@printpractical/cruze 0.0.9 → 0.0.10

package/src/domain/validation/vision_rules.ts

@@ -0,0 +1,41 @@
+import { rowElements } from "../elements.ts";
+import { findSection } from "../markdown.ts";
+import { splitRow } from "../markdown_tables.ts";
+import { PATHS } from "../project/layout.ts";
+import type { ProjectView } from "../project/project_view.ts";
+import { error, type Problem } from "./problem.ts";
+
+/** The section and the cells after the ID that each long-term row of the vision holds. */
+const INTENT_ROWS: Record<string, { section: string; cells: string[] }> = {
+  PRINCIPLE: { section: "Principles", cells: ["Principle", "Why"] },
+  LATER: { section: "Must stay possible", cells: ["Capability", "Likelihood", "Why", "Leave room for"] },
+};
+
+export const LIKELIHOODS = ["likely", "possible"];
+
+/**
+ * The vision's principles and the capabilities that must stay possible are rows, so designs cite
+ * them and approvals pin them. One project kept its principles in a seed note and its long-term
+ * plans in the user's head: a feature reversed a principle unnoticed, and a later review proposed
+ * removing what those plans needed.
+ */
+export function visionProblems(view: ProjectView): Problem[] {
+  const doc = view.living.docs.get(PATHS.vision);
+  if (doc === undefined) return [];
+  return rowElements(doc).flatMap((row) => {
+    const shape = INTENT_ROWS[row.kind];
+    if (shape === undefined) return [];
+    const section = findSection(doc, shape.section);
+    if (section === null || row.start < section.start || row.start >= section.end) {
+      return [error(PATHS.vision, row.start, "vision-row", `${row.id} belongs in the table under ## ${shape.section}`)];
+    }
+    const cells = splitRow(doc.lines[row.start] ?? "").slice(1);
+    if (cells.length !== shape.cells.length || cells.some((cell) => cell === "")) {
+      return [error(PATHS.vision, row.start, "vision-row", `${row.id} needs ${shape.cells.join(", ")}, each filled`)];
+    }
+    if (row.kind === "LATER" && !LIKELIHOODS.includes(cells[1] ?? "")) {
+      return [error(PATHS.vision, row.start, "vision-row", `${row.id}'s likelihood must be ${LIKELIHOODS.join(" or ")}`)];
+    }
+    return [];
+  });
+}

package/src/domain/versions/rule_versions.ts

@@ -17,6 +17,9 @@ export const RULE_SINCE: Record<string, string> = {
   "validate:change-too-large": "0.0.5",
   "validate:plan-too-large": "0.0.5",
   "validate:module-path-glob": "0.0.8",
+  "validate:decision-citation": "0.0.10",
+  "check:decision-citation": "0.0.10",
+  "validate:future-unanchored": "0.0.10",
 };
 
 /** Whether a rule arrived after the version the project's code meets, so it waits for `realign`. */

package/templates/init/AGENTS.md

@@ -25,4 +25,4 @@ Not defined yet. `cruze land` fills this in from the module map in `docs/archite
 
 ## Known pitfalls
 
-None recorded yet. `land` adds a line here when the same review finding or defect happens twice.
+None recorded yet. `land` adds a line here when the same review finding or defect about this project's code happens twice.