@forwardimpact/libwiki 0.2.27 → 0.2.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libwiki",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "Wiki lifecycle primitives — stable memory for agent teams so coordination persists across sessions.",
   "keywords": [
     "wiki",

package/src/audit/rule-builders.js

@@ -0,0 +1,247 @@
+import {
+  ACTIVE_CLAIMS_HEADER_RE,
+  ACTIVE_CLAIMS_HEADING,
+  CARRY_CLEARANCE_MARKER_RE,
+  CARRY_SURFACE_H1_RE,
+  PRIORITY_INDEX_HEADING,
+  WEEKLY_LOG_SEAM_RE,
+} from "../constants.js";
+import {
+  PRIORITY_HEADER_RE,
+  SUMMARY_H1_RE,
+  WEEKLY_LOG_H1_RE,
+} from "./scopes.js";
+
+// Check builders and the derived matchers they share, extracted from rules.js
+// so the rule table stays under the per-file line cap. Each builder takes a
+// subject (plus optional ctx) and returns null | finding | finding[]. rules.js
+// imports exactly the symbols its rule table references; the pure constants in
+// constants.js/scopes.js it still imports straight from source.
+
+export const PRIORITY_INDEX_HEADING_RE = new RegExp(
+  `^${PRIORITY_INDEX_HEADING}$`,
+  "m",
+);
+const ACTIVE_CLAIMS_HEADING_RE = new RegExp(`^${ACTIVE_CLAIMS_HEADING}$`, "m");
+export const PRIORITY_SEPARATOR_RE =
+  /^\|\s*---\s*\|\s*---\s*\|\s*---\s*\|\s*---\s*\|\s*---\s*\|/m;
+export const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+
+// improvement-coach is the storyboard facilitator and carries no domain
+// metrics; only the five domain agents need their own H3.
+const STORYBOARD_DOMAIN_AGENTS = [
+  "product-manager",
+  "release-engineer",
+  "security-engineer",
+  "staff-engineer",
+  "technical-writer",
+];
+
+// -- Check builders: subject (+ ctx) → null | finding | finding[] --
+
+export const matches = (pattern) => (s) => (pattern.test(s.text) ? null : {});
+export const firstLineMatches = (pattern) => (s) =>
+  pattern.test(s.firstLine) ? null : {};
+export const containsLine = (needle) => (s) =>
+  s.fileLines.some((l) => l.trim() === needle) ? null : {};
+
+export const lineBudget = (limit) => (s) =>
+  s.lines > limit ? { value: s.lines } : null;
+export const wordBudget = (limit) => (s) =>
+  s.words > limit ? { value: s.words } : null;
+
+export const firstH2Is = (expected) => (s) =>
+  s.h2s.length === 0 || s.h2s[0] === expected ? null : { observed: s.h2s[0] };
+
+export const nothingAfterH2 = (marker) => (s) => {
+  const idx = s.h2s.indexOf(marker);
+  if (idx === -1) return null;
+  const after = s.h2s.slice(idx + 1);
+  return after.length === 0 ? null : after.map((h) => ({ observed: h }));
+};
+
+export const fieldMatches = (name, pattern) => (s) =>
+  pattern.test(s[name]) ? null : { value: s[name] };
+
+export const columnCount = (expected) => (s) =>
+  s.cells.length === expected ? null : { actual: s.cells.length, expected };
+
+export const exists = (s) => (s.exists ? null : {});
+export const expired = (s, ctx) => (s.expires_at < ctx.today ? {} : null);
+
+// The heading must equal `requiredLine` exactly — a suffixed variant like
+// "### Decision — <summary>" does not satisfy it, but is reported as a
+// near miss so the writer fixes the heading instead of hunting for a
+// "missing" line that is right there.
+function entryHasDecision(lines, startIdx, requiredLine, stopRe) {
+  let seen = 0;
+  let nearMiss = null;
+  for (let j = startIdx + 1; j < lines.length && seen < 5; j++) {
+    const ln = lines[j].trim();
+    if (ln === "") continue;
+    seen++;
+    if (ln === requiredLine) return { found: true };
+    if (nearMiss === null && ln.startsWith(requiredLine)) nearMiss = ln;
+    if (stopRe.test(lines[j])) break;
+  }
+  return { found: false, nearMiss };
+}
+
+export const decisionWithin5 =
+  ({ entryRe, requiredLine, stopRe }) =>
+  (s) => {
+    const offenders = [];
+    for (let i = 0; i < s.fileLines.length; i++) {
+      if (!entryRe.test(s.fileLines[i])) continue;
+      const res = entryHasDecision(s.fileLines, i, requiredLine, stopRe);
+      if (!res.found) offenders.push({ lineNo: i + 1, nearMiss: res.nearMiss });
+    }
+    return offenders.length === 0 ? null : offenders;
+  };
+
+// Flag entry-shaped `## ` headings that the rotation seam-finder would skip —
+// the grammar-drift that degrades a whole file to one unsplittable prologue and
+// is otherwise silent (the decision-block rule matches only dated headings).
+// Uses the same WEEKLY_LOG_SEAM_RE the seam-finder uses, so the flagged set is
+// exactly the complement of the rotatable set.
+export const headingGrammarDrift = (s) => {
+  const offenders = [];
+  for (let i = 0; i < s.fileLines.length; i++) {
+    const line = s.fileLines[i];
+    if (/^## /.test(line) && !WEEKLY_LOG_SEAM_RE.test(line)) {
+      offenders.push({ lineNo: i + 1, observed: line.trim() });
+    }
+  }
+  return offenders.length === 0 ? null : offenders;
+};
+
+function scanMarkers(fileLines, openRe, closeRe, label) {
+  const openings = [];
+  const findings = [];
+  for (let i = 0; i < fileLines.length; i++) {
+    const openMatch = fileLines[i].match(openRe);
+    if (openMatch) {
+      openings.push({ label: openMatch[1] || label, lineNo: i + 1 });
+    } else if (closeRe.test(fileLines[i])) {
+      if (openings.length > 0) openings.pop();
+      else findings.push({ lineNo: i + 1, reason: "unpaired-close" });
+    }
+  }
+  for (const open of openings) {
+    findings.push({
+      lineNo: open.lineNo,
+      reason: "dangling-open",
+      label: open.label,
+    });
+  }
+  return findings;
+}
+
+export const markersBalanced =
+  ({ openRe, closeRe, label }) =>
+  (s) => {
+    const findings = scanMarkers(s.fileLines, openRe, closeRe, label);
+    return findings.length === 0 ? null : findings;
+  };
+
+export const allRequiredLines = (required) => (s) => {
+  const findings = [];
+  for (const r of required) {
+    if (!s.fileLines.some((l) => r.pattern.test(l))) {
+      findings.push({ label: r.label });
+    }
+  }
+  return findings.length === 0 ? null : findings;
+};
+
+// -- H1 → filename agent prefix --
+
+const slugify = (title) =>
+  title
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/(^-|-$)/g, "");
+
+export const summaryAgentMismatch = (s) => {
+  const titleSlug = slugify(s.firstLine.match(SUMMARY_H1_RE)[1]);
+  return titleSlug === s.agentPrefix ? null : { titleSlug };
+};
+
+export const weeklyAgentMismatch = (s) => {
+  const m = s.firstLine.match(WEEKLY_LOG_H1_RE);
+  if (!m) return null;
+  const titleSlug = slugify(m[1]);
+  return titleSlug === s.agentPrefix ? null : { titleSlug };
+};
+
+// Carry surface: the H1 agent slug (`# <agent> — Carries`) must agree with the
+// filename prefix (`<agent>-carries.md`), the carry analogue of the summary /
+// weekly-log agreement rules. The H1 is the slug form already, so slugify is a
+// no-op for well-formed files; it normalises a stray capitalisation otherwise.
+export const carryAgentMismatch = (s) => {
+  const m = s.firstLine.match(CARRY_SURFACE_H1_RE);
+  if (!m) return null;
+  const titleSlug = slugify(m[1]);
+  return titleSlug === s.agentPrefix ? null : { titleSlug };
+};
+
+// Each Carry entry is an H3 block; every block must name a clearance trigger
+// (the `**Carry-clearance:**` marker). Walk the file's H3 boundaries and emit
+// one finding per block missing the marker — the finding[]-returning shape
+// `nothingAfterH2` uses.
+export const carryEntryHasClearance = (s) => {
+  const offenders = [];
+  let blockStart = -1;
+  let hasMarker = false;
+  const close = () => {
+    if (blockStart !== -1 && !hasMarker) {
+      offenders.push({ lineNo: blockStart + 1 });
+    }
+  };
+  for (let i = 0; i < s.fileLines.length; i++) {
+    const line = s.fileLines[i];
+    if (/^### /.test(line)) {
+      close();
+      blockStart = i;
+      hasMarker = false;
+    } else if (blockStart !== -1 && CARRY_CLEARANCE_MARKER_RE.test(line)) {
+      hasMarker = true;
+    }
+  }
+  close();
+  return offenders.length === 0 ? null : offenders;
+};
+
+export const AGENT_H3_REQUIREMENTS = STORYBOARD_DOMAIN_AGENTS.map((agent) => ({
+  label: agent,
+  pattern: new RegExp(`^### ${agent}(\\s|$|—|-)`),
+}));
+
+// -- Metrics CSV duplicate rows --
+
+// Report every data line byte-identical to an earlier data line in the same
+// CSV. Line 1 is the header (positionally) and blank lines are skipped; the
+// header is never a duplicate subject. Keying on exact line equality gives the
+// spec's exit path for free: any column edit (run id or note) on one row makes
+// the pair non-identical and stops the finding firing.
+export const duplicateCsvRows = (s) => {
+  const seen = new Set();
+  const findings = [];
+  s.rows.forEach((text, i) => {
+    const lineNo = i + 1;
+    if (lineNo === 1 || text.trim() === "") return;
+    if (seen.has(text)) findings.push({ lineNo });
+    else seen.add(text);
+  });
+  return findings.length === 0 ? null : findings;
+};
+
+export const memoryExists = (s) => s.exists;
+export const memoryHasPriorityHeader = (s) =>
+  s.exists && PRIORITY_HEADER_RE.test(s.text);
+export const memoryHasClaimsHeading = (s) =>
+  s.exists && ACTIVE_CLAIMS_HEADING_RE.test(s.text);
+export const memoryHasClaimsHeader = (s) =>
+  ACTIVE_CLAIMS_HEADER_RE.test(s.text);
+export const storyboardExists = (s) => s.exists;

package/src/audit/rules.js

@@ -1,8 +1,9 @@
 import {
   ACTIVE_CLAIMS_HEADER_RE,
-  ACTIVE_CLAIMS_HEADING,
   ACTIVE_CLAIMS_SEPARATOR_RE,
   ACTIVE_CLAIMS_TABLE_HEADER,
+  AGENT_EXPERIMENTS_CLOSE_RE,
+  AGENT_EXPERIMENTS_OPEN_RE,
   DECISION_HEADING,
   ISSUE_CLOSE_RE,
   ISSUE_OPEN_RE,
@@ -13,208 +14,45 @@ import {
   SUMMARY_LINE_BUDGET,
   SUMMARY_WORD_BUDGET,
   WEEKLY_LOG_LINE_BUDGET,
-  WEEKLY_LOG_SEAM_RE,
   WEEKLY_LOG_WORD_BUDGET,
   XMR_CLOSE_RE,
   XMR_OPEN_RE,
 } from "../constants.js";
-import {
-  PRIORITY_HEADER_RE,
-  SUMMARY_H1_RE,
-  WEEKLY_LOG_H1_RE,
-} from "./scopes.js";
 import { CONFLICT_MARKER_RULE } from "./conflict-markers-rule.js";
+import { PRIORITY_HEADER_RE, WEEKLY_LOG_H1_RE } from "./scopes.js";
+import {
+  AGENT_H3_REQUIREMENTS,
+  allRequiredLines,
+  carryAgentMismatch,
+  carryEntryHasClearance,
+  columnCount,
+  containsLine,
+  decisionWithin5,
+  duplicateCsvRows,
+  exists,
+  expired,
+  fieldMatches,
+  firstH2Is,
+  firstLineMatches,
+  headingGrammarDrift,
+  ISO_DATE_RE,
+  lineBudget,
+  markersBalanced,
+  matches,
+  memoryExists,
+  memoryHasClaimsHeading,
+  memoryHasClaimsHeader,
+  memoryHasPriorityHeader,
+  nothingAfterH2,
+  PRIORITY_INDEX_HEADING_RE,
+  PRIORITY_SEPARATOR_RE,
+  storyboardExists,
+  summaryAgentMismatch,
+  weeklyAgentMismatch,
+  wordBudget,
+} from "./rule-builders.js";
 import { STATUS_ROW_RULES } from "./status-row.js";
 
-const PRIORITY_INDEX_HEADING_RE = new RegExp(
-  `^${PRIORITY_INDEX_HEADING}$`,
-  "m",
-);
-const ACTIVE_CLAIMS_HEADING_RE = new RegExp(`^${ACTIVE_CLAIMS_HEADING}$`, "m");
-const PRIORITY_SEPARATOR_RE =
-  /^\|\s*---\s*\|\s*---\s*\|\s*---\s*\|\s*---\s*\|\s*---\s*\|/m;
-const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-
-// improvement-coach is the storyboard facilitator and carries no domain
-// metrics; only the five domain agents need their own H3.
-const STORYBOARD_DOMAIN_AGENTS = [
-  "product-manager",
-  "release-engineer",
-  "security-engineer",
-  "staff-engineer",
-  "technical-writer",
-];
-
-// -- Check builders: subject (+ ctx) → null | finding | finding[] --
-
-const matches = (pattern) => (s) => (pattern.test(s.text) ? null : {});
-const firstLineMatches = (pattern) => (s) =>
-  pattern.test(s.firstLine) ? null : {};
-const containsLine = (needle) => (s) =>
-  s.fileLines.some((l) => l.trim() === needle) ? null : {};
-
-const lineBudget = (limit) => (s) =>
-  s.lines > limit ? { value: s.lines } : null;
-const wordBudget = (limit) => (s) =>
-  s.words > limit ? { value: s.words } : null;
-
-const firstH2Is = (expected) => (s) =>
-  s.h2s.length === 0 || s.h2s[0] === expected ? null : { observed: s.h2s[0] };
-
-const nothingAfterH2 = (marker) => (s) => {
-  const idx = s.h2s.indexOf(marker);
-  if (idx === -1) return null;
-  const after = s.h2s.slice(idx + 1);
-  return after.length === 0 ? null : after.map((h) => ({ observed: h }));
-};
-
-const fieldMatches = (name, pattern) => (s) =>
-  pattern.test(s[name]) ? null : { value: s[name] };
-
-const columnCount = (expected) => (s) =>
-  s.cells.length === expected ? null : { actual: s.cells.length, expected };
-
-const exists = (s) => (s.exists ? null : {});
-const expired = (s, ctx) => (s.expires_at < ctx.today ? {} : null);
-
-// The heading must equal `requiredLine` exactly — a suffixed variant like
-// "### Decision — <summary>" does not satisfy it, but is reported as a
-// near miss so the writer fixes the heading instead of hunting for a
-// "missing" line that is right there.
-function entryHasDecision(lines, startIdx, requiredLine, stopRe) {
-  let seen = 0;
-  let nearMiss = null;
-  for (let j = startIdx + 1; j < lines.length && seen < 5; j++) {
-    const ln = lines[j].trim();
-    if (ln === "") continue;
-    seen++;
-    if (ln === requiredLine) return { found: true };
-    if (nearMiss === null && ln.startsWith(requiredLine)) nearMiss = ln;
-    if (stopRe.test(lines[j])) break;
-  }
-  return { found: false, nearMiss };
-}
-
-const decisionWithin5 =
-  ({ entryRe, requiredLine, stopRe }) =>
-  (s) => {
-    const offenders = [];
-    for (let i = 0; i < s.fileLines.length; i++) {
-      if (!entryRe.test(s.fileLines[i])) continue;
-      const res = entryHasDecision(s.fileLines, i, requiredLine, stopRe);
-      if (!res.found) offenders.push({ lineNo: i + 1, nearMiss: res.nearMiss });
-    }
-    return offenders.length === 0 ? null : offenders;
-  };
-
-// Flag entry-shaped `## ` headings that the rotation seam-finder would skip —
-// the grammar-drift that degrades a whole file to one unsplittable prologue and
-// is otherwise silent (the decision-block rule matches only dated headings).
-// Uses the same WEEKLY_LOG_SEAM_RE the seam-finder uses, so the flagged set is
-// exactly the complement of the rotatable set.
-const headingGrammarDrift = (s) => {
-  const offenders = [];
-  for (let i = 0; i < s.fileLines.length; i++) {
-    const line = s.fileLines[i];
-    if (/^## /.test(line) && !WEEKLY_LOG_SEAM_RE.test(line)) {
-      offenders.push({ lineNo: i + 1, observed: line.trim() });
-    }
-  }
-  return offenders.length === 0 ? null : offenders;
-};
-
-function scanMarkers(fileLines, openRe, closeRe, label) {
-  const openings = [];
-  const findings = [];
-  for (let i = 0; i < fileLines.length; i++) {
-    const openMatch = fileLines[i].match(openRe);
-    if (openMatch) {
-      openings.push({ label: openMatch[1] || label, lineNo: i + 1 });
-    } else if (closeRe.test(fileLines[i])) {
-      if (openings.length > 0) openings.pop();
-      else findings.push({ lineNo: i + 1, reason: "unpaired-close" });
-    }
-  }
-  for (const open of openings) {
-    findings.push({
-      lineNo: open.lineNo,
-      reason: "dangling-open",
-      label: open.label,
-    });
-  }
-  return findings;
-}
-
-const markersBalanced =
-  ({ openRe, closeRe, label }) =>
-  (s) => {
-    const findings = scanMarkers(s.fileLines, openRe, closeRe, label);
-    return findings.length === 0 ? null : findings;
-  };
-
-const allRequiredLines = (required) => (s) => {
-  const findings = [];
-  for (const r of required) {
-    if (!s.fileLines.some((l) => r.pattern.test(l))) {
-      findings.push({ label: r.label });
-    }
-  }
-  return findings.length === 0 ? null : findings;
-};
-
-// -- H1 → filename agent prefix --
-
-const slugify = (title) =>
-  title
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/(^-|-$)/g, "");
-
-const summaryAgentMismatch = (s) => {
-  const titleSlug = slugify(s.firstLine.match(SUMMARY_H1_RE)[1]);
-  return titleSlug === s.agentPrefix ? null : { titleSlug };
-};
-
-const weeklyAgentMismatch = (s) => {
-  const m = s.firstLine.match(WEEKLY_LOG_H1_RE);
-  if (!m) return null;
-  const titleSlug = slugify(m[1]);
-  return titleSlug === s.agentPrefix ? null : { titleSlug };
-};
-
-const AGENT_H3_REQUIREMENTS = STORYBOARD_DOMAIN_AGENTS.map((agent) => ({
-  label: agent,
-  pattern: new RegExp(`^### ${agent}(\\s|$|—|-)`),
-}));
-
-// -- Metrics CSV duplicate rows --
-
-// Report every data line byte-identical to an earlier data line in the same
-// CSV. Line 1 is the header (positionally) and blank lines are skipped; the
-// header is never a duplicate subject. Keying on exact line equality gives the
-// spec's exit path for free: any column edit (run id or note) on one row makes
-// the pair non-identical and stops the finding firing.
-const duplicateCsvRows = (s) => {
-  const seen = new Set();
-  const findings = [];
-  s.rows.forEach((text, i) => {
-    const lineNo = i + 1;
-    if (lineNo === 1 || text.trim() === "") return;
-    if (seen.has(text)) findings.push({ lineNo });
-    else seen.add(text);
-  });
-  return findings.length === 0 ? null : findings;
-};
-
-const memoryExists = (s) => s.exists;
-const memoryHasPriorityHeader = (s) =>
-  s.exists && PRIORITY_HEADER_RE.test(s.text);
-const memoryHasClaimsHeading = (s) =>
-  s.exists && ACTIVE_CLAIMS_HEADING_RE.test(s.text);
-const memoryHasClaimsHeader = (s) => ACTIVE_CLAIMS_HEADER_RE.test(s.text);
-const storyboardExists = (s) => s.exists;
-
 export const RULES = [
   // -- Summary files --
 
@@ -388,6 +226,30 @@ export const RULES = [
     hint: "rename either the H1 or the file so they agree",
   },
 
+  // -- Carry surfaces --
+  // No `h1-shape` rule: unlike the weekly logs (classified on filename alone),
+  // the carry classifier (scopes.js) requires the Carry H1 before assigning the
+  // scope, so a malformed-H1 file is left unclassified rather than reaching an
+  // h1-shape rule. The two rules below are the reachable, failable set (SC #2).
+
+  {
+    id: "carry-surface.h1-agent-matches-filename",
+    scope: "carry-surface",
+    severity: "fail",
+    check: carryAgentMismatch,
+    message: (s, r) =>
+      `H1 title slug '${r.titleSlug}' does not match filename prefix '${s.agentPrefix}'`,
+    hint: "rename either the H1 ('# <agent> — Carries') or the file so they agree",
+  },
+  {
+    id: "carry-surface.entry-has-clearance",
+    scope: "carry-surface",
+    severity: "fail",
+    check: carryEntryHasClearance,
+    message: () => "Carry entry lacks a '**Carry-clearance:**' trigger line",
+    hint: "every '### ' Carry entry must name its clearance trigger with a '**Carry-clearance:**' line so the surface stays enumerable at boot",
+  },
+
   // -- MEMORY.md --
 
   {
@@ -544,6 +406,20 @@ export const RULES = [
       `${r.reason} issue-list marker${r.label ? ` (${r.label})` : ""}`,
     hint: "every '<!-- obstacles:* -->' or '<!-- experiments:* -->' needs a matching close marker",
   },
+  {
+    id: "storyboard.markers-balanced.agent-experiments",
+    scope: "storyboard",
+    severity: "fail",
+    when: storyboardExists,
+    check: markersBalanced({
+      openRe: AGENT_EXPERIMENTS_OPEN_RE,
+      closeRe: AGENT_EXPERIMENTS_CLOSE_RE,
+      label: "agent-experiments",
+    }),
+    message: (_s, r) =>
+      `${r.reason} agent-experiments marker${r.label ? ` (${r.label})` : ""}`,
+    hint: "every '<!-- agent-experiments -->' needs a matching '<!-- /agent-experiments -->'",
+  },
 
   // -- Metrics CSVs (union merge keeps both sides on concurrent appends;
   // exact-duplicate rows are surfaced here, never silently removed) --

package/src/audit/scopes.js

@@ -4,6 +4,8 @@ import { parseClaims } from "../active-claims.js";
 import { countLines, countWords } from "../budget.js";
 import { parseStatusRowId } from "../status.js";
 import {
+  CARRY_SURFACE_H1_RE,
+  CARRY_SURFACE_NAME_RE,
   PRIORITY_INDEX_HEADING,
   WEEKLY_LOG_NAME_RE,
   WEEKLY_LOG_PART_NAME_RE,
@@ -75,6 +77,11 @@ function loadFile(filePath, fs) {
   const base = path.basename(filePath);
   const weekMatch =
     base.match(WEEKLY_LOG_NAME_RE) || base.match(WEEKLY_LOG_PART_NAME_RE);
+  const carryMatch = base.match(CARRY_SURFACE_NAME_RE);
+  let agentPrefix;
+  if (weekMatch) agentPrefix = weekMatch[1];
+  else if (carryMatch) agentPrefix = carryMatch[1];
+  else agentPrefix = base.replace(/\.md$/, "");
   return {
     path: filePath,
     text,
@@ -83,7 +90,7 @@ function loadFile(filePath, fs) {
     h2s,
     lines: countLines(text),
     words: countWords(text),
-    agentPrefix: weekMatch ? weekMatch[1] : base.replace(/\.md$/, ""),
+    agentPrefix,
   };
 }
 
@@ -101,6 +108,17 @@ function classifyFile(filePath, fs) {
     return { kind: "weekly-log-part", subject: loadFile(filePath, fs) };
   }
   const subject = loadFile(filePath, fs);
+  // Carry surface: a `<agent>-carries.md` whose H1 matches the Carry H1 RE.
+  // Both axes must match (filename prefix and H1), mirroring the summary
+  // classifier. The two H1 REs end in distinct literals (`— Carries` vs
+  // `— Summary`) so the branches cannot cross-capture regardless of order;
+  // a name-match + H1-miss is left unclassified, like a malformed summary.
+  if (CARRY_SURFACE_NAME_RE.test(base)) {
+    if (CARRY_SURFACE_H1_RE.test(subject.firstLine)) {
+      return { kind: "carry-surface", subject };
+    }
+    return null;
+  }
   // Files that do not match a summary or weekly-log shape are left
   // unclassified: stray files are not audited.
   if (!SUMMARY_H1_RE.test(subject.firstLine)) return null;
@@ -219,6 +237,7 @@ const SCOPE_RESOLVERS = {
   "weekly-log-main": (ctx) => ctx.subjects["weekly-log-main"],
   "weekly-log-part": (ctx) => ctx.subjects["weekly-log-part"],
   "metrics-csv": (ctx) => ctx.subjects["metrics-csv"],
+  "carry-surface": (ctx) => ctx.subjects["carry-surface"],
   memory: (ctx) => [ctx.memory],
   "claims-row": (ctx) =>
     parseClaims(ctx.memory.text).map((c) => ({ ...c, path: ctx.memory.path })),
@@ -322,6 +341,7 @@ export function buildContext({ wikiRoot, today, fs, subprocess }) {
     "weekly-log-main": [],
     "weekly-log-part": [],
     "metrics-csv": [],
+    "carry-surface": [],
   };
   for (const file of listMdFiles(wikiRoot, fs)) {
     const classified = classifyFile(file, fs);