Juan Francisco Lebrero
99c3375f18
feat: add gsd headless query for instant state inspection ( #951 )
...
* feat: add `gsd headless query` for structured state inspection
Add read-only query commands that return parseable JSON without
spawning an LLM session. Decouples orchestrators from .gsd/ internals.
Targets: phase, cost, progress, next
* simplify: single `query` command returning full snapshot
Replace 4 query targets (phase/cost/progress/next) with one command
that returns everything in a single JSON object. Caller uses jq.
Also document query in README.md and docs/commands.md.
* docs: update gsd-headless skill and references
- SKILL.md: add missing flags (--supervised, --max-restarts, --response-timeout)
- references/commands.md: add query, discuss, remote, inspect, forensics
- references/multi-session.md: fix spawning syntax, use query for budget
* fix: remove integration tests that entered via merge
These files belong to the feat/headless-orchestration-skill branch
and were accidentally included during the upstream/main merge.
They contain TS errors (sessionTerminated scope issue) that break CI.
* fix: restore headless-command.ts deleted by accident
2026-03-17 16:03:59 -06:00
Tom Boucher
d2a9ee6024
docs: update documentation for v2.26 features ( #958 )
...
Updated 6 files with 114 lines covering new v2.26 features:
auto-mode.md:
- Headless auto-restart on crash with exponential backoff
- Provider error classification and auto-resume (rate limit + server errors)
- Incremental memory system (KNOWLEDGE.md)
- Context pressure monitor (70% wrap-up signal)
- Meaningful commit messages from task summaries
- Verification enforcement with auto-fix retries
- Slice discussion gate (require_slice_discussion)
- HTML report generation (auto_report)
configuration.md:
- git.manage_gitignore preference (opt out of .gitignore changes)
- verification_commands, verification_auto_fix, verification_max_retries
- auto_report preference
troubleshooting.md:
- Provider error recovery table (transient vs permanent classification)
- Headless auto-restart for overnight unattended execution
commands.md:
- /gsd export --html command
- --max-restarts flag for headless mode
visualizer.md:
- HTML export and auto_report preference
README.md:
- git.manage_gitignore in preferences table
- git.isolation updated to include 'branch' option
2026-03-17 15:42:18 -06:00
Tom Boucher
0abc61987d
fix: add Alt+V as clipboard image paste shortcut on macOS and document it ( #852 ) ( #854 )
2026-03-17 08:19:13 -06:00
Tom Boucher
1aebc06c46
docs: update documentation for v2.24 release features ( #825 )
...
- README: add parallel orchestration link, update loop diagram with validate-milestone phase
- architecture: add lazy provider loading, memory-extractor/store modules, update module table to v2.24
- auto-mode: add rate limit recovery section, parallel worker status in dashboard
- commands: add headless new-milestone command with --context/--context-text/--auto flags
- getting-started: add update check notification note
- troubleshooting: update rate limit recovery guidance
- visualizer: add task counts, discussion status to progress tab
2026-03-17 07:47:28 -06:00
Tom Boucher
2f2d0507c1
docs: update documentation for v2.22 features ( #787 )
...
New v2.22 features documented:
- commands.md: Add /gsd forensics (post-mortem investigation) and /gsd cleanup
- commands.md: Add MCP Server Mode section for --mode mcp
- configuration.md: Add /gsd prefs import-claude commands for Claude marketplace import
- skills.md: Add review, test, and lint skills to bundled skills table
- auto-mode.md: Add Post-Mortem Investigation section referencing /gsd forensics
- troubleshooting.md: Add forensics to Getting Help section, fix corrupted duplicate line
- README.md: Update troubleshooting link description to include forensics
2026-03-16 21:47:20 -06:00
Jeremy McSpadden
01b0d530c8
docs: parallel milestone orchestration documentation
...
New: docs/parallel-orchestration.md — comprehensive guide covering:
- Architecture overview with coordinator/worker diagram
- Worker isolation model (process, worktree, state, context)
- Eligibility analysis (dependencies + file overlap)
- Configuration reference (all parallel.* keys)
- Commands reference (/gsd parallel start|status|stop|pause|resume|merge)
- Signal lifecycle (coordinator → worker communication)
- Merge reconciliation with conflict handling
- Budget management across workers
- Doctor integration and health monitoring
- Safety model breakdown
- File layout (.gsd/parallel/ and .gsd/worktrees/)
- Troubleshooting guide
Updated existing docs:
- auto-mode.md: cross-reference to parallel orchestration
- configuration.md: parallel config block with all keys
- commands.md: parallel commands table
- git-strategy.md: parallel worktree branching diagram
- README.md: added to documentation index
2026-03-16 20:32:10 -06:00
TÂCHES
e0c1cc2f9d
Merge branch 'main' into feat/gsd-headless-command
2026-03-16 18:44:18 -06:00
Jeremy McSpadden
6fd87c1936
docs: update documentation for all post-2.22.0 changes
...
- CHANGELOG: fill in [Unreleased] with gsd sessions, 10 new browser
tools, visualizer shift-tab fix, capture resolution fix, screenshot
constraint fix, auto.lock fix, and cross-platform test fix
- README: add gsd sessions to CLI reference table; expand Browser Tools
description to cover the 13 new tools shipped in #698
- docs/commands.md: add gsd sessions to CLI Flags table
- docs/getting-started.md: document gsd sessions in Resume a Session
- docs/proposals/698: mark status as Shipped, update Current State
section to reflect the 13 implemented tools
2026-03-16 18:48:52 -05:00
frizynn
f56b8c69f0
fix: simplify headless flags, add missing imports, document headless mode
...
- Remove --verbose flag from headless (use --json for detailed output)
- Remove redundant sawToolExecution state variable
- Remove unused rejectCompletion
- Add missing build*Prompt imports in auto.ts (fixes CI typecheck:extensions)
- Document headless mode in README.md and docs/commands.md
- Simplify help text with examples instead of exhaustive command catalog
2026-03-16 19:46:56 -03:00
Tom Boucher
18a0abbfe3
docs: update documentation for v2.20.0 release
...
Update README and docs/ to cover new features and changes in v2.20.0:
- commands.md: Added /gsd quick, /gsd mode, /gsd help, /gsd skill-health,
/gsd hooks, /gsd run-hook, gsd --debug flag. Reorganized into
Session Commands, Configuration & Diagnostics, Git, and Session Management.
- skills.md: Added Skill Lifecycle Management section covering telemetry,
health dashboard (/gsd skill-health), staleness detection, and heal-skill
post-unit analysis.
- remote-questions.md: Added Telegram as a third channel alongside
Slack and Discord, with setup instructions and bot requirements.
- configuration.md: Added skill_staleness_days preference.
- README.md: Added skill_staleness_days to key settings table, new
Agent Instructions section, and Debug Mode section.
2026-03-16 14:50:36 -04:00
Tom Boucher
330e5200bc
docs: add v2.18/v2.19 feature documentation ( #631 )
...
New docs:
- dynamic-model-routing.md — complexity classification, tier models,
escalation, budget pressure, cost table, adaptive learning
- captures-triage.md — fire-and-forget capture, triage pipeline,
classification types, dashboard integration, worktree awareness
- visualizer.md — four-tab TUI overlay (progress, deps, metrics,
timeline), controls, auto-refresh, auto_visualize preference
Updated docs:
- README.md — added links to three new docs
- commands.md — added capture, triage, visualize, knowledge, queue reorder
- configuration.md — added dynamic_routing and auto_visualize settings,
updated full example with new config options
- auto-mode.md — added capture, visualize sections, dashboard badge,
dynamic model routing reference
- architecture.md — updated dispatch pipeline (routing + captures steps),
added key modules table for v2.19
- cost-management.md — added dynamic routing and visualizer tips
2026-03-16 09:00:58 -06:00
Tom Boucher
2ae4633d05
docs: add comprehensive documentation set and update README ( #605 )
2026-03-16 06:21:43 -06:00