specweave 0.13.5 → 0.14.0

package/dist/core/status-line/status-line-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Status Line Manager
+ *
+ * Ultra-fast status line rendering with intelligent caching.
+ * Target: <1ms render time for 99% of requests.
+ *
+ * Architecture:
+ * - Hook pre-computes cache (async, 10-50ms)
+ * - Renderer reads cache (sync, <1ms)
+ * - mtime-based invalidation (handles external edits)
+ */
+import { StatusLineCache, StatusLineConfig } from './types.js';
+export declare class StatusLineManager {
+    private rootDir;
+    private cacheFile;
+    private config;
+    constructor(rootDir?: string, config?: Partial<StatusLineConfig>);
+    /**
+     * Render status line (FAST PATH: <1ms)
+     *
+     * Returns formatted status line string or null if no active increment.
+     */
+    render(): string | null;
+    /**
+     * Get cache with freshness validation (0.5-1ms)
+     *
+     * Returns null if:
+     * - Cache file missing
+     * - Cache too old (>maxCacheAge)
+     * - tasks.md modified since cache update
+     */
+    private getCache;
+    /**
+     * Check if cache is fresh (0.2-0.5ms)
+     *
+     * Two-level check:
+     * 1. Age check (ultra-fast, no I/O)
+     * 2. mtime check (fast, single stat() call)
+     */
+    private isCacheFresh;
+    /**
+     * Format status line from cache (0.1ms)
+     */
+    private formatStatusLine;
+    /**
+     * Render ASCII progress bar (0.05ms)
+     */
+    private renderProgressBar;
+    /**
+     * Truncate string with ellipsis (0.01ms)
+     */
+    private truncate;
+    /**
+     * Get raw cache data (for testing/debugging)
+     */
+    getCacheData(): StatusLineCache | null;
+    /**
+     * Clear cache (for testing/manual reset)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=status-line-manager.d.ts.map

package/dist/core/status-line/status-line-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line-manager.d.ts","sourceRoot":"","sources":["../../../src/core/status-line/status-line-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,eAAe,EACf,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAmB;gBAGvB,OAAO,GAAE,MAAsB,EACvC,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAMxC;;;;OAIG;IACI,MAAM,IAAI,MAAM,GAAG,IAAI;IAa9B;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IA2BhB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACI,YAAY,IAAI,eAAe,GAAG,IAAI;IAY7C;;OAEG;IACI,UAAU,IAAI,IAAI;CAS1B"}

package/dist/core/status-line/status-line-manager.js

@@ -0,0 +1,169 @@
+/**
+ * Status Line Manager
+ *
+ * Ultra-fast status line rendering with intelligent caching.
+ * Target: <1ms render time for 99% of requests.
+ *
+ * Architecture:
+ * - Hook pre-computes cache (async, 10-50ms)
+ * - Renderer reads cache (sync, <1ms)
+ * - mtime-based invalidation (handles external edits)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { DEFAULT_STATUS_LINE_CONFIG, } from './types.js';
+export class StatusLineManager {
+    constructor(rootDir = process.cwd(), config = {}) {
+        this.rootDir = rootDir;
+        this.cacheFile = path.join(rootDir, '.specweave/state/status-line.json');
+        this.config = { ...DEFAULT_STATUS_LINE_CONFIG, ...config };
+    }
+    /**
+     * Render status line (FAST PATH: <1ms)
+     *
+     * Returns formatted status line string or null if no active increment.
+     */
+    render() {
+        if (!this.config.enabled) {
+            return null;
+        }
+        const cache = this.getCache();
+        if (!cache) {
+            return null; // No active increment or cache stale
+        }
+        return this.formatStatusLine(cache);
+    }
+    /**
+     * Get cache with freshness validation (0.5-1ms)
+     *
+     * Returns null if:
+     * - Cache file missing
+     * - Cache too old (>maxCacheAge)
+     * - tasks.md modified since cache update
+     */
+    getCache() {
+        try {
+            // Step 1: Read cache file (0.3ms)
+            if (!fs.existsSync(this.cacheFile)) {
+                return null;
+            }
+            const content = fs.readFileSync(this.cacheFile, 'utf8');
+            const cache = JSON.parse(content);
+            // Step 2: Validate cache has required fields
+            if (!cache.incrementId || cache.totalTasks === undefined) {
+                return null;
+            }
+            // Step 3: Check freshness (0.2-0.5ms)
+            if (!this.isCacheFresh(cache)) {
+                return null;
+            }
+            return cache;
+        }
+        catch (error) {
+            // Cache read/parse error = treat as cache miss
+            return null;
+        }
+    }
+    /**
+     * Check if cache is fresh (0.2-0.5ms)
+     *
+     * Two-level check:
+     * 1. Age check (ultra-fast, no I/O)
+     * 2. mtime check (fast, single stat() call)
+     */
+    isCacheFresh(cache) {
+        // Check 1: Recent update? (no I/O, ultra-fast)
+        const age = Date.now() - new Date(cache.lastUpdate).getTime();
+        if (age < this.config.maxCacheAge) {
+            return true; // Cache is fresh (<5s old)
+        }
+        // Check 2: Has tasks.md changed? (single stat() call)
+        try {
+            const tasksFile = path.join(this.rootDir, '.specweave/increments', cache.incrementId, 'tasks.md');
+            const stats = fs.statSync(tasksFile);
+            const currentMtime = Math.floor(stats.mtimeMs / 1000);
+            return currentMtime === cache.lastModified;
+        }
+        catch {
+            // File missing or stat() failed = invalidate cache
+            return false;
+        }
+    }
+    /**
+     * Format status line from cache (0.1ms)
+     */
+    formatStatusLine(cache) {
+        const parts = [];
+        // Increment name (truncated)
+        const name = this.truncate(cache.incrementName, this.config.maxIncrementNameLength);
+        parts.push(`[${name}]`);
+        // Progress bar
+        if (this.config.showProgressBar) {
+            const bar = this.renderProgressBar(cache.completedTasks, cache.totalTasks);
+            parts.push(bar);
+        }
+        // Tasks count and percentage
+        if (this.config.showPercentage) {
+            parts.push(`${cache.completedTasks}/${cache.totalTasks} (${cache.percentage}%)`);
+        }
+        else {
+            parts.push(`${cache.completedTasks}/${cache.totalTasks}`);
+        }
+        // Current task
+        if (this.config.showCurrentTask && cache.currentTask) {
+            const taskTitle = this.truncate(cache.currentTask.title, this.config.maxTaskTitleLength);
+            parts.push(`• ${cache.currentTask.id}: ${taskTitle}`);
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Render ASCII progress bar (0.05ms)
+     */
+    renderProgressBar(completed, total) {
+        if (total === 0) {
+            return '░'.repeat(this.config.progressBarWidth);
+        }
+        const percentage = completed / total;
+        const filled = Math.floor(percentage * this.config.progressBarWidth);
+        const empty = this.config.progressBarWidth - filled;
+        return '█'.repeat(filled) + '░'.repeat(empty);
+    }
+    /**
+     * Truncate string with ellipsis (0.01ms)
+     */
+    truncate(str, maxLength) {
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.substring(0, maxLength - 1) + '…';
+    }
+    /**
+     * Get raw cache data (for testing/debugging)
+     */
+    getCacheData() {
+        try {
+            if (!fs.existsSync(this.cacheFile)) {
+                return null;
+            }
+            const content = fs.readFileSync(this.cacheFile, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Clear cache (for testing/manual reset)
+     */
+    clearCache() {
+        try {
+            if (fs.existsSync(this.cacheFile)) {
+                fs.unlinkSync(this.cacheFile);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=status-line-manager.js.map

package/dist/core/status-line/status-line-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line-manager.js","sourceRoot":"","sources":["../../../src/core/status-line/status-line-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAGL,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,iBAAiB;IAI5B,YACU,UAAkB,OAAO,CAAC,GAAG,EAAE,EACvC,SAAoC,EAAE;QAD9B,YAAO,GAAP,OAAO,CAAwB;QAGvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,0BAA0B,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,CAAC,qCAAqC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACK,QAAQ;QACd,IAAI,CAAC;YACH,kCAAkC;YAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;YAErD,6CAA6C;YAC7C,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,KAAsB;QACzC,+CAA+C;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,CAAC,2BAA2B;QAC1C,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,OAAO,EACZ,uBAAuB,EACvB,KAAK,CAAC,WAAW,EACjB,UAAU,CACX,CAAC;YAEF,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YAEtD,OAAO,YAAY,KAAK,KAAK,CAAC,YAAY,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAsB;QAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,6BAA6B;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CACxB,KAAK,CAAC,aAAa,EACnB,IAAI,CAAC,MAAM,CAAC,sBAAsB,CACnC,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAExB,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAChC,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,UAAU,CACjB,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAC7B,KAAK,CAAC,WAAW,CAAC,KAAK,EACvB,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAC/B,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,SAAiB,EAAE,KAAa;QACxD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAEpD,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,GAAW,EAAE,SAAiB;QAC7C,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC5B,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACI,UAAU;QACf,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/core/status-line/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Status Line Types
+ *
+ * Type definitions for the fast status line caching system.
+ * Supports <1ms rendering with intelligent cache invalidation.
+ */
+export interface StatusLineCache {
+    /** Active increment ID (e.g., "0017-sync-architecture-fix") */
+    incrementId: string;
+    /** Short increment name (e.g., "sync-architecture-fix") */
+    incrementName: string;
+    /** Total number of tasks in tasks.md */
+    totalTasks: number;
+    /** Number of completed tasks ([x]) */
+    completedTasks: number;
+    /** Completion percentage (0-100) */
+    percentage: number;
+    /** Current task being worked on */
+    currentTask: TaskInfo | null;
+    /** ISO timestamp of last cache update */
+    lastUpdate: string;
+    /** Unix timestamp of tasks.md mtime (for invalidation) */
+    lastModified: number;
+}
+export interface TaskInfo {
+    /** Task ID (e.g., "T-016") */
+    id: string;
+    /** Task title (e.g., "Update documentation") */
+    title: string;
+}
+export interface StatusLineConfig {
+    /** Enable status line rendering */
+    enabled: boolean;
+    /** Maximum age of cache before forcing refresh (ms) */
+    maxCacheAge: number;
+    /** Width of progress bar (characters) */
+    progressBarWidth: number;
+    /** Maximum length for increment name */
+    maxIncrementNameLength: number;
+    /** Maximum length for task title */
+    maxTaskTitleLength: number;
+    /** Show progress bar */
+    showProgressBar: boolean;
+    /** Show percentage */
+    showPercentage: boolean;
+    /** Show current task */
+    showCurrentTask: boolean;
+}
+export declare const DEFAULT_STATUS_LINE_CONFIG: StatusLineConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/status-line/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IAEtB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE7B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IAEjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,sBAAsB,EAAE,MAAM,CAAC;IAE/B,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,wBAAwB;IACxB,eAAe,EAAE,OAAO,CAAC;IAEzB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;IAExB,wBAAwB;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,0BAA0B,EAAE,gBASxC,CAAC"}

package/dist/core/status-line/types.js

@@ -0,0 +1,17 @@
+/**
+ * Status Line Types
+ *
+ * Type definitions for the fast status line caching system.
+ * Supports <1ms rendering with intelligent cache invalidation.
+ */
+export const DEFAULT_STATUS_LINE_CONFIG = {
+    enabled: true,
+    maxCacheAge: 5000, // 5 seconds
+    progressBarWidth: 8,
+    maxIncrementNameLength: 20,
+    maxTaskTitleLength: 30,
+    showProgressBar: true,
+    showPercentage: true,
+    showCurrentTask: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/core/status-line/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8DH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI,EAAE,YAAY;IAC/B,gBAAgB,EAAE,CAAC;IACnB,sBAAsB,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/utils/project-mapper.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Project Mapper - Intelligent User Story to Project Classification
+ *
+ * Analyzes user story content, tech stack mentions, and component architecture
+ * to intelligently map user stories to the correct projects (FE, BE, MOBILE, etc.)
+ *
+ * @module project-mapper
+ */
+export interface ProjectMapping {
+    projectId: string;
+    confidence: number;
+    reasoning: string[];
+}
+export interface UserStory {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    technicalContext?: string;
+}
+export interface ProjectRule {
+    id: string;
+    name: string;
+    keywords: string[];
+    techStack: string[];
+    componentTypes: string[];
+    excludeKeywords?: string[];
+}
+/**
+ * Default project mapping rules
+ * These can be customized via .specweave/config.json
+ */
+export declare const DEFAULT_PROJECT_RULES: ProjectRule[];
+/**
+ * Analyze user story content and map to projects
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules (defaults to DEFAULT_PROJECT_RULES)
+ * @returns Array of project mappings sorted by confidence (highest first)
+ */
+export declare function mapUserStoryToProjects(userStory: UserStory, projectRules?: ProjectRule[]): ProjectMapping[];
+/**
+ * Determine primary project for a user story
+ * (highest confidence mapping)
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules
+ * @returns Primary project mapping or null if no confident match
+ */
+export declare function getPrimaryProject(userStory: UserStory, projectRules?: ProjectRule[]): ProjectMapping | null;
+/**
+ * Split spec into project-specific specs based on user story mappings
+ *
+ * @param userStories Array of user stories
+ * @param projectRules Project mapping rules
+ * @returns Map of projectId → user stories
+ */
+export declare function splitSpecByProject(userStories: UserStory[], projectRules?: ProjectRule[]): Map<string, UserStory[]>;
+/**
+ * Suggest JIRA item type hierarchy based on user story scope
+ *
+ * @param userStory User story to analyze
+ * @returns Suggested JIRA item type (Epic, Story, Task, Subtask)
+ */
+export declare function suggestJiraItemType(userStory: UserStory): 'Epic' | 'Story' | 'Task' | 'Subtask';
+/**
+ * Format project mapping report (for display to user)
+ *
+ * @param userStory User story
+ * @param mappings Project mappings
+ * @returns Formatted markdown report
+ */
+export declare function formatProjectMappingReport(userStory: UserStory, mappings: ProjectMapping[]): string;
+//# sourceMappingURL=project-mapper.d.ts.map

package/dist/utils/project-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mapper.d.ts","sourceRoot":"","sources":["../../src/utils/project-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAwF9C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,WAAW,EAA0B,GAClD,cAAc,EAAE,CAiFlB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,WAAW,EAA0B,GAClD,cAAc,GAAG,IAAI,CAOvB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,EAAE,EACxB,YAAY,GAAE,WAAW,EAA0B,GAClD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAmB1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB/F;AAeD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,cAAc,EAAE,GACzB,MAAM,CA4BR"}

package/dist/utils/project-mapper.js

@@ -0,0 +1,273 @@
+/**
+ * Project Mapper - Intelligent User Story to Project Classification
+ *
+ * Analyzes user story content, tech stack mentions, and component architecture
+ * to intelligently map user stories to the correct projects (FE, BE, MOBILE, etc.)
+ *
+ * @module project-mapper
+ */
+/**
+ * Default project mapping rules
+ * These can be customized via .specweave/config.json
+ */
+export const DEFAULT_PROJECT_RULES = [
+    {
+        id: 'FE',
+        name: 'Frontend (Web)',
+        keywords: [
+            'ui', 'ux', 'web', 'browser', 'chart', 'graph', 'visualization',
+            'dashboard', 'button', 'form', 'input', 'page', 'view', 'screen',
+            'modal', 'dropdown', 'navigation', 'menu', 'search', 'filter',
+            'responsive', 'desktop', 'tablet', 'css', 'styling', 'theme',
+            'dark mode', 'light mode', 'component', 'state management'
+        ],
+        techStack: [
+            'react', 'vue', 'angular', 'next.js', 'gatsby', 'svelte',
+            'typescript', 'javascript', 'html', 'css', 'scss', 'tailwind',
+            'mui', 'material-ui', 'antd', 'chakra', 'redux', 'zustand',
+            'recharts', 'd3', 'chart.js', 'plotly'
+        ],
+        componentTypes: [
+            'component', 'hook', 'context', 'provider', 'hoc', 'page',
+            'layout', 'template', 'widget'
+        ]
+    },
+    {
+        id: 'BE',
+        name: 'Backend (API)',
+        keywords: [
+            'api', 'endpoint', 'rest', 'graphql', 'database', 'query',
+            'migration', 'schema', 'model', 'service', 'controller',
+            'authentication', 'authorization', 'jwt', 'session', 'token',
+            'validation', 'sanitization', 'rate limiting', 'caching',
+            'redis', 'queue', 'job', 'worker', 'webhook', 'integration',
+            'third-party', 'external api', 'data processing', 'batch',
+            'cron', 'scheduler', 'background'
+        ],
+        techStack: [
+            'node.js', 'express', 'fastify', 'nestjs', 'koa',
+            'python', 'fastapi', 'django', 'flask',
+            'java', 'spring boot',
+            '.net', 'asp.net',
+            'go', 'gin',
+            'rust', 'actix',
+            'postgresql', 'mysql', 'mongodb', 'redis',
+            'prisma', 'typeorm', 'sequelize', 'sqlalchemy'
+        ],
+        componentTypes: [
+            'controller', 'service', 'repository', 'middleware',
+            'route', 'handler', 'util', 'helper', 'validator'
+        ]
+    },
+    {
+        id: 'MOBILE',
+        name: 'Mobile (iOS/Android)',
+        keywords: [
+            'mobile', 'ios', 'android', 'app', 'native', 'cross-platform',
+            'push notification', 'offline', 'sync', 'device', 'camera',
+            'gps', 'location', 'gesture', 'touch', 'swipe', 'navigation',
+            'tab bar', 'bottom sheet', 'drawer', 'stack', 'screen transition',
+            'deep linking', 'universal link', 'app store', 'play store'
+        ],
+        techStack: [
+            'react native', 'expo', 'flutter', 'swift', 'swiftui',
+            'kotlin', 'jetpack compose', 'xamarin', 'cordova', 'ionic',
+            'react-navigation', 'react-native-reanimated', 'asyncstorage'
+        ],
+        componentTypes: [
+            'screen', 'navigator', 'modal', 'bottom-sheet', 'drawer'
+        ],
+        excludeKeywords: ['web']
+    },
+    {
+        id: 'INFRA',
+        name: 'Infrastructure',
+        keywords: [
+            'deployment', 'ci/cd', 'docker', 'kubernetes', 'helm',
+            'terraform', 'cloudformation', 'infrastructure', 'devops',
+            'monitoring', 'logging', 'metrics', 'alerting', 'slo', 'sli',
+            'scalability', 'load balancing', 'cdn', 'dns', 'ssl', 'tls',
+            'security', 'firewall', 'vpc', 'network', 'backup', 'disaster recovery'
+        ],
+        techStack: [
+            'aws', 'azure', 'gcp', 'kubernetes', 'docker', 'terraform',
+            'ansible', 'jenkins', 'github actions', 'gitlab ci', 'circleci',
+            'prometheus', 'grafana', 'datadog', 'new relic', 'sentry'
+        ],
+        componentTypes: [
+            'pipeline', 'manifest', 'helm chart', 'terraform module'
+        ]
+    }
+];
+/**
+ * Analyze user story content and map to projects
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules (defaults to DEFAULT_PROJECT_RULES)
+ * @returns Array of project mappings sorted by confidence (highest first)
+ */
+export function mapUserStoryToProjects(userStory, projectRules = DEFAULT_PROJECT_RULES) {
+    const mappings = [];
+    // Combine all user story text for analysis
+    const fullText = [
+        userStory.title,
+        userStory.description,
+        ...userStory.acceptanceCriteria,
+        userStory.technicalContext || ''
+    ].join(' ').toLowerCase();
+    for (const rule of projectRules) {
+        const reasoning = [];
+        let score = 0;
+        let maxScore = 0;
+        // Keyword matching (40% weight)
+        const keywordMatches = rule.keywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
+        const keywordScore = keywordMatches.length * 0.4;
+        score += keywordScore;
+        maxScore += rule.keywords.length * 0.4;
+        if (keywordMatches.length > 0) {
+            reasoning.push(`Keywords: ${keywordMatches.slice(0, 5).join(', ')}`);
+        }
+        // Tech stack matching (40% weight)
+        const techStackMatches = rule.techStack.filter(tech => fullText.includes(tech.toLowerCase()));
+        const techScore = techStackMatches.length * 0.4;
+        score += techScore;
+        maxScore += rule.techStack.length * 0.4;
+        if (techStackMatches.length > 0) {
+            reasoning.push(`Tech stack: ${techStackMatches.slice(0, 5).join(', ')}`);
+        }
+        // Component type matching (20% weight)
+        const componentMatches = rule.componentTypes.filter(component => fullText.includes(component.toLowerCase()));
+        const componentScore = componentMatches.length * 0.2;
+        score += componentScore;
+        maxScore += rule.componentTypes.length * 0.2;
+        if (componentMatches.length > 0) {
+            reasoning.push(`Components: ${componentMatches.slice(0, 3).join(', ')}`);
+        }
+        // Exclude keywords (penalty)
+        if (rule.excludeKeywords) {
+            const excludeMatches = rule.excludeKeywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
+            if (excludeMatches.length > 0) {
+                score *= 0.5; // 50% penalty
+                reasoning.push(`Penalty: ${excludeMatches.join(', ')} (not primary focus)`);
+            }
+        }
+        // Normalize confidence (0.0-1.0)
+        const confidence = maxScore > 0 ? Math.min(score / (maxScore * 0.3), 1.0) : 0;
+        // Only include mappings with confidence > 0.1
+        if (confidence > 0.1) {
+            mappings.push({
+                projectId: rule.id,
+                confidence,
+                reasoning
+            });
+        }
+    }
+    // Sort by confidence (highest first)
+    mappings.sort((a, b) => b.confidence - a.confidence);
+    return mappings;
+}
+/**
+ * Determine primary project for a user story
+ * (highest confidence mapping)
+ *
+ * @param userStory User story to analyze
+ * @param projectRules Project mapping rules
+ * @returns Primary project mapping or null if no confident match
+ */
+export function getPrimaryProject(userStory, projectRules = DEFAULT_PROJECT_RULES) {
+    const mappings = mapUserStoryToProjects(userStory, projectRules);
+    // Require at least 30% confidence for primary project
+    return mappings.length > 0 && mappings[0].confidence >= 0.3
+        ? mappings[0]
+        : null;
+}
+/**
+ * Split spec into project-specific specs based on user story mappings
+ *
+ * @param userStories Array of user stories
+ * @param projectRules Project mapping rules
+ * @returns Map of projectId → user stories
+ */
+export function splitSpecByProject(userStories, projectRules = DEFAULT_PROJECT_RULES) {
+    const projectSpecs = new Map();
+    for (const userStory of userStories) {
+        const primaryProject = getPrimaryProject(userStory, projectRules);
+        if (primaryProject) {
+            const existing = projectSpecs.get(primaryProject.projectId) || [];
+            existing.push(userStory);
+            projectSpecs.set(primaryProject.projectId, existing);
+        }
+        else {
+            // No confident match - assign to "SHARED" or primary project
+            const shared = projectSpecs.get('SHARED') || [];
+            shared.push(userStory);
+            projectSpecs.set('SHARED', shared);
+        }
+    }
+    return projectSpecs;
+}
+/**
+ * Suggest JIRA item type hierarchy based on user story scope
+ *
+ * @param userStory User story to analyze
+ * @returns Suggested JIRA item type (Epic, Story, Task, Subtask)
+ */
+export function suggestJiraItemType(userStory) {
+    const storyPoints = estimateStoryPoints(userStory);
+    // Epic: > 13 story points (large feature area)
+    if (storyPoints > 13) {
+        return 'Epic';
+    }
+    // Story: 3-13 story points (standard user story)
+    if (storyPoints >= 3) {
+        return 'Story';
+    }
+    // Task: 1-2 story points (small implementation task)
+    if (storyPoints >= 1) {
+        return 'Task';
+    }
+    // Subtask: < 1 story point (granular work)
+    return 'Subtask';
+}
+/**
+ * Estimate story points based on acceptance criteria count and complexity
+ *
+ * @param userStory User story to estimate
+ * @returns Estimated story points (1-21)
+ */
+function estimateStoryPoints(userStory) {
+    const acCount = userStory.acceptanceCriteria.length;
+    // Simple heuristic: 1 AC ≈ 1 story point, max 21
+    return Math.min(acCount, 21);
+}
+/**
+ * Format project mapping report (for display to user)
+ *
+ * @param userStory User story
+ * @param mappings Project mappings
+ * @returns Formatted markdown report
+ */
+export function formatProjectMappingReport(userStory, mappings) {
+    const lines = [];
+    lines.push(`## ${userStory.id}: ${userStory.title}`);
+    lines.push('');
+    if (mappings.length === 0) {
+        lines.push('❌ **No project match** (assign to SHARED)');
+        return lines.join('\n');
+    }
+    lines.push(`✅ **Primary Project**: ${mappings[0].projectId} (${(mappings[0].confidence * 100).toFixed(0)}% confidence)`);
+    lines.push('');
+    lines.push('**Reasoning**:');
+    for (const reason of mappings[0].reasoning) {
+        lines.push(`- ${reason}`);
+    }
+    if (mappings.length > 1) {
+        lines.push('');
+        lines.push('**Secondary Matches**:');
+        for (const mapping of mappings.slice(1, 3)) {
+            lines.push(`- ${mapping.projectId} (${(mapping.confidence * 100).toFixed(0)}%)`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=project-mapper.js.map