@planu/cli 0.15.2

package/dist/engine/doc-generator/diagrams.js

@@ -0,0 +1,181 @@
+// Planu — Diagram Generators
+// Generates Mermaid diagrams from project knowledge and specs
+export function generateArchitectureDiagram(knowledge) {
+    const arch = knowledge.architecture;
+    const lines = ['graph TB'];
+    for (const layer of arch.layers) {
+        const id = layer.name.replace(/[^a-zA-Z0-9]/g, '_');
+        lines.push(`  ${id}["${layer.name}\\n${layer.directories.join(', ')}"]`);
+    }
+    // Add dependency arrows
+    for (const layer of arch.layers) {
+        const fromId = layer.name.replace(/[^a-zA-Z0-9]/g, '_');
+        for (const dep of layer.dependsOn) {
+            const toId = dep.replace(/[^a-zA-Z0-9]/g, '_');
+            lines.push(`  ${fromId} --> ${toId}`);
+        }
+    }
+    return {
+        type: 'architecture',
+        title: `${arch.primary} Architecture`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `Architecture diagram showing ${arch.primary} pattern with ${arch.layers.length} layers.`,
+    };
+}
+export function generateComponentDiagram(knowledge) {
+    const lines = ['graph LR'];
+    for (const app of knowledge.apps) {
+        const id = app.name.replace(/[^a-zA-Z0-9]/g, '_');
+        lines.push(`  ${id}["${app.name}\\n${app.type}\\n${app.language}"]`);
+    }
+    // Connect frontend to backend
+    const frontends = knowledge.apps.filter((a) => a.type === 'frontend');
+    const backends = knowledge.apps.filter((a) => a.type === 'backend');
+    for (const fe of frontends) {
+        for (const be of backends) {
+            const feId = fe.name.replace(/[^a-zA-Z0-9]/g, '_');
+            const beId = be.name.replace(/[^a-zA-Z0-9]/g, '_');
+            lines.push(`  ${feId} --> ${beId}`);
+        }
+    }
+    return {
+        type: 'component',
+        title: 'Component Diagram',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `Component diagram with ${knowledge.apps.length} app(s).`,
+    };
+}
+export function generateDataFlowDiagram(knowledge) {
+    const lines = ['graph LR'];
+    lines.push('  User((User))');
+    lines.push('  UI[UI Layer]');
+    lines.push('  API[API Layer]');
+    lines.push('  Logic[Business Logic]');
+    if (knowledge.database !== 'unknown') {
+        lines.push(`  DB[(${knowledge.database})]`);
+        lines.push('  Logic --> DB');
+    }
+    lines.push('  User --> UI');
+    lines.push('  UI --> API');
+    lines.push('  API --> Logic');
+    return {
+        type: 'data-flow',
+        title: 'Data Flow',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'High-level data flow through the application.',
+    };
+}
+export function generateSequenceDiagram(spec) {
+    const lines = ['sequenceDiagram'];
+    const title = spec?.title ?? 'Request Flow';
+    lines.push('  actor User');
+    lines.push('  participant UI');
+    lines.push('  participant API');
+    lines.push('  participant Service');
+    lines.push('  participant DB');
+    lines.push('');
+    lines.push(`  User->>UI: ${title}`);
+    lines.push('  UI->>API: HTTP Request');
+    lines.push('  API->>Service: Process');
+    lines.push('  Service->>DB: Query');
+    lines.push('  DB-->>Service: Result');
+    lines.push('  Service-->>API: Response');
+    lines.push('  API-->>UI: JSON');
+    lines.push('  UI-->>User: Display');
+    return {
+        type: 'sequence',
+        title: `Sequence: ${title}`,
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `Sequence diagram for ${title}.`,
+    };
+}
+export function generateErDiagram(knowledge) {
+    const lines = ['erDiagram'];
+    // Placeholder ER — real implementation would parse schema files
+    lines.push('  USERS {');
+    lines.push('    uuid id PK');
+    lines.push('    string email');
+    lines.push('    timestamp created_at');
+    lines.push('  }');
+    return {
+        type: 'er',
+        title: 'Entity Relationship Diagram',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `ER diagram for ${knowledge.database} database. Update with actual schema.`,
+    };
+}
+export function generateStateMachineDiagram(spec) {
+    const lines = ['stateDiagram-v2'];
+    if (spec) {
+        lines.push(`  [*] --> draft`);
+        lines.push(`  draft --> review: Submit`);
+        lines.push(`  review --> approved: Approve`);
+        lines.push(`  review --> draft: Request Changes`);
+        lines.push(`  approved --> implementing: Start`);
+        lines.push(`  implementing --> done: Complete`);
+        lines.push(`  done --> [*]`);
+    }
+    else {
+        lines.push(`  [*] --> Created`);
+        lines.push(`  Created --> Active: Activate`);
+        lines.push(`  Active --> Completed: Complete`);
+        lines.push(`  Completed --> [*]`);
+    }
+    return {
+        type: 'state-machine',
+        title: 'State Machine',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'State machine diagram showing lifecycle transitions.',
+    };
+}
+export function generateDependencyDiagram(knowledge) {
+    const lines = ['graph TD'];
+    for (const layer of knowledge.architecture.layers) {
+        const id = layer.name.replace(/[^a-zA-Z0-9]/g, '_');
+        lines.push(`  ${id}[${layer.name}]`);
+    }
+    for (const layer of knowledge.architecture.layers) {
+        const fromId = layer.name.replace(/[^a-zA-Z0-9]/g, '_');
+        for (const dep of layer.dependsOn) {
+            const toId = dep.replace(/[^a-zA-Z0-9]/g, '_');
+            lines.push(`  ${fromId} -.-> ${toId}`);
+        }
+        for (const forbidden of layer.neverDependsOn) {
+            const toId = forbidden.replace(/[^a-zA-Z0-9]/g, '_');
+            lines.push(`  ${fromId} -.-x ${toId}`);
+        }
+    }
+    return {
+        type: 'dependency',
+        title: 'Dependency Rules',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: 'Dependency rules: dashed arrows = allowed, crossed = forbidden.',
+    };
+}
+export function generateDeploymentDiagram(knowledge) {
+    const lines = ['graph LR'];
+    const units = knowledge.architecture.deploymentUnits;
+    lines.push('  Dev[Developer]');
+    lines.push('  Git[Git Repository]');
+    lines.push('  Dev --> Git');
+    for (const unit of units) {
+        const id = unit.replace(/[^a-zA-Z0-9]/g, '_');
+        lines.push(`  ${id}[${unit}]`);
+        lines.push(`  Git --> ${id}`);
+    }
+    return {
+        type: 'deployment',
+        title: 'Deployment Pipeline',
+        format: 'mermaid',
+        content: lines.join('\n'),
+        description: `Deployment pipeline with ${units.length} target(s).`,
+    };
+}
+//# sourceMappingURL=diagrams.js.map

package/dist/engine/doc-generator/diagrams.js.map

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

package/dist/engine/doc-generator/executive-summary/data-extractors.d.ts

@@ -0,0 +1,12 @@
+import type { Spec, ProjectKnowledge, ExecutiveSummarySpecEntry, AggregatedEstimation, RiskProfile, ArchitectureSnapshot, ExecutiveSummaryData } from '../../../types/index.js';
+/** Map a Spec to an ExecutiveSummarySpecEntry. */
+export declare function extractSpecEntries(specs: Spec[]): ExecutiveSummarySpecEntry[];
+/** Sum all estimation fields across all specs. */
+export declare function aggregateEstimation(specs: Spec[]): AggregatedEstimation;
+/** Count specs by risk level; highlights = titles of high/critical specs. */
+export declare function buildRiskProfile(specs: Spec[]): RiskProfile;
+/** Extract architecture snapshot from ProjectKnowledge. */
+export declare function buildArchitectureSnapshot(knowledge: ProjectKnowledge): ArchitectureSnapshot;
+/** Orchestrate all extractors to build the full ExecutiveSummaryData. */
+export declare function buildExecutiveSummaryData(knowledge: ProjectKnowledge, specs: Spec[]): ExecutiveSummaryData;
+//# sourceMappingURL=data-extractors.d.ts.map

package/dist/engine/doc-generator/executive-summary/data-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-extractors.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/data-extractors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAEjC,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,yBAAyB,EAAE,CAsB7E;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,oBAAoB,CAuBvE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CA2B3D;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,oBAAoB,CAS3F;AAED,yEAAyE;AACzE,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,GACZ,oBAAoB,CAYtB"}

package/dist/engine/doc-generator/executive-summary/data-extractors.js

@@ -0,0 +1,96 @@
+/** Map a Spec to an ExecutiveSummarySpecEntry. */
+export function extractSpecEntries(specs) {
+    return specs.map((spec) => {
+        const entry = {
+            id: spec.id,
+            title: spec.title,
+            status: spec.status,
+            difficulty: spec.difficulty,
+            risk: spec.risk,
+            devHours: spec.estimation.devHours,
+            reviewHours: spec.estimation.reviewHours,
+            totalCostUsd: spec.estimation.totalCostUsd,
+            tags: spec.tags,
+        };
+        if (spec.actuals !== null) {
+            entry.actualDevHours = spec.actuals.devHours;
+            entry.actualTotalCostUsd = spec.actuals.totalCostUsd;
+            entry.completedAt = spec.actuals.completedAt;
+        }
+        return entry;
+    });
+}
+/** Sum all estimation fields across all specs. */
+export function aggregateEstimation(specs) {
+    let totalDevHours = 0;
+    let totalReviewHours = 0;
+    let totalHumanCostUsd = 0;
+    let totalApiCostUsd = 0;
+    let totalCostUsd = 0;
+    for (const spec of specs) {
+        totalDevHours += spec.estimation.devHours;
+        totalReviewHours += spec.estimation.reviewHours;
+        totalHumanCostUsd += spec.estimation.humanCostUsd;
+        totalApiCostUsd += spec.estimation.apiCostUsd;
+        totalCostUsd += spec.estimation.totalCostUsd;
+    }
+    return {
+        totalDevHours,
+        totalReviewHours,
+        totalHumanCostUsd,
+        totalApiCostUsd,
+        totalCostUsd,
+        specCount: specs.length,
+    };
+}
+/** Count specs by risk level; highlights = titles of high/critical specs. */
+export function buildRiskProfile(specs) {
+    let low = 0;
+    let medium = 0;
+    let high = 0;
+    let critical = 0;
+    const highlights = [];
+    for (const spec of specs) {
+        switch (spec.risk) {
+            case 'low':
+                low++;
+                break;
+            case 'medium':
+                medium++;
+                break;
+            case 'high':
+                high++;
+                highlights.push(spec.title);
+                break;
+            case 'critical':
+                critical++;
+                highlights.push(spec.title);
+                break;
+        }
+    }
+    return { low, medium, high, critical, highlights };
+}
+/** Extract architecture snapshot from ProjectKnowledge. */
+export function buildArchitectureSnapshot(knowledge) {
+    const layers = knowledge.architecture.layers.map((l) => l.name);
+    return {
+        language: knowledge.language,
+        framework: knowledge.framework ?? 'none',
+        database: knowledge.database,
+        layers,
+    };
+}
+/** Orchestrate all extractors to build the full ExecutiveSummaryData. */
+export function buildExecutiveSummaryData(knowledge, specs) {
+    const pathSegments = knowledge.projectPath.split('/');
+    const projectName = pathSegments[pathSegments.length - 1] ?? knowledge.projectPath;
+    return {
+        projectName,
+        generatedAt: new Date().toISOString(),
+        architecture: buildArchitectureSnapshot(knowledge),
+        specs: extractSpecEntries(specs),
+        estimation: aggregateEstimation(specs),
+        riskProfile: buildRiskProfile(specs),
+    };
+}
+//# sourceMappingURL=data-extractors.js.map

package/dist/engine/doc-generator/executive-summary/data-extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-extractors.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/data-extractors.ts"],"names":[],"mappings":"AAWA,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,KAAK,GAA8B;YACvC,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ;YAClC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;YACxC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;YAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC7C,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YACrD,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAC/C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1C,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAChD,iBAAiB,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAClD,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAC9C,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,aAAa;QACb,gBAAgB;QAChB,iBAAiB;QACjB,eAAe;QACf,YAAY;QACZ,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,KAAK;gBACR,GAAG,EAAE,CAAC;gBACN,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,EAAE,CAAC;gBACT,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,EAAE,CAAC;gBACP,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,UAAU;gBACb,QAAQ,EAAE,CAAC;gBACX,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,yBAAyB,CAAC,SAA2B;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEhE,OAAO;QACL,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,MAAM;QACxC,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,yBAAyB,CACvC,SAA2B,EAC3B,KAAa;IAEb,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,WAAW,CAAC;IAEnF,OAAO;QACL,WAAW;QACX,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,yBAAyB,CAAC,SAAS,CAAC;QAClD,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAChC,UAAU,EAAE,mBAAmB,CAAC,KAAK,CAAC;QACtC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectKnowledge, Spec, GeneratedDocument } from '../../../types/index.js';
+/**
+ * Generate a self-contained HTML executive summary document.
+ * Returns a GeneratedDocument with type 'executive-summary'.
+ */
+export declare function generateExecutiveSummary(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+//# sourceMappingURL=executive-summary-generator.d.ts.map

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executive-summary-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/executive-summary-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAmBzF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAiCnB"}

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.js

@@ -0,0 +1,38 @@
+import { buildExecutiveSummaryData } from './data-extractors.js';
+import { generateArchitectureSvg, generateTimelineSvg, generateRiskDistributionSvg, } from './svg-diagrams.js';
+import { wrapInHtmlDocument } from './html-template.js';
+import { buildHeaderSection, buildOverviewSection, buildSpecsTableSection, buildEstimationSection, buildRiskSection, buildArchitectureSection, buildTimelineSection, buildFooterSection, } from './section-builders.js';
+/**
+ * Generate a self-contained HTML executive summary document.
+ * Returns a GeneratedDocument with type 'executive-summary'.
+ */
+export function generateExecutiveSummary(knowledge, specs, _language) {
+    const data = buildExecutiveSummaryData(knowledge, specs);
+    const archSvg = generateArchitectureSvg(data.architecture);
+    const timelineSvg = generateTimelineSvg(data.specs);
+    const riskSvg = generateRiskDistributionSvg(data.riskProfile);
+    const hasActuals = data.specs.some((s) => s.actualDevHours !== undefined);
+    const body = [
+        buildHeaderSection(data.projectName, data.generatedAt, data.specs.length),
+        buildOverviewSection(data.architecture),
+        buildSpecsTableSection(data.specs),
+        buildEstimationSection(data.estimation, hasActuals),
+        buildRiskSection(data.riskProfile, riskSvg),
+        buildArchitectureSection(data.architecture, archSvg),
+        buildTimelineSection(timelineSvg),
+        buildFooterSection(),
+    ].join('\n');
+    const title = `Executive Summary — ${data.projectName}`;
+    const content = wrapInHtmlDocument(title, body);
+    return {
+        type: 'executive-summary',
+        title,
+        path: 'docs/executive-summary.html',
+        content,
+        audience: 'stakeholder',
+        sections: [],
+        diagrams: [],
+        relatedSpecs: data.specs.map((s) => s.id),
+    };
+}
+//# sourceMappingURL=executive-summary-generator.js.map

package/dist/engine/doc-generator/executive-summary/executive-summary-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executive-summary-generator.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/executive-summary-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAA2B,EAC3B,KAAa,EACb,SAAiB;IAEjB,MAAM,IAAI,GAAG,yBAAyB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC;IAE1E,MAAM,IAAI,GAAG;QACX,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACzE,oBAAoB,CAAC,IAAI,CAAC,YAAY,CAAC;QACvC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAClC,sBAAsB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;QACnD,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;QAC3C,wBAAwB,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;QACpD,oBAAoB,CAAC,WAAW,CAAC;QACjC,kBAAkB,EAAE;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,uBAAuB,IAAI,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEhD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,KAAK;QACL,IAAI,EAAE,6BAA6B;QACnC,OAAO;QACP,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/engine/doc-generator/executive-summary/html-template.d.ts

@@ -0,0 +1,3 @@
+/** Wrap body content in a full HTML document with inline CSS. */
+export declare function wrapInHtmlDocument(title: string, bodyContent: string): string;
+//# sourceMappingURL=html-template.d.ts.map

package/dist/engine/doc-generator/executive-summary/html-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-template.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/html-template.ts"],"names":[],"mappings":"AAgCA,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAa7E"}

package/dist/engine/doc-generator/executive-summary/html-template.js

@@ -0,0 +1,53 @@
+// Planu — HTML document wrapper with inline CSS for executive summary
+const CSS = `
+  @page { margin: 2cm; size: A4; }
+  @media print { print-color-adjust: exact; -webkit-print-color-adjust: exact; }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; font-size: 14px; color: #1f2937; max-width: 900px; margin: 0 auto; padding: 24px; background: #fff; }
+  .header { border-bottom: 3px solid #4F46E5; padding-bottom: 16px; margin-bottom: 24px; }
+  .header h1 { font-size: 1.1em; color: #6b7280; font-weight: 400; margin-bottom: 4px; }
+  .header h2 { font-size: 1.8em; color: #111827; font-weight: 700; }
+  .header .meta { margin-top: 8px; font-size: 0.85em; color: #6b7280; }
+  .badge { display: inline-block; padding: 2px 10px; border-radius: 12px; font-size: 0.78em; font-weight: 600; }
+  .badge-draft { background: #e5e7eb; color: #374151; }
+  .badge-review { background: #dbeafe; color: #1d4ed8; }
+  .badge-approved { background: #d1fae5; color: #065f46; }
+  .badge-implementing { background: #fef3c7; color: #92400e; }
+  .badge-done { background: #d1fae5; color: #065f46; }
+  .section { margin-bottom: 28px; }
+  .section h2 { font-size: 1.15em; color: #4F46E5; border-left: 4px solid #4F46E5; padding-left: 10px; margin-bottom: 14px; }
+  .metric-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; margin-bottom: 16px; }
+  .metric-card { background: #f9fafb; border: 1px solid #e5e7eb; border-radius: 8px; padding: 14px; text-align: center; }
+  .metric-value { font-size: 2em; font-weight: 700; color: #4F46E5; line-height: 1; }
+  .metric-label { font-size: 0.78em; color: #6b7280; margin-top: 4px; }
+  table { width: 100%; border-collapse: collapse; font-size: 0.85em; }
+  th { background: #4F46E5; color: white; padding: 8px 12px; text-align: left; font-weight: 600; }
+  td { padding: 7px 12px; border-bottom: 1px solid #e5e7eb; }
+  tr:nth-child(even) td { background: #f9fafb; }
+  .risk-highlight { border-left: 3px solid #ef4444; padding: 6px 10px; margin: 4px 0; background: #fef2f2; border-radius: 0 4px 4px 0; font-size: 0.85em; color: #374151; }
+  svg { max-width: 100%; height: auto; }
+  .footer { margin-top: 32px; padding-top: 16px; border-top: 1px solid #e5e7eb; font-size: 0.78em; color: #9ca3af; text-align: center; }
+`;
+/** Wrap body content in a full HTML document with inline CSS. */
+export function wrapInHtmlDocument(title, bodyContent) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title>${escapeHtml(title)}</title>
+  <style>${CSS}</style>
+</head>
+<body>
+${bodyContent}
+</body>
+</html>`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+//# sourceMappingURL=html-template.js.map

package/dist/engine/doc-generator/executive-summary/html-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-template.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/html-template.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BX,CAAC;AAEF,iEAAiE;AACjE,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,WAAmB;IACnE,OAAO;;;;;WAKE,UAAU,CAAC,KAAK,CAAC;WACjB,GAAG;;;EAGZ,WAAW;;QAEL,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/engine/doc-generator/executive-summary/index.d.ts

@@ -0,0 +1,2 @@
+export { generateExecutiveSummary } from './executive-summary-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/doc-generator/executive-summary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/engine/doc-generator/executive-summary/index.js

@@ -0,0 +1,3 @@
+// Planu — Executive Summary module barrel
+export { generateExecutiveSummary } from './executive-summary-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/doc-generator/executive-summary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/engine/doc-generator/executive-summary/section-builders.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutiveSummarySpecEntry, AggregatedEstimation, RiskProfile, ArchitectureSnapshot } from '../../../types/index.js';
+/** Header section: project name, spec count, generated date. */
+export declare function buildHeaderSection(projectName: string, generatedAt: string, specCount: number): string;
+/** Overview section: language, framework, database, layer count. */
+export declare function buildOverviewSection(arch: ArchitectureSnapshot): string;
+/** Specs table section. Adds actual columns if any spec has actuals. */
+export declare function buildSpecsTableSection(specs: ExecutiveSummarySpecEntry[]): string;
+/** Estimation section: totals, and side-by-side if actuals available. */
+export declare function buildEstimationSection(est: AggregatedEstimation, hasActuals: boolean, actualEstimation?: AggregatedEstimation): string;
+/** Risk section: metric cards + SVG bar + highlights. */
+export declare function buildRiskSection(risk: RiskProfile, svgContent: string): string;
+/** Architecture section: language/framework/DB info + SVG. */
+export declare function buildArchitectureSection(arch: ArchitectureSnapshot, svgContent: string): string;
+/** Timeline section: SVG only. */
+export declare function buildTimelineSection(svgContent: string): string;
+/** Footer section. */
+export declare function buildFooterSection(): string;
+//# sourceMappingURL=section-builders.d.ts.map

package/dist/engine/doc-generator/executive-summary/section-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-builders.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/section-builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAmCjC,gEAAgE;AAChE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAUvE;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,yBAAyB,EAAE,GAAG,MAAM,CA+BjF;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,OAAO,EACnB,gBAAgB,CAAC,EAAE,oBAAoB,GACtC,MAAM,CAwBR;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiB9E;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/F;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,sBAAsB;AACtB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/engine/doc-generator/executive-summary/section-builders.js

@@ -0,0 +1,152 @@
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function statusToBadgeClass(status) {
+    switch (status) {
+        case 'draft':
+            return 'badge-draft';
+        case 'review':
+            return 'badge-review';
+        case 'approved':
+            return 'badge-approved';
+        case 'implementing':
+            return 'badge-implementing';
+        case 'done':
+            return 'badge-done';
+        default:
+            return 'badge-draft';
+    }
+}
+function formatUsd(amount) {
+    return amount.toLocaleString('en-US', {
+        style: 'currency',
+        currency: 'USD',
+        maximumFractionDigits: 0,
+    });
+}
+function metricCard(value, label) {
+    return `<div class="metric-card"><div class="metric-value">${value}</div><div class="metric-label">${label}</div></div>`;
+}
+// ── Section builders ─────────────────────────────────────────────────────────
+/** Header section: project name, spec count, generated date. */
+export function buildHeaderSection(projectName, generatedAt, specCount) {
+    const date = new Date(generatedAt).toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+    return `<div class="header">
+  <h1>Planu — Executive Summary</h1>
+  <h2>${escapeHtml(projectName)}</h2>
+  <div class="meta"><span class="badge badge-draft">${specCount} spec${specCount !== 1 ? 's' : ''}</span>&nbsp; Generated on ${date}</div>
+</div>`;
+}
+/** Overview section: language, framework, database, layer count. */
+export function buildOverviewSection(arch) {
+    return `<div class="section">
+  <h2>Project Overview</h2>
+  <div class="metric-grid">
+    ${metricCard(escapeHtml(arch.language), 'Language')}
+    ${metricCard(escapeHtml(arch.framework), 'Framework')}
+    ${metricCard(escapeHtml(arch.database), 'Database')}
+    ${metricCard(String(arch.layers.length), 'Architecture Layers')}
+  </div>
+</div>`;
+}
+/** Specs table section. Adds actual columns if any spec has actuals. */
+export function buildSpecsTableSection(specs) {
+    const hasActuals = specs.some((s) => s.actualDevHours !== undefined);
+    const header = `<tr>
+    <th>ID</th><th>Title</th><th>Status</th><th>Difficulty</th><th>Risk</th><th>Dev Hours</th><th>Cost (est.)</th>
+    ${hasActuals ? '<th>Actual Hours</th><th>Actual Cost</th>' : ''}
+  </tr>`;
+    const rows = specs
+        .map((s) => {
+        const badgeClass = statusToBadgeClass(s.status);
+        const actualCols = hasActuals
+            ? `<td>${s.actualDevHours !== undefined ? String(s.actualDevHours) : '—'}</td><td>${s.actualTotalCostUsd !== undefined ? formatUsd(s.actualTotalCostUsd) : '—'}</td>`
+            : '';
+        return `<tr>
+    <td>${escapeHtml(s.id)}</td>
+    <td>${escapeHtml(s.title)}</td>
+    <td><span class="badge ${badgeClass}">${s.status}</span></td>
+    <td>${s.difficulty}</td>
+    <td>${s.risk}</td>
+    <td>${s.devHours}h</td>
+    <td>${formatUsd(s.totalCostUsd)}</td>
+    ${actualCols}
+  </tr>`;
+    })
+        .join('');
+    return `<div class="section">
+  <h2>Specifications</h2>
+  <table>${header}${rows}</table>
+</div>`;
+}
+/** Estimation section: totals, and side-by-side if actuals available. */
+export function buildEstimationSection(est, hasActuals, actualEstimation) {
+    const cards = `<div class="metric-grid">
+    ${metricCard(String(est.totalDevHours) + 'h', 'Total Dev Hours')}
+    ${metricCard(String(est.totalReviewHours) + 'h', 'Review Hours')}
+    ${metricCard(formatUsd(est.totalHumanCostUsd), 'Human Cost')}
+    ${metricCard(formatUsd(est.totalApiCostUsd), 'API Cost')}
+    ${metricCard(formatUsd(est.totalCostUsd), 'Total Cost')}
+  </div>`;
+    let actualsBlock = '';
+    if (hasActuals && actualEstimation !== undefined) {
+        const delta = est.totalCostUsd > 0
+            ? Math.round(((actualEstimation.totalCostUsd - est.totalCostUsd) / est.totalCostUsd) * 100)
+            : 0;
+        const sign = delta >= 0 ? '+' : '';
+        actualsBlock = `<p style="margin-top:8px;font-size:0.85em;color:#6b7280;">Actual total: <strong>${formatUsd(actualEstimation.totalCostUsd)}</strong> — ${sign}${delta}% vs estimate</p>`;
+    }
+    return `<div class="section">
+  <h2>Cost Estimation</h2>
+  ${cards}
+  ${actualsBlock}
+</div>`;
+}
+/** Risk section: metric cards + SVG bar + highlights. */
+export function buildRiskSection(risk, svgContent) {
+    const highlights = risk.highlights.length > 0
+        ? risk.highlights.map((h) => `<div class="risk-highlight">${escapeHtml(h)}</div>`).join('')
+        : '<p style="color:#6b7280;font-size:0.85em;">No high-risk specs identified.</p>';
+    return `<div class="section">
+  <h2>Risk Assessment</h2>
+  <div class="metric-grid">
+    ${metricCard(String(risk.low), 'Low Risk')}
+    ${metricCard(String(risk.medium), 'Medium Risk')}
+    ${metricCard(String(risk.high), 'High Risk')}
+    ${metricCard(String(risk.critical), 'Critical Risk')}
+  </div>
+  ${svgContent}
+  <div style="margin-top:12px"><strong style="font-size:0.85em;color:#374151;">High &amp; Critical Specs:</strong>${highlights}</div>
+</div>`;
+}
+/** Architecture section: language/framework/DB info + SVG. */
+export function buildArchitectureSection(arch, svgContent) {
+    return `<div class="section">
+  <h2>Architecture</h2>
+  <p style="margin-bottom:12px;font-size:0.9em;color:#374151;">
+    <strong>${escapeHtml(arch.language)}</strong> project using <strong>${escapeHtml(arch.framework)}</strong> with <strong>${escapeHtml(arch.database)}</strong> — ${arch.layers.length} architecture layer${arch.layers.length !== 1 ? 's' : ''}.
+  </p>
+  ${svgContent}
+</div>`;
+}
+/** Timeline section: SVG only. */
+export function buildTimelineSection(svgContent) {
+    return `<div class="section">
+  <h2>Development Timeline</h2>
+  ${svgContent}
+</div>`;
+}
+/** Footer section. */
+export function buildFooterSection() {
+    return `<div class="footer">Generated by Planu &mdash; ${new Date().toUTCString()}</div>`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+//# sourceMappingURL=section-builders.js.map