@planu/cli 0.88.1 → 0.90.1

package/dist/engine/spec-summary-html/report-renderer.js

@@ -0,0 +1,139 @@
+import { writeFile, readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { generatePerSpecExecutiveReport, generatePerSpecTechnicalReport, } from '../doc-generator/per-spec-report/index.js';
+import { buildSpecMetricsSection, buildEffortDistributionSvg, buildSpecDependenciesSection, buildSpecTagsSection, } from '../doc-generator/per-spec-report/spec-section-builders.js';
+import { extractPerSpecData } from '../doc-generator/per-spec-report/spec-data-extractor.js';
+import { markdownToHtml } from '../markdown-renderer.js';
+const STATUS_COLORS = {
+    draft: { bg: '#e5e7eb', fg: '#374151' },
+    review: { bg: '#dbeafe', fg: '#1d4ed8' },
+    approved: { bg: '#d1fae5', fg: '#065f46' },
+    implementing: { bg: '#fef3c7', fg: '#92400e' },
+    done: { bg: '#d1fae5', fg: '#065f46' },
+    discarded: { bg: '#f3f4f6', fg: '#9ca3af' },
+};
+const REPORT_CSS = `
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; max-width: 900px; margin: 0 auto; padding: 24px; color: #1f2937; background: #fff; line-height: 1.6; font-size: 14px; }
+  .header { border-bottom: 3px solid #4F46E5; padding-bottom: 16px; margin-bottom: 24px; }
+  .header h1 { font-size: 1.1em; color: #6b7280; font-weight: 400; margin: 0 0 4px; }
+  .header h2 { font-size: 1.6em; color: #111827; margin: 0; }
+  .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; }
+  .nav { margin-bottom: 24px; }
+  .nav a { color: #4F46E5; text-decoration: none; font-size: 0.85em; }
+  .nav a:hover { text-decoration: underline; }
+  .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(140px, 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: 1.8em; font-weight: 700; color: #4F46E5; line-height: 1; }
+  .metric-label { font-size: 0.78em; color: #6b7280; margin-top: 4px; }
+  .tags-section .tag { display: inline-block; padding: 2px 8px; border-radius: 4px; background: #ede9fe; color: #5b21b6; font-size: 0.8em; margin: 2px 4px; }
+  .md-content h1 { font-size: 1.4em; color: #111827; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; margin: 24px 0 12px; }
+  .md-content h2 { font-size: 1.2em; color: #4F46E5; border-left: 4px solid #4F46E5; padding-left: 10px; margin: 20px 0 10px; }
+  .md-content h3 { font-size: 1.05em; color: #374151; margin: 16px 0 8px; }
+  .md-content p { margin: 8px 0; }
+  .md-content ul, .md-content ol { padding-left: 24px; margin: 8px 0; }
+  .md-content li { margin: 4px 0; }
+  .md-content blockquote { border-left: 4px solid #d1d5db; padding: 8px 16px; margin: 12px 0; color: #6b7280; background: #f9fafb; border-radius: 0 6px 6px 0; }
+  .md-content code { background: #f3f4f6; padding: 1px 5px; border-radius: 3px; font-size: 0.9em; }
+  .md-content pre { background: #1f2937; color: #e5e7eb; padding: 16px; border-radius: 8px; overflow-x: auto; margin: 12px 0; }
+  .md-content pre code { background: none; color: inherit; padding: 0; }
+  .md-table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 0.85em; }
+  .md-table th { text-align: left; padding: 8px 10px; background: #f9fafb; border-bottom: 2px solid #e5e7eb; font-weight: 600; color: #374151; }
+  .md-table td { padding: 8px 10px; border-bottom: 1px solid #f3f4f6; }
+  .md-table tr:hover { background: #f9fafb; }
+  .md-content hr { border: none; border-top: 1px solid #e5e7eb; margin: 20px 0; }
+  .md-content input[type=checkbox] { margin-right: 6px; }
+  .footer { margin-top: 32px; padding-top: 16px; border-top: 1px solid #e5e7eb; font-size: 0.78em; color: #9ca3af; text-align: center; }
+  .footer a { color: #4F46E5; text-decoration: none; }
+  @media print { body { padding: 0; } .nav { display: none; } }`;
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function buildMetricsDashboard(spec) {
+    const data = extractPerSpecData(spec, [], []);
+    return [
+        buildSpecMetricsSection(data),
+        buildEffortDistributionSvg(data.devHours, data.reviewHours),
+        buildSpecDependenciesSection(data),
+        buildSpecTagsSection(data),
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function buildReportHtml(spec, title, mdContent) {
+    const colors = STATUS_COLORS[spec.status] ?? { bg: '#e5e7eb', fg: '#374151' };
+    const date = new Date().toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+    const bodyHtml = markdownToHtml(mdContent);
+    const dashboard = buildMetricsDashboard(spec);
+    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>${REPORT_CSS}</style></head>
+<body>
+<div class="nav"><a href="../../index.html">&larr; Back to Dashboard</a></div>
+<div class="header">
+  <h1>Planu — Spec Report</h1>
+  <h2>${escapeHtml(spec.id)}: ${escapeHtml(spec.title)}</h2>
+  <div class="meta">
+    <span class="badge" style="background:${colors.bg};color:${colors.fg}">${escapeHtml(spec.status)}</span>
+    &middot; Generated ${escapeHtml(date)}
+  </div>
+</div>
+${dashboard}
+<div class="md-content">${bodyHtml}</div>
+<div class="footer">Generated by <strong>Planu</strong> — Spec Driven Development</div>
+</body></html>`;
+}
+async function readMdSafe(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Regenerate executive-report.html and technical-report.html for each spec.
+ * Reads actual spec.md and technical.md content to produce rich HTML reports.
+ * Also generates structural reports as fallback data source.
+ * Best-effort per spec — one failure doesn't block others.
+ */
+export async function regeneratePerSpecReports(specs) {
+    await Promise.all(specs.map(async (spec) => {
+        if (!spec.specPath) {
+            return;
+        }
+        const specDir = dirname(spec.specPath);
+        try {
+            const [specMd, techMd] = await Promise.all([
+                readMdSafe(spec.specPath),
+                readMdSafe(spec.technicalPath),
+            ]);
+            const execHtml = specMd
+                ? buildReportHtml(spec, `Executive Report — ${spec.id}: ${spec.title}`, specMd)
+                : generatePerSpecExecutiveReport(spec, [], []).content;
+            const techHtml = techMd
+                ? buildReportHtml(spec, `Technical Report — ${spec.id}: ${spec.title}`, techMd)
+                : generatePerSpecTechnicalReport(spec, [], [], []).content;
+            await Promise.all([
+                writeFile(join(specDir, 'executive-report.html'), execHtml, 'utf-8'),
+                writeFile(join(specDir, 'technical-report.html'), techHtml, 'utf-8'),
+            ]);
+        }
+        catch {
+            /* best-effort per spec */
+        }
+    }));
+}
+//# sourceMappingURL=report-renderer.js.map

package/dist/engine/spec-summary-html/report-renderer.js.map

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

package/dist/engine/spec-summary-html.d.ts

@@ -4,6 +4,7 @@ import type { Spec } from '../types/index.js';
  * Merges store specs with filesystem specs to ensure all specs appear.
  * Designed to be called from list_specs, update_status, create_spec.
  * Best-effort: never throws, never blocks the caller.
+ * Skips writing the file when spec data has not changed (hash comparison).
  */
 export declare function regenerateSpecSummaryHtml(projectPath: string, specs: Spec[], changedSpecIds?: string[]): Promise<void>;
 //# sourceMappingURL=spec-summary-html.d.ts.map

package/dist/engine/spec-summary-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-summary-html.d.ts","sourceRoot":"","sources":["../../src/engine/spec-summary-html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAkmB9C;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"spec-summary-html.d.ts","sourceRoot":"","sources":["../../src/engine/spec-summary-html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAwG9C;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAuCf"}