specweave 1.0.253 → 1.0.254

package/dist/src/core/repo-structure/role-prefix-collector.js

@@ -0,0 +1,106 @@
+/**
+ * Role & Prefix Collector
+ *
+ * Interactive flow that runs AFTER repo discovery (manual, bulk, or greenfield).
+ * Asks the user to assign a role and story prefix to each repository,
+ * then optionally designate a parent repo for centralized tracking.
+ */
+import chalk from 'chalk';
+import { select, input, confirm } from '@inquirer/prompts';
+import { validatePrefix, ROLE_PREFIX_DEFAULTS } from './prefix-validator.js';
+const ROLE_CHOICES = [
+    { name: 'Frontend (web, mobile UI)', value: 'frontend' },
+    { name: 'Backend (API, services)', value: 'backend' },
+    { name: 'Mobile (iOS, Android app)', value: 'mobile' },
+    { name: 'Infrastructure (Terraform, K8s)', value: 'infra' },
+    { name: 'Shared (libraries, utilities)', value: 'shared' },
+    { name: 'Other', value: 'other' },
+];
+/**
+ * Collect role and story prefix for each discovered repo.
+ *
+ * Runs AFTER repos are discovered/configured. Asks per-repo:
+ * 1. What is this repo for? (role)
+ * 2. Story prefix? (with role-based default, validated for uniqueness)
+ */
+export async function collectRolesAndPrefixes(repos) {
+    if (repos.length === 0)
+        return [];
+    console.log(chalk.cyan('\n🏷️  Repository Roles & Prefixes\n'));
+    console.log(chalk.gray('Each repo gets a role and a prefix for user stories (e.g., US-FE-001).\n'));
+    const result = [];
+    const usedPrefixes = new Set();
+    for (const repo of repos) {
+        console.log(chalk.white(`\n${repo.name}:`));
+        const role = await select({
+            message: 'What is this repository for?',
+            choices: ROLE_CHOICES,
+        });
+        const defaultPrefix = ROLE_PREFIX_DEFAULTS[role] || 'MISC';
+        const prefix = await input({
+            message: 'Story prefix (e.g., US-FE-001):',
+            default: defaultPrefix,
+            validate: (val) => {
+                const validation = validatePrefix(val, usedPrefixes);
+                if (!validation.valid)
+                    return validation.error;
+                return true;
+            },
+        });
+        // Normalize and track
+        const validation = validatePrefix(prefix, usedPrefixes);
+        const normalized = validation.normalized || prefix.toUpperCase();
+        usedPrefixes.add(normalized);
+        console.log(chalk.green(`   ✓ ${repo.name} → ${normalized} stories\n`));
+        result.push({
+            ...repo,
+            role,
+            storyPrefix: normalized,
+        });
+    }
+    return result;
+}
+/**
+ * Ask if user wants a parent repo for centralized issue tracking.
+ *
+ * Only offered when 2+ repos exist. Shows clear explanation of what
+ * a parent repo means and when to use it.
+ *
+ * @returns Selected parent repo ID, or undefined if declined
+ */
+export async function promptParentRepo(repos) {
+    if (repos.length < 2)
+        return undefined;
+    console.log(chalk.cyan('\n📦 Issue Tracking Strategy\n'));
+    const wantParent = await confirm({
+        message: [
+            'Do you want a parent/coordination repository?\n',
+            chalk.gray('   A parent repo tracks ALL work items in one place (issues, milestones).'),
+            chalk.gray('   It typically contains only docs/specs, no application code.\n'),
+            chalk.gray('   Use a parent repo if:'),
+            chalk.gray('     ✓ You have 3+ microservices and want one place for all work'),
+            chalk.gray('     ✓ Your team uses a central "specs" or "planning" repo\n'),
+            chalk.gray('   Skip parent repo if:'),
+            chalk.gray('     ✗ You only have 1-2 repos (just use the main repo for issues)'),
+            chalk.gray('     ✗ Each service has its own PM/team\n'),
+            chalk.gray('   Examples:'),
+            chalk.gray('     • WITH parent: acme-specs (tracks), acme-frontend, acme-api (code)'),
+            chalk.gray('     • WITHOUT parent: my-frontend (tracks + code), my-api (tracks + code)\n'),
+        ].join('\n'),
+        default: false,
+    });
+    if (!wantParent) {
+        console.log(chalk.gray('   → First repository will be default for issues\n'));
+        return undefined;
+    }
+    const parentId = await select({
+        message: 'Which repo should be the parent for issue tracking?',
+        choices: repos.map(r => ({
+            name: r.name,
+            value: r.id,
+        })),
+    });
+    console.log(chalk.green(`\n   ✓ Using "${parentId}" as parent for all work items\n`));
+    return parentId;
+}
+//# sourceMappingURL=role-prefix-collector.js.map

package/dist/src/core/repo-structure/role-prefix-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-prefix-collector.js","sourceRoot":"","sources":["../../../../src/core/repo-structure/role-prefix-collector.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/session-start.js

@@ -16,6 +16,7 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { fileURLToPath } from 'url';
 import { findProjectRoot, spawnNodeBackground, outputHookResult, consumeStdin, appendLog, } from './platform.js';
+import { cleanOrphanedStateFiles } from '../utils/state-cleanup.js';
 // Proper cross-platform URL-to-path conversion
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -43,6 +44,12 @@ async function main() {
     // Consume stdin (required by hook protocol)
     await consumeStdin();
     const logFile = path.join(projectRoot, '.specweave', 'logs', 'session-start.log');
+    // v1.0.254: Clean up orphaned state files on session start
+    const stateDir = path.join(projectRoot, '.specweave', 'state');
+    const cleaned = cleanOrphanedStateFiles(stateDir);
+    if (cleaned > 0) {
+        appendLog(logFile, `Cleaned ${cleaned} orphaned state files`);
+    }
     const distHooksDir = path.join(projectRoot, 'node_modules', 'specweave', 'dist', 'hooks');
     // Check for processor script
     // First try: built hooks in dist (production)

package/dist/src/hooks/session-start.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../src/hooks/session-start.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,+CAA+C;AAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,0BAA0B;IAC1B,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,4CAA4C;IAC5C,MAAM,YAAY,EAAE,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1F,6BAA6B;IAC7B,8CAA8C;IAC9C,2DAA2D;IAC3D,IAAI,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,uEAAuE;QACvE,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,+CAA+C;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC;QAC9E,IAAI,KAAK,EAAE,CAAC;YACV,SAAS,CAAC,OAAO,EAAE,2BAA2B,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,uEAAuE;QACvE,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IACjE,CAAC;IAED,wDAAwD;IACxD,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,wCAAwC;YACxC,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YACtD,IAAI,OAAO,eAAe,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC;gBAC7D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;gBACrE,IAAI,MAAM,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;oBACnC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;oBAC1E,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,OAAO,EAAE,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,WAAW;AACX,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,yCAAyC;AAC5D,CAAC,CAAC,CAAC"}
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../src/hooks/session-start.ts"],"names":[],"mappings":"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"}

package/dist/src/sync/story-router.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Story Router
+ *
+ * Routes user stories to repos by prefix matching.
+ * Format: US-{PREFIX}-{NUM} → matches repo with that prefix.
+ * Falls back to first repo (or custom default) when no match.
+ */
+import type { ChildRepoConfig } from '../core/config/types.js';
+export interface StoryRoutingResult {
+    /** Matched repo ID, or null if no repos available */
+    repoId: string | null;
+    /** Whether routing was an explicit prefix match */
+    matched: boolean;
+    /** Reason for routing decision (useful for debugging) */
+    reason: string;
+}
+/**
+ * Extract prefix from a user story ID.
+ *
+ * Supports: US-FE-001, US-SHARED-042, us-be-007 (case-insensitive)
+ * Returns null for: US-001 (no prefix), STORY-123 (wrong format)
+ *
+ * @param storyId - The story identifier (e.g., "US-FE-001")
+ * @returns Extracted prefix in uppercase, or null
+ */
+export declare function extractPrefix(storyId: string): string | null;
+/**
+ * Route a user story to a repo by prefix matching.
+ *
+ * @param storyId - Story identifier (e.g., "US-FE-001")
+ * @param childRepos - Available repos with prefix config
+ * @param defaultRepoId - Optional explicit default repo ID
+ * @returns Routing result with repoId, matched flag, and reason
+ */
+export declare function routeByPrefix(storyId: string, childRepos: ChildRepoConfig[], defaultRepoId?: string): StoryRoutingResult;
+//# sourceMappingURL=story-router.d.ts.map

package/dist/src/sync/story-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-router.d.ts","sourceRoot":"","sources":["../../../src/sync/story-router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,EAAE,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,kBAAkB,CA0BpB"}

package/dist/src/sync/story-router.js

@@ -0,0 +1,56 @@
+/**
+ * Story Router
+ *
+ * Routes user stories to repos by prefix matching.
+ * Format: US-{PREFIX}-{NUM} → matches repo with that prefix.
+ * Falls back to first repo (or custom default) when no match.
+ */
+/**
+ * Extract prefix from a user story ID.
+ *
+ * Supports: US-FE-001, US-SHARED-042, us-be-007 (case-insensitive)
+ * Returns null for: US-001 (no prefix), STORY-123 (wrong format)
+ *
+ * @param storyId - The story identifier (e.g., "US-FE-001")
+ * @returns Extracted prefix in uppercase, or null
+ */
+export function extractPrefix(storyId) {
+    if (!storyId)
+        return null;
+    // Match US-{PREFIX}-{NUM} where PREFIX is 2-6 letters
+    const match = storyId.match(/^US-([A-Za-z]{2,6})-\d+/i);
+    if (!match)
+        return null;
+    return match[1].toUpperCase();
+}
+/**
+ * Route a user story to a repo by prefix matching.
+ *
+ * @param storyId - Story identifier (e.g., "US-FE-001")
+ * @param childRepos - Available repos with prefix config
+ * @param defaultRepoId - Optional explicit default repo ID
+ * @returns Routing result with repoId, matched flag, and reason
+ */
+export function routeByPrefix(storyId, childRepos, defaultRepoId) {
+    if (childRepos.length === 0) {
+        return { repoId: null, matched: false, reason: 'No repos configured' };
+    }
+    const fallbackId = defaultRepoId
+        ? (childRepos.find(r => r.id === defaultRepoId)?.id ?? childRepos[0].id)
+        : childRepos[0].id;
+    const prefix = extractPrefix(storyId);
+    if (!prefix) {
+        return { repoId: fallbackId, matched: false, reason: 'No prefix in story ID' };
+    }
+    // Try exact prefix match
+    const matched = childRepos.find(r => r.prefix && r.prefix.toUpperCase() === prefix);
+    if (matched) {
+        return { repoId: matched.id, matched: true, reason: `Matched prefix ${prefix}` };
+    }
+    return {
+        repoId: fallbackId,
+        matched: false,
+        reason: `Unknown prefix "${prefix}" — using default`,
+    };
+}
+//# sourceMappingURL=story-router.js.map

package/dist/src/sync/story-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-router.js","sourceRoot":"","sources":["../../../src/sync/story-router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,sDAAsD;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,UAA6B,EAC7B,aAAsB;IAEtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACjF,CAAC;IAED,yBAAyB;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACpF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,MAAM,EAAE,EAAE,CAAC;IACnF,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,mBAAmB,MAAM,mBAAmB;KACrD,CAAC;AACJ,CAAC"}

package/dist/src/utils/state-cleanup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * State directory cleanup utility (v1.0.254)
+ *
+ * Removes orphaned marker files from .specweave/state/ that accumulate
+ * over time and are never cleaned up. These don't cause functional issues
+ * but contribute to state directory bloat.
+ *
+ * Called from session-start hook to run once per session.
+ *
+ * @module utils/state-cleanup
+ */
+/**
+ * Remove orphaned state marker files older than 7 days.
+ *
+ * @param stateDir - Path to .specweave/state/ directory
+ * @returns Number of files removed
+ */
+export declare function cleanOrphanedStateFiles(stateDir: string): number;
+//# sourceMappingURL=state-cleanup.d.ts.map

package/dist/src/utils/state-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-cleanup.d.ts","sourceRoot":"","sources":["../../../src/utils/state-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgChE"}

package/dist/src/utils/state-cleanup.js

@@ -0,0 +1,61 @@
+/**
+ * State directory cleanup utility (v1.0.254)
+ *
+ * Removes orphaned marker files from .specweave/state/ that accumulate
+ * over time and are never cleaned up. These don't cause functional issues
+ * but contribute to state directory bloat.
+ *
+ * Called from session-start hook to run once per session.
+ *
+ * @module utils/state-cleanup
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** Patterns of orphaned marker files to clean up */
+const ORPHAN_PATTERNS = [
+    /^\.prev-status-/,
+    /^\.github-sync-/,
+    /^\.living-specs-/,
+];
+/** Files older than this (in ms) are eligible for cleanup */
+const MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+/**
+ * Remove orphaned state marker files older than 7 days.
+ *
+ * @param stateDir - Path to .specweave/state/ directory
+ * @returns Number of files removed
+ */
+export function cleanOrphanedStateFiles(stateDir) {
+    if (!fs.existsSync(stateDir))
+        return 0;
+    let removed = 0;
+    const now = Date.now();
+    try {
+        const entries = fs.readdirSync(stateDir);
+        for (const entry of entries) {
+            // Check if filename matches any orphan pattern
+            const isOrphan = ORPHAN_PATTERNS.some(pattern => pattern.test(entry));
+            if (!isOrphan)
+                continue;
+            const filePath = path.join(stateDir, entry);
+            try {
+                const stat = fs.statSync(filePath);
+                if (!stat.isFile())
+                    continue;
+                const age = now - stat.mtimeMs;
+                if (age > MAX_AGE_MS) {
+                    fs.unlinkSync(filePath);
+                    removed++;
+                }
+            }
+            catch {
+                // Skip files we can't stat or delete
+            }
+        }
+    }
+    catch {
+        // Directory read failed — not critical
+    }
+    return removed;
+}
+//# sourceMappingURL=state-cleanup.js.map

package/dist/src/utils/state-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-cleanup.js","sourceRoot":"","sources":["../../../src/utils/state-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,oDAAoD;AACpD,MAAM,eAAe,GAAG;IACtB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;CACnB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAErD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAE7B,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC/B,IAAI,GAAG,GAAG,UAAU,EAAE,CAAC;oBACrB,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACxB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.253",
+  "version": "1.0.254",
   "description": "Spec-driven development framework for AI coding agents. First-class support for Claude Code — compatible with any LLM-powered coding tool. Living documentation, autonomous execution, quality gates, and multilingual support (9 languages).",
   "type": "module",
   "main": "dist/index.js",

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

@@ -371,17 +371,40 @@ escape_json_early() {
   fi
 }
 
+# v1.0.254: Prompt safety limits to prevent "Prompt is too long" errors
+# These must match the constants in src/core/lazy-loading/llm-plugin-detector.ts
+MAX_ADDITIONAL_CONTEXT_LENGTH=8000
+MAX_SKILL_FIRST_PROMPT_LENGTH=2000
+
 # Helper: Output approve response with context (Claude Code hook format v1.0.166)
 # CRITICAL: systemMessage is NOT a valid field for UserPromptSubmit hooks!
 # Use hookSpecificOutput.additionalContext instead.
 # See: https://docs.claude.com/en/docs/claude-code/hooks
+#
+# v1.0.254: Added size guard — truncates additionalContext if it exceeds
+# MAX_ADDITIONAL_CONTEXT_LENGTH to prevent "Prompt is too long" errors.
 output_approve_with_context() {
   local context="$1"
+  # v1.0.254: Safety truncation to prevent prompt overflow
+  if [[ ${#context} -gt $MAX_ADDITIONAL_CONTEXT_LENGTH ]]; then
+    context="${context:0:$MAX_ADDITIONAL_CONTEXT_LENGTH}... [context truncated for safety]"
+  fi
   local escaped
   escaped=$(escape_json_early "$context")
   printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","additionalContext":"%s"}}\n' "$escaped"
 }
 
+# Helper: Truncate and escape a prompt for SKILL FIRST args (v1.0.254)
+# Truncates to MAX_SKILL_FIRST_PROMPT_LENGTH, escapes for JSON embedding.
+# Args: $1=raw prompt text
+# Returns: Escaped, truncated prompt on stdout
+truncate_and_escape_prompt() {
+  local prompt="$1"
+  local truncated="${prompt:0:$MAX_SKILL_FIRST_PROMPT_LENGTH}"
+  [[ ${#prompt} -gt $MAX_SKILL_FIRST_PROMPT_LENGTH ]] && truncated="${truncated}... [truncated - see original prompt above]"
+  printf '%s' "$truncated" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g' | tr '\n' ' '
+}
+
 # Helper: Get skill memory content for injection (v1.0.198)
 # Reads .specweave/skill-memories/{skill}.md and extracts learnings.
 # Args: $1=full skill name (e.g., "sw:pm", "sw-frontend:frontend-architect")
@@ -1386,12 +1409,11 @@ Task({
                     [[ -n "$INC_NAME" ]] && CMD="/sw:increment \"$INC_NAME\""
 
                     # v1.0.169: Call sw:increment-planner DIRECTLY (not wrapper)
-                    # Pass FULL user prompt so skill can extract all context
+                    # Pass user prompt so skill can extract context
                     # INC_MANDATORY comes from detect-intent LLM response
                     if [[ "$INC_MANDATORY" == "true" ]]; then
-                      # Escape the full prompt for JSON embedding
-                      # Use printf to handle special chars, then escape for nested JSON
-                      ESCAPED_PROMPT=$(printf '%s' "$PROMPT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g' | tr '\n' ' ')
+                      # v1.0.254: Truncate + escape to prevent "Prompt is too long"
+                      ESCAPED_PROMPT=$(truncate_and_escape_prompt "$PROMPT")
 
                       # v1.0.243: Smart interview gate — LLM assesses prompt completeness
                       # before blindly calling increment-planner. If details are missing,
@@ -1466,7 +1488,7 @@ See CLAUDE.md section \"MANDATORY: Skill Chaining\" for full pattern."
                       exit 0
                     else
                       # v1.0.169: Also suggest direct skill call for non-mandatory
-                      ESCAPED_PROMPT_SUGGEST=$(printf '%s' "$PROMPT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g' | tr '\n' ' ')
+                      ESCAPED_PROMPT_SUGGEST=$(truncate_and_escape_prompt "$PROMPT")
                       MSG="${WIP_WARNING}${AUTOLOAD_PREFIX}💡 **Increment Suggestion**: This looks like new feature work.
 
 Consider creating an increment first:
@@ -1488,7 +1510,7 @@ Or via command: \`$CMD\`
 
                   hotfix)
                     # v1.0.169: Direct skill call for hotfix too
-                    ESCAPED_PROMPT_HOTFIX=$(printf '%s' "$PROMPT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g' | tr '\n' ' ')
+                    ESCAPED_PROMPT_HOTFIX=$(truncate_and_escape_prompt "$PROMPT")
                     MSG="${WIP_WARNING}${AUTOLOAD_PREFIX}🚨 **Hotfix Detected**: Urgent production issue.
 
 Create a hotfix increment:
@@ -1530,7 +1552,7 @@ specweave resume <id>  # Reopen it
                   small_fix)
                     # v1.0.241: small_fix still suggests increment (non-mandatory)
                     # Previously small_fix fell through with no output at all
-                    ESCAPED_PROMPT_SMALLFIX=$(printf '%s' "$PROMPT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/	/\\t/g' | tr '\n' ' ')
+                    ESCAPED_PROMPT_SMALLFIX=$(truncate_and_escape_prompt "$PROMPT")
                     CMD_SMALLFIX="/sw:increment"
                     [[ -n "$INC_NAME" ]] && CMD_SMALLFIX="/sw:increment \"$INC_NAME\""