@open-tomato/rafa 0.24.0 → 0.26.0

package/dist/{index-7qgng1rf.js → index-azptzvp3.js}

@@ -1,31 +1,37 @@
 // @bun
 import {
   CONFIG_DEFAULTS,
+  CONFIG_FILE,
   FINDING_DOMAINS,
   FINDING_KINDS,
   FINDING_SIGNALS,
   activeOutput,
   activeOutputMode,
+  configFilePath,
   createTextOutput,
+  isStampableStub,
   readRafaBlocks
-} from "./index-twbp38kz.js";
+} from "./index-rv7y8y1j.js";
 import {
   bless,
   merge
 } from "./index-d6d0942q.js";
 import {
   commandSpelling
-} from "./index-4fwgqveh.js";
+} from "./index-4j1e3h26.js";
 import {
+  BUSY_TIMEOUT_MAX_MS,
+  BUSY_TIMEOUT_MIN_MS,
   RAFA_INSTINCTS_PATH,
   STORE_BACKENDS,
   bundledBinDirectory,
   describeValue,
+  isBusyTimeoutMs,
   isMapping,
   messageOf,
   resolveInstinctScopes,
   tierExists
-} from "./index-pmkgvtfe.js";
+} from "./index-sf2brh4w.js";
 import {
   actionHash,
   triggerKey
@@ -34,6 +40,9 @@ import {
 // src/adapters/registry.ts
 import { homedir } from "os";
 
+// src/effort/store/ndjson.ts
+import { join as join3 } from "path";
+
 // src/effort/store.ts
 import {
   appendFileSync,
@@ -53,8 +62,8 @@ function asObject(value) {
 function normaliseKey(key) {
   return typeof key === "string" && key.length > 0 ? key : null;
 }
-function effortStorePath(repoRoot, kind) {
-  return join(repoRoot, EFFORT_STORE_DIR, STORE_FILE_NAMES[kind]);
+function effortStoreFileName(kind) {
+  return STORE_FILE_NAMES[kind];
 }
 function readStoreText(path) {
   return existsSync(path) ? readFileSync(path, "utf8") : null;
@@ -141,6 +150,54 @@ function appendRows(path, rows, keyOf) {
   };
 }
 
+// src/effort/store/location.ts
+import { existsSync as existsSync2, realpathSync } from "fs";
+import { tmpdir } from "os";
+import { isAbsolute, join as join2, relative, resolve, sep } from "path";
+var EFFORT_DIR_VARIABLE = "RAFA_EFFORT_DIR";
+var TEST_PROCESS_VARIABLE = "RAFA_TEST";
+var TEST_ENTRY_SUFFIX = ".test.ts";
+function canonical(path) {
+  const resolved = resolve(path);
+  return existsSync2(resolved) ? realpathSync(resolved) : resolved;
+}
+function isWithin(path, dir) {
+  const between = relative(resolve(dir), resolve(path));
+  const climbsOut = between === ".." || between.startsWith(`..${sep}`);
+  return !climbsOut && !isAbsolute(between);
+}
+function readEffortDirOverride(repoRoot, env = process.env) {
+  const value = env[EFFORT_DIR_VARIABLE];
+  if (value === undefined || value === "")
+    return null;
+  if (!isAbsolute(value)) {
+    throw new Error(`effort store: ${EFFORT_DIR_VARIABLE} is not an absolute path (${value}); run this command again` + ` with ${EFFORT_DIR_VARIABLE} set to the absolute path 'rafa effort copy' printed.`);
+  }
+  if (canonical(value) === canonical(join2(repoRoot, EFFORT_STORE_DIR))) {
+    throw new Error(`effort store: ${EFFORT_DIR_VARIABLE} names this project's own store (${value}); it points a command` + " at a copy only. Copy the store with 'rafa effort copy' and run this command with" + ` ${EFFORT_DIR_VARIABLE}=<the copy>.`);
+  }
+  return value;
+}
+function effortStoreDir(repoRoot, env = process.env) {
+  return readEffortDirOverride(repoRoot, env) ?? join2(repoRoot, EFFORT_STORE_DIR);
+}
+function isTestProcess(main = Bun.main, env = process.env) {
+  return main.endsWith(TEST_ENTRY_SUFFIX) || env[TEST_PROCESS_VARIABLE] === "1";
+}
+function isUnderTempDir(path, tempDir = tmpdir()) {
+  return isWithin(path, tempDir) || isWithin(path, canonical(tempDir));
+}
+function currentProbe() {
+  return { main: Bun.main, env: process.env, tempDir: tmpdir() };
+}
+function guardTestProcess(path, probe = currentProbe()) {
+  if (!isTestProcess(probe.main, probe.env))
+    return;
+  if (isUnderTempDir(path, probe.tempDir))
+    return;
+  throw new Error(`effort store: a test opened ${resolve(path)}, outside the temp directory ${probe.tempDir};` + " a test opens stores under tmpdir() only");
+}
+
 // src/effort/store/types.ts
 function keyOrNull(value) {
   return typeof value === "string" && value.length > 0 ? value : null;
@@ -151,15 +208,23 @@ var EFFORT_KEY_PROJECTIONS = {
 };
 
 // src/effort/store/ndjson.ts
+function kindPath(repoRoot, kind) {
+  return join3(effortStoreDir(repoRoot), effortStoreFileName(kind));
+}
+function openedKindPath(repoRoot, kind) {
+  const path = kindPath(repoRoot, kind);
+  guardTestProcess(path);
+  return path;
+}
 function readKind(repoRoot, kind) {
-  return readStoreRows(effortStorePath(repoRoot, kind));
+  return readStoreRows(openedKindPath(repoRoot, kind));
 }
 function keysOfKind(repoRoot, kind) {
-  const path = effortStorePath(repoRoot, kind);
+  const path = openedKindPath(repoRoot, kind);
   return collectedKeys(path, EFFORT_KEY_PROJECTIONS[kind]);
 }
 function appendKind(repoRoot, kind, rows) {
-  const path = effortStorePath(repoRoot, kind);
+  const path = openedKindPath(repoRoot, kind);
   return appendRows(path, rows, EFFORT_KEY_PROJECTIONS[kind]);
 }
 function openNdjsonStore(repoRoot) {
@@ -167,19 +232,461 @@ function openNdjsonStore(repoRoot) {
     append: (kind, rows) => appendKind(repoRoot, kind, rows),
     keys: (kind) => keysOfKind(repoRoot, kind),
     read: (kind) => readKind(repoRoot, kind).rows,
-    path: (kind) => effortStorePath(repoRoot, kind),
+    path: (kind) => kindPath(repoRoot, kind),
     readRows: (kind) => readKind(repoRoot, kind)
   };
 }
 
 // src/effort/store/sqlite.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname6, join as join7 } from "path";
 import { Database } from "bun:sqlite";
 
+// package.json
+var name = "@open-tomato/rafa";
+var version = "0.26.0";
+
+// src/cli/version.ts
+var RAFA_VERSION = version;
+function versionLine() {
+  return `rafa ${RAFA_VERSION}`;
+}
+
+// src/effort/store/development-build.ts
+import { tmpdir as tmpdir2 } from "os";
+import { basename as basename2, dirname as dirname5, isAbsolute as isAbsolute3 } from "path";
+
+// src/loop/sessions.ts
+import {
+  linkSync,
+  mkdirSync as mkdirSync2,
+  readdirSync,
+  readFileSync as readFileSync2,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { basename, dirname as dirname3, join as join5 } from "path";
+
+// src/project/scope.ts
+import { existsSync as existsSync3, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join4 } from "path";
+var SCOPE_DIR = dirname2(CONFIG_FILE);
+var INIT_COMMAND = "rafa init";
+var DISK_FILE_SYSTEM = Object.freeze({
+  exists: (path) => existsSync3(path),
+  realpath: (path) => realpathSync2(path)
+});
+
+class ScopeError extends Error {
+  constructor(message, options) {
+    super(`rafa scope: ${message}`, options);
+    this.name = "ScopeError";
+  }
+}
+function scopeAt(base) {
+  return { dir: join4(base, SCOPE_DIR), configFile: configFilePath(base) };
+}
+function initHint(start, passedUserConfig = null) {
+  const passed = passedUserConfig === null ? [] : [`${passedUserConfig} is the user scope's config and marks no project`];
+  return [
+    `not inside a rafa project: no ${CONFIG_FILE} in ${start} or any directory above it`,
+    ...passed,
+    `run \`${INIT_COMMAND}\` to set one up`
+  ].join(`
+`);
+}
+function requireAbsolute(label, path) {
+  if (!isAbsolute2(path)) {
+    throw new ScopeError(`${label} is ${describeValue(path)}, expected an absolute path`);
+  }
+}
+function realStartOf(start, fs) {
+  try {
+    return fs.realpath(start);
+  } catch (error) {
+    const message = `start directory ${start} does not resolve (${messageOf(error)})`;
+    throw new ScopeError(message, { cause: error });
+  }
+}
+function realHomeOf(home, fs) {
+  try {
+    return fs.realpath(home);
+  } catch {
+    return null;
+  }
+}
+function selfAndAncestors(path) {
+  const parent = dirname2(path);
+  return parent === path ? [path] : [path, ...selfAndAncestors(parent)];
+}
+function walkUp(realStart, realHome, fs) {
+  let passedUserConfig = false;
+  for (const dir of selfAndAncestors(realStart)) {
+    if (!fs.exists(configFilePath(dir)))
+      continue;
+    if (dir !== realHome)
+      return { root: dir, passedUserConfig };
+    passedUserConfig = true;
+  }
+  return { root: null, passedUserConfig };
+}
+function resolveScope(start, seams) {
+  const { home, fs = DISK_FILE_SYSTEM } = seams;
+  requireAbsolute("start directory", start);
+  requireAbsolute("home directory", home);
+  const user = scopeAt(home);
+  const walk = walkUp(realStartOf(start, fs), realHomeOf(home, fs), fs);
+  if (walk.root === null) {
+    const passed = walk.passedUserConfig ? user.configFile : null;
+    return { found: false, start, home, user, hint: initHint(start, passed) };
+  }
+  return { found: true, root: walk.root, home, project: scopeAt(walk.root), user };
+}
+
+// src/loop/sessions.ts
+var SESSION_STATES = Object.freeze(["running", "paused", "stopped", "done"]);
+var RUNS_DIR = "runs";
+var RECORD_EXTENSION = ".json";
+var SESSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+
+class SessionRecordError extends Error {
+  file;
+  constructor(file, problem) {
+    super(`session record ${file}: ${problem}`);
+    this.name = "SessionRecordError";
+    this.file = file;
+  }
+}
+
+class SessionConflictError extends Error {
+  conflicts;
+  constructor(conflicts) {
+    const named = conflicts.map((conflict) => `${conflict.record.sessionId} (${conflict.reason})`);
+    super(`the plan's sessions refuse the run: ${named.join(", ")}`);
+    this.name = "SessionConflictError";
+    this.conflicts = conflicts;
+  }
+}
+
+class SessionStateError extends Error {
+  file;
+  state;
+  constructor(file, state, onlyFrom) {
+    const acted = onlyFrom.length === 0 ? "no state" : onlyFrom.join(" or ");
+    super(`session record ${file}: stores ${state}, and the change acts on ${acted} alone`);
+    this.name = "SessionStateError";
+    this.file = file;
+    this.state = state;
+  }
+}
+function isSessionId(value) {
+  return SESSION_ID_PATTERN.test(value);
+}
+function runsDir(root) {
+  return join5(scopeAt(root).dir, RUNS_DIR);
+}
+function sessionFilePath(root, sessionId) {
+  if (!isSessionId(sessionId)) {
+    throw new Error(`session record: unusable session id ${JSON.stringify(sessionId)}`);
+  }
+  return join5(runsDir(root), `${sessionId}${RECORD_EXTENSION}`);
+}
+function describeValue2(value) {
+  return value === undefined ? "missing" : JSON.stringify(value) ?? String(value);
+}
+function field(fields, key) {
+  return Object.hasOwn(fields, key) ? fields[key] : undefined;
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveWhole(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isText(value) {
+  return typeof value === "string" && value.trim() !== "";
+}
+function taskProblem(task) {
+  if (task === null)
+    return null;
+  if (!isObject(task))
+    return `task is ${describeValue2(task)}, expected null or an object`;
+  if (!isPositiveWhole(field(task, "line"))) {
+    return `task.line is ${describeValue2(field(task, "line"))}, expected a whole number from 1`;
+  }
+  return isText(field(task, "text")) ? null : `task.text is ${describeValue2(field(task, "text"))}, expected a non-empty string`;
+}
+function sessionIdProblem(sessionId, file) {
+  if (typeof sessionId !== "string" || !isSessionId(sessionId)) {
+    return `sessionId is ${describeValue2(sessionId)}, expected a plain file name`;
+  }
+  return basename(file) === `${sessionId}${RECORD_EXTENSION}` ? null : `sessionId ${JSON.stringify(sessionId)} is not the file's name`;
+}
+function planStubProblem(planStub) {
+  return planStub === null || typeof planStub === "string" && isStampableStub(planStub) ? null : `planStub is ${describeValue2(planStub)}, expected null or a plan stub`;
+}
+function textProblems(fields) {
+  return ["plan", "branch"].filter((key) => !isText(field(fields, key))).map((key) => `${key} is ${describeValue2(field(fields, key))}, expected a non-empty string`);
+}
+function recordProblems(fields, file) {
+  const pid = field(fields, "pid");
+  const startedAt = field(fields, "startedAt");
+  const state = field(fields, "state");
+  const problems = [
+    sessionIdProblem(field(fields, "sessionId"), file),
+    planStubProblem(field(fields, "planStub")),
+    ...textProblems(fields),
+    isPositiveWhole(pid) ? null : `pid is ${describeValue2(pid)}, expected a whole number from 1`,
+    typeof startedAt === "string" && !Number.isNaN(Date.parse(startedAt)) ? null : `startedAt is ${describeValue2(startedAt)}, expected a timestamp`,
+    SESSION_STATES.includes(state) ? null : `state is ${describeValue2(state)}, expected one of ${SESSION_STATES.join(", ")}`,
+    taskProblem(field(fields, "task"))
+  ];
+  return problems.filter((problem) => problem !== null);
+}
+function freezeRecord(fields) {
+  const task = field(fields, "task");
+  return Object.freeze({
+    sessionId: field(fields, "sessionId"),
+    planStub: field(fields, "planStub"),
+    plan: field(fields, "plan"),
+    branch: field(fields, "branch"),
+    pid: field(fields, "pid"),
+    startedAt: field(fields, "startedAt"),
+    state: field(fields, "state"),
+    task: isObject(task) ? Object.freeze({ line: field(task, "line"), text: field(task, "text") }) : null
+  });
+}
+function parseSessionRecord(text, file) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch (error) {
+    throw new SessionRecordError(file, `holds no JSON: ${messageOf(error)}`);
+  }
+  if (!isObject(parsed))
+    throw new SessionRecordError(file, "holds no JSON object");
+  const problems = recordProblems(parsed, file);
+  if (problems.length > 0)
+    throw new SessionRecordError(file, problems.join("; "));
+  return freezeRecord(parsed);
+}
+function errorCode(error) {
+  return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : null;
+}
+function isPidAlive(pid) {
+  if (!isPositiveWhole(pid))
+    return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return errorCode(error) === "EPERM";
+  }
+}
+function readState(record, isAlive = isPidAlive) {
+  if (record.state === "stopped" || record.state === "done")
+    return record.state;
+  return isAlive(record.pid) ? record.state : "stopped";
+}
+function readRecordFile(file) {
+  let text;
+  try {
+    text = readFileSync2(file, "utf8");
+  } catch (error) {
+    throw new SessionRecordError(file, `cannot be read: ${messageOf(error)}`);
+  }
+  return parseSessionRecord(text, file);
+}
+function recordNames(dir) {
+  try {
+    return readdirSync(dir);
+  } catch (error) {
+    if (errorCode(error) === "ENOENT")
+      return [];
+    throw new SessionRecordError(dir, `cannot be listed: ${messageOf(error)}`);
+  }
+}
+function byStart(a, b) {
+  return Date.parse(a.startedAt) - Date.parse(b.startedAt) || a.sessionId.localeCompare(b.sessionId);
+}
+function readSessions(root, seams = {}) {
+  const dir = runsDir(root);
+  const isAlive = seams.isAlive ?? isPidAlive;
+  const records = recordNames(dir).filter((name2) => name2.endsWith(RECORD_EXTENSION)).map((name2) => readRecordFile(join5(dir, name2))).map((record) => Object.freeze({ ...record, state: readState(record, isAlive) }));
+  return Object.freeze(records.sort(byStart));
+}
+function readSession(root, sessionId, seams = {}) {
+  const record = readRecordFile(sessionFilePath(root, sessionId));
+  return Object.freeze({ ...record, state: readState(record, seams.isAlive ?? isPidAlive) });
+}
+function samePlan(a, b) {
+  if (a.planStub !== null || b.planStub !== null)
+    return a.planStub === b.planStub;
+  return a.plan === b.plan;
+}
+function sessionConflicts(records, candidate) {
+  return records.filter((record) => samePlan(record, candidate)).flatMap((record) => {
+    if (record.branch !== candidate.branch)
+      return [{ reason: "branch", record }];
+    return record.state === "running" || record.state === "paused" ? [{ reason: "live", record }] : [];
+  });
+}
+function checkRecord(record, file) {
+  const problems = recordProblems(record, file);
+  if (problems.length > 0)
+    throw new SessionRecordError(file, `not written: ${problems.join("; ")}`);
+}
+function writeRecordFile(file, record, isNew) {
+  checkRecord(record, file);
+  mkdirSync2(dirname3(file), { recursive: true });
+  const temporary = `${file}.${process.pid}.tmp`;
+  writeFileSync(temporary, `${JSON.stringify(record, null, 2)}
+`);
+  try {
+    if (isNew)
+      linkSync(temporary, file);
+    else
+      renameSync(temporary, file);
+  } finally {
+    rmSync(temporary, { force: true });
+  }
+}
+function beginSession(root, draft, seams = {}) {
+  const file = sessionFilePath(root, draft.sessionId);
+  const record = freezeRecord({ ...draft, state: "running", task: null });
+  const conflicts = sessionConflicts(readSessions(root, seams), record);
+  if (conflicts.length > 0)
+    throw new SessionConflictError(conflicts);
+  writeRecordFile(file, record, true);
+  return record;
+}
+function updateSession(root, sessionId, change) {
+  const file = sessionFilePath(root, sessionId);
+  const stored = readRecordFile(file);
+  if (change.onlyFrom !== undefined && !change.onlyFrom.includes(stored.state)) {
+    throw new SessionStateError(file, stored.state, change.onlyFrom);
+  }
+  const record = freezeRecord({
+    ...stored,
+    state: change.state ?? stored.state,
+    task: change.task === undefined ? stored.task : change.task
+  });
+  writeRecordFile(file, record, false);
+  return record;
+}
+
+// src/runtime/identity.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, realpathSync as realpathSync3 } from "fs";
+import { dirname as dirname4, join as join6, resolve as resolve2 } from "path";
+var MANIFEST = "package.json";
+var CHECKOUT_ENTRY = join6("src", "rafa.ts");
+function realOrResolved(path) {
+  const resolved = resolve2(path);
+  return existsSync4(resolved) ? realpathSync3(resolved) : resolved;
+}
+function manifestName(file) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(file, "utf8"));
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+    return null;
+  const name2 = parsed["name"];
+  return typeof name2 === "string" ? name2 : null;
+}
+function nearestRafaPackage(start) {
+  let dir = start;
+  for (;; ) {
+    const manifest = join6(dir, MANIFEST);
+    if (existsSync4(manifest) && manifestName(manifest) === name)
+      return dir;
+    const parent = dirname4(dir);
+    if (parent === dir)
+      return null;
+    dir = parent;
+  }
+}
+function readRuntimeIdentity(entry = Bun.main) {
+  const real = realOrResolved(entry);
+  const packageDir = nearestRafaPackage(dirname4(real));
+  if (packageDir !== null && existsSync4(join6(packageDir, CHECKOUT_ENTRY))) {
+    return { kind: "development", entry: real, checkout: packageDir };
+  }
+  return { kind: "installed", entry: real };
+}
+
+// src/effort/store/development-build.ts
+var DEVELOPMENT_NEXT_STEP = "rafa effort copy";
+var ADOPTION_NAME = "schema_migrations";
+var EFFORT_DIR_NAME = "effort";
+var DEVELOPMENT_MARK = "+dev:";
+function appliedByName(identity) {
+  return identity.kind === "development" ? `${RAFA_VERSION}${DEVELOPMENT_MARK}${identity.checkout}` : RAFA_VERSION;
+}
+
+class DevelopmentBuildRefusedError extends Error {
+  path;
+  nextStep;
+  constructor(path, message) {
+    super(message);
+    this.name = "DevelopmentBuildRefusedError";
+    this.path = path;
+    this.nextStep = DEVELOPMENT_NEXT_STEP;
+  }
+}
+function storeProjectRoot(path) {
+  const storeDir = dirname5(path);
+  const scopeDir = dirname5(storeDir);
+  if (basename2(storeDir) !== EFFORT_DIR_NAME || basename2(scopeDir) !== SCOPE_DIR)
+    return null;
+  return dirname5(scopeDir);
+}
+function isOwnedStore(path, env, tempDir) {
+  if (isUnderTempDir(path, tempDir))
+    return true;
+  const override = env[EFFORT_DIR_VARIABLE];
+  if (override === undefined || override === "" || !isAbsolute3(override))
+    return false;
+  return storeProjectRoot(path) === null && isUnderTempDir(path, override);
+}
+function loopSentence(record) {
+  return ` Loop ${record.sessionId} (pid ${String(record.pid)}, plan ${record.planStub ?? record.plan}) is running on this store.`;
+}
+function liveLoopSentences(path, isAlive) {
+  const root = storeProjectRoot(path);
+  if (root === null)
+    return "";
+  try {
+    return readSessions(root, { isAlive }).filter((record) => record.state === "running" || record.state === "paused").map(loopSentence).join("");
+  } catch (error) {
+    return ` The loop records under ${runsDir(root)} could not be read (${messageOf(error)}).`;
+  }
+}
+function developmentRefusalText(path, needs, checkout, loops) {
+  return `effort store: ${path} needs migration ${needs.join(", ")} and this rafa is a development build (${checkout});` + ` a development build migrates only a store under the temp directory or ${EFFORT_DIR_VARIABLE}.` + ` Copy it with '${DEVELOPMENT_NEXT_STEP}' and run this command with ${EFFORT_DIR_VARIABLE}=<the copy>.` + loops;
+}
+function refuseUnownedDevelopmentWrite(path, needs, probe = {}) {
+  const identity = probe.identity ?? readRuntimeIdentity();
+  if (identity.kind !== "development")
+    return;
+  if (isOwnedStore(path, probe.env ?? process.env, probe.tempDir ?? tmpdir2()))
+    return;
+  const loops = liveLoopSentences(path, probe.isAlive ?? isPidAlive);
+  throw new DevelopmentBuildRefusedError(path, developmentRefusalText(path, needs, identity.checkout, loops));
+}
+
 // src/effort/store/migrations.ts
+import { createHash } from "crypto";
+var LEGACY_GATE_OPEN = 13;
+var LEGACY_GATE_CLOSED = 1000;
 var SQLITE_MIGRATIONS = [
-  `
+  {
+    id: "kind-tables",
+    breaks: [],
+    sql: `
   CREATE TABLE sessions (
     seq        INTEGER PRIMARY KEY,
     session_id TEXT NOT NULL UNIQUE CHECK (session_id <> ''),
@@ -191,8 +698,12 @@ var SQLITE_MIGRATIONS = [
     sha      TEXT NOT NULL UNIQUE CHECK (sha <> ''),
     row_json TEXT NOT NULL
   );
-  `,
   `
+  },
+  {
+    id: "findings",
+    breaks: [],
+    sql: `
   CREATE TABLE findings (
     seq          INTEGER PRIMARY KEY,
     id           TEXT NOT NULL UNIQUE CHECK (id <> ''),
@@ -220,8 +731,12 @@ var SQLITE_MIGRATIONS = [
   CREATE UNIQUE INDEX findings_by_trigger_what
     ON findings (session_id, trigger, what)
     WHERE artifact IS NULL;
-  `,
   `
+  },
+  {
+    id: "blockers-and-bugs",
+    breaks: [],
+    sql: `
   CREATE TABLE blockers (
     seq          INTEGER PRIMARY KEY,
     id           TEXT NOT NULL UNIQUE CHECK (id <> ''),
@@ -252,8 +767,12 @@ var SQLITE_MIGRATIONS = [
 
   CREATE UNIQUE INDEX out_of_scope_bugs_by_entry
     ON out_of_scope_bugs (session_id, what, ifnull(artifact, ''), ifnull(security, -1));
-  `,
   `
+  },
+  {
+    id: "report-absences",
+    breaks: [],
+    sql: `
   CREATE TABLE report_absences (
     seq          INTEGER PRIMARY KEY,
     id           TEXT NOT NULL UNIQUE CHECK (id <> ''),
@@ -266,8 +785,12 @@ var SQLITE_MIGRATIONS = [
     outcome      TEXT NOT NULL,
     collected_at TEXT NOT NULL
   );
-  `,
   `
+  },
+  {
+    id: "task-reports",
+    breaks: [],
+    sql: `
   CREATE TABLE task_reports (
     seq          INTEGER PRIMARY KEY,
     id           TEXT NOT NULL UNIQUE CHECK (id <> ''),
@@ -278,8 +801,12 @@ var SQLITE_MIGRATIONS = [
     outcome      TEXT NOT NULL,
     collected_at TEXT NOT NULL
   );
-  `,
   `
+  },
+  {
+    id: "preflight",
+    breaks: [],
+    sql: `
   CREATE TABLE preflight (
     seq          INTEGER PRIMARY KEY,
     run_id       TEXT NOT NULL CHECK (run_id <> ''),
@@ -295,8 +822,12 @@ var SQLITE_MIGRATIONS = [
     UNIQUE (run_id, position),
     CHECK ((outcome = 'pass') = (failure IS NULL))
   );
-  `,
   `
+  },
+  {
+    id: "dispatches",
+    breaks: [],
+    sql: `
   CREATE TABLE dispatches (
     seq          INTEGER PRIMARY KEY,
     session_id   TEXT NOT NULL UNIQUE CHECK (session_id <> ''),
@@ -311,8 +842,12 @@ var SQLITE_MIGRATIONS = [
     flags        TEXT NOT NULL,
     collected_at TEXT NOT NULL
   );
-  `,
   `
+  },
+  {
+    id: "changes",
+    breaks: [],
+    sql: `
   CREATE TABLE changes (
     seq          INTEGER PRIMARY KEY,
     id           TEXT NOT NULL UNIQUE CHECK (id <> ''),
@@ -328,20 +863,32 @@ var SQLITE_MIGRATIONS = [
 
   CREATE UNIQUE INDEX changes_by_entry
     ON changes (session_id, level, ifnull(area, ''), summary);
-  `,
   `
+  },
+  {
+    id: "out-of-scope-bug-scope",
+    breaks: [],
+    sql: `
   ALTER TABLE out_of_scope_bugs
     ADD COLUMN scope TEXT CHECK (scope IN ('machine', 'rafa'));
-  `,
   `
+  },
+  {
+    id: "dispatch-skills",
+    breaks: [],
+    sql: `
   ALTER TABLE dispatches
     ADD COLUMN resolver TEXT CHECK (resolver IN ('planner', 'tag', 'none'));
   ALTER TABLE dispatches
     ADD COLUMN skills_offered TEXT CHECK (skills_offered IS NULL OR json_type(skills_offered) = 'array');
   ALTER TABLE dispatches
     ADD COLUMN lessons_offered TEXT CHECK (lessons_offered IS NULL OR json_type(lessons_offered) = 'array');
-  `,
   `
+  },
+  {
+    id: "skill-invocations",
+    breaks: [],
+    sql: `
   CREATE TABLE skill_invocations (
     seq        INTEGER PRIMARY KEY,
     session_id TEXT NOT NULL CHECK (session_id <> ''),
@@ -353,12 +900,20 @@ var SQLITE_MIGRATIONS = [
 
   CREATE UNIQUE INDEX skill_invocations_by_use
     ON skill_invocations (session_id, ifnull(name, ''), ifnull(sidechain, -1));
-  `,
   `
+  },
+  {
+    id: "task-report-skills",
+    breaks: [],
+    sql: `
   ALTER TABLE task_reports
     ADD COLUMN skills_used TEXT CHECK (skills_used IS NULL OR json_type(skills_used) = 'array');
-  `,
   `
+  },
+  {
+    id: "plan-ci",
+    breaks: [],
+    sql: `
   CREATE TABLE plan_ci (
     seq       INTEGER PRIMARY KEY,
     plan_stub TEXT NOT NULL CHECK (plan_stub <> ''),
@@ -371,13 +926,231 @@ var SQLITE_MIGRATIONS = [
     CHECK ((verdict = 'red') = (json_array_length(failing) > 0))
   );
   `
+  }
 ];
 var SQLITE_SCHEMA_VERSION = SQLITE_MIGRATIONS.length;
+function legacyGate(applied) {
+  return applied.every(({ breaks }) => breaks.length === 0) ? LEGACY_GATE_OPEN : LEGACY_GATE_CLOSED;
+}
+function migrationChecksum(migration) {
+  return createHash("sha256").update(migration.sql, "utf8").digest("hex");
+}
+
+// src/effort/store/schema-plan.ts
+var FIX_SCHEMA_STEP = "rafa effort fix-schema --dry-run";
+function sqliteCatalogue(migrations) {
+  return migrations.map(({ sql, ...spec }) => ({ ...spec, sha256: migrationChecksum({ sql }) }));
+}
+function planSchema(store, catalogue, access, caller) {
+  const { path, userVersion, log } = store;
+  if (log === null && (userVersion < 0 || userVersion > LEGACY_GATE_OPEN)) {
+    return refuse("pre-log-unreleased", FIX_SCHEMA_STEP, `effort store: ${path} is at schema version` + ` ${String(userVersion)} with no migration log; no released rafa wrote that.` + " Refusing to read or write it.");
+  }
+  if (log !== null && userVersion !== LEGACY_GATE_OPEN && userVersion !== LEGACY_GATE_CLOSED) {
+    return refuse("gate-mismatch", FIX_SCHEMA_STEP, `effort store: ${path} has a migration log and` + ` schema version ${String(userVersion)}; a build older than the log migrated it after the` + " log was made. Refusing to read or write it.");
+  }
+  const adopted = log === null ? adoptedEntries(catalogue, userVersion) : [];
+  const held = log ?? [];
+  const logRefusal = judgeLog(path, held, catalogue);
+  if (logRefusal !== null)
+    return logRefusal;
+  const heldIds = new Set([...adopted, ...held].map(({ id }) => id));
+  const pending = catalogue.filter(({ id }) => !heldIds.has(id));
+  const unknown = held.filter(({ id }) => !catalogue.some((entry) => entry.id === id));
+  const writes = access === "write" || pending.length > 0;
+  const writersBroken = unknown.find(({ breaks }) => breaks.includes("writers"));
+  if (writes && writersBroken !== undefined) {
+    return refuseUnknown("unknown-breaks-writers", path, writersBroken);
+  }
+  const orderRefusal = judgePending(path, catalogue, heldIds, pending, caller);
+  if (orderRefusal !== null)
+    return orderRefusal;
+  return {
+    verdict: "use",
+    adopted,
+    pending,
+    unknown,
+    gate: legacyGate([...adopted, ...held, ...pending])
+  };
+}
+function adoptedEntries(catalogue, count) {
+  const adopted = catalogue.slice(0, count);
+  if (adopted.length < count) {
+    throw new Error(`schema plan: the catalogue holds ${String(catalogue.length)} migrations,` + ` fewer than the ${String(count)} legacy entries a store at that version holds`);
+  }
+  return adopted;
+}
+function judgeLog(path, log, catalogue) {
+  const byId = new Map(catalogue.map((entry) => [entry.id, entry]));
+  for (const row of log) {
+    const known = byId.get(row.id);
+    if (known !== undefined && known.sha256 !== row.sha256) {
+      return refuse("edited", FIX_SCHEMA_STEP, `effort store: ${path} recorded migration ${row.id}` + ` as sha256 ${row.sha256}, and this rafa holds it as ${known.sha256}; one was edited` + " after it ran. Refusing to read or write the store.");
+    }
+  }
+  const readersBroken = log.find(({ id, breaks }) => !byId.has(id) && breaks.some((word) => word !== "writers"));
+  return readersBroken === undefined ? null : refuseUnknown("unknown-breaks-readers", path, readersBroken);
+}
+function judgePending(path, catalogue, heldIds, pending, caller) {
+  const breaking = pending.filter(({ breaks }) => breaks.length > 0);
+  for (const entry of breaking) {
+    const later = catalogue.slice(catalogue.indexOf(entry) + 1).find(({ id }) => heldIds.has(id));
+    if (later !== undefined) {
+      return refuse("breaking-out-of-order", "rafa effort schema", `effort store: ${path} needs` + ` migration ${entry.id} ahead of ${later.id}, which is already applied; a migration that` + " breaks older runtimes applies only in order. Refusing to read or write the store.");
+    }
+  }
+  const [first] = breaking;
+  if (first === undefined || caller === "migrate")
+    return null;
+  return refuse("breaking-pending", "rafa effort migrate --dry-run", `effort store: ${path} needs` + ` migration ${first.id}, which breaks older runtimes and is applied only by` + " 'rafa effort migrate'; refusing to read or write the store until then.");
+}
+function refuseUnknown(reason, path, row) {
+  const ending = reason === "unknown-breaks-readers" ? "which breaks older readers; refusing to read or write it." : "which breaks older writers; refusing to write it.";
+  return refuse(reason, `install a rafa that knows ${row.id}, or ${FIX_SCHEMA_STEP}`, "effort store:" + ` ${path} holds migration ${row.id} (applied by ${row.appliedBy} on ${dateOf(row.appliedAt)}),` + ` which this rafa does not know and ${ending}`);
+}
+function dateOf(appliedAt) {
+  return /^\d{4}-\d{2}-\d{2}/.test(appliedAt) ? appliedAt.slice(0, 10) : appliedAt;
+}
+function refuse(reason, nextStep, text) {
+  return { verdict: "refuse", reason, message: `${text} Next safe step: ${nextStep}`, nextStep };
+}
+
+// src/effort/store/bring-forward.ts
+var MIGRATION_LOG_TABLE = "schema_migrations";
+var CREATE_MIGRATION_LOG = `
+  CREATE TABLE IF NOT EXISTS ${MIGRATION_LOG_TABLE} (
+    seq        INTEGER PRIMARY KEY,
+    id         TEXT NOT NULL UNIQUE CHECK (id <> ''),
+    sha256     TEXT NOT NULL CHECK (length(sha256) = 64),
+    breaks     TEXT NOT NULL,
+    applied_at TEXT NOT NULL,
+    applied_by TEXT NOT NULL CHECK (applied_by <> '')
+  );
+`;
+
+class SchemaRefusedError extends Error {
+  reason;
+  nextStep;
+  constructor(refusal) {
+    super(refusal.message);
+    this.name = "SchemaRefusedError";
+    this.reason = refusal.reason;
+    this.nextStep = refusal.nextStep;
+  }
+}
+function bringForward(db, path, access, caller, options = {}) {
+  const migrations = options.migrations ?? SQLITE_MIGRATIONS;
+  const catalogue = sqliteCatalogue(migrations);
+  const first = usablePlan(readStoreSchema(db, path), catalogue, access, caller);
+  if (!hasWork(first))
+    return nothingWritten(db);
+  if (options.builtAside !== true)
+    refuseUnownedDevelopmentWrite(path, writeNames(first), options);
+  const apply = db.transaction(() => {
+    const store = readStoreSchema(db, path);
+    const plan = usablePlan(store, catalogue, access, caller);
+    if (!hasWork(plan))
+      return nothingWritten(db);
+    const stamp = {
+      appliedAt: (options.now ?? (() => new Date))().toISOString(),
+      appliedBy: options.appliedBy ?? RAFA_VERSION
+    };
+    db.run(CREATE_MIGRATION_LOG);
+    for (const entry of plan.adopted)
+      logMigration(db, entry, stamp);
+    for (const entry of plan.pending) {
+      db.run(bodyOf(migrations, entry.id));
+      logMigration(db, entry, stamp);
+    }
+    db.run(`PRAGMA user_version = ${String(plan.gate)}`);
+    return {
+      adopted: plan.adopted.map(({ id }) => id),
+      applied: plan.pending.map(({ id }) => id),
+      userVersion: plan.gate
+    };
+  });
+  return apply.immediate();
+}
+function readStoreSchema(db, path) {
+  return { path, userVersion: readUserVersion(db), log: readMigrationLog(db, path) };
+}
+function usablePlan(store, catalogue, access, caller) {
+  const plan = planSchema(store, catalogue, access, caller);
+  if (plan.verdict === "refuse")
+    throw new SchemaRefusedError(plan);
+  return plan;
+}
+function hasWork(plan) {
+  return plan.adopted.length > 0 || plan.pending.length > 0;
+}
+function writeNames(plan) {
+  const adoption = plan.adopted.length > 0 ? [ADOPTION_NAME] : [];
+  return [...adoption, ...plan.pending.map(({ id }) => id)];
+}
+function nothingWritten(db) {
+  return { adopted: [], applied: [], userVersion: readUserVersion(db) };
+}
+function readUserVersion(db) {
+  const row = db.query("PRAGMA user_version").get();
+  return row?.user_version ?? 0;
+}
+function readMigrationLog(db, path) {
+  const table = db.query("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?").get(MIGRATION_LOG_TABLE);
+  if (table === null)
+    return null;
+  return db.query(`SELECT id, sha256, breaks, applied_at, applied_by FROM ${MIGRATION_LOG_TABLE} ORDER BY seq`).all().map((row) => ({
+    id: row.id,
+    sha256: row.sha256,
+    breaks: parseBreaks(row.breaks, row.id, path),
+    appliedAt: row.applied_at,
+    appliedBy: row.applied_by
+  }));
+}
+function parseBreaks(text, id, path) {
+  const refused = new Error(`effort store: ${path} logs migration ${id} with breaks ${text},` + " which is not a JSON array of words; refusing to read or write it");
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch (cause) {
+    throw new Error(refused.message, { cause });
+  }
+  if (!Array.isArray(parsed) || !parsed.every((word) => typeof word === "string"))
+    throw refused;
+  return parsed;
+}
+function bodyOf(migrations, id) {
+  const migration = migrations.find((candidate) => candidate.id === id);
+  if (migration === undefined)
+    throw new Error(`bring forward: no migration ${id} in the catalogue it planned from`);
+  return migration.sql;
+}
+function logMigration(db, entry, stamp) {
+  db.run(`INSERT INTO ${MIGRATION_LOG_TABLE} (id, sha256, breaks, applied_at, applied_by) VALUES (?, ?, ?, ?, ?)`, [entry.id, entry.sha256, JSON.stringify(entry.breaks), stamp.appliedAt, stamp.appliedBy]);
+}
+
+// src/effort/store/settings.ts
+var DEFAULT_STORE_SETTINGS = Object.freeze({
+  busyTimeoutMs: CONFIG_DEFAULTS.effortBusyTimeoutMs
+});
+var active = DEFAULT_STORE_SETTINGS;
+function setActiveStoreSettings(settings) {
+  if (settings === null) {
+    active = DEFAULT_STORE_SETTINGS;
+    return;
+  }
+  if (!isBusyTimeoutMs(settings.busyTimeoutMs)) {
+    throw new RangeError(`effort store: busy timeout ${String(settings.busyTimeoutMs)} is not a whole number ` + `of milliseconds from ${String(BUSY_TIMEOUT_MIN_MS)} to ${String(BUSY_TIMEOUT_MAX_MS)}`);
+  }
+  active = Object.freeze({ busyTimeoutMs: settings.busyTimeoutMs });
+}
+function activeStoreSettings() {
+  return active;
+}
 
 // src/effort/store/sqlite.ts
-var STORE_FILE_NAME = "effort.sqlite";
+var SQLITE_STORE_FILE_NAME = "effort.sqlite";
 function sqliteStorePath(repoRoot) {
-  return join2(repoRoot, EFFORT_STORE_DIR, STORE_FILE_NAME);
+  return join7(effortStoreDir(repoRoot), SQLITE_STORE_FILE_NAME);
 }
 var KIND_TABLES = {
   sessions: { name: "sessions", keyColumn: "session_id" },
@@ -405,35 +1178,14 @@ function batchEntries(kind, rows) {
   }
   return keyed.map(({ key, row }) => ({ key, body: JSON.stringify(row) }));
 }
-function userVersion(db) {
-  const row = db.query("PRAGMA user_version").get();
-  return row?.user_version ?? 0;
-}
-function checkedVersion(db, path, latest) {
-  const version = userVersion(db);
-  if (version > latest) {
-    throw new Error(`effort store: ${path} is at schema version ${version}, past the` + ` ${latest} this rafa knows; refusing to read or write it`);
-  }
-  return version;
-}
-function migrateSchema(db, path, migrations = SQLITE_MIGRATIONS) {
-  const latest = migrations.length;
-  if (checkedVersion(db, path, latest) === latest)
-    return;
-  const applyPending = db.transaction(() => {
-    const from = checkedVersion(db, path, latest);
-    for (const sql of migrations.slice(from))
-      db.run(sql);
-    db.run(`PRAGMA user_version = ${latest}`);
-  });
-  applyPending.immediate();
-}
-function withSqliteStore(path, create, use) {
+function withSqliteStore(path, access, create, use) {
+  guardTestProcess(path);
   if (create)
-    mkdirSync2(dirname2(path), { recursive: true });
+    mkdirSync3(dirname6(path), { recursive: true });
   const db = new Database(path, { readwrite: true, create });
   try {
-    migrateSchema(db, path);
+    db.run(`PRAGMA busy_timeout = ${String(activeStoreSettings().busyTimeoutMs)}`);
+    bringForward(db, path, access, "open");
     return use(db);
   } finally {
     db.close();
@@ -445,11 +1197,11 @@ function insertBatch(db, table, entries) {
   return insertAll.immediate();
 }
 function writeSqliteStore(path, rowCount, empty, insert) {
-  const exists = existsSync2(path);
+  const exists = existsSync5(path);
   if (rowCount > 0)
-    return withSqliteStore(path, !exists, insert);
+    return withSqliteStore(path, "write", !exists, insert);
   if (exists)
-    withSqliteStore(path, false, () => {
+    withSqliteStore(path, "write", false, () => {
       return;
     });
   return empty;
@@ -461,10 +1213,10 @@ function appendKind2(path, kind, rows) {
   return { path, appended, skipped: entries.length - appended };
 }
 function keysOfKind2(path, kind) {
-  if (!existsSync2(path))
+  if (!existsSync5(path))
     return new Set;
-  const { name, keyColumn } = KIND_TABLES[kind];
-  const keys = withSqliteStore(path, false, (db) => db.query(`SELECT ${keyColumn} AS key FROM ${name} ORDER BY seq`).all());
+  const { name: name2, keyColumn } = KIND_TABLES[kind];
+  const keys = withSqliteStore(path, "read", false, (db) => db.query(`SELECT ${keyColumn} AS key FROM ${name2} ORDER BY seq`).all());
   return new Set(keys.map(({ key }) => key));
 }
 function parsedObject(body) {
@@ -483,11 +1235,11 @@ function rowOf(body, where) {
   return value;
 }
 function readKind2(path, kind) {
-  if (!existsSync2(path))
+  if (!existsSync5(path))
     return [];
-  const { name } = KIND_TABLES[kind];
-  const stored = withSqliteStore(path, false, (db) => db.query(`SELECT seq, row_json AS body FROM ${name} ORDER BY seq`).all());
-  return stored.map(({ seq, body }) => rowOf(body, `${path}: ${name} row ${seq}`));
+  const { name: name2 } = KIND_TABLES[kind];
+  const stored = withSqliteStore(path, "read", false, (db) => db.query(`SELECT seq, row_json AS body FROM ${name2} ORDER BY seq`).all());
+  return stored.map(({ seq, body }) => rowOf(body, `${path}: ${name2} row ${seq}`));
 }
 function openSqliteStore(repoRoot) {
   const path = sqliteStorePath(repoRoot);
@@ -501,15 +1253,15 @@ function openSqliteStore(repoRoot) {
 
 // src/adapters/learning/local.ts
 import { appendFile, mkdir, readFile, rm, writeFile } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join10 } from "path";
 
 // src/commands/instinct/instinct-records.ts
-import { readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
+import { readdirSync as readdirSync3, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
+import { join as join9 } from "path";
 
 // src/check/layout.ts
-import { readdirSync, statSync } from "fs";
-import { join as join3, relative } from "path";
+import { readdirSync as readdirSync2, statSync } from "fs";
+import { join as join8, relative as relative2 } from "path";
 var SKILL_FILE = "SKILL.md";
 var MARKDOWN_EXTENSION = ".md";
 var LAYOUT_SEVERITY = Object.freeze({
@@ -538,16 +1290,16 @@ function entryKind(path) {
   }
 }
 function visibleNames(dir) {
-  return readdirSync(dir).filter((name) => !name.startsWith(".")).sort((left, right) => left.localeCompare(right));
+  return readdirSync2(dir).filter((name2) => !name2.startsWith(".")).sort((left, right) => left.localeCompare(right));
 }
-function isMarkdown(name) {
-  return name.endsWith(MARKDOWN_EXTENSION);
+function isMarkdown(name2) {
+  return name2.endsWith(MARKDOWN_EXTENSION);
 }
-function markdownStem(name) {
-  return name.slice(0, -MARKDOWN_EXTENSION.length);
+function markdownStem(name2) {
+  return name2.slice(0, -MARKDOWN_EXTENSION.length);
 }
 function shown(root, path) {
-  return relative(root, path) || ".";
+  return relative2(root, path) || ".";
 }
 function dotfileOnlyEntry(kind, root, dir) {
   return {
@@ -569,37 +1321,37 @@ function unreadableEntry(kind, root, path) {
     issues: [layoutIssue("unreadable-entry", `${shown(root, path)} cannot be read (a broken symlink, or a path stat refuses)`)]
   };
 }
-function skillFileEntry(path, name) {
-  return { kind: "skill", path, isFile: true, shape: "skill-file", name, issues: [] };
+function skillFileEntry(path, name2) {
+  return { kind: "skill", path, isFile: true, shape: "skill-file", name: name2, issues: [] };
 }
-function flatGroupedEntry(root, path, name) {
+function flatGroupedEntry(root, path, name2) {
   return {
     kind: "skill",
     path,
     isFile: true,
     shape: "flat-grouped",
-    name,
-    issues: [layoutIssue("flat-grouped-layout", `${shown(root, path)} is the flat grouped layout <dir>/<group>/<name>.md,` + ` which does not register; move it to <dir>/${name}/${SKILL_FILE}`)]
+    name: name2,
+    issues: [layoutIssue("flat-grouped-layout", `${shown(root, path)} is the flat grouped layout <dir>/<group>/<name>.md,` + ` which does not register; move it to <dir>/${name2}/${SKILL_FILE}`)]
   };
 }
-function nestedGroupEntry(root, path, name) {
+function nestedGroupEntry(root, path, name2) {
   return {
     kind: "skill",
     path,
     isFile: true,
     shape: "nested-group",
-    name,
-    issues: [layoutIssue("nested-group-layout", `${shown(root, path)} is the nested layout <dir>/<group>/<name>/${SKILL_FILE},` + ` which does not register; move it to <dir>/${name}/${SKILL_FILE}`)]
+    name: name2,
+    issues: [layoutIssue("nested-group-layout", `${shown(root, path)} is the nested layout <dir>/<group>/<name>/${SKILL_FILE},` + ` which does not register; move it to <dir>/${name2}/${SKILL_FILE}`)]
   };
 }
-function looseFileEntry(root, path, name) {
+function looseFileEntry(root, path, name2) {
   return {
     kind: "skill",
     path,
     isFile: true,
     shape: "loose-file",
-    name,
-    issues: [layoutIssue("loose-file", `${shown(root, path)} sits directly under the skills directory, which registers` + ` only <dir>/<name>/${SKILL_FILE}; move it to <dir>/${name}/${SKILL_FILE}`)]
+    name: name2,
+    issues: [layoutIssue("loose-file", `${shown(root, path)} sits directly under the skills directory, which registers` + ` only <dir>/<name>/${SKILL_FILE}; move it to <dir>/${name2}/${SKILL_FILE}`)]
   };
 }
 function noSkillFileEntry(root, dir) {
@@ -612,30 +1364,30 @@ function noSkillFileEntry(root, dir) {
     issues: [layoutIssue("missing-skill-file", `${shown(root, dir)}/ holds no ${SKILL_FILE}, so it registers no skill`)]
   };
 }
-function nestedInstinctEntry(root, path, name) {
+function nestedInstinctEntry(root, path, name2) {
   return {
     kind: "instinct",
     path,
     isFile: true,
     shape: "nested-instinct",
-    name,
-    issues: [layoutIssue("nested-instinct-file", `${shown(root, path)} sits below the instincts directory, which is flat;` + ` move it to <dir>/${name}${MARKDOWN_EXTENSION}`)]
+    name: name2,
+    issues: [layoutIssue("nested-instinct-file", `${shown(root, path)} sits below the instincts directory, which is flat;` + ` move it to <dir>/${name2}${MARKDOWN_EXTENSION}`)]
   };
 }
-function scanGroupMember(root, dir, name) {
+function scanGroupMember(root, dir, name2) {
   const children = visibleNames(dir);
   if (children.length === 0)
     return [dotfileOnlyEntry("skill", root, dir)];
-  const skillPath = join3(dir, SKILL_FILE);
+  const skillPath = join8(dir, SKILL_FILE);
   if (children.includes(SKILL_FILE) && entryKind(skillPath) === "file") {
-    return [nestedGroupEntry(root, skillPath, name)];
+    return [nestedGroupEntry(root, skillPath, name2)];
   }
   return [noSkillFileEntry(root, dir)];
 }
 function scanSkillGroup(root, dir, children) {
   const entries = [];
   for (const child of children) {
-    const path = join3(dir, child);
+    const path = join8(dir, child);
     const found = entryKind(path);
     if (found === null) {
       entries.push(unreadableEntry("skill", root, path));
@@ -652,31 +1404,31 @@ function scanSkillGroup(root, dir, children) {
     return [noSkillFileEntry(root, dir)];
   return entries;
 }
-function scanSkillDirectory(root, dir, name) {
+function scanSkillDirectory(root, dir, name2) {
   const children = visibleNames(dir);
   if (children.length === 0)
     return [dotfileOnlyEntry("skill", root, dir)];
-  const skillPath = join3(dir, SKILL_FILE);
+  const skillPath = join8(dir, SKILL_FILE);
   if (children.includes(SKILL_FILE) && entryKind(skillPath) === "file") {
-    return [skillFileEntry(skillPath, name)];
+    return [skillFileEntry(skillPath, name2)];
   }
   return scanSkillGroup(root, dir, children);
 }
 function scanSkillRoot(root) {
   const entries = [];
-  for (const name of visibleNames(root)) {
-    const path = join3(root, name);
+  for (const name2 of visibleNames(root)) {
+    const path = join8(root, name2);
     const found = entryKind(path);
     if (found === null) {
       entries.push(unreadableEntry("skill", root, path));
       continue;
     }
     if (found === "directory") {
-      entries.push(...scanSkillDirectory(root, path, name));
+      entries.push(...scanSkillDirectory(root, path, name2));
       continue;
     }
-    if (isMarkdown(name))
-      entries.push(looseFileEntry(root, path, markdownStem(name)));
+    if (isMarkdown(name2))
+      entries.push(looseFileEntry(root, path, markdownStem(name2)));
   }
   return entries;
 }
@@ -686,7 +1438,7 @@ function scanInstinctSubdirectory(root, dir) {
     return [dotfileOnlyEntry("instinct", root, dir)];
   const entries = [];
   for (const child of children) {
-    const path = join3(dir, child);
+    const path = join8(dir, child);
     const found = entryKind(path);
     if (found === null) {
       entries.push(unreadableEntry("instinct", root, path));
@@ -703,8 +1455,8 @@ function scanInstinctSubdirectory(root, dir) {
 }
 function scanInstinctRoot(root) {
   const entries = [];
-  for (const name of visibleNames(root)) {
-    const path = join3(root, name);
+  for (const name2 of visibleNames(root)) {
+    const path = join8(root, name2);
     const found = entryKind(path);
     if (found === null) {
       entries.push(unreadableEntry("instinct", root, path));
@@ -714,14 +1466,14 @@ function scanInstinctRoot(root) {
       entries.push(...scanInstinctSubdirectory(root, path));
       continue;
     }
-    if (!isMarkdown(name))
+    if (!isMarkdown(name2))
       continue;
     entries.push({
       kind: "instinct",
       path,
       isFile: true,
       shape: "instinct-file",
-      name: markdownStem(name),
+      name: markdownStem(name2),
       issues: []
     });
   }
@@ -741,9 +1493,9 @@ function scanLayout(root, kind) {
 function declaredNameIssue(entry, declared) {
   if (entry.name === null || declared === null || declared === entry.name)
     return null;
-  const field = entry.kind === "skill" ? "name" : "id";
+  const field2 = entry.kind === "skill" ? "name" : "id";
   const source = entry.kind === "skill" ? "directory name" : "file name";
-  return layoutIssue("name-mismatch", `frontmatter ${field} "${declared}" is not the ${source} "${entry.name}"`);
+  return layoutIssue("name-mismatch", `frontmatter ${field2} "${declared}" is not the ${source} "${entry.name}"`);
 }
 
 // src/schema/frontmatter.ts
@@ -889,8 +1641,8 @@ var INSTINCT_KEY_ORDER = [
   "created_at",
   "updated_at"
 ];
-function issue(code, field, message) {
-  return { code, field, message };
+function issue(code, field2, message) {
+  return { code, field: field2, message };
 }
 function typeName(value) {
   if (value === null)
@@ -905,25 +1657,25 @@ function typeName(value) {
     return "a number";
   return `a ${typeof value}`;
 }
-function requiredString(data, field) {
-  const value = data[field];
+function requiredString(data, field2) {
+  const value = data[field2];
   if (value === undefined || value === null) {
-    return [issue("missing-field", field, `${field} is required and is absent`)];
+    return [issue("missing-field", field2, `${field2} is required and is absent`)];
   }
   if (typeof value !== "string") {
-    return [issue("wrong-type", field, `${field} must be a string, not ${typeName(value)}`)];
+    return [issue("wrong-type", field2, `${field2} must be a string, not ${typeName(value)}`)];
   }
   if (value.trim() === "") {
-    return [issue("missing-field", field, `${field} is required and is empty`)];
+    return [issue("missing-field", field2, `${field2} is required and is empty`)];
   }
   return [];
 }
-function requiredChoice(data, field, allowed, code) {
-  const issues = requiredString(data, field);
+function requiredChoice(data, field2, allowed, code) {
+  const issues = requiredString(data, field2);
   if (issues.length > 0)
     return issues;
-  const value = data[field];
-  return allowed.includes(value) ? [] : [issue(code, field, `${field} "${value}" is not one of ${allowed.join(", ")}`)];
+  const value = data[field2];
+  return allowed.includes(value) ? [] : [issue(code, field2, `${field2} "${value}" is not one of ${allowed.join(", ")}`)];
 }
 function checkId(data) {
   const issues = requiredString(data, "id");
@@ -959,11 +1711,11 @@ function checkSources(data) {
     return [issue("wrong-type", "sources", `sources must be a list, not ${typeName(value)}`)];
   }
   return value.flatMap((entry, index) => {
-    const field = `sources[${index}]`;
+    const field2 = `sources[${index}]`;
     if (typeof entry !== "string") {
-      return [issue("wrong-type", field, `sources entries must be strings, and this one is ${typeName(entry)}`)];
+      return [issue("wrong-type", field2, `sources entries must be strings, and this one is ${typeName(entry)}`)];
     }
-    return entry.trim() === "" ? [issue("wrong-type", field, "sources entries must name a source, and this one is blank")] : [];
+    return entry.trim() === "" ? [issue("wrong-type", field2, "sources entries must name a source, and this one is blank")] : [];
   });
 }
 function checkPromotedTo(data) {
@@ -992,26 +1744,26 @@ function checkProjectId(data) {
   }
   return PROJECT_ID_PATTERN.test(value) ? [] : [issue("invalid-project-id", "project_id", `project_id "${value}" is not ${PROJECT_ID_LENGTH} lowercase hex characters`)];
 }
-function checkTimestamp(data, field) {
-  const issues = requiredString(data, field);
+function checkTimestamp(data, field2) {
+  const issues = requiredString(data, field2);
   if (issues.length > 0)
     return issues;
-  const value = data[field];
-  return TIMESTAMP_PATTERN.test(value) && !Number.isNaN(Date.parse(value)) ? [] : [issue("invalid-timestamp", field, `${field} "${value}" is not an ISO 8601 instant such as 2026-09-11T10:00:00Z`)];
+  const value = data[field2];
+  return TIMESTAMP_PATTERN.test(value) && !Number.isNaN(Date.parse(value)) ? [] : [issue("invalid-timestamp", field2, `${field2} "${value}" is not an ISO 8601 instant such as 2026-09-11T10:00:00Z`)];
 }
 function isScalar(value) {
   return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
 }
 function checkEvidenceEntry(entry, index) {
-  const field = `evidence[${index}]`;
+  const field2 = `evidence[${index}]`;
   if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-    return [issue("wrong-type", field, `evidence entries must be mappings, and this one is ${typeName(entry)}`)];
+    return [issue("wrong-type", field2, `evidence entries must be mappings, and this one is ${typeName(entry)}`)];
   }
   const entries = Object.entries(entry);
   if (entries.length === 0) {
-    return [issue("wrong-type", field, "evidence entries must say something, and this one is empty")];
+    return [issue("wrong-type", field2, "evidence entries must say something, and this one is empty")];
   }
-  return entries.flatMap(([key, value]) => isScalar(value) ? [] : [issue("wrong-type", `${field}.${key}`, `evidence values must be text, numbers or booleans, and this one is ${typeName(value)}`)]);
+  return entries.flatMap(([key, value]) => isScalar(value) ? [] : [issue("wrong-type", `${field2}.${key}`, `evidence values must be text, numbers or booleans, and this one is ${typeName(value)}`)]);
 }
 function checkEvidence(data) {
   const value = data["evidence"];
@@ -1171,11 +1923,11 @@ function writeInstinct(instinct, newline = `
 }
 
 // src/commands/instinct/instinct-records.ts
-function isRecordFile(name) {
-  return !name.startsWith(".") && name.endsWith(MARKDOWN_EXTENSION) && name !== MARKDOWN_EXTENSION;
+function isRecordFile(name2) {
+  return !name2.startsWith(".") && name2.endsWith(MARKDOWN_EXTENSION) && name2 !== MARKDOWN_EXTENSION;
 }
-function recordId(name) {
-  return name.slice(0, -MARKDOWN_EXTENSION.length);
+function recordId(name2) {
+  return name2.slice(0, -MARKDOWN_EXTENSION.length);
 }
 function unreadableIssue(message) {
   return { code: "missing-frontmatter", field: "file", message: `the file could not be read: ${message}` };
@@ -1183,7 +1935,7 @@ function unreadableIssue(message) {
 function readRecord(path, scope, id) {
   let text;
   try {
-    text = readFileSync2(path, "utf8");
+    text = readFileSync4(path, "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     return { scope, path, id, instinct: null, issues: [unreadableIssue(message)] };
@@ -1199,7 +1951,7 @@ function isFile(path) {
   }
 }
 function recordFiles(dir) {
-  return readdirSync2(dir).filter((name) => isRecordFile(name) && isFile(join4(dir, name))).sort((left, right) => left.localeCompare(right));
+  return readdirSync3(dir).filter((name2) => isRecordFile(name2) && isFile(join9(dir, name2))).sort((left, right) => left.localeCompare(right));
 }
 function readScope(scope, dir) {
   if (!tierExists(dir))
@@ -1208,7 +1960,7 @@ function readScope(scope, dir) {
     scope,
     dir,
     exists: true,
-    records: recordFiles(dir).map((name) => readRecord(join4(dir, name), scope, recordId(name)))
+    records: recordFiles(dir).map((name2) => readRecord(join9(dir, name2), scope, recordId(name2)))
   };
 }
 function readScopes(seams) {
@@ -1220,9 +1972,9 @@ function allRecords(listings) {
 function findRecords(listings, id) {
   return allRecords(listings).filter((entry) => entry.id === id);
 }
-function instinctProject(context, name) {
+function instinctProject(context, name2) {
   if (context.project === null)
-    throw new Error(`${name} runs inside a project, and was handed none`);
+    throw new Error(`${name2} runs inside a project, and was handed none`);
   return context.project;
 }
 
@@ -1305,7 +2057,7 @@ var PREFIX = "local learning";
 var PUSH_REFUSAL = `${PREFIX}: refused to store a push`;
 var INSTINCTS_FILE = "instincts.ndjson";
 var FLAGS_FILE = "flags.ndjson";
-var RECORD_EXTENSION = ".md";
+var RECORD_EXTENSION2 = ".md";
 var MIN_CONFIDENCE = 0.3;
 var MAX_CONFIDENCE = 0.9;
 var SIGNALS = ["loud", "silent"];
@@ -1489,7 +2241,7 @@ function producedRecords(result) {
   for (const record of result.decisions.flatMap((decision) => decision.produced)) {
     const found = byId.get(record.id);
     if (found !== undefined && found !== record) {
-      throw new Error(`${PUSH_REFUSAL}: two records would be written to ${record.id}${RECORD_EXTENSION}`);
+      throw new Error(`${PUSH_REFUSAL}: two records would be written to ${record.id}${RECORD_EXTENSION2}`);
     }
     byId.set(record.id, record);
   }
@@ -1501,7 +2253,7 @@ function heldChanges(dir, held, result, described) {
   const writes = [];
   const kept = new Set;
   for (const record of producedRecords(result)) {
-    const file = `${record.id}${RECORD_EXTENSION}`;
+    const file = `${record.id}${RECORD_EXTENSION2}`;
     const instinct = toHeldInstinct(record, heldInstincts, payloadDescription(record, described));
     if (instinct === null) {
       throw new Error(`${PUSH_REFUSAL}: ${file} has no held member and no payload description to be written with`);
@@ -1511,7 +2263,7 @@ function heldChanges(dir, held, result, described) {
     if (issue2 !== undefined) {
       throw new Error(`${PUSH_REFUSAL}: ${file} would not read back: ${issue2.field}: ${issue2.message}`);
     }
-    const path = join5(dir, file);
+    const path = join10(dir, file);
     if (held.unreadable.has(path)) {
       throw new Error(`${PUSH_REFUSAL}: it would overwrite ${path}, which could not be read`);
     }
@@ -1541,18 +2293,18 @@ function pushLogLines(sourceId, described, result) {
   });
 }
 function localInstinctsDir(repoRoot) {
-  return join5(repoRoot, RAFA_INSTINCTS_PATH);
+  return join10(repoRoot, RAFA_INSTINCTS_PATH);
 }
 function userInstinctsDir(home) {
-  return join5(home, RAFA_INSTINCTS_PATH);
+  return join10(home, RAFA_INSTINCTS_PATH);
 }
 function createLocalLearning(options) {
   const { instinctsDir, minConfidence } = options;
   const userDir = userInstinctsDir(options.home);
   const now = options.now ?? (() => new Date().toISOString());
   const warn = options.warn ?? warnThroughActiveOutput;
-  const instinctsPath = join5(instinctsDir, INSTINCTS_FILE);
-  const flagsPath = join5(instinctsDir, FLAGS_FILE);
+  const instinctsPath = join10(instinctsDir, INSTINCTS_FILE);
+  const flagsPath = join10(instinctsDir, FLAGS_FILE);
   function readHeld(scope, dir) {
     const { records } = readScope(scope, dir);
     const unreadable = new Set;
@@ -1669,9 +2421,9 @@ function createJsonOutput({
 }
 
 // src/adapters/planner/claude.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import { mkdir as mkdir2, readFile as readFile2 } from "fs/promises";
-import { posix, resolve } from "path";
+import { posix, resolve as resolve3 } from "path";
 
 // src/board/spec-review.ts
 var SPEC_REVIEW_KIND = "spec-review";
@@ -1693,7 +2445,7 @@ var VERDICT_BREAK = /[\s_]+/gu;
 function isMapping2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function describeValue2(value) {
+function describeValue3(value) {
   if (typeof value === "string")
     return JSON.stringify(value);
   if (value === null)
@@ -1726,39 +2478,39 @@ function verdictOf(value) {
   const word = spelled.replace(VERDICT_BREAK, "-");
   return SPEC_REVIEW_VERDICTS.includes(word) ? word : null;
 }
-function issueAt(field, text) {
-  return { field, text };
+function issueAt(field2, text) {
+  return { field: field2, text };
 }
-function readBlocking(item, field, issues) {
+function readBlocking(item, field2, issues) {
   const value = valueAt(item, "blocking");
   if (typeof value === "boolean")
     return value;
-  const text = `${field}.blocking is ${describeValue2(value)}, not true or false; ` + "the gap is read as blocking";
-  issues.push(issueAt(`${field}.blocking`, text));
+  const text = `${field2}.blocking is ${describeValue3(value)}, not true or false; ` + "the gap is read as blocking";
+  issues.push(issueAt(`${field2}.blocking`, text));
   return true;
 }
-function readGap(item, field, issues) {
+function readGap(item, field2, issues) {
   if (!isMapping2(item)) {
-    const text = `${field} is ${describeValue2(item)}, not a mapping of heading and what; dropped`;
-    issues.push(issueAt(field, text));
+    const text = `${field2} is ${describeValue3(item)}, not a mapping of heading and what; dropped`;
+    issues.push(issueAt(field2, text));
     return null;
   }
   const what = stringAt(item, "what");
   if (what === null) {
-    const text = `${field}.what is ${describeValue2(valueAt(item, "what"))}, ` + "not a sentence; the gap is dropped";
-    issues.push(issueAt(`${field}.what`, text));
+    const text = `${field2}.what is ${describeValue3(valueAt(item, "what"))}, ` + "not a sentence; the gap is dropped";
+    issues.push(issueAt(`${field2}.what`, text));
     return null;
   }
   const heading = stringAt(item, "heading");
   if (heading === null) {
-    const text = `${field}.heading is ${describeValue2(valueAt(item, "heading"))}, ` + `not a heading; the gap is filed under ${REVIEW_HEADING}`;
-    issues.push(issueAt(`${field}.heading`, text));
+    const text = `${field2}.heading is ${describeValue3(valueAt(item, "heading"))}, ` + `not a heading; the gap is filed under ${REVIEW_HEADING}`;
+    issues.push(issueAt(`${field2}.heading`, text));
   }
-  const blocking = readBlocking(item, field, issues);
+  const blocking = readBlocking(item, field2, issues);
   const assumption = stringAt(item, "assumption");
   if (!blocking && assumption === null) {
-    const text = `${field}.assumption is ${describeValue2(valueAt(item, "assumption"))}, ` + "not what a non-blocking gap would be planned under; the gap is read as blocking";
-    issues.push(issueAt(`${field}.assumption`, text));
+    const text = `${field2}.assumption is ${describeValue3(valueAt(item, "assumption"))}, ` + "not what a non-blocking gap would be planned under; the gap is read as blocking";
+    issues.push(issueAt(`${field2}.assumption`, text));
     return { heading: heading ?? REVIEW_HEADING, what, blocking: true, assumption: null };
   }
   return { heading: heading ?? REVIEW_HEADING, what, blocking, assumption };
@@ -1768,7 +2520,7 @@ function readGaps(document, issues) {
   if (value === null)
     return [];
   if (!Array.isArray(value)) {
-    const text = `gaps is ${describeValue2(value)}, not a list; no gap is read from it`;
+    const text = `gaps is ${describeValue3(value)}, not a list; no gap is read from it`;
     issues.push(issueAt("gaps", text));
     return [];
   }
@@ -1824,12 +2576,12 @@ function parseSpecReview(output) {
     return unreadable("malformed", block, text);
   }
   if (!isMapping2(document)) {
-    const text = `the rafa:spec-review block at line ${line} holds ${describeValue2(document)}, ` + "not a mapping of verdict and gaps";
+    const text = `the rafa:spec-review block at line ${line} holds ${describeValue3(document)}, ` + "not a mapping of verdict and gaps";
     return unreadable("malformed", block, text);
   }
   const verdict = verdictOf(valueAt(document, "verdict"));
   if (verdict === null) {
-    const text = `the rafa:spec-review block at line ${line} has a verdict of ` + `${describeValue2(valueAt(document, "verdict"))}, ` + `not one of ${SPEC_REVIEW_VERDICTS.join(", ")}`;
+    const text = `the rafa:spec-review block at line ${line} has a verdict of ` + `${describeValue3(valueAt(document, "verdict"))}, ` + `not one of ${SPEC_REVIEW_VERDICTS.join(", ")}`;
     return unreadable("malformed", block, text);
   }
   const issues = [];
@@ -1905,11 +2657,11 @@ class UndeclaredSpendError extends Error {
   name = "UndeclaredSpendError";
 }
 function carriesFlag(flags, flag) {
-  const name = flag.replace(/^--/, "");
-  const value = flags[name];
+  const name2 = flag.replace(/^--/, "");
+  const value = flags[name2];
   if (value !== undefined && value !== false)
     return true;
-  return name.startsWith("no-") && flags[name.slice(3)] === false;
+  return name2.startsWith("no-") && flags[name2.slice(3)] === false;
 }
 function spendRefusal(running2) {
   if (running2 === null)
@@ -2035,12 +2787,12 @@ function createClaudePlanner(options) {
   const create = async ({ specPath, stub }) => {
     const planPath = planFilePath(planDir, `PLAN-${stub}.md`);
     const prerequisitesPath = planFilePath(planDir, `PREREQUISITES-${stub}.md`);
-    const isWritten = (path) => existsSync3(resolve(repoRoot, path));
+    const isWritten = (path) => existsSync6(resolve3(repoRoot, path));
     if (isWritten(planPath)) {
       throw new ClaudePlannerError(`${planPath} already exists`, FAILURE_EXIT_CODE);
     }
-    const specContent = await readFile2(resolve(repoRoot, specPath), "utf8");
-    await mkdir2(resolve(repoRoot, planDir), { recursive: true });
+    const specContent = await readFile2(resolve3(repoRoot, specPath), "utf8");
+    await mkdir2(resolve3(repoRoot, planDir), { recursive: true });
     const session = await runClaudeCaptured(buildPrompt(specContent, stub), settingSources, [], spawn);
     const review = parseSpecReview(session.stdout);
     const { exitCode } = session;
@@ -2151,8 +2903,8 @@ async function withDeadline(work, timeoutMs) {
   if (timeoutMs === undefined)
     return work;
   let timer;
-  const deadline = new Promise((resolve2) => {
-    timer = setTimeout(() => resolve2(TIMED_OUT), timeoutMs);
+  const deadline = new Promise((resolve4) => {
+    timer = setTimeout(() => resolve4(TIMED_OUT), timeoutMs);
   });
   try {
     return await Promise.race([work, deadline]);
@@ -2179,8 +2931,8 @@ function isRepoName(value) {
 function isLabelPart(value) {
   return typeof value === "string" && !value.includes(",");
 }
-function optionalFlag(name, value) {
-  return value === undefined ? [] : [name, value];
+function optionalFlag(name2, value) {
+  return value === undefined ? [] : [name2, value];
 }
 function detailOf(result) {
   return result.stderr.trim() || result.stdout.trim() || "it exited non-zero and wrote nothing";
@@ -2243,7 +2995,7 @@ function labelNames(value) {
   if (!Array.isArray(value))
     return null;
   const names = value.map((label) => isMapping(label) && typeof label["name"] === "string" ? label["name"] : null);
-  return names.every((name) => name !== null) ? names : null;
+  return names.every((name2) => name2 !== null) ? names : null;
 }
 function viewProblem(payload, number) {
   if (!isMapping(payload))
@@ -2279,18 +3031,18 @@ function listedIssues(stdout) {
     throw new Error(`${PREFIX2}: ${command} answered ${describeValue(payload)}, expected a list`);
   }
   return payload.map((row, index) => {
-    const refuse = (problem) => new Error(`${PREFIX2}: ${command} answered row ${index} ${problem}`);
+    const refuse2 = (problem) => new Error(`${PREFIX2}: ${command} answered row ${index} ${problem}`);
     if (!isMapping(row))
-      throw refuse(`${describeValue(row)}, expected a mapping`);
+      throw refuse2(`${describeValue(row)}, expected a mapping`);
     const { number, url } = row;
     const labels = labelNames(row["labels"]);
     if (typeof number !== "number" || !isIssueNumber(String(number))) {
-      throw refuse(`with number ${describeValue(number)}, expected an issue number`);
+      throw refuse2(`with number ${describeValue(number)}, expected an issue number`);
     }
     if (typeof url !== "string")
-      throw refuse(`with url ${describeValue(url)}, expected a string`);
+      throw refuse2(`with url ${describeValue(url)}, expected a string`);
     if (labels === null)
-      throw refuse("with labels that are not a list of named labels");
+      throw refuse2("with labels that are not a list of named labels");
     return { number, url, labels };
   });
 }
@@ -2344,9 +3096,9 @@ function createGithubTracker(options) {
     return result.stdout;
   }
   async function ensureLabels(names) {
-    const missing = [...new Set(names)].filter((name) => !knownLabels.has(name));
-    for (const name of missing) {
-      await run(["label", "create", name, "--force"], `gh label create ${describeValue(name)}`);
+    const missing = [...new Set(names)].filter((name2) => !knownLabels.has(name2));
+    for (const name2 of missing) {
+      await run(["label", "create", name2, "--force"], `gh label create ${describeValue(name2)}`);
     }
     knownLabels = new Set([...knownLabels, ...missing]);
   }
@@ -2457,7 +3209,7 @@ function createGithubTracker(options) {
 
 // src/adapters/tracker/local.ts
 import { mkdir as mkdir3, readdir, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
-import { join as join6 } from "path";
+import { join as join11 } from "path";
 var PREFIX3 = "local tracker";
 var FRONTMATTER = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
 var ISSUE_NUMBER2 = /^[1-9]\d*$/;
@@ -2510,11 +3262,11 @@ function parseIssueNumber(text) {
   const number = Number(text);
   return Number.isSafeInteger(number) ? number : null;
 }
-function issueNumberOfFile(name) {
-  return name.endsWith(ISSUE_EXTENSION) ? parseIssueNumber(name.slice(0, -ISSUE_EXTENSION.length)) : null;
+function issueNumberOfFile(name2) {
+  return name2.endsWith(ISSUE_EXTENSION) ? parseIssueNumber(name2.slice(0, -ISSUE_EXTENSION.length)) : null;
 }
 function issuePath(issuesDir, number) {
-  return join6(issuesDir, `${number}${ISSUE_EXTENSION}`);
+  return join11(issuesDir, `${number}${ISSUE_EXTENSION}`);
 }
 async function issueNumbers(issuesDir) {
   let names;
@@ -2528,7 +3280,7 @@ async function issueNumbers(issuesDir) {
   return names.map(issueNumberOfFile).filter((number) => number !== null).sort((a, b) => a - b);
 }
 function localIssuesDir(repoRoot) {
-  return join6(repoRoot, ".rafa", "issues");
+  return join11(repoRoot, ".rafa", "issues");
 }
 function renderLocalIssue(record) {
   const { draft } = record;
@@ -2849,7 +3601,7 @@ var CORE_ADAPTERS = [
 var CORE_ADAPTER_REGISTRY = createAdapterRegistry(CORE_ADAPTERS);
 
 // src/effort/store/index.ts
-function describeValue3(value) {
+function describeValue4(value) {
   if (typeof value === "string")
     return JSON.stringify(value);
   if (typeof value === "object" && value !== null)
@@ -2860,9 +3612,9 @@ function selectEffortStore(repoRoot, config) {
   const adapter = CORE_ADAPTER_REGISTRY.find("store", config.store);
   if (adapter === undefined) {
     const expected = CORE_ADAPTER_REGISTRY.kinds("store").join(", ");
-    throw new TypeError(`effort store: store is ${describeValue3(config.store)},` + ` expected one of: ${expected}`);
+    throw new TypeError(`effort store: store is ${describeValue4(config.store)},` + ` expected one of: ${expected}`);
   }
   return adapter.create({ repoRoot });
 }
 
-export { EFFORT_STORE_DIR, effortStorePath, EFFORT_KEY_PROJECTIONS, openNdjsonStore, SQLITE_MIGRATIONS, sqliteStorePath, LONE_SURROGATE, migrateSchema, withSqliteStore, writeSqliteStore, openSqliteStore, SKILL_FILE, MARKDOWN_EXTENSION, scanLayout, declaredNameIssue, readFrontmatterDocument, readFrontmatter, renderFrontmatter, mergeFrontmatter, writeFrontmatter, normalizeRemote, gitRemoteUrl, ACTION_HEADING, CAUSE_HEADING, parseInstinct, writeInstinct, readScopes, allRecords, findRecords, instinctProject, toHeldRecords, sessionSpawnEnv, getClaudeUsagePercent, checkUsage, CLAUDE_BIN, claudeArgs, interruptClaudeSessions, runClaude, spawnClaudeCaptured, runClaudeCaptured, planFilePath, ClaudePlannerError, ISSUE_TYPES, ISSUE_PRIORITIES, ISSUE_STATES, GITHUB_LABELS, createGhRunner, typeOfLabels, moduleOfLabels, createLocalTracker, PORT_VERSIONS, createAdapterRegistry, CORE_ADAPTER_REGISTRY, selectEffortStore };
+export { EFFORT_STORE_DIR, effortStoreFileName, EFFORT_DIR_VARIABLE, effortStoreDir, guardTestProcess, EFFORT_KEY_PROJECTIONS, openNdjsonStore, name, version, RAFA_VERSION, versionLine, SCOPE_DIR, INIT_COMMAND, DISK_FILE_SYSTEM, ScopeError, scopeAt, initHint, selfAndAncestors, resolveScope, SessionRecordError, SessionConflictError, SessionStateError, isSessionId, runsDir, sessionFilePath, errorCode, isPidAlive, readSessions, readSession, beginSession, updateSession, readRuntimeIdentity, DEVELOPMENT_NEXT_STEP, ADOPTION_NAME, DEVELOPMENT_MARK, appliedByName, DevelopmentBuildRefusedError, storeProjectRoot, refuseUnownedDevelopmentWrite, LEGACY_GATE_OPEN, LEGACY_GATE_CLOSED, SQLITE_MIGRATIONS, sqliteCatalogue, planSchema, MIGRATION_LOG_TABLE, bringForward, readStoreSchema, writeNames, setActiveStoreSettings, activeStoreSettings, SQLITE_STORE_FILE_NAME, sqliteStorePath, LONE_SURROGATE, withSqliteStore, writeSqliteStore, openSqliteStore, SKILL_FILE, MARKDOWN_EXTENSION, scanLayout, declaredNameIssue, readFrontmatterDocument, readFrontmatter, renderFrontmatter, mergeFrontmatter, writeFrontmatter, normalizeRemote, gitRemoteUrl, ACTION_HEADING, CAUSE_HEADING, parseInstinct, writeInstinct, readScopes, allRecords, findRecords, instinctProject, toHeldRecords, sessionSpawnEnv, getClaudeUsagePercent, checkUsage, CLAUDE_BIN, claudeArgs, interruptClaudeSessions, runClaude, spawnClaudeCaptured, runClaudeCaptured, planFilePath, ClaudePlannerError, ISSUE_TYPES, ISSUE_PRIORITIES, ISSUE_STATES, GITHUB_LABELS, createGhRunner, typeOfLabels, moduleOfLabels, createLocalTracker, PORT_VERSIONS, createAdapterRegistry, CORE_ADAPTER_REGISTRY, selectEffortStore };