claude-code-autoconfig 1.0.142 → 1.0.144

package/.claude/commands/autoconfig-update.md

@@ -1,5 +1,9 @@
 <!-- @description Manages and installs updates to Claude Code configuration. -->
 <!-- @version 1 -->
+<!-- @response updates-available | Displays list of pending updates with install/review options. -->
+<!-- @response up-to-date | All updates are already installed. -->
+<!-- @sideeffect Pulls latest update files from npm, executes update instructions, tracks applied updates -->
+<!-- @example /autoconfig-update | Check for and install configuration updates -->
 
 <!-- @applied
 -->

package/.claude/commands/autoconfig.md

@@ -1,5 +1,9 @@
-<!-- @description The command you just ran. Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes. -->
+<!-- @description Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes. -->
 <!-- @version 8 -->
+<!-- @response success | CLAUDE.md populated, settings configured, docs opened in browser. -->
+<!-- @response no-project | No project detected — asks user to confirm directory. -->
+<!-- @sideeffect Generates CLAUDE.md, settings.json, hooks, and MEMORY.md -->
+<!-- @example /autoconfig | Analyze project and configure Claude -->
 
 # Autoconfig
 

package/.claude/commands/commit-and-push.md

@@ -1,5 +1,9 @@
 <!-- @description Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes. -->
 <!-- @version 1 -->
+<!-- @response success | Changes committed and pushed to current branch. -->
+<!-- @response test-failure | Tests failed — no commit made. -->
+<!-- @sideeffect Runs test suite, stages all changes, creates git commit, pushes to remote -->
+<!-- @example /commit-and-push | Run tests, commit, and push -->
 
 # Commit and Push
 

package/.claude/commands/enable-retro.md

@@ -1,5 +1,8 @@
 <!-- @description (Experimental) Enable Claude to log tech debt it encounters into .claude/retro. -->
 <!-- @version 1 -->
+<!-- @response success | Retro enabled — Claude will log tech debt to .claude/retro/ when encountered. -->
+<!-- @sideeffect Creates .claude/retro/README.md, adds agent, updates CLAUDE.md -->
+<!-- @example /enable-retro | Activate tech debt tracking -->
 
 # Enable Retro
 

package/.claude/commands/gls.md

@@ -1,5 +1,15 @@
 <!-- @screenshotDir /c/Users/andre/OneDrive/Pictures/Screenshots 1 -->
+<!-- @description Get the latest screenshot(s) and display them. -->
 <!-- @version 1 -->
+<!-- @param count | integer | optional | Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1. -->
+<!-- @param path | string | optional | Screenshot directory path. Saved for future use. Auto-detected if omitted. -->
+<!-- @response success | Displays requested screenshot(s) from newest to oldest. -->
+<!-- @response no-screenshots | Directory exists but contains no image files. -->
+<!-- @response no-directory | Unable to detect screenshot directory — prompts for path. -->
+<!-- @sideeffect Saves detected screenshot path to command file on first run -->
+<!-- @example /gls | Display the most recent screenshot -->
+<!-- @example /gls-3 | Display the 3 most recent screenshots -->
+<!-- @example /gls /path/to/dir | Use a specific screenshot directory -->
 Get the latest screenshot(s) and display them.
 
 Usage:

package/.claude/commands/recover-context.md

@@ -1,5 +1,14 @@
 <!-- @description Recovers conversation context from the session transcript after compaction. -->
 <!-- @version 4 -->
+<!-- @param minutes | integer | required | How far back to recover, in minutes. Leading dash optional. Min: 1. -->
+<!-- @param --show | flag | optional | Opens the extracted transcript in your default editor. -->
+<!-- @response success | ~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min). -->
+<!-- @response no-transcript | No transcript files found. -->
+<!-- @response no-messages | No messages found in the requested time range. -->
+<!-- @sideeffect Reads .jsonl transcripts from ~/.claude/projects/, writes temp file -->
+<!-- @example /recover-context -60 | Last 60 minutes of conversation -->
+<!-- @example /recover-context 120 | Last 2 hours (dash optional) -->
+<!-- @example /recover-context -60 --show | Last 60 min + open transcript file -->
 Recover recent conversation context from the raw session transcript on disk.
 
 Usage:

package/.claude/commands/show-docs.md

@@ -1,5 +1,9 @@
 <!-- @description Opens the interactive docs in your browser. -->
 <!-- @version 2 -->
+<!-- @response success | Docs synced and opened in default browser. -->
+<!-- @response no-docs | Docs file not found — run /autoconfig first. -->
+<!-- @sideeffect Runs sync-docs.js to refresh content, opens browser -->
+<!-- @example /show-docs | Open interactive documentation -->
 
 # Show Docs
 

package/.claude/commands/sync-claude-md.md

@@ -1,5 +1,8 @@
 <!-- @description Re-analyzes your project and updates CLAUDE.md to reflect current state. -->
 <!-- @version 2 -->
+<!-- @response success | CLAUDE.md updated with current project state. -->
+<!-- @sideeffect Overwrites auto-generated sections of CLAUDE.md, preserves Discoveries section -->
+<!-- @example /sync-claude-md | Re-scan project and update CLAUDE.md -->
 
 # Sync CLAUDE.md
 

package/.claude/commands/test.md

@@ -1,5 +1,12 @@
 <!-- @description Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test. -->
 <!-- @version 1 -->
+<!-- @param scope | string | optional | File, directory, or pattern to limit test run. Runs full suite if omitted. -->
+<!-- @response success | Test suite passes. -->
+<!-- @response failure | Test suite fails with non-zero exit code. -->
+<!-- @sideeffect Executes detected test runner command -->
+<!-- @example /test | Run full test suite -->
+<!-- @example /test src/auth | Run tests in src/auth directory -->
+<!-- @example /test --coverage | Run tests with coverage report -->
 
 # Run Tests
 

package/.claude/commands/validate-cca-install.md

@@ -0,0 +1,205 @@
+<!-- @description Validates your claude-code-autoconfig installation against the latest published version. -->
+<!-- @version 1 -->
+<!-- @response valid | Install validated — all checks passed. -->
+<!-- @response issues | Validation found {N} issue(s) with fix suggestions. -->
+<!-- @sideeffect Read-only. Downloads latest package to temp dir for comparison, then cleans up. -->
+<!-- @example /validate-cca-install | Run full installation validation -->
+Validate the current claude-code-autoconfig installation. Reports what's correct, what's outdated, and what's missing. **Does not modify anything.**
+
+Usage:
+- `/validate-cca-install` — run a full validation check
+
+## Step 1: Fetch the latest package metadata
+
+Query the npm registry for the latest published version and its file manifest:
+
+```bash
+python3 -c "
+import json, urllib.request
+url = 'https://registry.npmjs.org/claude-code-autoconfig/latest'
+data = json.loads(urllib.request.urlopen(url, timeout=10).read())
+print(json.dumps({'version': data.get('version', 'unknown')}))
+"
+```
+
+Store the latest version as `$LATEST_VERSION`.
+
+## Step 2: Download and extract the latest package to a temp directory
+
+```bash
+TMPDIR=$(mktemp -d)
+npm pack claude-code-autoconfig@latest --pack-destination "$TMPDIR" 2>/dev/null
+tar -xzf "$TMPDIR"/*.tgz -C "$TMPDIR"
+echo "$TMPDIR/package"
+```
+
+Store the extracted path as `$PKG_DIR`. This gives us the ground truth for what files and versions should be installed.
+
+## Step 3: Validate installed files
+
+Run this Python script. Substitute `$PKG_DIR` with the temp package path and `$PROJECT_DIR` with the current working directory.
+
+```bash
+python3 -c "
+import json, os, re, sys
+
+pkg_dir = '$PKG_DIR'
+project_dir = '$PROJECT_DIR'
+claude_dir = os.path.join(project_dir, '.claude')
+
+def parse_version(content):
+    m = re.search(r'<!-- @version (\d+) -->', content)
+    return int(m.group(1)) if m else 0
+
+def parse_description(content):
+    m = re.search(r'<!-- @description (.+?) -->', content)
+    return m.group(1).strip() if m else ''
+
+issues = []
+info = []
+
+# --- 1. Check expected directories ---
+expected_dirs = ['commands', 'agents', 'docs', 'feedback', 'hooks', 'scripts']
+for d in expected_dirs:
+    local = os.path.join(claude_dir, d)
+    if not os.path.isdir(local):
+        issues.append(f'MISSING DIR: .claude/{d}/ does not exist')
+    else:
+        info.append(f'OK: .claude/{d}/ exists')
+
+# --- 2. Check command files and versions ---
+dev_only = ['publish.md']
+pkg_cmds_dir = os.path.join(pkg_dir, '.claude', 'commands')
+local_cmds_dir = os.path.join(claude_dir, 'commands')
+
+if os.path.isdir(pkg_cmds_dir) and os.path.isdir(local_cmds_dir):
+    pkg_cmds = set(f for f in os.listdir(pkg_cmds_dir) if f.endswith('.md') and f not in dev_only)
+    local_cmds = set(f for f in os.listdir(local_cmds_dir) if f.endswith('.md') and f not in dev_only)
+
+    # Missing commands
+    for f in sorted(pkg_cmds - local_cmds):
+        issues.append(f'MISSING CMD: .claude/commands/{f} not installed')
+
+    # Extra commands (user-added, just note them)
+    for f in sorted(local_cmds - pkg_cmds):
+        if f not in dev_only:
+            info.append(f'EXTRA CMD: .claude/commands/{f} (user-added, not in package)')
+
+    # Version comparison for shared commands
+    for f in sorted(pkg_cmds & local_cmds):
+        pkg_content = open(os.path.join(pkg_cmds_dir, f), encoding='utf-8').read()
+        local_content = open(os.path.join(local_cmds_dir, f), encoding='utf-8').read()
+        pkg_v = parse_version(pkg_content)
+        local_v = parse_version(local_content)
+        if local_v < pkg_v:
+            issues.append(f'OUTDATED CMD: /{f.replace(\".md\",\"\")} is v{local_v}, latest is v{pkg_v}')
+        elif local_v > pkg_v:
+            info.append(f'AHEAD CMD: /{f.replace(\".md\",\"\")} is v{local_v}, package has v{pkg_v} (local is newer)')
+        else:
+            info.append(f'OK CMD: /{f.replace(\".md\",\"\")} v{local_v}')
+
+# --- 3. Check agent files ---
+pkg_agents_dir = os.path.join(pkg_dir, '.claude', 'agents')
+local_agents_dir = os.path.join(claude_dir, 'agents')
+if os.path.isdir(pkg_agents_dir) and os.path.isdir(local_agents_dir):
+    pkg_agents = set(os.listdir(pkg_agents_dir))
+    local_agents = set(os.listdir(local_agents_dir))
+    for f in sorted(pkg_agents - local_agents):
+        issues.append(f'MISSING AGENT: .claude/agents/{f} not installed')
+    for f in sorted(pkg_agents & local_agents):
+        info.append(f'OK AGENT: .claude/agents/{f}')
+
+# --- 4. Check docs ---
+pkg_docs_dir = os.path.join(pkg_dir, '.claude', 'docs')
+local_docs_dir = os.path.join(claude_dir, 'docs')
+if os.path.isdir(pkg_docs_dir):
+    for f in os.listdir(pkg_docs_dir):
+        if f.endswith('.html'):
+            if os.path.isdir(local_docs_dir) and f in os.listdir(local_docs_dir):
+                info.append(f'OK DOC: .claude/docs/{f}')
+            else:
+                issues.append(f'MISSING DOC: .claude/docs/{f} not installed')
+
+# --- 5. Check settings.json ---
+settings_path = os.path.join(claude_dir, 'settings.json')
+if os.path.isfile(settings_path):
+    try:
+        settings = json.loads(open(settings_path, encoding='utf-8').read())
+        if 'permissions' in settings:
+            info.append('OK: settings.json exists with permissions')
+        else:
+            issues.append('SETTINGS: settings.json exists but has no permissions block')
+    except json.JSONDecodeError:
+        issues.append('SETTINGS: settings.json exists but is invalid JSON')
+else:
+    issues.append('MISSING: .claude/settings.json not found')
+
+# --- 6. Check CLAUDE.md ---
+claude_md = os.path.join(project_dir, 'CLAUDE.md')
+if os.path.isfile(claude_md):
+    content = open(claude_md, encoding='utf-8').read()
+    if 'AUTO-GENERATED BY /autoconfig' in content:
+        info.append('OK: CLAUDE.md exists with autoconfig marker')
+    else:
+        info.append('NOTE: CLAUDE.md exists but missing autoconfig marker (may be manually written)')
+else:
+    issues.append('MISSING: CLAUDE.md not found (run /autoconfig to generate)')
+
+# --- 7. Check hooks reference integrity ---
+if os.path.isfile(settings_path):
+    try:
+        settings = json.loads(open(settings_path, encoding='utf-8').read())
+        hooks = settings.get('hooks', {})
+        for event, matchers in hooks.items():
+            if isinstance(matchers, list):
+                for matcher in matchers:
+                    cmd = matcher.get('command', '')
+                    # Extract file paths from hook commands
+                    for token in cmd.split():
+                        if token.endswith('.js') and '.claude/' in token:
+                            hook_path = token.replace('.claude/', '')
+                            full_path = os.path.join(claude_dir, hook_path)
+                            if os.path.isfile(full_path):
+                                info.append(f'OK HOOK: {token} exists')
+                            else:
+                                issues.append(f'BROKEN HOOK: {token} referenced in settings.json but file not found')
+    except:
+        pass
+
+# --- Output ---
+print(json.dumps({'issues': issues, 'info': info}, indent=2))
+"
+```
+
+## Step 4: Clean up temp directory
+
+```bash
+rm -rf "$TMPDIR"
+```
+
+## Step 5: Display the report
+
+Format the results as a clear report. Use this structure:
+
+If there are **no issues**:
+
+> **Install validated — all checks passed.**
+>
+> - Latest version: {version}
+> - {count} commands, {count} agents, {count} hooks — all current
+>
+> Your installation is up to date.
+
+If there are **issues**:
+
+> **Validation found {N} issue(s):**
+>
+> {list each issue with a brief explanation}
+>
+> **To fix:** run `npx claude-code-autoconfig@latest` (or `--force` for a clean reinstall).
+
+Always list the OK items in a collapsed/brief summary (don't enumerate every OK item unless the user asks). Focus attention on the issues.
+
+## Step 6: Stop
+
+Do NOT take any action to fix issues. The user decides what to do next.

package/.claude/docs/autoconfig.docs.html

@@ -34,7 +34,7 @@
         }
 
         .container {
-            max-width: 900px;
+            max-width: 1100px;
             margin: 0 auto;
             padding: 40px 20px;
             min-height: 100vh;
@@ -395,8 +395,7 @@
 
         .tree-content {
             padding: 16px 16px 8px 16px;
-            overflow-y: auto;
-            overflow-x: hidden;
+            overflow: auto;
             flex: 1;
             min-height: 0;
         }
@@ -745,7 +744,7 @@
             background: var(--bg-secondary);
             border: 1px solid var(--bg-elevated);
             border-radius: 12px;
-            max-width: 800px;
+            max-width: 1000px;
             width: 100%;
             max-height: 80vh;
             display: flex;
@@ -913,6 +912,11 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">test.md</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="validate-cca-install" data-parent="commands">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">validate-cca-install.md</span>
+                            </div>
                             <div class="tree-item indent-2 folder-row hidden collapsed" data-info="agents" data-folder="agents" data-parent="claude-dir">
                                 <span class="tree-chevron">›</span>
                                 <span class="tree-folder-icon">📁</span>
@@ -1196,7 +1200,7 @@
                 item.style.position = '';
             });
             
-            treeSide.style.width = (maxWidth + 32) + 'px';
+            treeSide.style.width = Math.round((maxWidth + 32) * 1.25) + 'px';
             treeSide.style.paddingLeft = '8px';
             treeSide.style.paddingRight = '8px';
         }
@@ -1263,7 +1267,7 @@
                 title: '.claude/ Directory',
                 desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
             },
-                                                                                                            'rules': {
+                                                                                                                                                'rules': {
                 title: 'rules/',
                 desc: 'Path-scoped context that loads when Claude works on matching files.'
             },
@@ -1285,54 +1289,59 @@
             },
             'autoconfig-update': {
                 title: 'autoconfig-update.md',
-                desc: 'Manages and installs updates to Claude Code configuration.',
+                desc: 'Manages and installs updates to Claude Code configuration.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>updates-available</code></td><td style="padding: 4px 8px;">Displays list of pending updates with install/review options.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>up-to-date</code></td><td style="padding: 4px 8px;">All updates are already installed.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Pulls latest update files from npm, executes update instructions, tracks applied updates</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig-update</code> <span style="opacity: 0.6;">— Check for and install configuration updates</span></div></div></div>',
                 trigger: '/autoconfig-update'
             },
             'autoconfig': {
                 title: 'autoconfig.md',
-                desc: 'The command you just ran. Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes.',
+                desc: 'Analyzes your project and populates CLAUDE.md with real context. Re-run anytime your stack changes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">CLAUDE.md populated, settings configured, docs opened in browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-project</code></td><td style="padding: 4px 8px;">No project detected — asks user to confirm directory.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Generates CLAUDE.md, settings.json, hooks, and MEMORY.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig</code> <span style="opacity: 0.6;">— Analyze project and configure Claude</span></div></div></div>',
                 trigger: '/autoconfig'
             },
             'commit-and-push': {
                 title: 'commit-and-push.md',
-                desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.',
+                desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
                 trigger: '/commit-and-push'
             },
             'enable-retro': {
                 title: 'enable-retro.md',
-                desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.',
+                desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Retro enabled — Claude will log tech debt to .claude/retro/ when encountered.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/retro/README.md, adds agent, updates CLAUDE.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/enable-retro</code> <span style="opacity: 0.6;">— Activate tech debt tracking</span></div></div></div>',
                 trigger: '/enable-retro'
             },
             'gls': {
                 title: 'gls.md',
-                desc: 'gls.md in commands/<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;"><li><code>/gls</code> - Get and display the most recent screenshot</li><li><code>/gls-2</code> - Get and display the 2 most recent screenshots</li><li><code>/gls-3</code> - Get and display the 3 most recent screenshots</li><li><code>/gls-N</code> - Get and display the N most recent screenshots</li><li><code>/gls /path/to/dir</code> - Use a specific directory and save it</li></ul></div>',
+                desc: 'Get the latest screenshot(s) and display them.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>count</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>path</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Screenshot directory path. Saved for future use. Auto-detected if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Displays requested screenshot(s) from newest to oldest.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-screenshots</code></td><td style="padding: 4px 8px;">Directory exists but contains no image files.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-directory</code></td><td style="padding: 4px 8px;">Unable to detect screenshot directory — prompts for path.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Saves detected screenshot path to command file on first run</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/gls</code> <span style="opacity: 0.6;">— Display the most recent screenshot</span></div><div><code>/gls-3</code> <span style="opacity: 0.6;">— Display the 3 most recent screenshots</span></div><div><code>/gls /path/to/dir</code> <span style="opacity: 0.6;">— Use a specific screenshot directory</span></div></div></div>',
                 trigger: '/gls'
             },
             'publish': {
                 title: 'publish.md',
-                desc: 'Runs tests, bumps version, commits, and publishes to npm.',
+                desc: 'Runs tests, bumps version, commits, and publishes to npm.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
                 trigger: '/publish'
             },
             'recover-context': {
                 title: 'recover-context.md',
-                desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;"><li><code>/recover-context -60</code> — last 60 minutes of conversation</li><li><code>/recover-context -60 --show</code> — same, but also opens the transcript in your editor</li></ul></div>',
+                desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>minutes</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">required</td><td style="padding: 4px 8px;">How far back to recover, in minutes. Leading dash optional. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>--show</code></td><td style="padding: 4px 8px;"><code>flag</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Opens the extracted transcript in your default editor.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min).</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-transcript</code></td><td style="padding: 4px 8px;">No transcript files found.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-messages</code></td><td style="padding: 4px 8px;">No messages found in the requested time range.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Reads .jsonl transcripts from ~/.claude/projects/, writes temp file</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/recover-context -60</code> <span style="opacity: 0.6;">— Last 60 minutes of conversation</span></div><div><code>/recover-context 120</code> <span style="opacity: 0.6;">— Last 2 hours (dash optional)</span></div><div><code>/recover-context -60 --show</code> <span style="opacity: 0.6;">— Last 60 min + open transcript file</span></div></div></div>',
                 trigger: '/recover-context'
             },
             'show-docs': {
                 title: 'show-docs.md',
-                desc: 'Opens the interactive docs in your browser.',
+                desc: 'Opens the interactive docs in your browser.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Docs synced and opened in default browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-docs</code></td><td style="padding: 4px 8px;">Docs file not found — run /autoconfig first.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs sync-docs.js to refresh content, opens browser</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/show-docs</code> <span style="opacity: 0.6;">— Open interactive documentation</span></div></div></div>',
                 trigger: '/show-docs'
             },
             'sync-claude-md': {
                 title: 'sync-claude-md.md',
-                desc: 'Re-analyzes your project and updates CLAUDE.md to reflect current state.',
+                desc: 'Re-analyzes your project and updates CLAUDE.md to reflect current state.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">CLAUDE.md updated with current project state.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Overwrites auto-generated sections of CLAUDE.md, preserves Discoveries section</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/sync-claude-md</code> <span style="opacity: 0.6;">— Re-scan project and update CLAUDE.md</span></div></div></div>',
                 trigger: '/sync-claude-md'
             },
             'test': {
                 title: 'test.md',
-                desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.',
+                desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>scope</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">File, directory, or pattern to limit test run. Runs full suite if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Test suite passes.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>failure</code></td><td style="padding: 4px 8px;">Test suite fails with non-zero exit code.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Executes detected test runner command</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/test</code> <span style="opacity: 0.6;">— Run full test suite</span></div><div><code>/test src/auth</code> <span style="opacity: 0.6;">— Run tests in src/auth directory</span></div><div><code>/test --coverage</code> <span style="opacity: 0.6;">— Run tests with coverage report</span></div></div></div>',
                 trigger: '/test'
             },
+            'validate-cca-install': {
+                title: 'validate-cca-install.md',
+                desc: 'Validates your claude-code-autoconfig installation against the latest published version.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>valid</code></td><td style="padding: 4px 8px;">Install validated — all checks passed.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>issues</code></td><td style="padding: 4px 8px;">Validation found {N} issue(s) with fix suggestions.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Read-only. Downloads latest package to temp dir for comparison, then cleans up.</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/validate-cca-install</code> <span style="opacity: 0.6;">— Run full installation validation</span></div></div></div>',
+                trigger: '/validate-cca-install'
+            },
             'create-retro-item-agent': {
                 title: 'create-retro-item.md',
                 desc: 'Creates a formatted retro item when tech debt or improvements are spotted.',
@@ -1569,7 +1578,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
 
 > Run \`/autoconfig\` to populate this based on your project.`
             },
-                                                                                                            'autoconfig-update': {
+                                                                                                                                                'autoconfig-update': {
                 filename: 'autoconfig-update.md',
                 content: `<!-- @applied
 -->
@@ -1772,19 +1781,19 @@ The arguments are: $ARGUMENTS
 - Strip the leading \`-\` from the number and treat it as the number of minutes to look back
 - Check if \`--show\` flag is present
 
-## Step 2: Find the transcript file
+## Step 2: List candidate transcript files
 
-Find the current session's transcript by looking for the most recently modified \`.jsonl\` file in the Claude projects directory:
+List all \`.jsonl\` transcript files sorted by most recently modified:
 
 \`\`\`bash
-ls -t ~/.claude/projects/*/*.jsonl 2>/dev/null | head -1
+ls -t ~/.claude/projects/*/*.jsonl 2>/dev/null | head -20
 \`\`\`
 
-If no transcript is found, tell the user and stop.
+If no transcripts are found, tell the user and stop. Store the list as \`$TRANSCRIPT_FILES\` (one path per line).
 
-## Step 3: Extract conversation context
+## Step 3: Identify which files to parse (lazy probing)
 
-Run this Python script to extract the stripped-down conversation. Substitute \`$MINUTES\` with the resolved minutes value and \`$TRANSCRIPT_PATH\` with the path from Step 2:`
+For each file in \`$TRANSCRIPT_FILES\` (starting from most recent), probe its time range by reading only the **first and last timestamp** — do NOT parse the full file yet. Run this script, substituting \`$MINUTES\` and \`$TRANSCRIPT_FILES\`:`
             },
             'show-docs': {
                 filename: 'show-docs.md',
@@ -1857,6 +1866,39 @@ Run tests for this project.
 If no scope provided, run the full test suite. Otherwise run tests matching the scope (file, directory, or pattern).
 
 Detect the test command from project config (package.json scripts, pytest, go test, etc.) and execute it.`
+            },
+            'validate-cca-install': {
+                filename: 'validate-cca-install.md',
+                content: `Validate the current claude-code-autoconfig installation. Reports what's correct, what's outdated, and what's missing. **Does not modify anything.**
+
+Usage:
+- \`/validate-cca-install\` — run a full validation check
+
+## Step 1: Fetch the latest package metadata
+
+Query the npm registry for the latest published version and its file manifest:
+
+\`\`\`bash
+python3 -c "
+import json, urllib.request
+url = 'https://registry.npmjs.org/claude-code-autoconfig/latest'
+data = json.loads(urllib.request.urlopen(url, timeout=10).read())
+print(json.dumps({'version': data.get('version', 'unknown')}))
+"
+\`\`\`
+
+Store the latest version as \`$LATEST_VERSION\`.
+
+## Step 2: Download and extract the latest package to a temp directory
+
+\`\`\`bash
+TMPDIR=$(mktemp -d)
+npm pack claude-code-autoconfig@latest --pack-destination "$TMPDIR" 2>/dev/null
+tar -xzf "$TMPDIR"/*.tgz -C "$TMPDIR"
+echo "$TMPDIR/package"
+\`\`\`
+
+Store the extracted path as \`$PKG_DIR\`. This gives us the ground truth for what files and versions should be installed.`
             },
             'create-retro-item-agent': {
                 filename: 'create-retro-item.md',

package/.claude/scripts/sync-docs.js

@@ -82,33 +82,103 @@ function extractDescription(content, ext) {
 }
 
 /**
- * Extract usage lines from a command file's content.
- * Looks for a "Usage:" section and returns HTML-formatted usage list.
+ * Extract structured Swagger-style metadata from command file content.
+ * Parses @param, @response, @sideeffect, and @example comments.
  */
-function extractUsage(content) {
+function extractSwaggerMeta(content) {
+  const params = [];
+  const responses = [];
+  const examples = [];
+  let sideeffect = null;
+
   const lines = content.split(/\r?\n/);
-  const usageIdx = lines.findIndex(l => /^Usage:$/i.test(l.trim()));
-  if (usageIdx === -1) return null;
-
-  const usageLines = [];
-  for (let i = usageIdx + 1; i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (line.startsWith('- ')) {
-      // Convert markdown backticks to <code> tags and strip leading "- "
-      const item = line.slice(2)
-        .replace(/`([^`]+)`/g, '<code>$1</code>');
-      usageLines.push(item);
-    } else if (line === '') {
-      continue; // skip blank lines within usage block
-    } else {
-      break; // end of usage block
+  for (const line of lines) {
+    const paramMatch = line.match(/<!--\s*@param\s+(.+?)\s*-->/);
+    if (paramMatch) {
+      const parts = paramMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 4) {
+        params.push({ name: parts[0], type: parts[1], required: parts[2], desc: parts[3] });
+      }
+    }
+    const respMatch = line.match(/<!--\s*@response\s+(.+?)\s*-->/);
+    if (respMatch) {
+      const parts = respMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 2) {
+        responses.push({ status: parts[0], desc: parts[1] });
+      }
+    }
+    const exMatch = line.match(/<!--\s*@example\s+(.+?)\s*-->/);
+    if (exMatch) {
+      const parts = exMatch[1].split('|').map(s => s.trim());
+      if (parts.length >= 2) {
+        examples.push({ usage: parts[0], desc: parts[1] });
+      }
+    }
+    const seMatch = line.match(/<!--\s*@sideeffect\s+(.+?)\s*-->/);
+    if (seMatch) {
+      sideeffect = seMatch[1].trim();
+    }
+  }
+
+  return { params, responses, examples, sideeffect };
+}
+
+/**
+ * Build Swagger-style HTML from extracted metadata.
+ */
+function buildSwaggerHtml(meta) {
+  const parts = [];
+
+  // Parameters table
+  if (meta.params.length > 0) {
+    let table = '<div style="margin-top: 12px;"><strong>Parameters</strong>';
+    table += '<table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;">';
+    table += '<tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr>';
+    for (const p of meta.params) {
+      table += `<tr style="border-bottom: 1px solid var(--border);">`;
+      table += `<td style="padding: 4px 8px; white-space: nowrap;"><code>${p.name}</code></td>`;
+      table += `<td style="padding: 4px 8px;"><code>${p.type}</code></td>`;
+      table += `<td style="padding: 4px 8px;">${p.required}</td>`;
+      table += `<td style="padding: 4px 8px;">${p.desc}</td>`;
+      table += `</tr>`;
+    }
+    table += '</table></div>';
+    parts.push(table);
+  } else {
+    parts.push('<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>');
+  }
+
+  // Responses table
+  if (meta.responses.length > 0) {
+    let table = '<div style="margin-top: 12px;"><strong>Responses</strong>';
+    table += '<table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em;">';
+    table += '<tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr>';
+    for (const r of meta.responses) {
+      table += `<tr style="border-bottom: 1px solid var(--border);">`;
+      table += `<td style="padding: 4px 8px; white-space: nowrap;"><code>${r.status}</code></td>`;
+      table += `<td style="padding: 4px 8px;">${r.desc}</td>`;
+      table += `</tr>`;
+    }
+    table += '</table></div>';
+    parts.push(table);
+  }
+
+  // Side effects
+  if (meta.sideeffect) {
+    parts.push(`<div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">${meta.sideeffect}</div></div>`);
+  }
+
+  // Examples
+  if (meta.examples.length > 0) {
+    let html = '<div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;">';
+    for (const ex of meta.examples) {
+      html += `<div><code>${ex.usage}</code> <span style="opacity: 0.6;">— ${ex.desc}</span></div>`;
     }
+    html += '</div></div>';
+    parts.push(html);
   }
-  if (usageLines.length === 0) return null;
 
-  // Build an HTML list
-  const listItems = usageLines.map(l => `<li>${l}</li>`).join('');
-  return `<div style="margin-top: 10px;"><strong>Usage:</strong><ul style="margin: 6px 0 0 0; padding-left: 20px; list-style: disc;">${listItems}</ul></div>`;
+  return parts.length > 0 ? parts.join('') : null;
 }
 
 /**
@@ -200,9 +270,10 @@ function scanFiles() {
       const desc = extractDescription(content, ext) || `${file} in ${folder}/`;
       const trigger = deriveTrigger(folder, file, content);
       const preview = generatePreview(content, ext);
-      const usage = (folder === 'commands') ? extractUsage(content) : null;
+      const swagger = (folder === 'commands') ? extractSwaggerMeta(content) : null;
+      const swaggerHtml = swagger ? buildSwaggerHtml(swagger) : null;
 
-      entries.push({ key, folder, file, desc, trigger, preview, usage });
+      entries.push({ key, folder, file, desc, trigger, preview, swaggerHtml });
     }
   }
 
@@ -349,8 +420,8 @@ function generateTreeInfo(entries) {
     if (entry.isEmptyFolder) continue;
 
     let fullDesc = entry.desc;
-    if (entry.usage) {
-      fullDesc += entry.usage;
+    if (entry.swaggerHtml) {
+      fullDesc += entry.swaggerHtml;
     }
     const escapedDesc = fullDesc.replace(/'/g, "\\'");
     lines.push(`            '${entry.key}': {`);

package/README.md

@@ -53,7 +53,8 @@ your-project/
     │   ├── recover-context.md         #   /recover-context - restore context after compaction
     │   ├── show-docs.md               #   /show-docs - interactive walkthrough
     │   ├── sync-claude-md.md          #   /sync-claude-md - update CLAUDE.md
-    │   └── test.md                    #   /test - run tests
+    │   ├── test.md                    #   /test - run tests
+    │   └── validate-cca-install.md   #   /validate-cca-install - verify installation
     ├── agents/                        # Agent definitions
     │   ├── create-retro-item.md       #   Retro item creation agent
     │   └── docs-refresh.md            #   Docs sync agent
@@ -106,6 +107,7 @@ Run `/sync-claude-md` anytime your project evolves to keep the configuration cur
 | `/commit-and-push` | Stages, commits with good message, and pushes |
 | `/recover-context` | Recovers conversation context after compaction |
 | `/gls` | Views latest screenshot for visual context |
+| `/validate-cca-install` | Validates installation against latest published version |
 | `/enable-retro` | (Experimental) Enable tech debt tracking |
 
 ### Updates

package/bin/cli.js

@@ -617,7 +617,13 @@ const bootstrapMode = process.argv.includes('--bootstrap');
 if (bootstrapMode || insideClaude) {
   if (!bootstrapMode) {
     // insideClaude without --bootstrap: show guidance
-    console.log('\x1b[32m%s\x1b[0m', `✅ Files installed. Run ${launchCommand} to continue.`);
+    console.log();
+    console.log('\x1b[32m%s\x1b[0m', `✅ Autoconfig installed successfully.`);
+    console.log();
+    console.log('\x1b[33m%s\x1b[0m', `⚡ NEXT STEP: Type ${launchCommand} below and press Enter to complete setup.`);
+    console.log();
+    console.log('\x1b[90m%s\x1b[0m', `   (This CLI can't auto-trigger slash commands inside an active Claude session.`);
+    console.log('\x1b[90m%s\x1b[0m', `   Just type "${launchCommand}" at the prompt and Claude will handle the rest.)`);
     console.log();
   }
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.142",
+  "version": "1.0.144",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",