@lannguyensi/harness 0.64.0 → 1.0.0

package/dist/cli/gate/snapshot.js

@@ -1,21 +1,37 @@
 // Snapshot file format + I/O for `harness gate disable` / `harness gate enable`.
 //
-// A snapshot is the on-disk record of one `gate disable` invocation. It
-// captures (a) which hook groups were removed and where they came from,
-// (b) the SHA-256 of `settings.json` immediately before and after the
-// removal, and (c) the path the original was backed up to. `gate enable`
-// reads the newest snapshot in the settings directory, refuses to restore
-// over a settings.json the operator has edited since (`--force` overrides),
-// and writes the removed groups back into place.
+// A snapshot is the on-disk record of the `gate disable` calls made against
+// one settings.json since the last restore. It captures (a) which hook groups
+// were removed and where they came from, (b) the SHA-256 of `settings.json`
+// before the first removal and after the latest one, and (c) the path the
+// original was backed up to. There is at most ONE live snapshot per
+// settings.json: a second `gate disable` merges its groups into it while the
+// file is still in the state that snapshot left. `gate enable` restores that
+// snapshot, refuses to restore over a settings.json the operator has edited
+// since unless the result is exactly the pre-disable file (`--force`
+// overrides), writes the removed groups back into place and then retires the
+// snapshot (renamed to `*.restored.json`, kept for audit, never applied
+// again). A removed group counts as back only when the file holds an
+// unchanged copy of it; a group that merely shares its event and matcher is
+// taken for it only under `--force`.
 //
 // The format is intentionally narrow: no compression, no transform, just
 // the literal JSON groups as they were read out of settings.json.
 import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { kernelEntry, walkLinkChain } from "./link-chain.js";
+import { shellQuote } from "../shell-quote.js";
 export const SNAPSHOT_BASENAME_PREFIX = "harness.gate-disable.";
 export const SNAPSHOT_BASENAME_SUFFIX = ".json";
-export const SNAPSHOT_VERSION = 1;
+/** Written by this version. Adds `step` on every removed group and `merges`. */
+export const SNAPSHOT_VERSION = 2;
+/** Written by releases before a second disable merged into the live snapshot; still restorable. */
+export const LEGACY_SNAPSHOT_VERSION = 1;
+/** A retired snapshot keeps its name with this suffix instead of plain `.json`. */
+export const RETIRED_SNAPSHOT_SUFFIX = ".restored.json";
+/** A snapshot whose groups were carried into a snapshot at another place keeps its name with this suffix. */
+export const SUPERSEDED_SNAPSHOT_SUFFIX = ".superseded.json";
 export function sha256Hex(input) {
     return crypto.createHash("sha256").update(input).digest("hex");
 }
@@ -37,9 +53,11 @@ export function backupPath(settingsPath, now) {
  * Return all gate-disable snapshot paths in `settingsDir`, newest-first
  * by mtime. Missing directory returns []. Any file that isn't a valid
  * snapshot is silently skipped — `gate enable` re-parses the candidates
- * and surfaces format errors at that point.
+ * and surfaces format errors at that point. `prefix` selects the snapshot
+ * family: the Claude settings snapshots by default, the Codex ones when the
+ * Codex gate passes its own prefix (`codex-snapshot.ts`).
  */
-export function listSnapshots(settingsDir) {
+export function listSnapshots(settingsDir, prefix = SNAPSHOT_BASENAME_PREFIX) {
     let names;
     try {
         names = fs.readdirSync(settingsDir);
@@ -49,7 +67,7 @@ export function listSnapshots(settingsDir) {
     }
     const candidates = [];
     for (const name of names) {
-        if (!name.startsWith(SNAPSHOT_BASENAME_PREFIX))
+        if (!name.startsWith(prefix))
             continue;
         if (!name.endsWith(SNAPSHOT_BASENAME_SUFFIX))
             continue;
@@ -67,6 +85,33 @@ export function listSnapshots(settingsDir) {
     candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
     return candidates.map((c) => c.filePath);
 }
+/**
+ * The reason a parsed snapshot lacks one of the required string fields or
+ * its `filter` object, or null when it has them all. Shared by the Claude
+ * and Codex snapshot readers so the two cannot drift apart.
+ */
+export function snapshotFieldProblem(filePath, obj, stringFields) {
+    for (const field of stringFields) {
+        if (typeof obj[field] !== "string") {
+            return `snapshot ${filePath} is missing string field "${field}"`;
+        }
+    }
+    if (typeof obj["filter"] !== "object" || obj["filter"] === null) {
+        return `snapshot ${filePath} is missing object field "filter"`;
+    }
+    return null;
+}
+/**
+ * Whether a snapshot's recorded `settingsPath` names a file: only its
+ * basename tells which directory entry the snapshot belongs to, so a path
+ * that has none (empty, or ending in `.` or `..`) records no target.
+ */
+function hasRecordedTarget(recorded) {
+    if (typeof recorded !== "string")
+        return false;
+    const name = path.basename(recorded);
+    return name !== "" && name !== "." && name !== "..";
+}
 /**
  * Parse a snapshot file. Validates structural shape only — the body's
  * `removed[].group` payload is opaque (preserved verbatim from
@@ -91,29 +136,443 @@ export function readSnapshot(filePath) {
         return { ok: false, reason: `snapshot ${filePath} is not a JSON object` };
     }
     const obj = parsed;
-    if (obj["version"] !== SNAPSHOT_VERSION) {
+    if (obj["version"] !== SNAPSHOT_VERSION && obj["version"] !== LEGACY_SNAPSHOT_VERSION) {
+        return {
+            ok: false,
+            reason: `snapshot ${filePath} has unsupported version ${JSON.stringify(obj["version"])}; ` +
+                `expected ${LEGACY_SNAPSHOT_VERSION} or ${SNAPSHOT_VERSION}`,
+        };
+    }
+    if (!hasRecordedTarget(obj["settingsPath"])) {
         return {
             ok: false,
-            reason: `snapshot ${filePath} has unsupported version ${JSON.stringify(obj["version"])}; expected ${SNAPSHOT_VERSION}`,
+            reason: `snapshot ${filePath} has no recorded target (its "settingsPath" is missing or empty), so it cannot be ` +
+                `matched to a settings file`,
         };
     }
-    for (const field of [
+    const problem = snapshotFieldProblem(filePath, obj, [
         "createdAt",
         "settingsPath",
         "settingsBackupPath",
         "settingsBeforeSha256",
         "settingsAfterSha256",
-    ]) {
-        if (typeof obj[field] !== "string") {
-            return { ok: false, reason: `snapshot ${filePath} is missing string field "${field}"` };
-        }
-    }
-    if (typeof obj["filter"] !== "object" || obj["filter"] === null) {
-        return { ok: false, reason: `snapshot ${filePath} is missing object field "filter"` };
-    }
+    ]);
+    if (problem !== null)
+        return { ok: false, reason: problem };
     if (!Array.isArray(obj["removed"])) {
         return { ok: false, reason: `snapshot ${filePath} is missing array field "removed"` };
     }
     return { ok: true, snapshot: obj };
 }
+/** The name a snapshot is renamed to once retired. The file stays for audit. */
+export function retiredSnapshotPath(snapPath) {
+    return `${snapPath.slice(0, -SNAPSHOT_BASENAME_SUFFIX.length)}${RETIRED_SNAPSHOT_SUFFIX}`;
+}
+/**
+ * Retire `snapPath` as superseded (rename it, keep it for audit) and return
+ * the new path: its groups were merged into a snapshot beside the file they
+ * were removed from, so it is not restored and never offered again.
+ */
+export function supersedeSnapshot(snapPath) {
+    const to = `${snapPath.slice(0, -SNAPSHOT_BASENAME_SUFFIX.length)}${SUPERSEDED_SNAPSHOT_SUFFIX}`;
+    fs.renameSync(snapPath, to);
+    return to;
+}
+/** Retire `snapPath` (rename it, keep it for audit) and return the new path. */
+export function retireSnapshot(snapPath) {
+    const to = retiredSnapshotPath(snapPath);
+    fs.renameSync(snapPath, to);
+    return to;
+}
+/** Whether two names differ at most in letter case or Unicode normalization form. */
+function foldsTo(a, b) {
+    return a.normalize("NFC").toLowerCase() === b.normalize("NFC").toLowerCase();
+}
+/**
+ * Whether `recordedName`, in `dir`, is the directory entry `targetName`
+ * names. The same spelling is, by definition: snapshots sit beside their
+ * file and record its basename, so the name is the identity. A spelling that
+ * differs only in letter case or normalization is the same entry only on a
+ * filesystem that folds those (APFS by default), which `lstat` tells: both
+ * names must resolve to one regular file (neither a symlink) whose link
+ * count is 1, so no second name of that inode could be the one that matched.
+ * Every other name is another entry (a hard link, a symlink, a renamed file):
+ * restoring through it would write a new file at that name and leave the
+ * recorded file as the disable left it.
+ *
+ * `symlinks` lets the entry be a symlink itself (a symlinked Codex config,
+ * which the gate edits at its resolved target): two spellings then name one
+ * entry when `lstat` gives both the same device and inode and a link count of
+ * 1, as for a regular file. The Claude gate never sets it.
+ */
+export function namesSameEntry(dir, recordedName, targetName, opts = {}) {
+    if (recordedName === targetName)
+        return true;
+    if (!foldsTo(recordedName, targetName))
+        return false;
+    let recorded;
+    let target;
+    try {
+        recorded = fs.lstatSync(path.join(dir, recordedName), { bigint: true });
+        target = fs.lstatSync(path.join(dir, targetName), { bigint: true });
+    }
+    catch {
+        return false;
+    }
+    const kind = (st) => st.isFile() ? "file" : opts.symlinks === true && st.isSymbolicLink() ? "link" : null;
+    return (kind(recorded) !== null &&
+        kind(recorded) === kind(target) &&
+        recorded.dev === target.dev &&
+        recorded.ino === target.ino &&
+        recorded.nlink === 1n &&
+        target.nlink === 1n);
+}
+/**
+ * The spelling of `settingsPath` the gate builds every other path from: the
+ * backup, the snapshot, the listing beside it, and the atomic write's temp
+ * file. A spelling with a `..` segment is replaced by its directory as the
+ * kernel resolves it (`kernelEntry`, which the Codex gate uses as well), so
+ * no path built from it is folded into another directory; every other
+ * spelling is kept as given and the paths the gate prints read the way they
+ * were written.
+ */
+export function settingsOwnEntry(settingsPath) {
+    return kernelEntry(settingsPath);
+}
+/**
+ * The file `gate disable` and `gate enable` read and write for `settingsPath`.
+ * That is the path itself unless its last component is a symlink (a dotfiles
+ * setup): then it is the entry the link leads to, which may sit in another
+ * directory. Writing through the resolved entry keeps the link a link, and
+ * the snapshots sit beside the file itself, so a disable through either
+ * spelling is found by an enable through the other. Every hop of the chain is
+ * resolved the way the kernel resolves it (`walkLinkChain`, the walker the
+ * Codex gate uses too), so the file is the one reading through the path
+ * gives, `..` in a link text included. A link whose file is gone resolves to
+ * where the file would be, so the snapshots taken for it are still found; a
+ * link whose text passes through a directory that is gone resolves to that
+ * text as written (nothing can sit beside it). A path that is no link, and a
+ * loop, resolve to the path's own entry (`settingsOwnEntry`).
+ */
+export function resolveSettingsEntry(settingsPath) {
+    const { chain, end } = walkLinkChain(settingsPath);
+    if (chain.length === 1 || end === "loop")
+        return settingsOwnEntry(settingsPath);
+    // Every hop after the first is a physical directory and a name (the file's real path), unless the walk ended
+    // in a directory that is gone: then it is the link text as written.
+    return chain[chain.length - 1] ?? settingsPath;
+}
+/**
+ * The identity of a file across spellings of its directory, or the path itself
+ * when it cannot be resolved. The native `realpath` takes `d/..` through the
+ * real location of `d`, as the listing that found the file did.
+ */
+function fileIdentity(file) {
+    try {
+        return fs.realpathSync.native(file);
+    }
+    catch {
+        return file;
+    }
+}
+/**
+ * The live (not retired) snapshots that were taken for `settingsPath`,
+ * newest first by `createdAt`. Snapshots always sit beside their file, so
+ * only the basename of the recorded settings path counts, never how the
+ * directory was spelled when it was written (relative to some other working
+ * directory, or through a symlink): a snapshot belongs to the file when the
+ * target names the directory entry that basename names (`namesSameEntry`:
+ * the same spelling, or another spelling of the one entry on a
+ * case-insensitive filesystem). When `settingsPath` is itself a symlink
+ * (`resolveSettingsEntry`), the directory of the file it leads to is searched
+ * too, with the resolved entry as the target there: the snapshot of a disable
+ * made through the other spelling sits beside that file. A hard link to the
+ * file, a renamed file, or a snapshot found beside the file a symlink leads
+ * to but recorded under the symlink's own name is another entry, so a
+ * snapshot recorded for one is foreign to the other, whether or not the files
+ * exist. A snapshot for another settings file in the same directory is
+ * listed in `skippedForeign`, never dropped silently. A live snapshot that
+ * cannot be read, or records no target, is an error: its target cannot be
+ * told, so neither disable nor enable may go on as if it did not exist.
+ */
+export function listLiveSnapshots(settingsPath) {
+    const own = settingsOwnEntry(settingsPath);
+    const resolved = resolveSettingsEntry(settingsPath);
+    const places = [{ dir: path.dirname(own), name: path.basename(own) }];
+    if (resolved !== own) {
+        places.push({ dir: path.dirname(resolved), name: path.basename(resolved) });
+    }
+    const live = new Map();
+    const foreign = new Map();
+    for (const { dir, name: targetName } of places) {
+        for (const file of listSnapshots(dir)) {
+            if (file.endsWith(RETIRED_SNAPSHOT_SUFFIX) || file.endsWith(SUPERSEDED_SNAPSHOT_SUFFIX))
+                continue;
+            const id = fileIdentity(file);
+            const read = readSnapshot(file);
+            if (!read.ok)
+                return { ok: false, reason: read.reason, path: file };
+            const recordedName = path.basename(read.snapshot.settingsPath);
+            if (!namesSameEntry(dir, recordedName, targetName)) {
+                const recordedPath = path.join(dir, recordedName);
+                foreign.set(id, {
+                    path: file,
+                    settingsPath: recordedPath,
+                    settingsExists: fs.existsSync(recordedPath),
+                    settingsBackupPath: read.snapshot.settingsBackupPath,
+                });
+                continue;
+            }
+            live.set(id, { path: file, snapshot: read.snapshot });
+        }
+    }
+    const liveList = [...live.values()];
+    liveList.sort((a, b) => {
+        if (a.snapshot.createdAt !== b.snapshot.createdAt) {
+            return a.snapshot.createdAt < b.snapshot.createdAt ? 1 : -1;
+        }
+        return a.path < b.path ? 1 : -1;
+    });
+    // A snapshot the other spelling's directory owns is not foreign to the file.
+    const skippedForeign = [...foreign].filter(([id]) => !live.has(id)).map(([, f]) => f);
+    return { ok: true, live: liveList, skippedForeign };
+}
+const READ_ONLY_CODES = new Set(["EACCES", "EPERM", "EROFS"]);
+/** Whether a write failed because the directory or filesystem does not allow it to be written. */
+export function isReadOnlyWriteError(err) {
+    const code = err?.code;
+    return typeof code === "string" && READ_ONLY_CODES.has(code);
+}
+/**
+ * What a gate refusal says first when the file a settings symlink leads to
+ * cannot be written where it sits: what the link is and what refuses. EACCES
+ * and EROFS come from the directory (the gate writes a temp file beside the
+ * file and renames it into place); EPERM can come from the file or from the
+ * directory (an immutable flag, a sticky directory), so it names both without
+ * saying which. Each verb adds its own way out.
+ */
+export function readOnlyLinkTargetText(settingsPath, entry, err) {
+    const code = err.code;
+    const refuses = code === "EPERM"
+        ? `the file ${entry} or the directory ${path.dirname(entry)} that holds it`
+        : `the directory ${path.dirname(entry)} that holds that file`;
+    return `${settingsPath} is a symlink to ${entry}, and ${refuses} cannot be written (${code}), so the gate cannot write there.`;
+}
+/** What a read-only refusal tells the operator to make writable: the directory, and for EPERM the file too. */
+export function readOnlyWritablePlace(entry, err) {
+    return err.code === "EPERM"
+        ? `${entry} and ${path.dirname(entry)}`
+        : path.dirname(entry);
+}
+/** The command that puts a copy of the file a symlink leads to in place of the link. */
+export function copyOverLinkCommand(settingsPath, entry) {
+    const copy = `${settingsPath}.copy`;
+    return `cp ${shellQuote(entry)} ${shellQuote(copy)} && mv ${shellQuote(copy)} ${shellQuote(settingsPath)}`;
+}
+/**
+ * How a command prints a `--settings` target so that it works as printed: a
+ * path with a character the shell would act on (a space, a quote, `~`, `=`,
+ * `%`, `$`) is single-quoted by the one quoting helper the gate shares.
+ */
+export function settingsFlag(settingsPath) {
+    return `--settings ${shellQuote(settingsPath)}`;
+}
+function groupMatcherOf(group) {
+    if (group === null || typeof group !== "object" || Array.isArray(group))
+        return null;
+    const m = group["matcher"];
+    return typeof m === "string" ? m : null;
+}
+/** `PreToolUse matcher="Bash"`: how a message names a removed group. */
+export function groupLabel(event, group) {
+    return `${event} matcher=${JSON.stringify(groupMatcherOf(group))}`;
+}
+/** The `command` strings of a hook group's hooks, in order; empty for a malformed group. */
+export function groupCommands(group) {
+    if (group === null || typeof group !== "object" || Array.isArray(group))
+        return [];
+    const inner = group["hooks"];
+    const cmds = [];
+    for (const h of Array.isArray(inner) ? inner : []) {
+        if (h !== null && typeof h === "object" && !Array.isArray(h)) {
+            const cmd = h["command"];
+            if (typeof cmd === "string")
+                cmds.push(cmd);
+        }
+    }
+    return cmds;
+}
+function commandsText(group) {
+    const cmds = groupCommands(group);
+    return cmds.length === 0 ? "no command" : cmds.map((c) => `\`${c}\``).join(", ");
+}
+/**
+ * How a refusal names a removed group that is still missing: its event and
+ * matcher plus its commands, so that when another group shares the matcher
+ * the operator can tell which one is out of the file.
+ */
+export function missingLabel(entry) {
+    return `${groupLabel(entry.event, entry.group)} running ${commandsText(entry.group)}`;
+}
+/**
+ * JSON with the keys of every object sorted, so two groups compare equal
+ * whatever order an editor or an apply wrote their keys in.
+ */
+function canonicalJson(value) {
+    return JSON.stringify(value, (_key, v) => v !== null && typeof v === "object" && !Array.isArray(v)
+        ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)))
+        : v);
+}
+/** Names a changed group and the commands of both versions, so the operator can tell whether it is the gate's. */
+export function changedLabel(changed) {
+    const was = commandsText(changed.entry.group);
+    const now = commandsText(changed.current);
+    return (`${groupLabel(changed.entry.event, changed.entry.group)}: the snapshot's group runs ${was}, ` +
+        `the file's group runs ${now}${was === now ? " (they differ in another field)" : ""}`);
+}
+/**
+ * What putting a snapshot's removed groups back into `current` would do. The
+ * entries are paired with the groups of the file one to one: first every
+ * entry with a deep-equal group of the same event (`alreadyBack`), then each
+ * entry left over, in the order the snapshot recorded them, with the first
+ * group still unpaired that has its event and matcher (`changed`). The rest
+ * are spliced in at their recorded positions: each removal step recorded its
+ * indices against the array as it stood just before that step, so the steps
+ * are undone newest first, and inside a step by event and ascending index (an
+ * earlier insertion never shifts a later insertion's target index past the
+ * array end).
+ */
+export function planRestore(current, snapshot) {
+    const hooks = {};
+    const unpaired = new Map();
+    for (const [event, groups] of Object.entries(current)) {
+        hooks[event] = groups.slice();
+        unpaired.set(event, groups.slice());
+    }
+    const take = (entry, same) => {
+        const pool = unpaired.get(entry.event) ?? [];
+        const at = pool.findIndex(same);
+        return at === -1 ? [] : pool.splice(at, 1);
+    };
+    const alreadyBack = [];
+    const leftover = [];
+    for (const entry of snapshot.removed) {
+        const wanted = canonicalJson(entry.group);
+        if (take(entry, (g) => canonicalJson(g) === wanted).length > 0)
+            alreadyBack.push(entry);
+        else
+            leftover.push(entry);
+    }
+    const changed = [];
+    const missing = [];
+    for (const entry of leftover) {
+        const matcher = groupMatcherOf(entry.group);
+        const [match] = take(entry, (g) => groupMatcherOf(g) === matcher);
+        if (match !== undefined)
+            changed.push({ entry, current: match });
+        else
+            missing.push(entry);
+    }
+    const restored = missing.sort((a, b) => {
+        const stepA = a.step ?? 0;
+        const stepB = b.step ?? 0;
+        if (stepA !== stepB)
+            return stepB - stepA;
+        if (a.event !== b.event)
+            return a.event < b.event ? -1 : 1;
+        return a.index - b.index;
+    });
+    for (const entry of restored) {
+        const arr = hooks[entry.event] ?? [];
+        arr.splice(Math.min(entry.index, arr.length), 0, entry.group);
+        hooks[entry.event] = arr;
+    }
+    return { hooks, restored, alreadyBack, changed };
+}
+/**
+ * The settings text `gate enable` writes when it puts `plan`'s groups back
+ * into the parsed settings file `obj`: `obj` with its `hooks` key replaced by
+ * `plan.hooks` (and removed when the plan holds no group at all).
+ */
+export function restoredSettingsText(obj, hooks) {
+    const newObj = { ...obj };
+    if (Object.keys(hooks).length === 0) {
+        delete newObj["hooks"];
+    }
+    else {
+        newObj["hooks"] = hooks;
+    }
+    return `${JSON.stringify(newObj, null, 2)}\n`;
+}
+/**
+ * The one decision of why `harness gate enable` refuses a snapshot against
+ * the current settings.json unless it was called with `--force`, or null when
+ * it restores or retires it without one:
+ * - `"changed-group"`: the file holds a group with the event and matcher of a
+ *   removed one but other content, which may be another hook sharing the
+ *   matcher, so it never counts as back on its own;
+ * - `"edited-settings"`: the file is not the state the snapshot left and the
+ *   groups that are still missing do not add up to the pre-disable file, so
+ *   a restore would write over an operator edit.
+ * The current file already matching the pre-disable state, and a snapshot
+ * whose every group is back, never refuse: nothing is put back. A changed
+ * group wins when both hold, as `gate enable` refuses for it before it
+ * reaches the edit check. `gate enable` throws on it, and `harness doctor`
+ * calls it to decide whether its warning for a gate-disabled hook must name
+ * `--force`; the two callers never re-implement the conditions.
+ */
+export function claudeEnableRefusal(currentSha, currentObj, plan, snapshot) {
+    if (currentSha === snapshot.settingsBeforeSha256)
+        return null;
+    if (plan.changed.length > 0)
+        return "changed-group";
+    if (plan.restored.length === 0)
+        return null;
+    const restoredSha = sha256Hex(restoredSettingsText(currentObj, plan.hooks));
+    if (currentSha !== snapshot.settingsAfterSha256 && restoredSha !== snapshot.settingsBeforeSha256) {
+        return "edited-settings";
+    }
+    return null;
+}
+/**
+ * The live snapshots a plain `harness gate enable` applies on its next call,
+ * in the order it applies them, from `listLiveSnapshots`' newest-first list.
+ * `gate enable` restores ONE snapshot per call and retires it, so today it is
+ * the newest alone: an older snapshot waits until that restore changed the
+ * file, which is exactly why its own refusal against the CURRENT file is not
+ * what the next plain enable will decide. `harness doctor` asks this question
+ * before it words the warning for a gate-disabled hook, and `gate enable` takes
+ * its snapshot through it too, so the two cannot drift apart on which one
+ * decides.
+ */
+export function nextEnableSnapshots(live) {
+    return live.slice(0, 1);
+}
+/**
+ * The `hooks` of a parsed settings.json as the gate reads them: an array of
+ * groups per event, each array copied, so a caller never mutates the parsed
+ * document. A `hooks` key that is absent reads as no groups at all; any other
+ * shape the gate refuses to read is a failure reason, not a guess:
+ * `hooks-not-object` when the field itself is not an object, and
+ * `event-not-array` naming the first event whose value is not an array.
+ * `gate enable` turns the two reasons into its two refusal messages, and
+ * `harness doctor` reads them the same way when it asks the gate what a
+ * plain `gate enable` would do with the file it compares; the two never
+ * re-implement the walk.
+ */
+export function parseSettingsHooks(doc) {
+    const rawHooks = doc["hooks"];
+    const hooks = {};
+    if (rawHooks === undefined)
+        return { ok: true, hooks };
+    if (rawHooks === null || typeof rawHooks !== "object" || Array.isArray(rawHooks)) {
+        return { ok: false, reason: "hooks-not-object" };
+    }
+    for (const [event, groups] of Object.entries(rawHooks)) {
+        if (!Array.isArray(groups))
+            return { ok: false, reason: "event-not-array", event };
+        hooks[event] = groups.slice();
+    }
+    return { ok: true, hooks };
+}
 //# sourceMappingURL=snapshot.js.map

package/dist/cli/gate/snapshot.js.map

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

package/dist/cli/index.d.ts

@@ -1,18 +1,9 @@
 import { Command } from "commander";
 export declare function defaultVersionProbe(cmd: readonly string[]): string | null;
-import { type RogueLedgerScanOptions } from "./doctor/rogue-ledger.js";
 export interface RunOptions {
     argv?: string[];
     stdout?: (s: string) => void;
     stderr?: (s: string) => void;
-    /**
-     * Test-injection knob for `harness doctor --rm-rogue-ledgers`. When set,
-     * both the initial scan (forwarded to `doctor()`) and the post-deletion
-     * re-scan use these options instead of the runtime `os.homedir()` /
-     * `process.cwd()` defaults. This makes the re-scan fully hermetic in unit
-     * tests without spawning real filesystem side-effects.
-     */
-    rogueLedgerScanOptions?: Partial<RogueLedgerScanOptions>;
 }
 export declare function buildProgram(opts?: RunOptions): Command;
 export declare function run(opts?: RunOptions): Promise<number>;