@geonosis/release 1.3.0 → 1.4.0

package/dist/release-cli.js

@@ -14,6 +14,86 @@ import {
 
 // src/release-cli.ts
 import { resolve } from "path";
+
+// src/envelope.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var ENVELOPES_DIR = ".geonosis/envelopes";
+var envelopePath = (root, tool) => join(root, ENVELOPES_DIR, `${tool}.json`);
+var UnbalancedEnvelope = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "UnbalancedEnvelope";
+  }
+};
+var isCount = (value) => Number.isSafeInteger(value) && value >= 0;
+var unbalancedMessage = (envelope, next) => `${envelope.tool}: considered ${envelope.considered} but accounts for ${envelope.read + envelope.refused.length + envelope.excused.length} \u2014 ${envelope.read} read + ${envelope.refused.length} refused + ${envelope.excused.length} excused. A run that has lost count of its own inputs cannot say what it measured, so no verdict was rendered and no envelope was written. Next: ${next}`;
+var writeEnvelope = ({
+  envelope,
+  next,
+  root
+}) => {
+  if (envelope.tool.trim() === "") {
+    throw new UnbalancedEnvelope(
+      `an envelope with no tool name cannot be filed or reported against. Next: ${next}`
+    );
+  }
+  if (envelope.version.trim() === "") {
+    throw new UnbalancedEnvelope(
+      `${envelope.tool}: an envelope that cannot name the build that wrote it dates nothing, and a stale one reads exactly like a fresh one. Next: ${next}`
+    );
+  }
+  if (!isCount(envelope.considered) || !isCount(envelope.read)) {
+    throw new UnbalancedEnvelope(
+      `${envelope.tool}: considered ${envelope.considered} and read ${envelope.read} \u2014 a census is a whole number of things, and arithmetic over anything else balances by accident. Next: ${next}`
+    );
+  }
+  if (envelope.considered !== envelope.read + envelope.refused.length + envelope.excused.length) {
+    throw new UnbalancedEnvelope(unbalancedMessage(envelope, next));
+  }
+  const at = envelopePath(root, envelope.tool);
+  mkdirSync(dirname(at), { recursive: true });
+  writeFileSync(at, `${JSON.stringify(envelope, void 0, 2)}
+`);
+  return at;
+};
+var UNKNOWN = "unknown";
+var versionIn = (dir) => {
+  try {
+    const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+    return typeof manifest.version === "string" ? manifest.version : void 0;
+  } catch {
+    return void 0;
+  }
+};
+var versionOf = (moduleUrl) => {
+  let dir = dirname(fileURLToPath(moduleUrl));
+  for (; ; ) {
+    const found = versionIn(dir);
+    if (found !== void 0) return found;
+    const up = dirname(dir);
+    if (up === dir) return UNKNOWN;
+    dir = up;
+  }
+};
+var MIGRATIONS_TOOL = "release-migrations";
+var MIGRATIONS_NEXT = "geonosis-release migrations --since <ref> --json and compare `files` against `unreadable` \u2014 every added file leaves by exactly one door, and a file in one list and not the other is the accounting bug this refuses over";
+var migrationsEnvelope = (report, durationMs) => ({
+  considered: report.files.length,
+  durationMs,
+  excused: report.files.filter((one) => one.state === "excused").map((one) => ({
+    path: one.path,
+    reason: "a contract-migration marker this gate could believe"
+  })),
+  findings: [...report.refusals, ...report.markers, ...report.squawk],
+  read: report.files.filter((one) => one.state !== "excused" && one.state !== "unreadable").length,
+  refused: report.unreadable.map((one) => ({ path: one.path, reason: one.why })),
+  tool: MIGRATIONS_TOOL,
+  version: versionOf(import.meta.url)
+});
+
+// src/release-cli.ts
 var USAGE = `geonosis-release <command> [options]
 
   migrations --since <ref> [--dialect <name>] [--root <dir>] [--json]
@@ -84,15 +164,24 @@ var migrations = (parsed, cwd) => {
   if (dialect !== void 0 && !DIALECTS.has(dialect)) {
     throw new CannotRun(`--dialect must be one of ${[...DIALECTS].toSorted().join(", ")}`);
   }
+  const root = resolve(cwd, parsed.read["--root"] ?? cwd);
+  const startedAt = Date.now();
   const report = runMigrations({
     ...dialect === void 0 ? {} : { dialect },
-    root: resolve(cwd, parsed.read["--root"] ?? cwd),
+    root,
     since
   });
   process.stdout.write(
     parsed.json ? `${JSON.stringify(report, void 0, 2)}
 ` : formatMigrations(report)
   );
+  const at = writeEnvelope({
+    envelope: migrationsEnvelope(report, Date.now() - startedAt),
+    next: MIGRATIONS_NEXT,
+    root
+  });
+  if (!parsed.json) process.stdout.write(`envelope: ${at}
+`);
   if (report.unreadable.length > 0) return 2;
   return report.ok ? 0 : 1;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geonosis/release",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "types": "./dist/index.d.ts",
   "description": "The release contract with its proofs: an expand-only migration gate over three dialects, a smoke that must name the version that answered it, and declared ≠ deployed.",
   "keywords": [
@@ -44,7 +44,8 @@
     }
   },
   "devDependencies": {
-    "squawk-cli": "2.63.0"
+    "squawk-cli": "2.63.0",
+    "@geonosis/ratchet": "1.4.0"
   },
   "engines": {
     "node": ">=22"