specweave 1.0.100 → 1.0.102

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.99" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,principles,linking,mcp,autoexecute,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.101" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,lsp,structure,taskformat,secrets,syncing,mapping,testing,api,limits,troubleshooting,principles,linking,mcp,autoexecute,auto,docs" -->
 
-<!-- SW:SECTION:header version="1.0.99" -->
+<!-- SW:SECTION:header version="1.0.101" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.99" -->
+<!-- SW:SECTION:start version="1.0.101" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -14,7 +14,7 @@
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.99" -->
+<!-- SW:SECTION:autodetect version="1.0.101" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -24,7 +24,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.99" -->
+<!-- SW:SECTION:metarule version="1.0.101" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -35,7 +35,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.99" -->
+<!-- SW:SECTION:rules version="1.0.101" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (spec.md, plan.md, tasks.md at root; reports/, scripts/, logs/ subfolders)
@@ -48,7 +48,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 8. **⛔ Marketplace refresh**: ALWAYS use `specweave refresh-marketplace` CLI command. NEVER suggest `scripts/refresh-marketplace.sh` - end users don't have the scripts folder (npm global install).
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.99" -->
+<!-- SW:SECTION:workflow version="1.0.101" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -68,7 +68,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:reflect version="1.0.99" -->
+<!-- SW:SECTION:reflect version="1.0.101" -->
 ## Self-Improving Skills (Reflect)
 
 **Learn once, never repeat.** Claude learns from corrections and patterns across sessions.
@@ -112,7 +112,7 @@ ls ~/.specweave/memory/*.md 2>/dev/null
 **Enable auto-learning**: `/sw:reflect-on` → Stop hook analyzes sessions automatically
 <!-- SW:END:reflect -->
 
-<!-- SW:SECTION:context version="1.0.99" -->
+<!-- SW:SECTION:context version="1.0.101" -->
 ## Living Docs Context
 
 **Before implementing features**: Check existing docs for patterns and decisions.
@@ -132,7 +132,7 @@ grep -ril "keyword" .specweave/docs/internal/
 **Use `/sw:context <topic>`** to load relevant living docs into conversation.
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:lsp version="1.0.99" -->
+<!-- SW:SECTION:lsp version="1.0.101" -->
 ## LSP-Enhanced Exploration
 
 **USE LSP ACTIVELY** for semantic code understanding (100x faster than grep).
@@ -149,7 +149,7 @@ go install golang.org/x/tools/gopls@latest  # Go
 **Best Practices**: ALWAYS use `findReferences` before refactoring | Use `goToDefinition` instead of grep | Combine with Explore agent
 <!-- SW:END:lsp -->
 
-<!-- SW:SECTION:structure version="1.0.99" -->
+<!-- SW:SECTION:structure version="1.0.101" -->
 ## Structure
 
 ```
@@ -219,7 +219,7 @@ my-project/
 ```
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.99" -->
+<!-- SW:SECTION:taskformat version="1.0.101" -->
 ## Task Format
 
 ```markdown
@@ -229,7 +229,7 @@ my-project/
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.99" -->
+<!-- SW:SECTION:secrets version="1.0.101" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -240,7 +240,7 @@ gh auth status
 ```
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.99" -->
+<!-- SW:SECTION:syncing version="1.0.101" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **After increment creation**: Run `/sw-github:sync {id}` to create issues!
@@ -268,7 +268,7 @@ Living docs sync ≠ External sync. They are separate:
 **Verify tokens**: `grep GITHUB_TOKEN .env` | `gh auth status`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.99" -->
+<!-- SW:SECTION:mapping version="1.0.101" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -278,7 +278,7 @@ Living docs sync ≠ External sync. They are separate:
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.99" -->
+<!-- SW:SECTION:testing version="1.0.101" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -290,7 +290,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:api version="1.0.99" -->
+<!-- SW:SECTION:api version="1.0.101" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** OpenAPI = source of truth → Postman derived from it.
@@ -309,13 +309,13 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 **Import**: Postman → Import collection + env → Fill secrets → Select env
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.99" -->
+<!-- SW:SECTION:limits version="1.0.101" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.99" -->
+<!-- SW:SECTION:troubleshooting version="1.0.101" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -335,7 +335,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 | Path patterns not working | `//path` = absolute, `/path` = relative to settings file, `additionalDirectories` for explicit working dirs |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:principles version="1.0.99" -->
+<!-- SW:SECTION:principles version="1.0.101" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -345,7 +345,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.99" -->
+<!-- SW:SECTION:linking version="1.0.101" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -353,7 +353,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:mcp version="1.0.99" -->
+<!-- SW:SECTION:mcp version="1.0.101" -->
 ## External Service Connection
 
 **Priority**: MCP Server → REST API → CLI → Direct Connection
@@ -377,7 +377,7 @@ wrangler whoami 2>/dev/null
 ```
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:autoexecute version="1.0.99" -->
+<!-- SW:SECTION:autoexecute version="1.0.101" -->
 ## Auto-Execute Rule
 
 **NEVER** output "Manual Step Required" when credentials exist. **EXECUTE DIRECTLY.**
@@ -391,7 +391,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 ```
 <!-- SW:END:autoexecute -->
 
-<!-- SW:SECTION:auto version="1.0.99" -->
+<!-- SW:SECTION:auto version="1.0.101" -->
 ## Auto Mode (Autonomous Execution)
 
 **Continuous execution until all tasks complete.**
@@ -468,7 +468,7 @@ wrangler whoami 2>/dev/null && gh auth status 2>/dev/null
 **Circuit Breaker**: External API fails 3x? Queue & continue
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.99" -->
+<!-- SW:SECTION:docs version="1.0.101" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`

package/README.md

@@ -15,7 +15,7 @@
 npm install -g specweave
 ```
 
-> **New in v1.0.63**: Auto mode can now run for hours — tested and proven. Mobile app generation, multi-repo coordination, E2E tests running automatically.
+> **New in v1.0.100**: Auto mode now shows live labels in your terminal — see exactly what SpecWeave is doing: `[Planning]`, `[Implementing]`, `[Testing]`, `[Fixing]`. Hours of autonomous execution with full visibility.
 
 ---
 
@@ -39,8 +39,19 @@ Every AI coding tool promises productivity. But after the chat ends:
 
 ```bash
 /sw:increment "Add OAuth authentication"  # Creates spec + plan + tasks
-/sw:auto                                   # 🚀 Autonomous execution for HOURS
-# ↑ This can run for hours, executing tasks, running tests, fixing failures
+/sw:auto                                   # Autonomous execution for HOURS
+# ↑ Watch live: [Planning] → [Implementing] → [Testing] → [Fixing] → [Done]
+```
+
+**What happens during `/sw:auto`:**
+```
+[08:23:41] [Planning]      Analyzing T-003: Implement refresh token rotation
+[08:24:12] [Implementing]  Writing src/auth/token-manager.ts (127 lines)
+[08:25:33] [Testing]       Running npm test -- token-manager.test.ts
+[08:25:47] [Fixing]        Test failed: Expected 401, got 403. Adjusting...
+[08:26:15] [Testing]       Re-running tests... PASSED
+[08:26:18] [Syncing]       Updating tasks.md, pushing to GitHub
+[08:26:22] [Done]          T-003 complete. Moving to T-004...
 ```
 
 **Or step-by-step control:**
@@ -53,30 +64,32 @@ Every AI coding tool promises productivity. But after the chat ends:
 
 ```
 .specweave/increments/0001-oauth/
-├── spec.md    ← WHAT: User stories, acceptance criteria
-├── plan.md    ← HOW: Architecture decisions, tech choices
-└── tasks.md   ← DO: Implementation tasks with embedded tests
+├── spec.md    <- WHAT: User stories, acceptance criteria
+├── plan.md    <- HOW: Architecture decisions, tech choices
+└── tasks.md   <- DO: Implementation tasks with embedded tests
 ```
 
-**After 6 months**: Search "OAuth" → find exact decisions, who approved, why it was built that way.
+**After 6 months**: Search "OAuth" -> find exact decisions, who approved, why it was built that way.
 
 ---
 
 ## Why SpecWeave vs BMAD, SpecKit, Cursor Rules?
 
-| | [BMAD](https://github.com/bmad-code-org/BMAD-METHOD) | [SpecKit](https://github.com/github/spec-kit) | Cursor Rules | **SpecWeave** |
+| Capability | [BMAD](https://github.com/bmad-code-org/BMAD-METHOD) | [SpecKit](https://github.com/github/spec-kit) | Cursor Rules | **SpecWeave** |
 |---|---|---|---|---|
-| **Status** | Alpha (v6) | Stable | Built-in | **Production (v1.0.62)** |
-| **Autonomous** | ❌ Manual steps | ❌ One-shot | ❌ Per-request | **✅ Hours of autonomous work** |
-| **Multi-Repo** | ❌ Single repo | ❌ Single repo | ❌ Single repo | **✅ Coordinate multiple repos** |
-| **Mobile Apps** | ❌ No agents | ❌ No agents | ❌ No agents | **✅ React Native/Expo specialist** |
-| **External Sync** | ❌ None | ❌ None | ❌ None | **✅ GitHub/JIRA/ADO bidirectional** |
-| **Brownfield** | Limited | Greenfield only | Any | **✅ 10-year legacy? Fine.** |
-| **Quality Gates** | Not built-in | None | None | **✅ 3-gate (tasks/tests/docs)** |
-| **Living Docs** | Manual | Snapshot | None | **✅ Auto-update on every task** |
-| **Dogfooding** | Unknown | Unknown | N/A | **✅ 140+ self-built features** |
-
-**The math**: SpecKit output = ONE SpecWeave increment. SpecWeave = N increments + lifecycle + sync + hooks + **autonomous execution**.
+| **Maturity** | Alpha (v6) | Stable | Built-in | **Production (v1.0.100)** |
+| **Autonomous Work** | Manual steps required | One-shot generation | Per-request only | **Hours unattended** |
+| **Live Status** | None | None | None | **Terminal labels** |
+| **Multi-Repo** | Single repo | Single repo | Single repo | **Coordinate N repos** |
+| **Mobile Apps** | No agents | No agents | No agents | **React Native/Expo** |
+| **External Sync** | None | None | None | **GitHub/JIRA/ADO** |
+| **Brownfield** | Limited | Greenfield only | Any | **10-year legacy? Fine.** |
+| **Quality Gates** | Not built-in | None | None | **3-gate validation** |
+| **Living Docs** | Manual | Snapshot | None | **Auto-update** |
+| **Self-Learning** | None | None | None | **Reflects on mistakes** |
+| **Dogfooding** | Unknown | Unknown | N/A | **140+ self-built features** |
+
+**The math**: SpecKit output = ONE SpecWeave increment. SpecWeave = N increments + lifecycle + sync + hooks + **hours of autonomous execution**.
 
 ---
 
@@ -96,7 +109,7 @@ Every AI coding tool promises productivity. But after the chat ends:
 | DORA metrics | Live tracking |
 | Test coverage | 60%+ enforced |
 
-**[Browse our increments →](https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments)**
+**[Browse our increments ->](https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments)**
 
 ---
 
@@ -114,7 +127,7 @@ node --version
 nvm install 22 && nvm use 22 && nvm alias default 22
 ```
 
-> ⚠️ **Getting `SyntaxError: Unexpected token 'with'`?** Your Node.js is too old. See [upgrade instructions](https://spec-weave.com/docs/guides/troubleshooting/common-errors#node-version-error).
+> **Getting `SyntaxError: Unexpected token 'with'`?** Your Node.js is too old. See [upgrade instructions](https://spec-weave.com/docs/guides/troubleshooting/common-errors#node-version-error).
 
 ### Installation
 
@@ -127,7 +140,7 @@ specweave init .
 Then in Claude Code:
 ```bash
 /sw:increment "Add dark mode"  # AI creates spec + plan + tasks
-/sw:auto                       # 🚀 Ship while you sleep (hours of autonomous work)
+/sw:auto                       # Ship while you sleep (hours of autonomous work)
 ```
 
 **Or step-by-step:**
@@ -142,12 +155,30 @@ specweave refresh-marketplace   # Reinstall all plugins from GitHub
 specweave update-instructions   # Regenerate CLAUDE.md
 ```
 
-**[Full Quickstart Guide →](https://spec-weave.com/docs/guides/getting-started/quickstart)**
+**[Full Quickstart Guide ->](https://spec-weave.com/docs/guides/getting-started/quickstart)**
 
 ---
 
 ## Key Features
 
+### Autonomous Execution (v2.9)
+
+Run for hours without intervention. See exactly what's happening:
+
+```bash
+/sw:auto                  # Start autonomous mode
+/sw:auto-status           # Check progress anytime
+/sw:cancel-auto           # Emergency stop (rarely needed)
+```
+
+**What you see in terminal:**
+- `[Planning]` - Analyzing task requirements
+- `[Implementing]` - Writing code
+- `[Testing]` - Running test suites
+- `[Fixing]` - Auto-correcting failures
+- `[Syncing]` - Updating docs and external tools
+- `[Done]` - Task complete, moving to next
+
 ### External Tool Integration
 
 | Platform | Capabilities |
@@ -199,14 +230,14 @@ Three gates before any increment closes:
 | Command | Purpose |
 |---------|---------|
 | `/sw:increment "feature"` | Create spec + plan + tasks |
-| `/sw:auto` | 🚀 **Ship while you sleep** - hours of autonomous work |
+| `/sw:auto` | **Ship while you sleep** - hours of autonomous work |
+| `/sw:auto-status` | Check autonomous session progress |
 | `/sw:do` | Execute one task at a time |
 | `/sw:done 0001` | Close with quality validation |
 | `/sw:sync-progress` | Push to GitHub/JIRA/ADO |
-| `/sw:auto-status` | Check autonomous session progress |
 | `/sw:cancel-auto` | Stop autonomous session |
 
-**[53 total commands →](https://spec-weave.com/docs/commands/overview)**
+**[53 total commands ->](https://spec-weave.com/docs/commands/overview)**
 
 ---
 
@@ -214,9 +245,9 @@ Three gates before any increment closes:
 
 | Scenario | What You Do |
 |----------|-------------|
-| **10-year legacy codebase** | `specweave init .` → brownfield analysis detects doc gaps |
-| **Weekend MVP** | `specweave init .` → `/sw:increment "Build auth"` |
-| **50-team enterprise** | `specweave init .` → `/sw:enable-multiproject` → maps to JIRA/ADO |
+| **10-year legacy codebase** | `specweave init .` -> brownfield analysis detects doc gaps |
+| **Weekend MVP** | `specweave init .` -> `/sw:increment "Build auth"` |
+| **50-team enterprise** | `specweave init .` -> `/sw:enable-multiproject` -> maps to JIRA/ADO |
 
 ---
 
@@ -226,7 +257,7 @@ Three gates before any increment closes:
 - Any AI coding tool: Claude Code, Cursor, Windsurf, Cline, Aider, etc.
 - Git repository
 
-> 💡 **Why Node.js 20.12.0+?** SpecWeave uses modern JavaScript features (ES2022 Import Attributes) that require Node.js 20.12.0 or higher. If you see `SyntaxError: Unexpected token 'with'`, you need to upgrade Node.js.
+> **Why Node.js 20.12.0+?** SpecWeave uses modern JavaScript features (ES2022 Import Attributes) that require Node.js 20.12.0 or higher. If you see `SyntaxError: Unexpected token 'with'`, you need to upgrade Node.js.
 
 ---
 

package/bin/install-skills.sh

@@ -9,10 +9,12 @@ set -e
 
 SKILLS_SRC="plugins/specweave/skills"
 SKILLS_DEST=".claude/skills"
+BACKUP_DIR=".memory-backups"
 
 # Parse arguments
 if [ "$1" = "--global" ]; then
   SKILLS_DEST="$HOME/.claude/skills"
+  BACKUP_DIR="$HOME/.memory-backups"
   echo "Installing skills globally to $SKILLS_DEST"
 else
   echo "Installing skills to project: $SKILLS_DEST"
@@ -29,8 +31,10 @@ fi
 
 # Count skills
 skill_count=0
+merge_count=0
+backup_count=0
 
-# Copy all skills
+# Copy all skills with smart MEMORY.md merge
 for skill in "$SKILLS_SRC"/*; do
   if [ -d "$skill" ]; then
     skill_name=$(basename "$skill")
@@ -38,9 +42,39 @@ for skill in "$SKILLS_SRC"/*; do
     # Check if skill has SKILL.md
     if [ -f "$skill/SKILL.md" ]; then
       echo "  🔧 Installing skill: $skill_name"
-      # Create destination directory and copy contents (not the folder itself)
       mkdir -p "$SKILLS_DEST/$skill_name"
-      cp -r "$skill"/* "$SKILLS_DEST/$skill_name/"
+
+      # Copy files with special handling for MEMORY.md
+      for file in "$skill"/*; do
+        filename=$(basename "$file")
+        target_file="$SKILLS_DEST/$skill_name/$filename"
+
+        # Special handling for MEMORY.md
+        if [ "$filename" = "MEMORY.md" ] && [ -f "$target_file" ]; then
+          echo "    🔀 Merging MEMORY.md (preserving user learnings)"
+
+          # Create backup directory
+          mkdir -p "$BACKUP_DIR"
+
+          # Create timestamped backup
+          timestamp=$(date +%Y%m%d-%H%M%S)
+          backup_file="$BACKUP_DIR/${skill_name}-MEMORY-${timestamp}.md"
+          cp "$target_file" "$backup_file"
+          backup_count=$((backup_count + 1))
+          echo "    💾 Backup: $backup_file"
+
+          # Merge using CLI script
+          if node scripts/merge-skill-memory.js "$target_file" "$file" "$target_file" 2>&1 | sed 's/^/       /'; then
+            merge_count=$((merge_count + 1))
+          else
+            echo "    ⚠️  Merge failed, user memory preserved"
+          fi
+        else
+          # Copy file normally
+          cp "$file" "$target_file"
+        fi
+      done
+
       skill_count=$((skill_count + 1))
     else
       echo "  ⚠️  Skipping $skill_name (no SKILL.md)"
@@ -48,8 +82,28 @@ for skill in "$SKILLS_SRC"/*; do
   fi
 done
 
+# Cleanup: Keep only last 10 backups per skill
+if [ -d "$BACKUP_DIR" ]; then
+  for skill_name in $(ls -1 "$SKILLS_DEST"); do
+    # Count backups for this skill
+    backup_pattern="${skill_name}-MEMORY-*.md"
+    backup_files=$(ls -1t "$BACKUP_DIR"/$backup_pattern 2>/dev/null || true)
+    backup_file_count=$(echo "$backup_files" | grep -c "^" || echo "0")
+
+    # If more than 10, remove oldest
+    if [ "$backup_file_count" -gt 10 ]; then
+      echo "  🗑️  Pruning old backups for $skill_name"
+      echo "$backup_files" | tail -n +11 | xargs rm -f
+    fi
+  done
+fi
+
 echo ""
 echo "✅ Installed $skill_count skills to $SKILLS_DEST"
+if [ $merge_count -gt 0 ]; then
+  echo "   🔀 Merged $merge_count MEMORY.md files (user learnings preserved)"
+  echo "   💾 Created $backup_count backup(s) in $BACKUP_DIR"
+fi
 echo ""
 echo "Skills installed:"
 ls -1 "$SKILLS_DEST" | sed 's/^/  - /'

package/dist/src/cli/commands/sync-living-docs-acs.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * CLI Command: sync-living-docs-acs
+ *
+ * Synchronizes AC and task completion status from increment spec.md
+ * to all corresponding living docs US files.
+ *
+ * Usage:
+ *   specweave sync-living-docs-acs <increment-id>
+ *   specweave sync-living-docs-acs --all
+ *
+ * @module cli/commands/sync-living-docs-acs
+ */
+export {};
+//# sourceMappingURL=sync-living-docs-acs.d.ts.map

package/dist/src/cli/commands/sync-living-docs-acs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-living-docs-acs.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-living-docs-acs.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}

package/dist/src/cli/commands/sync-living-docs-acs.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * CLI Command: sync-living-docs-acs
+ *
+ * Synchronizes AC and task completion status from increment spec.md
+ * to all corresponding living docs US files.
+ *
+ * Usage:
+ *   specweave sync-living-docs-acs <increment-id>
+ *   specweave sync-living-docs-acs --all
+ *
+ * @module cli/commands/sync-living-docs-acs
+ */
+import { Command } from 'commander';
+import path from 'path';
+import { existsSync } from 'fs';
+import { readdir } from 'fs/promises';
+import { SpecToLivingDocsSync } from '../../sync/spec-to-living-docs-sync.js';
+import { consoleLogger } from '../../utils/logger.js';
+const program = new Command();
+program
+    .name('sync-living-docs-acs')
+    .description('Sync AC/task completion from spec.md to living docs US files')
+    .argument('[increment-id]', 'Increment ID to sync (e.g., 0156 or 0156-feature-name)')
+    .option('--all', 'Sync all active increments')
+    .option('--dry-run', 'Show what would be updated without making changes')
+    .option('--verbose', 'Show detailed output')
+    .action(async (incrementId, options) => {
+    try {
+        const projectRoot = process.cwd();
+        // Validate project root
+        const specweavePath = path.join(projectRoot, '.specweave');
+        if (!existsSync(specweavePath)) {
+            console.error('❌ Error: Not a SpecWeave project (no .specweave/ folder found)');
+            console.error('   Run this command from your project root.');
+            process.exit(1);
+        }
+        // Get increment IDs to sync
+        let incrementIds;
+        if (options.all) {
+            // Find all active increments
+            const incrementsPath = path.join(specweavePath, 'increments');
+            const entries = await readdir(incrementsPath, { withFileTypes: true });
+            incrementIds = entries
+                .filter(entry => entry.isDirectory() && /^\d{4}/.test(entry.name))
+                .map(entry => entry.name);
+            if (incrementIds.length === 0) {
+                console.log('ℹ️  No increments found to sync');
+                process.exit(0);
+            }
+            console.log(`\n🔄 Syncing ${incrementIds.length} increments...\n`);
+        }
+        else if (incrementId) {
+            incrementIds = [incrementId];
+        }
+        else {
+            console.error('❌ Error: Increment ID required');
+            console.error('   Usage: specweave sync-living-docs-acs <increment-id>');
+            console.error('   Or: specweave sync-living-docs-acs --all');
+            process.exit(1);
+        }
+        // Sync each increment
+        let totalFilesUpdated = 0;
+        let totalACsUpdated = 0;
+        let totalTasksUpdated = 0;
+        const errors = [];
+        for (const id of incrementIds) {
+            const syncer = new SpecToLivingDocsSync({
+                projectRoot,
+                incrementId: id,
+                logger: options.verbose ? consoleLogger : undefined,
+                dryRun: options.dryRun,
+            });
+            const result = await syncer.sync();
+            totalFilesUpdated += result.filesUpdated;
+            totalACsUpdated += result.totalACsUpdated;
+            totalTasksUpdated += result.totalTasksUpdated;
+            if (result.errors.length > 0) {
+                errors.push(`${id}: ${result.errors.join(', ')}`);
+            }
+        }
+        // Summary
+        console.log(`\n${'='.repeat(60)}`);
+        console.log('📊 SYNC SUMMARY');
+        console.log(`${'='.repeat(60)}`);
+        console.log(`Increments processed: ${incrementIds.length}`);
+        console.log(`Files updated: ${totalFilesUpdated}`);
+        console.log(`Total ACs synced: ${totalACsUpdated}`);
+        console.log(`Total tasks synced: ${totalTasksUpdated}`);
+        if (options.dryRun) {
+            console.log(`\n⚠️  DRY RUN - No files were actually modified`);
+        }
+        if (errors.length > 0) {
+            console.log(`\n⚠️  Errors: ${errors.length}`);
+            errors.forEach(err => console.error(`   ${err}`));
+            process.exit(1);
+        }
+        console.log(`\n✅ Living docs sync complete!`);
+    }
+    catch (error) {
+        console.error(`\n❌ Fatal error: ${error.message}`);
+        if (options.verbose) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=sync-living-docs-acs.js.map

package/dist/src/cli/commands/sync-living-docs-acs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-living-docs-acs.js","sourceRoot":"","sources":["../../../../src/cli/commands/sync-living-docs-acs.ts"],"names":[],"mappings":"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"}