docs: update changelog and documentation for v1.9.0

2026-01-20 11:53:21 -06:00
parent 6e757aaa77
commit 9a3a394f79
3 changed files with 120 additions and 3 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,29 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

 ## [Unreleased]

+## [1.9.0] - 2025-01-20
+
+### Added
+- **Codebase Intelligence System** — Automatic semantic understanding of your codebase
+  - `/gsd:analyze-codebase` now generates semantic entities (modules, services, utils) from AST analysis
+  - `/gsd:query-intel` command for CLI access to dependency graph (`dependents`, `hotspots`)
+  - SQLite graph database (`.planning/intel/graph.db`) stores entity relationships
+  - SessionStart hook injects relevant codebase context into conversations
+  - PostToolUse hook maintains index incrementally as files change
+  - Stop hook prunes deleted files from index
+- **Model Profiles** — `/gsd:set-profile` for quality/balanced/budget agent configurations
+- **Workflow Settings** — `/gsd:settings` command for toggling workflow behaviors interactively
+
+### Changed
+- Subagent prompts now include codebase intelligence context when available
+- New project initialization creates intel directory structure
+- Install process registers intel hooks automatically
+- Documentation updated: help.md, README.md with new commands and codebase intelligence features
+
+### Fixed
+- Orchestrators now inline file contents in Task prompts (fixes context issues with @ references)
+- Tech debt from milestone audit addressed
+
 ## [1.8.0] - 2026-01-19

 ### Added
@@ -957,7 +980,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - YOLO mode for autonomous execution
 - Interactive mode with checkpoints

-[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.8.0...HEAD
+[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.9.0...HEAD
+[1.9.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.9.0
 [1.8.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.8.0
 [1.7.1]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.7.1
 [1.7.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.7.0
--- a/README.md
+++ b/README.md
@@ -326,13 +326,14 @@ Use for: bug fixes, small features, config changes, one-off tasks.

 ### Codebase Intelligence

-GSD learns your codebase patterns automatically. As Claude writes code, a PostToolUse hook indexes exports and imports, detects naming conventions, and builds a lightweight intelligence layer.
+GSD learns your codebase patterns automatically. As Claude writes code, a PostToolUse hook indexes exports and imports, detects naming conventions, and builds a semantic understanding of your codebase.

 **How it works:**

 1. **Automatic learning** — Every time Claude writes or edits a JS/TS file, the hook extracts exports/imports and updates `.planning/intel/index.json`
 2. **Convention detection** — Analyzes exports for naming patterns (camelCase, PascalCase, etc.), identifies directory purposes, detects file suffixes
-3. **Context injection** — At session start, injects a summary into Claude's context so it knows your codebase structure and conventions
+3. **Graph database** — Stores entity relationships in SQLite for dependency analysis
+4. **Context injection** — At session start, injects a summary into Claude's context so it knows your codebase structure and conventions

 **For existing codebases:**

@@ -342,12 +343,20 @@ GSD learns your codebase patterns automatically. As Claude writes code, a PostTo

 Performs a bulk scan of your codebase to bootstrap the intelligence layer. Works standalone — no `/gsd:new-project` required. After initial analysis, hooks continue incremental learning.

+**Query the graph:**
+
+```
+/gsd:query-intel dependents src/lib/db.ts   # What depends on this file?
+/gsd:query-intel hotspots                    # Most-depended-on files
+```
+
 **Files created:**

 | File | Purpose |
 |------|---------|
 | `.planning/intel/index.json` | File exports and imports index |
 | `.planning/intel/conventions.json` | Detected patterns (naming, directories, suffixes) |
+| `.planning/intel/graph.db` | SQLite database with entity relationships |
 | `.planning/intel/summary.md` | Concise context for session injection |

 **Benefits:**
@@ -355,6 +364,8 @@ Performs a bulk scan of your codebase to bootstrap the intelligence layer. Works
 - Claude follows your naming conventions automatically
 - New files go in the right directories
 - Consistency maintained across sessions
+- Query blast radius before refactoring
+- Identify high-impact hotspot files
 - No manual documentation of patterns needed

 ### Context Engineering
@@ -449,6 +460,7 @@ You're never locked in. The system adapts.
 | `/gsd:plan-phase [N]` | Research + plan + verify for a phase |
 | `/gsd:execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
 | `/gsd:verify-work [N]` | Manual user acceptance testing ¹ |
+| `/gsd:audit-milestone` | Verify milestone achieved its definition of done |
 | `/gsd:complete-milestone` | Archive milestone, tag release |
 | `/gsd:new-milestone [name]` | Start next version: questions → research → requirements → roadmap |

@@ -458,6 +470,8 @@ You're never locked in. The system adapts.
 |---------|--------------|
 | `/gsd:progress` | Where am I? What's next? |
 | `/gsd:help` | Show all commands and usage guide |
+| `/gsd:whats-new` | See what changed since your installed version |
+| `/gsd:update` | Update GSD with changelog preview |

 ### Brownfield

@@ -465,6 +479,7 @@ You're never locked in. The system adapts.
 |---------|--------------|
 | `/gsd:map-codebase` | Analyze existing codebase before new-project |
 | `/gsd:analyze-codebase` | Bootstrap codebase intelligence for existing projects |
+| `/gsd:query-intel <type>` | Query dependency graph (dependents, hotspots) |

 ### Phase Management

@@ -473,6 +488,8 @@ You're never locked in. The system adapts.
 | `/gsd:add-phase` | Append phase to roadmap |
 | `/gsd:insert-phase [N]` | Insert urgent work between phases |
 | `/gsd:remove-phase [N]` | Remove future phase, renumber |
+| `/gsd:list-phase-assumptions [N]` | See Claude's intended approach before planning |
+| `/gsd:plan-milestone-gaps` | Create phases to close gaps from audit |

 ### Session

--- a/commands/gsd/help.md
+++ b/commands/gsd/help.md
@@ -285,6 +285,73 @@ List pending todos and select one to work on.
 Usage: `/gsd:check-todos`
 Usage: `/gsd:check-todos api`

+### User Acceptance Testing
+
+**`/gsd:verify-work [phase]`**
+Validate built features through conversational UAT.
+
+- Extracts testable deliverables from SUMMARY.md files
+- Presents tests one at a time (yes/no responses)
+- Automatically diagnoses failures and creates fix plans
+- Ready for re-execution if issues found
+
+Usage: `/gsd:verify-work 3`
+
+### Milestone Auditing
+
+**`/gsd:audit-milestone [version]`**
+Audit milestone completion against original intent.
+
+- Reads all phase VERIFICATION.md files
+- Checks requirements coverage
+- Spawns integration checker for cross-phase wiring
+- Creates MILESTONE-AUDIT.md with gaps and tech debt
+
+Usage: `/gsd:audit-milestone`
+
+**`/gsd:plan-milestone-gaps`**
+Create phases to close gaps identified by audit.
+
+- Reads MILESTONE-AUDIT.md and groups gaps into phases
+- Prioritizes by requirement priority (must/should/nice)
+- Adds gap closure phases to ROADMAP.md
+- Ready for `/gsd:plan-phase` on new phases
+
+Usage: `/gsd:plan-milestone-gaps`
+
+### Configuration
+
+**`/gsd:settings`**
+Configure workflow toggles and model profile interactively.
+
+- Toggle researcher, plan checker, verifier agents
+- Select model profile (quality/balanced/budget)
+- Updates `.planning/config.json`
+
+Usage: `/gsd:settings`
+
+**`/gsd:set-profile <profile>`**
+Quick switch model profile for GSD agents.
+
+- `quality` — Opus everywhere except verification
+- `balanced` — Opus for planning, Sonnet for execution (default)
+- `budget` — Sonnet for writing, Haiku for research/verification
+
+Usage: `/gsd:set-profile budget`
+
+### Codebase Intelligence
+
+**`/gsd:query-intel <type> [path]`**
+Query the codebase intelligence graph database.
+
+- `dependents <file>` — What files depend on this? (blast radius)
+- `hotspots` — Which files have the most dependents?
+
+Requires `/gsd:analyze-codebase` to build the graph first.
+
+Usage: `/gsd:query-intel dependents src/lib/db.ts`
+Usage: `/gsd:query-intel hotspots`
+
 ### Utility Commands

 **`/gsd:help`**
@@ -300,6 +367,15 @@ See what's changed since your installed version.

 Usage: `/gsd:whats-new`

+**`/gsd:update`**
+Update GSD to latest version with changelog preview.
+
+- Shows what changed before updating
+- Confirms before running install
+- Better than raw `npx get-shit-done-cc`
+
+Usage: `/gsd:update`
+
 ## Files & Structure

 ```