@planu/cli 0.90.2 → 0.92.0

package/dist/engine/registry/smithery-generator.js

@@ -0,0 +1,71 @@
+// engine/registry/smithery-generator.ts — SPEC-273: Smithery YAML generator
+// Generates smithery.yaml for publishing MCP servers to smithery.ai marketplace.
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Escapes a YAML string value, wrapping in quotes when necessary.
+ */
+function yamlEscapeValue(value) {
+    const needsQuotes = /[:#[\]{},&*?|<>=!%@`'"\n\r\t]/.test(value) || value.trim() !== value;
+    if (needsQuotes) {
+        return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+/**
+ * Serializes a string array into YAML block sequence lines.
+ */
+function yamlStringList(items, indent) {
+    return items.map((item) => `${indent}- ${yamlEscapeValue(item)}`).join('\n');
+}
+/**
+ * Generates a smithery.yaml string from the given options.
+ *
+ * @param options  Configuration for the Smithery registry entry.
+ * @returns YAML string suitable for writing to disk.
+ */
+export function generateSmitheryYaml(options) {
+    const lines = [
+        '# smithery.yaml — MCP server registry entry for smithery.ai',
+        '# Auto-generated by Planu (SPEC-273). Do not edit manually.',
+        '',
+        `name: ${yamlEscapeValue(options.name)}`,
+        `description: ${yamlEscapeValue(options.description)}`,
+        `version: ${yamlEscapeValue(options.version)}`,
+        `author: ${yamlEscapeValue(options.author)}`,
+        `repository: ${yamlEscapeValue(options.repository)}`,
+    ];
+    if (options.homepage !== undefined) {
+        lines.push(`homepage: ${yamlEscapeValue(options.homepage)}`);
+    }
+    if (options.license !== undefined) {
+        lines.push(`license: ${yamlEscapeValue(options.license)}`);
+    }
+    lines.push('');
+    lines.push('tools:');
+    lines.push(yamlStringList(options.tools, '  '));
+    lines.push('');
+    lines.push('categories:');
+    lines.push(yamlStringList(options.categories, '  '));
+    return lines.join('\n') + '\n';
+}
+/**
+ * Writes smithery.yaml to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      Smithery registry options.
+ */
+export function writeSmitheryYaml(projectPath, options) {
+    const filePath = join(projectPath, 'smithery.yaml');
+    const content = generateSmitheryYaml(options);
+    /* v8 ignore start */
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write smithery.yaml to ${filePath}: ${msg}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=smithery-generator.js.map

package/dist/engine/registry/smithery-generator.js.map

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

package/dist/engine/reverse-engineer/test-file-parser.d.ts

@@ -0,0 +1,26 @@
+import type { TestFramework, TestReverseEngineerResult } from '../../types/test-reverse-engineer.js';
+/**
+ * Detect the test framework from file content.
+ */
+export declare function detectFramework(content: string): TestFramework;
+/**
+ * Clean an AC text from a test description:
+ * - Remove leading "should " (case-insensitive)
+ * - Remove leading "it "
+ * - Capitalize first letter
+ * - Trim whitespace
+ */
+export declare function cleanAcText(description: string): string;
+/**
+ * Suggest a spec title from an array of describe group names.
+ */
+export declare function suggestTitle(groups: string[]): string;
+/**
+ * Suggest tags from the file path and detected framework.
+ */
+export declare function suggestTags(filePath: string, framework: TestFramework): string[];
+/**
+ * Parse a test file and extract acceptance criteria.
+ */
+export declare function parseTestFile(filePath: string): Promise<TestReverseEngineerResult>;
+//# sourceMappingURL=test-file-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-file-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/reverse-engineer/test-file-parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAG1B,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA0B9D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CASrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,EAAE,CAwBhF;AAmED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyBxF"}

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-coverage/core.js.map

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

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":"AAAA,8EAA8E;AAG9E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAElE,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,wEAAwE;AACxE,SAAS,kBAAkB,CACzB,cAAsB,EACtB,WAA0B;IAE1B,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACxE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAwB;IAExB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEjC,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAE3B,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,qDAAqD;gBAClE,wDAAwD,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,qDAAqD;QACrD,qBAAqB;QACrB,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,IAAI,CAAC,CAAC;QACpF,CAAC;QACD,oBAAoB;QACpB,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC;QACrB,OAAO,KAAK,WAAW,CAAC,GAAG,CAAC;IAC9B,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,MAAc,EACd,KAAK,GAAG,EAAE;IAEV,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAErD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,qBAAqB;QACrB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,oBAAoB;QACpB,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,cAAc,EAAE,OAAO,IAAI,IAAI,CAAC;QAEpD,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,aAAa,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,SAAS,CAAC,CAAC,CAAC,GAAG;YACb,GAAG,KAAK;YACR,aAAa,EAAE,YAAY,KAAK,CAAC,aAAa,EAAE;SACjD,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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