specweave 1.0.301 → 1.0.303

package/dist/src/importers/import-to-increment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-increment.d.ts","sourceRoot":"","sources":["../../../src/importers/import-to-increment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,gCAAgC;IAChC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,yBAAyB;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA+B;gBAEtC,OAAO,EAAE,wBAAwB;IAM7C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAMjD;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgErE;;;;;;OAMG;IACG,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBzB"}

package/dist/src/importers/import-to-increment.js

@@ -0,0 +1,223 @@
+/**
+ * Import-to-Increment Converter
+ *
+ * Bridges the gap between ExternalItem (imported from GitHub/JIRA/ADO)
+ * and SpecWeave increment creation with platform-specific suffixes.
+ *
+ * @module import-to-increment
+ * @since 1.0.272
+ */
+import { IncrementNumberManager } from '../core/increment/increment-utils.js';
+import { createIncrementTemplates } from '../core/increment/template-creator.js';
+import { IncrementExternalRefDetector, formatExternalRef } from './increment-external-ref-detector.js';
+import { SUFFIX_MAP } from '../sync/types.js';
+/**
+ * Converts external items (from GitHub/JIRA/ADO) into SpecWeave increments
+ * with platform-specific suffixes (G/J/A) and duplicate prevention.
+ *
+ * @example
+ * ```typescript
+ * const converter = new ImportToIncrementConverter({
+ *   projectRoot: '/path/to/project',
+ *   projectId: 'my-app',
+ * });
+ *
+ * const result = await converter.createIncrement(externalItem);
+ * console.log(result.incrementId); // "0271G-fix-login-bug"
+ * ```
+ */
+export class ImportToIncrementConverter {
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.projectId = options.projectId;
+        this.refDetector = new IncrementExternalRefDetector(options.projectRoot);
+    }
+    /**
+     * Check if an external item has already been imported as an increment.
+     *
+     * @param item - External item to check
+     * @returns Existing increment ID if found, null otherwise
+     */
+    checkDuplicate(item) {
+        const externalRef = this.buildExternalRef(item);
+        const match = this.refDetector.hasRef(externalRef);
+        return match ? match.incrementId : null;
+    }
+    /**
+     * Create a single increment from an external item.
+     *
+     * @param item - External item to import
+     * @returns Created increment details
+     * @throws Error if item is a duplicate (use checkDuplicate first) or creation fails
+     */
+    async createIncrement(item) {
+        const externalRef = this.buildExternalRef(item);
+        // Check for duplicates
+        const existing = this.refDetector.hasRef(externalRef);
+        if (existing) {
+            throw new Error(`Duplicate import: ${externalRef} already imported as ${existing.incrementId} (${existing.location})`);
+        }
+        // Generate increment ID with platform suffix
+        const slug = slugify(item.title);
+        const platformSuffix = SUFFIX_MAP[item.platform];
+        const incrementId = IncrementNumberManager.generateIncrementId(slug, {
+            platformSuffix,
+            projectRoot: this.projectRoot,
+            projectId: this.projectId,
+        });
+        // Build external source info for template creator
+        const externalSource = {
+            platform: item.platform,
+            externalId: externalRef,
+            externalUrl: item.url,
+            title: item.title,
+            description: item.description,
+            acceptanceCriteria: item.acceptanceCriteria,
+            labels: item.labels,
+            priority: item.priority,
+            status: item.status,
+        };
+        // Map external priority to SpecWeave priority
+        const priority = item.priority ?? 'P2';
+        // Map external type to SpecWeave type
+        const type = mapExternalType(item.type);
+        // Create increment via template creator
+        const result = await createIncrementTemplates({
+            incrementId,
+            title: item.title,
+            description: item.description,
+            projectId: this.projectId || 'default',
+            type,
+            priority,
+            projectRoot: this.projectRoot,
+            externalSource,
+        });
+        if (!result.success) {
+            throw new Error(`Failed to create increment ${incrementId}: ${result.error}`);
+        }
+        return {
+            incrementId,
+            incrementPath: result.incrementPath,
+            externalRef,
+            platform: item.platform,
+            createdFiles: result.createdFiles,
+        };
+    }
+    /**
+     * Batch create increments from multiple external items.
+     * Automatically deduplicates and reports skipped items.
+     *
+     * @param items - External items to import
+     * @returns Batch result with created, skipped, and error arrays
+     */
+    async createIncrements(items) {
+        const result = {
+            created: [],
+            skipped: [],
+            errors: [],
+        };
+        // Pre-check all refs at once for efficiency
+        const refs = items.map(item => this.buildExternalRef(item));
+        const existingRefs = this.refDetector.checkRefs(refs);
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const ref = refs[i];
+            // Check duplicate
+            const existing = existingRefs.get(ref);
+            if (existing) {
+                result.skipped.push({
+                    item,
+                    externalRef: ref,
+                    existingIncrementId: existing.incrementId,
+                    reason: `Already imported as ${existing.incrementId} (${existing.location})`,
+                });
+                continue;
+            }
+            // Try to create
+            try {
+                const imported = await this.createIncrement(item);
+                result.created.push(imported);
+            }
+            catch (error) {
+                result.errors.push({
+                    item,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Build a canonical external_ref string from an ExternalItem.
+     */
+    buildExternalRef(item) {
+        switch (item.platform) {
+            case 'github': {
+                // GitHub IDs are formatted as "github#{owner/repo}#{number}"
+                const repo = item.sourceRepo || extractGitHubRepo(item.id);
+                const issueNumber = extractGitHubNumber(item.id);
+                return formatExternalRef('github', repo, issueNumber);
+            }
+            case 'jira': {
+                // JIRA IDs are the issue key (e.g., "PROJ-123")
+                const project = item.jiraProjectKey || extractJiraProject(item.id);
+                return formatExternalRef('jira', project, item.id);
+            }
+            case 'ado': {
+                // ADO IDs are work item numbers
+                const project = item.adoProjectName || 'default';
+                return formatExternalRef('ado', project, item.id);
+            }
+        }
+    }
+}
+/**
+ * Convert a title to a kebab-case slug suitable for increment folder names.
+ * Limits to 50 chars to keep folder names reasonable.
+ */
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '') // Remove special chars
+        .replace(/\s+/g, '-') // Spaces to hyphens
+        .replace(/-+/g, '-') // Collapse multiple hyphens
+        .replace(/^-|-$/g, '') // Trim leading/trailing hyphens
+        .slice(0, 50) // Limit length
+        .replace(/-$/, ''); // Clean trailing hyphen after slice
+}
+/**
+ * Map external item type to SpecWeave increment type.
+ */
+function mapExternalType(externalType) {
+    switch (externalType) {
+        case 'bug': return 'bug';
+        case 'feature': return 'feature';
+        case 'epic': return 'feature';
+        case 'user-story': return 'feature';
+        case 'task': return 'feature';
+        default: return 'feature';
+    }
+}
+/**
+ * Extract owner/repo from a GitHub external ID.
+ * Input format: "github#owner/repo#123" or just a number.
+ */
+function extractGitHubRepo(id) {
+    const match = id.match(/github#([^#]+)#/);
+    return match ? match[1] : 'unknown/unknown';
+}
+/**
+ * Extract issue number from a GitHub external ID.
+ */
+function extractGitHubNumber(id) {
+    const match = id.match(/#(\d+)$/);
+    return match ? match[1] : id.replace(/\D/g, '') || '0';
+}
+/**
+ * Extract project key from a JIRA issue ID (e.g., "PROJ-123" → "PROJ").
+ */
+function extractJiraProject(id) {
+    const match = id.match(/^([A-Z]+)-/);
+    return match ? match[1] : 'UNKNOWN';
+}
+//# sourceMappingURL=import-to-increment.js.map

package/dist/src/importers/import-to-increment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-to-increment.js","sourceRoot":"","sources":["../../../src/importers/import-to-increment.ts"],"names":[],"mappings":"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"}

package/dist/src/importers/increment-external-ref-detector.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Increment External Reference Detector
+ *
+ * Scans ALL increment metadata.json files for `external_ref` fields
+ * to prevent duplicate imports from external tools (GitHub/JIRA/ADO).
+ *
+ * @module increment-external-ref-detector
+ * @since 1.0.272
+ */
+/**
+ * Scan result for an existing external reference.
+ */
+export interface ExternalRefMatch {
+    /** Increment ID that already has this external ref */
+    incrementId: string;
+    /** Lifecycle directory where the increment was found */
+    location: 'active' | '_archive' | '_abandoned' | '_paused';
+    /** The external_ref value from metadata.json */
+    externalRef: string;
+}
+/**
+ * Detects duplicate external references across all increment directories.
+ *
+ * Scans metadata.json files in:
+ * - .specweave/increments/ (active)
+ * - .specweave/increments/_archive/
+ * - .specweave/increments/_abandoned/
+ * - .specweave/increments/_paused/
+ *
+ * @example
+ * ```typescript
+ * const detector = new IncrementExternalRefDetector('/path/to/project');
+ * const existing = detector.hasRef('github#owner/repo#123');
+ * if (existing) {
+ *   console.log(`Already imported as ${existing.incrementId}`);
+ * }
+ * ```
+ */
+export declare class IncrementExternalRefDetector {
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Build a map of all external references across all increments.
+     *
+     * @returns Map of external_ref → ExternalRefMatch
+     */
+    buildRefMap(): Map<string, ExternalRefMatch>;
+    /**
+     * Check if an external reference already exists in any increment.
+     *
+     * @param externalRef - External reference to check (e.g., "github#owner/repo#123")
+     * @returns The match if found, null otherwise
+     */
+    hasRef(externalRef: string): ExternalRefMatch | null;
+    /**
+     * Check multiple external references at once (batch dedup).
+     *
+     * @param externalRefs - Array of external references to check
+     * @returns Map of refs that already exist → their matches
+     */
+    checkRefs(externalRefs: string[]): Map<string, ExternalRefMatch>;
+}
+/**
+ * Generate a canonical external_ref string from platform and issue details.
+ *
+ * @param platform - Source platform
+ * @param identifier - Platform-specific identifier
+ * @returns Canonical external_ref string
+ *
+ * @example
+ * ```typescript
+ * formatExternalRef('github', 'owner/repo', 123) → 'github#owner/repo#123'
+ * formatExternalRef('jira', 'PROJ', 'PROJ-456')   → 'jira#PROJ#PROJ-456'
+ * formatExternalRef('ado', 'org/project', 789)     → 'ado#org/project#789'
+ * ```
+ */
+export declare function formatExternalRef(platform: 'github' | 'jira' | 'ado', context: string, issueId: string | number): string;
+//# sourceMappingURL=increment-external-ref-detector.d.ts.map

package/dist/src/importers/increment-external-ref-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-external-ref-detector.d.ts","sourceRoot":"","sources":["../../../src/importers/increment-external-ref-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3D,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAI/B;;;;OAIG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAiD5C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKpD;;;;;OAKG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;CAajE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,MAAM,CAER"}

package/dist/src/importers/increment-external-ref-detector.js

@@ -0,0 +1,130 @@
+/**
+ * Increment External Reference Detector
+ *
+ * Scans ALL increment metadata.json files for `external_ref` fields
+ * to prevent duplicate imports from external tools (GitHub/JIRA/ADO).
+ *
+ * @module increment-external-ref-detector
+ * @since 1.0.272
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Detects duplicate external references across all increment directories.
+ *
+ * Scans metadata.json files in:
+ * - .specweave/increments/ (active)
+ * - .specweave/increments/_archive/
+ * - .specweave/increments/_abandoned/
+ * - .specweave/increments/_paused/
+ *
+ * @example
+ * ```typescript
+ * const detector = new IncrementExternalRefDetector('/path/to/project');
+ * const existing = detector.hasRef('github#owner/repo#123');
+ * if (existing) {
+ *   console.log(`Already imported as ${existing.incrementId}`);
+ * }
+ * ```
+ */
+export class IncrementExternalRefDetector {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Build a map of all external references across all increments.
+     *
+     * @returns Map of external_ref → ExternalRefMatch
+     */
+    buildRefMap() {
+        const refMap = new Map();
+        const incrementsDir = path.join(this.projectRoot, '.specweave', 'increments');
+        const dirsToScan = [
+            { path: incrementsDir, location: 'active' },
+            { path: path.join(incrementsDir, '_archive'), location: '_archive' },
+            { path: path.join(incrementsDir, '_abandoned'), location: '_abandoned' },
+            { path: path.join(incrementsDir, '_paused'), location: '_paused' },
+        ];
+        for (const { path: dirPath, location } of dirsToScan) {
+            if (!fs.existsSync(dirPath))
+                continue;
+            try {
+                const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    if (entry.name.startsWith('_'))
+                        continue; // Skip lifecycle subdirs
+                    const metadataPath = path.join(dirPath, entry.name, 'metadata.json');
+                    if (!fs.existsSync(metadataPath))
+                        continue;
+                    try {
+                        const raw = fs.readFileSync(metadataPath, 'utf-8');
+                        const metadata = JSON.parse(raw);
+                        if (metadata.external_ref) {
+                            refMap.set(metadata.external_ref, {
+                                incrementId: metadata.id || entry.name,
+                                location,
+                                externalRef: metadata.external_ref,
+                            });
+                        }
+                    }
+                    catch {
+                        // Corrupted metadata.json — skip silently
+                        continue;
+                    }
+                }
+            }
+            catch {
+                // Permission denied or other error — skip
+                continue;
+            }
+        }
+        return refMap;
+    }
+    /**
+     * Check if an external reference already exists in any increment.
+     *
+     * @param externalRef - External reference to check (e.g., "github#owner/repo#123")
+     * @returns The match if found, null otherwise
+     */
+    hasRef(externalRef) {
+        const refMap = this.buildRefMap();
+        return refMap.get(externalRef) ?? null;
+    }
+    /**
+     * Check multiple external references at once (batch dedup).
+     *
+     * @param externalRefs - Array of external references to check
+     * @returns Map of refs that already exist → their matches
+     */
+    checkRefs(externalRefs) {
+        const refMap = this.buildRefMap();
+        const duplicates = new Map();
+        for (const ref of externalRefs) {
+            const match = refMap.get(ref);
+            if (match) {
+                duplicates.set(ref, match);
+            }
+        }
+        return duplicates;
+    }
+}
+/**
+ * Generate a canonical external_ref string from platform and issue details.
+ *
+ * @param platform - Source platform
+ * @param identifier - Platform-specific identifier
+ * @returns Canonical external_ref string
+ *
+ * @example
+ * ```typescript
+ * formatExternalRef('github', 'owner/repo', 123) → 'github#owner/repo#123'
+ * formatExternalRef('jira', 'PROJ', 'PROJ-456')   → 'jira#PROJ#PROJ-456'
+ * formatExternalRef('ado', 'org/project', 789)     → 'ado#org/project#789'
+ * ```
+ */
+export function formatExternalRef(platform, context, issueId) {
+    return `${platform}#${context}#${issueId}`;
+}
+//# sourceMappingURL=increment-external-ref-detector.js.map

package/dist/src/importers/increment-external-ref-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-external-ref-detector.js","sourceRoot":"","sources":["../../../src/importers/increment-external-ref-detector.ts"],"names":[],"mappings":"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"}

package/dist/src/init/research/types.d.ts

@@ -73,12 +73,12 @@ export declare const VisionInsightsSchema: z.ZodObject<{
         education: "education";
         iot: "iot";
         gaming: "gaming";
+        marketplace: "marketplace";
         "productivity-saas": "productivity-saas";
         "e-commerce": "e-commerce";
         "social-network": "social-network";
         "enterprise-b2b": "enterprise-b2b";
         "consumer-b2c": "consumer-b2c";
-        marketplace: "marketplace";
         blockchain: "blockchain";
         "ai-ml": "ai-ml";
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.301",
+  "version": "1.0.303",
   "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/hooks/stop-auto-v5.sh

@@ -168,8 +168,8 @@ for meta in $(find "$INC_DIR" -maxdepth 2 -name "metadata.json" 2>/dev/null); do
     p=$(count_pending_tasks "$d/tasks.md"); a=$(count_open_acs "$d/spec.md")
     if [ "$p" -gt 0 ] || [ "$a" -gt 0 ]; then
         TP=$((TP + p)); TAC=$((TAC + a)); IC=$((IC + 1))
-        # Extract next pending task title (first [ ] line, strip markdown)
-        _next_task=$(grep -m1 '\[ \]' "$d/tasks.md" 2>/dev/null | sed 's/.*\] //' | head -c 80 || echo "")
+        # Extract next pending task title using helper
+        _next_task=$(get_next_task_title "$d/tasks.md")
         # Count completed tasks for progress fraction
         _done=$(grep -c '\[x\]' "$d/tasks.md" 2>/dev/null) || _done=0
         _total=$((_done + p))

package/plugins/specweave/hooks/stop-sync.sh

@@ -74,15 +74,16 @@ if [ ! -f "$BRIDGE_HANDLER" ]; then
 fi
 
 # Cross-platform timeout wrapper
+# FIXED (v1.0.302): Don't suppress stderr from inner commands
 run_with_timeout() {
     local timeout_secs="$1"
     shift
     if command -v timeout >/dev/null 2>&1; then
-        timeout "$timeout_secs" "$@" 2>/dev/null || true
+        timeout "$timeout_secs" "$@" || true
     elif command -v gtimeout >/dev/null 2>&1; then
-        gtimeout "$timeout_secs" "$@" 2>/dev/null || true
+        gtimeout "$timeout_secs" "$@" || true
     else
-        "$@" 2>/dev/null || true
+        "$@" || true
     fi
 }
 
@@ -194,11 +195,15 @@ for INC_ID in $INCREMENTS_TO_SYNC; do
 
     # Route user-story events to github-sync-handler (v1.0.262+)
     # github-sync-handler understands user-story.completed/reopened with INC_ID:US_ID data
+    # FIXED (v1.0.302): Filter by BOTH event type AND increment ID to prevent
+    # routing all events to the first matching increment's US event.
     if [ -f "$GITHUB_SYNC_HANDLER" ] && [ -f "$EVENT_TYPES_FILE" ]; then
         while IFS='|' read -r _inc_id us_event_type; do
             [ -z "$us_event_type" ] && continue
-            # Extract US data (INC_ID:US_ID) from pending.jsonl for this event
-            US_DATA=$(grep -o "\"type\":\"${us_event_type}\"[^}]*\"data\":\"[^\"]*\"" "$PENDING_FILE" 2>/dev/null \
+            # Extract US data (INC_ID:US_ID) from pending.jsonl for THIS increment
+            # Must match both the event type AND the increment ID in the data field
+            US_DATA=$(grep "\"type\":\"${us_event_type}\"" "$PENDING_FILE" 2>/dev/null \
+                | grep "\"data\":\"${INC_ID}:" \
                 | grep -o '"data":"[^"]*"' | cut -d'"' -f4 | head -1)
             if [ -n "$US_DATA" ]; then
                 log "Routing user-story event to github-sync-handler: $us_event_type $US_DATA"

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -1415,9 +1415,11 @@ Then spawn agent: \`Task({ subagent_type: \"${PRIMARY_PLUGIN}:${PRIMARY_SKILL_NA
                       # The skill reads the user's prompt from conversation context (it's already there).
 
                       # v1.0.243: Smart interview gate — LLM assesses prompt completeness
+                      # v1.0.301: Removed question count cap ("2-5") — sw:pm decides count
+                      # based on complexity (trivial: 0-3, small: 4-8, medium: 9-18, large: 19-40).
                       DEEP_INTERVIEW_MSG=""
                       if [[ "$DEEP_INTERVIEW_ENABLED" == "true" ]]; then
-                        DEEP_INTERVIEW_MSG=" Assess prompt completeness first — if gaps exist, ask 2-5 targeted questions before calling."
+                        DEEP_INTERVIEW_MSG=" Deep interview enabled — sw:pm skill will assess complexity and interview depth."
                       fi
 
                       MSG="${WIP_WARNING}${AUTOLOAD_PREFIX}SKILL FIRST: \`Skill({ skill: \"sw:increment\" })\` — call BEFORE implementation.
@@ -2092,7 +2094,7 @@ if [[ "$DEEP_INTERVIEW_ENABLED" == "true" ]] && [[ -z "$ACTIVE_INCREMENT" ]]; th
   fi
 
   if [[ "$HAVE_ACTIVE_STATE" != "true" ]]; then
-    SMART_INTERVIEW_GATE_MSG="No active increment. Assess prompt completeness for complexity — if gaps, ask 2-5 targeted questions. If sufficient, call sw:increment."
+    SMART_INTERVIEW_GATE_MSG="No active increment. Deep interview enabled — assess prompt completeness for complexity. If gaps exist, ask targeted questions (count depends on complexity). If sufficient, call sw:increment."
   fi
 fi
 
@@ -2429,20 +2431,40 @@ _budget_append "$ARCHIVE_SUGGESTION_MSG"
 # ==============================================================================
 # If this turn's context is identical to last turn's, don't re-inject it.
 # Claude already has it in history. Saves ~2500 chars per duplicate turn.
+#
+# v1.0.301: SMART_INTERVIEW_GATE_MSG is excluded from the dedup hash.
+# The gate must fire on EVERY prompt (until an increment is created) so the
+# LLM keeps assessing prompt completeness across turns. Hashing the full
+# FINAL_MESSAGE (which includes the gate) would produce the same hash on
+# consecutive prompts and suppress the gate after the first turn.
 if [[ -n "$FINAL_MESSAGE" ]] && [[ -n "$SW_PROJECT_ROOT" ]]; then
   DEDUP_HASH_FILE="$SW_PROJECT_ROOT/.specweave/state/.context-hash"
   CURRENT_HASH=""
+
+  # Build hash input WITHOUT the gate message so it doesn't trigger dedup
+  DEDUP_INPUT="$FINAL_MESSAGE"
+  if [[ -n "$SMART_INTERVIEW_GATE_MSG" ]]; then
+    # Remove the gate message (with leading \n) from hash input
+    DEDUP_INPUT="${DEDUP_INPUT//\\n${SMART_INTERVIEW_GATE_MSG}/}"
+    DEDUP_INPUT="${DEDUP_INPUT//${SMART_INTERVIEW_GATE_MSG}/}"
+  fi
+
   if command -v md5sum >/dev/null 2>&1; then
-    CURRENT_HASH=$(printf '%s' "$FINAL_MESSAGE" | md5sum | cut -d' ' -f1)
+    CURRENT_HASH=$(printf '%s' "$DEDUP_INPUT" | md5sum | cut -d' ' -f1)
   elif command -v md5 >/dev/null 2>&1; then
-    CURRENT_HASH=$(printf '%s' "$FINAL_MESSAGE" | md5)
+    CURRENT_HASH=$(printf '%s' "$DEDUP_INPUT" | md5)
   fi
 
   if [[ -n "$CURRENT_HASH" ]]; then
     if [[ -f "$DEDUP_HASH_FILE" ]]; then
       PREV_HASH=$(cat "$DEDUP_HASH_FILE" 2>/dev/null)
       if [[ "$CURRENT_HASH" == "$PREV_HASH" ]]; then
-        # Identical to last turn — skip injection
+        if [[ -n "$SMART_INTERVIEW_GATE_MSG" ]]; then
+          # Rest of context is duplicate, but gate must still fire
+          output_approve_with_context "\\n${SMART_INTERVIEW_GATE_MSG}"
+          exit 0
+        fi
+        # No gate — fully identical, skip injection
         echo '{"decision":"approve"}'
         exit 0
       fi

package/plugins/specweave/hooks/v2/handlers/github-sync-handler.sh

@@ -144,15 +144,18 @@ touch "$THROTTLE_FILE"
 echo "[$(date '+%Y-%m-%d %H:%M:%S')] [github-sync] EXECUTING $INC_ID ($SYNC_TYPE) event=$EVENT_TYPE" >> "$THROTTLE_LOG" 2>/dev/null
 
 # Cross-platform timeout wrapper
+# FIXED (v1.0.302): Don't suppress stderr from inner commands — only suppress
+# stderr from timeout/gtimeout binary itself (e.g., "command not found").
+# The caller already redirects stderr to log files via 2>&1.
 run_with_timeout() {
   local timeout_secs="$1"
   shift
   if command -v timeout >/dev/null 2>&1; then
-    timeout "$timeout_secs" "$@" 2>/dev/null || true
+    timeout "$timeout_secs" "$@" || true
   elif command -v gtimeout >/dev/null 2>&1; then
-    gtimeout "$timeout_secs" "$@" 2>/dev/null || true
+    gtimeout "$timeout_secs" "$@" || true
   else
-    "$@" 2>/dev/null || true
+    "$@" || true
   fi
 }
 

package/plugins/specweave/hooks/v2/handlers/project-bridge-handler.sh

@@ -79,15 +79,16 @@ for path in \
 done
 
 # Cross-platform timeout wrapper
+# FIXED (v1.0.302): Don't suppress stderr from inner commands
 run_with_timeout() {
   local timeout_secs="$1"
   shift
   if command -v timeout >/dev/null 2>&1; then
-    timeout "$timeout_secs" "$@" 2>/dev/null || true
+    timeout "$timeout_secs" "$@" || true
   elif command -v gtimeout >/dev/null 2>&1; then
-    gtimeout "$timeout_secs" "$@" 2>/dev/null || true
+    gtimeout "$timeout_secs" "$@" || true
   else
-    "$@" 2>/dev/null || true
+    "$@" || true
   fi
 }