@planu/cli 3.9.11 → 3.9.13

package/dist/engine/housekeeping/ephemeral-artifacts-cleaner.js

@@ -1,25 +1,16 @@
 // engine/housekeeping/ephemeral-artifacts-cleaner.ts — SPEC-762
-// Removes ephemeral planning artifacts (risk-register.md, implementation-brief.md,
-// prompt.md) from spec directories where the spec is done or discarded.
-import { readdir, readFile, unlink } from 'node:fs/promises';
+// Removes obsolete per-spec sidecar planning artifacts (risk-register.md,
+// implementation-brief.md, prompt.md). Current Planu specs keep durable content
+// in spec.md; these files are no longer generated or preserved.
+import { access, readdir, unlink } from 'node:fs/promises';
 import { join } from 'node:path';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
 const EPHEMERAL_FILENAMES = ['risk-register.md', 'implementation-brief.md', 'prompt.md'];
-const TERMINAL_STATUSES = new Set(['done', 'discarded']);
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-/** Extract the `status:` field from a spec.md YAML frontmatter block. */
-function extractStatus(raw) {
-    const frontmatterMatch = /^---\r?\n([\s\S]*?)\r?\n---/m.exec(raw);
-    if (!frontmatterMatch?.[1]) {
-        return null;
-    }
-    const statusMatch = /^status:\s*(\S+)/m.exec(frontmatterMatch[1]);
-    return statusMatch?.[1] ?? null;
-}
 /** Return true when the directory name looks like a Planu spec folder. */
 function isSpecDir(name) {
     return /^SPEC-\d+/.test(name);
@@ -28,8 +19,8 @@ function isSpecDir(name) {
 // Public API
 // ---------------------------------------------------------------------------
 /**
- * Scan all planu/specs/SPEC-* directories. For each spec whose status is
- * `done` or `discarded`, delete (or report) the ephemeral artifact files.
+ * Scan all planu/specs/SPEC-* directories and delete (or report) obsolete
+ * sidecar artifact files.
  */
 export async function cleanEphemeralArtifacts(input) {
     const specsRoot = join(input.projectPath, 'planu', 'specs');
@@ -50,22 +41,10 @@ export async function cleanEphemeralArtifacts(input) {
         return result; // planu/specs/ doesn't exist — nothing to clean
     }
     for (const specDir of specDirs) {
-        const specMdPath = join(specDir, 'spec.md');
-        let status;
-        try {
-            const raw = await readFile(specMdPath, 'utf-8');
-            status = extractStatus(raw);
-        }
-        catch {
-            continue; // no spec.md — skip this directory
-        }
-        if (status === null || !TERMINAL_STATUSES.has(status)) {
-            continue; // spec is still active
-        }
         for (const filename of EPHEMERAL_FILENAMES) {
             const filePath = join(specDir, filename);
             try {
-                await readFile(filePath, 'utf-8'); // probe existence
+                await access(filePath); // probe existence
             }
             catch {
                 continue; // file doesn't exist — skip

package/dist/engine/living-spec-analyzer.js

@@ -1,7 +1,7 @@
 // engine/living-spec-analyzer.ts — Heuristic analysis of spec criteria vs codebase
 // Compares acceptance criteria against actual code to produce a living spec report.
 // No LLM calls — purely file-existence and pattern-matching heuristics.
-import { readFile, writeFile, stat } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import { replaceSectionInSpec } from './spec-format/replace-section.js';
 import { join } from 'node:path';
 import { glob } from 'glob';
@@ -34,8 +34,8 @@ export async function analyzeLivingSpec(spec, projectPath) {
         progressUpdated = await updateProgressInSpec(spec.specPath, assessments, completionPercent);
     }
     else if (spec.progressPath) {
-        // Legacy fallback: spec.md path unknown but progress.md path set
-        progressUpdated = await updateProgressFile(spec.progressPath, assessments, completionPercent);
+        // Legacy progress.md paths are read-only compatibility metadata in unified spec mode.
+        progressUpdated = false;
     }
     return {
         specId: spec.id,
@@ -362,37 +362,6 @@ function extractSectionBodyLocal(content, sectionName) {
     const end = next ? next.index : normalized.length;
     return normalized.slice(afterHeading, end).trim();
 }
-/**
- * Update the spec's progress.md with living spec analysis results.
- * Legacy fallback: only called when specPath is unknown but progressPath exists.
- */
-async function updateProgressFile(progressPath, assessments, completionPercent) {
-    try {
-        let content;
-        try {
-            content = await readFile(progressPath, 'utf-8');
-        }
-        catch {
-            content = '';
-        }
-        const timestamp = new Date().toISOString();
-        const sectionHeader = '### Living Spec Analysis';
-        const newSection = buildProgressSection(assessments, completionPercent, timestamp);
-        if (content.includes(sectionHeader)) {
-            // Replace existing section (up to next ## or end of file)
-            content = content.replace(/### Living Spec Analysis[\s\S]*?(?=\n### |\n## |\n---\n|$)/, newSection);
-        }
-        else {
-            // Append new section
-            content = content.trimEnd() + '\n\n---\n\n' + newSection + '\n';
-        }
-        await writeFile(progressPath, content, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Build the markdown section for living spec progress.
  */

package/dist/engine/living-specs/index.d.ts

@@ -1,8 +1,8 @@
 import type { LivingSpecReconcileResult } from '../../types/index.js';
 /**
  * Auto-reconcile a spec against its actual implementation files.
- * Reads technical.md for file paths, spec.md for criteria,
- * scans files, matches criteria, updates progress.md.
+ * Reads spec.md for file paths and criteria, scans files, matches criteria,
+ * and writes the auto-reconcile summary into the inline ## Progress section.
  * Never throws -- returns partial result on error.
  */
 export declare function reconcileSpec(specId: string, projectPath: string): Promise<LivingSpecReconcileResult>;

package/dist/engine/living-specs/index.js

@@ -1,9 +1,10 @@
 // engine/living-specs/index.ts -- Main auto-reconcile entry point (SPEC-330)
-import { readFile, writeFile, access } from 'node:fs/promises';
+import { readFile, access } from 'node:fs/promises';
 import { join } from 'node:path';
 import { glob } from 'glob';
 import { scanFile, extractFilePaths } from './file-scanner.js';
 import { extractCriteriaLines, matchCriteria } from './criteria-matcher.js';
+import { replaceSectionInSpec } from '../spec-format/replace-section.js';
 /**
  * Find the spec directory for a given specId within the project.
  * Looks for planu/specs/{specId}-SLUG pattern via glob.
@@ -32,24 +33,12 @@ async function readSafe(filePath) {
 function buildDriftFlags(fileResults) {
     return fileResults.filter((f) => !f.exists).map((f) => 'DRIFT: ' + f.path + ' missing');
 }
-/**
- * Append or update the Auto-Reconcile section in progress.md.
- * SPEC-461: Only updates if the file already exists (lean specs don't have progress.md).
- */
-async function updateProgressMd(progressPath, result) {
-    // SPEC-461: Don't create progress.md for lean specs — only update if it already exists
-    try {
-        await access(progressPath);
-    }
-    catch {
-        return; // File doesn't exist — lean format spec, skip silently
-    }
-    const existing = await readSafe(progressPath);
+function buildAutoReconcileProgressBody(result) {
     const coveragePct = result.criteriaTotal > 0 ? Math.round((result.criteriaMet / result.criteriaTotal) * 100) : 0;
     const driftSection = result.driftFlags.length > 0
         ? '\n### Drift Flags\n\n' + result.driftFlags.map((f) => '- ' + f).join('\n') + '\n'
         : '';
-    const section = '\n## Auto-Reconcile\n\n' +
+    return ('### Auto-Reconcile\n\n' +
         '> Last reconciled: ' +
         result.reconciledAt +
         '\n\n' +
@@ -67,21 +56,12 @@ async function updateProgressMd(progressPath, result) {
         String(coveragePct) +
         '%)' +
         driftSection +
-        '\n';
-    const AUTO_RECONCILE_MARKER = '## Auto-Reconcile';
-    let newContent;
-    if (existing.includes(AUTO_RECONCILE_MARKER)) {
-        newContent = existing.replace(/\n## Auto-Reconcile[\s\S]*?(?=\n## |\n$|$)/, section);
-    }
-    else {
-        newContent = existing + section;
-    }
-    await writeFile(progressPath, newContent, 'utf-8');
+        '\n');
 }
 /**
  * Auto-reconcile a spec against its actual implementation files.
- * Reads technical.md for file paths, spec.md for criteria,
- * scans files, matches criteria, updates progress.md.
+ * Reads spec.md for file paths and criteria, scans files, matches criteria,
+ * and writes the auto-reconcile summary into the inline ## Progress section.
  * Never throws -- returns partial result on error.
  */
 export async function reconcileSpec(specId, projectPath) {
@@ -103,14 +83,9 @@ export async function reconcileSpec(specId, projectPath) {
             empty.driftFlags.push('DRIFT: spec directory for ' + specId + ' not found');
             return empty;
         }
-        const technicalPath = join(specDir, 'technical.md');
         const specMdPath = join(specDir, 'spec.md');
-        const progressPath = join(specDir, 'progress.md');
-        const [technicalContent, specMdContent] = await Promise.all([
-            readSafe(technicalPath),
-            readSafe(specMdPath),
-        ]);
-        const relativePaths = extractFilePaths(technicalContent);
+        const specMdContent = await readSafe(specMdPath);
+        const relativePaths = extractFilePaths(specMdContent);
         const absolutePaths = relativePaths.map((p) => join(projectPath, p));
         const fileResults = await Promise.all(absolutePaths.map((p) => scanFile(p)));
         const fileResultsWithRelative = fileResults.map((fr, i) => ({
@@ -134,7 +109,7 @@ export async function reconcileSpec(specId, projectPath) {
             fileResults: fileResultsWithRelative,
             criteriaResults,
         };
-        await updateProgressMd(progressPath, result);
+        await replaceSectionInSpec(specMdPath, 'Progress', buildAutoReconcileProgressBody(result));
         return result;
     }
     catch (err) {

package/dist/engine/planu-config-writer.js

@@ -57,7 +57,7 @@ export function getSpecFileNames(naming) {
     if (naming === 'legacy') {
         return { spec: 'HU.md', technical: 'FICHA-TECNICA.md', progress: 'PROGRESS.md' };
     }
-    return { spec: 'spec.md', technical: 'technical.md', progress: 'progress.md' };
+    return { spec: 'spec.md', technical: 'spec.md', progress: 'spec.md' };
 }
 /**
  * Check if a specLocation uses legacy naming.

package/dist/engine/progress-writer.d.ts

@@ -1,10 +1,10 @@
 import type { Spec } from '../types/index.js';
 /**
- * Generate initial progress.md content for a newly created spec.
+ * Generate initial ## Progress content for a newly created spec.
  */
 export declare function generateProgressContent(spec: Spec): string;
 /**
- * Generate an updated progress.md reflecting a status change.
+ * Generate updated ## Progress content reflecting a status change.
  */
 export declare function generateProgressUpdate(spec: Spec, previousStatus: string, existingContent: string): string;
 //# sourceMappingURL=progress-writer.d.ts.map

package/dist/engine/progress-writer.js

@@ -1,5 +1,5 @@
 /**
- * Generate initial progress.md content for a newly created spec.
+ * Generate initial ## Progress content for a newly created spec.
  */
 export function generateProgressContent(spec) {
     const sections = [
@@ -10,7 +10,7 @@ export function generateProgressContent(spec) {
     return sections.map((s) => `## ${s.title}\n\n${s.content}`).join('\n\n---\n\n');
 }
 /**
- * Generate an updated progress.md reflecting a status change.
+ * Generate updated ## Progress content reflecting a status change.
  */
 export function generateProgressUpdate(spec, previousStatus, existingContent) {
     const timestamp = new Date().toISOString();

package/dist/engine/scan-project/index.js

@@ -101,7 +101,7 @@ async function generateSpecs(input, modules, moduleResults, crossAnalysis, healt
         });
         const specDir = join(input.path, SPEC_LOCATION, `${specId}-${slug}`);
         spec.specPath = join(specDir, 'spec.md');
-        spec.technicalPath = join(specDir, 'technical.md');
+        spec.technicalPath = spec.specPath;
         const body = `# ${spec.title}\n\nAuto-generated by scan_project.\n`;
         await writeSpecFiles(specDir, spec, body);
         await createSpec(input.projectId, spec);
@@ -127,7 +127,7 @@ async function generateSpecs(input, modules, moduleResults, crossAnalysis, healt
     });
     const overviewDir = join(input.path, SPEC_LOCATION, `${overviewSpecId}-${overviewSlug}`);
     overviewSpec.specPath = join(overviewDir, 'spec.md');
-    overviewSpec.technicalPath = join(overviewDir, 'technical.md');
+    overviewSpec.technicalPath = overviewSpec.specPath;
     const overviewBody = overviewContent
         ? `# Project Overview — Automated Scan\n\n${overviewContent}\n`
         : `# Project Overview — Automated Scan\n\nAuto-generated by scan_project.\n`;

package/dist/engine/skill-generator/skills-content.js

@@ -43,7 +43,7 @@ export function generateDomainSkill(config, name, description, knowledge, specCo
         '1. **Understand** — Read spec criteria, review existing code, identify affected modules',
         '2. **Implement** — Write code following architecture patterns and project conventions',
         '3. **Validate** — Run tests, typecheck, lint; verify all spec criteria pass',
-        '4. **Track** — Update PROGRESS.md or spec status with session results',
+        '4. **Track** — Update spec status or the inline ## Progress section with session results',
         '5. **Commit** — Commit with conventional commit message (feat/fix/refactor)',
         '',
         '## Guidelines',

package/dist/engine/spec-format/lean-technical-generator.d.ts

@@ -1,5 +1,5 @@
 import type { LeanFileEntry, LeanTechnicalInput } from '../../types/index.js';
 export type { LeanFileEntry, LeanTechnicalInput };
-/** Generate lean technical.md content: YAML frontmatter + files section only. */
+/** Generate lean ## Technical content: YAML-like metadata + files section only. */
 export declare function generateLeanTechnicalContent(input: LeanTechnicalInput): string;
 //# sourceMappingURL=lean-technical-generator.d.ts.map

package/dist/engine/spec-format/lean-technical-generator.js

@@ -1,6 +1,6 @@
-// engine/spec-format/lean-technical-generator.ts — Generates lean technical.md (SPEC-461)
+// engine/spec-format/lean-technical-generator.ts — Generates lean ## Technical content (SPEC-461)
 // Output: ~15-20 lines. Only files section with create/modify/test and pending/done status.
-/** Generate lean technical.md content: YAML frontmatter + files section only. */
+/** Generate lean ## Technical content: YAML-like metadata + files section only. */
 export function generateLeanTechnicalContent(input) {
     const { specId, filesToCreate = [], filesToModify = [], filesToTest = [] } = input;
     const lines = ['---', `spec: ${specId}`, '---', '', '## Files', ''];

package/dist/engine/spec-format/technical-md-populator.d.ts

@@ -1,6 +1,6 @@
 import type { LeanFileEntry } from '../../types/index.js';
 /**
- * Attempt to extract file paths from spec body for auto-populating technical.md.
+ * Attempt to extract file paths from spec body for auto-populating ## Technical.
  * Returns null when no structured file section is found (caller uses placeholder).
  */
 export declare function extractFilesFromSpecBody(specBody: string, projectPath: string): Promise<{

package/dist/engine/spec-format/technical-md-populator.js

@@ -1,4 +1,4 @@
-// engine/spec-format/technical-md-populator.ts — SPEC-586: Parse spec body to populate technical.md
+// engine/spec-format/technical-md-populator.ts — SPEC-586: Parse spec body to populate ## Technical
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
 const FILE_PATH_RE = /\b(src|tests)\/[\w/-]+\.[a-z]+\b/g;
@@ -52,7 +52,7 @@ async function categorizeByExistence(paths, projectPath) {
     return { create, modify, test: [] };
 }
 /**
- * Attempt to extract file paths from spec body for auto-populating technical.md.
+ * Attempt to extract file paths from spec body for auto-populating ## Technical.
  * Returns null when no structured file section is found (caller uses placeholder).
  */
 export async function extractFilesFromSpecBody(specBody, projectPath) {

package/dist/engine/spec-migrator/drift-detector.js

@@ -11,7 +11,7 @@ const CANONICAL_ROOT_FILES = new Set([
     'roadmap.html',
 ]);
 const CANONICAL_ROOT_DIRS = new Set(['specs']);
-const CANONICAL_SPEC_FILES = new Set(['spec.md', 'technical.md']);
+const CANONICAL_SPEC_FILES = new Set(['spec.md']);
 async function scanPlanuRoot(projectPath) {
     const rootFiles = [];
     const planuDir = join(projectPath, 'planu');

package/dist/engine/spec-migrator/lean-migration.js

@@ -7,8 +7,10 @@ import { safeUnlink } from './git-aware-fs.js';
 import { parseFrontmatterLocal } from './frontmatter-parser.js';
 import { generateLeanSpecContent } from '../spec-format/lean-spec-generator.js';
 import { generateLeanTechnicalContent } from '../spec-format/lean-technical-generator.js';
+import { buildUnifiedSpecContent } from '../spec-format/unified-spec-builder.js';
 /** Files to delete from old-format specs. */
 const OBSOLETE_FILES = [
+    'technical.md',
     'progress.md',
     'executive-report.html',
     'technical-report.html',
@@ -380,7 +382,7 @@ export async function migrateSpecToLean(specDir, projectPath) {
         const leanSpecLines = generateLeanSpecContent({ spec, description, estimation });
         // Inject real criteria (replace the default one)
         const leanSpecWithCriteria = replaceCriteria(leanSpecLines, criteria);
-        // Generate lean technical.md (estimation only in spec.md — SPEC-462)
+        // Generate the legacy technical body, then fold it into unified spec.md.
         const leanTech = generateLeanTechnicalContent({
             specId: id,
             filesToCreate: files.create.map((p) => ({ path: p, status: 'pending' })),
@@ -394,9 +396,8 @@ export async function migrateSpecToLean(specDir, projectPath) {
         catch (backupErr) {
             return `backup failed: ${backupErr instanceof Error ? backupErr.message : String(backupErr)}`;
         }
-        // Write lean files
-        await atomicWriteFile(specPath, leanSpecWithCriteria);
-        await atomicWriteFile(techPath, leanTech);
+        // Write one unified spec.md.
+        await atomicWriteFile(specPath, buildUnifiedSpecContent(leanSpecWithCriteria, leanTech));
         // Delete obsolete files
         for (const file of OBSOLETE_FILES) {
             const filePath = join(specDir, file);

package/dist/engine/spec-migrator/planu-root-cleaner.js

@@ -14,7 +14,7 @@ const CANONICAL_ROOT_FILES = new Set([
 /** Directories allowed in planu/ root. */
 const CANONICAL_ROOT_DIRS = new Set(['specs']);
 /** Files allowed inside each planu/specs/SPEC-XXX/ directory. */
-const CANONICAL_SPEC_FILES = new Set(['spec.md', 'technical.md']);
+const CANONICAL_SPEC_FILES = new Set(['spec.md']);
 /** Remove a file from git tracking (best-effort, silent if not a git repo or file not tracked). */
 function gitRmCached(absolutePath, cwd) {
     try {

package/dist/engine/spec-registry/packager.d.ts

@@ -1,6 +1,6 @@
 /**
  * Pack a spec directory into a gzipped archive buffer.
- * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * Only includes recognized spec files (spec.md, planu-registry.json).
  * @param specDir - Absolute path to the spec directory.
  * @returns Gzipped buffer containing the archived spec files.
  */

package/dist/engine/spec-registry/packager.js

@@ -10,10 +10,10 @@ const gunzipAsync = promisify(gunzip);
 /** Maximum package size in bytes (500 KB). */
 const MAX_PACKAGE_SIZE = 500 * 1024;
 /** Files that may be included in a spec package. */
-const ALLOWED_FILES = ['spec.md', 'technical.md', 'progress.md', 'planu-registry.json'];
+const ALLOWED_FILES = ['spec.md', 'planu-registry.json'];
 /**
  * Pack a spec directory into a gzipped archive buffer.
- * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * Only includes recognized spec files (spec.md, planu-registry.json).
  * @param specDir - Absolute path to the spec directory.
  * @returns Gzipped buffer containing the archived spec files.
  */

package/dist/engine/spec-registry/validator.js

@@ -7,8 +7,7 @@ const MAX_TOTAL_SIZE = 500 * 1024;
 /** Semver regex (simplified: major.minor.patch with optional pre-release). */
 const SEMVER_RE = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
 /** Required files in a publishable spec directory. */
-// SPEC-461: Lean format — only 2 required files (no progress.md)
-const REQUIRED_FILES = ['spec.md', 'technical.md'];
+const REQUIRED_FILES = ['spec.md'];
 /** Required fields in the planu-registry.json manifest. */
 const REQUIRED_MANIFEST_FIELDS = [
     'name',

package/dist/engine/spec-splitter.js

@@ -289,8 +289,8 @@ export function buildChildSpecs(original, proposals, nextIdFn) {
             createdAt: now,
             updatedAt: now,
             specPath: original.specPath.replace(/\/[^/]+\/spec\.md$/, `/${childId}-${childSlug}/spec.md`),
-            technicalPath: original.technicalPath.replace(/\/[^/]+\/technical\.md$/, `/${childId}-${childSlug}/technical.md`),
-            progressPath: original.progressPath?.replace(/\/[^/]+\/progress\.md$/, `/${childId}-${childSlug}/progress.md`),
+            technicalPath: original.specPath.replace(/\/[^/]+\/spec\.md$/, `/${childId}-${childSlug}/spec.md`),
+            progressPath: undefined,
             estimation,
             actuals: null,
             target: original.target,

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

@@ -1,9 +1,8 @@
 import type { Spec } from '../../types/index.js';
 /**
- * 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.
+ * Per-spec HTML reports are deprecated. The unified docs site renders spec.md
+ * on demand, so this function intentionally does not write files inside
+ * planu/specs/SPEC-* directories.
  */
 export declare function regeneratePerSpecReports(specs: Spec[]): Promise<void>;
 //# sourceMappingURL=report-renderer.d.ts.map

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

@@ -1,139 +1,10 @@
-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.
+ * Per-spec HTML reports are deprecated. The unified docs site renders spec.md
+ * on demand, so this function intentionally does not write files inside
+ * planu/specs/SPEC-* directories.
  */
-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 */
-        }
-    }));
+export function regeneratePerSpecReports(specs) {
+    void specs;
+    return Promise.resolve();
 }
 //# sourceMappingURL=report-renderer.js.map

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

@@ -43,7 +43,7 @@ async function scanFilesystemSpecs(projectPath) {
                 createdAt: str(m.created ?? m.createdAt),
                 updatedAt: str(m.updated ?? m.updatedAt),
                 specPath: join(specsDir, folder, 'spec.md'),
-                technicalPath: join(specsDir, folder, 'technical.md'),
+                technicalPath: join(specsDir, folder, 'spec.md'),
                 estimation: {
                     devHours: num(m.devHours, 8),
                     reviewHours: num(m.reviewHours, 2),

package/dist/engine/universal-rules/rules/planu-english-specs.js

@@ -6,14 +6,11 @@ Auto-generated by \`init_project\`. Do not edit manually.
 
 ## Rule
 
-All generated spec artifacts are written in English, regardless of the user's conversation language:
+All generated spec content is written in English, regardless of the user's conversation language:
 
 - \`spec.md\`
-- \`technical.md\`
-- architecture notes inside \`planu/specs/**\`
-- acceptance criteria
-- implementation notes
-- validation and reconciliation notes
+- inline \`## Technical\`, \`## Files\`, and \`## Progress\` sections
+- acceptance criteria, implementation notes, validation notes, and reconciliation notes
 
 User-facing chat may use the user's preferred language. The spec contract itself stays in English so every agent, tool, and CI gate can parse it consistently.
 
@@ -21,6 +18,7 @@ User-facing chat may use the user's preferred language. The spec contract itself
 
 - Do not create mixed-language acceptance criteria.
 - Do not translate BDD keywords.
+- Do not create standalone \`technical.md\`, \`progress.md\`, \`HU.md\`, \`FICHA-TECNICA.md\`, or \`PROGRESS.md\`.
 - Do not approve a spec that contains unresolved placeholders such as \`to be determined\`, \`TBD\`, \`TODO\`, or equivalent filler.
 `;
 }