Gsd 2 Updates & Release Notes

Added

• gsd: add /gsd verdict command for milestone override recovery
• gsd: add visual brief command
• subagent: add random tracking names
• subagent: add resumable isolated launch records
• web: update visualizer tabs
• gsd: dispatch adapter receives full session inputs (#5789)
• gsd: orchestrator parity with runPreDispatch (#5788)
• gsd: move stuck-loop detection into Auto Orchestration (#5787)
• gsd: widen AutoAdvanceResult with unit + action (#5786)
• adr-013: stop decisions-table writes from gsd_save_decision (stage 3)
• adr-013: /gsd knowledge routes pattern + lesson to memories (stage 2c)
• adr-013: KNOWLEDGE.md backfill + hybrid projection (stage 2b)
• adr-013: DECISIONS.md projection sources from memories (stage 2a)
• adr-013: switch prompt-inline decisions read to memories (stage 1)
• adr-013: memory-store cutover preflight scanner
• adr-011: ROADMAP shows [sketch] badge on unrefined slices
• adr-005: declare producesImages on always-image browser tools
• adr-005: surface ProviderSwitchReport via audit, notification, counter

Fixed

• pi-agent: default tool output expanded
• gsd: preserve paused cleanup and verify guidance
• gsd: refresh db before post-unit verification
• gsd: clarify step mode next action
• gsd: preserve step-mode completion surface
• gsd: remove tracker refs from user messages
• pi-coding-agent: skip empty reasoning transcript rails …

Added

• tui: refresh operations console design
• gsd: show milestone completion rollup

Fixed

• gsd: ignore completed-content aborts during session switch
• gsd-extension: drop duplicate resolveGitDir import in merge-state.ts
• run stuck detection during verification retries
• complete auto timeout recovery journaling
• skip ignored task key files during auto commit
• defer run-unit failsafe during recovery
• close all unit-end iteration exits
• journal post-unit finalize stops
• gsd: keep complete-slice closeout read-only
• gsd: unblock CI tests on PR #5679
• gsd: unblock CI typecheck on PR #5678
• auto: guard ghost completions before milestone stop
• gsd: gate unmerged exit telemetry on active worktrees
• gsd: back off verification retries

Changed

• gsd-extension: ADR-017 / strict caller closure for parallel spawns (#5707)
• gsd-extension: ADR-017 / missing-completion-timestamp drift (#5706)
• gsd-extension: ADR-017 / roadmap-divergence drift (#5705)
• gsd-extension: ADR-017 / unregistered-milestone drift (#5704)
• gsd-extension: ADR-017 / stale-worker drift detection and repair (#5703)
• gsd-extension: ADR-017 / migrate stale-render drift (#5702)
• gsd-extension: ADR-017 / migrate merge-state drift (#5701)
• gsd-extension: ADR-017 phase 1 / sketch-flag drift pattern proof (#5700)
• gsd-extension: ADR-016 phase 3 / R2 + R4 + ADR carve-outs (#5693) …

Added

• tui: show tool targets in compact output
• gsd: scope provider tools at request time
• pi-agent-core: add provider-boundary token audit
• gsd: startup audit reapplies orphaned gsd-preflight-stash entries
• db: V28 — last_hit_at on memories + time-decay in relevance scoring
• db: V27 — content_hash on artifacts for integrity fingerprinting
• tui: align chat and tool cards with terminal design
• tui: summarize low-signal tool output by phase
• tui: wire adaptive refresher layouts
• tui: add adaptive style primitives
• legacy: add cleanup evidence runner
• legacy: flush zero-use telemetry snapshots
• legacy: add cleanup telemetry gate
• legacy: persist cleanup telemetry snapshots
• legacy: warn on deprecated paths
• legacy: count component format usage
• legacy: count mcp alias usage
• legacy: count provider default usage
• legacy: count uok fallback usage
• legacy: count workflow engine usage
• legacy: add cleanup telemetry counters
• process: add process baseline metrics
• process: recommend task paths by size
• refactor: add contract drift baseline metrics
• refactor: add phase 0 baseline harness

Fixed

• test: align loop-deps mocks with slice 7's LoopDeps + WorktreeLifecycleDeps
• drop accidentally-committed node_modules symlink
• gsd: use truthy check for activeEngineId in Worktree Safety bypass …

Added

• gsd: make uok contracts db authoritative
• context-mode: fully wire auto-run context mode

Fixed

• post-exec: tighten explicit extension fallback and +types guard
• post-exec: handle dotted module stems and ignore React Router +types imports
• gsd: recover planned slices after artifact writes
• auto: emit stopped lifecycle event on recovery stop
• gsd-extension: address remaining CodeRabbit auto seam feedback
• gsd-extension: address auto orchestration review findings
• gsd-extension: type pauseAuto error context in loop deps
• shared: preserve submitted interview answers on abort
• gsd-extension: type pauseAuto error context in loop deps
• gsd-extension: preserve cancellation context for auto-mode pauses
• mcp-server: update gsd_summary_save PROJECT test fixture for R3a contract
• gsd: address PR5279 review — basePath threading + cache invalidation + Gate 1a test rigor
• gsd: close depth-verification gate workflow regressions
• gsd: resolve plan-slice artifacts case-insensitively
• gsd: guard onTurnResult phaseResults access with Array.isArray
• gsd: address PR5266 review — trace correlation, cleanup-on-throw, audit context reset
• gsd: continue deep queued milestones
• gsd: bind task commits to milestone completion guard
• gsd: keep project save success if registration fails
• mcp-server: Windows path-sep test regex + gate gsd_exec writes …

Added

• gsd: DB-backed auto-mode coordination tables (workers, leases, dispatches, command queue)
• workspace: introduce GsdWorkspace and MilestoneScope handle types
• dispatch: annotate dispatch actions with delegation-policy verdict
• delegation: codify per-tool background-safety policy
• discuss: scale questioning depth via project shape classifier
• headless: add gsd headless recover for non-TTY DB recovery
• gsd: doctor flags exhausted run-uat retry counters
• gsd: emit pre-ship soft warning on EVAL-REVIEW status
• gsd: register /gsd eval-review in catalog and ops dispatcher
• gsd: add /gsd eval-review command handler
• gsd: add EVAL-REVIEW frontmatter schema module
• gsd: add artifact validators for Phase 11 deep mode
• gsd: add /gsd new-project and --deep flag for Phase 11
• gsd: add research-decision and research-project dispatch units (Phase 11)
• gsd: add deep planning mode dispatch units (Phase 11)
• gsd: add worktree {list,merge,clean,remove} commands to TUI dispatcher
• unit-manifest: introduce planning-dispatch mode for slice plan/complete
• auto-prompts: surface manifest skills via recommendations + auto-match
• auto-dispatch: default reactive-execute on at >=3 ready tasks
• subagent: add dispatch telemetry and stronger prompt guidelines
• ollama: configurable probe/request timeouts via env vars
• pi-coding-agent: opt-in per-call token telemetry (#5023) …

Added

• workflow: close single-writer-v3 control plane gaps
• auto: UnitContextManifest tools-policy field — declarative-only (#4934)
• auto: UnitContextManifest v2 contract — typed computed artifacts (#4924)
• auto: migrate complete-slice through composer — #4782 phase 3 batch 3
• auto: migrate research-milestone through composer — #4782 phase 3 batch 2
• auto: migrate run-uat through composer — #4782 phase 3 batch 1
• auto: compose reassess-roadmap context from manifest — #4782 phase 2
• auto: wire pipeline variant into dispatch — phase 2 of #4781
• auto: milestone scope classifier — phase 1 of #4781
• auto: UnitContextManifest schema + data + CI guard — phase 1 of #4782
• claude-code: add permission granularity picker for Always Allow
• pi-coding-agent: add skillFilter option to buildSystemPrompt
• gsd: narrow component system foundation
• gsd: add uok swarm contract foundation
• gsd: add GPT-5.5 Codex model support
• pi-coding-agent: show auth mode alongside providers in /model
• 10-02: replace google-search source with deprecation stub
• 10-01: add validateExtensionPackage function and validate subcommand
• 10-01: create extracted @gsd-extensions/google-search workspace package
• 09-02: wire sortExtensionPaths into loader and initialize warnings
• 09-02: add ExtensionLoadWarning type and warnings[] to LoadExtensionsResult …

Added

• ci: dynamic system-specific verification checklists in pr-risk-check
• gsd-exec: add clean-root preflight gate + auto-stash to milestone completion (#4604)
• prefs: expose all KNOWN_PREFERENCE_KEYS through /gsd prefs wizard
• gsd: default context_mode to ON (opt-out via enabled:false)
• gsd: add gsd_exec_search, gsd_resume, and compaction snapshot (slice 2)
• gsd: add gsd_exec sandboxed tool-output execution (context-mode slice 1)
• tui: render skill invocations in purple chat-frame style
• add Layer 0 shell hooks + new Layer 2 events
• skills: add 9 gap-closing skills for GSD workflow coverage
• gsd: cutover to memories table as single source of truth (ADR-013 step 6)
• gsd: backfill decisions table into memories (ADR-013 step 5)
• gsd: memory-store auto-injection parity (ADR-013 step 4)
• skills: bundle 6 planning/design skills and surface hidden ones
• mcp: expose memory tools to external clients (ADR-013 step 3)
• gsd: add structured_fields column to memories table (ADR-013 step 2)
• gsd: wire new memory tools across agents and extract-learnings (Option A' dual-write)

Fixed

• gsd-db: writeBlockerPlaceholder DB update for plan-milestone + saveStuckState in standard path (#4634)
• gsd: add .mcp.json to ensureGitignore baseline
• worktree-resolver: re-throw all errors, not just MergeConflictError (#4633) …

Added

• gsd: memory maintenance \u2014 cap cascade, decay observability, export/import (Phase 5)
• gsd: memory relationships / knowledge graph (Phase 4)
• gsd: hybrid keyword + semantic memory retrieval (Phase 3)
• gsd: memory ingestion + scope/tags (Phase 2)
• gsd: memory tools — capture_thought, memory_query, gsd_graph (Phase 1)
• web: surface CLI onboarding completion record in settings
• gsd: /gsd onboarding re-entry + setup hub disambiguation
• tui: refresh chat, footer, and welcome screen
• models: add gpt-5.4-mini to openai-codex list (#1215)
• gsd: ADR-011 Phase 2 mid-execution escalation (#3789)
• gsd: ADR-011 Phase 1 progressive planning (sketch-then-refine) (#3789)
• routing: add allow_flat_rate_providers opt-in (#4386)
• workflow: unified plugin system with modes and remote install
• pi-ai: add claude-opus-4-7 for Bedrock, Antigravity and OpenRouter (#4348)
• pi-ai: add claude-opus-4-7 model support
• remote: add Telegram command interface for auto-mode control
• theme: add tui-classic and web classic/vivid palettes (#4301)
• Added /gsd debug GitBook and Mintlify feature pages, wired both…
• Added specialistContext to debug-session-manager template and wir…
• Wired checkpoint and TDD gate logic into the continue handler: di…
• Extended session artifact with DebugCheckpoint/DebugTddGate inter…
• Wired diagnose-only and continue flows to prompt dispatch with ex… …

Added

• tui: render compaction notice in the shared chat-frame style
• prefs: add persistent language preference via /gsd language
• tui: align tool execution cards with chat frame styling
• tui: blend chat frame with shared timestamp and model header
• extensions: add GSDExtensionAPI for .gsd/extensions/ (#3338)
• graph: parse LEARNINGS.md into knowledge graph and rebuild after extraction
• gsd: add /gsd extract-learnings command
• gsd-uok: flip default to UOK with emergency legacy fallback
• gsd-uok: enforce plan-v2 compile gates and graph metadata
• gsd-uok: unify audit envelopes across logger metrics and activity
• gsd-uok: add turn-level git transaction modes and closeout gates
• gsd-uok: unify reactive and parallel scheduling via execution graph
• gsd-uok: enforce model policy filtering before routing
• gsd-uok: unify gate plane across pre/post validation checks
• graph: implement knowledge graph system (closes #4202)
• gsd: add v1→v2 command parity — 12 missing commands

Fixed

• ci: stage all workspace package.json files in release commit
• tui: pin rendered block to terminal bottom on clear
• gsd: silence benign auto-mode warnings and bind getProviderAuthMode correctly
• gsd: stop wiping the artifacts table on every cache invalidation
• tui: unstick tool cards after compaction and promote success notifications …

Added

• gsd: extend flat-rate provider detection to custom/externalCli providers
• claude-code: pass thinking level as effort

Fixed

• claude-code-cli: forward image blocks in SDK query prompt (#4183)
• keep assistant text visible when thinking traces are long
• state: DB-authoritative milestone completeness (#4179)
• auto-mode: prevent false milestone merge after complete-milestone failure (#4175)
• auto: pause on validate-milestone needs-remediation without slices (#4094)
• gsd: notify users what to do next after /gsd step finishes
• cli: restore --help handling when it follows a subcommand or unknown flag
• tui: eliminate pinned output duplication and reduce render overhead
• auto: prevent premature auto-mode stops on blocked phase + missing reassessment
• cli: use junction symlinks in merged node_modules path
• tui: reset segment state on claude-code sub-turn shrink
• gsd: set completed_at when reconciling task status to complete
• tui: keep AUTO-mode widgets alive and drop duplicate health panel
• gsd: use bun for update when installed via Bun (#4145)
• tui: render assistant tool calls inline with text instead of grouped at end
• gsd: restore isAutoMode plumbing and workflow-logger catch in auto-model-selection
• gsd: preserve custom-model selection on /gsd auto bootstrap (#4122)
• pi-coding-agent: use safe compaction role markers
• pi-ai: detect claude-code overflow text …

Fixed

• gsd: address 3 silent-crash secondary issues from #3348 post-#3696 (#4133)
• gsd: tolerate corrupt task arrays (#4056)
• gsd: discard milestone DB and worktree state (#4065)
• model-resolver: gate saved default restore on provider readiness
• tui: stop pinned latest-output mirror from duplicating streaming text
• gsd: wire subagent_model preference through to dispatch prompt builders
• ci: address 5 pipeline integrity issues from release audit (#4119)
• ci: regenerate package-lock.json during version bump (#4116)
• pi-coding-agent: skip localhost dummy key when fallback resolver provides a configured key

Changed

• gsd: delete 3 unreferenced dead files and orphaned test (#3728)

Added

• pi-ai: add Alibaba DashScope as standalone provider (#3891)
• gsd: add layered depth enforcement to discuss.md (#4079)

Fixed

• gsd: reconcile stale slice rows and rebuild STATE.md before DB close (#3658)
• gsd: block direct writes to gsd.db via hooks to prevent corruption (#3674)
• gsd: break 3 circular dependencies in extension modules (#3730)
• claude-code: default GSD subagents to bypassPermissions and pre-authorize safe built-ins (#4099 follow-up)
• gsd: add memory pressure watchdog and persist stuck detection state (#3708)
• state: prevent false degraded-mode warning when DB not yet initialized (#3922)
• async-jobs: suppress stale follow-up for jobs consumed by await_job (#3787) (#3788)
• gsd: rebuild STATE.md after unit completion (#3876)
• gsd: let doctor heal dispatch fixable warnings (#3875)
• gsd: preserve experimental preferences in merges (#3847)
• gsd: heal legacy task arrays and evidence rows (#4027)
• gsd: unlock depth verification outside guided flow (#4058)
• gsd: preserve paused auto badge after provider pause (#4062)
• ollama: add cloud auth support and resolve real context window via /api/show (#4017)
• security: activate auth middleware and harden shutdown/update routes (#4023)
• gsd: normalize workingDirectory prompt paths (#4057)
• claude-code: pre-authorize workflow MCP tools so interactive acceptEdits mode stops blocking GSD commands …

Added

• agents: add GSD phase guard to prevent subagent/phase conflicts
• agents: add 8 specialist subagents and slim pro agents
• tui: improve gsd overlays, shortcuts, and notification flows

Fixed

• ci: build artifacts in integration-tests job
• auto: recover from OpenRouter credit affordability errors
• gsd: cast unknown gate id in test to satisfy GateId type
• gsd: route quality gates through a per-turn registry
• mcp: expose every registered tool and fix SDK subpath resolution
• mcp: resolve rebase regressions in stream-adapter
• mcp: thread abort signals, restore tool fidelity, and fix subpath imports
• doctor: skip key check for CLI-authenticated providers
• tui: overlay subscription + Ctrl+Shift+P shortcut conflict
• models: block unconfigured models from selection surfaces
• ollama: clear footer status when provider unavailable
• gsd: guard model override in minimal command contexts
• model: require provider readiness for saved default selection
• gsd: honor /gsd model as session override across dispatch
• gsd: use milestone branch for merged worktree cleanup
• pi-coding-agent: show full OAuth login URLs
• auto: add structured cooldown error and bounded retry budget
• auto: survive transient 429 credential cooldown in auto sessions
• pi-coding-agent: match renderable tools case-insensitively
• headless: keep idle timeout off during interactive tools …

Added

• mcp-server: add secure_env_collect tool via MCP form elicitation

Fixed

• tui: clear pinned output on message_end to prevent duplicate display
• tui: clear pinned latest output on turn completion
• tui: restore pinned output above editor during tool execution
• TOCTOU file locking race conditions in event log and custom workflow graph
• tui: mask secure extension input values in interactive mode
• claude-code: harden MCP elicitation schema handling
• claude-code: accept secure_env_collect MCP elicitation forms
• interactive: keep MCP tool output ordered and restore secure prompt fallback
• interactive: preserve MCP tool output stream ordering
• gsd: resolve workflow MCP test typing regressions
• mcp: return isError flag on workflow tool execution failures
• discuss: add structuredQuestionsAvailable conditional to all gates
• discuss: add multi-round questioning to new-project discuss phase
• gsd: harden claude-code workflow MCP bootstrap
• web: drop provisional pre-tool question text

Changed

• extract deriveStateFromDb logic into composable helpers
• pr: drop web-layer changes from MCP stream-order fix

Fixed

• routing: address codex review — complete interactive bypass and accurate banner
• routing: skip dynamic routing for interactive dispatches, always show model changes (#3962)
• ci: trim windows portability integration load
• ci: narrow windows portability coverage
• ci: skip validate-pack in windows portability job
• ci: unblock windows portability follow-up
• windows: harden portability across runtime and tooling
• auto: use pathToFileURL for cross-platform import and reconcile regression test
• auto: resolve resource-loader.js from GSD_PKG_ROOT on resume (#3949)
• mcp-server: importLocalModule resolves src/ paths from dist/ context
• gsd: surface scoped doctor health warnings
• gsd: skip skipped slices in milestone prompts
• gsd: handle doubled-backtick pre-exec paths
• update: fetch latest version from registry

Added

• gsd: implement ADR-005 multi-model provider and tool strategy
• gsd: complete ADR-004 capability-aware model routing implementation

Fixed

• gsd: add missing directories to codebase generator exclude list
• gsd: wire ADR-005 infrastructure into live paths
• gsd: replace empty catch with logWarning for CI compliance
• gsd: merge enhanced context sections into standard template, clean up stale gate patterns
• gsd: remove broken discuss-prepared template, inject briefs into discuss.md

Added

• expose slice replanning over workflow MCP
• expose milestone workflow tools over MCP
• expose slice completion over workflow MCP
• expose task completion alias over workflow MCP
• expose GSD planning tools over MCP
• gate workflow MCP units by provider transport capabilities
• expose core GSD workflow tools over MCP
• add contextual tips system for TUI and web terminal

Fixed

• state: prevent false degraded-mode warning when DB not yet initialized
• gsd: use debugLog in catch block to satisfy empty-catch lint
• gsd: avoid false manifest and skipped-slice warnings
• gsd: replace empty catch block with descriptive comment
• guard autoCommitDirtyState and restore cwd on MergeConflictError (#2929)
• Claude Code MCP tool output rendering and real-time streaming
• gsd: surface warnings when DB or STATE.md init fails
• gsd: create gsd.db, runtime/, and STATE.md during init (#3880)
• gsd: suppress workflow stderr during /gsd
• gsd: enforce workflow write gates over MCP
• restore autoStartTime on resume + replace empty catch blocks (#3585)
• mcp: harden workflow tool boundary
• gsd: accept em-dash none verification rationale
• gsd: resync managed resources on auto resume
• gsd: stop stale forensics context hijacks
• gsd: serialize workflow MCP execution state
• gsd: restore milestone status db preflight
• claude-code-cli: suppress streamed internal tool noise
• gsd: skip same-path planning artifact copies…