@planu/cli 0.90.2 → 0.92.0

package/dist/engine/spec-exporter.js

@@ -0,0 +1,122 @@
+// engine/spec-exporter.ts — Pure functions for exporting specs to CSV/Markdown — SPEC-298
+// ---------------------------------------------------------------------------
+// Column definitions
+// ---------------------------------------------------------------------------
+export const ALL_COLUMNS = [
+    'id',
+    'title',
+    'status',
+    'type',
+    'scope',
+    'difficulty',
+    'risk',
+    'target',
+    'tags',
+    'createdAt',
+    'updatedAt',
+    'devHours',
+    'totalCostUsd',
+    'estimatedModel',
+];
+// ---------------------------------------------------------------------------
+// Value extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the string value for a given column from a spec.
+ */
+export function extractColumnValue(spec, column) {
+    switch (column) {
+        case 'id':
+            return spec.id;
+        case 'title':
+            return spec.title;
+        case 'status':
+            return spec.status;
+        case 'type':
+            return spec.type;
+        case 'scope':
+            return spec.scope;
+        case 'difficulty':
+            return String(spec.difficulty);
+        case 'risk':
+            return spec.risk;
+        case 'target':
+            return spec.target;
+        case 'tags':
+            return spec.tags.join(';');
+        case 'createdAt':
+            return spec.createdAt;
+        case 'updatedAt':
+            return spec.updatedAt;
+        case 'devHours':
+            return spec.estimation.devHours.toString();
+        case 'totalCostUsd':
+            return spec.estimation.totalCostUsd.toString();
+        case 'estimatedModel':
+            return spec.estimation.recommendedModel;
+    }
+}
+// ---------------------------------------------------------------------------
+// CSV helpers (RFC 4180)
+// ---------------------------------------------------------------------------
+/**
+ * Escape a CSV field value per RFC 4180.
+ * If the value contains a comma, newline, or double-quote, wrap in quotes
+ * and double any internal quotes.
+ */
+export function escapeCsv(value) {
+    if (value.includes(',') || value.includes('\n') || value.includes('"')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+/**
+ * Serialize specs to CSV format.
+ * First row is the header, subsequent rows are data.
+ */
+export function specsToCsv(specs, columns) {
+    const header = columns.map((c) => escapeCsv(c)).join(',');
+    const rows = specs.map((spec) => columns.map((col) => escapeCsv(extractColumnValue(spec, col))).join(','));
+    return [header, ...rows].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Markdown table helpers
+// ---------------------------------------------------------------------------
+/**
+ * Serialize specs to a Markdown table format.
+ */
+export function specsToMarkdownTable(specs, columns) {
+    const escapeCell = (value) => value.replace(/\|/g, '\\|');
+    const header = `| ${columns.map((c) => escapeCell(c)).join(' | ')} |`;
+    const separator = `| ${columns.map(() => '---').join(' | ')} |`;
+    const rows = specs.map((spec) => `| ${columns.map((col) => escapeCell(extractColumnValue(spec, col))).join(' | ')} |`);
+    return [header, separator, ...rows].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Filtering
+// ---------------------------------------------------------------------------
+/**
+ * Filter specs by status, type, and tags from ExportInput.
+ */
+export function filterSpecs(specs, input) {
+    return specs.filter((spec) => {
+        if (input.status && input.status.length > 0) {
+            if (!input.status.includes(spec.status)) {
+                return false;
+            }
+        }
+        if (input.type && input.type.length > 0) {
+            if (!input.type.includes(spec.type)) {
+                return false;
+            }
+        }
+        if (input.tags && input.tags.length > 0) {
+            const hasTag = input.tags.some((tag) => spec.tags.includes(tag));
+            if (!hasTag) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=spec-exporter.js.map

package/dist/engine/spec-exporter.js.map

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

package/dist/engine/spec-searcher.d.ts

@@ -0,0 +1,31 @@
+import type { Spec } from '../types/index.js';
+import type { SearchInput, SearchResponse, SuggestionInput, SuggestionResponse } from '../types/search.js';
+/**
+ * Returns a score 0-1 for how well `query` matches `text`.
+ * Exact substring → 1.0. Subsequence match → query.length / text.length.
+ * No match → 0.
+ */
+export declare function fuzzyMatch(text: string, query: string): number;
+/**
+ * Returns true if spec matches ALL provided filters.
+ * Within each array filter, any match is sufficient (OR logic).
+ * Across filters, all must match (AND logic).
+ */
+export declare function matchesFilters(spec: Spec, input: SearchInput): boolean;
+/**
+ * Computes a relevance score [0-1] for a spec against a query.
+ * Higher weight given to: exact id match, then title, then tags.
+ */
+export declare function computeMatchScore(spec: Spec, query: string): {
+    score: number;
+    matchedFields: string[];
+};
+/**
+ * Filter, score, sort, and paginate specs according to SearchInput.
+ */
+export declare function searchSpecs(specs: Spec[], input: SearchInput): SearchResponse;
+/**
+ * Returns unique field values from all specs that partially match the query.
+ */
+export declare function getSuggestions(specs: Spec[], input: SuggestionInput): SuggestionResponse;
+//# sourceMappingURL=spec-searcher.d.ts.map

package/dist/engine/spec-searcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-searcher.d.ts","sourceRoot":"","sources":["../../src/engine/spec-searcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAEd,eAAe,EACf,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAM5B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B9D;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CA8DtE;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC5C;AAmCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CA4C7E;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,eAAe,GAAG,kBAAkB,CA8BxF"}

package/dist/engine/spec-searcher.js

@@ -0,0 +1,240 @@
+// engine/spec-searcher.ts — Pure search engine for specs (SPEC-295)
+// Fuzzy matching, multi-field filtering, scoring, sorting, pagination.
+// ---------------------------------------------------------------------------
+// Fuzzy matching
+// ---------------------------------------------------------------------------
+/**
+ * Returns a score 0-1 for how well `query` matches `text`.
+ * Exact substring → 1.0. Subsequence match → query.length / text.length.
+ * No match → 0.
+ */
+export function fuzzyMatch(text, query) {
+    if (query.length === 0) {
+        return 1;
+    }
+    if (text.length === 0) {
+        return 0;
+    }
+    const lowerText = text.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    // Exact substring match
+    if (lowerText.includes(lowerQuery)) {
+        return 1;
+    }
+    // Subsequence match: all query chars appear in order in text
+    let qi = 0;
+    for (let ti = 0; ti < lowerText.length && qi < lowerQuery.length; ti++) {
+        if (lowerText[ti] === lowerQuery[qi]) {
+            qi++;
+        }
+    }
+    if (qi < lowerQuery.length) {
+        return 0;
+    } // not a subsequence
+    return lowerQuery.length / lowerText.length;
+}
+// ---------------------------------------------------------------------------
+// Filter matching
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if spec matches ALL provided filters.
+ * Within each array filter, any match is sufficient (OR logic).
+ * Across filters, all must match (AND logic).
+ */
+export function matchesFilters(spec, input) {
+    // status filter
+    if (input.status && input.status.length > 0) {
+        if (!input.status.includes(spec.status)) {
+            return false;
+        }
+    }
+    // type filter
+    if (input.type && input.type.length > 0) {
+        if (!input.type.includes(spec.type)) {
+            return false;
+        }
+    }
+    // target filter
+    if (input.target && input.target.length > 0) {
+        if (!input.target.includes(spec.target)) {
+            return false;
+        }
+    }
+    // risk filter
+    if (input.risk && input.risk.length > 0) {
+        if (!input.risk.includes(spec.risk)) {
+            return false;
+        }
+    }
+    // tags filter — spec must have at least one matching tag
+    if (input.tags && input.tags.length > 0) {
+        const hasTag = input.tags.some((tag) => spec.tags.includes(tag));
+        if (!hasTag) {
+            return false;
+        }
+    }
+    // difficulty range filter
+    if (input.difficulty) {
+        if (input.difficulty.min !== undefined && spec.difficulty < input.difficulty.min) {
+            return false;
+        }
+        if (input.difficulty.max !== undefined && spec.difficulty > input.difficulty.max) {
+            return false;
+        }
+    }
+    // date filters
+    if (input.createdAfter && spec.createdAt < input.createdAfter) {
+        return false;
+    }
+    if (input.createdBefore && spec.createdAt > input.createdBefore) {
+        return false;
+    }
+    if (input.updatedAfter && spec.updatedAt < input.updatedAfter) {
+        return false;
+    }
+    if (input.updatedBefore && spec.updatedAt > input.updatedBefore) {
+        return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Match scoring
+// ---------------------------------------------------------------------------
+/**
+ * Computes a relevance score [0-1] for a spec against a query.
+ * Higher weight given to: exact id match, then title, then tags.
+ */
+export function computeMatchScore(spec, query) {
+    if (!query || query.trim().length === 0) {
+        return { score: 1, matchedFields: [] };
+    }
+    const matchedFields = [];
+    let score = 0;
+    // Exact ID match → highest score
+    if (spec.id.toLowerCase() === query.toLowerCase()) {
+        return { score: 1.0, matchedFields: ['id'] };
+    }
+    // Title fuzzy match
+    const titleScore = fuzzyMatch(spec.title, query);
+    if (titleScore > 0) {
+        matchedFields.push('title');
+        score = Math.max(score, titleScore * 0.9);
+    }
+    // Tags fuzzy match
+    for (const tag of spec.tags) {
+        const tagScore = fuzzyMatch(tag, query);
+        if (tagScore > 0) {
+            if (!matchedFields.includes('tags')) {
+                matchedFields.push('tags');
+            }
+            score = Math.max(score, tagScore * 0.7);
+        }
+    }
+    // ID partial match (starts with or contains)
+    const idScore = fuzzyMatch(spec.id, query);
+    if (idScore > 0) {
+        if (!matchedFields.includes('id')) {
+            matchedFields.push('id');
+        }
+        score = Math.max(score, idScore * 0.8);
+    }
+    return { score, matchedFields };
+}
+// ---------------------------------------------------------------------------
+// Comparators for sorting
+// ---------------------------------------------------------------------------
+function compareSpecs(a, b, sortBy, sortOrder) {
+    const direction = sortOrder === 'desc' ? -1 : 1;
+    if (sortBy === 'relevance' || !sortBy) {
+        // Higher score first (desc by default for relevance)
+        return (b.score - a.score) * direction;
+    }
+    if (sortBy === 'createdAt') {
+        return a.spec.createdAt.localeCompare(b.spec.createdAt) * direction;
+    }
+    if (sortBy === 'updatedAt') {
+        return a.spec.updatedAt.localeCompare(b.spec.updatedAt) * direction;
+    }
+    // sortBy === 'difficulty'
+    return (a.spec.difficulty - b.spec.difficulty) * direction;
+}
+// ---------------------------------------------------------------------------
+// Main search function
+// ---------------------------------------------------------------------------
+/**
+ * Filter, score, sort, and paginate specs according to SearchInput.
+ */
+export function searchSpecs(specs, input) {
+    const limit = Math.min(Math.max(input.limit ?? 20, 1), 100);
+    const offset = Math.max(input.offset ?? 0, 0);
+    // Score and filter
+    const scored = [];
+    for (const spec of specs) {
+        if (!matchesFilters(spec, input)) {
+            continue;
+        }
+        const { score, matchedFields } = computeMatchScore(spec, input.query ?? '');
+        if (input.query && input.query.trim().length > 0 && score === 0) {
+            continue;
+        }
+        scored.push({ spec, score, matchedFields });
+    }
+    // Sort
+    const sortBy = input.sortBy ?? (input.query ? 'relevance' : 'updatedAt');
+    const sortOrder = input.sortOrder ?? (sortBy === 'relevance' ? 'desc' : 'asc');
+    scored.sort((a, b) => compareSpecs(a, b, sortBy, sortOrder));
+    const total = scored.length;
+    const paginated = scored.slice(offset, offset + limit);
+    const items = paginated.map(({ spec, score, matchedFields }) => ({
+        specId: spec.id,
+        title: spec.title,
+        status: spec.status,
+        type: spec.type,
+        tags: spec.tags,
+        matchScore: score,
+        matchedFields,
+    }));
+    return {
+        total,
+        hasMore: offset + limit < total,
+        items,
+    };
+}
+// ---------------------------------------------------------------------------
+// Suggestions
+// ---------------------------------------------------------------------------
+/**
+ * Returns unique field values from all specs that partially match the query.
+ */
+export function getSuggestions(specs, input) {
+    const { query, field = 'tags' } = input;
+    const lowerQuery = query.toLowerCase();
+    const values = new Set();
+    for (const spec of specs) {
+        if (field === 'tags') {
+            for (const tag of spec.tags) {
+                if (tag.toLowerCase().includes(lowerQuery)) {
+                    values.add(tag);
+                }
+            }
+        }
+        else if (field === 'type') {
+            if (spec.type.toLowerCase().includes(lowerQuery)) {
+                values.add(spec.type);
+            }
+        }
+        else if (field === 'status') {
+            if (spec.status.toLowerCase().includes(lowerQuery)) {
+                values.add(spec.status);
+            }
+        }
+        else {
+            // field === 'id'
+            if (spec.id.toLowerCase().includes(lowerQuery)) {
+                values.add(spec.id);
+            }
+        }
+    }
+    return { suggestions: Array.from(values).sort() };
+}
+//# sourceMappingURL=spec-searcher.js.map

package/dist/engine/spec-searcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-searcher.js","sourceRoot":"","sources":["../../src/engine/spec-searcher.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,uEAAuE;AAWvE,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,wBAAwB;IACxB,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,6DAA6D;IAC7D,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QACvE,IAAI,SAAS,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,EAAE,EAAE,CAAC;QACP,CAAC;IACH,CAAC;IAED,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,oBAAoB;IACtB,OAAO,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,KAAkB;IAC3D,gBAAgB;IAChB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,cAAc;IACd,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,cAAc;IACd,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAU,EACV,KAAa;IAEb,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,iCAAiC;IACjC,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,oBAAoB;IACpB,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,SAAS,YAAY,CACnB,CAAgC,EAChC,CAAgC,EAChC,MAA6B,EAC7B,SAAmC;IAEnC,MAAM,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,IAAI,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,qDAAqD;QACrD,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACtE,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAkB;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C,mBAAmB;IACnB,MAAM,MAAM,GAA6D,EAAE,CAAC;IAE5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5E,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChE,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;IACP,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE/E,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAmB,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,KAAK;QACjB,aAAa;KACd,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,KAAK;QACL,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK;QAC/B,KAAK;KACN,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAsB;IAClE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACpD,CAAC"}

package/dist/engine/spec-splitter.d.ts

@@ -1,4 +1,4 @@
-import type { SpecSplitSuggestion, SplitAnalysisInput, ExperienceLevel } from '../types/index.js';
+import type { SpecSplitSuggestion, SplitAnalysisInput, ExperienceLevel, SpecSizeAnalysis, SplitProposal, Spec } from '../types/index.js';
 /**
  * Analyze a spec and determine if it should be split into smaller specs.
  * Returns null if the spec is appropriately sized.
@@ -12,4 +12,14 @@ export declare function detectOversizedSpec(criteriaCount: number, moduleCount:
  * Format split suggestion for display based on experience level.
  */
 export declare function formatSplitSuggestion(suggestion: SpecSplitSuggestion, level: ExperienceLevel): string;
+/**
+ * Analyzes a spec to determine if it should be split.
+ * Returns a SpecSizeAnalysis with reasons and suggested splits.
+ */
+export declare function analyzeSpecSize(spec: Spec): SpecSizeAnalysis;
+/**
+ * Executes the split of a spec into child specs.
+ * Returns the list of child spec objects to be persisted by the caller.
+ */
+export declare function buildChildSpecs(original: Spec, proposals: SplitProposal[], nextIdFn: (index: number) => string): Spec[];
 //# sourceMappingURL=spec-splitter.d.ts.map

package/dist/engine/spec-splitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-splitter.d.ts","sourceRoot":"","sources":["../../src/engine/spec-splitter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAElB,eAAe,EAIhB,MAAM,mBAAmB,CAAC;AAW3B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,GACb,mBAAmB,GAAG,IAAI,CA4B5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,eAAe,GACrB,MAAM,CAKR"}
+{"version":3,"file":"spec-splitter.d.ts","sourceRoot":"","sources":["../../src/engine/spec-splitter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAElB,eAAe,EAIf,gBAAgB,EAChB,aAAa,EACb,IAAI,EACL,MAAM,mBAAmB,CAAC;AAW3B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,GACb,mBAAmB,GAAG,IAAI,CA4B5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,eAAe,GACrB,MAAM,CAKR;AAmND;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAsD5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAClC,IAAI,EAAE,CAwDR"}

package/dist/engine/spec-splitter.js

@@ -198,4 +198,182 @@ function formatForExpert(suggestion) {
     lines.push('```');
     return lines.join('\n');
 }
+// === SPEC-289: analyze_spec_size and executeSplit ===
+/** Words that signal subsystem boundaries in a description */
+const SUBSYSTEM_SIGNAL_WORDS = [
+    'and',
+    'also',
+    'additionally',
+    'furthermore',
+    'as well as',
+    'plus',
+    'moreover',
+];
+/** Vague words in ACs that indicate ambiguous criteria */
+const VAGUE_WORDS = ['should handle', 'properly', 'efficiently', 'correctly', 'appropriately'];
+/** Threshold: >15 ACs triggers split suggestion */
+const AC_SPLIT_THRESHOLD = 15;
+/** Threshold: >40h estimation triggers split suggestion */
+const HOURS_SPLIT_THRESHOLD = 40;
+/** Threshold: >3 subsystem signals triggers split suggestion */
+const SUBSYSTEM_SPLIT_THRESHOLD = 3;
+/**
+ * Analyzes a spec to determine if it should be split.
+ * Returns a SpecSizeAnalysis with reasons and suggested splits.
+ */
+export function analyzeSpecSize(spec) {
+    const criteria = extractCriteria(spec);
+    const criteriaCount = criteria.length;
+    const estimatedHours = spec.estimation.devHours;
+    const reasons = [];
+    const ambiguousCriteria = [];
+    // Check AC count threshold
+    if (criteriaCount > AC_SPLIT_THRESHOLD) {
+        reasons.push(`${String(criteriaCount)} acceptance criteria exceed the threshold of ${String(AC_SPLIT_THRESHOLD)}`);
+    }
+    // Check estimation threshold
+    if (estimatedHours > HOURS_SPLIT_THRESHOLD) {
+        reasons.push(`${String(estimatedHours)}h estimated exceeds the threshold of ${String(HOURS_SPLIT_THRESHOLD)}h`);
+    }
+    // Check subsystem count using description
+    const subsystemCount = countSubsystemSignals(spec.title + ' ' + spec.specPath);
+    if (subsystemCount > SUBSYSTEM_SPLIT_THRESHOLD) {
+        reasons.push(`${String(subsystemCount)} subsystem signals detected (e.g. "and", "also", "additionally")`);
+    }
+    // Detect ambiguous criteria
+    for (const criterion of criteria) {
+        const lower = criterion.toLowerCase();
+        for (const vague of VAGUE_WORDS) {
+            if (lower.includes(vague)) {
+                ambiguousCriteria.push(criterion);
+                break;
+            }
+        }
+    }
+    const shouldSplit = reasons.length > 0;
+    const suggestedSplits = shouldSplit ? buildSplitProposals(criteria, spec.target, spec.scope) : [];
+    return {
+        specId: spec.id,
+        specTitle: spec.title,
+        shouldSplit,
+        reasons,
+        suggestedSplits,
+        criteriaCount,
+        estimatedHours,
+        ambiguousCriteria,
+    };
+}
+/**
+ * Executes the split of a spec into child specs.
+ * Returns the list of child spec objects to be persisted by the caller.
+ */
+export function buildChildSpecs(original, proposals, nextIdFn) {
+    const now = new Date().toISOString();
+    const criteria = extractCriteria(original);
+    return proposals.map((proposal, i) => {
+        const childId = nextIdFn(i);
+        const childSlug = slugifyTitle(proposal.title);
+        const difficulty = inferDifficulty(original.type, original.scope);
+        const estimation = calculateEstimation(original.type, original.scope, difficulty);
+        const childSpec = {
+            id: childId,
+            title: proposal.title,
+            slug: childSlug,
+            feature: original.feature,
+            type: original.type,
+            scope: 'feature',
+            status: 'draft',
+            difficulty,
+            risk: original.risk,
+            projectId: original.projectId,
+            createdAt: now,
+            updatedAt: now,
+            specPath: original.specPath.replace(/\/[^/]+\/spec\.md$/, `/${childId}-${childSlug}/spec.md`),
+            technicalPath: original.technicalPath.replace(/\/[^/]+\/technical\.md$/, `/${childId}-${childSlug}/technical.md`),
+            progressPath: original.progressPath?.replace(/\/[^/]+\/progress\.md$/, `/${childId}-${childSlug}/progress.md`),
+            estimation,
+            actuals: null,
+            target: original.target,
+            tags: [...original.tags],
+            dependencies: proposal.dependsOn.map((idx) => nextIdFn(idx)),
+            blockedBy: [],
+            gitBranch: `feat/${childId.toLowerCase()}-${childSlug}`,
+            impactAnalysis: null,
+            reviewNotes: [`Split from ${original.id}: ${original.title}`],
+        };
+        // Attach the relevant criteria as review notes for context
+        const assignedCriteria = proposal.criteriaIndices
+            .map((idx) => criteria[idx])
+            .filter((c) => c !== undefined);
+        if (assignedCriteria.length > 0) {
+            childSpec.reviewNotes = [
+                ...(childSpec.reviewNotes ?? []),
+                `Assigned criteria: ${assignedCriteria.join('; ')}`,
+            ];
+        }
+        return childSpec;
+    });
+}
+// === Internal helpers ===
+/** Extract acceptance criteria lines from spec path or title (simple heuristic) */
+function extractCriteria(spec) {
+    // We cannot read the file in a pure engine function — use reviewNotes or title
+    // as proxy for criteria count. The handler reads the actual file content.
+    // This overload is used when the caller passes pre-extracted criteria.
+    return spec.reviewNotes ?? [];
+}
+/** Count subsystem signal word occurrences in a text */
+function countSubsystemSignals(text) {
+    const lower = text.toLowerCase();
+    let count = 0;
+    for (const word of SUBSYSTEM_SIGNAL_WORDS) {
+        const regex = new RegExp(`\\b${word}\\b`, 'g');
+        const matches = lower.match(regex);
+        if (matches) {
+            count += matches.length;
+        }
+    }
+    return count;
+}
+/** Build split proposals from criteria list */
+function buildSplitProposals(criteria, target, scope) {
+    if (criteria.length === 0) {
+        return buildDefaultProposals(target, scope);
+    }
+    const half = Math.ceil(criteria.length / 2);
+    const firstIndices = criteria.slice(0, half).map((_, i) => i);
+    const secondIndices = criteria.slice(half).map((_, i) => half + i);
+    return [
+        {
+            title: `Core Implementation`,
+            description: 'Core features and primary acceptance criteria',
+            criteriaIndices: firstIndices,
+            dependsOn: [],
+        },
+        {
+            title: `Extended Features and Validation`,
+            description: 'Extended features, edge cases and validation criteria',
+            criteriaIndices: secondIndices,
+            dependsOn: [0],
+        },
+    ];
+}
+/** Fallback proposals when no criteria are available */
+function buildDefaultProposals(target, scope) {
+    const targets = inferTargets(target, scope);
+    return targets.map((t, i) => ({
+        title: t.label,
+        description: `${t.label} portion of the original spec`,
+        criteriaIndices: [],
+        dependsOn: i > 0 ? [i - 1] : [],
+    }));
+}
+/** Simple slugify for child spec titles */
+function slugifyTitle(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 60);
+}
 //# sourceMappingURL=spec-splitter.js.map