specweave 1.0.593 → 2.0.3

package/dist/src/core/increment/status-change-sync-trigger.js

@@ -34,7 +34,8 @@ import { SyncCircuitBreaker } from './sync-circuit-breaker.js';
 import { SyncThrottle } from '../sync-throttle.js';
 import { consoleLogger } from '../../utils/logger.js';
 import { resolveEffectiveRoot } from '../../utils/find-project-root.js';
-import { ConfigManager } from '../config/config-manager.js';
+import { livingDocsEnabled } from '../living-docs/living-docs-enabled.js';
+import { externalSyncConfigured } from '../../sync/external-sync-configured.js';
 export class StatusChangeSyncTrigger {
     /**
      * Trigger sync if status transition warrants it
@@ -59,7 +60,10 @@ export class StatusChangeSyncTrigger {
         // This handles the case where increment was created directly with "active" status
         // but living docs sync never ran (no FS-XXX folder created)
         let forceSync = false;
-        if (newStatus === IncrementStatus.ACTIVE) {
+        if (newStatus === IncrementStatus.ACTIVE && livingDocsEnabled(resolveEffectiveRoot())) {
+            // Only meaningful when living docs are switched on: with the 2.0 default
+            // (`livingDocs: false`) there is no FS-xxx folder to back-fill, and
+            // announcing a "forced living docs sync" was a straight lie.
             forceSync = await this.hasMissingFeatureId(incrementId);
             if (forceSync) {
                 this.logger.log(`📚 Increment ${incrementId} missing feature_id - forcing living docs sync...`);
@@ -69,6 +73,14 @@ export class StatusChangeSyncTrigger {
         if (!forceSync && !this.isSyncWorthy(oldStatus, newStatus)) {
             return;
         }
+        // Nothing to sync TO. With the 2.0 defaults (livingDocs: false, no tracker
+        // configured) there is no destination at all, and running the pipeline only
+        // produced the line `✅ Auto-synced increment … to external tools` in a
+        // project whose own `doctor` reports "no external sync enabled".
+        const projectRoot = resolveEffectiveRoot();
+        if (!livingDocsEnabled(projectRoot) && !externalSyncConfigured(projectRoot)) {
+            return;
+        }
         // Check circuit breaker
         if (!this.circuitBreaker.canSync()) {
             this.logger.warn('⚠️  Sync circuit breaker open - skipping auto-sync');
@@ -148,8 +160,8 @@ export class StatusChangeSyncTrigger {
     static isSyncWorthy(oldStatus, newStatus) {
         const transition = `${oldStatus} → ${newStatus}`;
         const SYNC_WORTHY = [
-            'planning → active', // Work started
-            'planned → active', // Work started (alternate status value)
+            'planned → active', // Work started
+            'planning → active', // 1.x spelling, still seen on disk
             'active → completed', // Work finished (legacy direct completion)
             'active → ready_for_review', // All tasks complete, pending user confirmation
             'ready_for_review → completed', // Work approved (v0.28.63+ user confirmation)
@@ -159,7 +171,8 @@ export class StatusChangeSyncTrigger {
             // Defense-in-depth: catch-up sync for direct-to-completed transitions.
             // Auto-walk goes through intermediates, but if metadata is edited
             // directly these ensure sync still happens.
-            'planning → completed', // Direct completion (bypassed CLI)
+            'planned → completed', // Direct completion (bypassed CLI)
+            'planning → completed', // 1.x spelling, still seen on disk
             'backlog → completed', // Direct completion (bypassed CLI)
             'paused → completed', // Direct completion (bypassed CLI)
             'paused → ready_for_review' // Paused -> review (valid transition)
@@ -179,18 +192,10 @@ export class StatusChangeSyncTrigger {
      */
     static async spawnAsyncSync(incrementId, newStatus) {
         const projectRoot = resolveEffectiveRoot();
-        // Check sync.mode: "queued" (default) vs "immediate" (legacy)
-        const syncMode = await this.getSyncMode(projectRoot);
-        if (syncMode === 'queued') {
-            // Queue event instead of direct sync
-            const { queueSyncEvent } = await import('../sync/event-queue.js');
-            await queueSyncEvent(projectRoot, incrementId, 'status.changed', newStatus ? { newStatus } : undefined);
-            this.logger.log(`📋 Queued sync event for ${incrementId} (status.changed)`);
-            return;
-        }
-        // IMMEDIATE MODE (legacy): direct sync calls below
         // Dynamic import to avoid circular dependency
         const { LivingDocsSync } = await import('../living-docs/living-docs-sync.js');
+        const externalConfigured = externalSyncConfigured(projectRoot);
+        const synced = [];
         const syncFn = async () => {
             // Record throttle BEFORE sync to prevent reentrancy.
             // Syncs take 10-30s but the throttle window is 5s — recording after
@@ -198,39 +203,37 @@ export class StatusChangeSyncTrigger {
             // creating a loop that exhausted GitHub API rate limits.
             new SyncThrottle(projectRoot).record(incrementId);
             // v1.0.19: Check if we need to auto-create external issues
-            await this.autoCreateIfNeeded(projectRoot, incrementId);
-            // Run living docs sync
-            const sync = new LivingDocsSync(projectRoot, {
-                logger: this.logger
-            });
-            await sync.syncIncrement(incrementId);
+            if (externalConfigured) {
+                await this.autoCreateIfNeeded(projectRoot, incrementId);
+                synced.push('external tools');
+            }
+            // Run living docs sync — 2.0 generates docs only on `livingDocs: 'onDone'`.
+            // (This trigger is how `livingDocs: false` projects still ended up with a
+            // freshly written FEATURE.md at the moment of closure.)
+            if (livingDocsEnabled(projectRoot)) {
+                const sync = new LivingDocsSync(projectRoot, {
+                    logger: this.logger
+                });
+                await sync.syncIncrement(incrementId);
+                synced.push('living docs');
+            }
             // v1.0.19: Auto-close issues on completion
-            if (newStatus === IncrementStatus.COMPLETED) {
+            if (externalConfigured && newStatus === IncrementStatus.COMPLETED) {
                 await this.autoCloseExternalIssues(projectRoot, incrementId);
             }
             this.circuitBreaker.recordSuccess();
-            this.logger.log(`✅ Auto-synced increment ${incrementId} to external tools`);
+            // Name only the destinations that were actually written to. Claiming
+            // "external tools" in a project with no tracker configured taught users
+            // to distrust every sync line the CLI prints.
+            if (synced.length > 0) {
+                this.logger.log(`✅ Auto-synced increment ${incrementId} to ${synced.join(' and ')}`);
+            }
         };
         // All transitions run synchronously to ensure sync completes
         // before the process exits. The previous setTimeout(0) pattern
         // caused sync to be lost when the process exited quickly.
         await syncFn();
     }
-    /**
-     * Read sync.mode from config.json.
-     * Returns 'queued' (default) or 'immediate' (legacy).
-     */
-    static async getSyncMode(projectRoot) {
-        try {
-            const configManager = new ConfigManager(projectRoot);
-            const config = await configManager.read();
-            const mode = config.sync?.mode;
-            return mode === 'immediate' ? 'immediate' : 'queued';
-        }
-        catch {
-            return 'queued';
-        }
-    }
     /**
      * Auto-create external issues if:
      * 1. config.sync.autoCreateOnIncrement = true
@@ -277,7 +280,7 @@ export class StatusChangeSyncTrigger {
             });
             // Close GitHub/JIRA/ADO issues with proper completion comments
             const result = await coordinator.syncIncrementClosure();
-            if (result.success) {
+            if (result.success && result.closedIssues.length > 0) {
                 this.logger.log(`🎉 Auto-closed external issues for ${incrementId} (${result.closedIssues.length} closed)`);
             }
         }

package/dist/src/core/increment/status-change-sync-trigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-change-sync-trigger.js","sourceRoot":"","sources":["../../../../src/core/increment/status-change-sync-trigger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status-change-sync-trigger.js","sourceRoot":"","sources":["../../../../src/core/increment/status-change-sync-trigger.ts"],"names":[],"mappings":"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"}

package/dist/src/core/increment/status-commands.d.ts

@@ -6,6 +6,16 @@
  * Part of increment 0007: Smart Status Management
  */
 import { IncrementType } from '../types/increment-metadata.js';
+/**
+ * Expand a bare 4-digit id (`0001`) to the folder name (`0001-add-login`).
+ *
+ * The design says the bare id is accepted wherever an increment id is taken
+ * (`specweave complete <NNNN>` spells it out); `pause`/`resume`/`abandon` used
+ * to hand the short form straight to MetadataManager and die with
+ * "Invalid increment ID format". Unknown / ambiguous ids are returned
+ * unchanged so the caller still produces its own error.
+ */
+export declare function expandIncrementId(incrementId: string, projectRoot?: string): string;
 export interface PauseOptions {
     incrementId: string;
     reason?: string;
@@ -13,7 +23,6 @@ export interface PauseOptions {
 }
 export interface ResumeOptions {
     incrementId: string;
-    force?: boolean;
 }
 export interface AbandonOptions {
     incrementId: string;
@@ -32,6 +41,15 @@ export declare function pauseIncrement(options: PauseOptions): Promise<void>;
  * Resume a paused or abandoned increment
  */
 export declare function resumeIncrement(options: ResumeOptions): Promise<void>;
+/**
+ * Start an increment: `planned`/`backlog`/`paused` → `active`.
+ *
+ * The 2.0 loop resolves the single ACTIVE increment for `task`, `verify` and
+ * `handoff`. `create-increment` already creates in `active`; this is the
+ * explicit CLI transition for `--planned` (backlog) increments, for imported
+ * ones, and for 1.x increments still carrying `planning`. Idempotent.
+ */
+export declare function startIncrement(options: ResumeOptions): Promise<void>;
 /**
  * Abandon an increment
  */
@@ -40,6 +58,8 @@ export interface CompleteOptions {
     incrementId: string;
     silent?: boolean;
     skipValidation?: boolean;
+    /** Close despite a missing/failing reports/verify.json (stored as metadata.closeReason). */
+    reason?: string;
 }
 /**
  * Complete an active increment

package/dist/src/core/increment/status-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-commands.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/status-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAmB,aAAa,EAAsC,MAAM,gCAAgC,CAAC;AAGpH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAWD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CzE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD7E;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CA4KlF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F3E"}
+{"version":3,"file":"status-commands.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/status-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAmB,aAAa,EAA+C,MAAM,gCAAgC,CAAC;AAK7H;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnF;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D3E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B1E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD7E;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBlF;AAgLD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG3E"}