v0.6.17

Release Notes - v0.6.17

Summary

• This patch release makes agent route packets more direct, especially around ownership, verification, and blocked-runner recovery.
• It adds stronger decision-context surfaces so agents can see the next command, missing evidence, and route confidence without reconstructing state from prose.
• It bounds several local hook paths so commits, pre-push checks, and PR artifact refreshes fail with actionable guidance instead of hanging.
• It keeps branch_pr publication evidence, release notes, and docs social assets aligned during multi-task closeout and release-candidate preparation.
• It makes the architecture dependency check less memory-spiky by running dependency-cruiser through a segmented package-root runner.

Added

• Added agent decision-context surfaces so route output can expose the operational fields agents need before choosing a next action. (10b5d00)
• Added clearer route diagnostics for agents so blocked or ambiguous workflow states point at the next useful command. (3710350)
• Added explicit evidence-missing output to task route packets so agents can see which approval, branch, PR, or verification artifact is still absent. (74f35a9)
• Added action-specific commit-hook diagnostics for subject and DCO failures so the CLI reports the actual policy issue instead of a generic git-context failure. (e5d9593)
• Added bounded git commit hook execution so stalled commit hooks terminate with a direct timeout reason and recovery command. (854bebd)
• Added bounded repository pre-push runner execution so local pre-push checks cannot leave agents waiting without a next step. (807dfd1)
• Added bounded PR artifact amend handling so automated artifact refreshes cannot hang on local hook behavior. (c1e34ba)
• Added live-head PR freshness handling so missing artifact head metadata can be interpreted against the current PR head instead of forcing stale-state loops. (d63ffc8)
• Added the v0.6.17 release notes page so the patch release has a complete human-readable change record before candidate preparation. (353bb93)
• Added generated social preview assets for the v0.6.17 release page so docs social checks stay complete after the new page is introduced. (ee7ffc9)

Improved

• Improved release-candidate plan discovery so a missing .agentplane/.release/plan directory now reports a direct validation error with agentplane release plan --patch as the next action. (b1dec8d)
• Improved release-candidate diagnostic formatting so the missing-plan guard satisfies the release format gate. (829d50d)
• Improved the v0.6.17 notes after the release-candidate task found late release-gate fixes, keeping the release record aligned with the updated plan. (69c533a)
• Improved architecture dependency checking by replacing one combined dependency-cruiser graph with a segmented per-package runner that preserves the same rules with lower peak memory. (f807284)
• Improved the segmented dependency-cruiser runner to satisfy the repository lint contract without changing the architecture-check behavior. (025f445)
• Improved the segmented dependency-cruiser runner so depcruise.config.cjs remains visible to the unused-code baseline guard. (f5fd224)
• Improved the segmented dependency-cruiser runner again by splitting the largest agentplane package root into smaller source slices, assigning a controlled child-process heap, and reporting the exact failing slice. (361fb94)
• Improved the Knip baseline guard so it runs local Knip through the active Node process, preserves termination signals in diagnostics, and avoids opaque code unknown failures. (8f10902)
• Improved TypeScript and tsup build scripts so release builds run through process-bound wrappers with explicit signal diagnostics instead of ambient tool shims. (1a926df)
• Improved the release Vitest suite runner so local Vitest runs through the active Node process while preserving the existing bunx fallback. (f38e145)
• Improved quality-review evidence for the segmented dependency-cruiser runner so the release trail records the arch gate fix before candidate retry. (22ec032)
• Improved quality-review evidence for the subsegmented dependency-cruiser runner so the release trail records the final architecture-gate stabilization. (1d224da)
• Improved quality-review evidence for the Knip baseline diagnostic fix so the release trail records the unused-code guard stabilization. (899504d)
• Improved quality-review evidence for the Knip wrapper formatting follow-up so the release trail records the final format-gate cleanup. (a1964e3)
• Improved quality-review evidence for the build wrapper fix so the release trail records the TypeScript/tsup stabilization before publication. (f103f86)
• Improved quality-review evidence for the build-wrapper formatting follow-up so the release trail records the final build format-gate cleanup. (0771778)
• Improved quality-review evidence for the release Vitest runner fix so the release trail records the test-runner stabilization before publication. (03e5c89)
• Improved quality-review evidence for the release build contract update so the release trail records the clean forced-build invariant after wrapper adoption. (55908c2)
• Improved quality-review evidence for the stale review metadata fix so the release trail records the PR freshness regression before candidate retry. (c8f1f44)
• Improved quality-review evidence for the stale branch fallback fix so the release trail records the PR validation regression before candidate retry. (48cb264)
• Improved quality-review evidence for the release workflow snapshot fix so the release trail records the generated-state drift before publication. (123fc56)
• Improved quality-review evidence for the release ACR example formatting fix so the release trail records the post-version-bump format gate before publication. (d52f8ba)
• Improved quality-review recording for the missing-plan diagnostic fix so release evidence includes the evaluator pass before candidate preparation continues. (52c5106)
• Improved release notes closeout evidence so the v0.6.17 notes task records its review result and task artifacts. (80bc08b)
• Improved social asset closeout evidence so the generated v0.6.17 preview image and manifest update carry task-local review proof. (a955e5c)
• Improved task artifact refresh for the release notes PR so branch_pr metadata stays synchronized after the notes commit. (6b47d61)
• Improved release notes publication on main so the final hosted close tail records the docs task completion cleanly. (6934309)
• Improved decision-context static exports so downstream CLI surfaces can consume the new context helpers reliably. (9cdc819)
• Improved confusing agent route diagnostics so route output is more direct about the checkout, blocker, and next command. (dd57dc3)
• Improved feedback issue diagnostics so structured feedback routes tell agents how to proceed when the runner is blocked or evidence is incomplete. (1c07c76)
• Improved blocked runner route hints so recovery guidance is visible in the route packet instead of buried in task prose. (2e72f84)
• Improved hosted-close handling so tasks that were closed before merge can still be tolerated during final hosted closeout. (8b5b9ee)
• Improved hosted-close implementation so pre-merge closed tasks no longer break the post-merge closure path. (6e7f7ca)
• Improved batch PR metadata refresh so the primary task and included follow-up tasks stay aligned during PR publication. (ddc9cd7)
• Improved batch task ownership refresh so completed included tasks carry the right ownership and closeout context. (71174e7)
• Improved included batch artifact commits so related task README updates are staged and committed with the PR artifact refresh. (9fa2717)
• Improved PR checks against live-head artifacts so ap pr check and route guidance agree about whether the PR evidence is current. (d63ffc8)
• Improved static verification cleanup so release checks no longer fail on stale or mismatched verification artifacts. (9690a22)
• Improved unused timeout export cleanup so static dependency checks stay clean after the hook-timeout refactor. (8cc097c)
• Improved evaluator review recording so the release trail includes the quality review result for the cognitive-load refactor. (fce858f)
• Improved the primary cognitive-load refactor closeout so CLI packets, task artifacts, and release preparation are captured together. (f1ea771)

Fixed

• Fixed feedback issue diagnostics closeout so the bug-fix task records the corrected diagnostic behavior cleanly. (786f128)
• Fixed evaluator pass recording for the feedback diagnostics task so the verification trail is explicit before merge. (9f1e9be)
• Fixed branch_pr artifact update loops where PR metadata refreshes could leave included task artifacts dirty after commit. (85e65eb)
• Fixed route packet ownership ambiguity so verification candidates keep the owner role aligned with the executable next action. (74f35a9)
• Fixed PR artifact amend hangs by skipping local hooks for the automated amend path and relying on explicit verification checks. (c1e34ba)
• Fixed stale PR check behavior where missing head metadata could cause a fresh PR to be reported as stale. (d63ffc8)
• Fixed stale review metadata handling so missing meta.head_sha no longer hides a changed branch diffstat when no matching digest is present. (e3bb2b4)
• Fixed stale branch fallback handling so pr check no longer reports success from branch-backed PR artifacts when the current checkout is missing the local task projection. (704ced2)
• Fixed the release-candidate missing-plan path that previously surfaced as an internal ENOENT instead of telling agents to generate the release plan first. (b1dec8d)
• Fixed release workflow snapshot drift so .agentplane/workflows/last-known-good.md carries the same 0.6.17 expected CLI version as .agentplane/WORKFLOW.md. (27fc3d1)
• Fixed release ACR example formatting after the 0.6.17 version bump so format:check stays green on the final release candidate head. (f178fe8)

Upgrade Notes

• No breaking changes.
• The package set remains in lockstep at 0.6.17.
• Operators should continue to use the branch_pr release candidate route, then publish with the release commit SHA.
• AGENTPLANE_GIT_COMMIT_TIMEOUT_MS can be used to tune bounded commit-hook execution when local hook environments are slower than the default.

Verification

• ap release plan --patch generated .agentplane/.release/plan/2026-06-04T23-07-27-698Z for v0.6.17.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-04T23-28-53-887Z after the release notes, social assets, and missing-plan diagnostic tasks landed.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-04T23-41-17-464Z after the segmented architecture-check task landed.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-04T23-43-32-283Z after the dependency-cruiser runner lint cleanup.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-04T23-46-38-128Z after the dependency-cruiser config visibility cleanup.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-04T23-55-23-157Z after the stale review metadata regression fix.
• ap release plan --patch regenerated .agentplane/.release/plan/2026-06-05T00-03-10-806Z after the stale branch fallback regression fix.
• docs/releases/v0.6.17.md covers every change listed in the frozen release plan.
• bun run docs:social:check checked 210 docs social images after generating website/static/img/social/docs/releases/v0.6.17.png.
• bun run arch:check passed with the segmented dependency-cruiser runner.
• bunx vitest run packages/agentplane/src/cli/run-cli.core.pr-flow.pr-notes-verify.test.ts packages/agentplane/src/commands/pr/internal/freshness.test.ts passed the PR artifact freshness regression coverage.
• bunx vitest run packages/agentplane/src/cli/run-cli.core.pr-flow.pr-validation.test.ts packages/agentplane/src/cli/run-cli.core.pr-flow.pr-check-remote-artifacts.test.ts passed the PR artifact fallback regression coverage.
• bun run docs:bootstrap:check passed after synchronizing .agentplane/workflows/last-known-good.md with .agentplane/WORKFLOW.md.
• bunx prettier packages/spec/examples/acr.json --check and bun run release:acr-example:check passed after formatting the release-updated ACR example.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH bun run arch:deps passed with the subsegmented dependency-cruiser runner.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH bunx eslint scripts/checks/run-depcruise-arch.mjs passed for the dependency-cruiser runner.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH NODE_OPTIONS=--max-old-space-size=4096 bun run knip:check passed with the process-bound Knip wrapper.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH bunx eslint scripts/checks/check-knip-baseline.mjs passed for the Knip baseline wrapper.
• bunx prettier scripts/checks/check-knip-baseline.mjs --check passed after formatting the Knip baseline wrapper.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH NODE_OPTIONS=--max-old-space-size=4096 bun run typecheck passed with the TypeScript wrapper.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH NODE_OPTIONS=--max-old-space-size=4096 bun run build passed with the TypeScript and tsup wrappers.
• bunx prettier scripts/checks/run-typescript-build.mjs scripts/checks/run-tsup-build.mjs --check passed after formatting the build wrappers.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH NODE_OPTIONS=--max-old-space-size=4096 node scripts/checks/run-vitest-suite.mjs release-ci-base --report-json .agentplane/cache/release-ci-base-focused.json passed chunks 1-50 before the now-fixed release contract assertion.
• PATH=/Users/densmirnov/.nvm/versions/node/v24.11.1/bin:$PATH NODE_OPTIONS=--max-old-space-size=4096 node node_modules/vitest/vitest.mjs --config vitest.workspace.ts run packages/agentplane/src/commands/release/release-ci-contract.test.ts --pool=forks --maxWorkers 1 --testTimeout 60000 --hookTimeout 60000 passed after updating the build contract.
• node scripts/generate/generate-scripts-readme.mjs --check passed after documenting the new build wrapper scripts.
• npm run typecheck passed in packages/agentplane.
• Release candidate validation is expected to run after these notes are committed.