@printpractical/cruze 0.0.13 → 0.0.15

package/dist/domain/architecture_sections.js

@@ -1,23 +0,0 @@
-                                     
-
-/** The `##` sections of architecture.md, in order, and the element kind each holds. */
-export const ARCHITECTURE_SECTIONS                                                      = [
-  { title: "Overview", kind: "VIEW" },
-  { title: "Bounded contexts", kind: "CTX" },
-  { title: "Domain model", kind: "ENT" },
-  { title: "Use cases", kind: "UC" },
-  { title: "Ports", kind: "PORT" },
-  { title: "Adapters", kind: "ADP" },
-  { title: "Flows", kind: "FLOW" },
-  { title: "Modules", kind: "MOD" },
-  { title: "Dependency rules", kind: "RULE" },
-  { title: "Cross-cutting concerns", kind: "XC" },
-  { title: "Decisions", kind: null },
-];
-
-export const ARCHITECTURE_KINDS                  = ["VIEW", "CTX", "ENT", "UC", "PORT", "ADP", "FLOW", "MOD", "RULE", "XC"];
-export const SPEC_KINDS                  = ["REQ", "SCN"];
-
-export function sectionForKind(kind      )                     {
-  return ARCHITECTURE_SECTIONS.find((section) => section.kind === kind)?.title;
-}

package/dist/domain/check/decision_comments.js

@@ -1,38 +0,0 @@
-import { findDecisionCitations,                       } from "../decision_citations.js";
-
-const HASH_COMMENTS = new Set(["py", "rb", "sh", "bash", "zsh", "pl", "r", "ex", "exs", "jl", "nim", "cr", "ps1"]);
-const DASH_COMMENTS = new Set(["sql", "lua", "hs", "elm", "ada"]);
-
-/**
- * Decisions a source file's comments cite by number, such as `(D22)` or `(events D23)`. Each work
- * item numbers its decisions from D1 and is archived when it finishes, so a number in code points
- * at nothing a reader can find.
- */
-export function decisionCitationsInComments(path        , text        )                     {
-  const comments = commentText(path, text.split("\n"));
-  return findDecisionCitations(comments, new Set());
-}
-
-/** Each line with everything but its comment blanked, so a citation's line number stays right. */
-function commentText(path        , lines          )           {
-  const extension = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
-  if (HASH_COMMENTS.has(extension)) return lines.map((line) => after(line, /(^|\s)#/));
-  if (DASH_COMMENTS.has(extension)) return lines.map((line) => after(line, /--/));
-  let inBlock = false;
-  return lines.map((line) => {
-    if (inBlock) {
-      if (line.includes("*/")) inBlock = false;
-      return line;
-    }
-    const open = line.indexOf("/*");
-    if (open !== -1 && !line.includes("*/", open + 2)) inBlock = true;
-    const slash = line.indexOf("//");
-    const start = [open, slash].filter((at) => at !== -1).sort((a, b) => a - b)[0];
-    return start === undefined ? "" : line.slice(start);
-  });
-}
-
-function after(line        , marker        )         {
-  const match = marker.exec(line);
-  return match === null ? "" : line.slice(match.index);
-}

package/dist/domain/decision_citations.js

@@ -1,62 +0,0 @@
-/**
- * Settled decisions are numbered `D<n>` within the document that records them: the architecture's
- * `## Decisions`, or one feature or change, which is archived when it finishes. A number cited
- * anywhere else either dangles or silently means another document's decision.
- */
-
-/** One citation of decisions by number, such as `D5`, `D5, D19` or `events D17`. */
-                                   
-                      
-               
-               
-                    
-                                                                             
-                     
- 
-
-const SLUG = "[a-z0-9]+(?:-[a-z0-9]+)*";
-const CITATION = new RegExp(`(?:(?<![\\w-])(${SLUG})\\s+)?(?<![\\w-])(D\\d+(?:\\s*(?:,|and)\\s*D\\d+)*)(?![\\w-])(?:\\s+of\\s+(${SLUG}))?`, "g");
-const DEFINITION = /^\s*- D(\d+):/;
-
-/**
- * Every citation of decisions by number in the lines given, skipping the `- D<n>:` that defines one
- * and anything inside backticks. `slugs` are the work items a citation may name.
- */
-export function findDecisionCitations(lines                   , slugs                     , skip                            = () => false)                     {
-  const citations                     = [];
-  lines.forEach((raw, line) => {
-    if (skip(line)) return;
-    const text = raw.replace(DEFINITION, (m) => " ".repeat(m.length)).replace(/`[^`]*`/g, (m) => " ".repeat(m.length));
-    for (const match of text.matchAll(CITATION)) {
-      const before = match[1] !== undefined && slugs.has(match[1]) ? match[1] : undefined;
-      const after = match[3] !== undefined && slugs.has(match[3]) ? match[3] : undefined;
-      const numbers = [...(match[2] ?? "").matchAll(/D(\d+)/g)].map((m) => Number(m[1]));
-      const qualifier = before ?? after;
-      const cited = qualifier === undefined ? (match[2] ?? "") : (match[0] ?? "").trim();
-      citations.push(qualifier === undefined ? { line, text: cited, numbers } : { line, text: cited, numbers, qualifier });
-    }
-  });
-  return citations;
-}
-
-/** The decisions a `## Decisions` section, or any lines, define as `- D<n>: ...`. */
-export function definedDecisions(lines                   )              {
-  return new Set(lines.flatMap((line) => {
-    const match = DEFINITION.exec(line);
-    return match?.[1] === undefined ? [] : [Number(match[1])];
-  }));
-}
-
-/**
- * The names a citation may give a work item: a feature's slug with and without its date, and a
- * change's folder name, such as `events`, `2026-10-08-events` and `02-links`.
- */
-export function workItemSlugs(folderNames                  )              {
-  const slugs = new Set        ();
-  for (const name of folderNames) {
-    slugs.add(name);
-    const undated = name.replace(/^\d{4}-\d{2}-\d{2}-/, "");
-    if (undated !== "") slugs.add(undated);
-  }
-  return slugs;
-}

package/dist/domain/edits/agents_file.js

@@ -1,58 +0,0 @@
-import { factsOf, statusOf } from "../elements.js";
-import { findSection, parseMarkdown } from "../markdown.js";
-                                                              
-
-/**
- * The managed sections of a project's `AGENTS.md`: its commands, from `.cruze/config.yaml`,
- * and its layout, from the built modules in `docs/architecture.md`.
- */
-
-const OPEN = "<!-- cruze:managed -->";
-const CLOSE = "<!-- /cruze:managed -->";
-
-/** Rewrites the managed blocks under `## Commands` and `## Layout`; other text is left alone. */
-export function renderAgentsFile(text        , view             )         {
-  let next = text;
-  const commands = Object.entries(view.config?.config?.commands ?? {});
-  if (commands.length > 0) next = replaceBlock(next, "Commands", commands.map(([name, command]) => `- ${name}: \`${command}\``));
-  const modules = builtModules(view);
-  if (modules.length > 0) next = replaceBlock(next, "Layout", ["Modules, from `docs/architecture.md`:", "", ...modules]);
-  return next;
-}
-
-/** The lines under `## Known pitfalls`, one per pitfall, which the feedback export carries back to Cruze. */
-export function knownPitfalls(text        )           {
-  const doc = parseMarkdown(text);
-  const range = findSection(doc, "Known pitfalls");
-  if (range === null) return [];
-  return doc.lines.slice(range.start, range.end).filter((line) => line.startsWith("- ")).map((line) => line.slice(2).trim());
-}
-
-/**
- * The modules whose code exists: those built, and those a land built before a rethink set them
- * back to `planned` for a change to rebuild, since their directories are still there.
- */
-function builtModules(view             )           {
-  const everBuilt = new Set(view.journal.filter((e) => e.event === "land").flatMap((e) => (Array.isArray(e["built"]) ? (e["built"]             ).map(String) : [])));
-  return [...view.living.elements.values()]
-    .filter(({ element, doc }) => element.kind === "MOD" && (statusOf(doc, element) === "built" || everBuilt.has(element.id)))
-    .map(({ element, doc }) => {
-      const facts = factsOf(doc, element);
-      const paths = (facts.get("Path") ?? []).flatMap((value) => [...value.matchAll(/`([^`]+)`/g)].map((m) => `\`${m[1] ?? ""}\``));
-      return `- ${paths.join(", ")} (${facts.get("Layer")?.[0] ?? "unknown"}): ${element.title}`;
-    })
-    .sort();
-}
-
-/** Replaces the body of the first managed block after `## <heading>`, before the next `## ` heading. */
-function replaceBlock(text        , heading        , body          )         {
-  const lines = text.split("\n");
-  const at = lines.findIndex((line) => line === `## ${heading}`);
-  if (at === -1) return text;
-  const sectionEnd = lines.findIndex((line, i) => i > at && line.startsWith("## "));
-  const end = sectionEnd === -1 ? lines.length : sectionEnd;
-  const open = lines.findIndex((line, i) => i > at && i < end && line.trim() === OPEN);
-  const close = lines.findIndex((line, i) => i > open && i < end && line.trim() === CLOSE);
-  if (open === -1 || close === -1) return text;
-  return [...lines.slice(0, open + 1), ...body, ...lines.slice(close)].join("\n");
-}

package/dist/domain/edits/managed_tables.js

@@ -1,60 +0,0 @@
-import { parseMarkdown } from "../markdown.js";
-import { splitRow, tablesIn } from "../markdown_tables.js";
-
-/**
- * Edits to the managed tables: the feature map in vision.md and the status table
- * in roadmap.md. Rows are keyed by their first cell.
- */
-
-/** Replaces or appends the row keyed by `cells[0]` in the table under a heading. */
-export function upsertRow(text        , heading        , cells          )         {
-  return editTable(text, heading, (rows) => {
-    const index = rows.findIndex((row) => row[0] === cells[0]);
-    if (index === -1) rows.push(cells);
-    else rows[index] = cells;
-  });
-}
-
-export function removeRow(text        , heading        , key        )                                             {
-  let removed                  = null;
-  const next = editTable(text, heading, (rows) => {
-    const index = rows.findIndex((row) => row[0] === key);
-    if (index !== -1) removed = rows.splice(index, 1)[0] ?? null;
-  });
-  return { text: next, removed };
-}
-
-export function readRows(text        , heading        )             {
-  const doc = parseMarkdown(text);
-  const at = doc.headings.find((h) => h.text === heading);
-  if (at === undefined) return [];
-  const end = doc.headings.find((h) => h.line > at.line && h.level <= at.level)?.line ?? doc.lines.length;
-  return tablesIn(doc.lines, doc.inFence, at.line + 1, end)[0]?.rows.map((row) => row.cells) ?? [];
-}
-
-function editTable(text        , heading        , edit                            )         {
-  const doc = parseMarkdown(text);
-  const at = doc.headings.find((h) => h.text === heading);
-  if (at === undefined) throw new Error(`No "${heading}" heading to edit`);
-  const end = doc.headings.find((h) => h.line > at.line && h.level <= at.level)?.line ?? doc.lines.length;
-  let first = -1;
-  let last = -1;
-  for (let i = at.line + 1; i < end; i++) {
-    if (/^\s*\|.*\|\s*$/.test(doc.lines[i] ?? "")) {
-      if (first === -1) first = i;
-      last = i;
-    } else if (first !== -1) break;
-  }
-  if (first === -1) throw new Error(`No table under "${heading}"`);
-  const header = splitRow(doc.lines[first] ?? "");
-  const rows = doc.lines.slice(first + 2, last + 1).map(splitRow);
-  edit(rows);
-  const rendered = [renderRow(header), renderRow(header.map(() => "---")), ...rows.map(renderRow)];
-  const lines = [...doc.lines];
-  lines.splice(first, last - first + 1, ...rendered);
-  return lines.join("\n");
-}
-
-function renderRow(cells          )         {
-  return `| ${cells.join(" | ")} |`;
-}

package/dist/domain/edits/progress_block.js

@@ -1,33 +0,0 @@
-import { MANAGED_CLOSE, MANAGED_OPEN, parseMarkdown } from "../markdown.js";
-import { readTasks } from "../project/plan_parts.js";
-import { progressRange, readProgress,               } from "../project/progress.js";
-
-/** Rewrites the managed `## Progress` block of a feature or change from a changed Progress. */
-export function updateProgress(text        , change                              )         {
-  const doc = parseMarkdown(text);
-  const progress = readProgress(doc);
-  for (const task of readTasks(doc).tasks) if (!progress.tasks.has(task.number)) progress.tasks.set(task.number, null);
-  change(progress);
-  const block = [MANAGED_OPEN, "## Progress", ...renderProgress(progress), MANAGED_CLOSE];
-  const range = progressRange(doc);
-  const lines = [...doc.lines];
-  if (range === null) {
-    while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-    return [...lines, "", ...block, ""].join("\n");
-  }
-  lines.splice(range.open, range.end - range.open + 1, ...block);
-  return lines.join("\n");
-}
-
-function renderProgress(progress          )           {
-  const lines           = [];
-  if (progress.branch !== undefined) lines.push(`- Branch: ${progress.branch}`);
-  for (const [change, state] of progress.changes) lines.push(`- ${change}: ${state}`);
-  const ordered = [...progress.tasks].sort(([a], [b]) => Number(a.slice(1)) - Number(b.slice(1)));
-  for (const [task, commit] of ordered) {
-    lines.push(commit === null ? `- [ ] ${task}` : commit === "" ? `- [x] ${task}` : `- [x] ${task} (${commit})`);
-  }
-  for (const deviation of progress.deviations) lines.push(`- Deviation ${deviation}`);
-  if (progress.landed !== undefined) lines.push(`- Landed: ${progress.landed}`);
-  return lines;
-}

package/dist/domain/edits/status_lines.js

@@ -1,52 +0,0 @@
-import { headingElements, isStatusLine, statusOf,             } from "../elements.js";
-import { STATUS_KINDS } from "../ids.js";
-import { parseMarkdown,                  } from "../markdown.js";
-
-/** Managed `- Status:` lines: only the CLI adds or changes them. */
-
-/** Sets one element's status, adding the line after its facts when it has none. Returns the new text. */
-export function setStatus(text        , id        , status        )         {
-  const doc = parseMarkdown(text);
-  const element = headingElements(doc).find((e) => e.id === id);
-  if (element === undefined) throw new Error(`${id} is not in this document`);
-  const lines = [...doc.lines];
-  const at = statusLineIndex(doc, element.start, element.end);
-  if (at !== null) lines[at] = `- Status: ${status}`;
-  else lines.splice(insertionPoint(doc, element.start, element.end), 0, `- Status: ${status}`);
-  return lines.join("\n");
-}
-
-/** Adds `- Status: planned` to every status-carrying element that has none. */
-export function stampMissingStatuses(text        )                                      {
-  let current = text;
-  const stamped           = [];
-  for (const element of headingElements(parseMarkdown(text))) {
-    if (!STATUS_KINDS.includes(element.kind)) continue;
-    const doc = parseMarkdown(current);
-    const fresh = headingElements(doc).find((e) => e.id === element.id);
-    if (fresh === undefined || statusOf(doc, fresh) !== undefined) continue;
-    current = setStatus(current, element.id, "planned");
-    stamped.push(element.id);
-  }
-  return { text: current, stamped };
-}
-
-function statusLineIndex(doc             , start        , end        )                {
-  for (let i = start + 1; i < end; i++) {
-    if (!doc.inFence[i] && /^#{1,6} /.test(doc.lines[i] ?? "")) return null;
-    if (!doc.inFence[i] && isStatusLine(doc.lines[i] ?? "")) return i;
-  }
-  return null;
-}
-
-/** After the element's last top-level fact or step, before any diagram or nested heading. */
-function insertionPoint(doc             , start        , end        )         {
-  let point = start + 1;
-  for (let i = start + 1; i < end; i++) {
-    const line = doc.lines[i] ?? "";
-    if (doc.inFence[i] || /^#{1,6} /.test(line)) break;
-    if (/^(- |\s{2,}- )/.test(line)) point = i + 1;
-    else if (line.trim() !== "" && point > start + 1) break;
-  }
-  return point;
-}

package/dist/domain/elements.js

@@ -1,126 +0,0 @@
-import { ID_PATTERN, STATUS_KINDS, kindOf,           } from "./ids.js";
-import { sectionEnd,                  } from "./markdown.js";
-
-                                                       
-                                         
-
-/** One element: a heading `<ID>: <Title>` and its body, or a table row whose first cell is an ID. */
-                          
-             
-             
-                
-                          
-                                                                                      
-               
-                
-                                                 
-                
-              
- 
-
-/** A delta heading that creates a spec file: `### ADDED CAPABILITY <name>: <Title>`. */
-                               
-                     
-                
-                
-              
- 
-
-const HEADING = new RegExp(`^(?:(ADDED|MODIFIED|REMOVED) )?(${ID_PATTERN}): (.+)$`);
-const CAPABILITY = /^ADDED CAPABILITY ([a-z0-9]+(?:-[a-z0-9]+)*): (.+)$/;
-const ROW = new RegExp(`^\\|\\s*(${ID_PATTERN})\\s*\\|(.*)\\|\\s*$`);
-const STATUS_LINE = /^- Status: (planned|built)\s*$/;
-
-/** Heading elements whose heading lies in [from, to). */
-export function headingElements(doc             , from = 0, to = doc.lines.length)            {
-  const elements            = [];
-  for (const heading of doc.headings) {
-    if (heading.line < from || heading.line >= to) continue;
-    const match = HEADING.exec(heading.text);
-    if (match?.[2] === undefined || match[3] === undefined) continue;
-    const element          = {
-      id: match[2],
-      kind: kindOf(match[2]),
-      title: match[3],
-      form: "heading",
-      level: heading.level,
-      start: heading.line,
-      end: Math.min(sectionEnd(doc, heading), to),
-    };
-    if (match[1] !== undefined) element.op = match[1]           ;
-    elements.push(element);
-  }
-  return elements;
-}
-
-export function capabilityOps(doc             , from = 0, to = doc.lines.length)                 {
-  return doc.headings
-    .filter((h) => h.line >= from && h.line < to)
-    .flatMap((heading) => {
-      const match = CAPABILITY.exec(heading.text);
-      if (match?.[1] === undefined || match[2] === undefined) return [];
-      return [{ capability: match[1], title: match[2], start: heading.line, end: Math.min(sectionEnd(doc, heading), to) }];
-    });
-}
-
-/** Row elements: table rows, outside code fences, whose first cell is an ID. */
-export function rowElements(doc             )            {
-  return doc.lines.flatMap((line, index) => {
-    if (doc.inFence[index]) return [];
-    const match = ROW.exec(line);
-    if (match?.[1] === undefined) return [];
-    const title = match[2]?.split("|")[0]?.trim() ?? "";
-    return [{ id: match[1], kind: kindOf(match[1]), title, form: "row"         , level: 0, start: index, end: index + 1 }];
-  });
-}
-
-export function elementLines(doc             , element                                )           {
-  return doc.lines.slice(element.start, element.end);
-}
-
-export function isStatusLine(line        )          {
-  return STATUS_LINE.test(line);
-}
-
-/** The element's own managed status: the first status line before any nested heading. */
-/**
- * Whether an element is still to be built: marked `planned`, or a kind that carries a status
- * but not stamped yet, because the document holding it has never been approved.
- */
-export function isUnbuilt(doc             , element         )          {
-  const status = statusOf(doc, element);
-  return status === "planned" || (status === undefined && STATUS_KINDS.includes(element.kind));
-}
-
-export function statusOf(doc             , element         )                     {
-  for (let i = element.start + 1; i < element.end; i++) {
-    if (/^#{1,6} /.test(doc.lines[i] ?? "") && !doc.inFence[i]) return undefined;
-    const match = STATUS_LINE.exec(doc.lines[i] ?? "");
-    if (match?.[1] !== undefined) return match[1]          ;
-  }
-  return undefined;
-}
-
-/**
- * The element's top-level facts: `- Key: value` items and their indented sub-items.
- * Nested elements' facts are excluded.
- */
-export function factsOf(doc             , element         )                        {
-  const facts = new Map                  ();
-  let current                  = null;
-  for (let i = element.start + 1; i < element.end; i++) {
-    const line = doc.lines[i] ?? "";
-    if (doc.inFence[i]) continue;
-    if (/^#{1,6} /.test(line)) break;
-    const fact = /^- ([A-Z][A-Za-z ]*): ?(.*)$/.exec(line);
-    if (fact?.[1] !== undefined) {
-      current = fact[2] === undefined || fact[2] === "" ? [] : [fact[2]];
-      facts.set(fact[1], current);
-      continue;
-    }
-    const sub = /^\s{2,}- (.+)$/.exec(line);
-    if (sub?.[1] !== undefined && current !== null) current.push(sub[1]);
-    else if (line.trim() !== "") current = null;
-  }
-  return facts;
-}

package/dist/domain/journal.js

@@ -1,109 +0,0 @@
-/** The append-only journal: one JSON object per line, written only by the CLI. */
-
-                               
-             
-                
-             
-                           
- 
-
-/** Events other tools and skills record, with the fields each requires. */
-export const RECORDED_EVENTS                           = {
-  rethink: ["level", "kind", "summary", "wrong", "found_by"],
-  disposition: ["finding", "disposition", "reason", "review"],
-  review: ["review", "round", "blockers", "concerns"],
-  override: ["gate", "reason"],
-  bug: ["summary", "cause"],
-  verification: ["result", "summary"],
-  checks: ["commit"],
-  lesson: ["summary", "instead", "step"],
-};
-
-/** Fields an event may carry beyond its required ones, checked when present. A defect rethink must say which step missed it. */
-const OPTIONAL_FIELDS                           = {
-  rethink: ["missed_by"],
-  review: ["nits", "checked_by"],
-  disposition: ["decided"],
-  verification: ["back_to", "commit"],
-};
-
-/** The workflow steps and checks that find or miss a problem, so a retro can count them. */
-export const STEPS = ["envision", "architect", "research", "design-review", "walkthrough", "plan", "plan-review", "build", "code-review", "verify", "land", "realign", "improve", "validate", "check", "user"];
-
-export const FIELD_VALUES                           = {
-  level: ["task", "detail", "change", "feature", "architecture", "vision"],
-  kind: ["defect", "discovery"],
-  disposition: ["fixed", "waived", "deferred", "rejected", "rethink"],
-  decided: ["agent", "user"],
-  review: ["design", "plan", "code", "realign", "improve"],
-  result: ["accepted", "sent-back"],
-  back_to: ["build", "rethink"],
-  checked_by: ["agent", "reviewer"],
-  found_by: STEPS,
-  missed_by: STEPS,
-  step: STEPS,
-};
-
-/** A defect rethink must say which step missed it, and a sent-back verification where the change goes back to. */
-function conditionallyRequired(event        , fields                        )           {
-  if (event === "rethink" && fields["kind"] === "defect") return ["missed_by"];
-  if (event === "verification" && fields["result"] === "sent-back") return ["back_to"];
-  return [];
-}
-
-const CONDITION_NOTES                         = { missed_by: " for a defect", back_to: " when the change is sent back" };
-
-/** Fields recorded as numbers rather than text. */
-const COUNT_FIELDS = ["round", "blockers", "concerns", "nits"];
-
-export function journalPath(folder        )         {
-  return `${folder}/journal.jsonl`;
-}
-
-export function parseJournal(text                    )                                                  {
-  const entries                 = [];
-  const badLines           = [];
-  (text ?? "").split("\n").forEach((line, index) => {
-    if (line.trim() === "") return;
-    try {
-      const entry = JSON.parse(line)                ;
-      if (typeof entry.event === "string" && typeof entry.at === "string") entries.push(entry);
-      else badLines.push(index + 1);
-    } catch {
-      badLines.push(index + 1);
-    }
-  });
-  return { entries, badLines };
-}
-
-export function serializeEntry(entry              )         {
-  return `${JSON.stringify(entry)}\n`;
-}
-
-/** Problems with an event a caller asks to record; empty when it can be recorded. */
-export function recordedEventProblems(event        , fields                        )           {
-  const required = RECORDED_EVENTS[event];
-  if (required === undefined) return [`unknown event "${event}"; recordable events: ${Object.keys(RECORDED_EVENTS).join(", ")}`];
-  const needed = [...required, ...conditionallyRequired(event, fields)];
-  const problems = needed.filter((field) => (fields[field] ?? "").trim() === "").map((field) => `${event} needs ${field}${CONDITION_NOTES[field] ?? ""}`);
-  const known = [...required, ...(OPTIONAL_FIELDS[event] ?? [])];
-  for (const field of known) {
-    const value = fields[field];
-    if (value === undefined) continue;
-    const allowed = FIELD_VALUES[field];
-    if (allowed !== undefined && !allowed.includes(value)) problems.push(`${field} must be one of ${allowed.join(", ")}`);
-    if (COUNT_FIELDS.includes(field) && !/^\d+$/.test(value)) problems.push(`${field} must be a whole number`);
-  }
-  if ((event === "checks" || event === "verification") && fields["commit"] !== undefined && !/^[0-9a-f]{7,40}$/.test(fields["commit"])) {
-    problems.push("commit must be a commit hash, such as the output of git rev-parse --short HEAD");
-  }
-  if (event === "disposition" && fields["decided"] === "agent" && fields["disposition"] !== "fixed") {
-    problems.push("the agent decides only fixes; the user waives, defers or rejects a finding (decided=user)");
-  }
-  return problems;
-}
-
-/** The fields as the journal stores them: counts become numbers. */
-export function recordedFields(fields                        )                                  {
-  return Object.fromEntries(Object.entries(fields).map(([key, value]) => [key, COUNT_FIELDS.includes(key) ? Number(value) : value]));
-}

package/dist/domain/land/bookkeeping.js

@@ -1,54 +0,0 @@
-import { removeRow, upsertRow } from "../edits/managed_tables.js";
-import { updateProgress } from "../edits/progress_block.js";
-import { parseMarkdown } from "../markdown.js";
-import { PATHS } from "../project/layout.js";
-import { readChangesTable } from "../project/plan_parts.js";
-import { readProgress } from "../project/progress.js";
-                                                              
-                                                         
-
-                              
-                                                                                              
-                    
-                                                           
-                                         
-                  
- 
-
-/** Records the land in progress blocks, the roadmap status and, when a feature finishes, the feature map. */
-export function applyBookkeeping(view             , change          , source          , landed        , files                     )              {
-  const text = (path        )                     => files.get(path) ?? view.snapshot.get(path);
-  files.set(change.path, updateProgress(text(change.path) ?? "", (progress) => (progress.landed = landed)));
-
-  let finished = true;
-  if (source !== change) {
-    const featureText = updateProgress(text(source.path) ?? "", (progress) => progress.changes.set(change.folderName, "landed"));
-    files.set(source.path, featureText);
-    const states = readProgress(parseMarkdown(featureText)).changes;
-    finished = readChangesTable(source.doc).every((row) => states.get(row.change) === "landed");
-  }
-
-  const release = releaseName(text(PATHS.roadmap));
-  const slug = typeof source.doc.frontmatter?.["roadmap"] === "string" ? source.doc.frontmatter["roadmap"] : undefined;
-  const roadmap = text(PATHS.roadmap);
-  if (slug !== undefined && roadmap !== undefined && roadmap.includes("## Status")) {
-    files.set(PATHS.roadmap, upsertRow(roadmap, "Status", [slug, source.folderName, finished ? "landed" : "building"]));
-  }
-  const vision = text(PATHS.vision);
-  if (finished && source.kind === "feature" && slug !== undefined && vision !== undefined && vision.includes("### Implemented")) {
-    const { text: withoutFuture, removed } = removeRow(vision, "Future", slug);
-    const summary = removed?.[1] ?? String(source.doc.frontmatter?.["title"] ?? slug);
-    files.set(PATHS.vision, upsertRow(withoutFuture, "Implemented", [slug, release, summary]));
-  }
-
-  const result              = { finished, release };
-  if (finished) result.archive = { from: source.folder, to: `${PATHS.archiveDir}/${source.folderName}` };
-  return result;
-}
-
-/** The release in progress: the roadmap's `## Release` line up to its colon. */
-export function releaseName(roadmap                    )         {
-  if (roadmap === undefined) return "unreleased";
-  const line = roadmap.split("## Release")[1]?.split("\n").find((l) => l.trim() !== "");
-  return line?.split(":")[0]?.trim() || "unreleased";
-}