@inixiative/config 0.5.61 → 0.5.63

package/README.md

@@ -65,7 +65,7 @@ TypeScript 6.0 notes, discovered by this repo's fixture suite:
 bunx @inixiative/config check [dir] [--preset=base|node|react]
 bunx @inixiative/config sync  [dir] [--preset=...] [--force] [--no-install]
 bunx @inixiative/config scan  [root] [--lane=primitives|agentic]
-bunx @inixiative/config train [root] [--lane=primitives|agentic] [--push]
+bunx @inixiative/config train [root] [--lane=primitives|agentic] [--push] [--dry-run]
 bunx @inixiative/config ports [project]
 ```
 
@@ -83,7 +83,9 @@ Lanes stand alone. A lane with a package missing a checkout, or claimed by ambig
 
 Consumers run once, after every selected lane, upstreams first, against the full blessed set: a consumer of both lanes ends coherent with both whichever lane ran. They get the same bump → re-lock → `check`, never a publish, and their changes go through review: the train commits them on a `train/ecosystem-sync-<date>` branch and leaves the checkout there until it is merged.
 
-When anything was blessed it then ships this package last, so the BOM names the new state: bumps its own patch version if npm already has the current one, blesses that version in the BOM, brings the `test/fixtures` consumers onto the blessed set, runs `check`, commits, publishes. Then every checkout the train re-locked (lane packages on their default branch, consumers on their review branch) is re-locked onto that new `@inixiative/config` and committed, so none is left pinning the previous release. It never pushes unless asked: pass `--push` to push every repo it committed to and open a PR for each consumer branch; otherwise it prints the commands.
+When anything was blessed it then ships this package last, so the BOM names the new state: bumps its own patch version if npm already has the current one, blesses that version in the BOM, brings the `test/fixtures` consumers onto the blessed set, runs `check`, commits, publishes. Then every checkout the train re-locked (lane packages on their default branch, consumers on their review branch) is re-locked onto that new `@inixiative/config` and committed, so none is left pinning the previous release. It never pushes unless asked: pass `--push` to push every repo it committed to and open a PR for each consumer branch; otherwise it prints the commands. `--dry-run` walks the same plan and prints each step it would take (range rewrites, re-locks and checks, commits, review branches, publishes, BOM blessings, pushes) without running any of them; it only fetches and reads git state and `npm view`.
+
+Each command accepts only its own flags. An unknown or misplaced flag (`--dryrun`, `--push` on `sync`) is a usage error and exits 2 before anything runs.
 
 Division of labor: this CLI owns the toolchain set, ecosystem coherence, stubs, and lockfile format. Renovate owns everything else plus bumping `@inixiative/config` itself, and must be fenced off the toolchain packages.
 

package/dist/cli.js

@@ -6,6 +6,9 @@ import { existsSync as existsSync2, mkdtempSync, readdirSync as readdirSync2, re
 import { tmpdir } from "os";
 import { dirname as dirname2, join as join2, resolve as resolve2 } from "path";
 
+// src/args.ts
+import { parseArgs } from "util";
+
 // src/lib.ts
 import { spawnSync } from "child_process";
 import {
@@ -22,13 +25,13 @@ import { fileURLToPath } from "url";
 var packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
 var LANES = ["primitives", "agentic"];
 var isLane = (value) => LANES.includes(value);
-var lanePackages = (manifest2, lane) => {
-  const section = lane === "primitives" ? manifest2.ecosystem : manifest2.agentic ?? {};
+var lanePackages = (manifest2, lane2) => {
+  const section = lane2 === "primitives" ? manifest2.ecosystem : manifest2.agentic ?? {};
   const { "@inixiative/config": _config, ...packages } = section;
   return packages;
 };
-var laneSection = (manifest2, lane) => {
-  if (lane === "primitives") return manifest2.ecosystem;
+var laneSection = (manifest2, lane2) => {
+  if (lane2 === "primitives") return manifest2.ecosystem;
   manifest2.agentic ??= {};
   return manifest2.agentic;
 };
@@ -38,7 +41,7 @@ var blessedVersions = (manifest2) => ({
 });
 var consumersFor = (manifest2, lanes2) => {
   const consumers = manifest2.consumers ?? {};
-  const selected = Object.keys(consumers).filter((repo) => consumers[repo].lanes.some((lane) => lanes2.includes(lane))).sort();
+  const selected = Object.keys(consumers).filter((repo) => consumers[repo].lanes.some((lane2) => lanes2.includes(lane2))).sort();
   const order = [];
   const visit = (repo, trail) => {
     if (order.includes(repo)) return;
@@ -211,8 +214,8 @@ var candidateDirs = (root) => {
 };
 var discover = (root, manifest2, lanes2 = LANES) => {
   const wanted = /* @__PURE__ */ new Map();
-  for (const lane of lanes2) {
-    for (const name of Object.keys(lanePackages(manifest2, lane))) wanted.set(name, lane);
+  for (const lane2 of lanes2) {
+    for (const name of Object.keys(lanePackages(manifest2, lane2))) wanted.set(name, lane2);
   }
   const consumerRepos = new Set(consumersFor(manifest2, lanes2));
   const claims = /* @__PURE__ */ new Map();
@@ -328,11 +331,11 @@ var trainPlan = (root, manifest2, lanes2 = LANES) => {
     )
   );
   return {
-    lanes: LANES.filter((lane) => lanes2.includes(lane)).map((lane) => {
-      const names = new Set(Object.keys(lanePackages(manifest2, lane)));
-      const own = checkouts.filter((checkout) => checkout.lane === lane);
+    lanes: LANES.filter((lane2) => lanes2.includes(lane2)).map((lane2) => {
+      const names = new Set(Object.keys(lanePackages(manifest2, lane2)));
+      const own = checkouts.filter((checkout) => checkout.lane === lane2);
       return {
-        lane,
+        lane: lane2,
         checkouts: topoOrder(own),
         missing: [...names].filter(
           (name) => !own.some((checkout) => checkout.packages.some((entry) => entry.name === name)) && !ambiguous.some((entry) => entry.key === name)
@@ -729,8 +732,8 @@ function inspect(dir2, manifest2, presetOverride) {
       }
     }
   }
-  const preset = detectPreset(pkg, presetOverride);
-  const tsconfigTarget = `@inixiative/config/tsconfig/${preset}.json`;
+  const preset2 = detectPreset(pkg, presetOverride);
+  const tsconfigTarget = `@inixiative/config/tsconfig/${preset2}.json`;
   const tsconfigPath = join(dir2, "tsconfig.json");
   if (!existsSync(tsconfigPath)) {
     findings.push({
@@ -758,7 +761,7 @@ function inspect(dir2, manifest2, presetOverride) {
       });
     }
   }
-  const biomeTargets = preset === "react" ? ["@inixiative/config/biome/base.json", "@inixiative/config/biome/react.json"] : ["@inixiative/config/biome/base.json"];
+  const biomeTargets = preset2 === "react" ? ["@inixiative/config/biome/base.json", "@inixiative/config/biome/react.json"] : ["@inixiative/config/biome/base.json"];
   const biomePath = join(dir2, "biome.json");
   if (!existsSync(biomePath)) {
     findings.push({
@@ -804,6 +807,58 @@ function inspect(dir2, manifest2, presetOverride) {
   };
 }
 
+// src/args.ts
+var COMMANDS = ["check", "sync", "scan", "train", "ports"];
+var PRESETS = ["base", "node", "react"];
+var preset = { type: "string" };
+var lane = { type: "string" };
+var flag = { type: "boolean", default: false };
+var OPTIONS = {
+  check: { preset },
+  sync: { preset, force: flag, "no-install": flag },
+  scan: { lane },
+  train: { lane, push: flag, "dry-run": flag },
+  ports: {}
+};
+var UsageError = class extends Error {
+};
+var isCommand = (value) => COMMANDS.includes(value);
+var parseCommandLine = (argv) => {
+  const command2 = argv[0];
+  if (!isCommand(command2)) throw new UsageError(`unknown command: ${command2 ?? "(none)"}`);
+  let values;
+  let positionals2;
+  try {
+    const options = OPTIONS[command2];
+    ({ values, positionals: positionals2 } = parseArgs({
+      args: argv.slice(1),
+      options,
+      allowPositionals: true,
+      strict: true
+    }));
+  } catch (error) {
+    throw new UsageError(`${command2}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  const presetValue = values.preset;
+  if (typeof presetValue === "string" && !PRESETS.includes(presetValue)) {
+    throw new UsageError(`unknown preset: ${presetValue}`);
+  }
+  const laneValue = values.lane;
+  if (typeof laneValue === "string" && !isLane(laneValue)) {
+    throw new UsageError(`unknown lane: ${laneValue}`);
+  }
+  return {
+    command: command2,
+    positionals: positionals2,
+    preset: typeof presetValue === "string" ? presetValue : void 0,
+    lane: typeof laneValue === "string" && isLane(laneValue) ? laneValue : void 0,
+    force: values.force === true,
+    noInstall: values["no-install"] === true,
+    push: values.push === true,
+    dryRun: values["dry-run"] === true
+  };
+};
+
 // ports.json
 var ports_default = {
   $comment: "Local port registry. A project's port for a service is the service's default plus 100 times the project's block, so projects never collide and none uses a default. Add a project at the next free block; add a service with its usual default.",
@@ -847,32 +902,32 @@ function portsFor(project) {
 }
 
 // src/cli.ts
-var args = process.argv.slice(2);
-var command = args[0];
-var flags = new Set(args.filter((arg) => arg.startsWith("--")).map((arg) => arg.split("=")[0]));
-var presetFlag = args.find((arg) => arg.startsWith("--preset="))?.split("=")[1];
-var laneFlag = args.find((arg) => arg.startsWith("--lane="))?.split("=")[1];
-var positional = args.slice(1).filter((arg) => !arg.startsWith("--"));
-var dir = resolve2(positional[0] ?? ".");
-var usage = () => {
-  console.log(
-    "Usage: inixiative-config <check|sync|scan|train> [dir] [--preset=base|node|react] [--lane=primitives|agentic] [--force] [--no-install] [--push]\n       inixiative-config ports [project]"
+var commandLine;
+try {
+  commandLine = parseCommandLine(process.argv.slice(2));
+} catch (error) {
+  if (!(error instanceof UsageError)) throw error;
+  console.error(`\u2717 ${error.message}`);
+  console.error(
+    "Usage: inixiative-config check [dir] [--preset=base|node|react]\n       inixiative-config sync [dir] [--preset=base|node|react] [--force] [--no-install]\n       inixiative-config scan [root] [--lane=primitives|agentic]\n       inixiative-config train [root] [--lane=primitives|agentic] [--push] [--dry-run]\n       inixiative-config ports [project]"
   );
   process.exit(2);
-};
+}
+var { command, positionals, preset: presetFlag, dryRun } = commandLine;
+var dir = resolve2(positionals[0] ?? ".");
 if (command === "ports") {
-  const project = positional[0];
-  if (project !== void 0 && !projects.includes(project)) usage();
+  const project = positionals[0];
+  if (project !== void 0 && !projects.includes(project)) {
+    console.error(`\u2717 unknown project: ${project} (${projects.join(", ")})`);
+    process.exit(2);
+  }
   for (const name of project ? [project] : projects)
     console.log(
       `${name}: ${Object.entries(portsFor(name)).map(([service, port]) => `${service}=${port}`).join(" ")}`
     );
   process.exit(0);
 }
-if (!["check", "sync", "scan", "train"].includes(command)) usage();
-if (presetFlag && !["base", "node", "react"].includes(presetFlag)) usage();
-if (laneFlag !== void 0 && !isLane(laneFlag)) usage();
-var lanes = laneFlag && isLane(laneFlag) ? [laneFlag] : [...LANES];
+var lanes = commandLine.lane ? [commandLine.lane] : [...LANES];
 var manifest = loadManifest();
 var report = (findings) => {
   for (const finding of findings) {
@@ -931,13 +986,13 @@ if (command === "check") {
 var laneLabel = (checkout) => checkout.consumer ? `consumer of ${checkout.consumer.lanes.join(" + ")}` : `${checkout.lane} lane`;
 if (command === "scan") {
   const plan = trainPlan(dir, manifest, lanes);
-  const checkouts = [...plan.lanes.flatMap((lane) => lane.checkouts), ...plan.consumers];
+  const checkouts = [...plan.lanes.flatMap((lane2) => lane2.checkouts), ...plan.consumers];
   if (checkouts.length === 0) {
     console.error(`\u2717 no ecosystem repos found under ${dir}`);
     process.exit(1);
   }
-  const missing = [...plan.lanes.flatMap((lane) => lane.missing), ...plan.missingConsumers];
-  const ambiguous = [...plan.lanes.flatMap((lane) => lane.ambiguous), ...plan.ambiguousConsumers];
+  const missing = [...plan.lanes.flatMap((lane2) => lane2.missing), ...plan.missingConsumers];
+  const ambiguous = [...plan.lanes.flatMap((lane2) => lane2.ambiguous), ...plan.ambiguousConsumers];
   const drifted = [];
   for (const checkout of checkouts) {
     console.log(`
@@ -973,13 +1028,24 @@ scanned ${checkouts.length} repos (${lanes.join(" + ")}): ${drifted.length === 0
 var Abort = class extends Error {
 };
 if (command === "train") {
+  const effect = (description, planned, run) => {
+    if (!dryRun) return run();
+    console.log(`  [dry-run] would ${description}`);
+    return planned;
+  };
+  if (dryRun) console.log("dry run: nothing is installed, written, committed, published or pushed");
   git(packageRoot, "fetch", "--quiet");
   if (behindOrigin(packageRoot) > 0) {
-    console.error("\u2717 this config checkout is behind origin \u2014 its blessed set is stale; pull first");
-    process.exit(1);
+    if (!dryRun) {
+      console.error(
+        "\u2717 this config checkout is behind origin \u2014 its blessed set is stale; pull first"
+      );
+      process.exit(1);
+    }
+    console.log("\u26A0 this config checkout is behind origin \u2014 the plan uses a stale blessed set");
   }
   const plan = trainPlan(dir, manifest, lanes);
-  if (plan.lanes.every((lane) => lane.checkouts.length === 0) && plan.consumers.length === 0) {
+  if (plan.lanes.every((lane2) => lane2.checkouts.length === 0) && plan.consumers.length === 0) {
     console.error(`\u2717 no ecosystem repos found under ${dir}`);
     process.exit(1);
   }
@@ -1017,30 +1083,39 @@ if (command === "train") {
         console.log("\u26A0 diverged from origin \u2014 reconcile first, skipping");
         return false;
       }
-      if (git(checkout.dir, "merge", "--ff-only", "@{upstream}").status !== 0) {
+      const merged = effect(
+        `fast-forward to origin (+${behind}); the plan below reflects the local tree`,
+        true,
+        () => git(checkout.dir, "merge", "--ff-only", "@{upstream}").status === 0
+      );
+      if (!merged) {
         console.log("\u26A0 fast-forward to origin failed \u2014 reconcile first, skipping");
         return false;
       }
-      console.log(`\u2193 fast-forwarded to origin (+${behind})`);
-      checkout.pkg = JSON.parse(readFileSync2(join2(checkout.dir, "package.json"), "utf8"));
+      if (!dryRun) {
+        console.log(`\u2193 fast-forwarded to origin (+${behind})`);
+        checkout.pkg = JSON.parse(readFileSync2(join2(checkout.dir, "package.json"), "utf8"));
+      }
     }
     return true;
   };
   const bumpRanges = (checkout) => {
     const inspection = inspect(checkout.dir, manifest);
     const bumps = inspection.findings.filter((finding) => finding.kind === "ecosystem-range");
-    for (const bump of bumps) {
-      console.log(`  ${bump.message}`);
-      bump.fix?.();
+    for (const bump of bumps) console.log(`  ${bump.message}`);
+    if (bumps.length > 0) {
+      effect(`rewrite ${bumps.length} ecosystem range(s) to the blessed set`, void 0, () => {
+        for (const bump of bumps) bump.fix?.();
+        inspection.flush();
+      });
     }
-    inspection.flush();
     return {
       inspection,
       bumped: bumps.length > 0,
       staleLock: inspection.findings.some((finding) => finding.kind === "stale-lock")
     };
   };
-  const relockAndCheck = (checkout, check = true) => {
+  const relockAndCheck = (checkout, check = true) => effect(`re-lock ${checkout.name}${check ? " and run its check" : ""}`, void 0, () => {
     if (spawnSync2("bun", ["install"], { cwd: checkout.dir, stdio: "inherit" }).status !== 0) {
       throw new Abort(`bun install failed in ${checkout.name}`);
     }
@@ -1053,23 +1128,38 @@ if (command === "train") {
     if (check && spawnSync2("bun", ["run", "check"], { cwd: checkout.dir, stdio: "inherit" }).status !== 0) {
       throw new Abort(`check failed in ${checkout.name}`);
     }
-  };
+  });
   const followers = [];
-  const commitOwned = (checkout, packagePaths) => {
-    const tracked = [...packagePaths, "bun.lock"];
-    const mutated = git(checkout.dir, "status", "--porcelain", "--", ...tracked);
-    if (mutated.status !== 0 || mutated.stdout.trim().length === 0) return false;
-    if (git(checkout.dir, "add", "--", ...tracked).status !== 0) {
-      throw new Abort(`git add failed in ${checkout.name} \u2014 is bun.lock ignored?`);
-    }
-    const commit = spawnSync2("git", ["commit", "-m", "chore: sync ecosystem deps to blessed set"], {
-      cwd: checkout.dir,
-      stdio: "inherit"
+  const commitOwned = (checkout, packagePaths, changes) => {
+    if (dryRun && !changes) return false;
+    return effect(`commit its package.json files + bun.lock in ${checkout.name}`, true, () => {
+      const tracked = [...packagePaths, "bun.lock"];
+      const mutated = git(checkout.dir, "status", "--porcelain", "--", ...tracked);
+      if (mutated.status !== 0 || mutated.stdout.trim().length === 0) return false;
+      if (git(checkout.dir, "add", "--", ...tracked).status !== 0) {
+        throw new Abort(`git add failed in ${checkout.name} \u2014 is bun.lock ignored?`);
+      }
+      const commit = spawnSync2(
+        "git",
+        ["commit", "-m", "chore: sync ecosystem deps to blessed set"],
+        {
+          cwd: checkout.dir,
+          stdio: "inherit"
+        }
+      );
+      if (commit.status !== 0) throw new Abort(`commit failed in ${checkout.name}`);
+      return true;
     });
-    if (commit.status !== 0) throw new Abort(`commit failed in ${checkout.name}`);
-    return true;
   };
-  const publish = (checkout, entry) => {
+  const publish = (checkout, entry, version, remote) => effect(`publish ${entry.name}@${version} to npm (npm has ${remote ?? "none"})`, true, () => {
+    console.log(`publishing ${entry.name}@${version} (npm has ${remote ?? "none"})`);
+    if (!publishToNpm(checkout, entry)) throw new Abort(`publish failed for ${entry.name}`);
+    if (!servedByRegistry(entry.name, version)) {
+      throw new Abort(`npm accepted ${entry.name}@${version} but the registry does not serve it`);
+    }
+    return true;
+  });
+  const publishToNpm = (checkout, entry) => {
     if (entry.path === "package.json") {
       return spawnSync2("npm", ["publish"], { cwd: checkout.dir, stdio: "inherit" }).status === 0;
     }
@@ -1091,12 +1181,12 @@ if (command === "train") {
     const remote = spawnSync2("npm", ["view", `${name}@latest`, "version"], { encoding: "utf8" });
     return remote.status === 0 ? remote.stdout.trim() : null;
   };
-  for (const { lane, checkouts, missing, ambiguous } of plan.lanes) {
+  for (const { lane: lane2, checkouts, missing, ambiguous } of plan.lanes) {
     console.log(
       `
-\u2550 ${lane} lane: ${checkouts.map((checkout) => checkout.name).join(" \u2192 ") || "(none)"}`
+\u2550 ${lane2} lane: ${checkouts.map((checkout) => checkout.name).join(" \u2192 ") || "(none)"}`
     );
-    const section = laneSection(manifest, lane);
+    const section = laneSection(manifest, lane2);
     const before = { ...section };
     const laneBlessed = [];
     try {
@@ -1133,19 +1223,13 @@ if (command === "train") {
           skipped.push(checkout.name);
           continue;
         }
-        if (bumped || staleLock || releases.some((release) => release.ahead))
-          relockAndCheck(checkout);
-        if (commitOwned(checkout, inspection.packagePaths)) committed.add(checkout.dir);
+        const relocked = bumped || staleLock || releases.some((release) => release.ahead);
+        if (relocked) relockAndCheck(checkout);
+        if (commitOwned(checkout, inspection.packagePaths, relocked)) committed.add(checkout.dir);
         followers.push(checkout);
         for (const { entry, local, remote, ahead } of releases) {
           if (ahead) {
-            console.log(`publishing ${entry.name}@${local} (npm has ${remote ?? "none"})`);
-            if (!publish(checkout, entry)) throw new Abort(`publish failed for ${entry.name}`);
-            if (!servedByRegistry(entry.name, local)) {
-              throw new Abort(
-                `npm accepted ${entry.name}@${local} but the registry does not serve it`
-              );
-            }
+            publish(checkout, entry, local, remote);
           } else if (section[entry.name] === local) {
             console.log(`\u2713 ${entry.name}@${local} already on npm and blessed`);
             continue;
@@ -1157,19 +1241,23 @@ if (command === "train") {
         }
       }
       if (laneBlessed.length > 0) {
-        writeManifest(manifest);
+        effect(
+          `bless ${laneBlessed.join(", ")} in versions.json`,
+          void 0,
+          () => writeManifest(manifest)
+        );
         bomDirty = true;
         blessed.push(...laneBlessed);
       }
       console.log(
-        `${lane} lane blessed: ${laneBlessed.length === 0 ? "nothing new" : laneBlessed.join(", ")}`
+        `${lane2} lane blessed: ${laneBlessed.length === 0 ? "nothing new" : laneBlessed.join(", ")}`
       );
     } catch (error) {
       if (!(error instanceof Abort)) throw error;
       for (const name of Object.keys(section)) delete section[name];
       Object.assign(section, before);
-      failed.push(`${lane} lane`);
-      console.error(`\u2717 ${error.message} \u2014 ${lane} lane stopped; its BOM entries are unchanged`);
+      failed.push(`${lane2} lane`);
+      console.error(`\u2717 ${error.message} \u2014 ${lane2} lane stopped; its BOM entries are unchanged`);
       if (laneBlessed.length > 0) {
         console.error(
           `  published but not blessed: ${laneBlessed.join(", ")} \u2014 the next train blesses them`
@@ -1210,13 +1298,18 @@ if (command === "train") {
         checkout.dir,
         `train/ecosystem-sync-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`
       );
-      if (git(checkout.dir, "switch", "-c", branch).status !== 0) {
-        throw new Abort(`could not create ${branch} in ${checkout.name}`);
-      }
+      const switched = effect(
+        `create review branch ${branch} in ${checkout.name}`,
+        true,
+        () => git(checkout.dir, "switch", "-c", branch).status === 0
+      );
+      if (!switched) throw new Abort(`could not create ${branch} in ${checkout.name}`);
       followers.push(checkout);
-      if (commitOwned(checkout, inspection.packagePaths)) {
+      if (commitOwned(checkout, inspection.packagePaths, true)) {
         reviewBranches.push({ dir: checkout.dir, branch, base });
-        console.log(`committed on ${branch} for review; the checkout stays on it until merged`);
+        if (!dryRun) {
+          console.log(`committed on ${branch} for review; the checkout stays on it until merged`);
+        }
       }
     } catch (error) {
       if (!(error instanceof Abort)) throw error;
@@ -1233,52 +1326,73 @@ blessed: ${blessed.length === 0 ? "nothing" : blessed.join(", ")}`);
     let version = ownVersion();
     if (remoteVersion !== null && compare(version, remoteVersion) <= 0) {
       version = bumpPatch(remoteVersion);
-      const pkgPath = join2(packageRoot, "package.json");
-      const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
-      pkg.version = version;
-      writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
+      const bumped = version;
+      effect(`bump @inixiative/config to ${bumped} in package.json`, void 0, () => {
+        const pkgPath = join2(packageRoot, "package.json");
+        const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
+        pkg.version = bumped;
+        writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `);
+      });
     }
     manifest.ecosystem["@inixiative/config"] = version;
-    writeManifest(manifest);
-    for (const fixture of fixtureDirs()) {
-      const inspection = inspect(fixture, manifest);
-      for (const finding of inspection.findings)
-        if (finding.kind === "ecosystem-range") finding.fix?.();
-      inspection.flush();
-    }
-    const check = spawnSync2("bun", ["run", "check"], { cwd: packageRoot, stdio: "inherit" });
-    if (check.status !== 0) {
-      console.error("\u2717 check failed in @inixiative/config \u2014 aborting before publish");
-      process.exit(1);
-    }
-    spawnSync2("git", ["add", "--", "package.json", "versions.json", "test/fixtures"], {
-      cwd: packageRoot
+    effect(
+      `bless @inixiative/config@${version} in versions.json and move test/fixtures onto the blessed set`,
+      void 0,
+      () => {
+        writeManifest(manifest);
+        for (const fixture of fixtureDirs()) {
+          const inspection = inspect(fixture, manifest);
+          for (const finding of inspection.findings)
+            if (finding.kind === "ecosystem-range") finding.fix?.();
+          inspection.flush();
+        }
+      }
+    );
+    effect("run bun run check in @inixiative/config", void 0, () => {
+      const check = spawnSync2("bun", ["run", "check"], { cwd: packageRoot, stdio: "inherit" });
+      if (check.status !== 0) {
+        console.error("\u2717 check failed in @inixiative/config \u2014 aborting before publish");
+        process.exit(1);
+      }
     });
-    const commit = spawnSync2(
-      "git",
-      ["commit", "-m", `chore: bless ${blessed.join(", ")} \u2014 ${version}`],
-      { cwd: packageRoot, stdio: "inherit" }
+    effect(
+      `commit "chore: bless ${blessed.join(", ")} \u2014 ${version}" in @inixiative/config`,
+      void 0,
+      () => {
+        spawnSync2("git", ["add", "--", "package.json", "versions.json", "test/fixtures"], {
+          cwd: packageRoot
+        });
+        const commit = spawnSync2(
+          "git",
+          ["commit", "-m", `chore: bless ${blessed.join(", ")} \u2014 ${version}`],
+          { cwd: packageRoot, stdio: "inherit" }
+        );
+        if (commit.status !== 0) {
+          console.error("\u2717 commit failed in @inixiative/config \u2014 aborting before publish");
+          process.exit(1);
+        }
+      }
     );
-    if (commit.status !== 0) {
-      console.error("\u2717 commit failed in @inixiative/config \u2014 aborting before publish");
-      process.exit(1);
-    }
-    const publish2 = spawnSync2("npm", ["publish"], { cwd: packageRoot, stdio: "inherit" });
-    if (publish2.status !== 0 || !servedByRegistry("@inixiative/config", version)) {
-      console.error("\u2717 publish failed for @inixiative/config");
-      process.exit(1);
-    }
+    effect(`publish @inixiative/config@${version} to npm`, void 0, () => {
+      const publish2 = spawnSync2("npm", ["publish"], { cwd: packageRoot, stdio: "inherit" });
+      if (publish2.status !== 0 || !servedByRegistry("@inixiative/config", version)) {
+        console.error("\u2717 publish failed for @inixiative/config");
+        process.exit(1);
+      }
+      console.log(`published: @inixiative/config@${version} \u2014 the BOM names the new state`);
+    });
     committed.add(packageRoot);
-    console.log(`published: @inixiative/config@${version} \u2014 the BOM names the new state`);
+    if (followers.length > 0) console.log(`
+\u2550 re-lock onto @inixiative/config@${version}`);
     for (const checkout of followers) {
       try {
         const { inspection, bumped, staleLock } = bumpRanges(checkout);
         if (!bumped && !staleLock) continue;
         relockAndCheck(checkout, false);
-        if (commitOwned(checkout, inspection.packagePaths) && !checkout.consumer)
+        if (commitOwned(checkout, inspection.packagePaths, true) && !checkout.consumer)
           committed.add(checkout.dir);
-        console.log(`\u2713 ${checkout.name} locked to @inixiative/config@${version}`);
+        if (!dryRun) console.log(`\u2713 ${checkout.name} locked to @inixiative/config@${version}`);
       } catch (error) {
         if (!(error instanceof Abort)) throw error;
         failed.push(checkout.name);
@@ -1286,7 +1400,14 @@ blessed: ${blessed.length === 0 ? "nothing" : blessed.join(", ")}`);
       }
     }
   }
-  if (flags.has("--push")) {
+  if (dryRun) {
+    console.log(
+      `
+dry run complete \u2014 a real train would commit in ${committed.size} repo(s) and open ${reviewBranches.length} review branch(es)${commandLine.push ? ", then push them" : ""}:`
+    );
+    for (const repoDir of committed) console.log(`  ${repoDir}`);
+    for (const { dir: repoDir, branch } of reviewBranches) console.log(`  ${repoDir} (${branch})`);
+  } else if (commandLine.push) {
     for (const repoDir of committed) {
       if (spawnSync2("git", ["push"], { cwd: repoDir, stdio: "inherit" }).status !== 0) {
         console.error(`\u2717 push failed in ${repoDir}`);
@@ -1345,7 +1466,7 @@ function fixtureDirs() {
   if (!existsSync2(root)) return [];
   return readdirSync2(root).map((name) => join2(root, name)).filter((dir2) => existsSync2(join2(dir2, "package.json")));
 }
-if (existsSync2(join2(dir, ".git")) && !flags.has("--force")) {
+if (existsSync2(join2(dir, ".git")) && !commandLine.force) {
   const status = spawnSync2("git", ["status", "--porcelain"], { cwd: dir, encoding: "utf8" });
   if (status.status === 0 && status.stdout.trim().length > 0) {
     console.error("\u2717 working tree dirty \u2014 commit first or pass --force");
@@ -1357,7 +1478,7 @@ for (const finding of first.findings) finding.fix?.();
 first.flush();
 var fixed = first.findings.filter((finding) => finding.fix).length;
 if (fixed > 0) console.log(`applied ${fixed} fix${fixed === 1 ? "" : "es"}`);
-if (!flags.has("--no-install")) {
+if (!commandLine.noInstall) {
   const relinked = new Set(
     first.findings.flatMap(
       (finding) => finding.kind === "member-toolchain" && finding.path ? [dirname2(finding.path)] : []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/config",
-  "version": "0.5.61",
+  "version": "0.5.63",
   "description": "Shared toolchain for the inixiative ecosystem: tsconfig/biome/tsup presets, a version manifest (BOM), and a sync/check CLI",
   "type": "module",
   "license": "MIT",

package/versions.json

@@ -13,10 +13,10 @@
     "@types/bun"
   ],
   "ecosystem": {
-    "@inixiative/config": "0.5.61",
-    "@inixiative/json-rules": "3.4.0",
+    "@inixiative/config": "0.5.63",
+    "@inixiative/json-rules": "3.4.1",
     "@inixiative/permissions": "0.4.0",
-    "@inixiative/transitions": "0.3.0",
+    "@inixiative/transitions": "0.4.0",
     "@inixiative/rules-builder": "0.30.0",
     "@inixiative/prisma-map": "0.2.0",
     "@inixiative/atlas": "0.2.0",
@@ -24,10 +24,10 @@
   },
   "agentic": {
     "@inixiative/signet": "0.3.0",
-    "@inixiative/archive": "0.9.0",
-    "@inixiative/agent-session": "0.3.1",
-    "@inixiative/foundry-core": "0.3.0",
-    "@inixiative/foundry": "0.3.0"
+    "@inixiative/archive": "0.10.0",
+    "@inixiative/agent-session": "0.4.0",
+    "@inixiative/foundry-core": "0.4.0",
+    "@inixiative/foundry": "0.4.0"
   },
   "consumers": {
     "inixiative/template": {