@tekyzinc/gsd-t 2.16.4 → 2.17.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.17.0] - 2026-02-16
+
+### Added
+- `/user:gsd-t-log` command — sync progress.md Decision Log with recent git activity by scanning commits since last logged entry
+- Incremental updates (only new commits) and first-time full reconstruction from git history
+- Total commands: 38 GSD-T + 3 utility = 41
+
+## [2.16.5] - 2026-02-16
+
+### Added
+- `gsd-t-populate` now reconstructs Decision Log from git history — parses all commits, generates timestamped entries, merges with existing log
+- Pre-Commit Gate explicitly lists all 30 file-modifying commands that must log to progress.md
+
+### Changed
+- Rebuilt GSD-T project Decision Log with full `YYYY-MM-DD HH:MM` timestamps from 54 git commits
+
 ## [2.16.4] - 2026-02-16
 
 ### Changed

package/README.md

@@ -18,7 +18,7 @@ A methodology for reliable, parallelizable development using Claude Code with op
 npx @tekyzinc/gsd-t install
 ```
 
-This installs 37 GSD-T commands + 3 utility commands to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
+This installs 38 GSD-T commands + 3 utility commands to `~/.claude/commands/` and the global CLAUDE.md to `~/.claude/CLAUDE.md`. Works on Windows, Mac, and Linux.
 
 ### Start Using It
 
@@ -142,6 +142,7 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | `/user:gsd-t-resume` | Restore context, continue | Manual |
 | `/user:gsd-t-quick` | Fast task with GSD-T guarantees | Manual |
 | `/user:gsd-t-debug` | Systematic debugging with state | Manual |
+| `/user:gsd-t-log` | Sync progress Decision Log with recent git activity | Manual |
 | `/user:gsd-t-version-update` | Update GSD-T to latest version | Manual |
 | `/user:gsd-t-version-update-all` | Update GSD-T + all registered projects | Manual |
 
@@ -280,8 +281,8 @@ get-stuff-done-teams/
 ├── LICENSE
 ├── bin/
 │   └── gsd-t.js                       # CLI installer
-├── commands/                          # 40 slash commands
-│   ├── gsd-t-*.md                     # 37 GSD-T workflow commands
+├── commands/                          # 41 slash commands
+│   ├── gsd-t-*.md                     # 38 GSD-T workflow commands
 │   ├── branch.md                      # Git branch helper
 │   ├── checkin.md                     # Auto-version + commit/push helper
 │   └── Claude-md.md                   # Reload CLAUDE.md directives

package/commands/gsd-t-help.md

@@ -52,6 +52,7 @@ UTILITIES                                                              Manual
   debug               Systematic debugging with state
   promote-debt        Convert techdebt items to milestones
   populate            Auto-populate docs from existing codebase
+  log                 Sync progress Decision Log with recent git activity
   version-update      Update GSD-T package to latest version
   version-update-all  Update GSD-T package + all registered projects
 
@@ -295,6 +296,13 @@ Use these when user asks for help on a specific command:
 - **Updates**: `docs/requirements.md`, `docs/architecture.md`, `docs/workflows.md`, `docs/infrastructure.md`, `.gsd-t/progress.md`
 - **Use when**: You have an existing codebase and want to fill docs with real findings instead of placeholders
 
+### log
+- **Summary**: Sync progress.md Decision Log with recent git activity
+- **Auto-invoked**: No
+- **Files**: `.gsd-t/progress.md`, git history
+- **Use when**: Progress.md Decision Log is behind — catches up by scanning git commits since the last logged entry
+- **Features**: Incremental updates, first-time full reconstruction from git history, groups same-day changes
+
 ### backlog-add
 - **Summary**: Capture a new backlog item with auto-categorization
 - **Auto-invoked**: No

package/commands/gsd-t-log.md

@@ -0,0 +1,87 @@
+# GSD-T: Log — Sync Progress Decision Log with Recent Activity
+
+Update `.gsd-t/progress.md` Decision Log by scanning git history for commits not yet recorded. Works on any GSD-T project.
+
+## Step 1: Load State
+
+Read:
+1. `.gsd-t/progress.md` — current Decision Log entries
+2. Note the **last entry's timestamp** — this is the cutoff; only commits after this time need processing
+
+If `.gsd-t/progress.md` doesn't exist, inform user: "No GSD-T state found. Run `/user:gsd-t-init` first."
+
+## Step 2: Get Recent Commits
+
+Run: `git log --reverse --format="%ai|%s" --after="{last entry date}"`
+
+If no cutoff exists (empty Decision Log), get the full history:
+`git log --reverse --format="%ai|%s"`
+
+## Step 3: Filter and Format
+
+For each commit since the last logged entry:
+
+1. **Skip** merge commits, whitespace-only changes, and commits already in the Decision Log
+2. **Group** multiple commits on the same day that cover the same logical change into one entry
+3. **Format** each entry:
+   ```
+   - YYYY-MM-DD HH:MM: {commit summary} — {brief context}
+   ```
+4. If the commit message includes a version tag like `(vX.Y.Z)`, append it to the entry
+
+### What to include:
+- Feature additions, bug fixes, refactors
+- Config/dependency changes
+- Documentation updates
+- Version bumps and releases
+- Any commit that modified documents, scripts, or code
+
+### What to exclude:
+- Pure merge commits with no additional context
+- Commits that only change whitespace or formatting
+- Entries already in the Decision Log (check by date+content match)
+
+## Step 4: Append to Decision Log
+
+Append the new entries chronologically at the end of the existing Decision Log section in `.gsd-t/progress.md`.
+
+Do NOT modify or rewrite existing entries — only add new ones.
+
+## Step 5: Report
+
+Show a summary:
+
+```
+Progress Log Updated
+
+  Commits scanned:  {N}
+  New entries added: {M}
+  Last entry:        {date and summary of most recent entry}
+
+Decision Log now has {total} entries covering {first date} to {last date}.
+```
+
+If no new commits were found:
+```
+Progress Log — already up to date
+
+  Last entry: {date and summary}
+  No new commits since last log entry.
+```
+
+## Step 6: First-Time Reconstruction
+
+If the Decision Log is empty or has fewer than 3 entries and git history has 5+ commits, offer full reconstruction:
+
+```
+The Decision Log appears sparse but this project has {N} commits.
+Reconstructing full history from git...
+```
+
+Then run the full reconstruction (same as the populate command's git history reconstruction):
+1. Parse all commits
+2. Generate timestamped entries
+3. Group by logical change
+4. Mark reconstructed entries: `(Entries before {date} reconstructed from git history)`
+
+$ARGUMENTS

package/commands/gsd-t-populate.md

@@ -35,6 +35,36 @@ Scan this codebase and populate the GSD-T documentation. Analyze the actual code
 - Set status: VERIFIED
 - Log today session: "GSD-T documentation populated from existing codebase"
 
+## Reconstruct Decision Log from Git History
+
+Rebuild the progress.md Decision Log from the project's commit history:
+
+1. **Read existing Decision Log entries** — note what's already recorded to avoid duplicates
+2. **Run `git log --reverse --format="%ai|%s"`** — get all commits with timestamps and messages
+3. **Filter meaningful commits** — skip merge commits, trivial whitespace/formatting-only commits
+4. **Generate entries** in the standard format:
+   ```
+   - YYYY-MM-DD HH:MM: {commit summary} — {brief context from commit message}
+   ```
+5. **Group by date** — if multiple commits on the same day cover the same logical change, combine them into one entry rather than listing each commit separately
+6. **Merge with existing entries** — insert reconstructed entries chronologically, keeping any hand-written entries that already exist (they may have richer context than commit messages)
+7. **Mark the reconstruction** — add a note at the top of the reconstructed section:
+   ```
+   (Entries before {date} reconstructed from git history)
+   ```
+
+### What to include:
+- Feature additions, bug fixes, refactors
+- Config/dependency changes
+- Documentation updates
+- Version bumps and releases
+- Any commit that modified documents, scripts, or code
+
+### What to exclude:
+- Pure merge commits with no additional context
+- Commits that only change whitespace or formatting
+- Duplicate entries already in the Decision Log
+
 ---
 
 ## Document Ripple

package/docs/GSD-T-README.md

@@ -111,6 +111,7 @@ GSD-T reads all state files and tells you exactly where you left off.
 | `/user:gsd-t-resume` | Restore context, continue | Manual |
 | `/user:gsd-t-quick` | Fast task with GSD-T guarantees | Manual |
 | `/user:gsd-t-debug` | Systematic debugging with state | Manual |
+| `/user:gsd-t-log` | Sync progress Decision Log with recent git activity | Manual |
 | `/user:gsd-t-version-update` | Update GSD-T to latest version | Manual |
 | `/user:gsd-t-version-update-all` | Update GSD-T + all registered projects | Manual |
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.16.4",
-  "description": "GSD-T: Contract-Driven Development for Claude Code — 40 slash commands with backlog management, impact analysis, test sync, and milestone archival",
+  "version": "2.17.0",
+  "description": "GSD-T: Contract-Driven Development for Claude Code — 41 slash commands with backlog management, impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",
   "repository": {

package/templates/CLAUDE-global.md

@@ -54,6 +54,7 @@ PROJECT or FEATURE or SCAN
 | `/user:gsd-t-debug` | Systematic debugging |
 | `/user:gsd-t-quick` | Fast task, respects contracts |
 | `/user:gsd-t-populate` | Auto-populate docs from existing codebase |
+| `/user:gsd-t-log` | Sync progress Decision Log with recent git activity |
 | `/user:gsd-t-resume` | Restore context, continue |
 | `/user:gsd-t-version-update` | Update GSD-T to latest version |
 | `/user:gsd-t-version-update-all` | Update GSD-T + all registered projects |
@@ -205,11 +206,16 @@ BEFORE EVERY COMMIT:
   │     YES → Update docs/requirements.md (mark complete or revise)
   ├── Did I add/change/remove a component or change data flow?
   │     YES → Update docs/architecture.md
-  ├── Did I complete a task or make a meaningful change?
+  ├── Did I modify any document, script, or code file?
   │     YES → Add timestamped entry to .gsd-t/progress.md Decision Log
   │     Format: `- YYYY-MM-DD HH:MM: {what was done} — {brief context or result}`
+  │     This includes ALL file-modifying activities:
+  │       project, feature, scan, gap-analysis, milestone, partition, discuss,
+  │       plan, impact, execute, test-sync, integrate, verify, complete-milestone,
+  │       wave, quick, debug, promote-debt, populate, setup, init, init-scan-setup,
+  │       backlog-add/edit/move/remove/promote/settings, and any manual code changes
   ├── Did I make an architectural or design decision?
-  │     YES → Add to .gsd-t/progress.md Decision Log (with decision rationale)
+  │     YES → Also include decision rationale in the progress.md entry
   ├── Did I discover or fix tech debt?
   │     YES → Update .gsd-t/techdebt.md
   ├── Did I establish a pattern future work should follow?