@planu/cli 0.55.0 → 0.56.0

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

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

@@ -0,0 +1,6 @@
+import type { Spec } from '../../../types/spec/core.js';
+/**
+ * Generate the changelog.html portal page.
+ */
+export declare function generateChangelogPage(specs: Spec[]): string;
+//# sourceMappingURL=changelog-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-page.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/changelog-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AA+LxD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAuC3D"}

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

@@ -0,0 +1,204 @@
+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;');
+}
+function formatDate(dateStr) {
+    try {
+        const d = new Date(dateStr);
+        return d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+    }
+    catch {
+        return escapeHtml(dateStr);
+    }
+}
+function getYearMonth(dateStr) {
+    try {
+        const d = new Date(dateStr);
+        return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function accuracyClass(estimated, actual) {
+    if (estimated <= 0) {
+        return { label: 'N/A', cls: 'planu-badge-muted' };
+    }
+    const ratio = Math.abs(actual - estimated) / estimated;
+    if (ratio <= 0.2) {
+        return { label: `±${Math.round(ratio * 100)}%`, cls: 'planu-badge-success' };
+    }
+    if (ratio <= 0.5) {
+        return { label: `±${Math.round(ratio * 100)}%`, cls: 'planu-badge-warning' };
+    }
+    return { label: `±${Math.round(ratio * 100)}%`, cls: 'planu-badge-danger' };
+}
+function buildSpecCard(spec) {
+    const completedAt = spec.actuals?.completedAt ?? '';
+    const dateDisplay = completedAt ? formatDate(completedAt) : 'Unknown date';
+    const estimatedHours = spec.estimation.devHours + spec.estimation.reviewHours;
+    const actualHours = spec.actuals ? spec.actuals.devHours + spec.actuals.reviewHours : 0;
+    const { label: accLabel, cls: accCls } = accuracyClass(estimatedHours, actualHours);
+    const actualDisplay = spec.actuals !== null
+        ? `<span class="hours-actual">${actualHours.toFixed(1)}h actual</span>`
+        : '';
+    const tagBadges = spec.tags.length > 0
+        ? spec.tags
+            .slice(0, 3)
+            .map((t) => `<span class="tag-chip">${escapeHtml(t)}</span>`)
+            .join('')
+        : '';
+    return `<div class="cl-card planu-card">
+    <div class="cl-header">
+      <span class="cl-id">${escapeHtml(spec.id)}</span>
+      <span class="cl-title">${escapeHtml(spec.title)}</span>
+      <span class="planu-badge ${accCls}">${accLabel}</span>
+      <span class="cl-date">${dateDisplay}</span>
+    </div>
+    <div class="cl-meta">
+      <span class="hours-est">${estimatedHours.toFixed(1)}h est</span>
+      ${actualDisplay}
+      ${tagBadges}
+    </div>
+  </div>`;
+}
+function buildFeed(doneSpecs) {
+    if (doneSpecs.length === 0) {
+        return '';
+    }
+    // Group by year-month
+    const groups = new Map();
+    for (const spec of doneSpecs) {
+        const key = spec.actuals?.completedAt ? getYearMonth(spec.actuals.completedAt) : 'unknown';
+        const arr = groups.get(key) ?? [];
+        arr.push(spec);
+        groups.set(key, arr);
+    }
+    // Sort keys descending
+    const sortedKeys = [...groups.keys()].sort((a, b) => b.localeCompare(a));
+    return sortedKeys
+        .map((key) => {
+        const specs = groups.get(key) ?? [];
+        const label = key === 'unknown' ? 'Unknown Date' : key;
+        const cards = specs.map(buildSpecCard).join('\n');
+        return `<div class="month-group">
+        <div class="month-header">${escapeHtml(label)}</div>
+        ${cards}
+      </div>`;
+    })
+        .join('\n');
+}
+function buildSummarySection(doneSpecs) {
+    if (doneSpecs.length === 0) {
+        return '';
+    }
+    const now = new Date();
+    const currentMonth = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+    const thisMonth = doneSpecs.filter((s) => s.actuals?.completedAt && getYearMonth(s.actuals.completedAt) === currentMonth);
+    const totalHours = doneSpecs.reduce((sum, s) => {
+        if (!s.actuals) {
+            return sum;
+        }
+        return sum + s.actuals.devHours + s.actuals.reviewHours;
+    }, 0);
+    const specsWithActuals = doneSpecs.filter((s) => s.actuals !== null && s.estimation.devHours > 0);
+    const avgAccuracy = specsWithActuals.length > 0
+        ? specsWithActuals.reduce((sum, s) => {
+            const est = s.estimation.devHours + s.estimation.reviewHours;
+            const act = (s.actuals?.devHours ?? 0) + (s.actuals?.reviewHours ?? 0);
+            return sum + Math.abs(act - est) / est;
+        }, 0) / specsWithActuals.length
+        : null;
+    const accDisplay = avgAccuracy !== null ? `${Math.round(avgAccuracy * 100)}%` : 'N/A';
+    return `<section class="planu-card section-card summary-section">
+    <h2>Summary</h2>
+    <div class="summary-grid">
+      <div class="sum-item">
+        <span class="sum-num">${doneSpecs.length}</span>
+        <span class="sum-lbl">Total Done</span>
+      </div>
+      <div class="sum-item">
+        <span class="sum-num">${thisMonth.length}</span>
+        <span class="sum-lbl">This Month</span>
+      </div>
+      <div class="sum-item">
+        <span class="sum-num">${totalHours.toFixed(0)}h</span>
+        <span class="sum-lbl">Total Hours</span>
+      </div>
+      <div class="sum-item">
+        <span class="sum-num">${accDisplay}</span>
+        <span class="sum-lbl">Avg Deviation</span>
+      </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); }
+  .summary-grid { display: flex; gap: 16px; flex-wrap: wrap; }
+  .sum-item { text-align: center; padding: 12px 20px; background: #f9fafb; border-radius: 8px; min-width: 80px; }
+  .sum-num { display: block; font-size: 1.8rem; font-weight: 700; color: var(--planu-primary); }
+  .sum-lbl { font-size: 0.78rem; color: #6b7280; }
+  .month-group { margin-bottom: 24px; }
+  .month-header { font-size: 0.85rem; font-weight: 700; color: #9ca3af; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 10px; padding-left: 4px; }
+  .cl-card { margin-bottom: 10px; padding: 12px 14px; }
+  .cl-header { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-bottom: 4px; }
+  .cl-id { font-weight: 700; color: #6b7280; font-size: 0.82rem; }
+  .cl-title { font-weight: 600; flex: 1; }
+  .cl-date { font-size: 0.78rem; color: #9ca3af; margin-left: auto; }
+  .cl-meta { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; font-size: 0.78rem; }
+  .hours-est { color: #6b7280; }
+  .hours-actual { color: var(--planu-primary); font-weight: 600; }
+  .tag-chip { padding: 2px 6px; border-radius: 4px; background: #f3f4f6; color: #374151; }
+  .empty-state { text-align: center; padding: 64px 24px; color: #6b7280; }
+  .empty-state h3 { font-size: 1.2rem; }`;
+}
+/**
+ * Generate the changelog.html portal page.
+ */
+export function generateChangelogPage(specs) {
+    const doneSpecs = specs
+        .filter((s) => s.status === 'done')
+        .sort((a, b) => {
+        const aDate = a.actuals?.completedAt ?? '';
+        const bDate = b.actuals?.completedAt ?? '';
+        return bDate.localeCompare(aDate);
+    });
+    const navbar = buildNavbar('changelog', '');
+    const themeCSS = getPortalThemeCSS();
+    const pageCSS = buildPageCSS();
+    const bodyContent = doneSpecs.length === 0
+        ? `<div class="empty-state"><h3>No completed specs yet.</h3><p>Specs marked as <code>done</code> will appear here.</p></div>`
+        : `${buildSummarySection(doneSpecs)}
+  <section class="section-card">
+    <h2>Completion Feed</h2>
+    ${buildFeed(doneSpecs)}
+  </section>`;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Changelog — Planu Portal</title>
+  <style>${themeCSS}${pageCSS}</style>
+</head>
+<body>
+  ${navbar}
+  <main>
+    <h1 class="page-title">📝 Changelog</h1>
+    <p class="page-subtitle">Completed specs in reverse chronological order with estimation accuracy.</p>
+    ${bodyContent}
+  </main>
+</body>
+</html>`;
+}
+//# sourceMappingURL=changelog-page.js.map

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

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

package/dist/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.d.ts

@@ -0,0 +1,11 @@
+import type { Spec } from '../../../../types/index.js';
+import type { AccuracyRecord } from '../../../../types/portal.js';
+/**
+ * Compare estimation.devHours vs actuals.devHours for every done spec
+ * that has recorded actuals.
+ *
+ * accuracy = 100 - |estimated - actual| / estimated * 100
+ * Clamped to [0, 100].
+ */
+export declare function computeAccuracy(specs: Spec[]): AccuracyRecord[];
+//# sourceMappingURL=accuracy-aggregator.d.ts.map

package/dist/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accuracy-aggregator.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAmB/D"}

package/dist/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.js

@@ -0,0 +1,24 @@
+/**
+ * Compare estimation.devHours vs actuals.devHours for every done spec
+ * that has recorded actuals.
+ *
+ * accuracy = 100 - |estimated - actual| / estimated * 100
+ * Clamped to [0, 100].
+ */
+export function computeAccuracy(specs) {
+    const records = [];
+    for (const spec of specs) {
+        if (spec.status !== 'done' || !spec.actuals) {
+            continue;
+        }
+        const estimated = spec.estimation.devHours;
+        const actual = spec.actuals.devHours;
+        if (estimated <= 0) {
+            continue;
+        }
+        const accuracy = Math.max(0, 100 - (Math.abs(estimated - actual) / estimated) * 100);
+        records.push({ specId: spec.id, estimated, actual, accuracy: Math.round(accuracy * 10) / 10 });
+    }
+    return records;
+}
+//# sourceMappingURL=accuracy-aggregator.js.map

package/dist/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accuracy-aggregator.js","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/data-aggregators/accuracy-aggregator.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/doc-generator/portal/data-aggregators/bottleneck-detector.d.ts

@@ -0,0 +1,9 @@
+import type { Spec } from '../../../../types/index.js';
+import type { BottleneckSpec } from '../../../../types/portal.js';
+/**
+ * Find specs that have been in the same non-done status for more than 7 days.
+ * Uses updatedAt as the reference timestamp.
+ * Returns results sorted by staleDays descending (worst first).
+ */
+export declare function detectBottlenecks(specs: Spec[]): BottleneckSpec[];
+//# sourceMappingURL=bottleneck-detector.d.ts.map

package/dist/engine/doc-generator/portal/data-aggregators/bottleneck-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottleneck-detector.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/data-aggregators/bottleneck-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAKlE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CA0BjE"}

package/dist/engine/doc-generator/portal/data-aggregators/bottleneck-detector.js

@@ -0,0 +1,31 @@
+const STALE_THRESHOLD_DAYS = 7;
+const MS_PER_DAY = 86_400_000;
+/**
+ * Find specs that have been in the same non-done status for more than 7 days.
+ * Uses updatedAt as the reference timestamp.
+ * Returns results sorted by staleDays descending (worst first).
+ */
+export function detectBottlenecks(specs) {
+    const now = Date.now();
+    const bottlenecks = [];
+    for (const spec of specs) {
+        if (spec.status === 'done') {
+            continue;
+        }
+        const updatedMs = new Date(spec.updatedAt).getTime();
+        if (isNaN(updatedMs)) {
+            continue;
+        }
+        const staleDays = Math.floor((now - updatedMs) / MS_PER_DAY);
+        if (staleDays >= STALE_THRESHOLD_DAYS) {
+            bottlenecks.push({
+                specId: spec.id,
+                title: spec.title,
+                status: spec.status,
+                staleDays,
+            });
+        }
+    }
+    return bottlenecks.sort((a, b) => b.staleDays - a.staleDays);
+}
+//# sourceMappingURL=bottleneck-detector.js.map

package/dist/engine/doc-generator/portal/data-aggregators/bottleneck-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottleneck-detector.js","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/data-aggregators/bottleneck-detector.ts"],"names":[],"mappings":"AAIA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,WAAW,GAAqB,EAAE,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7D,IAAI,SAAS,IAAI,oBAAoB,EAAE,CAAC;YACtC,WAAW,CAAC,IAAI,CAAC;gBACf,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS;aACV,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC"}

package/dist/engine/doc-generator/portal/data-aggregators/burndown-aggregator.d.ts

@@ -0,0 +1,10 @@
+import type { Spec } from '../../../../types/index.js';
+import type { BurndownPoint } from '../../../../types/portal.js';
+/**
+ * Compute a sprint-level burndown from specs.
+ * Uses createdAt to determine when work started and completedAt for done dates.
+ * Returns daily data points sorted by date.
+ * Returns empty array when no specs have dates.
+ */
+export declare function computeBurndown(specs: Spec[]): BurndownPoint[];
+//# sourceMappingURL=burndown-aggregator.d.ts.map

package/dist/engine/doc-generator/portal/data-aggregators/burndown-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burndown-aggregator.d.ts","sourceRoot":"","sources":["../../../../../src/engine/doc-generator/portal/data-aggregators/burndown-aggregator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,EAAE,CA0D9D"}