@planu/cli 0.55.0 → 0.56.0

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

@@ -0,0 +1,219 @@
+import { buildNavbar } from './portal-navbar.js';
+import { getPortalThemeCSS } from './portal-theme.js';
+import { buildRiskMatrixSvg } from './risk-matrix-svg.js';
+import { buildRiskGaugeSvg } from './risk-gauge-svg.js';
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const STATUS_BADGE = {
+    identified: 'planu-badge-muted',
+    mitigating: 'planu-badge-info',
+    mitigated: 'planu-badge-success',
+    accepted: 'planu-badge-warning',
+    materialized: 'planu-badge-danger',
+};
+function statusBadge(status) {
+    const cls = STATUS_BADGE[status];
+    return `<span class="planu-badge ${cls}">${escapeHtml(status)}</span>`;
+}
+function categoryBadge(cat) {
+    const colors = {
+        technical: 'planu-badge-info',
+        security: 'planu-badge-danger',
+        integration: 'planu-badge-warning',
+        dependency: 'planu-badge-muted',
+        organizational: 'planu-badge-muted',
+        data: 'planu-badge-success',
+    };
+    return `<span class="planu-badge ${colors[cat]}">${escapeHtml(cat)}</span>`;
+}
+function buildRiskTable(allRisks, specMap) {
+    if (allRisks.length === 0) {
+        return `<p class="empty-message">No risks registered yet.</p>`;
+    }
+    const rows = allRisks
+        .map((r) => {
+        const specTitle = specMap.get(r.specId) ?? r.specId;
+        return `<tr>
+        <td>${escapeHtml(r.id)}</td>
+        <td title="${escapeHtml(r.specId)}">${escapeHtml(specTitle)}</td>
+        <td>${escapeHtml(r.description)}</td>
+        <td>${categoryBadge(r.category)}</td>
+        <td class="num">${r.probability}%</td>
+        <td class="num">$${r.impactUsd.toLocaleString()}</td>
+        <td class="num">${r.impactDays}d</td>
+        <td>${escapeHtml(r.mitigationPlan || '—')}</td>
+        <td>${escapeHtml(r.owner || '—')}</td>
+        <td>${statusBadge(r.status)}</td>
+      </tr>`;
+    })
+        .join('\n');
+    return `<div class="table-wrap">
+    <table class="risk-table sortable">
+      <thead>
+        <tr>
+          <th>ID</th>
+          <th>Spec</th>
+          <th>Description</th>
+          <th>Category</th>
+          <th class="sortable-col">Probability</th>
+          <th class="sortable-col">Impact $</th>
+          <th class="sortable-col">Impact Days</th>
+          <th>Mitigation</th>
+          <th>Owner</th>
+          <th>Status</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${rows}
+      </tbody>
+    </table>
+  </div>`;
+}
+function buildCoverageSection(allRisks) {
+    if (allRisks.length === 0) {
+        return '';
+    }
+    const total = allRisks.length;
+    const withPlan = allRisks.filter((r) => r.mitigationPlan && r.mitigationPlan.trim().length > 0).length;
+    const mitigated = allRisks.filter((r) => r.status === 'mitigated').length;
+    const noOwner = allRisks.filter((r) => !r.owner || r.owner.trim() === '').length;
+    const planPct = Math.round((withPlan / total) * 100);
+    const mitigatedPct = Math.round((mitigated / total) * 100);
+    const warning = noOwner > 0
+        ? `<div class="coverage-warning">⚠️ <strong>${noOwner}</strong> risk${noOwner > 1 ? 's' : ''} without an assigned owner.</div>`
+        : '';
+    return `<section class="planu-card section-card">
+    <h2>Mitigation Coverage</h2>
+    <div class="coverage-grid">
+      <div class="coverage-item">
+        <span class="coverage-pct">${planPct}%</span>
+        <span class="coverage-label">With Mitigation Plan</span>
+      </div>
+      <div class="coverage-item">
+        <span class="coverage-pct coverage-green">${mitigatedPct}%</span>
+        <span class="coverage-label">Mitigated</span>
+      </div>
+      <div class="coverage-item">
+        <span class="coverage-pct coverage-red">${noOwner}</span>
+        <span class="coverage-label">Without Owner</span>
+      </div>
+    </div>
+    ${warning}
+  </section>`;
+}
+function buildScoreCard(registers, allRisks) {
+    const avgScore = registers.length > 0
+        ? Math.round(registers.reduce((s, r) => s + r.aggregateRiskScore, 0) / registers.length)
+        : 0;
+    const highCount = allRisks.filter((r) => r.probability >= 60 && r.impactUsd >= 5000).length;
+    const criticalCount = allRisks.filter((r) => r.probability >= 80 && r.impactUsd >= 20000).length;
+    const gaugeSvg = buildRiskGaugeSvg(avgScore);
+    return `<section class="planu-card section-card score-card">
+    <h2>Risk Score</h2>
+    <div class="score-layout">
+      <div class="gauge-wrap">${gaugeSvg}</div>
+      <div class="score-stats">
+        <div class="stat-item">
+          <span class="stat-num">${allRisks.length}</span>
+          <span class="stat-label">Total Risks</span>
+        </div>
+        <div class="stat-item stat-warn">
+          <span class="stat-num">${highCount}</span>
+          <span class="stat-label">High Priority</span>
+        </div>
+        <div class="stat-item stat-danger">
+          <span class="stat-num">${criticalCount}</span>
+          <span class="stat-label">Critical</span>
+        </div>
+        <div class="stat-item">
+          <span class="stat-num">${registers.length}</span>
+          <span class="stat-label">Specs with Risks</span>
+        </div>
+      </div>
+    </div>
+  </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); }
+  .matrix-wrap { overflow-x: auto; }
+  .matrix-wrap svg { max-width: 100%; height: auto; }
+  .table-wrap { overflow-x: auto; }
+  .risk-table { width: 100%; border-collapse: collapse; font-size: 0.82rem; }
+  .risk-table th { background: #f3f4f6; text-align: left; padding: 8px 10px; font-weight: 600; white-space: nowrap; border-bottom: 2px solid var(--planu-border); }
+  .risk-table td { padding: 8px 10px; border-bottom: 1px solid var(--planu-border); vertical-align: top; }
+  .risk-table tr:hover td { background: #f9fafb; }
+  .risk-table .num { text-align: right; white-space: nowrap; }
+  .score-layout { display: flex; align-items: flex-start; gap: 24px; flex-wrap: wrap; }
+  .gauge-wrap { width: 200px; flex-shrink: 0; }
+  .gauge-wrap svg { width: 100%; height: auto; }
+  .score-stats { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; flex: 1; }
+  .stat-item { text-align: center; padding: 12px; background: #f9fafb; border-radius: 8px; }
+  .stat-num { display: block; font-size: 1.8rem; font-weight: 700; color: var(--planu-primary); }
+  .stat-warn .stat-num { color: var(--planu-warning); }
+  .stat-danger .stat-num { color: var(--planu-danger); }
+  .stat-label { font-size: 0.78rem; color: #6b7280; }
+  .coverage-grid { display: flex; gap: 24px; flex-wrap: wrap; }
+  .coverage-item { text-align: center; min-width: 100px; }
+  .coverage-pct { display: block; font-size: 2rem; font-weight: 700; color: var(--planu-primary); }
+  .coverage-green { color: var(--planu-success); }
+  .coverage-red { color: var(--planu-danger); }
+  .coverage-label { font-size: 0.82rem; color: #6b7280; }
+  .coverage-warning { margin-top: 12px; padding: 10px 14px; background: #fef3c7; border-radius: 8px; font-size: 0.88rem; color: #92400e; }
+  .empty-state { text-align: center; padding: 48px 24px; color: #6b7280; }
+  .empty-state h3 { font-size: 1.2rem; margin-bottom: 8px; }
+  .empty-message { color: #9ca3af; font-style: italic; }`;
+}
+/**
+ * Generate the risks.html portal page.
+ */
+export function generateRiskPage(risks, specs) {
+    const specMap = new Map(specs.map((s) => [s.id, s.title]));
+    const allRisks = risks.flatMap((r) => r.risks);
+    const navbar = buildNavbar('risks', '');
+    const themeCSS = getPortalThemeCSS();
+    const pageCSS = buildPageCSS();
+    const matrixSvg = buildRiskMatrixSvg(allRisks);
+    const matrixSection = allRisks.length > 0
+        ? `<section class="planu-card section-card">
+    <h2>Risk Matrix</h2>
+    <div class="matrix-wrap">${matrixSvg}</div>
+  </section>`
+        : '';
+    const bodyContent = allRisks.length === 0
+        ? `<div class="empty-state"><h3>No risk data available</h3><p>Use <code>estimate</code> with risk analysis to populate this page.</p></div>`
+        : `${buildScoreCard(risks, allRisks)}
+  ${matrixSection}
+  <section class="planu-card section-card">
+    <h2>Risk Registry</h2>
+    ${buildRiskTable(allRisks, specMap)}
+  </section>
+  ${buildCoverageSection(allRisks)}`;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Risks — Planu Portal</title>
+  <style>${themeCSS}${pageCSS}</style>
+</head>
+<body>
+  ${navbar}
+  <main>
+    <h1 class="page-title">⚠️ Risk Register</h1>
+    <p class="page-subtitle">Risk matrix, registry, and mitigation coverage across all specs.</p>
+    ${bodyContent}
+  </main>
+</body>
+</html>`;
+}
+//# sourceMappingURL=risk-page.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-page.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/roadmap-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAKpD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAqClF"}

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

@@ -0,0 +1,204 @@
+import { getPortalThemeCSS } from './portal-theme.js';
+import { buildNavbar } from './portal-navbar.js';
+import { buildGanttChart } from '../proposal/proposal-gantt-builder.js';
+/**
+ * Generate the full roadmap.html page for the Planu portal.
+ * Returns an HTML string ready to write to disk.
+ */
+export function generateRoadmapPage(specs, ganttStartDate) {
+    const navbar = buildNavbar('roadmap', '', ['roadmap', 'dashboard']);
+    const ganttHtml = buildGanttSection(specs, ganttStartDate);
+    const phaseSummary = buildPhaseSummary(specs);
+    const milestonesHtml = buildMilestonesSection(specs);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width,initial-scale=1"/>
+<title>Roadmap — Planu</title>
+<style>
+${getPortalThemeCSS()}
+${ROADMAP_CSS}
+</style>
+</head>
+<body>
+${navbar}
+<main class="roadmap-main">
+  <h1 class="roadmap-title">🗺️ Roadmap</h1>
+  <section class="planu-card roadmap-section">
+    <h2>Gantt Chart</h2>
+    ${ganttHtml}
+  </section>
+  <section class="planu-card roadmap-section">
+    <h2>Phase Summary</h2>
+    ${phaseSummary}
+  </section>
+  <section class="planu-card roadmap-section">
+    <h2>Milestones</h2>
+    ${milestonesHtml}
+  </section>
+</main>
+</body>
+</html>`;
+}
+// --- Gantt section ---
+function buildGanttSection(specs, startDate) {
+    if (specs.length === 0) {
+        return '<p class="roadmap-empty">No specs to display.</p>';
+    }
+    const gantt = buildGanttChart(specs, undefined, startDate);
+    if (!gantt) {
+        return '<p class="roadmap-empty">Could not generate Gantt chart.</p>';
+    }
+    return gantt;
+}
+// --- Phase summary section ---
+function buildPhaseSummary(specs) {
+    if (specs.length === 0) {
+        return '<p class="roadmap-empty">No specs available.</p>';
+    }
+    const tagMap = new Map();
+    for (const spec of specs) {
+        const tags = spec.tags.length > 0 ? spec.tags : ['untagged'];
+        const primaryTag = tags[0] ?? 'untagged';
+        if (!tagMap.has(primaryTag)) {
+            tagMap.set(primaryTag, []);
+        }
+        const tagSpecs = tagMap.get(primaryTag);
+        if (tagSpecs) {
+            tagSpecs.push(spec);
+        }
+    }
+    const cards = Array.from(tagMap.entries()).map(([tag, tagSpecs]) => {
+        const doneCount = tagSpecs.filter((s) => s.status === 'done').length;
+        const total = tagSpecs.length;
+        const pct = total > 0 ? Math.round((doneCount / total) * 100) : 0;
+        return `<div class="phase-card planu-card">
+  <div class="phase-tag">${escapeHtml(tag)}</div>
+  <div class="phase-progress-bar">
+    <div class="phase-progress-fill" style="width:${pct}%"></div>
+  </div>
+  <div class="phase-stats">${doneCount} / ${total} done (${pct}%)</div>
+</div>`;
+    });
+    return `<div class="phase-grid">${cards.join('\n')}</div>`;
+}
+// --- Milestones section ---
+function buildMilestonesSection(specs) {
+    if (specs.length === 0) {
+        return '<p class="roadmap-empty">No milestones found.</p>';
+    }
+    const sorted = [...specs].sort((a, b) => {
+        const da = a.actuals?.completedAt ?? a.updatedAt;
+        const db = b.actuals?.completedAt ?? b.updatedAt;
+        return da.localeCompare(db);
+    });
+    const items = sorted.map((spec) => {
+        const isDone = spec.status === 'done';
+        const date = spec.actuals?.completedAt ?? spec.updatedAt;
+        const dateLabel = date ? date.slice(0, 10) : '—';
+        const dotClass = isDone ? 'milestone-dot-done' : 'milestone-dot-pending';
+        const depLabels = spec.dependencies.length > 0
+            ? `<div class="milestone-deps">⤵ ${spec.dependencies.map(escapeHtml).join(', ')}</div>`
+            : '';
+        return `<div class="milestone-item">
+  <div class="milestone-dot ${dotClass}"></div>
+  <div class="milestone-body">
+    <div class="milestone-header">
+      <span class="milestone-id">${escapeHtml(spec.id)}</span>
+      <span class="milestone-title">${escapeHtml(spec.title)}</span>
+      <span class="milestone-date">${dateLabel}</span>
+    </div>
+    ${depLabels}
+  </div>
+</div>`;
+    });
+    return `<div class="milestone-timeline">${items.join('\n')}</div>`;
+}
+// --- Helpers ---
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const ROADMAP_CSS = `
+  .roadmap-main {
+    max-width: 1100px;
+    margin: 0 auto;
+    padding: 0 16px 40px;
+  }
+  .roadmap-title { font-size: 1.5rem; color: var(--planu-primary); margin-bottom: 20px; }
+  .roadmap-empty { color: #9ca3af; font-style: italic; padding: 12px 0; }
+  .roadmap-section { margin-bottom: 24px; }
+  .roadmap-section h2 {
+    font-size: 1.05rem;
+    color: var(--planu-secondary);
+    margin-bottom: 14px;
+    border-bottom: 1px solid var(--planu-border);
+    padding-bottom: 6px;
+  }
+  /* Gantt reuse */
+  .gantt-container { overflow-x: auto; }
+  .gantt-header { display: flex; margin-bottom: 4px; }
+  .gantt-header-label { width: 160px; flex-shrink: 0; font-size: 0.75rem; color: #9ca3af; }
+  .gantt-header-weeks { display: flex; flex: 1; gap: 2px; }
+  .gantt-week { flex: 1; font-size: 0.7rem; color: #9ca3af; text-align: center; }
+  .gantt-grid { display: flex; flex-direction: column; gap: 4px; }
+  .gantt-row { display: flex; align-items: center; height: 28px; }
+  .gantt-label { width: 160px; flex-shrink: 0; font-size: 0.78rem; color: #374151; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  .gantt-track { position: relative; flex: 1; height: 20px; background: #f3f4f6; border-radius: 4px; }
+  .gantt-bar {
+    position: absolute;
+    height: 100%;
+    border-radius: 4px;
+    color: white;
+    font-size: 0.68rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    white-space: nowrap;
+    overflow: hidden;
+  }
+  /* Phase cards */
+  .phase-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
+    gap: 12px;
+  }
+  .phase-card { padding: 12px 14px; }
+  .phase-tag { font-weight: 600; font-size: 0.85rem; color: var(--planu-primary); margin-bottom: 8px; }
+  .phase-progress-bar {
+    background: #e9ecef;
+    border-radius: 99px;
+    height: 8px;
+    overflow: hidden;
+    margin-bottom: 6px;
+  }
+  .phase-progress-fill { background: var(--planu-accent); height: 100%; border-radius: 99px; }
+  .phase-stats { font-size: 0.75rem; color: #6b7280; }
+  /* Milestones */
+  .milestone-timeline { display: flex; flex-direction: column; gap: 0; }
+  .milestone-item { display: flex; gap: 12px; padding: 8px 0; border-bottom: 1px solid #f3f4f6; }
+  .milestone-dot {
+    width: 14px;
+    height: 14px;
+    border-radius: 50%;
+    flex-shrink: 0;
+    margin-top: 3px;
+  }
+  .milestone-dot-done { background: var(--planu-success); }
+  .milestone-dot-pending { background: #e9ecef; border: 2px solid #9ca3af; }
+  .milestone-body { flex: 1; }
+  .milestone-header { display: flex; gap: 8px; align-items: baseline; flex-wrap: wrap; }
+  .milestone-id { font-size: 0.72rem; color: #9ca3af; flex-shrink: 0; }
+  .milestone-title { font-size: 0.85rem; color: #2d3436; flex: 1; }
+  .milestone-date { font-size: 0.72rem; color: #6b7280; flex-shrink: 0; }
+  .milestone-deps { font-size: 0.72rem; color: #9ca3af; margin-top: 2px; }
+  @media print {
+    .roadmap-main { max-width: 100%; }
+    .gantt-container { overflow-x: visible; }
+  }
+`;
+//# sourceMappingURL=roadmap-page.js.map

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

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

package/dist/engine/doc-generator/portal/svg-charts/bar-chart.d.ts

@@ -0,0 +1,4 @@
+import type { BarChartData, BarChartOptions } from '../../../../types/portal.js';
+/** Build a responsive SVG bar chart. Returns empty string when data is empty. */
+export declare function buildSvgBarChart(data: BarChartData[], options?: BarChartOptions): string;
+//# sourceMappingURL=bar-chart.d.ts.map

package/dist/engine/doc-generator/portal/svg-charts/bar-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-chart.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/svg-charts/bar-chart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAKjF,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAyCxF"}

package/dist/engine/doc-generator/portal/svg-charts/bar-chart.js

@@ -0,0 +1,50 @@
+import { scaleLinear, svgText, CHART_COLORS, escapeXml } from './chart-utils.js';
+const PADDING = { top: 40, right: 20, bottom: 60, left: 50 };
+/** Build a responsive SVG bar chart. Returns empty string when data is empty. */
+export function buildSvgBarChart(data, options) {
+    if (data.length === 0) {
+        return '';
+    }
+    const vbW = options?.width ?? 500;
+    const vbH = options?.height ?? 300;
+    const title = options?.title ?? '';
+    const innerW = vbW - PADDING.left - PADDING.right;
+    const innerH = vbH - PADDING.top - PADDING.bottom;
+    const maxVal = Math.max(...data.map((d) => d.value), 1);
+    const yScale = scaleLinear([0, maxVal], [innerH, 0]);
+    const barW = Math.max(2, Math.floor(innerW / data.length) - 4);
+    const bars = data.map((d, i) => {
+        const x = PADDING.left + i * (innerW / data.length) + (innerW / data.length - barW) / 2;
+        const barH = innerH - yScale(d.value);
+        const y = PADDING.top + yScale(d.value);
+        const color = d.color ?? CHART_COLORS[i % CHART_COLORS.length] ?? '#e94560';
+        const labelX = x + barW / 2;
+        const labelY = vbH - PADDING.bottom + 16;
+        const shortLabel = d.label.length > 10 ? d.label.slice(0, 9) + '…' : d.label;
+        return `<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${barW}" height="${Math.max(0, barH).toFixed(1)}" fill="${escapeXml(color)}" rx="2"/>
+${svgText(labelX, labelY, shortLabel, { fontSize: 10, anchor: 'middle', fill: '#6b7280' })}
+${svgText(labelX, y - 4, String(d.value), { fontSize: 10, anchor: 'middle', fill: '#2d3436' })}`;
+    });
+    const yTicks = buildYTicks(maxVal, vbW, PADDING, innerH, yScale);
+    const titleEl = title
+        ? svgText(vbW / 2, 20, title, { fontSize: 13, anchor: 'middle', fill: '#1a1a2e' })
+        : '';
+    return `<svg viewBox="0 0 ${vbW} ${vbH}" xmlns="http://www.w3.org/2000/svg" style="width:100%;max-width:${vbW}px">
+  ${titleEl}
+  ${yTicks}
+  ${bars.join('\n  ')}
+  <line x1="${PADDING.left}" y1="${PADDING.top}" x2="${PADDING.left}" y2="${PADDING.top + innerH}" stroke="#e9ecef" stroke-width="1"/>
+  <line x1="${PADDING.left}" y1="${PADDING.top + innerH}" x2="${PADDING.left + innerW}" y2="${PADDING.top + innerH}" stroke="#e9ecef" stroke-width="1"/>
+</svg>`;
+}
+function buildYTicks(maxVal, vbW, padding, _innerH, yScale) {
+    const tickCount = 4;
+    return Array.from({ length: tickCount + 1 }, (_, i) => {
+        const val = (maxVal / tickCount) * i;
+        const y = padding.top + yScale(val);
+        const label = Number.isInteger(val) ? String(val) : val.toFixed(1);
+        return `<line x1="${padding.left}" y1="${y.toFixed(1)}" x2="${padding.left + (vbW - padding.left - padding.right)}" y2="${y.toFixed(1)}" stroke="#f3f4f6" stroke-width="1"/>
+${svgText(padding.left - 6, y + 4, label, { fontSize: 9, anchor: 'end', fill: '#9ca3af' })}`;
+    }).join('\n  ');
+}
+//# sourceMappingURL=bar-chart.js.map

package/dist/engine/doc-generator/portal/svg-charts/bar-chart.js.map

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

package/dist/engine/doc-generator/portal/svg-charts/chart-utils.d.ts

@@ -0,0 +1,16 @@
+/** 8 visually distinct colours for chart series. */
+export declare const CHART_COLORS: string[];
+/**
+ * Create a linear scale function that maps values from [domainMin, domainMax]
+ * to [rangeMin, rangeMax].
+ */
+export declare function scaleLinear(domain: [number, number], range: [number, number]): (val: number) => number;
+/** Render an SVG <text> element. */
+export declare function svgText(x: number, y: number, text: string, opts?: {
+    fontSize?: number;
+    anchor?: string;
+    fill?: string;
+}): string;
+/** Escape XML special chars for safe SVG embedding. */
+export declare function escapeXml(str: string): string;
+//# sourceMappingURL=chart-utils.d.ts.map

package/dist/engine/doc-generator/portal/svg-charts/chart-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-utils.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/svg-charts/chart-utils.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,MAAM,EAWhC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAQzB;AAED,oCAAoC;AACpC,wBAAgB,OAAO,CACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAMR;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/dist/engine/doc-generator/portal/svg-charts/chart-utils.js

@@ -0,0 +1,45 @@
+// Planu — Shared SVG chart utilities
+/** 8 visually distinct colours for chart series. */
+export const CHART_COLORS = [
+    '#e94560',
+    '#0891b2',
+    '#059669',
+    '#d97706',
+    '#7c3aed',
+    '#6366f1',
+    '#0f766e',
+    '#b45309',
+    '#db2777',
+    '#2563eb',
+];
+/**
+ * Create a linear scale function that maps values from [domainMin, domainMax]
+ * to [rangeMin, rangeMax].
+ */
+export function scaleLinear(domain, range) {
+    const [d0, d1] = domain;
+    const [r0, r1] = range;
+    const domainSpan = d1 - d0;
+    if (domainSpan === 0) {
+        return () => r0;
+    }
+    return (val) => r0 + ((val - d0) / domainSpan) * (r1 - r0);
+}
+/** Render an SVG <text> element. */
+export function svgText(x, y, text, opts) {
+    const fontSize = opts?.fontSize ?? 12;
+    const anchor = opts?.anchor ?? 'start';
+    const fill = opts?.fill ?? '#2d3436';
+    const escaped = escapeXml(text);
+    return `<text x="${x}" y="${y}" font-size="${fontSize}" text-anchor="${anchor}" fill="${fill}">${escaped}</text>`;
+}
+/** Escape XML special chars for safe SVG embedding. */
+export function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=chart-utils.js.map

package/dist/engine/doc-generator/portal/svg-charts/chart-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-utils.js","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/svg-charts/chart-utils.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAwB,EACxB,KAAuB;IAEvB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IACvB,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,CAAC;IAC3B,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAW,EAAU,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,OAAO,CACrB,CAAS,EACT,CAAS,EACT,IAAY,EACZ,IAA4D;IAE5D,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,SAAS,CAAC;IACrC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,YAAY,CAAC,QAAQ,CAAC,gBAAgB,QAAQ,kBAAkB,MAAM,WAAW,IAAI,KAAK,OAAO,SAAS,CAAC;AACpH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,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;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/engine/doc-generator/portal/svg-charts/line-chart.d.ts

@@ -0,0 +1,16 @@
+import type { LinePoint, LineChartOptions } from '../../../../types/portal.js';
+/**
+ * Build a responsive SVG line chart for one or two series.
+ * When a second series is passed via options it is drawn with a dashed line.
+ * Returns empty string when points array is empty.
+ */
+export declare function buildSvgLineChart(points: LinePoint[], options?: LineChartOptions): string;
+/**
+ * Build a dual-series SVG line chart (real vs ideal).
+ * Returns empty string when either series is empty.
+ */
+export declare function buildSvgDualLineChart(series1: LinePoint[], series2: LinePoint[], options?: LineChartOptions & {
+    label1?: string;
+    label2?: string;
+}): string;
+//# sourceMappingURL=line-chart.d.ts.map

package/dist/engine/doc-generator/portal/svg-charts/line-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-chart.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/svg-charts/line-chart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAK/E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAgEzF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,CAAC,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CA4ER"}