Kjell Tore Guttormsen 0707d03bea chore(graceful-handoff): 2.0.0 — bump version, remove auto_discover, update CHANGELOG [skip-docs]

Step 8 of v2.0 plan.

2026-05-01 06:06:25 +02:00

Changelog

All notable changes to graceful-handoff are documented here.

The format is based on Keep a Changelog.

[2.0.0] - 2026-05-01

Hard cut from commands/ to skills/. The plugin now ships a single SKILL.md at skills/graceful-handoff/SKILL.md with disable-model-invocation: true and model: claude-sonnet-4-6. The legacy commands/graceful-handoff.md is deleted. User-invocation /graceful-handoff works as before.
Architecture rewrite. The 6-phase prose workflow is replaced by a deterministic Node script scripts/handoff-pipeline.mjs that returns structured JSON. SKILL.md is now a thin orchestration wrapper. Tests run directly against the pipeline without LLM involvement.
Removed auto_discover: true from plugin.json (not in documented schema; silently ignored anyway per research/05).

Auto-trigger via Stop hook (hooks/scripts/stop-context-monitor.mjs). Estimates context usage from transcript size; at estimated ≥70%, auto-writes the artifact and creates a commit. Push remains user-triggered (separates reversible from irreversible). Lock file at <transcript_dir>/.handoff-lock-<session_id> prevents repeat firing within a session.
Context hint via statusLine (hooks/scripts/statusline-monitor.mjs). Reads context_window.used_percentage from payload; prints a hint at 60% and an urgent reminder at 70%. Display-only — never runs git (unsafe per research/03).
Auto-load via SessionStart hook (hooks/scripts/session-start-load-handoff.mjs). On source: resume or source: compact, finds NEXT-SESSION-*.local.md (cwd + 3 levels up), injects content via additionalContext, archives the file (*.archived.local.md) to prevent stale-load.
Commit-message confirmation gate: pipeline prints message to stderr, reads y/n from stdin (interactive). --auto flag bypasses for hook-driven invocations.
New flags: --no-push (commit but don't push), --auto (non-interactive auto-Y), --non-interactive.
Pipeline robustness: detached HEAD detection, no-upstream detection, idempotency check (60s cooldown on clean tree), pre-commit hook respect.
36 unit tests across 5 test files (skill-structure, pipeline, statusline-monitor, stop-context-monitor, session-start-load-handoff).

Pipeline staging discipline (CRITICAL). Pipeline now stages ONLY the handoff artifact (and REMEMBER.md/TODO.md if present). Previously used git add -A which scoops up unrelated work-in-progress. The new behavior is enforced by a regression test.
allowed-tools is now Bash sub-scoped (Bash(git:*) Bash(node:*) Bash(jq:*) ...) instead of an open Bash. Note: per research/02, this is pre-approval (not restriction) — to actually block tools, project-level deny rules are needed.
Plugin model is pinned to claude-sonnet-4-6 (was: inherit from session). Frees Opus 4.7 budget for the next session that the user is actually entering.

statusLine placement in hooks/hooks.json is an open assumption (research/03 confirmed statusLine config exists, but exact placement vs settings.json is unverified). Smoke-test required.
Token estimation in Stop hook uses chars/3.5 heuristic — may drift ±10% from Claude's internal counting. The 70% threshold is conservatively set.
disable-model-invocation: true has open issue #26251; manual smoke-test recommended before relying on it.
Auto-execute does not push: irreversible operations remain user-triggered.

There is no automatic migration. v2.0.0 is a breaking change.

Reinstall the plugin to pick up skills/ and remove commands/.
The /graceful-handoff slash command works identically from the user's perspective.
The new auto-trigger features activate automatically when the plugin's hooks are loaded.

Initial release with single command /graceful-handoff
6-fase deklarativ workflow: detect → classify → write artifact → update REMEMBER/TODO → commit+push → print copy-paste-prompt
Tre handoff-typer: multi-sesjon (ultraplan-prosjekt), plugin-arbeid (marketplace-plugin), enkelt-oppgave (fallback)
Default filnavn NEXT-SESSION-PROMPT.local.md; slug-override via første posisjons-argument
Flag: --no-commit (skip git), --dry-run (ingen skriving, ingen git-ops)
Auto-generert Conventional Commits-melding fra git diff --stat
Respekterer pre-commit hooks (secrets, pathguard) — bypasser aldri
Tidsbudsjett < 60 sekunder; ingen Agent-delegering, ingen WebSearch
7-seksjons-template for NEXT-SESSION-artefakt (matcher eksisterende konvensjon i llm-security/config-audit)