@clossys/butler 0.1.1

package/dist/cli.js

@@ -0,0 +1,426 @@
+#!/usr/bin/env node
+/**
+ * `butler-check` — one bin, three gates, dispatched on `argv[0]` matching a
+ * subcommand name EXACTLY.
+ *
+ * Dispatch is on `argv[0]`, never on `basename(process.argv[1])`. A bin-name
+ * dispatch would see `cli.js` wherever this gate is invoked by its compiled
+ * path — which is exactly how this repository's own `npm run check` invokes
+ * other packages' gates — and would silently run the wrong command, or none.
+ *
+ * Presentation only: parse argv, load JSON files, run the pure checkers in
+ * `contract.ts`, print a report, pick an exit code. Every decision worth
+ * testing lives in `contract.ts` and is tested there directly, against
+ * plain values, with no filesystem involved.
+ *
+ * EXIT CODES — the contract a consumer's CI depends on (this repository's
+ * own contribution guide, "Gate CLIs exit `0` clean, `1` findings, `2`
+ * could not run"):
+ *
+ *   0 — ran cleanly against a non-empty record set and found nothing.
+ *   1 — ran cleanly and found at least one real violation.
+ *   2 — could not run. Kept strictly distinct from `1`, because "I checked
+ *       and it is fine" and "I never checked" are different answers and a
+ *       gate that reports the second as the first is worse than no gate.
+ *
+ * `2` is genuinely reachable here, on every subcommand, and each route is
+ * tested:
+ *   - a record store that cannot be read — missing file, unreadable file,
+ *     a directory where a file was named, invalid JSON, or JSON that does
+ *     not validate against this package's own schema;
+ *   - nothing to scan — an empty record set, which is not a clean run, it
+ *     is a run that examined nothing;
+ *   - a required declared value that was not supplied — the confidence
+ *     floor, or the denial-invalidation policy. Neither has a default
+ *     anywhere in this package, and a run missing one declines rather than
+ *     inventing one of the consumer's own values;
+ *   - NO GATE SELECTED AT ALL. A bare `butler-check` with no subcommand is
+ *     a run that never happened, and it exits `2`, not `0` — see `main()`'s
+ *     own comment for why an explicitly requested `--help` is the one
+ *     argument-shaped `0` here and a dropped argument is not.
+ */
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { checkConfirmationCompleteness, checkCurrency, checkWithdrawalParity, } from "./contract.js";
+import { validateConfirmationRecords, validateInstructionUsages, validateIntentRecords, validatePreferencePaths, validateStandingInstructions, } from "./schema.js";
+const USAGE = `Usage: butler-check <gate> [arguments]
+
+Gates:
+  confirmation-completeness <intents-file> <confirmations-file> --floor <0..1>
+      Fails when an acted-on intent has no confirmation record, when it was
+      acted on against a "misread" or "unclear" read-back, or when a reading
+      below the declared floor was acted on with no explicit hand-off.
+
+  currency <instructions-file> <usages-file> --invalidate-denial-on-policy-bump <true|false>
+      Fails when a standing instruction was relied on past its own declared
+      window, after the policy version it answered was superseded, or while
+      there was no answer on record at all.
+
+  withdrawal-parity <paths-file>
+      Fails when withdrawing takes more steps than granting, demands a
+      contact or an account granting did not, or is not offered at all.
+
+Options:
+  --help    Print this message and exit 0. Also available per gate.
+
+Exit codes: 0 = clean, 1 = at least one finding, 2 = could not run (bad
+arguments, a missing/unreadable/unparseable/invalid file, an empty record
+set, or a required declared value that was not supplied).
+`;
+const CONFIRMATION_USAGE = `Usage: butler-check confirmation-completeness <intents-file> <confirmations-file> --floor <0..1>
+
+  intents-file        JSON array of IntentRecord objects. Required.
+  confirmations-file  JSON array of ConfirmationRecord objects. Required. May be an empty array — an empty CONFIRMATION set is a real, checkable state (every acted-on intent is then unconfirmed); an empty INTENT set is not, and exits 2.
+  --floor <0..1>      The declared confidence floor. Required, with no default: the number below which a reading is too weak to act on is one of the consumer's own values, and this gate will not invent one.
+
+Exit codes: 0 = every acted-on intent is accounted for, 1 = at least one is not, 2 = could not run.
+`;
+const CURRENCY_USAGE = `Usage: butler-check currency <instructions-file> <usages-file> --invalidate-denial-on-policy-bump <true|false>
+
+  instructions-file  JSON array of StandingInstruction objects. Required.
+  usages-file        JSON array of InstructionUsage objects — one entry per occasion an instruction was actually relied on. Required.
+  --invalidate-denial-on-policy-bump <true|false>
+                     Whether a policy-version bump also invalidates a stored denial. Required, with no default in either direction: that is a jurisdiction judgment this package does not make.
+
+Exit codes: 0 = every usage relied on a current answer, 1 = at least one did not, 2 = could not run.
+`;
+const WITHDRAWAL_USAGE = `Usage: butler-check withdrawal-parity <paths-file>
+
+  paths-file  JSON array of PreferencePath objects: for one surface and one topic, the measured cost of the grant route and of the withdraw route. Required.
+
+Exit codes: 0 = withdrawing is no harder than granting anywhere, 1 = somewhere it is, 2 = could not run.
+`;
+const GATES = ["confirmation-completeness", "currency", "withdrawal-parity"];
+/** Exported for `cli.test.ts` — anything wrong with the arguments themselves always maps to exit code 2, never 1. */
+export class CliInputError extends Error {
+}
+/**
+ * One argv parser for all three gates. `--name value` and `--name=value`
+ * are both accepted; an unknown flag is a `CliInputError`, never a silently
+ * ignored argument — a typo in a flag that carries a required declared
+ * value must not read as that value being absent by choice.
+ */
+function parseArgs(argv, knownOptions) {
+    const positional = [];
+    const options = new Map();
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+            continue;
+        }
+        if (!arg.startsWith("-")) {
+            positional.push(arg);
+            continue;
+        }
+        const equals = arg.indexOf("=");
+        const name = equals === -1 ? arg : arg.slice(0, equals);
+        if (!knownOptions.includes(name))
+            throw new CliInputError(`unknown flag "${name}"`);
+        if (equals !== -1) {
+            options.set(name, arg.slice(equals + 1));
+            continue;
+        }
+        const next = argv[i + 1];
+        if (next === undefined || next.startsWith("-"))
+            throw new CliInputError(`flag "${name}" requires a value`);
+        options.set(name, next);
+        i++;
+    }
+    return { positional, options, help };
+}
+/**
+ * Why this record store cannot be read, or `undefined` if it can be.
+ *
+ * Deliberately NOT a `CliInputError`. A malformed argument is the caller's
+ * mistake and belongs with the other argv errors; a record store that is
+ * missing, unreadable, or is a directory where a file was named is the
+ * store's condition, and it is exactly the "could not run" state this
+ * gate's `2` exists for. Reporting it through the normal return path
+ * rather than an exception is what lets `main()` itself be observed
+ * returning `2` for it — a decline path nothing ever exercises is a
+ * decline path nobody knows works.
+ */
+function fileProblem(label, path) {
+    if (!existsSync(path))
+        return `${label} "${path}" does not exist`;
+    let stat;
+    try {
+        stat = statSync(path);
+    }
+    catch (error) {
+        return `cannot stat ${label} "${path}": ${error instanceof Error ? error.message : String(error)}`;
+    }
+    if (!stat.isFile())
+        return `${label} "${path}" is not a file`;
+    return undefined;
+}
+/**
+ * Reads and JSON-parses a file, never throwing: an I/O failure or a syntax
+ * error comes back as `{ ok: false, detail }`. This CLI is the only place
+ * in this package that reads anything off disk — every checker in
+ * `contract.ts` is pure.
+ */
+function readJsonFile(label, path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        return { ok: false, detail: `cannot read ${label} "${path}": ${error instanceof Error ? error.message : String(error)}` };
+    }
+    try {
+        return { ok: true, value: JSON.parse(raw) };
+    }
+    catch (error) {
+        return { ok: false, detail: `${label} "${path}" is not valid JSON: ${error instanceof Error ? error.message : String(error)}` };
+    }
+}
+/**
+ * Load one record file and validate it against this package's own schema.
+ * Returns the records, or `undefined` having already printed why — a file
+ * that is missing, unreadable, unparseable, or schema-invalid never
+ * reaches a checker at all: it is "could not run", decided here.
+ */
+function loadRecords(label, path, validate) {
+    const problem = fileProblem(label, path);
+    if (problem !== undefined) {
+        console.error(`\n${label} could not be loaded: ${problem}`);
+        console.error("Refusing to report a pass against a record store that could not be read.");
+        return undefined;
+    }
+    const json = readJsonFile(label, path);
+    if (!json.ok) {
+        console.error(`\n${label} could not be loaded: ${json.detail}`);
+        console.error("Refusing to report a pass against a record store that could not be read.");
+        return undefined;
+    }
+    const shape = validate(json.value);
+    if (!shape.ok) {
+        console.error(`\n${label} "${path}" did not validate:`);
+        for (const issue of shape.issues)
+            console.error(`  ${issue.path}: ${issue.message}`);
+        console.error("Refusing to report a pass against records this package cannot trust.");
+        return undefined;
+    }
+    return shape.value;
+}
+/** `--floor 0.8`. No default: a missing or unparseable floor is a decline, never an assumed number. */
+function parseFloor(raw) {
+    if (raw === undefined)
+        throw new CliInputError("--floor is required; this gate has no default confidence floor");
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new CliInputError(`--floor must be a number between 0 and 1 inclusive, got "${raw}"`);
+    }
+    return value;
+}
+/** Exactly `true` or `false`. No default in either direction, and no truthiness: "yes", "1" and "" are all input errors. */
+function parseBooleanFlag(name, raw) {
+    if (raw === undefined)
+        throw new CliInputError(`${name} is required; this gate has no default in either direction`);
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    throw new CliInputError(`${name} must be exactly "true" or "false", got "${raw}"`);
+}
+function printConfirmationReport(result) {
+    console.log(`${result.intentsChecked} intent(s) checked against ${result.confirmationsChecked} confirmation(s), floor ${result.floorApplied}.`);
+    for (const finding of result.findings) {
+        console.log(`  [${finding.kind}] ${finding.intentId}${finding.actorId ? ` (actor ${finding.actorId})` : ""} — ${finding.message}`);
+    }
+    if (result.ok)
+        console.log("Confirmation completeness: satisfied.");
+    else if (result.reason === "unconfirmed-intents")
+        console.log("Confirmation completeness: violated.");
+    else
+        console.log(`Confirmation completeness: indeterminate (${result.reason}).`);
+}
+function printCurrencyReport(result) {
+    console.log(`${result.instructionsChecked} standing instruction(s) checked against ${result.usagesChecked} usage(s).`);
+    for (const finding of result.findings) {
+        console.log(`  [${finding.kind}] ${finding.instructionId} (actor ${finding.actorId}, used ${finding.usedAt}) — ${finding.message}`);
+    }
+    if (result.ok)
+        console.log("Currency: satisfied.");
+    else if (result.reason === "stale-instructions-used")
+        console.log("Currency: violated.");
+    else
+        console.log(`Currency: indeterminate (${result.reason}).`);
+}
+function printWithdrawalReport(result) {
+    console.log(`${result.pathsChecked} preference path(s) checked.`);
+    for (const finding of result.findings) {
+        console.log(`  [${finding.kind}] ${finding.surfaceId} / ${finding.topic} — ${finding.message}`);
+    }
+    if (result.ok)
+        console.log("Withdrawal parity: satisfied.");
+    else if (result.reason === "withdrawal-harder-than-granting")
+        console.log("Withdrawal parity: violated.");
+    else
+        console.log(`Withdrawal parity: indeterminate (${result.reason}).`);
+}
+/**
+ * The one mapping every gate shares: a real violation is `1`; an
+ * indeterminate reason — nothing was compared — is `2`, never `0` and never
+ * conflated with a violation.
+ */
+function exitCodeFor(ok, reason, violationReason) {
+    if (ok)
+        return 0;
+    return reason === violationReason ? 1 : 2;
+}
+function runConfirmationCompleteness(argv) {
+    const args = parseArgs(argv, ["--floor"]);
+    if (args.help) {
+        console.log(CONFIRMATION_USAGE);
+        return 0;
+    }
+    const [intentsArg, confirmationsArg, ...extra] = args.positional;
+    if (intentsArg === undefined)
+        throw new CliInputError("intents-file is required");
+    if (confirmationsArg === undefined)
+        throw new CliInputError("confirmations-file is required");
+    if (extra.length > 0)
+        throw new CliInputError(`unexpected extra argument "${extra[0]}"`);
+    const minimumConfidence = parseFloor(args.options.get("--floor"));
+    const intentsFile = resolve(intentsArg);
+    const confirmationsFile = resolve(confirmationsArg);
+    console.log(`Intents file: ${intentsFile}`);
+    console.log(`Confirmations file: ${confirmationsFile}`);
+    const intents = loadRecords("intents-file", intentsFile, validateIntentRecords);
+    if (intents === undefined)
+        return 2;
+    const confirmations = loadRecords("confirmations-file", confirmationsFile, validateConfirmationRecords);
+    if (confirmations === undefined)
+        return 2;
+    const result = checkConfirmationCompleteness(intents, confirmations, { minimumConfidence });
+    printConfirmationReport(result);
+    return exitCodeFor(result.ok, result.reason, "unconfirmed-intents");
+}
+function runCurrency(argv) {
+    const args = parseArgs(argv, ["--invalidate-denial-on-policy-bump"]);
+    if (args.help) {
+        console.log(CURRENCY_USAGE);
+        return 0;
+    }
+    const [instructionsArg, usagesArg, ...extra] = args.positional;
+    if (instructionsArg === undefined)
+        throw new CliInputError("instructions-file is required");
+    if (usagesArg === undefined)
+        throw new CliInputError("usages-file is required");
+    if (extra.length > 0)
+        throw new CliInputError(`unexpected extra argument "${extra[0]}"`);
+    const invalidateDenialOnPolicyBump = parseBooleanFlag("--invalidate-denial-on-policy-bump", args.options.get("--invalidate-denial-on-policy-bump"));
+    const instructionsFile = resolve(instructionsArg);
+    const usagesFile = resolve(usagesArg);
+    console.log(`Instructions file: ${instructionsFile}`);
+    console.log(`Usages file: ${usagesFile}`);
+    const instructions = loadRecords("instructions-file", instructionsFile, validateStandingInstructions);
+    if (instructions === undefined)
+        return 2;
+    const usages = loadRecords("usages-file", usagesFile, validateInstructionUsages);
+    if (usages === undefined)
+        return 2;
+    const result = checkCurrency(instructions, usages, { invalidateDenialOnPolicyBump });
+    printCurrencyReport(result);
+    return exitCodeFor(result.ok, result.reason, "stale-instructions-used");
+}
+function runWithdrawalParity(argv) {
+    const args = parseArgs(argv, []);
+    if (args.help) {
+        console.log(WITHDRAWAL_USAGE);
+        return 0;
+    }
+    const [pathsArg, ...extra] = args.positional;
+    if (pathsArg === undefined)
+        throw new CliInputError("paths-file is required");
+    if (extra.length > 0)
+        throw new CliInputError(`unexpected extra argument "${extra[0]}"`);
+    const pathsFile = resolve(pathsArg);
+    console.log(`Paths file: ${pathsFile}`);
+    const paths = loadRecords("paths-file", pathsFile, validatePreferencePaths);
+    if (paths === undefined)
+        return 2;
+    const result = checkWithdrawalParity(paths);
+    printWithdrawalReport(result);
+    return exitCodeFor(result.ok, result.reason, "withdrawal-harder-than-granting");
+}
+/**
+ * Exported (unlike a typical CLI `main`) so `cli.test.ts` can exercise the
+ * whole argv-to-exit-code contract directly, against real `mkdtemp` temp
+ * directories, without spawning a subprocess per case. Takes `argv` as a
+ * parameter rather than reading `process.argv` itself for exactly that
+ * reason — `run()` below is the only caller that reads the real
+ * `process.argv`.
+ */
+export function main(argv) {
+    const first = argv[0];
+    // An EXPLICITLY requested `--help` is a run that did exactly what was
+    // asked, so it is `0`. A BARE invocation is not: no gate was selected, so
+    // nothing was checked, and reporting that clean is the precise fail-open
+    // shape this repository's own contribution guide forbids ("a check that
+    // cannot run must fail (`2`), never pass (`0`)"). A CI step with a dropped
+    // argument, a wrapper that loses `$1`, or a gate renamed out from under
+    // its caller all arrive here, and all three must go red rather than green
+    // on the strength of having examined nothing. Usage still prints — on
+    // stderr, because it is now a diagnostic rather than the thing asked for.
+    if (first === "--help" || first === "-h") {
+        console.log(USAGE);
+        return 0;
+    }
+    if (first === undefined) {
+        console.error("butler-check: no gate selected, so nothing was checked.");
+        console.error(`\n${USAGE}`);
+        return 2;
+    }
+    if (first === "confirmation-completeness")
+        return runConfirmationCompleteness(argv.slice(1));
+    if (first === "currency")
+        return runCurrency(argv.slice(1));
+    if (first === "withdrawal-parity")
+        return runWithdrawalParity(argv.slice(1));
+    throw new CliInputError(`unknown gate "${first}"; expected one of ${GATES.join(", ")}`);
+}
+function run() {
+    try {
+        process.exitCode = main(process.argv.slice(2));
+    }
+    catch (error) {
+        if (error instanceof CliInputError) {
+            console.error(`butler-check: ${error.message}`);
+            console.error(`\n${USAGE}`);
+            process.exitCode = 2;
+        }
+        else {
+            console.error(`butler-check: unexpected error: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`);
+            process.exitCode = 2;
+        }
+    }
+}
+/**
+ * `npm install` publishes `bin` entries as symlinks, so comparing
+ * `process.argv[1]` to `import.meta.url` without resolving symlinks on both
+ * sides fails the moment this file is invoked the only way it ships — as an
+ * installed CLI — and fails silently: `run()` never fires, nothing prints,
+ * and the exit code is 0. Resolving both real paths is the fix.
+ */
+function detectMainModule() {
+    const argvPath = process.argv[1];
+    if (argvPath === undefined)
+        return false;
+    const modulePath = fileURLToPath(import.meta.url);
+    try {
+        return realpathSync(resolve(argvPath)) === realpathSync(modulePath);
+    }
+    catch {
+        return resolve(argvPath) === modulePath;
+    }
+}
+if (detectMainModule()) {
+    run();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}