Skip to content
Get Shit Done

Changelog

All releases of GSD 2, from newest to oldest. Each entry shows what was added, changed, and fixed. Click any version number to view the release on GitHub. For the narrative behind these releases, see The Story of GSD.

Engine Era v2.29–v2.58

v2.58.0 March 28, 2026
Highlights Added: Added 6 discord.js shard/error/warn event listeners for reconnect… · Fixed: guard startAuto() against concurrent invocation

Added

  • Added 6 discord.js shard/error/warn event listeners for reconnect…

Fixed

  • auto: guard startAuto() against concurrent invocation (#2923)
  • auto-dispatch: widen operational verification gate regex (fixes #2866) (#2898)
  • parallel: three bugs preventing reliable parallel worker execution (#2801)
  • web: fall back to project totals when dashboard metrics are zero (#2847)
  • gsd: parse raw YAML under preference headings (#2794)
  • gsd: persist verification classes in milestone validation (#2820)
  • gsd: guard reconcileWorktreeDb against same-file ATTACH corruption (#2825)
  • web: skip shutdown in daemon mode so server survives tab close (#2842)
  • headless: skip execution_complete for multi-turn commands (auto/next)
  • Fixed 3 bugs (launchd JSON parsing, login race condition, interact…
v2.57.0 March 28, 2026
Highlights Added: Extended DaemonConfig with control_channel_id and orchestrator se… · Changed: auto-commit after complete-milestone · Fixed: match "completed" status from RPC v2 in exit code mapper

Added

  • Extended DaemonConfig with control_channel_id and orchestrator se…
  • Created pure-function event formatters (10 functions) mapping RPC…
  • models: add GLM-5.1 to Z.AI provider in custom models
  • Added discord.js v14, DiscordBot class with auth guard and lifecy…
  • Created packages/daemon workspace package with DaemonConfig/LogLe…
  • headless text mode shows tool calls + skip UAT pause in headless
  • Wire --resume flag to resolve session IDs via prefix matching and…
  • Migrated headless orchestrator to use execution_complete events,…

Fixed

  • headless: match "completed" status from RPC v2 in exit code mapper
  • show external drives in directory browser on Linux
  • Regenerate package-lock.json after merge
  • gsd: resume cold auto bootstrap from db
  • gsd: preserve first auto unit model after session reset
  • Accept flags after positional command in headless arg parser
  • gsd: discover project subagents in .gsd
  • model-routing: use honest unitTypes for discuss dispatches and map all auto-dispatch phases
  • revert jsonl.ts to inline implementation — @gsd-build/rpc-client not available at source-level test time in CI

Changed

  • auto-commit after complete-milestone
v2.56.0 March 27, 2026
Highlights Added: /gsd parallel watch — native TUI overlay for worker monitoring · Changed: compile unit tests with esbuild, reclassify integration tests, fix node_modules symlink · Fixed: copy web/components to dist-test for xterm-theme test

Added

  • parallel: /gsd parallel watch — native TUI overlay for worker monitoring (#2806)

Fixed

  • ci: copy web/components to dist-test for xterm-theme test (#2891)
  • gsd: prefer PREFERENCES.md in worktrees (#2796)
  • gsd: resume auto-mode after transient provider pause (#2822)
  • parallel: resolve session lock contention and 3 related parallel-mode bugs (#2184) (#2800)
  • web: improve light theme terminal contrast (#2819)
  • gsd: preserve auto start model through discuss (#2837)

Changed

  • test: compile unit tests with esbuild, reclassify integration tests, fix node_modules symlink (#2809)
v2.54.0 March 27, 2026
Highlights Added: Headless Integration Hardening & Release (M002)

Added

  • Headless Integration Hardening & Release (M002) (#2811)
  • parallel: add real-time TUI monitor dashboard with self-healing (#2799)
v2.53.0 March 27, 2026
Highlights Added: activity feed, workflow controls, session forking, enhanced code lens [2/3] · Changed: extract duplicated status guards and validation helpers · Fixed: hydrate collected secrets for current session

Added

  • vscode: activity feed, workflow controls, session forking, enhanced code lens [2/3] (#2656)
  • gsd: enable safety mechanisms by default (snapshots, pre-merge checks) (#2678)

Fixed

  • hydrate collected secrets for current session (#2788)
  • resolve stash pop conflicts and stop swallowing merge errors (#2780)
  • treat any extracted verdict as terminal in isValidationTerminal (#2774)
  • use localStorage for auth token to enable multi-tab usage (#2785)
  • guard activeMilestone.id access in discuss and headless paths (#2776)
  • clean up zombie parallel workers stuck in error state (#2782)
  • relax milestone validation gate to accept prose evidence (#2779)
  • write milestone reports to project root instead of worktree (#2778)
  • auto-resolve build artifact conflicts in milestone merge (#2777)
  • let rate-limit errors attempt model fallback before pausing (#2775)
  • prevent gsd next from self-killing via stale crash lock (#2784)
  • add shell flag for Windows spawn in VSCode extension (#2781)

Changed

  • gsd: extract duplicated status guards and validation helpers (#2767)
v2.52.0 March 27, 2026
Highlights Added: status bar, file decorations, bash terminal, session tree, conversation history, code lens [1/2] · Changed: replace model-ID pattern matching with capability metadata · Fixed: auto-mode stops after provider errors (#2762)

Added

  • vscode: status bar, file decorations, bash terminal, session tree, conversation history, code lens [1/2] (#2651)
  • web: Dark mode contrast — raise token floor and flatten opacity tier system (#2734)
  • Wire --bare mode across headless → pi-coding-agent → resource-loa…
  • Added runId generation on prompt/steer/follow_up commands, event…
  • Added RPC protocol v2 types, init handshake with version detectio…

Fixed

  • auto-mode stops after provider errors (#2762) (#2764)
  • add missing runtime stage name to Dockerfile (#2765)
  • make transaction() re-entrant and add slice_dependencies to initSchema
  • remove preferences.md from ROOT_STATE_FILES to prevent back-sync overwrite
  • wire tool handlers through DB port layer, remove _getAdapter from all tools
  • gsd: move state machine guards inside transaction in 5 tool handlers (#2752)
  • reconcile disk milestones into empty DB before deriveStateFromDb guard (#2686)
  • gsd: seed preferences.md into auto-mode worktrees (#2693)
  • claude-import: discover marketplace plugins nested inside container directories (#2718)
  • exempt interactive tools from idle watchdog stall detection (#2676)
  • guard allSlicesDone against vacuous truth on empty slice array (#2679)
  • block complete-milestone dispatch when VALIDATION is needs-remediation (#2682)
  • gsd: sync milestone DB status in parkMilestone and unparkMilestone (#2696)
  • web: auth token gate — synthetic 401 on missing token, unauthenticated boot state, and recovery screen (#2740)
  • remote-questions: empty-key entry in auth.json shadows valid Discord bot token (#2737)
  • idle watchdog stalled-tool detection overridden by filesystem activity (#2697)
  • surface exhausted Claude SDK streams as errors (#2719)
  • docker: overhaul fragile setup, adopt proven container patterns (#2716)
  • gsd: write DB before disk in validate-milestone to match engine pattern (#2742)
  • gsd: extract and honor milestone argument in /gsd auto and /gsd next (#2729)
  • windows: prevent EINVAL by disabling detached process groups on Win32 (#2744)
  • gsd: delete orphaned verification_evidence rows on complete-task rollback (#2746)
  • gsd: wire setLogBasePath into engine init to resurrect audit log (#2745)
  • Remove premature pendingTools.delete in webSearchResult handler (#2743)
  • gsd: remove redundant assertions that fail TS2367 typecheck
  • include preferences.md in worktree sync and initial seed

Changed

  • pi-ai: replace model-ID pattern matching with capability metadata (#2548)
  • gsd-db: comprehensive SQLite audit fixes — indexes, caching, safety, reconciliation
  • rename preferences.md to PREFERENCES.md for consistency (#2700) (#2738)
  • gsd: unify three overlapping error classifiers into single classify→decide→act pipeline
v2.51.0 March 26, 2026
Highlights Added: add /terminal slash command for direct shell execution · Changed: consolidate docs, remove stale artifacts, and repo hygiene · Fixed: improve light theme warning contrast

Added

  • add /terminal slash command for direct shell execution (#2349)
  • auto: check verification class compliance before milestone completion (#2623)
  • validate: extract followUps and knownLimitations in parseSummary (#2622)
  • managed RTK integration with opt-in preference and web UI toggle (#2620)
  • validate: inject verification classes into milestone validation prompt (#2621)
  • skills: add 19 wshobson/agents packs with 40 curated skills
  • skills: add 11 new skill packs covering major frameworks and languages
  • skills: add SQLite/SQL detection, SQL optimization pack, and Redis pack
  • skills: add Prisma and Supabase/Postgres database packs
  • skills: add cloud platform packs (Firebase, Azure, AWS) and improve detection
  • skills: curate catalog — add top ecosystem skills, drop low-quality bundled ones
  • skills: parse SDKROOT from pbxproj for platform-aware iOS skill matching
  • skills: use ~/.agents/skills/ as primary skills directory with curated catalog

Fixed

  • improve light theme warning contrast (#2674)
  • honor explicit model config when model is not in known tier map (#2643)
  • exclude lastReasoning from retry diagnostic to prevent hallucination loops (#2663)
  • persist rewrite-docs attempt counter to disk for session restart survival (#2671)
  • add non-null assertions for parseUnitId optional fields in tests
  • update triage-dispatch static analysis tests for enqueueSidecar helper
  • notifications: prefer terminal-notifier over osascript on macOS (#2633)
  • classify stream-truncation JSON parse errors as transient (#2636)
  • call ensureDbOpen() before slice queries in /gsd discuss (#2640)
  • prompts: use --body-file for forensics issue creation (#2641)
  • isLockProcessAlive should return true for own PID (#2642)
  • check ASSESSMENT file for UAT verdict in checkNeedsRunUat (#2646)
  • use pauseAuto instead of stopAuto for warning-level dispatch stops (#2666)
  • signal malformed tool arguments in toolcall_end event (#2647)
  • prevent double mergeAndExit on milestone completion (#2648)
  • respect queue-order.json in DB-backed state derivation (#2649)
  • vscode: support Remote SSH by adding extensionKind and error handler (#2650)
  • update DB task status in writeBlockerPlaceholder for execute-task (#2657)
  • normalize path separators in matchesProjectFileMarker for Windows
  • tests: remove obsolete doctor filesystem test
  • tests: update doctor issue code to db_done_task_no_summary
  • restore PR files lost during merge conflict resolution
  • skills: address QA round 3
  • skills: address QA round 2
  • skills: address QA round 1
  • skills: prioritize ecosystem dir and skip legacy after migration
  • skills: address QA round 23
  • skills: address QA round 22
  • skills: address QA round 21
  • skills: address QA round 20
  • skills: address QA round 19
  • skills: address QA round 18
  • skills: address QA round 17
  • skills: address QA round 16
  • skills: address QA round 15
  • skills: address QA round 14
  • skills: address QA round 13
  • skills: address QA round 12
  • skills: address QA round 11
  • skills: address QA round 10
  • skills: address QA round 8
  • skills: detect FastAPI via dependency scanning
  • skills: address QA round 6
  • skills: address QA round 5
  • skills: address QA round 4
  • skills: address QA round 3
  • skills: address QA round 2
  • skills: defer greenfield skill selection to post-design phase
  • skills: add migration from ~/.gsd/agent/skills/ to ~/.agents/skills/
  • gsd extension: detect initialized projects in health widget
  • gsd extension: detect initialized projects in health widget

Changed

  • consolidate docs, remove stale artifacts, and repo hygiene (#2665)
  • extract runSafely helper for try-catch-debug-continue pattern (#2611)
v2.50.0 March 26, 2026
Highlights Added: wire structured error propagation through UnitResult · Changed: adopt parseUnitId utility across all auto-* modules · Fixed: reconcile stale task status in filesystem-based state derivation

Added

  • gsd: wire structured error propagation through UnitResult
  • add parallel quality gate evaluation with evaluating-gates phase
  • add 8-question quality gates to planning and completion templates

Fixed

  • reconcile stale task status in filesystem-based state derivation (#2514)
  • merge duplicate extractUatType imports in auto-dispatch
  • use Record<string, any> for hasNonEmptyFields to accept typed DB rows
  • tests: replace undefined assertTrue/assertEq with assert.ok/assert.equal
  • tests: replace undefined assertTrue/assertEq with assert.ok/deepStrictEqual
  • gsd: handle session_switch event so /resume restores GSD state (#2587)
  • use GitHub Issue Types via GraphQL instead of classification labels
  • headless: disable overall timeout for auto-mode, fix lock-guard auto-select (#2586)
  • auto: align UAT artifact suffix with gsd_slice_complete output (#2592)
  • retry-handler: stop treating 5xx server errors as credential-level failures
  • test: replace stale completedUnits with sessionFile in session-lock test
  • session-lock: retry lock file reads before declaring compromise
  • gsd: prevent ensureGsdSymlink from creating subdirectory .gsd when git-root .gsd exists
  • auto: add EAGAIN to INFRA_ERROR_CODES to stop budget-burning retries
  • search: enforce hard search budget and survive context compaction
  • remote-questions: use static ESM import for AuthStorage hydration
  • add SAFE_SKILL_NAME guard to reject prompt-injection via crafted skill names
  • gsd: use explicit parameter syntax in skill activation prompts
  • guard writeIntegrationBranch against workflow-template branches
  • preserve doctor missing-dir checks for active legacy slices
  • gsd: downgrade isolation mode when worktree creation fails
  • gsd: skip loading files for completed milestones in queue context builder
  • resolve race conditions in blob-store, discovery-cache, and agent-loop
  • ai: resolve WebSocket listener leaks and bound session cache
  • rpc: resolve double-set race, missing error ID, and stream handler
  • pi-coding-agent: prevent crash when login is cancelled
  • doctor: compare lockfile mtime against install marker, not directory mtime (#1974)
  • doctor: chdir out of orphaned worktree before removal (#1946)
  • roadmap: recognize &#39;## Slice Roadmap&#39; header in extractSlicesSection
  • prevent worktree sync from overwriting state and forward-sync completed-units.json
  • web: lazily compute default package root to avoid Windows standalone crash

Changed

  • adopt parseUnitId utility across all auto-* modules
  • flatten syncMilestoneDir nesting with shared helper
  • extract merge-state cleanup helper in reconcileMergeState
  • extract planning-state validation helpers in detectRogueFileWrites
  • split doctor-checks into focused modules
  • merge auto-worktree-sync into auto-worktree
  • deduplicate artifact path functions into single module
  • remove dead selfHealRuntimeRecords function from auto-recovery
  • decouple session-forensics from auto-worktree
  • remove dead worktree code and unused methods
  • consolidate branch name patterns into single module
  • deduplicate session-lock compromise handler and state assignment
v2.49.0 March 25, 2026
Highlights Added: add --yolo flag to /gsd auto for non-interactive project init · Changed: move GSD metadata from commit subject scopes to git trailers · Fixed: use full git log in merge tests to match trailer-based milestone IDs

Added

  • add --yolo flag to /gsd auto for non-interactive project init

Fixed

  • use full git log in merge tests to match trailer-based milestone IDs
  • update parallel-merge test assertion for new trailer format
  • clarify regex alternation in test assertion
  • verdict gate accepts PARTIAL for mixed/human-experience/live-runtime UATs

Changed

  • move GSD metadata from commit subject scopes to git trailers
v2.48.0 March 25, 2026
Highlights Added: allow /gsd discuss to target queued milestones · Changed: address review - extract RAPID_ITERATION_THRESHOLD_MS, simplify data access · Fixed: make journal scanning intelligent — limit parsed files, line-count older ones

Added

  • discuss: allow /gsd discuss to target queued milestones
  • enhance /gsd forensics with journal and activity log awareness

Fixed

  • make journal scanning intelligent — limit parsed files, line-count older ones
  • model-registry: scope custom provider stream handlers to prevent clobbering built-in API handlers
  • forensics: filter benign bash exit-code-1 and user skips from error traces
  • gsd: clear stale milestone ID reservations at session start
  • render tool calls above text response for external providers
  • auto: skip CONTEXT-DRAFT warning for completed/parked milestones

Changed

  • address review - extract RAPID_ITERATION_THRESHOLD_MS, simplify data access

Removed

  • remove insertChildBefore usage in chat-controller
v2.47.0 March 25, 2026
Highlights Added: add externalToolExecution mode for external providers · Fixed: render tool calls above text response

Added

  • agent-core: add externalToolExecution mode for external providers
  • provider: add Claude Code CLI provider extension

Fixed

  • claude-code-cli: render tool calls above text response
  • ci: update FILE-SYSTEM-MAP.md path after docs→docs-internal move
  • isInheritedRepo false negative when parent has stale .gsd; defense-in-depth local .git check in bootstrap
  • claude-code-cli: resolve SDK executable path and update model IDs
  • make planning doctrine demoable definition audience-appropriate
  • prompts: migrate remaining 4 prompts to use DB-backed tool API instead of direct write
  • make workflow event hash platform-deterministic
  • reconcile stale task DB status from disk artifacts (#2514)
v2.46.1 March 25, 2026
Highlights Changed: trigger CI to pick up pipeline race condition fix · Fixed: prevent windows-portability from blocking pipeline

Fixed

  • ci: prevent windows-portability from blocking pipeline
  • ci: prevent pipeline race condition on release push
  • gsd: create empty DB for fresh projects with empty .gsd/ (#2510)
  • remote-questions: hydrate remote channel tokens from auth.json on startup

Changed

  • trigger CI to pick up pipeline race condition fix
  • trigger pipeline with race condition fix
v2.46.0 March 25, 2026
Highlights Added: single-writer engine v3 — state machine guards, actor identity, reversibility · Fixed: align prompts with single-writer tool API

Added

  • gsd: single-writer engine v3 — state machine guards, actor identity, reversibility
  • gsd: single-writer state engine v2 — discipline layer on DB architecture
  • gsd: add workflow-logger and wire into engine, tool, manifest, reconcile paths (#2494)

Fixed

  • gsd: align prompts with single-writer tool API
  • gsd: integration-proof — check DB state not roadmap projection after reset
  • gsd: block milestone completion when verification fails (#2500)
  • ci: add typecheck:extensions to pretest to prevent silent type drift
  • gsd: relax integration-proof cross-validation for table-format roadmap
  • gsd: update integration-proof tests for table-format roadmap projections
  • gsd: update test assertions for schema v11, prompt changes, and removed completedUnits
  • gsd: update test files for removed completedUnits, writeLock signature, and type changes
  • gsd: remove stale completedUnits refs, fix writeLock callers, add missing imports
  • gsd: harden single-writer engine — close TOCTOU, intercept bypasses, status inconsistencies
  • write-intercept: close bare-relative-path bypass in STATE.md regex
  • voice: fix misleading portaudio error on PEP 668 Linux systems (#2403) (#2407)
  • core: address PR review feedback for non-apikey provider support (#2452)
  • ci: retry npm install in pipeline to handle registry propagation delay (#2462)
  • gsd: change default isolation mode from worktree to none (#2481)
  • loader: add startup checks for Node version and git availability (#2463)
  • gsd: add worktree lifecycle events to journal (#2486)
v2.45.0 March 25, 2026
Highlights Added: make web UI mobile responsive · Changed: migrate D-G test files from createTestContext to node:test · Fixed: handle retentionDays=0 on Windows + run windows-portability on PRs

Added

  • web: make web UI mobile responsive (#2354)
  • gsd: add /gsd rethink command for conversational project reorganization (#2459)
  • gsd: add renderCall/renderResult previews to DB tools (#2273)
  • add timestamps on user and assistant messages (#2368)
  • gsd: add /gsd mcp command for MCP server status and connectivity (#2362)
  • complete offline mode support (#2429)
  • system-context: inject global ~/.gsd/agent/KNOWLEDGE.md into system prompt (#2331)

Fixed

  • gsd: handle retentionDays=0 on Windows + run windows-portability on PRs (#2460)
  • use Array.from instead of Buffer.from for native processStreamChunk state (#2348)
  • gsd: isInheritedRepo conflates ~/.gsd with project .gsd when git root is $HOME (#2398)
  • reconcile disk milestones missing from DB in deriveStateFromDb (#2416) (#2422)
  • auto: reset recoveryAttempts on unit re-dispatch (#2322) (#2424)
  • detect and preserve submodule state during worktree teardown (#2337) (#2425)
  • auto-start: handle survivor branch recovery in phase=complete (#2358) (#2427)
  • gsd: widen test search window for CRLF portability on Windows (#2458)
  • gsd: preserve rich task plans on DB roundtrip (#2450) (#2453)
  • merge worktree back to main when stopAuto is called after milestone completion (#2317) (#2430)
  • gsd: skip doctor directory checks for pending slices (#2446)
  • gsd: migrate completion/validation prompts to DB-backed tools (#2449)
  • gsd: prevent saveArtifactToDb from overwriting larger files with truncated content (#2442) (#2447)
  • stop auto loop on real code merge conflicts (#2330) (#2428)
  • classify terminated/connection errors as transient in provider error handler (#2309) (#2432)
  • archive completed-units.json on milestone transition and sync metrics.json (#2313) (#2431)
  • supervision timeouts now respect task est: annotations (#2243) (#2434)
  • auto_pr: true now actually creates PRs — fix 3 interacting bugs (#2302) (#2433)
  • gsd: insert DB row when generating milestone ID (#2416)
  • gsd: reconcile disk-only milestones into DB in deriveStateFromDb (#2416)
  • preferences: deduplicate unrecognized format warning on repeated loads (#2375)
  • gate auto-mode bootstrap on SQLite availability (#2419) (#2421)
  • block /gsd quick when auto-mode is active (#2420)
  • ci: add Rust target for all platforms, not just cross-compilation
  • ci: restore Rust target triple and separate cross-compilation setup
  • ci: separate cross-compilation target from toolchain install

Changed

  • migrate D-G test files from createTestContext to node:test (#2418)
  • test: replace try/finally with beforeEach/afterEach in packages tests (#2390)
  • test: migrate gsd/tests s-z from custom harness to node:test (#2397)
  • test: migrate gsd/tests o-r from custom harness to node:test (#2401)
  • test: migrate gsd/tests i-n from custom harness to node:test (#2399)
  • test: migrate gsd/tests a-c from custom harness to node:test (#2400)
  • test: replace try/finally with t.after() in gsd/tests (e-i) (#2396)
  • test: replace try/finally with t.after() in gsd/tests (a-d) (#2395)
  • test: replace try/finally with t.after() in src/tests (o-z) (#2392)
  • test: replace try/finally with t.after() in src/tests (a-n) (#2394)
v2.44.0 March 24, 2026

What&#39;s New

DB-Backed Planning Engine

The planning system now uses atomic SQLite operations instead of markdown file mutation. This is the biggest architectural change in this release — state transitions are now transactional, concurrent-safe, and recoverable. File-based fallbacks ensure backward compatibility when the DB is unavailable.

Features

  • Per-prompt token cost display — see cost per prompt in the footer (enable via show_token_cost preference) (#2357)
  • Change project root from web UI — switch projects without restarting (#2355)
  • Docker sandbox template — official Docker template for isolated auto mode (#2360)
  • Non-API-key provider support — extensions like Claude Code CLI can now authenticate without API keys (#2382)

Bug Fixes

  • Planning data integrity — prevent data loss from destructive upsert and post-unit re-import (#2370)
  • Memory and resource leaks — fix leaks across TUI, LSP, DB, and automation subsystems (#2314)
  • TypeScript detection in .js files — detect TS syntax and suggest renaming (#2386)
  • SQLite WAL handling — add missing WAL sidecars and journal to runtime exclusion lists (#2299)
  • Auto-stash before merge — dirty working tree files are auto-stashed before squash merge (#2298)
  • Subprocess module resolution — resolve compiled .js modules correctly under node_modules (#2320)
  • Decision persistence — preserve freeform DECISIONS.md content on save (#2319)
  • Provider restoration — restore alibaba-coding-plan provider via custom models (#2350)
  • Doctor checks — skip false env_dependencies errors in auto-worktrees (#2318)
  • DB pragmas and rollback safety — add busy_timeout, foreign_keys, and safe render-failure handling (#2410)
  • Windows compatibility — fix CRLF assertions, EPERM cleanup, and path normalization in tests
  • CI stability — process-level test isolation to prevent cross-test state leakage

Infrastructure

  • Add CODEOWNERS and team workflow documentation (#2286)
  • Migrate CI runners to Blacksmith for faster builds
  • Fix Rust cross-compilation target resolution for ARM64 builds
v2.43.0 March 23, 2026
Highlights Added: opt-in duplicate detection before issue creation · Changed: startup optimizations — pre-compiled extensions, compile cache, batch discovery · Fixed: prevent banner from printing twice on first run

Added

  • forensics: opt-in duplicate detection before issue creation (#2105)

Fixed

  • prevent banner from printing twice on first run (#2251)
  • test: Windows CI — use double quotes in git commit message (#2252)
  • async-jobs: suppress duplicate follow-up for awaited job results (#2248) (#2250)
  • gsd: remove force-staging of .gsd/milestones/ through symlinks (#2247) (#2249)
  • gsd: remove over-broad skill activation heuristic (#2239) (#2244)
  • auth: fall through to env/fallback when OAuth credential has no registered provider (#2097)
  • lsp: bound message buffer and clean up stale client state (#2171)
  • clean up macOS numbered .gsd collision variants (#2205) (#2210)
  • search: keep duplicate-search loop guard armed (#2117)
  • clean up extension error listener on session dispose (#2165)
  • web: resolve 4 pre-existing onboarding contract test failures (#2209)
  • async bash job timeout hangs indefinitely instead of erroring out (#2214)
  • gsd: apply fast service tier outside auto-mode (#2126)
  • interactive: clean up leaked SIGINT and extension selector listeners (#2172)
  • ci: standardize GitHub Actions and Node.js versions (#2169)
  • native: resolve memory leaks in glob, ttsr, and image overflow (#2170)
  • extension resource management — prune stale dirs, fix isBuiltIn, gate skills on Skill tool, suppress search warnings (#2235)
  • batch isolated fixes — error messages, preferences, web auth, MCP vars, detection, gitignore (#2232)
  • document iTerm2 Ctrl+Alt+G keybinding conflict and add helpful hint (#2231)
  • footer: display active inference model during execution (#1982)
  • web: kill stale server process before launch to prevent EADDRINUSE (#1934) (#2034)
  • git: force LC_ALL=C in GIT_NO_PROMPT_ENV to support non-English locales (#2035)
  • forensics: force gh CLI for issue creation to prevent misrouting (#2067) (#2094)
  • force-stage .gsd/milestones/ artifacts when .gsd is a symlink (#2104) (#2112)
  • pi-ai: correct Copilot context window and output token limits (#2118)

Changed

  • startup optimizations — pre-compiled extensions, compile cache, batch discovery (#2125)
v2.42.0 March 22, 2026
Highlights Added: declarative workflow engine — YAML-defined workflows through the auto-loop · Fixed: wrap rmSync cleanup in try/catch for Windows EPERM

Added

  • gsd: declarative workflow engine — YAML-defined workflows through the auto-loop (#2024)
  • gsd: unified rule registry, event journal, journal query tool, and tool naming convention (#1928)
  • ci: PR risk checker — classify changed files by system and surface risk level (#1930)
  • ADR attribution — distinguish human vs agent vs collaborative decisions (#1830)
  • add /gsd fast command and gate service tier icon to supported models (#1848) (#1862)
  • add --host, --port, --allowed-origins flags for web mode (#1847) (#1873)

Fixed

  • tests: wrap rmSync cleanup in try/catch for Windows EPERM
  • tests: add maxRetries to rmSync cleanup for Windows EPERM compatibility
  • recursive key sorting in tool-call loop guard hash function (#1962)
  • use path.sep for cross-platform path traversal guards and test assertions
  • tests: use cross-platform path split in run-manager timestamp test
  • prevent SIGTSTP crash on Windows (#2018)
  • add missing codeFilesChanged to journal integration test mock
  • repo-identity: use native realpath on Windows to resolve 8.3 short paths (#1960)
  • doctor: gate roadmap checkbox on summary existing on disk, not issue detection (#1915)
  • warn when milestone merge contains only metadata and no code (#1906) (#1927)
  • worktree: resolve 8.3 short paths and use shell mode for .bat hooks on Windows (#1956)
  • web: persist auth token in sessionStorage to survive page refreshes (#1877)
  • clean up SQUASH_MSG after squash-merge and guard worktree teardown against uncommitted changes (#1868)
  • populate RecoveryContext in hook unit supervision to prevent crash on stalled tool recovery (#1867)
  • resolve worktree path from git registry when .gsd/ symlink is shadowed (#1866)
  • resolve Node v24 web boot failure — ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING (#1864)
  • auto: broaden worktree health check to all ecosystems (#1860)
  • doctor: cascade slice uncheck when task_done_missing_summary unchecks tasks (#1850) (#1858)
  • defend exit path against ESM module cache mismatch (#1854)
  • escape parentheses in paths before bash shell-out, fix __extensionDir fallback (#1872)
  • use PowerShell Start-Process for Windows browser launch, prevent URL wrapping (#1870)
  • clear stale unit state and restore CWD when step-wizard exits auto-loop (#1869)
  • prevent cross-project state leak in brand-new directories (#1639) (#1861)
  • reconcile worktree HEAD with milestone branch ref before squash merge (#1846) (#1859)
  • normalize Windows backslash paths in bash command strings (#1436) (#1863)
  • parsePlan and verifyExpectedArtifact recognize heading-style task entries (#1691) (#1857)
  • sync all milestone dirs regardless of naming convention (#1547) (#1845)
v2.41.0 March 21, 2026
Highlights Added: worktree lifecycle checks, cleanup consolidation, enhanced /worktree list · Changed: split shared/mod.ts into pure and TUI-dependent barrels · Fixed: skip web build on Windows — Next.js webpack hits EPERM on system dirs

Added

  • doctor: worktree lifecycle checks, cleanup consolidation, enhanced /worktree list (#1814)
  • web: browser-based web interface (#1717)
  • ci: skip build/test for docs-only PRs and add prompt injection scan (#1699)
  • docs: add Custom Models guide and update related documentation (#1670)
  • surface doctor issue details in progress score widget and health views (#1667)
  • cleanup: add ~/.gsd/projects/ orphan detection and pruning (#1686)

Fixed

  • skip web build on Windows — Next.js webpack hits EPERM on system dirs
  • include web build in main build command
  • fall through to prose slice parser when checkbox parser yields empty under ## Slices (#1744)
  • auto: verify merge anchored before worktree teardown (#1829)
  • auto: reject execute-task with zero tool calls as hallucinated (#1838)
  • also convert --import resolver path to file URL for Windows
  • use pathToFileURL for Windows-safe ESM import in verification-gate test
  • gsd: read depends_on from CONTEXT-DRAFT.md when CONTEXT.md is absent (#1743)
  • roadmap: detect ✓ completion marker in prose slice headers (#1816)
  • auto: reverse-sync root-level .gsd files on worktree teardown (#1831)
  • tui: prevent freeze when using @ file finder (#1832)
  • prevent silent data loss when milestone merge fails due to dirty working tree (#1752)
  • verification: avoid DEP0190 by passing command to shell explicitly (#1827)
  • state: treat zero-slice roadmap as pre-planning instead of blocked (#1826)
  • hooks: process depth verification in queue mode (#1823)
  • auto: register SIGHUP/SIGINT handlers to clean lock files on crash (#1821)
  • auto-dispatch discussion instead of hard-stopping on needs-discussion phase (#1820)
  • doctor: fix roadmap checkbox and UAT stub immediately instead of deferring (#1819)
  • auto: resolve pending unitPromise in stopAuto to prevent hang (#1818)
  • git: handle unborn branch in nativeBranchExists to prevent dispatch deadlock (#1815)
  • doctor: prevent cleanup from deleting user work files (#1825)
  • use realpathSync.native on Windows to resolve 8.3 short paths
  • detect and skip ghost milestone directories in deriveState() (#1817)
  • create milestone directory when triage defers to a not-yet-existing milestone (#1813)
  • add @gsd/pi-tui to test module resolver in dist-redirect (#1811)
  • surface unmapped active requirements when all milestones complete (#1805)
  • normalize paths in tests to handle Windows 8.3 short-path forms (#1804)
  • share milestone ID reservation between preview and tool (#1569) (#1802)
  • tui,gsd: tool-call loop guard + TUI stack overflow prevention (#1801)
  • validate paused-session milestone before restoring it (#1664) (#1800)
  • detect REPLAN-TRIGGER.md in deriveState for triage-initiated replans (#1798)
  • dispatch uat targets last completed slice instead of activeSlice (#1693) (#1796)
  • read depends_on from CONTEXT-DRAFT.md when CONTEXT.md absent (#1795)
  • worktree: sync root-level files and all milestone dirs on worktree teardown (#1794)
  • dashboard highlights UAT target slice instead of advanced activeSlice (#1793)
  • dispatch guard skips completed milestones with SUMMARY file (#1791)
  • ensureDbOpen creates DB + migrates Markdown in interactive sessions (#1790)
  • add require condition to pi-tui exports for CJS resolution
  • update integration test to match dependency-aware dispatch guard wording
  • use createRequire instead of bare require for lazy pi-tui import
  • update doctor-git test to match PR #1633 behavior change
  • increase resolveProjectRootFromGitFile walk-up limit from 10 to 30
  • include ensure-workspace-builds.cjs in npm package files
  • resolve extension typecheck errors in test files
  • resolve CI build errors from Wave 4+5 merges
  • return retry from postUnitPreVerification when artifact verification fails (#1571) (#1782)
  • hook model field uses model-router resolution instead of Claude-only registry (#1720) (#1781)
  • stop auto-mode immediately on infrastructure errors (ENOSPC, ENOMEM, etc.) (#1780)
  • add missing milestones/ segment in resolveHookArtifactPath (#1779)
  • break needs-discussion infinite loop when survivor branch exists (#1726) (#1778)
  • tear down browser sessions at unit boundaries and in stopAuto (#1733) (#1777)
  • rebuild STATE.md and reset completed-units on milestone transition (#1576) (#1775)
  • resolve pending unit promise on all exit paths to prevent orphaned auto-loop (#1774)
  • closeout unit on pause and heal runtime records on resume (#1625) (#1773)
  • call selfHealRuntimeRecords before autoLoop to clear orphaned dispatched records (#1772)
  • dispatch guard uses dependency declarations instead of positional ordering (#1638) (#1770)
  • add configurable timeout to await_job to prevent indefinite session blocking (#1769)
  • parallel: restore orchestrator state from session files and add worker stderr logging (#1748)
  • prevent getLoadedSkills crash and auto-build workspace packages (#1767)
  • session lock multi-path cleanup and false positive hardening (#1578) (#1765)
  • robust node_modules symlink handling to prevent extension loading failures (#1762)
  • lazy-load @gsd/pi-tui in shared/ui.ts to prevent /exit crash (#1761)
  • validate worktree .git file and fix metrics toolCall casing (#1713) (#1754)
  • verify implementation artifacts before milestone completion (#1703) (#1760)
  • make task closeout crash-safe by unchecking orphaned checkboxes (#1650) (#1759)
  • preserve milestone branch on merge-back during transitions (#1573) (#1758)
  • write crash lock after newSession so it records correct session path (#1757)
  • handle symlinked .gsd in git add pathspec exclusions (#1712) (#1756)
  • guard worktree teardown on empty merge to prevent data loss (#1672) (#1755)
  • resolve symlinks in doctor orphaned-worktree check (#1715) (#1753)
  • silence spurious extension load error for non-extension libraries (#1709) (#1747)
  • reset completion state when post_unit_hooks retry_on signal is consumed (#1746)
  • route needs-discussion phase to showSmartEntry, preventing infinite /gsd loop (#1745)
  • roadmap: parse table-format slices in roadmap files (#1741)
  • extract milestone title from CONTEXT.md when ROADMAP is missing (#1729)
  • gsd: harden auto-mode telemetry — metrics idempotency, elapsed guard, title sanitization (#1722)
  • gsd: make saveJsonFile atomic via write-tmp-rename pattern (#1719)
  • gsd: syncWorktreeStateBack recurses into tasks/ subdirectory (#1678) (#1718)
  • prevent parallel worktree path resolution from escaping to home directory (#1677)
  • add web search budget awareness to discuss and queue prompts (#1702)
  • harden auto-mode against stale integration metadata and Windows file locks (#1633)
  • autocomplete: repair /gsd skip, add widget/next completions, add discuss to hint (#1675)
  • search: keep loop guard armed after firing to prevent infinite loop restart (#1671) (#1674)
  • worktree: detect default branch instead of hardcoding "main" on milestone merge (#1668) (#1669)
  • remove duplicate TUI header rendered on session_start (#1663)
  • worktree: recurse into tasks/ when syncing slice artifacts back to project root (#1678) (#1681)

Changed

  • split shared/mod.ts into pure and TUI-dependent barrels (#1807)
  • replace hardcoded /tmp paths with os.tmpdir()/homedir() (#1708)
  • ci: reduce pipeline minutes with shallow clones, npm caching, and exponential backoff (#1700)
  • split auto-loop.ts monolith into auto/ directory modules (#1682)
v2.40.0 March 20, 2026
Highlights Added: add Skill tool resolution · Changed: decompose autoLoop into pipeline phases (#1615) · Fixed: prune stale env-utils.js from extensions root, preventing startup load error

Added

  • pi: add Skill tool resolution (#1661)
  • health check phase 2 — real-time doctor issue visibility across widget, visualizer, and HTML reports (#1644)
  • upgrade forensics prompt to full-access GSD debugger (#1660)

Fixed

  • prune stale env-utils.js from extensions root, preventing startup load error (#1655)
  • splash: replace box corners with full-width bars for visual unity with auto-mode widget (#1654)
  • add runtime paths to forensics prompt to prevent path hallucination (#1657)
  • guard TUI render during session transitions to prevent freeze (#1658)
  • default UAT type to artifact-driven to prevent unnecessary auto-mode pauses (#1651)
  • cancel trailing async jobs on session switch to prevent wasted LLM turns (#1643)

Changed

  • decompose autoLoop into pipeline phases (#1615) (#1659)
v2.39.0 March 20, 2026
Highlights Added: activate matching skills in dispatched prompts · Changed: unify sidecar mini-loop into main dispatch path · Fixed: recover + prevent #1364 .gsd/ data-loss (v2.30.0–v2.38.0)

Added

  • gsd: activate matching skills in dispatched prompts (#1630)
  • gsd: add .gsd/RUNTIME.md template for declared runtime context (#1626)
  • gsd: create draft PR on milestone completion when git.auto_pr enabled (#1627)
  • gsd: add browser-executable and runtime-executable UAT types (#1620)
  • apply model preferences in guided flow for milestone planning (#1614)
  • gsd: GitHub sync extension — auto-sync to Issues, PRs, Milestones (#1603)
  • add GSD_PROJECT_ID env var to override project hash (#1600)
  • add GSD_HOME env var to override global ~/.gsd directory (#1566)
  • gsd: add 13 enhancements to /gsd doctor (#1583)
  • feat(ui): minimal GSD welcome screen on startup (#1584)

Fixed

  • recover + prevent #1364 .gsd/ data-loss (v2.30.0–v2.38.0) (#1635)
  • treat summary as terminal artifact even when roadmap slices are unchecked (#1632)
  • gsd: close residual #1364 data-loss vectors on v2.36.0+ (#1637)
  • auto-resolve npm subpath exports in extension loader (#1624)
  • create node_modules symlink for dynamic import resolution in extensions (#1623)
  • filter cross-milestone errors from health tracker escalation (#1621)
  • move unit closeout to run immediately after completion (#1612)
  • use pathspec exclusions in smartStage to prevent hanging on large repos (#1613)
  • add auto-fix for premature slice completion deadlock in doctor (#1611)
  • resolve ${VAR} env references in MCP client .mcp.json configs (#1609)
  • return "dispatched" after doctor heal to prevent session race (#1580) (#1610)
  • update Anthropic OAuth endpoints to platform.claude.com (#1608)
  • lazy-open GSD database on first tool call in manual sessions (#1606)
  • gsd: detect anthropic-vertex in provider doctor (#1598)
  • gsd: tighten prompt automation contracts (#1556)
  • gsd: harden auto-mode agent loop — session teardown, unit correlation, sidecar perf (#1592)
  • break remaining shared/mod.js barrel imports in report generation chain (#1588)
  • apply pi manifest opt-out to extension-discovery.ts (#1545)
  • detect worktree paths resolved through .gsd symlinks (#1585)

Changed

  • gsd: unify sidecar mini-loop into main dispatch path (#1617)
  • auto-loop: initial cleanup — hoist constant, cache prefs per iteration (#1616)
  • gsd: add 30K char hard cap on prompt preamble (#1619)
  • gsd: replace stuck counter with sliding-window detection (#1618)
  • auto-loop: 5 code smell fixes (#1602)
  • gsd: replace session-scoped promise bridge with per-unit one-shot (#1595)
  • gsd: remove prompt compression subsystem (~4,100 lines) (#1597)
  • gsd: crashproof stopAuto with independent try/catch per cleanup step (#1596)
v2.38.0 March 20, 2026
Highlights Added: ADR-004 — derived-graph reactive task execution · Fixed: reduce GitHub Actions minutes ~60-70% (~10k → ~3-4k/month)

Added

  • gsd: ADR-004 — derived-graph reactive task execution (#1546)
  • add anthropic-vertex provider for Claude on Vertex AI (#1533)

Fixed

  • ci: reduce GitHub Actions minutes ~60-70% (~10k → ~3-4k/month) (#1552)
  • gsd: reactive batch verification + dependency-based carry-forward (#1549)
  • gsd: enforce backtick file paths in task plan IO sections (#1548)
v2.37.1 March 20, 2026
Highlights Fixed: interactive guard menu for remote auto-mode sessions (#1507)

Fixed

  • interactive guard menu for remote auto-mode sessions (#1507) (#1524)
  • use pull_request_target so AI triage has secret access on PRs
  • cmux library directory incorrectly loaded as extension (#1537)
  • separate pi-tui-dependent layout utils to fix report generation (#1527)
  • clarify session lock loss diagnostics (#1535)
  • #1526: auto-mode worktree commits land on main instead of milestone branch (#1534)
v2.37.0 March 20, 2026
Highlights Added: two-column layout with redesigned widget · Fixed: add session-level search budget to prevent unbounded native web search (#1309)

Added

  • dashboard: two-column layout with redesigned widget (#1530)
  • integrate cmux with gsd runtime (#1532)

Fixed

  • add session-level search budget to prevent unbounded native web search (#1309) (#1529)
v2.36.0 March 20, 2026
Highlights Added: deprecate agent-instructions.md in favor of AGENTS.md / CLAUDE.md (#1492) · Fixed: preserve user messages during abort with origin-aware queue clearing (#1439)

Added

  • deprecate agent-instructions.md in favor of AGENTS.md / CLAUDE.md (#1492) (#1514)
  • AI-powered issue and PR triage via Claude Haiku (#1510)

Fixed

  • preserve user messages during abort with origin-aware queue clearing (#1439) (#1521)
  • remove broken SwiftUI skill and add CI reference check (#1476) (#1520)
  • wire escalateTier into auto-loop retry path (#1505) (#1519)
  • prevent bare /gsd from stealing session lock from running auto-mode (#1507) (#1517)
  • wire dead token-profile defaults and add /gsd rate command (#1505) (#1516)
  • prevent false-positive session lock loss during sleep/event loop stalls (#1512) (#1513)
  • gsd: filter non-milestone directories from findMilestoneIds (#1494) (#1508)
  • gsd: accept &#39;passed&#39; as terminal validation verdict (#1429) (#1509)
  • add missing imports breaking CI build (#1511)
  • prevent ensureGitignore from adding .gsd when tracked in git (#1364) (#1367)
  • check project root .env when secrets gate runs in worktree (#1387) (#1470)
  • realign cwd before dispatch + clean stale merge state on failure (#1389) (#1400)
  • create milestones/ directory in worktree when missing (#1374)
  • inject network_idle warning into hook prompts (#1345) (#1401)
  • verify symlink after migration + fix test failures (#1377) (#1404)
  • validate CWD instead of project root when running from a GSD worktree (#1317) (#1504)
  • gsd: detect initialized health widget projects (#1432)
  • smarter .gsd root discovery — git-root anchor + walk-up replaces symlink hack (#1386)
  • correct GSD-WORKFLOW.md fallback path and sync to agentDir (#1375)
  • always include reasoning.encrypted_content for OpenAI reasoning models
  • gsd: avoid EISDIR crash in file loader
  • gsd: open existing database on inspect
v2.35.0 March 19, 2026
Highlights Added: add /gsd changelog command with LLM-summarized release notes · Changed: deduplicate error emission and message patterns in agent-core · Fixed: restore lsp single-server selector export

Added

  • gsd: add /gsd changelog command with LLM-summarized release notes (#1465)

Fixed

  • restore lsp single-server selector export
  • mcp: preserve args for mcp_call tool invocations (#1354)
  • accumulate session cost independently of message array (#1423)
  • resolve CI failures — scope provider check, fix Windows path, correct severity
  • close 5 doctor coverage gaps — providers, lock dir, integration branch, orphaned worktrees
  • add PID self-check to guided-flow crash lock detection (#1398)
  • prefs: close merge, validation, serialization, and docs gaps

Changed

  • deduplicate error emission and message patterns in agent-core (#1444)
  • simplify settings manager with generic setter helpers (#1461)
  • consolidate theme files and remove manual schema (#1478)
  • extract overlay layout and compositing from TUI into separate module (#1482)
  • extract slash command handlers from interactive-mode (#1485)
  • remove dead code (unused exports) (#1486)
  • extract retry handler and compaction orchestrator from agent-session
  • deduplicate rendering patterns in markdown and keys
  • consolidate shared code between OpenAI providers
  • deduplicate RPC mode shared patterns
  • extract shared tree rendering utilities
  • consolidate OAuth callback server and helper utilities
  • extract shared file lock utilities
  • consolidate resource loader with generic update/dedupe methods
  • consolidate model switching logic in agent-session
  • extract shared helpers in compaction module
  • deduplicate toPosixPath, ZERO_USAGE, and shortenPath utilities
  • consolidate 9 emit methods in extension runner into shared invokeHandlers
  • consolidate extension type guards and inline handler type aliases
  • consolidate duplicate patterns in LSP module
v2.34.0 March 19, 2026
Highlights Added: auto-generate OpenRouter model registry from API + add missing models (#1407) · Changed: **auto-mode: replace reactive callback graph with linear execution loop** — refactors auto-mode orchestration from a … · Fixed: release stranded bootstrap locks and handle re-entrant reacquire

Changed

  • auto-mode: replace reactive callback graph with linear execution loop — refactors auto-mode orchestration from a recursive event-driven dispatch system into a while (active) loop. Deletes ~8,300 lines of compensatory machinery (stuck detection, reentrancy guards, session locks, idempotency checks, gap watchdogs) that existed to work around structural flaws in the old architecture. Replaces with ~1,400 lines across auto-loop.ts, worktree-resolver.ts, and auto-worktree-sync.ts. Bug classes like silent stalls, skip/redispatch loops, and zombie active-but-idle states are now structurally impossible. deriveState() is sole authority for phase progression. Post-unit work (hooks, triage, quick-tasks) runs via sidecar queue instead of nested inline dispatch. 67 files changed, +5,245 / -8,296. (#1419)

Added

  • auto-generate OpenRouter model registry from API + add missing models (#1407) (#1426)

Fixed

  • release stranded bootstrap locks and handle re-entrant reacquire (#1352)
  • add JS fallbacks for wrapTextWithAnsi and visibleWidth when native addon unavailable (#1418) (#1428)
  • emit agent_end after abort during tool execution (#1414) (#1417)
  • auto-discard bootstrap crash locks and clean auto.lock on exit (#1397)
  • harden quick-task branch lifecycle — disk recovery + integration branch guard (#1342)
  • skip verification retry on spawn infra errors (ETIMEDOUT, ENOENT) (#1340)
  • keep external GSD state stable in worktrees (#1334)
  • stop excluding all .gsd/ from commits — only exclude runtime files (#1326) (#1328)
  • handle ECOMPROMISED in uncaughtException guard and align retry onCompromised (#1322) (#1332)
v2.33.1 March 19, 2026
Highlights Changed: remove orphaned mcporter extension manifest · Fixed: clean up stale numbered lock files and harden signal/exit handling (#1315)

Fixed

  • clean up stale numbered lock files and harden signal/exit handling (#1315) (#1323)
  • worktree sync and home-directory safety check (#1311, #1317) (#1322)

Changed

  • remove orphaned mcporter extension manifest (#1318)
v2.33.0 March 19, 2026
Highlights Added: add live regression test harness for post-build pipeline validation · Changed: extract tryMergeMilestone to eliminate 4 duplicate merge paths in auto.ts · Fixed: align retry lock path with primary lock settings to prevent ECOMPROMISED

Added

  • add live regression test harness for post-build pipeline validation (#1316)

Fixed

  • align retry lock path with primary lock settings to prevent ECOMPROMISED (#1307)
  • skip symlinks in makeTreeWritable to prevent EPERM on NixOS/nix-darwin (#1303)
  • handle Windows EPERM on .gsd migration rename with copy+delete fallback (#1296)
  • add actionable recovery guidance to crash info messages (#1295)
  • resolve main repo root in worktrees for stable identity hash (#1294)
  • merge quick-task branch back to original after completion (#1293)

Changed

  • extract tryMergeMilestone to eliminate 4 duplicate merge paths in auto.ts (#1314)
  • dispatch loop hardening — defensive guards, regression tests, lock alignment (#1310)
  • extract parseUnitId() to centralize unit ID parsing (#1282)
  • extract getErrorMessage() helper to eliminate 65 inline duplicates (#1280)
  • consolidate DB-fallback inline functions in auto-prompts (#1276)
v2.32.0 March 19, 2026
Highlights Added: always-on health widget and visualizer health tab expansion · Changed: deduplicate knownUnitTypes and STATE_REBUILD_MIN_INTERVAL_MS constants · Fixed: skip crash recovery when auto.lock was written by current process

Added

  • always-on health widget and visualizer health tab expansion (#1286)
  • environment health checks, progress score, and status integration (#1263)

Fixed

  • skip crash recovery when auto.lock was written by current process (#1289)
  • load worktree-cli extension modules via jiti instead of static ESM imports (#1285)
  • gsd: prevent concurrent dispatch during skip chains (#1272) (#1283)
  • skip non-artifact UAT dispatch in auto-mode (#1277)

Changed

  • deduplicate knownUnitTypes and STATE_REBUILD_MIN_INTERVAL_MS constants (#1281)
  • extract prompt builder helpers for inlined context and source file lists (#1279)
  • extract createGitService() factory, remove debug logs (#1278)
  • extract dispatchUnit helper, inline dead buildDocsCommitInstruction (#1275)
  • unify unit-type switch statements into lookup map (#1273)
v2.31.2 March 18, 2026
Highlights Fixed: stop replaying completed run-uat units

Fixed

  • gsd: stop replaying completed run-uat units (#1270)
v2.31.1 March 18, 2026
Highlights Fixed: prevent false-positive 'Session lock lost' during auto-mode

Fixed

  • prevent false-positive &#39;Session lock lost&#39; during auto-mode (#1257)
v2.31.0 March 18, 2026
Highlights Added: add aws-auth extension for automatic Bedrock credential refresh · Changed: remove dead commit_docs preference (incompatible with external .gsd/ state) · Fixed: remove stale git-commit assertion in worktree test after commit_docs removal

Added

  • add aws-auth extension for automatic Bedrock credential refresh (#1253)
  • add -w/--worktree CLI flag for isolated worktree sessions (#1247)

Fixed

  • remove stale git-commit assertion in worktree test after commit_docs removal
  • remove commit_docs test that broke CI after type removal (#1258)
  • replace blanket git clean .gsd/ with targeted runtime file removal (#1252)
  • invalidate caches inside discuss loop to detect newly written slice context (#1249)
  • robust prose slice header parsing — handle H1-H4, bold, dots, no-separator variants (#1248)
  • clean up stranded .gsd.lock/ directory to prevent false lock conflicts (#1251)

Changed

  • remove dead commit_docs preference (incompatible with external .gsd/ state) (#1258)
v2.30.0 March 18, 2026
Highlights Added: add extension manifest + registry for user-managed enable/disable · Changed: move .gsd/ to external state directory with symlink (ADR-002) · Fixed: align react-best-practices skill name with directory name

Added

  • add extension manifest + registry for user-managed enable/disable (#1238)
  • add model health indicator to auto-mode progress widget (#1232)
  • simplify auto pipeline — merge research into planning, mechanical completion (ADR-003) (#1235)
  • add create-gsd-extension skill (#1229)
  • add built-in skill authoring system (ADR-003) (#1228)
  • prefs: two-step provider→model picker in preferences wizard (#1218)
  • workflow templates — right-sized workflows for every task type (#1185)

Fixed

  • align react-best-practices skill name with directory name (#1234)
  • gate slice progression on UAT verdict, not just file existence (#1241)
  • invalidate caches before roadmap check in /gsd discuss (#1240)
  • use shell: true for LSP spawn on Windows to resolve .cmd executables (#1233)
  • increase headless new-milestone timeout and limit investigation scope (#1230)
  • clean untracked .gsd/ files before squash-merge to prevent failure (#1239)
  • graceful fallback when native addon is unavailable on unsupported platforms (#1225)
  • replace ambiguous double-question in discussion reflection step (#1226)
  • kill non-persistent bg processes between auto-mode units (#1217)
  • Two-column dashboard layout with task checklist (#1195)

Changed

  • move .gsd/ to external state directory with symlink (ADR-002) (#1242)
  • replace MCPorter with native MCP client (#1210)
  • extend json-persistence utility and migrate top JSON I/O callsites (#1216)
  • deduplicate dispatchDoctorHeal — keep single copy in commands-handlers.ts (#1211)
  • remove facade re-exports from auto.ts — import directly from source modules (#1214)
  • extract shared HTTP client for remote-questions adapters (#1212)
v2.29.0 March 18, 2026
Highlights Added: add searchExcludeDirs setting for @ file autocomplete blacklist · Changed: extract numeric validation helpers in prefs wizard · Fixed: add npm publish to prod-release and prevent mid-deploy cancellation

Added

  • add searchExcludeDirs setting for @ file autocomplete blacklist (#1202)
  • ci: automate prod-release with version bump, changelog, and tag push (#1194)
  • auto-open HTML reports in default browser on manual export (#1164)
  • upgrade to Node.js 24 LTS across CI, Docker, and package config (#1165)
  • add /gsd logs command to browse activity, debug, and metrics logs (#1162)
  • browser-tools: configurable screenshot resolution, format, and quality (#1152)
  • add pre-commit secret scanner and CI secret detection (#1148)
  • mcporter: add .gsd/mcp.json per-project MCP config support (#1141)
  • metrics: add API request counter for copilot/subscription users (#1140)
  • per-milestone depth verification + queue-flow write-gate (#1116)
  • add OSC 8 clickable hyperlinks for file paths in export notifications (#1114)
  • park/discard actions for in-progress milestones (#1107)
  • ci: implement three-stage promotion pipeline (Dev → Test → Prod) (#1098)
  • cache-ordered prompt assembly and dashboard cache hit rate (#1094)
  • add comprehensive API key manager (/gsd keys) (#1089)
  • ci: add multi-stage Dockerfile for CI builder and runtime images
  • gsd: add directory safeguards for system/home paths (#1053)
  • enhance HTML report with derived metrics, visualizations, and interactivity (#1078)
  • auto-extract lessons to KNOWLEDGE.md on slice/milestone completion (#711) (#1081)
  • auto-create PR on milestone completion (#687) (#1084)
  • wire semantic chunking, add preferences, metrics, and docs
  • add token optimization suite for prompt caching, compression, and smart context selection
  • autocomplete: add /thinking completions, GSD subcommand descriptions, and test coverage (#1019)
  • add respectGitignoreInPicker setting for @ file picker (#979) (#1016)
  • prefs: add search_provider to preferences.md (#1001)
  • add --events flag for JSONL stream filtering (#1000)
  • add 10 bundled skills for UI, quality, and code optimization (#999)
  • ux: group model list by provider in /gsd prefs wizard (#993)
  • add --answers flag for headless answer injection (#982)
  • add project onboarding detection and init wizard

Fixed

  • ci: add npm publish to prod-release and prevent mid-deploy cancellation (#1208)
  • ci: use env var for Discord webhook secret in if-condition
  • complete shared barrel exports and add import-claude to help text (#1198)
  • broaden unit-runtime path sanitization to strip all unsafe characters
  • detect stale bundled resources via content fingerprint (#1193)
  • include promptGuidelines in customPrompt path of buildSystemPrompt (#1187)
  • prevent branch-mode merge fallback from firing in worktree isolation (#1183)
  • treat auto-discovered verification failures as advisory, not blocking (#1188)
  • ci: remove @latest npm promotion from pipeline
  • ci: skip GitHub release creation when tag already exists
  • handle Windows non-ASCII paths in cpSync with copyFileSync fallback (#1181)
  • non-blocking verification gate for auto-discovered commands (#1177)
  • add defensive guards against undefined .filter() in auto-mode dispatch/recovery (#1180)
  • sync living docs (DECISIONS/REQUIREMENTS/PROJECT/KNOWLEDGE) between worktree and project root (#1173)
  • route needs-discussion phase to interactive flow instead of stopping (#1175)
  • run resource-skew check before early TTY gate
  • move TTY check before heavy initialization to prevent process hang
  • ci: skip init smoke test in non-TTY CI environments (#1172)
  • ci: skip publish when version already exists on npm (#1166)
  • ci: use local binary for pipeline smoke test (#1163)
  • prevent concurrent GSD sessions from overlapping on same project (#1154)
  • exclude completion-transition errors from health escalation at task level (#1157)
  • ci: skip git-diff guard in prepublishOnly during CI (#1160)
  • /gsd quick respects git isolation: none preference (#1156)
  • text-based fallbacks for RPC mode where TUI widgets produce empty turns (#1112)
  • headless-query: use jiti to load extension .ts modules (#1143)
  • pause auto-mode when env variables needed instead of blocking (#1147)
  • ci: fix dev-publish version stamp and platform sync (#1145)
  • google-search: add 30s timeout to Gemini API call (#1139)
  • verification-gate: sanitize preference commands with isLikelyCommand (#1138)
  • auto-dashboard: show trigger task label for hook units (#1136)
  • auto-worktree: detect worktree structurally when originalBase is null (#1135)
  • model-resolver: prefer provider&#39;s recommended variant over saved base model (#1131)
  • auto-worktree: auto-commit project root dirty state before milestone merge (#1130)
  • guided-flow: support re-discuss flow for already-discussed slices (#1129)
  • dispatch guard skips parked milestones — they no longer block later milestone dispatch (#1126)
  • worktree reassess-roadmap loop — existsSync fallback in checkNeedsReassessment (#1117)
  • lsp: use where.exe on Windows to resolve command paths (#1134)
  • gsd-db: auto-initialize database when tools are called (#1133)
  • inline preferences path to fix remote questions setup (#1110) (#1111)
  • ci: add safe.directory for containerized pipeline job (#1108)
  • remove .gsd/ from tracking, ignore entire directory
  • update tests for god-file decomposition
  • strip model variant suffix for API key auth (#1097) (#1099)
  • match both milestoneId and sliceId when filtering duplicate blocker cards
  • add dispatch stall guards to prevent auto-mode pause after slice completion (#1073) (#1076)
  • prevent summarizing phase stall by retrying dropped agent_end events (#1072) (#1074)
  • use atomic writes for completed-units.json and invalidate caches in db-writer (#1069)
  • reject prose Verify: fields from being executed as shell commands (#1066) (#1068)
  • restore session model on error instead of reading stale global prefs (#1065) (#1067)
  • prevent run-uat re-dispatch loop when roadmap checkbox update fails (#1063) (#1064)
  • inline compareSemver in gsd extension to fix broken relative import (#1058)
  • disable reasoning for MiniMax-M2.5 in alibaba-coding-plan provider (#1003) (#1055)
  • improve LSP diagnostics when no servers detected (#1082) (#1086)
  • prevent summarizing phase stall by retrying dropped agent_end events (#1072)
  • switch alibaba-coding-plan to OpenAI-compat endpoint with proper compat flags (#1003)
  • add barrel files for remote-questions, ttsr, and shared extensions (#1048)
  • consolidate frontmatter parsing into shared module (#1040)
  • always ensure tasks/ directory exists for slice units (#900) (#1050)
  • centralize GSD timeout and cache constants (#1038)
  • improve RemotePromptRecord.ref type safety (#1041)
  • document silent catch handlers in browser-tools (#1037)
  • use literal union types in RuntimeErrorJSON for type safety (#1034)
  • extract sanitizeError to shared module and apply to ask-user-questions (#1033)
  • deduplicate formatDateShort into shared/format-utils (#1032)
  • add error handlers to visualizer overlay promise chains (#1027)
  • security: use execFileSync in resolve-config-value to prevent shell operator bypass (#1025)
  • security: use execFile for browser URL opening to prevent shell injection (#1022)
  • prevent duplicate milestone IDs when generating multiple before persisting (#961) (#1018)
  • consolidate duplicate formatting functions (#1011)
  • gsd: delete orphaned complexity.ts (#1005)
  • search: consolidate duplicate Brave API helpers (#1010)
  • merge worktree to main when all milestones complete (#962) (#1007)
  • gsd: deduplicate resolveGitHeadPath function (#1015)
  • add missing package.json subpath exports and oauth stubs (#1014)
  • gsd: consolidate string-array normalizer functions into shared utility (#1009)
  • browser-tools: document intentional silent catches, add debug logging for others (#1013)
  • consolidate duplicate VerificationCheck/Result type definitions (#1008)
  • gsd: add GIT_NO_PROMPT_ENV to gitFileExec and deduplicate constant (#1006)
  • remote-questions: add null coalesce for optional threadUrl (#1004)
  • auto-resume on transient server errors, not just rate limits (#886) (#957)
  • replace ambiguous compound question in reflection step (#963) (#1002)
  • gsd: remove STATE.md update instructions from all prompts (#983)
  • gsd: clear all caches after discuss dispatch so picker sees new CONTEXT files (#981)
  • auto: dispatch retry after verification gate failure (#998)
  • enforce GSDError usage and activate unused error codes (#997)
  • unify extension discovery logic (#995)
  • deduplicate tierLabel/tierOrdinal exports (#988)
  • deduplicate getMainBranch implementations (#994)
  • add error handling for unhandled promise rejections (#992)
  • deduplicate formatTokenCount into shared format-utils (#987)
  • add debug logging to silent catch blocks in auto.ts (#986)
  • deduplicate formatDuration into shared format-utils (#989)
  • add exports fields to pi-tui and pi-agent-core packages (#991)
  • remove dead github-client.ts (never imported) (#990)
  • deduplicate parseJSONL and unify MAX_JSONL_BYTES constant (#985)
  • remove broken ./hooks export path from pi-coding-agent (#984)
  • inline bundled extension path parsing in subagent

Changed

  • extract numeric validation helpers in prefs wizard (#1205)
  • deduplicate projectRoot() and dispatchDoctorHeal() between commands.ts and commands-handlers.ts (#1203)
  • extract shared JSON persistence utility, migrate metrics + routing-history + unit-runtime (#1206)
  • remove unused preferences-hooks.ts re-export facade (#1207)
  • remove commands.ts re-exports, import directly from submodules (#1204)
  • extract frontmatter body extraction into shared helper (#1201)
  • deduplicate projectRoot() — single source in commands.ts (#1197)
  • extract PER_REQUEST_TIMEOUT_MS to shared types (#1196)
  • update state — S01 planned, ready for execution
  • M001-1ya5a3/S01: auto-commit after state-rebuild
  • M001-1ya5a3/S01: auto-commit after research-slice
  • decompose doctor.ts into types, format, and checks modules (#1096)
  • extract milestone-ids and guided-flow-queue from guided-flow.ts (#1095)
  • decompose preferences.ts, populate skills and models modules (#1091)
  • decompose auto.ts into 6 focused modules (#1088)
  • decompose commands.ts into 5 focused modules
  • remove redundant test file, identify consolidation targets (#1070)
  • batch 2 — consolidate preferences, convert 8 more files to node:test (#1061)
  • consolidate tests by area, standardize on node:test (#1059)
  • skip initResources when version matches, consolidate startup I/O (#1052)
  • centralize magic numbers into constants.ts (#1044)
  • resource-loader: extract syncResourceDir to eliminate triplicated sync logic (#1036)
  • bg-shell: split 1604-line god file into tool, command, and lifecycle modules (#1049)
  • headless: split 772-line god file into events, UI, and context modules (#1047)
  • gsd: extract safeCopy/safeMkdir helpers to replace repetitive try/catch FS patterns (#1043)
  • gsd: extract atomicWriteSync utility to replace 6 duplicate write-tmp-rename patterns (#1046)
  • gsd: unify duplicate padRight/truncate into shared format-utils (#1045)
  • loader: consolidate 5 duplicate package.json version reads into cached helper (#1042)
  • headless: remove duplicate jsonLine, use serializeJsonLine from pi-coding-agent (#1039)
  • fix unicode regex discrepancy and standardize function naming (#1031)
  • fix chalk version mismatch and document pinned dependency rationale (#1030)
  • add concurrency limits to unbounded Promise.all operations (#1029)
  • optimize SSE streaming buffer to avoid quadratic string growth (#1024)
  • reduce makeTreeWritable calls from 6 to 2 on startup (#1023)
  • add domain-grouped re-exports for preferences module (#996)

Maturity Era v2.16–v2.28

v2.28.0 March 17, 2026
Highlights Added: `gsd headless query` command for instant, read-only state inspection — returns phase, cost, progress, and next-unit as parseable JSON without spawning an LLM session · Changed: Updated documentation for v2.26 and v2.27.0 features · Fixed: Failure recovery & resume safeguards: atomic file writes, OAuth fetch timeouts (30s), RPC subprocess exit detection, extension command context guards, bash temp file cleanup, settings write queue flush, LSP init retry with backoff, crash detection on session resume, blob garbage collection

Added

  • gsd headless query command for instant, read-only state inspection — returns phase, cost, progress, and next-unit as parseable JSON without spawning an LLM session
  • /gsd update slash command for in-session self-update
  • /gsd export --html --all for retrospective milestone reports

Fixed

  • Failure recovery & resume safeguards: atomic file writes, OAuth fetch timeouts (30s), RPC subprocess exit detection, extension command context guards, bash temp file cleanup, settings write queue flush, LSP init retry with backoff, crash detection on session resume, blob garbage collection
  • Consolidated duplicate mcp-server.ts into single implementation
  • Consolidated duplicate bundled-extension-paths.ts into single module
  • Removed duplicate marketplace-discovery.test.ts test file
  • Established npm as canonical package manager
  • Exported RPC utilities from pi-coding-agent public API
  • Prompt system requires grammatical narration for clearer agent output

Changed

  • Updated documentation for v2.26 and v2.27.0 features
  • Documented all preferences.md fields in reference and template
  • Removed stale .pi/agents/ files superseded by built-in agent definitions

Install/upgrade: npx gsd-pi@latest

v2.27.0 March 17, 2026
Highlights Added: HTML report generator with progression index across milestones · Changed: Encapsulated auto.ts state into AutoSession class (cleaner session lifecycle) · Fixed: Single ENTER now correctly submits slash command argument autocomplete

Added

  • HTML report generator with progression index across milestones
  • Crash recovery for parallel orchestrator — persisted state with PID liveness detection
  • Headless orchestration skill with supervised mode
  • Verification enforcement gate for milestone completion
  • git.manage_gitignore preference to opt out of automatic .gitignore changes

Changed

  • Encapsulated auto.ts state into AutoSession class (cleaner session lifecycle)
  • Extracted 7 focused modules from auto.ts (auto-worktree-sync, resource staleness, stale escape)
  • TUI dashboard cleanup, dedup, and feature improvements
  • Reordered visualizer tabs and HTML report sections into logical groupings

Fixed

  • Single ENTER now correctly submits slash command argument autocomplete
  • Web search loop broken with consecutive duplicate guard
  • Transient network errors retried before model fallback
  • Parallel worker PID tracking, spawn-status race, and exit persistence
  • /gsd discuss now recommends next undiscussed slice
  • Roadmap parser allows suffix text after ## Slices heading
  • User&#39;s model choice no longer overwritten when API key is temporarily unavailable
  • Reassess-roadmap skip loop broken by preventing re-persistence of evicted keys
  • LSP command resolution and ENOENT crash on Windows/MSYS
  • Dispatch plan-slice when task plan files are missing
  • Reduced CPU usage on long auto-mode sessions
  • Orphan-prone child processes reaped across session churn
  • Symlinked skill directories resolved in always_use_skills and preferences
  • Replan-slice infinite loop and non-standard finish_reason crash
  • Skip slice plan commit when commit_docs is false
  • Context-pressure monitor wired to send wrap-up signal at 70%
  • Missing STATE.md in fresh worktree no longer deadlocks pre-dispatch health gate
  • Stale runtime unit files for completed milestones cleaned on startup
  • Broken install detection with Windows symlink fallback
  • Auto-restart headless mode on crash with exponential backoff
  • Generic type preserved on resolveModelId through resolution

Install/upgrade: npm install -g gsd-pi@latest

v2.26.0 March 17, 2026
Highlights Added: Model selector grouped by provider with model type, provider, and API docs fields · Changed: Explicit Gemini OAuth ToS warning added to README — recommends API keys over OAuth · Fixed: Windows path normalization in LLM-visible text to prevent bash failures

Added

  • Model selector grouped by provider with model type, provider, and API docs fields
  • require_slice_discussion option to pause auto-mode before each slice for human review
  • Discussion status indicators in /gsd discuss slice picker
  • Worker NDJSON monitoring and budget enforcement for parallel orchestration
  • gsd_generate_milestone_id tool for multi-milestone unique ID generation
  • Alt+V clipboard image paste shortcut on macOS
  • Hashline edit mode integration into active workflow
  • Fallback parser for prose-style roadmaps without ## Slices section

Fixed

  • Windows path normalization in LLM-visible text to prevent bash failures
  • Async bash job completion no longer triggers spurious LLM turns
  • Native web_search limited to max 5 uses per response
  • Completed milestone with summary no longer re-entered as active on resume
  • Replan-slice artifact verification breaks infinite replanning-slice loop
  • Auto-heal STATE.md missing in preDispatchHealthGate
  • Worktree artifact copy includes STATE.md, KNOWLEDGE.md, OVERRIDES.md
  • Transient network errors marked as retriable in Anthropic provider
  • needs-remediation treated as terminal validation verdict to prevent hard loop
  • Post-hook doctor uses fixLevel &#39;all&#39; to fix roadmap checkboxes
  • task_done_missing_summary fixable in doctor to prevent validate-milestone skip loop
  • BMP clipboard images on WSL2 handled via wl-paste PNG conversion
  • Extended idle timeout for headless new-milestone
  • EPIPE handling in LSP sendNotification with proper process exit wait
  • Debug logging for silent early-return paths in dispatchNextUnit
  • Untracked .gsd/ state files removed before milestone merge checkout
  • Crash prevention when cancelling OAuth provider login dialog
  • Resource staleness check compares gsdVersion instead of syncedAt
  • Unique temp paths in saveFile() to prevent parallel write collisions
  • Validation/summary file generation for completed milestones during migration
  • Cache invalidation before initial state derivation in startAuto
  • Headless mode no longer exits early on progress notifications containing &#39;complete&#39;

Removed

  • Symlink-based development workflow (reverted PR #744)

Changed

  • Explicit Gemini OAuth ToS warning added to README — recommends API keys over OAuth
  • Documentation updated for v2.24 release features
  • Bug report template updated with model type, provider, and API docs fields

Install/upgrade: npx gsd-pi@latest

v2.25.0 March 17, 2026
Highlights Added: Native web search results rendering in TUI with PREFER_BRAVE_SEARCH environment variable toggle · Changed: Removed unnecessary as any casts, dead exports, and duplicate code · Fixed: Phantom skip loop caused by stale crash recovery context

[2.25.0] - 2026-03-16

Added

  • Native web search results rendering in TUI with PREFER_BRAVE_SEARCH environment variable toggle
  • Meaningful commit messages generated from task summaries instead of generic messages
  • Incremental memory system for auto-mode sessions
  • Visualizer enriched with stats and discussion status
  • 14 new E2E smoke tests for CLI verification

Fixed

  • Phantom skip loop caused by stale crash recovery context
  • Skip-loop now interruptible and counts toward lifetime cap
  • Cache invalidation consistency — orphaned invalidateStateCache() calls replaced, DB artifact cache included in invalidateAllCaches()
  • Plan checkbox reconciliation on worktree re-attach after crash

Changed

  • Removed unnecessary as any casts, dead exports, and duplicate code
  • Updated documentation for v2.22 and v2.23 release features
v2.24.0 March 17, 2026
Highlights Added: **Parallel milestone orchestration** — run multiple workers across phases simultaneously · Changed: Lazy-load LLM provider SDKs to reduce startup time · Fixed: Sync completed-units.json across worktree boundaries

[2.24.0] - 2026-03-16

Added

  • Parallel milestone orchestration — run multiple workers across phases simultaneously
  • Dashboard view for parallel workers with 80% budget alert
  • Headless new-milestone command for programmatic milestone creation
  • Interactive update prompt on startup when a new version is available
  • Symlink-based development workflow for src/resources/
  • Descriptions added to /gsd autocomplete commands
  • validate-milestone phase and dispatch

Fixed

  • Sync completed-units.json across worktree boundaries
  • Worktree artifact verification uses correct base path
  • Auto-resume auto-mode after rate limit cooldown
  • Raise maxDelayMs default from 60s to 300s for better rate-limit handling
  • Downgrade missing_tasks_dir to warning for completed slices
  • Prevent stale state loop on auto-mode restart with existing worktree
  • Always sync bundled resources and clean stale files
  • Add stop reason to every auto-mode stop
  • Skip redundant checkout in worktree merge when main already current
  • Prevent runaway execute-task when task plan missing after failed research
  • Fix read-only file permissions after cpSync from Nix store
  • Fix parallel sendMessage calls missing required fields
  • Strip clack UI from postinstall, keep silent Playwright download

Changed

  • Lazy-load LLM provider SDKs to reduce startup time

Install/upgrade: npx gsd-pi@latest

v2.23.0 March 17, 2026
Highlights Added: full extension with chat participant, RPC integration, marketplace publishing under FluxLabs publisher · Changed: optimized hot path with parallel git queries and lazy workspace validation · Fixed: Forensics uses `GSD_VERSION` env var instead of fragile package.json path traversal; now worktree-aware to prevent stale root misdiagnosis

Added

  • VS Code extension — full extension with chat participant, RPC integration, marketplace publishing under FluxLabs publisher
  • gsd headless — redesigned headless mode for full workflow orchestration: auto-responds to prompts, detects completion, supports --json output and --timeout flags
  • gsd sessions — interactive session picker for browsing and resuming saved sessions (#721)
  • 10 new browser tools — browser_save_pdf, browser_save_state, browser_restore_state, browser_mock_route, browser_block_urls, browser_clear_routes, browser_emulate_device, browser_extract, browser_visual_diff, browser_zoom_region, browser_generate_test, browser_check_injection, browser_action_cache (#698)
  • Structured discussion rounds — ask_user_questions in guided-discuss-milestone for better requirement gathering (#688)
  • validate-milestone prompt — milestone validation prompt and template
  • models.json resolution — custom model definitions with fallback to ~/.pi/agent/models.json

Changed

  • Background shell performance — optimized hot path with parallel git queries and lazy workspace validation

Fixed

  • Forensics uses GSD_VERSION env var instead of fragile package.json path traversal; now worktree-aware to prevent stale root misdiagnosis
  • Background commands rewritten to prevent pipe-open hang; stalled-tool detection added with prompt guidance
  • Auto mode breaks infinite skip loop on repeatedly-skipped completed units
  • Roadmap parser expands range syntax in depends (e.g. S01-S04 → S01,S02,S03,S04)
  • Empty scaffold plan files rejected during plan-slice artifact verification (#699)
  • Anti-pattern rule prevents bash & usage that causes agent hangs (#733)
  • Shift-Tab navigates to previous tab in workflow visualizer (#717)
  • Capture resolutions executed after triage instead of only classified (#714)
  • Screenshot constraining uses independent width/height caps (#725)
  • auto.lock written at startup; remote sessions detected in dashboard (#723)
  • Cross-platform test compatibility with process.ppid
  • CSP nonce, dead branch cleanup, restart cooldown fixes
  • CI fix: pi.getActiveTools() replaces ctx.getActiveTools()

Install/upgrade: npx gsd-pi@latest

v2.22.0 March 16, 2026
Highlights Added: post-mortem investigation of auto-mode failures with structured root-cause analysis · Fixed: `verificationBudget` passed correctly to execute-task prompt template

Added

  • /gsd forensics — post-mortem investigation of auto-mode failures with structured root-cause analysis
  • Claude marketplace import — import Claude marketplace plugins as namespaced GSD components
  • MCP server mode — run GSD as an MCP server with --mode mcp
  • /review skill — code review with diff-aware context
  • /test skill — test generation and execution
  • /lint skill — linting integration
  • GitHub API client — diff-aware context injection and tiktoken-based token counting
  • File watcher — chokidar-based file watching for live updates
  • git.isolation: "none" — disable worktree isolation for projects that don&#39;t need it
  • E2E smoke tests — end-to-end test suite for extension integration
  • Subcommand help — inline help text for all GSD subcommands

Fixed

  • verificationBudget passed correctly to execute-task prompt template
  • Background shell worktree cwd detection normalized to prevent stale paths
  • Skill loading made an active directive in auto-mode units
  • Auto-worktree validated as real git worktree before use
  • MCP server discovery from project-root .mcp.json
  • Command injection surface eliminated in diff-context; file-watcher path resolution hardened
  • Thinking level clamped to low for gpt-5.x models
  • Fractional slice IDs (e.g. S03.5) supported in roadmap parser
  • Worktree state synced to project root after each unit
  • Hardware cursor auto-enabled in Warp terminal
  • CSI 3J scrollback clear removed from TUI full redraws
  • Worktree edge cases — resolveGitDir, captureIntegrationBranch guard, doctor path

Install/upgrade: npx gsd-pi@latest

v2.21.0 March 16, 2026
Highlights Added: `browser-tools/core.js` converted to TypeScript with c8 test coverage · Changed: reuses crash recovery infrastructure for more reliable context restoration · Fixed: Task counter display no longer shows "task 5/4" after loop recovery

Added

  • Browser tools TypeScript conversion — browser-tools/core.js converted to TypeScript with c8 test coverage
  • SSRF protection on fetch_page — blocks private IPs, metadata endpoints, and non-HTTP protocols
  • Stale async job cancellation — heuristic prevents outdated results in auto-mode

Changed

  • Pause/resume recovery — reuses crash recovery infrastructure for more reliable context restoration
  • Build scripts extracted — inline package.json scripts moved to standalone files for cross-platform support
  • Help text deduplicated — consolidated across CLI entry points
  • Dependency alignment — @types/mime-types moved to devDependencies, chalk versions consolidated

Fixed

  • Task counter display no longer shows "task 5/4" after loop recovery
  • Browser-tools TypeScript type errors in CI
  • 4 small issues (#663): Windows GitHub Copilot login, Tavily display, MCPorter auto-install, notification preferences
  • Cross-platform validate-pack script compatibility

Install/upgrade: npx gsd-pi@latest

v2.20.0 March 16, 2026
Highlights Added: **Telegram remote questions** — receive and respond to GSD questions via Telegram bot alongside existing Slack and Di… · Changed: **Preferences wizard** — replaced serial flow with categorized menu for faster configuration · Fixed: **CPU spinning from regex backtracking** — replaced [\s\S]*? regex in preferences parser with indexOf-based scanning

Added

  • Telegram remote questions — receive and respond to GSD questions via Telegram bot alongside existing Slack and Discord channels (#645)
  • /gsd quick — execute a quick task with GSD guarantees (atomic commits, state tracking) without the full planning overhead (#437)
  • /gsd mode — workflow mode system with solo and team presets that configure defaults for milestone IDs, git commit behavior, and documentation settings (#651)
  • /gsd help — categorized command reference with descriptions for all GSD subcommands (#630)
  • /gsd doctor — 7 runtime health checks with auto-fix for common state corruption issues (#646)
  • Agent instructions injection — agent-instructions.md loaded into every agent session for persistent per-project behavioral guidance (#437)
  • Skill lifecycle management — telemetry tracking, health dashboard, and heal-skill command for managing custom skills (#599)
  • SQLite context store — surgical prompt injection from structured knowledge base for precise context engineering (#619)
  • Context-window budget engine — proportional prompt sizing that allocates context budget across system prompt sections based on relevance (#660)
  • LSP activated by default — Language Server Protocol now auto-activates with call hierarchy, formatting, signature help, and synchronized edits (#639)
  • Extension smoke tests — CI catches import failures, circular deps, and module resolution issues across all bundled extensions
  • gsd --debug mode — structured JSONL diagnostic logging for troubleshooting dispatch and state issues (#468)
  • Worktree post-create hook — run custom setup scripts when GSD creates a new worktree (#597)

Fixed

  • CPU spinning from regex backtracking — replaced [\s\S]*? regex in preferences parser with indexOf-based scanning (#468)
  • Model config bleed between concurrent GSD instances — isolated model configuration per session (#650)
  • Onboarding wizard repeats — skip onboarding for extension-based providers that don&#39;t require auth.json credentials (#589)
  • Session tool rebuild on cwd change — tools now rebuild correctly when working directory changes mid-session (#633)
  • Auto mode state derivation after discussion fallthrough — re-derives state to prevent stale dispatches (#609)
  • Milestone branch preservation on auto stop — prevents work loss when stopping auto mode (#601)
  • Infinite loop when milestone detection silently fails — findMilestoneIds now logs errors and warns instead of looping (#456)
  • Google Search OAuth fallback — uses Google Cloud Code Assist API when GEMINI_API_KEY is not set (#466)

Changed

  • Preferences wizard — replaced serial flow with categorized menu for faster configuration (#623)
  • Slack remote questions — brought to feature parity with Discord integration (#628)
  • YAML support in hooks — hooks now support YAML configuration alongside JSON (#637)

Install/upgrade: npm install -g gsd-pi@2.20.0

v2.19.0 March 16, 2026
Highlights Added: `/gsd visualize` opens a full-screen TUI overlay with four tabs: Progress, Dependencies, Metrics, and Timeline. Supports Tab/1-4 switching, per-tab scrolling, auto-refresh every 2s, and optional auto-trigger via `auto_visualize` preference (#626) · Fixed: write-target variables now absolute, eliminating LLM path confusion in worktree contexts (#627)

Added

  • Workflow visualizer — /gsd visualize opens a full-screen TUI overlay with four tabs: Progress, Dependencies, Metrics, and Timeline. Supports Tab/1-4 switching, per-tab scrolling, auto-refresh every 2s, and optional auto-trigger via auto_visualize preference (#626)
  • Mid-execution capture & triage — /gsd capture lets you fire-and-forget thoughts during auto-mode. Triages at natural seams between tasks, classifies into five types (quick-task, inject, defer, replan, note), proposes action with confirmation. Dashboard shows pending capture badge (#512)
  • Dynamic model routing — complexity-based routing classifies units into light/standard/heavy tiers, routes to cheaper models when appropriate (20-50% token savings). Budget-pressure-aware, adaptive learning from history, task plan introspection (#579)
  • Feature-branch lifecycle integration test (#624)
  • Discord integration parity with Slack + remote-questions documentation (#620)

Fixed

  • Absolute paths in auto-mode prompts — write-target variables now absolute, eliminating LLM path confusion in worktree contexts (#627)
  • Worktree lifecycle on mid-session milestone transitions (#616, #618)
  • Eager template cache warming — prevents version-skew crash in long auto-mode sessions (#621)

Install/upgrade: npx gsd-pi@latest

v2.18.0 March 16, 2026
Highlights Added: `/gsd queue` supports reordering milestone execution priority with dependency-aware validation, persistent ordering via `.gsd/QUEUE-ORDER.json` (#460) · Changed: Auto-mode artifact writes scoped to active milestone worktree (#590) · Fixed: four sources of unbounded memory growth patched (#611)

Added

  • Milestone queue reorder — /gsd queue supports reordering milestone execution priority with dependency-aware validation, persistent ordering via .gsd/QUEUE-ORDER.json (#460)
  • .gsd/KNOWLEDGE.md — persistent project-specific context file loaded into agent prompts. New /gsd knowledge command with rule, pattern, and lesson subcommands (#585)
  • Dynamic model discovery — runtime model enumeration from provider APIs (Ollama, OpenAI, Google, OpenRouter) with per-provider TTL caching. New ProviderManagerComponent TUI for managing providers (#581)
  • Expanded preferences wizard — all configurable fields now exposed in the setup wizard (#580)
  • Comprehensive documentation — 12 new docs covering getting started, auto-mode, commands, configuration, token optimization, cost management, git strategy, team workflows, skills, migration, troubleshooting, and architecture (#605)
  • resolveProjectRoot() — all GSD commands resolve the effective project root from worktree paths (#602)
  • 1,813 lines of new tests — 13 new test files

Fixed

  • Heap OOM during long-running auto-mode sessions — four sources of unbounded memory growth patched (#611)
  • Stale worktree cwd after milestone completion — three-layer fix (#608)
  • Worktree created from integration branch instead of main (#606)
  • Milestone merge skipped in branch isolation mode (#603)
  • parseContextDependsOn() destroys unique milestone ID case (#604)
  • Tool-aware idle detection — prevents false interruption of long-running tasks (#596)
  • Remote questions onboarding crash (#592)
  • showNextAction crash — falls back to select() when custom() returns undefined (#447, #615)

Changed

  • Auto-mode artifact writes scoped to active milestone worktree (#590)
  • Comprehensive update to preferences reference and configuration guide (#614)

Install/upgrade: npx gsd-pi@latest

v2.17.0 March 16, 2026
Highlights Added: **Token optimization profiles** — budget, balanced, and quality presets that coordinate model selection, phase skippi… · Changed: Updated Ollama cloud provider model catalog · Fixed: Native binary hangs in GSD auto-mode paths

Added

  • Token optimization profiles — budget, balanced, and quality presets that coordinate model selection, phase skipping, and context compression to reduce token usage by 40-60% on budget mode
  • Complexity-based task routing — automatically classifies tasks as simple/standard/heavy and routes to appropriate models, with persistent learning from routing history
  • git.commit_docs preference — set to false to keep .gsd/ planning artifacts local-only, useful for teams where only some members use GSD

Changed

  • Updated Ollama cloud provider model catalog

Fixed

  • Native binary hangs in GSD auto-mode paths (#453)
  • Auto-mode can be stopped from a different terminal (#586)
  • Parse cache collision causing false loop detection on complete-slice (#583)
  • Exhaustive switch handling and cleanup in Google provider (#587)

Install/upgrade: npx gsd-pi@latest

v2.16.0 March 16, 2026
Highlights Added: `/gsd steer` command — hard-steer plan documents during execution without stopping the pipeline · Changed: Hot-path lookup caching and error resilience optimizations · Fixed: Auto-mode continues after guided milestone planning instead of stalling at "Milestone planned"

Added

  • /gsd steer command — hard-steer plan documents during execution without stopping the pipeline
  • Native git operations via libgit2 — ~70 fewer process spawns per dispatch cycle
  • Native performance optimizations for deriveState, JSONL parsing, and path resolution
  • Default model upgraded to Opus 4.6 with 1M context variant
  • PR template and bug report issue template

Fixed

  • Auto-mode continues after guided milestone planning instead of stalling at "Milestone planned"
  • Git commands no longer fail when repo path contains spaces
  • Arrow key cursor updates and Shift+Enter newline insertion in TUI
  • Tool API keys loaded from auth.json at session startup
  • TypeScript errors resolved across extension, test, and async-jobs files

Changed

  • Hot-path lookup caching and error resilience optimizations
  • Extension type-checking added to CI pipeline

Install/upgrade: npx gsd-pi@latest

The Seed v0.2–v0.3

v2.15.1 March 16, 2026
Highlights Added: Unit tests for auto-dashboard, auto-recovery, and crash-recovery modules (46 new tests) · Changed: CI pipeline supports prerelease publishing with --tag next for testing before stable release · Fixed: Auto-mode worktree path resolution — prompt templates now include working directory, preventing artifacts from being …

Fixed

  • Auto-mode worktree path resolution — prompt templates now include working directory, preventing artifacts from being written to the wrong location and causing infinite re-dispatches
  • Auto-mode resource sync detection — gracefully stops when resources change mid-session instead of crashing
  • Auto-mode missing import for resolveSkillDiscoveryMode causing crash on startup
  • Auto-mode recovery hardened — checkbox verification falls through correctly, corrupt roadmaps fail verification instead of silently passing, atomic writes for completed-units.json, and task completion verified via artifacts not just file existence
  • Auto-mode progress widget now refreshes from disk every 5 seconds during unit execution instead of appearing frozen
  • Undo command now invalidates all caches (not just state cache), preventing stale results after undoing completed tasks

Changed

  • CI pipeline supports prerelease publishing with --tag next for testing before stable release

Added

  • Unit tests for auto-dashboard, auto-recovery, and crash-recovery modules (46 new tests)

Install/upgrade: npx gsd-pi@latest

v2.15.0 March 15, 2026
Highlights Added: **8 new commands**: budget enforcement, notifications, and quality-of-life improvements (#441) · Changed: Auto-mode decomposed into focused modules for maintainability (#534) · Fixed: Executor agents now receive explicit working directory, preventing writes to main repo instead of worktree (#543)

Added

  • 8 new commands: budget enforcement, notifications, and quality-of-life improvements (#441)
  • Preferences schema validation: detects unknown/typo&#39;d preference keys and surfaces warnings instead of silently ignoring them (#542)
  • Pipeline-aware prompts: each agent phase (research, plan, execute, complete) now knows its role in the pipeline, eliminating redundant code exploration between phases (#543)
  • Research depth calibration: three-tier system (deep/targeted/light) so agents match effort to actual complexity (#543)

Changed

  • Auto-mode decomposed into focused modules for maintainability (#534)
  • Dispatch logic extracted from if-else chain to dispatch table (#539)
  • v1 migration code gated behind dynamic import — only loaded when needed (#541)
  • Background shell module decomposed into focused modules
  • Unified cache invalidation into single invalidateAllCaches() function (#545)

Fixed

  • Executor agents now receive explicit working directory, preventing writes to main repo instead of worktree (#543)
  • Merge loop and .gsd/ conflict auto-resolution in worktree model, git.isolation preference restored (#536)
  • Arrow keys no longer insert escape sequences as text during LLM streaming (#493)
  • YAML preferences parser hardened for OpenRouter model IDs with special characters (#488)
  • @ file autocomplete debounced to prevent TUI freeze on large codebases (#448)
  • Auto-mode stops cleanly when dispatch gap watchdog fails (#537)
  • Synchronous I/O removed from hot paths (#540)
  • Silent catch blocks now capture error references for crash diagnostics (#546)
  • ctx.log error in GSD provider recovery path fixed
  • TUI resource leaks patched in loader, cancellable-loader, input, and editor components (#482)
  • Hardcoded ANSI escapes replaced with chalk for consistent terminal handling (#482)

Install/upgrade: npx gsd-pi@latest

v2.14.4 March 15, 2026
Highlights Fixed: **Session cwd update** — newSession() now updates the LLM's perceived working directory to reflect process.chdir() in…

Fixed

  • Session cwd update — newSession() now updates the LLM&#39;s perceived working directory to reflect process.chdir() into auto-worktrees. Previously the system prompt was frozen at the original project root, causing the LLM to cd back and write files to the wrong location. This was the root cause of complete-slice and plan-slice artifact loops in worktree-based projects.

Install/upgrade: npx gsd-pi@latest

v2.14.3 March 15, 2026
Highlights Fixed: **Copy planning artifacts into new auto-worktrees** — createAutoWorktree now copies .gsd/milestones/, DECISIONS.md, R…

Fixed

  • Copy planning artifacts into new auto-worktrees — createAutoWorktree now copies .gsd/milestones/, DECISIONS.md, REQUIREMENTS.md, PROJECT.md from the source repo into the worktree. Prevents plan-slice loops in projects with pre-v2.14.0 .gitignore where planning artifacts are on disk but not in git.

Install/upgrade: npx gsd-pi@latest

v2.14.2 March 15, 2026
Highlights Fixed: **Dispatch reentrancy deadlock** — _dispatching flag was never reset after first dispatch, permanently blocking all s…

Fixed

  • Dispatch reentrancy deadlock — _dispatching flag was never reset after first dispatch, permanently blocking all subsequent unit dispatches. This was the root cause of dispatch gap stalls and "no unit dispatched" warnings. Wrapped in try/finally.
  • .gitignore self-heal — existing projects with blanket .gsd/ ignore now auto-remove it on next auto-mode start, replacing with explicit runtime-only patterns so planning artifacts are tracked in git and survive worktree creation.
  • Discuss depth verification — render summary as chat text (markdown renders properly), use ask_user_questions for short confirmation only.

Install/upgrade: npx gsd-pi@latest

v2.14.1 March 15, 2026
Highlights Fixed: **Quiet auto-mode warnings** — internal recovery machinery (dispatch gap watchdog, model fallback chain) downgraded t…

Fixed

  • Quiet auto-mode warnings — internal recovery machinery (dispatch gap watchdog, model fallback chain) downgraded to verbose-only. Users only see warnings when action is needed.
  • Dispatch recovery hardening — artifact fallback when completion key missing, TUI freeze prevention, reentrancy guard, atomic writes, stale runtime record cleanup

Install/upgrade: npx gsd-pi@latest

v2.14.0 March 15, 2026
Highlights Added: **Discussion manifest** — mechanical process verification for multi-milestone context discussions · Changed: **Branchless worktree architecture** — eliminated slice branches entirely. All work commits sequentially on milestone… · Fixed: **Auto-mode loop detection failures** — artifacts on wrong branch or invisible after branch switch no longer possible…

[2.14.0] - 2026-03-15

Added

  • Discussion manifest — mechanical process verification for multi-milestone context discussions
  • Session-internal /gsd config — configure GSD settings within a running session
  • Model selection UI — select list instead of free-text input for model preferences
  • Startup performance — faster GSD launch via optimized initialization

Changed

  • Branchless worktree architecture — eliminated slice branches entirely. All work commits sequentially on milestone/<MID> within auto-mode worktrees. No branch creation, switching, or merging within a worktree. ~2600 lines of merge/conflict/branch-switching code removed.
  • .gitignore overhaul — planning artifacts (.gsd/milestones/) are tracked in git naturally. Only runtime files are gitignored. No more force-add hacks.
  • Multi-milestone enforcement — depends_on frontmatter enforced in multi-milestone CONTEXT.md

Fixed

  • Auto-mode loop detection failures — artifacts on wrong branch or invisible after branch switch no longer possible (root cause eliminated by branchless architecture)
  • Nested worktree creation — auto-mode no longer creates worktrees inside existing manual worktrees, preventing wrong-repo state reads and "All milestones complete" false positives
  • Dispatch recovery hardening — artifact fallback when completion key missing, TUI freeze prevention on cascading skips, reentrancy guard, atomic writes, stale runtime record cleanup, git index.lock cleanup
  • Hook orchestration — finalize runtime records, add supervision, fix retry
  • Empty slice plan stays in planning — no longer incorrectly transitions to summarizing
  • Prefs wizard — launch directly from /gsd prefs, fix parse/serialize cycle for empty arrays
  • Discussion routing — /gsd discuss routes to draft when phase is needs-discussion

Removed

  • ensureSliceBranch(), switchToMain(), mergeSliceToMain(), mergeSliceToMilestone()
  • shouldUseWorktreeIsolation(), getMergeToMainMode(), buildFixMergePrompt()
  • withMergeHeal(), recoverCheckout(), fix-merge unit type
  • git.isolation and git.merge_to_main preferences (deprecated with warnings)

Install/upgrade: npx gsd-pi@latest

v2.13.1 March 15, 2026
Highlights Fixed: Windows: multi-line commit messages in mergeSliceToMilestone broke shell parsing — switched to execFileSync with argu…

Fixed

  • Windows: multi-line commit messages in mergeSliceToMilestone broke shell parsing — switched to execFileSync with argument arrays
  • Windows: single-quoted git arguments and bash-only redirects in test files
  • Windows: worktree path normalization for shouldUseWorktreeIsolation and stale branch detection

Install/upgrade: npx gsd-pi@latest

v2.13.0 March 15, 2026
Highlights Added: auto-mode creates isolated git worktrees per milestone, with `--no-ff` slice merges preserving commit history and squash merge to main on milestone completion · Fixed: `dispatchNextUnit()` cleared path cache but not parse cache, allowing stale roadmap checkbox state to persist through doctor→dispatch transitions (#462)

Added

  • Worktree isolation for auto-mode — auto-mode creates isolated git worktrees per milestone, with --no-ff slice merges preserving commit history and squash merge to main on milestone completion
  • Self-healing git repair — automatic recovery from detached HEAD, stale locks, and orphaned worktrees
  • Worktree-aware doctor — git health diagnostics and worktree integrity checks
  • Isolation preferences — choose between worktree and branch isolation modes

Fixed

  • Dispatch loop: parse cache stale data — dispatchNextUnit() cleared path cache but not parse cache, allowing stale roadmap checkbox state to persist through doctor→dispatch transitions (#462)
  • Dispatch loop: completion not persisted after agent session — handleAgentEnd() now verifies artifacts and persists the completion key before re-entering the dispatch loop, preventing re-dispatch when deriveState() sees pre-merge branch state (#462)
  • Dispatch loop: recovery counter reset without persistence — loop-recovery and self-repair paths now persist completion keys and include a hard lifetime dispatch cap of 6 (#462, #463)
  • Dispatch loop: non-execute-task units had no artifact verification — complete-slice, plan-slice, and other unit types now verify artifacts on disk before bail-out (#465)
  • @ file autocomplete debounced to prevent TUI freeze on large codebases (#452)
  • Guard against newer synced resources from future versions (#445)
  • Prevent web_search tool injection for non-Anthropic providers serving Claude models (#446)

Install/upgrade: npx gsd-pi@latest

v2.12.0 March 15, 2026
Highlights Added: **Parallel tool calling** — tools from a single assistant message execute concurrently by default, with sequential mo… · Changed: Inline static templates into prompt builders, eliminating ~44 READ tool calls per milestone · Fixed: Auto-mode dispatch loop when cachedReaddir returns stale data after unit writes files

Added

  • Parallel tool calling — tools from a single assistant message execute concurrently by default, with sequential mode as opt-in (toolExecution: "sequential") and beforeToolCall/afterToolCall hooks for interception
  • Ollama Cloud as model and web tool provider
  • Extensible hook system for auto-mode state machine — post-unit hooks fire after unit completion
  • Event queue settlement for parallel tool execution — extension tool_call/tool_result handlers always see settled agent state

Changed

  • Inline static templates into prompt builders, eliminating ~44 READ tool calls per milestone

Fixed

  • Auto-mode dispatch loop when cachedReaddir returns stale data after unit writes files
  • Parse and path caches cleared alongside state cache after unit completion
  • bg_shell hangs indefinitely when ready_port server fails to start — now transitions to error state with stderr context
  • Em dash and slash characters in milestone/slice titles corrupting GSD state management
  • Guided-flow self-heals stale runtime records from crashed auto-mode sessions on wizard start
  • CI smoke test ANSI code stripping

Install/upgrade: npx gsd-pi@latest

v2.11.0 March 14, 2026
Highlights Added: Cross-provider fallback when rate or quota limits are hit (#125) · Changed: Replace hardcoded extension list with dynamic discovery in loader · Fixed: Resolve OpenRouter model IDs in auto-mode and show active model per phase

Added

  • Cross-provider fallback when rate or quota limits are hit (#125)
  • Custom OpenAI-compatible endpoint option in onboarding wizard (#335)
  • Model provider selection in preferences (#350)
  • Auto-mode fallback model rotation on network errors (#386)
  • Native libgit2-backed git read operations for dispatch hotpath (#388)

Changed

  • Replace hardcoded extension list with dynamic discovery in loader
  • Deduplicate transitive dependency summaries in prompt builders
  • Reduce dispatch gap timeout from 30s to 5s
  • Memoize deriveState() per dispatch cycle
  • Wire native batch parser into deriveState() hotpath (#389)
  • Add session-scoped directory listing cache and content-hash-keyed parse cache for path resolution
  • Optimize discovery and interactive hot paths

Fixed

  • Resolve OpenRouter model IDs in auto-mode and show active model per phase
  • Suppress git-svn noise causing confusing errors on affected systems (#404)
  • Include export-html templates in pkg/ shim (#370, #395)
  • Increase timeout for z.ai provider to handle slow API spikes (#379, #396)
  • Prevent login dialog from leaving dangling promises that freeze the UI (#280, #390)
  • Improve Cloud Code Assist 404 error with actionable model guidance (#384)
  • Prevent auto-mode hang when dispatch chain breaks after slice tasks complete (#381, #382)
  • Fix packaging verification and path portability (#378)
  • Read resources from dist/ to prevent branch-drift in npm-link setups (#314)
  • Always use native Anthropic web search when available (#374)
  • CI smoke test — wait for registry propagation, show errors (#383)
  • Bypass pre-commit hooks on GSD infrastructure commits to prevent lint-staged empty commit errors (#385)

Install/upgrade: npx gsd-pi@latest

v2.10.12 March 14, 2026
Highlights Fixed: Fix `npx gsd-pi@latest` failing with `ERR_MODULE_NOT_FOUND: Cannot find package '@gsd/pi-coding-agent'`. The loader now creates workspace package symlinks at runtime, so it works even when `npx` skips postinstall scripts.

Fixed

  • Fix npx gsd-pi@latest failing with ERR_MODULE_NOT_FOUND: Cannot find package &#39;@gsd/pi-coding-agent&#39;. The loader now creates workspace package symlinks at runtime, so it works even when npx skips postinstall scripts.

If you have a stale npx cache from a previous broken install, clear it first:

rm -rf ~/.npm/_npx && npx gsd-pi@latest

Install/upgrade: npx gsd-pi@latest

v2.10.11 March 14, 2026
Highlights Fixed: Hoist workspace package dependencies (anthropic SDK, openai, undici, chalk, etc.) into root `dependencies` so they install for end users. v2.10.10 removed `bundleDependencies` but didn't promote the transitive deps, causing `ERR_MODULE_NOT_FOUND` on startup.

Fixed

  • Hoist workspace package dependencies (anthropic SDK, openai, undici, chalk, etc.) into root dependencies so they install for end users. v2.10.10 removed bundleDependencies but didn&#39;t promote the transitive deps, causing ERR_MODULE_NOT_FOUND on startup.

Install/upgrade: npx gsd-pi@latest

v2.10.10 March 14, 2026
Highlights Fixed: Fix broken `npm install` / `npx gsd-pi@latest` caused by unpublished `@gsd/*` workspace packages leaking into npm dependencies. Workspace cross-references removed from published package metadata; packages resolve via postinstall symlinks at runtime.

Fixed

  • Fix broken npm install / npx gsd-pi@latest caused by unpublished @gsd/* workspace packages leaking into npm dependencies. Workspace cross-references removed from published package metadata; packages resolve via postinstall symlinks at runtime.
  • Add pre-publish tarball install validation (validate-pack) to CI and publish pipeline, preventing broken packages from reaching npm.
  • Add .npmignore to prevent .gitignore from excluding dist/ and packages/*/dist/ from the published tarball.

Install/upgrade: npx gsd-pi@latest

v2.10.9 March 14, 2026
Highlights Added: Team collaboration: multiple users can work on the same repo without milestone name clashes by checking in .gsd/ plan… · Changed: Execute-task loop detection uses adaptive reconciliation instead of hard-stopping, reducing false positives · Fixed: Node 22.22+ compatibility: .ts import extensions normalized to .js for module resolution

Added

  • Team collaboration: multiple users can work on the same repo without milestone name clashes by checking in .gsd/ planning artifacts (#338)

Changed

  • Execute-task loop detection uses adaptive reconciliation instead of hard-stopping, reducing false positives (#342)
  • Memory storage switched from better-sqlite3 to sql.js (WASM) for Node 25+ compatibility (#356)

Fixed

  • Node 22.22+ compatibility: .ts import extensions normalized to .js for module resolution (#354)
  • Infinite loop when complete-slice merges to main are interrupted (#345)
  • Credential backoff no longer triggers on transport errors; quota exhaustion handled gracefully (#353)
  • OAuth-backed providers (Gemini) no longer crash on quota exhaustion (#347)
  • Secrets skip in auto mode no longer crashes (#352)
  • Untracked runtime files discarded before branch switch to prevent checkout conflicts (#346)
  • TUI crash/corruption on code blocks with lines exceeding terminal width (#343)
  • Infinite skip loop in gsd auto broken by adding roadmap completion check
  • Model ID variant suffix stripped correctly for OAuth Anthropic API calls
  • .gsd/ planning artifacts force-added and handleAgentEnd reentrancy guarded (#341)

Install/upgrade: npm install -g gsd-pi@latest

v2.10.6 March 13, 2026
Highlights Added: Native Rust output truncation module for efficient large-output handling · Fixed: Oversized TUI lines now truncated instead of crashing

Added

  • Native Rust output truncation module for efficient large-output handling (#268)
  • Native Rust xxHash32 hasher for hashline IDs — faster line hashing (#272)
  • Native Rust bash stream processor for single-pass chunk processing (#271)
  • Memory extraction pipeline (#261)
  • claude-opus-4-6 model with 1M context window (#288)

Fixed

  • Oversized TUI lines now truncated instead of crashing (#287)
  • Anthropic rate limit backoff now respects server-requested retry delay
  • CI publish guard: skip main package publish if already on npm
v2.10.4 March 13, 2026
Highlights Added: Per-platform optional dependency packages (`@gsd-build/engine-*`) for macOS (ARM64/x64), Linux (x64/ARM64), and Windows (x64) · Fixed: Native binary distribution — `.node` binaries were missing from the npm tarball, causing startup crashes on all platforms since v2.10.0

Fixed

  • Native binary distribution — .node binaries were missing from the npm tarball, causing startup crashes on all platforms since v2.10.0
  • Native loader resolution chain: tries @gsd-build/engine-{platform} npm package first, then local dev build, with clear error messages listing supported platforms

Added

  • Per-platform optional dependency packages (@gsd-build/engine-*) for macOS (ARM64/x64), Linux (x64/ARM64), and Windows (x64)
  • Cross-platform native binary CI build and publish workflow
  • Version synchronization script for lock-step platform package releases

Install/upgrade: npm i -g gsd-pi@latest

v2.10.2 March 13, 2026
Highlights Added: Native Rust TTSR regex engine — pre-compiles all stream rule conditions into a single RegexSet for one-pass DFA match…

[2.10.2] - 2026-03-13

Added

  • Native Rust TTSR regex engine — pre-compiles all stream rule conditions into a single RegexSet for one-pass DFA matching instead of O(rules × conditions) JS regex iteration
  • Native Rust diff engine — fuzzy text matching (fuzzyFindText, normalizeForFuzzyMatch) and unified diff generation (generateDiff) via the similar crate, replacing the diff npm package
  • Native Rust GSD file parser — frontmatter parsing, section extraction, batch .gsd/ directory parsing, and structured roadmap parsing with transparent JS fallback

Install/upgrade: npm install -g gsd-pi@2.10.2

v2.10.1 March 13, 2026
Highlights Fixed: @gsd/native package ships pre-compiled JavaScript instead of raw TypeScript, fixing startup crashes on Node.js 20, 22…

Fixed

  • @gsd/native package ships pre-compiled JavaScript instead of raw TypeScript, fixing startup crashes on Node.js 20, 22, and 24 (#248)

Install/upgrade: npm i -g gsd-pi@latest

v2.10.0 March 13, 2026
Highlights Added: Native Rust engine with high-performance N-API modules replacing JS/WASM dependencies: · Changed: Find tool uses native Rust glob instead of fd CLI binary · Fixed: Prevent move operation from silently overwriting existing files

[2.10.0] - 2026-03-13

Added

  • Native Rust engine with high-performance N-API modules replacing JS/WASM dependencies:
    • grep — ripgrep-backed content and filesystem search
    • glob — gitignore-aware file discovery with scan caching
    • ps — cross-platform process tree management
    • clipboard — native clipboard access via arboard (text + image)
    • highlight — syntect-based syntax highlighting (replaces cli-highlight)
    • ast — structural code search and rewrite via ast-grep (38+ languages)
    • html — HTML-to-Markdown conversion
    • text — ANSI-aware text measurement, wrapping, truncation, and slicing
    • fd — fuzzy file path discovery for autocomplete
    • image — decode, encode, and resize images (PNG, JPEG, GIF, WebP)
  • Background shell env action to query shell session environment state
  • Background shell run action for blocking command execution on persistent sessions
  • Background shell session process type for persistent interactive sessions
  • Hashline edits — line-hash-anchored file editing
  • Universal config discovery extension

Changed

  • Find tool uses native Rust glob instead of fd CLI binary
  • Syntax highlighting uses native syntect instead of cli-highlight npm package
  • Autocomplete uses native fd module instead of fd CLI subprocess
  • Text utilities (visible width, wrapping, truncation, slicing) use native Rust instead of JS
  • Clipboard operations use native arboard instead of platform-specific CLI tools
  • Image processing uses native Rust image crate instead of Photon WASM

Fixed

  • Prevent move operation from silently overwriting existing files
  • Separate access/unlink error handling in delete path
  • Untrack runtime files from slice branch before squash-merge
  • Copy LSP defaults.json to dist during build
  • Native module test assertions

Install/upgrade: npm install -g gsd-pi@2.10.0

Engine Era v2.29–v2.58

v2.9.0 March 13, 2026
Highlights Added: LSP tool — full Language Server Protocol integration with diagnostics, go-to-definition, references, hover, document/… · Fixed: TypeScript type errors across gsd, browser-tools, search-the-web, and misc extension files

[2.9.0] - 2026-03-13

Added

  • LSP tool — full Language Server Protocol integration with diagnostics, go-to-definition, references, hover, document/workspace symbols, rename, code actions, type definition, and implementation support
  • /thinking slash command for toggling thinking level during sessions
  • Interactive wizard mode for /gsd prefs with guided configuration
  • Startup update check with 24-hour cache — notifies when a new version is available

Fixed

  • TypeScript type errors across gsd, browser-tools, search-the-web, and misc extension files
  • Milestone ID generation uses max-based approach instead of length+1 (prevents ID collisions)
  • Non-thinking models handled correctly in /thinking command
  • Auto-mode pauses on provider errors to prevent reassess-roadmap loop
  • TAB hint displayed for notes input in discuss-mode survey
  • Slice branches merge to integration branch instead of main
  • Prefs wizard audit findings addressed
  • Deduplicated maxNum logic with test coverage
  • Command injection eliminated in LSP config which() function
  • Unhandled JSON.parse in LSP message reader wrapped with error handling
v2.8.3 March 13, 2026
Highlights Fixed: ask_user_questions handles undefined custom() result in RPC mode

Fixed

  • ask_user_questions handles undefined custom() result in RPC mode
  • Provider-aware model resolution for per-phase preferences (respects provider field instead of parsing model name prefixes)
  • Execute-task artifact verification aligned with deriveState — adds self-repair for missing artifacts
  • Research phase infinite loop broken; state synced on stop
  • Auto-resolve merge conflicts on .gsd/ runtime files
  • Auto-switch model after /login and /logout to prevent API key errors
  • Anthropic provider detection uses provider field instead of model name prefix matching
v2.8.2 March 13, 2026
Highlights Changed: .claude/ and .gsd/ directories untracked from repo, *.tgz gitignored · Fixed: Path operations use node:path stdlib instead of hardcoded forward slashes, fixing cross-platform compatibility

[2.8.2] - 2026-03-13

Fixed

  • Path operations use node:path stdlib instead of hardcoded forward slashes, fixing cross-platform compatibility
  • Prompts use relative paths to prevent Windows drive letter mangling
  • Runtime files already in the git index are untracked to prevent merge conflicts
  • HTTP_PROXY and HTTPS_PROXY environment variables respected for all outbound requests
  • Windows NUL redirects sanitized to /dev/null in Git Bash environments

Changed

  • .claude/ and .gsd/ directories untracked from repo, *.tgz gitignored
v2.8.1 March 13, 2026
Highlights Added: Discussion depth verification and context write-gate · Fixed: Bump fsevents to ~2.3.3 for Node 25 compatibility

Fixed

  • Bump fsevents to ~2.3.3 for Node 25 compatibility (#186)
  • Inject observability warnings into agent prompt for enforcement (#174)
  • Auto-detect headless environment for Playwright browser launch (#183)
  • Add configurable merge_strategy preference for slice completion (#167)
  • Verify UAT artifact before marking complete-slice done (#176, #175)
  • Require prior slices complete on main in auto-mode (#160)
  • smartStage fallback bypasses runtime exclusions when .gsd/ is gitignored (#168)
  • fsevents as optional dep to fix install on Linux (#182)
  • Graceful shutdown for /exit (#134)

Added

  • Discussion depth verification and context write-gate (#181)
  • TTSR + blob/artifact storage
  • Skip/discard escape hatches to no-roadmap wizard
v2.8.0 March 13, 2026
Highlights Added: Browser tools: browser_analyze_form and browser_fill_form — form field inventory and intelligent filling by label/nam… · Changed: Browser tools: decomposed 5000-line monolithic index.ts into focused modules (state, capture, settle, lifecycle, refs…

[2.8.0] - 2026-03-13

Added

  • Browser tools: browser_analyze_form and browser_fill_form — form field inventory and intelligent filling by label/name/placeholder
  • Browser tools: browser_find_best — scored element candidates for semantic intents
  • Browser tools: browser_act — execute common browser micro-tasks in one call
  • Browser tools: 108 unit and integration tests covering all new components

Changed

  • Browser tools: decomposed 5000-line monolithic index.ts into focused modules (state, capture, settle, lifecycle, refs, utils) with 11 categorized tool files
  • Browser tools: consolidated state capture reduces evaluate round-trips per action
  • Browser tools: zero-mutation settle short-circuit for faster page interaction
  • Browser tools: conditional body text capture — low-signal tools skip it for smaller token payloads
  • Browser tools: screenshot resizing uses sharp instead of canvas evaluate calls
  • Browser tools: screenshots opt-in on navigate (no longer sent by default)

Install/upgrade: npm install -g gsd-pi@latest

v2.7.1 March 13, 2026
Highlights Added: Model fallback support for auto-mode phases — if the configured model fails, GSD tries alternate models before stopping · Changed: /exit uses graceful shutdown (saves session state); /kill replaces the old immediate-exit behavior · Fixed: npm install -g gsd-pi now works — workspace packages bundled in npm tarball via bundleDependencies

[2.7.1] - 2026-03-13

Added

  • Model fallback support for auto-mode phases — if the configured model fails, GSD tries alternate models before stopping
  • /kill command for immediate process termination

Fixed

  • npm install -g gsd-pi now works — workspace packages bundled in npm tarball via bundleDependencies
  • External PI ecosystem packages (pi-rtk, pi-context, etc.) can now resolve @mariozechner/* imports through jiti aliases
  • Missing export-html vendor files (marked.min.js, highlight.min.js) restored
  • Skipped API keys now persist so the setup wizard doesn&#39;t repeat on every launch
  • Provider config and extension loading reused correctly

Changed

  • /exit uses graceful shutdown (saves session state); /kill replaces the old immediate-exit behavior

Install/upgrade: npm install -g gsd-pi@latest

v2.7.0 March 13, 2026
Highlights Changed: Vendor Pi SDK source (tui, ai, agent-core, coding-agent) into workspace monorepo under `packages/`, replacing the compiled npm dependency and patch-package workflow. Pi internals are now directly modifiable as TypeScript source.

Changed

  • Vendor Pi SDK source (tui, ai, agent-core, coding-agent) into workspace monorepo under packages/, replacing the compiled npm dependency and patch-package workflow. Pi internals are now directly modifiable as TypeScript source.
  • Existing patches (setModel persist option, Windows VT input caching) applied as source edits.
  • Build pipeline runs workspace packages in dependency order before GSD compilation.
  • Removed patch-package from devDependencies and postinstall.

Install/upgrade: npm install -g gsd-pi@latest

v2.6.0 March 13, 2026
Highlights Added: Proactive secret management — planning phase forecasts required API keys into a manifest; auto-mode collects pending … · Fixed: Doctor post-hook no longer preempts complete-slice dispatch

[2.6.0] - 2026-03-12

Added

  • Proactive secret management — planning phase forecasts required API keys into a manifest; auto-mode collects pending secrets before dispatching the first slice
  • --continue / -c CLI flag to resume the most recent session

Fixed

  • Doctor post-hook no longer preempts complete-slice dispatch
  • main_branch preference restored; runPreMergeCheck implemented for merge safety
  • Recovery/retry prompt injection capped to prevent V8 OOM on large sessions
  • .gsd/ excluded from pre-switch auto-commits to prevent squash merge conflicts

Install/upgrade: npm install -g gsd-pi@latest

v2.5.1 March 12, 2026
Highlights Added: secure_env_collect now auto-detects existing keys, destination files, and provides guidance field for better onboardi… · Changed: Right-sized pipeline for simple work — single-slice milestones skip redundant research/plan sessions, reducing 9-10 s… · Fixed: Squash-merge now aborts cleanly on conflict and stops auto-mode instead of looping with corrupted state

[2.5.1] - 2026-03-12

Added

  • secure_env_collect now auto-detects existing keys, destination files, and provides guidance field for better onboarding UX

Changed

  • Right-sized pipeline for simple work — single-slice milestones skip redundant research/plan sessions, reducing 9-10 sessions to 5-6
  • Heavyweight plan sections (Proof Level, Integration Closure, Observability) are now conditional, omitted for simple slices

Fixed

  • Squash-merge now aborts cleanly on conflict and stops auto-mode instead of looping with corrupted state
  • Resolved baked-in merge conflict markers in loader.ts, logo.ts, and postinstall.js

Install/upgrade: npm install -g gsd-pi@latest

v2.5.0 March 12, 2026
Highlights Added: Native Anthropic web search — Claude models get server-side web search automatically, no Brave API key required · Fixed: State machine deadlock when units fail to produce expected artifacts — retry and cross-validation now gate completion

Added

  • Native Anthropic web search — Claude models get server-side web search automatically, no Brave API key required
  • GitService fully wired into codebase — programmatic git operations replace shell-based git commands in prompts
  • Merge guards prevent slice completion when uncommitted changes or conflicts exist
  • Snapshot support for saving and restoring .gsd/ state
  • Auto-push after slice squash-merge to main
  • Rich commit messages with structured metadata

Fixed

  • State machine deadlock when units fail to produce expected artifacts — retry and cross-validation now gate completion
  • Duplicate Brave search tools when toggling providers repeatedly
  • Windows test glob patterns (single quotes → unquoted for shell expansion)
  • Conversation replay error caused by thinking blocks in stored history
  • Brave search tools removed from API payload when no BRAVE_API_KEY is set
  • Restore notifications suppressed on session resume to reduce UX noise

Install/upgrade: npm install -g gsd-pi@latest

v2.4.0 March 12, 2026
Highlights Added: Automatic migration of provider credentials from existing Pi installations — skip re-authentication when switching to… · Changed: System prompt compressed by 48% (360 → 187 lines) for better context efficiency · Fixed: RPC mode crash when ctx.ui.theme is undefined

[2.4.0] - 2026-03-12

Added

  • Automatic migration of provider credentials from existing Pi installations — skip re-authentication when switching to GSD
  • Pi extensions from ~/.pi/agent/extensions/ discoverable in interactive mode
  • GitService core implementation for programmatic git operations

Changed

  • System prompt compressed by 48% (360 → 187 lines) for better context efficiency
  • Refined agent character and communication style prompts
  • Added craft standards, self-debugging awareness, and work narration to agent prompts

Fixed

  • RPC mode crash when ctx.ui.theme is undefined (#121)

Install/upgrade: npm install -g gsd-pi@latest

v2.3.11 March 12, 2026
Highlights Added: Branded clack-based onboarding wizard on first launch — LLM provider selection (OAuth + API key), optional tool API k… · Changed: wizard.ts trimmed to env hydration only — onboarding logic moved to onboarding.ts · Fixed: Parallel subagent results no longer truncated at 200 characters

[2.3.11] - 2026-03-12

Added

  • Branded clack-based onboarding wizard on first launch — LLM provider selection (OAuth + API key), optional tool API keys, and setup summary (#118)
  • gsd config subcommand to re-run the setup wizard anytime
  • Shared src/logo.ts module as single source of truth for ASCII banner

Fixed

  • Parallel subagent results no longer truncated at 200 characters

Changed

  • wizard.ts trimmed to env hydration only — onboarding logic moved to onboarding.ts
  • First-launch banner removed from loader.ts (onboarding wizard handles branding)

Install/upgrade: npm install -g gsd-pi@latest

v2.3.10 March 12, 2026
Highlights Added: Branded postinstall experience with animated spinners, progress indicators, and clean summary · Fixed: Ctrl+Alt shortcuts (dashboard, bg manager, voice) now show slash-command fallback in terminals that lack Kitty keyboa…

[2.3.10] - 2026-03-12

Added

  • Branded postinstall experience with animated spinners, progress indicators, and clean summary (#115)

Fixed

  • Ctrl+Alt shortcuts (dashboard, bg manager, voice) now show slash-command fallback in terminals that lack Kitty keyboard protocol support — macOS Terminal.app, JetBrains IDEs (#100, #104)
v2.3.9 March 12, 2026
Highlights Added: Tavily as alternative web search provider alongside Brave Search · Fixed: Auto-mode infinite loop and closeout instability — idempotent unit dispatch, retry caps, and atomic closeout (#96, #109)

[2.3.9] - 2026-03-12

Added

  • Tavily as alternative web search provider alongside Brave Search (#102)
  • Auto-mode progress widget now shows all stats; footer hidden during auto-mode (#75)

Fixed

  • Auto-mode infinite loop and closeout instability — idempotent unit dispatch, retry caps, and atomic closeout (#96, #109)
  • Migration no longer requires ROADMAP.md — milestones inferred from phases/ directory when missing (#93, #90)
  • Worktree branch safety — proper namespacing and slice branch base selection (#92)
  • Windows: use execFile to avoid single-quote shell issues (#103)
  • Broken read @GSD-WORKFLOW.md references replaced with /gsd command (#88)
  • Google Search extension updated to use gemini-2.5-flash (#83)
  • Duplicate getCurrentBranch import in auto.ts (#87)
  • formatCost crash on non-number cost values (#74)
  • Avoid sudo prompts in postinstall script (#73)
  • .gsd/ folder removed from git tracking; consolidated .gitignore (#78)
  • Multiple community-reported bugs across CLI, auto-mode, and extensions

Install/upgrade: npm install -g gsd-pi@latest

v2.3.8 March 12, 2026
Highlights Fixed: Worktree file operations (Write, Read, Edit) now resolve paths against the active working directory instead of the la…

Fixed

  • Worktree file operations (Write, Read, Edit) now resolve paths against the active working directory instead of the launch directory (#72)
  • Auto-mode merge guard handles all slice completion paths, preventing infinite dispatch loops when complete-slice is bypassed (#71)

Install/upgrade: npx gsd-pi@latest

v2.3.7 March 11, 2026
Highlights Added: Remote user questions via Slack/Discord for headless auto-mode sessions · Changed: Remote question result details use discriminated union type · Fixed: Auto-mode model switches no longer persist as the user's global default

[2.3.7] - 2026-03-11

Added

  • Remote user questions via Slack/Discord for headless auto-mode sessions

Fixed

  • Auto-mode model switches no longer persist as the user&#39;s global default (#30)
  • Auto-mode resume now rebuilds disk state and runs doctor before dispatching, preventing inline execution after pause (#16)
  • Silent dispatch failure when command context is null now surfaces an error notification
  • Race condition between timeout handlers and prompt dispatch in auto-mode
  • Remote questions: validate IDs before test-send, sanitize error messages to prevent token leakage
  • Remote questions: cap user_note at 500 chars to prevent LLM context injection
  • Remote questions: validate channel ID format to prevent SSRF
  • Remote questions: add 15s per-request fetch timeout to adapters
  • Remote questions: distinguish Discord 404 from auth errors in reactions
  • Prompt store sorting uses updatedAt instead of filename
  • TypeScript parameter properties desugared for --experimental-strip-types compatibility

Changed

  • Remote question result details use discriminated union type

Install/upgrade: npm install -g gsd-pi@latest

v2.3.6 March 11, 2026
Highlights Changed: Updated README to reflect current commands, extensions, and step mode workflow · Fixed: Postinstall no longer triggers hidden sudo prompt on Linux — Playwright's --with-deps flag is no longer run automatic…

[2.3.6] - 2026-03-11

Fixed

  • Postinstall no longer triggers hidden sudo prompt on Linux — Playwright&#39;s --with-deps flag is no longer run automatically, preventing npm install -g from appearing to hang (#67)
  • Auto-commit dirty files before branch switch to prevent lost work during slice transitions

Changed

  • Updated README to reflect current commands, extensions, and step mode workflow

Install/upgrade: npx gsd-pi@latest

v2.3.5 March 11, 2026
Highlights Fixed: Voice extension: transcription no longer lost when pausing and resuming recording

Fixed

  • Voice extension: transcription no longer lost when pausing and resuming recording

Install/upgrade: npm install -g gsd-pi@latest

v2.3.4 March 11, 2026
Highlights Added: CHANGELOG.md with curated history from v0.1.6 onwards

Added

  • CHANGELOG.md with curated history from v0.1.6 onwards
  • Project-local /publish-version command for npm releases
  • GitHub Sponsors funding configuration
  • npm publish and install smoke test

Install/upgrade: npm install -g gsd-pi@latest

The Seed v0.2–v0.3

v0.3.0 March 11, 2026
Highlights Added: /worktree (/wt) — git worktree lifecycle management for GSD · Fixed: Startup fallback no longer overwrites user's default model with Sonnet

Added

  • /worktree (/wt) — git worktree lifecycle management for GSD (#31)
  • /gsd migrate — .planning to .gsd migration tool (#28)

Fixed

  • Startup fallback no longer overwrites user&#39;s default model with Sonnet (#29)
  • Scoped models restored from settings on new session startup (#22)
  • Skipped API keys persisted so wizard doesn&#39;t repeat on every launch (#27)
v0.2.9 March 11, 2026
Highlights Fixed: Milestones with summary but no roadmap (pre-roadmap convention) are now correctly treated as complete

Fixed

  • Milestones with summary but no roadmap (pre-roadmap convention) are now correctly treated as complete (#13)
  • Idle recovery skips stuck units with blocker placeholders instead of silently stalling auto-mode (#17, #19)
  • pkg/package.json version synced with pi-coding-agent to prevent false update banner (#15)