@planu/cli 0.28.0 → 0.30.0

package/dist/engine/code-transforms/typescript/modernize-syntax.js

@@ -0,0 +1,213 @@
+// engine/code-transforms/typescript/modernize-syntax.ts — (AC-05).
+// var->const/let, require->import, module.exports->export default, templates.
+import { getTypeScript, parseSource, getLineNumber, createChange, replaceRange, } from './ast-utils.js';
+// ---------------------------------------------------------------------------
+// var -> const/let
+// ---------------------------------------------------------------------------
+function modernizeVar(ts, sourceFile, source) {
+    const changes = [];
+    const replacements = [];
+    function visit(node) {
+        if (ts.isVariableStatement(node)) {
+            const declList = node.declarationList;
+            const isConst = (declList.flags & ts.NodeFlags.Const) !== 0;
+            const isLet = (declList.flags & ts.NodeFlags.Let) !== 0;
+            if (isConst || isLet) {
+                ts.forEachChild(node, visit);
+                return;
+            }
+            const keyword = 'const';
+            const start = declList.getStart(sourceFile);
+            const varEnd = start + 3; // "var".length
+            replacements.push({
+                start,
+                end: varEnd,
+                text: keyword,
+                line: getLineNumber(sourceFile, start),
+            });
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    replacements.sort((a, b) => b.start - a.start);
+    let result = source;
+    for (const r of replacements) {
+        result = replaceRange(result, r.start, r.end, r.text);
+        changes.push(createChange(r.line, `Changed 'var' to '${r.text}'`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { result, changes };
+}
+// ---------------------------------------------------------------------------
+// require() -> import
+// ---------------------------------------------------------------------------
+function modernizeRequire(ts, sourceFile, source) {
+    const changes = [];
+    const replacements = [];
+    function visit(node) {
+        if (ts.isVariableStatement(node) && node.declarationList.declarations.length === 1) {
+            const decl = node.declarationList.declarations[0];
+            /* v8 ignore next 3 -- defensive: declarations[0] always exists when length === 1 */
+            if (!decl) {
+                return;
+            }
+            if (decl.initializer &&
+                ts.isCallExpression(decl.initializer) &&
+                ts.isIdentifier(decl.initializer.expression) &&
+                decl.initializer.expression.text === 'require' &&
+                decl.initializer.arguments.length === 1) {
+                const arg = decl.initializer.arguments[0];
+                if (arg && ts.isStringLiteral(arg)) {
+                    const name = decl.name.getText(sourceFile);
+                    const mod = arg.text;
+                    const importStmt = `import ${name} from '${mod}';`;
+                    const stmtStart = node.getStart(sourceFile);
+                    const stmtEnd = node.getEnd();
+                    replacements.push({
+                        start: stmtStart,
+                        end: stmtEnd,
+                        text: importStmt,
+                        line: getLineNumber(sourceFile, stmtStart),
+                    });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    replacements.sort((a, b) => b.start - a.start);
+    let result = source;
+    for (const r of replacements) {
+        result = replaceRange(result, r.start, r.end, r.text);
+        changes.push(createChange(r.line, `Converted require() to import`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { result, changes };
+}
+// ---------------------------------------------------------------------------
+// module.exports -> export default
+// ---------------------------------------------------------------------------
+function modernizeModuleExports(ts, sourceFile, source) {
+    const changes = [];
+    const replacements = [];
+    function visit(node) {
+        if (ts.isExpressionStatement(node) &&
+            ts.isBinaryExpression(node.expression) &&
+            ts.isPropertyAccessExpression(node.expression.left) &&
+            ts.isIdentifier(node.expression.left.expression) &&
+            node.expression.left.expression.text === 'module' &&
+            node.expression.left.name.text === 'exports') {
+            const rhs = node.expression.right.getText(sourceFile);
+            const stmtStart = node.getStart(sourceFile);
+            const stmtEnd = node.getEnd();
+            replacements.push({
+                start: stmtStart,
+                end: stmtEnd,
+                text: `export default ${rhs};`,
+                line: getLineNumber(sourceFile, stmtStart),
+            });
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    replacements.sort((a, b) => b.start - a.start);
+    let result = source;
+    for (const r of replacements) {
+        result = replaceRange(result, r.start, r.end, r.text);
+        changes.push(createChange(r.line, `Converted module.exports to export default`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { result, changes };
+}
+// ---------------------------------------------------------------------------
+// String concatenation -> template literals
+// ---------------------------------------------------------------------------
+function isStringConcat(ts, node) {
+    if (!ts.isBinaryExpression(node)) {
+        return false;
+    }
+    if (node.operatorToken.kind !== ts.SyntaxKind.PlusToken) {
+        return false;
+    }
+    const hasStr = ts.isStringLiteral(node.left) || ts.isStringLiteral(node.right);
+    const hasNested = isStringConcat(ts, node.left) || isStringConcat(ts, node.right);
+    return hasStr || hasNested;
+}
+function flattenConcat(ts, node, sourceFile) {
+    if (ts.isBinaryExpression(node) && node.operatorToken.kind === ts.SyntaxKind.PlusToken) {
+        return [
+            ...flattenConcat(ts, node.left, sourceFile),
+            ...flattenConcat(ts, node.right, sourceFile),
+        ];
+    }
+    if (ts.isStringLiteral(node)) {
+        return [node.text];
+    }
+    return [`\${${node.getText(sourceFile)}}`];
+}
+function modernizeTemplateLiterals(ts, sourceFile, source) {
+    const changes = [];
+    const replacements = [];
+    function visit(node) {
+        if (isStringConcat(ts, node)) {
+            // Only process top-level concatenation
+            if (isStringConcat(ts, node.parent)) {
+                return;
+            }
+            const parts = flattenConcat(ts, node, sourceFile);
+            const template = '`' + parts.join('') + '`';
+            const start = node.getStart(sourceFile);
+            const end = node.getEnd();
+            replacements.push({
+                start,
+                end,
+                text: template,
+                line: getLineNumber(sourceFile, start),
+            });
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    replacements.sort((a, b) => b.start - a.start);
+    let result = source;
+    for (const r of replacements) {
+        result = replaceRange(result, r.start, r.end, r.text);
+        changes.push(createChange(r.line, `Converted string concatenation to template literal`));
+    }
+    changes.sort((a, b) => a.line - b.line);
+    return { result, changes };
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+export function modernizeSyntax(source, options, fileName) {
+    const ts = getTypeScript();
+    const allChanges = [];
+    let result = source;
+    if (options.varToConst !== false) {
+        const sf = parseSource(result, fileName);
+        const r = modernizeVar(ts, sf, result);
+        result = r.result;
+        allChanges.push(...r.changes);
+    }
+    if (options.requireToImport !== false) {
+        const sf = parseSource(result, fileName);
+        const r = modernizeRequire(ts, sf, result);
+        result = r.result;
+        allChanges.push(...r.changes);
+    }
+    if (options.moduleExportsToExport !== false) {
+        const sf = parseSource(result, fileName);
+        const r = modernizeModuleExports(ts, sf, result);
+        result = r.result;
+        allChanges.push(...r.changes);
+    }
+    if (options.templateLiterals !== false) {
+        const sf = parseSource(result, fileName);
+        const r = modernizeTemplateLiterals(ts, sf, result);
+        result = r.result;
+        allChanges.push(...r.changes);
+    }
+    return { transformed: result, changes: allChanges };
+}
+//# sourceMappingURL=modernize-syntax.js.map

package/dist/engine/code-transforms/typescript/modernize-syntax.js.map

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

package/dist/engine/code-transforms/typescript/rename-symbol.d.ts

@@ -0,0 +1,8 @@
+import type { RenameSymbolOptions, RenameResult } from '../../../types/index.js';
+/**
+ * Rename all occurrences of a symbol in the source code.
+ * Uses AST to find Identifier nodes, then applies text replacements
+ * in reverse order.
+ */
+export declare function renameSymbol(source: string, options: RenameSymbolOptions, fileName: string): RenameResult;
+//# sourceMappingURL=rename-symbol.d.ts.map

package/dist/engine/code-transforms/typescript/rename-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-symbol.d.ts","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/rename-symbol.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAmB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AASlG;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,GACf,YAAY,CAqCd"}

package/dist/engine/code-transforms/typescript/rename-symbol.js

@@ -0,0 +1,40 @@
+// engine/code-transforms/typescript/rename-symbol.ts — Rename symbol transform (AC-02).
+// Finds all identifiers matching oldName and replaces them with newName.
+import { getTypeScript, parseSource, getLineNumber, createChange, replaceRange, } from './ast-utils.js';
+/**
+ * Rename all occurrences of a symbol in the source code.
+ * Uses AST to find Identifier nodes, then applies text replacements
+ * in reverse order.
+ */
+export function renameSymbol(source, options, fileName) {
+    const ts = getTypeScript();
+    const sourceFile = parseSource(source, fileName);
+    const changes = [];
+    // Collect all identifier positions matching oldName
+    const positions = [];
+    function visit(node) {
+        if (ts.isIdentifier(node) && node.text === options.oldName) {
+            positions.push({
+                start: node.getStart(sourceFile),
+                end: node.getEnd(),
+                line: getLineNumber(sourceFile, node.getStart(sourceFile)),
+            });
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (positions.length === 0) {
+        return { transformed: source, changes: [] };
+    }
+    // Apply replacements in reverse order to preserve positions
+    let result = source;
+    const reversed = [...positions].sort((a, b) => b.start - a.start);
+    for (const pos of reversed) {
+        result = replaceRange(result, pos.start, pos.end, options.newName);
+        changes.push(createChange(pos.line, `Renamed '${options.oldName}' to '${options.newName}'`));
+    }
+    // Sort changes by line number (ascending) for output
+    changes.sort((a, b) => a.line - b.line);
+    return { transformed: result, changes };
+}
+//# sourceMappingURL=rename-symbol.js.map

package/dist/engine/code-transforms/typescript/rename-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-symbol.js","sourceRoot":"","sources":["../../../../src/engine/code-transforms/typescript/rename-symbol.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,yEAAyE;AAIzE,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,OAA4B,EAC5B,QAAgB;IAEhB,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,oDAAoD;IACpD,MAAM,SAAS,GAAmD,EAAE,CAAC;IAErE,SAAS,KAAK,CAAC,IAAmB;QAChC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3D,SAAS,CAAC,IAAI,CAAC;gBACb,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAChC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;gBAClB,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAElB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,OAAO,CAAC,OAAO,SAAS,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,qDAAqD;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/engine/mermaid/core.d.ts

@@ -0,0 +1,18 @@
+import type { SpecDiagram, Spec, ProjectKnowledge } from '../../types/index.js';
+/**
+ * Generate all applicable diagrams for a spec based on its scope and context.
+ */
+export declare function generateDiagrams(spec: Spec, knowledge: ProjectKnowledge | null, options: {
+    hasDatabase: boolean;
+    hasUi: boolean;
+    hasTransitions: boolean;
+}): SpecDiagram[];
+/**
+ * Generate a data flow diagram: Client -> Action -> Service -> Repo -> DB
+ */
+export declare function generateDataFlowDiagram(spec: Spec, knowledge: ProjectKnowledge | null): SpecDiagram;
+/**
+ * Format diagrams as Mermaid code blocks for inclusion in markdown.
+ */
+export declare function formatDiagramsAsMarkdown(diagrams: SpecDiagram[]): string;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/mermaid/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/mermaid/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAehF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GACzE,WAAW,EAAE,CAkDf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,WAAW,CAkBb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAkBxE"}

package/dist/engine/mermaid/core.js

@@ -0,0 +1,88 @@
+// engine/mermaid/core.ts — Main orchestrator for Mermaid diagram generation.
+// Extracted from mermaid-generator.ts to keep file sizes within limits.
+import { isScopeAtLeast, buildLayers } from './helpers.js';
+import { generateErDiagram, generateSequenceDiagram, generateComponentDiagram, generateStateDiagram, generateArchitectureDiagram, } from './diagram-generators.js';
+import { generateClassDiagram, generateGanttDiagram, generatePieDiagram, } from '../mermaid-extended.js';
+/**
+ * Generate all applicable diagrams for a spec based on its scope and context.
+ */
+export function generateDiagrams(spec, knowledge, options) {
+    const diagrams = [];
+    // Data flow diagram for ALL specs (except trivial)
+    if (spec.scope !== 'trivial') {
+        diagrams.push(generateDataFlowDiagram(spec, knowledge));
+    }
+    // ER diagram if database changes
+    if (options.hasDatabase) {
+        diagrams.push(generateErDiagram(spec, knowledge));
+    }
+    // Sequence diagram if scope >= cross-module
+    if (isScopeAtLeast(spec.scope, 'cross-module')) {
+        diagrams.push(generateSequenceDiagram(spec, knowledge));
+    }
+    // Component diagram if UI
+    if (options.hasUi) {
+        diagrams.push(generateComponentDiagram(spec, knowledge));
+    }
+    // State machine diagram if transitions
+    if (options.hasTransitions) {
+        diagrams.push(generateStateDiagram(spec));
+    }
+    // Architecture diagram if scope = architectural
+    if (spec.scope === 'architectural') {
+        diagrams.push(generateArchitectureDiagram(spec, knowledge));
+    }
+    // Class diagram for cross-module+ backend/shared specs
+    if (isScopeAtLeast(spec.scope, 'cross-module') &&
+        (spec.target === 'backend' || spec.target === 'shared' || spec.target === 'fullstack')) {
+        diagrams.push(generateClassDiagram(spec));
+    }
+    // Gantt diagram for larger specs (> 8 dev hours)
+    if (spec.estimation.devHours > 8) {
+        diagrams.push(generateGanttDiagram(spec));
+    }
+    // Pie chart for effort distribution (always for per-spec reports)
+    diagrams.push(generatePieDiagram(spec));
+    return diagrams;
+}
+/**
+ * Generate a data flow diagram: Client -> Action -> Service -> Repo -> DB
+ */
+export function generateDataFlowDiagram(spec, knowledge) {
+    const layers = buildLayers(spec.target, knowledge);
+    const lines = ['graph LR'];
+    layers.forEach((from, i) => {
+        const to = layers[i + 1];
+        if (to) {
+            lines.push(`  ${from.id}[${from.label}] --> ${to.id}[${to.label}]`);
+        }
+    });
+    return {
+        type: 'data-flow',
+        title: `Data Flow — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'Data flow diagram showing how data moves through the system layers.',
+    };
+}
+/**
+ * Format diagrams as Mermaid code blocks for inclusion in markdown.
+ */
+export function formatDiagramsAsMarkdown(diagrams) {
+    if (diagrams.length === 0) {
+        return '';
+    }
+    const sections = [];
+    for (const diagram of diagrams) {
+        sections.push(`### ${diagram.title}`);
+        sections.push('');
+        sections.push(`> ${diagram.description}`);
+        sections.push('');
+        sections.push('```mermaid');
+        sections.push(diagram.content);
+        sections.push('```');
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/mermaid/core.js.map

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

package/dist/engine/mermaid/diagram-generators.d.ts

@@ -0,0 +1,22 @@
+import type { SpecDiagram, Spec, ProjectKnowledge } from '../../types/index.js';
+/**
+ * Generate an ER diagram for database changes.
+ */
+export declare function generateErDiagram(spec: Spec, knowledge: ProjectKnowledge | null): SpecDiagram;
+/**
+ * Generate a sequence diagram for cross-module interactions.
+ */
+export declare function generateSequenceDiagram(spec: Spec, knowledge: ProjectKnowledge | null): SpecDiagram;
+/**
+ * Generate a component diagram for UI specs.
+ */
+export declare function generateComponentDiagram(spec: Spec, knowledge: ProjectKnowledge | null): SpecDiagram;
+/**
+ * Generate a state machine diagram for transitions.
+ */
+export declare function generateStateDiagram(spec: Spec): SpecDiagram;
+/**
+ * Generate an architecture diagram for architectural specs.
+ */
+export declare function generateArchitectureDiagram(spec: Spec, knowledge: ProjectKnowledge | null): SpecDiagram;
+//# sourceMappingURL=diagram-generators.d.ts.map

package/dist/engine/mermaid/diagram-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-generators.d.ts","sourceRoot":"","sources":["../../../src/engine/mermaid/diagram-generators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGhF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,WAAW,CA2B7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,WAAW,CA+Bb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,WAAW,CAqBb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAmB5D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,WAAW,CA8Bb"}

package/dist/engine/mermaid/diagram-generators.js

@@ -0,0 +1,139 @@
+// engine/mermaid/diagram-generators.ts — Individual diagram type generators.
+// Extracted from mermaid-generator.ts to keep file sizes within limits.
+import { buildParticipants } from './helpers.js';
+/**
+ * Generate an ER diagram for database changes.
+ */
+export function generateErDiagram(spec, knowledge) {
+    const dbEngine = knowledge?.database ?? 'unknown';
+    const lines = [
+        'erDiagram',
+        `  %% Database: ${dbEngine}`,
+        `  %% Spec: ${spec.title}`,
+        '  ENTITY_A {',
+        '    string id PK',
+        '    string name',
+        '    datetime created_at',
+        '  }',
+        '  ENTITY_B {',
+        '    string id PK',
+        '    string entity_a_id FK',
+        '    string value',
+        '  }',
+        '  ENTITY_A ||--o{ ENTITY_B : "has many"',
+    ];
+    return {
+        type: 'er',
+        title: `Entity Relationship — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'Entity-relationship diagram for database schema changes. Customize entities to match your domain.',
+    };
+}
+/**
+ * Generate a sequence diagram for cross-module interactions.
+ */
+export function generateSequenceDiagram(spec, knowledge) {
+    const participants = buildParticipants(spec.target, knowledge);
+    const lines = ['sequenceDiagram'];
+    for (const p of participants) {
+        lines.push(`  participant ${p.id} as ${p.label}`);
+    }
+    // Generate basic request-response flow
+    const first = participants[0];
+    const second = participants[1];
+    if (first && second) {
+        lines.push(`  ${first.id}->>+${second.id}: Request`);
+        const third = participants[2];
+        if (third) {
+            lines.push(`  ${second.id}->>+${third.id}: Process`);
+            lines.push(`  ${third.id}-->>-${second.id}: Result`);
+        }
+        lines.push(`  ${second.id}-->>-${first.id}: Response`);
+    }
+    return {
+        type: 'sequence',
+        title: `Sequence Diagram — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'Sequence diagram showing interactions between modules. Customize messages to match your flow.',
+    };
+}
+/**
+ * Generate a component diagram for UI specs.
+ */
+export function generateComponentDiagram(spec, knowledge) {
+    const framework = knowledge?.framework ?? 'UI';
+    const lines = [
+        'graph TD',
+        `  Page["${spec.title} Page"]`,
+        `  Page --> Header[Header]`,
+        `  Page --> Main[Main Content]`,
+        `  Page --> Footer[Footer]`,
+        `  Main --> CompA["Component A"]`,
+        `  Main --> CompB["Component B"]`,
+        `  CompA --> Store["${framework} State"]`,
+        `  CompB --> Store`,
+    ];
+    return {
+        type: 'component',
+        title: `Component Diagram — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'UI component hierarchy diagram. Customize components to match your design.',
+    };
+}
+/**
+ * Generate a state machine diagram for transitions.
+ */
+export function generateStateDiagram(spec) {
+    const lines = [
+        'stateDiagram-v2',
+        `  [*] --> Initial`,
+        `  Initial --> Processing: Start`,
+        `  Processing --> Success: Complete`,
+        `  Processing --> Error: Fail`,
+        `  Error --> Processing: Retry`,
+        `  Success --> [*]`,
+    ];
+    return {
+        type: 'state-machine',
+        title: `State Machine — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'State machine diagram showing state transitions. Customize states to match your domain.',
+    };
+}
+/**
+ * Generate an architecture diagram for architectural specs.
+ */
+export function generateArchitectureDiagram(spec, knowledge) {
+    const arch = knowledge?.architecture;
+    const pattern = arch ? arch.primary : 'layered';
+    const externalServices = knowledge?.externalServices ?? [];
+    const externalLabel = externalServices.length > 0 ? externalServices.slice(0, 2).join(' / ') : 'External Services';
+    const lines = [
+        'graph TB',
+        `  subgraph "${spec.title}"`,
+        `    direction TB`,
+        `    Client["Client Layer"]`,
+        `    API["API Gateway"]`,
+        `    Service["Service Layer"]`,
+        `    Data["Data Layer"]`,
+        `    Client --> API`,
+        `    API --> Service`,
+        `    Service --> Data`,
+        `  end`,
+        `  External["${externalLabel}"]`,
+        `  Service --> External`,
+        `  %% Architecture: ${pattern}`,
+    ];
+    return {
+        type: 'architecture',
+        title: `Architecture — ${spec.title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `Architecture diagram using ${pattern} pattern. Customize to match your system.`,
+    };
+}
+//# sourceMappingURL=diagram-generators.js.map

package/dist/engine/mermaid/diagram-generators.js.map

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

package/dist/engine/mermaid/helpers.d.ts

@@ -0,0 +1,8 @@
+import type { SpecScope, SpecTarget, ProjectKnowledge, LayerNode } from '../../types/index.js';
+/** Checks if a scope meets or exceeds a threshold in the scope ordering. */
+export declare function isScopeAtLeast(scope: SpecScope, threshold: SpecScope): boolean;
+/** Builds layer nodes for data flow diagrams based on target and knowledge. */
+export declare function buildLayers(target: SpecTarget, knowledge: ProjectKnowledge | null): LayerNode[];
+/** Builds participant nodes for sequence diagrams based on target and knowledge. */
+export declare function buildParticipants(target: SpecTarget, knowledge: ProjectKnowledge | null): LayerNode[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/engine/mermaid/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/engine/mermaid/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/F,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAQ9E;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAAE,CA4C/F;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,SAAS,EAAE,CAgBb"}