@majeanson/lac 3.4.0 → 3.4.1

package/dist/index.mjs

@@ -10431,8 +10431,20 @@ body { background: var(--bg); color: var(--text); font-family: var(--sans); font
   font-family: var(--mono);
   font-size: 11px;
   color: var(--text-soft);
-  margin-bottom: 32px;
+  margin-bottom: 12px;
+}
+.guide-link {
+  display: inline-block;
+  margin-bottom: 28px;
+  font-family: var(--mono);
+  font-size: 11px;
+  color: var(--accent);
+  text-decoration: none;
+  border: 1px solid rgba(196,162,85,0.3);
+  border-radius: 4px;
+  padding: 3px 10px;
 }
+.guide-link:hover { background: rgba(196,162,85,0.08); }
 .completeness-bar {
   display: inline-block;
   width: 80px;
@@ -10891,7 +10903,8 @@ function renderFeature(key) {
     \${f.domain ? \`<span class="badge badge-domain">\${esc(f.domain)}</span>\` : ''}
   </div>\` : ''}
   <div class="feature-title">\${esc(f.title)}</div>
-  \${VIEW !== 'user' ? \`<div class="feature-completeness">\${barFill}\${pct}% complete</div>\` : ''}\`;
+  \${VIEW !== 'user' ? \`<div class="feature-completeness">\${barFill}\${pct}% complete</div>\` : ''}
+  \${f.userGuide ? \`<a class="guide-link" href="./lac-guide.html#\${esc(f.featureKey)}" target="_self">📖 View User Guide →</a>\` : ''}\`;
 
   // Problem
   html += section(VIEW === 'user' ? 'About this feature' : 'Problem', f.problem ? \`<div class="section-body">\${md(f.problem)}</div>\` : '<span class="empty">Not documented.</span>');
@@ -21234,7 +21247,7 @@ body {
 
 /* Feature pages */
 .feature-page { max-width: 760px; margin: 0 auto; padding: 48px 40px 80px; }
-.feature-page.hidden { display: none; }
+.feature-page.hidden, .home-page.hidden { display: none; }
 .feature-domain-eyebrow { font-family: var(--mono); font-size: 9px; letter-spacing: 0.18em; text-transform: uppercase; margin-bottom: 10px; }
 .feature-title { font-size: 28px; font-weight: 800; color: var(--text); letter-spacing: -0.015em; line-height: 1.2; margin-bottom: 12px; }
 .feature-meta  { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-bottom: 28px; }
@@ -21355,9 +21368,21 @@ function showPage(id) {
   const page = document.getElementById('page-' + id);
   if (page) { page.classList.remove('hidden'); document.getElementById('content').scrollTop = 0; }
   document.querySelectorAll('.nav-item').forEach(el => el.classList.toggle('active', el.dataset.id === id));
+  var hash = '#' + id;
+  if (window.location.hash !== hash) { history.replaceState(null, '', hash); }
 }
 // init
 document.querySelectorAll('.feature-page').forEach(p => p.classList.add('hidden'));
+// Hash routing: navigate to feature on load if hash is present
+(function() {
+  var hash = window.location.hash.slice(1);
+  if (hash) { showPage(hash); }
+})();
+// Hash routing: respond to browser back/forward navigation
+window.addEventListener('hashchange', function() {
+  var hash = window.location.hash.slice(1);
+  showPage(hash || 'home');
+});
 
 const gsearch  = document.getElementById('gsearch');
 const sresults = document.getElementById('sresults');
@@ -21479,10 +21504,14 @@ const ALL_HUB_ENTRIES = [
 		primary: false
 	}
 ];
-function generateHub(projectName, stats, entries, generatedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+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", {
@@ -21492,7 +21521,7 @@ function generateHub(projectName, stats, entries, generatedAt = (/* @__PURE__ */
 	});
 	function primaryCard(e) {
 		return `
-    <a href="./${esc(e.file)}" class="primary-card" target="_self">
+    <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>
@@ -21503,7 +21532,7 @@ function generateHub(projectName, stats, entries, generatedAt = (/* @__PURE__ */
 	}
 	function secondaryCard(e) {
 		return `
-    <a href="./${esc(e.file)}" class="secondary-card" target="_self">
+    <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>
@@ -21603,6 +21632,9 @@ body { background: var(--bg); color: var(--text); font-family: var(--sans); font
 .footer-sep   { font-family: var(--mono); font-size: 10px; color: var(--border); }
 .footer-note  { font-size: 11px; color: var(--text-soft); }
 </style>
+${urlPrefix ? "" : `<script>
+function lacGo(file){location.href=location.href.replace(/[^\\/]*$/,'')+file}
+<\/script>`}
 </head>
 <body>
 
@@ -22034,7 +22066,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("--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("--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", `
 Examples:
   lac export --html                          HTML wiki (cwd) → lac-wiki.html
   lac export --raw                           Raw field dump  → lac-raw.html
@@ -22445,7 +22477,7 @@ Views (--view):
 			deprecated: fs.filter((f) => f.status === "deprecated").length,
 			domains: [...new Set(fs.map((f) => f.domain).filter((d) => Boolean(d)))]
 		};
-		const html = generateHub(basename(dir), stats, ALL_HUB_ENTRIES);
+		const html = generateHub(basename(dir), stats, ALL_HUB_ENTRIES, (/* @__PURE__ */ new Date()).toISOString(), options.prefix);
 		const outFile = options.out ? resolve(options.out) : resolve(process$1.cwd(), "lac-hub.html");
 		try {
 			await writeFile(outFile, html, "utf-8");
@@ -22499,7 +22531,7 @@ Views (--view):
 			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));
+		}, ALL_HUB_ENTRIES, (/* @__PURE__ */ new Date()).toISOString(), options.prefix));
 		process$1.stdout.write(`Done — ${features.length} features, 11 files written to ${outDir}\n`);
 		return;
 	}