@planu/cli 0.91.0 → 0.92.0

package/dist/engine/reverse-engineer/test-file-parser.js

@@ -0,0 +1,165 @@
+// engine/reverse-engineer/test-file-parser.ts — Parse test files into spec ACs (SPEC-299)
+import { readFile } from 'node:fs/promises';
+import * as nodePath from 'node:path';
+/**
+ * Detect the test framework from file content.
+ */
+export function detectFramework(content) {
+    const hasPlaywriterImport = content.toLowerCase().includes('playwright');
+    const hasTestDescribe = content.includes('test.describe');
+    const hasPlaywright = hasPlaywriterImport || hasTestDescribe;
+    if (hasPlaywright) {
+        return 'playwright';
+    }
+    const hasCyDot = content.includes('cy.');
+    const hasCypress = hasCyDot;
+    if (hasCypress) {
+        return 'cypress';
+    }
+    const hasDescribe = /describe\s*\(/.test(content);
+    const hasItOrTest = /(?:it|test)\s*\(/.test(content);
+    // hasCyDot and hasPlaywriterImport are already false here (early returns above)
+    const hasJest = hasDescribe && hasItOrTest;
+    if (hasJest) {
+        return 'jest';
+    }
+    return 'unknown';
+}
+/**
+ * Clean an AC text from a test description:
+ * - Remove leading "should " (case-insensitive)
+ * - Remove leading "it "
+ * - Capitalize first letter
+ * - Trim whitespace
+ */
+export function cleanAcText(description) {
+    let text = description.trim();
+    text = text.replace(/^should\s+/i, '');
+    text = text.replace(/^it\s+/i, '');
+    text = text.trim();
+    if (text.length > 0) {
+        text = text.charAt(0).toUpperCase() + text.slice(1);
+    }
+    return text;
+}
+/**
+ * Suggest a spec title from an array of describe group names.
+ */
+export function suggestTitle(groups) {
+    if (groups.length === 0) {
+        return 'Untitled Spec';
+    }
+    const unique = [...new Set(groups)];
+    if (unique.length >= 2) {
+        return `${unique[0]} - ${unique[1]}`;
+    }
+    return unique[0] ?? 'Untitled Spec';
+}
+/**
+ * Suggest tags from the file path and detected framework.
+ */
+export function suggestTags(filePath, framework) {
+    const tags = [];
+    const lower = filePath.toLowerCase();
+    if (lower.includes('e2e')) {
+        tags.push('e2e');
+    }
+    if (lower.includes('integration')) {
+        tags.push('integration');
+    }
+    if (lower.includes('unit')) {
+        tags.push('unit');
+    }
+    if (framework !== 'unknown') {
+        tags.push(framework);
+    }
+    if (lower.includes('auth') || lower.includes('login')) {
+        tags.push('authentication');
+    }
+    if (lower.includes('checkout') || lower.includes('payment')) {
+        tags.push('payments');
+    }
+    return [...new Set(tags)];
+}
+/**
+ * Associate each test with the nearest preceding describe block using line numbers.
+ */
+function buildGroupLineMap(content) {
+    const lines = content.split('\n');
+    const result = [];
+    const groupRegex = /describe\s*\(\s*['"`]([^'"`]+)['"`]/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line !== undefined) {
+            const m = groupRegex.exec(line);
+            if (m?.[1] !== undefined) {
+                result.push({ lineNumber: i, groupName: m[1] });
+            }
+        }
+    }
+    return result;
+}
+function findGroupForLine(lineNumber, groupMap) {
+    let best = 'General';
+    for (const entry of groupMap) {
+        if (entry.lineNumber <= lineNumber) {
+            best = entry.groupName;
+        }
+    }
+    return best;
+}
+function extractTestFileMatches(content) {
+    const lines = content.split('\n');
+    const results = [];
+    const activeRegex = /(?:^|[^\w])(?:it|test)\s*\(\s*(['"`])([^'"`]+)\1/;
+    const skippedRegex = /(?:^|[^\w])(?:it|test)\.skip\s*\(\s*(['"`])([^'"`]+)\1/;
+    const xRegex = /(?:^|[^\w])(?:xit|xtest)\s*\(\s*(['"`])([^'"`]+)\1/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined) {
+            continue;
+        }
+        const skippedMatch = skippedRegex.exec(line);
+        if (skippedMatch?.[2] !== undefined) {
+            results.push({ lineNumber: i, description: skippedMatch[2], skipped: true });
+            continue;
+        }
+        const xMatch = xRegex.exec(line);
+        if (xMatch?.[2] !== undefined) {
+            results.push({ lineNumber: i, description: xMatch[2], skipped: true });
+            continue;
+        }
+        const activeMatch = activeRegex.exec(line);
+        if (activeMatch?.[2] !== undefined) {
+            results.push({ lineNumber: i, description: activeMatch[2], skipped: false });
+        }
+    }
+    return results;
+}
+/**
+ * Parse a test file and extract acceptance criteria.
+ */
+export async function parseTestFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    const framework = detectFramework(content);
+    const groupMap = buildGroupLineMap(content);
+    const testMatches = extractTestFileMatches(content);
+    const generatedAcs = testMatches.map((match) => ({
+        text: cleanAcText(match.description),
+        group: findGroupForLine(match.lineNumber, groupMap),
+        skipped: match.skipped,
+    }));
+    const skipCount = generatedAcs.filter((ac) => ac.skipped).length;
+    const groupNames = [...new Set(groupMap.map((g) => g.groupName))];
+    const suggestedTitleValue = suggestTitle(groupNames);
+    const suggestedTagsValue = suggestTags(nodePath.normalize(filePath), framework);
+    return {
+        detectedFramework: framework,
+        totalTests: generatedAcs.length,
+        skipCount,
+        generatedAcs,
+        suggestedTitle: suggestedTitleValue,
+        suggestedTags: suggestedTagsValue,
+    };
+}
+//# sourceMappingURL=test-file-parser.js.map

package/dist/engine/reverse-engineer/test-file-parser.js.map

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

package/dist/engine/slack-dispatcher.d.ts

@@ -0,0 +1,15 @@
+import type { SlackPayload } from '../types/index.js';
+/**
+ * Build a rich Block Kit payload for a spec status change notification.
+ */
+export declare function buildSpecPayload(specId: string, title: string, oldStatus: string, newStatus: string): SlackPayload;
+/**
+ * Build a plain or spec-linked manual message payload.
+ */
+export declare function buildManualPayload(message: string, specId?: string): SlackPayload;
+/**
+ * POST a Slack payload to an incoming webhook URL.
+ * Throws if the HTTP response is not OK (2xx).
+ */
+export declare function dispatchToSlack(webhookUrl: string, payload: SlackPayload): Promise<void>;
+//# sourceMappingURL=slack-dispatcher.d.ts.map

package/dist/engine/slack-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-dispatcher.d.ts","sourceRoot":"","sources":["../../src/engine/slack-dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AAMlE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,YAAY,CAgCd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAejF;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9F"}

package/dist/engine/slack-dispatcher.js

@@ -0,0 +1,73 @@
+// ---------------------------------------------------------------------------
+// Payload builders
+// ---------------------------------------------------------------------------
+/**
+ * Build a rich Block Kit payload for a spec status change notification.
+ */
+export function buildSpecPayload(specId, title, oldStatus, newStatus) {
+    const fallbackText = `:white_check_mark: ${specId} status changed: ${oldStatus} → ${newStatus}`;
+    const blocks = [
+        {
+            type: 'header',
+            text: {
+                type: 'plain_text',
+                text: `:white_check_mark: ${specId} status changed`,
+                emoji: true,
+            },
+        },
+        {
+            type: 'section',
+            fields: [
+                {
+                    type: 'mrkdwn',
+                    text: `*Spec ID*\n${specId}`,
+                },
+                {
+                    type: 'mrkdwn',
+                    text: `*Title*\n${title}`,
+                },
+                {
+                    type: 'mrkdwn',
+                    text: `*Status*\n${oldStatus} → ${newStatus}`,
+                },
+            ],
+        },
+    ];
+    return { text: fallbackText, blocks };
+}
+/**
+ * Build a plain or spec-linked manual message payload.
+ */
+export function buildManualPayload(message, specId) {
+    const prefix = specId !== undefined ? `[${specId}] ` : '';
+    const text = `${prefix}${message}`;
+    const blocks = [
+        {
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text,
+            },
+        },
+    ];
+    return { text, blocks };
+}
+// ---------------------------------------------------------------------------
+// HTTP dispatcher
+// ---------------------------------------------------------------------------
+/**
+ * POST a Slack payload to an incoming webhook URL.
+ * Throws if the HTTP response is not OK (2xx).
+ */
+export async function dispatchToSlack(webhookUrl, payload) {
+    const response = await globalThis.fetch(webhookUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => '(unreadable)');
+        throw new Error(`Slack webhook returned ${response.status}: ${body}. Check the webhook URL and try again.`);
+    }
+}
+//# sourceMappingURL=slack-dispatcher.js.map

package/dist/engine/slack-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-dispatcher.js","sourceRoot":"","sources":["../../src/engine/slack-dispatcher.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,SAAiB;IAEjB,MAAM,YAAY,GAAG,sBAAsB,MAAM,oBAAoB,SAAS,MAAM,SAAS,EAAE,CAAC;IAEhG,MAAM,MAAM,GAAiB;QAC3B;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,sBAAsB,MAAM,iBAAiB;gBACnD,KAAK,EAAE,IAAI;aACZ;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,cAAc,MAAM,EAAE;iBAC7B;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,YAAY,KAAK,EAAE;iBAC1B;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,aAAa,SAAS,MAAM,SAAS,EAAE;iBAC9C;aACF;SACF;KACF,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAe;IACjE,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAiB;QAC3B;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI;aACL;SACF;KACF,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,OAAqB;IAC7E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE;QAClD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,0BAA0B,QAAQ,CAAC,MAAM,KAAK,IAAI,wCAAwC,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { SpecVersionDiff, VersionSummary, ComputeDiffOptions } from '../types/index.js';
+/** Format a SpecVersionDiff as a human-readable +/- text block. */
+export declare function formatDiffAsText(diff: SpecVersionDiff): string;
+/**
+ * Compute a diff between two version tags of a spec.
+ * If toVersion is omitted, uses the latest version.
+ * If both fromVersion and toVersion are omitted, compares latest vs penultimate.
+ */
+export declare function computeSpecVersionDiff(opts: ComputeDiffOptions): Promise<SpecVersionDiff>;
+/**
+ * List all version snapshots for a spec as VersionSummary objects.
+ * Returns them in reverse chronological order (newest first).
+ */
+export declare function listSpecVersionHistory(dataDir: string, specId: string, limit?: number): Promise<VersionSummary[]>;
+//# sourceMappingURL=spec-differ.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-differ.d.ts","sourceRoot":"","sources":["../../src/engine/spec-differ.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQ7F,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAiC9D;AAqBD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,eAAe,CAAC,CA2B1B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,SAAK,GACT,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B"}

package/dist/engine/spec-differ.js

@@ -0,0 +1,115 @@
+// engine/spec-differ.ts — Facade for spec version diff and history (SPEC-284)
+import { diffVersions, listVersions, getLatestVersionTag, computeLineDiff, } from './spec-versioning/index.js';
+/** Format a SpecVersionDiff as a human-readable +/- text block. */
+export function formatDiffAsText(diff) {
+    const lines = [];
+    lines.push(`--- ${diff.specId} @ ${diff.fromTag}`);
+    lines.push(`+++ ${diff.specId} @ ${diff.toTag}`);
+    lines.push('');
+    if (diff.removed.length === 0 && diff.added.length === 0) {
+        lines.push('(no line changes)');
+    }
+    for (const line of diff.removed) {
+        lines.push(`- ${line}`);
+    }
+    for (const line of diff.added) {
+        lines.push(`+ ${line}`);
+    }
+    lines.push('');
+    lines.push('## Criteria changes');
+    lines.push(`  Added:    ${diff.criteriaChanges.added.length}`);
+    lines.push(`  Removed:  ${diff.criteriaChanges.removed.length}`);
+    lines.push(`  Modified: ${diff.criteriaChanges.modified.length}`);
+    if (diff.sectionChanges.length > 0) {
+        lines.push('');
+        lines.push('## Section changes');
+        for (const change of diff.sectionChanges) {
+            lines.push(`  ${change}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Build a summary string for a version relative to its predecessor. */
+function buildChangeSummary(currentContent, prevContent) {
+    if (prevContent === null) {
+        return 'initial version';
+    }
+    const { added, removed } = computeLineDiff(prevContent, currentContent);
+    const parts = [];
+    if (added.length > 0) {
+        parts.push(`+${added.length} lines`);
+    }
+    if (removed.length > 0) {
+        parts.push(`-${removed.length} lines`);
+    }
+    return parts.length > 0 ? parts.join(', ') : 'no line changes';
+}
+/**
+ * Compute a diff between two version tags of a spec.
+ * If toVersion is omitted, uses the latest version.
+ * If both fromVersion and toVersion are omitted, compares latest vs penultimate.
+ */
+export async function computeSpecVersionDiff(opts) {
+    const { dataDir, specId } = opts;
+    let fromTag = opts.fromVersion;
+    let toTag = opts.toVersion;
+    if (fromTag === undefined || toTag === undefined) {
+        const versions = await listVersions(dataDir, specId);
+        if (versions.length < 2) {
+            throw new Error(`Spec "${specId}" has fewer than 2 versions — cannot compute diff. ` +
+                `Create more version snapshots with version_spec first.`);
+        }
+        const latest = versions[versions.length - 1];
+        const penultimate = versions[versions.length - 2];
+        // Guaranteed to exist — we checked length >= 2 above
+        /* v8 ignore start */
+        if (latest === undefined || penultimate === undefined) {
+            throw new Error(`Unexpected: versions array out of bounds for spec "${specId}".`);
+        }
+        /* v8 ignore stop */
+        toTag ??= latest.tag;
+        fromTag ??= penultimate.tag;
+    }
+    return diffVersions(dataDir, specId, fromTag, toTag);
+}
+/**
+ * List all version snapshots for a spec as VersionSummary objects.
+ * Returns them in reverse chronological order (newest first).
+ */
+export async function listSpecVersionHistory(dataDir, specId, limit = 20) {
+    const versions = await listVersions(dataDir, specId);
+    if (versions.length === 0) {
+        return [];
+    }
+    const latestTag = await getLatestVersionTag(dataDir, specId);
+    const summaries = [];
+    // Build summaries newest-first
+    const reversed = [...versions].reverse();
+    for (let i = 0; i < Math.min(reversed.length, limit); i++) {
+        const version = reversed[i];
+        /* v8 ignore start */
+        if (version === undefined) {
+            continue;
+        }
+        /* v8 ignore stop */
+        const prevInOriginal = versions[versions.length - 1 - i - 1];
+        const prevContent = prevInOriginal?.content ?? null;
+        summaries.push({
+            tag: version.tag,
+            timestamp: version.timestamp,
+            ...(version.author !== undefined ? { author: version.author } : {}),
+            ...(version.message !== undefined ? { message: version.message } : {}),
+            changeSummary: buildChangeSummary(version.content, prevContent),
+        });
+    }
+    // Mark the latest version explicitly in the first summary
+    if (summaries[0]?.tag === latestTag) {
+        const first = summaries[0];
+        summaries[0] = {
+            ...first,
+            changeSummary: `[latest] ${first.changeSummary}`,
+        };
+    }
+    return summaries;
+}
+//# sourceMappingURL=spec-differ.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { Spec } from '../types/index.js';
+import type { ExportColumn, ExportInput } from '../types/spec-export.js';
+export declare const ALL_COLUMNS: ExportColumn[];
+/**
+ * Extract the string value for a given column from a spec.
+ */
+export declare function extractColumnValue(spec: Spec, column: ExportColumn): string;
+/**
+ * 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 declare function escapeCsv(value: string): string;
+/**
+ * Serialize specs to CSV format.
+ * First row is the header, subsequent rows are data.
+ */
+export declare function specsToCsv(specs: Spec[], columns: ExportColumn[]): string;
+/**
+ * Serialize specs to a Markdown table format.
+ */
+export declare function specsToMarkdownTable(specs: Spec[], columns: ExportColumn[]): string;
+/**
+ * Filter specs by status, type, and tags from ExportInput.
+ */
+export declare function filterSpecs(specs: Spec[], input: ExportInput): Spec[];
+//# sourceMappingURL=spec-exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-exporter.d.ts","sourceRoot":"","sources":["../../src/engine/spec-exporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMzE,eAAO,MAAM,WAAW,EAAE,YAAY,EAerC,CAAC;AAMF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CA+B3E;AAMD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAMzE;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAUnF;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,CAoBrE"}

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"}