@majeanson/lac 3.4.5 → 3.5.1

package/dist/index.mjs

@@ -3781,6 +3781,10 @@ const FeatureSchema$1 = object$1({
 	lastVerifiedDate: string$2().regex(/^\d{4}-\d{2}-\d{2}$/, "lastVerifiedDate must be YYYY-MM-DD").optional(),
 	codeSnippets: array$1(CodeSnippetSchema$1).optional(),
 	implementationNotes: array$1(string$2()).optional(),
+	pmSummary: string$2().optional(),
+	testStrategy: string$2().optional(),
+	releaseVersion: string$2().optional(),
+	acceptanceCriteria: array$1(string$2()).optional(),
 	fieldLocks: array$1(FieldLockSchema$1).optional(),
 	featureLocked: boolean$2().optional()
 });
@@ -7725,6 +7729,10 @@ const FeatureSchema = object({
 	lastVerifiedDate: string().regex(/^\d{4}-\d{2}-\d{2}$/, "lastVerifiedDate must be YYYY-MM-DD").optional(),
 	codeSnippets: array(CodeSnippetSchema).optional(),
 	implementationNotes: array(string()).optional(),
+	pmSummary: string().optional(),
+	testStrategy: string().optional(),
+	releaseVersion: string().optional(),
+	acceptanceCriteria: array(string()).optional(),
 	fieldLocks: array(FieldLockSchema).optional(),
 	featureLocked: boolean().optional()
 });
@@ -8142,6 +8150,25 @@ Return ONLY a valid JSON array of plain strings — no other text, no markdown f
 
 If there are no notable implementation notes, return an empty array: []`,
 		userSuffix: "Extract free-form implementation notes for this feature."
+	},
+	pmSummary: {
+		system: `You are a product manager writing for a non-technical executive audience. Given a feature.json, write a 1–2 sentence business-value summary. Focus on the outcome and the user or business benefit — not the technical implementation. Avoid words like "component", "schema", "API", "TypeScript". Write as if you are telling a stakeholder why this feature matters. Return only the summary text, no JSON wrapper, no heading.`,
+		userSuffix: "Write a 1–2 sentence PM/exec summary for this feature."
+	},
+	testStrategy: {
+		system: `You are a software testing expert. Given a feature.json, describe in 2-4 sentences how this feature should be tested. Cover: what type of tests are appropriate (unit, integration, E2E, manual), what the hardest thing to test is, and any test setup or environment requirements implied by the feature. Be specific — name the actual components or flows that need coverage. Return only the strategy text, no JSON wrapper, no heading.`,
+		userSuffix: "Describe the test strategy for this feature."
+	},
+	releaseVersion: {
+		system: `You are a software engineering analyst. Given a feature.json, return the release version string this feature first shipped in, if it can be inferred from the statusHistory dates, revisions, or annotations. If not determinable, return an empty string. Return only the version string (e.g. "3.5.0", "v2", "2026-Q2") or an empty string — nothing else.`,
+		userSuffix: "Identify the release version this feature first shipped in, or return empty string if unknown."
+	},
+	acceptanceCriteria: {
+		system: `You are a software testing expert. Given a feature.json, break the successCriteria and problem statement into 3-8 discrete, testable acceptance criteria. Each criterion must be a single concrete, verifiable statement (e.g. "Camera roll permission prompt appears on first launch only", "Denying permission shows a recovery screen with an Open Settings button"). No vague statements. No compound criteria (one thing per item).
+
+Return ONLY a valid JSON array of strings — no other text:
+["criterion 1", "criterion 2", "criterion 3"]`,
+		userSuffix: "Generate structured acceptance criteria for this feature."
 	}
 };
 const JSON_FIELDS = new Set([
@@ -8152,7 +8179,9 @@ const JSON_FIELDS = new Set([
 	"npmPackages",
 	"publicInterface",
 	"externalDependencies",
-	"codeSnippets"
+	"codeSnippets",
+	"implementationNotes",
+	"acceptanceCriteria"
 ]);
 const ALL_FILLABLE_FIELDS = [
 	"analysis",
@@ -8162,6 +8191,9 @@ const ALL_FILLABLE_FIELDS = [
 	"tags",
 	"successCriteria",
 	"userGuide",
+	"pmSummary",
+	"testStrategy",
+	"acceptanceCriteria",
 	"domain",
 	"componentFile",
 	"npmPackages",
@@ -8169,7 +8201,8 @@ const ALL_FILLABLE_FIELDS = [
 	"externalDependencies",
 	"lastVerifiedDate",
 	"codeSnippets",
-	"implementationNotes"
+	"implementationNotes",
+	"releaseVersion"
 ];
 function getMissingFields(feature) {
 	return ALL_FILLABLE_FIELDS.filter((field) => {
@@ -8186,7 +8219,7 @@ const GEN_PROMPTS = {
 		userSuffix: "Generate a React TypeScript component for this feature."
 	},
 	test: {
-		system: `You are an expert software testing engineer. You will be given a feature.json. Generate a comprehensive test suite using Vitest. Use the successCriteria to derive happy-path tests and the knownLimitations to derive edge-case tests. Return only the test code, no explanation.`,
+		system: `You are an expert software testing engineer. You will be given a feature.json. Generate a comprehensive test suite using Vitest. Primary inputs: use acceptanceCriteria[] for happy-path test cases (one test per criterion), testStrategy to determine the appropriate test type (unit/integration/E2E), and knownLimitations for edge-case tests. If acceptanceCriteria is absent, derive tests from successCriteria. Return only the test code, no explanation.`,
 		userSuffix: "Generate a Vitest test suite for this feature."
 	},
 	migration: {
@@ -8196,6 +8229,10 @@ const GEN_PROMPTS = {
 	docs: {
 		system: `You are a technical writer. You will be given a feature.json. Generate user-facing documentation for this feature. Write it clearly enough that any end user can understand it (not developer-focused). Cover: what it does, how to use it, and known limitations. Use Markdown. Return only the documentation, no explanation.`,
 		userSuffix: "Generate user-facing documentation for this feature."
+	},
+	mock: {
+		system: `You are an expert TypeScript developer. You will be given a feature.json with a publicInterface[] array describing exported types, components, hooks, services, and functions. Generate realistic TypeScript mock factories for each entry. Use hand-crafted realistic static values (no external faker library). Export a factory function for each interface named \`mock<Name>(overrides?: Partial<Type>): Type\`. Where the shape is not fully defined in the feature, make reasonable assumptions from the name and description. Return only the TypeScript code, no explanation.`,
+		userSuffix: "Generate TypeScript mock factories for this feature."
 	}
 };
 const PROMPT_LOG_FILENAME = "prompt.log.jsonl";
@@ -8468,29 +8505,183 @@ async function genFromFeature(options) {
 	const result = validateFeature(JSON.parse(raw));
 	if (!result.success) throw new Error(`Invalid feature.json: ${result.errors.join(", ")}`);
 	const feature = result.data;
+	if (type === "types") return writeOrPrint(genTypes(feature), options.outFile ?? path.join(featureDir, `${feature["featureKey"]}.types.ts`), dryRun, type);
+	if (type === "adr") return writeOrPrint(genAdr(feature), options.outFile ?? path.join(featureDir, "ARCHITECTURE-DECISIONS.md"), dryRun, type);
+	if (type === "snippets") return writeOrPrint(genSnippets(feature), options.outFile ?? path.join(featureDir, `${feature["featureKey"]}-snippets.md`), dryRun, type);
 	const promptConfig = GEN_PROMPTS[type];
-	if (!promptConfig) throw new Error(`Unknown generation type: "${type}". Available: component, test, migration, docs`);
+	if (!promptConfig) throw new Error(`Unknown generation type: "${type}". Available: component, test, migration, docs, types, adr, snippets, mock`);
 	const client = createClient();
-	process$1.stdout.write(`\nGenerating ${type} for ${feature.featureKey} (${feature.title})...\n`);
+	process$1.stdout.write(`\nGenerating ${type} for ${feature["featureKey"]} (${feature["title"]})...\n`);
 	process$1.stdout.write(`Model: ${model}\n\n`);
-	const contextStr = contextToString(buildContext(featureDir, feature));
-	const generated = await generateText(client, promptConfig.system, `${contextStr}\n\n${promptConfig.userSuffix}`, model);
+	const contextStr = contextToString(buildContext(featureDir, result.data));
+	return writeOrPrint(await generateText(client, promptConfig.system, `${contextStr}\n\n${promptConfig.userSuffix}`, model), options.outFile ?? path.join(featureDir, `${feature["featureKey"]}${typeToExt(type)}`), dryRun, type);
+}
+function writeOrPrint(content, outFile, dryRun, type) {
 	if (dryRun) {
-		process$1.stdout.write(generated);
-		process$1.stdout.write("\n\n  [dry-run] No file written.\n");
-		return generated;
+		process$1.stdout.write(content);
+		process$1.stdout.write(`\n\n  [dry-run] No file written.\n`);
+		return content;
+	}
+	fs.writeFileSync(outFile, content, "utf-8");
+	process$1.stdout.write(`  ✓ Generated ${type} → ${outFile}\n\n`);
+	return content;
+}
+function genTypes(feature) {
+	const iface = feature["publicInterface"];
+	const lines = [
+		`// Generated by lac gen --type types`,
+		`// Feature: ${feature["featureKey"]} — ${feature["title"]}`,
+		`// Do not edit manually — regenerate with: lac gen --type types`,
+		``
+	];
+	if (!iface || iface.length === 0) {
+		lines.push(`// No publicInterface entries found in feature.json`);
+		lines.push(`// Add publicInterface[] to the feature to generate type declarations`);
+		return lines.join("\n");
+	}
+	for (const entry of iface) {
+		if (entry.description) lines.push(`/** ${entry.description} */`);
+		const lower = entry.type.toLowerCase();
+		const name = entry.name;
+		if (lower.includes("react component") || lower.includes("component") && !lower.includes("context")) {
+			lines.push(`export interface ${name}Props {`);
+			lines.push(`  // TODO: define props`);
+			lines.push(`}`);
+			lines.push(`export declare function ${name}(props: ${name}Props): JSX.Element`);
+		} else if (lower.includes("context") || lower.includes("provider")) {
+			const valueName = `${name}Value`;
+			lines.push(`export interface ${valueName} {`);
+			lines.push(`  // TODO: define context value shape`);
+			lines.push(`}`);
+			lines.push(`export declare const ${name}: React.Context<${valueName}>`);
+		} else if (lower.includes("hook") || name.startsWith("use")) lines.push(`export declare function ${name}(): unknown // TODO: define return type`);
+		else if (lower.includes("service") || lower.includes("manager") || lower.includes("class")) {
+			lines.push(`export declare class ${name} {`);
+			lines.push(`  // TODO: define service methods`);
+			lines.push(`}`);
+		} else if (lower.includes("function") || lower.includes("util") || lower.includes("helper")) lines.push(`export declare function ${name}(...args: unknown[]): unknown // TODO: define signature`);
+		else {
+			lines.push(`export interface ${name} {`);
+			lines.push(`  // TODO: define interface shape`);
+			lines.push(`}`);
+		}
+		lines.push(``);
+	}
+	return lines.join("\n");
+}
+function genAdr(feature) {
+	const decisions = feature["decisions"];
+	const featureKey = feature["featureKey"];
+	const title = feature["title"];
+	const problem = feature["problem"];
+	const analysis = feature["analysis"];
+	const lines = [
+		`# Architecture Decision Records — ${title}`,
+		``,
+		`> Feature: \`${featureKey}\`  `,
+		`> Generated by: \`lac gen --type adr\``,
+		``,
+		`---`,
+		``
+	];
+	if (!decisions || decisions.length === 0) {
+		lines.push(`*No decisions recorded in this feature.json.*`);
+		lines.push(``);
+		lines.push(`Add \`decisions[]\` to the feature to generate ADRs.`);
+		return lines.join("\n");
+	}
+	decisions.forEach((d, i) => {
+		d.decision.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+		lines.push(`## ADR-${String(i + 1).padStart(3, "0")}: ${d.decision}`);
+		lines.push(``);
+		lines.push(`**Status:** Accepted  `);
+		if (d.date) lines.push(`**Date:** ${d.date}  `);
+		lines.push(`**Feature:** \`${featureKey}\``);
+		lines.push(``);
+		lines.push(`### Context`);
+		lines.push(``);
+		if (problem) {
+			lines.push(problem);
+			lines.push(``);
+		}
+		if (analysis) {
+			lines.push(analysis);
+			lines.push(``);
+		}
+		lines.push(`### Decision`);
+		lines.push(``);
+		lines.push(d.decision);
+		lines.push(``);
+		lines.push(`### Rationale`);
+		lines.push(``);
+		lines.push(d.rationale);
+		lines.push(``);
+		if (d.alternativesConsidered && d.alternativesConsidered.length > 0) {
+			lines.push(`### Alternatives Considered`);
+			lines.push(``);
+			for (const alt of d.alternativesConsidered) lines.push(`- ${alt}`);
+			lines.push(``);
+		}
+		lines.push(`---`);
+		lines.push(``);
+	});
+	return lines.join("\n");
+}
+function genSnippets(feature) {
+	const snippets = feature["codeSnippets"];
+	const featureKey = feature["featureKey"];
+	const lines = [
+		`# Code Snippets — ${feature["title"]}`,
+		``,
+		`> Feature: \`${featureKey}\`  `,
+		`> Generated by: \`lac gen --type snippets\``,
+		``,
+		`---`,
+		``
+	];
+	if (!snippets || snippets.length === 0) {
+		lines.push(`*No codeSnippets recorded in this feature.json.*`);
+		lines.push(``);
+		lines.push(`Add \`codeSnippets[]\` to the feature to generate a snippet reference.`);
+		return lines.join("\n");
+	}
+	for (const s of snippets) {
+		lines.push(`## ${s.label}`);
+		lines.push(``);
+		lines.push("```");
+		lines.push(s.snippet);
+		lines.push("```");
+		lines.push(``);
+	}
+	return lines.join("\n");
+}
+/**
+* Runs a custom AI generator against a single feature.json.
+* Used by the `lac gen --generator <name>` plugin system for type:"ai" generators.
+*/
+async function genWithCustomPrompt(options) {
+	const { featureDir, systemPrompt, dryRun = false, model = "claude-sonnet-4-6" } = options;
+	const featurePath = path.join(featureDir, "feature.json");
+	let raw;
+	try {
+		raw = fs.readFileSync(featurePath, "utf-8");
+	} catch {
+		throw new Error(`No feature.json found at "${featurePath}"`);
 	}
-	const outFile = options.outFile ?? path.join(featureDir, `${feature.featureKey}${typeToExt(type)}`);
-	fs.writeFileSync(outFile, generated, "utf-8");
-	process$1.stdout.write(`  ✓ Written to ${outFile}\n\n`);
-	return generated;
+	const result = validateFeature(JSON.parse(raw));
+	if (!result.success) throw new Error(`Invalid feature.json: ${result.errors.join(", ")}`);
+	const feature = result.data;
+	const client = createClient();
+	process$1.stdout.write(`  Running AI generator for ${feature["featureKey"]} (${feature["title"]})...\n`);
+	return writeOrPrint(await generateText(client, systemPrompt, `${contextToString(buildContext(featureDir, result.data))}\n\nGenerate the requested output for this feature.`, model), options.outFile ?? path.join(featureDir, `${feature["featureKey"]}-generated.txt`), dryRun, "custom");
 }
 function typeToExt(type) {
 	return {
 		component: ".tsx",
 		test: ".test.ts",
 		migration: ".sql",
-		docs: ".md"
+		docs: ".md",
+		mock: ".mock.ts"
 	}[type] ?? ".txt";
 }
 function askUser$1(question) {
@@ -9018,7 +9209,9 @@ const DEFAULTS = {
 		restrictedFields: [],
 		requireAlternatives: false,
 		freezeRequiresHumanRevision: false
-	}
+	},
+	views: {},
+	generators: {}
 };
 function loadConfig(fromDir) {
 	const configPath = findLacConfig(fromDir ?? process$1.cwd());
@@ -9038,7 +9231,9 @@ function loadConfig(fromDir) {
 				restrictedFields: parsed.guardlock?.restrictedFields ?? DEFAULTS.guardlock.restrictedFields,
 				requireAlternatives: parsed.guardlock?.requireAlternatives ?? DEFAULTS.guardlock.requireAlternatives,
 				freezeRequiresHumanRevision: parsed.guardlock?.freezeRequiresHumanRevision ?? DEFAULTS.guardlock.freezeRequiresHumanRevision
-			}
+			},
+			views: parsed.views ?? DEFAULTS.views,
+			generators: parsed.generators ?? DEFAULTS.generators
 		};
 	} catch {
 		process$1.stderr.write(`Warning: could not parse lac.config.json at "${configPath}" — using defaults\n`);
@@ -9184,22 +9379,85 @@ const configCommand = new Command("config").description("Show the resolved lac.c
 });
 //#endregion
 //#region src/commands/gen.ts
-const GEN_TYPES = [
+const FEATURE_GEN_TYPES = [
 	"component",
 	"test",
 	"migration",
-	"docs"
+	"docs",
+	"types",
+	"adr",
+	"snippets",
+	"mock"
 ];
-const genCommand = new Command("gen").description("Generate code artifacts from a feature.json (component, test, migration, docs)").argument("[dir]", "Feature folder (default: nearest feature.json from cwd)").option(`--type <type>`, `What to generate: ${GEN_TYPES.join(", ")}`).option("--dry-run", "Print generated content without writing to disk").option("--out <file>", "Output file path (default: auto-named next to feature.json)").option("--model <model>", "Claude model to use (default: claude-sonnet-4-6)").action(async (dir, options) => {
+const WORKSPACE_GEN_TYPES = ["index"];
+const ALL_GEN_TYPES = [...FEATURE_GEN_TYPES, ...WORKSPACE_GEN_TYPES];
+const genCommand = new Command("gen").description("Generate code artifacts from feature.json(s)").argument("[dir]", "Feature folder or workspace root (default: nearest feature.json / cwd)").option(`--type <type>`, `Built-in generator: ${ALL_GEN_TYPES.join(", ")}`).option("--generator <name>", "Run a named generator from lac.config.json generators block").option("--list", "List all available generators (built-in + config-defined)").option("--dry-run", "Print generated content without writing to disk").option("--out <file>", "Output file path (default: auto-named)").option("--model <model>", "Claude model to use (default: claude-sonnet-4-6)").action(async (dir, options) => {
+	const cwd = process$1.cwd();
+	const startDir = dir ? resolve(dir) : cwd;
+	const config = loadConfig(startDir);
+	const configFilePath = findLacConfig(startDir);
+	const configDir = configFilePath ? dirname(configFilePath) : startDir;
+	if (options.list) {
+		process$1.stdout.write("\nBuilt-in generator types:\n");
+		for (const t of ALL_GEN_TYPES) {
+			const scope = WORKSPACE_GEN_TYPES.includes(t) ? "workspace" : "feature";
+			process$1.stdout.write(`  ${t.padEnd(12)} [${scope}]\n`);
+		}
+		const customEntries = Object.entries(config.generators);
+		if (customEntries.length === 0) {
+			process$1.stdout.write("\nCustom generators (lac.config.json): none\n");
+			process$1.stdout.write("  Add a \"generators\" block to your lac.config.json to define custom generators.\n");
+		} else {
+			process$1.stdout.write("\nCustom generators (lac.config.json):\n");
+			for (const [name, gen] of customEntries) {
+				const scope = gen.scope ?? "feature";
+				const desc = gen.description ? ` — ${gen.description}` : "";
+				process$1.stdout.write(`  ${name.padEnd(16)} [${gen.type}/${scope}]${desc}\n`);
+			}
+		}
+		process$1.stdout.write("\n");
+		return;
+	}
+	if (options.generator) {
+		const genDef = config.generators[options.generator];
+		if (!genDef) {
+			const available = Object.keys(config.generators);
+			process$1.stderr.write(`Unknown generator "${options.generator}". Available: ${available.length > 0 ? available.join(", ") : "(none — add generators to lac.config.json)"}\n`);
+			process$1.exit(1);
+		}
+		try {
+			await runPluginGenerator(options.generator, genDef, startDir, configDir, {
+				dryRun: options.dryRun ?? false,
+				out: options.out,
+				model: options.model
+			});
+		} catch (err) {
+			process$1.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
 	const type = options.type ?? "component";
-	if (!GEN_TYPES.includes(type)) {
-		process$1.stderr.write(`Unknown type "${type}". Available: ${GEN_TYPES.join(", ")}\n`);
+	if (!ALL_GEN_TYPES.includes(type)) {
+		process$1.stderr.write(`Unknown type "${type}". Available: ${ALL_GEN_TYPES.join(", ")}\n`);
 		process$1.exit(1);
 	}
+	if (type === "index") {
+		try {
+			await runIndexGenerator(startDir, {
+				dryRun: options.dryRun ?? false,
+				out: options.out
+			});
+		} catch (err) {
+			process$1.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
 	let featureDir;
 	if (dir) featureDir = resolve(dir);
 	else {
-		const found = findNearestFeatureJson$1(process$1.cwd());
+		const found = findNearestFeatureJson$1(cwd);
 		if (!found) {
 			process$1.stderr.write("No feature.json found from current directory.\nRun \"lac init\" to create one, or pass a path: lac gen src/auth/ --type test\n");
 			process$1.exit(1);
@@ -9219,6 +9477,145 @@ const genCommand = new Command("gen").description("Generate code artifacts from
 		process$1.exit(1);
 	}
 });
+async function runIndexGenerator(startDir, opts) {
+	process$1.stdout.write(`\nScanning workspace for publicInterface entries...\n`);
+	const scanned = await scanFeatures(startDir);
+	const lines = [
+		`// Generated by lac gen --type index`,
+		`// Workspace public-interface barrel`,
+		`// Do not edit manually — regenerate with: lac gen --type index`,
+		`// Generated: ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`,
+		``
+	];
+	let totalExports = 0;
+	let featuresWithInterface = 0;
+	for (const { feature } of scanned) {
+		const feat = feature;
+		const iface = feat["publicInterface"];
+		if (!iface || iface.length === 0) continue;
+		featuresWithInterface++;
+		const file = typeof feat["componentFile"] === "string" ? feat["componentFile"] : void 0;
+		lines.push(`// ── ${feature.featureKey} — ${feature.title}`);
+		for (const e of iface) {
+			const importPath = file ? file.split(",")[0]?.trim() ?? feature.featureKey : `./${feature.featureKey}`;
+			lines.push(`// export { ${e.name} } from '${importPath}'`);
+			totalExports++;
+		}
+		lines.push(``);
+	}
+	if (totalExports === 0) {
+		lines.push(`// No publicInterface entries found across ${scanned.length} feature(s).`);
+		lines.push(`// Add publicInterface[] to your feature.jsons to populate this barrel.`);
+		lines.push(``);
+	}
+	const content = lines.join("\n");
+	const outPath = opts.out ?? resolve(startDir, "index.generated.ts");
+	if (opts.dryRun) {
+		process$1.stdout.write(content);
+		process$1.stdout.write(`\n\n  [dry-run] No file written.\n`);
+		return;
+	}
+	writeFileSync(outPath, content, "utf-8");
+	process$1.stdout.write(`  ✓ index → ${outPath}\n    ${totalExports} export(s) from ${featuresWithInterface}/${scanned.length} features\n\n`);
+}
+async function runPluginGenerator(name, gen, startDir, configDir, opts) {
+	const scope = gen.scope ?? "feature";
+	let features;
+	if (scope === "workspace") features = (await scanFeatures(startDir)).map((s) => s.feature).filter((f) => {
+		if (gen.filterStatus && !gen.filterStatus.includes(f["status"])) return false;
+		if (gen.filterTags) {
+			const ftags = f["tags"] ?? [];
+			if (!gen.filterTags.some((t) => ftags.includes(t))) return false;
+		}
+		return true;
+	});
+	else {
+		const found = findNearestFeatureJson$1(startDir);
+		if (!found) throw new Error(`No feature.json found from "${startDir}"`);
+		const raw = readFileSync(found, "utf-8");
+		features = [JSON.parse(raw)];
+	}
+	process$1.stdout.write(`\nGenerator "${name}" [${gen.type}/${scope}] — ${features.length} feature(s)\n`);
+	if (gen.type === "script") {
+		if (!gen.script) throw new Error(`Generator "${name}": missing "script" path.`);
+		const scriptPath = resolve(configDir, gen.script);
+		const input = JSON.stringify(scope === "workspace" ? features : features[0], null, 2);
+		const result = spawnSync("node", [scriptPath], {
+			input,
+			encoding: "utf-8",
+			cwd: configDir
+		});
+		if (result.error || result.status !== 0) {
+			const msg = result.stderr || (result.error?.message ?? `exit ${result.status}`);
+			throw new Error(`Script failed: ${msg}`);
+		}
+		writeOrPrintPlugin(result.stdout ?? "", name, gen, features, configDir, opts);
+	} else if (gen.type === "template") {
+		if (!gen.template) throw new Error(`Generator "${name}": missing "template" path.`);
+		const templatePath = resolve(configDir, gen.template);
+		let template;
+		try {
+			template = readFileSync(templatePath, "utf-8");
+		} catch {
+			throw new Error(`Cannot read template: ${templatePath}`);
+		}
+		if (scope === "workspace") {
+			const ctx = {
+				features,
+				count: features.length
+			};
+			writeOrPrintPlugin(renderTemplate(template, ctx), name, gen, features, configDir, opts);
+		} else for (const f of features) writeOrPrintPlugin(renderTemplate(template, f), name, gen, [f], configDir, opts);
+	} else if (gen.type === "ai") {
+		if (!gen.systemPrompt) throw new Error(`Generator "${name}": missing "systemPrompt".`);
+		let systemPrompt;
+		if (gen.systemPrompt.endsWith(".md") || gen.systemPrompt.endsWith(".txt")) try {
+			systemPrompt = readFileSync(resolve(configDir, gen.systemPrompt), "utf-8");
+		} catch {
+			throw new Error(`Cannot read systemPrompt file: ${gen.systemPrompt}`);
+		}
+		else systemPrompt = gen.systemPrompt;
+		for (const f of features) {
+			const featureDir = startDir;
+			const outFile = resolveOutputPath(opts.out ?? gen.outputFile, f, configDir);
+			await genWithCustomPrompt({
+				featureDir,
+				systemPrompt,
+				dryRun: opts.dryRun,
+				outFile,
+				model: opts.model
+			});
+		}
+	}
+}
+/** Lightweight template engine: replaces {{field}} with feature values */
+function renderTemplate(template, ctx) {
+	return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+		const val = ctx[key];
+		if (val === void 0 || val === null) return "";
+		if (typeof val === "string") return val;
+		return JSON.stringify(val);
+	});
+}
+function resolveOutputPath(pattern, f, startDir) {
+	if (!pattern) return void 0;
+	const slug = String(f["title"] ?? "untitled").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+	return resolve(startDir, pattern.replace(/\{featureKey\}/g, String(f["featureKey"] ?? "unknown")).replace(/\{domain\}/g, String(f["domain"] ?? "misc")).replace(/\{status\}/g, String(f["status"] ?? "draft")).replace(/\{title\}/g, slug));
+}
+function writeOrPrintPlugin(output, name, gen, features, baseDir, opts) {
+	if (opts.dryRun) {
+		process$1.stdout.write(output);
+		process$1.stdout.write(`\n\n  [dry-run] No file written.\n`);
+		return;
+	}
+	const outPath = resolveOutputPath(opts.out ?? gen.outputFile, features[0] ?? {}, baseDir);
+	if (!outPath) {
+		process$1.stdout.write(output);
+		return;
+	}
+	writeFileSync(outPath, output, "utf-8");
+	process$1.stdout.write(`  ✓ "${name}" → ${outPath}\n`);
+}
 //#endregion
 //#region src/commands/guardlock.ts
 /**
@@ -10076,7 +10473,7 @@ const doctorCommand = new Command("doctor").description("Check workspace health
 function esc$12(s) {
 	return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function generateHtmlWiki(features, projectName, viewLabel, viewName) {
+function generateHtmlWiki(features, projectName, viewLabel, viewName, renderMode) {
 	const dataJson = JSON.stringify(features).replace(/<\/script>/gi, "<\\/script>");
 	features.filter((f) => f.status === "active").length, features.filter((f) => f.status === "frozen").length, features.filter((f) => f.status === "draft").length, features.filter((f) => f.status === "deprecated").length;
 	const domains = [...new Set(features.map((f) => f.domain).filter(Boolean))].sort();
@@ -10685,7 +11082,7 @@ function statusColor(s) {
 
 // ── Tree building ────────────────────────────────────────────────────────────
 
-const VIEW = '${viewName || ""}';
+const VIEW = '${renderMode || viewName || ""}';
 const byKey = new Map(FEATURES.map(f => [f.featureKey, f]));
 
 function getChildren(key) {
@@ -21449,158 +21846,1266 @@ gsearch.addEventListener('keydown', e => {
 </html>`;
 }
 //#endregion
-//#region src/lib/hubGenerator.ts
-/** Canonical ordered entry definitions for all standard LAC outputs. */
-const ALL_HUB_ENTRIES = [
-	{
-		file: "lac-guide.html",
-		label: "User Guide",
-		description: "How to use every user-facing feature — generated from userGuide fields",
-		icon: "📖",
-		primary: true
-	},
-	{
-		file: "lac-story.html",
-		label: "Product Story",
-		description: "Long-form narrative case study built from feature data",
-		icon: "📰",
-		primary: true
-	},
-	{
-		file: "lac-wiki.html",
-		label: "Feature Wiki",
-		description: "Complete searchable wiki — all fields, all features, sidebar navigation",
-		icon: "🗂️",
-		primary: false
-	},
-	{
-		file: "lac-kanban.html",
-		label: "Kanban Board",
-		description: "Active / Frozen / Draft columns with sortable, filterable cards",
-		icon: "📋",
-		primary: false
-	},
-	{
-		file: "lac-health.html",
-		label: "Health Scorecard",
-		description: "Completeness, coverage, tech-debt score, and field fill rates",
-		icon: "🏥",
-		primary: false
-	},
-	{
-		file: "lac-decisions.html",
-		label: "Decision Log",
-		description: "All architectural decisions consolidated and searchable by domain",
-		icon: "⚖️",
-		primary: false
-	},
-	{
-		file: "lac-heatmap.html",
-		label: "Completeness Heatmap",
-		description: "Field x feature completeness grid — quickly spot gaps",
-		icon: "🔥",
-		primary: false
-	},
-	{
-		file: "lac-graph.html",
-		label: "Lineage Graph",
-		description: "Interactive force-directed feature dependency graph",
-		icon: "🕸️",
-		primary: false
-	},
-	{
-		file: "lac-print.html",
-		label: "Print",
-		description: "Print-ready A4 document — all features in clean two-column layout",
-		icon: "🖨️",
-		primary: false
-	},
-	{
-		file: "lac-raw.html",
-		label: "Raw Dump",
-		description: "Field-by-field dump of every feature.json with sidebar navigation",
-		icon: "🔩",
-		primary: false
-	}
-];
-function generateHub(projectName, stats, entries, generatedAt = (/* @__PURE__ */ new Date()).toISOString(), prefix) {
+//#region src/lib/changelogGenerator.ts
+/**
+* generateChangelog — aggregates all revision[] entries across the workspace,
+* sorts by date descending, groups by month, and renders a structured HTML changelog.
+*
+* Output: lac-changelog.html
+*/
+function generateChangelog(features, projectName, since) {
 	function esc(s) {
 		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 	}
-	const urlPrefix = prefix ? "/" + (/[A-Za-z]:[/\\]/.test(prefix) ? prefix.split(/[/\\]/).filter(Boolean).pop() ?? "" : prefix.replace(/^\/+/, "").replace(/\/+$/, "")) : "";
-	function href(file) {
-		return urlPrefix ? `${urlPrefix}/${file}` : `./${file}`;
-	}
-	const primaryEntries = entries.filter((e) => e.primary);
-	const secondaryEntries = entries.filter((e) => !e.primary);
-	const date = new Date(generatedAt).toLocaleDateString("en-US", {
-		year: "numeric",
-		month: "long",
-		day: "numeric"
-	});
-	function primaryCard(e) {
-		return `
-    <a href="${esc(href(e.file))}" class="primary-card">
-      <div class="primary-card-icon">${e.icon}</div>
-      <div class="primary-card-body">
-        <div class="primary-card-label">${esc(e.label)}</div>
-        <div class="primary-card-desc">${esc(e.description)}</div>
-      </div>
-      <div class="primary-card-arrow">→</div>
-    </a>`;
+	const entries = [];
+	for (const f of features) {
+		const revisions = f["revisions"];
+		if (!revisions) continue;
+		for (const r of revisions) {
+			if (since && r.date < since) continue;
+			entries.push({
+				date: r.date,
+				author: r.author,
+				fields_changed: r.fields_changed,
+				reason: r.reason,
+				featureKey: f.featureKey,
+				featureTitle: f.title,
+				featureDomain: f.domain ?? "misc",
+				featureStatus: f.status
+			});
+		}
 	}
-	function secondaryCard(e) {
-		return `
-    <a href="${esc(href(e.file))}" class="secondary-card">
-      <div class="secondary-card-icon">${e.icon}</div>
-      <div class="secondary-card-label">${esc(e.label)}</div>
-      <div class="secondary-card-desc">${esc(e.description)}</div>
-    </a>`;
+	entries.sort((a, b) => b.date.localeCompare(a.date));
+	const byMonth = /* @__PURE__ */ new Map();
+	for (const e of entries) {
+		const month = e.date.slice(0, 7);
+		const group = byMonth.get(month) ?? [];
+		group.push(e);
+		byMonth.set(month, group);
+	}
+	const months = [...byMonth.keys()].sort((a, b) => b.localeCompare(a));
+	function monthLabel(ym) {
+		const [y, m] = ym.split("-");
+		return new Date(Number(y), Number(m) - 1, 1).toLocaleString("en-US", {
+			month: "long",
+			year: "numeric"
+		});
 	}
-	const domainList = stats.domains.length > 0 ? stats.domains.slice(0, 6).map((d) => `<span class="domain-tag">${esc(d)}</span>`).join("") + (stats.domains.length > 6 ? `<span class="domain-tag">+${stats.domains.length - 6}</span>` : "") : "";
+	function statusColor(s) {
+		return s === "frozen" ? "var(--status-frozen)" : s === "active" ? "var(--status-active)" : s === "draft" ? "var(--status-draft)" : "var(--status-deprecated)";
+	}
+	const navHtml = months.map((m, i) => `<a class="nav-item${i === 0 ? " active" : ""}" data-month="${esc(m)}" href="#${esc(m)}">${esc(monthLabel(m))} <span class="nav-count">${byMonth.get(m).length}</span></a>`).join("\n");
+	const sectionsHtml = months.map((m, i) => {
+		const revs = byMonth.get(m);
+		const items = revs.map((r) => `
+      <div class="rev-card">
+        <div class="rev-card-top">
+          <div class="rev-feature">
+            <span class="rev-key">${esc(r.featureKey)}</span>
+            <span class="rev-title">${esc(r.featureTitle)}</span>
+            <span class="rev-domain">${esc(r.featureDomain.replace(/-/g, " "))}</span>
+            <span class="rev-status" style="color:${statusColor(r.featureStatus)}">${esc(r.featureStatus)}</span>
+          </div>
+          <div class="rev-meta">
+            <span class="rev-date">${esc(r.date)}</span>
+            <span class="rev-author">${esc(r.author)}</span>
+          </div>
+        </div>
+        <div class="rev-reason">${esc(r.reason)}</div>
+        <div class="rev-fields">${r.fields_changed.map((f) => `<span class="rev-field">${esc(f)}</span>`).join("")}</div>
+      </div>`).join("");
+		return `<section id="${esc(m)}" class="month-section${i > 0 ? " hidden" : ""}">
+      <div class="month-header">
+        <div class="month-title">${esc(monthLabel(m))}</div>
+        <div class="month-count">${revs.length} change${revs.length !== 1 ? "s" : ""}</div>
+      </div>
+      ${items}
+    </section>`;
+	}).join("\n");
+	const sinceNote = since ? ` · since ${since}` : "";
 	return `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${esc(projectName)} — Life-as-Code Hub</title>
+<title>${esc(projectName)} — Changelog</title>
 <style>
 *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
 :root {
-  --bg:        #0f0d0b;
-  --bg-card:   #181512;
-  --bg-hover:  #1e1a16;
-  --border:    #262018;
-  --text:      #ece3d8;
-  --text-mid:  #b0a494;
-  --text-soft: #736455;
-  --accent:    #c4a255;
-  --accent-w:  #e8b865;
-  --mono: 'Cascadia Code','Fira Code','JetBrains Mono','Consolas',monospace;
-  --sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
-  --frozen:  #5b82cc; --active: #4aad72; --draft: #c4a255; --deprecated: #cc5b5b;
+  --bg: #0f0d0b; --bg-sidebar: #0b0a08; --bg-card: #181512; --bg-hover: #1e1a16; --bg-active: #231e17;
+  --border: #262018; --border-soft: #1e1a14; --text: #ece3d8; --text-mid: #b0a494; --text-soft: #736455;
+  --accent: #c4a255; --mono: 'Cascadia Code','Fira Code','Consolas',monospace; --sans: -apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
+  --status-frozen: #5b82cc; --status-active: #4aad72; --status-draft: #c4a255; --status-deprecated: #cc5b5b;
 }
 html { scroll-behavior: smooth; }
-body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; min-height: 100vh; }
-
-/* ── Topbar ── */
-.topbar { height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 28px; background: #0b0a08; border-bottom: 1px solid var(--border); position: sticky; top: 0; z-index: 10; }
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; display: flex; flex-direction: column; height: 100vh; overflow: hidden; }
+.shell { display: flex; flex-direction: column; height: 100vh; overflow: hidden; }
+.topbar { flex-shrink: 0; height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 20px; background: var(--bg-sidebar); border-bottom: 1px solid var(--border); }
 .topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
-.topbar-sep   { color: var(--border); font-size: 18px; line-height: 1; }
+.topbar-sep { color: var(--border); font-size: 18px; }
 .topbar-title { font-size: 13px; color: var(--text-mid); }
-.topbar-date  { margin-left: auto; font-family: var(--mono); font-size: 10px; color: var(--text-soft); }
-
-/* ── Layout ── */
-.page { max-width: 880px; margin: 0 auto; padding: 56px 28px 100px; }
-
-/* ── Hero ── */
-.hero { margin-bottom: 48px; }
-.hero-eyebrow { font-family: var(--mono); font-size: 9px; letter-spacing: 0.22em; text-transform: uppercase; color: var(--accent); margin-bottom: 12px; }
-.hero-title   { font-size: 40px; font-weight: 800; color: var(--text); letter-spacing: -0.025em; line-height: 1.1; margin-bottom: 10px; }
-.hero-sub     { font-size: 15px; color: var(--text-mid); max-width: 520px; line-height: 1.7; margin-bottom: 28px; }
-
-/* ── Stats row ── */
-.stats-row { display: flex; flex-wrap: wrap; gap: 1px; background: var(--border); border: 1px solid var(--border); border-radius: 10px; overflow: hidden; margin-bottom: 8px; }
+.topbar-meta { margin-left: auto; font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.body-row { display: flex; flex: 1; min-height: 0; }
+.sidebar { width: 220px; flex-shrink: 0; background: var(--bg-sidebar); border-right: 1px solid var(--border); display: flex; flex-direction: column; overflow: hidden; }
+.sidebar-header { padding: 14px 16px 10px; border-bottom: 1px solid var(--border); }
+.sidebar-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.16em; text-transform: uppercase; color: var(--text-soft); }
+.nav-tree { flex: 1; overflow-y: auto; padding: 8px 0 32px; scrollbar-width: thin; scrollbar-color: var(--border) transparent; }
+.nav-item { display: flex; align-items: center; justify-content: space-between; padding: 7px 14px; font-size: 12px; color: var(--text-mid); cursor: pointer; text-decoration: none; border-left: 2px solid transparent; transition: background 0.1s; }
+.nav-item:hover { background: var(--bg-hover); color: var(--text); }
+.nav-item.active { background: var(--bg-active); border-left-color: var(--accent); color: var(--text); }
+.nav-count { font-family: var(--mono); font-size: 10px; color: var(--text-soft); background: var(--bg-card); padding: 1px 6px; border-radius: 999px; border: 1px solid var(--border); }
+.content { flex: 1; min-width: 0; overflow-y: auto; scrollbar-width: thin; scrollbar-color: var(--border) transparent; }
+.month-section { max-width: 760px; margin: 0 auto; padding: 40px 40px 80px; }
+.month-section.hidden { display: none; }
+.month-header { display: flex; align-items: baseline; gap: 12px; margin-bottom: 28px; padding-bottom: 14px; border-bottom: 1px solid var(--border); }
+.month-title { font-size: 22px; font-weight: 800; color: var(--text); letter-spacing: -0.01em; }
+.month-count { font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.rev-card { background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; padding: 16px 20px; margin-bottom: 12px; }
+.rev-card-top { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; margin-bottom: 10px; }
+.rev-feature { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.rev-key { font-family: var(--mono); font-size: 10px; color: var(--text-soft); }
+.rev-title { font-size: 13px; font-weight: 600; color: var(--text); }
+.rev-domain { font-family: var(--mono); font-size: 10px; color: var(--text-soft); padding: 1px 7px; background: var(--bg); border: 1px solid var(--border); border-radius: 999px; }
+.rev-status { font-family: var(--mono); font-size: 10px; }
+.rev-meta { text-align: right; flex-shrink: 0; }
+.rev-date { font-family: var(--mono); font-size: 11px; color: var(--text-soft); display: block; }
+.rev-author { font-family: var(--mono); font-size: 10px; color: var(--accent); }
+.rev-reason { font-size: 13px; color: var(--text-mid); line-height: 1.65; margin-bottom: 10px; }
+.rev-fields { display: flex; gap: 6px; flex-wrap: wrap; }
+.rev-field { font-family: var(--mono); font-size: 10px; color: var(--text-soft); background: var(--bg); border: 1px solid var(--border); border-radius: 3px; padding: 1px 7px; }
+.empty-state { text-align: center; padding: 80px 40px; color: var(--text-soft); }
+.empty-title { font-size: 18px; color: var(--text-mid); margin-bottom: 8px; }
+</style>
+</head>
+<body>
+<div class="shell">
+  <div class="topbar">
+    <span class="topbar-brand">lac·changelog</span>
+    <span class="topbar-sep">/</span>
+    <span class="topbar-title">${esc(projectName)}</span>
+    <span class="topbar-meta">${entries.length} revision${entries.length !== 1 ? "s" : ""}${sinceNote}</span>
+  </div>
+  <div class="body-row">
+    <div class="sidebar">
+      <div class="sidebar-header"><div class="sidebar-label">By Month</div></div>
+      <nav class="nav-tree">${navHtml}</nav>
+    </div>
+    <main class="content" id="content">
+      ${entries.length === 0 ? `<div class="empty-state"><div class="empty-title">No revisions found</div><p>Add revision entries to your feature.jsons${since ? ` after ${since}` : ""}.</p></div>` : sectionsHtml}
+    </main>
+  </div>
+</div>
+<script>
+function showMonth(month) {
+  document.querySelectorAll('.month-section').forEach(s => s.classList.add('hidden'))
+  const sec = document.getElementById(month)
+  if (sec) { sec.classList.remove('hidden'); document.getElementById('content').scrollTop = 0 }
+  document.querySelectorAll('.nav-item').forEach(el => el.classList.toggle('active', el.dataset.month === month))
+  history.replaceState(null, '', '#' + month)
+}
+document.querySelectorAll('.nav-item').forEach(el => {
+  el.addEventListener('click', e => { e.preventDefault(); showMonth(el.dataset.month) })
+})
+const hash = window.location.hash.slice(1)
+if (hash && document.getElementById(hash)) showMonth(hash)
+<\/script>
+</body>
+</html>`;
+}
+//#endregion
+//#region src/lib/releaseNotesGenerator.ts
+/**
+* generateReleaseNotes — user-facing release notes filtered by date or releaseVersion.
+*
+* Features included: those that transitioned to "frozen" after `since` date,
+* OR those whose `releaseVersion` matches the `release` option.
+* Falls back to all frozen features if neither filter is provided.
+*
+* Output: lac-release-notes.html — communication-ready, PM/user tone.
+*/
+function generateReleaseNotes(features, projectName, opts) {
+	function esc(s) {
+		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+	}
+	function mdToHtml(raw) {
+		function inline(s) {
+			return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>").replace(/\*([^*\n]+?)\*/g, "<em>$1</em>").replace(/`([^`]+)`/g, "<code>$1</code>");
+		}
+		return raw.split(/\n{2,}/).map((block) => {
+			const lines = block.split("\n");
+			if (lines.every((l) => /^\s*[-*]\s/.test(l))) return `<ul>${lines.map((l) => `<li>${inline(l.replace(/^\s*[-*]\s/, ""))}</li>`).join("")}</ul>`;
+			return `<p>${lines.map((l) => inline(l.trim())).filter(Boolean).join(" ")}</p>`;
+		}).join("\n");
+	}
+	let releaseFeatures = features.filter((f) => {
+		const feat = f;
+		if (opts.release && feat["releaseVersion"] === opts.release) return true;
+		if (opts.since) {
+			const history = feat["statusHistory"];
+			if (history) return history.some((t) => t.to === "frozen" && t.date >= opts.since);
+		}
+		if (!opts.since && !opts.release) return f.status === "frozen";
+		return false;
+	});
+	releaseFeatures = releaseFeatures.sort((a, b) => (a.priority ?? 99) - (b.priority ?? 99));
+	const domainOrder = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const f of releaseFeatures) {
+		const d = f.domain ?? "other";
+		if (!seen.has(d)) {
+			seen.add(d);
+			domainOrder.push(d);
+		}
+	}
+	const PALETTE = [
+		"#c4a255",
+		"#e8674a",
+		"#4aad72",
+		"#5b82cc",
+		"#b87fda",
+		"#4ab8cc",
+		"#cc5b5b",
+		"#a2cc4a"
+	];
+	const domainColor = {};
+	domainOrder.forEach((d, i) => {
+		domainColor[d] = PALETTE[i % PALETTE.length];
+	});
+	const filterLabel = opts.release ? `v${opts.release}` : opts.since ? `since ${opts.since}` : "all frozen features";
+	function renderFeatureCard(f) {
+		const feat = f;
+		const domain = f.domain ?? "other";
+		const color = domainColor[domain] ?? "#c4a255";
+		const userGuide = typeof feat["userGuide"] === "string" ? feat["userGuide"] : "";
+		const pmSummary = typeof feat["pmSummary"] === "string" ? feat["pmSummary"] : "";
+		const limitations = feat["knownLimitations"] ?? [];
+		const releaseVer = typeof feat["releaseVersion"] === "string" ? feat["releaseVersion"] : "";
+		return `<div class="feature-card" id="${esc(f.featureKey)}">
+      <div class="card-domain-eyebrow" style="color:${color}">${esc(domain.replace(/-/g, " "))}${releaseVer ? ` · v${esc(releaseVer)}` : ""}</div>
+      <div class="card-title">${esc(f.title)}</div>
+      ${pmSummary ? `<div class="card-pm-summary">${esc(pmSummary)}</div>` : ""}
+      ${userGuide ? `<div class="card-guide-block"><div class="card-guide-label">How to use</div><div class="card-guide-text">${mdToHtml(userGuide)}</div></div>` : ""}
+      ${limitations.length > 0 ? `<div class="card-limits"><div class="card-limits-label">Known limitations</div><ul class="card-limits-list">${limitations.map((l) => `<li>${esc(l)}</li>`).join("")}</ul></div>` : ""}
+    </div>`;
+	}
+	const domainSectionsHtml = domainOrder.map((domain) => {
+		const domFeatures = releaseFeatures.filter((f) => (f.domain ?? "other") === domain);
+		return `<div class="domain-section">
+      <div class="domain-header">
+        <div class="domain-pip" style="background:${domainColor[domain]}"></div>
+        <div class="domain-title">${esc(domain.replace(/-/g, " "))}</div>
+        <div class="domain-count">${domFeatures.length} feature${domFeatures.length !== 1 ? "s" : ""}</div>
+      </div>
+      ${domFeatures.map(renderFeatureCard).join("")}
+    </div>`;
+	}).join("");
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${esc(projectName)} — Release Notes</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg: #0f0d0b; --bg-card: #181512; --bg-hover: #1e1a16; --border: #262018; --text: #ece3d8; --text-mid: #b0a494; --text-soft: #736455;
+  --accent: #c4a255; --mono: 'Cascadia Code','Fira Code','Consolas',monospace; --sans: -apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
+}
+html { scroll-behavior: smooth; }
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; }
+.topbar { height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 20px; background: #0b0a08; border-bottom: 1px solid var(--border); position: sticky; top: 0; z-index: 10; }
+.topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
+.topbar-sep { color: var(--border); font-size: 18px; }
+.topbar-title { font-size: 13px; color: var(--text-mid); }
+.topbar-filter { margin-left: auto; font-family: var(--mono); font-size: 11px; color: var(--text-soft); padding: 3px 10px; border: 1px solid var(--border); border-radius: 999px; background: var(--bg-card); }
+.main { max-width: 820px; margin: 0 auto; padding: 56px 40px 100px; }
+.page-eyebrow { font-family: var(--mono); font-size: 9px; letter-spacing: 0.2em; text-transform: uppercase; color: var(--accent); margin-bottom: 14px; }
+.page-title { font-size: 36px; font-weight: 800; letter-spacing: -0.02em; line-height: 1.1; margin-bottom: 10px; }
+.page-sub { font-size: 15px; color: var(--text-mid); margin-bottom: 48px; max-width: 560px; }
+.stats-row { display: flex; gap: 12px; flex-wrap: wrap; margin-bottom: 48px; }
+.stat-card { padding: 14px 18px; background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; min-width: 100px; }
+.stat-num { font-family: var(--mono); font-size: 24px; font-weight: 700; color: var(--accent); }
+.stat-lbl { font-size: 11px; color: var(--text-soft); margin-top: 4px; }
+.domain-section { margin-bottom: 56px; }
+.domain-header { display: flex; align-items: center; gap: 10px; margin-bottom: 20px; padding-bottom: 10px; border-bottom: 1px solid var(--border); }
+.domain-pip { width: 10px; height: 10px; border-radius: 50%; flex-shrink: 0; }
+.domain-title { font-family: var(--mono); font-size: 11px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--text); }
+.domain-count { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-left: auto; }
+.feature-card { background: var(--bg-card); border: 1px solid var(--border); border-radius: 10px; padding: 24px 28px; margin-bottom: 16px; }
+.card-domain-eyebrow { font-family: var(--mono); font-size: 9px; letter-spacing: 0.16em; text-transform: uppercase; margin-bottom: 8px; }
+.card-title { font-size: 20px; font-weight: 800; color: var(--text); letter-spacing: -0.01em; margin-bottom: 10px; }
+.card-pm-summary { font-size: 14px; color: var(--text-mid); line-height: 1.7; margin-bottom: 16px; font-style: italic; }
+.card-guide-block { margin-bottom: 16px; }
+.card-guide-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.16em; text-transform: uppercase; color: var(--accent); margin-bottom: 10px; }
+.card-guide-text { font-size: 14px; color: var(--text-mid); line-height: 1.8; }
+.card-guide-text p { margin-bottom: 0.75em; }
+.card-guide-text p:last-child { margin-bottom: 0; }
+.card-guide-text ul { margin: 0.4em 0 0.8em 1.4em; }
+.card-guide-text li { margin-bottom: 0.3em; }
+.card-guide-text strong { color: var(--text); font-weight: 600; }
+.card-guide-text code { font-family: var(--mono); font-size: 12px; background: var(--bg-hover); border: 1px solid var(--border); border-radius: 3px; padding: 1px 5px; }
+.card-limits { margin-top: 16px; padding-top: 14px; border-top: 1px solid var(--border); }
+.card-limits-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.14em; text-transform: uppercase; color: var(--text-soft); margin-bottom: 8px; }
+.card-limits-list { list-style: none; padding: 0; }
+.card-limits-list li { font-size: 12px; color: var(--text-soft); line-height: 1.6; margin-bottom: 4px; padding-left: 14px; position: relative; }
+.card-limits-list li::before { content: '—'; position: absolute; left: 0; opacity: 0.4; }
+.empty-state { text-align: center; padding: 80px 40px; color: var(--text-soft); }
+.empty-title { font-size: 20px; color: var(--text-mid); margin-bottom: 10px; font-weight: 700; }
+</style>
+</head>
+<body>
+<div class="topbar">
+  <span class="topbar-brand">lac·release-notes</span>
+  <span class="topbar-sep">/</span>
+  <span class="topbar-title">${esc(projectName)}</span>
+  <span class="topbar-filter">${esc(filterLabel)}</span>
+</div>
+<main class="main">
+  <div class="page-eyebrow">release notes</div>
+  <div class="page-title">${esc(projectName)}</div>
+  <div class="page-sub">What shipped — ${esc(filterLabel)}. ${releaseFeatures.length} feature${releaseFeatures.length !== 1 ? "s" : ""} across ${domainOrder.length} domain${domainOrder.length !== 1 ? "s" : ""}.</div>
+  <div class="stats-row">
+    <div class="stat-card"><div class="stat-num">${releaseFeatures.length}</div><div class="stat-lbl">features shipped</div></div>
+    <div class="stat-card"><div class="stat-num">${domainOrder.length}</div><div class="stat-lbl">domains</div></div>
+    <div class="stat-card"><div class="stat-num">${releaseFeatures.filter((f) => f["userGuide"]).length}</div><div class="stat-lbl">with user guides</div></div>
+  </div>
+  ${releaseFeatures.length === 0 ? `<div class="empty-state"><div class="empty-title">No features matched the filter</div><p>${opts.since ? `No features frozen after ${opts.since}.` : opts.release ? `No features with releaseVersion "${opts.release}".` : "No frozen features found."}</p></div>` : domainSectionsHtml}
+</main>
+</body>
+</html>`;
+}
+//#endregion
+//#region src/lib/sprintGenerator.ts
+/**
+* generateSprint — compact sprint planning view.
+*
+* Shows draft + active features sorted by priority.
+* Summary density: title, status badge, priority, problem (first sentence), successCriteria, tags.
+* Designed to be scannable in a standup or sprint planning meeting.
+*
+* Output: lac-sprint.html
+*/
+function generateSprint(features, projectName) {
+	function esc(s) {
+		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+	}
+	const sorted = [...features].sort((a, b) => {
+		if (a.status !== b.status) return a.status === "active" ? -1 : 1;
+		return (a.priority ?? 99) - (b.priority ?? 99);
+	});
+	const activeCount = sorted.filter((f) => f.status === "active").length;
+	const draftCount = sorted.filter((f) => f.status === "draft").length;
+	const domains = [...new Set(sorted.map((f) => f.domain).filter(Boolean))];
+	function priorityLabel(p) {
+		if (!p) return "";
+		const color = {
+			1: "#cc5b5b",
+			2: "#e8674a",
+			3: "#c4a255",
+			4: "#4aad72",
+			5: "#5b82cc"
+		}[p] ?? "#736455";
+		return `<span class="priority-badge" style="background:${color}20;color:${color};border-color:${color}40">P${p}</span>`;
+	}
+	function firstSentence(s) {
+		const match = s.match(/^[^.!?]+[.!?]/);
+		return match ? match[0] : s.length > 120 ? s.slice(0, 120) + "…" : s;
+	}
+	const activeFeatures = sorted.filter((f) => f.status === "active");
+	const draftFeatures = sorted.filter((f) => f.status === "draft");
+	function renderCard(f) {
+		const tags = (f.tags ?? []).slice(0, 4).map((t) => `<span class="tag">${esc(t)}</span>`).join("");
+		const successCriteria = f.successCriteria ?? "";
+		const domain = f.domain ?? "";
+		return `<div class="sprint-card">
+      <div class="card-top">
+        <div class="card-header">
+          ${f.priority ? priorityLabel(f.priority) : ""}
+          <span class="status-dot ${esc(f.status)}"></span>
+          <span class="card-key">${esc(f.featureKey)}</span>
+        </div>
+        <div class="card-title">${esc(f.title)}</div>
+        ${domain ? `<div class="card-domain">${esc(domain.replace(/-/g, " "))}</div>` : ""}
+      </div>
+      <div class="card-problem">${esc(firstSentence(f.problem))}</div>
+      ${successCriteria ? `<div class="card-criteria"><span class="criteria-label">Done when:</span> ${esc(firstSentence(successCriteria))}</div>` : ""}
+      ${tags ? `<div class="card-tags">${tags}</div>` : ""}
+    </div>`;
+	}
+	function renderGroup(title, groupFeatures, statusClass) {
+		if (groupFeatures.length === 0) return "";
+		return `<section class="group-section">
+      <div class="group-header">
+        <div class="group-dot ${statusClass}"></div>
+        <div class="group-title">${esc(title)}</div>
+        <div class="group-count">${groupFeatures.length}</div>
+      </div>
+      <div class="cards-grid">
+        ${groupFeatures.map(renderCard).join("")}
+      </div>
+    </section>`;
+	}
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${esc(projectName)} — Sprint Board</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg: #0f0d0b; --bg-card: #181512; --bg-hover: #1e1a16; --border: #262018; --text: #ece3d8; --text-mid: #b0a494; --text-soft: #736455;
+  --accent: #c4a255; --mono: 'Cascadia Code','Fira Code','Consolas',monospace; --sans: -apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
+  --active: #4aad72; --draft: #c4a255;
+}
+html { scroll-behavior: smooth; }
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; }
+.topbar { height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 24px; background: #0b0a08; border-bottom: 1px solid var(--border); position: sticky; top: 0; z-index: 10; }
+.topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
+.topbar-sep { color: var(--border); font-size: 18px; }
+.topbar-title { font-size: 13px; color: var(--text-mid); }
+.topbar-stats { margin-left: auto; display: flex; gap: 16px; }
+.stat { font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.stat strong { color: var(--text-mid); }
+.main { max-width: 1100px; margin: 0 auto; padding: 40px 32px 80px; }
+.page-title { font-size: 26px; font-weight: 800; color: var(--text); letter-spacing: -0.015em; margin-bottom: 4px; }
+.page-sub { font-size: 13px; color: var(--text-soft); margin-bottom: 40px; }
+.group-section { margin-bottom: 48px; }
+.group-header { display: flex; align-items: center; gap: 10px; margin-bottom: 16px; padding-bottom: 10px; border-bottom: 1px solid var(--border); }
+.group-dot { width: 8px; height: 8px; border-radius: 50%; flex-shrink: 0; }
+.group-dot.active { background: var(--active); }
+.group-dot.draft  { background: var(--draft); }
+.group-title { font-family: var(--mono); font-size: 10px; letter-spacing: 0.14em; text-transform: uppercase; color: var(--text); }
+.group-count { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-left: auto; }
+.cards-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 12px; }
+.sprint-card { background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; padding: 16px 18px; transition: border-color 0.15s; }
+.sprint-card:hover { border-color: var(--text-soft); }
+.card-top { margin-bottom: 10px; }
+.card-header { display: flex; align-items: center; gap: 6px; margin-bottom: 6px; }
+.status-dot { width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0; }
+.status-dot.active { background: var(--active); }
+.status-dot.draft  { background: var(--draft); }
+.card-key { font-family: var(--mono); font-size: 10px; color: var(--text-soft); }
+.priority-badge { font-family: var(--mono); font-size: 9px; padding: 1px 6px; border-radius: 3px; border: 1px solid; letter-spacing: 0.05em; }
+.card-title { font-size: 13px; font-weight: 700; color: var(--text); line-height: 1.35; }
+.card-domain { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-top: 3px; }
+.card-problem { font-size: 12px; color: var(--text-mid); line-height: 1.6; margin-bottom: 8px; }
+.card-criteria { font-size: 11px; color: var(--text-soft); line-height: 1.5; margin-bottom: 8px; }
+.criteria-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--text-soft); }
+.card-tags { display: flex; gap: 4px; flex-wrap: wrap; }
+.tag { font-family: var(--mono); font-size: 9px; color: var(--text-soft); background: var(--bg); border: 1px solid var(--border); border-radius: 999px; padding: 1px 7px; }
+.empty-state { text-align: center; padding: 80px 40px; color: var(--text-soft); }
+</style>
+</head>
+<body>
+<div class="topbar">
+  <span class="topbar-brand">lac·sprint</span>
+  <span class="topbar-sep">/</span>
+  <span class="topbar-title">${esc(projectName)}</span>
+  <div class="topbar-stats">
+    <span class="stat"><strong>${activeCount}</strong> active</span>
+    <span class="stat"><strong>${draftCount}</strong> draft</span>
+    <span class="stat"><strong>${domains.length}</strong> domains</span>
+  </div>
+</div>
+<main class="main">
+  <div class="page-title">${esc(projectName)} — Sprint</div>
+  <div class="page-sub">${sorted.length} features in flight · sorted by priority</div>
+  ${sorted.length === 0 ? `<div class="empty-state">No active or draft features found.</div>` : renderGroup("Active", activeFeatures, "active") + renderGroup("Draft", draftFeatures, "draft")}
+</main>
+</body>
+</html>`;
+}
+//#endregion
+//#region src/lib/apiSurfaceGenerator.ts
+/**
+* generateApiSurface — aggregates all publicInterface[] entries across the workspace.
+*
+* Groups by interface type (React Components, Hooks, Contexts, Services, Functions, Other).
+* Full-text search. Each entry links back to the feature wiki.
+*
+* Output: lac-api-surface.html
+*/
+function generateApiSurface(features, projectName) {
+	function esc(s) {
+		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+	}
+	const entries = [];
+	for (const f of features) {
+		const iface = f["publicInterface"];
+		if (!iface || iface.length === 0) continue;
+		for (const e of iface) entries.push({
+			name: e.name,
+			type: e.type,
+			description: e.description ?? "",
+			featureKey: f.featureKey,
+			featureTitle: f.title,
+			featureDomain: f.domain ?? "misc",
+			componentFile: typeof f["componentFile"] === "string" ? f["componentFile"] : void 0
+		});
+	}
+	function classifyType(t) {
+		const lower = t.toLowerCase();
+		if (lower.includes("react component") || lower.includes("component") || lower.includes("view") || lower.includes("screen")) return "Components";
+		if (lower.includes("hook") || lower.startsWith("use")) return "Hooks";
+		if (lower.includes("context") || lower.includes("provider")) return "Contexts";
+		if (lower.includes("service") || lower.includes("class") || lower.includes("manager")) return "Services";
+		if (lower.includes("function") || lower.includes("util") || lower.includes("helper")) return "Functions";
+		if (lower.includes("type") || lower.includes("interface") || lower.includes("enum")) return "Types";
+		return "Other";
+	}
+	const groupOrder = [
+		"Components",
+		"Hooks",
+		"Contexts",
+		"Services",
+		"Functions",
+		"Types",
+		"Other"
+	];
+	const groups = /* @__PURE__ */ new Map();
+	for (const e of entries) {
+		const g = classifyType(e.type);
+		const list = groups.get(g) ?? [];
+		list.push(e);
+		groups.set(g, list);
+	}
+	const presentGroups = groupOrder.filter((g) => groups.has(g));
+	const groupIcons = {
+		Components: "🧩",
+		Hooks: "🪝",
+		Contexts: "🔗",
+		Services: "⚙️",
+		Functions: "𝑓",
+		Types: "📐",
+		Other: "◻️"
+	};
+	const navHtml = presentGroups.map((g) => `<a class="nav-item" data-group="${esc(g)}" href="#group-${esc(g)}">${groupIcons[g] ?? ""} ${esc(g)} <span class="nav-count">${groups.get(g).length}</span></a>`).join("\n");
+	function renderEntry(e) {
+		return `<div class="api-entry" data-search="${esc(`${e.name} ${e.type} ${e.description} ${e.featureTitle} ${e.featureDomain}`).toLowerCase()}">
+      <div class="entry-top">
+        <div class="entry-name"><code class="entry-code">${esc(e.name)}</code></div>
+        <div class="entry-type">${esc(e.type)}</div>
+      </div>
+      ${e.description ? `<div class="entry-desc">${esc(e.description)}</div>` : ""}
+      <div class="entry-source">
+        <a class="entry-feature-link" href="./lac-wiki.html#${esc(e.featureKey)}">${esc(e.featureTitle)}</a>
+        <span class="entry-domain">${esc(e.featureDomain.replace(/-/g, " "))}</span>
+        ${e.componentFile ? `<span class="entry-file">${esc(e.componentFile.split(",")[0]?.trim() ?? "")}</span>` : ""}
+      </div>
+    </div>`;
+	}
+	const groupSectionsHtml = presentGroups.map((g) => `<section id="group-${esc(g)}" class="group-section">
+      <div class="group-header">
+        <span class="group-icon">${groupIcons[g] ?? ""}</span>
+        <span class="group-title">${esc(g)}</span>
+        <span class="group-count">${groups.get(g).length}</span>
+      </div>
+      <div class="entries-list">
+        ${groups.get(g).map(renderEntry).join("")}
+      </div>
+    </section>`).join("");
+	const searchData = JSON.stringify(entries.map((e) => ({
+		name: e.name,
+		type: e.type,
+		description: e.description,
+		featureTitle: e.featureTitle,
+		featureDomain: e.featureDomain,
+		featureKey: e.featureKey,
+		group: classifyType(e.type)
+	})));
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${esc(projectName)} — API Surface</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg: #0f0d0b; --bg-sidebar: #0b0a08; --bg-card: #181512; --bg-hover: #1e1a16; --bg-active: #231e17;
+  --border: #262018; --border-soft: #1e1a14; --text: #ece3d8; --text-mid: #b0a494; --text-soft: #736455;
+  --accent: #c4a255; --mono: 'Cascadia Code','Fira Code','Consolas',monospace; --sans: -apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
+}
+html { scroll-behavior: smooth; }
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; display: flex; flex-direction: column; height: 100vh; overflow: hidden; }
+.shell { display: flex; flex-direction: column; height: 100vh; overflow: hidden; }
+.topbar { flex-shrink: 0; height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 20px; background: var(--bg-sidebar); border-bottom: 1px solid var(--border); }
+.topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
+.topbar-sep { color: var(--border); font-size: 18px; }
+.topbar-title { font-size: 13px; color: var(--text-mid); }
+.topbar-right { margin-left: auto; display: flex; align-items: center; gap: 10px; }
+.topbar-count { font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.search-wrap { position: relative; }
+#gsearch { background: var(--bg-card); border: 1px solid var(--border); border-radius: 5px; padding: 5px 10px 5px 28px; font-family: var(--mono); font-size: 11px; color: var(--text); outline: none; width: 180px; transition: border-color 0.15s, width 0.2s; }
+#gsearch:focus { border-color: var(--accent); width: 240px; }
+#gsearch::placeholder { color: var(--text-soft); }
+.search-icon { position: absolute; left: 8px; top: 50%; transform: translateY(-50%); color: var(--text-soft); pointer-events: none; }
+.body-row { display: flex; flex: 1; min-height: 0; }
+.sidebar { width: 200px; flex-shrink: 0; background: var(--bg-sidebar); border-right: 1px solid var(--border); display: flex; flex-direction: column; overflow: hidden; }
+.sidebar-header { padding: 14px 16px 10px; border-bottom: 1px solid var(--border); }
+.sidebar-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.16em; text-transform: uppercase; color: var(--text-soft); }
+.nav-tree { flex: 1; overflow-y: auto; padding: 8px 0; scrollbar-width: thin; scrollbar-color: var(--border) transparent; }
+.nav-item { display: flex; align-items: center; justify-content: space-between; padding: 7px 14px; font-size: 12px; color: var(--text-mid); cursor: pointer; text-decoration: none; border-left: 2px solid transparent; transition: background 0.1s; gap: 6px; }
+.nav-item:hover { background: var(--bg-hover); color: var(--text); }
+.nav-item.active { background: var(--bg-active); border-left-color: var(--accent); color: var(--text); }
+.nav-count { font-family: var(--mono); font-size: 10px; color: var(--text-soft); background: var(--bg-card); padding: 1px 5px; border-radius: 999px; border: 1px solid var(--border); margin-left: auto; }
+.content { flex: 1; min-width: 0; overflow-y: auto; padding: 32px 40px 80px; scrollbar-width: thin; scrollbar-color: var(--border) transparent; }
+.group-section { margin-bottom: 48px; max-width: 800px; }
+.group-section.hidden { display: none; }
+.group-header { display: flex; align-items: center; gap: 10px; margin-bottom: 16px; padding-bottom: 10px; border-bottom: 1px solid var(--border); }
+.group-icon { font-size: 16px; }
+.group-title { font-family: var(--mono); font-size: 11px; letter-spacing: 0.12em; text-transform: uppercase; color: var(--text); }
+.group-count { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-left: auto; }
+.entries-list { display: flex; flex-direction: column; gap: 8px; }
+.api-entry { background: var(--bg-card); border: 1px solid var(--border); border-radius: 7px; padding: 14px 18px; transition: border-color 0.15s; }
+.api-entry:hover { border-color: var(--text-soft); }
+.api-entry.filtered-out { display: none; }
+.entry-top { display: flex; align-items: baseline; gap: 12px; margin-bottom: 6px; }
+.entry-name { flex-shrink: 0; }
+.entry-code { font-family: var(--mono); font-size: 13px; color: var(--accent); background: transparent; }
+.entry-type { font-family: var(--mono); font-size: 10px; color: var(--text-soft); padding: 1px 8px; background: var(--bg); border: 1px solid var(--border); border-radius: 3px; }
+.entry-desc { font-size: 12px; color: var(--text-mid); line-height: 1.6; margin-bottom: 8px; }
+.entry-source { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.entry-feature-link { font-family: var(--mono); font-size: 10px; color: var(--accent); text-decoration: none; opacity: 0.7; }
+.entry-feature-link:hover { opacity: 1; text-decoration: underline; }
+.entry-domain { font-family: var(--mono); font-size: 10px; color: var(--text-soft); padding: 1px 7px; background: var(--bg); border: 1px solid var(--border); border-radius: 999px; }
+.entry-file { font-family: var(--mono); font-size: 10px; color: var(--text-soft); }
+.empty-state { text-align: center; padding: 60px 40px; color: var(--text-soft); }
+#no-results { display: none; padding: 40px; text-align: center; color: var(--text-soft); font-size: 13px; }
+</style>
+</head>
+<body>
+<div class="shell">
+  <div class="topbar">
+    <span class="topbar-brand">lac·api-surface</span>
+    <span class="topbar-sep">/</span>
+    <span class="topbar-title">${esc(projectName)}</span>
+    <div class="topbar-right">
+      <span class="topbar-count">${entries.length} exports</span>
+      <div class="search-wrap">
+        <svg class="search-icon" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
+        <input type="text" id="gsearch" placeholder="Search API…" autocomplete="off" spellcheck="false">
+      </div>
+    </div>
+  </div>
+  <div class="body-row">
+    <div class="sidebar">
+      <div class="sidebar-header"><div class="sidebar-label">By Type</div></div>
+      <nav class="nav-tree">
+        <a class="nav-item active" data-group="all" href="#">All <span class="nav-count">${entries.length}</span></a>
+        ${navHtml}
+      </nav>
+    </div>
+    <main class="content" id="content">
+      ${entries.length === 0 ? `<div class="empty-state">No publicInterface entries found. Add publicInterface[] to your feature.jsons.</div>` : groupSectionsHtml}
+      <div id="no-results">No matches found.</div>
+    </main>
+  </div>
+</div>
+<script>
+const SEARCH_DATA = ${searchData};
+const gsearch = document.getElementById('gsearch');
+function filterEntries(q) {
+  const lower = q.toLowerCase().trim();
+  let anyVisible = false;
+  document.querySelectorAll('.api-entry').forEach(el => {
+    const searchStr = el.dataset.search ?? '';
+    const match = !lower || searchStr.includes(lower);
+    el.classList.toggle('filtered-out', !match);
+    if (match) anyVisible = true;
+  });
+  document.getElementById('no-results').style.display = (lower && !anyVisible) ? 'block' : 'none';
+}
+gsearch.addEventListener('input', () => filterEntries(gsearch.value));
+document.querySelectorAll('.nav-item').forEach(el => {
+  el.addEventListener('click', e => {
+    e.preventDefault();
+    const group = el.dataset.group;
+    document.querySelectorAll('.nav-item').forEach(n => n.classList.remove('active'));
+    el.classList.add('active');
+    if (group === 'all') {
+      document.querySelectorAll('.group-section').forEach(s => s.classList.remove('hidden'));
+    } else {
+      document.querySelectorAll('.group-section').forEach(s => {
+        s.classList.toggle('hidden', s.id !== 'group-' + group);
+      });
+      const target = document.getElementById('group-' + group);
+      if (target) { document.getElementById('content').scrollTop = target.offsetTop - 20; }
+    }
+  });
+});
+<\/script>
+</body>
+</html>`;
+}
+//#endregion
+//#region src/lib/dependencyMapGenerator.ts
+/**
+* generateDependencyMap — visualizes cross-feature runtime dependencies from externalDependencies[].
+*
+* Distinct from the lineage graph (which shows parent/child hierarchy).
+* This shows the RUNTIME dependency web — which features call into other features at runtime.
+*
+* Uses a force-directed canvas graph with:
+* - Node size = number of dependents (high coupling = larger node)
+* - Node color = domain
+* - Edge direction = dependency (A → B means A depends on B)
+* - Red edges = potential cycles
+* - Detail panel on click
+*
+* Output: lac-depmap.html
+*/
+function generateDependencyMap(features, projectName) {
+	function esc(s) {
+		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+	}
+	const nodeMap = /* @__PURE__ */ new Map();
+	for (const f of features) nodeMap.set(f.featureKey, {
+		key: f.featureKey,
+		title: f.title,
+		domain: f.domain ?? "misc",
+		status: f.status,
+		deps: [],
+		dependents: []
+	});
+	for (const f of features) {
+		const externalDeps = f["externalDependencies"];
+		if (!externalDeps || externalDeps.length === 0) continue;
+		const node = nodeMap.get(f.featureKey);
+		for (const dep of externalDeps) if (nodeMap.has(dep)) {
+			node.deps.push(dep);
+			nodeMap.get(dep).dependents.push(f.featureKey);
+		}
+	}
+	const nodes = [...nodeMap.values()];
+	const edges = nodes.flatMap((n) => n.deps.map((dep) => ({
+		from: n.key,
+		to: dep
+	})));
+	function hasCycle(from, to, visited = /* @__PURE__ */ new Set()) {
+		if (from === to) return true;
+		if (visited.has(from)) return false;
+		visited.add(from);
+		return nodeMap.get(from)?.deps.some((dep) => hasCycle(dep, to, new Set(visited))) ?? false;
+	}
+	const cycleEdges = new Set(edges.filter((e) => hasCycle(e.to, e.from)).map((e) => `${e.from}→${e.to}`));
+	const domains = [...new Set(nodes.map((n) => n.domain))];
+	const PALETTE = [
+		"#c4a255",
+		"#e8674a",
+		"#4aad72",
+		"#5b82cc",
+		"#b87fda",
+		"#4ab8cc",
+		"#cc5b5b",
+		"#a2cc4a",
+		"#e8b865",
+		"#736455"
+	];
+	const domainColor = {};
+	domains.forEach((d, i) => {
+		domainColor[d] = PALETTE[i % PALETTE.length];
+	});
+	const graphData = JSON.stringify({
+		nodes: nodes.map((n) => ({
+			key: n.key,
+			title: n.title,
+			domain: n.domain,
+			status: n.status,
+			depCount: n.deps.length,
+			dependentCount: n.dependents.length,
+			color: domainColor[n.domain] ?? "#736455"
+		})),
+		edges: edges.map((e) => ({
+			from: e.from,
+			to: e.to,
+			isCycle: cycleEdges.has(`${e.from}→${e.to}`)
+		}))
+	});
+	const isolatedCount = nodes.filter((n) => n.deps.length === 0 && n.dependents.length === 0).length;
+	const highCouplingCount = nodes.filter((n) => n.dependents.length >= 3).length;
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${esc(projectName)} — Dependency Map</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg: #0f0d0b; --bg-card: #181512; --bg-hover: #1e1a16; --border: #262018; --text: #ece3d8; --text-mid: #b0a494; --text-soft: #736455;
+  --accent: #c4a255; --mono: 'Cascadia Code','Fira Code','Consolas',monospace; --sans: -apple-system,BlinkMacSystemFont,'Segoe UI',system-ui,sans-serif;
+}
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; display: flex; flex-direction: column; height: 100vh; overflow: hidden; }
+.topbar { flex-shrink: 0; height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 20px; background: #0b0a08; border-bottom: 1px solid var(--border); }
+.topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
+.topbar-sep { color: var(--border); font-size: 18px; }
+.topbar-title { font-size: 13px; color: var(--text-mid); }
+.topbar-stats { margin-left: auto; display: flex; gap: 16px; }
+.topbar-stat { font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.topbar-stat strong { color: var(--text-mid); }
+.main { display: flex; flex: 1; min-height: 0; position: relative; }
+canvas { flex: 1; cursor: grab; display: block; }
+canvas:active { cursor: grabbing; }
+.legend { position: absolute; top: 16px; left: 16px; background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; padding: 14px 16px; min-width: 180px; }
+.legend-title { font-family: var(--mono); font-size: 9px; letter-spacing: 0.14em; text-transform: uppercase; color: var(--text-soft); margin-bottom: 10px; }
+.legend-items { display: flex; flex-direction: column; gap: 6px; }
+.legend-item { display: flex; align-items: center; gap: 8px; font-size: 11px; color: var(--text-mid); }
+.legend-dot { width: 10px; height: 10px; border-radius: 50%; flex-shrink: 0; }
+.legend-line { width: 20px; height: 2px; flex-shrink: 0; }
+.detail-panel { position: absolute; top: 16px; right: 16px; width: 280px; background: var(--bg-card); border: 1px solid var(--border); border-radius: 8px; padding: 18px 20px; display: none; }
+.detail-panel.visible { display: block; }
+.detail-key { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-bottom: 4px; }
+.detail-title { font-size: 15px; font-weight: 700; color: var(--text); margin-bottom: 8px; line-height: 1.3; }
+.detail-domain { font-family: var(--mono); font-size: 10px; color: var(--text-soft); margin-bottom: 12px; }
+.detail-section { margin-bottom: 10px; }
+.detail-label { font-family: var(--mono); font-size: 9px; letter-spacing: 0.12em; text-transform: uppercase; color: var(--text-soft); margin-bottom: 4px; }
+.detail-links { display: flex; flex-direction: column; gap: 3px; }
+.detail-link { font-family: var(--mono); font-size: 11px; color: var(--accent); opacity: 0.7; cursor: pointer; }
+.detail-link:hover { opacity: 1; }
+.detail-close { position: absolute; top: 10px; right: 12px; font-size: 16px; color: var(--text-soft); cursor: pointer; }
+.detail-close:hover { color: var(--text); }
+.detail-count { font-family: var(--mono); font-size: 11px; color: var(--text-soft); }
+.empty-overlay { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center; flex-direction: column; gap: 12px; color: var(--text-soft); pointer-events: none; }
+.empty-title { font-size: 18px; color: var(--text-mid); font-weight: 700; }
+</style>
+</head>
+<body>
+<div class="topbar">
+  <span class="topbar-brand">lac·depmap</span>
+  <span class="topbar-sep">/</span>
+  <span class="topbar-title">${esc(projectName)}</span>
+  <div class="topbar-stats">
+    <span class="topbar-stat"><strong>${nodes.length}</strong> features</span>
+    <span class="topbar-stat"><strong>${edges.length}</strong> dependencies</span>
+    ${highCouplingCount > 0 ? `<span class="topbar-stat" style="color:#cc5b5b"><strong>${highCouplingCount}</strong> high-coupling</span>` : ""}
+    ${isolatedCount > 0 ? `<span class="topbar-stat"><strong>${isolatedCount}</strong> isolated</span>` : ""}
+  </div>
+</div>
+<div class="main">
+  <canvas id="canvas"></canvas>
+  <div class="legend">
+    <div class="legend-title">Legend</div>
+    <div class="legend-items">
+      <div class="legend-item"><div class="legend-line" style="background:#5b82cc;height:1.5px"></div> depends on</div>
+      <div class="legend-item"><div class="legend-line" style="background:#cc5b5b;height:2px"></div> cycle risk</div>
+      <div class="legend-item"><span style="font-family:var(--mono);font-size:11px;color:var(--text-soft)">size = dependents</span></div>
+      ${domains.map((d) => `<div class="legend-item"><div class="legend-dot" style="background:${domainColor[d] ?? "#736455"}"></div>${esc(d.replace(/-/g, " "))}</div>`).join("")}
+    </div>
+  </div>
+  <div class="detail-panel" id="detail">
+    <span class="detail-close" onclick="closeDetail()">×</span>
+    <div class="detail-key" id="detail-key"></div>
+    <div class="detail-title" id="detail-title"></div>
+    <div class="detail-domain" id="detail-domain"></div>
+    <div class="detail-section" id="detail-deps-section">
+      <div class="detail-label">Depends on</div>
+      <div class="detail-links" id="detail-deps"></div>
+    </div>
+    <div class="detail-section" id="detail-dependents-section">
+      <div class="detail-label">Depended on by</div>
+      <div class="detail-links" id="detail-dependents"></div>
+    </div>
+    <div class="detail-count" id="detail-isolated"></div>
+  </div>
+  ${edges.length === 0 ? `<div class="empty-overlay"><div class="empty-title">No dependencies mapped</div><p>Add featureKeys to externalDependencies[] in your feature.jsons.</p></div>` : ""}
+</div>
+<script>
+const GRAPH = ${graphData};
+const canvas = document.getElementById('canvas');
+const ctx = canvas.getContext('2d');
+let W, H, dpr, nodes, edges;
+let pan = { x: 0, y: 0 }, zoom = 1, dragging = false, lastMouse = null, hoveredKey = null, selectedKey = null;
+
+function resize() {
+  dpr = window.devicePixelRatio || 1;
+  W = canvas.clientWidth; H = canvas.clientHeight;
+  canvas.width = W * dpr; canvas.height = H * dpr;
+  ctx.scale(dpr, dpr);
+}
+
+function initNodes() {
+  nodes = GRAPH.nodes.map((n, i) => {
+    const angle = (i / GRAPH.nodes.length) * 2 * Math.PI;
+    const r = Math.min(W, H) * 0.3;
+    return { ...n, x: W/2 + r * Math.cos(angle), y: H/2 + r * Math.sin(angle), vx: 0, vy: 0 };
+  });
+  edges = GRAPH.edges;
+}
+
+const nodeByKey = () => new Map(nodes.map(n => [n.key, n]));
+
+function tick() {
+  const map = nodeByKey();
+  // Repulsion
+  for (let i = 0; i < nodes.length; i++) {
+    for (let j = i + 1; j < nodes.length; j++) {
+      const a = nodes[i], b = nodes[j];
+      const dx = b.x - a.x, dy = b.y - a.y;
+      const dist = Math.sqrt(dx*dx + dy*dy) || 1;
+      const force = 8000 / (dist * dist);
+      const fx = (dx / dist) * force, fy = (dy / dist) * force;
+      a.vx -= fx; a.vy -= fy; b.vx += fx; b.vy += fy;
+    }
+  }
+  // Spring edges
+  for (const e of edges) {
+    const a = map.get(e.from), b = map.get(e.to);
+    if (!a || !b) continue;
+    const dx = b.x - a.x, dy = b.y - a.y;
+    const dist = Math.sqrt(dx*dx + dy*dy) || 1;
+    const target = 120;
+    const force = (dist - target) * 0.04;
+    const fx = (dx / dist) * force, fy = (dy / dist) * force;
+    a.vx += fx; a.vy += fy; b.vx -= fx; b.vy -= fy;
+  }
+  // Gravity to center
+  for (const n of nodes) {
+    n.vx += (W/2 - n.x) * 0.003;
+    n.vy += (H/2 - n.y) * 0.003;
+  }
+  // Apply + dampen
+  for (const n of nodes) {
+    n.x += n.vx * 0.4; n.y += n.vy * 0.4;
+    n.vx *= 0.7; n.vy *= 0.7;
+  }
+}
+
+function draw() {
+  ctx.clearRect(0, 0, W, H);
+  ctx.save();
+  ctx.translate(pan.x, pan.y);
+  ctx.scale(zoom, zoom);
+  const map = nodeByKey();
+  // Edges
+  for (const e of edges) {
+    const a = map.get(e.from), b = map.get(e.to);
+    if (!a || !b) continue;
+    const isHighlighted = selectedKey && (e.from === selectedKey || e.to === selectedKey);
+    ctx.globalAlpha = isHighlighted ? 1 : (selectedKey ? 0.15 : 0.5);
+    ctx.strokeStyle = e.isCycle ? '#cc5b5b' : '#5b82cc';
+    ctx.lineWidth = isHighlighted ? 2 : 1;
+    ctx.beginPath();
+    ctx.moveTo(a.x, a.y);
+    // Arrow to B
+    const dx = b.x - a.x, dy = b.y - a.y;
+    const dist = Math.sqrt(dx*dx + dy*dy);
+    const bR = nodeRadius(b);
+    const ex = b.x - (dx/dist) * bR;
+    const ey = b.y - (dy/dist) * bR;
+    ctx.lineTo(ex, ey);
+    ctx.stroke();
+    // Arrowhead
+    const angle = Math.atan2(dy, dx);
+    ctx.fillStyle = e.isCycle ? '#cc5b5b' : '#5b82cc';
+    ctx.beginPath();
+    ctx.moveTo(ex, ey);
+    ctx.lineTo(ex - 8*Math.cos(angle-0.4), ey - 8*Math.sin(angle-0.4));
+    ctx.lineTo(ex - 8*Math.cos(angle+0.4), ey - 8*Math.sin(angle+0.4));
+    ctx.closePath();
+    ctx.fill();
+  }
+  // Nodes
+  for (const n of nodes) {
+    const r = nodeRadius(n);
+    const isHovered = n.key === hoveredKey;
+    const isSelected = n.key === selectedKey;
+    ctx.globalAlpha = selectedKey && !isSelected ? 0.3 : 1;
+    ctx.beginPath();
+    ctx.arc(n.x, n.y, r, 0, Math.PI * 2);
+    ctx.fillStyle = n.color;
+    ctx.globalAlpha *= isHovered ? 1 : 0.85;
+    ctx.fill();
+    if (isSelected || isHovered) {
+      ctx.strokeStyle = '#ece3d8';
+      ctx.lineWidth = 2;
+      ctx.stroke();
+    }
+    ctx.globalAlpha = selectedKey && !isSelected ? 0.3 : 1;
+    ctx.fillStyle = '#ece3d8';
+    ctx.font = \`\${Math.max(9, Math.min(12, r * 0.7))}px monospace\`;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    const label = n.title.length > 16 ? n.title.slice(0, 14) + '…' : n.title;
+    ctx.fillText(label, n.x, n.y);
+  }
+  ctx.restore();
+}
+
+function nodeRadius(n) {
+  return Math.max(18, 18 + (n.dependentCount ?? 0) * 4);
+}
+
+function hitTest(mx, my) {
+  const wx = (mx - pan.x) / zoom, wy = (my - pan.y) / zoom;
+  for (const n of [...nodes].reverse()) {
+    const r = nodeRadius(n);
+    if ((wx-n.x)**2 + (wy-n.y)**2 < r*r) return n;
+  }
+  return null;
+}
+
+function showDetail(n) {
+  const map = nodeByKey();
+  selectedKey = n.key;
+  document.getElementById('detail-key').textContent = n.key;
+  document.getElementById('detail-title').textContent = n.title;
+  document.getElementById('detail-domain').textContent = n.domain;
+  const depsEl = document.getElementById('detail-deps');
+  const depsSection = document.getElementById('detail-deps-section');
+  depsEl.innerHTML = (n.depCount > 0) ? GRAPH.nodes.filter(x => {
+    const node = nodes.find(nd => nd.key === n.key);
+    return node && GRAPH.edges.some(e => e.from === n.key && e.to === x.key);
+  }).map(x => \`<span class="detail-link" onclick="showDetail(nodes.find(nd=>nd.key==='\${x.key}'))">\${x.title}</span>\`).join('') : '';
+  depsSection.style.display = n.depCount > 0 ? '' : 'none';
+  const depEl = document.getElementById('detail-dependents');
+  const depSection = document.getElementById('detail-dependents-section');
+  depEl.innerHTML = (n.dependentCount > 0) ? GRAPH.nodes.filter(x => {
+    return GRAPH.edges.some(e => e.from === x.key && e.to === n.key);
+  }).map(x => \`<span class="detail-link" onclick="showDetail(nodes.find(nd=>nd.key==='\${x.key}'))">\${x.title}</span>\`).join('') : '';
+  depSection.style.display = n.dependentCount > 0 ? '' : 'none';
+  const isolatedEl = document.getElementById('detail-isolated');
+  isolatedEl.textContent = (n.depCount === 0 && n.dependentCount === 0) ? 'Isolated — no runtime dependencies' : '';
+  document.getElementById('detail').classList.add('visible');
+}
+
+function closeDetail() {
+  selectedKey = null;
+  document.getElementById('detail').classList.remove('visible');
+}
+
+window.addEventListener('resize', () => { resize(); });
+canvas.addEventListener('mousedown', e => { dragging = true; lastMouse = { x: e.clientX, y: e.clientY }; });
+canvas.addEventListener('mouseup', e => {
+  if (dragging && lastMouse && Math.abs(e.clientX - lastMouse.x) < 3 && Math.abs(e.clientY - lastMouse.y) < 3) {
+    const hit = hitTest(e.clientX - canvas.getBoundingClientRect().left, e.clientY - canvas.getBoundingClientRect().top);
+    if (hit) showDetail(hit); else closeDetail();
+  }
+  dragging = false; lastMouse = null;
+});
+canvas.addEventListener('mousemove', e => {
+  const rect = canvas.getBoundingClientRect();
+  if (dragging && lastMouse) {
+    pan.x += e.clientX - lastMouse.x; pan.y += e.clientY - lastMouse.y;
+    lastMouse = { x: e.clientX, y: e.clientY };
+  }
+  const hit = hitTest(e.clientX - rect.left, e.clientY - rect.top);
+  hoveredKey = hit ? hit.key : null;
+  canvas.style.cursor = hit ? 'pointer' : (dragging ? 'grabbing' : 'grab');
+});
+canvas.addEventListener('wheel', e => {
+  e.preventDefault();
+  const f = e.deltaY < 0 ? 1.1 : 0.9;
+  const rect = canvas.getBoundingClientRect();
+  const mx = e.clientX - rect.left, my = e.clientY - rect.top;
+  pan.x = mx - (mx - pan.x) * f;
+  pan.y = my - (my - pan.y) * f;
+  zoom *= f;
+}, { passive: false });
+
+resize();
+initNodes();
+let frame = 0;
+function loop() {
+  if (frame < 200) tick();
+  frame++;
+  draw();
+  requestAnimationFrame(loop);
+}
+loop();
+<\/script>
+</body>
+</html>`;
+}
+//#endregion
+//#region src/lib/hubGenerator.ts
+/** Canonical ordered entry definitions for all standard LAC outputs. */
+const ALL_HUB_ENTRIES = [
+	{
+		file: "lac-guide.html",
+		label: "User Guide",
+		description: "How to use every user-facing feature — generated from userGuide fields",
+		icon: "📖",
+		primary: true
+	},
+	{
+		file: "lac-story.html",
+		label: "Product Story",
+		description: "Long-form narrative case study built from feature data",
+		icon: "📰",
+		primary: true
+	},
+	{
+		file: "lac-release-notes.html",
+		label: "Release Notes",
+		description: "User-facing release notes — features that shipped recently",
+		icon: "🚀",
+		primary: true
+	},
+	{
+		file: "lac-sprint.html",
+		label: "Sprint Board",
+		description: "Active + draft features sorted by priority — sprint planning at a glance",
+		icon: "⚡",
+		primary: false
+	},
+	{
+		file: "lac-wiki.html",
+		label: "Feature Wiki",
+		description: "Complete searchable wiki — all fields, all features, sidebar navigation",
+		icon: "🗂️",
+		primary: false
+	},
+	{
+		file: "lac-kanban.html",
+		label: "Kanban Board",
+		description: "Active / Frozen / Draft columns with sortable, filterable cards",
+		icon: "📋",
+		primary: false
+	},
+	{
+		file: "lac-changelog.html",
+		label: "Changelog",
+		description: "Feature revision history grouped by month — all changes across the workspace",
+		icon: "📅",
+		primary: false
+	},
+	{
+		file: "lac-decisions.html",
+		label: "Decision Log",
+		description: "All architectural decisions consolidated and searchable by domain",
+		icon: "⚖️",
+		primary: false
+	},
+	{
+		file: "lac-api-surface.html",
+		label: "API Surface",
+		description: "Aggregated public interface reference — all exported components, hooks, and types",
+		icon: "🔌",
+		primary: false
+	},
+	{
+		file: "lac-depmap.html",
+		label: "Dependency Map",
+		description: "Runtime cross-feature dependency graph from externalDependencies[]",
+		icon: "🕸️",
+		primary: false
+	},
+	{
+		file: "lac-health.html",
+		label: "Health Scorecard",
+		description: "Completeness, coverage, tech-debt score, and field fill rates",
+		icon: "🏥",
+		primary: false
+	},
+	{
+		file: "lac-heatmap.html",
+		label: "Completeness Heatmap",
+		description: "Field x feature completeness grid — quickly spot gaps",
+		icon: "🔥",
+		primary: false
+	},
+	{
+		file: "lac-graph.html",
+		label: "Lineage Graph",
+		description: "Interactive force-directed feature lineage graph",
+		icon: "🌐",
+		primary: false
+	},
+	{
+		file: "lac-print.html",
+		label: "Print",
+		description: "Print-ready A4 document — all features in clean two-column layout",
+		icon: "🖨️",
+		primary: false
+	},
+	{
+		file: "lac-raw.html",
+		label: "Raw Dump",
+		description: "Field-by-field dump of every feature.json with sidebar navigation",
+		icon: "🔩",
+		primary: false
+	}
+];
+function generateHub(projectName, stats, entries, generatedAt = (/* @__PURE__ */ new Date()).toISOString(), prefix) {
+	function esc(s) {
+		return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+	}
+	const urlPrefix = prefix ? "/" + (/[A-Za-z]:[/\\]/.test(prefix) ? prefix.split(/[/\\]/).filter(Boolean).pop() ?? "" : prefix.replace(/^\/+/, "").replace(/\/+$/, "")) : "";
+	function href(file) {
+		return urlPrefix ? `${urlPrefix}/${file}` : `./${file}`;
+	}
+	const primaryEntries = entries.filter((e) => e.primary);
+	const secondaryEntries = entries.filter((e) => !e.primary);
+	const date = new Date(generatedAt).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	});
+	function primaryCard(e) {
+		return `
+    <a href="${esc(href(e.file))}" class="primary-card">
+      <div class="primary-card-icon">${e.icon}</div>
+      <div class="primary-card-body">
+        <div class="primary-card-label">${esc(e.label)}</div>
+        <div class="primary-card-desc">${esc(e.description)}</div>
+      </div>
+      <div class="primary-card-arrow">→</div>
+    </a>`;
+	}
+	function secondaryCard(e) {
+		return `
+    <a href="${esc(href(e.file))}" class="secondary-card">
+      <div class="secondary-card-icon">${e.icon}</div>
+      <div class="secondary-card-label">${esc(e.label)}</div>
+      <div class="secondary-card-desc">${esc(e.description)}</div>
+    </a>`;
+	}
+	const domainList = stats.domains.length > 0 ? stats.domains.slice(0, 6).map((d) => `<span class="domain-tag">${esc(d)}</span>`).join("") + (stats.domains.length > 6 ? `<span class="domain-tag">+${stats.domains.length - 6}</span>` : "") : "";
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${esc(projectName)} — Life-as-Code Hub</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg:        #0f0d0b;
+  --bg-card:   #181512;
+  --bg-hover:  #1e1a16;
+  --border:    #262018;
+  --text:      #ece3d8;
+  --text-mid:  #b0a494;
+  --text-soft: #736455;
+  --accent:    #c4a255;
+  --accent-w:  #e8b865;
+  --mono: 'Cascadia Code','Fira Code','JetBrains Mono','Consolas',monospace;
+  --sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
+  --frozen:  #5b82cc; --active: #4aad72; --draft: #c4a255; --deprecated: #cc5b5b;
+}
+html { scroll-behavior: smooth; }
+body { background: var(--bg); color: var(--text); font-family: var(--sans); font-size: 14px; line-height: 1.6; min-height: 100vh; }
+
+/* ── Topbar ── */
+.topbar { height: 46px; display: flex; align-items: center; gap: 14px; padding: 0 28px; background: #0b0a08; border-bottom: 1px solid var(--border); position: sticky; top: 0; z-index: 10; }
+.topbar-brand { font-family: var(--mono); font-size: 13px; color: var(--accent); letter-spacing: 0.05em; }
+.topbar-sep   { color: var(--border); font-size: 18px; line-height: 1; }
+.topbar-title { font-size: 13px; color: var(--text-mid); }
+.topbar-date  { margin-left: auto; font-family: var(--mono); font-size: 10px; color: var(--text-soft); }
+
+/* ── Layout ── */
+.page { max-width: 880px; margin: 0 auto; padding: 56px 28px 100px; }
+
+/* ── Hero ── */
+.hero { margin-bottom: 48px; }
+.hero-eyebrow { font-family: var(--mono); font-size: 9px; letter-spacing: 0.22em; text-transform: uppercase; color: var(--accent); margin-bottom: 12px; }
+.hero-title   { font-size: 40px; font-weight: 800; color: var(--text); letter-spacing: -0.025em; line-height: 1.1; margin-bottom: 10px; }
+.hero-sub     { font-size: 15px; color: var(--text-mid); max-width: 520px; line-height: 1.7; margin-bottom: 28px; }
+
+/* ── Stats row ── */
+.stats-row { display: flex; flex-wrap: wrap; gap: 1px; background: var(--border); border: 1px solid var(--border); border-radius: 10px; overflow: hidden; margin-bottom: 8px; }
 .stat { flex: 1; min-width: 90px; padding: 14px 20px; background: var(--bg-card); }
 .stat-num   { font-family: var(--mono); font-size: 22px; font-weight: 700; line-height: 1; }
 .stat-lbl   { font-size: 11px; color: var(--text-soft); margin-top: 3px; }
@@ -21725,6 +23230,16 @@ function lacGo(file){location.href=location.href.replace(/[^\\/]*$/,'')+file}
 }
 //#endregion
 //#region src/lib/views.ts
+/** Fields always shown at summary density regardless of view */
+const SUMMARY_FIELDS = new Set([
+	"featureKey",
+	"title",
+	"status",
+	"domain",
+	"priority",
+	"tags",
+	"problem"
+]);
 const VIEW_NAMES = [
 	"dev",
 	"product",
@@ -21776,10 +23291,13 @@ const VIEWS = {
 			"problem",
 			"analysis",
 			"userGuide",
+			"pmSummary",
 			"successCriteria",
+			"acceptanceCriteria",
 			"decisions",
 			"knownLimitations",
-			"tags"
+			"tags",
+			"releaseVersion"
 		])
 	},
 	dev: {
@@ -21793,8 +23311,11 @@ const VIEWS = {
 			"problem",
 			"analysis",
 			"implementation",
+			"implementationNotes",
 			"userGuide",
 			"successCriteria",
+			"acceptanceCriteria",
+			"testStrategy",
 			"decisions",
 			"knownLimitations",
 			"tags",
@@ -21819,8 +23340,12 @@ const VIEWS = {
 			"problem",
 			"analysis",
 			"implementation",
+			"implementationNotes",
 			"userGuide",
+			"pmSummary",
 			"successCriteria",
+			"acceptanceCriteria",
+			"testStrategy",
 			"decisions",
 			"knownLimitations",
 			"tags",
@@ -21834,6 +23359,7 @@ const VIEWS = {
 			"externalDependencies",
 			"codeSnippets",
 			"lastVerifiedDate",
+			"releaseVersion",
 			"superseded_by",
 			"superseded_from",
 			"merged_into",
@@ -21871,6 +23397,74 @@ function applyViewForHtml(feature, view) {
 	for (const key of Object.keys(feature)) if (view.fields.has(key) || HTML_NAV_FIELDS.has(key)) result[key] = feature[key];
 	return result;
 }
+/**
+* Apply density filtering to a feature.
+* - summary:  only SUMMARY_FIELDS (title, status, domain, priority, tags, problem snippet)
+* - standard: pass through unchanged (generators decide what to show)
+* - verbose:  pass through unchanged but callers should render VERBOSE_EXTRA_FIELDS too
+*
+* Returns the filtered feature and the resolved density level.
+*/
+function applyDensity(feature, density) {
+	if (density === "standard" || density === "verbose") return feature;
+	const result = {};
+	for (const key of Object.keys(feature)) if (SUMMARY_FIELDS.has(key)) if (key === "problem" && typeof feature[key] === "string") {
+		const prob = feature[key];
+		const firstSentence = prob.split(/[.!?]\s/)[0] ?? prob;
+		result[key] = firstSentence.length < prob.length ? firstSentence + "." : prob;
+	} else result[key] = feature[key];
+	return result;
+}
+/**
+* Resolve a view name against both built-in views and custom views from lac.config.json.
+*
+* Resolution order:
+*  1. If `name` matches a key in `customViews` (from lac.config.json), build a ViewConfig from it.
+*     If it has `extends`, merge on top of the built-in base.
+*  2. Otherwise fall back to VIEWS[name].
+*  3. If neither matches, return undefined.
+*/
+function resolveView(name, customViews = {}) {
+	const custom = customViews[name];
+	if (custom) {
+		const base = custom.extends ? VIEWS[custom.extends] : void 0;
+		const baseFields = base ? new Set(base.fields) : /* @__PURE__ */ new Set();
+		const fields = custom.fields ? new Set(custom.fields) : baseFields;
+		for (const f of IDENTITY) fields.add(f);
+		return {
+			name,
+			label: custom.label ?? base?.label ?? name,
+			description: custom.description ?? base?.description ?? `Custom view: ${name}`,
+			fields,
+			density: custom.density,
+			groupBy: custom.groupBy,
+			sortBy: custom.sortBy,
+			filterStatus: custom.filterStatus,
+			sections: custom.sections
+		};
+	}
+	return VIEW_NAMES.includes(name) ? VIEWS[name] : void 0;
+}
+/**
+* Sort and filter a feature list according to a resolved view profile.
+* This is called before passing features to any generator.
+*/
+function applyViewTransforms(features, profile) {
+	let result = [...features];
+	if (profile.filterStatus && profile.filterStatus.length > 0) result = result.filter((f) => profile.filterStatus.includes(f["status"]));
+	if (profile.sortBy === "priority") result.sort((a, b) => (a["priority"] ?? 99) - (b["priority"] ?? 99));
+	else if (profile.sortBy === "title") result.sort((a, b) => String(a["title"] ?? "").localeCompare(String(b["title"] ?? "")));
+	else if (profile.sortBy === "status") {
+		const order = {
+			active: 0,
+			draft: 1,
+			frozen: 2,
+			deprecated: 3
+		};
+		result.sort((a, b) => (order[a["status"]] ?? 9) - (order[b["status"]] ?? 9));
+	} else if (profile.sortBy === "lastVerifiedDate") result.sort((a, b) => String(b["lastVerifiedDate"] ?? "").localeCompare(String(a["lastVerifiedDate"] ?? "")));
+	return result;
+}
 //#endregion
 //#region src/commands/export.ts
 /**
@@ -22085,7 +23679,7 @@ function buildReconstructionPrompt(features, projectName, promptDir) {
 	lines.push("");
 	return lines.join("\n");
 }
-const exportCommand = new Command("export").description("Export feature.json as JSON, Markdown, or generate a static HTML view").option("--out <path>", "Output file or directory path").option("--html [dir]", "Scan <dir> (default: cwd) and emit a single self-contained HTML wiki").option("--raw [dir]", "Raw field-by-field HTML dump with sidebar navigation").option("--print [dir]", "Print-ready HTML document (A4, all features, @media print CSS)").option("--postcard", "Beautiful single-feature shareable card (nearest feature.json)").option("--resume [dir]", "Portfolio page from all frozen features").option("--slide [dir]", "Full-screen HTML slideshow, one slide per feature").option("--graph [dir]", "Interactive force-directed feature lineage graph").option("--heatmap [dir]", "Completeness heatmap — fields × features grid").option("--quiz [dir]", "Flashcard-style quiz to test knowledge of your feature set").option("--story [dir]", "Long-form narrative document — product case study from feature data").option("--treemap [dir]", "Rectangular treemap — features sized by decisions × completeness, grouped by domain").option("--kanban [dir]", "Kanban board — Active / Frozen / Draft columns with sortable, filterable cards").option("--health [dir]", "Project health scorecard — completeness, coverage, tech debt, and health score").option("--embed [dir]", "Compact embeddable stats widget (iframe-ready)").option("--decisions [dir]", "Consolidated ADR — all decisions from all features, searchable by domain").option("--guide [dir]", "User guide — one page per feature that has a non-empty userGuide field").option("--hub [dir]", "Hub landing page linking to all generated views → lac-hub.html").option("--all [dir]", "Generate all HTML views + hub index.html → --out dir (default: ./lac-output)").option("--prefix <prefix>", "URL prefix for hub links (no leading slash), e.g. lac → hrefs become /lac/lac-guide.html").option("--diff <dir-b>", "Compare cwd workspace against <dir-b> and show added/removed/changed").option("--site <dir>", "Generate a multi-page static site → --out dir (default: ./lac-site)").option("--prompt [dir]", "AI reconstruction prompt for all features (stdout or --out file)").option("--markdown", "Single feature as Markdown (nearest feature.json)").option("--tags <tags>", "Comma-separated tags to filter by (OR logic) — applies to all multi-feature modes").option("--sort <mode>", "Sort order for multi-feature modes: key (default) | build-order (parents before children)").option("--view <name>", `Audience view — filters and shapes exported fields. One of: ${VIEW_NAMES.join(", ")}`).addHelpText("after", `
+const exportCommand = new Command("export").description("Export feature.json as JSON, Markdown, or generate a static HTML view").option("--out <path>", "Output file or directory path").option("--html [dir]", "Scan <dir> (default: cwd) and emit a single self-contained HTML wiki").option("--raw [dir]", "Raw field-by-field HTML dump with sidebar navigation").option("--print [dir]", "Print-ready HTML document (A4, all features, @media print CSS)").option("--postcard", "Beautiful single-feature shareable card (nearest feature.json)").option("--resume [dir]", "Portfolio page from all frozen features").option("--slide [dir]", "Full-screen HTML slideshow, one slide per feature").option("--graph [dir]", "Interactive force-directed feature lineage graph").option("--heatmap [dir]", "Completeness heatmap — fields × features grid").option("--quiz [dir]", "Flashcard-style quiz to test knowledge of your feature set").option("--story [dir]", "Long-form narrative document — product case study from feature data").option("--treemap [dir]", "Rectangular treemap — features sized by decisions × completeness, grouped by domain").option("--kanban [dir]", "Kanban board — Active / Frozen / Draft columns with sortable, filterable cards").option("--health [dir]", "Project health scorecard — completeness, coverage, tech debt, and health score").option("--embed [dir]", "Compact embeddable stats widget (iframe-ready)").option("--decisions [dir]", "Consolidated ADR — all decisions from all features, searchable by domain").option("--guide [dir]", "User guide — one page per feature that has a non-empty userGuide field").option("--hub [dir]", "Hub landing page linking to all generated views → lac-hub.html").option("--all [dir]", "Generate all HTML views + hub index.html → --out dir (default: ./lac-output)").option("--prefix <prefix>", "URL prefix for hub links (no leading slash), e.g. lac → hrefs become /lac/lac-guide.html").option("--diff <dir-b>", "Compare cwd workspace against <dir-b> and show added/removed/changed").option("--site <dir>", "Generate a multi-page static site → --out dir (default: ./lac-site)").option("--prompt [dir]", "AI reconstruction prompt for all features (stdout or --out file)").option("--markdown", "Single feature as Markdown (nearest feature.json)").option("--changelog [dir]", "Structured changelog grouped by month — from revisions[] across all features").option("--since <date>", "Filter --changelog and --release-notes to entries after this date (YYYY-MM-DD)").option("--release-notes [dir]", "User-facing release notes — features that went frozen since --since date or --release version").option("--release <version>", "Filter --release-notes to features matching this releaseVersion (e.g. 3.5.0)").option("--sprint [dir]", "Sprint planning view — draft+active features sorted by priority, summary density").option("--api-surface [dir]", "Aggregated publicInterface[] reference across all features → lac-api-surface.html").option("--dependency-map [dir]", "Runtime dependency graph from externalDependencies[] → lac-depmap.html").option("--tags <tags>", "Comma-separated tags to filter by (OR logic) — applies to all multi-feature modes").option("--sort <mode>", "Sort order for multi-feature modes: key (default) | build-order (parents before children)").option("--view <name>", `Audience view — built-in (${VIEW_NAMES.join(", ")}) or custom name from lac.config.json views`).option("--density <level>", "Content density: summary | standard | verbose (default: standard)").addHelpText("after", `
 Examples:
   lac export --html                          HTML wiki (cwd) → lac-wiki.html
   lac export --raw                           Raw field dump  → lac-raw.html
@@ -22121,11 +23715,16 @@ Views (--view):
   product  Business problem, success criteria, and strategic decisions (no code)
   dev      Full implementation context — code, decisions, snippets, and lineage
   tech     Complete technical record — all fields including history and revisions`).action(async (options) => {
-	let activeView = options.view ? VIEWS[options.view] : void 0;
+	const config = loadConfig(process$1.cwd());
+	let activeView = options.view ? resolveView(options.view, config.views) : void 0;
+	const activeViewRenderMode = options.view && config.views[options.view] ? config.views[options.view].extends : void 0;
 	if (options.view && !activeView) {
-		process$1.stderr.write(`Error: unknown view "${options.view}". Valid views: ${VIEW_NAMES.join(", ")}\n`);
+		const customNames = Object.keys(config.views);
+		const allNames = [...VIEW_NAMES, ...customNames];
+		process$1.stderr.write(`Error: unknown view "${options.view}". Available: ${allNames.join(", ")}\n`);
 		process$1.exit(1);
 	}
+	const activeDensity = options.density === "summary" || options.density === "verbose" ? options.density : activeView && "density" in activeView && activeView.density ? activeView.density : "standard";
 	if (options.sort && options.sort !== "key" && options.sort !== "build-order") {
 		process$1.stderr.write(`Error: unknown sort mode "${options.sort}". Valid modes: key, build-order\n`);
 		process$1.exit(1);
@@ -22183,7 +23782,8 @@ Views (--view):
 			process$1.exit(0);
 		}
 		const projectName = basename(htmlDir);
-		const html = generateHtmlWiki(activeView ? features.map((f) => applyViewForHtml(f.feature, activeView)) : features.map((f) => f.feature), projectName, activeView?.label, activeView?.name);
+		const densityFeatures = withDensity(features);
+		const html = generateHtmlWiki(activeView ? densityFeatures.map((f) => applyViewForHtml(f.feature, activeView)) : densityFeatures.map((f) => f.feature), projectName, activeView?.label, activeView?.name, activeViewRenderMode);
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-wiki.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22215,7 +23815,8 @@ Views (--view):
 			process$1.exit(0);
 		}
 		const projectName = basename(rawDir);
-		const html = generateRawHtml(activeView ? features.map((f) => applyViewForHtml(f.feature, activeView)) : features.map((f) => f.feature), projectName, activeView?.label, activeView?.name);
+		const densityRaw = withDensity(features);
+		const html = generateRawHtml(activeView ? densityRaw.map((f) => applyViewForHtml(f.feature, activeView)) : densityRaw.map((f) => f.feature), projectName, activeView?.label, activeView?.name);
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-raw.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22276,7 +23877,23 @@ Views (--view):
 			const tagsToMatch = options.tags.split(",").map((t) => t.trim()).filter(Boolean);
 			features = features.filter(({ feature }) => tagsToMatch.some((tag) => feature.tags?.includes(tag)));
 		}
-		return applySort(features);
+		if (activeView && ("filterStatus" in activeView || "sortBy" in activeView)) {
+			const transformed = applyViewTransforms(features.map((f) => f.feature), {
+				filterStatus: activeView.filterStatus,
+				sortBy: activeView.sortBy
+			});
+			const transformedKeys = new Set(transformed.map((f) => f["featureKey"]));
+			features = features.filter((f) => transformedKeys.has(f.feature.featureKey));
+		}
+		features = applySort(features);
+		return features;
+	}
+	function withDensity(featureList) {
+		if (activeDensity === "standard") return featureList;
+		return featureList.map((f) => ({
+			...f,
+			feature: applyDensity(f.feature, activeDensity)
+		}));
 	}
 	if (options.print !== void 0) {
 		const dir = typeof options.print === "string" ? resolve(options.print) : resolve(process$1.cwd());
@@ -22285,7 +23902,8 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const html = generatePrint(activeView ? features.map((f) => applyViewForHtml(f.feature, activeView)) : features.map((f) => f.feature), basename(dir), activeView?.label);
+		const dPrint = withDensity(features);
+		const html = generatePrint(activeView ? dPrint.map((f) => applyViewForHtml(f.feature, activeView)) : dPrint.map((f) => f.feature), basename(dir), activeView?.label);
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-print.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22303,7 +23921,7 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const html = generateResume(features.map((f) => f.feature), basename(dir));
+		const html = generateResume(withDensity(features).map((f) => f.feature), basename(dir));
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-resume.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22321,7 +23939,8 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const html = generateSlides(activeView ? features.map((f) => applyViewForHtml(f.feature, activeView)) : features.map((f) => f.feature), basename(dir), activeView?.label);
+		const dSlide = withDensity(features);
+		const html = generateSlides(activeView ? dSlide.map((f) => applyViewForHtml(f.feature, activeView)) : dSlide.map((f) => f.feature), basename(dir), activeView?.label);
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-slides.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22357,7 +23976,7 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const html = generateStory(features.map((f) => f.feature), basename(dir));
+		const html = generateStory(withDensity(features).map((f) => f.feature), basename(dir));
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-story.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22393,7 +24012,7 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const html = generateKanban(features.map((f) => f.feature), basename(dir));
+		const html = generateKanban(withDensity(features).map((f) => f.feature), basename(dir));
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-kanban.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22447,7 +24066,7 @@ Views (--view):
 			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
 			process$1.exit(0);
 		}
-		const fs = features.map((f) => f.feature);
+		const fs = withDensity(features).map((f) => f.feature);
 		const totalDecisions = fs.reduce((n, f) => n + (f.decisions?.length ?? 0), 0);
 		const html = generateDecisionLog(fs, basename(dir));
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-decisions.html");
@@ -22507,6 +24126,104 @@ Views (--view):
 		}
 		return;
 	}
+	if (options.changelog !== void 0) {
+		const dir = typeof options.changelog === "string" ? resolve(options.changelog) : resolve(process$1.cwd());
+		const features = await scanAndFilter(dir);
+		if (features.length === 0) {
+			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
+			process$1.exit(0);
+		}
+		const fs = features.map((f) => f.feature);
+		const html = generateChangelog(fs, basename(dir), options.since);
+		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-changelog.html");
+		try {
+			await writeFile(outFile, html, "utf-8");
+			const totalRevisions = fs.reduce((n, f) => n + (f["revisions"]?.length ?? 0), 0);
+			process$1.stdout.write(`✓ Changelog (${totalRevisions} revisions across ${features.length} features) → ${options.out ?? "lac-changelog.html"}\n`);
+		} catch (err) {
+			process$1.stderr.write(`Error writing "${outFile}": ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
+	if (options.releaseNotes !== void 0) {
+		const dir = typeof options.releaseNotes === "string" ? resolve(options.releaseNotes) : resolve(process$1.cwd());
+		const features = await scanAndFilter(dir);
+		if (features.length === 0) {
+			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
+			process$1.exit(0);
+		}
+		const html = generateReleaseNotes(features.map((f) => f.feature), basename(dir), {
+			since: options.since,
+			release: options.release
+		});
+		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-release-notes.html");
+		try {
+			await writeFile(outFile, html, "utf-8");
+			process$1.stdout.write(`✓ Release notes → ${options.out ?? "lac-release-notes.html"}\n`);
+		} catch (err) {
+			process$1.stderr.write(`Error writing "${outFile}": ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
+	if (options.sprint !== void 0) {
+		const dir = typeof options.sprint === "string" ? resolve(options.sprint) : resolve(process$1.cwd());
+		const features = await scanAndFilter(dir);
+		if (features.length === 0) {
+			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
+			process$1.exit(0);
+		}
+		const sprintFeatures = features.filter((f) => f.feature.status === "draft" || f.feature.status === "active");
+		const html = generateSprint(sprintFeatures.map((f) => f.feature), basename(dir));
+		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-sprint.html");
+		try {
+			await writeFile(outFile, html, "utf-8");
+			process$1.stdout.write(`✓ Sprint (${sprintFeatures.length} active+draft features) → ${options.out ?? "lac-sprint.html"}\n`);
+		} catch (err) {
+			process$1.stderr.write(`Error writing "${outFile}": ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
+	if (options.apiSurface !== void 0) {
+		const dir = typeof options.apiSurface === "string" ? resolve(options.apiSurface) : resolve(process$1.cwd());
+		const features = await scanAndFilter(dir);
+		if (features.length === 0) {
+			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
+			process$1.exit(0);
+		}
+		const fs = features.map((f) => f.feature);
+		const totalEntries = fs.reduce((n, f) => n + (f["publicInterface"]?.length ?? 0), 0);
+		const html = generateApiSurface(fs, basename(dir));
+		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-api-surface.html");
+		try {
+			await writeFile(outFile, html, "utf-8");
+			process$1.stdout.write(`✓ API surface (${totalEntries} entries across ${features.length} features) → ${options.out ?? "lac-api-surface.html"}\n`);
+		} catch (err) {
+			process$1.stderr.write(`Error writing "${outFile}": ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
+	if (options.dependencyMap !== void 0) {
+		const dir = typeof options.dependencyMap === "string" ? resolve(options.dependencyMap) : resolve(process$1.cwd());
+		const features = await scanAndFilter(dir);
+		if (features.length === 0) {
+			process$1.stdout.write(`No valid feature.json files found in "${dir}".\n`);
+			process$1.exit(0);
+		}
+		const html = generateDependencyMap(features.map((f) => f.feature), basename(dir));
+		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-depmap.html");
+		try {
+			await writeFile(outFile, html, "utf-8");
+			process$1.stdout.write(`✓ Dependency map (${features.length} features) → ${options.out ?? "lac-depmap.html"}\n`);
+		} catch (err) {
+			process$1.stderr.write(`Error writing "${outFile}": ${err instanceof Error ? err.message : String(err)}\n`);
+			process$1.exit(1);
+		}
+		return;
+	}
 	if (options.all !== void 0) {
 		const dir = typeof options.all === "string" ? resolve(options.all) : resolve(process$1.cwd());
 		const outDir = resolve(options.out ?? "./lac-output");
@@ -22543,15 +24260,73 @@ Views (--view):
 		await write("lac-graph.html", generateGraph(fs, projectName));
 		await write("lac-print.html", generatePrint(fs, projectName));
 		await write("lac-raw.html", generateRawHtml(fs, projectName));
-		await write("index.html", generateHub(projectName, {
+		await write("lac-changelog.html", generateChangelog(fs, projectName));
+		await write("lac-release-notes.html", generateReleaseNotes(fs, projectName, {}));
+		await write("lac-sprint.html", generateSprint(fs.filter((f) => f.status === "draft" || f.status === "active"), projectName));
+		await write("lac-api-surface.html", generateApiSurface(fs, projectName));
+		await write("lac-depmap.html", generateDependencyMap(fs, projectName));
+		const stats = {
 			total: fs.length,
 			frozen: fs.filter((f) => f.status === "frozen").length,
 			active: fs.filter((f) => f.status === "active").length,
 			draft: fs.filter((f) => f.status === "draft").length,
 			deprecated: fs.filter((f) => f.status === "deprecated").length,
 			domains: [...new Set(fs.map((f) => f.domain).filter((d) => Boolean(d)))]
-		}, ALL_HUB_ENTRIES, (/* @__PURE__ */ new Date()).toISOString(), options.prefix));
-		process$1.stdout.write(`Done — ${features.length} features, 11 files written to ${outDir}\n`);
+		};
+		const customEntries = [];
+		const VIEW_ICON_MAP = {
+			musician: "🎵",
+			sprint: "⚡",
+			"dev-deep": "🔬",
+			"code-focus": "📦",
+			shipped: "🚀",
+			onboarding: "🎓",
+			architect: "🏛️",
+			support: "🛟",
+			user: "👤",
+			dev: "💻",
+			product: "📊",
+			tech: "🔧"
+		};
+		function pickViewIcon(name, label) {
+			if (VIEW_ICON_MAP[name]) return VIEW_ICON_MAP[name];
+			const lc = label.toLowerCase();
+			if (lc.includes("music")) return "🎵";
+			if (lc.includes("sprint") || lc.includes("active")) return "⚡";
+			if (lc.includes("dev") || lc.includes("engineer")) return "🔬";
+			if (lc.includes("code") || lc.includes("snippet")) return "📦";
+			if (lc.includes("ship") || lc.includes("release") || lc.includes("frozen")) return "🚀";
+			if (lc.includes("onboard") || lc.includes("guide") || lc.includes("new")) return "🎓";
+			if (lc.includes("architect") || lc.includes("decision")) return "🏛️";
+			if (lc.includes("support") || lc.includes("qa")) return "🛟";
+			return "📄";
+		}
+		for (const [viewName, viewDef] of Object.entries(config.views)) {
+			const resolved = resolveView(viewName, config.views);
+			if (!resolved) continue;
+			const label = viewDef.label ?? viewName;
+			const description = viewDef.description ?? `Custom view: ${viewName}`;
+			const icon = pickViewIcon(viewName, label);
+			const filename = `view-${viewName}.html`;
+			let viewFeatures = features.map((f) => f.feature);
+			viewFeatures = applyViewTransforms(viewFeatures, {
+				filterStatus: resolved.filterStatus,
+				sortBy: resolved.sortBy
+			});
+			const viewHtmlFeatures = viewFeatures.map((f) => applyViewForHtml(f, resolved));
+			const renderMode = viewDef.extends;
+			await write(filename, generateHtmlWiki(viewHtmlFeatures, projectName, label, viewName, renderMode));
+			customEntries.push({
+				file: filename,
+				label,
+				description,
+				icon,
+				primary: false
+			});
+		}
+		await write("index.html", generateHub(projectName, stats, [...ALL_HUB_ENTRIES, ...customEntries], (/* @__PURE__ */ new Date()).toISOString(), options.prefix));
+		const totalFiles = 15 + customEntries.length + 1;
+		process$1.stdout.write(`Done — ${features.length} features, ${totalFiles} files written to ${outDir}\n`);
 		return;
 	}
 	if (options.graph !== void 0) {