@deftai/directive-core 0.84.0 → 0.85.0

package/dist/product-signal/consent-prompt.js

@@ -0,0 +1,30 @@
+import { resolveProductSignal } from "../policy/product-signal.js";
+import { isProductSignalConsented } from "./consent.js";
+import { isHeadlessSession } from "./headless.js";
+/** D17 first-time consent ask (#2693 / #2822). */
+export const PRODUCT_SIGNAL_CONSENT_PROMPT = "May we collect usage metrics and related session signal from this install to improve Directive? " +
+    "This can include a short check-in plus minimized local summaries (value/health and related ledgers). " +
+    "Nothing is sent while this path is off or without your consent.\n\n" +
+    "If you are unsure, please check with your company before saying no — they are a Directive partner " +
+    "and may already expect this signal to be shared.\n\n" +
+    "Reply **yes** to consent (`task product-signal:consent -- --grant`), or **no** to decline.";
+/** True when an interactive session should surface the D17 consent ask (#2822 AC). */
+export function isProductSignalConsentEligible(options) {
+    if (isHeadlessSession(options)) {
+        return false;
+    }
+    const policy = resolveProductSignal(options.projectRoot);
+    if (!policy.enabled) {
+        return false;
+    }
+    return !isProductSignalConsented({ env: options.env });
+}
+/** Format the D17 consent ask for session start / status surfaces. */
+export function formatProductSignalConsentPrompt() {
+    return `[deft product-signal] First-time consent eligible:\n${PRODUCT_SIGNAL_CONSENT_PROMPT}\n`;
+}
+/** Emit the D17 ask when eligible; headless callers get an empty string (#2693 D16). */
+export function maybeFormatProductSignalConsentPrompt(options) {
+    return isProductSignalConsentEligible(options) ? formatProductSignalConsentPrompt() : "";
+}
+//# sourceMappingURL=consent-prompt.js.map

package/dist/product-signal/submit.js

@@ -1,9 +1,11 @@
 import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { assertWriteTargetSafe, ProjectionContainmentError } from "../fs/projection-containment.js";
 import { enableProductSignal, formatProductSignalStatusLine, resolveProductSignal, } from "../policy/product-signal.js";
 import { resolveProjectRoot } from "../scope/project-context.js";
 import { resolveActorName } from "./actor-name.js";
 import { authorizeProductSignalSink, grantProductSignalConsent, readProductSignalConsent, revokeProductSignalConsent, } from "./consent.js";
+import { maybeFormatProductSignalConsentPrompt } from "./consent-prompt.js";
 import { evaluateProductSignalGates } from "./gates.js";
 import { GitHubPrivateSinkAdapter } from "./github-private-sink-adapter.js";
 import { collectInstallContext } from "./install-context.js";
@@ -13,6 +15,7 @@ import { bootstrapProductSignalSink } from "./sink-bootstrap.js";
 export const PRODUCT_SIGNAL_LAST_SUBMIT_REL = join(".deft-cache", "product-signal-last-submit.json");
 function recordLastSubmit(projectRoot, outcome, url) {
     const path = resolve(projectRoot, PRODUCT_SIGNAL_LAST_SUBMIT_REL);
+    assertWriteTargetSafe(projectRoot, path);
     try {
         mkdirSync(join(path, ".."), { recursive: true });
         appendFileSync(path, `${JSON.stringify({
@@ -127,7 +130,21 @@ export async function submitProductSignal(options) {
     const adapter = new GitHubPrivateSinkAdapter({ sinkRepo: policy.sinkRepo });
     const result = await adapter.submit(payload, { gapText: options.gapText });
     if (result.outcome === "submitted") {
-        recordLastSubmit(root, result.outcome, result.issueUrl ?? null);
+        try {
+            recordLastSubmit(root, result.outcome, result.issueUrl ?? null);
+        }
+        catch (err) {
+            if (err instanceof ProjectionContainmentError) {
+                return {
+                    outcome: "error-config",
+                    exitCode: 2,
+                    message: `${err.message}\n`,
+                    issueUrl: result.issueUrl,
+                    payload,
+                };
+            }
+            throw err;
+        }
     }
     const urlLine = result.issueUrl ? ` url=${result.issueUrl}` : "";
     return {
@@ -150,6 +167,10 @@ export function runProductSignalStatus(projectRoot) {
         `[deft product-signal] consented=${String(consent !== null)} configuredSink=${configuredSink} consentedSink=${sinkAuth.consentedSink ?? "none"} sinksMatch=${String(sinkAuth.sinksMatch)}`,
         last ? `[deft product-signal] ${last}` : "[deft product-signal] last submit: none",
     ];
+    const consentPrompt = maybeFormatProductSignalConsentPrompt({ projectRoot: root });
+    if (consentPrompt.length > 0) {
+        lines.push(consentPrompt.trimEnd());
+    }
     return { exitCode: 0, text: `${lines.join("\n")}\n` };
 }
 export function runProductSignalEnable(projectRoot, confirm) {

package/dist/render/index.d.ts

@@ -8,6 +8,7 @@ export * as projectRender from "./project-render.js";
 export { acknowledgeProjectDefinitionStaleness, buildStalenessAcknowledgement, computeStalenessFlags, flagStaleNarratives, main as projectRenderMain, parseStalenessReview, renderProjectDefinition, scanLifecycleFolders, unacknowledgedCompletedItems, } from "./project-render.js";
 export * as roadmapRender from "./roadmap-render.js";
 export { checkDrift, generateRoadmapContent, main as roadmapRenderMain, renderRoadmap, renderRoadmapToBuffer, } from "./roadmap-render.js";
+export { main as ruleMapMain } from "./rule-map.js";
 export { aggregateScopeSection, buildScopeOutlookSection } from "./scope-outlook.js";
 export * as specRender from "./spec-render.js";
 export { main as specRenderMain, parseIncludeScopesFlag, renderSpec } from "./spec-render.js";

package/dist/render/index.js

@@ -8,6 +8,7 @@ export * as projectRender from "./project-render.js";
 export { acknowledgeProjectDefinitionStaleness, buildStalenessAcknowledgement, computeStalenessFlags, flagStaleNarratives, main as projectRenderMain, parseStalenessReview, renderProjectDefinition, scanLifecycleFolders, unacknowledgedCompletedItems, } from "./project-render.js";
 export * as roadmapRender from "./roadmap-render.js";
 export { checkDrift, generateRoadmapContent, main as roadmapRenderMain, renderRoadmap, renderRoadmapToBuffer, } from "./roadmap-render.js";
+export { main as ruleMapMain } from "./rule-map.js";
 export { aggregateScopeSection, buildScopeOutlookSection } from "./scope-outlook.js";
 export * as specRender from "./spec-render.js";
 export { main as specRenderMain, parseIncludeScopesFlag, renderSpec } from "./spec-render.js";

package/dist/render/rule-map-template.d.ts

@@ -0,0 +1,2 @@
+export declare const TEMPLATE = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Directive \u2014 Rule Map</title>\n<style>\n  :root{\n    --bg:#0f1115; --panel:#171a21; --panel2:#1d222b; --line:#2a303b;\n    --ink:#e7ebf0; --dim:#96a0ad; --dim2:#6b7482; --accent:#6ea8fe; --accent2:#8be0c0;\n    --must:#ff6b6b; --mustnot:#c0392b; --should:#f0b429; --shouldnot:#9a7b12; --may:#7f8a99;\n    --radius:12px;\n  }\n  *{box-sizing:border-box}\n  html,body{margin:0;height:100%}\n  body{background:var(--bg);color:var(--ink);\n    font:15px/1.5 -apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif}\n  code,.mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}\n  a{color:var(--accent);text-decoration:none}\n  .wrap{max-width:1120px;margin:0 auto;padding:22px 24px 80px}\n  header.top{display:flex;align-items:center;gap:18px;flex-wrap:wrap;\n    border-bottom:1px solid var(--line);padding-bottom:16px;margin-bottom:20px}\n  .brand{font-size:20px;font-weight:700;letter-spacing:.2px}\n  .brand small{display:block;font-size:12px;color:var(--dim);font-weight:400;margin-top:2px}\n  nav.spines{display:flex;gap:6px;margin-left:auto}\n  nav.spines button{background:var(--panel);color:var(--dim);border:1px solid var(--line);\n    padding:7px 14px;border-radius:999px;cursor:pointer;font-size:13px}\n  nav.spines button.active{background:var(--accent);color:#0b0d10;border-color:var(--accent);font-weight:600}\n  .search{width:100%;margin:0 0 18px}\n  .search input{width:100%;background:var(--panel);border:1px solid var(--line);color:var(--ink);\n    padding:11px 14px;border-radius:10px;font-size:14px}\n  .search input::placeholder{color:var(--dim2)}\n  .crumbs{display:flex;align-items:center;gap:8px;flex-wrap:wrap;color:var(--dim);font-size:13px;margin-bottom:16px}\n  .crumbs a{cursor:pointer}\n  .crumbs .sep{color:var(--dim2)}\n  .crumbs .here{color:var(--ink)}\n  .lead{color:var(--dim);margin:-4px 0 20px;max-width:760px}\n  .grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(250px,1fr));gap:12px}\n  .card{background:var(--panel);border:1px solid var(--line);border-radius:var(--radius);\n    padding:15px 16px;cursor:pointer;transition:.12s;display:flex;flex-direction:column;gap:7px;min-height:96px}\n  .card:hover{border-color:var(--accent);background:var(--panel2);transform:translateY(-1px)}\n  .card .name{font-weight:600;font-size:15px;display:flex;align-items:center;gap:8px}\n  .card .name .ic{color:var(--dim2);font-size:13px}\n  .card .desc{color:var(--dim);font-size:13px;line-height:1.45}\n  .card .meta{margin-top:auto;display:flex;align-items:center;gap:10px;color:var(--dim2);font-size:12px}\n  .rows{display:flex;flex-direction:column;gap:8px}\n  .row{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:12px 14px;\n    cursor:pointer;transition:.12s;display:flex;align-items:center;gap:12px}\n  .row:hover{border-color:var(--accent);background:var(--panel2)}\n  .row .rname{font-weight:600;min-width:0}\n  .row .rname .sub{font-weight:400;color:var(--dim);font-size:13px;display:block;margin-top:2px;\n    overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n  .row .rt{margin-left:auto;display:flex;gap:5px;flex-shrink:0}\n  .row .chev{color:var(--dim2);flex-shrink:0}\n  .tier{font-size:11px;padding:2px 7px;border-radius:999px;font-weight:600;white-space:nowrap;\n    color:#0b0d10;font-family:ui-monospace,monospace}\n  .t-MUST{background:var(--must)} .t-MUST-NOT{background:var(--mustnot);color:#fff}\n  .t-SHOULD{background:var(--should)} .t-SHOULD-NOT{background:var(--shouldnot);color:#fff}\n  .t-MAY{background:var(--may);color:#fff}\n  .bar{display:flex;height:6px;border-radius:999px;overflow:hidden;background:var(--panel2);flex:1;max-width:120px}\n  .bar span{display:block;height:100%}\n  .detail{background:var(--panel);border:1px solid var(--line);border-radius:var(--radius);padding:22px 24px}\n  .detail h2{margin:0 0 4px;font-size:22px}\n  .detail .kind{color:var(--dim2);font-size:12px;text-transform:uppercase;letter-spacing:.08em}\n  .detail .summary{color:var(--dim);margin:12px 0 18px;max-width:720px}\n  .sectionlist{display:flex;flex-wrap:wrap;gap:7px;margin:6px 0 4px}\n  .sectionlist .s{background:var(--panel2);border:1px solid var(--line);border-radius:7px;\n    padding:5px 10px;font-size:12.5px;color:var(--ink)}\n  .srcbox{margin-top:20px;border-top:1px solid var(--line);padding-top:16px}\n  .srcbox .path{font-size:12.5px;color:var(--dim);word-break:break-all;margin-bottom:10px}\n  .btns{display:flex;gap:8px;flex-wrap:wrap}\n  button.act{background:var(--accent);color:#0b0d10;border:none;padding:8px 14px;border-radius:8px;\n    cursor:pointer;font-size:13px;font-weight:600}\n  button.act.ghost{background:transparent;color:var(--accent);border:1px solid var(--line)}\n  button.act:hover{filter:brightness(1.08)}\n  h3.grouphdr{font-size:13px;text-transform:uppercase;letter-spacing:.08em;color:var(--dim2);margin:26px 0 10px}\n  .legend{display:flex;gap:8px;flex-wrap:wrap;font-size:12px;color:var(--dim);margin:2px 0 18px}\n  .toast{position:fixed;bottom:22px;left:50%;transform:translateX(-50%);background:var(--panel2);\n    border:1px solid var(--line);color:var(--ink);padding:11px 18px;border-radius:10px;font-size:13px;\n    opacity:0;transition:.2s;pointer-events:none;box-shadow:0 8px 30px rgba(0,0,0,.4);z-index:50}\n  .toast.show{opacity:1}\n  .toast.err{border-color:var(--must)}\n  .flow{display:flex;flex-wrap:wrap;align-items:stretch;gap:0}\n  .flow .node{background:var(--panel2);border:1px solid var(--line);border-radius:9px;padding:10px 14px;text-align:center;min-width:110px}\n  .flow .node .st{font-weight:600}\n  .flow .node .via{font-size:11px;color:var(--dim2);margin-top:3px;font-family:ui-monospace,monospace}\n  .flow .arw{align-self:center;color:var(--dim2);padding:0 8px;font-size:18px}\n  .ladder{display:flex;flex-direction:column;gap:8px;margin:6px 0 20px}\n  .ladder .lv{display:flex;gap:12px;align-items:baseline;background:var(--panel);border:1px solid var(--line);border-radius:9px;padding:11px 14px}\n  .ladder .lv b{min-width:190px}\n  .ladder .lv .d{color:var(--dim);font-size:13px}\n  .pill{display:inline-flex;align-items:center;gap:6px;font-size:12px;color:var(--dim);\n    background:var(--panel2);border:1px solid var(--line);padding:4px 9px;border-radius:999px;margin:0 6px 6px 0}\n  .muted{color:var(--dim2);font-size:12px}\n  .empty{color:var(--dim);padding:30px;text-align:center}\n  .foot{margin-top:34px;color:var(--dim2);font-size:12px;border-top:1px solid var(--line);padding-top:14px}\n  /* source viewer */\n  .src{margin-top:16px;background:#0b0d12;border:1px solid var(--line);border-radius:10px;padding:16px 18px;\n    max-height:60vh;overflow:auto}\n  .src h1,.src h2,.src h3{color:var(--ink);margin:14px 0 6px;line-height:1.3}\n  .src h1{font-size:19px} .src h2{font-size:16px} .src h3{font-size:14px}\n  .src p{margin:8px 0;color:#c7cfda}\n  .src ul{margin:8px 0;padding-left:22px;color:#c7cfda}\n  .src li{margin:3px 0}\n  .src code{background:#161b24;border:1px solid var(--line);border-radius:5px;padding:1px 5px;font-size:12.5px;color:var(--accent2)}\n  .src pre{background:#161b24;border:1px solid var(--line);border-radius:8px;padding:12px 14px;overflow:auto}\n  .src pre code{background:none;border:none;padding:0;color:#c7cfda}\n  .src blockquote{border-left:3px solid var(--line);margin:8px 0;padding:2px 12px;color:var(--dim)}\n  .src .trunc{color:var(--dim2);font-size:12px;margin-top:10px}\n</style>\n</head>\n<body>\n<div class=\"wrap\">\n  <header class=\"top\">\n    <div class=\"brand\">Directive &mdash; Rule Map<small id=\"sub\">maintainer map</small></div>\n    <nav class=\"spines\">\n      <button data-spine=\"rules\">Rules</button>\n      <button data-spine=\"tasks\">Tasks</button>\n      <button data-spine=\"lifecycle\">Lifecycle</button>\n    </nav>\n  </header>\n\n  <div class=\"search\"><input id=\"q\" placeholder=\"Search groupings, rules, tasks\u2026  (Esc to clear)\"></div>\n  <div class=\"crumbs\" id=\"crumbs\"></div>\n  <div id=\"view\"></div>\n  <div class=\"foot\" id=\"foot\"></div>\n</div>\n<div class=\"toast\" id=\"toast\"></div>\n\n<script>window.DIRECTIVE_DATA = /*__DATA__*/ null;</script>\n<script>\nlet DATA=window.DIRECTIVE_DATA, spine=\"rules\", stack=[];\nconst el=(t,c,txt)=>{const e=document.createElement(t);if(c)e.className=c;if(txt!=null)e.textContent=txt;return e;};\nconst tierClass=t=>\"t-\"+t.replace(/\\s|_/g,\"-\");\nconst TIER_ORDER=[\"MUST\",\"MUST NOT\",\"SHOULD\",\"SHOULD NOT\",\"MAY\"];\nconst TIER_COLOR={\"MUST\":\"var(--must)\",\"MUST NOT\":\"var(--mustnot)\",\"SHOULD\":\"var(--should)\",\"SHOULD NOT\":\"var(--shouldnot)\",\"MAY\":\"var(--may)\"};\nconst MARK2TIER={\"!\":\"MUST\",\"\u2297\":\"MUST NOT\",\"~\":\"SHOULD\",\"\u2249\":\"SHOULD NOT\",\"?\":\"MAY\"};\n\nfunction toast(msg,err){const t=document.getElementById('toast');t.textContent=msg;\n  t.className='toast show'+(err?' err':'');setTimeout(()=>t.className='toast',1800);}\nfunction copyPath(p){\n  const ok=()=>toast(\"Path copied\");\n  const fail=()=>toast(\"Copy failed\",true);\n  const fallback=()=>{\n    try{\n      const ta=document.createElement(\"textarea\");\n      ta.value=p;ta.setAttribute(\"readonly\",\"\");\n      ta.style.position=\"fixed\";ta.style.left=\"-9999px\";\n      document.body.appendChild(ta);ta.select();\n      const done=document.execCommand(\"copy\");\n      document.body.removeChild(ta);\n      done?ok():fail();\n    }catch(_){fail();}\n  };\n  if(navigator.clipboard&&typeof navigator.clipboard.writeText===\"function\"){\n    navigator.clipboard.writeText(p).then(ok,fallback);\n  }else fallback();\n}\n\n/* tiny zero-dependency markdown renderer (headings, lists, code, quote, inline) */\nfunction esc(s){return s.replace(/&/g,\"&amp;\").replace(/</g,\"&lt;\").replace(/>/g,\"&gt;\");}\nfunction inlineMd(s){\n  s=esc(s);\n  s=s.replace(/`([^`]+)`/g,'<code>$1</code>');\n  s=s.replace(/\\*\\*([^*]+)\\*\\*/g,'<strong>$1</strong>');\n  s=s.replace(/(^|[^*])\\*([^*]+)\\*/g,'$1<em>$2</em>');\n  s=s.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g,function(_,t,u){return /^(?:https?:|[/#.])/i.test(u)?'<a href=\"'+u+'\">'+t+'</a>':t;});\n  return s;\n}\nfunction mdToHtml(md){\n  const lines=(md||\"\").split(\"\\n\");\n  let out=[], i=0, inCode=false, code=[], list=false;\n  const closeList=()=>{if(list){out.push(\"</ul>\");list=false;}};\n  while(i<lines.length){\n    let ln=lines[i];\n    if(/^```/.test(ln)){\n      if(!inCode){inCode=true;code=[];}\n      else{inCode=false;out.push(\"<pre><code>\"+esc(code.join(\"\\n\"))+\"</code></pre>\");}\n      i++;continue;\n    }\n    if(inCode){code.push(ln);i++;continue;}\n    let m;\n    if((m=ln.match(/^(#{1,3})\\s+(.*)$/))){closeList();out.push(`<h${m[1].length}>`+inlineMd(m[2])+`</h${m[1].length}>`);}\n    else if(/^\\s*[-*]\\s+/.test(ln)){if(!list){out.push(\"<ul>\");list=true;}out.push(\"<li>\"+inlineMd(ln.replace(/^\\s*[-*]\\s+/,\"\"))+\"</li>\");}\n    else if(/^\\s*>\\s?/.test(ln)){closeList();out.push(\"<blockquote>\"+inlineMd(ln.replace(/^\\s*>\\s?/,\"\"))+\"</blockquote>\");}\n    else if(ln.trim()===\"\"){closeList();}\n    else{closeList();out.push(\"<p>\"+inlineMd(ln)+\"</p>\");}\n    i++;\n  }\n  closeList();\n  if(inCode)out.push(\"<pre><code>\"+esc(code.join(\"\\n\"))+\"</code></pre>\");\n  return out.join(\"\\n\");\n}\n\nfunction markerBar(markers){\n  const total=Object.values(markers||{}).reduce((a,b)=>a+b,0);\n  const bar=el('div','bar'); if(!total) return bar;\n  TIER_ORDER.forEach(t=>{const v=markers[t]||0;if(!v)return;\n    const s=el('span');s.style.width=(v/total*100)+'%';s.style.background=TIER_COLOR[t];s.title=t+\": \"+v;bar.appendChild(s);});\n  return bar;\n}\nfunction markersFromMarks(m){const o={};for(const k in (m||{})){const t=MARK2TIER[k];if(t)o[t]=(o[t]||0)+m[k];}return o;}\nfunction totalMarks(m){return Object.values(m||{}).reduce((a,b)=>a+b,0);}\n\nfunction go(node){stack.push(node);render();}\nfunction reset(s){spine=s;stack=[];render();}\nfunction crumbTo(i){stack=stack.slice(0,i);render();}\nfunction setSpine(s){document.querySelectorAll('nav.spines button').forEach(b=>b.classList.toggle('active',b.dataset.spine===s));}\n\nfunction render(){\n  setSpine(spine);\n  const view=document.getElementById('view');view.innerHTML='';\n  renderCrumbs();\n  if(document.getElementById('q').value.trim()){renderSearch(view);return;}\n  if(stack.length===0){ ({rules:overviewRules,tasks:overviewTasks,lifecycle:renderLifecycle})[spine](view); return; }\n  stack[stack.length-1].render(view);\n}\nfunction renderCrumbs(){\n  const c=document.getElementById('crumbs');c.innerHTML='';\n  const root=el('a','',spine[0].toUpperCase()+spine.slice(1));root.onclick=()=>{stack=[];render();};c.appendChild(root);\n  stack.forEach((n,i)=>{c.appendChild(el('span','sep','\u203A'));\n    if(i<stack.length-1){const a=el('a','',n.label);a.onclick=()=>crumbTo(i+1);c.appendChild(a);}\n    else c.appendChild(el('span','here',n.label));});\n}\nfunction intro(t){return el('div','lead',t);}\nfunction ghdr(t){return el('h3','grouphdr',t);}\nfunction pathBar(p){const box=el('div','srcbox');box.appendChild(el('div','path',p));\n  const b=el('button','act ghost','Copy path');b.onclick=e=>{e.stopPropagation();copyPath(p);};\n  const btns=el('div','btns');btns.appendChild(b);box.appendChild(btns);return box;}\n\nfunction overviewRules(view){\n  document.getElementById('foot').textContent=\n    `${DATA.groupings.length} rule groupings \u00B7 ${DATA.groupings.reduce((a,g)=>a+g.doc_count,0)} docs \u00B7 derived from content/`;\n  view.appendChild(intro(\"Major rule groupings \u2014 lazy-loaded bodies of guidance the agent pulls in only when the work needs it. Click to drill in.\"));\n  const grid=el('div','grid');\n  DATA.groupings.forEach(g=>{\n    const card=el('div','card');\n    card.appendChild(el('div','name',g.name));\n    card.appendChild(el('div','desc',g.purpose||''));\n    const meta=el('div','meta');meta.appendChild(el('span','',g.doc_count+' docs'));meta.appendChild(markerBar(g.markers));card.appendChild(meta);\n    card.onclick=()=>go({label:g.name,render:v=>groupView(v,g)});\n    grid.appendChild(card);\n  });\n  view.appendChild(grid);\n}\nfunction groupView(view,g){\n  view.appendChild(intro(g.purpose||''));\n  const files=g.items.filter(i=>i.kind==='file'), dirs=g.items.filter(i=>i.kind==='dir');\n  if(files.length){view.appendChild(ghdr(\"Documents\"));view.appendChild(rowsOf(files));}\n  if(dirs.length){view.appendChild(ghdr(\"Topics\"));\n    const grid=el('div','grid');\n    dirs.forEach(d=>{const card=el('div','card');card.appendChild(el('div','name',d.title||d.name));\n      if(d.summary)card.appendChild(el('div','desc',d.summary));\n      const meta=el('div','meta');meta.appendChild(el('span','',d.count+' files'));card.appendChild(meta);\n      card.onclick=()=>go({label:d.name,render:v=>dirView(v,d)});grid.appendChild(card);});\n    view.appendChild(grid);\n  }\n}\nfunction dirView(view,d){\n  view.appendChild(intro(d.summary||''));\n  if(d.readme){view.appendChild(ghdr(\"Overview\"));view.appendChild(rowsOf([d.readme]));}\n  view.appendChild(ghdr(\"Files\"));view.appendChild(rowsOf(d.files));\n}\nfunction rowsOf(files){\n  const box=el('div','rows');\n  files.forEach(f=>{\n    const row=el('div','row');\n    const nm=el('div','rname');nm.appendChild(document.createTextNode(f.title||f.name));\n    if(f.summary)nm.appendChild(el('span','sub',f.summary));\n    row.appendChild(nm);\n    const rt=el('div','rt');const mk=markersFromMarks(f.markers);\n    TIER_ORDER.forEach(t=>{if(mk[t]){const b=el('span','tier '+tierClass(t),mk[t]+\" \"+t.replace(\" NOT\",\"\u0338\"));b.title=mk[t]+\" \"+t;rt.appendChild(b);}});\n    row.appendChild(rt);row.appendChild(el('span','chev','\u203A'));\n    row.onclick=()=>go({label:f.name,render:v=>docDetail(v,f)});\n    box.appendChild(row);\n  });\n  return box;\n}\nfunction docDetail(view,f){\n  const d=el('div','detail');\n  d.appendChild(el('div','kind',(f.generated?'generated view \u00B7 ':'')+(f.lines?f.lines+' lines':'document')));\n  d.appendChild(el('h2',null,f.title||f.name));\n  if(f.summary)d.appendChild(el('div','summary',f.summary));\n  const mk=markersFromMarks(f.markers);\n  if(totalMarks(f.markers)){const p=el('div');p.style.margin='0 0 14px';\n    TIER_ORDER.forEach(t=>{if(mk[t]){const b=el('span','tier '+tierClass(t));b.textContent=mk[t]+\" \"+t;b.style.marginRight='6px';p.appendChild(b);}});\n    d.appendChild(p);}\n  if(f.sections&&f.sections.length){d.appendChild(el('div','muted','Sections'));\n    const sl=el('div','sectionlist');f.sections.forEach(s=>sl.appendChild(el('div','s',s)));d.appendChild(sl);}\n  if(f.generated)d.appendChild(Object.assign(el('div','muted'),{textContent:'\u26A0 Auto-generated from a pack \u2014 edit the source pack, not this file.',style:'margin-top:12px'}));\n\n  const box=el('div','srcbox');\n  box.appendChild(el('div','path',f.path));\n  const btns=el('div','btns');\n  const srcPane=el('div','src');srcPane.style.display='none';\n  let shown=false;\n  const view_=el('button','act','View source');\n  view_.onclick=e=>{e.stopPropagation();shown=!shown;\n    if(shown&&!srcPane.dataset.rendered){srcPane.innerHTML=mdToHtml(f.body||'(source not captured)');\n      if(f.truncated)srcPane.appendChild(Object.assign(el('div','trunc'),{textContent:'\u2026 truncated (large file); open the file directly for the rest.'}));\n      srcPane.dataset.rendered='1';}\n    srcPane.style.display=shown?'block':'none';view_.textContent=shown?'Hide source':'View source';};\n  const copy=el('button','act ghost','Copy path');copy.onclick=e=>{e.stopPropagation();copyPath(f.path);};\n  btns.appendChild(view_);btns.appendChild(copy);box.appendChild(btns);box.appendChild(srcPane);\n  d.appendChild(box);\n  view.appendChild(d);\n}\n\nfunction overviewTasks(view){\n  document.getElementById('foot').textContent=\n    `${DATA.tasks.length} task namespaces \u00B7 ${DATA.tasks.reduce((a,t)=>a+t.task_count,0)} tasks \u00B7 run: task <namespace>:<name>`;\n  view.appendChild(intro(\"The executable layer. Rules are enforced by Taskfile targets \u2014 deterministic gates the agent and CI run. Each card is a namespace; drill in for its commands.\"));\n  const grid=el('div','grid');\n  DATA.tasks.forEach(t=>{const card=el('div','card');\n    const nm=el('div','name');nm.appendChild(document.createTextNode(t.namespace));\n    if(t.unlisted)nm.appendChild(Object.assign(el('span','ic'),{textContent:'unlisted'}));\n    card.appendChild(nm);card.appendChild(el('div','desc',t.purpose||''));\n    const meta=el('div','meta');meta.appendChild(el('span','',t.task_count+' tasks'));card.appendChild(meta);\n    card.onclick=()=>go({label:t.namespace,render:v=>taskDetail(v,t)});grid.appendChild(card);});\n  view.appendChild(grid);\n}\nfunction taskDetail(view,t){\n  view.appendChild(intro(t.purpose||''));\n  view.appendChild(ghdr(\"Commands\"));\n  const box=el('div','rows');\n  t.tasks.forEach(tk=>{const row=el('div','row');row.style.cursor='default';\n    const nm=el('div','rname');nm.appendChild(Object.assign(el('code'),{textContent:'task '+t.namespace+':'+tk.name}));\n    if(tk.desc)nm.appendChild(el('span','sub',tk.desc));row.appendChild(nm);box.appendChild(row);});\n  view.appendChild(box);\n  view.appendChild(pathBar(t.path));\n}\nfunction renderLifecycle(view){\n  const L=DATA.lifecycle;\n  document.getElementById('foot').textContent=\"Lifecycle & gates \u00B7 source: \"+L.source;\n  view.appendChild(intro(L.summary));\n  view.appendChild(ghdr(\"Rule strength \u2014 prefer enforceable over remembered\"));\n  const lad=el('div','ladder');\n  L.rule_strength.forEach((r,i)=>{const lv=el('div','lv');lv.appendChild(Object.assign(el('b'),{textContent:(i+1)+\". \"+r.level}));lv.appendChild(el('span','d',r.detail));lad.appendChild(lv);});\n  view.appendChild(lad);\n  view.appendChild(ghdr(\"Scope lifecycle\"));\n  const flow=el('div','flow');\n  L.scope_states.forEach((s,i)=>{if(i)flow.appendChild(el('div','arw','\u2192'));\n    const n=el('div','node');n.appendChild(el('div','st',s.state));n.appendChild(el('div','via',s.via));flow.appendChild(n);});\n  view.appendChild(flow);\n  view.appendChild(ghdr(\"vBRIEF \u2014 the durable state\"));\n  const box=el('div','rows');\n  L.vbrief_files.forEach(v=>{const row=el('div','row');row.style.cursor='default';\n    const nm=el('div','rname');nm.appendChild(Object.assign(el('code'),{textContent:v.file}));nm.appendChild(el('span','sub',v.role));row.appendChild(nm);box.appendChild(row);});\n  view.appendChild(box);\n  view.appendChild(ghdr(\"Quality gates\"));\n  const g=el('div');g.style.marginBottom='14px';\n  L.gates.forEach(x=>{const p=el('span','pill');p.appendChild(Object.assign(el('code'),{textContent:x}));g.appendChild(p);});\n  view.appendChild(g);\n  view.appendChild(ghdr(\"Key docs\"));\n  const kd=el('div','rows');\n  L.key_docs.forEach(doc=>{const row=el('div','row');row.style.cursor='default';\n    const nm=el('div','rname');nm.appendChild(document.createTextNode(doc.title));nm.appendChild(el('span','sub',doc.path));row.appendChild(nm);\n    const b=el('button','act ghost','Copy path');b.onclick=e=>{e.stopPropagation();copyPath(doc.path);};\n    const rt=el('div','rt');rt.appendChild(b);row.appendChild(rt);kd.appendChild(row);});\n  view.appendChild(kd);\n}\nfunction renderSearch(view){\n  const q=document.getElementById('q').value.trim().toLowerCase();\n  const hits=[];\n  const push=(label,sub,onclick,tag)=>hits.push({label,sub,onclick,tag});\n  DATA.groupings.forEach(g=>{\n    if((g.name+\" \"+g.purpose).toLowerCase().includes(q))\n      push(g.name,g.purpose,()=>{spine='rules';stack=[{label:g.name,render:v=>groupView(v,g)}];document.getElementById('q').value='';render();},\"grouping\");\n    g.items.forEach(it=>{\n      const scan=f=>{if((f.title+\" \"+f.name+\" \"+(f.summary||\"\")).toLowerCase().includes(q))\n        push(f.title||f.name,f.summary||g.name,()=>{spine='rules';stack=[{label:g.name,render:v=>groupView(v,g)},{label:f.name,render:v=>docDetail(v,f)}];document.getElementById('q').value='';render();},g.name);};\n      if(it.kind==='file')scan(it); else{if(it.readme)scan(it.readme);it.files.forEach(scan);}\n    });\n  });\n  DATA.tasks.forEach(t=>{\n    if((t.namespace+\" \"+t.purpose).toLowerCase().includes(q))\n      push(\"task \"+t.namespace,t.purpose,()=>{spine='tasks';stack=[{label:t.namespace,render:v=>taskDetail(v,t)}];document.getElementById('q').value='';render();},\"tasks\");\n    t.tasks.forEach(tk=>{if((tk.name+\" \"+tk.desc).toLowerCase().includes(q))\n      push(\"task \"+t.namespace+\":\"+tk.name,tk.desc,()=>{spine='tasks';stack=[{label:t.namespace,render:v=>taskDetail(v,t)}];document.getElementById('q').value='';render();},\"task\");});\n  });\n  document.getElementById('foot').textContent=hits.length+\" matches\";\n  if(!hits.length){view.appendChild(el('div','empty','No matches for \"'+q+'\"'));return;}\n  const box=el('div','rows');\n  hits.slice(0,120).forEach(h=>{const row=el('div','row');\n    const nm=el('div','rname');nm.appendChild(document.createTextNode(h.label));if(h.sub)nm.appendChild(el('span','sub',h.sub));row.appendChild(nm);\n    if(h.tag){const rt=el('div','rt');rt.appendChild(el('span','pill',h.tag));row.appendChild(rt);}\n    row.appendChild(el('span','chev','\u203A'));row.onclick=h.onclick;box.appendChild(row);});\n  view.appendChild(box);\n}\n\ndocument.querySelectorAll('nav.spines button').forEach(b=>b.onclick=()=>reset(b.dataset.spine));\nconst qEl=document.getElementById('q');\nqEl.addEventListener('input',render);\nqEl.addEventListener('keydown',e=>{if(e.key==='Escape'){qEl.value='';render();}});\n\nif(!DATA){document.getElementById('view').innerHTML='<div class=\"empty\">No data embedded. Rebuild with <code>task docs:rule-map</code>.</div>';}\nelse{document.getElementById('sub').textContent=\"Deft Directive \u00B7 \"+DATA.groupings.length+\" rule groups \u00B7 \"+DATA.tasks.length+\" task namespaces \u00B7 maintainer map\";render();}\n</script>\n</body>\n</html>\n";
+//# sourceMappingURL=rule-map-template.d.ts.map

package/dist/render/rule-map-template.js

@@ -0,0 +1,407 @@
+// Inlined Rule Map explorer template (zero runtime deps). The build (tsc) does not
+// copy non-.ts assets, so the HTML shell ships as a string constant compiled with
+// the code. It is a plain template literal — edit the HTML/CSS/JS in place here;
+// keep it a literal (escape only a backtick as \` and a literal ${ as \${), since
+// rule-map.ts injects the data by string-replacing the `/*__DATA__*/ null` token.
+export const TEMPLATE = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Directive — Rule Map</title>
+<style>
+  :root{
+    --bg:#0f1115; --panel:#171a21; --panel2:#1d222b; --line:#2a303b;
+    --ink:#e7ebf0; --dim:#96a0ad; --dim2:#6b7482; --accent:#6ea8fe; --accent2:#8be0c0;
+    --must:#ff6b6b; --mustnot:#c0392b; --should:#f0b429; --shouldnot:#9a7b12; --may:#7f8a99;
+    --radius:12px;
+  }
+  *{box-sizing:border-box}
+  html,body{margin:0;height:100%}
+  body{background:var(--bg);color:var(--ink);
+    font:15px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif}
+  code,.mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+  a{color:var(--accent);text-decoration:none}
+  .wrap{max-width:1120px;margin:0 auto;padding:22px 24px 80px}
+  header.top{display:flex;align-items:center;gap:18px;flex-wrap:wrap;
+    border-bottom:1px solid var(--line);padding-bottom:16px;margin-bottom:20px}
+  .brand{font-size:20px;font-weight:700;letter-spacing:.2px}
+  .brand small{display:block;font-size:12px;color:var(--dim);font-weight:400;margin-top:2px}
+  nav.spines{display:flex;gap:6px;margin-left:auto}
+  nav.spines button{background:var(--panel);color:var(--dim);border:1px solid var(--line);
+    padding:7px 14px;border-radius:999px;cursor:pointer;font-size:13px}
+  nav.spines button.active{background:var(--accent);color:#0b0d10;border-color:var(--accent);font-weight:600}
+  .search{width:100%;margin:0 0 18px}
+  .search input{width:100%;background:var(--panel);border:1px solid var(--line);color:var(--ink);
+    padding:11px 14px;border-radius:10px;font-size:14px}
+  .search input::placeholder{color:var(--dim2)}
+  .crumbs{display:flex;align-items:center;gap:8px;flex-wrap:wrap;color:var(--dim);font-size:13px;margin-bottom:16px}
+  .crumbs a{cursor:pointer}
+  .crumbs .sep{color:var(--dim2)}
+  .crumbs .here{color:var(--ink)}
+  .lead{color:var(--dim);margin:-4px 0 20px;max-width:760px}
+  .grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(250px,1fr));gap:12px}
+  .card{background:var(--panel);border:1px solid var(--line);border-radius:var(--radius);
+    padding:15px 16px;cursor:pointer;transition:.12s;display:flex;flex-direction:column;gap:7px;min-height:96px}
+  .card:hover{border-color:var(--accent);background:var(--panel2);transform:translateY(-1px)}
+  .card .name{font-weight:600;font-size:15px;display:flex;align-items:center;gap:8px}
+  .card .name .ic{color:var(--dim2);font-size:13px}
+  .card .desc{color:var(--dim);font-size:13px;line-height:1.45}
+  .card .meta{margin-top:auto;display:flex;align-items:center;gap:10px;color:var(--dim2);font-size:12px}
+  .rows{display:flex;flex-direction:column;gap:8px}
+  .row{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:12px 14px;
+    cursor:pointer;transition:.12s;display:flex;align-items:center;gap:12px}
+  .row:hover{border-color:var(--accent);background:var(--panel2)}
+  .row .rname{font-weight:600;min-width:0}
+  .row .rname .sub{font-weight:400;color:var(--dim);font-size:13px;display:block;margin-top:2px;
+    overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+  .row .rt{margin-left:auto;display:flex;gap:5px;flex-shrink:0}
+  .row .chev{color:var(--dim2);flex-shrink:0}
+  .tier{font-size:11px;padding:2px 7px;border-radius:999px;font-weight:600;white-space:nowrap;
+    color:#0b0d10;font-family:ui-monospace,monospace}
+  .t-MUST{background:var(--must)} .t-MUST-NOT{background:var(--mustnot);color:#fff}
+  .t-SHOULD{background:var(--should)} .t-SHOULD-NOT{background:var(--shouldnot);color:#fff}
+  .t-MAY{background:var(--may);color:#fff}
+  .bar{display:flex;height:6px;border-radius:999px;overflow:hidden;background:var(--panel2);flex:1;max-width:120px}
+  .bar span{display:block;height:100%}
+  .detail{background:var(--panel);border:1px solid var(--line);border-radius:var(--radius);padding:22px 24px}
+  .detail h2{margin:0 0 4px;font-size:22px}
+  .detail .kind{color:var(--dim2);font-size:12px;text-transform:uppercase;letter-spacing:.08em}
+  .detail .summary{color:var(--dim);margin:12px 0 18px;max-width:720px}
+  .sectionlist{display:flex;flex-wrap:wrap;gap:7px;margin:6px 0 4px}
+  .sectionlist .s{background:var(--panel2);border:1px solid var(--line);border-radius:7px;
+    padding:5px 10px;font-size:12.5px;color:var(--ink)}
+  .srcbox{margin-top:20px;border-top:1px solid var(--line);padding-top:16px}
+  .srcbox .path{font-size:12.5px;color:var(--dim);word-break:break-all;margin-bottom:10px}
+  .btns{display:flex;gap:8px;flex-wrap:wrap}
+  button.act{background:var(--accent);color:#0b0d10;border:none;padding:8px 14px;border-radius:8px;
+    cursor:pointer;font-size:13px;font-weight:600}
+  button.act.ghost{background:transparent;color:var(--accent);border:1px solid var(--line)}
+  button.act:hover{filter:brightness(1.08)}
+  h3.grouphdr{font-size:13px;text-transform:uppercase;letter-spacing:.08em;color:var(--dim2);margin:26px 0 10px}
+  .legend{display:flex;gap:8px;flex-wrap:wrap;font-size:12px;color:var(--dim);margin:2px 0 18px}
+  .toast{position:fixed;bottom:22px;left:50%;transform:translateX(-50%);background:var(--panel2);
+    border:1px solid var(--line);color:var(--ink);padding:11px 18px;border-radius:10px;font-size:13px;
+    opacity:0;transition:.2s;pointer-events:none;box-shadow:0 8px 30px rgba(0,0,0,.4);z-index:50}
+  .toast.show{opacity:1}
+  .toast.err{border-color:var(--must)}
+  .flow{display:flex;flex-wrap:wrap;align-items:stretch;gap:0}
+  .flow .node{background:var(--panel2);border:1px solid var(--line);border-radius:9px;padding:10px 14px;text-align:center;min-width:110px}
+  .flow .node .st{font-weight:600}
+  .flow .node .via{font-size:11px;color:var(--dim2);margin-top:3px;font-family:ui-monospace,monospace}
+  .flow .arw{align-self:center;color:var(--dim2);padding:0 8px;font-size:18px}
+  .ladder{display:flex;flex-direction:column;gap:8px;margin:6px 0 20px}
+  .ladder .lv{display:flex;gap:12px;align-items:baseline;background:var(--panel);border:1px solid var(--line);border-radius:9px;padding:11px 14px}
+  .ladder .lv b{min-width:190px}
+  .ladder .lv .d{color:var(--dim);font-size:13px}
+  .pill{display:inline-flex;align-items:center;gap:6px;font-size:12px;color:var(--dim);
+    background:var(--panel2);border:1px solid var(--line);padding:4px 9px;border-radius:999px;margin:0 6px 6px 0}
+  .muted{color:var(--dim2);font-size:12px}
+  .empty{color:var(--dim);padding:30px;text-align:center}
+  .foot{margin-top:34px;color:var(--dim2);font-size:12px;border-top:1px solid var(--line);padding-top:14px}
+  /* source viewer */
+  .src{margin-top:16px;background:#0b0d12;border:1px solid var(--line);border-radius:10px;padding:16px 18px;
+    max-height:60vh;overflow:auto}
+  .src h1,.src h2,.src h3{color:var(--ink);margin:14px 0 6px;line-height:1.3}
+  .src h1{font-size:19px} .src h2{font-size:16px} .src h3{font-size:14px}
+  .src p{margin:8px 0;color:#c7cfda}
+  .src ul{margin:8px 0;padding-left:22px;color:#c7cfda}
+  .src li{margin:3px 0}
+  .src code{background:#161b24;border:1px solid var(--line);border-radius:5px;padding:1px 5px;font-size:12.5px;color:var(--accent2)}
+  .src pre{background:#161b24;border:1px solid var(--line);border-radius:8px;padding:12px 14px;overflow:auto}
+  .src pre code{background:none;border:none;padding:0;color:#c7cfda}
+  .src blockquote{border-left:3px solid var(--line);margin:8px 0;padding:2px 12px;color:var(--dim)}
+  .src .trunc{color:var(--dim2);font-size:12px;margin-top:10px}
+</style>
+</head>
+<body>
+<div class="wrap">
+  <header class="top">
+    <div class="brand">Directive &mdash; Rule Map<small id="sub">maintainer map</small></div>
+    <nav class="spines">
+      <button data-spine="rules">Rules</button>
+      <button data-spine="tasks">Tasks</button>
+      <button data-spine="lifecycle">Lifecycle</button>
+    </nav>
+  </header>
+
+  <div class="search"><input id="q" placeholder="Search groupings, rules, tasks…  (Esc to clear)"></div>
+  <div class="crumbs" id="crumbs"></div>
+  <div id="view"></div>
+  <div class="foot" id="foot"></div>
+</div>
+<div class="toast" id="toast"></div>
+
+<script>window.DIRECTIVE_DATA = /*__DATA__*/ null;</script>
+<script>
+let DATA=window.DIRECTIVE_DATA, spine="rules", stack=[];
+const el=(t,c,txt)=>{const e=document.createElement(t);if(c)e.className=c;if(txt!=null)e.textContent=txt;return e;};
+const tierClass=t=>"t-"+t.replace(/\\s|_/g,"-");
+const TIER_ORDER=["MUST","MUST NOT","SHOULD","SHOULD NOT","MAY"];
+const TIER_COLOR={"MUST":"var(--must)","MUST NOT":"var(--mustnot)","SHOULD":"var(--should)","SHOULD NOT":"var(--shouldnot)","MAY":"var(--may)"};
+const MARK2TIER={"!":"MUST","⊗":"MUST NOT","~":"SHOULD","≉":"SHOULD NOT","?":"MAY"};
+
+function toast(msg,err){const t=document.getElementById('toast');t.textContent=msg;
+  t.className='toast show'+(err?' err':'');setTimeout(()=>t.className='toast',1800);}
+function copyPath(p){
+  const ok=()=>toast("Path copied");
+  const fail=()=>toast("Copy failed",true);
+  const fallback=()=>{
+    try{
+      const ta=document.createElement("textarea");
+      ta.value=p;ta.setAttribute("readonly","");
+      ta.style.position="fixed";ta.style.left="-9999px";
+      document.body.appendChild(ta);ta.select();
+      const done=document.execCommand("copy");
+      document.body.removeChild(ta);
+      done?ok():fail();
+    }catch(_){fail();}
+  };
+  if(navigator.clipboard&&typeof navigator.clipboard.writeText==="function"){
+    navigator.clipboard.writeText(p).then(ok,fallback);
+  }else fallback();
+}
+
+/* tiny zero-dependency markdown renderer (headings, lists, code, quote, inline) */
+function esc(s){return s.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;");}
+function inlineMd(s){
+  s=esc(s);
+  s=s.replace(/\`([^\`]+)\`/g,'<code>$1</code>');
+  s=s.replace(/\\*\\*([^*]+)\\*\\*/g,'<strong>$1</strong>');
+  s=s.replace(/(^|[^*])\\*([^*]+)\\*/g,'$1<em>$2</em>');
+  s=s.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g,function(_,t,u){return /^(?:https?:|[/#.])/i.test(u)?'<a href="'+u+'">'+t+'</a>':t;});
+  return s;
+}
+function mdToHtml(md){
+  const lines=(md||"").split("\\n");
+  let out=[], i=0, inCode=false, code=[], list=false;
+  const closeList=()=>{if(list){out.push("</ul>");list=false;}};
+  while(i<lines.length){
+    let ln=lines[i];
+    if(/^\`\`\`/.test(ln)){
+      if(!inCode){inCode=true;code=[];}
+      else{inCode=false;out.push("<pre><code>"+esc(code.join("\\n"))+"</code></pre>");}
+      i++;continue;
+    }
+    if(inCode){code.push(ln);i++;continue;}
+    let m;
+    if((m=ln.match(/^(#{1,3})\\s+(.*)$/))){closeList();out.push(\`<h\${m[1].length}>\`+inlineMd(m[2])+\`</h\${m[1].length}>\`);}
+    else if(/^\\s*[-*]\\s+/.test(ln)){if(!list){out.push("<ul>");list=true;}out.push("<li>"+inlineMd(ln.replace(/^\\s*[-*]\\s+/,""))+"</li>");}
+    else if(/^\\s*>\\s?/.test(ln)){closeList();out.push("<blockquote>"+inlineMd(ln.replace(/^\\s*>\\s?/,""))+"</blockquote>");}
+    else if(ln.trim()===""){closeList();}
+    else{closeList();out.push("<p>"+inlineMd(ln)+"</p>");}
+    i++;
+  }
+  closeList();
+  if(inCode)out.push("<pre><code>"+esc(code.join("\\n"))+"</code></pre>");
+  return out.join("\\n");
+}
+
+function markerBar(markers){
+  const total=Object.values(markers||{}).reduce((a,b)=>a+b,0);
+  const bar=el('div','bar'); if(!total) return bar;
+  TIER_ORDER.forEach(t=>{const v=markers[t]||0;if(!v)return;
+    const s=el('span');s.style.width=(v/total*100)+'%';s.style.background=TIER_COLOR[t];s.title=t+": "+v;bar.appendChild(s);});
+  return bar;
+}
+function markersFromMarks(m){const o={};for(const k in (m||{})){const t=MARK2TIER[k];if(t)o[t]=(o[t]||0)+m[k];}return o;}
+function totalMarks(m){return Object.values(m||{}).reduce((a,b)=>a+b,0);}
+
+function go(node){stack.push(node);render();}
+function reset(s){spine=s;stack=[];render();}
+function crumbTo(i){stack=stack.slice(0,i);render();}
+function setSpine(s){document.querySelectorAll('nav.spines button').forEach(b=>b.classList.toggle('active',b.dataset.spine===s));}
+
+function render(){
+  setSpine(spine);
+  const view=document.getElementById('view');view.innerHTML='';
+  renderCrumbs();
+  if(document.getElementById('q').value.trim()){renderSearch(view);return;}
+  if(stack.length===0){ ({rules:overviewRules,tasks:overviewTasks,lifecycle:renderLifecycle})[spine](view); return; }
+  stack[stack.length-1].render(view);
+}
+function renderCrumbs(){
+  const c=document.getElementById('crumbs');c.innerHTML='';
+  const root=el('a','',spine[0].toUpperCase()+spine.slice(1));root.onclick=()=>{stack=[];render();};c.appendChild(root);
+  stack.forEach((n,i)=>{c.appendChild(el('span','sep','›'));
+    if(i<stack.length-1){const a=el('a','',n.label);a.onclick=()=>crumbTo(i+1);c.appendChild(a);}
+    else c.appendChild(el('span','here',n.label));});
+}
+function intro(t){return el('div','lead',t);}
+function ghdr(t){return el('h3','grouphdr',t);}
+function pathBar(p){const box=el('div','srcbox');box.appendChild(el('div','path',p));
+  const b=el('button','act ghost','Copy path');b.onclick=e=>{e.stopPropagation();copyPath(p);};
+  const btns=el('div','btns');btns.appendChild(b);box.appendChild(btns);return box;}
+
+function overviewRules(view){
+  document.getElementById('foot').textContent=
+    \`\${DATA.groupings.length} rule groupings · \${DATA.groupings.reduce((a,g)=>a+g.doc_count,0)} docs · derived from content/\`;
+  view.appendChild(intro("Major rule groupings — lazy-loaded bodies of guidance the agent pulls in only when the work needs it. Click to drill in."));
+  const grid=el('div','grid');
+  DATA.groupings.forEach(g=>{
+    const card=el('div','card');
+    card.appendChild(el('div','name',g.name));
+    card.appendChild(el('div','desc',g.purpose||''));
+    const meta=el('div','meta');meta.appendChild(el('span','',g.doc_count+' docs'));meta.appendChild(markerBar(g.markers));card.appendChild(meta);
+    card.onclick=()=>go({label:g.name,render:v=>groupView(v,g)});
+    grid.appendChild(card);
+  });
+  view.appendChild(grid);
+}
+function groupView(view,g){
+  view.appendChild(intro(g.purpose||''));
+  const files=g.items.filter(i=>i.kind==='file'), dirs=g.items.filter(i=>i.kind==='dir');
+  if(files.length){view.appendChild(ghdr("Documents"));view.appendChild(rowsOf(files));}
+  if(dirs.length){view.appendChild(ghdr("Topics"));
+    const grid=el('div','grid');
+    dirs.forEach(d=>{const card=el('div','card');card.appendChild(el('div','name',d.title||d.name));
+      if(d.summary)card.appendChild(el('div','desc',d.summary));
+      const meta=el('div','meta');meta.appendChild(el('span','',d.count+' files'));card.appendChild(meta);
+      card.onclick=()=>go({label:d.name,render:v=>dirView(v,d)});grid.appendChild(card);});
+    view.appendChild(grid);
+  }
+}
+function dirView(view,d){
+  view.appendChild(intro(d.summary||''));
+  if(d.readme){view.appendChild(ghdr("Overview"));view.appendChild(rowsOf([d.readme]));}
+  view.appendChild(ghdr("Files"));view.appendChild(rowsOf(d.files));
+}
+function rowsOf(files){
+  const box=el('div','rows');
+  files.forEach(f=>{
+    const row=el('div','row');
+    const nm=el('div','rname');nm.appendChild(document.createTextNode(f.title||f.name));
+    if(f.summary)nm.appendChild(el('span','sub',f.summary));
+    row.appendChild(nm);
+    const rt=el('div','rt');const mk=markersFromMarks(f.markers);
+    TIER_ORDER.forEach(t=>{if(mk[t]){const b=el('span','tier '+tierClass(t),mk[t]+" "+t.replace(" NOT","̸"));b.title=mk[t]+" "+t;rt.appendChild(b);}});
+    row.appendChild(rt);row.appendChild(el('span','chev','›'));
+    row.onclick=()=>go({label:f.name,render:v=>docDetail(v,f)});
+    box.appendChild(row);
+  });
+  return box;
+}
+function docDetail(view,f){
+  const d=el('div','detail');
+  d.appendChild(el('div','kind',(f.generated?'generated view · ':'')+(f.lines?f.lines+' lines':'document')));
+  d.appendChild(el('h2',null,f.title||f.name));
+  if(f.summary)d.appendChild(el('div','summary',f.summary));
+  const mk=markersFromMarks(f.markers);
+  if(totalMarks(f.markers)){const p=el('div');p.style.margin='0 0 14px';
+    TIER_ORDER.forEach(t=>{if(mk[t]){const b=el('span','tier '+tierClass(t));b.textContent=mk[t]+" "+t;b.style.marginRight='6px';p.appendChild(b);}});
+    d.appendChild(p);}
+  if(f.sections&&f.sections.length){d.appendChild(el('div','muted','Sections'));
+    const sl=el('div','sectionlist');f.sections.forEach(s=>sl.appendChild(el('div','s',s)));d.appendChild(sl);}
+  if(f.generated)d.appendChild(Object.assign(el('div','muted'),{textContent:'⚠ Auto-generated from a pack — edit the source pack, not this file.',style:'margin-top:12px'}));
+
+  const box=el('div','srcbox');
+  box.appendChild(el('div','path',f.path));
+  const btns=el('div','btns');
+  const srcPane=el('div','src');srcPane.style.display='none';
+  let shown=false;
+  const view_=el('button','act','View source');
+  view_.onclick=e=>{e.stopPropagation();shown=!shown;
+    if(shown&&!srcPane.dataset.rendered){srcPane.innerHTML=mdToHtml(f.body||'(source not captured)');
+      if(f.truncated)srcPane.appendChild(Object.assign(el('div','trunc'),{textContent:'… truncated (large file); open the file directly for the rest.'}));
+      srcPane.dataset.rendered='1';}
+    srcPane.style.display=shown?'block':'none';view_.textContent=shown?'Hide source':'View source';};
+  const copy=el('button','act ghost','Copy path');copy.onclick=e=>{e.stopPropagation();copyPath(f.path);};
+  btns.appendChild(view_);btns.appendChild(copy);box.appendChild(btns);box.appendChild(srcPane);
+  d.appendChild(box);
+  view.appendChild(d);
+}
+
+function overviewTasks(view){
+  document.getElementById('foot').textContent=
+    \`\${DATA.tasks.length} task namespaces · \${DATA.tasks.reduce((a,t)=>a+t.task_count,0)} tasks · run: task <namespace>:<name>\`;
+  view.appendChild(intro("The executable layer. Rules are enforced by Taskfile targets — deterministic gates the agent and CI run. Each card is a namespace; drill in for its commands."));
+  const grid=el('div','grid');
+  DATA.tasks.forEach(t=>{const card=el('div','card');
+    const nm=el('div','name');nm.appendChild(document.createTextNode(t.namespace));
+    if(t.unlisted)nm.appendChild(Object.assign(el('span','ic'),{textContent:'unlisted'}));
+    card.appendChild(nm);card.appendChild(el('div','desc',t.purpose||''));
+    const meta=el('div','meta');meta.appendChild(el('span','',t.task_count+' tasks'));card.appendChild(meta);
+    card.onclick=()=>go({label:t.namespace,render:v=>taskDetail(v,t)});grid.appendChild(card);});
+  view.appendChild(grid);
+}
+function taskDetail(view,t){
+  view.appendChild(intro(t.purpose||''));
+  view.appendChild(ghdr("Commands"));
+  const box=el('div','rows');
+  t.tasks.forEach(tk=>{const row=el('div','row');row.style.cursor='default';
+    const nm=el('div','rname');nm.appendChild(Object.assign(el('code'),{textContent:'task '+t.namespace+':'+tk.name}));
+    if(tk.desc)nm.appendChild(el('span','sub',tk.desc));row.appendChild(nm);box.appendChild(row);});
+  view.appendChild(box);
+  view.appendChild(pathBar(t.path));
+}
+function renderLifecycle(view){
+  const L=DATA.lifecycle;
+  document.getElementById('foot').textContent="Lifecycle & gates · source: "+L.source;
+  view.appendChild(intro(L.summary));
+  view.appendChild(ghdr("Rule strength — prefer enforceable over remembered"));
+  const lad=el('div','ladder');
+  L.rule_strength.forEach((r,i)=>{const lv=el('div','lv');lv.appendChild(Object.assign(el('b'),{textContent:(i+1)+". "+r.level}));lv.appendChild(el('span','d',r.detail));lad.appendChild(lv);});
+  view.appendChild(lad);
+  view.appendChild(ghdr("Scope lifecycle"));
+  const flow=el('div','flow');
+  L.scope_states.forEach((s,i)=>{if(i)flow.appendChild(el('div','arw','→'));
+    const n=el('div','node');n.appendChild(el('div','st',s.state));n.appendChild(el('div','via',s.via));flow.appendChild(n);});
+  view.appendChild(flow);
+  view.appendChild(ghdr("vBRIEF — the durable state"));
+  const box=el('div','rows');
+  L.vbrief_files.forEach(v=>{const row=el('div','row');row.style.cursor='default';
+    const nm=el('div','rname');nm.appendChild(Object.assign(el('code'),{textContent:v.file}));nm.appendChild(el('span','sub',v.role));row.appendChild(nm);box.appendChild(row);});
+  view.appendChild(box);
+  view.appendChild(ghdr("Quality gates"));
+  const g=el('div');g.style.marginBottom='14px';
+  L.gates.forEach(x=>{const p=el('span','pill');p.appendChild(Object.assign(el('code'),{textContent:x}));g.appendChild(p);});
+  view.appendChild(g);
+  view.appendChild(ghdr("Key docs"));
+  const kd=el('div','rows');
+  L.key_docs.forEach(doc=>{const row=el('div','row');row.style.cursor='default';
+    const nm=el('div','rname');nm.appendChild(document.createTextNode(doc.title));nm.appendChild(el('span','sub',doc.path));row.appendChild(nm);
+    const b=el('button','act ghost','Copy path');b.onclick=e=>{e.stopPropagation();copyPath(doc.path);};
+    const rt=el('div','rt');rt.appendChild(b);row.appendChild(rt);kd.appendChild(row);});
+  view.appendChild(kd);
+}
+function renderSearch(view){
+  const q=document.getElementById('q').value.trim().toLowerCase();
+  const hits=[];
+  const push=(label,sub,onclick,tag)=>hits.push({label,sub,onclick,tag});
+  DATA.groupings.forEach(g=>{
+    if((g.name+" "+g.purpose).toLowerCase().includes(q))
+      push(g.name,g.purpose,()=>{spine='rules';stack=[{label:g.name,render:v=>groupView(v,g)}];document.getElementById('q').value='';render();},"grouping");
+    g.items.forEach(it=>{
+      const scan=f=>{if((f.title+" "+f.name+" "+(f.summary||"")).toLowerCase().includes(q))
+        push(f.title||f.name,f.summary||g.name,()=>{spine='rules';stack=[{label:g.name,render:v=>groupView(v,g)},{label:f.name,render:v=>docDetail(v,f)}];document.getElementById('q').value='';render();},g.name);};
+      if(it.kind==='file')scan(it); else{if(it.readme)scan(it.readme);it.files.forEach(scan);}
+    });
+  });
+  DATA.tasks.forEach(t=>{
+    if((t.namespace+" "+t.purpose).toLowerCase().includes(q))
+      push("task "+t.namespace,t.purpose,()=>{spine='tasks';stack=[{label:t.namespace,render:v=>taskDetail(v,t)}];document.getElementById('q').value='';render();},"tasks");
+    t.tasks.forEach(tk=>{if((tk.name+" "+tk.desc).toLowerCase().includes(q))
+      push("task "+t.namespace+":"+tk.name,tk.desc,()=>{spine='tasks';stack=[{label:t.namespace,render:v=>taskDetail(v,t)}];document.getElementById('q').value='';render();},"task");});
+  });
+  document.getElementById('foot').textContent=hits.length+" matches";
+  if(!hits.length){view.appendChild(el('div','empty','No matches for "'+q+'"'));return;}
+  const box=el('div','rows');
+  hits.slice(0,120).forEach(h=>{const row=el('div','row');
+    const nm=el('div','rname');nm.appendChild(document.createTextNode(h.label));if(h.sub)nm.appendChild(el('span','sub',h.sub));row.appendChild(nm);
+    if(h.tag){const rt=el('div','rt');rt.appendChild(el('span','pill',h.tag));row.appendChild(rt);}
+    row.appendChild(el('span','chev','›'));row.onclick=h.onclick;box.appendChild(row);});
+  view.appendChild(box);
+}
+
+document.querySelectorAll('nav.spines button').forEach(b=>b.onclick=()=>reset(b.dataset.spine));
+const qEl=document.getElementById('q');
+qEl.addEventListener('input',render);
+qEl.addEventListener('keydown',e=>{if(e.key==='Escape'){qEl.value='';render();}});
+
+if(!DATA){document.getElementById('view').innerHTML='<div class="empty">No data embedded. Rebuild with <code>task docs:rule-map</code>.</div>';}
+else{document.getElementById('sub').textContent="Deft Directive · "+DATA.groupings.length+" rule groups · "+DATA.tasks.length+" task namespaces · maintainer map";render();}
+</script>
+</body>
+</html>
+`;
+//# sourceMappingURL=rule-map-template.js.map

package/dist/render/rule-map.d.ts

@@ -0,0 +1,2 @@
+export declare function main(argv: readonly string[]): number;
+//# sourceMappingURL=rule-map.d.ts.map