@biffo/cli 0.224.3 → 0.225.0

package/dist/index.js

@@ -9168,6 +9168,7 @@ import { existsSync as existsSync31, readdirSync as readdirSync13, readFileSync
 import { join as join31 } from "path";
 var ADR_FILENAME = /^(\d{4})-.+\.md$/;
 var ALLOWLIST_FILENAME = ".numbering-allowlist";
+var TEMPLATE_ADR_RESERVED_UPTO = "0099";
 function readAdrNumberingAllowlist(adrDir) {
   const path = join31(adrDir, ALLOWLIST_FILENAME);
   if (!existsSync31(path)) return /* @__PURE__ */ new Set();
@@ -9199,10 +9200,24 @@ function findAdrNumberCollisions(adrDir) {
   }
   return collisions;
 }
-function findStaleAdrNumberingAllowlistEntries(adrDir) {
+function findAdrReservedRangeViolations(adrDir, reservedUpTo = TEMPLATE_ADR_RESERVED_UPTO) {
+  const allowlist = readAdrNumberingAllowlist(adrDir);
+  const violations = [];
+  for (const [number, files] of [...adrNumbersIn(adrDir).entries()].sort()) {
+    if (number > reservedUpTo || allowlist.has(number)) continue;
+    for (const file of files) violations.push({ number, file });
+  }
+  return violations;
+}
+function findStaleAdrNumberingAllowlistEntries(adrDir, options = {}) {
   const allowlist = readAdrNumberingAllowlist(adrDir);
   const claims = adrNumbersIn(adrDir);
-  return [...allowlist].filter((number) => (claims.get(number)?.length ?? 0) < 2).sort();
+  return [...allowlist].filter((number) => {
+    const count = claims.get(number)?.length ?? 0;
+    const stillColliding = count >= 2;
+    const stillInReservedRange = options.isInstance === true && count >= 1 && number <= (options.reservedUpTo ?? TEMPLATE_ADR_RESERVED_UPTO);
+    return !stillColliding && !stillInReservedRange;
+  }).sort();
 }
 function formatAdrNumberCollisions(collisions) {
   return collisions.map(
@@ -9211,6 +9226,12 @@ function formatAdrNumberCollisions(collisions) {
     ambiguous while both exist.`
   ).join("\n");
 }
+function formatAdrReservedRangeViolations(violations, reservedUpTo = TEMPLATE_ADR_RESERVED_UPTO) {
+  return violations.map(
+    (v) => `  ${v.file} claims ADR-${v.number}, inside 0001-${reservedUpTo} \u2014 reserved for the template's own series.
+    Renumber it above ADR-${reservedUpTo}, or if it is meant to be there (e.g. inherited at biffo init), list ${v.number} in docs/ADR/${ALLOWLIST_FILENAME}.`
+  ).join("\n");
+}
 
 // src/scripts/check-adr-numbering.ts
 async function runAdrNumberingCheck() {
@@ -9220,8 +9241,10 @@ async function runAdrNumberingCheck() {
     console.log("\u2713 ADR numbering guard: no docs/ADR/ directory \u2014 nothing to compare");
     return;
   }
+  const instance = isInstanceRepo(root);
   const collisions = findAdrNumberCollisions(adrDir);
-  const stale = findStaleAdrNumberingAllowlistEntries(adrDir);
+  const reservedRangeViolations = instance ? findAdrReservedRangeViolations(adrDir) : [];
+  const stale = findStaleAdrNumberingAllowlistEntries(adrDir, { isInstance: instance });
   let failed = false;
   if (collisions.length > 0) {
     failed = true;
@@ -9232,10 +9255,18 @@ async function runAdrNumberingCheck() {
 Already accepted? List it in docs/ADR/${ALLOWLIST_FILENAME} instead of leaving this red forever. See tabsii-platform#449 for how this class of collision happens.`
     );
   }
+  if (reservedRangeViolations.length > 0) {
+    failed = true;
+    console.error(
+      "\u2717 ADR numbering guard: docs/ADR/ has an ADR inside the template's reserved range\n"
+    );
+    console.error(formatAdrReservedRangeViolations(reservedRangeViolations));
+    console.error("\nSee #1105 for why this range is reserved.");
+  }
   if (stale.length > 0) {
     failed = true;
     console.error(
-      `\u2717 ADR numbering guard: docs/ADR/${ALLOWLIST_FILENAME} names a number that no longer collides: ${stale.join(", ")}
+      `\u2717 ADR numbering guard: docs/ADR/${ALLOWLIST_FILENAME} names a number that neither check needs any more: ${stale.join(", ")}
   Remove the stale entry \u2014 an allowlist nothing checks against just hides the next real one.`
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biffo/cli",
-  "version": "0.224.3",
+  "version": "0.225.0",
   "description": "Biffo project scaffolding CLI",
   "license": "MIT",
   "type": "module",