specweave 1.0.334 → 1.0.336

package/bin/specweave.js

@@ -909,6 +909,21 @@ program
     await syncProgress(args);
   });
 
+// Sync-living-docs command - Sync living docs for a specific increment
+program
+  .command('sync-living-docs [increment-id]')
+  .description('Sync living documentation for an increment (feature spec + user story files)')
+  .option('--dry-run', 'Preview without making changes')
+  .option('--force', 'Force sync even if no changes detected')
+  .action(async (incrementId, options) => {
+    const { syncLivingDocs } = await import('../dist/src/cli/commands/sync-living-docs.js');
+    const args = [];
+    if (incrementId) args.push(incrementId);
+    if (options.dryRun) args.push('--dry-run');
+    if (options.force) args.push('--force');
+    await syncLivingDocs(args);
+  });
+
 // Docs command - Documentation preview, build, validation
 const docsCmd = program
   .command('docs')

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

@@ -0,0 +1,20 @@
+/**
+ * CLI Command: sync-living-docs
+ *
+ * Sync living documentation for a specific increment.
+ * Generates or updates feature specs and user story files
+ * under .specweave/docs/internal/specs/.
+ *
+ * This is a focused command that ONLY syncs living docs.
+ * For full progress sync (including external tools), use sync-progress.
+ */
+import { Logger } from '../../utils/logger.js';
+export interface SyncLivingDocsArgs {
+    incrementId?: string;
+    dryRun?: boolean;
+    force?: boolean;
+}
+export declare function syncLivingDocs(args: string[], options?: {
+    logger?: Logger;
+}): Promise<void>;
+//# sourceMappingURL=sync-living-docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-living-docs.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-living-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAG9D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,IAAI,CAAC,CAgEf"}

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

@@ -0,0 +1,129 @@
+/**
+ * CLI Command: sync-living-docs
+ *
+ * Sync living documentation for a specific increment.
+ * Generates or updates feature specs and user story files
+ * under .specweave/docs/internal/specs/.
+ *
+ * This is a focused command that ONLY syncs living docs.
+ * For full progress sync (including external tools), use sync-progress.
+ */
+import path from 'path';
+import { existsSync, readdirSync } from 'fs';
+import { LivingDocsSync } from '../../core/living-docs/living-docs-sync.js';
+import { consoleLogger } from '../../utils/logger.js';
+import { ActiveIncrementManager } from '../../core/increment/active-increment-manager.js';
+export async function syncLivingDocs(args, options = {}) {
+    const logger = options.logger ?? consoleLogger;
+    const parsedArgs = parseArgs(args);
+    const projectRoot = process.cwd();
+    // Resolve increment ID
+    let incrementId = parsedArgs.incrementId;
+    if (!incrementId) {
+        incrementId = detectActiveIncrement(projectRoot, logger) ?? undefined;
+    }
+    if (!incrementId) {
+        logger.error('No active increment found.');
+        logger.error('Usage: specweave sync-living-docs <increment-id>');
+        process.exit(1);
+        return;
+    }
+    // Verify increment exists
+    if (!incrementExists(projectRoot, incrementId)) {
+        logger.error(`Increment ${incrementId} not found.`);
+        process.exit(1);
+        return;
+    }
+    if (parsedArgs.dryRun) {
+        logger.log('[DRY RUN] No files will be modified.');
+    }
+    logger.log(`Syncing living docs for increment: ${incrementId}`);
+    try {
+        const sync = new LivingDocsSync(projectRoot, { logger });
+        const result = await sync.syncIncrement(incrementId, {
+            dryRun: parsedArgs.dryRun,
+            force: parsedArgs.force,
+        });
+        // Report results
+        logger.log('');
+        if (result.success) {
+            logger.log('Living Docs Sync Results:');
+            logger.log(`  Feature ID: ${result.featureId}`);
+            logger.log(`  Files created: ${result.filesCreated.length}`);
+            logger.log(`  Files updated: ${result.filesUpdated.length}`);
+        }
+        else {
+            logger.error('Living docs sync failed.');
+        }
+        if (result.errors.length > 0) {
+            logger.log('  Warnings:');
+            for (const err of result.errors) {
+                logger.log(`    - ${err}`);
+            }
+        }
+        if (!result.success) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        logger.error(`Sync failed: ${msg}`);
+        process.exit(1);
+    }
+}
+function parseArgs(args) {
+    const result = {};
+    for (const arg of args) {
+        if (arg === '--dry-run') {
+            result.dryRun = true;
+        }
+        else if (arg === '--force') {
+            result.force = true;
+        }
+        else if (!arg.startsWith('-') && !result.incrementId) {
+            result.incrementId = arg;
+        }
+    }
+    return result;
+}
+function detectActiveIncrement(projectRoot, logger) {
+    try {
+        const manager = new ActiveIncrementManager(projectRoot);
+        const active = manager.getActive();
+        if (active.length > 0) {
+            logger.log(`Auto-detected active increment: ${active[0]}`);
+            return active[0];
+        }
+    }
+    catch {
+        // Silent fallback
+    }
+    return null;
+}
+function incrementExists(projectRoot, id) {
+    const incrementsDir = path.join(projectRoot, '.specweave/increments');
+    // Direct match
+    if (existsSync(path.join(incrementsDir, id)))
+        return true;
+    // Archive match
+    if (existsSync(path.join(incrementsDir, '_archive', id)))
+        return true;
+    // Prefix match (e.g., "0001" matching "0001-feature-name")
+    try {
+        const entries = readdirSync(incrementsDir);
+        for (const entry of entries) {
+            if (entry.startsWith(id + '-') || entry === id)
+                return true;
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    return false;
+}
+// Main entry point when run directly
+if (process.argv[1]?.endsWith('sync-living-docs.js') || process.argv[1]?.endsWith('sync-living-docs.ts')) {
+    const args = process.argv.slice(2);
+    syncLivingDocs(args).catch(console.error);
+}
+//# sourceMappingURL=sync-living-docs.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.334",
+  "version": "1.0.336",
   "description": "Spec-driven development framework for AI coding agents. Works with Claude Code, Codex, Antigravity, Cursor, Copilot & more. 100+ skills, 49 CLI commands, verified skill certification, autonomous execution, and living documentation.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/sync-setup.md

@@ -99,12 +99,8 @@ Write the following:
 Run a test sync (read-only) to verify configuration:
 
 ```bash
-# Test each enabled provider
-node -e "
-  import { SyncEngine } from './src/sync/engine.js';
-  import { GitHubAdapter } from './src/sync/providers/github.js';
-  // ... test connection for each provider
-"
+# Test each enabled provider with dry-run
+specweave sync-progress --dry-run
 ```
 
 Report results and confirm setup is complete.

package/plugins/specweave/skills/sync-docs/SKILL.md

@@ -39,12 +39,11 @@ Run the living docs sync via CLI:
 # Normal mode
 specweave sync-living-docs <increment-id>
 
-# If CLI command not available, use Node.js directly:
-node -e "
-  const { LivingDocsSync } = require('./dist/src/core/living-docs/living-docs-sync.js');
-  const sync = new LivingDocsSync(process.cwd());
-  sync.syncIncrement('<increment-id>').then(r => console.log(JSON.stringify(r, null, 2)));
-"
+# Review mode (dry-run)
+specweave sync-living-docs <increment-id> --dry-run
+
+# If CLI command not available, use sync-progress as fallback:
+specweave sync-progress <increment-id> --no-github --no-jira --no-ado
 ```
 
 ### Step 4: Report Results

package/plugins/specweave-ado/skills/ado-resource-validator/SKILL.md

@@ -470,11 +470,8 @@ npx specweave init
 # Via skill activation
 "Can you validate my Azure DevOps configuration?"
 
-# Via TypeScript directly
-npx tsx -e "import { validateAzureDevOpsResources } from './dist/utils/external-resource-validator.js'; await validateAzureDevOpsResources();"
-
-# Via CLI (future command - planned)
-specweave validate-ado
+# Via ADO sync (validates automatically before syncing)
+/sw-ado:sync <increment-id>
 ```
 
 **Validation output**:
@@ -771,11 +768,8 @@ Run validation independently:
 # Via skill
 "Validate my Azure DevOps configuration"
 
-# Via TypeScript
-npx tsx src/utils/external-resource-validator.ts --provider=ado
-
-# Via CLI (future)
-specweave validate-ado
+# Via ADO sync (validates automatically before syncing)
+/sw-ado:sync <increment-id>
 ```
 
 ## Best Practices

package/plugins/specweave-github/commands/sync.md

@@ -66,11 +66,11 @@ fi
 Use the Feature Sync CLI:
 
 ```bash
-# Run feature sync
-node dist/plugins/specweave-github/lib/github-feature-sync-cli.js <feature-id>
+# Run feature sync via CLI
+specweave sync-progress <increment-id>
 
 # Example
-node dist/plugins/specweave-github/lib/github-feature-sync-cli.js FS-062
+specweave sync-progress 0062
 ```
 
 ---

package/plugins/specweave-jira/skills/jira-resource-validator/SKILL.md

@@ -401,8 +401,8 @@ Enter correct board ID or name: 3
 
 **Manual validation**:
 ```bash
-# From TypeScript
-npx tsx src/utils/external-resource-validator.ts
+# Via CLI
+specweave validate-jira
 
 # Or via skill activation
 "Can you validate my Jira configuration?"
@@ -684,10 +684,7 @@ Run validation independently:
 # Via skill
 "Validate my Jira configuration"
 
-# Via TypeScript
-npx tsx src/utils/external-resource-validator.ts
-
-# Via CLI (future)
+# Via CLI
 specweave validate-jira
 ```