@planu/cli 0.54.2 → 0.56.0

package/dist/engine/doc-generator/per-spec-report/technical-report.d.ts

@@ -1,7 +1,9 @@
 import type { Spec, GeneratedDocument, SpecDiagram } from '../../../types/index.js';
 /**
  * Generate a self-contained HTML technical report for a single spec.
- * Includes: header, Mermaid diagrams, affected files, architectural decisions.
+ * Includes: header, scope, diagrams, impact analysis, affected files,
+ * architectural decisions, acceptance criteria, living spec, estimation reasoning.
+ * All rich sections are conditionally rendered based on data availability.
  */
 export declare function generatePerSpecTechnicalReport(spec: Spec, diagrams: SpecDiagram[], affectedFiles: string[], architecturalDecisions: string[]): GeneratedDocument;
 //# sourceMappingURL=technical-report.d.ts.map

package/dist/engine/doc-generator/per-spec-report/technical-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-report.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/per-spec-report/technical-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAWpF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,WAAW,EAAE,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,sBAAsB,EAAE,MAAM,EAAE,GAC/B,iBAAiB,CAuCnB"}
+{"version":3,"file":"technical-report.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/per-spec-report/technical-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAepF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,WAAW,EAAE,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,sBAAsB,EAAE,MAAM,EAAE,GAC/B,iBAAiB,CAuDnB"}

package/dist/engine/doc-generator/per-spec-report/technical-report.js

@@ -1,27 +1,37 @@
 import { extractPerSpecData } from './spec-data-extractor.js';
-import { buildSpecHeaderSection, buildAffectedFilesSection, buildArchDecisionsSection, buildSpecFooterSection, } from './spec-section-builders.js';
+import { buildSpecHeaderSection, buildAffectedFilesSection, buildArchDecisionsSection, buildSpecFooterSection, buildImpactAnalysisSection, buildEstimationReasoningSection, buildLivingSpecSection, buildAcceptanceCriteriaSection, } from './spec-section-builders.js';
 import { renderMermaidDiagrams, getMermaidScript } from './mermaid-renderer.js';
 import { wrapPerSpecHtml } from './html-wrapper.js';
 /**
  * Generate a self-contained HTML technical report for a single spec.
- * Includes: header, Mermaid diagrams, affected files, architectural decisions.
+ * Includes: header, scope, diagrams, impact analysis, affected files,
+ * architectural decisions, acceptance criteria, living spec, estimation reasoning.
+ * All rich sections are conditionally rendered based on data availability.
  */
 export function generatePerSpecTechnicalReport(spec, diagrams, affectedFiles, architecturalDecisions) {
     const data = extractPerSpecData(spec, affectedFiles, architecturalDecisions);
-    const scopeInfo = `<div class="section">
-  <h2>Scope</h2>
-  <p><strong>Scope:</strong> ${escapeHtml(data.scope)} &middot; <strong>Target:</strong> ${escapeHtml(data.target)}</p>
-  ${data.gitBranch ? `<p><strong>Branch:</strong> <code>${escapeHtml(data.gitBranch)}</code></p>` : ''}
-</div>`;
+    const scopeInfo = buildScopeSection(data.scope, data.target, data.gitBranch);
     const diagramsSection = diagrams.length > 0
         ? `<div class="section"><h2>Diagrams</h2>${renderMermaidDiagrams(diagrams)}</div>`
         : '';
+    const impactSection = data.impactAnalysis !== undefined ? buildImpactAnalysisSection(data.impactAnalysis) : '';
+    const acSection = data.acceptanceCriteria !== undefined && data.acceptanceCriteria.length > 0
+        ? buildAcceptanceCriteriaSection(data.acceptanceCriteria)
+        : '';
+    const livingSection = data.livingSpec !== undefined ? buildLivingSpecSection(data.livingSpec) : '';
+    const reasoningSection = data.estimationReasoning !== undefined && data.estimationReasoning.length > 0
+        ? buildEstimationReasoningSection(data.estimationReasoning)
+        : '';
     const body = [
         buildSpecHeaderSection(data),
         scopeInfo,
         diagramsSection,
+        impactSection,
         buildAffectedFilesSection(data.affectedFiles),
         buildArchDecisionsSection(data.architecturalDecisions),
+        acSection,
+        livingSection,
+        reasoningSection,
         buildSpecFooterSection(),
     ]
         .filter(Boolean)
@@ -40,6 +50,13 @@ export function generatePerSpecTechnicalReport(spec, diagrams, affectedFiles, ar
         relatedSpecs: [data.specId],
     };
 }
+function buildScopeSection(scope, target, gitBranch) {
+    return `<div class="section">
+  <h2>Scope</h2>
+  <p><strong>Scope:</strong> ${escapeHtml(scope)} &middot; <strong>Target:</strong> ${escapeHtml(target)}</p>
+  ${gitBranch ? `<p><strong>Branch:</strong> <code>${escapeHtml(gitBranch)}</code></p>` : ''}
+</div>`;
+}
 function escapeHtml(str) {
     return str
         .replace(/&/g, '&amp;')

package/dist/engine/doc-generator/per-spec-report/technical-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-report.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/per-spec-report/technical-report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,IAAU,EACV,QAAuB,EACvB,aAAuB,EACvB,sBAAgC;IAEhC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAE7E,MAAM,SAAS,GAAG;;+BAEW,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,sCAAsC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9G,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,qCAAqC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE;OAC/F,CAAC;IAEN,MAAM,eAAe,GACnB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,yCAAyC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ;QAClF,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,IAAI,GAAG;QACX,sBAAsB,CAAC,IAAI,CAAC;QAC5B,SAAS;QACT,eAAe;QACf,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7C,yBAAyB,CAAC,IAAI,CAAC,sBAAsB,CAAC;QACtD,sBAAsB,EAAE;KACzB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,sBAAsB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IAE5D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,KAAK;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO;QACP,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,EAAE;QACZ,QAAQ;QACR,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;KAC5B,CAAC;AACJ,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"}
+{"version":3,"file":"technical-report.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/per-spec-report/technical-report.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/portal/analytics-page.d.ts

@@ -0,0 +1,8 @@
+import type { Spec } from '../../../types/index.js';
+import type { MetricsHistory } from '../../../types/project/config-metrics.js';
+/**
+ * Generate the full analytics.html page for the Planu portal.
+ * Returns an HTML string ready to write to disk.
+ */
+export declare function generateAnalyticsPage(specs: Spec[], metrics?: MetricsHistory): string;
+//# sourceMappingURL=analytics-page.d.ts.map

package/dist/engine/doc-generator/portal/analytics-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/analytics-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAa/E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAkDrF"}

package/dist/engine/doc-generator/portal/analytics-page.js

@@ -0,0 +1,265 @@
+import { getPortalThemeCSS } from './portal-theme.js';
+import { buildNavbar } from './portal-navbar.js';
+import { buildSvgBarChart } from './svg-charts/bar-chart.js';
+import { buildSvgDualLineChart } from './svg-charts/line-chart.js';
+import { buildSvgPieChart } from './svg-charts/pie-chart.js';
+import { CHART_COLORS } from './svg-charts/chart-utils.js';
+import { computeVelocity } from './data-aggregators/velocity-aggregator.js';
+import { computeBurndown } from './data-aggregators/burndown-aggregator.js';
+import { detectBottlenecks } from './data-aggregators/bottleneck-detector.js';
+import { computeAccuracy } from './data-aggregators/accuracy-aggregator.js';
+/**
+ * Generate the full analytics.html page for the Planu portal.
+ * Returns an HTML string ready to write to disk.
+ */
+export function generateAnalyticsPage(specs, metrics) {
+    const navbar = buildNavbar('analytics', '', ['analytics', 'dashboard']);
+    const kpiHtml = buildKpiSection(specs);
+    const burndownHtml = buildBurndownSection(specs);
+    const velocityHtml = buildVelocitySection(specs);
+    const accuracyHtml = buildAccuracySection(specs, metrics);
+    const distributionHtml = buildDistributionSection(specs);
+    const bottleneckHtml = buildBottleneckSection(specs);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width,initial-scale=1"/>
+<title>Analytics — Planu</title>
+<style>
+${getPortalThemeCSS()}
+${ANALYTICS_CSS}
+</style>
+</head>
+<body>
+${navbar}
+<main class="analytics-main">
+  <h1 class="analytics-title">📈 Analytics</h1>
+  ${kpiHtml}
+  <div class="analytics-charts-row">
+    <section class="planu-card analytics-section">
+      <h2>Burn-down</h2>
+      ${burndownHtml}
+    </section>
+    <section class="planu-card analytics-section">
+      <h2>Velocity</h2>
+      ${velocityHtml}
+    </section>
+  </div>
+  <section class="planu-card analytics-section">
+    <h2>Estimated vs Actual Hours</h2>
+    ${accuracyHtml}
+  </section>
+  <section class="planu-card analytics-section">
+    <h2>Distribution</h2>
+    ${distributionHtml}
+  </section>
+  <section class="planu-card analytics-section">
+    <h2>Bottlenecks</h2>
+    ${bottleneckHtml}
+  </section>
+</main>
+</body>
+</html>`;
+}
+// --- Section builders ---
+function buildKpiSection(specs) {
+    if (specs.length === 0) {
+        return '<p class="analytics-empty">No specs available.</p>';
+    }
+    const total = specs.length;
+    const done = specs.filter((s) => s.status === 'done').length;
+    const pct = total > 0 ? Math.round((done / total) * 100) : 0;
+    const accuracyRecords = computeAccuracy(specs);
+    const avgAccuracy = accuracyRecords.length > 0
+        ? Math.round(accuracyRecords.reduce((s, r) => s + r.accuracy, 0) / accuracyRecords.length)
+        : 0;
+    const totalHours = specs.reduce((s, sp) => s + sp.estimation.devHours, 0);
+    const velocity = computeVelocity(specs);
+    const avgVelocity = velocity.length > 0
+        ? Math.round(velocity.reduce((s, v) => s + v.count, 0) / velocity.length)
+        : 0;
+    const kpis = [
+        { label: 'Total Specs', value: String(total), icon: '📋' },
+        { label: 'Done', value: String(done), icon: '✅' },
+        { label: 'Completion', value: `${pct}%`, icon: '📊' },
+        { label: 'Avg Accuracy', value: `${avgAccuracy}%`, icon: '🎯' },
+        { label: 'Total Hours', value: String(totalHours), icon: '⏱️' },
+        { label: 'Avg Velocity', value: `${avgVelocity}/mo`, icon: '🚀' },
+    ];
+    const cards = kpis
+        .map((k) => `<div class="kpi-card planu-card">
+  <div class="kpi-icon">${k.icon}</div>
+  <div class="kpi-value">${escapeHtml(k.value)}</div>
+  <div class="kpi-label">${escapeHtml(k.label)}</div>
+</div>`)
+        .join('\n');
+    return `<div class="kpi-row">${cards}</div>`;
+}
+function buildBurndownSection(specs) {
+    const points = computeBurndown(specs);
+    if (points.length === 0) {
+        return '<p class="analytics-empty">Insufficient data for burndown.</p>';
+    }
+    const series1 = points.map((p, i) => ({ x: i, y: p.remaining, label: p.date }));
+    const series2 = points.map((p, i) => ({ x: i, y: p.ideal }));
+    return buildSvgDualLineChart(series1, series2, {
+        title: 'Remaining vs Ideal',
+        label1: 'Remaining',
+        label2: 'Ideal',
+        showDots: false,
+    });
+}
+function buildVelocitySection(specs) {
+    const velocity = computeVelocity(specs);
+    if (velocity.length === 0) {
+        return '<p class="analytics-empty">No completed specs with dates.</p>';
+    }
+    const data = velocity.map((v, i) => ({
+        label: v.period,
+        value: v.count,
+        color: CHART_COLORS[i % CHART_COLORS.length],
+    }));
+    return buildSvgBarChart(data, { title: 'Specs Completed per Month' });
+}
+function buildAccuracySection(specs, _metrics) {
+    const records = computeAccuracy(specs);
+    if (records.length === 0) {
+        return '<p class="analytics-empty">No completed specs with estimation data.</p>';
+    }
+    const estimated = records.map((r) => ({
+        label: r.specId,
+        value: r.estimated,
+        color: CHART_COLORS[0],
+    }));
+    const actual = records.map((r) => ({
+        label: r.specId,
+        value: r.actual,
+        color: CHART_COLORS[1],
+    }));
+    const estSvg = buildSvgBarChart(estimated, { title: 'Estimated Hours' });
+    const actSvg = buildSvgBarChart(actual, { title: 'Actual Hours' });
+    return `<div class="analytics-charts-row">${estSvg}${actSvg}</div>`;
+}
+function buildDistributionSection(specs) {
+    if (specs.length === 0) {
+        return '<p class="analytics-empty">No specs to distribute.</p>';
+    }
+    const byType = countBy(specs, (s) => s.type);
+    const byRisk = countBy(specs, (s) => s.risk);
+    const byDifficulty = countBy(specs, (s) => String(s.difficulty));
+    const typePie = buildSvgPieChart(mapToPieSlices(byType));
+    const riskPie = buildSvgPieChart(mapToPieSlices(byRisk));
+    const diffPie = buildSvgPieChart(mapToPieSlices(byDifficulty));
+    return `<div class="distribution-row">
+  <div class="distribution-col">
+    <h3>By Type</h3>${typePie}
+  </div>
+  <div class="distribution-col">
+    <h3>By Risk</h3>${riskPie}
+  </div>
+  <div class="distribution-col">
+    <h3>By Difficulty</h3>${diffPie}
+  </div>
+</div>`;
+}
+function buildBottleneckSection(specs) {
+    const bottlenecks = detectBottlenecks(specs);
+    if (bottlenecks.length === 0) {
+        return '<p class="analytics-empty">No bottlenecks detected. 🎉</p>';
+    }
+    const rows = bottlenecks.map((b) => {
+        const badgeClass = b.staleDays > 30 ? 'planu-badge-danger' : 'planu-badge-warning';
+        return `<tr>
+  <td>${escapeHtml(b.specId)}</td>
+  <td>${escapeHtml(b.title)}</td>
+  <td><span class="planu-badge planu-badge-muted">${escapeHtml(b.status)}</span></td>
+  <td><span class="planu-badge ${badgeClass}">${b.staleDays}d</span></td>
+</tr>`;
+    });
+    return `<table class="bottleneck-table">
+<thead>
+  <tr><th>ID</th><th>Title</th><th>Status</th><th>Stale</th></tr>
+</thead>
+<tbody>
+${rows.join('\n')}
+</tbody>
+</table>`;
+}
+// --- Helpers ---
+function countBy(arr, key) {
+    const map = new Map();
+    for (const item of arr) {
+        const k = key(item);
+        map.set(k, (map.get(k) ?? 0) + 1);
+    }
+    return map;
+}
+function mapToPieSlices(counts) {
+    return Array.from(counts.entries()).map(([label, value], i) => ({
+        label,
+        value,
+        color: CHART_COLORS[i % CHART_COLORS.length] ?? '#e94560',
+    }));
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const ANALYTICS_CSS = `
+  .analytics-main {
+    max-width: 1100px;
+    margin: 0 auto;
+    padding: 0 16px 40px;
+  }
+  .analytics-title { font-size: 1.5rem; color: var(--planu-primary); margin-bottom: 20px; }
+  .analytics-empty { color: #9ca3af; font-style: italic; padding: 12px 0; }
+  .analytics-section { margin-bottom: 24px; }
+  .analytics-section h2 {
+    font-size: 1.05rem;
+    color: var(--planu-secondary);
+    margin-bottom: 14px;
+    border-bottom: 1px solid var(--planu-border);
+    padding-bottom: 6px;
+  }
+  .analytics-charts-row {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 16px;
+    margin-bottom: 24px;
+  }
+  @media (max-width: 700px) { .analytics-charts-row { grid-template-columns: 1fr; } }
+  .kpi-row {
+    display: grid;
+    grid-template-columns: repeat(6, 1fr);
+    gap: 12px;
+    margin-bottom: 24px;
+  }
+  @media (max-width: 900px) { .kpi-row { grid-template-columns: repeat(3, 1fr); } }
+  @media (max-width: 500px) { .kpi-row { grid-template-columns: repeat(2, 1fr); } }
+  .kpi-card { text-align: center; padding: 14px 10px; }
+  .kpi-icon { font-size: 1.6rem; margin-bottom: 4px; }
+  .kpi-value { font-size: 1.5rem; font-weight: 700; color: var(--planu-primary); }
+  .kpi-label { font-size: 0.75rem; color: #6b7280; margin-top: 2px; }
+  .distribution-row {
+    display: grid;
+    grid-template-columns: repeat(3, 1fr);
+    gap: 16px;
+  }
+  @media (max-width: 700px) { .distribution-row { grid-template-columns: 1fr; } }
+  .distribution-col h3 { font-size: 0.9rem; color: #4b5563; margin-bottom: 8px; text-align: center; }
+  .bottleneck-table { width: 100%; border-collapse: collapse; font-size: 0.85rem; }
+  .bottleneck-table th {
+    background: #f3f4f6;
+    text-align: left;
+    padding: 8px 10px;
+    font-size: 0.8rem;
+    color: #6b7280;
+  }
+  .bottleneck-table td { padding: 8px 10px; border-bottom: 1px solid #f3f4f6; }
+  @media print { .analytics-charts-row { grid-template-columns: 1fr; } }
+`;
+//# sourceMappingURL=analytics-page.js.map

package/dist/engine/doc-generator/portal/analytics-page.js.map

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

package/dist/engine/doc-generator/portal/architecture-page.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectKnowledge } from '../../../types/project/core.js';
+/**
+ * Generate the architecture.html portal page.
+ */
+export declare function generateArchitecturePage(knowledge: ProjectKnowledge): string;
+//# sourceMappingURL=architecture-page.d.ts.map

package/dist/engine/doc-generator/portal/architecture-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-page.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/architecture-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,gCAAgC,CAAC;AAuPnF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAoC5E"}

package/dist/engine/doc-generator/portal/architecture-page.js

@@ -0,0 +1,250 @@
+import { buildNavbar } from './portal-navbar.js';
+import { getPortalThemeCSS } from './portal-theme.js';
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const TECH_ICONS = {
+    typescript: '🔷',
+    javascript: '🟡',
+    python: '🐍',
+    rust: '🦀',
+    go: '🐹',
+    java: '☕',
+    ruby: '💎',
+    php: '🐘',
+    swift: '🍎',
+    kotlin: '🟣',
+    'c#': '🔵',
+    elixir: '💧',
+    next: '▲',
+    nextjs: '▲',
+    react: '⚛️',
+    vue: '💚',
+    angular: '🔴',
+    svelte: '🔥',
+    express: '🚂',
+    fastapi: '⚡',
+    django: '🟢',
+    rails: '💎',
+    laravel: '🔴',
+    spring: '🌿',
+    postgres: '🐘',
+    postgresql: '🐘',
+    mysql: '🐬',
+    mongodb: '🍃',
+    redis: '🔴',
+    sqlite: '📦',
+    prisma: '⬟',
+    drizzle: '💧',
+    pnpm: '📦',
+    npm: '📦',
+    yarn: '🧶',
+    bun: '🐰',
+    vite: '⚡',
+    webpack: '📦',
+    esbuild: '⚡',
+    docker: '🐋',
+    kubernetes: '☸️',
+    node: '🟢',
+};
+function techIcon(name) {
+    const key = name.toLowerCase();
+    return TECH_ICONS[key] ?? '🔧';
+}
+function buildStackCards(knowledge) {
+    const entries = [
+        { key: 'language', label: 'Language', value: knowledge.language },
+        { key: 'framework', label: 'Framework', value: knowledge.framework },
+        { key: 'database', label: 'Database', value: knowledge.database },
+        { key: 'orm', label: 'ORM', value: knowledge.orm },
+        { key: 'packageManager', label: 'Package Manager', value: knowledge.packageManager },
+    ];
+    const buildToolName = knowledge.buildTool?.buildTool ?? null;
+    if (buildToolName && buildToolName !== 'unknown') {
+        entries.push({ key: 'buildTool', label: 'Build Tool', value: buildToolName });
+    }
+    const cards = entries
+        .filter((e) => e.value !== null && e.value !== 'none' && e.value !== 'null')
+        .map((e) => {
+        const icon = techIcon(e.value);
+        return `<div class="stack-card planu-card">
+        <div class="stack-icon">${icon}</div>
+        <div class="stack-info">
+          <div class="stack-label">${escapeHtml(e.label)}</div>
+          <div class="stack-value">${escapeHtml(e.value)}</div>
+        </div>
+      </div>`;
+    })
+        .join('\n');
+    if (!cards) {
+        return '<p class="empty-message">No stack information detected.</p>';
+    }
+    return `<div class="stack-grid">${cards}</div>`;
+}
+function buildLayersSection(knowledge) {
+    const layers = knowledge.architecture.layers;
+    if (layers.length === 0) {
+        return '';
+    }
+    const boxes = layers
+        .map((layer) => `<div class="layer-box">
+        <div class="layer-name">${escapeHtml(layer.name)}</div>
+        <div class="layer-resp">${escapeHtml(layer.responsibility)}</div>
+        ${layer.directories.length > 0 ? `<div class="layer-dirs">${layer.directories.map((d) => `<code>${escapeHtml(d)}</code>`).join(' ')}</div>` : ''}
+      </div>`)
+        .join('\n    <div class="layer-arrow">↓</div>\n    ');
+    return `<section class="planu-card section-card">
+    <h2>Architecture Layers</h2>
+    <div class="layers-stack">
+      ${boxes}
+    </div>
+  </section>`;
+}
+function appTypeIcon(type) {
+    const icons = {
+        frontend: '🖥️',
+        backend: '⚙️',
+        mobile: '📱',
+        ios: '🍎',
+        android: '🤖',
+        desktop: '💻',
+        shared: '📦',
+        worker: '⚡',
+        docs: '📄',
+    };
+    return icons[type] ?? '📦';
+}
+function buildAppsSection(knowledge) {
+    const { apps } = knowledge;
+    if (apps.length === 0) {
+        return '';
+    }
+    const cards = apps
+        .map((app) => `<div class="app-card planu-card">
+        <div class="app-header">
+          <span class="app-icon">${appTypeIcon(app.type)}</span>
+          <span class="app-name">${escapeHtml(app.name)}</span>
+          <span class="app-type-badge">${escapeHtml(app.type)}</span>
+        </div>
+        <div class="app-details">
+          <span>${escapeHtml(app.language)}</span>
+          ${app.framework ? `<span class="sep">·</span><span>${escapeHtml(app.framework)}</span>` : ''}
+          ${app.database ? `<span class="sep">·</span><span>DB: ${escapeHtml(app.database)}</span>` : ''}
+        </div>
+        ${app.path ? `<div class="app-path"><code>${escapeHtml(app.path)}</code></div>` : ''}
+      </div>`)
+        .join('\n');
+    return `<section class="planu-card section-card">
+    <h2>Applications</h2>
+    <div class="apps-grid">${cards}</div>
+  </section>`;
+}
+function buildConventionsSection(knowledge) {
+    const entries = Object.entries(knowledge.conventions);
+    if (entries.length === 0) {
+        return '';
+    }
+    const rows = entries
+        .map(([k, v]) => `<tr>
+      <td class="conv-key">${escapeHtml(k)}</td>
+      <td>${escapeHtml(v)}</td>
+    </tr>`)
+        .join('\n');
+    return `<section class="planu-card section-card">
+    <h2>Conventions</h2>
+    <table class="simple-table">
+      <thead><tr><th>Convention</th><th>Value</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>
+  </section>`;
+}
+function buildExternalServicesSection(knowledge) {
+    const services = knowledge.externalServices;
+    if (services.length === 0) {
+        return '';
+    }
+    const items = services.map((s) => `<li class="service-item">🔌 ${escapeHtml(s)}</li>`).join('\n');
+    return `<section class="planu-card section-card">
+    <h2>External Services</h2>
+    <ul class="services-list">${items}</ul>
+  </section>`;
+}
+function buildPageCSS() {
+    return `
+  body { font-family: system-ui, sans-serif; margin: 0; padding: 0 16px 48px; background: var(--planu-bg); color: var(--planu-text); }
+  .page-title { font-size: 1.6rem; font-weight: 700; margin: 0 0 6px; }
+  .page-subtitle { color: #6b7280; margin: 0 0 24px; font-size: 0.95rem; }
+  .section-card { margin-bottom: 24px; }
+  h2 { font-size: 1.1rem; font-weight: 600; margin: 0 0 16px; color: var(--planu-primary); }
+  .stack-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(160px, 1fr)); gap: 12px; }
+  .stack-card { display: flex; align-items: center; gap: 10px; padding: 12px; }
+  .stack-icon { font-size: 1.8rem; }
+  .stack-label { font-size: 0.75rem; color: #6b7280; }
+  .stack-value { font-weight: 600; font-size: 0.9rem; }
+  .layers-stack { display: flex; flex-direction: column; align-items: center; gap: 0; }
+  .layer-box { width: 100%; max-width: 560px; padding: 12px 16px; background: white; border: 1px solid var(--planu-border); border-radius: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+  .layer-name { font-weight: 700; color: var(--planu-primary); margin-bottom: 2px; }
+  .layer-resp { font-size: 0.84rem; color: #4b5563; }
+  .layer-dirs { margin-top: 6px; font-size: 0.78rem; color: #6b7280; }
+  .layer-dirs code { background: #f3f4f6; padding: 1px 4px; border-radius: 3px; margin-right: 4px; }
+  .layer-arrow { font-size: 1.2rem; color: #9ca3af; }
+  .apps-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(220px, 1fr)); gap: 12px; }
+  .app-card { padding: 12px 14px; }
+  .app-header { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; }
+  .app-icon { font-size: 1.4rem; }
+  .app-name { font-weight: 700; }
+  .app-type-badge { font-size: 0.75rem; padding: 2px 6px; border-radius: 4px; background: #f3f4f6; color: #374151; }
+  .app-details { font-size: 0.82rem; color: #6b7280; }
+  .sep { margin: 0 4px; color: #d1d5db; }
+  .app-path { margin-top: 6px; font-size: 0.75rem; color: #9ca3af; }
+  .app-path code { background: #f9fafb; padding: 1px 4px; border-radius: 3px; }
+  .simple-table { width: 100%; border-collapse: collapse; font-size: 0.83rem; }
+  .simple-table th { background: #f3f4f6; padding: 8px 10px; text-align: left; border-bottom: 2px solid var(--planu-border); }
+  .simple-table td { padding: 8px 10px; border-bottom: 1px solid var(--planu-border); }
+  .conv-key { font-weight: 600; color: var(--planu-primary); }
+  .services-list { list-style: none; padding: 0; margin: 0; display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 8px; }
+  .service-item { padding: 8px 12px; background: #f9fafb; border-radius: 6px; font-size: 0.86rem; }
+  .empty-state { text-align: center; padding: 64px 24px; color: #6b7280; }
+  .empty-message { color: #9ca3af; font-style: italic; }`;
+}
+/**
+ * Generate the architecture.html portal page.
+ */
+export function generateArchitecturePage(knowledge) {
+    const navbar = buildNavbar('architecture', '');
+    const themeCSS = getPortalThemeCSS();
+    const pageCSS = buildPageCSS();
+    const hasContent = knowledge.language !== '' || knowledge.framework !== null || knowledge.apps.length > 0;
+    const bodyContent = hasContent
+        ? `<section class="planu-card section-card">
+    <h2>Tech Stack</h2>
+    ${buildStackCards(knowledge)}
+  </section>
+  ${buildLayersSection(knowledge)}
+  ${buildAppsSection(knowledge)}
+  ${buildConventionsSection(knowledge)}
+  ${buildExternalServicesSection(knowledge)}`
+        : `<div class="empty-state"><h3>No architecture data available</h3><p>Run <code>scan_project</code> to populate this page.</p></div>`;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Architecture — Planu Portal</title>
+  <style>${themeCSS}${pageCSS}</style>
+</head>
+<body>
+  ${navbar}
+  <main>
+    <h1 class="page-title">🔧 Architecture</h1>
+    <p class="page-subtitle">Tech stack, layers, apps, and conventions for this project.</p>
+    ${bodyContent}
+  </main>
+</body>
+</html>`;
+}
+//# sourceMappingURL=architecture-page.js.map

package/dist/engine/doc-generator/portal/architecture-page.js.map

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