Files

Tom Boucher fe5731185e chore: merge release v1.8.0 to main (#2500 )

Reconciles main to the v1.8.0 tree while preserving the [1.7.0] CHANGELOG
section that release/1.8.0 omitted (root-caused in #2502: the main->next
auto-backmerge failed after 1.7.0, so next never received 1.7.0's promoted
CHANGELOG). Both parents kept so the v1.7.0 and v1.6.1 tags remain in
main's ancestry. This also delivers the fixed auto-backmerge.yml (build:lib
step, #2281) to main so the main->next backmerge stops failing.

2026-07-21 20:40:16 -04:00

Changelog

All notable changes to GSD will be documented in this file.

Format follows Keep a Changelog.

[1.8.0] - 2026-07-22

Added

A default-off, BETA, claude-only "Claude orchestration" capability — adopts Claude Code's Workflow tool (/effort ultracode, Agent SDK ≥ v0.3.149) as an optional parallel-execution backend for the GSD loop, restoring the wave parallelism + plan-checker + verifier that the #853 backgrounded-agent nesting limitation forces inline on Claude Code, and folding the existing gsd-ultraplan-phase plan-offload under the same runtime gate. When claude_orchestration.enabled is on AND the runtime is Claude AND the Workflow tool is detected AND the Agent SDK meets the floor (claude_orchestration.min_agent_sdk_version, default 0.3.149), execute-phase emits a generated Workflow script (waves → parallel() barriers, plans → agent({ agentType: 'gsd-executor', isolation: 'worktree' }), files_modified overlap → separate sequential stages, resumeFromRunId wired to the phase run id, shared budget pool) that composes the SAME executor agent + worktree isolation the inline path uses, so artifacts/commits are produced identically. Detection is pure and fail-closed (any miss → inline), so on any runtime lacking the Workflow tool behaviour is byte-identical to today. Adds a pure module gsd-core/bin/lib/claude-orchestration.cjs (detectWorkflowBackend, emitWorkflowScript), the capabilities/claude-orchestration/ declaration with two gated loop contributions (execute:wave:post, plan:post) and a claude-orchestration command family (gsd-tools claude-orchestration detect-backend|emit-workflow), federated config keys, and an ADR-1143 implementation amendment. (#1143) (#2044)
Phases that integrate an external API/SDK/service can no longer seal without a decided coverage matrix — a new api-coverage gate on the ai-integration capability blocks /gsd:verify-work until the phase produces a COVERAGE.md enumerating the API's full capability surface, with every non-integrated capability an explicit, reasoned opt-out. Full coverage is the default; the matrix is the subtraction record, so "we integrated the API" can no longer silently mean "we integrated whatever the first use case exercised." Toggleable via workflow.api_coverage_gate (on by default). (#1562) (#2065)
OpenCode installs now auto-register the GSD companion MCP server (mcp.gsd) — --opencode install writes a mcp.gsd entry (local stdio → gsd-mcp-server) into opencode.json, so OpenCode drives GSD's command + planning-state surface over MCP with no bespoke plugin (ADR-1239 Phase D / #1682). Idempotent and non-clobbering; a user-defined mcp.gsd is preserved. (#1682) (#1929)
OpenCode plugin handles session.idle + the opencode-subset hook dialect is implemented — the GSD OpenCode plugin now recognizes session.idle (↔ Claude Stop lifecycle point), completing the compaction/idle pair (#1914 shipped compaction). The reserved opencode-subset dialect gains a consumer — hookEventSurfaceFor() in host-integration.cts — describing OpenCode's session/tool/file event subset (no workflow-phase events; the engine owns phase sequencing, ADR-1239 §OpenCode binding). Adds a Claude-parity test asserting the plugin covers the full declared subset. (#1682) (#1930)
GSD now warns when model config changed without re-running the installer on static-frontmatter runtimes — on codex and opencode, editing model_overrides or model_profile_overrides or model_policy.runtime_tiers in .planning/config.json or ~/.gsd/defaults.json previously had no effect until the user re-ran gsd install <runtime>, and the failure was silent: the sub-agent kept using the base model. Workflow entry points like gsd-tools init * now emit a one-line stderr warning naming the changed config file and the exact remediation command when they detect the config is newer than the baked agent files. The guard is read-only and warning-only by default, dedup'd per session, and skipped entirely on Claude Code because Claude Code resolves models at spawn time. Resolves #1688 as the structural follow-up to #1650. (#1692)
gsd-tools state rebuild — new subcommand that re-derives STATE.md body structure from canonical sources (frontmatter + .planning/phases/ disk scan), reconciling drifted ## Current Position prose, dropping orphaned rows from the **By Phase:** table, clearing template-placeholder field values, and de-duplicating ## Session Continuity Archive blocks. Every mutation is recorded in a ## Rebuild Log audit section. Idempotent (running twice on a clean file is a no-op). Supports --dry-run (preview) and --verbose (tee log to stderr). Heavier, manual counterpart to the lightweight auto-triggered state sync. (#1830)
graphify.graph_path makes the knowledge-graph location configurable so one umbrella graph can serve multiple projects — a new .planning/config.json key (path relative to project root, or absolute) overrides where /gsd-graphify query|status|diff read the graph, letting a single curated cross-repo umbrella graph serve every sibling sub-project without N drifting ~5 MB mirror copies. Previously the graph location was hardcoded to <cwd>/.planning/graphs/ with no override; the only workaround was copying the umbrella graph.json into each project (which drifted, wasted disk, and could be silently overwritten by an in-project build). The diff snapshot travels with the configured graph; build stays project-scoped; unset → byte-identical default; a configured-but-missing file yields an actionable error naming the path. (#1825) (#2013)
Claude Sonnet 5 is now the standard (sonnet) tier model. The model catalog and provider presets resolve the sonnet/standard tier to claude-sonnet-5 (GA 2026-06-30) across the Anthropic-backed runtimes (claude, copilot, and the anthropic/anthropic-fable presets), plus the OpenRouter-style anthropic/claude-sonnet-5 for opencode/hermes, replacing the superseded claude-sonnet-4-6. Opus and Haiku tier defaults are unchanged (the haiku high-effort preset's escalation slot tracks the current sonnet model). Shipped in 1.6.1. (#1847) (#1848)
gsd-debugger now guards fix acceptance with a multi-signal anti-overfitting gate — a fix that greens the target test can no longer be silently accepted. The debugger now runs a five-signal guardrail before accepting a fix (target test, mutation check via Stryker, no-op/behavior-deleting diff detector, adjacent/held-out tests, and revert-and-reconfirm), degrades gracefully when Stryker or a test suite is absent (each skip is logged, never a silent pass), records every signal's result under Resolution.verification in the debug file, and returns a FIX REJECTED BY GUARDRAIL outcome that gsd-debug-session-manager surfaces for revise / accept-as-documented-debt / abandon. Full rules live in gsd-core/references/debugger-fix-acceptance.md. (#1958) (#2396)
gsd-debugger now ranks suspect code by Ochiai suspiciousness before forming hypotheses — when a runnable test suite with per-test coverage exists (≥1 failing and ≥1 passing test), the debugger computes a spectrum-based fault-localization (Ochiai) ranking over the coverage and seeds the top-N suspicious locations into the Evidence section as first-class hypothesis candidates, narrowing the search space deterministically before any LLM reasoning. Tarantula is documented as a fallback formula. The step degrades cleanly (logged, never a silent pass) when there is no test suite, no failing tests, or no per-test coverage, and it is explicitly not trusted on flaky/Heisenbug spectra (pairs with the Phase 2B bug-taxonomy routing). Full rules live in gsd-core/references/debugger-sbfl.md. (#1959) (#2403)
gsd-debugger now branches root-cause analysis instead of chaining, guarding against 5-Whys single-cause bias — before committing root_cause, the debugger enumerates candidate causes across ≥2 Ishikawa categories (code / config / environment / data) rather than a single linear "why" chain, and explicitly answers an AND-gate question ("could this failure require more than one contributing condition simultaneously?"). When the AND-gate fires, every contributing cause is recorded — so a multi-cause fix no longer recurs via the unaddressed second cause. Resolution.root_cause may now hold one OR a small set of contributing causes (additive; a single-cause session still records exactly one root_cause while the reasoning_checkpoint gains two RCA fields populated in every session). The Structured Reasoning Checkpoint gains candidate_causes + and_gate fields, and debugger-philosophy.md adds the single-cause-bias trap to its cognitive-bias table. Full rules live in gsd-core/references/debugger-rca-branching.md. (#1960) (#2405)
gsd-debugger now classifies each failure by bug class and routes the investigation technique accordingly, replacing the flat 11-technique menu with selection-by-class — at a new Phase 1.75 the debugger assigns a bug_class (Bohrbug / Heisenbug-Mandelbug / Concurrency) and consults an explicit, inspectable routing table: Bohrbugs route to deterministic reproduction + SBFL (Phase 1.25) + git bisect; Heisenbugs/Mandelbugs route to record-replay (rr) + stability-stress + statistical sampling and explicitly skip SBFL (a flaky spectrum poisons the ranking); Concurrency bugs surface the atomicity/order/deadlock checklist before general techniques. The 11 techniques remain as routed targets, not an undifferentiated list (supersede, not append). bug_class + chosen strategy are written to the debug file; the common-bug-patterns catalog is cross-referenced to the taxonomy. Full rules live in gsd-core/references/debugger-bug-taxonomy.md. (#1961) (#2407)
gsd-debugger now hardens regression tests via PBT shrinking, explicit oracle classification, and boundary neighbors — extending Minimal Reproduction and Test-First Debugging. When a bug triggers on a class of inputs, the debugger wraps the failing input in a property (fast-check for JS/TS, Hypothesis for Python) and lets the shrinker auto-minimize the counterexample, storing the minimized input as the regression seed; before writing the assertion it classifies the oracle as specified / derived (contract/model) / metamorphic / implicit (crash — weakest, never the silent default) and records it under Resolution.oracle_type; and it generates boundary neighbors (off-by-one, min/max, empty/singleton) around the fixed defect's equivalence class. Together they turn the regression test into a root-cause check — which is what the Phase 1A mutation guardrail needs to bite. Degrades gracefully to manual minimization when no PBT framework is present. Full rules live in gsd-core/references/debugger-repro-hardening.md. (#1962) (#2409)
gsd-debugger now emits a blameless-postmortem Prevention block at resolution, closing the loop on bug-class prevention — at archive_session the debugger produces three blame-free components: a branching 5-Whys causal chain (branching per the Phase 2A RCA discipline, not a single linear chain; "agent error" prompts "why was that error possible?", never blame), a "why wasn't this caught?" answer naming the existing gate (test/typecheck/lint/review/verify) that missed it, and a concrete recurrence guard (a regression test / assertion / lint rule / knowledge-base pattern). The knowledge-base entry gains two structured fields — why_not_caught and recurrence_guard — so a future Phase-0 recall surfaces not just the prior fix but the prior prevention (additive; old entries without the fields still load). The session-manager's compact summary surfaces a one-line prevention summary. Full rules live in gsd-core/references/debugger-prevention.md; kept minimal — a block, not an incident-management subsystem. (#1963) (#2410)
Third-party capability gates now actually fire via a generic command-exit-zero predicate. — a capability's declared check.predicate gate was rendered for display but never evaluated (only built-in check.query gates were enforced, and the security capability's gate worked solely via a hard-coded ship.md branch). A new generic evaluator (gsd_run check predicate) now evaluates check.predicate blocks by kind; the first built-in kind command-exit-zero runs a bounded sh -c command at the project root and blocks the loop on non-zero exit (timeout → block, fail-closed). The execute:wave:post, execute:post, and plan:post gate-dispatch sites route predicate gates to the new evaluator automatically. (#2008) (#2011)
GSD's lifecycle hooks now run under Kimi CLI — installing GSD into Kimi wires its session-state, phase-boundary, graphify, and guard hooks into Kimi's own native config.toml [[hooks]] bus (Beta on Kimi's side) instead of silently no-op'ing, and GSD's Kimi subagents can now run in the background. Kimi's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2095) (#2159)
GSD is now installable on pi — npx @opengsd/gsd-core --pi installs the GSD extension to ~/.pi/agent/extensions/gsd.cjs, and /gsd <family> <subcommand> now dispatches real commands through the embedded engine (the reference binding previously could only run query help). Drives pi through the negotiated imperative Host-Integration adapter, with active-model steering and the full pi lifecycle-event surface. (#2102) (#2205)
The EoS Registry now lists GSD for Oh My Pi — discover the independently maintained tchivs/gsd-omp protocol-v1 host integration, including exact install and uninstall commands, supported interface points, and negotiated host axes. (#2448)
Broken-windows ledger — /gsd:ship now blocks (when workflow.windows_enforce=true, opt-in) while .planning/WINDOWS.md has any open entry, and the executor auto-populates the ledger with stubs, skipped tests, and unrun verifies as it works. Each window can be waived only with a recorded reason (auditable) or fixed (removed from the blocking set); /gsd:progress surfaces the open + waived counts. Backward-compatible: projects with no ledger ship cleanly (open_count starts at 0), and enforcement is off by default so tracking can precede the gate. Enable with gsd config-set workflow.windows_enforce true. (#1950) (#2441)
GSD now ships a pi extension — a real, jiti-loadable ExtensionAPI module (pi/gsd.cjs) that registers /gsd (dispatches through the GSD command-routing hub) + gsd_invoke tool + tool_call event, installable at ~/.pi/agent/extensions/. A reachability test proves the /gsd handler dispatches through the engine (keystone wired, not just registered on a mock). (#1965) (#1965)
plan-phase now authors edge and prohibition predicates into PLAN.md must_haves when a phase SPEC omits ## Edge Coverage / ## Prohibitions, so goal-backward verification still has predicates to check on a spec-less phase (ADR-857 Phase 6). Gated by the new default-on workflow.specless_probe_fallback toggle — disable it to skip the fallback (the skip is recorded visibly in the plan). Spec-less prohibitions are authored descriptor-less and disposed flagged/unverified (honest verifier #1154), never a silent pass. (#1835)
Discover third-party GSD Capabilities in a new Community Capability Registry. — A non-endorsing discoverability catalog where authors register a Capability via a documentation PR; each entry carries a live latest-release badge and a per-entry GitHub Discussion for community ranking and comments. (#2188) (#2188)
GSD now warns when a stale global CLI (e.g. a retired @gsd-build/sdk canary) shadows your project-local install — the gsd-tools CLI startup detects when the running binary is outside the project root while a project-local install exists, and prints a remediation warning to stderr (non-blocking). (#1754) (#1755)
gsd-mcp-server — companion MCP server (interface points 1 + 5) — a new bin command (npx @opengsd/gsd-core gsd-mcp-server) runs a stdio JSON-RPC 2.0 MCP server exposing gsd_invoke_command (→ the GSD command-routing hub) + gsd_read_state / gsd_write_state (→ .planning/ state), so any MCP-consuming host (Claude Code, Codex, OpenCode, VS Code, Gemini CLI, Cursor, Cline, Hermes) can drive GSD with no bespoke plugin (ADR-1239 Phase C-2 / #1681). Dependency-free (hand-rolled JSON-RPC). How-to: docs/how-to/connect-gsd-mcp-server.md. (#1810)
Opt-in absolute token count on the statusline context meter — new statusline.show_context_tokens config (default false). When enabled, the meter shows the absolute context total after the percentage, e.g. "████░░░░░░ 46% (156k)", summing input, cache-creation, cache-read, and output tokens from the hook payload (a broader basis than the meter's percentage, which is derived from used_percentage and excludes output tokens — the two figures can diverge slightly). Default meter output is unchanged. (#2161) (#2174)
Long-running compute can now be externalized as async external jobs instead of blocking the agent turn — a default-off external-job capability lets executors submit SLURM jobs, commit a .planning/async-jobs manifest, defer SUMMARY.md, and return external_job_waiting; the core loop already reconciles these manifests (#1165), so this adds the producer half (SLURM adapter, pure manifest module, planner/executor fragments, operation policy). (#1105) (#1998)
GSD now ships a repo-local VS Code extension — a buildable extension (vscode/extension.js + vscode/package.json) that registers gsd.invoke (dispatches through the GSD command-routing hub) in the VS Code command palette. A reachability test proves the handler dispatches through the engine (keystone wired). Not Marketplace-published; mirrors the OpenCode plugin's bar. (#1966) (#1966)
Discover third-party GSD Embeddable Orchestration System (EoS) integrations in a new EoS Registry. — A non-endorsing discoverability catalog where host-integration authors register via a documentation PR; each entry declares its Host-Integration interface points, negotiated axes, and protocol version, with a live release badge and a per-entry GitHub Discussion for ranking and comments. (#2193) (#2193)
GSD Core ships a .claude-plugin/marketplace.json marketplace manifest so Claude-plugin-compatible runtimes (ZCODE et al.) can discover and install gsd-core from a custom marketplace source. Additive — the existing .claude-plugin/plugin.json and the Claude Code install path are unchanged. The catalog version (plugins[0].version) tracks package.json via the release version-sync. (#1861)
GSD now drives VS Code through the Embeddable Orchestration System — the VS Code extension is rewired through the negotiated imperative Host-Integration adapter (active vscode.lm model, engine hook bus, sandboxed storage), gains native Language Model Tools (GSD skills as #gsd-* tools) and #runSubagent dispatch, and runs as a Web Extension (no Node APIs). (#2103) (#2210)
/gsd:next smart-entry workflow — adds a state-aware entry point that classifies the current project situation (no-project, blocked, verify-failed, planning, executing, verify-pending, complete, and more) and recommends the right next GSD command. The gsd-tools smart-entry [--json] classifier handles phase ordering including decimal phase IDs; the /gsd:next skill surfaces the workflow with tiered fallback behavior. (#1798)
OpenCode now runs GSD's lifecycle safety hooks (prompt-injection guard, read-before-edit guard, injection scanner, worktree/workflow guards, context monitor) via a native plugin installed to ~/.config/opencode/plugins/gsd-core.js. OpenCode declares hooksSurface: 'none', so these hooks were previously inert; the plugin bridges OpenCode's event bus onto GSD's existing hook scripts. Installed automatically by npx @opengsd/gsd-core --opencode and removed on uninstall. (#1923)
Opt-in compact GSD-state statusline format — new statusline.state_format config, enum full|compact (default full, the existing rendering). compact renders " · P/ · " (e.g. "v1.12 · P7/12 · executing"), dropping the milestone name and progress bar and collapsing narrative statuses to the canonical vocabulary from normalizeStateStatus() — the canonical stuck state paused renders uppercase as PAUSED. Solves the unbounded-width problem where free-text status sentences push the context meter off the line. (#2162) (#2175)
<precondition> task element (Design by Contract) — plans may now declare a runnable/checkable fact a task assumes (env var set, prior-phase artifact present, external-setup done) that plan ordering does not guarantee; the executor asserts it before running the task and halts with a checkpoint on unmet instead of building on a broken assumption. Plans that omit <precondition> behave exactly as today. (#1949) (#2422)
Config-gated provider escalation when a run hits a quota or rate limit — an executor killed by a provider throttle stopped the phase and waited for a manual restart; escalating a tier did not help because the same throttled provider was still in play. Set dynamic_routing.provider_escalation to an ordered list of fallback model IDs and GSD now switches provider on a quota-exceeded failure, logs the swap (sonnet → gpt-5), honors the provider's Retry-After, caps the walk at max_escalations, and names every model tried once the list is spent. Opt-in — unset, quota failures keep today's manual recovery prompt. (#2296) (#2458)
Host-integration descriptors now carry an extensionEvents vocabulary — the extension-system event surface (OpenCode, pi) is a separate descriptor field from managed hookEvents, so OpenCode declares extensionEvents:opencode without conflicting with the hooksSurface:none invariant. (#1946) (#1946)
/gsd-review now supports custom reviewer instances — run one model-capable adapter (e.g. OpenCode) as several independent reviewer identities via a bounded review.reviewer_instances config, so two different models can review in a single pass without manually swapping config or hand-merging REVIEWS.md. (#1517) (#1766)
Opt-in git branch and working-state segment in the statusline — the shell prompt's branch/dirty-state signal is hidden for the whole session under the Claude Code TUI, so wrong-branch commits and ship-time push rejections surface only after the fact. New statusline.show_git config (default false) renders the branch name plus staged/unstaged/untracked/ahead/behind markers (or ✓ when clean and in sync) after the directory segment. When disabled, no git subprocess is spawned and output is unchanged. (#2163) (#2183)
/gsd:onboard guides brownfield setup — existing repos now have a top-level onboarding command that routes through codebase mapping, docs ingest, project initialization, and an onboarding summary without silently overwriting planning files. (#1994)
Plural/optional/chosen assumption-delta checkpoint during planning — when a phase makes something plural, optional, or chosen that used to be singular, required, or derived, the planner is now prompted to re-ask whether the primary key / identity model still names the right thing, preventing silent architectural drift from accumulating into a later user-facing bug. Advisory (non-blocking); fires only on a detected signal. Toggle with workflow.assumption_delta. (#1561) (#1767)
/gsd-ui-phase now probes UI state coverage — a new ui-consideration-probe (the third probe-core adapter) enumerates the shape-rooted UI states a UI-SPEC must resolve (empty/loading/error/populated/partial/overflow/zero-one-many/long-text). After the UI checker approves, the probe surfaces applicable considerations for each element, records a ## UI Considerations section in the UI-SPEC, and plan-phase lifts each resolved consideration into must_haves — so a purely-visual state with no wired test routes to insufficient_spec → human_needed at verify rather than a silent pass. (#1979)
Host-Integration Interface (ADR-1239 Phase A) — a versioned, negotiated capability contract (runtime.hostIntegration) over the six host-integration points (command, dispatch, model, hooks, state, artifact). Adds an in-process negotiateHostCapabilities handshake that fail-closes on undeclared/unknown/undocumented values (effective ⊆ host-declared ∩ engine-known), a typed degradation ladder, host-capability profiles, and a documentation-sourced per-CLI capability matrix for all 16 runtimes. Interface-definition only — no change to install behaviour. (#1690)
ZCode (Z.ai) is now an installable runtime — a desktop Agentic Development Environment for the GLM-5.2 model can now be targeted with --zcode, landing GSD skills at ~/.zcode/skills/<name>/SKILL.md plus slash commands and subagents. ZCode ships as a pure declarative capability descriptor (capabilities/zcode/capability.json) with zero hardcoded runtime === 'zcode' branches, reusing the Claude skill converter — the de-hardcoded, data-driven runtime path that 1.7.0 (ADR-1016 / ADR-1239) enables. (#1925) (#2039)
Reversibility tagging for planning decisions — decisions can now be rated reversible, costly, or one-way by how expensive they are to undo. A one-way decision (one whose undo needs a data migration, breaks a published contract, or is impossible) earns a checkpoint:decision before the task that implements it, so an unattended run pauses for your sign-off instead of walking through the door. costly decisions are flagged in the plan without blocking; reversible ones flow as before. Pass --no-reversibility-gates to /gsd:plan-phase to suppress the checkpoint on runs you mean to leave unattended — ratings are still recorded either way. (#1951) (#2471)

Changed

gsd-debugger now recalls prior resolved sessions semantically via MemPalace instead of keyword overlap — at Phase 0 the debugger queries MemPalace with the current symptoms and surfaces the top-k meaning-similar prior resolutions as candidate hypotheses, catching the same-root-cause / different-wording cases keyword overlap missed (a prior "requests hang under load" now surfaces for "API times out when many users connect"). Resolved sessions are indexed into MemPalace at archive (symptoms + root cause(s) + fix + recurrence guard). knowledge-base.md remains the durable plain-text source of truth; when MemPalace is absent the debugger falls back to keyword-overlap matching against it (logged, never a silent skip). No new embedding/vector infrastructure — MemPalace is reused. Full rules live in gsd-core/references/debugger-semantic-recall.md. (#1964) (#2416)
The GSD CLI now self-heals a missing runtime build. The compiled gsd-core/bin/lib/*.cjs modules are gitignored build artifacts (ADR-457) that ship prebuilt in the npm tarball but are absent on a Claude Code plugin-marketplace / git-clone install, which never runs npm run build:lib. Previously every command died at load with Cannot find module './lib/cli-exit.cjs'. The gsd-tools entrypoint now detects the missing output and compiles it once, on demand (lock-guarded so parallel invocations don't race), then proceeds — a single no-op check on the already-built npm path. When TypeScript is genuinely unavailable it prints an actionable npm install && npm run build:lib message instead of crashing. (#2036)
Internal: Claude Code's installer is now driven through the public Host-Integration Interface (ADR-1239 / EoS). bin/install.js routes claude install/uninstall through the imperative adapter (createImperativeAdapter) instead of calling the engine directly, and its 13 hardcoded runtime === 'claude' / runtime !== 'claude' branches are folded into descriptor-driven runtime.hostBehaviors on capabilities/claude/capability.json (permission schema, settings.local.json scope routing, .gsd-source marker, effort frontmatter, canonical-workflow authorship, and more). Install/uninstall output is byte-identical for both the global skills layout and the local legacy layout (golden-parity asserted for both scopes); no other runtime changes. Removes the "add-a-host tax" of scattered string-equality checks for the tier-1 reference host. No user-facing change. (#2086) (#2106)
OpenCode is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). OpenCode and its Kilo sibling previously installed via a bespoke runtime === 'opencode'/isOpencode branch in bin/install.js; its commands+skills+plugin install now runs through the imperative adapter → the engine's combined-family install path (installRuntimeArtifacts), and every hardcoded runtime === 'opencode' branch is folded into descriptor-driven runtime.hostBehaviors. Install/uninstall output is byte-identical (golden parity asserted for all 16 runtimes). Two Context7-verified upgrades land: (1) background dispatch — OpenCode shipped experimental background subagents in v1.15 and made them default-on in v1.17, so dispatch.background/backgroundDispatch flip to true; GSD no longer force-flattens OpenCode-hosted wave dispatch (shouldFlattenDispatch now returns false), letting agents run concurrently where the host supports it. (2) expanded event surface — the OpenCode plugin now subscribes to permission.asked, permission.replied, and session.error (added to EXTENSION_EVENT_SURFACES.opencode), wiring the declared surface for future permission/error-aware bindings. (#2087) (#2108)
Codex is now driven through the public Host-Integration Interface, with three capability upgrades (ADR-1239 / EoS). Codex previously installed via hardcoded runtime === 'codex'/isCodex projection in bin/install.js; its config.toml / agent-.toml / hooks.json install now runs through the declarative embedding adapter and descriptor-driven runtime.hostBehaviors, with zero positive isCodex gates and zero runtime === 'codex' branches remaining (source-guarded). Install/uninstall output stays byte-parity-gated (tests/fixtures/golden-install-parity/codex.json). Three Context7-verified upgrades land, each with a test driving the user-reachable surface: (1) skill root — GSD skills now install to Codex's canonical $HOME/.agents/skills (via a skills-kind home override) instead of the deprecated $CODEX_HOME/skills fallback, and pre-move installs are migrated (stale ~/.codex/skills/gsd-* cleaned on both install and uninstall, user-owned content preserved); (2) hook events — GSD registers the six documented Codex lifecycle events it previously skipped (PreToolUse, PermissionRequest, PreCompact, PostCompact, SubagentStop, UserPromptSubmit, in addition to the existing SessionStart/SubagentStart/Stop/PostToolUse) in hooks.json, so gsd-context-monitor fires at the same points as in Claude Code, and the descriptor extendedHookEvents is reconciled from [] to the schema-valid wired subset; (3) dispatch tuning — [agents] max_depth = 1 is written explicitly into the managed config.toml block to pin the negotiated dispatch.maxDepth: 1 axis (degradationFor flattens GSD-hosted waves to single-level), and validateCodexConfigSchema now permits a known-scalar-only [agents] AgentsToml table (coexisting with the flattened [agents.gsd-*] role sub-tables) while still rejecting the [[agents]] and unknown-key break-forms from #2760. (#2088) (#2110)
Cursor is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). Cursor previously installed via hardcoded runtime === 'cursor'/isCursor branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded cursor branch is folded into descriptor-driven runtime.hostBehaviors (reapplyCommand, frontmatterDialect, hooksJsonSurface, skipSharedHooksInstall, reportCommandsDir, managedHookEvents). Install/uninstall output is byte-identical (golden parity asserted for all 16 runtimes). Two Context7-verified upgrades land: (1) expanded hook-bus coverage — GSD registers all 6 managed lifecycle events in Cursor's hooks.json (preToolUse, stop, subagentStart, subagentStop in addition to the original sessionStart/postToolUse), driven by a new descriptor-driven adapter module (src/host-integration-adapters/imperative-hook-bus.cts) that reads hostBehaviors.managedHookEvents instead of a hardcoded event pair; cite https://cursor.com/docs/hooks. (2) named/background nested subagent dispatch — Cursor's dispatch.background/backgroundDispatch/nested are all true with maxDepth: 2, so shouldFlattenDispatch(cursor) returns false and GSD's wave-based execution drives Cursor's native background + depth-2 nested subagent invocation instead of flattening to inline sequential calls; cite https://cursor.com/docs/subagents + https://cursor.com/docs/sdk/typescript. (#2089) (#2120)
Cline is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). Cline previously installed via hardcoded runtime === 'cline'/isCline branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded cline branch is folded into descriptor-driven runtime.hostBehaviors (reapplyCommand, frontmatterDialect, skipSharedHooksInstall, localTargetIsProjectRoot, clineRulesSurface, localCommandsViaRules). Install/uninstall output is byte-identical (golden parity asserted for cline + claude/cursor/codex/opencode). Two Context7-verified upgrades land: (1) AgentPlugin.hooks.beforeTool planning guard — the .clinerules/hooks/PreToolUse file-convention hook (#787) is re-implemented as a real Cline SDK AgentPlugin that cancels write-class calls targeting .planning/ (same fail-open semantics), driven by a new descriptor-driven adapter module (src/host-integration-adapters/cline-sdk-binding.cts); cite https://github.com/cline/cline/blob/main/docs/sdk/plugins.mdx. (2) createAgentModel model overrides — DefaultGateway.createAgentModel({providerId, modelId}) is wired so GSD's per-subagent model_overrides/model_profile_overrides resolution applies to Cline subagents (modelMode: active); cite https://github.com/cline/cline/blob/main/docs/sdk/reference/gateway.mdx. Cline's dispatch deliberately stays degraded/flat (maxDepth: 1, read-only, no nested spawning) per the documented host restriction — never silently upgraded to full nested/background. (#2090) (#2132)
Hermes Agent is now driven through the public Host-Integration Interface, with three capability upgrades (ADR-1239 / EoS). Hermes previously installed via hardcoded runtime === 'hermes'/isHermes branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded hermes branch is folded into descriptor-driven runtime.hostBehaviors. Three upgrades land: (1) real plugin hook vocabulary — GSD registers a new extensionEvents: "hermes" dialect carrying the 13 documented Hermes plugin events (pre_tool_call, post_tool_call, pre_llm_call, post_llm_call, on_session_start, on_session_end, on_session_finalize, on_session_reset, subagent_start, subagent_stop, pre_gateway_dispatch, pre_approval_request, transform_tool_result), replacing the borrowed hookEvents: "claude" 6-event surface that silently never fired; cite https://github.com/nousresearch/hermes-agent/blob/main/website/docs/user-guide/features/hooks.md. (2) dispatch posture — Hermes' dispatch.nested: true with maxDepth: 1 is correctly negotiated (not silently flattened). (3) branding/category metadata — DESCRIPTION.md category descriptions, version: frontmatter, and branding rewrites are now descriptor-driven rather than hardcoded. Install/uninstall output is byte-identical (golden parity asserted for all runtimes). (#2091) (#2134)
Qwen Code now projects GSD's specialist agents as native subagents — installing GSD into Qwen Code writes ~/.qwen/agents/gsd-*.md files you can invoke directly (planner, executor, code-reviewer, …) instead of reaching them only through skill prose, and a SubagentStart hook now fires alongside SubagentStop. Qwen's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2092) (#2153)
Kilo Code now supports native hooks, active-model routing, and named subagent dispatch — installing GSD into Kilo wires a lifecycle-hook plugin, keeps each agent's requested model instead of dropping it, projects GSD's specialist agents as invokable subagents, and documents the GSD MCP companion. Kilo's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2093) (#2156)
GSD skills installed for Trae now carry SOLO stage metadata — Trae's SOLO Agent can recognize GSD skills as workflow-stage skills for auto-invocation instead of requiring manual triggering. Several of Trae's install branches (shared-hooks gating, path rewrites) also move onto its capability descriptor. Note: the stage-metadata field is a best-effort/inferred shape — Trae publishes no formal schema. (#2094) (#2157)
Installing GSD into Antigravity now writes the permissions.allow rules its CLI documents — so GSD's own reads and hooks aren't stuck on interactive prompts — and registers GSD's companion MCP server via a standalone mcp_config.json (best-effort: Antigravity's raw config schema isn't published, so this uses the Gemini-CLI-successor format). Antigravity's install is now driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2096) (#2165)
Augment Code now installs through its capability descriptor, with a native MCP companion — installing GSD into Augment registers the GSD companion server in Augment's settings.json mcpServers and drives command/skill/agent conversion from Augment's negotiated descriptor instead of hardcoded runtime special-cases. (#2097) (#2166)
CodeBuddy now wires GSD's full extended lifecycle hook set and is driven by its capability descriptor — installing GSD into CodeBuddy now registers SubagentStart, SubagentStop, Stop, and PreCompact hooks in its settings.json (it previously had none of these), matching the coverage Qwen/Kimi already ship, and CodeBuddy's install is fully descriptor-driven instead of via residual hardcoded runtime branches. (#2098) (#2169)
GitHub Copilot now wires GSD's full lifecycle hook bus and is driven by its capability descriptor — installing GSD into Copilot registers preToolUse, postToolUse, userPromptSubmitted, and sessionEnd handlers in its hooks/gsd-session.json (beyond today's sessionStart-only advisory), and Copilot's residual hardcoded runtime branches are folded onto descriptor-driven hostBehaviors. (#2099) (#2172)
Windsurf now enforces GSD's write/command safety guards through Cascade's native hook bus — installing GSD into Windsurf registers blocking pre_write_code/pre_run_command hooks in .windsurf/hooks.json (exit-code-2 blocking) and drives Windsurf's install from its capability descriptor instead of hardcoded runtime branches. (#2100) (#2190)
ZCode's install is now driven and regression-tested through its capability descriptor — ZCode joins the dogfooded declarative-adapter reference hosts with a byte-identical install, and its shared-hooks exclusion is folded onto hostBehaviors instead of a hardcoded runtime branch. (Hook-automation and MCP upgrades remain blocked on ZCode publishing its on-disk config formats.) (#2101) (#2195)
Codex/OpenAI default models advance to the GPT-5.6 family (Sol/Terra/Luna) — the Codex runtime tier defaults and the openai provider preset now resolve to current-generation model IDs instead of the superseded GPT-5.4/5.5 line, so Codex users on default profiles get improved agentic coding (Sol) and lower costs (Terra/Luna) without changing any config. (#2122) (#2146)
Internal: the installer's program (display-name) + command (slash-invocation) chains are now single-source lookups — the 14-line program chain (an exact duplicate of runtimeLabel) → getRuntimeLabel, and the 14-line command chain (the per-runtime /gsd-new-project syntax: gemini /gsd:, codex $, cursor skill-mention, kimi /skill:, default /gsd-new-project) → new getRuntimeNewProjectCommand(runtime) helper (ADR-1239 Phase B / #1679 AC2 slice 4). runtime === count in bin/install.js: 53 → 25 (cumulative this session: 129 → 25). Stdout strings preserved byte-for-byte; no install-output change (golden-parity 16/16). No user-facing change. (#1813)
Internal: the installer's per-function is<Runtime> flag-declaration blocks are now a single runtimeFlags lookup — the four duplicated const isX = runtime === 'x' blocks in bin/install.js (uninstall / writeManager / install / a fourth helper — 48 branches) are collapsed into one runtimeFlags(runtime) helper in runtime-name-policy.cts (ADR-1239 Phase B / #1679 AC2 slice 3). The add-a-host tax for flags is removed (one RUNTIME_FLAG_IDS entry, not four declaration blocks). Install output is byte-identical for all 16 runtimes (golden-parity asserted); runtime === count in bin/install.js: 101 → 53. No user-facing change. (#1811)
Internal: third-party descriptor loader enforces configHome write-confinement at load time — loadRegistry({includeInstalled:true, configHome}) now rejects (skip + warn, fail-closed) any installed third-party host-plugin descriptor whose declared destSubpath resolves outside the supplied configHome, before it is composed into the registry (ADR-1239 Phase C-2 / #1681 slice 2). The configHome option is optional and backward-compatible (omitted → no load-time check; install-time gate still bounds writes). No user-facing change for existing flows. (#1808)
Internal: agent install for cursor/windsurf/augment/trae/codebuddy now flows through the descriptor path — ADR-1235 step 1 routes the trivial-converter runtime group's agents off the inline install() loop onto the descriptor-driven installRuntimeArtifacts path, applying the cross-cutting steps uniformly (pre-converter, no workflow-stamp). Agent output is byte-identical for all 16 runtimes (golden-parity asserted, global + local verified); no user-facing change. (#1764)
gsd-ui-checker gains an adversarial FORCE stance (LLM-playbook principle 16) — the only verdict-producing critic that lacked one now resists rubber-stamping UI-SPEC contracts, with BLOCK/FLAG/PASS classification. Based on arXiv 2505.23840 (third-person objective persona), 2506.04975 (objective-not-hostile persona). (#1584)
Internal: the declarative embedding adapter is now named + bound behind a minimal HostIntegrationInterface — createDeclarativeAdapter({runtime}) (new src/adapter-declarative.cts) delegates in-process to install-engine's installRuntimeArtifacts/uninstallRuntimeArtifacts, formalizing today's projection path as one of the two embedding adapters behind a common contract (ADR-1239 Phase C-1 / #1680 AC1). Output is byte-identical to today's install (gated by golden-install-parity). The full 6-point interface binding surface is deferred until the imperative adapter (AC2) fixes the shape (ADR-1239 open wire-shape question). No user-facing change — the adapter is not yet wired to any runtime path. (#1802)
Internal: getDirName is now derived from a documented runtime.localConfigDir descriptor field — each runtime's local content-rewrite directory (e.g. cursor→.cursor, copilot→.github) moved from a hand-maintained if-chain into its capability descriptor (ADR-1239 Phase B), so it can no longer drift from the registry. Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing change. (#1757)
Internal: copyWithPathReplacement converter selection is now data-driven — the installer's back-compat content-copy path replaced its 13 hardcoded runtime === 'x' flag chains with a single per-runtime dispatch table (ADR-1239 Phase B). Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing change. (#1759)
Phase-completion now writes Status: All phases complete instead of the overloaded bare Milestone complete — the phase-level completion verb (completePhaseCore) was writing the same bare 'Milestone complete' string that the milestone-close verb uses for terminal state, causing a phase-level verb to own a milestone-level field. Per ADR-2207, phase-completion now writes the existing intermediate value 'All phases complete' (already used in gsd2-import.cts); milestone termination (' milestone complete' / 'Awaiting next milestone') remains solely with the milestone-close verb. (#2204) (#2259)
#853 dispatch-flatten is now data-driven (ADR-1239 Phase B) — whether GSD backgrounds the plan/execute orchestrator is decided from a documentation-sourced backgroundDispatch capability per host (via gsd_run query dispatch-should-flatten) instead of a hardcoded runtime === 'codex' check. Cursor now backgrounds the orchestrator (its docs document backgrounded subagent nesting); codex unchanged; all other hosts run inline. Fail-closed to inline on any uncertainty. (#1719)
Internal: companion MCP server module (interface points 1 + 5) — handleMessage/runServer (new src/mcp-server.cts) is a minimal, dependency-free stdio JSON-RPC 2.0 server exposing gsd_invoke_command (→ the command-routing hub) + gsd_read_state/gsd_write_state (→ the Phase 3 stateIO seam), so any MCP-consuming host can drive GSD with no bespoke plugin (ADR-1239 Phase C-2 / #1681 slice 3a). Bin entry / packaging deferred to slice 3b. No user-facing change — the server is not yet wired to a bin entry. (#1809)
requirements mark-complete reports a per-surface write-set — the command now returns a per-requirement write_set (checkbox + traceability surfaces) and a write_set_complete that is true only when every surface of every requirement applied, so a partial (checkbox-only) reconcile can no longer masquerade as full success even inside a multi-ID batch. Introduces the reusable ADR-2143 §5/§6 Result / WriteSet contract. (#2251) (#2251)
Internal: the imperative embedding adapter now composes the capability registry behind the same HostIntegrationInterface — createImperativeAdapter({runtime}) (new src/adapter-imperative.cts) calls loadRegistry({includeInstalled:true}) (first-party-wins + consent + fail-closed — identical trust semantics to the CLI) and binds the engine surface behind the same contract the declarative adapter (AC1) satisfies, plus a registry accessor for an in-process host to bind its primitives to (ADR-1239 Phase C-1 / #1680 AC2). Concrete host binding is deferred to Phase 5. No user-facing change — the adapter is not yet wired to any runtime path. (#1803)
Internal: the model adapter seam exposes passive + active adapters selected by modelMode — createModelAdapter({modelMode}) (new src/model-adapter.cts): passive formalizes today's tier routing (delegates to model-resolver.resolveModelForTier), active is a host-supplied sendRequest seam (VS Code vscode.lm / pi providers), fail-closed until Phase 5 binds a concrete provider (ADR-1239 Phase C-1 / #1680 AC3). No user-facing change — the seam is not yet wired to any runtime path. (#1804)
Internal: derive the non-Claude runtime list from the capability registry — NON_CLAUDE_RUNTIMES is now computed from the capability registry instead of a hand-maintained literal, so it can no longer drift from the per-runtime descriptors. No user-visible behavior change (the list is identical). (#1728)
Honest verifier — verify-phase now abstains on non-inferable backstop truths instead of confidently false-passing them (#1154). When the spec's edge-probe marks a truth non-inferable (verification: backstop) and the verifier cannot confirm it with explicit evidence (a passing wired held-out/property test, or a directly-observed behavior), it now reports human_needed with reason insufficient_spec ("unverified — held-out test recommended") rather than a silent passed. Autonomous runs complete with "N unverified non-inferable checks"; interactive runs route to the end-of-phase human checkpoint. Inferable truths are never abstained (over-abstention guard); abstention is exogenous (driven by the tag, not self-judgment). Truth-axis mirror of the prohibition judgment-tier (ADR-550 D4). (#1738)
Document Claude Code's advisor-tool inheritance in the model-profiles reference: the session-level advisor is inherited by all GSD subagents and composes with per-agent tiering, with candidate executor/advisor pairings, when it is worth enabling, and the session-level (no per-agent control) constraint. (#1922)
Extraction discipline for strict-format agents (LLM-playbook principle 8) — gsd-doc-classifier and gsd-doc-synthesizer apply taxonomy/precedence rules directly without inventing content, reducing reasoning-induced format drift. Based on arXiv 2504.05081 (few-shot beats CoT for pattern tasks), 2506.00069 (terminal instruction placement), 2505.14810, 2505.11423. (#1584)
Internal: extracted the runtime-artifact install engine from bin/install.js — installRuntimeArtifacts/uninstallRuntimeArtifacts/installOpencodeFamilySkills and their helpers now live in a dedicated gsd-core/bin/lib/install-engine.cjs module (ADR-1239 Phase B), so adapters can import the install pipeline instead of reaching into the 12k-line installer. Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing behaviour change. (#1735)
MemPalace memory_mode kg_backend and replace are now functional — selecting either mode now routes recall through the palace instead of silently behaving like augment: kg_backend treats the palace temporal KG as the primary knowledge-graph source (native .planning/graphs/ as fallback), and replace resolves recall through the palace as the source of truth. Every mode stays default-resilient — an unreachable palace falls back to native memory and no memory is lost. (#2010) (#2010)
/gsd:surface and --materialize now produce byte-identical agent output to a fresh install — surface-path agents for descriptor-driven runtimes (cursor, windsurf, augment, trae, codebuddy, copilot, antigravity) now receive the same path-prefix rewrite, Co-Authored-By attribution, runtime-specific conversion, and body normalization as the install path. Copilot and Antigravity agents are now installed via the descriptor-driven path (copilot agents get the .agent.md filename rename). Cline remains on the inline loop (rules-only local branch). (#1575) (#2040)
Internal: hook-bus + stateIO adapter seams — createHookBus({bus}) (new src/hook-bus.cts, host/engine/none — engine is in-process pub/sub, host fail-closed, none silent) + createStateIO({io}) (new src/state-io.cts, filesystem/sandboxed-storage/session-log-append — filesystem delegates to fs, the rest are fail-closed seams) (ADR-1239 Phase C-1 / #1680 AC4). Completes the Phase 3 adapter seam layer; concrete host binding is Phase 5. No user-facing change. (#1805)
Long-context model names render compactly in the statusline — the verbose " (1M context)" suffix Claude Code appends to the model display name now collapses to a compact " (1M)" badge (tolerant of future window sizes and the abbreviated "ctx" variant: "(500K context)" → "(500K)", "(1M ctx)" → "(1M)"). Lossless — the long-context signal stays, the 12 characters of width don't. (#2160) (#2173)
Lazy-split plan-phase.md into a steps/ directory — ~4.7 KB lighter eager context per /gsd-plan-phase call via byte-invariant progressive disclosure (ADR-1610). (#1852) (#1934)
GSD subagents now self-load configured agent_skills regardless of orchestrator bash — projects that map skills via .planning/config.json agent_skills.<agent-type> no longer silently lose them on /gsd-autonomous or Cursor, where Skill()-delegated workflow bash init did not reliably run. Each of the 22 consumer agents queries its own type at init and reads the listed skills, with a dedup guard so runtimes that also inject orchestrator-side (Claude Code) never carry two copies. (#1866) (#1868)
Internal: install/uninstall runtime labels are now sourced from a single getRuntimeLabel lookup — the two duplicated runtimeLabel assignment chains in bin/install.js (uninstall + install) are collapsed into one curated label table in runtime-name-policy.cts, sibling to the registry-derived getDirName (ADR-1239 Phase B, #1679). Install output is byte-identical for all 16 runtimes (golden-parity asserted). Two console-label inconsistencies are normalized as a side effect: kimi shows 'Kimi CLI' in both sites, and cline uninstall no longer falls through to 'Claude Code'. (#1800)
Phase plans now lead with a verified end-to-end "tracer" slice by default — every plan starts with one thin, production-quality slice wired through every layer, which the executor verifies before building out the remaining tasks, so an architectural dead-end surfaces after one commit instead of after ten. Pass --no-tracer to restore the previous horizontal-layer default; --mvp now layers user-story framing and the Walking Skeleton on top of the tracer-first ordering. (#1945) (#2294)
Internal: external-descriptor trust gate — load-time configHome confinement — assertDescriptorConfined(descriptor, configHome) (new src/external-descriptor-trust.cts) fail-closed rejects any installed third-party host-plugin descriptor whose declared destSubpath resolves outside the user-approved configHome, before its install plan runs (ADR-1239 Phase C-2 / #1681 slice 1). Defense-in-depth load-time twin of Phase 2's install-time assertDestWithinConfigHome. Not yet wired into the loader (slice 2). No user-facing change. (#1806)
Internal: the installer's runtime → global-config-home hook-pathogen fragment is now a single getGlobalConfigHomeFragment lookup — the 14-branch if (runtime === 'x') return "'...'" chain in getConfigDirFromHome (bin/install.js, the hook path.join() codegen mapping) is collapsed into one table in runtime-name-policy.cts, sibling to getRuntimeLabel (ADR-1239 Phase B, #1679 AC2 slice 2). Generated hook output is byte-identical for all 16 runtimes (golden-parity asserted); antigravity's dynamic env-overridable resolution is preserved in the caller. No user-facing change. (#1801)

Removed

Removed the sunset Gemini CLI runtime — use Antigravity CLI instead — Google discontinued Gemini CLI on 2026-06-18, so npx gsd-core --gemini now prints a deprecation notice and points you to Antigravity CLI (the official successor), which GSD already ships as a first-class runtime. (#1928) (#1996)

Fixed

The verify-work security-blocked presentation no longer offers next-phase planning. When security enforcement blocks phase advancement (no SECURITY.md produced), the workflow now routes only to the current-phase fix instead of competing /gsd:plan-phase {next} and /gsd:execute-phase {next} options. (#1687)
milestone complete and roadmap analyze now exclude the Phase 0 / Phase 999 backlog sentinels. A milestone whose only directory-less ROADMAP heading is a backlog sentinel can be completed without --force, and roadmap analyze no longer counts the sentinel in phase_count or routes next_phase into it. Completes the ^999 exclusion #1445 added to the progress denominators. (#1691)
config-set no longer silently coerces values into something the disk never sees — Number.isFinite replaced !isNaN in the value parser so Infinity/-Infinity are no longer coerced to non-finite numbers that JSON.stringify then renders as null on disk while the CLI echoes Infinity (output ≠ disk). context_window now has a per-key validator requiring a finite positive integer (rejects Infinity, 0, negatives, non-integers with a non-zero exit), and project_code is always persisted as a string so a leading-zero code like 007 survives verbatim instead of collapsing to 7. Numeric coercion for genuine numeric keys (e.g. granularity 42) is unchanged. (#1581) (#2023)
phase.complete no longer reports a false is_last_phase on a <details>-wrapped checkbox checklist (#1591, #1752) — when the active milestone's phase checklist was written as - [ ] Phase N: checkbox items inside a <details> block and the next phase had no directory on disk yet (still in planning), phase.complete's isLastPhase roadmap-enumeration fallback used a heading-only pattern (/#{2,4}\s*Phase…/) that never matched checkbox items. It returned is_last_phase: true, next_phase: null on a mid-milestone phase and — via the milestone-complete cascade — wrongly flipped STATE.md to Milestone complete and decremented progress.total_phases (e.g. 8 → 7). The pattern now matches heading-style (### Phase N:), plain checkbox-list phases (- [ ] Phase N: / - [x] Phase N:), and the canonical bold checklist form the roadmap template emits (- [ ] **Phase N: Name**); extractCurrentMilestone already surfaces the <details>-wrapped checklist correctly, so no parser change was needed. Only the reproduced phase.complete fallback is changed; the heading-only sibling patterns elsewhere in phase.cts are untouched. (#1819)
The <agent_skills> block emitted by gsd init no longer leaks backslash paths into @-reference skill paths on Windows. The global skill directory (a native path.join result) was interpolated into the generated markdown without POSIX normalization, producing references like @C:\…\skills\name/SKILL.md; the reference is now normalized at the emit site so skill references use forward slashes on every platform. (#1736)
/gsd-settings no longer warns about four search-provider keys on fresh projects (#1747) — buildNewProjectConfig emits seven search-provider availability flags and research-provider.cts providerAvailability() consumes all seven, but only three were registered in VALID_CONFIG_KEYS (config-schema.manifest.json). Running /gsd-settings on a freshly generated .planning/config.json printed unknown config key(s) … tavily_search, ref_search, perplexity, jina — these will be ignored even though the user never hand-edited the config. The four missing keys are now registered alongside brave_search/firecrawl/exa_search and documented in docs/CONFIGURATION.md; a drift guard in tests/bug-2530-valid-config-keys.test.cjs now requires every config-driven research-provider flag to be in the schema, so a future provider addition cannot reintroduce the drift. (#1814)
gsd-tools state json no longer reports conflated progress for an unversioned milestone (#1761) — the ADR-1769 Phase 7 fix (#1794) taught state sync to leave Progress untouched when a milestone version is asserted but the ROADMAP has no versioned heading for it, but the state json read path still rebuilt progress via buildStateFrontmatter, whose phase-heading count fell back to the whole document and summed sibling milestones. state json therefore reported a conflated total_phases (e.g. 8 = 4+4 across two milestones) plus a derived percent, contradicting the sync guard on the very same project. The read path now mirrors the sync guard: when the asserted milestone cannot be bounded to a versioned ROADMAP heading, total_phases falls back to the on-disk phase-dir count and percent is omitted. Bounded milestones (versioned ROADMAP, or no milestone asserted) are unchanged; the signal rides on the existing _diskScanCache so extractCurrentMilestone's return contract and its other callers are untouched. (#1818)
gsd-graphify-update.sh now reads the full multi-line command in Gate 2 (#1772) — the PostToolUse auto-update hook joined tool_name + \n + tool_input.command and extracted the command with sed -n '2p' (line 2 only). Agent runtimes (Claude Code's Bash tool among them) routinely emit HEAD-advancing commits as multi-line scripts (cd /path, then git add, then git commit …), so line 2 was the cd, Gate 2's *"git commit"* match failed, and the rebuild silently no-op'd on real commits even with graphify.auto_update: true. The failure was invisible in manual probes because a single-line git commit -m x passes line 2 verbatim. The hook now captures line 2 through EOF (sed -n '2,$p') so the case glob sees the full command string; single-line behavior is unchanged and multi-line commands without a HEAD-advancing op still no-op cleanly. (#1815)
/gsd-thread close|resume now writes the thread status/updated frontmatter (#1778) — the thread workflow's CLOSE and RESUME branches invoked frontmatter.set with the pre-1.6 fully-positional shape (frontmatter.set <file> <field> <value>), but since 1.6 the dispatcher parses the file positionally and reads field/value from the named flags --field/--value via parseNamedArgs. The positional form left field/value undefined, cmdFrontmatterSet errored file, field, and value required, and the writes were silently skipped — so closing a thread never marked it status: resolved and resuming never marked it status: in_progress, with the error scrolling past on every thread command. All four sites (CLOSE status+updated, RESUME status+updated) now use the 1.6 hybrid form that verify-work.md already uses (frontmatter.set <file> --field <field> --value <value>). (#1816)
The installer no longer copies dead lifecycle hook scripts for ZCode — it declares hooksSurface: 'none' and has no plugin surface, so the staged hooks/*.js, hooks/*.sh, hooks/lib/ and the CommonJS package.json marker were dead weight in ~/.zcode/. The hook-copy guards in install.js now exclude ZCode alongside the other no-hook runtimes. OpenCode, which also declares hooksSurface: 'none', is deliberately kept: its native plugin adapter (#1914) spawns those staged hooks via OpenCode's event bus and needs both them and the marker. (This fix originally excluded Kilo too, on the premise that it had no plugin surface; that premise was wrong — Kilo's native plugin spawns the staged guard hooks, exactly like OpenCode's — and #2327 reverses the Kilo half.) (#2057)
Test gates can no longer hang forever on a watch-mode test runner. vitest defaults to watch mode in an interactive terminal (exactly where gsd-execute-phase runs), so a resolved npm test / pnpm test that maps to vitest never exited and the orchestrator waited indefinitely until the user manually intervened. Every GSD test-command gate — the regression gate, the post-merge gate, the audit-fix gate, and the verify-phase gate — now routes the resolved command through a shared normalize-test-command helper that rewrites it to a one-shot form (direct vitest → vitest run; jest --watch → --watchAll=false; a package-manager test script backed by watch-vitest → CI=true prefix; already-one-shot commands are left unchanged). The three gates that previously hung or silently continued — the regression, post-merge, and audit-fix gates — additionally bound execution with a configurable workflow.test_gate_timeout (default 600s), aborting or surfacing the cause on timeout instead of hanging; the verify-phase gate was already bounded (a fixed 5-minute limit) and keeps it, now naming watch mode on timeout. The normalizer only rewrites a runner named as a standalone command token (so paths/targets like run-vitest.js are never mangled), is length-capped and linear-time on adversarial input, and only reads a regular-file package.json. (#2060)
settings-advanced.md no longer has an orphan </step> around §8 Model Policy — the §8 Model Policy block ended with a closing </step> but had no matching opening tag (5 opens / 6 closes), leaving its content as loose inter-step prose that could fail to execute reliably. Added the missing <step name="model_policy"> opener so the section is a proper step. A new workflow <step>-tag-balance regression guard (fenced-code-stripped) now blocks any future orphan tag across all top-level workflows. (#1864) (#2014)
The runtime launcher now honors CLAUDE_CONFIG_DIR — the gsd_run preamble embedded in every workflow/agent resolved the Claude global install only at $HOME/.claude/gsd-core/bin/, while the installer honored CLAUDE_CONFIG_DIR, so a global install redirected via CLAUDE_CONFIG_DIR was invisible to every gsd_run call (every GSD command failed with gsd-tools.cjs not found). The Claude resolver arm now uses ${CLAUDE_CONFIG_DIR:-$HOME/.claude} — matching the installer and the other runtimes' ${VAR:-default} pattern — so a custom CLAUDE_CONFIG_DIR is found and the default $HOME/.claude path is unchanged. Re-synced into all 95 workflows/agents; two capped workflows trimmed to stay under their byte budgets. (#1865) (#2024)
Node-test prohibition proofs now require a clean-fixture causation control — a node-test prohibition's fail-first proof no longer accepts a deceptive content-independent negative test (one that reds merely because GSD_PROHIB_SUBJECT is set, ignoring the subject's content). The check_clean_fixture control is now mandatory for the node-test kind: a descriptor that omits it is un-provable and hard-gates, rather than greening on the violation alone. Breaking (Hyrum): a previously-green node-test prohibition with no clean fixture now hard-gates — blast radius is zero in-tree (no node-test prohibition ships today). The lint-rule kind is unchanged (its subject IS the linted file, no GSD_PROHIB_SUBJECT indirection). (#1906) (#2001)
Third-party capabilities now work on installed layouts. capability install no longer rejects capabilities with a real engines.gsd range as "incompatible with GSD 0.0.0" — the host version is now read from the authoritative gsd-core/VERSION file across every runtime and the capability install CLI. The installer also now ships the registry generator scripts (gen-capability-registry.cjs, gen-loop-host-contract.cjs), so installed third-party capabilities actually compose into the loop instead of being silently discarded. (#1938)
/gsd:verify-work preserves verification state across gap-closure execution and no longer auto-promotes deferred follow-ups into blocking gaps — resuming after /gsd:execute-phase --gaps-only used to lose the verification state: the UAT ## Gaps still read status: failed even after their fix plans executed, so verify-work re-diagnosed them as fresh blockers, spawned a new gap plan, and reported only the new plan as verified. A state contract now links each gap to its fix plan: every UAT gap carries a stable gap_id (G-{phase}-{N}), gap-closure plans tag the ids they address in their frontmatter (gap_ids: […]), and a new reconcile_gaps step on resume marks a gap status: resolved when its plan has a matching *-SUMMARY.md — so fixed gaps aren't re-diagnosed and the phase can close. Separately, a deferred-follow-up branch captures future-work ideas (signals like "later", "next version", "out of scope") into a ## Deferred Follow-Ups section instead of creating a blocking gap/plan. (#1921) (#2025)
roadmap update-plan-progress no longer counts stray non-plan *-SUMMARY.md files against phase completion — remediation/gap-closure summaries (e.g. 30-FIX-CR02-SUMMARY.md, 30-GAPCLOSURE-SUMMARY.md) inflated summary_count, and once summary_count >= plan_count the phase silently flipped to Complete (checkbox checked, date stamped) even though several plans had no summary. A new countMatchedSummaries helper (core-utils) pairs summaries to plans via the PLAN→SUMMARY marker swap + the <stem>-SUMMARY.md form (layout-agnostic across root, bare, and nested layouts), so only a summary that corresponds to a real plan counts. Wired into scanPhasePlans (fixing roadmap listing, state sync, verification, workstream inventory at once) and cmdRoadmapUpdatePlanProgress. (#1988) (#2016)
milestone complete --ws requirements archive header now points at the workstream REQUIREMENTS.md — the archive header string hardcoded the root path (`…see .planning/REQUIREMENTS.md`), so a workstream archive directed readers at the wrong file even though #1917 had already fixed the archive locations to land inside the workstream. The display path is now derived from the same workstream-aware reqPath the writer uses (path.relative(cwd, reqPath)), so root behavior is byte-identical and the workstream case correctly reads .planning/workstreams/<ws>/REQUIREMENTS.md. (#1993) (#2015)
Load-failed capability gates now fail open with a loud warning instead of blocking the whole project — when an installed overlay (third-party) capability failed to load (e.g. an incompatible engines.gsd range) but had declared a gate-kind loop hook, the loop resolver injected a blocking synthetic gate (blocking:true, onError:halt) at every point where that capability declared a gate. A single incompatible capability therefore halted every ship:pre and verify:post in the project — unrelated to what the gate would have checked, and with no remediation surfaced. The resolver now injects no gate and instead emits a loud warning — to stderr and in the loop render-hooks envelope's warnings array — naming the load-failure reason and the exact gsd capability remove <id> remediation, and the loop proceeds (fail open). The capability id embedded in that remediation is validated against the canonical id shape first, so a malformed overlay directory name cannot inject shell metacharacters into the surfaced command. The loader still records _overlay.blockedGates; only the consequence changes from block to warn. step/contribution overlays were already skip-open. (#2009) (#2075)
phase.complete now updates the ## Progress rollup row even when an earlier phase-numbered table precedes it — the Progress-row writer used a non-global regex that matched any table row starting with the phase number, so it bound to the first such row (e.g. a | Phase | Requirements | Count | coverage table), no-op'd on the wrong 3-column row, and never reached the real Progress row. The regex is now scoped to the ## Progress section so it binds to the correct table. The command still returned roadmap_updated: true (that field is fs.existsSync(ROADMAP.md)), masking the silent failure. (#2012) (#2032)
context7 now works for plugin-marketplace installs (8 agents regained doc lookup) — the agents granted only mcp__context7__*, which matches a standalone context7 MCP server but not the official Claude Code plugin-marketplace install (context7@claude-plugins-official), whose tools are named mcp__plugin_context7_context7__*. The grant never matched, so advisor/ai/domain/phase/project/ui-researcher + planner + executor silently lost documentation lookup and fell back to WebSearch. All 8 agents now grant both forms, the researcher profile table is updated, and a parity guard asserts no agent grants the standalone form without the plugin form. (#2017) (#2029)
applySurface no longer deletes every gsd-* agent when the skills manifest resolves empty — the agent-prune loop in _syncGsdDir deleted any gsd-*.md not in the staged set, and when the manifest was empty/unresolvable (null manifest, no array entries, no files key, or an unresolvable install source root), the staged set was empty → every agent was pruned. Skills were guarded by pruneSkillDirs's manifest-membership check (conservative preservation on empty manifest); agents had no equivalent. The agent-prune loop is now skipped when the manifest is empty/absent, so agents are preserved while copy (adding genuinely new agents) still runs. (#2018) (#2031)
planning-config.md global-learnings path corrected to ~/.gsd/knowledge/ — the features.global_learnings row directed users to ~/.gsd/learnings/, but the implementation (src/learnings.cts, execute-phase.md) stores and reads global learnings from ~/.gsd/knowledge/. Anyone following the docs to inspect, back up, or seed their global learnings looked in a directory the code never touches. (#2019) (#2026)
Removed dead SDK file references from runtime-loaded markdown that triggered an infinite find.exe storm on Windows — agents/gsd-executor.md pointed at sdk/src/query/QUERY-HANDLERS.md and gsd-core/workflows/reapply-patches.md at sdk/dist/cli.js, both retired with the SDK package (ADR-0174). AI runtimes that resolve doc references by filesystem search ran find / -iname …; on Git Bash for Windows / maps to the drive root, so find.exe traversed the whole disk (14h+, orphaned processes, 4M+ open handles each, unkillable). The references now resolve to live paths, and a new regression guard asserts no sdk/src|sdk/dist|sdk/handlers file references remain in agents/workflows/references markdown. (#2020) (#2027)
roadmap update-plan-progress no longer checks the phase checkbox without verification — the command stamped the phase-level ROADMAP checkbox and completion date the moment the last plan summary landed (called routinely after every wave and every plan), with no verification gate — unlike phase.complete which correctly requires readVerificationStatus(...).status === 'passed'. Now isComplete requires both all plan summaries AND a passed verification, matching the cmdPhaseComplete contract, so the checkbox only fires after gsd-verifier has confirmed the phase. (#2022) (#2030)
phase complete no longer marks a milestone done out of order, nor silently writes root state in workstream mode. Completing the numerically-highest phase while an earlier phase was still outstanding wrongly flipped STATE.md to Status: Milestone complete (the milestone-end check only looked for higher-numbered phases, so an out-of-order completion — e.g. Phase 10 before Phase 9 — read as the end). It now reports milestone-end only when every lower-numbered phase in the milestone is checked complete. Separately, in workstream mode with no active workstream, phase complete previously fell back to root .planning and wrote STATE.md/ROADMAP.md (and the mislabel) into the shared root other workstreams read; it now fails safe — asking for --ws <name> or an active workstream — mirroring the existing init progress guard. (#2066) (#2066)
Phase directories whose slug begins with a single digit now resolve correctly. A phase like 46-6-rs-pipeline-orchestrator (roadmap name "6 Rs Pipeline Orchestrator") had its phase token over-collected as 46-6 instead of 46, so gsd-tools phase-by-number lookups resolved phase_dir=null / has_context=false (breaking init.plan-phase, init.phase-op, and downstream execute/verify/ship). Numeric phase-token components must now be zero-padded (≥2 digits), so a single-digit slug word is no longer absorbed into the token. Fixed consistently across every same-class implementation — extractPhaseToken, PHASE_TOKEN_FROM_DIR_RE and canonicalPlanStem (health checks / plan pairing), isDirInMilestone's numeric matcher (milestone filtering), and extractCanonicalPlanId — so the health-check and milestone-filter subsystems are fixed alongside phase resolution. (#2059)
gsd-tools config-set <key> null now clears (removes) the key instead of persisting the literal string "null". The documented "Clear" action previously fell through the value parser and stored "null" — a truthy value — so "cleared" keys stayed set and config-get returned "null"; for secret keys (brave_search/firecrawl/exa_search) a masked success line hid a truthy value on disk that integrations could pass along as a real credential. config-set <key> null now deletes the key (short-circuiting the typed per-key validators so clearing an enum/boolean/number key removes it rather than being rejected), making the "Clear" flows in settings-integrations.md / settings-advanced.md actually clear. (#2058)
init plan-phase no longer collapses foreign-prefixed task/workstream IDs into numeric phases — a query like MEM-01 (where MEM is not the configured project_code) used to have its prefix stripped and resolve to the unrelated numeric Phase 01; it now reports phase_found: false unless a phase directory or roadmap entry literally carries that prefix. The configured project_code's own prefixed phases (e.g. LKML-01 under project_code: LKML) continue to resolve as before. (#2056) (#2105)
phase complete no longer ticks the wrong phase's ROADMAP checkbox — completing a phase whose number also appears in a later phase's description (e.g. an idempotent re-run of an already-complete phase) used to mark the wrong phase done, because the checkbox-matching regex greedily spanned from ] to any later "Phase N" mention instead of only the immediately-following phase title. (#2067) (#2079)
gsd-tools effort sync no longer crashes in an installed runtime. In any global install (e.g. ~/.claude/gsd-core/), effort sync threw Cannot find module '../../../bin/install.js' — the command reached into the package-root bin/install.js for its install-time effort resolvers, but the installer only copies the gsd-core/ subtree into a runtime home, so that file is never present there. As a result, effort config changes (routing_tier_defaults / agent_overrides) silently never reached installed agents without a full reinstall. The two resolvers (readGsdEffectiveEffortConfig + resolveInstallTimeEffort, with their helpers) are now extracted into a shipped gsd-core/bin/lib/install-effort-resolver.cjs that both effort sync and the installer import — a single source of truth that is always present in the installed tree. (#2076) (#2076)
model_overrides and per-phase-type models now actually apply to the assumptions-analyzer, code-reviewer, and code-fixer agents on Claude Code. Previously model_overrides["gsd-code-reviewer"] / ["gsd-assumptions-analyzer"] / ["gsd-code-fixer"] (and models.verification / models.discuss / models.execution) were accepted and resolved but silently dropped — the workflows spawned these agents with no model, so they inherited the session model and the configured routing never took effect (no warning). Every spawn now threads its resolved model: discuss-phase-assumptions, code-review, and code-review-fix (both the re-review and the two fixer spawns) resolve it inline, and quick's review step uses the code-reviewer's own resolved model instead of the executor's. The stale "discuss — reserved, no subagent" model-profile docs are corrected to list gsd-assumptions-analyzer, and the verification row now includes gsd-code-reviewer. (#2074) (#2074)
/gsd-review's Antigravity CLI reviewer no longer fails silently on large prompts, unavailable pinned models, or pre-session stalls — the agy invocation now uses a file-reference prompt to avoid exec arg-list overflow, is wrapped in an external wall-clock timeout paired with --print-timeout because --print-timeout cannot fire before agy creates a session, passes --model from review.models.agy when set as an escape hatch for a 404'd pinned model, and its empty-output stub now surfaces an agy cli.log diagnostic instead of a bare generic message. Supersedes the #687 "no external killer / inline $(cat)" contract, which predated agy gaining --model and predated its own guidance to pair --print-timeout with a terminal timeout. (#2073) (#2109)
init execute-phase, init verify-work, and init phase-op no longer collapse foreign-prefixed task IDs to numeric phases — MEM-01 under project_code: LKML was silently stripped to 01 and resolved to the unrelated numeric Phase 01, because the #2056 guard was applied only to init plan-phase. The guard is now extracted into shared helpers (guardedFindPhase / guardedGetRoadmapPhase) that delegate to the canonical isForeignPrefixedPhaseQuery from phase-id.cts, and all four init commands route through them. (#2104) (#2149)
commit --files now commits only the declared paths — gsd-tools commit --files A B previously ran a bare git commit that absorbed the entire staged index, silently sweeping in unrelated files the caller never named. The commit now appends a pathspec (-- <paths>) so only the staged subset of --files lands in the commit; the no---files default path is unchanged. Missing tracked files are still skipped (not committed as deletions, #2014), and when all declared files are missing the function short-circuits to nothing_to_commit instead of absorbing the index. (#2112) (#2148)
Fixed unresolvable bare require('gsd-core/...') in gsd-surface command doc — the four require() examples now derive the engine path from runtimeConfigDir (resolvable at runtime), and the reinstall hint corrects npm i -g gsd-core to npm i -g @opengsd/gsd-core. (#2116) (#2213)
milestone complete --dry-run now prints a preview plan instead of silently mutating — gsd-tools milestone complete --dry-run was neither parsed nor rejected, so a caller expecting a preview triggered the full destructive mutation (archive phases, move audit artifacts, rewrite STATE.md) with no way to back out. The --dry-run flag is now honored: it returns a JSON plan listing would_archive (roadmap, requirements, audit, phase dirs) and would_update (MILESTONES.md, STATE.md) targets with zero filesystem mutations. (#2118) (#2155)
/gsd-secure-phase now has a single SECURITY.md writer — the gsd-security-auditor subagent previously held Write/Edit tools and was instructed to "write SECURITY.md" with no padded <N>- prefix and no template frontmatter, while the orchestrator's Step 6 also wrote the phase-scoped <N>-SECURITY.md from templates/SECURITY.md. The auditor is now return-only (drops Write/Edit, returns a structured verdict with threats_open); the orchestrator is the sole file writer. The workflow's Step 5 spawn constraints explicitly forbid the auditor from writing SECURITY.md. (#2119) (#2154)
Dead security scan exports removed; injection-scan docs corrected to match reality — scanEntropyAnomalies and shannonEntropy were dead code with zero production callers (live hooks inline their own patterns for independence). REQ-SCAN-INJ-02/-03 now accurately describe what runs live (injection patterns, invisible Unicode) vs CI-only (base64-decode, codebase scan). (#2198) (#2211)
Post-merge, regression, and other GSD test/build gates no longer fail with a spurious "command not found" on stock macOS. These gates hardcoded GNU coreutils' timeout, which stock macOS ships neither as timeout nor gtimeout; a passing build or test run now completes under a portable, coreutils-independent run-with-timeout wrapper instead of exiting 127 and being misreported as a failure. (#2351) (#2426)
Installed third-party capability skills now materialize on OpenCode and Kilo — capability install + capability set --runtime opencode (or kilo) could report a capability as installed: true, surfaced: true, active: true while its skill was never written to skills/gsd-<stem>/SKILL.md: the OpenCode/Kilo combined-family install path never called the seam #2322 fixed for other runtimes. Installed capability skills now materialize the same way there too, bound to their declaring capability, with first-party skills always winning a name collision. (#2362) (#2434)
Shared requirement IDs across multiple plans no longer read Complete before every declaring plan (and phase verification) has finished — execute-plan.md now gates completion on sibling plans' SUMMARY.md files via a new read-only requirements ready-ids check, and a gaps_found phase verification reverts any requirement ID this phase owns back out of Complete before the gap report renders. Single-plan requirement IDs are unaffected — no added latency. (#2388) (#2424)
phase.add no longer silently mistakes a goal-shaped description for a phase title — a long or multi-sentence description used to land verbatim in the ### Phase N: header with no signal anything was off; phase.add now returns a warning field when the description looks goal-shaped, and the phase-number auto-detect docs now correctly point callers at the orchestrating workflow instead of implying gsd-tools.cjs resolves it itself. (#2390) (#2425)
response_language now reaches orchestrator-owned prompts across most workflows and the UAT verification checkpoint frame — previously only subagent prompts honored a configured response_language; the orchestrator's own questions (verify-work, new-project, new-milestone, quick, manager, and others) and the hardcoded English UAT checkpoint banner stayed in English regardless of configuration. Both now render in the configured language, with output byte-identical to before when unset. (#2402) (#2457)
Codex installer no longer double-registers each agent role in config.toml, eliminating one duplicate-role startup warning per agent — generateCodexConfigBlock stopped emitting [agents.gsd-*] tables whose config_file pointed back at the same standalone TOMLs Codex already auto-discovers under $CODEX_HOME/agents/; reinstalling over an existing config also drops any legacy managed role tables left by a prior install while preserving unrelated user config and the user's own AgentsToml scalars. (#2406) (#2432)
Production dependency tree carries no known advisories — five advisories disclosed against the transitive tree under @anthropic-ai/claude-agent-sdk → @modelcontextprotocol/sdk were cleared: fast-uri (GHSA-4c8g-83qw-93j6, high) and hono (GHSA-xgm2-5f3f-mvvc, GHSA-hvrm-45r6-mjfj, GHSA-w62v-xxxg-mg59) re-resolved to patched releases inside their already-declared ranges with no package.json change, and @hono/node-server (GHSA-frvp-7c67-39w9) pinned to >=2.0.5 via overrides because @modelcontextprotocol/sdk@1.29.0 — already the latest published version — still declares the vulnerable ^1.19.9 range. npm audit --omit=dev reports zero advisories. (#2496) (#2497)
Custom STATE.md frontmatter keys are no longer dropped on every mutating verb — syncStateFrontmatter rebuilt the frontmatter from a fixed schema, silently dropping any custom key. It now carries forward existing keys the schema does not own. (#2202) (#2233)
Non-frontend phases with UI hint: no are no longer blocked by the UI-SPEC gate — the UI safety gate's token list included the bare token UI, which matched GSD's own **UI hint**: no metadata line and false-detected a UI, blocking backend/infra phases at /gsd-plan-phase. An explicit UI hint: yes|no is now authoritative and the hint line is no longer token-sniffed. (#2150) (#2222)
OpenCode reviewer no longer silently yields an empty review on large prompts — /gsd-review --opencode now invokes opencode run --format json and reconstructs the review from the assistant text parts, so a large-prompt run where the default build agent ends its turn with zero output tokens no longer produces an empty stub. When the agent genuinely emits no text, the stub now reports the stop reason, output-token count, and captured stderr instead of a generic message. (#1936) (#1992)
OpenCode's first-time install baseline now protects pre-existing files under the commands/ directory, not just the legacy command/ alias — after #2329 moved OpenCode command materialization to commands/, the baseline scan that guards a machine's very first GSD-tracked install still only knew about the legacy command/ directory, so a pre-existing, unrelated commands/gsd-*.md file was silently deleted by ordinary command materialization instead of blocking the install for an explicit keep/remove choice — the same protection command/ already had. The scan now covers both directories. Kilo is unaffected and keeps using command/. (#2354)
api-coverage detector no longer false-positives non-API phases (and no longer fails open) — the external-API-integration detector behind the blocking verify:pre seal gate required only same-line co-occurrence of an integration verb and an API noun, treated / as a word boundary (so first-party Next.js src/app/api/… route paths matched), and read any capitalized word before API/SDK/REST/GraphQL as a service name (so threat-model prose like "Resolver-only API" fired). It is now fail-closed: the compound rule requires the integration verb and API noun to share one clause (the clause boundary is the whole relationship test — no fragile word-gap cap that a genuine long integration clause would trip); fenced code, inline code spans, and path-shaped tokens are excluded before matching while external hosts like api.stripe.com/v1 still count; and the <Service> API surface rule rejects stopwords, locality/protocol descriptors ("Internal API", "REST API"), compound modifiers, and first-party-qualified services, so a real vendor name (Stripe API) fires from any clause position. A phase that integrates no external API can declare it first-class in COVERAGE.md — No external API integration: <reason> — instead of fabricating a matrix row; when the detector still finds signals, the declaration overrides but the gate surfaces the overridden signals so the contradiction is visible. Because a false positive is cheaply dismissed by that declaration while a false negative silently slips a real API phase past the gate, the detector deliberately leans toward detecting. (#2365) (#2397)
stale-bake-guard hermeticity fix (test-isolation) — the readGsdEffectiveModelOverrides subtest no longer reads the developer's real ~/.gsd/defaults.json; the resolver now accepts a homedir seam so the test sandboxes HOME. (#2152) (#2223)
/gsd-surface (list/status) works on Claude Code global installs — the installer now writes a .gsd-source marker pointing at its commands/gsd source, so findInstallSourceRoot resolves on the global skills layout (which ships no commands/gsd tree) instead of throwing could not locate commands/gsd. (#1487) (#1487)
Cursor no longer shows every /gsd-* command twice — a --cursor install wrote both a skill and a slash command for each action, so every GSD entry appeared twice in Cursor's / menu. GSD now installs Cursor skills as user-invocable: false (matching the existing CodeBuddy behavior), so the slash command is the single / entry point while skills remain model-invocable. (#2341) (#2386)
phase complete --phase N now works alongside the positional form — the phase verb family treated the first positional as the phase number, so --phase 12 was passed as the literal phase name and failed with 'Phase --phase not found'. The phase family now accepts the --phase flag consistently with the state family, and unrecognized flags yield a usage error. (#2201) (#2231)
Third-party capability skills now surface correctly after install — a skills-only role: feature capability installed active but its skills never reached the runtime surface, capability enable/set rejected it as unknown capability, and capability list disagreed with capability state. resolveSurface now unions the composed registry's capabilityClusters into the surfaced skill set (no on-disk linking), the writer validates against the composed overlay-aware registry, and capability list carries a surfaced field matching capability state. (#2054)
/gsd-ship no longer emits a 100%-missing TDD Audit noise table — the TDD Audit PR-body section was always emitted, but the execute pipeline only writes gate_status: git trailers when TDD mode is active. Without TDD mode (the default), every commit was counted missing and the table was pure noise with no way to disable it. The section is now gated behind workflow.tdd_mode: when TDD mode is off, both the TDD Audit section and the aggregate gate_status: trailer are skipped entirely; when on, the existing behavior is preserved. (#2467)
phases.clear now archives phase history under the outgoing milestone version, not the newly-switched one — because new-milestone advances the milestone before clearing leftover phases, the phase-history archive was silently misfiled under the new milestone's <version>-phases/ directory. A new --archive-version override on phases.clear (threaded from the new-milestone workflow) files the archive under the previous milestone's version; without it, behavior is unchanged. (#2288) (#2323)
Fixed: probe-core's runProbeCli now fails closed on per-item adapter garbage inside a well-shaped report envelope, matching its documented 'fails closed on adapter garbage' contract. (#1910)
Deferred out-of-scope findings logged to deferred-items.md are now surfaced — the executor's SCOPE BOUNDARY convention writes discoveries to a phase directory's deferred-items.md, but nothing read it back, so those items were permanently invisible. /gsd-progress's forensic audit and audit-uat now glob .planning/phases/*/deferred-items.md and surface unresolved entries. (#2287) (#2318)
/gsd:verify-work no longer silently terminates when all remaining UAT tests are blocked — sessions with blocked_count > 0 and pending_count == 0 now route to complete_session as expected, enabling the zero-issues auto-transition path. (#1722)
state record-metric no longer appends per-plan rows into the By-Phase velocity table — it now maintains its own Per-Plan Metrics table (self-created on first use), and its auto-create scaffold header is corrected. (#2253) (#2253)
Dynamic routing now escalates the model, not just effort — with dynamic_routing.enabled, retry attempts advanced the reasoning effort but the model stayed pinned to the default tier because resolve-execution resolved the model without consulting dynamic_routing. resolve-execution now resolves the model per-attempt through the tier ladder (e.g. standard→heavy on attempt 1, capped at max_escalations); resolution is unchanged when dynamic routing is disabled. (#2068) (#2334)
/gsd-next no longer reports a project as complete while phases are still unchecked — smart-entry's completion check now grounds in ROADMAP.md's actual Progress table (global, authoritative) instead of STATE.md's stale milestone-scoped total_phases, and its status regex requires milestone-level language (milestone complete / all phases complete / complete) instead of matching any per-phase shipped or done substring. Together these fix the false-complete misclassification that could route /gsd-next toward /gsd-new-milestone — which archives still-pending phase directories. (#2466)
Codex reviewer now captures the review via codex's --output-last-message flag instead of redirecting stdout, so Windows process-teardown output no longer pollutes the review file and slips past the empty-output guard. (#1709)
last_activity now shows your local calendar day — the clock seam derived the date by slicing a UTC instant, so in negative-UTC-offset zones during UTC's early evening the date-only last_activity field jumped a day ahead of the operator's actual date (and of last_updated's local date). Operator-facing date fields now use a host-local calendar day while internal/cosmetic stamps stay UTC. (#2136) (#2216)
A phase with a deliberately-unexecuted (superseded) plan no longer stays stuck below 100% — a plan reassigned or dropped mid-phase can never gain a matching SUMMARY, yet plan-scan counted it forever, so the phase read In Progress and the milestone sat below 100% permanently — the plan-level analogue of the retired-phase bug (#1514). Mark such a plan status: superseded in its PLAN.md frontmatter and it is now excluded from both the plan and summary counts, so the phase completes honestly (a 13-plan phase with 2 superseded reads 11/11). Plans without the marker are unchanged. (#2349) (#2404)
milestone_name is no longer clobbered with a delimiter-led fragment — getMilestoneInfo's ## heading regex was unanchored, so it matched a heading quoted inside backticks in the Milestones bullet and wrote garbage like — Active Milestone over the curated milestone name on every phase transition. Now consults the 🚧 marker first, anchors the regex to line start, strips the leading delimiter, and widens the preserve guard so a bad derive keeps the existing name. (#2135) (#2215)
init milestone-op now counts project_code-prefixed phase directories correctly — fully shipped milestones using the standard prefixed directory layout no longer report completed_phases: 0 or stay falsely incomplete. (#1844) (#1844)
/gsd-mempalace-capture no longer crashes on first invocation — the skill's own documented rooms: example wrote a flat list of bare strings, but mempalace's miner expects each entry as a dict with a name key, so following the example verbatim and running mempalace mine crashed with TypeError: string indices must be integers, not 'str'. Both skills/gsd-mempalace-capture/SKILL.md and commands/gsd/mempalace-capture.md now ship the corrected - name: <room> shape, so the documented example runs successfully end-to-end. (#2464)
/gsd-quick no longer halts with a stale-base worktree mismatch — the worktree executor now degrades to sequential execution when its fork base has diverged from origin/HEAD, instead of spawning a worktree guaranteed to fail the base-mismatch guard. (#1991)
GSD_ALLOW_SYMLINKED_DEST=1 lets users with intentional symlinked configHome layouts install/update again — v1.7.0's destSubpath write-confinement (ADR-1239 Phase B) refused install/update whenever CLAUDE_CONFIG_DIR (or an artifact-kind child like skills/ or hooks/) was a pre-existing symlink, with no opt-out. Three legitimate user-owned layouts were blocked: multi-account configs with symlinked shared skills/hooks (POSIX symlinks), Windows Junctions to shared skills dirs, and dotfiles-managed configHome (e.g. nix-darwin symlinking ~/.claude itself to a version-controlled dir). The new env var follows user-owned symlinks instead of refusing them, while preserving the two load-bearing refusals from the original threat model: path-traversal in the destSubpath string itself (../../etc-style), and a symlink resolving to the install root itself (would let the prune pass wipe it). (#2393) (#2445)
state record-session no longer silently drops inserted fields on a CRLF STATE.md — the section-rewrite regexes in cmdStateRecordSession used literal \n which couldn't match a CRLF STATE.md (---\r\n), so when a canonical session field (Resume file / Stopped at / Last session) was missing and had to be inserted via the section-rewrite path, the CRLF-tolerant detector entered the branch, the writer regex silently no-op'd, but updated.push(...) ran unconditionally. The command returned {"recorded": true, "updated": ["Resume File"]} while the field was never written to disk. With core.autocrlf=input, the CRLF working-tree file produced no git diff/git status change, so the bug was invisible. Both regexes now use the CRLF-tolerant \r?\n form (same canonical pattern already in use elsewhere), and a new defensive invariant gates updated.push(...) on the replace callback actually firing — so a future detector/writer drift will surface as missing updated entries rather than re-arming this silent-success class. (#2482)
/code-review no longer skips a phase whose SUMMARY.md records ~/-prefixed file paths — such a path was silently dropped as "deleted" (bash never tilde-expands a ~ that arrives as a variable's value), emptying the review scope and reporting "no source files changed" as a false success. Tilde paths are now expanded to $HOME/… before the deleted-file filter runs. (#2419)
Setting external_job.submit_timeout_ms / poll_timeout_ms / artifact_dir in .planning/config.json now actually configures the SLURM adapter — the keys were declared by the external-job capability but the adapter only read env vars, so config edits silently had no effect. The adapter now resolves them through the canonical capability-config seam (env override > config > registry default), surfaces the resolved artifact_dir in submit output, documents why the contribution registers at execute:wave:post (#1164 asks for wave:pre, which execute-phase.md does not dispatch today; wiring it is a core-loop change #1164 explicitly defers), and gains unit coverage for the CLI surface (parseFlags, findPlanningDir, resolveExternalJobSettings, formatShowReport). (#1164) (#2006)
The Antigravity reviewer in /gsd-review no longer reviews blind — agy -p never granted the agent the repo under review, so it frequently anchored on its own scratch directory and returned plan-text-only verdicts counted at full consensus weight. The reviewer is now granted the repo (capability-probed --add-dir) and anchored to the absolute repo root; a review that still runs without repo access is stamped [reviewed-without-repo-access] and down-weighted in the Consensus Summary. The cursor-agent prompt gains the same absolute-root anchor. (#2176) (#2184)
Non-Claude installs no longer brand all GSD output as Claude — the installer never persisted runtime: <id> into ~/.gsd/defaults.json for non-Claude runtimes, so resolveRuntime() (precedence: GSD_RUNTIME env > config.runtime > 'claude') fell through to the hard-coded 'claude' default. A non-Claude install showed agent_runtime: "claude" and Claude-formatted /gsd-* slash hints with no env or config hand-set. The installer now persists runtime: <runtime> into ~/.gsd/defaults.json for non-Claude runtimes, mirroring the existing resolve_model_ids: "omit" write at the same call site. Claude is the fallback so it needs no write; an explicit pre-existing runtime value is always preserved. (#2395) (#2446)
Autonomous reruns now skip phases with deferred verification until you resume them explicitly — if a prior /gsd-autonomous run recorded verification_deferred_human or verification_deferred_gaps, later reruns no longer drop back into the same prompt loop and instead point you at the saved resume command. (#1846) (#1846)
requirements mark-complete no longer reports silent success when the traceability row is missing — it OR-ed its checkbox and table-row writes into one flag, so a checkbox-only reconcile returned a payload byte-identical to a full reconcile while the traceability row stayed Pending (and re-run masked it as already-complete). It now surfaces table_unmatched for IDs whose checkbox reconciled but whose table row is absent, and treats a checked box with no table row as partial rather than done. (#2140) (#2219)
state prune now resolves the current phase from the canonical location — frontmatter current_phase, the Current Phase field, or the prose Phase: line scoped to the ## Current Position section — instead of extracting Phase over the whole document, where stateExtractField's pipe-table fallback could latch onto an unrelated | Phase | N | row (e.g. a historical verification table) and compute a wrong prune cutoff. (#1832)
model_overrides Claude model IDs now resolve to Agent-tool aliases on the claude runtime — a full Claude model ID (e.g. claude-sonnet-5) in model_overrides was returned verbatim and silently dropped by the Claude Agent tool (whose model parameter documents only tier aliases), causing the spawned subagent to inherit the parent session model instead of the configured one. It now maps to the tier alias (sonnet/opus/haiku/fable), consistent with the model_policy path (#1144). Bare aliases, non-Claude values, and non-Claude runtimes are unchanged; a Claude ID with no alias warns once and falls through to tier resolution. (#2041) (#2048)
validate health no longer false-flags the adaptive model profile, and now warns when a models.<phase_type> tier is invalid — health reported W004 invalid model_profile "adaptive" for a profile that has been valid since v1.40, and a typo like "planning": "opuss" was accepted in silence while the resolver quietly ignored it. Health now sources its profile list from the model catalog and emits W022 for unknown phase types and invalid tier values. (#2336)
Phase dirs whose slug leads with a multi-digit number (e.g. a year) resolve again — a phase like 14-2026-photos-performance (roadmap name "2026 Photos & Performance") had its phase token over-collected as 14-2026, so init.plan-phase, init.execute-phase, phase-plan-index, state.planned-phase, and roadmap.annotate-dependencies reported phase_dir=null / plan_count=0 while the directory existed. Continuation segments of a phase token are now capped at the exactly-2-digit zero-padded form the write side emits, via a single shared grammar source consumed by all five parsing sites (the residual case from #2043). (#2232) (#2254)
Phase headers that place a parenthetical tag before the colon (### Phase 26 (Cluster B): Title) now resolve and enumerate the same as untagged headers. Previously the resolver returned not-found and roadmap analyze/listing silently dropped the phase (wrong phase_count, progress, and next_phase). Tag tolerance is applied at every phase-header read site; untagged and all existing header formats parse unchanged. (#1765)
/gsd-stats no longer misreports a phase as Not Started when two directories collide on the same phase key — cmdStats now folds colliding statuses by precedence (Complete > Needs Review > Executed > In Progress > Planned > Not Started) instead of overwriting last-write-wins, so the furthest-along status wins regardless of fs.readdirSync order. Separately, /gsd-health now emits a new W023 warning whenever two or more real phase directories collide on the same normalized phase key, naming both directories and their independently-computed statuses (neutral wording — never guesses which is the real one). (#2461)
Executor and milestone-summary/forensics workflows now call state.* commands with named flags so the named-only router records metrics, decisions, blockers, and session continuity instead of silently dropping positional args. (#1873)
bug-1367 install test no longer fails on Windows CI when hooks/dist isn't pre-built — the test ran install.js without building its hooks/dist precondition (a gitignored build artifact the unit lane doesn't build), so on a lane without pre-built hooks the installer hit "Failed to install hooks: directory is empty" and the before-hook threw. The test now builds hooks in its own before() (mirroring golden-install-parity). (#1926) (#1927)
/gsd-fast now appends Quick Task rows to STATE.md again — the log_to_state column-count guard used an off-by-one awk formula (NF-1) that was always one too high, so the schema gate rejected the very table quick.md creates and silently skipped the STATE.md update. Also now supports the 6-column validate-mode table. (#2133) (#2214)
Build the gitignored hooks/dist/ artifact once upfront in scripts/run-tests.cjs (the same chokepoint as ensureBuiltArtifacts), before any concurrent install test spawns install.js. Closes the scoped-CI first-build empty-dir race that intermittently failed install tests with Failed to install hooks: directory is empty (e.g. bug-3683-workflow-colon-namespace-leak). (#1967) (#1968)
workstream progress no longer reports shipped milestones as executing — gsd-tools workstream progress now derives each workstream's status from authoritative shipped signals (an archived milestone snapshot under milestones/, or a SHIPPED marker in the workstream ROADMAP) instead of trusting the mutable STATE.md Status field, so a stale field can never hide a shipped/archived milestone. The output adds status_source (field | derived) and status_conflict (true when the derived value disagrees with the stale field). (#1913) (#1916)
Windows install/upgrade/state-write operations no longer fail on transient antivirus/indexer file locks — the fs.renameSync atomic-publish sites (install state, hooks config, capability ledger/lifecycle, phase/workstream/milestone dirs, roadmap, planning/state locks) now retry EPERM/EBUSY/EACCES via retryRenameSync instead of propagating the transient lock; enforced by the new local/require-fs-op-fallback lint rule (ADR-1703 Phase 6). (#1740) (#1742)
reconstructFrontmatter now emits valid YAML for scalars and block-array items that were previously serialized unescaped. Values carrying a YAML indicator plus a literal quote/backslash, embedded control characters, the empty string, a leading YAML indicator, or leading/trailing whitespace are now routed through a properly escaped double-quoted form, so frontmatter round-trips through strict parsers (js-yaml, PyYAML) instead of corrupting the block on the next state sync. (#1807)
phase remove no longer destroys the Progress table when removing the last phase — deleting a phase used a whole-document regex whose scan, on the final phase, ran past the section and swept away the ## Progress heading and its entire tracking table; the deletion is now structurally bounded to the phase’s own section. (#2253) (#2253)
Subagent prompts embedding orchestrator-relative planning paths now resolve correctly when the spawned subagent's own working directory differs from the orchestrator's (e.g. a git worktree) — init.* (and state.load) command handlers now emit state_path, roadmap_path, phase_dir, project_path, research_dir, codebase_dir, intel_dir, conflicts_path, debug_dir, and similar fields as absolute paths anchored on the project root, and the planner/checker/verifier/synthesizer/roadmapper/debugger/mapper/classifier subagent-prompt blocks that previously hardcoded bare .planning/... literals now reference those fields instead; a subagent spawned into a different cwd would previously report real, already-committed files as missing. (#2376) (#2428)
phases clear archives phase directories instead of destroying them — at a milestone switch, committed phase directories were hard-deleted (rmSync) with no archive, silently losing browsable phase history (the #1447 dirty-tree guard was a no-op for the common committed case). Phase directories are now moved to milestones/<version>-phases/ (collision-safe; timestamp fallback when no version resolves), so history survives the switch. The #1447 uncommitted-changes guard is retained as a secondary backstop. (#1871) (#1919)
/gsd-review and /gsd:ship temp files are now scoped to a single per-run directory — both workflows previously wrote prompt, section, and reviewer-output files to /tmp/gsd-review-*-{phase}.* keyed only on the bare phase number, so two projects sharing a phase number (or a crashed run's leftover file) could collide and silently feed a reviewer another project's stale content with no error; every temp path now lives under one mktemp-created run directory that's removed after the review completes. (#2358) (#2433)
Cross-AI review no longer silently drops the Codex/Claude/Gemini lanes on large plan sets — the prompt-fed reviewer blocks in review.md invoked each CLI with no explicit timeout, so a slow source-grounded review was killed at the host default (~2 min) and the lane was silently lost. The workflow now directs a high Bash timeout and frames an empty output as a timeout (not the crash it was misdiagnosed as). (#2194) (#2226)
Runtime brand-swap no longer mislabels <runtime_compatibility> comparison tables — every runtime installer that rebrands "Claude Code" to its own name (Cursor, Windsurf, Trae, Cline, CodeBuddy, Qwen, Hermes) also swapped it inside the runtime-comparison tables in shipped workflows, where "Claude Code" is a compared-runtime label, not a host self-reference — corrupting the comparison. Branding now protects <runtime_compatibility> regions while still rebranding genuine self-references. (#2284) (#2309)
check tdd.review-checkpoint no longer silently skips TDD plans with CRLF line endings — the frontmatter regex at src/check-command-router.cts:751 used literal \n which couldn't match a CRLF PLAN.md delimiter (---\r\n), so a Windows-authored type: tdd plan was silently classified as "no type:tdd plans found" and the advisory gate short-circuited to a confident pass with no violations table. The regex now uses the same CRLF-tolerant form (/^---\r?\n([\s\S]*?)\r?\n---/) already in use elsewhere in the same file (line 205, extractPlanDesignatedSections). With core.autocrlf=input, the triggering CRLF was invisible to git diff/git status, so the contributor had no way to tell their plan was being misclassified. (#2477)
Phase verification no longer reads stale from filesystem timestamps alone — staleness is now derived from git commit times instead of file mtimes, so a phase whose report declares status: passed stays passed across a fresh git clone, cp -R, or an unrelated touch/reformat, instead of being silently downgraded to stale by a checkout-order mtime skew. (#2348) (#2394)
/gsd-progress no longer reports a stale root milestone in workstream mode — in a multi-workstream project with no active workstream set, gsd-tools query init.progress silently fell back to root .planning/STATE.md (often stale) and reported it confidently. It now fails safe with an actionable error naming the available workstreams and the --ws/workstream set fix, so a stale root value is never reported. Flat mode and --ws <name> are unchanged. (#1912) (#1918)
Kilo installs now stage the shared PreToolUse guard hooks the native plugin spawns — Kilo's capability descriptor declared both a nativePlugin (which spawns gsd-prompt-guard, gsd-read-guard, and gsd-worktree-path-guard as subprocesses) and skipSharedHooksInstall: true (which suppressed staging those scripts into the Kilo config dir), so every guard silently no-opped on every Kilo install. The skip flag is removed (Kilo now stages the same hooks bundle as OpenCode, whose byte-identical plugin was unaffected), and the plugin's runHook now warns loudly — once per hook file — when a guard script is missing instead of treating the absence as a silent allow. Resolves #2305. (#2327)
The decision-coverage gate no longer fails open on unrecognized decision-ID prefixes — check.decision-coverage-plan classified a populated <decisions> block as "no trackable decisions" (a clean pass) whenever its IDs used a prefix the parser couldn't read (e.g. D5-01 instead of D-01), silently skipping the gate on real decisions. The gate now recognizes any bold-lead-in decision bullet as evidence and fails loud (could-not-parse) when it can't read a populated block, instead of passing. (#2347) (#2389)
Windows: stop double-quoting $CLAUDE_PROJECT_DIR-anchored managed node hook paths during the #2979 legacy rewrite, which produced ""$CLAUDE_PROJECT_DIR"/..." and broke every node managed hook with MODULE_NOT_FOUND (PreToolUse-guard deadlock). (#1746)
/gsd-stats and STATE.md progress no longer freeze stale total_plans — the progress ratchet was applied to the whole progress record, so any single counter decreasing (e.g. completed_plans) froze every field including total_plans. Now total_plans always takes the freshly derived value (joining total_phases from #1446), so it corrects in both directions — upward when a new phase adds plans, downward when a milestone reorganization removes phases. The write-path applyStatePreservation also switched from wholesale block restore to per-field merge, so state planned-phase writes a consistent total_plans instead of the pre-transform stale value. (#2468)
phase complete now updates STATE progress on milestone-grouped roadmaps — deriveProgressFromRoadmap parses the ## Progress table by header (column-by-name) instead of a fixed 4-column layout, so the 5-column milestone-grouped shape is no longer silently unparsed. (#2168)
Windows Claude Code hooks now work under PowerShell — when Claude Code's hook runner resolves to PowerShell (not Git Bash), every GSD-installed hook failed with Unexpected token because the installer emitted bare quoted paths with no PowerShell call operator. The fix adds a hookShell parameter to the hook-command projection chain; when hookShell='powershell', the & call operator is prepended. Default behavior (Git Bash, no prefix) is unchanged. (#2236) (#2261)
/gsd-debug now auto-resumes instead of stopping mid-investigation — when the debug session-manager's own turn ended before the investigation was complete, the orchestrator treated the intermediate progress summary as completion and returned control to the user. It now recognizes a non-terminal CONTINUE_REQUIRED return, auto-resumes from the on-disk checkpoint, and only stops for genuine terminal conditions (with a no-progress anti-loop guard). (#2257) (#2300)
Installing a non-Claude runtime no longer breaks Claude's model resolution in no-project sessions — the installer writes resolve_model_ids:"omit" for non-alias runtimes into the machine-wide ~/.gsd/defaults.json, which any runtime read back, so install order silently flipped Claude's adaptive tier aliases (executor→sonnet, planner→opus) to an empty model string. Resolution is now scoped to the runtime actually resolving, via a per-install .gsd-runtime marker: Claude ignores a global-defaults omit and keeps its tier aliases, non-alias runtimes still omit, and an explicit project-level omit/true is always honored. (#2297) (#2332)
check.decision-coverage-plan no longer false-blocks on decisions cited in <read_first>/<behavior>/<verify>/<acceptance_criteria>/<done> — the gate scanned only <objective>/<tasks>/<task>/<action> tag bodies while its remediation message claimed "(or body)". A decision faithfully cited in any of the five other planner-canonical tags (the natural place for "read this CONTEXT decision before editing" pointers, verification steps, acceptance criteria, etc.) was reported as uncovered with a misleading fix-hint that sent the fixer to "the body" — where a re-citation still failed. The scan now covers all nine planner-canonical tag bodies AND the message names the surfaces it actually scans, so message and behavior cannot drift apart again. (#2372) (#2443)
capability state and loop render-hooks now accept --runtime to override the auto-detected runtime — previously both commands parsed only --config-dir, so the runtime config dir was derived from the persisted .planning/config.json runtime (precedence GSD_RUNTIME → config.runtime → claude). A repo that persisted runtime:"codex" resolved the config dir to ~/.codex, where the Claude skill isn't installed, so every skill-bearing capability reported surfaced:false and execute:post/verify:post hooks silently no-op'd when the operator drove GSD from Claude Code. --runtime <r> (canonicalized, so aliases like codex-app work) now bypasses that fallback so the config dir resolves to the explicitly-named runtime's home. Behavior without the flag is unchanged. (#2003) (#2051)
/gsd now registers on pi — installing GSD for pi wrote its extension as gsd.cjs, a suffix pi's extension auto-discovery skips silently, so /gsd never appeared and nothing reported an error. The extension now installs as gsd.js, and upgrading removes the stale gsd.cjs. (#2470) (#2478)
phase complete no longer false-reports REQ-IDs as missing when the traceability table leads with a status column — the parser required the REQ-ID in the first column, so a table shaped | ☐ | REQ-01 | … matched zero rows and every body REQ-ID was reported missing. It now matches REQ-IDs in any column. (#2203) (#2234)
init milestone-op now ignores backlog 999.x headings when counting milestone phases — parked backlog items no longer inflate phase_count or pin all_phases_complete false for an otherwise finished milestone. (#1843) (#1843)
Phase archival is now wired end-to-end across the milestone lifecycle — finishes the #1871 follow-up: phases archive is now a real command (the half-wired alias is routed, no longer errors Unknown), milestone complete archives phase dirs by default (--no-archive-phases opts out), and new-milestone §6 stages the archive move + source removal in the same commit so history is preserved atomically rather than left as orphaned uncommitted deletions. (#1871) (#1924)
state update-progress no longer mangles the frontmatter and discards the progress suffix — its Progress: regex matched the raw STATE.md including frontmatter, so the YAML progress: key was hit first (corrupting the frontmatter) while the body line stayed stale and was silently reverted on the next write, and any descriptive suffix after the progress bar was destroyed. It now targets the body line only and preserves the suffix. (#2177) (#2224)
/gsd-plan-review-convergence no longer silently overrides configured reviewers with Codex — a bare invocation (no reviewer flags) now respects review.default_reviewers (and, transitively, review.reviewer_instances) per ADR-0011/ADR-0015, instead of always injecting --codex and bypassing the configured default. Users without review.default_reviewers configured still get --codex as before. The startup banner now shows what will actually run. (#2451)
/gsd-ship no longer silently drops the ship-status note from STATE on merge — the track_shipping step committed the STATE ship-note after creating the PR but never pushed it, so on a fast merge the note stayed local-only and never reached the default branch. The ship-note is now pushed onto the PR branch with a [ci skip] trailer so it lands on merge without a redundant pipeline. (#2138) (#2217)
/gsd-debug no longer stalls on a phantom background handoff — the orchestrator treated the foreground session-manager spawn as a background task and queried its agent ID via TaskOutput (which needs a task ID), then waited on a handoff that was never queryable. The workflow now states the spawn is foreground/blocking, forbids passing an agent ID to TaskOutput, and gives a lost-handoff recovery path. (#2196) (#2227)
Roadmap phase lookup now ignores fenced examples and the backlog sentinel lane — roadmap get-phase and init plan-phase no longer return fenced sample headings as real phases or treat 999.x backlog items as active milestone work. (#1845) (#1845)
phase complete no longer checks the wrong ROADMAP checkbox or writes the plan count into a shipped milestone — the roadmap mutators ran unanchored and un-milestone-scoped, so they could flip a bullet inside a backticked prose literal or a Backlog entry instead of the closing phase's, and write the plan count into a same-numbered phase in a shipped milestone. The checkbox flip is now line-anchored and both writers are scoped to the current milestone. (#2200) (#2229)
audit-uat no longer reports a false-clean total_items: 0 when real items exist — the parsers ignored two artifact shapes: a ## Gaps section recording open findings, and verification items declared in frontmatter (human_verification: array) or as ### N.+bold-paragraph blocks. audit-uat now surfaces unresolved ## Gaps entries and reads the frontmatter array / heading shape, so a phase with outstanding UAT/verification work is no longer waved through as clean. (#2286) (#2317)
claude_orchestration.enabled: true now actually routes execute-phase waves through the Workflow backend — the capability shipped registered-but-inert: nothing in /gsd-execute-phase ever called its backend detection, and the execute:wave:pre hook it needed was declared but never rendered, so enabling it had zero effect. execute-phase now renders execute:wave:pre before each wave and, when the capability is enabled and all gates pass, dispatches independent plans via the generated Workflow script; any gate miss or disabled config falls back to byte-identical inline dispatch. (#2285) (#2314)
roadmap get-phase resolves project-code-prefixed headings by bare number — a bare-number query (e.g. 29) now resolves a drifted ### Phase AB-29: heading, matching the internal resolver used by init.phase-op; previously the CLI returned empty. A bare sibling (### Phase 29:) still takes precedence. A project-code-prefixed heading present only as a summary/checklist line (no matching detail section) now reports a malformed_roadmap diagnostic — for both prefixed and bare-number queries — instead of a silent empty result. (#2114) (#2139)
query config-get now returns capability-registry defaults for absent keys — keys declared with a default in the capability registry (e.g. workflow.security_enforcement, which defaults to true) previously reported "Key not found" (exit 1) when missing from config.json, diverging from the runtime's own resolver and letting ... || echo false guards silently read the security gate as disabled. config-get now resolves these through the same registry defaults the runtime uses. (#2256) (#2299)
milestone complete --ws now archives into the workstream instead of root — the archive paths (MILESTONES.md, the milestones/ archive dir, and the per-version MILESTONE-AUDIT.md) were hardcoded to root .planning/, so a workstream milestone close scattered its artifacts into root and never produced a workstream-local archive. They now derive from the workstream-aware planning base (planningPaths(cwd).planning); flat-mode (no --ws) is unchanged. (#1911) (#1917)
/gsd:new-milestone --ws <name> no longer overwrites the shared PROJECT.md milestone heading — in workstream mode the shared .planning/PROJECT.md had its ## Current Milestone heading rewritten with one workstream's milestone, so with parallel workstreams whichever ran last silently won the shared heading. The milestone-state write in Step 4 is now skipped when a workstream is active, and the commit no longer stages PROJECT.md. The --ws flag is also now parsed into ${GSD_WS}, which previously expanded to empty and silently dropped workstream scope from the suggested next-step routing hints. (#2338)
The context-monitor hook no longer fails Codex's Stop hook — GSD wires gsd-context-monitor to Codex lifecycle events including Stop, but the hook emitted a hookSpecificOutput.additionalContext envelope that Codex's Stop schema rejects ("hook returned invalid stop hook JSON output") exactly when context was low. The hook now emits that envelope only for context-injection events (PostToolUse / AfterTool) and exits silently for Stop and every other lifecycle event, while its debounce and critical-session bookkeeping still run. (#2289) (#2324)
phase complete now reads milestone-grouped ROADMAP progress tables — progress reported 0% on projects whose Progress table carries a Milestone column, because the reader assumed a fixed column position; it now resolves progress columns by name so both flat and milestone-grouped tables work (#2137). Quick Tasks logging via /gsd:fast also appends schema-correct, lock-safe rows instead of guessing the column count in shell (#2133). (#2248) (#2248)
Managed hooks no longer break after a volta node upgrade or prune — on machines using volta to manage Node, the installer baked a version-pinned node path into every managed hook command. Once volta pruned that node version, every hook failed to spawn with No such file or directory at the start of each session, until the installer was re-run. Hook commands now resolve through volta's stable shim, which survives version changes. (#2335) (#2375)
Todo severity is now captured and surfaced end-to-end — /gsd-capture (add-todo) now confirms a severity (blocker/major/minor/cosmetic) before writing a todo instead of silently omitting it, and gsd-tools list-todos / init todos now include the severity field in their JSON output (omitted for older todos that have none), so a backlog can be triaged by severity instead of by re-reading every file. (#2337) (#2381)
Skill-bearing capabilities now surface correctly on flat command-layout installs — on an install using the flat commands/gsd-<stem>.md source layout (e.g. a Claude Code local project install with no commands/gsd/ subdir), every skill-bearing capability (nyquist, code-review, security, ui, mempalace, ai-integration, profile-pipeline) was silently reported surfaced:false/enabled:false/active:false, so their loop hooks (verify:post, execute:post, etc.) never fired even with the corresponding workflow.* toggle on. The skill-manifest resolver now detects the flat layout and produces the same stems the nested commands/gsd/*.md loader does. (#1858) (#2049)
Claude Code installs now pre-approve .planning/ and STATE.md writes — the installer wrote Write(.planning/*)/Write(STATE.md) permission rules, but Claude Code has no standalone Write gate (file edits are gated via Edit(pattern)), so those rules never matched and every fresh install still hit first-run approval prompts (and a session-start warning). The installer now writes Edit(...) rules and migrates the stale Write(...) entries away on the next run. (#2278) (#2302)
Roadmap, requirements, and state table edits are confined to the right table — the last ad-hoc table writers (phase completion updating roadmap progress, requirements mark-complete, and state record-metric/velocity) now route through the shared markdown-table seam, so a stray decoy table elsewhere in a document can no longer swallow a phase-progress update, a single ragged neighbouring row no longer silently aborts the whole edit, and per-plan metric recording no longer drops trailing section content or duplicates the section. (#2253) (#2253)
Installed third-party capability skills now materialize as real slash commands — a capability could pass every check (installed: true, surfaced: true, active: true) and still never exist on disk: the registry layer counted the capability's skill as surfaced, but the file-copy step only ever scanned gsd-core's own bundled commands, so nothing was ever written to the runtime's skills/ directory and the command was never invocable. Installed capability skills are now staged from where they live, bound to the capability that actually declared and registered them (never inferred from directory listing order), and are subject to the same runtime-targeted body rewrites as first-party skills — first-party skills still win any name collision. (#2340)
/gsd:plan-review-convergence can now use the Antigravity CLI reviewer — its reviewer-flag whitelist predated the 1.7.0 Antigravity adapter and silently dropped --agy/--antigravity, so convergence fell back to --codex only and the working adapter was unreachable (especially after Gemini CLI's upstream shutdown). Both flags are now recognized and passed through to /gsd-review unchanged. (#2293) (#2325)
npm run lint:ci (and every npm script banner) on next and feature branches cut from next no longer reports a stale pre-release version after a final release — the release pipeline's finalize job shipped X.Y.0 to npm latest but never bumped next to match, so next carried the last rc.N placeholder indefinitely (observed: 1.7.0-rc.6 lingering after 1.7.0 shipped). The finalize job now runs scripts/sync-next-version.cjs — the same step the rc job already ran — keeping next at the last published release for every release type as scripts/sync-next-version.cjs:6-9 always promised. (#2423) (#2437)
verify plan-structure no longer false-flags checkpoint tasks for missing <action>/<verify>/<done> — every <task type="checkpoint:*"> was reported as a structural error because the verifier unconditionally required the auto-task fields. It now branches on the task's type attribute: checkpoint:human-verify requires its canonical triple (<what-built>/<how-to-verify>/<resume-signal>), checkpoint:decision requires <decision>/<options>/<resume-signal>, checkpoint:human-action requires <action>/<instructions>/<verification>/<resume-signal> (per gsd-core/references/checkpoints.md), and unknown checkpoint:* subtypes require only the universal <resume-signal>. Non-checkpoint tasks keep the historical <action>/<verify>/<done>/<files> requirements unchanged. (#2473)
Hermes installs now project named-agent dispatch onto delegate_task instead of asserting a nonexistent Agent tool — installed Hermes workflows brand-swapped "Claude Code"→"Hermes Agent" but kept literal Agent(...) calls and falsely claimed "The Agent tool IS available", which Hermes doesn't expose. A Hermes .md converter now rewrites named dispatch onto Hermes's delegate_task contract (embedding the resolved role prompt since Hermes has no named-agent lookup, mapping background dispatch, dropping unsupported per-call model), driven by the runtime's documented dispatch facts, and fails closed if a referenced role prompt is missing. (#2284) (#2309)
phase complete no longer silently drops requirement IDs the roadmap cites but REQUIREMENTS.md never defined — completing a phase whose **Requirements**: line named an unregistered REQ-ID reported requirements_updated: true with zero warnings while the file was left byte-for-byte unchanged, indistinguishable from a run that wrote everything. Ghost IDs now raise a warning, requirements_updated reflects whether a write actually landed, an active heading like ## v1 Requirements is no longer mistaken for a deferred section, and a phase whose every cited ID is unregistered still reports its missing-requirement rows instead of "No requirements or decisions to check." (#2339)
~/.gsd/defaults.json no longer silently drops model_policy, model_profile_overrides, and runtime — the global-defaults path of config load now forwards these three keys identically to a project's .planning/config.json, so a machine-wide model policy / runtime / overrides specified globally is honored even outside a project. (#2069) (#2442)
ROADMAP phase edits can no longer escape their section — completing a phase updated its plan count and per-plan checkboxes with whole-document regexes that could bleed into a neighbouring phase; those per-phase writes are now structurally bounded to the phase own section via a new withSection / withPhaseSection seam (#2130, #2067, #2080). (#2250) (#2250)
close_phase_todos no longer leaves moved todos as phantom unstaged deletions in git status — the workflow step moved resolved todos from .planning/todos/pending/ to .planning/todos/completed/ with a plain mv, then committed by listing only the destination directory in --files. Git's index still tracked the moved file at its old pending/ path, so the deletion was never staged and the moved-away file lingered as an unstaged deletion in git status until some later broad git add -A happened to catch it. The step's commit --files list now includes BOTH directories so git add .planning/todos/pending/ stages the deletion atomically with the new completed/ copy in the same commit. (#2415) (#2447)
STATE.md ## Session fields now resolve on Windows — the session-section reader used a \n-only heading regex that silently failed on a CRLF ## Session heading, nulling all session state on Windows checkouts; it now reads through the CRLF-safe section seam. (#2253) (#2253)
Bullet/em-dash ROADMAP phases no longer resolve to Phase null — the roadmap phase lookup matched only ATX headings with a colon, so a bullet entry like - [ ] **Phase N — Name** (which the roadmapper emits) failed to resolve and Phase null landed in STATE.md; a bullet-only ROADMAP also broke the milestone phase count. Phase lookup and the milestone filter now accept bullet/checkbox entries with an em-dash/en-dash/hyphen/colon separator. (#2199) (#2228)
Linuxbrew users no longer lose all GSD-managed hooks after brew upgrade node — normalizeNodePath only recognized macOS Homebrew Cellar paths, so on Linux the version-pinned node path stayed baked into hook commands and 404'd after a node bump (and reinstall couldn't repair it). It now rewrites any Homebrew Cellar path — Intel, Apple Silicon, Linuxbrew, custom HOMEBREW_PREFIX — to the stable <prefix>/bin/node symlink. (#2185) (#2225)
milestone complete no longer corrupts the recorded phase — closing a milestone (e.g. v0.5) previously overwrote current_phase in STATE.md with the version's minor digit, and a follow-up state complete-phase mined a bogus 0.5 token and rewrote the file; phase resolution is now anchored so the real phase is preserved and a milestone-closure line is rejected. (#2111) (#2131)
Headless MemPalace capture no longer fails silently — the headless invocation mempalace mine <path> --wing <wing> --room <room> used a --room flag that does not exist on the mine subcommand (only search accepts --room), causing every headless/no-MCP capture run to fail with unrecognized arguments: --room and silently skip (onError: skip). The fix replaces the flag with MemPalace's documented room-assignment mechanism: stage the artifact under a room-named subfolder with a mempalace.yaml taxonomy so detect_room() assigns it via folder-path match. (#2220) (#2260)
Codex agents no longer fail to launch with an unsupported-model error — GSD was writing an Anthropic tier name (opus/sonnet/haiku/fable) or a claude-* id into each Codex agent's .toml model field, which Codex rejects — fatally on a ChatGPT account (The 'sonnet' model is not supported when using Codex with a ChatGPT account). GSD now never writes an Anthropic-flavored model to a Codex agent: an explicit real-Codex model pin is kept, anything else is omitted so the agent inherits the working session model. (#2310) (#2312)
Fixed: a hand-authored non-inferable backstop truth with a stray trailing space or surrounding quotes no longer silently grades green — it correctly abstains (insufficient_spec), restoring the #1154 honest-verifier guarantee. (#1909)
commit_docs no longer silently disables on CRLF .gitignore repos — git check-ignore falsely reports a trailing-slash path (e.g. .planning/) as ignored when the .gitignore has CRLF line endings with blank lines. isGitIgnored now strips trailing slashes before querying, so the false positive cannot occur. (#2206) (#2235)
Phase-directory resolution fails loud on cross-project collisions — when two unrelated GSD projects share a .planning/phases/ tree, a bare phase number silently resolved to the first 0N-* directory found. The fix detects multiple matches and surfaces an ambiguous_matches result. (#2237) (#2262)
Build/test gates no longer report a false failure on repos with no detectable build/test tooling — the post-merge, regression, verify-phase, and audit-fix gates read config-get workflow.build_command/workflow.test_command without --raw, so an unset key returned the literal 2-byte string "" rather than empty output. The [ -z "$CMD" ] guard then saw a non-empty value, skipped the Makefile/Cargo/go.mod/package.json auto-detection cascade, and executed the literal "" as a command → exit 127, misread as a build/test failure (docs-only or planning-only repos, or any repo before its first build file). All of these reads now pass --raw, restoring the intended "no command detected — skip" no-op. (#2350) (#2399)
scanPhasePlans no longer counts PLAN-REVIEW artifacts as executable plans — *-PLAN-REVIEW.md files were counted by the loose /PLAN/i fallback. The fix adds a PLAN_REVIEW_RE exclusion before the fallback. (#2252) (#2263)
Dependency tree no longer carries a known body-parser advisory — GHSA-v422-hmwv-36x6 (low-severity DoS via invalid limit value, published 2026-07-20) in body-parser@2.2.2 was pulled transitively via @anthropic-ai/claude-agent-sdk → @modelcontextprotocol/sdk → express and surfaced by npm audit --omit=dev. Re-resolved body-parser to 2.3.0 in package-lock.json within express's already-declared ^2.2.1 range; no overrides block needed, package.json is unchanged. (#2473)
Milestone audit no longer flags a not-yet-validated phase as a Nyquist failure — a phase that was planned but never run through validate-phase now reports as NOT-VALIDATED (a "run validate-phase" TODO) instead of collapsing into PARTIAL alongside phases whose validation genuinely failed. (#2117) (#2209)
CI gates no longer fail with no merge base on branches behind the base. The mutation, changeset-required, and docs-required workflows shallow-fetched the base ref, truncating the ancestry their three-dot origin/<base>...HEAD diffs depend on — so the mutation gate reported failure and silently skipped its Stryker shards, leaving the 80% threshold unverified on any PR not already level with next. (#2452) (#2485)
OpenCode slash commands now install to the supported commands/ directory instead of OpenCode's legacy command/ alias — GSD wrote all ~71 /gsd-* commands to command/ (singular), which OpenCode's docs list only as a backwards-compatibility alias for the documented commands/ (plural) convention. Commands now land in ~/.config/opencode/commands/ (global) and .opencode/commands/ (local), and upgrading migrates the legacy directory, preserving any files you put there yourself. OpenCode currently resolves both names, so this is an alignment rather than a rescue — it takes GSD off a path the vendor may withdraw. Kilo is unaffected. (#2354)

Security

gate="blocking-human" checkpoints are no longer auto-approved by the execute-phase orchestrator — the package-legitimacy gate (#2827) spans two layers: gsd-executor refuses to auto-approve a gate="blocking-human" checkpoint and escalates it via checkpoint_return_format so a human can vet the package, and execute-phase's checkpoint_handling step decides what happens next. That step dispatched purely on checkpoint type and never read gate, so under --auto / --chain it immediately auto-approved the very checkpoint the executor had just refused to auto-approve (human-verify → {user_response} = "approved"). The slopsquatting defence was therefore inert in exactly the unattended mode where nobody is watching: an [ASSUMED]/[SUS] package reached install with no human ever seeing the verification prompt. checkpoint_handling now carves out gate="blocking-human" (and the package-legitimacy what-built markers) ahead of every auto-mode branch, routing those checkpoints to the standard present-to-user flow regardless of type. references/checkpoints.md documents the gate attribute and its two values for the first time — previously blocking-human appeared nowhere outside agents/gsd-executor.md, so no planner had a documented way to author a checkpoint that auto-mode could not bypass. The existing regression test asserted the executor half only; it now asserts the orchestrator half too, which is why it stayed green while the gate was open. (#2107) (#2113)
Patched a transitive denial-of-service advisory in the production dependency tree — body-parser reached GSD via the Claude Agent SDK's MCP dependency and, on versions through 2.2.2, silently stopped enforcing request size limits when given an invalid limit value (GHSA-v422-hmwv-36x6). Pinned to >=2.3.0. (#2470) (#2478)
phases.clear --archive-version and milestone complete <version> now reject version labels containing path separators or .. — the milestone version becomes a filesystem directory name that phase directories are moved into, so an unvalidated value could relocate phase history outside .planning/milestones/. Both now validate against a strict version-token pattern and fail loudly. (#2288) (#2323)
query config-get no longer leaks secret values or walks the prototype chain — the --default fallback path printed secret-named keys (e.g. brave_search) in plaintext instead of masking them, and dotted-key traversal used raw property access so config-get __proto__/constructor resolved to JavaScript internals at exit 0 instead of erroring. Both absent-key resolution and traversal are now masked and own-property-gated. (#2256) (#2299)
Hardened phase/roadmap/plan markdown parsing against quadratic-time (ReDoS) CPU exhaustion — a crafted ROADMAP.md, STATE.md, or PLAN.md with large runs of unclosed (, [, <tag>, <!--, or <details> could drive the phase-header, Plans-count, files_modified, and <tag>-block parsers into O(n²) scans (tens of seconds on a ~1.5 MB file). Every affected regex is now linear: header tag/bracket clauses are length-bounded, the Plans-count scan is section-local, and all <tag>…</tag> extraction routes through a single ReDoS-safe seam. (#2128) (#2141)
Installer writes are now confined to the declared config home — the workflow/skill emit path (copyWithPathReplacement) and the Codex config writer (installCodexConfig) now reject any destination that escapes the install root: crafted or absolute paths, path-separator agent names, and pre-existing symlinks are refused before any delete or write. Fail-closed: an install write with no declared root is rejected rather than written unconfined. (#1725)
Install write-confinement (ADR-1239 Phase B) — the installer now rejects any runtime-descriptor destSubpath that would write or delete outside the user's config home (path traversal, the config root itself, NUL bytes) and refuses to follow a pre-existing symlink that escapes it. Hardening only; no change to legitimate installs. (#1706)

[1.7.0] - 2026-07-15

Added

A default-off, BETA, claude-only "Claude orchestration" capability — adopts Claude Code's Workflow tool (/effort ultracode, Agent SDK ≥ v0.3.149) as an optional parallel-execution backend for the GSD loop, restoring the wave parallelism + plan-checker + verifier that the #853 backgrounded-agent nesting limitation forces inline on Claude Code, and folding the existing gsd-ultraplan-phase plan-offload under the same runtime gate. When claude_orchestration.enabled is on AND the runtime is Claude AND the Workflow tool is detected AND the Agent SDK meets the floor (claude_orchestration.min_agent_sdk_version, default 0.3.149), execute-phase emits a generated Workflow script (waves → parallel() barriers, plans → agent({ agentType: 'gsd-executor', isolation: 'worktree' }), files_modified overlap → separate sequential stages, resumeFromRunId wired to the phase run id, shared budget pool) that composes the SAME executor agent + worktree isolation the inline path uses, so artifacts/commits are produced identically. Detection is pure and fail-closed (any miss → inline), so on any runtime lacking the Workflow tool behaviour is byte-identical to today. Adds a pure module gsd-core/bin/lib/claude-orchestration.cjs (detectWorkflowBackend, emitWorkflowScript), the capabilities/claude-orchestration/ declaration with two gated loop contributions (execute:wave:post, plan:post) and a claude-orchestration command family (gsd-tools claude-orchestration detect-backend|emit-workflow), federated config keys, and an ADR-1143 implementation amendment. (#1143) (#2044)
Phases that integrate an external API/SDK/service can no longer seal without a decided coverage matrix — a new api-coverage gate on the ai-integration capability blocks /gsd:verify-work until the phase produces a COVERAGE.md enumerating the API's full capability surface, with every non-integrated capability an explicit, reasoned opt-out. Full coverage is the default; the matrix is the subtraction record, so "we integrated the API" can no longer silently mean "we integrated whatever the first use case exercised." Toggleable via workflow.api_coverage_gate (on by default). (#1562) (#2065)

OpenCode installs now auto-register the GSD companion MCP server (`mcp.gsd`) — `--opencode` install writes a `mcp.gsd` entry (local stdio → `gsd-mcp-server`) into `opencode.json`, so OpenCode drives GSD's command + planning-state surface over MCP with no bespoke plugin (ADR-1239 Phase D / #1682). Idempotent and non-clobbering; a user-defined `mcp.gsd` is preserved. (#1682) (#1929)

OpenCode plugin handles session.idle + the opencode-subset hook dialect is implemented — the GSD OpenCode plugin now recognizes session.idle (↔ Claude Stop lifecycle point), completing the compaction/idle pair (#1914 shipped compaction). The reserved opencode-subset dialect gains a consumer — hookEventSurfaceFor() in host-integration.cts — describing OpenCode's session/tool/file event subset (no workflow-phase events; the engine owns phase sequencing, ADR-1239 §OpenCode binding). Adds a Claude-parity test asserting the plugin covers the full declared subset. (#1682) (#1930)

GSD now warns when model config changed without re-running the installer on static-frontmatter runtimes — on codex and opencode, editing model_overrides or model_profile_overrides or model_policy.runtime_tiers in .planning/config.json or ~/.gsd/defaults.json previously had no effect until the user re-ran gsd install <runtime>, and the failure was silent: the sub-agent kept using the base model. Workflow entry points like gsd-tools init * now emit a one-line stderr warning naming the changed config file and the exact remediation command when they detect the config is newer than the baked agent files. The guard is read-only and warning-only by default, dedup'd per session, and skipped entirely on Claude Code because Claude Code resolves models at spawn time. Resolves #1688 as the structural follow-up to #1650. (#1692)
gsd-tools state rebuild — new subcommand that re-derives STATE.md body structure from canonical sources (frontmatter + .planning/phases/ disk scan), reconciling drifted ## Current Position prose, dropping orphaned rows from the **By Phase:** table, clearing template-placeholder field values, and de-duplicating ## Session Continuity Archive blocks. Every mutation is recorded in a ## Rebuild Log audit section. Idempotent (running twice on a clean file is a no-op). Supports --dry-run (preview) and --verbose (tee log to stderr). Heavier, manual counterpart to the lightweight auto-triggered state sync. (#1830)
graphify.graph_path makes the knowledge-graph location configurable so one umbrella graph can serve multiple projects — a new .planning/config.json key (path relative to project root, or absolute) overrides where /gsd-graphify query|status|diff read the graph, letting a single curated cross-repo umbrella graph serve every sibling sub-project without N drifting ~5 MB mirror copies. Previously the graph location was hardcoded to <cwd>/.planning/graphs/ with no override; the only workaround was copying the umbrella graph.json into each project (which drifted, wasted disk, and could be silently overwritten by an in-project build). The diff snapshot travels with the configured graph; build stays project-scoped; unset → byte-identical default; a configured-but-missing file yields an actionable error naming the path. (#1825) (#2013)
Claude Sonnet 5 is now the standard (sonnet) tier model. The model catalog and provider presets resolve the sonnet/standard tier to claude-sonnet-5 (GA 2026-06-30) across the Anthropic-backed runtimes (claude, copilot, and the anthropic/anthropic-fable presets), plus the OpenRouter-style anthropic/claude-sonnet-5 for opencode/hermes, replacing the superseded claude-sonnet-4-6. Opus and Haiku tier defaults are unchanged (the haiku high-effort preset's escalation slot tracks the current sonnet model). Shipped in 1.6.1. (#1847) (#1848)
Third-party capability gates now actually fire via a generic command-exit-zero predicate. — a capability's declared check.predicate gate was rendered for display but never evaluated (only built-in check.query gates were enforced, and the security capability's gate worked solely via a hard-coded ship.md branch). A new generic evaluator (gsd_run check predicate) now evaluates check.predicate blocks by kind; the first built-in kind command-exit-zero runs a bounded sh -c command at the project root and blocks the loop on non-zero exit (timeout → block, fail-closed). The execute:wave:post, execute:post, and plan:post gate-dispatch sites route predicate gates to the new evaluator automatically. (#2008) (#2011)
GSD's lifecycle hooks now run under Kimi CLI — installing GSD into Kimi wires its session-state, phase-boundary, graphify, and guard hooks into Kimi's own native config.toml [[hooks]] bus (Beta on Kimi's side) instead of silently no-op'ing, and GSD's Kimi subagents can now run in the background. Kimi's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2095) (#2159)
GSD is now installable on pi — npx @opengsd/gsd-core --pi installs the GSD extension to ~/.pi/agent/extensions/gsd.cjs, and /gsd <family> <subcommand> now dispatches real commands through the embedded engine (the reference binding previously could only run query help). Drives pi through the negotiated imperative Host-Integration adapter, with active-model steering and the full pi lifecycle-event surface. (#2102) (#2205)

GSD now ships a pi extension — a real, jiti-loadable ExtensionAPI module (pi/gsd.cjs) that registers /gsd (dispatches through the GSD command-routing hub) + gsd_invoke tool + tool_call event, installable at ~/.pi/agent/extensions/. A reachability test proves the /gsd handler dispatches through the engine (keystone wired, not just registered on a mock). (#1965) (#1965)

plan-phase now authors edge and prohibition predicates into PLAN.md must_haves when a phase SPEC omits ## Edge Coverage / ## Prohibitions, so goal-backward verification still has predicates to check on a spec-less phase (ADR-857 Phase 6). Gated by the new default-on workflow.specless_probe_fallback toggle — disable it to skip the fallback (the skip is recorded visibly in the plan). Spec-less prohibitions are authored descriptor-less and disposed flagged/unverified (honest verifier #1154), never a silent pass. (#1835)
Discover third-party GSD Capabilities in a new Community Capability Registry. — A non-endorsing discoverability catalog where authors register a Capability via a documentation PR; each entry carries a live latest-release badge and a per-entry GitHub Discussion for community ranking and comments. (#2188) (#2188)
GSD now warns when a stale global CLI (e.g. a retired @gsd-build/sdk canary) shadows your project-local install — the gsd-tools CLI startup detects when the running binary is outside the project root while a project-local install exists, and prints a remediation warning to stderr (non-blocking). (#1754) (#1755)
gsd-mcp-server — companion MCP server (interface points 1 + 5) — a new bin command (npx @opengsd/gsd-core gsd-mcp-server) runs a stdio JSON-RPC 2.0 MCP server exposing gsd_invoke_command (→ the GSD command-routing hub) + gsd_read_state / gsd_write_state (→ .planning/ state), so any MCP-consuming host (Claude Code, Codex, OpenCode, VS Code, Gemini CLI, Cursor, Cline, Hermes) can drive GSD with no bespoke plugin (ADR-1239 Phase C-2 / #1681). Dependency-free (hand-rolled JSON-RPC). How-to: docs/how-to/connect-gsd-mcp-server.md. (#1810)
Opt-in absolute token count on the statusline context meter — new statusline.show_context_tokens config (default false). When enabled, the meter shows the absolute context total after the percentage, e.g. "████░░░░░░ 46% (156k)", summing input, cache-creation, cache-read, and output tokens from the hook payload (a broader basis than the meter's percentage, which is derived from used_percentage and excludes output tokens — the two figures can diverge slightly). Default meter output is unchanged. (#2161) (#2174)
Long-running compute can now be externalized as async external jobs instead of blocking the agent turn — a default-off external-job capability lets executors submit SLURM jobs, commit a .planning/async-jobs manifest, defer SUMMARY.md, and return external_job_waiting; the core loop already reconciles these manifests (#1165), so this adds the producer half (SLURM adapter, pure manifest module, planner/executor fragments, operation policy). (#1105) (#1998)

GSD now ships a repo-local VS Code extension — a buildable extension (vscode/extension.js + vscode/package.json) that registers gsd.invoke (dispatches through the GSD command-routing hub) in the VS Code command palette. A reachability test proves the handler dispatches through the engine (keystone wired). Not Marketplace-published; mirrors the OpenCode plugin's bar. (#1966) (#1966)

Discover third-party GSD Embeddable Orchestration System (EoS) integrations in a new EoS Registry. — A non-endorsing discoverability catalog where host-integration authors register via a documentation PR; each entry declares its Host-Integration interface points, negotiated axes, and protocol version, with a live release badge and a per-entry GitHub Discussion for ranking and comments. (#2193) (#2193)
GSD Core ships a .claude-plugin/marketplace.json marketplace manifest so Claude-plugin-compatible runtimes (ZCODE et al.) can discover and install gsd-core from a custom marketplace source. Additive — the existing .claude-plugin/plugin.json and the Claude Code install path are unchanged. The catalog version (plugins[0].version) tracks package.json via the release version-sync. (#1861)
GSD now drives VS Code through the Embeddable Orchestration System — the VS Code extension is rewired through the negotiated imperative Host-Integration adapter (active vscode.lm model, engine hook bus, sandboxed storage), gains native Language Model Tools (GSD skills as #gsd-* tools) and #runSubagent dispatch, and runs as a Web Extension (no Node APIs). (#2103) (#2210)
/gsd:next smart-entry workflow — adds a state-aware entry point that classifies the current project situation (no-project, blocked, verify-failed, planning, executing, verify-pending, complete, and more) and recommends the right next GSD command. The gsd-tools smart-entry [--json] classifier handles phase ordering including decimal phase IDs; the /gsd:next skill surfaces the workflow with tiered fallback behavior. (#1798)
OpenCode now runs GSD's lifecycle safety hooks (prompt-injection guard, read-before-edit guard, injection scanner, worktree/workflow guards, context monitor) via a native plugin installed to ~/.config/opencode/plugins/gsd-core.js. OpenCode declares hooksSurface: 'none', so these hooks were previously inert; the plugin bridges OpenCode's event bus onto GSD's existing hook scripts. Installed automatically by npx @opengsd/gsd-core --opencode and removed on uninstall. (#1923)
Host-integration descriptors now carry an extensionEvents vocabulary — the extension-system event surface (OpenCode, pi) is a separate descriptor field from managed hookEvents, so OpenCode declares extensionEvents:opencode without conflicting with the hooksSurface:none invariant. (#1946) (#1946)
/gsd-review now supports custom reviewer instances — run one model-capable adapter (e.g. OpenCode) as several independent reviewer identities via a bounded review.reviewer_instances config, so two different models can review in a single pass without manually swapping config or hand-merging REVIEWS.md. (#1517) (#1766)
Opt-in git branch and working-state segment in the statusline — the shell prompt's branch/dirty-state signal is hidden for the whole session under the Claude Code TUI, so wrong-branch commits and ship-time push rejections surface only after the fact. New statusline.show_git config (default false) renders the branch name plus staged/unstaged/untracked/ahead/behind markers (or ✓ when clean and in sync) after the directory segment. When disabled, no git subprocess is spawned and output is unchanged. (#2163) (#2183)
/gsd:onboard guides brownfield setup — existing repos now have a top-level onboarding command that routes through codebase mapping, docs ingest, project initialization, and an onboarding summary without silently overwriting planning files. (#1994)
Plural/optional/chosen assumption-delta checkpoint during planning — when a phase makes something plural, optional, or chosen that used to be singular, required, or derived, the planner is now prompted to re-ask whether the primary key / identity model still names the right thing, preventing silent architectural drift from accumulating into a later user-facing bug. Advisory (non-blocking); fires only on a detected signal. Toggle with workflow.assumption_delta. (#1561) (#1767)
/gsd-ui-phase now probes UI state coverage — a new ui-consideration-probe (the third probe-core adapter) enumerates the shape-rooted UI states a UI-SPEC must resolve (empty/loading/error/populated/partial/overflow/zero-one-many/long-text). After the UI checker approves, the probe surfaces applicable considerations for each element, records a ## UI Considerations section in the UI-SPEC, and plan-phase lifts each resolved consideration into must_haves — so a purely-visual state with no wired test routes to insufficient_spec → human_needed at verify rather than a silent pass. (#1979)
Host-Integration Interface (ADR-1239 Phase A) — a versioned, negotiated capability contract (runtime.hostIntegration) over the six host-integration points (command, dispatch, model, hooks, state, artifact). Adds an in-process negotiateHostCapabilities handshake that fail-closes on undeclared/unknown/undocumented values (effective ⊆ host-declared ∩ engine-known), a typed degradation ladder, host-capability profiles, and a documentation-sourced per-CLI capability matrix for all 16 runtimes. Interface-definition only — no change to install behaviour. (#1690)
ZCode (Z.ai) is now an installable runtime — a desktop Agentic Development Environment for the GLM-5.2 model can now be targeted with --zcode, landing GSD skills at ~/.zcode/skills/<name>/SKILL.md plus slash commands and subagents. ZCode ships as a pure declarative capability descriptor (capabilities/zcode/capability.json) with zero hardcoded runtime === 'zcode' branches, reusing the Claude skill converter — the de-hardcoded, data-driven runtime path that 1.7.0 (ADR-1016 / ADR-1239) enables. (#1925) (#2039)

Changed

The GSD CLI now self-heals a missing runtime build. The compiled gsd-core/bin/lib/*.cjs modules are gitignored build artifacts (ADR-457) that ship prebuilt in the npm tarball but are absent on a Claude Code plugin-marketplace / git-clone install, which never runs npm run build:lib. Previously every command died at load with Cannot find module './lib/cli-exit.cjs'. The gsd-tools entrypoint now detects the missing output and compiles it once, on demand (lock-guarded so parallel invocations don't race), then proceeds — a single no-op check on the already-built npm path. When TypeScript is genuinely unavailable it prints an actionable npm install && npm run build:lib message instead of crashing. (#2036)

Internal: Claude Code's installer is now driven through the public Host-Integration Interface (ADR-1239 / EoS). bin/install.js routes claude install/uninstall through the imperative adapter (createImperativeAdapter) instead of calling the engine directly, and its 13 hardcoded runtime === 'claude' / runtime !== 'claude' branches are folded into descriptor-driven runtime.hostBehaviors on capabilities/claude/capability.json (permission schema, settings.local.json scope routing, .gsd-source marker, effort frontmatter, canonical-workflow authorship, and more). Install/uninstall output is byte-identical for both the global skills layout and the local legacy layout (golden-parity asserted for both scopes); no other runtime changes. Removes the "add-a-host tax" of scattered string-equality checks for the tier-1 reference host. No user-facing change. (#2086) (#2106)
OpenCode is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). OpenCode and its Kilo sibling previously installed via a bespoke runtime === 'opencode'/isOpencode branch in bin/install.js; its commands+skills+plugin install now runs through the imperative adapter → the engine's combined-family install path (installRuntimeArtifacts), and every hardcoded runtime === 'opencode' branch is folded into descriptor-driven runtime.hostBehaviors. Install/uninstall output is byte-identical (golden parity asserted for all 16 runtimes). Two Context7-verified upgrades land: (1) background dispatch — OpenCode shipped experimental background subagents in v1.15 and made them default-on in v1.17, so dispatch.background/backgroundDispatch flip to true; GSD no longer force-flattens OpenCode-hosted wave dispatch (shouldFlattenDispatch now returns false), letting agents run concurrently where the host supports it. (2) expanded event surface — the OpenCode plugin now subscribes to permission.asked, permission.replied, and session.error (added to EXTENSION_EVENT_SURFACES.opencode), wiring the declared surface for future permission/error-aware bindings. (#2087) (#2108)
Codex is now driven through the public Host-Integration Interface, with three capability upgrades (ADR-1239 / EoS). Codex previously installed via hardcoded runtime === 'codex'/isCodex projection in bin/install.js; its config.toml / agent-.toml / hooks.json install now runs through the declarative embedding adapter and descriptor-driven runtime.hostBehaviors, with zero positive isCodex gates and zero runtime === 'codex' branches remaining (source-guarded). Install/uninstall output stays byte-parity-gated (tests/fixtures/golden-install-parity/codex.json). Three Context7-verified upgrades land, each with a test driving the user-reachable surface: (1) skill root — GSD skills now install to Codex's canonical $HOME/.agents/skills (via a skills-kind home override) instead of the deprecated $CODEX_HOME/skills fallback, and pre-move installs are migrated (stale ~/.codex/skills/gsd-* cleaned on both install and uninstall, user-owned content preserved); (2) hook events — GSD registers the six documented Codex lifecycle events it previously skipped (PreToolUse, PermissionRequest, PreCompact, PostCompact, SubagentStop, UserPromptSubmit, in addition to the existing SessionStart/SubagentStart/Stop/PostToolUse) in hooks.json, so gsd-context-monitor fires at the same points as in Claude Code, and the descriptor extendedHookEvents is reconciled from [] to the schema-valid wired subset; (3) dispatch tuning — [agents] max_depth = 1 is written explicitly into the managed config.toml block to pin the negotiated dispatch.maxDepth: 1 axis (degradationFor flattens GSD-hosted waves to single-level), and validateCodexConfigSchema now permits a known-scalar-only [agents] AgentsToml table (coexisting with the flattened [agents.gsd-*] role sub-tables) while still rejecting the [[agents]] and unknown-key break-forms from #2760. (#2088) (#2110)
Cursor is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). Cursor previously installed via hardcoded runtime === 'cursor'/isCursor branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded cursor branch is folded into descriptor-driven runtime.hostBehaviors (reapplyCommand, frontmatterDialect, hooksJsonSurface, skipSharedHooksInstall, reportCommandsDir, managedHookEvents). Install/uninstall output is byte-identical (golden parity asserted for all 16 runtimes). Two Context7-verified upgrades land: (1) expanded hook-bus coverage — GSD registers all 6 managed lifecycle events in Cursor's hooks.json (preToolUse, stop, subagentStart, subagentStop in addition to the original sessionStart/postToolUse), driven by a new descriptor-driven adapter module (src/host-integration-adapters/imperative-hook-bus.cts) that reads hostBehaviors.managedHookEvents instead of a hardcoded event pair; cite https://cursor.com/docs/hooks. (2) named/background nested subagent dispatch — Cursor's dispatch.background/backgroundDispatch/nested are all true with maxDepth: 2, so shouldFlattenDispatch(cursor) returns false and GSD's wave-based execution drives Cursor's native background + depth-2 nested subagent invocation instead of flattening to inline sequential calls; cite https://cursor.com/docs/subagents + https://cursor.com/docs/sdk/typescript. (#2089) (#2120)
Cline is now driven through the public Host-Integration Interface, with two capability upgrades (ADR-1239 / EoS). Cline previously installed via hardcoded runtime === 'cline'/isCline branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded cline branch is folded into descriptor-driven runtime.hostBehaviors (reapplyCommand, frontmatterDialect, skipSharedHooksInstall, localTargetIsProjectRoot, clineRulesSurface, localCommandsViaRules). Install/uninstall output is byte-identical (golden parity asserted for cline + claude/cursor/codex/opencode). Two Context7-verified upgrades land: (1) AgentPlugin.hooks.beforeTool planning guard — the .clinerules/hooks/PreToolUse file-convention hook (#787) is re-implemented as a real Cline SDK AgentPlugin that cancels write-class calls targeting .planning/ (same fail-open semantics), driven by a new descriptor-driven adapter module (src/host-integration-adapters/cline-sdk-binding.cts); cite https://github.com/cline/cline/blob/main/docs/sdk/plugins.mdx. (2) createAgentModel model overrides — DefaultGateway.createAgentModel({providerId, modelId}) is wired so GSD's per-subagent model_overrides/model_profile_overrides resolution applies to Cline subagents (modelMode: active); cite https://github.com/cline/cline/blob/main/docs/sdk/reference/gateway.mdx. Cline's dispatch deliberately stays degraded/flat (maxDepth: 1, read-only, no nested spawning) per the documented host restriction — never silently upgraded to full nested/background. (#2090) (#2132)
Hermes Agent is now driven through the public Host-Integration Interface, with three capability upgrades (ADR-1239 / EoS). Hermes previously installed via hardcoded runtime === 'hermes'/isHermes branches in bin/install.js; its install/uninstall now runs through the imperative adapter, and every hardcoded hermes branch is folded into descriptor-driven runtime.hostBehaviors. Three upgrades land: (1) real plugin hook vocabulary — GSD registers a new extensionEvents: "hermes" dialect carrying the 13 documented Hermes plugin events (pre_tool_call, post_tool_call, pre_llm_call, post_llm_call, on_session_start, on_session_end, on_session_finalize, on_session_reset, subagent_start, subagent_stop, pre_gateway_dispatch, pre_approval_request, transform_tool_result), replacing the borrowed hookEvents: "claude" 6-event surface that silently never fired; cite https://github.com/nousresearch/hermes-agent/blob/main/website/docs/user-guide/features/hooks.md. (2) dispatch posture — Hermes' dispatch.nested: true with maxDepth: 1 is correctly negotiated (not silently flattened). (3) branding/category metadata — DESCRIPTION.md category descriptions, version: frontmatter, and branding rewrites are now descriptor-driven rather than hardcoded. Install/uninstall output is byte-identical (golden parity asserted for all runtimes). (#2091) (#2134)
Qwen Code now projects GSD's specialist agents as native subagents — installing GSD into Qwen Code writes ~/.qwen/agents/gsd-*.md files you can invoke directly (planner, executor, code-reviewer, …) instead of reaching them only through skill prose, and a SubagentStart hook now fires alongside SubagentStop. Qwen's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2092) (#2153)
Kilo Code now supports native hooks, active-model routing, and named subagent dispatch — installing GSD into Kilo wires a lifecycle-hook plugin, keeps each agent's requested model instead of dropping it, projects GSD's specialist agents as invokable subagents, and documents the GSD MCP companion. Kilo's install is driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2093) (#2156)
GSD skills installed for Trae now carry SOLO stage metadata — Trae's SOLO Agent can recognize GSD skills as workflow-stage skills for auto-invocation instead of requiring manual triggering. Several of Trae's install branches (shared-hooks gating, path rewrites) also move onto its capability descriptor. Note: the stage-metadata field is a best-effort/inferred shape — Trae publishes no formal schema. (#2094) (#2157)
Installing GSD into Antigravity now writes the permissions.allow rules its CLI documents — so GSD's own reads and hooks aren't stuck on interactive prompts — and registers GSD's companion MCP server via a standalone mcp_config.json (best-effort: Antigravity's raw config schema isn't published, so this uses the Gemini-CLI-successor format). Antigravity's install is now driven by its negotiated capability descriptor instead of hardcoded runtime special-cases. (#2096) (#2165)

Augment Code now installs through its capability descriptor, with a native MCP companion — installing GSD into Augment registers the GSD companion server in Augment's `settings.json` `mcpServers` and drives command/skill/agent conversion from Augment's negotiated descriptor instead of hardcoded runtime special-cases. (#2097) (#2166)

CodeBuddy now wires GSD's full extended lifecycle hook set and is driven by its capability descriptor — installing GSD into CodeBuddy now registers `SubagentStart`, `SubagentStop`, `Stop`, and `PreCompact` hooks in its `settings.json` (it previously had none of these), matching the coverage Qwen/Kimi already ship, and CodeBuddy's install is fully descriptor-driven instead of via residual hardcoded runtime branches. (#2098) (#2169)

GitHub Copilot now wires GSD's full lifecycle hook bus and is driven by its capability descriptor — installing GSD into Copilot registers preToolUse, postToolUse, userPromptSubmitted, and sessionEnd handlers in its hooks/gsd-session.json (beyond today's sessionStart-only advisory), and Copilot's residual hardcoded runtime branches are folded onto descriptor-driven hostBehaviors. (#2099) (#2172)

Windsurf now enforces GSD's write/command safety guards through Cascade's native hook bus — installing GSD into Windsurf registers blocking pre_write_code/pre_run_command hooks in .windsurf/hooks.json (exit-code-2 blocking) and drives Windsurf's install from its capability descriptor instead of hardcoded runtime branches. (#2100) (#2190)
ZCode's install is now driven and regression-tested through its capability descriptor — ZCode joins the dogfooded declarative-adapter reference hosts with a byte-identical install, and its shared-hooks exclusion is folded onto hostBehaviors instead of a hardcoded runtime branch. (Hook-automation and MCP upgrades remain blocked on ZCode publishing its on-disk config formats.) (#2101) (#2195)
Codex/OpenAI default models advance to the GPT-5.6 family (Sol/Terra/Luna) — the Codex runtime tier defaults and the openai provider preset now resolve to current-generation model IDs instead of the superseded GPT-5.4/5.5 line, so Codex users on default profiles get improved agentic coding (Sol) and lower costs (Terra/Luna) without changing any config. (#2122) (#2146)
Internal: the installer's program (display-name) + command (slash-invocation) chains are now single-source lookups — the 14-line program chain (an exact duplicate of runtimeLabel) → getRuntimeLabel, and the 14-line command chain (the per-runtime /gsd-new-project syntax: gemini /gsd:, codex $, cursor skill-mention, kimi /skill:, default /gsd-new-project) → new getRuntimeNewProjectCommand(runtime) helper (ADR-1239 Phase B / #1679 AC2 slice 4). runtime === count in bin/install.js: 53 → 25 (cumulative this session: 129 → 25). Stdout strings preserved byte-for-byte; no install-output change (golden-parity 16/16). No user-facing change. (#1813)
Internal: the installer's per-function is<Runtime> flag-declaration blocks are now a single runtimeFlags lookup — the four duplicated const isX = runtime === 'x' blocks in bin/install.js (uninstall / writeManager / install / a fourth helper — 48 branches) are collapsed into one runtimeFlags(runtime) helper in runtime-name-policy.cts (ADR-1239 Phase B / #1679 AC2 slice 3). The add-a-host tax for flags is removed (one RUNTIME_FLAG_IDS entry, not four declaration blocks). Install output is byte-identical for all 16 runtimes (golden-parity asserted); runtime === count in bin/install.js: 101 → 53. No user-facing change. (#1811)
Internal: third-party descriptor loader enforces configHome write-confinement at load time — loadRegistry({includeInstalled:true, configHome}) now rejects (skip + warn, fail-closed) any installed third-party host-plugin descriptor whose declared destSubpath resolves outside the supplied configHome, before it is composed into the registry (ADR-1239 Phase C-2 / #1681 slice 2). The configHome option is optional and backward-compatible (omitted → no load-time check; install-time gate still bounds writes). No user-facing change for existing flows. (#1808)
Internal: agent install for cursor/windsurf/augment/trae/codebuddy now flows through the descriptor path — ADR-1235 step 1 routes the trivial-converter runtime group's agents off the inline install() loop onto the descriptor-driven installRuntimeArtifacts path, applying the cross-cutting steps uniformly (pre-converter, no workflow-stamp). Agent output is byte-identical for all 16 runtimes (golden-parity asserted, global + local verified); no user-facing change. (#1764)
gsd-ui-checker gains an adversarial FORCE stance (LLM-playbook principle 16) — the only verdict-producing critic that lacked one now resists rubber-stamping UI-SPEC contracts, with BLOCK/FLAG/PASS classification. Based on arXiv 2505.23840 (third-person objective persona), 2506.04975 (objective-not-hostile persona). (#1584)
Internal: the declarative embedding adapter is now named + bound behind a minimal HostIntegrationInterface — createDeclarativeAdapter({runtime}) (new src/adapter-declarative.cts) delegates in-process to install-engine's installRuntimeArtifacts/uninstallRuntimeArtifacts, formalizing today's projection path as one of the two embedding adapters behind a common contract (ADR-1239 Phase C-1 / #1680 AC1). Output is byte-identical to today's install (gated by golden-install-parity). The full 6-point interface binding surface is deferred until the imperative adapter (AC2) fixes the shape (ADR-1239 open wire-shape question). No user-facing change — the adapter is not yet wired to any runtime path. (#1802)
Internal: getDirName is now derived from a documented runtime.localConfigDir descriptor field — each runtime's local content-rewrite directory (e.g. cursor→.cursor, copilot→.github) moved from a hand-maintained if-chain into its capability descriptor (ADR-1239 Phase B), so it can no longer drift from the registry. Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing change. (#1757)
Internal: copyWithPathReplacement converter selection is now data-driven — the installer's back-compat content-copy path replaced its 13 hardcoded runtime === 'x' flag chains with a single per-runtime dispatch table (ADR-1239 Phase B). Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing change. (#1759)
Phase-completion now writes Status: All phases complete instead of the overloaded bare Milestone complete — the phase-level completion verb (completePhaseCore) was writing the same bare 'Milestone complete' string that the milestone-close verb uses for terminal state, causing a phase-level verb to own a milestone-level field. Per ADR-2207, phase-completion now writes the existing intermediate value 'All phases complete' (already used in gsd2-import.cts); milestone termination (' milestone complete' / 'Awaiting next milestone') remains solely with the milestone-close verb. (#2204) (#2259)
#853 dispatch-flatten is now data-driven (ADR-1239 Phase B) — whether GSD backgrounds the plan/execute orchestrator is decided from a documentation-sourced backgroundDispatch capability per host (via gsd_run query dispatch-should-flatten) instead of a hardcoded runtime === 'codex' check. Cursor now backgrounds the orchestrator (its docs document backgrounded subagent nesting); codex unchanged; all other hosts run inline. Fail-closed to inline on any uncertainty. (#1719)
Internal: companion MCP server module (interface points 1 + 5) — handleMessage/runServer (new src/mcp-server.cts) is a minimal, dependency-free stdio JSON-RPC 2.0 server exposing gsd_invoke_command (→ the command-routing hub) + gsd_read_state/gsd_write_state (→ the Phase 3 stateIO seam), so any MCP-consuming host can drive GSD with no bespoke plugin (ADR-1239 Phase C-2 / #1681 slice 3a). Bin entry / packaging deferred to slice 3b. No user-facing change — the server is not yet wired to a bin entry. (#1809)
requirements mark-complete reports a per-surface write-set — the command now returns a per-requirement write_set (checkbox + traceability surfaces) and a write_set_complete that is true only when every surface of every requirement applied, so a partial (checkbox-only) reconcile can no longer masquerade as full success even inside a multi-ID batch. Introduces the reusable ADR-2143 §5/§6 Result / WriteSet contract. (#2251) (#2251)
Internal: the imperative embedding adapter now composes the capability registry behind the same HostIntegrationInterface — createImperativeAdapter({runtime}) (new src/adapter-imperative.cts) calls loadRegistry({includeInstalled:true}) (first-party-wins + consent + fail-closed — identical trust semantics to the CLI) and binds the engine surface behind the same contract the declarative adapter (AC1) satisfies, plus a registry accessor for an in-process host to bind its primitives to (ADR-1239 Phase C-1 / #1680 AC2). Concrete host binding is deferred to Phase 5. No user-facing change — the adapter is not yet wired to any runtime path. (#1803)
Internal: the model adapter seam exposes passive + active adapters selected by modelMode — createModelAdapter({modelMode}) (new src/model-adapter.cts): passive formalizes today's tier routing (delegates to model-resolver.resolveModelForTier), active is a host-supplied sendRequest seam (VS Code vscode.lm / pi providers), fail-closed until Phase 5 binds a concrete provider (ADR-1239 Phase C-1 / #1680 AC3). No user-facing change — the seam is not yet wired to any runtime path. (#1804)
Internal: derive the non-Claude runtime list from the capability registry — NON_CLAUDE_RUNTIMES is now computed from the capability registry instead of a hand-maintained literal, so it can no longer drift from the per-runtime descriptors. No user-visible behavior change (the list is identical). (#1728)
Honest verifier — verify-phase now abstains on non-inferable backstop truths instead of confidently false-passing them (#1154). When the spec's edge-probe marks a truth non-inferable (verification: backstop) and the verifier cannot confirm it with explicit evidence (a passing wired held-out/property test, or a directly-observed behavior), it now reports human_needed with reason insufficient_spec ("unverified — held-out test recommended") rather than a silent passed. Autonomous runs complete with "N unverified non-inferable checks"; interactive runs route to the end-of-phase human checkpoint. Inferable truths are never abstained (over-abstention guard); abstention is exogenous (driven by the tag, not self-judgment). Truth-axis mirror of the prohibition judgment-tier (ADR-550 D4). (#1738)
Document Claude Code's advisor-tool inheritance in the model-profiles reference: the session-level advisor is inherited by all GSD subagents and composes with per-agent tiering, with candidate executor/advisor pairings, when it is worth enabling, and the session-level (no per-agent control) constraint. (#1922)
Extraction discipline for strict-format agents (LLM-playbook principle 8) — gsd-doc-classifier and gsd-doc-synthesizer apply taxonomy/precedence rules directly without inventing content, reducing reasoning-induced format drift. Based on arXiv 2504.05081 (few-shot beats CoT for pattern tasks), 2506.00069 (terminal instruction placement), 2505.14810, 2505.11423. (#1584)
Internal: extracted the runtime-artifact install engine from bin/install.js — installRuntimeArtifacts/uninstallRuntimeArtifacts/installOpencodeFamilySkills and their helpers now live in a dedicated gsd-core/bin/lib/install-engine.cjs module (ADR-1239 Phase B), so adapters can import the install pipeline instead of reaching into the 12k-line installer. Install output is byte-identical for all 16 runtimes (golden-parity asserted); no user-facing behaviour change. (#1735)
MemPalace memory_mode kg_backend and replace are now functional — selecting either mode now routes recall through the palace instead of silently behaving like augment: kg_backend treats the palace temporal KG as the primary knowledge-graph source (native .planning/graphs/ as fallback), and replace resolves recall through the palace as the source of truth. Every mode stays default-resilient — an unreachable palace falls back to native memory and no memory is lost. (#2010) (#2010)
/gsd:surface and --materialize now produce byte-identical agent output to a fresh install — surface-path agents for descriptor-driven runtimes (cursor, windsurf, augment, trae, codebuddy, copilot, antigravity) now receive the same path-prefix rewrite, Co-Authored-By attribution, runtime-specific conversion, and body normalization as the install path. Copilot and Antigravity agents are now installed via the descriptor-driven path (copilot agents get the .agent.md filename rename). Cline remains on the inline loop (rules-only local branch). (#1575) (#2040)
Internal: hook-bus + stateIO adapter seams — createHookBus({bus}) (new src/hook-bus.cts, host/engine/none — engine is in-process pub/sub, host fail-closed, none silent) + createStateIO({io}) (new src/state-io.cts, filesystem/sandboxed-storage/session-log-append — filesystem delegates to fs, the rest are fail-closed seams) (ADR-1239 Phase C-1 / #1680 AC4). Completes the Phase 3 adapter seam layer; concrete host binding is Phase 5. No user-facing change. (#1805)
Long-context model names render compactly in the statusline — the verbose " (1M context)" suffix Claude Code appends to the model display name now collapses to a compact " (1M)" badge (tolerant of future window sizes and the abbreviated "ctx" variant: "(500K context)" → "(500K)", "(1M ctx)" → "(1M)"). Lossless — the long-context signal stays, the 12 characters of width don't. (#2160) (#2173)
Lazy-split plan-phase.md into a steps/ directory — ~4.7 KB lighter eager context per /gsd-plan-phase call via byte-invariant progressive disclosure (ADR-1610). (#1852) (#1934)
GSD subagents now self-load configured agent_skills regardless of orchestrator bash — projects that map skills via .planning/config.json agent_skills.<agent-type> no longer silently lose them on /gsd-autonomous or Cursor, where Skill()-delegated workflow bash init did not reliably run. Each of the 22 consumer agents queries its own type at init and reads the listed skills, with a dedup guard so runtimes that also inject orchestrator-side (Claude Code) never carry two copies. (#1866) (#1868)
Internal: install/uninstall runtime labels are now sourced from a single getRuntimeLabel lookup — the two duplicated runtimeLabel assignment chains in bin/install.js (uninstall + install) are collapsed into one curated label table in runtime-name-policy.cts, sibling to the registry-derived getDirName (ADR-1239 Phase B, #1679). Install output is byte-identical for all 16 runtimes (golden-parity asserted). Two console-label inconsistencies are normalized as a side effect: kimi shows 'Kimi CLI' in both sites, and cline uninstall no longer falls through to 'Claude Code'. (#1800)
Internal: external-descriptor trust gate — load-time configHome confinement — assertDescriptorConfined(descriptor, configHome) (new src/external-descriptor-trust.cts) fail-closed rejects any installed third-party host-plugin descriptor whose declared destSubpath resolves outside the user-approved configHome, before its install plan runs (ADR-1239 Phase C-2 / #1681 slice 1). Defense-in-depth load-time twin of Phase 2's install-time assertDestWithinConfigHome. Not yet wired into the loader (slice 2). No user-facing change. (#1806)
Internal: the installer's runtime → global-config-home hook-pathogen fragment is now a single getGlobalConfigHomeFragment lookup — the 14-branch if (runtime === 'x') return "'...'" chain in getConfigDirFromHome (bin/install.js, the hook path.join() codegen mapping) is collapsed into one table in runtime-name-policy.cts, sibling to getRuntimeLabel (ADR-1239 Phase B, #1679 AC2 slice 2). Generated hook output is byte-identical for all 16 runtimes (golden-parity asserted); antigravity's dynamic env-overridable resolution is preserved in the caller. No user-facing change. (#1801)

Removed

Removed the sunset Gemini CLI runtime — use Antigravity CLI instead — Google discontinued Gemini CLI on 2026-06-18, so npx gsd-core --gemini now prints a deprecation notice and points you to Antigravity CLI (the official successor), which GSD already ships as a first-class runtime. (#1928) (#1996)

Fixed

The verify-work security-blocked presentation no longer offers next-phase planning. When security enforcement blocks phase advancement (no SECURITY.md produced), the workflow now routes only to the current-phase fix instead of competing /gsd:plan-phase {next} and /gsd:execute-phase {next} options. (#1687)
milestone complete and roadmap analyze now exclude the Phase 0 / Phase 999 backlog sentinels. A milestone whose only directory-less ROADMAP heading is a backlog sentinel can be completed without --force, and roadmap analyze no longer counts the sentinel in phase_count or routes next_phase into it. Completes the ^999 exclusion #1445 added to the progress denominators. (#1691)
config-set no longer silently coerces values into something the disk never sees — Number.isFinite replaced !isNaN in the value parser so Infinity/-Infinity are no longer coerced to non-finite numbers that JSON.stringify then renders as null on disk while the CLI echoes Infinity (output ≠ disk). context_window now has a per-key validator requiring a finite positive integer (rejects Infinity, 0, negatives, non-integers with a non-zero exit), and project_code is always persisted as a string so a leading-zero code like 007 survives verbatim instead of collapsing to 7. Numeric coercion for genuine numeric keys (e.g. granularity 42) is unchanged. (#1581) (#2023)
phase.complete no longer reports a false is_last_phase on a <details>-wrapped checkbox checklist (#1591, #1752) — when the active milestone's phase checklist was written as - [ ] Phase N: checkbox items inside a <details> block and the next phase had no directory on disk yet (still in planning), phase.complete's isLastPhase roadmap-enumeration fallback used a heading-only pattern (/#{2,4}\s*Phase…/) that never matched checkbox items. It returned is_last_phase: true, next_phase: null on a mid-milestone phase and — via the milestone-complete cascade — wrongly flipped STATE.md to Milestone complete and decremented progress.total_phases (e.g. 8 → 7). The pattern now matches heading-style (### Phase N:), plain checkbox-list phases (- [ ] Phase N: / - [x] Phase N:), and the canonical bold checklist form the roadmap template emits (- [ ] **Phase N: Name**); extractCurrentMilestone already surfaces the <details>-wrapped checklist correctly, so no parser change was needed. Only the reproduced phase.complete fallback is changed; the heading-only sibling patterns elsewhere in phase.cts are untouched. (#1819)
The <agent_skills> block emitted by gsd init no longer leaks backslash paths into @-reference skill paths on Windows. The global skill directory (a native path.join result) was interpolated into the generated markdown without POSIX normalization, producing references like @C:\…\skills\name/SKILL.md; the reference is now normalized at the emit site so skill references use forward slashes on every platform. (#1736)
/gsd-settings no longer warns about four search-provider keys on fresh projects (#1747) — buildNewProjectConfig emits seven search-provider availability flags and research-provider.cts providerAvailability() consumes all seven, but only three were registered in VALID_CONFIG_KEYS (config-schema.manifest.json). Running /gsd-settings on a freshly generated .planning/config.json printed unknown config key(s) … tavily_search, ref_search, perplexity, jina — these will be ignored even though the user never hand-edited the config. The four missing keys are now registered alongside brave_search/firecrawl/exa_search and documented in docs/CONFIGURATION.md; a drift guard in tests/bug-2530-valid-config-keys.test.cjs now requires every config-driven research-provider flag to be in the schema, so a future provider addition cannot reintroduce the drift. (#1814)
gsd-tools state json no longer reports conflated progress for an unversioned milestone (#1761) — the ADR-1769 Phase 7 fix (#1794) taught state sync to leave Progress untouched when a milestone version is asserted but the ROADMAP has no versioned heading for it, but the state json read path still rebuilt progress via buildStateFrontmatter, whose phase-heading count fell back to the whole document and summed sibling milestones. state json therefore reported a conflated total_phases (e.g. 8 = 4+4 across two milestones) plus a derived percent, contradicting the sync guard on the very same project. The read path now mirrors the sync guard: when the asserted milestone cannot be bounded to a versioned ROADMAP heading, total_phases falls back to the on-disk phase-dir count and percent is omitted. Bounded milestones (versioned ROADMAP, or no milestone asserted) are unchanged; the signal rides on the existing _diskScanCache so extractCurrentMilestone's return contract and its other callers are untouched. (#1818)
gsd-graphify-update.sh now reads the full multi-line command in Gate 2 (#1772) — the PostToolUse auto-update hook joined tool_name + \n + tool_input.command and extracted the command with sed -n '2p' (line 2 only). Agent runtimes (Claude Code's Bash tool among them) routinely emit HEAD-advancing commits as multi-line scripts (cd /path, then git add, then git commit …), so line 2 was the cd, Gate 2's *"git commit"* match failed, and the rebuild silently no-op'd on real commits even with graphify.auto_update: true. The failure was invisible in manual probes because a single-line git commit -m x passes line 2 verbatim. The hook now captures line 2 through EOF (sed -n '2,$p') so the case glob sees the full command string; single-line behavior is unchanged and multi-line commands without a HEAD-advancing op still no-op cleanly. (#1815)
/gsd-thread close|resume now writes the thread status/updated frontmatter (#1778) — the thread workflow's CLOSE and RESUME branches invoked frontmatter.set with the pre-1.6 fully-positional shape (frontmatter.set <file> <field> <value>), but since 1.6 the dispatcher parses the file positionally and reads field/value from the named flags --field/--value via parseNamedArgs. The positional form left field/value undefined, cmdFrontmatterSet errored file, field, and value required, and the writes were silently skipped — so closing a thread never marked it status: resolved and resuming never marked it status: in_progress, with the error scrolling past on every thread command. All four sites (CLOSE status+updated, RESUME status+updated) now use the 1.6 hybrid form that verify-work.md already uses (frontmatter.set <file> --field <field> --value <value>). (#1816)
The installer no longer copies dead lifecycle hook scripts for Kilo and ZCode — both declare hooksSurface: 'none' and have no plugin surface, so the staged hooks/*.js, hooks/*.sh, hooks/lib/ and the CommonJS package.json marker were dead weight in ~/.kilo/ and ~/.zcode/. The two hook-copy guards in install.js now exclude Kilo and ZCode alongside the other no-hook runtimes. OpenCode, which also declares hooksSurface: 'none', is deliberately kept: its native plugin adapter (#1914) spawns those staged hooks via OpenCode's event bus and needs both them and the marker. (#2057)
Test gates can no longer hang forever on a watch-mode test runner. vitest defaults to watch mode in an interactive terminal (exactly where gsd-execute-phase runs), so a resolved npm test / pnpm test that maps to vitest never exited and the orchestrator waited indefinitely until the user manually intervened. Every GSD test-command gate — the regression gate, the post-merge gate, the audit-fix gate, and the verify-phase gate — now routes the resolved command through a shared normalize-test-command helper that rewrites it to a one-shot form (direct vitest → vitest run; jest --watch → --watchAll=false; a package-manager test script backed by watch-vitest → CI=true prefix; already-one-shot commands are left unchanged). The three gates that previously hung or silently continued — the regression, post-merge, and audit-fix gates — additionally bound execution with a configurable workflow.test_gate_timeout (default 600s), aborting or surfacing the cause on timeout instead of hanging; the verify-phase gate was already bounded (a fixed 5-minute limit) and keeps it, now naming watch mode on timeout. The normalizer only rewrites a runner named as a standalone command token (so paths/targets like run-vitest.js are never mangled), is length-capped and linear-time on adversarial input, and only reads a regular-file package.json. (#2060)
settings-advanced.md no longer has an orphan </step> around §8 Model Policy — the §8 Model Policy block ended with a closing </step> but had no matching opening tag (5 opens / 6 closes), leaving its content as loose inter-step prose that could fail to execute reliably. Added the missing <step name="model_policy"> opener so the section is a proper step. A new workflow <step>-tag-balance regression guard (fenced-code-stripped) now blocks any future orphan tag across all top-level workflows. (#1864) (#2014)
The runtime launcher now honors CLAUDE_CONFIG_DIR — the gsd_run preamble embedded in every workflow/agent resolved the Claude global install only at $HOME/.claude/gsd-core/bin/, while the installer honored CLAUDE_CONFIG_DIR, so a global install redirected via CLAUDE_CONFIG_DIR was invisible to every gsd_run call (every GSD command failed with gsd-tools.cjs not found). The Claude resolver arm now uses ${CLAUDE_CONFIG_DIR:-$HOME/.claude} — matching the installer and the other runtimes' ${VAR:-default} pattern — so a custom CLAUDE_CONFIG_DIR is found and the default $HOME/.claude path is unchanged. Re-synced into all 95 workflows/agents; two capped workflows trimmed to stay under their byte budgets. (#1865) (#2024)
Node-test prohibition proofs now require a clean-fixture causation control — a node-test prohibition's fail-first proof no longer accepts a deceptive content-independent negative test (one that reds merely because GSD_PROHIB_SUBJECT is set, ignoring the subject's content). The check_clean_fixture control is now mandatory for the node-test kind: a descriptor that omits it is un-provable and hard-gates, rather than greening on the violation alone. Breaking (Hyrum): a previously-green node-test prohibition with no clean fixture now hard-gates — blast radius is zero in-tree (no node-test prohibition ships today). The lint-rule kind is unchanged (its subject IS the linted file, no GSD_PROHIB_SUBJECT indirection). (#1906) (#2001)
Third-party capabilities now work on installed layouts. capability install no longer rejects capabilities with a real engines.gsd range as "incompatible with GSD 0.0.0" — the host version is now read from the authoritative gsd-core/VERSION file across every runtime and the capability install CLI. The installer also now ships the registry generator scripts (gen-capability-registry.cjs, gen-loop-host-contract.cjs), so installed third-party capabilities actually compose into the loop instead of being silently discarded. (#1938)
/gsd:verify-work preserves verification state across gap-closure execution and no longer auto-promotes deferred follow-ups into blocking gaps — resuming after /gsd:execute-phase --gaps-only used to lose the verification state: the UAT ## Gaps still read status: failed even after their fix plans executed, so verify-work re-diagnosed them as fresh blockers, spawned a new gap plan, and reported only the new plan as verified. A state contract now links each gap to its fix plan: every UAT gap carries a stable gap_id (G-{phase}-{N}), gap-closure plans tag the ids they address in their frontmatter (gap_ids: […]), and a new reconcile_gaps step on resume marks a gap status: resolved when its plan has a matching *-SUMMARY.md — so fixed gaps aren't re-diagnosed and the phase can close. Separately, a deferred-follow-up branch captures future-work ideas (signals like "later", "next version", "out of scope") into a ## Deferred Follow-Ups section instead of creating a blocking gap/plan. (#1921) (#2025)
roadmap update-plan-progress no longer counts stray non-plan *-SUMMARY.md files against phase completion — remediation/gap-closure summaries (e.g. 30-FIX-CR02-SUMMARY.md, 30-GAPCLOSURE-SUMMARY.md) inflated summary_count, and once summary_count >= plan_count the phase silently flipped to Complete (checkbox checked, date stamped) even though several plans had no summary. A new countMatchedSummaries helper (core-utils) pairs summaries to plans via the PLAN→SUMMARY marker swap + the <stem>-SUMMARY.md form (layout-agnostic across root, bare, and nested layouts), so only a summary that corresponds to a real plan counts. Wired into scanPhasePlans (fixing roadmap listing, state sync, verification, workstream inventory at once) and cmdRoadmapUpdatePlanProgress. (#1988) (#2016)
milestone complete --ws requirements archive header now points at the workstream REQUIREMENTS.md — the archive header string hardcoded the root path (`…see .planning/REQUIREMENTS.md`), so a workstream archive directed readers at the wrong file even though #1917 had already fixed the archive locations to land inside the workstream. The display path is now derived from the same workstream-aware reqPath the writer uses (path.relative(cwd, reqPath)), so root behavior is byte-identical and the workstream case correctly reads .planning/workstreams/<ws>/REQUIREMENTS.md. (#1993) (#2015)
Load-failed capability gates now fail open with a loud warning instead of blocking the whole project — when an installed overlay (third-party) capability failed to load (e.g. an incompatible engines.gsd range) but had declared a gate-kind loop hook, the loop resolver injected a blocking synthetic gate (blocking:true, onError:halt) at every point where that capability declared a gate. A single incompatible capability therefore halted every ship:pre and verify:post in the project — unrelated to what the gate would have checked, and with no remediation surfaced. The resolver now injects no gate and instead emits a loud warning — to stderr and in the loop render-hooks envelope's warnings array — naming the load-failure reason and the exact gsd capability remove <id> remediation, and the loop proceeds (fail open). The capability id embedded in that remediation is validated against the canonical id shape first, so a malformed overlay directory name cannot inject shell metacharacters into the surfaced command. The loader still records _overlay.blockedGates; only the consequence changes from block to warn. step/contribution overlays were already skip-open. (#2009) (#2075)
phase.complete now updates the ## Progress rollup row even when an earlier phase-numbered table precedes it — the Progress-row writer used a non-global regex that matched any table row starting with the phase number, so it bound to the first such row (e.g. a | Phase | Requirements | Count | coverage table), no-op'd on the wrong 3-column row, and never reached the real Progress row. The regex is now scoped to the ## Progress section so it binds to the correct table. The command still returned roadmap_updated: true (that field is fs.existsSync(ROADMAP.md)), masking the silent failure. (#2012) (#2032)
context7 now works for plugin-marketplace installs (8 agents regained doc lookup) — the agents granted only mcp__context7__*, which matches a standalone context7 MCP server but not the official Claude Code plugin-marketplace install (context7@claude-plugins-official), whose tools are named mcp__plugin_context7_context7__*. The grant never matched, so advisor/ai/domain/phase/project/ui-researcher + planner + executor silently lost documentation lookup and fell back to WebSearch. All 8 agents now grant both forms, the researcher profile table is updated, and a parity guard asserts no agent grants the standalone form without the plugin form. (#2017) (#2029)
applySurface no longer deletes every gsd-* agent when the skills manifest resolves empty — the agent-prune loop in _syncGsdDir deleted any gsd-*.md not in the staged set, and when the manifest was empty/unresolvable (null manifest, no array entries, no files key, or an unresolvable install source root), the staged set was empty → every agent was pruned. Skills were guarded by pruneSkillDirs's manifest-membership check (conservative preservation on empty manifest); agents had no equivalent. The agent-prune loop is now skipped when the manifest is empty/absent, so agents are preserved while copy (adding genuinely new agents) still runs. (#2018) (#2031)
planning-config.md global-learnings path corrected to ~/.gsd/knowledge/ — the features.global_learnings row directed users to ~/.gsd/learnings/, but the implementation (src/learnings.cts, execute-phase.md) stores and reads global learnings from ~/.gsd/knowledge/. Anyone following the docs to inspect, back up, or seed their global learnings looked in a directory the code never touches. (#2019) (#2026)
Removed dead SDK file references from runtime-loaded markdown that triggered an infinite find.exe storm on Windows — agents/gsd-executor.md pointed at sdk/src/query/QUERY-HANDLERS.md and gsd-core/workflows/reapply-patches.md at sdk/dist/cli.js, both retired with the SDK package (ADR-0174). AI runtimes that resolve doc references by filesystem search ran find / -iname …; on Git Bash for Windows / maps to the drive root, so find.exe traversed the whole disk (14h+, orphaned processes, 4M+ open handles each, unkillable). The references now resolve to live paths, and a new regression guard asserts no sdk/src|sdk/dist|sdk/handlers file references remain in agents/workflows/references markdown. (#2020) (#2027)
roadmap update-plan-progress no longer checks the phase checkbox without verification — the command stamped the phase-level ROADMAP checkbox and completion date the moment the last plan summary landed (called routinely after every wave and every plan), with no verification gate — unlike phase.complete which correctly requires readVerificationStatus(...).status === 'passed'. Now isComplete requires both all plan summaries AND a passed verification, matching the cmdPhaseComplete contract, so the checkbox only fires after gsd-verifier has confirmed the phase. (#2022) (#2030)
phase complete no longer marks a milestone done out of order, nor silently writes root state in workstream mode. Completing the numerically-highest phase while an earlier phase was still outstanding wrongly flipped STATE.md to Status: Milestone complete (the milestone-end check only looked for higher-numbered phases, so an out-of-order completion — e.g. Phase 10 before Phase 9 — read as the end). It now reports milestone-end only when every lower-numbered phase in the milestone is checked complete. Separately, in workstream mode with no active workstream, phase complete previously fell back to root .planning and wrote STATE.md/ROADMAP.md (and the mislabel) into the shared root other workstreams read; it now fails safe — asking for --ws <name> or an active workstream — mirroring the existing init progress guard. (#2066) (#2066)
Phase directories whose slug begins with a single digit now resolve correctly. A phase like 46-6-rs-pipeline-orchestrator (roadmap name "6 Rs Pipeline Orchestrator") had its phase token over-collected as 46-6 instead of 46, so gsd-tools phase-by-number lookups resolved phase_dir=null / has_context=false (breaking init.plan-phase, init.phase-op, and downstream execute/verify/ship). Numeric phase-token components must now be zero-padded (≥2 digits), so a single-digit slug word is no longer absorbed into the token. Fixed consistently across every same-class implementation — extractPhaseToken, PHASE_TOKEN_FROM_DIR_RE and canonicalPlanStem (health checks / plan pairing), isDirInMilestone's numeric matcher (milestone filtering), and extractCanonicalPlanId — so the health-check and milestone-filter subsystems are fixed alongside phase resolution. (#2059)
gsd-tools config-set <key> null now clears (removes) the key instead of persisting the literal string "null". The documented "Clear" action previously fell through the value parser and stored "null" — a truthy value — so "cleared" keys stayed set and config-get returned "null"; for secret keys (brave_search/firecrawl/exa_search) a masked success line hid a truthy value on disk that integrations could pass along as a real credential. config-set <key> null now deletes the key (short-circuiting the typed per-key validators so clearing an enum/boolean/number key removes it rather than being rejected), making the "Clear" flows in settings-integrations.md / settings-advanced.md actually clear. (#2058)
init plan-phase no longer collapses foreign-prefixed task/workstream IDs into numeric phases — a query like MEM-01 (where MEM is not the configured project_code) used to have its prefix stripped and resolve to the unrelated numeric Phase 01; it now reports phase_found: false unless a phase directory or roadmap entry literally carries that prefix. The configured project_code's own prefixed phases (e.g. LKML-01 under project_code: LKML) continue to resolve as before. (#2056) (#2105)
phase complete no longer ticks the wrong phase's ROADMAP checkbox — completing a phase whose number also appears in a later phase's description (e.g. an idempotent re-run of an already-complete phase) used to mark the wrong phase done, because the checkbox-matching regex greedily spanned from ] to any later "Phase N" mention instead of only the immediately-following phase title. (#2067) (#2079)
gsd-tools effort sync no longer crashes in an installed runtime. In any global install (e.g. ~/.claude/gsd-core/), effort sync threw Cannot find module '../../../bin/install.js' — the command reached into the package-root bin/install.js for its install-time effort resolvers, but the installer only copies the gsd-core/ subtree into a runtime home, so that file is never present there. As a result, effort config changes (routing_tier_defaults / agent_overrides) silently never reached installed agents without a full reinstall. The two resolvers (readGsdEffectiveEffortConfig + resolveInstallTimeEffort, with their helpers) are now extracted into a shipped gsd-core/bin/lib/install-effort-resolver.cjs that both effort sync and the installer import — a single source of truth that is always present in the installed tree. (#2076) (#2076)
model_overrides and per-phase-type models now actually apply to the assumptions-analyzer, code-reviewer, and code-fixer agents on Claude Code. Previously model_overrides["gsd-code-reviewer"] / ["gsd-assumptions-analyzer"] / ["gsd-code-fixer"] (and models.verification / models.discuss / models.execution) were accepted and resolved but silently dropped — the workflows spawned these agents with no model, so they inherited the session model and the configured routing never took effect (no warning). Every spawn now threads its resolved model: discuss-phase-assumptions, code-review, and code-review-fix (both the re-review and the two fixer spawns) resolve it inline, and quick's review step uses the code-reviewer's own resolved model instead of the executor's. The stale "discuss — reserved, no subagent" model-profile docs are corrected to list gsd-assumptions-analyzer, and the verification row now includes gsd-code-reviewer. (#2074) (#2074)
/gsd-review's Antigravity CLI reviewer no longer fails silently on large prompts, unavailable pinned models, or pre-session stalls — the agy invocation now uses a file-reference prompt to avoid exec arg-list overflow, is wrapped in an external wall-clock timeout paired with --print-timeout because --print-timeout cannot fire before agy creates a session, passes --model from review.models.agy when set as an escape hatch for a 404'd pinned model, and its empty-output stub now surfaces an agy cli.log diagnostic instead of a bare generic message. Supersedes the #687 "no external killer / inline $(cat)" contract, which predated agy gaining --model and predated its own guidance to pair --print-timeout with a terminal timeout. (#2073) (#2109)
init execute-phase, init verify-work, and init phase-op no longer collapse foreign-prefixed task IDs to numeric phases — MEM-01 under project_code: LKML was silently stripped to 01 and resolved to the unrelated numeric Phase 01, because the #2056 guard was applied only to init plan-phase. The guard is now extracted into shared helpers (guardedFindPhase / guardedGetRoadmapPhase) that delegate to the canonical isForeignPrefixedPhaseQuery from phase-id.cts, and all four init commands route through them. (#2104) (#2149)
commit --files now commits only the declared paths — gsd-tools commit --files A B previously ran a bare git commit that absorbed the entire staged index, silently sweeping in unrelated files the caller never named. The commit now appends a pathspec (-- <paths>) so only the staged subset of --files lands in the commit; the no---files default path is unchanged. Missing tracked files are still skipped (not committed as deletions, #2014), and when all declared files are missing the function short-circuits to nothing_to_commit instead of absorbing the index. (#2112) (#2148)
Fixed unresolvable bare require('gsd-core/...') in gsd-surface command doc — the four require() examples now derive the engine path from runtimeConfigDir (resolvable at runtime), and the reinstall hint corrects npm i -g gsd-core to npm i -g @opengsd/gsd-core. (#2116) (#2213)
milestone complete --dry-run now prints a preview plan instead of silently mutating — gsd-tools milestone complete --dry-run was neither parsed nor rejected, so a caller expecting a preview triggered the full destructive mutation (archive phases, move audit artifacts, rewrite STATE.md) with no way to back out. The --dry-run flag is now honored: it returns a JSON plan listing would_archive (roadmap, requirements, audit, phase dirs) and would_update (MILESTONES.md, STATE.md) targets with zero filesystem mutations. (#2118) (#2155)
/gsd-secure-phase now has a single SECURITY.md writer — the gsd-security-auditor subagent previously held Write/Edit tools and was instructed to "write SECURITY.md" with no padded <N>- prefix and no template frontmatter, while the orchestrator's Step 6 also wrote the phase-scoped <N>-SECURITY.md from templates/SECURITY.md. The auditor is now return-only (drops Write/Edit, returns a structured verdict with threats_open); the orchestrator is the sole file writer. The workflow's Step 5 spawn constraints explicitly forbid the auditor from writing SECURITY.md. (#2119) (#2154)
Dead security scan exports removed; injection-scan docs corrected to match reality — scanEntropyAnomalies and shannonEntropy were dead code with zero production callers (live hooks inline their own patterns for independence). REQ-SCAN-INJ-02/-03 now accurately describe what runs live (injection patterns, invisible Unicode) vs CI-only (base64-decode, codebase scan). (#2198) (#2211)
Custom STATE.md frontmatter keys are no longer dropped on every mutating verb — syncStateFrontmatter rebuilt the frontmatter from a fixed schema, silently dropping any custom key. It now carries forward existing keys the schema does not own. (#2202) (#2233)
Non-frontend phases with UI hint: no are no longer blocked by the UI-SPEC gate — the UI safety gate's token list included the bare token UI, which matched GSD's own **UI hint**: no metadata line and false-detected a UI, blocking backend/infra phases at /gsd-plan-phase. An explicit UI hint: yes|no is now authoritative and the hint line is no longer token-sniffed. (#2150) (#2222)
OpenCode reviewer no longer silently yields an empty review on large prompts — /gsd-review --opencode now invokes opencode run --format json and reconstructs the review from the assistant text parts, so a large-prompt run where the default build agent ends its turn with zero output tokens no longer produces an empty stub. When the agent genuinely emits no text, the stub now reports the stop reason, output-token count, and captured stderr instead of a generic message. (#1936) (#1992)
stale-bake-guard hermeticity fix (test-isolation) — the readGsdEffectiveModelOverrides subtest no longer reads the developer's real ~/.gsd/defaults.json; the resolver now accepts a homedir seam so the test sandboxes HOME. (#2152) (#2223)
/gsd-surface (list/status) works on Claude Code global installs — the installer now writes a .gsd-source marker pointing at its commands/gsd source, so findInstallSourceRoot resolves on the global skills layout (which ships no commands/gsd tree) instead of throwing could not locate commands/gsd. (#1487) (#1487)
phase complete --phase N now works alongside the positional form — the phase verb family treated the first positional as the phase number, so --phase 12 was passed as the literal phase name and failed with 'Phase --phase not found'. The phase family now accepts the --phase flag consistently with the state family, and unrecognized flags yield a usage error. (#2201) (#2231)
Third-party capability skills now surface correctly after install — a skills-only role: feature capability installed active but its skills never reached the runtime surface, capability enable/set rejected it as unknown capability, and capability list disagreed with capability state. resolveSurface now unions the composed registry's capabilityClusters into the surfaced skill set (no on-disk linking), the writer validates against the composed overlay-aware registry, and capability list carries a surfaced field matching capability state. (#2054)
Fixed: probe-core's runProbeCli now fails closed on per-item adapter garbage inside a well-shaped report envelope, matching its documented 'fails closed on adapter garbage' contract. (#1910)
/gsd:verify-work no longer silently terminates when all remaining UAT tests are blocked — sessions with blocked_count > 0 and pending_count == 0 now route to complete_session as expected, enabling the zero-issues auto-transition path. (#1722)
state record-metric no longer appends per-plan rows into the By-Phase velocity table — it now maintains its own Per-Plan Metrics table (self-created on first use), and its auto-create scaffold header is corrected. (#2253) (#2253)
Codex reviewer now captures the review via codex's --output-last-message flag instead of redirecting stdout, so Windows process-teardown output no longer pollutes the review file and slips past the empty-output guard. (#1709)
last_activity now shows your local calendar day — the clock seam derived the date by slicing a UTC instant, so in negative-UTC-offset zones during UTC's early evening the date-only last_activity field jumped a day ahead of the operator's actual date (and of last_updated's local date). Operator-facing date fields now use a host-local calendar day while internal/cosmetic stamps stay UTC. (#2136) (#2216)
milestone_name is no longer clobbered with a delimiter-led fragment — getMilestoneInfo's ## heading regex was unanchored, so it matched a heading quoted inside backticks in the Milestones bullet and wrote garbage like — Active Milestone over the curated milestone name on every phase transition. Now consults the 🚧 marker first, anchors the regex to line start, strips the leading delimiter, and widens the preserve guard so a bad derive keeps the existing name. (#2135) (#2215)
init milestone-op now counts project_code-prefixed phase directories correctly — fully shipped milestones using the standard prefixed directory layout no longer report completed_phases: 0 or stay falsely incomplete. (#1844) (#1844)
/gsd-quick no longer halts with a stale-base worktree mismatch — the worktree executor now degrades to sequential execution when its fork base has diverged from origin/HEAD, instead of spawning a worktree guaranteed to fail the base-mismatch guard. (#1991)
Setting external_job.submit_timeout_ms / poll_timeout_ms / artifact_dir in .planning/config.json now actually configures the SLURM adapter — the keys were declared by the external-job capability but the adapter only read env vars, so config edits silently had no effect. The adapter now resolves them through the canonical capability-config seam (env override > config > registry default), surfaces the resolved artifact_dir in submit output, documents why the contribution registers at execute:wave:post (#1164 asks for wave:pre, which execute-phase.md does not dispatch today; wiring it is a core-loop change #1164 explicitly defers), and gains unit coverage for the CLI surface (parseFlags, findPlanningDir, resolveExternalJobSettings, formatShowReport). (#1164) (#2006)
The Antigravity reviewer in /gsd-review no longer reviews blind — agy -p never granted the agent the repo under review, so it frequently anchored on its own scratch directory and returned plan-text-only verdicts counted at full consensus weight. The reviewer is now granted the repo (capability-probed --add-dir) and anchored to the absolute repo root; a review that still runs without repo access is stamped [reviewed-without-repo-access] and down-weighted in the Consensus Summary. The cursor-agent prompt gains the same absolute-root anchor. (#2176) (#2184)
Autonomous reruns now skip phases with deferred verification until you resume them explicitly — if a prior /gsd-autonomous run recorded verification_deferred_human or verification_deferred_gaps, later reruns no longer drop back into the same prompt loop and instead point you at the saved resume command. (#1846) (#1846)
requirements mark-complete no longer reports silent success when the traceability row is missing — it OR-ed its checkbox and table-row writes into one flag, so a checkbox-only reconcile returned a payload byte-identical to a full reconcile while the traceability row stayed Pending (and re-run masked it as already-complete). It now surfaces table_unmatched for IDs whose checkbox reconciled but whose table row is absent, and treats a checked box with no table row as partial rather than done. (#2140) (#2219)
state prune now resolves the current phase from the canonical location — frontmatter current_phase, the Current Phase field, or the prose Phase: line scoped to the ## Current Position section — instead of extracting Phase over the whole document, where stateExtractField's pipe-table fallback could latch onto an unrelated | Phase | N | row (e.g. a historical verification table) and compute a wrong prune cutoff. (#1832)
model_overrides Claude model IDs now resolve to Agent-tool aliases on the claude runtime — a full Claude model ID (e.g. claude-sonnet-5) in model_overrides was returned verbatim and silently dropped by the Claude Agent tool (whose model parameter documents only tier aliases), causing the spawned subagent to inherit the parent session model instead of the configured one. It now maps to the tier alias (sonnet/opus/haiku/fable), consistent with the model_policy path (#1144). Bare aliases, non-Claude values, and non-Claude runtimes are unchanged; a Claude ID with no alias warns once and falls through to tier resolution. (#2041) (#2048)
Phase headers that place a parenthetical tag before the colon (### Phase 26 (Cluster B): Title) now resolve and enumerate the same as untagged headers. Previously the resolver returned not-found and roadmap analyze/listing silently dropped the phase (wrong phase_count, progress, and next_phase). Tag tolerance is applied at every phase-header read site; untagged and all existing header formats parse unchanged. (#1765)
Executor and milestone-summary/forensics workflows now call state.* commands with named flags so the named-only router records metrics, decisions, blockers, and session continuity instead of silently dropping positional args. (#1873)
bug-1367 install test no longer fails on Windows CI when hooks/dist isn't pre-built — the test ran install.js without building its hooks/dist precondition (a gitignored build artifact the unit lane doesn't build), so on a lane without pre-built hooks the installer hit "Failed to install hooks: directory is empty" and the before-hook threw. The test now builds hooks in its own before() (mirroring golden-install-parity). (#1926) (#1927)
/gsd-fast now appends Quick Task rows to STATE.md again — the log_to_state column-count guard used an off-by-one awk formula (NF-1) that was always one too high, so the schema gate rejected the very table quick.md creates and silently skipped the STATE.md update. Also now supports the 6-column validate-mode table. (#2133) (#2214)
Build the gitignored hooks/dist/ artifact once upfront in scripts/run-tests.cjs (the same chokepoint as ensureBuiltArtifacts), before any concurrent install test spawns install.js. Closes the scoped-CI first-build empty-dir race that intermittently failed install tests with Failed to install hooks: directory is empty (e.g. bug-3683-workflow-colon-namespace-leak). (#1967) (#1968)
workstream progress no longer reports shipped milestones as executing — gsd-tools workstream progress now derives each workstream's status from authoritative shipped signals (an archived milestone snapshot under milestones/, or a SHIPPED marker in the workstream ROADMAP) instead of trusting the mutable STATE.md Status field, so a stale field can never hide a shipped/archived milestone. The output adds status_source (field | derived) and status_conflict (true when the derived value disagrees with the stale field). (#1913) (#1916)
Windows install/upgrade/state-write operations no longer fail on transient antivirus/indexer file locks — the fs.renameSync atomic-publish sites (install state, hooks config, capability ledger/lifecycle, phase/workstream/milestone dirs, roadmap, planning/state locks) now retry EPERM/EBUSY/EACCES via retryRenameSync instead of propagating the transient lock; enforced by the new local/require-fs-op-fallback lint rule (ADR-1703 Phase 6). (#1740) (#1742)
reconstructFrontmatter now emits valid YAML for scalars and block-array items that were previously serialized unescaped. Values carrying a YAML indicator plus a literal quote/backslash, embedded control characters, the empty string, a leading YAML indicator, or leading/trailing whitespace are now routed through a properly escaped double-quoted form, so frontmatter round-trips through strict parsers (js-yaml, PyYAML) instead of corrupting the block on the next state sync. (#1807)
phase remove no longer destroys the Progress table when removing the last phase — deleting a phase used a whole-document regex whose scan, on the final phase, ran past the section and swept away the ## Progress heading and its entire tracking table; the deletion is now structurally bounded to the phase’s own section. (#2253) (#2253)
phases clear archives phase directories instead of destroying them — at a milestone switch, committed phase directories were hard-deleted (rmSync) with no archive, silently losing browsable phase history (the #1447 dirty-tree guard was a no-op for the common committed case). Phase directories are now moved to milestones/<version>-phases/ (collision-safe; timestamp fallback when no version resolves), so history survives the switch. The #1447 uncommitted-changes guard is retained as a secondary backstop. (#1871) (#1919)
Cross-AI review no longer silently drops the Codex/Claude/Gemini lanes on large plan sets — the prompt-fed reviewer blocks in review.md invoked each CLI with no explicit timeout, so a slow source-grounded review was killed at the host default (~2 min) and the lane was silently lost. The workflow now directs a high Bash timeout and frames an empty output as a timeout (not the crash it was misdiagnosed as). (#2194) (#2226)
/gsd-progress no longer reports a stale root milestone in workstream mode — in a multi-workstream project with no active workstream set, gsd-tools query init.progress silently fell back to root .planning/STATE.md (often stale) and reported it confidently. It now fails safe with an actionable error naming the available workstreams and the --ws/workstream set fix, so a stale root value is never reported. Flat mode and --ws <name> are unchanged. (#1912) (#1918)
Windows: stop double-quoting $CLAUDE_PROJECT_DIR-anchored managed node hook paths during the #2979 legacy rewrite, which produced ""$CLAUDE_PROJECT_DIR"/..." and broke every node managed hook with MODULE_NOT_FOUND (PreToolUse-guard deadlock). (#1746)
phase complete now updates STATE progress on milestone-grouped roadmaps — deriveProgressFromRoadmap parses the ## Progress table by header (column-by-name) instead of a fixed 4-column layout, so the 5-column milestone-grouped shape is no longer silently unparsed. (#2168)
Windows Claude Code hooks now work under PowerShell — when Claude Code's hook runner resolves to PowerShell (not Git Bash), every GSD-installed hook failed with Unexpected token because the installer emitted bare quoted paths with no PowerShell call operator. The fix adds a hookShell parameter to the hook-command projection chain; when hookShell='powershell', the & call operator is prepended. Default behavior (Git Bash, no prefix) is unchanged. (#2236) (#2261)
capability state and loop render-hooks now accept --runtime to override the auto-detected runtime — previously both commands parsed only --config-dir, so the runtime config dir was derived from the persisted .planning/config.json runtime (precedence GSD_RUNTIME → config.runtime → claude). A repo that persisted runtime:"codex" resolved the config dir to ~/.codex, where the Claude skill isn't installed, so every skill-bearing capability reported surfaced:false and execute:post/verify:post hooks silently no-op'd when the operator drove GSD from Claude Code. --runtime <r> (canonicalized, so aliases like codex-app work) now bypasses that fallback so the config dir resolves to the explicitly-named runtime's home. Behavior without the flag is unchanged. (#2003) (#2051)
phase complete no longer false-reports REQ-IDs as missing when the traceability table leads with a status column — the parser required the REQ-ID in the first column, so a table shaped | ☐ | REQ-01 | … matched zero rows and every body REQ-ID was reported missing. It now matches REQ-IDs in any column. (#2203) (#2234)
init milestone-op now ignores backlog 999.x headings when counting milestone phases — parked backlog items no longer inflate phase_count or pin all_phases_complete false for an otherwise finished milestone. (#1843) (#1843)
Phase archival is now wired end-to-end across the milestone lifecycle — finishes the #1871 follow-up: phases archive is now a real command (the half-wired alias is routed, no longer errors Unknown), milestone complete archives phase dirs by default (--no-archive-phases opts out), and new-milestone §6 stages the archive move + source removal in the same commit so history is preserved atomically rather than left as orphaned uncommitted deletions. (#1871) (#1924)
state update-progress no longer mangles the frontmatter and discards the progress suffix — its Progress: regex matched the raw STATE.md including frontmatter, so the YAML progress: key was hit first (corrupting the frontmatter) while the body line stayed stale and was silently reverted on the next write, and any descriptive suffix after the progress bar was destroyed. It now targets the body line only and preserves the suffix. (#2177) (#2224)
/gsd-ship no longer silently drops the ship-status note from STATE on merge — the track_shipping step committed the STATE ship-note after creating the PR but never pushed it, so on a fast merge the note stayed local-only and never reached the default branch. The ship-note is now pushed onto the PR branch with a [ci skip] trailer so it lands on merge without a redundant pipeline. (#2138) (#2217)
/gsd-debug no longer stalls on a phantom background handoff — the orchestrator treated the foreground session-manager spawn as a background task and queried its agent ID via TaskOutput (which needs a task ID), then waited on a handoff that was never queryable. The workflow now states the spawn is foreground/blocking, forbids passing an agent ID to TaskOutput, and gives a lost-handoff recovery path. (#2196) (#2227)
Roadmap phase lookup now ignores fenced examples and the backlog sentinel lane — roadmap get-phase and init plan-phase no longer return fenced sample headings as real phases or treat 999.x backlog items as active milestone work. (#1845) (#1845)
phase complete no longer checks the wrong ROADMAP checkbox or writes the plan count into a shipped milestone — the roadmap mutators ran unanchored and un-milestone-scoped, so they could flip a bullet inside a backticked prose literal or a Backlog entry instead of the closing phase's, and write the plan count into a same-numbered phase in a shipped milestone. The checkbox flip is now line-anchored and both writers are scoped to the current milestone. (#2200) (#2229)
roadmap get-phase resolves project-code-prefixed headings by bare number — a bare-number query (e.g. 29) now resolves a drifted ### Phase AB-29: heading, matching the internal resolver used by init.phase-op; previously the CLI returned empty. A bare sibling (### Phase 29:) still takes precedence. A project-code-prefixed heading present only as a summary/checklist line (no matching detail section) now reports a malformed_roadmap diagnostic — for both prefixed and bare-number queries — instead of a silent empty result. (#2114) (#2139)
milestone complete --ws now archives into the workstream instead of root — the archive paths (MILESTONES.md, the milestones/ archive dir, and the per-version MILESTONE-AUDIT.md) were hardcoded to root .planning/, so a workstream milestone close scattered its artifacts into root and never produced a workstream-local archive. They now derive from the workstream-aware planning base (planningPaths(cwd).planning); flat-mode (no --ws) is unchanged. (#1911) (#1917)
phase complete now reads milestone-grouped ROADMAP progress tables — progress reported 0% on projects whose Progress table carries a Milestone column, because the reader assumed a fixed column position; it now resolves progress columns by name so both flat and milestone-grouped tables work (#2137). Quick Tasks logging via /gsd:fast also appends schema-correct, lock-safe rows instead of guessing the column count in shell (#2133). (#2248) (#2248)
Skill-bearing capabilities now surface correctly on flat command-layout installs — on an install using the flat commands/gsd-<stem>.md source layout (e.g. a Claude Code local project install with no commands/gsd/ subdir), every skill-bearing capability (nyquist, code-review, security, ui, mempalace, ai-integration, profile-pipeline) was silently reported surfaced:false/enabled:false/active:false, so their loop hooks (verify:post, execute:post, etc.) never fired even with the corresponding workflow.* toggle on. The skill-manifest resolver now detects the flat layout and produces the same stems the nested commands/gsd/*.md loader does. (#1858) (#2049)
Roadmap, requirements, and state table edits are confined to the right table — the last ad-hoc table writers (phase completion updating roadmap progress, requirements mark-complete, and state record-metric/velocity) now route through the shared markdown-table seam, so a stray decoy table elsewhere in a document can no longer swallow a phase-progress update, a single ragged neighbouring row no longer silently aborts the whole edit, and per-plan metric recording no longer drops trailing section content or duplicates the section. (#2253) (#2253)
ROADMAP phase edits can no longer escape their section — completing a phase updated its plan count and per-plan checkboxes with whole-document regexes that could bleed into a neighbouring phase; those per-phase writes are now structurally bounded to the phase own section via a new withSection / withPhaseSection seam (#2130, #2067, #2080). (#2250) (#2250)
STATE.md ## Session fields now resolve on Windows — the session-section reader used a \n-only heading regex that silently failed on a CRLF ## Session heading, nulling all session state on Windows checkouts; it now reads through the CRLF-safe section seam. (#2253) (#2253)
Bullet/em-dash ROADMAP phases no longer resolve to Phase null — the roadmap phase lookup matched only ATX headings with a colon, so a bullet entry like - [ ] **Phase N — Name** (which the roadmapper emits) failed to resolve and Phase null landed in STATE.md; a bullet-only ROADMAP also broke the milestone phase count. Phase lookup and the milestone filter now accept bullet/checkbox entries with an em-dash/en-dash/hyphen/colon separator. (#2199) (#2228)
Linuxbrew users no longer lose all GSD-managed hooks after brew upgrade node — normalizeNodePath only recognized macOS Homebrew Cellar paths, so on Linux the version-pinned node path stayed baked into hook commands and 404'd after a node bump (and reinstall couldn't repair it). It now rewrites any Homebrew Cellar path — Intel, Apple Silicon, Linuxbrew, custom HOMEBREW_PREFIX — to the stable <prefix>/bin/node symlink. (#2185) (#2225)
milestone complete no longer corrupts the recorded phase — closing a milestone (e.g. v0.5) previously overwrote current_phase in STATE.md with the version's minor digit, and a follow-up state complete-phase mined a bogus 0.5 token and rewrote the file; phase resolution is now anchored so the real phase is preserved and a milestone-closure line is rejected. (#2111) (#2131)
Headless MemPalace capture no longer fails silently — the headless invocation mempalace mine <path> --wing <wing> --room <room> used a --room flag that does not exist on the mine subcommand (only search accepts --room), causing every headless/no-MCP capture run to fail with unrecognized arguments: --room and silently skip (onError: skip). The fix replaces the flag with MemPalace's documented room-assignment mechanism: stage the artifact under a room-named subfolder with a mempalace.yaml taxonomy so detect_room() assigns it via folder-path match. (#2220) (#2260)
Fixed: a hand-authored non-inferable backstop truth with a stray trailing space or surrounding quotes no longer silently grades green — it correctly abstains (insufficient_spec), restoring the #1154 honest-verifier guarantee. (#1909)
commit_docs no longer silently disables on CRLF .gitignore repos — git check-ignore falsely reports a trailing-slash path (e.g. .planning/) as ignored when the .gitignore has CRLF line endings with blank lines. isGitIgnored now strips trailing slashes before querying, so the false positive cannot occur. (#2206) (#2235)
Phase-directory resolution fails loud on cross-project collisions — when two unrelated GSD projects share a .planning/phases/ tree, a bare phase number silently resolved to the first 0N-* directory found. The fix detects multiple matches and surfaces an ambiguous_matches result. (#2237) (#2262)
scanPhasePlans no longer counts PLAN-REVIEW artifacts as executable plans — *-PLAN-REVIEW.md files were counted by the loose /PLAN/i fallback. The fix adds a PLAN_REVIEW_RE exclusion before the fallback. (#2252) (#2263)
Milestone audit no longer flags a not-yet-validated phase as a Nyquist failure — a phase that was planned but never run through validate-phase now reports as NOT-VALIDATED (a "run validate-phase" TODO) instead of collapsing into PARTIAL alongside phases whose validation genuinely failed. (#2117) (#2209)

Security

gate="blocking-human" checkpoints are no longer auto-approved by the execute-phase orchestrator — the package-legitimacy gate (#2827) spans two layers: gsd-executor refuses to auto-approve a gate="blocking-human" checkpoint and escalates it via checkpoint_return_format so a human can vet the package, and execute-phase's checkpoint_handling step decides what happens next. That step dispatched purely on checkpoint type and never read gate, so under --auto / --chain it immediately auto-approved the very checkpoint the executor had just refused to auto-approve (human-verify → {user_response} = "approved"). The slopsquatting defence was therefore inert in exactly the unattended mode where nobody is watching: an [ASSUMED]/[SUS] package reached install with no human ever seeing the verification prompt. checkpoint_handling now carves out gate="blocking-human" (and the package-legitimacy what-built markers) ahead of every auto-mode branch, routing those checkpoints to the standard present-to-user flow regardless of type. references/checkpoints.md documents the gate attribute and its two values for the first time — previously blocking-human appeared nowhere outside agents/gsd-executor.md, so no planner had a documented way to author a checkpoint that auto-mode could not bypass. The existing regression test asserted the executor half only; it now asserts the orchestrator half too, which is why it stayed green while the gate was open. (#2107) (#2113)
Hardened phase/roadmap/plan markdown parsing against quadratic-time (ReDoS) CPU exhaustion — a crafted ROADMAP.md, STATE.md, or PLAN.md with large runs of unclosed (, [, <tag>, <!--, or <details> could drive the phase-header, Plans-count, files_modified, and <tag>-block parsers into O(n²) scans (tens of seconds on a ~1.5 MB file). Every affected regex is now linear: header tag/bracket clauses are length-bounded, the Plans-count scan is section-local, and all <tag>…</tag> extraction routes through a single ReDoS-safe seam. (#2128) (#2141)
Installer writes are now confined to the declared config home — the workflow/skill emit path (copyWithPathReplacement) and the Codex config writer (installCodexConfig) now reject any destination that escapes the install root: crafted or absolute paths, path-separator agent names, and pre-existing symlinks are refused before any delete or write. Fail-closed: an install write with no declared root is rejected rather than written unconfined. (#1725)
Install write-confinement (ADR-1239 Phase B) — the installer now rejects any runtime-descriptor destSubpath that would write or delete outside the user's config home (path traversal, the config root itself, NUL bytes) and refuses to follow a pre-existing symlink that escapes it. Hardening only; no change to legitimate installs. (#1706)

[1.6.1] - 2026-07-01

Added

Claude Sonnet 5 is now the standard (sonnet) tier model. The model catalog and provider presets resolve the sonnet/standard tier to claude-sonnet-5 (GA 2026-06-30) across the Anthropic-backed runtimes (claude, copilot, and the anthropic/anthropic-fable presets), plus the OpenRouter-style anthropic/claude-sonnet-5 for opencode/hermes, replacing the superseded claude-sonnet-4-6. Opus and Haiku tiers are unchanged. (#1847) (#1848)

Fixed

milestone complete and roadmap analyze now exclude the Phase 0 / Phase 999 backlog sentinels. A milestone whose only directory-less ROADMAP heading is a backlog sentinel can be completed without --force, and roadmap analyze no longer counts the sentinel in phase_count or routes next_phase into it. Completes the ^999 exclusion #1445 added to the progress denominators. (#1691)
phase.complete no longer reports a false is_last_phase on a <details>-wrapped checkbox checklist (#1591, #1752) — when the active milestone's phase checklist was written as - [ ] Phase N: checkbox items inside a <details> block and the next phase had no directory on disk yet (still in planning), phase.complete's isLastPhase roadmap-enumeration fallback used a heading-only pattern (/#{2,4}\s*Phase…/) that never matched checkbox items. It returned is_last_phase: true, next_phase: null on a mid-milestone phase and — via the milestone-complete cascade — wrongly flipped STATE.md to Milestone complete and decremented progress.total_phases (e.g. 8 → 7). The pattern now matches both heading-style (### Phase N:) and checkbox-list phases (- [ ] Phase N: / - [x] Phase N:); extractCurrentMilestone already surfaces the <details>-wrapped checklist correctly, so no parser change was needed. Only the reproduced phase.complete fallback is changed; the heading-only sibling patterns elsewhere in phase.cts are untouched. (#1819)
Windows: stop double-quoting $CLAUDE_PROJECT_DIR-anchored managed node hook paths during the #2979 legacy rewrite, which produced ""$CLAUDE_PROJECT_DIR"/..." and broke every node managed hook with MODULE_NOT_FOUND (PreToolUse-guard deadlock). (#1746)

[1.6.0] - 2026-06-24

Added

workflow.context_guard_mode config key — proactive context-exhaustion guard for execute-phase. Before each wave, the orchestrator self-assesses context pressure using the degradation signals defined in context-budget.md. Values: warn (default — emit warning and recommend /gsd:pause-work when POOR tier detected), auto (automatically invoke /gsd:pause-work before next wave), off (disable). Set via gsd config-set workflow.context_guard_mode auto for fully autonomous checkpoint behaviour. (#1452) (#1452)
agent-skills --json IR gains an additive value: { block, skills_count } field formalizing the Resolution<T> convention for config-interpreting read verbs; no breaking change. The new src/resolution.cts module exports Resolution<T> { value, configured, reason, warnings } (the canonical envelope) and makeResolution<T>() (the builder); AgentSkillsValue { block, skills_count } is the first adopter. All existing flat fields (agent_type, block, skills_count, warnings, configured, reason, source, degraded) are retained for back-compat. Capability-state and capability-writer keep their existing JSON shapes unchanged; only doc comments are added naming them the canonical read-verb and mutation-verb envelopes respectively. The shared seam across all shapes is warnings: string[]; a single generic across read+write verbs was rejected by the deletion test (ADR-1411 P3 amendment). (Part of #1411, P3 / #1416.) (#1425)
Added gsd capability outdated — a new subcommand that light-peeks each installed overlay capability's recorded source for the latest version that re-resolving that source would install and reports which have an update available (ADR-1244 D6 per-source matrix: git ls-remote --tags, npm view … version, local re-read; tarball → manual, registry → unknown). A capability is reported outdated only if re-resolving its recorded source would fetch a newer version: an npm range (@^1) resolves to the highest version matching the range (read from each npm view line's canonical version field, so a version-like substring in the package name never poisons the result), and a source pinned to an immutable ref (git #sha:/#tag:) or an exact npm version is reported pinned — never outdated, since update will not move it. A bare git ref (#<ref>) is classified at the remote with a bounded git ls-remote: a ref that resolves to a tag is pinned, while a mutable branch ref is never pinned (it degrades to unknown, since the installed commit is not recorded to compare against). Each capability is classified outdated / current / pinned / manual / unknown; subprocesses are bounded (git ≤30s, npm ≤60s) and a failing or unsupported peek degrades that row to unknown instead of crashing the command. --json emits the records array; the default prints a table. (#1463) (#1488)
gsd capability management command — install, update, remove, list, disable, and enable GSD capabilities (first-party and third-party overlays) from a registry / git / npm / tarball / local source, wiring the ADR-1244 lifecycle (source resolver, ledger, consent + integrity trust gate) to a user-facing CLI. (#1457) (#1457)
Runtime capability registry overlay — installed third-party capabilities (under ~/.gsd/capabilities/ or a project's .gsd/capabilities/) are now composed into the registry at runtime via loadRegistry({ includeInstalled }): validated against the same conformance invariants as first-party, first-party-wins on any collision, skipped-with-a-warning when incompatible with the running GSD version (engines.gsd), with gate-kind capabilities failing closed. Installed overlays are toggable via surface and federate their config keys (cwd-aware) exactly like first-party. Foundation (ADR-1244 Phase 2) for capability install/upgrade/remove. (#1440)
Capability manifests are now versioned — every capability.json carries a required semver version, plus optional engines.gsd, compatVersions, integrity and provenance fields, enforced by the capability conformance validator. First-party capabilities are version-stamped in lockstep with the GSD release. Foundation (ADR-1244 Phase 1) for installing, upgrading, and removing capabilities in later releases. (#1436)
/gsd-capture --list-seeds audits parked seeds — a new read-only listing of .planning/seeds/ showing each seed's ID, status, scope, and trigger, with an optional status filter (e.g. --list-seeds dormant). Backed by the gsd-tools list-seeds command. Previously seeds could only be created or auto-surfaced at /gsd-new-milestone, with no way to browse them on demand (#441). (#722)
Capability source resolver + install ledger — resolveCapabilitySource(spec) fetches a capability from a local path, git repo, npm package, or tarball URL, verifies it (sha512 integrity before staging, engines.gsd compatibility, full conformance validation) and stages a bundle without executing any capability code (copy/extract only — npm pack --ignore-scripts, never npm install; symlink/tar-slip/shell-metacharacter/unsafe-transport inputs rejected). A per-runtime ledger records what each install wrote for atomic, reversible upgrade/remove. Foundation (ADR-1244 Phase 3) for the upcoming gsd capability install command. (#1443)
Capability matrix reference — a generated catalogue (docs/reference/capability-matrix.md) of every first-party capability's role, tier, extension points, hook kinds, and engines.gsd, generated from the committed registry and kept honest by a CI drift guard so it can never fall out of sync with the actual capability set. (#1458) (#1458)
Third-party capabilities can ship dispatchable CLI commands (ADR-1244 Phase 5) — a capability that declares a commands family is now dispatched by gsd-tools <family> via the registry, the same seam the first-party graphify/intel/audit commands already use. Third-party command dispatch runs only for an installed, consented capability (a committed ledger entry) and loads the router module strictly from that capability's own install root (basename + realpath confinement, rejecting .. traversal and symlink escape); a bundle merely present on disk with no install record keeps its declarative surfaces but is never command-dispatchable. (#1450) (#1450)
Plugin installs now expose GSD skills — when GSD is installed as a Claude Code plugin (claude plugin install), its skills are available via gsd-core:<skill> the native way. Previously, plugin-only installs lacked the skill surface because bin/install.js never ran; agents that preload global:gsd-core:<skill> (PR #1261) now resolve against plugin-provided skills. (#1596) (#1597)
Added a validated gsd-tools worktree record-agent writer verb that appends a per-agent entry to the wave cleanup manifest, validating every field at write time with the same rules the cleanup-wave reader enforces (write-strict --agent-id) and failing loudly with a recovery hint instead of silently appending an under-populated entry. The execute-phase orchestrator now records each spawned worktree through this verb. (#1448) (#1448)
gap-analysis --phase-req-ids now expands numeric ID ranges — a same-prefix ascending equal-width range like SEL-01..SEL-03 expands to SEL-01, SEL-02, SEL-03 (zero-pad preserved) instead of being treated as one literal ID that gap-analysis then reports as missing. Ambiguous tokens (mismatched prefix, descending, differing width, non-numeric, >1000 span) stay literal. (#1269) (#1419)
/gsd-plan-phase now flags a stale codebase map before planning — the drift capability runs its codebase-drift check at plan:pre (non-blocking, warn-only), so a stale STRUCTURE.md is surfaced before the planner is spawned instead of being discovered mid-execution by the existing execute:wave:post gate. Gated on a new workflow.plan_drift_precheck toggle (default on), independent of workflow.schema_drift_gate, so autonomous/CI runs can silence the plan-time advisory without disabling the execute-time gates. (#1595)

Changed

Capability commands now emit dispatch audit records — graphify, intel, audit-uat, and audit-open now route through the Command Routing Hub per ADR-959 §III(B), so GSD_AUDIT=1 traces, the structured stderr JSON error envelope, and the typed Result contract cover them uniformly with all other command families. JSON-error reason values (usage, sdk_unknown_command) are preserved byte-identical. (#1646) (#1647)
/gsd-verify-work now routes UAT deterministically from a structured coverage: block on SUMMARY.md — deliverables proven by passing tests (human_judgment: false with a non-empty all-pass verification list) are auto-passed (source: automated, no prompt), and only judgment-dependent or unverified deliverables are presented for human sign-off. SUMMARYs without a coverage: block fall back to the previous prose-based extraction, byte-identical. Authored by execute-plan and validated by the new gsd-tools uat classify-coverage verb. (#1611)
Thread isGlobal install scope through the descriptor-driven convertedAgentsKind / stageAgentsForRuntimeWithConverter plumbing — a prerequisite for the ADR-1235 agent-conversion cutover. No runtime declares a converted agents kind yet; the capability.json wiring is deferred to a follow-up that first ships the ADR-1235 §0 byte-for-byte parity harness (so the /gsd:surface / --materialize consumer can mirror the legacy agent pipeline before the kind goes live). The legacy bin/install.js agent loop remains authoritative, so installed agent output is unchanged. (#1173) (#1438)
/gsd-review now asks external reviewers to verify plan claims against the source — the reviewer prompt requires opening the referenced files, citing file:line evidence + mechanism, and tracing asserted behavior, with a graceful-degradation clause for reviewers that have no file access. This turns every capable agentic reviewer into a real second source instead of a plan-text paraphraser. (#1318) (#1421)
eval-auditor scoring moved into a deterministic eval.score query verb (LLM-playbook principle 10) — coverage/infra/overall arithmetic and verdict banding are computed in code (gsd-tools query eval.score) instead of by the model. Based on arXiv 2601.15130 (Plausibility Trap / DPDM), 2508.15754 (Tool-Integrated Reasoning), 2507.10281 (Table Agent); 2504.00406 / 2510.15955 supporting. (#1583)
gsd-tools now resolves the project root from a descendant subdirectory — findProjectRoot walks up to the nearest ancestor directory containing .planning/ so config loads correctly when invoked outside the project root; previously it fell through to defaults for plain descendant paths (cwd-drift gap #1366). Sub_repos, multiRepo, and .git-based heuristics retain priority. (Part of #1411, P1 / #1414) (#1423)
verify-phase test-tier prohibition fail-first can now prove the RED is caused by the violation's content — the node-test machine-proof (#1279) confirmed a known-bad subject drives the negative test RED, but could not tell a genuine content-violation from a deceptive test that reds merely because GSD_PROHIB_SUBJECT is set. An optional fifth flat scalar check_clean_fixture (→ CheckDescriptor.cleanFixture) threads a KNOWN-CLEAN control subject through projectProhibitions + descriptorFromProjection; when present the prover also runs the check against it and requires GREEN, so fail-first is proven only when the check is RED on the violation and GREEN on the clean subject (content-dependent). It is opt-in and additive: absent a clean fixture the prover behaves exactly as it did post-#1314 (no control, documented residual), preserving the zero-authoring compose path; the lint-rule kind needs no analog. (#1346) (#1518)
fish-shell support in the post-install PATH suggestion. When a directory is not on your PATH, the installer now prints a fish-native fish_add_path '<dir>' line alongside the zsh/bash suggestions (the previous export PATH=… commands are inert in fish). It also stops the false-positive "not on your PATH" warning for fish users whose fish_user_paths/config.fish already covers the directory, detected via a read-only probe of fish's config (no fish subprocess, no writes). No change for bash/zsh/PowerShell/cmd/Git-Bash users. (#727)

Fixed

Project-local Claude Code install now produces /gsd-<cmd> (hyphen) slash commands — the installer was writing command files to .claude/commands/gsd/<cmd>.md (subdirectory with bare names), causing Claude Code to namespace them as /gsd:<cmd> (colon form). The fix writes flat gsd-<cmd>.md files at .claude/commands/ level so Claude Code registers /gsd-<cmd> (hyphen form), matching hooks, statusline, and all cross-command references. Legacy commands/gsd/ directories from prior installs are cleaned up on reinstall and uninstall, with dev-preferences.md preserved. (#1367) (#1367)
execute-phase now re-checks the worktree fork base at the start of every wave and resets the wave manifest between waves (#1369) — two compounding issues caused wave N+1 worktrees to be created from the stale pre-wave-N commit. First, the worktree.base-check auto-degrade only ran once at initialize time; after Wave N merged and tracking commits advanced orchestrator HEAD past origin/HEAD, Wave N+1 worktrees were still forked from origin/HEAD (Claude Code's "fresh" base), causing both agents to immediately halt with FATAL: worktree base mismatch from the worktree_branch_check guard. Second, WAVE_WORKTREE_MANIFEST was never unset between waves, so wave N+1 would reuse the consumed wave-N manifest file, causing the step 5.5 manifest guard (#3384) to block on subsequent waves. Two safeguards fix this: step 0.5 in the execute_waves "For each wave" loop re-runs worktree.base-check before every wave's dispatch (when divergence is detected, USE_WORKTREES is overridden to false for that wave); step 7c between waves unsets WAVE_WORKTREE_MANIFEST so wave N+1 creates a fresh per-wave manifest, and re-asserts worktree.baseRef:"head" (idempotent) so the Claude Code harness re-reads the live HEAD on the next dispatch. The permanent fix remains setting worktree.baseRef:"head" in .claude/settings.local.json (see #683). (#1369)
Workflow temp files now randomize correctly on BSD/macOS — several workflows called mktemp with templates where XXXXXX was followed by a .json/.md suffix (e.g. gsd-worktree-wave-XXXXXX.json, gsd-pr-body.XXXXXX.md). BSD/macOS mktemp only substitutes XXXXXX when it is the final path component, so those templates returned a literal, non-randomized path, letting concurrent workflow runs collide on the same temp manifest/body file (one run overwriting or consuming another's). The fix creates a suffixless temp then renames to add the extension — portable across BSD + GNU. Affected: execute-phase, quick, spec-phase, ship, profile-user. (#1520) (#1550)
Core-path file locks now verify the holder process is alive before stealing a stale lock (#1532) — the STATE.md write lock (acquireStateLock) and the .planning/ workspace lock (withPlanningLock) previously stole locks on a bare mtime timer with no liveness check, so a live-but-slow holder (e.g. a deep .planning/ scan on slow NFS) could have its lock stolen mid-write, corrupting STATE.md or losing an update. Both locks now gate stealing on process.kill(pid,0) liveness with a deadman ceiling above the wait budget (pid-reuse backstop), withPlanningLock no longer force-steals a live holder on timeout (and can no longer leak an uncaught EEXIST), writeStateMd computes its disk scan inside the lock, and acquireStateLock no longer leaks a file descriptor or strands an empty lock on a recoverable write error. The steal itself is now race-safe: a lock is never stolen while its body is still being written (the create→pid-write window), and stealing uses an atomic rename with an identity re-confirm so two waiters can no longer both reclaim the same lock and end up holding it concurrently. The uncontended path is unchanged. (#1532)
normalizeNodePath now maps pruned mise node paths to the stable shim (#1619) — resolveNodeRunner() bakes process.execPath into managed .js hook commands. Node realpaths execPath, so under mise it resolves to <data>/installs/node/<ver>/bin/node — a concrete version mise prunes on mise up, after which every managed hook fails to spawn (No such file or directory on every SessionStart and tool event), the same ephemeral-path failure #977 fixed for fnm and #3181 for Homebrew. normalizeNodePath now rewrites a mise versioned install path to the stable sibling shim <data>/shims/node (.exe preserved on Windows) when that shim exists, deriving <data> from execPath so a custom MISE_DATA_DIR works, and falling back to the raw execPath unchanged otherwise. (#1619) (#1621)

fix(#1472): validate health is now workstream-aware — PROJECT.md and config.json are resolved from .planning/ root, while ROADMAP.md, STATE.md, and phases/ follow the workstream-scoped path; previously both sets were routed through planningDir() causing false E002/E003/E004/W003 when GSD_WORKSTREAM is set.

fix(#1454): validate health W017 no longer suggests removing the active session's worktree — stale-worktree findings are now skipped when the worktree path matches or is an ancestor of process.cwd(). (#1483)

frontmatter set / frontmatter merge no longer destroy must_haves object-lists — changing one frontmatter field (e.g. wave) silently dropped every provides: value and collapsed must_haves.artifacts/.prohibitions from a structured [{path, provides}] list into a malformed inline array, because the whole frontmatter was round-tripped through a lossy parse→serialize path that flattens object-list items to scalar strings. The write now preserves the original raw text for any structurally-unchanged top-level key and regenerates only the field that actually changed, so unrelated must_haves blocks survive verbatim. (#1572) (#1656)
Non-Claude runtime installs now resolve their own runtime and never attempt Claude-only worktree isolation — on any non-Claude install (Cursor, Gemini, Qwen, etc.) a runtime-neutral .planning/config.json previously resolved runtime=claude and enabled git worktree isolation, which only Claude Code's isolation="worktree" can honor — risking main-checkout edits while the workflow believed agents were isolated. Every non-Claude install now resolves its own runtime identity, defaults workflow.use_worktrees to false, fails closed if worktrees are forced on, and runs plan/execute inline in the manager/autonomous flows since only Codex can background-nest the pipeline's subagents. (#1521) (#1537)
Phase-aware commands now resolve project-code-prefixed ROADMAP headings such as MANIFOLD-117, while the roadmapper is instructed to keep project_code out of phase headings. (#1456)
workflow.mvp_mode now accepted by config-set; three undocumented workflow keys added to references — workflow.mvp_mode, workflow.code_review_command, and workflow.plan_chunked were consumed by planning-pipeline code but could not be set via config-set (they were missing from VALID_CONFIG_KEYS) or discovered via reference docs. All three are now in the schema and documented in references/planning-config.md. (#1500) (#1500)
Windsurf reinstall removes legacy .devin/skills/ artifacts — pre-#1615 installs wrote skills under .devin/skills/gsd-/ (Devin Desktop layout, #1085). #1615 moved Windsurf to .windsurf/workflows/ but never cleaned up the old layout. Reinstalls now remove GSD-managed .devin/skills/gsd- dirs; user-owned content is preserved. (#1631)
adr-parser now classifies 9 previously-dropped punctuated ADR headers (Trade-offs, Non-Goals, Won't Do, Follow-up, How We'll Know, etc.) into their intended buckets instead of leaving them unmapped. (#1536)
Add prototype-pollution guard to the workstream/root config merge (_deepMergeConfig) so a config.json with a proto/constructor/prototype key can no longer spoof unset config flags. (#1534)
All GSD agents load on Gemini again — the Claude Skill/SlashCommand tools were converted to an invalid skill tool that Gemini rejects, aborting the load of 22 of 34 agents. They are now excluded from the Gemini and Gemini-backed Antigravity agent tools: frontmatter, the same way AskUserQuestion already is. (#1394) (#1418)
Antigravity config-dir resolution no longer shadows the active runtime — when more than one of ~/.gemini/antigravity, antigravity-ide, or antigravity-cli exists, GSD now resolves to the directory it actually installed into (marked by gsd-core/VERSION) instead of whichever directory existed first. Fixes silent misresolution where a CLI user who also had the Antigravity-IDE dir present was sent to the legacy dir (regression from #217). (#1442)
gsd-tools query agent-skills no longer silently drops a configured agent's skills under cwd or workstream drift — cmdAgentSkills now anchors to the project root via findProjectRoot before loading config, so invoking it from a descendant subdirectory or with a GSD_WORKSTREAM that has no scoped config correctly resolves the configured agent_skills block. A new loadConfigResolved(cwd, options) → { config, source, degraded } function reports provenance alongside the config object: source distinguishes 'root' | 'workstream' | 'builtin-defaults' | 'global-defaults'; degraded:true signals a workstream was requested but its config.json was absent. The --json IR of agent-skills gains four new fields — configured (bool), reason ('resolved' | 'not_configured' | 'configured_empty' | 'configured_unresolved'), source, and degraded — making silent failures visible and testable. A configured_empty or configured_unresolved agent emits a stderr WARNING; an unconfigured agent stays silent. (Closes #1366. Part of #1411, P2 / #1415.) (#1424)
findProjectRoot now respects explicit sub_repos config over implicit .git — when a parent workspace's .planning/config.json lists a child directory in sub_repos, that declaration takes precedence over the child's own .git/ directory. Previously, if the child had both .planning/ and .git/, the .git heuristic fired first and resolved to the child rather than the parent workspace, making the sub_repos declaration ineffective. (#1422)

`phases clear` now refuses to delete phase directories with uncommitted changes — `cmdPhasesClear` runs `git status --porcelain` over the phases directory before executing any deletion. If uncommitted or staged-but-not-committed files are found it aborts with a clear error message, preventing silent data loss at `new-milestone` time. Pass `--force` to bypass the guard when archival is already complete. Non-git projects are unaffected. (#1447, data-loss fix) (#1484)

999.x backlog phases are now excluded from total_phases, and total_phases can correct downward — deriveProgressFromRoadmap counted all progress-table rows whose phase cell started with a digit, so a 999.1 Backlog row inflated total_phases by one per entry (#1445). The same overcounting occurred in getMilestonePhaseFilter (which feeds isDirInMilestone and phaseDirs) and in the roadmapPhaseCount loop in buildStateFrontmatter. All three sites now filter phase tokens matching /^999\b/, consistent with the existing exclusion in init.cts. Additionally, shouldPreserveExistingProgress included total_phases in its ratchet check, preventing the counter from decreasing once set too high — e.g. after a 999.x fix or a ROADMAP correction (#1446). total_phases is now always taken from the freshly derived value; only completed_phases, total_plans, and completed_plans retain ratchet behaviour. (#1490)

Capability trust model was bypassable for project-scope third-party capabilities (#1459). The consent signal for a project-scope capability was its in-repo project ledger — but a project ledger is repo-plantable, so cloning or forging a repository activated that capability's executable surfaces (hooks, MCP servers) AND its declarative loop surfaces (steps, gates, contributions, federated config) AND its command dispatch with no user decision on the machine running it. The fix moves the authoritative consent signal off the repo tree into a new user-owned consent store at ${GSD_HOME||homedir()}/.gsd/consent.json (new leaf module src/capability-consent.cts): a bounded, non-throwing, atomically-written store keyed by (realpath(projectRoot), capability id). The security binding is a recomputed full-bundle content hash (bundleContentHash — a sha512 over every regular file in the bundle, manifest AND artifacts AND identity, symlinks and non-regular entries rejected, bounded), not the repo-plantable ledger integrity (which is '' for path/git/dir installs — a degenerate '' === '') and not the executable-only disclosure signature (which is constant for a declarative-only capability, so a repo-write attacker could swap capability.json for a malicious gate/contribution while consent still matched). The loader recomputes the bundle content hash at load and activates a project-scope overlay — declarative surfaces and command dispatch alike — only when it matches the consent record on this machine; any tamper (a swapped declarative manifest, an edited hook script, an empty-integrity local install) changes the hash and leaves the capability discovered but inactive (gsd capability list reports status: inactive with a reason). Global-scope overlays (under the user's own home) remain trusted without a per-project record. The lifecycle records consent (bound to the installed bundle's content hash) on a consented project install/upgrade and revokes it on remove, deriving the project root through one canonical helper (consentProjectRoot) shared by the install record site, the loader lookup, and trust revoke, so an install from a sub-directory is not immediately inactive. The disclosure signature now also covers each MCP server's transport/url/headers (non-stdio endpoints), env, cwd, and the raw args array, plus a command module's router, and every surface line is JSON-encoded (no delimiter-injection collisions) — so a swapped remote endpoint, header, environment (e.g. NODE_OPTIONS=--require evil.js), entry point, or non-string arg forces re-consent. The consent store serializes concurrent cross-project writes under a lockfile (no lost updates), enforces its record cap at write time, uses a collision-safe on-disk key for paths containing spaces, and tolerates a vanished directory on the durability fsync. New CLI: gsd capability trust list and gsd capability trust revoke <id> [--project <path>]. The loader's per-scope ledger read now goes through the shared bounded fd reader (a repo-planted FIFO ledger can no longer hang the loader) and reuses the ledger's shared isValidLedgerEntry validator for committed-entry parity. Integration hardening: the overlay consumers (capability-state, loop-resolver, the federated config-loader/config-schema) now thread the consent home (GSD_HOME) explicitly to the loader so a consented project capability is never looked up at the wrong home; the loader's discovered-but-inactive warning carries a structural kind: 'unconsented' discriminant that gsd capability list filters on (rather than matching the reason prose); a reconcile rollback that deletes a project-scope bundle also revokes its now-stale consent so an identical re-drop stays inactive; installCapability/upgradeCapability warn on stderr when a project install supplies no consent store and when the consent-store write fails (the install still succeeds — a consent-store IO error never fails an otherwise-successful install); gsd capability trust list now exposes the stored disclosureSignature and contentHash for diffing; and when GSD_HOME resolves equal to a genuine project root an in-repo bundle still requires a consent record (it is not deduped as trusted-global). Convergence hardening: the content-hash canonicalization — the security binding itself — is now injective and lossless. It length-FRAMES every component (an entry count, then per entry a type tag, the uint32 path length + path bytes, and for files the uint64 content length + the raw content bytes read via a new raw-Buffer reader, never a lossy UTF-8 decode) so neither a NUL embedded in file content can fake a file boundary (the old relpath + NUL + content + NUL framing was non-injective) nor can two binary artifacts that differ only in invalid-UTF-8 bytes collide on U+FFFD; empty directories are bound via typed directory markers so adding/removing one changes the hash. recordProjectConsent/revokeProjectConsent now throw rather than perform an unlocked read-modify-write when the consent-store lock cannot be acquired (the lifecycle already treats a consent-write failure as non-fatal and warns, so an install still succeeds). The consent lock and the lifecycle lock are now ONE shared hardened primitive (src/capability-lock.cts) — process-start-time liveness identity + a hard deadman — so the consent lock can no longer stale-steal a slow-but-live writer (the old mtime-only 60 s steal could). Finally, the MCP disclosure signature now folds in a stable hash of the full server config object the writer persists (not only the whitelisted fields), so an upgrade that changes any host-honored field outside the whitelist (a future envFile/workingDir/launch option) still forces re-consent. A final convergence pass closes four residual gaps: (1) the loader's overlay-root dedup and the CB-3 "project root == global home ⇒ require consent" comparison are now keyed on fs.realpathSync (fail-safe to path.resolve), so a symlinked GSD_HOME aliasing the project root can no longer slip an in-repo bundle into the trusted-global slot — it still requires a consent record; (2) the loader reads capability.json through the shared bounded fd reader (regular-file + size cap) instead of a raw fs.readFileSync, so a project-planted FIFO/device or oversized manifest skips the overlay (warning) rather than hanging or OOM-ing the loop; (3) the PATH component of the content hash is now hashed from raw directory-entry bytes (a { encoding: 'buffer' } walk, separator normalized at the byte level), so two bundle files whose names differ only in invalid-UTF-8 bytes (which a string decode would collapse to U+FFFD) no longer collide; and (4) the gsd capability trust revoke CLI now catches the consent-store lock-acquire failure and emits a clean, actionable error instead of surfacing a raw stack. A further convergence pass closes three more residual gaps and documents one irreducible limit: (1) the loader's user-owned consent gate now runs before the heavy pre-activation work (materializeHookFragments and cross-capability validation) for a project-scope overlay, so a forged in-repo bundle whose fragment.path points at an in-bundle FIFO/oversized file is skipped (unconsented → inactive) without ever reading that fragment — closing a pre-consent hang/OOM (the gate's decision is unchanged; only the work-ordering moved), and as defense-in-depth materializeHookFragments now reads each fragment body through the shared bounded fd reader (regular-file + size cap) so a FIFO/device/oversized fragment becomes an un-materializable-fragment validation error rather than a blocking read on any scope; (2) gsd capability list now reads each project capability.json through the same bounded reader instead of a raw fs.readFileSync, so a project-planted FIFO/device or oversized manifest omits that entry's metadata and exits cleanly rather than hanging/OOM-ing the list; (3) the loader's canonicalDir realpath failure is now strictly fail-safe — a candidate that would be classified trusted-global but whose realpathSync throws (a race/odd-FS, e.g. a symlinked GSD_HOME aliasing the project root) is reclassified conservatively to consent-required project, so it can no longer park an aliased project tree in the trusted-global slot (a non-existent global dir still resolves to a harmless no-op scan). Finally, an honest in-code comment at the loader consent gate documents the irreducible filesystem-primitive TOCTOU residual: the content hash binds the bundle at verification time, but a local writer racing between that verification and the capability's later execution can still mutate the bundle files — closing this window would require fd-pinned execution or an atomic content snapshot (native support not available at this layer); any persisted tamper is still caught on the next load (mirrors the #1462 lock-release residual — a documented real limit, not a dismissal). A final deep-convergence pass closes three more gaps: (1) the realpath fail-safe is now two-sided — a global overlay root is trusted (consent-free) ONLY when realpath(global) AND realpath(project) BOTH succeed AND resolve to DIFFERENT physical paths; the prior one-sided rule (demote only a realpath-failed global candidate) still let a symlinked GSD_HOME aliasing the project root bypass consent when the GLOBAL candidate realpathed fine but the PROJECT candidate's realpath failed (the keys never collided, so the in-repo bundle stayed in the no-consent global slot), so distinctness that cannot be proven (either side throws, or both resolve equal) now demotes the global to consent-required project whenever a genuine project root exists — while a genuinely non-existent project overlay (ENOENT) or a distinct real global root still stays trusted; (2) bundleContentHash now bounds the enumeration itself — it streams each directory via fs.opendirSync + readSync and throws the moment a cumulative entry counter exceeds the cap, BEFORE collecting/sorting a whole directory, so a malicious unconsented bundle with a huge single directory (or a deep tree) can no longer force unbounded memory/CPU before fail-closing (the cap is cumulative across the recursive walk; determinism is preserved by sorting the bounded set); and (3) a project remove no longer silently swallows the revoke-on-lock-failure throw — revokeProjectConsent throws on a consent-lock failure (a stale consent record a byte-identical re-drop could reactivate against), so removeCapability now surfaces it via a stderr warning naming the record AND a consentRevokeFailed/consentRevokeWarning flag on the result, which the CLI reports as a non-clean removal (telling the user to run gsd capability trust revoke). (#1473)

Capability --integrity is now verified or rejected per source, and hook commands are confined to the bundle — a supplied --integrity pin was silently dropped for npm, git, and local capability sources (only the tarball source verified it), so a user could believe content was pinned when it was not. npm now verifies the pin over the npm pack .tgz bytes; git and local sources, which have no single hashable artifact, now reject a supplied --integrity with an actionable error instead of ignoring it. Separately, a capability hook's relative script was written verbatim as the hook command, so it resolved against the working directory (not the capability bundle) at hook-exec time and a crafted relative path could escape the bundle; the command is now resolved against the capability's own install dir and realpath-confined to it, then written as an absolute path. That absolute command is consumed by a shell, which exposed two further problems now fixed: (1) a manifest could ship a file literally named run.sh; touch /tmp/pwn (filenames may legally contain ;, spaces, $, backtick, |, newline) and declare it as the hook script, so the emitted command injected a second shell command even though the file lived inside the bundle — the validator now rejects any hook script path outside a conservative [A-Za-z0-9._/-] allowlist (no whitespace, shell metacharacters, leading -, absolute path, or ..), failing the install/load loudly, and the confinement helper mirrors the same rejection defensively; (2) the absolute path begins with the install-home directory, which commonly contains spaces (e.g. /Users/Bob Smith/.claude/...) and word-split or broke when written unquoted — the emitted command is now POSIX single-quoted so the install prefix can neither break nor inject. (#1460) (#1481)

The capability loader never crashes on a single malformed overlay, and untrusted manifest/tar reads are size-bounded (ADR-1244 D2 invariant) — loadRegistry now makes the WHOLE per-candidate overlay-processing body total: ANY throw from ANY validator or step (including the committed validateCapability, which dereferences a malformed array entry such as gates: [null] / steps: [null] / contributions: [null] before its shape check) drops just that one overlay with a skip-warning instead of escaping the loader, while gatePointsOf is hardened to be total over null/non-array/malformed gates. The final canonical buildRegistry compose stays guarded: a throw on the merged set falls back to the frozen first-party registry plus a warning, records each dropped gate-declaring overlay's declared gate as blocked (incompatibleGateCapIds / blockedGates) so a dropped blocking gate FAILS CLOSED, AND now clears _overlay.commandRoots in the fallback so no dropped overlay retains a stale command root. Previously a malformed-array throw or a compose throw escaped the loader and crashed every consumer (loop-resolver, config-loader, surface, capability-state, gsd-tools). On the source side, the capability resolver/staging now reads every untrusted capability.json (tarball / npm / git / local) via the shared bounded fd-reader (regular-file + 8 MiB cap) instead of a raw fs.readFileSync, so an oversized or FIFO/non-regular extracted-or-local manifest can no longer OOM or hang the resolver; the fetch (realHttpsGet) bounds the downloaded response to 64 MiB; and stageValidated now enforces ONE uniform aggregate byte-budget (MAX_STAGED_BUNDLE_BYTES, 128 MiB) over the STAGED bundle directory via a bounded streaming walk (cumulative byte + entry counters; symlink / non-regular entries rejected) at the common staging chokepoint — AFTER staging and BEFORE validation/promotion — so a huge source tree, git repo, npm package, or gzip/tar bomb is rejected (and its staging dir cleaned up) before promotion, uniformly bounding the RESULT of copyDirRecursive / git clone / npm pack / tar -x that were previously only timeout-bounded. copyDirRecursive itself is now STREAMING and BUDGETED: it enumerates each directory via fs.opendirSync + dir.readSync() (one entry at a time) and threads CUMULATIVE entry (MAX_STAGED_BUNDLE_ENTRIES, 100k) and byte (MAX_STAGED_BUNDLE_BYTES) counters through the recursion, failing closed the MOMENT either cap is exceeded DURING the copy — closing a residual where the former fs.readdirSync(src, { withFileTypes: true }) materialized the ENTIRE directory-entry array into memory at staging time (BEFORE the post-copy budget walk), so a hostile source whose tree held a directory of millions of tiny files (fetch < 64 MiB, but a colossal dirent array) could OOM the process during the copy before the budget could fail closed; the post-copy walk is retained as a cheap belt-and-suspenders re-verification on what actually landed in staging. The spoofable per-member tar-header size parse (parseTarMemberSize, which mis-anchored on BSD tar -tv owner/group columns such as a Jan group → fail-open) was REMOVED in favor of that non-spoofable staged-dir budget; assertSafeTarMembers keeps its unambiguous traversal / symlink / hardlink NAME and TYPE guards. (#1461) (#1475)
Capability ledger: fail closed on corruption, with durable atomic writes and a race-safe install lock. A corrupt or unreadable .gsd-capabilities.json is now left in place and surfaced (not silently overwritten) — install/update/remove/list/reconcile fail closed and report it, so a corrupt ledger can no longer wipe prior capabilities' tracked files and shared-config fragments (which previously left unremovable orphans in settings.json/hooks.json). Ledger writes are atomic and crash-durable (exclusive temp file + fsync of file and directory + rename, with temp cleanup on failure). The per-capability lock is race-safe: a holder is identified by (pid, process start-time, hostname), so a reused PID cannot deadlock recovery and a verifiably-live holder is never stolen, with a hard deadman timeout for unverifiable or cross-host holders. Untrusted ledger and lock reads are bounded (regular-file + size caps; FIFOs/devices rejected) and validated through a single shared entry validator (prototype-safe ids, DoS length caps). (#1462, ADR-1244.) (#1469)

fix(#1478,#1479,#1480): prohibit ungrounded baselines, error-suppressing fallbacks, and stale-artifact authority in planner verify blocks (#1482)

/gsd:pr-branch now handles sub-repos defined in config — when planning.sub_repos is set, the command scans each sub-repo for uncommitted changes and offers to create a branch, commit, push, and open a companion PR per sub-repo. Previously, sub-repos were silently ignored because all git commands ran against the shell's current directory instead of the intended repo path. All sub-repo git operations now use git -C <repo> so no shell-state assumptions are made. (#667)

/gsd-new-project AI Models prompt now exposes the adaptive model profile — both onboarding paths (auto-mode and interactive) listed only Balanced/Quality/Budget/Inherit, so the adaptive profile (role-based cost optimization across Claude/Codex/Gemini/OpenRouter/local) was unreachable through /gsd-new-project despite being a first-class catalog entry and documented in CONFIGURATION.md. Both prompts now use the proven two-question split (Q1: Adaptive / Standard tier / Inherit; Q2: Quality / Balanced / Budget) already shipped for /gsd:settings (#3784), and both config-new-project example payloads list adaptive. (#1516) (#1654)
--raw CLI commands no longer drop stdout on the error path — a command that emitted a JSON result/error envelope and then exited non-zero previously lost all of stdout (the output-capture wrapper discarded its buffer when the command threw to set a non-zero exit); the buffer is now flushed before the error propagates. (#1457) (#1457)
gsd install/upgrade now recovers a malformed ~/.gsd/defaults.json instead of leaving it broken — a defaults.json containing a valid-JSON-but-non-object value (null, [], a number, or a string) bypassed the parse catch and flowed through unrecovered: null threw a TypeError (swallowed by the outer guard, logging a confusing "Could not write" warning and leaving the file as null), while []/42/"str" silently kept their broken shape on every install. The non-Claude finishInstall step now resets any non-object parse result to a fresh {} before reading/writing it, so the file is repaired and resolve_model_ids defaults normally. (#1661)
Shipped milestones with a retired/folded phase now reach 100% — a phase struck through in ROADMAP (marked [x], with a directory but no completion artifact) was counted in progress.total_phases but could never be counted complete, freezing the milestone below 100% (e.g. 5/6 = 83%) with state sync --verify reporting no drift. Both STATE counting paths (state json and state sync) now exclude retired phases — detected from GFM strikethrough whose subject is the phase on a checklist/heading line — from both the phase-dir set and the heading count, via the canonical phase-id helpers so numeric, decimal, and project-code IDs match alike. (#1514) (#1568)
Codex installs no longer run with unsafe Claude-style worktree isolation — a Codex install with a runtime-neutral .planning/config.json was resolving its runtime as Claude and enabling git worktree isolation, which Codex's spawn_agent cannot honor; the Codex fail-closed guard was also silently dead because runtime/worktree config was read JSON-quoted and broke shell equality checks. Codex-emitted workflows now resolve runtime=codex, default workflow.use_worktrees to false, and fail closed when worktrees are forced on. (#1515) (#1519)
Windsurf installs expose /gsd- commands in Cascade again* — Windsurf runtime installs now emit workflow files under .windsurf/workflows instead of dead skills-only artifacts. (#1615) (#1622)
Capability settings.json hooks no longer fire on every tool and no longer fail when non-executable — installing a capability that declared a tool-scoped PreToolUse/PostToolUse hook wrote the entry with no matcher, so a guard intended for only Write|Edit fired on every tool call (including Bash) and a fail-closed guard could block the whole session; the emitted command was also a bare script path, so a .js-family hook delivered via git/tarball that lost the executable bit failed with Permission denied on every matching call. Install now honors a declared matcher (absent = match-all, unchanged for existing capabilities) and emits a node-prefixed command for .js/.cjs/.mjs hooks so they run regardless of file-mode bits. (#1634) (#1638)
/gsd:secure-phase now honors the configured ASVS level and block threshold — the security auditor previously received unsubstituted {SECURITY_ASVS} / {SECURITY_BLOCK_ON} placeholder text because secure-phase.md never assigned those variables. It now resolves workflow.security_asvs_level and workflow.security_block_on from config (--raw) before the auditor handoff. (#1625) (#1633)
Phase transitions now require fresh canonical verification - implementation-complete phases no longer advance when verification is missing, gap-bearing, human-pending, or stale relative to phase summaries. (#1548)
The security audit gate now respects workflow.security_block_on severity — /gsd:secure-phase previously blocked phase advancement on any open threat regardless of severity, so the documented security_block_on threshold had no effect (and the auditor's block vocabulary didn't even match the config enum). Threats now carry a per-threat Severity (critical|high|medium|low), and only open threats at or above the configured security_block_on severity count toward the blocking gate (SECURITY.md threats_open); none disables blocking, and a missing/unparseable severity fails closed as critical. (#1626) (#1635)
verify codebase-drift now reads workflow.drift_action and workflow.drift_threshold from the correct nested config shape — previously both keys silently no-oped because loadConfig() returns a flattened object and config?.workflow was always undefined. (#1504)
check.decision-coverage-plan no longer false-passes when CONTEXT.md decisions use the titled-colon bullet form — parseDecisions recognized the colon-immediate (- **D-NN:** text) and em-dash (- **D-NN — title** body) forms but dropped the titled-colon form (- **D-NN: Title.** body, where a title sits between the colon and the closing **) via the parse-miss guard. When all decisions used the titled convention, the parser returned 0 decisions and the coverage gate passed vacuously. A third per-form regex (checked last, a strict superset of the colon form) now parses the titled-colon form; id and [tags] trackability are honored. (#1665)
npm version no longer leaves capability-registry.cjs stale — the version npm lifecycle script now regenerates and stages the capability registry after stamping new version strings into all capability manifests, preventing the 1.6.0-rc regression where gen-capability-registry.cjs --check failed. (#1498) (#1499)
Antigravity installs all GSD slash-command skills where AGY can discover them — concrete skills such as /gsd-progress and /gsd-verify-work now land directly under the Antigravity skills directory instead of router-nested folders. (#1614) (#1616)
frontmatter set on an object-list field now fails closed instead of silently doing nothing — setting must_haves (or another object-list field) to a value whose lossy parse projection matched the original's was a silent no-op: the command reported {updated:true} but the change never applied (the writer's scalar-only parser had flattened both to the same shape). frontmatter set now detects a no-op write for dict-valued fields and surfaces a clear error directing the user to edit the file directly. Scalars and scalar arrays round-trip faithfully, so idempotent sets of those still report {updated:true} (no false positive). (#1664)
config-set now rejects invalid config values instead of storing them silently — out-of-enum strings, JSON array/object coercion (e.g. ["high"] stored as an array in a scalar key), and wrong-typed values for capability-registry-owned keys are validated against each key's declared schema at set time. Previously these were accepted and persisted, mis-configuring GSD. (#1628) (#1632)
OpenCode and other AGENTS-native runtimes now get a root AGENTS.md from /gsd:new-project — the workflow hardcoded a codex-only branch that sent every other runtime to .claude/CLAUDE.md, a location OpenCode never loads. A shared getProjectInstructionFile(runtime) policy (claude→.claude/CLAUDE.md, codex/opencode/kilo/kimi→AGENTS.md, copilot→.github/copilot-instructions.md, antigravity/gemini→GEMINI.md) is now the single source of truth consumed by both the new-project workflow and the generate-claude-md path, with a parity test guarding drift. (#1574)
roadmap upgrade now rejects an unsupported or malformed --convention value (including the --convention= form) instead of silently running the milestone-prefixed migration, and no longer hard-exits inside the command-routing hub. (#1539)
phase complete no longer duplicates a By-Phase row when the phase number's padding differs — completing a phase by its unpadded number (e.g. phase complete 5) against an existing zero-padded By-Phase row (| 05 |) appended a second | 5 | row instead of updating it, double-counting the phase in any column sum. The row matcher now canonicalizes a numeric phase to its integer form (matching 5, 05, 005 in either direction), so the existing row is upserted regardless of padding. (#1663)
Non-Claude installs no longer rewrite an explicit resolve_model_ids: true to "omit" — Codex, OpenCode, Gemini, and the other non-Claude runtimes were silently clobbering the deliberate opt-in to full materialized model IDs on every install/upgrade, so generated agent manifests inherited the active chat model instead of pinning the resolved model. The finish step now only defaults resolve_model_ids to "omit" when it is absent or falsy; an explicit true is preserved. (#1569) (#1653)
A failed roadmap upgrade --apply now actually rolls back .planning/ even when it is gitignored (commit_docs:false), instead of reporting a successful rollback while leaving the workspace half-migrated. Rollback is surgical and no longer runs a whole-repo git reset --hard. (#1543)
Codex runtime no longer crashes on startup — every gsd-tools command previously aborted with Cannot find module '../../../package.json' on Codex, whose runtime root has no package.json, because a module in the loader chain did a top-level require of it. The version emitted into Hermes skill frontmatter is now sourced lazily from the installed gsd-core/VERSION (validated semver), so gsd-tools loads on every runtime and never emits version: undefined. (#1383) (#1409)
/gsd-* commands in Windsurf Cascade resolve their command bodies — Windsurf slash-command workflows delegate to canonical command bodies at gsd-core/commands/gsd/X.md, but the install never copied those files. Commands appeared in the / menu yet silently failed when invoked because the LLM was told to read a missing file. Installs now copy commands/gsd/*.md into the workflow delegation target. (#1630)
query agent-skills no longer returns empty output on Windows — the plain (non---json) path wrote the <agent_skills> block then immediately called process.exit(0), which truncated the async stdout buffer on Windows pipes/files so every ${AGENT_SKILLS_*} workflow capture expanded empty and configured per-agent skills were silently dropped. It now flushes synchronously via the same writeAllSync helper the --json path uses. (#1400) (#1410)
phase complete now updates the By-Phase table on CRLF (Windows) STATE.md files — the By-Phase table matcher required bare \n line endings, so a STATE.md written or hand-edited with CRLF (\r\n) was treated as having no table: the completed phase's row was never upserted (and, with the velocity-from-table derivation, the total went stale). The matcher is now CRLF-tolerant (\r?\n) on the header/separator/lookahead, so CRLF STATE.md files are handled identically to LF. (#1662)
clean up stale get-shit-done paths in Codex and Kimi skill mirrors on upgrade (#1453) (#1453)
add phase.list-plans to gsd-tools — the command was referenced in agents/gsd-plan-checker.md but was missing from the router, causing 'Unknown phase subcommand' on every invocation (#1437)
roadmap analyze no longer reports phantom missing_phase_details for milestone-prefixed (M-NN) phase IDs (#1552)
workflow.security_asvs_level now actually scales security rigor — it was display-only (the planner hardcoded ASVS L1 and the auditor only echoed the level), so L2/L3 behaved identically to L1. The configured ASVS level now scales both planner threat-disposition rigor and auditor verification depth (L1 grep-presence → L2 boundary/vector checks → L3 end-to-end trace), defined in a new references/security-asvs-levels.md; the secure-phase clean-phase short-circuit now spawns the auditor at L2/L3 so deep verification runs even when the preliminary grep classification is clean. (#1627) (#1636)
Atomic file writes now retry a transient rename lock on Windows (a reader holding the target open) instead of falling back to a non-atomic write that could let a concurrent reader observe a truncated STATE.md/ROADMAP.md. (#1541)
Misconfigured agent skills no longer fail silently — when an agent's configured agent_skills paths all fail to resolve (e.g. a missing SKILL.md), gsd-tools query agent-skills now emits an aggregate warning to stderr and adds a warnings[] field to its --json output, instead of returning an empty block with no signal. (#1376) (#1376)
Decision-coverage gate now reads markdown-header and em-dash decisions, and fails loud when it can't parse them — check.decision-coverage-plan (a blocking gate) and gap-analysis previously extracted zero decisions from a populated CONTEXT.md that recorded its decisions under markdown headers (## Locked decisions) or with em-dash bullets (- **D-1 — title**), and silently reported a clean pass — so real decisions went un-checked. Decisions in those shapes are now recognized, and when decision-shaped content cannot be parsed (or a - **D-NN** bullet is malformed), the gate fails loud with a format-mismatch message instead of passing. (#1386) (#1386)
phase complete no longer double-counts Total plans completed velocity on re-run — re-running phase complete on an already-complete phase incremented the velocity total each time (2 -> 4 -> 6 ...), because the metric re-read the cumulative total and blind-added the phase's plan count on every invocation. The total is now derived from the By-Phase table's Plans column (the same source the table upserts against), so re-completing a phase upserts the same row and the sum stays stable — and a hand-edited inflated total self-heals to the true sum on the next completion. (#1582) (#1655)
verify schema-drift now resolves the target phase by its canonical token instead of substring containment, so a non-existent phase no longer silently matches a token-superstring phase (e.g. "1" matching "11-expansion") and runs the drift gate against the wrong phase. (#1640)

Security

Prompt-injection defence extended to the untrusted-input surface (LLM-playbook principle 12) — the read-injection scanner (a pattern-based pre-filter) now also scans WebFetch/WebSearch output (closing the largest untrusted channel at ingress), and the 10 research/doc-ingest agents (issue #1577 AC #2's named eight plus gsd-ai-researcher and gsd-domain-researcher, both web-ingress) isolate fetched/read content as data-not-instructions via a shared untrusted-input-boundary reference — this prompt-level boundary is what keeps an injection from being followed. An opt-in security.injection_blocking (registered config key; default advisory, unchanged) upgrades HIGH-confidence detections to a PostToolUse circuit-breaker: since the hook runs after the fetch, decision: "block" halts the agent's next step rather than redacting the already-fetched content (it is not a redactor). Based on arXiv 2506.05739 (PPA), 2507.15219 (PromptArmor), 2504.20472, 2503.00061. (#1585)
Third-party capability trust gate (ADR-1244 Phase 4) — installing a capability from a git/npm/tarball/local source now discloses every executable surface it ships (hooks, command modules, MCP servers, with the actual commands) and requires explicit consent before anything is promoted; integrity (sha512) and engines.gsd are verified before any code is staged, install never executes capability code, and reserved gsd-/gsd-core-/anthropic- namespaces are refused. capabilities.strict_known_registries gates which sources may be installed ([] = local-only lockdown; host-based allowlist otherwise) and capabilities.auto_update is off by default, re-prompting whenever a new version's executable set changes. An install ledger makes remove surgical (strips only the capability's own shared-config entries, preserving your hand-edits) and update an atomic, crash-safe stage-then-swap. (#1449) (#1449)

[1.5.0] - 2026-06-17

Added

gen-capability-registry now rejects duplicate artifact producers at the same Loop Extension Point — if two capability steps declare produces: [<same artifact>] at the same point, the generator throws at gen time naming the artifact, the point, and the producing capability ids, instead of letting the topological sort pick a winner silently (which left ADR-857 Decision #6's data-flow contract undefined). The check counts distinct (capId, stepIdx) producer steps, so a single step listing an artifact twice does not false-positive. ADR-894 §4's enumerated cross-capability invariant list gains the artifact-production-uniqueness rule. (#1123) (#1131)
gsd-tools drift-guard — deterministic plan-drift severity/authority decisions (ADR-22). The plan-review source-grounding pass now classifies cited-symbol drift through a tested seam (5-rung authority ladder, grep→intel auto-upgrade, severity mapping, rung≥3 hard-block) instead of re-deriving the rules from workflow prose on each run. (#1190) (#1242)
/gsd-progress --next --auto --converge now routes planning through plan-review convergence. ADR-15's designated primary convergence surface is wired into the progress/next workflow (previously only /gsd-autonomous --converge honored it; on /gsd-progress the flag was silently dropped). Accepts --cross-ai as an alias plus reviewer flags and --max-cycles N, and is gated on workflow.plan_review_convergence. (#1190) (#1237)

gsd-tools query teams-status + a plan-phase warning detect claude-code agent-teams — GSD's multi-agent orchestration can stall under claude-code's experimental agent-teams (a subagent's completion can fail to route back to the orchestrator). A new read-only query teams-status command reports { active, runtime, env_present, source } (and --active for a clean shell guard), and /gsd:plan-phase now emits a single non-fatal warning when agent-teams is detected, recommending you disable it for GSD workflows. The detector only activates on the claude runtime with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS strictly truthy — every other runtime and the teams-off path are completely unaffected. (#1355) (#1371)

spec-phase: prohibition probe — a prose-orchestrated Step 5.6 that surfaces the unwritten must-NOT constraints (values/safety/ethics) a feature could silently become but the spec never forbids. Two stages per requirement: an adversarial recall question ("what could this silently become that the author would NOT want?") then a one-pass precision classifier that drops routine engineering and keeps genuine prohibitions. Confirmed prohibitions become NEGATIVE SPEC acceptance criteria carrying a test/judgment verification tier, which plan-phase lifts into the must_haves.prohibitions sibling block (truths untouched). Judgment-tier items soft-gate at verify time (never silent, never hard-halt); unwired test-tier items fail closed. The recall stage is model-driven (no compiled engine); canon-bound concerns (OWASP/GDPR/fairness) are referred to /gsd:secure-phase. Additive and optional: existing SPECs without a Prohibitions section remain valid. Second adapter of the probe-core resolution model (ADR-550 Decision 7). (#1149)
Optional ## Business Context section in the PROJECT.md template — a four-field block (Customer, Revenue model, Success metric, Strategy notes) for monetized or customer-facing projects, positioned between Core Value and Requirements. Optional by default (an HTML comment tells non-business projects to delete it), capped at four one-line fields to stay a constraint reference rather than a business plan, and reviewed at each milestone by /gsd-complete-milestone when present. (#72) (#756)
Async external jobs can now defer an Execute step legally (external_job_waiting). An Execute step that dispatches a long-running external job and commits a .planning/async-jobs/<job>.json manifest — deferring SUMMARY.md — is now recognized as a legal deferred state, not an illegal partial-plan state. execute-phase safe-resume, resume-project, and pause-work reconcile against the manifest instead of re-dispatching (which would duplicate the external compute). This defines the versioned, scheduler-agnostic manifest stability contract consumed by the core loop; the scheduler adapter that produces manifests is the capability half (#1164). (#1165) (#1221)
MemPalace memory capability (opt-in) — adds cross-session/cross-project recall and verbatim+temporal-KG capture at GSD loop boundaries via the MemPalace MCP server and CLI; disabled by default, skip-on-error. (#1201) (#1201)
spec-phase: spec-completeness edge-probe — a taxonomy-driven Step 5.5 that walks each SPEC requirement against a closed 8-category edge taxonomy (boundary, adjacency, empty/degenerate, encoding, ordering, precision, idempotency, concurrency), proposes concrete candidate edges, and resolves each to covered/dismissed/backstop/unresolved. covered edges add acceptance criteria the planner lifts into must_haves.truths; a soft gate flags unresolved edges. Additive and optional: existing SPECs without an Edge Coverage section remain valid. (#584)
phase uat-passed predicate — new runtime-neutral command evaluates HUMAN-UAT results with markdown-aware parsing (ignores frontmatter, fenced code, blockquotes, and HTML comments) and reports pass only when every required check passes. (#1063) (#1063)
Bug-report issues that lack a valid GSD Version are now auto-closed on open by a new version-gate.yml GitHub Actions workflow. GitHub Issue Forms only enforce required: true in the web UI, so issues filed via the REST API, gh issue create, or AI reporters can arrive without a version; values like idk, _No response_, or an empty field are treated as missing. Affected issues receive a closing comment with instructions to add the version (e.g. 1.18.0) and reopen; maintainers can add the version-exempt label to opt an issue out. (#1181)
Kimi CLI runtime support is now documented and installable — users can install global GSD Agent Skills with --kimi --global, invoke them as /skill:gsd-*, and launch the generated custom agent explicitly with kimi --agent-file. The custom-agent (--agent-file) surface targets the legacy/Python kimi-cli contract; newer Kimi Code (@moonshot-ai/kimi-code) consumes the same /skill:gsd-* skills via --skills-dir instead. (#743)
agent_skills can now reference Claude-Code plugin-provided skills via the namespaced global:<plugin>:<skill> form (e.g. global:coderabbit:code-review). On the Claude runtime the agent's skills block emits a by-name Skill-tool load directive that resolves the plugin skill (no plugin-cache path is read); path-resolvable skills keep the existing @-include unchanged; on non-Claude runtimes a namespaced entry is skipped with a warning. The 22 agent_skills-consumer agents now carry the Skill tool so they can load plugin-provided skills. (#1261)
gsd-tools capability set — turn capabilities on/off and gate hooks from one command. Adds the write side of the capability system (ADR-857/ADR-1213): capability set <id> --on|--off toggles a capability through the runtime surface (the canonical on/off switch) and --gate <key>=<true|false> toggles a hook within an enabled capability, then re-resolves and reports — so disabling a capability is consistent across surface and config ("off means off") as a write-time invariant. /gsd:settings capability hook-gates now route through it. (#1213) (#1225)

Changed

Added an opt-in anthropic-fable model policy provider preset for Claude Fable 5 high-budget routing while preserving the existing Anthropic Opus 4.8 defaults and anthropic provider preset. (#1014) (#1015)
Windsurf/Devin workspace skills now install to the canonical .devin/skills/ directory — fresh workspace installs write skills under .devin/skills/ (Devin Desktop's documented preferred location) instead of .windsurf/skills/; the legacy .windsurf/skills/ layout is still recognized. The global ~/.codeium/windsurf/skills/ path is unchanged. (#1093) (#1093)

loadCentralConfigKeys now fails loud on a malformed central config-schema instead of silently returning an empty Set — ENOENT (the schema legitimately absent) still returns an empty Set silently, but a JSON parse error or any other read failure now writes a prominent stderr warning naming the schema file and throws ExitError(1). Previously a single catch (_) swallowed parse errors too, so a merge-conflict marker or truncated write in config-schema.manifest.json made every capability config key look non-central — the config-key collision / pending-migration gate fired zero warnings and --check passed clean, defeating the gate invisibly. (#1124) (#1131)

Capability hook rendering now consumes resolved Capability State — gsd-tools loop render-hooks uses the same installed/surfaced/configured state reported by gsd-tools capability state, so disabling a migrated capability at the runtime surface removes its workflow hooks even when config defaults are enabled. Migrated capability config keys remain accepted through the generated capability registry/federated config path instead of duplicated central VALID_CONFIG_KEYS entries. (#1136) (#1153)

Added ADR-857 Phase 6 capstone conformance coverage so migrated Capability activation keys cannot be read directly from host loop workflows, Capability-owned config keys stay out of the central schema, and the host loop workflow size budgets remain documented. The verify-work UI automation preflight now resolves UI activation through the Capability hook registry instead of reading workflow.ui_phase directly. (#1158)

ADR-857 phase 6 complete: optional features are now Capabilities, not inline loop branches. tdd, schema-gate, drift, gap-analysis, and profile-pipeline are migrated out of the five-step host loop into declarative Capabilities (loop hooks + a command family); their config keys are federated to capability ownership; and the plan-phase/execute-phase workflow bodies shrink accordingly. Two previously-declared-but-dead capability gates now actually fire — the security ship-time gate (ship:pre) and the UI safety gate (execute:wave:post) — and the phase-6 conformance gate is hardened to be un-gameable (rejects empty stubs, requires loop-body shrink, verifies hook dispatch and gate-result contracts). Behavior is preserved, verified across five adversarial review passes. (#1139, #1167, #1168, #1169) (#1183)

Test-tier prohibitions are now a real, provable gate instead of a permanent, unsatisfiable gaps_found — the deferred ENFORCEMENT half of ADR-550 Decision 5d (the "heavy half" that #644 / PR #1149 deferred) has landed. A new deterministic check prohibition-enforcement sub-command (authored as src/prohibition-enforcement.cts, compiled by build:lib to the gitignored gsd-core/bin/lib/prohibition-enforcement.cjs) is the missing PRODUCER: it locates the wired mechanical check, runs it for a genuine non-vacuous pass, builds enforcementEvidence, and emits the dispositionForProhibition() verdict. The previously-unreachable green branch in dispositionForProhibition() is now reachable from the live pipeline — a test-tier prohibition with a genuinely-passing wired check disposes green and can reach passed, while a missing, non-attested, or non-passing check hard-gates (flagged, never green → gaps_found) in BOTH interactive and autonomous modes (ADR-550 D4 / D3). verify-phase.md wires the consumer; the green/fail-closed policy in src/probe-core.cts is untouched. Both wired-check kinds are accepted (ADR-550 D2): a node --test negative test (requiring a real reported test — an empty file, which node --test counts as one passing "test", does NOT green) AND a lint/AST rule run as eslint --format json filtered by ruleId (so plugin rules like local/* load — bare --rule cannot), anchored on the in-tree local/no-source-grep rule (dogfooding, ADR-550 D4). This enforcement seam is the concrete instance of ADR-857 open-question §147 and lands on the core verify rail, never in capabilities/ (D6). (#1259)

Honest scope — failFirst is caller-attested, not yet machine-proven. This lands the execution + non-vacuous-pass half: the producer requires the caller to attest failFirst: true and the check to genuinely run and pass. It does NOT yet independently prove the check fails-on-violation (the literal regression-must-fail-first property) — cheap proof of that at verify time needs running the check against a known violation fixture, which is a tracked follow-up (#1279). The red-first property currently rests on caller attestation, surfaced transparently in the evidence record.

Correction to the issue body (#1259): the issue's "96 invalid/error negative-proof cases" figure is wrong. For the no-source-grep anchor specifically, the genuine regression-must-fail-first proofs are its two invalid cases (the .includes() and .match() blocks) in tests/eslint-rules.test.cjs — not 96. The anchor argument is unaffected (those two cases ARE real fail-first proofs); only the count was off. (#1273)

The test-tier prohibition gate now has a deterministic SOURCE for its wired check — a resolved test-tier must_haves.prohibitions item MAY carry an optional check descriptor authored at spec-phase: the flat-scalar keys check_kind (node-test | lint-rule), check_target, and check_rule (lint-rule only). projectProhibitions projects these scalars deterministically and verify-phase reads them back (via descriptorFromProjection) to locate the check handed to check prohibition-enforcement — so a wired, passing test closes the gap with zero manual descriptor authoring (previously the verify-phase LLM had to invent {kind, target, rule} each run, #1259). This extends the ADR-550 Decision 3 prohibition-item shape (ratified in a dated 2026-06-15 ADR-550 addendum). The descriptor is optional and fully backward-compatible — a prohibition with no descriptor parses and disposes byte-identically to today — and fail-closed: a partial, invalid, or absent descriptor falls through to the producer's existing fail-closed locate, never a silent green. The descriptor is represented as flat scalars (not a nested check:{} object) to keep the shared parseMustHavesBlock round-trip regression-free. Out of scope: machine-proven fail-first (#1279) and the dispositionForProhibition policy stay unchanged. (#1278) (#1301)

Test-tier prohibition fail-first is now MACHINE-PROVEN, not caller-attested — the deferred literal regression-must-fail-first property of ADR-550 Decision 4 (the gap #1259 / PR #1273 left as a tracked follow-up) has landed. The check prohibition-enforcement producer (src/prohibition-enforcement.cts, compiled by build:lib to the gitignored gsd-core/bin/lib/prohibition-enforcement.cjs) no longer trusts the caller's failFirst attestation: before a clean, non-vacuous pass can dispose a test-tier prohibition green, the new defaultProveFailFirst prover independently RUNS the wired check against a KNOWN VIOLATION and confirms it goes RED. Attestation is gone from the green AND (passed = proof.provenFailFirst === true && run.passed === true); any other outcome — passes-on-violation, can't-prove, throws, times out, or no violation source — hard-gates in BOTH interactive and autonomous modes (ADR-550 D4 / D3). The evidence record gains a failFirstProof field recording HOW fail-first was proven (FF-07). A caller can no longer green a toothless check.

The violation is sourced from a new descriptor field, CheckDescriptor.violationFixture — an author-supplied path to a known-bad subject. For a lint-rule the prover lints that fixture and requires the rule id to appear in the JSON report (the rule must have teeth); for a node-test the prover spawns the negative test with the subject injected through the GSD_PROHIB_SUBJECT env convention and requires a NON-VACUOUS red — # fail >= 1 AND a failing test named distinctly from the file (isNonVacuousNodeTestRed), so a violation fixture that merely CRASHES the test at load is not mistaken for the negative assertion firing red (symmetric with the clean-pass non-vacuity guard). The node-test prover also requires the violationFixture to EXIST (resolved against cwd) before spawning — a missing/typo'd path fail-CLOSES rather than letting an honest test's ENOENT crash forge a green (symmetric with the lint path's file-result guard). The deterministic spec→verify path composes end-to-end: a fourth flat scalar check_violation_fixture is projected by projectProhibitions and read back by descriptorFromProjection (rides both kinds), so a prohibition authored with all four check_* scalars machine-proves fail-first and greens through the projection alone — zero hand-authoring at verify time (#1278 + #1279 + #1346; round-trip pinned by a fast-check property + CHK-03(D) + an end-to-end COMPOSE capstone). One documented residual remains under #1346: the node-test proof confirms the fixture exists and the check reds, but cannot generically prove the red was caused by the subject's content rather than by the env merely being set. The lint-rule path is fully shippable now and is dogfooded against the in-tree local/no-source-grep rule; the node-test path ships its mechanism (a fixture-bearing descriptor IS machine-proven) and is exercised by SYNTHETIC temp fixtures — there is no live in-tree node --test prohibition to dogfood. CheckDescriptor.failFirst is DEMOTED, not removed (FF-08): it is kept as a non-authoritative hint so the #1259 route-JSON shape and the CheckDescriptor type stay backward-compatible mid-migration, but no path greens on it alone. The green/fail-closed policy in src/probe-core.cts (dispositionForProhibition, reads only evidence.length > 0) is untouched; the evidence array shape is additive. This closes ADR-550's D5d follow-up — see the dated 2026-06-15 ADR-550 addendum. (#1279)

PR-review flag — GSD_PROHIB_SUBJECT + violationFixture are PROPOSED, renamable conventions. Both are net-new surface with ZERO live in-tree consumers (no in-tree node-test prohibition yet; node-test proof runs only on synthetic test fixtures, the real dogfood stays the lint-rule). They are forward-looking scaffolding, so a later rename — or replacing the env var with an argv — is a mechanical, zero-migration find/replace. Surfacing them here so the maintainer can ratify, rename, or replace them at PR review with no migration cost, exactly as #1278's ADR addendum was reviewed at PR time. The failFirst demotion is likewise open to weighing outright removal; the keep-as-hint rationale is recorded in the ADR addendum. (#1314)

Read-only verifier/auditor agents now ship a Claude-Code disallowedTools deny-list — the installer injects a framework-level write-tool deny-list into the Claude copies of the read-only verifier/auditor agents (gsd-verifier, gsd-plan-checker, gsd-integration-checker, gsd-doc-verifier, gsd-eval-auditor, gsd-ui-auditor, gsd-ui-checker) so write actions are blocked even if a tool grant is inherited. Injected for Claude only; other runtimes are unaffected. (#1081) (#1081)

Antigravity workspace skills now install to the canonical `.agents/` directory — fresh installs write workspace artifacts under `.agents/` (the Google-Codelabs-documented base) instead of `.agent/`; the legacy `.agent/` layout is still recognized so existing installs keep working. The global `~/.gemini/antigravity/` path is unchanged. (#1090) (#1090)

devin-desktop runtime alias for the Windsurf→Devin Desktop rebrand — the windsurf runtime now also answers to devin-desktop (CLI --devin-desktop), aiding discoverability after Cognition rebranded Windsurf as Devin Desktop. All paths are unchanged — global skills still install to ~/.codeium/windsurf/skills/. (#1086) (#1086)

Remove dead loadConfig export from configuration.cts — superseded by config-loader.cts (ADR-857 phase 2e, #885). All live callers already import loadConfig from config-loader.cjs or the core.cjs back-compat re-export; exhaustive grep confirms zero callers importing it from configuration.cjs. configuration.cjs now provides only the pure normalization and defaults primitives (normalizeLegacyKeys, mergeDefaults, migrateOnDisk, CONFIG_DEFAULTS) that config-loader.cjs depends on. (#893) (#893)
audit(#779): correct stale model-catalog IDs verified against live provider sources. The gemini opus default gemini-3-pro → gemini-3.1-pro-preview (the bare gemini-3-pro ID is undefined in gemini-cli source — only gemini-3-pro-preview/gemini-3.1-pro-preview exist) and the codex sonnet default gpt-5.3-codex → gpt-5.4 (deprecated per OpenAI's Codex models page); the same two IDs are also updated in the google/openai provider-preset entries. qwen3-coder-next was verified valid (callable on Alibaba Model Studio) and left unchanged. Adds a regression guard against the retired IDs and a sourcing/verification note in CONFIGURATION.md. Catalog IDs are internal defaults; users who pinned the old IDs must update their config. (#1047)
INVENTORY.md no longer carries (N shipped) count scalars — the hand-maintained absolute counts collided silently on merge (two branches each bumping the same integer to N+1 while the merged tree held N+2), red-flagging CI on the merge commit across all platforms. The manifest's name-set is now the sole registry, anchors are count-free and stable, and a guard test blocks re-adding a count. (#1179) (#1179)
Edge-probe precision probe text now names tie-breaking / rounding-mode (half-up vs half-to-even, ceil/floor/truncate), so a surfaced precision edge cues the most common rounding failure mode. Prose-only; firing rule and the 8-category core unchanged. (#1108)
Capability manifests now declare runtime compatibility through a validated runtimeCompat contract, and runtime descriptor interpreters now read artifact layout, skills-home, and hook-surface facts directly from runtime Capability descriptors instead of parallel runtime-name allowlists or fallbacks. This preserves existing supported runtime behavior while making future descriptor-backed runtimes additive. (#1157)
Planning-time research, AI integration, and pattern mapping now participate through Capability declarations and rendered plan:pre hooks, with developer documentation for building GSD capabilities. (#1141)
The planner now blocks plans that would self-trip their own verify gate — when an acceptance criterion negative-greps for a literal (grep -c 'LIT' file == 0) and that same literal appears verbatim in an <action> body, plan creation now fails at write time instead of letting the executor waste cycles on a comment-text echo at commit time. Unquoted/ambiguous grep targets warn instead of failing; add  to allowlist a legitimate occurrence. (#1062) (#1062)
Namespace router skills now nest their concrete sub-skills at install time (#69). On runtimes with non-recursive skill loaders (Claude global, Cline, Qwen, Hermes, Augment, Trae, Antigravity) the installer emits the 6 gsd-ns-* routers as the only top-level skill bundles and nests the ~61 concrete skills under <router>/skills/<name>/SKILL.md, cutting the eager skill-listing overhead to ≈6 entries. Concrete skills stay reachable via the router's Read skills/<name>/SKILL.md routing table. Breaking: on those runtimes the concrete skills are no longer invocable by bare name through the Skill tool / top-level listing — route via the namespace router (or the unchanged /gsd-* slash command where a commands surface exists). Legacy top-level gsd-<concrete>/ skill dirs are removed on upgrade. Recursive/unconfirmed loaders (Cursor, Codex, Copilot, Windsurf, CodeBuddy, OpenCode, Kilo) keep the flat layout. (#883)
Graphify now respects surface/profile state, not just graphify.enabled — gsd-tools graphify is off unless graphify is installed AND surfaced AND graphify.enabled is true (previously only the config key was checked). The gate is now runtime-aware: Codex/Cursor/etc. read their own runtime's surface instead of ~/.claude. (#1313) (#1313)
Isolated-executor recovery now fails safe — when an isolated (worktree) executor run is rejected (you decline to merge it) or over-reached the requested scope, /gsd:execute-phase and /gsd:quick no longer default or propose recovery by editing the primary checkout (main). The orchestrator halts safely and offers a fresh, narrowly-scoped worktree or inspect/discard; editing the primary checkout requires explicit, clearly-labeled confirmation. (#1292) (#1303)
Migrate code review, security, and Nyquist verification workflows to ADR-857 capability hooks. (#1147)
Intel and loop-hook rendering now honor the single capability active state — gsd-tools intel gates through the shared resolver (consistency; intel stays governed by intel.enabled), and loop-hook rendering now suppresses a config-disabled capability's hooks via the capability-level active gate (fail-closed), not just per-hook when. (#1315) (#1315)
Added no-drift guard tests (tests/issue-57-runtime-install-no-drift.test.cjs) that protect the Runtime Install Policy Module boundary (ADR-58) and the explicit Runtime Config Adapter Registry (#60). They fail loudly when supported-runtime metadata is added to an installer call site (allRuntimes, the interactive runtimeMap menu) without a matching registry adapter entry, or when config-mutation dispatch escapes the registry's declared install surfaces — catching reintroduction of the scattered per-runtime branching those seams removed. (#867)
Edge-probe now surfaces a zero-classification requirement (non-empty prose, no shape cue matched, no shapes override) as a single soft unclassified — review manually candidate instead of silently dropping it. Dismissible like any edge; shapes: [] opt-out stays silent; TAXONOMY unchanged. (#1117)
Capability state now reports a tri-state active — gsd-tools capability state adds an active field per capability (installed && surfaced && config-enabled), alongside the existing enabled (installed && surfaced). Internal isCapabilityActive(capId, cwd) lets consumers honor the single resolved on/off answer. (#1311) (#1311)
gsd-verifier no longer marks behavior-dependent must-haves VERIFIED on symbol presence alone — a truth that asserts a state transition or a cancellation/cleanup/ordering invariant is marked PRESENT_BEHAVIOR_UNVERIFIED when no test exercises it: excluded from the verified_truths score, reported as a behavior_unverified count, and routed to human verification, so a clean N/N now certifies behavioral evidence rather than mere symbol presence. (#966) (#1271)
verify plan-structure warns on cross-task region-scope conflicts (#968) — when a plan task's file-wide negative grep (! grep -Eq 'PAT' file / grep -c 'PAT' file == 0) bans a construct a sibling task legitimately requires elsewhere in the same file, plan validation now surfaces a warning pointing to the new region/function-scoped negative-gate idiom (documented in the gsd-planner guidance and the planner-antipatterns reference, with a worked banned-in-X / required-in-Y example). Warn-only: it never errors and never changes valid. (#1320) (#1320)

Fixed

gsd-intel-updater now writes the canonical intel filenames the gsd-tools intel CLI actually reads — the agent was instructed to emit short names (files.json, apis.json, deps.json) and a markdown arch.md, but the intel library reads only file-roles.json, api-map.json, dependency-graph.json, and arch-decisions.json (JSON). After /gsd:map-codebase --query refresh the output was orphaned, so intel status/validate reported the files missing and intel query returned nothing. The agent now emits the canonical long names and structured arch-decisions.json. (#1000) (#1037)
Installer no longer appends a duplicate managed hook when it is registered via an HTTP route — a hook re-registered as a type:"http" entry (local hook-server routing) carries its identity only in url, which the installer's presence check ignored, so a stock command duplicate was appended on every install/update and the hook ran twice per event. The presence check now also inspects h.url. (#1004) (#1032)
/gsd-code-review's fallow structural pre-pass now actually runs and delivers findings — it invoked fallow with flags no published fallow version accepts (--json, --profile, --stdin-files), so the pre-pass failed on every run and silently degraded (the structural-findings feature never delivered on any fallow version). It now uses fallow's real CLI (audit --format json --quiet, --changed-since for phase scope, and --max-crap mapped from the code_quality.fallow.profile preset: minimal→50, standard→30, strict→15), treats fallow's exit code 1 ("issues found") as a successful run instead of a crash (gating on a valid JSON report, not the exit code), and normalizes fallow's real audit --format json schema (dead_code.*, duplication.clone_groups) into the reviewer's <structural_findings> contract. The report normalizer — previously dead code parsing a schema fallow never shipped — is wired to the real schema and exercised against real fallow output. (#1012) (#1044)
worktree base-check now honors a user/global worktree.baseRef:"head" (and CLAUDE_CONFIG_DIR) — base-check resolved baseRef from the project checkout's .claude/ only, so a machine-wide head set via /config (the layer the harness itself honors) was invisible. On any phase/feature lane it returned shouldDegrade:true and execute-phase silently forced sequential execution, losing the parallel worktree execution the user configured. Resolution now falls back to the user/global settings.json (via getGlobalConfigDir('claude'), honoring CLAUDE_CONFIG_DIR) below the existing project-local and project-shared layers. (#1013) (#1038)
Agent SDK/state/commit steps now resolve gsd-tools on shim-only installs for every runtime — source agents/*.md (gsd-planner, gsd-executor, gsd-verifier, gsd-plan-checker, …) invoked bare gsd-tools …, which fails with command not found on shim-only installs where the binary is only reachable as <runtime-home>/gsd-core/bin/gsd-tools.cjs and is not on PATH. The agent then silently skipped init/state/validate/commit ceremony. #725 fixed only Codex's conversion layer; the source agents were never migrated, so the bug persisted on Claude Code and every other runtime that consumes the source agents directly. All 12 gsd-tools-calling agents now carry the canonical multi-runtime gsd_run resolver (the same preamble the workflow launchers use — covering claude/codex/cursor/gemini/copilot/windsurf/augment/trae/qwen/cline/opencode/kilo/hermes/antigravity homes), gsd-phase-researcher's stale claude-only resolver is upgraded to the canonical one, and the launcher-parity + bare-call regression guards are extended to agents/ so no runtime can silently regress. (#1041) (#1045)
gsd-tools generate-claude-md no longer clobbers a hand-crafted CLAUDE.md, and defaults the Claude-runtime output to ./.claude/CLAUDE.md — /gsd-new-project wrote a repo-root CLAUDE.md full of broad project documentation, overwriting/diluting an existing hand-authored instruction file. Now: (1) an existing instruction file that contains no GSD section markers (a hand-crafted file) is left untouched and the command reports action: "skipped" — pass --force to overwrite intentionally (the flag was already parsed but ignored); (2) the default output for Claude-family runtimes is ./.claude/CLAUDE.md (a valid project-scoped memory location) instead of repo-root ./CLAUDE.md, so generated content does not pollute a repo-root file. The config default (claude_md_path), the project config template, and the new-project workflow are aligned to the new location. Codex projects still write AGENTS.md. (#1098) (#1118)
state record-session updates an existing ## Session Continuity section in place instead of appending a duplicate ## Session block — on a freshly bootstrapped project (workstream / gsd2-import / new-project templates all emit ## Session Continuity), the auto-create path recognised only the normalized ## Session heading, so it appended a second session block. It now inserts only the missing canonical fields after the ## Session Continuity heading, preserving the heading and any existing prose, and the snapshot / frontmatter readers recognise that heading. (The originally reported recorded:false-yet-mutated symptom was already resolved by #944/#948.) (#1101) (#1113)
roadmap annotate-dependencies no longer fuses the preceding summary line onto the Plans: header — when the match regex's (?:^|\n) anchor consumed a leading newline (mid-string match), the replacement dropped it, producing corrupted output like **Plans:** 3 plansPlans:. The replacement now re-emits the leading newline when present. (#1103) (#1111)
/gsd-progress no longer reports a phase as complete (and routes to the next phase) when its verification ended human_needed or gaps_found — routing derived completeness from plan/summary counts only and never consulted the verification.status query (the seam built in #651). A new Step 1.7 consults it for the current phase, and the routing table sends gaps_found to /gsd:plan-phase {phase} --gaps (Route V.gaps) and human_needed to /gsd:verify-work {phase} (Route V.human) before the generic complete row. passed, missing (unverified), and unknown still route as complete, so unverified phases are not falsely blocked. (#1107) (#1116)
write-profile now writes USER-PROFILE.md to the active runtime's config home instead of always ~/.claude — under Codex, gsd-tools query write-profile wrote ~/.claude/gsd-core/USER-PROFILE.md while Codex discuss-phase advisor-mode (installed under ~/.codex) checked the Codex home and never found it, so advisor-mode silently stayed disabled. The default output path is now resolved via the runtime-aware getGlobalConfigDir (GSD_RUNTIME / config.runtime → e.g. ~/.codex for Codex), matching how the runtime's own workflows resolve it — mirroring generate-dev-preferences. Claude is unchanged (~/.claude); an explicit --output still wins. (#1114) (#1119)
/gsd:review no longer produces a silent empty Codex review on codex-cli < 0.137 — the codex exec invocation passed --dangerously-bypass-hook-trust (added in codex 0.137.0) unconditionally and discarded stderr, so on older CLIs codex exited with unexpected argument before reading the prompt and the empty output was treated as a completed review. The flag is now capability-probed (codex exec --help | grep) and applied via $CODEX_BYPASS_FLAG only when supported, codex stderr is captured to a .err file instead of /dev/null, and an empty Codex output is replaced with a diagnostic so a broken reviewer is surfaced rather than silently skipped. (#1115) (#1122)
sandbox_mode emission in Codex TOML is now gated on the runtime descriptor's sandboxTier axis — previously installCodexConfig emitted sandbox_mode unconditionally from a hardcoded policy map regardless of whether the runtime descriptor declared a sandbox tier, making the descriptor field cosmetic. resolveInstallPlan now projects sandboxTier from the capability registry, and generateCodexAgentToml / installCodexConfig gate emission on sandboxTier !== 'none'. The per-agent mode table CODEX_AGENT_SANDBOX remains GSD agent policy (not a runtime-descriptor property). For codex (sandboxTier === 'codex-agent-sandbox') output is byte-identical to before; for all other runtimes (sandboxTier === 'none') sandbox_mode is correctly omitted. resolveInstallPlan now fails loud (throws TypeError) on a missing or invalid sandboxTier descriptor axis rather than silently coercing garbage to 'none', preventing a corrupt/stale registry from silently dropping sandbox enforcement. Full removal of the per-agent registration-tax map remains tracked under #1138. (#1151) (#1152)
Installed runtimes no longer silently disable verify:post gates — in a global skills-runtime install (e.g. Codex at ~/.codex), the commands/gsd source tree is absent, so capability-state resolved an empty skill manifest. The full-profile * sentinel then materialized to an empty surfaced set, marking every capability surfaced=false → enabled=false. The result: gsd-tools loop render-hooks verify:post returned activeHooks: [] even with security_enforcement and nyquist_validation enabled, so the security and Nyquist gates never fired. Capability-state now falls back to the installed <configDir>/skills/gsd-*/SKILL.md layout when the source tree is unreachable, so verify:post again includes security -> secure-phase and nyquist -> validate-phase. (#1206) (#1206)
gsd install no longer warns that settings.local.json "may be malformed" when the file contains a valid JSON null. readSettings now treats a successfully-parsed null as empty settings ({}) instead of collapsing it into the parse-failure path, so a literal-null settings file is preserved silently; genuinely unparseable files still emit the warning. (#1191) (#1233)
gsd-tools no longer crashes at load on a fresh install — the installer omitted scripts/fix-slash-commands.cjs, which command-roster requires at module load, so every gsd-tools command failed with MODULE_NOT_FOUND. The installer now ships it (with a smoke assertion), and readCmdNames() tolerates a missing commands directory. (#1240) (#1240)
state begin-phase / complete-phase now advance the frontmatter status for pipe-table STATE.md, not only inline Status: files. The status update matched the YAML frontmatter status: line first and never updated a body | Status | … | cell, so the frontmatter status froze (e.g. stuck at planning); it now transitions correctly (planning → executing → completed) regardless of whether the body Status is inline or pipe-table. (#1255) (#1256)
state planned-phase now advances the pipe-table Status cell (and frontmatter status), and state begin-phase now updates the Current Position | Phase | / | Plan | cells instead of prepending stray inline lines. Systemic follow-up to #1255: planned-phase ran its body-field replacements on the full file content, so the YAML frontmatter status: line was matched before the body | Status | … | cell and the status never reached Ready to execute; and begin-phase had pipe-table branches only for Status/Last activity, so for pipe-table STATE.md the Phase/Plan rows were left stale while a spurious inline Phase: N — EXECUTING line was prepended. Both handlers now strip frontmatter before body-field replacement and update pipe-table cells in place, matching the inline-format behaviour. (#1257) (#1260)

Parallel worktree execution now has executor-authored cleanup metadata — executor agents capture their worktree path, branch, and expected base before task commits and return a parseable metadata block for execute-phase to prefer over runtime harness metadata. (#1297) (#1349)

UAT resume now accepts paused checkpoints — `uat render-checkpoint` treats a non-structured paused `Current Test` placeholder as a resume signal and derives the checkpoint from the first pending UAT test instead of failing as malformed. (#1300) (#1350)

`phase complete` now preserves prose-block STATE phase names — template-shaped `Current Position` prose now advances with the next phase name, avoids missing-field warnings, and keeps `Last activity:` on the template em-dash delimiter. (#1316) (#1351)

Claude skill installs now avoid rejected `xhigh` effort frontmatter — heavyweight GSD skills now ship with portable `effort: max`, and the Claude skill converter normalizes any remaining `xhigh` source effort before writing `SKILL.md`. (#1319) (#1352)

Glued letter-prefix phase directories now resolve correctly -- phase lookup now recognizes tokens like `P0.3` and `M1-2` from directory names, so phase commands can find their plans instead of reporting none found. (#1324) (#1353)

Update backups now ignore preserved shared skills and hooks -- `/gsd-update` custom-file detection now mirrors installer cleanup scope for shared runtime roots, so non-`gsd-*` skills and hooks are not copied into backup folders unnecessarily. (#1325) (#1354)

Codex skills no longer show up twice in autocomplete — GSD's Codex install wrote an `agents/openai.yaml` sidecar under every managed `gsd-*` skill directory, and recent Codex builds index both `SKILL.md` and the sidecar, so each skill appeared twice (once as `gsd-foo`, once as a humanized `foo` display name). The installer now stops emitting these sidecars and removes stale ones left by prior installs (pruning the empty `agents/` directory), while preserving user-owned skill directories. Codex discovers GSD skills via `SKILL.md` alone. (#1326) (#1360)

The worktree path guard no longer blocks ordinary writes in non-GSD git worktrees — the `gsd-worktree-path-guard` PreToolUse hook fired for every `Write`/`Edit` in any linked git worktree, so Claude Code plan-mode writing its plan to `~/.claude/plans/<slug>.md` from a manually-created worktree was hard-blocked. The hook now only enforces inside a GSD isolated-executor worktree (branch `worktree-agent-*`) and fails open when a target resolves to no git repository, while still blocking writes that escape to a different git root (the #260 protection) or into a repository's `.git` internals. (#1342) (#1361)

`check.decision-coverage-plan` no longer reports a false pass when a `D-NN` decision header has text before the colon — `parseDecisions` previously dropped any `- D-NN …:` bullet whose header contained a `(parenthetical)`, em-dash, or other prose before the `:**`, silently narrowing the trackable set so the blocking coverage gate green-lit a phase whose dropped decisions were never checked. The parser now tolerates a freeform run before the colon (preserving `[bracket]` tags) and warns on any `D-NN` bullet it still cannot parse instead of dropping it. (#1343) (#1358)

Codex `hooks.json` is now always written in the nested `{ "hooks": { … } }` shape Codex expects — the writer previously echoed back whatever shape it read, so an empty, absent, or legacy top-level `hooks.json` (`{ "SessionStart": [...] }`) stayed in the legacy shape that current Codex can reject or warn on. Every write now canonicalizes to the nested form, lifting any legacy top-level event entries (including mixed nested+top-level files) under `hooks` without dropping user-owned entries. Managed-hook dedup/removal is unchanged. (#1348) (#1363)

gsd install --cursor no longer leaves bare ~/.claude paths in installed artifacts — the Cursor install branch only rewrote the trailing-slash .claude forms, so bare ~/.claude / $HOME/.claude references survived into installed skills and workflows (e.g. gsd-surface, gsd-graphify, plan-phase, autonomous) and tripped the post-install "unreplaced .claude path reference(s)" warning, pointing at a directory that doesn't exist on a Cursor-only install. The Cursor branch now rewrites bare forms too (mirroring the Trae/Augment/Copilot branches), using a (?![\w-]) lookahead so .claude-plugin / .claudeignore are not corrupted. (#1356) (#1368)

/gsd-new-project and /gsd-new-milestone now self-heal when the research synthesizer returns SUMMARY.md inline instead of writing it — under some context loads the gsd-research-synthesizer agent hits an LLM false-refusal (fabricating a non-existent write restriction) and returns the SUMMARY.md content in its reply rather than writing .planning/research/SUMMARY.md. Prompt hardening (#240) reduced but did not eliminate this. Both workflows now verify the file exists after the synthesizer returns and, if it is missing but content came back inline, the orchestrator persists it before spawning gsd-roadmapper — so the roadmapper never fails with "SUMMARY.md not found". (#222) (#1042)
Codex agent TOML generation no longer pins model_reasoning_effort when the agent is intentionally inheriting the active Codex chat model. GSD still emits both model and model_reasoning_effort when a per-agent model override or runtime: "codex" resolver pins the model, avoiding the confusing partial state where the model followed Codex UI selection while effort followed GSD catalog defaults. (#838) (#842)
profile-pipeline temp output now lands under the reaped GSD temp root. cmdExtractMessages and cmdProfileSample previously created their output directories directly in os.tmpdir() root (gsd-pipeline-* / gsd-profile-*), which reapStaleTempFiles never scans (it only scans GSD_TEMP_DIR = os.tmpdir()/gsd). The directories accumulated forever. Both sites now call ensureGsdTempDir() and create under GSD_TEMP_DIR. Also adds missing after/afterEach teardown to four test fixtures that leaked gsd-* temp dirs on every npm test run. (#866) (#879)
getMilestonePhaseFilter now excludes phase headings inside fenced code blocks ( ``` or ~~~) — consistent with the fence-aware behavior of extractCurrentMilestone. Previously, a ### Phase N: line inside a fenced block was wrongly counted as a real phase. (#875) (#880)
gsd_run launcher shim now probes all non-Claude runtime homes before failing. The shim's last-resort detection previously stopped at $HOME/.claude, causing a false-positive fatal error on every non-Claude runtime (Hermes, Cursor, Codex, Copilot, Windsurf, Augment, Trae, Qwen, CodeBuddy, Cline, Grok, Antigravity, OpenCode, Kilo) when RUNTIME_DIR was unset and gsd-tools was not on PATH. The snippet now probes each runtime's config directory (respecting HERMES_HOME, CURSOR_CONFIG_DIR, CODEX_HOME, etc. with sensible $HOME-relative defaults) before emitting the install error. (#903)
validate health and validate consistency no longer emit false-positive W007 warnings for projects using checklist-style ROADMAP.md phases. buildRoadmapPhaseVariants() in src/validate.cts previously used only a heading-style regex (## Phase N: name), silently ignoring the supported checklist format (- [x] **Phase N: name**). This caused every on-disk phase directory to trigger W007 ("exists on disk but not in ROADMAP.md") when the project's ROADMAP used checklist-only notation. The fix adds a second regex pass mirroring the existing buildNotStartedPhaseVariants() approach. Additionally, cmdValidateConsistency() in src/verify.cts had a duplicate inline heading-only regex with the same gap — refactored to delegate to buildRoadmapPhaseVariants() (DRY). (#892) (#893)
init execute-phase and cmdCommit now produce correct branch_name when project_code is set — the {phase} substitution in phase_branch_template now calls normalizePhaseName(), stripping the project-code prefix and zero-padding the number, so the generated branch is e.g. gsd/phase-01-foundation instead of gsd/phase-CK-01-foundation. Both the execute-phase output path (src/init.cts) and the pre-execution commit path (src/commands.cts) are fixed. (#904) (#904)
syncStateFrontmatter no longer strips current_phase, current_phase_name, current_plan, and progress from STATE.md — when body annotations are absent (e.g. after an agent rewrites the body), the existing frontmatter values for those scalars are now preserved, mirroring the fallback already applied in cmdStateJson. (#905) (#905)
Top-level Claude Code /gsd-plan-phase now always spawns the researcher/planner/plan-checker agents instead of collapsing them inline — a <runtime_compatibility> block after </available_agent_types> makes the Agent-availability requirement explicit and documents that the workflow fails-closed (stops with a clear log message) in genuinely Agent-less contexts; seven "ORCHESTRATOR RULE — CODEX RUNTIME" labels are renamed to "ALL RUNTIMES" so the guard applies universally; execute-phase.md scopes its existing "Other runtimes" inline-fallback prose to non-Claude contexts, preserving the #853 backgrounded-agent behaviour. (#913) (#913)
/gsd-plan-phase, /gsd-execute-phase, /gsd-autonomous no longer carry context: fork — these are spawning orchestrators; a forked subagent context has no Agent tool, preventing them from spawning the subagents they require. effort: xhigh is preserved. Fixes /gsd:autonomous halting with "running as a forked subagent" on 1.4.1 (#921). Also replaces the introspection-based Agent-availability check in plan-phase's <runtime_compatibility> block with an attempt-based gate: the workflow now always attempts the Agent() call and only stops if a real tool-unavailable error is returned, eliminating false-negative aborts in top-level sessions (#922). (#921)
Claude global install reverted to flat skill layout so concrete skills are discoverable. PR #883 introduced nested skill layout for Claude at ~/.claude/skills/gsd-ns-<router>/skills/<stem>/SKILL.md, but Claude Code's skill discovery scans only one level under ~/.claude/skills/ — nested concrete skills were never listed in the Skill-tool available-skills list and direct Skill(skill="gsd-plan-phase") calls stopped working. This fix reverts Claude to the flat layout (~/.claude/skills/gsd-<name>/SKILL.md) so all ~61 concrete skills are top-level and immediately discoverable. The 6 other runtimes that confirmed non-recursive scanning (cline, qwen, hermes, augment, trae, antigravity) retain their nested layout. (#924) (#924)
gsd-context-monitor.js now echoes the actual invoking hook event name — instead of hardcoding hookEventName: "PostToolUse" (or "AfterTool" for Gemini), the hook reads data.hook_event_name from the stdin payload and falls back to the runtime heuristic only when the field is absent or blank; this fixes Claude Code rejecting hook output with "expected Stop but got PostToolUse" when the monitor is invoked by the Stop, SubagentStop, or PreCompact hooks registered in PR #821. (#925) (#926)
Fix --reapply verifier false-positives on post-#604-rename installs caused by two gaps in pristine-baseline handling:

Gap 1 (verify-reapply-patches.cjs): when backup-meta.json records a pristine_hash for a file but gsd-pristine/ has no corresponding snapshot on disk, the verifier fell to over-broad mode (every upstream-changed line treated as a user-added requirement) and produced FAIL_USER_LINES_MISSING false positives. Fix: return advisory OK_NO_BASELINE reason (non-blocking, exit 0) when a recorded hash is present but the pristine file is absent — the verifier cannot reason correctly without a baseline and must not block.

Gap 2 (new migration 004-prune-stale-pristine-get-shit-done): migration 003 removed legacy get-shit-done/ runtime files but left gsd-pristine/get-shit-done/ orphan snapshots in place. Those stale snapshots referenced get-shit-done/... key paths that no longer match the active gsd-core/... layout, contributing to FAIL_INSTALLED_MISSING false reports. Fix: add a new migration (not editing 003, to preserve its checksum) that removes all files under gsd-pristine/get-shit-done/. (#934) (#935)

/gsd-update changelog preview no longer silently fails — the installer now copies scripts/changeset/ and scripts/lib/ into the runtime config dir so $GSD_DIR/scripts/changeset/cli.cjs resolves at runtime; update.md was updated to use the correct installed path and to surface an explicit error if the CLI is missing rather than swallowing it. (#935)
plan-review-convergence now runs gsd-plan-phase inline instead of inside Agent() — both sites that previously wrapped gsd-plan-phase in Agent() (initial planning + replan loop) have been changed to bare Skill() calls at depth 0. On Claude Code, a depth-1 Agent has no Agent tool, so a wrapped plan-phase could never spawn gsd-planner or gsd-plan-checker — the replan loop silently failed to produce a revised plan whenever HIGH concerns were found. Running plan-phase inline from the depth-0 orchestrator (which retains the Agent tool) restores the full planner→checker sub-agent chain. A new structural guard test (bug-936-no-nested-spawner-wrap.test.cjs) statically scans all workflow files and fails if any workflow wraps a spawner orchestrator in Agent() without a RUNTIME != claude carve-out, preventing regression. (#936) (#939)
--json-errors now emits a structured error even when a handler throws unexpectedly — an unexpected (non-ExitError) throw fell through to a raw stack trace on stderr, breaking SDK structured-error parsing. (#965) (#987)
verify key-links docs now correctly state from:/to: are relative file paths — the reference implied component/endpoint values the verifier never supported, so locator-style links failed with a misleading 'Source file not found' and the author's pattern: was never evaluated. (#967) (#990)
Fixed a test-infrastructure regression (#996) where bug-969 hardening tests deleted the shared gsd-core/bin/lib/core.cjs during concurrent runs and the build tsbuildinfo lived inside the copied install tree, intermittently failing CI with MODULE_NOT_FOUND/ENOENT. The destructive tests now run hermetically against a temp project, and the tsbuildinfo moved out of gsd-core/bin/. (#969) (#1002)
gsd-planner now ships the Edit tool, so it can no longer destroy ROADMAP.md via a whole-file Write — the planner had Write but not Edit (the #571/#581 writer-agent gap), so an in-place ROADMAP edit fell back to a full overwrite that truncated committed milestone history. The update_roadmap step now directs scoped Edit calls and explicitly forbids passing the full file to Write. (#973) (#989)
graphify query --budget with no value now errors instead of silently ignoring the budget — a trailing --budget parsed as NaN and was treated as 'no budget', so the query ran unbounded with no warning. (#974) (#986)
The installer now resolves a stable fnm node path instead of the ephemeral multishell shim on Windows — managed .js hooks were pinned to fnm_multishells/<id>/node.exe, a per-shell-session path fnm later deletes, breaking every managed hook until reinstall. (#977) (#992)
gsd-tools milestone complete --force now actually overrides the unstarted-phase guard — the dispatcher never parsed --force, so the guard's own documented escape hatch was inert. (#978) (#982)

Trae and Windsurf installs no longer leak unreplaced ~/.claude / $HOME/.claude paths — both converters only rewrote trailing-slash .claude/ forms, so bare home-path references survived conversion and pointed users at the wrong config dir; bare forms are now rewritten (Codex/Cline #570/#782 parity) and CLAUDE_CONFIG_DIR maps to the runtime's own var, with .claude-plugin preserved. (#983) (#995)

Claude Code plugin installs no longer fail with empty @~/.claude/gsd-core/... includes — agents, commands, and templates @-include the canonical ~/.claude/gsd-core/ path, but a marketplace plugin install (claude plugin install) never creates that directory, so every include resolved to nothing and agents (e.g. the executor) failed. A new SessionStart hook (gsd-ensure-canonical-path.js) symlinks the canonical path's immutable subdirs (bin, contexts, references, templates, workflows) to the plugin's bundled tree. It is a no-op in classic bin/install.js installs, preserves user-generated files (e.g. USER-PROFILE.md), prunes stale links so it self-heals after claude plugin update, and uses Windows junctions. (#1207) (#1207)
/gsd-code-review, /gsd-code-review --fix, and /gsd-eval-review now inject configured agent_skills into their subagents — these review-family workflows previously spawned their reviewer/fixer/auditor agents (including the --auto re-review/re-fix loops) without the project-configured skill and rule context, so any agent_skills set for gsd-code-reviewer, gsd-code-fixer, or gsd-eval-auditor were silently ignored. They now query and inject those skills like the ~20 sibling workflows. (#1005)
phase complete no longer rewrites an existing roadmap completion date — repeat runs on an already-Complete phase preserve the recorded YYYY-MM-DD date (4- and 5-column layouts); empty/-/non-date cells are still stamped with the current date. (#1177)
Legacy ROADMAP projects no longer get deprecation-warning spam — the free-form ROADMAP warning fired on every command regardless of phase_id_convention; it now only warns when the milestone-prefixed convention is explicitly set and unmet. (#1218) (#1218)
Forking workflows target wrong base branch on master repos when origin/HEAD is unset — execute-phase, quick, ship, complete-milestone, and pr-branch detection bash fell through to a hardcoded main fallback whenever origin/HEAD was absent (common in git init + remote add + fetch without set-head, CI checkouts, and worktrees), causing GSD to fork phase branches off a non-existent main on master repos. Replaced with a single gsd_run query git.base-branch resolver that walks the full precedence ladder: config override → origin/HEAD symref → git remote show origin → local branch presence → "main". (#1198) (#1198)
query user-story.validate now works — mvp-phase and verify-work workflows both invoked this command to validate "As a / I want to / so that" user stories, but no CJS handler existed; every call errored with "Unknown command: user-story". (#1193) (#1193)
Context meter no longer sticks at 100% — the statusline reserved-buffer math was inverted, pinning usage at 100% whenever CLAUDE_CODE_AUTO_COMPACT_WINDOW equalled the total window. (#1194) (#1211)
Roadmapper honors phase_id_convention — new-project roadmaps now use milestone-prefixed phase IDs when phase_id_convention is set, instead of ignoring the default. (#1205) (#1215)

phase complete no longer emits false warnings from historical verification metadata or deferred requirement IDs — two distinct false-positive warning bugs: (A) the verification-status check used a full-text regex that matched previous_status: gaps_found in the file body, triggering an "unresolved gaps" warning even when the current frontmatter status: passed; the check now reads only the frontmatter status key via extractFrontmatter. (B) requirement IDs under explicitly deferred/backlog/future/v2 section headings in REQUIREMENTS.md were flagged as missing from the Traceability table; the check now skips any section whose heading matches those terms. (#1197) (#1197)

verify key-links no longer fails on planned future files — a from: link whose file is declared in a current/upcoming wave plan’s files_modified is now reported pending instead of a hard missing-file failure. (#1202) (#1219)
state patch and state record-session no longer corrupt STATE.md — a no-match patch no longer rewrites the file (was resetting milestone_name and resurrecting a stale stopped_at), and record-session now persists --stopped-at/--resume-file even when the body lacks the exact labels. (#952)
/gsd-update no longer flags managed-hooks-registry.cjs as a custom file — the shipped hook is now recorded in the file manifest, eliminating a perpetual false-positive custom-file warning. (#953)
gsd-tools no longer throws EAGAIN or truncates output under heavy load — the CLI's stdout/stderr writes now retry the transient EAGAIN/EINTR errnos and handle short writes when the output stream is a full non-blocking pipe (e.g. the parallel test runner), instead of throwing or silently dropping bytes. (#1009)
Quick worktree execution now accepts parent-or-plan bases for pre-dispatch plan commits — quick mode records the parent and plan commit around the pre-dispatch PLAN.md commit, lets the worktree guard accept either approved base, materializes the plan from git objects when a runtime forks from the parent, and teaches cleanup to validate the same allowed-base set. (#1265) (#1347)
phase add no longer reuses an existing phase number when that phase exists only as a roadmap bullet — the next-number scan now counts phases listed only as - [ ] **Phase N: ...** bullets (all checkbox variants, with or without a title), in addition to ### Phase N: section headers and on-disk phase directories, so a bullet-only phase is no longer shadowed and phase add appends after the highest used number. (#1249)
Preserve curated STATE.md progress frontmatter when state patch updates non-progress fields, while still allowing progress-related fields to resync from disk-derived project state. (#1345)
The installer no longer re-adds a duplicate managed hook when the user registered it in command+args (wrapped) form — the presence checks only inspected h.command, so an args-form wrapper (a common Windows windowless-launcher mitigation) was invisible and a stock entry was appended on every install/update, running the hook twice. (#976) (#994)
cmdSkillManifest now discovers concrete skills nested under gsd-ns-* routers (<root>/gsd-ns-<router>/skills/<stem>/SKILL.md), so gsd-health and gsd-settings report the correct count on nested-layout runtimes (cline, qwen, hermes, augment, trae, antigravity). The scan is scoped to gsd-ns-* router dirs only — unrelated user dirs that happen to have a skills/ subdirectory are not traversed. Dual-routed concretes (same skill installed under two routers) are deduped by name within each root. (#929) (#929)
state record-session no longer pins a CPU core forever — acquireStateLock busy-spun at 100% CPU when a recoverable errno (e.g. ENOENT from a removed worktree) persisted, because that retry path skipped the backoff sleep and the 30s time budget. Every retry path is now bounded and backed off. (#1236) (#1236)
/gsd-manager and /gsd-autonomous --interactive no longer silently skip worktree isolation and independent verification on Claude Code. They dispatched plan/execute as background agents, but a backgrounded Claude Code agent has no Agent/Task tool and cannot spawn the nested executors, plan-checker, or verifier — so isolation and verification silently never ran. Both workflows now resolve the runtime and run plan/execute inline on Claude Code; background dispatch is kept on runtimes that support nested subagents. (#863)
Researcher agents can now invoke Perplexity — gsd-phase-researcher and gsd-project-researcher referenced mcp__perplexity__* in their provider dispatch tables but never granted it in their tools: allowlist, so Perplexity web research silently fell through to the next provider. The grant is now generated from the researcher profiles, with a parity guard that fails if a future dispatch-table provider is added without its tool grant. (#1284) (#1288)
Init phase lookups now resolve active phases whose canonical details live in a flat Phase Details block outside the current milestone summary, restoring requirement coverage for plan/execute/phase-op flows. (#1344)
Installer no longer leaks gsd-cmd-rewrites-* temp directories. Each install that emitted slash commands left one fs.mkdtempSync directory under the system temp root; on tmpfs /tmp hosts these accumulated and consumed RAM-backed storage. installRuntimeArtifacts() now removes the temp copy in a finally once command files are copied. (#862)
validate agents (and validate health) now cross-reference the install manifest to detect manifest-backed Codex agent pair drift: when a generated agents/gsd-*.md / agents/gsd-*.toml pair has one side missing on disk, the agent is reported as incomplete and agents_found is false (previously a false-healthy agents_found: true, missing: []). validate health names the incomplete agents and recommends re-running the installer. The check no-ops when no manifest is present. (#1058) (#1079)
The map-codebase and docs-update workflows no longer collect background sub-agent results with the deprecated Claude Code TaskOutput tool — they keep run_in_background=true on the spawn and Read each agent's outputFile (from the async_launched result) once it reports completion, removing the TaskOutput(block=true) main-session hang surface (anthropics/claude-code#20236). Completion-marker contracts and on-disk verification are unchanged, and the non-Claude runtime fallbacks are preserved. (#1362)
model_policy is now honored on the default claude runtime — including the anthropic-fable Claude Fable 5 preset. Policy-resolved model IDs map to Claude Code agent aliases (e.g. claude-fable-5 → fable), and IDs without a Claude alias warn and fall back to the configured tier. Forward-port of #1133 (originally shipped on the 1.4.5 hotfix line). (#1133) (#1133)
/gsd-plan-review-convergence now blocks on actionable review findings outside PLAN.md (#724). The convergence summary contract includes current_actionable alongside current_high, and reviews-mode planning/checking requires actionable MEDIUM/LOW feedback to be incorporated or explicitly deferred in executable PLAN.md content. (#728)
Config docs/prompts now match the consumers — workflow.subagent_timeout is documented in milliseconds (default 300000), not "seconds (default 600)" (a user who entered 600 got a 600 ms timeout); review.models.<cli> is documented as a bare model id injected into --model/-m, not a shell command; and workflow.test_command / workflow.build_command (consumed by verify-phase, execute-phase, audit-fix, and the post-merge gate) are now accepted by config set and documented. (#1296) (#1299)
changeset new --pr 0 now accepted at creation — the required-field guard treated the integer 0 as a missing --pr flag, so the documented pr: 0 placeholder could not be authored via the CLI. (#1231) (#1231)
$gsd-quick Codex adapter no longer assumes typed spawn_agent(agent_type=...) — documents that typed planner/executor spawning needs the agent_type-capable Codex schema and provides a clearly-labeled generic-subagent fallback when only multi_agent_v1 is exposed. (#958)
state update and roadmap update-plan-progress now handle current Markdown artifact shapes — state field read/replace works on table-format STATE.md (| Status | … |), and roadmap update-plan-progress inserts missing per-plan checklist rows (filling partial gaps), tolerates Plans:/**Plans:**/**Plans**:, and scopes changes to the active milestone. (#1172)
state planned-phase now advances the Status field when the prior phase left a Complete ✓ (checkmark) or bare Complete terminal status. Previously such a status matched no known template default, so the transition was silently skipped and the state machine stayed stuck on the prior phase. Caveat-bearing statuses (e.g. Complete but needs manual QA) remain preserved. (#1070) (#1078)
state.* writes no longer silently revert the STATE.md frontmatter status/stopped_at — an incidental write (e.g. state record-session) that doesn't change the body's Status:/Stopped at: source field now preserves the existing frontmatter value instead of re-deriving it from possibly-stale body text. Legitimate transitions (e.g. begin-phase/complete-phase, which do update the body Status) still re-derive normally, so a verified-complete phase can no longer be flipped back to verifying by an unrelated write. (#1252)
audit-open no longer false-flags completed quick tasks — quick-task SUMMARYs now carry status: complete in frontmatter by construction, so the milestone-close auditor stops reporting finished quick tasks as [unknown]. (#951)
Workspace (local) Antigravity and Copilot skill installs no longer point at the global config home — a local install rewrote ~/.claude/ references in SKILL.md bodies to the global ~/.gemini/antigravity/ / ~/.copilot/ paths instead of the workspace-relative .agent/ / .github/, because the skills layout wrapper passed the runtime name into the converter's isGlobal parameter slot. (#1092) (#1092)
Fix the workflow gsd_run launcher being unreachable in later bash blocks on runtimes that run each fenced block in a fresh shell (e.g. Claude Code): ship a standalone gsd-core/bin/gsd_run executable and have the per-file preamble persist the launcher's bin dir onto PATH via CLAUDE_ENV_FILE, with the inline function definition kept as the fallback for all other runtimes. (#1084)
/gsd:phase insert and /gsd:phase --edit no longer dead-end recording Roadmap Evolution — query state.add-roadmap-evolution was rejected as "SDK-only" with an error that pointed back at the very command that just failed, and no CJS handler existed after the SDK retirement. The handler is now implemented in CJS, so the insert/edit phase workflows append the ### Roadmap Evolution entry under ## Accumulated Context (creating the subsection if missing, deduping identical entries) as documented. (#1148) (#1148)
Corrected the installer --help profile skill counts: core now shows 8 (was 7) and standard shows 14 (was 13), both derived from PROFILES so they can't drift again; the full line drops the stale hardcoded 66 for all skills. (#834) (#847)
Codex-installed GSD skills and agents no longer rely on a bare gsd-tools executable — generated Codex surfaces now call the bundled shim, and workflow launchers can resolve the Codex shim-only install path. (#731)

Wire the discuss loop step for capability hooks — capabilities can now register discuss:pre/discuss:post hooks (e.g. discuss-time context recall and CONTEXT capture); previously discuss was contract-declared but structurally unwireable. Also collapses the host-loop file set to a single source of truth and adds an authoring-time guard rejecting hooks at unwired extension points. (#1199) (#1199)

/gsd-autonomous --converge now routes phase planning through plan-review convergence instead of silently ignoring the flag. (#711) (#729)
Hermes skills now install at skills/gsd/gsd-/SKILL.md with name gsd-, restoring canonical /gsd- dispatch that was broken by the bare-stem prefix introduced in #3664. (#955)

[1.4.5] - 2026-06-12

Fixed

model_policy is now honored on the default claude runtime — including the anthropic-fable Claude Fable 5 preset. Policy-resolved model IDs map to Claude Code agent aliases (e.g. claude-fable-5 → fable), and IDs without a Claude alias warn and fall back to the configured tier. Previously the entire model_policy block was silently ignored on claude. (#1133) (#1133)

[1.4.4] - 2026-06-11

Changed

Added an opt-in anthropic-fable model policy provider preset for Claude Fable 5 high-budget routing while preserving the existing Anthropic Opus 4.8 defaults and anthropic provider preset. (#1014) (#1015)

[1.4.3] - 2026-06-09

Fixed

Fix --reapply verifier false-positives on post-#604-rename installs caused by two gaps in pristine-baseline handling:

Gap 2 (new migration 004-prune-stale-pristine-snapshots): migration 003 removed legacy get-shit-done/ runtime files but left gsd-pristine/get-shit-done/ orphan snapshots in place. Those stale snapshots referenced get-shit-done/... key paths that no longer match the active gsd-core/... layout, contributing to FAIL_INSTALLED_MISSING false reports. Fix: add a new migration (not editing 003, to preserve its checksum) that removes all files under gsd-pristine/get-shit-done/. (#934) (#937)

/gsd-update changelog preview no longer silently fails — the installer now copies scripts/changeset/ and scripts/lib/ into the runtime config dir so $GSD_DIR/scripts/changeset/cli.cjs resolves at runtime; update.md was updated to use the correct installed path and to surface an explicit error if the CLI is missing rather than swallowing it. (#938)
plan-review-convergence now runs gsd-plan-phase inline instead of inside Agent() — both sites that previously wrapped gsd-plan-phase in Agent() (initial planning + replan loop) have been changed to bare Skill() calls at depth 0. On Claude Code, a depth-1 Agent has no Agent tool, so a wrapped plan-phase could never spawn gsd-planner or gsd-plan-checker — the replan loop silently failed to produce a revised plan whenever HIGH concerns were found. Running plan-phase inline from the depth-0 orchestrator (which retains the Agent tool) restores the full planner→checker sub-agent chain. A new structural guard test (bug-936-no-nested-spawner-wrap.test.cjs) statically scans all workflow files and fails if any workflow wraps a spawner orchestrator in Agent() without a RUNTIME != claude carve-out, preventing regression. (#936) (#939)

[1.4.2] - 2026-06-09

Fixed

/gsd-plan-phase, /gsd-execute-phase, /gsd-autonomous no longer carry context: fork — these are spawning orchestrators; a forked subagent context has no Agent tool, preventing them from spawning the subagents they require. effort: xhigh is preserved. Fixes /gsd:autonomous halting with "running as a forked subagent" on 1.4.1 (#921). Also replaces the introspection-based Agent-availability check in plan-phase's <runtime_compatibility> block with an attempt-based gate: the workflow now always attempts the Agent() call and only stops if a real tool-unavailable error is returned, eliminating false-negative aborts in top-level sessions (#922). (#921)
gsd-context-monitor.js now echoes the actual invoking hook event name — instead of hardcoding hookEventName: "PostToolUse" (or "AfterTool" for Gemini), the hook reads data.hook_event_name from the stdin payload and falls back to the runtime heuristic only when the field is absent or blank; this fixes Claude Code rejecting hook output with "expected Stop but got PostToolUse" when the monitor is invoked by the Stop, SubagentStop, or PreCompact hooks registered in PR #821. (#925) (#926)

[1.4.1] - 2026-06-09

Changed

Added no-drift guard tests (tests/issue-57-runtime-install-no-drift.test.cjs) that protect the Runtime Install Policy Module boundary (ADR-58) and the explicit Runtime Config Adapter Registry (#60). They fail loudly when supported-runtime metadata is added to an installer call site (allRuntimes, the interactive runtimeMap menu) without a matching registry adapter entry, or when config-mutation dispatch escapes the registry's declared install surfaces — catching reintroduction of the scattered per-runtime branching those seams removed. (#867)

Fixed

profile-pipeline temp output now lands under the reaped GSD temp root. cmdExtractMessages and cmdProfileSample previously created their output directories directly in os.tmpdir() root (gsd-pipeline-* / gsd-profile-*), which reapStaleTempFiles never scans (it only scans GSD_TEMP_DIR = os.tmpdir()/gsd). The directories accumulated forever. Both sites now call ensureGsdTempDir() and create under GSD_TEMP_DIR. Also adds missing after/afterEach teardown to four test fixtures that leaked gsd-* temp dirs on every npm test run. (#866) (#879)
gsd_run launcher shim now probes all non-Claude runtime homes before failing. The shim's last-resort detection previously stopped at $HOME/.claude, causing a false-positive fatal error on every non-Claude runtime (Hermes, Cursor, Codex, Copilot, Windsurf, Augment, Trae, Qwen, CodeBuddy, Cline, Grok, Antigravity, OpenCode, Kilo) when RUNTIME_DIR was unset and gsd-tools was not on PATH. The snippet now probes each runtime's config directory (respecting HERMES_HOME, CURSOR_CONFIG_DIR, CODEX_HOME, etc. with sensible $HOME-relative defaults) before emitting the install error. (#903)
validate health and validate consistency no longer emit false-positive W007 warnings for projects using checklist-style ROADMAP.md phases. buildRoadmapPhaseVariants() in src/validate.cts previously used only a heading-style regex (## Phase N: name), silently ignoring the supported checklist format (- [x] **Phase N: name**). This caused every on-disk phase directory to trigger W007 ("exists on disk but not in ROADMAP.md") when the project's ROADMAP used checklist-only notation. The fix adds a second regex pass mirroring the existing buildNotStartedPhaseVariants() approach. Additionally, cmdValidateConsistency() in src/verify.cts had a duplicate inline heading-only regex with the same gap — refactored to delegate to buildRoadmapPhaseVariants() (DRY). (#892) (#893)
init execute-phase and cmdCommit now produce correct branch_name when project_code is set — the {phase} substitution in phase_branch_template now calls normalizePhaseName(), stripping the project-code prefix and zero-padding the number, so the generated branch is e.g. gsd/phase-01-foundation instead of gsd/phase-CK-01-foundation. Both the execute-phase output path (src/init.cts) and the pre-execution commit path (src/commands.cts) are fixed. (#904) (#904)
syncStateFrontmatter no longer strips current_phase, current_phase_name, current_plan, and progress from STATE.md — when body annotations are absent (e.g. after an agent rewrites the body), the existing frontmatter values for those scalars are now preserved, mirroring the fallback already applied in cmdStateJson. (#905) (#905)
Top-level Claude Code /gsd-plan-phase now always spawns the researcher/planner/plan-checker agents instead of collapsing them inline — a <runtime_compatibility> block after </available_agent_types> makes the Agent-availability requirement explicit and documents that the workflow fails-closed (stops with a clear log message) in genuinely Agent-less contexts; seven "ORCHESTRATOR RULE — CODEX RUNTIME" labels are renamed to "ALL RUNTIMES" so the guard applies universally; execute-phase.md scopes its existing "Other runtimes" inline-fallback prose to non-Claude contexts, preserving the #853 backgrounded-agent behaviour. (#913) (#913)
/gsd-manager and /gsd-autonomous --interactive no longer silently skip worktree isolation and independent verification on Claude Code. They dispatched plan/execute as background agents, but a backgrounded Claude Code agent has no Agent/Task tool and cannot spawn the nested executors, plan-checker, or verifier — so isolation and verification silently never ran. Both workflows now resolve the runtime and run plan/execute inline on Claude Code; background dispatch is kept on runtimes that support nested subagents. (#863)
Installer no longer leaks gsd-cmd-rewrites-* temp directories. Each install that emitted slash commands left one fs.mkdtempSync directory under the system temp root; on tmpfs /tmp hosts these accumulated and consumed RAM-backed storage. installRuntimeArtifacts() now removes the temp copy in a finally once command files are copied. (#862)
Corrected the installer --help profile skill counts: core now shows 8 (was 7) and standard shows 14 (was 13), both derived from PROFILES so they can't drift again; the full line drops the stale hardcoded 66 for all skills. (#834) (#847)

[1.4.0] - 2026-06-08

Added

Research is now cached, curated-first, and code-governed — a content-addressed Research Store (per-source TTL), a single provider waterfall with confidence tiers, and registry-API package legitimacy replace the per-agent prose waterfall and the slopcheck bolt-on. (#664) Confidence is now verification-evidence-driven: provider identity alone no longer yields HIGH; HIGH requires ground-truth corroboration (e.g. legitimacyVerdict: 'OK'), authority alone caps at MEDIUM, and SLOP caps at LOW. (#664)
/gsd:plan-phase now accepts a --granularity <coarse|standard|fine> flag to override the configured planning granularity for a single invocation. The flag takes precedence over granularities.planning, top-level granularity, and planning.granularity config. Invalid values are rejected. (#703) (#750)
gsd-core can now be installed as a native Claude Code plugin — a new .claude-plugin/plugin.json manifest enables installing gsd-core via claude plugin install or the zero-friction ~/.claude/skills/ auto-load path (gsd-core@skills-dir), with slash commands auto-namespaced as /gsd-core:<command> (e.g. /gsd-core:plan-phase) and lifecycle management via claude plugin enable|disable|update. gsd-core's always-on guard and update hooks are wired for the plugin path through hooks/hooks.json using ${CLAUDE_PLUGIN_ROOT}. This is additive — the existing npm / file-copy installer is unchanged. (#797)
Installer pre-populates permissions.allow/deny for Claude Code — fresh Claude Code installs now receive GSD's known-safe tool-call patterns (Bash(npx gsd-core *), Read(.planning/*), Write(.planning/*), Read(STATE.md), Write(STATE.md)) in settings.json out of the box, eliminating first-run approval prompts. A deny block for credential files (Read(.env), Read(.env.*), Read(.secrets)) is also added for defense-in-depth. The merge is additive and idempotent; existing user-set entries are preserved. Uninstall removes only GSD-owned entries. (#768) (#819)

Added: register newly-available Claude Code lifecycle hooks — SubagentStop, Stop, PreCompact (all wired to gsd-context-monitor for context-headroom warnings), and FileChanged (matcher: config.json, wired to new gsd-config-reload.js hook that hot-reloads .planning/config.json context mid-session). Also updates hooks/hooks.json (plugin manifest) and managed-hooks-registry for drift-guard coverage (#770). (#821)

Gemini installs now register three additional hook events — BeforeAgent, AfterAgent, and BeforeModel — wired to gsd-context-monitor.js for per-turn context headroom tracking. Previously only SessionStart, BeforeTool, and AfterTool were registered. The installer also detects hooksConfig.enabled: false in the user's Gemini settings.json and emits a clear warning, surfacing the silent failure mode where all hooks are registered but never execute. (#776) (#829)
Cross-runtime command enrichment in the installer. Gemini CLI commands now use native {{args}} interpolation (translated from Claude's $ARGUMENTS) so typed arguments interpolate into the prompt body, and /gsd:progress injects live project state via a fixed, injection-safe !{cat .planning/STATE.md 2>/dev/null} shell block. Qwen Code skills now carry a numeric priority field so the most-used main-loop workflows (new-project, plan-phase, execute-phase, …) surface first in the /skills list. The OpenCode per-command model/agent/subtask enrichment was evaluated and intentionally not implemented — model would reintroduce the ProviderModelNotFoundError regression that the converter deliberately guards against for non-Anthropic providers (#1156), subtask/agent change execution semantics for GSD's interactive commands, and variant is not in the OpenCode command schema. (#778) (#825)
Emit native on-demand skills (skills/<name>/SKILL.md) for the OpenCode-family runtimes (OpenCode and Kilo) at install time, in addition to the existing flat command/ and file-based agents/ surfaces. OpenCode and Kilo share a config schema and both discover skills from skills/<name>/SKILL.md; the installer now stages each GSD command as a skill with minimal, spec-compliant frontmatter (name matching the directory, description 1–1024 chars) via a shared OpenCode-family skill writer. Skills respect the active install profile (core/minimal stage only their subset) and are removed on uninstall. (#784) (#810)
gsd install --cursor now writes .cursor/commands/gsd-<name>.md in addition to the existing .cursor/skills/ surface. Cursor 1.6 introduced plain-markdown slash commands (no frontmatter) in .cursor/commands/; they appear in the / menu in the Agent input. Each command file is generated from the same source as the skill but with frontmatter stripped and Cursor-specific content transforms applied (convertClaudeCommandToCursorCommand). The skills surface is unchanged — both surfaces are written on every install. (#803)
The GitHub Copilot installer now reaches lifecycle-hook and instruction parity with other first-class runtimes. It emits a self-contained sessionStart hook config (.github/hooks/gsd-session.json for local installs, ~/.copilot/hooks/gsd-session.json for global) and writes AGENTS.md at the repository root (which Copilot CLI reads as primary instructions) alongside copilot-instructions.md. The hook is an inline command hook with no separate script file, so it cannot dangle. Both artifacts are removed — with user-authored content preserved — on --uninstall. (#786) (#804)
Elevate the Cline runtime to hook parity. The installer now emits the Cline .clinerules/ directory form (.clinerules/gsd.md) instead of a single .clinerules file, adds a .clinerules/hooks/PreToolUse lifecycle hook (Cline v3.36+ JSON stdin → {cancel,errorMessage,contextModification} protocol; guards .planning/ artifacts and fails open), and merges GSD instructions into the cross-tool global ~/.agents/AGENTS.md target on global installs. A legacy single-file .clinerules is migrated to the directory form in place, and --uninstall removes the new artifacts and strips the GSD block from ~/.agents/AGENTS.md. (#787) (#803)
Qwen Code installs now register three additional hook events that Qwen Code supports beyond Claude Code: SubagentStop, Stop, and PreCompact — all wired to gsd-context-monitor.js for context headroom tracking at subagent completion, model stop, and pre-compaction. These events are Qwen-only; Claude Code installs are unchanged. UserPromptSubmit is deferred: gsd-prompt-guard exits unless tool_name is Write|Edit, making it a no-op for that payload shape. (#788) (#807)
CodeBuddy (Tencent) installs now emit /gsd-* slash commands. A --codebuddy install writes commands/gsd-<name>.md files to ~/.codebuddy/commands/ so GSD workflows are invokable from CodeBuddy's / menu (/gsd-phase, /gsd-ship, etc.), matching the integration depth of other fully-elevated runtimes (#789). The existing skills/gsd-<name>/SKILL.md files are now emitted with user-invocable: false so they stay out of the / menu — the commands surface is the single / entry point (no duplicate entries) and skills remain available for model invocation. Subagents (~/.codebuddy/agents/) were already emitted and are unchanged. Uninstall removes the gsd-* command files while preserving user-owned commands. No mcp.json is written — gsd ships no MCP server and CodeBuddy's mcp.json only registers external MCP servers.

(#830)

Augment installs now emit slash command definitions alongside skills. A global --augment install writes commands/gsd-<name>.md files to ~/.augment/commands/ in addition to the existing skills/gsd-<name>/SKILL.md files, matching the integration depth of other fully-elevated runtimes and allowing Auggie users to invoke GSD as slash commands (/gsd-phase, /gsd-ship, etc.) without manual configuration (#790). Content rewrites (path normalisation and Augment-specific branding) are applied at install time. Uninstall removes the gsd-* command files while preserving user-owned commands. mcpServers registration is explicitly excluded — gsd ships no MCP server and does not register third-party servers. (#801)
Issues are now checked for duplicates when opened: a no-LLM title-similarity check posts a challenge comment and applies a possible-duplicate label when a new issue closely matches existing open ones. Flagged issues that go unanswered for 24h are auto-closed as duplicates (reply, or react 👎 to the bot comment, to keep one open); a reply clears the label and routes to needs-maintainer-review. (#836) (#843)
Cursor now receives GSD lifecycle hooks via .cursor/hooks.json — a sessionStart hook injects the current workflow state as context at session start, and a postToolUse hook nudges the agent to update .planning/ after write-class operations, bringing Cursor to baseline hook parity with Gemini and Claude Code. (#777)
Gemini CLI extension package — gsd-core now ships a gemini-extension.json manifest (plus a GEMINI.md context payload) at the repository root, so Gemini CLI users can install, update, and remove GSD through Gemini's own extension lifecycle: gemini extensions install https://github.com/open-gsd/gsd-core, gemini extensions update gsd-core, gemini extensions uninstall gsd-core, and gemini extensions link <path> for local dev. The extension is discoverable in gemini extensions list and loads GSD's operating context into every session. Additive — the existing npx gsd-core --gemini installer (which provides the /gsd:* slash commands) is unchanged. (#775) (#775)
New agent_skills_security.trusted_global_roots config — opt-in allowlist of trusted root directories so symlinked global: agent skills whose real path resolves outside the default skills dir (e.g. ~/.claude/skills) are accepted; default [] is byte-identical and preserves the symlink-escape guard. (#754)
Added /gsd-update --next (alias --rc) to install or refresh from the @next RC dist-tag (ADR #660). A new parse_update_channel workflow step resolves the channel from $ARGUMENTS; the version check and all three npx install invocations thread $TAG instead of hardcoding @latest. When --next is used the version-comparison output gains a Channel: next (RC) banner so the user knows they are leaving the stable line; omitting the flag keeps @latest behavior byte-for-byte unchanged. check-latest-version.cjs gains ALLOWED_TAGS, buildViewArgs, and resolveTag exports, with an allowlist guard (enforced at both the CLI and function boundary) that rejects any dist-tag other than latest/next. (#815) (#839)

Changed

/gsd:plan-phase --research-phase <N> now auto-uses an existing RESEARCH.md instead of prompting update/view/skip. When research already exists and neither --research nor --view is passed, it emits a one-line notice and exits cleanly, matching the promptless behavior of standard /gsd:plan-phase <N>. Pass --research to force-refresh or --view to print the existing research. (#159) (#718)
Retire the installer's one-off runtime directory helpers (getGlobalDir/getOpencodeGlobalDir/getKiloGlobalDir) and consolidate per-runtime global config-dir resolution onto the single canonical projection runtime-homes:getGlobalConfigDir, extended with the --config-dir override and the opencode/kilo *_CONFIG file-path precedence. Behavior-preserving across all 15 install runtimes. (#56) (#802)
Make per-runtime config-mutation dispatch in the installer explicit: a new runtime config adapter registry maps each supported runtime to a typed config intent (install surface, shared-settings gate, finish-phase permission writer), and install()/finishInstall() dispatch by resolved intent instead of inline runtime === '...' branching. Behavior-preserving; unknown runtimes now fail loudly. (#60) (#795)
Verification status routing is now owned by a single queryable seam — ship.md and execute-phase.md both consume gsd_run query verification.status instead of re-deriving the passed/gaps_found/human_needed routing independently; the query returns next_action and next_command so per-status prose no longer needs to be kept in sync across files. This also fixes the broad-grep status misread in execute-phase.md where a body status: line (in a code block or copied artifact) could concatenate with the frontmatter value and misroute a valid passed phase; a parity test fails if a new verifier status value lacks a route. (#651) (#755)
Agent color: frontmatter now uses Claude Code's documented named colors (red/blue/green/yellow/purple/orange/pink/cyan) instead of hex values or the undocumented magenta, so the intended per-agent TUI color differentiation renders reliably across the Claude Code runtime. Display-only metadata; no behavior change. (#771) (#823)
Codex installs now register three additional stable hook events (SubagentStart, Stop, PostToolUse) wired to gsd-context-monitor.js, matching the full event coverage available since Codex CLI stabilised these hooks. The SessionStart hook entry gains a commandWindows field on Windows installs so the .cmd shim is used for native execution (Git Bash/MSYS cannot POSIX-exec node.exe directly). Both new-event registration and uninstall paths handle the flat { "EventName": [...] } and nested { "hooks": { "EventName": [...] } } hooks.json shapes. gsd-context-monitor.js and its Windows .cmd sibling are added to the managed-hook allowlist so idempotent re-runs de-duplicate entries correctly. (#772) (#827)
Codex CLI installs now emit two enrichments per agent and skill. Agent TOML enrichment: light-tier agents (haiku-equivalent, routingTier: "light" in model-catalog.json) get service_tier = "flex" and model_verbosity = "low" appended to their agent TOML, telling the Codex scheduler to use the flex tier (lower cost, background processing) and suppress verbose token output. Skill TUI chip: each installed gsd-* skill directory now receives an agents/openai.yaml file with interface.display_name and interface.short_description, making the skill appear in the Codex /skills picker with a human-readable name and description drawn from the skill's existing short-description frontmatter. Both enrichments are additive and backward-compatible with Codex CLI ≥ 0.130.0. (#774) (#828)
Cline global installs now emit skills, not just rules: gsd writes skills to ~/.cline/skills/<name>/SKILL.md for Cline ≥ v3.48.0 (see Cline skills docs), in addition to the existing .clinerules file. Each SKILL.md carries name/description frontmatter (agentskills.io) with paths rewritten to the .cline/ convention. Local installs remain .clinerules-only. The .clinerules rules file continues to be emitted for compatibility, and upgrading over an existing rules-only install emits the new skills on the next run. (#809)
Workflow size budget now measures bytes, not lines (#717). tests/workflow-size-budget.test.cjs re-bases its tier ceilings (XL/LARGE/DEFAULT) from line counts to byte counts — deterministic, no tokenizer, and matching the unit vendors bound on (Codex's 32,768-byte project_doc_max_bytes cap). The #597 tighten-only ratchet and per-file semantics are unchanged; the budget's caching-independent quality rationale (context rot / attention budget) is now documented. (#719)
The gsd-verifier agent no longer re-runs the full workspace test suite once per must-have during Step 7b spot-checks — it enumerates tests to prove existence and runs a single named test to prove a pass, invoking the full suite at most once per verification. (#753)
/gsd-plan-phase, /gsd-execute-phase, /gsd-autonomous now run in an isolated forked context on Claude Code — context: fork in skill frontmatter protects the main session's context budget. These three heavy skills also declare effort: xhigh; quick-status skills /gsd-progress and /gsd-stats declare effort: low. The installer preserves both fields when converting commands to Claude SKILL.md files. Runtimes that do not recognise these fields silently ignore them — no behaviour change on non-Claude runtimes. (#769)
/gsd:plan-phase and /gsd:execute-phase no longer eagerly load MVP-only guidance on non-MVP runs — the MVP planner rules, user-story template, Walking-Skeleton template, and MVP+TDD halt-report reference are now Read lazily by the planner/executor only when MVP / Walking-Skeleton / MVP+TDD mode is active, in both the workflow files and the gsd-planner/gsd-executor agent definitions, instead of being @-imported into every run. Behaviour is unchanged; non-MVP planning/execution simply carries less context. (#720) (#746)

Automated codex exec invocations in the review workflow now include --ephemeral (no session-state accumulation across automated/CI runs) and --dangerously-bypass-hook-trust (skip hook-trust prompts for hooks managed by gsd-core itself). These flags apply only to the non-interactive reviewer invocations in gsd-core/workflows/review.md. (#773) (#824)

Codex slash-command conversion no longer corrupts inline-wrapped /gsd-… file paths — the install-time converter now identifies a real /gsd-<command> mention by positive boundaries (opening delimiter + no path continuation) instead of an unbounded preceding-character denylist, closing the path-corruption class (#637 → #704) by construction while still converting legitimate backtick-wrapped mentions. (#747)
The release pipeline now automatically runs changeset render during the finalize job, promoting .changeset/ fragments into a dated CHANGELOG.md section before publishing — previously a manual step that was routinely skipped (leaving v1.3.0 and v1.3.1 unpromoted, #690). A new --allow-empty flag prevents the verify gate from hard-failing on no-change releases by emitting a dated heading with a _No notable changes._ placeholder when there are zero fragments. (#715)

Fixed

/gsd-review --cursor now actually invokes the Cursor agent. Detection probes the cursor-agent headless binary instead of the cursor IDE launcher, the invocation calls the single cursor-agent binary in print mode (not the two-token cursor agent, which the IDE treats as a file path), and the review prompt is passed as a file-path argument rather than piped to stdin (which cursor-agent -p ignores). On failure the captured stderr is surfaced instead of a silent empty result. (#686)
No more "gsd-core" console-window flash on Windows. Every gsd-core child process now passes windowsHide: true: the context monitor's record-session spawn, the execGit / execNpm / execTool helpers in shell-command-projection, the gsd-worktree-path-guard and gsd-workflow-guard hook git probes, check-command-router's git log call, and the roadmap-upgrade git status/rev-parse/reset/clean calls — matching the existing gsd-check-update spawn. execNpm (which uses shell: true → cmd.exe and runs on every SessionStart, i.e. every /clear) and the worktree-path guard (which runs on every Edit/Write in a worktree) were the most visible offenders. No behavior change on macOS/Linux, where the flag is ignored. (#688)
/gsd-review --agy no longer hangs the whole review on large prompts. On a big, file-path-rich prompt Antigravity's agy -p agentic Cascade can loop on its code_search/grep steps and never converge. The invocation now passes agy's own --print-timeout flag (its native print-mode cap) so a stalled run self-terminates through the tool's own mechanism; on a non-zero exit any partial output is discarded so the existing transcript fallback / "review failed" stub take over. (#689)
The roadmap parser now resolves fresh phases of the current milestone in multi-milestone roadmaps. extractCurrentMilestone() scoped the current-milestone window to its ## Phases checklist subsection and stopped at the milestone's own ## Milestone … (Phase Details) heading, so the ### Phase N: detail headers fell out of scope. Any command backed by the parser — init.phase-op (and therefore /gsd:discuss-phase and /gsd:plan-phase), state, roadmap list, and validate health (W006) — could not resolve phases of any milestone after the first until a .planning/phases/ directory already existed, blocking discuss/plan. The parser now also includes the current milestone's (Phase Details) section in scope, anchored to the selected milestone's version token so sibling sub-milestones do not cross-pollinate. (#730) (#748)
getGlobalSkillsBase('kilo') now resolves to ~/.kilo/skills — where Kilo Code actually discovers global skills — instead of ~/.config/kilo/skills. Per Kilo Code docs, global skills live in the .kilo directory within HOME (~/.kilo/skills/), independent of the XDG-based config dir at ~/.config/kilo. The kilo.jsonc config dir (~/.config/kilo) and the command/ path used by the installer are correct and unchanged. Blast radius: this corrects the resolved skills-base path used by doctor/status checks and agent-skills-block resolution (init.cjs); the installer writes commands (not skills) for Kilo, so no files were previously being written to the wrong location. (#806)
Honor the COPILOT_HOME environment variable when resolving the GitHub Copilot global config directory. Previously a global --copilot install ignored COPILOT_HOME and wrote all artifacts (skills, agents, copilot-instructions.md, the session hook) to ~/.copilot even when the user had relocated their Copilot home, making them undiscoverable by Copilot CLI. Resolution now follows --config-dir > COPILOT_CONFIG_DIR > COPILOT_HOME > ~/.copilot, mirroring the existing CODEX_HOME handling. Uninstall uses the same resolver and stays symmetric. (#812) (#814)
Release version bumps now keep runtime manifest versions in sync — .claude-plugin/plugin.json and gemini-extension.json are stamped to match package.json on every npm version, unblocking RC/finalize releases. New version-bearing manifests must be registered in scripts/sync-manifest-versions.cjs (enforced by a regression test). (#845)
npx @opengsd/gsd-core upgrades no longer abort with "applied migration checksum changed" — an already-applied installer migration whose recorded checksum drifted (e.g. a shipped body was edited) is now detected and reconciled automatically on the next install, instead of hard-failing the upgrade. Replaces the published-checksum allowlist with general self-healing recovery plus a CI baseline lock. (#675)
/gsd-import, /gsd-plan-review-convergence, and /gsd-spec-phase now run on global installs — these workflows resolve gsd-tools via the runtime launcher instead of a hardcoded $HOME path, so they no longer falsely report the tool as "not found" (and stop short) when only a global/shim install is present and no project-local runtime exists. (#642)
Worktree wave-cleanup no longer fails when the phase SUMMARY is committed — rescueSummaryArtifacts no longer copies an already-committed SUMMARY into the main checkout, which previously caused git merge --no-ff to abort with a permanent merge_failed (#706). (#709)
Phase execution no longer halts with exit 42 (worktree base mismatch) when run on a branch diverged from the default branch (#683). Claude Code forks worktree-isolated executors off the repository default branch (origin/HEAD), so running /gsd-execute-phase on an unmerged milestone/feature branch left every executor without the phase's plan files and tripped the worktree-branch-check guard (100% reproducible, all OSes). Execute-phase now detects this before dispatch and automatically degrades to sequential execution on the main working tree, recommending the permanent fix worktree.baseRef:"head". Both fresh installs and upgrades of GSD Core set worktree.baseRef:"head" in .claude/settings.local.json automatically (no-clobber) when workflow.use_worktrees is enabled (the default); gsd-tools worktree set-baseref remains available for manual use (e.g. after toggling worktrees on later). The exit 42 guard remains as a backstop. (#749)
Codex install no longer corrupts launcher paths — shell path segments like ${VAR}/gsd-core/ and $(cmd)/gsd-local-patches are no longer rewritten into a literal $gsd-core token during Codex markdown conversion (#704). (#710)
/gsd:surface no longer corrupts installed skill paths — re-surfacing (profile/enable/disable/reset) now applies the same per-runtime path rewrites as install, so SKILL.md bodies keep the correct install target instead of reverting to the converter's default ~/.claude paths. (#817)
/gsd:graphify, /gsd:import, and planning agents now resolve gsd-tools on global/shim-only installs — agent and command surfaces that invoked a hardcoded $HOME/.claude/...gsd-tools.cjs path now route through the resolved gsd_run launcher, so the step no longer reports the tool "not found" when there is no project-local runtime. (#707)
/gsd:surface no longer mis-names or orphans runtime command files — re-surfacing now writes the same gsd--prefixed command filenames as a fresh install for flat command dirs (Cursor, Augment, OpenCode, Kilo) and preserves user-authored command files instead of deleting them. (#822)
/gsd:update reliably previews release notes again — promotes the 1.3.x changelog into dated [1.3.0]/[1.3.1] sections, stops deleting the temp changelog before the human-readable render (no more (changelog unavailable)), and adds a release gate that blocks publishing a version whose CHANGELOG.md section was never promoted. (#694)

Security

gsd-tools config-set prototype-pollution guard hardened and regression-tested. The guard that blocks __proto__, prototype, and constructor segments in dotted config keys now uses inline literal comparisons at each property-write site (instead of a pre-loop Set check), so CodeQL's js/prototype-pollution-utility analysis recognises it as a sanitising barrier and code-scanning alert #26 clears. Runtime behaviour is unchanged from #663. Added regression tests that drive schema-valid dynamic-prefix keys (agent_skills.__proto__, agent_skills.constructor, features.__proto__, review.models.constructor) all the way to the guard — these reach setConfigValue past the schema gate and were previously the guard's only untested attack surface. (#751) (#752)
Hardened roadmap-phase parsing and config writes — resolved ReDoS in phase-heading/plan-filename regexes (validate/verify/commands/phase), blocked prototype-pollution through dotted config keys in config-set, and pinned qs >= 6.15.2 (DoS advisory). (#665)

1.3.1 - 2026-06-04

Security

Bumped hono to clear a moderate npm advisory carried transitively in the dependency tree. (#670)

Fixed

Installer-migration checksum drift no longer blocks upgrades — the updater now self-heals when a shipped migration's recorded checksum has drifted, reconciling the stored checksum instead of aborting. Restores upgrades across all OSes after shipped migration bodies were edited in a prior release. (#670)

1.3.0 - 2026-06-04

Added

Vertical MVP Slice mode — --mvp flag on /gsd-plan-phase switches the planner from horizontal layer decomposition to vertical feature-slice decomposition (UI→API→DB in one task sequence). On Phase 1 of a new project with no prior phase summaries, also emits SKELETON.md via Walking Skeleton mode. Composable with --tdd: --mvp --tdd produces vertical slices where every behavior-adding task starts with a failing test. Phase-level persistence via **Mode:** mvp in ROADMAP.md applies --mvp automatically without the flag. (#78)
/gsd-mvp-phase command — guided MVP planning: prompts for a user story (As a / I want to / So that), runs SPIDR story-splitting check (Spike/Paths/Interfaces/Data/Rules axes), writes **Mode:** mvp to ROADMAP.md, then delegates to /gsd-plan-phase. (#78)
MVP-aware UAT framing in verify-phase — when a phase has mode: mvp, the verifier generates a user-flow-first UAT script (walks the feature as a user would) before any technical checks. (#78)
MVP progress and stats display — progress and stats commands show Walking Skeleton completion status and per-feature-slice status lines for MVP-mode phases. (#78)
Six MVP reference files — planner-mvp-mode.md, skeleton-template.md, user-story-template.md, spidr-splitting.md, execute-mvp-tdd.md, verify-mvp-mode.md — loaded by the planner, executor, and verifier agents when MVP mode is active. (#78)
Milestone-prefixed phase ID convention (M-NN) for globally unique phase IDs within a project (#39)
getMilestoneFromPhaseId() and getPhaseDirFromPhaseId() helpers in core.cjs (#39)
W021 validation rule: fires when a phase ID's integer prefix mismatches its enclosing milestone section (#39)
gsd-tools roadmap validate subcommand for convention compliance checking (#39)
gsd-tools roadmap upgrade --convention milestone-prefixed migration tool (dry-run by default, --apply to mutate) (#39)
phase_id_convention config field (null | 'milestone-prefixed' | 'free-form'), defaults to null (legacy free-form, no breaking change) (#39)

Fixed

isDirInMilestone now correctly matches M-NN-style phase directories against milestone-prefixed ROADMAP headings (#39)
searchPhaseInContent heading regex now tolerates [bracket-token] scope prefix (e.g., ### [GSD] Phase 2-01:) (#39)
README version guidance now uses npm/package metadata as the source of truth — README, localized READMEs, and the docs index no longer present archived release-note or canary-stream numbers as the current GSD Core package version. (#545)

1.2.0 - 2026-05-31

1.2.0 is the current stable @opengsd/gsd-core release. It resumes the public package line after the release-version validation recovery documented in ADR 218 and makes @opengsd/gsd-core / gsd-core the canonical package and CLI identity.

Added

Plan-vs-codebase drift guard — plan review can verify generated plans against live source symbols before execution so hallucinated files, APIs, or commands are caught earlier. (#487)
Single Package Identity seam — package name, CLI identity, update checks, and installer identity are centralized so @opengsd/gsd-core stays consistent across runtime surfaces. (#499, #517, #521)
Cross-provider effort controls and fast-mode-aware routing — model-effort selection works across providers and can adjust routing for faster workflows. (#463)
Current public docs and install identity — README/docs now advertise GSD Core, @opengsd/gsd-core, and the gsd-core binary as the canonical user-facing surface. (#519, #523, #540)

Changed

SDK shim retired from installer/runtime docs — workflows now route through gsd-tools; dead SDK-shim verification and stale SDK-generated banners were removed. (#522, #515, #510)
Release numbering recovered at 1.2.0 — leading-zero release inputs are invalid and duplicate-version checks fail early before publish work begins. See ADR 218.
CI/test selection is more precise — affected-test selection now widens docs/test-impact correctly and avoids under-testing relevant PRs. (#495)

Fixed

Planning writes are more reliable — phase completion writes are transactional and no longer corrupt milestone progress counters. (#465, #514)
Roadmap and milestone parsing no longer leak stale phase details into active milestone state. (#513)
/gsd:update detects local Antigravity .agent installs and repo-local Claude installs correctly. (#512, #476)
Package identity registration no longer regresses update/runtime detection. (#521)

Legacy Release History

Release notes for every version published before the project was renamed to @opengsd/gsd-core — the retired get-shit-done-cc / get-shit-done-redux lineage, versions 1.0.0 → 1.42.x plus pre-release and canary builds — have been rolled up into a single archive:

➡️ docs/RELEASE-NOTES-LEGACY.md

Those legacy 1.x numbers belong to the previous package line and predate the current @opengsd/gsd-core versioning, which restarts at 1.0.0. They are preserved verbatim-in-spirit (condensed) in the archive and intentionally kept out of this file so the two version streams cannot collide.

416 KiB Raw Blame History Unescape Escape

Changelog

Unreleased

[1.8.0] - 2026-07-22

Added

Changed

Removed

Fixed

Security

[1.7.0] - 2026-07-15

Added

Changed

Removed

Fixed

Security

[1.6.1] - 2026-07-01

Added

Fixed

[1.6.0] - 2026-06-24

Added

Changed

Fixed

fix(#1478,#1479,#1480): prohibit ungrounded baselines, error-suppressing fallbacks, and stale-artifact authority in planner verify blocks (#1482)

Security

[1.5.0] - 2026-06-17

Added

Changed

Fixed

Parallel worktree execution now has executor-authored cleanup metadata — executor agents capture their worktree path, branch, and expected base before task commits and return a parseable metadata block for execute-phase to prefer over runtime harness metadata. (#1297) (#1349)

UAT resume now accepts paused checkpoints — uat render-checkpoint treats a non-structured paused Current Test placeholder as a resume signal and derives the checkpoint from the first pending UAT test instead of failing as malformed. (#1300) (#1350)

phase complete now preserves prose-block STATE phase names — template-shaped Current Position prose now advances with the next phase name, avoids missing-field warnings, and keeps Last activity: on the template em-dash delimiter. (#1316) (#1351)

Claude skill installs now avoid rejected xhigh effort frontmatter — heavyweight GSD skills now ship with portable effort: max, and the Claude skill converter normalizes any remaining xhigh source effort before writing SKILL.md. (#1319) (#1352)

Glued letter-prefix phase directories now resolve correctly -- phase lookup now recognizes tokens like P0.3 and M1-2 from directory names, so phase commands can find their plans instead of reporting none found. (#1324) (#1353)

Update backups now ignore preserved shared skills and hooks -- /gsd-update custom-file detection now mirrors installer cleanup scope for shared runtime roots, so non-gsd-* skills and hooks are not copied into backup folders unnecessarily. (#1325) (#1354)

[1.4.5] - 2026-06-12

Fixed

[1.4.4] - 2026-06-11

Changed

[1.4.3] - 2026-06-09

Fixed

[1.4.2] - 2026-06-09

Fixed

[1.4.1] - 2026-06-09

Changed

Fixed

[1.4.0] - 2026-06-08

Added

Changed

Fixed

Security

1.3.1 - 2026-06-04

Security

Fixed

1.3.0 - 2026-06-04

Added

Fixed

1.2.0 - 2026-05-31

Added

Changed

Fixed

Legacy Release History

416 KiB

Raw Blame History

UAT resume now accepts paused checkpoints — `uat render-checkpoint` treats a non-structured paused `Current Test` placeholder as a resume signal and derives the checkpoint from the first pending UAT test instead of failing as malformed. (#1300) (#1350)

`phase complete` now preserves prose-block STATE phase names — template-shaped `Current Position` prose now advances with the next phase name, avoids missing-field warnings, and keeps `Last activity:` on the template em-dash delimiter. (#1316) (#1351)

Claude skill installs now avoid rejected `xhigh` effort frontmatter — heavyweight GSD skills now ship with portable `effort: max`, and the Claude skill converter normalizes any remaining `xhigh` source effort before writing `SKILL.md`. (#1319) (#1352)

Glued letter-prefix phase directories now resolve correctly -- phase lookup now recognizes tokens like `P0.3` and `M1-2` from directory names, so phase commands can find their plans instead of reporting none found. (#1324) (#1353)

Update backups now ignore preserved shared skills and hooks -- `/gsd-update` custom-file detection now mirrors installer cleanup scope for shared runtime roots, so non-`gsd-*` skills and hooks are not copied into backup folders unnecessarily. (#1325) (#1354)