@erclx/canon 5.14.1 → 5.16.0

package/src/teach/nav.ts

@@ -10,6 +10,14 @@ import { FAVICON_COLORS, faviconLink, renderFavicon } from '@/design/favicon'
 import { stripFrontmatter } from '@/frontmatter'
 import { parseFrontmatter, readField } from '@/indexes/frontmatter'
 import { PROJECT_ROOT } from '@/project-root'
+import { compileScript } from '@/teach/browser/compile'
+import { dismiss } from '@/teach/browser/dismiss'
+import { focusLine } from '@/teach/browser/focus-line'
+import { glossaryFilter } from '@/teach/browser/glossary-filter'
+import { head } from '@/teach/browser/head'
+import { quiz } from '@/teach/browser/quiz'
+import { sidebar } from '@/teach/browser/sidebar'
+import { theme } from '@/teach/browser/theme'
 import { linkLessonReferences } from '@/teach/cross-references'
 import { TEACH_FONT_FACES } from '@/teach/fonts'
 import { LESSON_NUMBER } from '@/teach/lesson'
@@ -82,76 +90,6 @@ const CARET =
 const THEME_BUTTON =
   '<button class="theme" type="button" aria-label="Switch between light and dark"><svg class="sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg><svg class="moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg></button>'
 
-const THEME_SCRIPT =
-  '<script>(function(){var r=document.documentElement;try{var s=localStorage.getItem("course-theme");if(s)r.dataset.theme=s;}catch(e){}document.addEventListener("click",function(e){var b=e.target.closest(".theme");if(!b)return;var d=r.dataset.theme==="dark"||(!r.dataset.theme&&matchMedia("(prefers-color-scheme: dark)").matches);r.dataset.theme=d?"light":"dark";try{localStorage.setItem("course-theme",r.dataset.theme);}catch(e){}});})();</script>'
-
-const CLOSE_OUTSIDE_CLICK_SCRIPT = `<script>
-(function () {
-  var MENUS = "details.jump[open], details.sb-ws[open]";
-
-  function close(except) {
-    document.querySelectorAll(MENUS).forEach(function (d) {
-      if (d !== except) d.open = false;
-    });
-  }
-  document.addEventListener("click", function (e) {
-    var inside = e.target.closest("details.jump, details.sb-ws");
-    close(inside);
-  });
-  document.addEventListener("keydown", function (e) {
-    if (e.key !== "Escape") return;
-    var open = document.querySelector(MENUS);
-    if (!open) return;
-    open.open = false;
-    var s = open.querySelector("summary");
-    if (s) s.focus();
-  });
-
-  /* Hover intent on the breadcrumb only. The sidebar's workspace switcher stays
-     click-only on purpose: its panel opens directly over the lesson list, which
-     is where the pointer is headed, so hovering it would cover the thing
-     being reached for. The breadcrumb's panel drops over body text instead. */
-  var OPEN = 120, SHUT = 260;
-
-  document.querySelectorAll("details.jump").forEach(function (d) {
-    var host = d.closest(".crumb-item") || d;
-    var timer = null;
-    var openedByHover = false;
-
-    function arm(want) {
-      clearTimeout(timer);
-      timer = setTimeout(function () {
-        if (want) close(d);
-        d.open = want;
-      }, want ? OPEN : SHUT);
-    }
-
-    host.addEventListener("mouseenter", function () {
-      if (!d.open) openedByHover = true;
-      arm(true);
-    });
-    host.addEventListener("mouseleave", function () {
-      openedByHover = false;
-      arm(false);
-    });
-    /* Keeps it open while the pointer is inside the panel, without cancelling a
-       pending open, which is what silently disabled this on one of two menus. */
-    d.addEventListener("mouseenter", function () { if (d.open) clearTimeout(timer); });
-
-    /* Hover and click were wired to one disclosure and fought: hover opened the
-       panel, then the summary's native click toggled what hover had already
-       opened, so reaching for an item shut it. A click on a panel hover opened
-       keeps it open, and a second click closes. The click path stays live for
-       touch, where no hover exists, and for the keyboard, where Enter is the
-       only way in. */
-    var summary = d.querySelector("summary");
-    if (summary) summary.addEventListener("click", function (e) {
-      if (d.open && openedByHover) { e.preventDefault(); openedByHover = false; }
-    });
-  });
-})();
-</script>`
-
 /**
  * The stepper, as CSS over the radio inputs a lesson's quiz is written from.
  *
@@ -195,307 +133,6 @@ const QUIZ_CSS = `@supports selector(:has(*)) {
  */
 const LEGACY_OPTION = '<button class="opt"'
 
-/**
- * What reveals feedback in a lesson written against `LEGACY_OPTION`. The radio
- * shape needs none of it, so a lesson carrying no button option gets no script,
- * and removing this outright would leave the lessons already written showing no
- * feedback at all.
- */
-const QUIZ_SCRIPT =
-  '<script>document.querySelectorAll(".q").forEach(function(q){var f=q.querySelector(".fb");q.querySelectorAll(".opt").forEach(function(b){b.addEventListener("click",function(){if(f.classList.contains("show"))return;q.querySelectorAll(".opt").forEach(function(o){o.dataset.state=o.dataset.a==="1"?"right":(o===b?"chosen":"wrong");});f.classList.add("show");});});});</script>'
-
-const GLOSSARY_FILTER_SCRIPT = `<script>
-(function () {
-  var input = document.getElementById("gfilter");
-  var list = document.getElementById("gloss");
-  var count = document.getElementById("gloss-count");
-  if (!input || !list) return;
-  function updateGroups() {
-    list.querySelectorAll(".gloss-group").forEach(function (heading) {
-      var el = heading.nextElementSibling;
-      var any = false;
-      while (el && !el.classList.contains("gloss-group")) {
-        if (el.style.display !== "none") any = true;
-        el = el.nextElementSibling;
-      }
-      heading.style.display = any ? "" : "none";
-    });
-  }
-  input.addEventListener("input", function () {
-    var q = input.value.toLowerCase();
-    var n = 0;
-    list.querySelectorAll(".gterm").forEach(function (entry) {
-      var match = entry.textContent.toLowerCase().includes(q);
-      entry.style.display = match ? "" : "none";
-      if (match) n++;
-    });
-    list.classList.toggle("none", n === 0);
-    updateGroups();
-    if (count) {
-      var total = list.querySelectorAll(".gterm").length;
-      count.textContent = (n === total ? total : n + " of " + total) + (total === 1 ? " term" : " terms");
-    }
-  });
-  var clear = list.querySelector(".clear");
-  if (clear) {
-    clear.addEventListener("click", function () {
-      input.value = "";
-      input.dispatchEvent(new Event("input"));
-      input.focus();
-    });
-  }
-})();
-</script>`
-
-/**
- * The outline rail's focus-line ramp, as the JavaScript source `OUTLINE_SCRIPT`
- * embeds verbatim, so there is one copy of the formula rather than a TS
- * reimplementation that could drift from what a browser actually runs.
- *
- * It ramps the line from near the top at scroll 0 to the viewport's bottom
- * edge at max scroll, so the last heading is reachable regardless of how
- * little content trails it. The prior formula ended the ramp 120px short of
- * the edge, which left a heading followed by under 120px of trailing content
- * permanently unmarked, since its top never fell below the line even at max
- * scroll.
- */
-const FOCUS_LINE_BODY = `if (max <= 0) return innerHeight;
-    var progress = Math.min(1, Math.max(0, scrollY / max));
-    return 120 + progress * Math.max(0, innerHeight - 120);`
-
-/**
- * Compiles and runs `FOCUS_LINE_BODY`, so a test exercises the exact source
- * the browser runs rather than a parallel copy of it.
- */
-export function focusLine(
-  scrollY: number,
-  max: number,
-  innerHeight: number,
-): number {
-  const compiled = new Function(
-    'scrollY',
-    'max',
-    'innerHeight',
-    FOCUS_LINE_BODY,
-  ) as (scrollY: number, max: number, innerHeight: number) => number
-
-  return compiled(scrollY, max, innerHeight)
-}
-
-/**
- * The panel's state, settled before the first paint rather than after it. An
- * arm that set the narrow default afterwards slid the panel in and back out on
- * every load, and a restored custom width animated in from the default.
- *
- * A listing page starts shut because the body already lists what the panel
- * would, and a lesson starts open because there the panel is the only
- * cross-lesson navigation on the page. A stored preference beats both. A count
- * threshold on its own was built and reverted, since it hides the panel on a
- * lesson too.
- */
-function headScript(page: 'index' | 'lesson'): string {
-  return `<script>(function(){var r=document.documentElement,s=null;
-r.dataset.page="${page}";
-if(matchMedia("(max-width: ${TEACH_SIDEBAR_BREAKPOINT}px)").matches){r.classList.add("sb-shut");return}
-try{s=localStorage.getItem("teach-sb")}catch(e){}
-var idx=r.dataset.page==="index";
-if(s==="shut"||(s===null&&idx))r.classList.add("sb-shut");
-var w=null;try{w=localStorage.getItem("teach-sb-w")}catch(e){}
-if(w)r.style.setProperty("--sb-w",w+"px")})();</script>`
-}
-
-const SIDEBAR_SCRIPT = `<script>
-(function () {
-  var root = document.documentElement;
-  var panel = document.querySelector(".sb");
-  if (!panel) return;
-
-  var fold = document.querySelector(".sb-fold");
-  var narrow = matchMedia("(max-width: ${TEACH_SIDEBAR_BREAKPOINT}px)");
-
-  var FOCUSABLE = "a[href], button:not([disabled]), summary, input, [tabindex]:not([tabindex='-1'])";
-
-  function panelStops() {
-    return Array.prototype.slice.call(panel.querySelectorAll(FOCUSABLE))
-      .filter(function (el) { return el.offsetParent !== null || el === document.activeElement; });
-  }
-
-  /* The focus return belongs here rather than on the close control, because all
-     three routes out land here and only one of them used to move focus. The
-     shut panel takes visibility: hidden 180ms later, so a reader who pressed
-     Escape kept focus on a control that then disappeared under them and the
-     browser dropped them at the top of the document. */
-  function shut() {
-    var inside = panel.contains(document.activeElement);
-    root.classList.add("sb-shut");
-    try { localStorage.setItem("teach-sb", "shut"); } catch (e) {}
-    if (inside && fold) fold.focus();
-  }
-
-  if (fold) fold.addEventListener("click", function () {
-    root.classList.toggle("sb-shut");
-    try {
-      localStorage.setItem("teach-sb", root.classList.contains("sb-shut") ? "shut" : "open");
-    } catch (e) {}
-    /* An overlay takes focus with it. Without this a keyboard reader opens the
-       panel and goes on tabbing through the lesson behind the scrim. */
-    if (!narrow.matches || root.classList.contains("sb-shut")) return;
-    var first = panel.querySelector("a, button, summary, input");
-    if (first) first.focus();
-  });
-
-  var scrim = document.createElement("div");
-  scrim.className = "sb-scrim";
-  document.body.appendChild(scrim);
-  scrim.addEventListener("click", shut);
-
-  document.addEventListener("keydown", function (e) {
-    if (e.key === "Escape" && narrow.matches) { shut(); return; }
-
-    /* The scrim says the lesson is unavailable, so Tab must not reach it.
-       Moving focus into the panel on open only defers this by however many
-       controls the panel holds. */
-    if (e.key !== "Tab") return;
-    if (!narrow.matches || root.classList.contains("sb-shut")) return;
-
-    var stops = panelStops();
-    if (!stops.length) return;
-
-    var first = stops[0];
-    var last = stops[stops.length - 1];
-
-    if (!panel.contains(document.activeElement)) {
-      (e.shiftKey ? last : first).focus();
-      e.preventDefault();
-    } else if (e.shiftKey && document.activeElement === first) {
-      last.focus();
-      e.preventDefault();
-    } else if (!e.shiftKey && document.activeElement === last) {
-      first.focus();
-      e.preventDefault();
-    }
-  });
-
-  /* The panel covers the masthead and the toggle that opened it, so it carries
-     its own way out rather than leaving the scrim as the only route. */
-  var close = document.createElement("button");
-  close.type = "button";
-  close.className = "sb-close";
-  close.setAttribute("aria-label", "Close the course panel");
-  close.textContent = "\\u00d7";
-  close.addEventListener("click", shut);
-  panel.appendChild(close);
-
-  var MIN = 208, MAX = 296, DEF = 256;
-  var grip = document.querySelector(".sb-grip");
-  var lastWidth = parseInt(root.style.getPropertyValue("--sb-w"), 10) || DEF;
-
-  function setWidth(px, save) {
-    var w = Math.max(MIN, Math.min(MAX, Math.round(px)));
-    root.style.setProperty("--sb-w", w + "px");
-    lastWidth = w;
-    if (save) { try { localStorage.setItem("teach-sb-w", String(w)); } catch (e) {} }
-  }
-
-  if (grip) {
-    var dragging = false;
-    grip.addEventListener("pointerdown", function (e) {
-      dragging = true;
-      grip.setPointerCapture(e.pointerId);
-      root.classList.add("sb-drag");
-      e.preventDefault();
-    });
-    grip.addEventListener("pointermove", function (e) {
-      if (dragging) setWidth(e.clientX, false);
-    });
-    grip.addEventListener("pointerup", function (e) {
-      if (!dragging) return;
-      dragging = false;
-      root.classList.remove("sb-drag");
-      grip.releasePointerCapture(e.pointerId);
-      setWidth(lastWidth, true);
-    });
-    grip.addEventListener("dblclick", function () { setWidth(DEF, true); });
-    grip.addEventListener("keydown", function (e) {
-      var step = e.shiftKey ? 32 : 8;
-      if (e.key === "ArrowLeft") { setWidth(lastWidth - step, true); e.preventDefault(); }
-      else if (e.key === "ArrowRight") { setWidth(lastWidth + step, true); e.preventDefault(); }
-      else if (e.key === "Home") { setWidth(DEF, true); e.preventDefault(); }
-    });
-  }
-
-  var filter = document.querySelector(".sb-filter input");
-  if (filter) filter.addEventListener("input", function () {
-    var q = filter.value.trim().toLowerCase();
-    document.querySelectorAll(".sb-list > li").forEach(function (li) {
-      li.classList.toggle("hide", q !== "" && li.textContent.toLowerCase().indexOf(q) === -1);
-    });
-  });
-
-  var slot = document.querySelector(".sb-out-slot");
-  var hs = Array.prototype.slice.call(document.querySelectorAll("main h2"));
-  var links = [];
-
-  if (slot && hs.length) {
-    var list = document.createElement("ul");
-    list.className = "sb-out";
-    hs.forEach(function (h, i) {
-      if (!h.id) h.id = "s" + i;
-      var li = document.createElement("li");
-      var a = document.createElement("a");
-      a.href = "#" + h.id;
-      a.textContent = h.textContent.trim();
-      li.appendChild(a);
-      list.appendChild(li);
-    });
-    slot.parentNode.replaceChild(list, slot);
-    links = Array.prototype.slice.call(list.querySelectorAll("a"));
-  }
-
-  /* The bar reports position inside the lesson, which nothing reported before
-     the segmented track retired. The breadcrumb's last segment carries the
-     lesson title once the real one has scrolled off. */
-  var bar = document.querySelector(".bar");
-  var here = document.querySelector(".crumb-here");
-  var h1 = document.querySelector("main h1");
-  var counter = here ? here.textContent.trim() : "";
-  var title = h1 ? h1.textContent.trim() : "";
-
-  function focusLine() {
-    var max = document.documentElement.scrollHeight - innerHeight;
-    ${FOCUS_LINE_BODY}
-  }
-
-  function sync() {
-    if (bar) {
-      var max = document.documentElement.scrollHeight - innerHeight;
-      var pct = max > 0 ? Math.min(100, Math.max(0, (scrollY / max) * 100)) : 0;
-      bar.style.setProperty("--read", pct.toFixed(1) + "%");
-    }
-
-    if (here && h1 && title && counter) {
-      var want = h1.getBoundingClientRect().bottom < 56 ? title : counter;
-      if (here.textContent !== want) here.textContent = want;
-    }
-
-    if (links.length) {
-      /* Nothing is marked until a heading has actually passed the line, so the
-         first section is not reported as current while the title is on screen. */
-      var best = -1;
-      var line = focusLine();
-      for (var i = 0; i < hs.length; i++) {
-        if (hs[i].getBoundingClientRect().top <= line) best = i;
-      }
-      links.forEach(function (l, j) { l.classList.toggle("on", j === best); });
-    }
-  }
-
-  addEventListener("scroll", sync, { passive: true });
-  addEventListener("resize", sync);
-  sync();
-})();
-</script>`
-
 function escapeHtml(text: string): string {
   return text
     .replace(/&/g, '&amp;')
@@ -685,13 +322,21 @@ function renderHeader(
 </header>`
 }
 
+function headScript(page: 'index' | 'lesson'): string {
+  return compileScript(head, [page, TEACH_SIDEBAR_BREAKPOINT])
+}
+
 function renderScripts(
   includeQuiz: boolean,
   includeGlossaryFilter: boolean,
 ): string {
-  const scripts = [THEME_SCRIPT, CLOSE_OUTSIDE_CLICK_SCRIPT, SIDEBAR_SCRIPT]
-  if (includeGlossaryFilter) scripts.push(GLOSSARY_FILTER_SCRIPT)
-  if (includeQuiz) scripts.push(QUIZ_SCRIPT)
+  const scripts = [
+    compileScript(theme),
+    compileScript(dismiss),
+    compileScript(sidebar, [TEACH_SIDEBAR_BREAKPOINT], [focusLine]),
+  ]
+  if (includeGlossaryFilter) scripts.push(compileScript(glossaryFilter))
+  if (includeQuiz) scripts.push(compileScript(quiz))
   return scripts.join('\n')
 }
 

package/standards/architecture.md

@@ -40,7 +40,7 @@ The slots come from a scale test. Ask whether the decision would still be in thi
 - A decision that fills no slot. It lives in the domain context entry it constrains, and this file carries at most one line pointing at it.
 - A measurement paragraph specific to one domain's own mechanism, even behind a slot decision. Route it to that domain's context entry and keep the choice, the alternative that lost, and one reason here.
 - The instances of a build principle. The principle takes one sentence here, and each instance lives in the domain entry where it applies.
-- The history of how a decision was reached or revised: rounds of candidates, a figure followed by its correction, a branch or change that moved a number. That trail goes to the decision log or the change that introduced it.
+- The history of how a decision was reached or revised: rounds of candidates, a figure followed by its correction, a branch or change that moved a number. Cut it. Git and the change that introduced it keep the trail.
 
 ## Sections
 

package/standards/context.md

@@ -100,7 +100,7 @@ Only the `development` entry carries this section. It is not a general-purpose h
 - Anything already in `canon/REQUIREMENTS.md` or `canon/ARCHITECTURE.md`.
 - The history of how the domain reached its current shape. An entry describes the repository as it stands, so a change number, release label, or date attached to a change goes wherever the project tracks work.
 - A rejected alternative's provenance, which is the same rule at the one place the section above admits history. Keep what was tried and why it lost. Cut who tried it and when.
-- The route to a decision: the rounds of candidates, the tuning steps a threshold passed through, the review pass that caught a miss. State the decision, what lost, and why, once and in the present tense. The route goes to the decision log or the change that introduced it.
+- The route to a decision: the rounds of candidates, the tuning steps a threshold passed through, the review pass that caught a miss. State the decision, what lost, and why, once and in the present tense. Cut the route. Git and the change that introduced it keep it.
 - Measured results a generated file already carries. Point at the file instead of copying the figure, so a re-run cannot leave the entry behind.
 
 ## Length

package/standards/design.md

@@ -27,7 +27,7 @@ Does not govern:
 
 - CSS classes and prop names. Those live in code.
 - Anything that needs updating every time the code is refactored
-- The history of how a value or a mark was chosen: the candidates, the rounds, the date of a pick. State the rule and the current value. The trail goes to the decision log.
+- The history of how a value or a mark was chosen: the candidates, the rounds, the date of a pick. State the rule and the current value, and cut the trail. Git keeps it.
 
 ## Format
 

package/standards/index.md

@@ -12,7 +12,6 @@ Reference docs for consistent authoring across the toolkit and target projects.
 - [Branch reference](branch.md): Branch naming format and type conventions
 - [Commit reference](commit.md): Commit message format and type conventions
 - [Context entry reference](context.md): Shape and content rules for canon/context/<domain>.md entries
-- [Decisions reference](decisions.md): Folder layout, ordinal filename, frontmatter, record sections, and the append-only lifecycle for canon/decisions/
 - [Design reference](design.md): Shape and content rules for canon/DESIGN.md
 - [Diagram reference](diagrams.md): Shape and content rules for .canon/diagrams/<kind>.md files
 - [Docs reference](docs.md): Reader and jurisdiction, frontmatter, page structure, what a page links out to, the diagram permission, and when a category earns a subfolder

package/standards/requirements.md

@@ -9,7 +9,7 @@ Applies to `canon/REQUIREMENTS.md`. Describes what the product does and why, not
 
 ## Scope
 
-Governs the product-scope document at `canon/REQUIREMENTS.md`: problem, goals, non-goals, MVP features, distribution, stack, and constraints.
+Governs the product-scope document at `canon/REQUIREMENTS.md`: problem, goals, non-goals, MVP features, distribution, and constraints.
 
 Does not govern:
 
@@ -23,7 +23,6 @@ Does not govern:
 - User-facing goals stated as outcomes, not implementation
 - Explicit non-goals that prevent feature creep. Mark deferred items "(deferred)" so they read as paused, not excluded. A non-goal resting on how an outside tool, an installer, or the model behaves may close with one `Revisit when <finding>.` sentence, and a non-goal resting on scope alone takes none.
 - MVP features as a numbered list: feature name and one-line description
-- Tech stack as a plain list of tools
 - Hard constraints that shape every decision
 
 ## What does not go in
@@ -31,14 +30,15 @@ Does not govern:
 - Implementation details, API names, or internal component references
 - Anything that describes how a feature is built rather than what it does
 - Measured results, such as scores, benchmark figures, or token counts. They move on every run and this file changes least. Name where the results live instead.
+- Content another canonical doc owns, such as the stack list, which the stack-and-runtime slot of `canon/ARCHITECTURE.md` holds, or the rules of this standard itself
 
 ## Sections
 
-Use `## Problem`, `## Goals`, `## Non-goals`, `## MVP features`, `## Tech stack`, and `## Constraints`. Add `## Distribution` when the rule below applies. Add `## Premise` when the project exists to answer a question, stated as the question and what would count as an answer, never as the answer measured so far. Drop a section rather than pad it with filler.
+Use `## Problem`, `## Goals`, `## Non-goals`, `## MVP features`, and `## Constraints`. Add `## Distribution` when the rule below applies. Add `## Worldview` when the project holds beliefs that shape every decision, and keep a belief there only when it changes a decision, since a padded worldview turns into a second goals list. Add `## Premise` when the project exists to answer a question, stated as the question and what would count as an answer, never as the answer measured so far. Drop a section rather than pad it with filler.
 
 ## Lifecycle
 
-The MVP list is a historical record of the original scope. Once those features ship it stays as written. Do not renumber it, do not append to it, and do not annotate entries with status. A reader telling the original scope apart from what followed depends on the first one staying legible.
+Once every entry in the MVP list, or in a later scope section, has shipped, delete the section. Git keeps the old text, and the document states the project as it stands. Do not annotate an entry as shipped and leave it in place. While any entry is unshipped, do not renumber the list or append to it.
 
 Later scope arrives as a new section rather than as an extension of the MVP list. Name the section for what it delivers and state its entries as outcomes, the same way the goals are stated. Nothing sequences either list into versions. Work reaches the board as discrete tasks under `tasks.md`, and `board.md` orders them by readiness, so a section here states what is wanted and never when it lands.
 
@@ -65,7 +65,5 @@ State each entry as an outcome the consumer reaches, never as the mechanism that
 
 <!-- ## Distribution: include only when shipping outside the repository -->
 
-## Tech stack
-
 ## Constraints
 ```

package/standards/wireframes.md

@@ -76,11 +76,11 @@ Both fields feed `canon/wireframes/index.md` when regenerated.
 ## Not on this surface
 
 - State what was deliberately left off, one bullet per exclusion, as a present-tense rule: `- No navigation rail`. This is the section that stops a draft from proposing what was already ruled out.
-- Keep the reason to a clause where one is needed. The rounds that ruled it out go to the decision log.
+- Keep the reason to a clause where one is needed. Cut the rounds that ruled it out.
 
 ## What moves out
 
-- Which candidate beat which, and when: the decision log
+- Which candidate beat which, and when: nowhere. Cut it, since git keeps the old text
 - Measurements such as contrast ratios and timings: `canon/DESIGN.md` for tokens and floors, the surface's context entry for the rest
 
 ## What moves to canon/context/

package/tooling/claude/reference.md

@@ -14,7 +14,6 @@ canon/
 ├── ARCHITECTURE.md    ← seeded. Technical design decisions and open questions
 ├── DESIGN.md          ← seeded. Visual intent and the decisions behind it
 ├── context/           ← seeded. Per-domain narrative. `index.md` is the discovery anchor.
-├── decisions/         ← seeded. Decision history a canonical doc points at, never loaded eagerly. `<nn>-<slug>.md` records.
 └── wireframes/        ← seeded. Per-surface regions and states. `index.md` is the discovery anchor; `<surface>.md` files hold the regions list, the states table, and the behavior bullets.
 
 .claude/

package/tooling/claude/seeds/canon/REQUIREMENTS.md

@@ -13,6 +13,4 @@ Authoring guidance: the requirements standard.
 1. Feature: description
 2. Feature: description
 
-## Tech stack
-
 ## Constraints

package/governance/rules/canon/645-decisions.md

@@ -1,12 +0,0 @@
----
-description: Route canon/decisions/ edits to the decisions standard for record shape and lifecycle
-paths:
-  - 'canon/decisions/**'
-  - '.claude/decisions/**'
----
-
-# Decisions standards
-
-## Authority
-
-- Follow the decisions standard for folder layout, the ordinal filename, frontmatter, record sections, and the append-only lifecycle. It is the single source. Read it with `canon standards decisions`.

package/standards/decisions.md

@@ -1,105 +0,0 @@
----
-title: Decisions reference
-description: Folder layout, ordinal filename, frontmatter, record sections, and the append-only lifecycle for canon/decisions/
----
-
-# Decisions reference
-
-Applies to `canon/decisions/`. Holds the history a canonical doc used to carry itself: pick rounds, superseded figures, and a decision's rejected alternatives, in a tracked folder nothing loads eagerly. A canonical doc points at a record from its own history section rather than restating it.
-
-## Scope
-
-Governs `canon/decisions/`: folder layout, the ordinal filename, frontmatter, record sections, and the append-only lifecycle.
-
-Does not govern:
-
-- Which canonical doc points here and when, and what stays behind in that doc's own body: `architecture.md`, `context.md`, `wireframes.md`, `design.md`, `requirements.md`, once each states its own retirement rule
-- Voice, rhythm, and sentence construction: the `write-human` skill
-- Headings, punctuation, word choice, and file references: `markdown.md`
-
-## What a working record looks like
-
-A record works when a reader who has never opened the project can follow it from the file alone:
-
-- What was decided, stated once, without needing the canonical doc that points here
-- What else was considered, and why each alternative lost
-- Which claim rests on a measurement, and what commit that measurement was read against
-
-A record failing these is non-conforming even when it satisfies every shape rule below.
-
-## Folder name
-
-- `canon/decisions/`, resolved the way every tracked surface is: at `canon/decisions/` in a project that has moved, at `.claude/decisions/` in one that has not.
-- Never add `canon/decisions/index.md` to a `CLAUDE.md` `@` import. A log that loads eagerly rebuilds the bloat it exists to absorb. A canonical doc's own pointer is how a reader reaches a record, one file at a time.
-
-## Record filename
-
-- Name each record `<nn>-<slug>.md`, a two-digit zero-padded ordinal followed by a kebab-case slug, the same shape a groundwork track's folder takes.
-- The ordinal is the order the record was written in, which is what lets a listing sort by when a decision landed rather than alphabetically by subject.
-- Never renumber an existing record. A later reader cites it by that name, and a record whose number moved is a record a stale citation can no longer find.
-
-## Frontmatter
-
-- `title` (required): the decision in sentence case
-- `description` (required): one line naming what was decided
-
-## Sections
-
-Use `## Context`, `## Decision`, `## Alternatives`, `## Revisit when`, and `## Measurements`.
-
-- `## Context`: the problem as it stood, stated so a reader needs nothing else open. Restate a fact rather than pointing at where it was found.
-- `## Decision`: what was chosen, and why, in enough detail that a reader can tell it apart from an alternative that sounds similar.
-- `## Alternatives`: each one considered and dropped, with the reason it lost. An alternative with no stated reason reads as a claim nobody checked.
-- `## Revisit when`: one bullet per finding that would reopen the decision. Required when the record came from a groundwork track whose deciding leans carried "Overturned by" lines, which carry over as written. It is optional otherwise, for a decision resting on how an outside tool, an installer, or the model behaves. Skip it for a decision resting on the project's own code.
-- `## Measurements`: skip when the decision cites no number. When it does, state the number and close with the commit it was read against, per Verification anchors below.
-
-## Verification anchors
-
-A record's reasoning stays correct while the numbers it cites move. The anchor records what a measured claim was read against, so a reader can tell a number that was checked and held from one nobody has looked at since.
-
-- Close a `## Measurements` section with a trailing sentence naming the short commit SHA and the ISO date that number was read: `Measured at <short-sha> on <YYYY-MM-DD>.`
-- Anchor on the number alone. A record citing none carries no `## Measurements` section at all.
-- Read an absent section as unchecked rather than as current. A record with no measurements has nothing due a re-read.
-
-## Lifecycle
-
-- Append-only. A written record is never edited to reflect a later reversal.
-- Write a new record when a later decision supersedes an earlier one, naming the record it supersedes. The old record stays as it was written, since it is history rather than a live statement of the current shape.
-- Never auto-loaded. A canonical doc's own history section links to a record by relative path, and a reader reaches it by following that link, not by the folder loading with the session.
-
-## Citation
-
-- Never cite `.canon/`. A record restates what it needs, since a clone without the gitignored records folder resolves nothing there.
-- Cite a same-repository pull request or commit the way `publish.md` fixes for any tracked document.
-
-## Template
-
-```markdown
----
-title: <Decision, in sentence case>
-description: <one line naming what was decided>
----
-
-# <Decision title>
-
-## Context
-
-<The problem as it stood, self-contained.>
-
-## Decision
-
-<What was chosen, and why.>
-
-## Alternatives
-
-- **<Alternative>.** <Why it lost.>
-- **<Alternative>.** <Why it lost.>
-
-## Revisit when
-
-- <The finding that would reopen the decision.>
-
-## Measurements
-
-<The number the decision rests on.> Measured at <short-sha> on <YYYY-MM-DD>.
-```