@planu/cli 0.27.0 → 0.29.0

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

package/dist/engine/mermaid/helpers.js

@@ -0,0 +1,61 @@
+// engine/mermaid/helpers.ts — Shared helpers for mermaid diagram generation.
+// Extracted from mermaid-generator.ts to keep file sizes within limits.
+/** Checks if a scope meets or exceeds a threshold in the scope ordering. */
+export function isScopeAtLeast(scope, threshold) {
+    const order = {
+        trivial: 0,
+        feature: 1,
+        'cross-module': 2,
+        architectural: 3,
+    };
+    return order[scope] >= order[threshold];
+}
+/** Builds layer nodes for data flow diagrams based on target and knowledge. */
+export function buildLayers(target, knowledge) {
+    // If knowledge has real architecture layers, prefer them over target-inferred ones
+    if (knowledge && knowledge.architecture.layers.length > 0) {
+        return knowledge.architecture.layers.map((l) => ({
+            id: l.name.replace(/[^a-zA-Z0-9]/g, '_'),
+            label: l.name,
+        }));
+    }
+    const framework = knowledge?.framework ?? '';
+    const layers = [];
+    if (target === 'frontend' || target === 'fullstack') {
+        layers.push({ id: 'Client', label: framework ? `Client (${framework})` : 'Client' });
+    }
+    if (target !== 'database' && target !== 'infrastructure') {
+        layers.push({ id: 'Action', label: 'Action/Controller' });
+        layers.push({ id: 'Service', label: 'Service' });
+    }
+    if (target === 'backend' || target === 'fullstack' || target === 'database') {
+        layers.push({ id: 'Repo', label: 'Repository' });
+        const dbRaw = knowledge?.database ?? 'DB';
+        const db = dbRaw === 'unknown' ? 'DB' : dbRaw;
+        layers.push({ id: 'DB', label: db });
+    }
+    if (target === 'infrastructure') {
+        layers.push({ id: 'Infra', label: 'Infrastructure' });
+        layers.push({ id: 'Cloud', label: 'Cloud Provider' });
+    }
+    // Fallback if empty
+    if (layers.length === 0) {
+        layers.push({ id: 'Input', label: 'Input' }, { id: 'Process', label: 'Process' }, { id: 'Output', label: 'Output' });
+    }
+    return layers;
+}
+/** Builds participant nodes for sequence diagrams based on target and knowledge. */
+export function buildParticipants(target, knowledge) {
+    const participants = [];
+    if (target === 'frontend' || target === 'fullstack') {
+        participants.push({ id: 'UI', label: 'UI' });
+    }
+    participants.push({ id: 'API', label: 'API' });
+    participants.push({ id: 'SVC', label: 'Service' });
+    if (target === 'backend' || target === 'fullstack' || target === 'database') {
+        const db = knowledge?.database ?? 'DB';
+        participants.push({ id: 'DB', label: db });
+    }
+    return participants;
+}
+//# sourceMappingURL=helpers.js.map

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

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

package/dist/engine/mermaid-generator.d.ts

@@ -1,39 +1,4 @@
-import type { SpecDiagram, Spec, ProjectKnowledge } from '../types/index.js';
+export { generateDiagrams, generateDataFlowDiagram, formatDiagramsAsMarkdown, } from './mermaid/core.js';
+export { generateErDiagram, generateSequenceDiagram, generateComponentDiagram, generateStateDiagram, generateArchitectureDiagram, } from './mermaid/diagram-generators.js';
 export { generateClassDiagram, generateGanttDiagram, generatePieDiagram, } from './mermaid-extended.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;
-/**
- * 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;
-/**
- * Format diagrams as Mermaid code blocks for inclusion in markdown.
- */
-export declare function formatDiagramsAsMarkdown(diagrams: SpecDiagram[]): string;
 //# sourceMappingURL=mermaid-generator.d.ts.map

package/dist/engine/mermaid-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-generator.d.ts","sourceRoot":"","sources":["../../src/engine/mermaid-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EAGJ,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAO/B;;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,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;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAkBxE"}
+{"version":3,"file":"mermaid-generator.d.ts","sourceRoot":"","sources":["../../src/engine/mermaid-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC"}