@open-tomato/rafa 0.34.0 → 0.34.1

package/README.md

@@ -820,6 +820,20 @@ is the old one removed, so no reader meets a half-replaced runtime. The
 link lands by a rename too, so a shell meets the old link or the new one
 and never none.
 
+## Bringing a project up to the installed rafa
+
+`rafa self-update` moves the rafa every project on the device runs, and
+leaves what each project holds as it was set up. `rafa update current`,
+run inside a project, brings that project to the installed rafa: it
+creates the `.rafa/` folders and the board labels newer versions expect,
+and records the version in `rafa.lock` at the repository root, a small
+JSON file meant to be committed. It works within a patch range: the
+installed version must share the major and minor of the one the lock
+records, and a project with no lock is adopted. It prints every change
+first, and `--dry-run` stops there; otherwise it asks once, or takes
+`--yes`. The rest of `rafa update` (`self`, `project`, `board`, `next`,
+`latest`) is in development and says so (#713).
+
 ## Runtime
 
 The build targets bun, and `engines` names `bun` alone: there is no

package/dist/bundled/operators/agents/rafa-stretch-analyst.md

@@ -0,0 +1,53 @@
+---
+name: rafa-stretch-analyst
+description: Operator agent, never a loop task executor. Read-only. Turns a stretch's raw data (run records, loop logs, effort store, kernel log, board) into checked insights. Takes the person's hunch, tests it against the data, and names the alternative explanation and the check that separates them. Also called da2 or da². Start it with `bun run stretch analyst` in the project's main checkout, or as the third window of `bun run stretch start`.
+tools: Read, Bash
+provenance: first-party
+source: rafa
+stage: alpha
+---
+
+Alpha: tested on rafa's own development, may become a feature.
+
+## Mission
+
+The person works on hunches and curiosity. Your job is to say which hunch the
+data supports, which it does not, and which it cannot answer yet. Never
+change anything: no writes to the board, branches, config, or the stretch
+folder except `analysis.md`.
+
+## Vision
+
+A finding is only as good as its input. Before any number, check the input:
+
+- time that is not work (machine asleep, waiting on the person, a paused loop);
+- units that do not compare (tokens with input against output-only tokens);
+- small samples (a p90 over 7 tasks is one task);
+- a cause counted twice (one failure filed as several bugs);
+- the loudest signal that is not the costliest one.
+
+## Sources
+
+| Source | What it holds | How to read it |
+|---|---|---|
+| `.rafa/runs/<id>.json` | test steps: kind, scope, failures, `[Ns]` duration | `python3`/`jq` over `steps` |
+| `.rafa/stretch/<n>/loop-*.log` | `rafa·` lines: task done minutes and tokens | grep the `done` lines |
+| `.rafa/effort/effort.sqlite` | sessions, task reports, dispatches | `sqlite3 -readonly` |
+| `journalctl -k` (`pmset -g log` on macOS) | suspend and resume times | subtract from wall time |
+| `gh issue list --search created:>=…` | filings per loop | group by cause |
+| `bucket.md`, `pit-stops.md`, `watch.md` | plan, decisions, what was seen | timestamps of each change |
+
+## Method, for each question
+
+1. Restate the hunch as a claim that can be false.
+2. Measure it: the number, its source, and the command that produced it.
+3. Name at least one other mechanism that fits the same numbers, and the
+   check that tells them apart. Run the check if the data allows it.
+4. Verdict: supported, not supported, or open (with what data would close it).
+
+## Report
+
+Write to `.rafa/stretch/<n>/analysis.md` and answer the person in the same
+shape: one line per finding as claim → measurement → source → verdict. Put
+the one finding that changes a decision first. Leave out findings that
+change nothing.

package/dist/bundled/operators/agents/rafa-stretch-engineer.md

@@ -31,6 +31,11 @@ steps: a helper, never a hinderer. Hold every step you take to it:
   written; a flag you always add is a flag rafa may not need. Note both
   in the report.
 - Stop and ask only where there is a risk. Everything else is yours.
+- Move an issue between epics with `rafa epic move <issue> --to=<epic>`,
+  never by adding a second `epic:` label: where the project installs the
+  epic guard, a second label added beside the first is removed, and its
+  comment lands on the issue. Turning the guard on or off is the
+  person's, never yours.
 
 ## Two stops, everything else unattended
 

package/dist/cli.js

@@ -2233,7 +2233,7 @@ function restoreRunningCommand(previous) {
 var running = null;
 
 // package.json
-var name = "@open-tomato/rafa", version = "0.34.0";
+var name = "@open-tomato/rafa", version = "0.34.1";
 var init_package = () => {};
 
 // src/cli/version.ts
@@ -64612,6 +64612,504 @@ var init_status4 = __esm(() => {
   status_default3 = createStatusCommand();
 });
 
+// src/commands/update/stub.ts
+function stubMessage(action, issue5) {
+  return `rafa update ${action} is a feature in development, tracked in ${ISSUES_URL}/${String(issue5)}.` + " Nothing was changed.";
+}
+function createUpdateStub(spec) {
+  const command = {
+    name: `update ${spec.action}`,
+    subject: "update",
+    action: spec.action,
+    summary: `${spec.summary} (in development, #${String(spec.issue)})`,
+    description: `${spec.summary}. In development: it refuses with exit code 1, naming #${String(spec.issue)},` + " and changes nothing.",
+    args: [],
+    flags: [],
+    examples: [{ cmd: `rafa update ${spec.action}`, note: `Refuses, naming #${String(spec.issue)}; changes nothing.` }],
+    outputs: ["text", "json"],
+    needsProject: false,
+    ...spec.hidden === true ? { hidden: true } : {},
+    run: () => Promise.reject(new CommandExit(1, stubMessage(spec.action, spec.issue)))
+  };
+  return Object.freeze(command);
+}
+var ISSUES_URL = "https://github.com/open-tomato/rafa/issues";
+var init_stub = __esm(() => {
+  init_command();
+});
+
+// src/commands/update/board.ts
+var board_default;
+var init_board = __esm(() => {
+  init_stub();
+  board_default = createUpdateStub({ action: "board", summary: "apply the board's newest setup and its migrations", issue: 717 });
+});
+
+// src/project/lock.ts
+import { existsSync as existsSync63, lstatSync as lstatSync3, readFileSync as readFileSync79, writeFileSync as writeFileSync31 } from "fs";
+import { join as join98 } from "path";
+function lockPath(root) {
+  return join98(root, LOCK_FILE);
+}
+function projectLockText(version2) {
+  const lock = { lockfileVersion: LOCKFILE_VERSION, rafa: version2 };
+  return `${JSON.stringify(lock, null, 2)}
+`;
+}
+function isLink(path9) {
+  try {
+    return lstatSync3(path9).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function refuse16(problem2) {
+  throw new ProjectLockError(`${LOCK_FILE} ${problem2}`);
+}
+function lockOf(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    refuse16("holds no JSON object");
+  const record = value;
+  const format = record["lockfileVersion"];
+  if (format !== LOCKFILE_VERSION) {
+    refuse16(`is in lockfileVersion ${String(format)}, and this rafa reads ${String(LOCKFILE_VERSION)}: a newer rafa wrote it`);
+  }
+  const rafa = record["rafa"];
+  if (typeof rafa !== "string" || parseSemanticVersion(rafa) === null) {
+    refuse16(`names rafa ${JSON.stringify(rafa)}, which is no version`);
+  }
+  return { lockfileVersion: LOCKFILE_VERSION, rafa };
+}
+function readProjectLock(root) {
+  const path9 = lockPath(root);
+  if (!existsSync63(path9)) {
+    if (isLink(path9))
+      refuse16("is a link to nothing");
+    return null;
+  }
+  let text2;
+  try {
+    text2 = readFileSync79(path9, "utf8");
+  } catch (error) {
+    refuse16(`could not be read: ${messageOf(error)}`);
+  }
+  let value;
+  try {
+    value = JSON.parse(text2);
+  } catch {
+    refuse16("is not JSON");
+  }
+  return lockOf(value);
+}
+function writeProjectLock(root, version2) {
+  writeFileSync31(lockPath(root), projectLockText(version2), "utf8");
+}
+var LOCK_FILE = "rafa.lock", LOCKFILE_VERSION = 1, ProjectLockError;
+var init_lock = __esm(() => {
+  init_config_sections();
+  init_version2();
+  ProjectLockError = class ProjectLockError extends Error {
+    name = "ProjectLockError";
+  };
+});
+
+// src/project/update-current.ts
+import { existsSync as existsSync64 } from "fs";
+import { join as join99 } from "path";
+function missingFolders(root) {
+  return PROJECT_TREE.map((name2) => join99(SCOPE_DIR, name2)).filter((relative21) => !existsSync64(join99(root, relative21)));
+}
+async function readBoard3(access) {
+  if (access.gh === null)
+    return { kind: "skipped", reason: access.reason };
+  try {
+    const held = await listBoardLabels(access.gh);
+    return { kind: "labels", missing: missingBoardLabels(held).map((label) => label.name) };
+  } catch (error) {
+    return { kind: "skipped", reason: messageOf(error) };
+  }
+}
+function lockChangeOf(range) {
+  if (range.kind === "adopt")
+    return "created";
+  return range.kind === "patch" ? "updated" : "unchanged";
+}
+function fromOf(range) {
+  if (range.kind === "patch")
+    return range.from;
+  if (range.kind === "same")
+    return range.to;
+  return null;
+}
+async function readUpdatePlan(roots, range, board) {
+  const { root, lockRoot } = roots;
+  return {
+    root,
+    lockRoot,
+    from: fromOf(range),
+    to: range.to,
+    folders: missingFolders(root),
+    board: await readBoard3(board),
+    deprecations: DEPRECATIONS,
+    lock: lockChangeOf(range)
+  };
+}
+function planChanges(plan2) {
+  const labels = plan2.board.kind === "labels" ? plan2.board.missing.length : 0;
+  return plan2.folders.length > 0 || labels > 0 || plan2.deprecations.length > 0 || plan2.lock !== "unchanged";
+}
+function foldersNowThere(plan2) {
+  return plan2.folders.filter((relative21) => existsSync64(join99(plan2.root, relative21)));
+}
+function writeFolders(plan2) {
+  if (plan2.folders.length === 0)
+    return [];
+  try {
+    return writeProjectScope(plan2.root).filter((write) => write.change === "created").map((write) => write.path);
+  } catch (error) {
+    throw new UpdateStepError("folders", messageOf(error), foldersNowThere(plan2));
+  }
+}
+function createdLabels(parts) {
+  return parts.filter((part) => part.outcome === "created").map((part) => `label ${part.name}`);
+}
+async function applyUpdatePlan(plan2, gh) {
+  const folders = writeFolders(plan2);
+  const labels = gh !== null && plan2.board.kind === "labels" && plan2.board.missing.length > 0 ? await setUpLabels(gh) : [];
+  if (plan2.lock !== "unchanged") {
+    try {
+      writeProjectLock(plan2.lockRoot, plan2.to);
+    } catch (error) {
+      throw new UpdateStepError("lock", messageOf(error), [...folders, ...createdLabels(labels)]);
+    }
+  }
+  return { folders, labels, lock: plan2.lock };
+}
+var DEPRECATIONS, UpdateStepError;
+var init_update_current = __esm(() => {
+  init_setup();
+  init_config_sections();
+  init_lock();
+  init_scaffold();
+  init_scope();
+  DEPRECATIONS = Object.freeze([]);
+  UpdateStepError = class UpdateStepError extends Error {
+    step;
+    written;
+    name = "UpdateStepError";
+    constructor(step2, message, written3) {
+      super(message);
+      this.step = step2;
+      this.written = written3;
+    }
+  };
+});
+
+// src/project/update-range.ts
+function refused6(reason, message) {
+  return { kind: "refused", reason, message };
+}
+function readCurrentRange(recorded, installed) {
+  const to = parseSemanticVersion(installed);
+  if (to === null)
+    return refused6("unreadable", `the installed rafa answers "${installed}", which is no version`);
+  if (recorded === null)
+    return { kind: "adopt", to: installed };
+  const from = parseSemanticVersion(recorded);
+  if (from === null)
+    return refused6("unreadable", `the project records rafa "${recorded}", which is no version`);
+  const order = compareVersions(to, from);
+  if (order < 0) {
+    return refused6("older", `the installed rafa ${installed} is older than the project's ${recorded}, and no downgrade runs before 1.0.0`);
+  }
+  if (to.major !== from.major) {
+    return refused6("newer-major", `the installed rafa ${installed} is a newer major than the project's ${recorded}; that move is rafa update latest`);
+  }
+  if (to.minor !== from.minor) {
+    return refused6("newer-minor", `the installed rafa ${installed} is a newer minor than the project's ${recorded}; that move is rafa update next`);
+  }
+  return order === 0 ? { kind: "same", to: installed } : { kind: "patch", from: recorded, to: installed };
+}
+var init_update_range = __esm(() => {
+  init_status();
+  init_version2();
+});
+
+// src/commands/update/current.ts
+function checkoutLockRoot(root, dir) {
+  const run = Bun.spawnSync(["git", "rev-parse", "--show-toplevel"], { cwd: dir, stdout: "pipe", stderr: "pipe" });
+  if (run.exitCode !== 0)
+    return root;
+  const top = run.stdout.toString().trim();
+  return top !== "" && mainCheckoutOf(top) === root ? top : root;
+}
+function readSwitch4(context, name2) {
+  const value = context.flags[name2];
+  if (value === undefined || value === false || value === "false")
+    return false;
+  if (value === true || value === "true")
+    return true;
+  throw new CommandExit(1, `\u274C --${name2} takes no value, and read "${String(value)}" as one
+Usage: ${USAGE47}`);
+}
+function couldNotRun(problem2) {
+  return new CommandExit(2, `FAIL \u2014 ${problem2}
+nothing was changed.`);
+}
+function projectOf17(context) {
+  if (context.project === null)
+    throw new Error("rafa update current runs inside a project, and was handed none");
+  return context.project;
+}
+function boardAccess(project, seams) {
+  let configured;
+  try {
+    configured = loadConfig({ root: project.root, home: project.home }, {}, () => {}).config.prProvider;
+  } catch (error) {
+    throw couldNotRun(`config: ${messageOf(error)}`);
+  }
+  const provider = resolvePrProvider({ configured, dir: project.root, readRemote: seams.readRemote }).provider;
+  return provider === "gh" ? { gh: seams.openGh(project.root), reason: "" } : { gh: null, reason: `pr.provider is ${provider}, so there is no GitHub board` };
+}
+function foldersText(plan2) {
+  if (plan2.folders.length === 0)
+    return "nothing missing";
+  return `create ${plan2.folders.join(", ")}`;
+}
+function boardText2(plan2) {
+  if (plan2.board.kind === "skipped")
+    return `skipped: ${plan2.board.reason}`;
+  if (plan2.board.missing.length === 0)
+    return "every label present";
+  return `create labels ${plan2.board.missing.join(", ")}`;
+}
+function deprecationsText(plan2) {
+  if (plan2.deprecations.length === 0)
+    return "none registered yet (#718)";
+  return `${String(plan2.deprecations.length)} to run`;
+}
+function lockText(plan2) {
+  const where = plan2.lockRoot === plan2.root ? "" : ` in ${plan2.lockRoot}`;
+  if (plan2.lock === "unchanged")
+    return `unchanged at ${plan2.to}${where}`;
+  if (plan2.lock === "created")
+    return `create at ${plan2.to}${where}`;
+  return `update ${String(plan2.from)} \u2192 ${plan2.to}${where}`;
+}
+function planLines2(plan2) {
+  const from = plan2.from ?? `no ${LOCK_FILE}`;
+  return [
+    `rafa update current: ${plan2.root}, from ${from} to ${plan2.to}`,
+    `  folders       ${foldersText(plan2)}`,
+    `  board         ${boardText2(plan2)}`,
+    `  deprecations  ${deprecationsText(plan2)}`,
+    `  ${LOCK_FILE}     ${lockText(plan2)}`
+  ];
+}
+function appliedLines(applied, plan2, context) {
+  for (const path9 of applied.folders)
+    context.output.info(`created ${path9}`);
+  for (const part of applied.labels) {
+    if (part.outcome === "created")
+      context.output.info(`created label ${part.name}`);
+    if (part.outcome === "refused")
+      context.output.warn(`label ${part.name} was not created: ${part.detail}`);
+  }
+  if (applied.lock !== "unchanged")
+    context.output.info(`wrote ${LOCK_FILE} at ${plan2.to}`);
+}
+async function confirmed3(yes, seams) {
+  if (yes)
+    return true;
+  if (!seams.isTerminal()) {
+    throw new CommandExit(1, "REFUSED \u2014 rafa update current asks before it changes anything, and there is no" + " terminal to ask on. Run it with --dry-run to see the changes, then with --yes to apply them." + `
+nothing was changed.`);
+  }
+  const prompter = seams.openPrompter();
+  try {
+    const answer5 = await prompter.ask(APPLY_QUESTION);
+    return answer5 !== null && YES_ANSWERS7.includes(answer5.trim().toLowerCase());
+  } finally {
+    prompter.close();
+  }
+}
+function readRange2(root, installed) {
+  let recorded;
+  try {
+    recorded = readProjectLock(root)?.rafa ?? null;
+  } catch (error) {
+    throw couldNotRun(messageOf(error));
+  }
+  const range = readCurrentRange(recorded, installed);
+  if (range.kind === "refused")
+    throw new CommandExit(1, `REFUSED \u2014 ${range.message}
+nothing was changed.`);
+  return range;
+}
+function refuseConflicts(project) {
+  const conflicts2 = scaffoldConflicts(project.root, project.home);
+  if (conflicts2.length === 0)
+    return;
+  throw couldNotRun(`the project scope cannot be written:
+${conflicts2.map((conflict) => `  ${conflict}`).join(`
+`)}`);
+}
+function stoppedPartWay(error) {
+  const kept = error.written.length === 0 ? "Nothing was written before it." : `Already written, and kept: ${error.written.join(", ")}.`;
+  return new CommandExit(2, `FAIL \u2014 ${error.step}: ${error.message}
+stopped part-way. ${kept}` + `
+Fix the cause and run rafa update current again: each step writes only what is missing.`);
+}
+async function applyAndReport(plan2, gh, context) {
+  let applied;
+  try {
+    applied = await applyUpdatePlan(plan2, gh);
+  } catch (error) {
+    if (error instanceof UpdateStepError)
+      throw stoppedPartWay(error);
+    throw error;
+  }
+  appliedLines(applied, plan2, context);
+  return applied;
+}
+function refusedLabels(applied) {
+  const refused7 = applied.labels.filter((part) => part.outcome === "refused");
+  if (refused7.length === 0)
+    return null;
+  return new CommandExit(1, `${String(refused7.length)} board label(s) were not created; everything else was applied.` + " Run rafa update current again once gh can create them.");
+}
+function stopLine2(plan2, dryRun) {
+  if (!planChanges(plan2))
+    return "Nothing to change.";
+  if (dryRun)
+    return "Dry run: nothing was written. Run rafa update current to apply it.";
+  return null;
+}
+async function runUpdateCurrent(context, seams) {
+  expectNoArgument(context.args, USAGE47);
+  const dryRun = readSwitch4(context, "dry-run");
+  const yes = readSwitch4(context, "yes");
+  const project = projectOf17(context);
+  const lockRoot = seams.lockRootOf(project.root);
+  const range = readRange2(lockRoot, seams.installed);
+  refuseConflicts(project);
+  const access = boardAccess(project, seams);
+  const plan2 = await readUpdatePlan({ root: project.root, lockRoot }, range, access);
+  for (const line of planLines2(plan2))
+    context.output.info(line);
+  const finish2 = (applied2) => {
+    if (context.outputMode === "json")
+      context.output.result({ plan: plan2, applied: applied2 });
+  };
+  const stop = stopLine2(plan2, dryRun);
+  if (stop !== null) {
+    context.output.info(stop);
+    finish2(null);
+    return;
+  }
+  context.output.warn("rafa cannot roll these changes back. Run it with --dry-run first to only see them.");
+  if (!await confirmed3(yes, seams)) {
+    context.output.info("Nothing was changed.");
+    finish2(null);
+    return;
+  }
+  const applied = await applyAndReport(plan2, access.gh, context);
+  finish2(applied);
+  const refusal16 = refusedLabels(applied);
+  if (refusal16 !== null)
+    throw refusal16;
+}
+function createUpdateCurrentCommand(seams = DEFAULT_UPDATE_CURRENT_SEAMS) {
+  const command = {
+    name: "update current",
+    subject: "update",
+    action: "current",
+    summary: "bring this project to the installed rafa, within its patch range",
+    description: "Brings the project to the installed rafa when the installed version shares the major and" + ` minor of the version \`${LOCK_FILE}\` records at the project root, and is the same patch or newer.` + " A project with no lock is adopted at the installed version. It creates the missing `.rafa/` folders" + " and the missing board labels on a GitHub board, runs the deprecations step (none registered yet)," + ` and writes \`${LOCK_FILE}\`. It prints every change first; \`--dry-run\` stops there. Otherwise it` + " warns that the changes cannot be rolled back and asks once, `--yes` answering; with no terminal and" + " no `--yes` it refuses with exit code 1. A newer minor or major, or an installed rafa older than the" + " lock, refuses with exit code 1, and so does a board label `gh` would not create, once everything" + " else is applied. A lock or config that cannot be read, or a `.rafa/` path holding something else," + " exits 2 before anything is asked; a folder or the lock that cannot be written exits 2 naming the" + " step and what was already written. In a linked worktree the lock is the worktree's, on its branch." + " With `--output=json` the plan and what was applied are the data of the terminal result event.",
+    args: [],
+    flags: [
+      { name: "dry-run", description: "Print every change and write nothing.", type: "boolean" },
+      { name: "yes", description: "Apply the changes without asking.", type: "boolean" }
+    ],
+    examples: [
+      { cmd: "rafa update current --dry-run", note: "Lists the folders, labels and lock it would write, and writes nothing." },
+      { cmd: "rafa update current --yes", note: "Applies them without asking, as a script or a loop host runs it." }
+    ],
+    outputs: ["text", "json"],
+    run: async (context) => runUpdateCurrent(context, seams)
+  };
+  return Object.freeze(command);
+}
+var USAGE47 = "rafa update current [--dry-run] [--yes]", APPLY_QUESTION = "Apply these changes? [y/N] ", YES_ANSWERS7, DEFAULT_UPDATE_CURRENT_SEAMS, current_default2;
+var init_current2 = __esm(() => {
+  init_github();
+  init_command();
+  init_confirm();
+  init_version();
+  init_config_load();
+  init_config_sections();
+  init_provider();
+  init_lock();
+  init_scaffold();
+  init_update_current();
+  init_update_range();
+  init_worktree_root();
+  init_project_id();
+  init_plan_files();
+  YES_ANSWERS7 = ["y", "yes"];
+  DEFAULT_UPDATE_CURRENT_SEAMS = Object.freeze({
+    installed: RAFA_VERSION,
+    openGh: (root) => createGhRunner({ cwd: root }),
+    readRemote: gitRemoteUrl,
+    isTerminal: () => process.stdin.isTTY === true,
+    openPrompter: () => createLinePrompter(process.stdin, process.stderr),
+    lockRootOf: (root) => checkoutLockRoot(root, process.cwd())
+  });
+  current_default2 = createUpdateCurrentCommand();
+});
+
+// src/commands/update/latest.ts
+var latest_default;
+var init_latest = __esm(() => {
+  init_stub();
+  latest_default = createUpdateStub({ action: "latest", summary: "move this project to the newest version", issue: 716 });
+});
+
+// src/commands/update/next.ts
+var next_default2;
+var init_next2 = __esm(() => {
+  init_stub();
+  next_default2 = createUpdateStub({ action: "next", summary: "move this project to the newest minor of its major", issue: 716 });
+});
+
+// src/commands/update/port.ts
+var port_default;
+var init_port = __esm(() => {
+  init_stub();
+  port_default = createUpdateStub({ action: "port", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+});
+
+// src/commands/update/project.ts
+var project_default;
+var init_project = __esm(() => {
+  init_stub();
+  project_default = createUpdateStub({ action: "project", summary: "move this project to a version, with its migrations", issue: 716 });
+});
+
+// src/commands/update/rafa.ts
+var rafa_default;
+var init_rafa = __esm(() => {
+  init_stub();
+  rafa_default = createUpdateStub({ action: "rafa", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+});
+
+// src/commands/update/self.ts
+var self_default;
+var init_self = __esm(() => {
+  init_stub();
+  self_default = createUpdateStub({ action: "self", summary: "update rafa itself, from npm, a pinned version or another source", issue: 715 });
+});
+
 // src/usage.ts
 async function usage(_args) {
   const pct = await getClaudeUsagePercent();
@@ -64743,6 +65241,14 @@ var init_commands2 = __esm(() => {
   init_show8();
   init_status4();
   init_switch();
+  init_board();
+  init_current2();
+  init_latest();
+  init_next2();
+  init_port();
+  init_project();
+  init_rafa();
+  init_self();
   init_usage2();
   CORE_SUBJECTS = Object.freeze([
     { name: "plan", summary: "create plans from specs; list, show and validate them; read their risk and needs" },
@@ -64757,7 +65263,8 @@ var init_commands2 = __esm(() => {
     { name: "release", summary: "read the release state of the project; settle the waiting fragments into a version; tag the commit that set it" },
     { name: "board", summary: "list the boards with their owner, epic count, and which is current and home" },
     { name: "epic", summary: "show one epic's issues as the Roadmap table; create an epic; defer or promote it; move an issue to it; close it through the gate or cancel it" },
-    { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" }
+    { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" },
+    { name: "update", summary: "bring this project to the installed rafa; the other updates are in development" }
   ]);
   CORE_COMMANDS = Object.freeze([
     create_default2,
@@ -64829,6 +65336,14 @@ var init_commands2 = __esm(() => {
     hand_default,
     accept_default,
     take_default,
+    current_default2,
+    self_default,
+    project_default,
+    rafa_default,
+    port_default,
+    board_default,
+    next_default2,
+    latest_default,
     status_default3,
     next_default,
     roadmap_default,
@@ -65459,12 +65974,12 @@ init_config_sections();
 init_sessions();
 init_scope();
 init_sections2();
-import { mkdirSync as mkdirSync30, readFileSync as readFileSync79, renameSync as renameSync12, writeFileSync as writeFileSync31 } from "fs";
-import { dirname as dirname39, join as join98 } from "path";
+import { mkdirSync as mkdirSync30, readFileSync as readFileSync80, renameSync as renameSync12, writeFileSync as writeFileSync32 } from "fs";
+import { dirname as dirname39, join as join100 } from "path";
 var SEEN_FILE = "status-seen.json";
 var SEEN_VERSION = 1;
 function seenFilePath(root) {
-  return join98(scopeAt(root).dir, SEEN_FILE);
+  return join100(scopeAt(root).dir, SEEN_FILE);
 }
 function readSeenSessions(root, isAlive) {
   const sessions = {};
@@ -65519,7 +66034,7 @@ function asSnapshot(value) {
 function readSeenFile(root) {
   let text2;
   try {
-    text2 = readFileSync79(seenFilePath(root), "utf8");
+    text2 = readFileSync80(seenFilePath(root), "utf8");
   } catch {
     return null;
   }
@@ -65533,7 +66048,7 @@ function writeSeenFile(root, snapshot) {
   const file = seenFilePath(root);
   mkdirSync30(dirname39(file), { recursive: true });
   const temporary = `${file}.${String(process.pid)}.tmp`;
-  writeFileSync31(temporary, `${JSON.stringify(snapshot, null, 2)}
+  writeFileSync32(temporary, `${JSON.stringify(snapshot, null, 2)}
 `);
   renameSync12(temporary, file);
 }

package/dist/effort/store/index.js

@@ -14,7 +14,7 @@ import {
   openNdjsonStore,
   openSqliteStore,
   selectEffortStore
-} from "../../index-bvfbfa63.js";
+} from "../../index-bebv92ha.js";
 import"../../index-vp0xghk2.js";
 import"../../index-d6d0942q.js";
 import"../../index-3mzw3kzh.js";

package/dist/{index-bvfbfa63.js → index-bebv92ha.js}

@@ -259,7 +259,7 @@ import { Database } from "bun:sqlite";
 
 // package.json
 var name = "@open-tomato/rafa";
-var version = "0.34.0";
+var version = "0.34.1";
 
 // src/cli/version.ts
 var RAFA_VERSION = version;

package/dist/{index-b8t7q5hc.js → index-nr4hdb35.js}

@@ -321,6 +321,7 @@ import {
   sessionLine,
   sessionLogDir,
   setUpBoard,
+  setUpLabels,
   severalRoadmapsMessage,
   shellQuote,
   show_default,
@@ -356,7 +357,7 @@ import {
   worktreeAt,
   writeSession,
   writeShippedFile
-} from "./index-4b3m7s0z.js";
+} from "./index-s8ff86xt.js";
 import {
   PROBE_TIMEOUT_MS,
   loadPlanPrerequisites,
@@ -388,6 +389,7 @@ import {
   MOVE_TO_SQLITE,
   MergeRefusal,
   POSITION_FILE,
+  RAFA_VERSION,
   RebuildRefusal,
   SCOPE_DIR,
   SKILL_FILE,
@@ -421,6 +423,7 @@ import {
   isFile,
   issueLine,
   loadConfig,
+  mainCheckoutOf,
   mergeFrontmatter,
   mergeStore,
   migrateStore,
@@ -461,7 +464,7 @@ import {
   versionLine,
   writeFrontmatter,
   writePositionFile
-} from "./index-bvfbfa63.js";
+} from "./index-bebv92ha.js";
 import {
   CONFIG_DEFAULTS,
   CONFIG_FILE,
@@ -22078,6 +22081,445 @@ function createStatusCommand(seams = DEFAULT_STATUS_SEAMS) {
 }
 var status_default3 = createStatusCommand();
 
+// src/commands/update/stub.ts
+var ISSUES_URL = "https://github.com/open-tomato/rafa/issues";
+function stubMessage(action, issue2) {
+  return `rafa update ${action} is a feature in development, tracked in ${ISSUES_URL}/${String(issue2)}.` + " Nothing was changed.";
+}
+function createUpdateStub(spec) {
+  const command = {
+    name: `update ${spec.action}`,
+    subject: "update",
+    action: spec.action,
+    summary: `${spec.summary} (in development, #${String(spec.issue)})`,
+    description: `${spec.summary}. In development: it refuses with exit code 1, naming #${String(spec.issue)},` + " and changes nothing.",
+    args: [],
+    flags: [],
+    examples: [{ cmd: `rafa update ${spec.action}`, note: `Refuses, naming #${String(spec.issue)}; changes nothing.` }],
+    outputs: ["text", "json"],
+    needsProject: false,
+    ...spec.hidden === true ? { hidden: true } : {},
+    run: () => Promise.reject(new CommandExit(1, stubMessage(spec.action, spec.issue)))
+  };
+  return Object.freeze(command);
+}
+
+// src/commands/update/board.ts
+var board_default = createUpdateStub({ action: "board", summary: "apply the board's newest setup and its migrations", issue: 717 });
+
+// src/project/lock.ts
+import { existsSync as existsSync15, lstatSync as lstatSync2, readFileSync as readFileSync28, writeFileSync as writeFileSync12 } from "fs";
+import { join as join40 } from "path";
+var LOCK_FILE = "rafa.lock";
+var LOCKFILE_VERSION = 1;
+
+class ProjectLockError extends Error {
+  name = "ProjectLockError";
+}
+function lockPath(root) {
+  return join40(root, LOCK_FILE);
+}
+function projectLockText(version2) {
+  const lock = { lockfileVersion: LOCKFILE_VERSION, rafa: version2 };
+  return `${JSON.stringify(lock, null, 2)}
+`;
+}
+function isLink(path) {
+  try {
+    return lstatSync2(path).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function refuse8(problem2) {
+  throw new ProjectLockError(`${LOCK_FILE} ${problem2}`);
+}
+function lockOf(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    refuse8("holds no JSON object");
+  const record = value;
+  const format = record["lockfileVersion"];
+  if (format !== LOCKFILE_VERSION) {
+    refuse8(`is in lockfileVersion ${String(format)}, and this rafa reads ${String(LOCKFILE_VERSION)}: a newer rafa wrote it`);
+  }
+  const rafa = record["rafa"];
+  if (typeof rafa !== "string" || parseSemanticVersion(rafa) === null) {
+    refuse8(`names rafa ${JSON.stringify(rafa)}, which is no version`);
+  }
+  return { lockfileVersion: LOCKFILE_VERSION, rafa };
+}
+function readProjectLock(root) {
+  const path = lockPath(root);
+  if (!existsSync15(path)) {
+    if (isLink(path))
+      refuse8("is a link to nothing");
+    return null;
+  }
+  let text;
+  try {
+    text = readFileSync28(path, "utf8");
+  } catch (error) {
+    refuse8(`could not be read: ${messageOf(error)}`);
+  }
+  let value;
+  try {
+    value = JSON.parse(text);
+  } catch {
+    refuse8("is not JSON");
+  }
+  return lockOf(value);
+}
+function writeProjectLock(root, version2) {
+  writeFileSync12(lockPath(root), projectLockText(version2), "utf8");
+}
+
+// src/project/update-current.ts
+import { existsSync as existsSync16 } from "fs";
+import { join as join41 } from "path";
+var DEPRECATIONS = Object.freeze([]);
+function missingFolders(root) {
+  return PROJECT_TREE.map((name) => join41(SCOPE_DIR, name)).filter((relative9) => !existsSync16(join41(root, relative9)));
+}
+async function readBoard3(access) {
+  if (access.gh === null)
+    return { kind: "skipped", reason: access.reason };
+  try {
+    const held = await listBoardLabels(access.gh);
+    return { kind: "labels", missing: missingBoardLabels(held).map((label) => label.name) };
+  } catch (error) {
+    return { kind: "skipped", reason: messageOf(error) };
+  }
+}
+function lockChangeOf(range) {
+  if (range.kind === "adopt")
+    return "created";
+  return range.kind === "patch" ? "updated" : "unchanged";
+}
+function fromOf(range) {
+  if (range.kind === "patch")
+    return range.from;
+  if (range.kind === "same")
+    return range.to;
+  return null;
+}
+async function readUpdatePlan(roots, range, board) {
+  const { root, lockRoot } = roots;
+  return {
+    root,
+    lockRoot,
+    from: fromOf(range),
+    to: range.to,
+    folders: missingFolders(root),
+    board: await readBoard3(board),
+    deprecations: DEPRECATIONS,
+    lock: lockChangeOf(range)
+  };
+}
+function planChanges(plan2) {
+  const labels = plan2.board.kind === "labels" ? plan2.board.missing.length : 0;
+  return plan2.folders.length > 0 || labels > 0 || plan2.deprecations.length > 0 || plan2.lock !== "unchanged";
+}
+
+class UpdateStepError extends Error {
+  step;
+  written;
+  name = "UpdateStepError";
+  constructor(step, message, written) {
+    super(message);
+    this.step = step;
+    this.written = written;
+  }
+}
+function foldersNowThere(plan2) {
+  return plan2.folders.filter((relative9) => existsSync16(join41(plan2.root, relative9)));
+}
+function writeFolders(plan2) {
+  if (plan2.folders.length === 0)
+    return [];
+  try {
+    return writeProjectScope(plan2.root).filter((write) => write.change === "created").map((write) => write.path);
+  } catch (error) {
+    throw new UpdateStepError("folders", messageOf(error), foldersNowThere(plan2));
+  }
+}
+function createdLabels(parts) {
+  return parts.filter((part) => part.outcome === "created").map((part) => `label ${part.name}`);
+}
+async function applyUpdatePlan(plan2, gh) {
+  const folders = writeFolders(plan2);
+  const labels = gh !== null && plan2.board.kind === "labels" && plan2.board.missing.length > 0 ? await setUpLabels(gh) : [];
+  if (plan2.lock !== "unchanged") {
+    try {
+      writeProjectLock(plan2.lockRoot, plan2.to);
+    } catch (error) {
+      throw new UpdateStepError("lock", messageOf(error), [...folders, ...createdLabels(labels)]);
+    }
+  }
+  return { folders, labels, lock: plan2.lock };
+}
+
+// src/project/update-range.ts
+function refused2(reason, message) {
+  return { kind: "refused", reason, message };
+}
+function readCurrentRange(recorded, installed) {
+  const to = parseSemanticVersion(installed);
+  if (to === null)
+    return refused2("unreadable", `the installed rafa answers "${installed}", which is no version`);
+  if (recorded === null)
+    return { kind: "adopt", to: installed };
+  const from = parseSemanticVersion(recorded);
+  if (from === null)
+    return refused2("unreadable", `the project records rafa "${recorded}", which is no version`);
+  const order = compareVersions(to, from);
+  if (order < 0) {
+    return refused2("older", `the installed rafa ${installed} is older than the project's ${recorded}, and no downgrade runs before 1.0.0`);
+  }
+  if (to.major !== from.major) {
+    return refused2("newer-major", `the installed rafa ${installed} is a newer major than the project's ${recorded}; that move is rafa update latest`);
+  }
+  if (to.minor !== from.minor) {
+    return refused2("newer-minor", `the installed rafa ${installed} is a newer minor than the project's ${recorded}; that move is rafa update next`);
+  }
+  return order === 0 ? { kind: "same", to: installed } : { kind: "patch", from: recorded, to: installed };
+}
+
+// src/commands/update/current.ts
+var USAGE42 = "rafa update current [--dry-run] [--yes]";
+var APPLY_QUESTION = "Apply these changes? [y/N] ";
+var YES_ANSWERS5 = ["y", "yes"];
+function checkoutLockRoot(root, dir) {
+  const run = Bun.spawnSync(["git", "rev-parse", "--show-toplevel"], { cwd: dir, stdout: "pipe", stderr: "pipe" });
+  if (run.exitCode !== 0)
+    return root;
+  const top = run.stdout.toString().trim();
+  return top !== "" && mainCheckoutOf(top) === root ? top : root;
+}
+var DEFAULT_UPDATE_CURRENT_SEAMS = Object.freeze({
+  installed: RAFA_VERSION,
+  openGh: (root) => createGhRunner({ cwd: root }),
+  readRemote: gitRemoteUrl,
+  isTerminal: () => process.stdin.isTTY === true,
+  openPrompter: () => createLinePrompter(process.stdin, process.stderr),
+  lockRootOf: (root) => checkoutLockRoot(root, process.cwd())
+});
+function readSwitch4(context, name) {
+  const value = context.flags[name];
+  if (value === undefined || value === false || value === "false")
+    return false;
+  if (value === true || value === "true")
+    return true;
+  throw new CommandExit(1, `\u274C --${name} takes no value, and read "${String(value)}" as one
+Usage: ${USAGE42}`);
+}
+function couldNotRun(problem2) {
+  return new CommandExit(2, `FAIL \u2014 ${problem2}
+nothing was changed.`);
+}
+function projectOf15(context) {
+  if (context.project === null)
+    throw new Error("rafa update current runs inside a project, and was handed none");
+  return context.project;
+}
+function boardAccess(project, seams) {
+  let configured;
+  try {
+    configured = loadConfig({ root: project.root, home: project.home }, {}, () => {}).config.prProvider;
+  } catch (error) {
+    throw couldNotRun(`config: ${messageOf(error)}`);
+  }
+  const provider = resolvePrProvider({ configured, dir: project.root, readRemote: seams.readRemote }).provider;
+  return provider === "gh" ? { gh: seams.openGh(project.root), reason: "" } : { gh: null, reason: `pr.provider is ${provider}, so there is no GitHub board` };
+}
+function foldersText(plan2) {
+  if (plan2.folders.length === 0)
+    return "nothing missing";
+  return `create ${plan2.folders.join(", ")}`;
+}
+function boardText2(plan2) {
+  if (plan2.board.kind === "skipped")
+    return `skipped: ${plan2.board.reason}`;
+  if (plan2.board.missing.length === 0)
+    return "every label present";
+  return `create labels ${plan2.board.missing.join(", ")}`;
+}
+function deprecationsText(plan2) {
+  if (plan2.deprecations.length === 0)
+    return "none registered yet (#718)";
+  return `${String(plan2.deprecations.length)} to run`;
+}
+function lockText(plan2) {
+  const where = plan2.lockRoot === plan2.root ? "" : ` in ${plan2.lockRoot}`;
+  if (plan2.lock === "unchanged")
+    return `unchanged at ${plan2.to}${where}`;
+  if (plan2.lock === "created")
+    return `create at ${plan2.to}${where}`;
+  return `update ${String(plan2.from)} \u2192 ${plan2.to}${where}`;
+}
+function planLines2(plan2) {
+  const from = plan2.from ?? `no ${LOCK_FILE}`;
+  return [
+    `rafa update current: ${plan2.root}, from ${from} to ${plan2.to}`,
+    `  folders       ${foldersText(plan2)}`,
+    `  board         ${boardText2(plan2)}`,
+    `  deprecations  ${deprecationsText(plan2)}`,
+    `  ${LOCK_FILE}     ${lockText(plan2)}`
+  ];
+}
+function appliedLines(applied, plan2, context) {
+  for (const path of applied.folders)
+    context.output.info(`created ${path}`);
+  for (const part of applied.labels) {
+    if (part.outcome === "created")
+      context.output.info(`created label ${part.name}`);
+    if (part.outcome === "refused")
+      context.output.warn(`label ${part.name} was not created: ${part.detail}`);
+  }
+  if (applied.lock !== "unchanged")
+    context.output.info(`wrote ${LOCK_FILE} at ${plan2.to}`);
+}
+async function confirmed2(yes, seams) {
+  if (yes)
+    return true;
+  if (!seams.isTerminal()) {
+    throw new CommandExit(1, "REFUSED \u2014 rafa update current asks before it changes anything, and there is no" + " terminal to ask on. Run it with --dry-run to see the changes, then with --yes to apply them." + `
+nothing was changed.`);
+  }
+  const prompter = seams.openPrompter();
+  try {
+    const answer2 = await prompter.ask(APPLY_QUESTION);
+    return answer2 !== null && YES_ANSWERS5.includes(answer2.trim().toLowerCase());
+  } finally {
+    prompter.close();
+  }
+}
+function readRange(root, installed) {
+  let recorded;
+  try {
+    recorded = readProjectLock(root)?.rafa ?? null;
+  } catch (error) {
+    throw couldNotRun(messageOf(error));
+  }
+  const range = readCurrentRange(recorded, installed);
+  if (range.kind === "refused")
+    throw new CommandExit(1, `REFUSED \u2014 ${range.message}
+nothing was changed.`);
+  return range;
+}
+function refuseConflicts(project) {
+  const conflicts2 = scaffoldConflicts(project.root, project.home);
+  if (conflicts2.length === 0)
+    return;
+  throw couldNotRun(`the project scope cannot be written:
+${conflicts2.map((conflict) => `  ${conflict}`).join(`
+`)}`);
+}
+function stoppedPartWay(error) {
+  const kept = error.written.length === 0 ? "Nothing was written before it." : `Already written, and kept: ${error.written.join(", ")}.`;
+  return new CommandExit(2, `FAIL \u2014 ${error.step}: ${error.message}
+stopped part-way. ${kept}` + `
+Fix the cause and run rafa update current again: each step writes only what is missing.`);
+}
+async function applyAndReport(plan2, gh, context) {
+  let applied;
+  try {
+    applied = await applyUpdatePlan(plan2, gh);
+  } catch (error) {
+    if (error instanceof UpdateStepError)
+      throw stoppedPartWay(error);
+    throw error;
+  }
+  appliedLines(applied, plan2, context);
+  return applied;
+}
+function refusedLabels(applied) {
+  const refused3 = applied.labels.filter((part) => part.outcome === "refused");
+  if (refused3.length === 0)
+    return null;
+  return new CommandExit(1, `${String(refused3.length)} board label(s) were not created; everything else was applied.` + " Run rafa update current again once gh can create them.");
+}
+function stopLine2(plan2, dryRun) {
+  if (!planChanges(plan2))
+    return "Nothing to change.";
+  if (dryRun)
+    return "Dry run: nothing was written. Run rafa update current to apply it.";
+  return null;
+}
+async function runUpdateCurrent(context, seams) {
+  expectNoArgument(context.args, USAGE42);
+  const dryRun = readSwitch4(context, "dry-run");
+  const yes = readSwitch4(context, "yes");
+  const project = projectOf15(context);
+  const lockRoot = seams.lockRootOf(project.root);
+  const range = readRange(lockRoot, seams.installed);
+  refuseConflicts(project);
+  const access = boardAccess(project, seams);
+  const plan2 = await readUpdatePlan({ root: project.root, lockRoot }, range, access);
+  for (const line of planLines2(plan2))
+    context.output.info(line);
+  const finish = (applied2) => {
+    if (context.outputMode === "json")
+      context.output.result({ plan: plan2, applied: applied2 });
+  };
+  const stop = stopLine2(plan2, dryRun);
+  if (stop !== null) {
+    context.output.info(stop);
+    finish(null);
+    return;
+  }
+  context.output.warn("rafa cannot roll these changes back. Run it with --dry-run first to only see them.");
+  if (!await confirmed2(yes, seams)) {
+    context.output.info("Nothing was changed.");
+    finish(null);
+    return;
+  }
+  const applied = await applyAndReport(plan2, access.gh, context);
+  finish(applied);
+  const refusal13 = refusedLabels(applied);
+  if (refusal13 !== null)
+    throw refusal13;
+}
+function createUpdateCurrentCommand(seams = DEFAULT_UPDATE_CURRENT_SEAMS) {
+  const command = {
+    name: "update current",
+    subject: "update",
+    action: "current",
+    summary: "bring this project to the installed rafa, within its patch range",
+    description: "Brings the project to the installed rafa when the installed version shares the major and" + ` minor of the version \`${LOCK_FILE}\` records at the project root, and is the same patch or newer.` + " A project with no lock is adopted at the installed version. It creates the missing `.rafa/` folders" + " and the missing board labels on a GitHub board, runs the deprecations step (none registered yet)," + ` and writes \`${LOCK_FILE}\`. It prints every change first; \`--dry-run\` stops there. Otherwise it` + " warns that the changes cannot be rolled back and asks once, `--yes` answering; with no terminal and" + " no `--yes` it refuses with exit code 1. A newer minor or major, or an installed rafa older than the" + " lock, refuses with exit code 1, and so does a board label `gh` would not create, once everything" + " else is applied. A lock or config that cannot be read, or a `.rafa/` path holding something else," + " exits 2 before anything is asked; a folder or the lock that cannot be written exits 2 naming the" + " step and what was already written. In a linked worktree the lock is the worktree's, on its branch." + " With `--output=json` the plan and what was applied are the data of the terminal result event.",
+    args: [],
+    flags: [
+      { name: "dry-run", description: "Print every change and write nothing.", type: "boolean" },
+      { name: "yes", description: "Apply the changes without asking.", type: "boolean" }
+    ],
+    examples: [
+      { cmd: "rafa update current --dry-run", note: "Lists the folders, labels and lock it would write, and writes nothing." },
+      { cmd: "rafa update current --yes", note: "Applies them without asking, as a script or a loop host runs it." }
+    ],
+    outputs: ["text", "json"],
+    run: async (context) => runUpdateCurrent(context, seams)
+  };
+  return Object.freeze(command);
+}
+var current_default2 = createUpdateCurrentCommand();
+
+// src/commands/update/latest.ts
+var latest_default = createUpdateStub({ action: "latest", summary: "move this project to the newest version", issue: 716 });
+
+// src/commands/update/next.ts
+var next_default2 = createUpdateStub({ action: "next", summary: "move this project to the newest minor of its major", issue: 716 });
+
+// src/commands/update/port.ts
+var port_default = createUpdateStub({ action: "port", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+
+// src/commands/update/project.ts
+var project_default = createUpdateStub({ action: "project", summary: "move this project to a version, with its migrations", issue: 716 });
+
+// src/commands/update/rafa.ts
+var rafa_default = createUpdateStub({ action: "rafa", summary: "move this project to a version, as update project does", issue: 716, hidden: true });
+
+// src/commands/update/self.ts
+var self_default = createUpdateStub({ action: "self", summary: "update rafa itself, from npm, a pinned version or another source", issue: 715 });
+
 // src/commands/usage.ts
 var usage_default = wrapPhaseZeroCommand({
   name: "usage",
@@ -22110,7 +22552,8 @@ var CORE_SUBJECTS = Object.freeze([
   { name: "release", summary: "read the release state of the project; settle the waiting fragments into a version; tag the commit that set it" },
   { name: "board", summary: "list the boards with their owner, epic count, and which is current and home" },
   { name: "epic", summary: "show one epic's issues as the Roadmap table; create an epic; defer or promote it; move an issue to it; close it through the gate or cancel it" },
-  { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" }
+  { name: "claim", summary: "give up this device's claim on an issue; hand it to another store or withdraw the offer; accept a handover; take over a stale claim" },
+  { name: "update", summary: "bring this project to the installed rafa; the other updates are in development" }
 ]);
 var CORE_COMMANDS = Object.freeze([
   create_default2,
@@ -22182,6 +22625,14 @@ var CORE_COMMANDS = Object.freeze([
   hand_default,
   accept_default,
   take_default,
+  current_default2,
+  self_default,
+  project_default,
+  rafa_default,
+  port_default,
+  board_default,
+  next_default2,
+  latest_default,
   status_default3,
   next_default,
   roadmap_default,

package/dist/{index-4b3m7s0z.js → index-s8ff86xt.js}

@@ -127,7 +127,7 @@ import {
   writeNames,
   writePositionFile,
   writeSqliteStore
-} from "./index-bvfbfa63.js";
+} from "./index-bebv92ha.js";
 import {
   CHANGE_LEVELS,
   CONFIG_DEFAULTS,
@@ -14334,7 +14334,7 @@ function withOutlineCache(outline, root) {
 import path2 from "path";
 async function coreRoster() {
   const [{ CORE_REGISTRY }, { describeRegistry }] = await Promise.all([
-    import("./index-b8t7q5hc.js"),
+    import("./index-nr4hdb35.js"),
     import("./describe-5hqfwbjc.js")
   ]);
   return describeRegistry(CORE_REGISTRY, version);
@@ -31282,4 +31282,4 @@ async function plan(args, repoRoot, registry = CORE_ADAPTER_REGISTRY) {
   }
 }
 
-export { SERVE_CLI_VERSION, PROVENANCE_FIELD, SKILL_FILE2 as SKILL_FILE, provenanceBlock, serveVerdict, SKILL_USE_CLI_VERSION, MANIFEST_VERSION, FEATURE_TYPES, OUTPUT_CHANNELS, RUNNING_MANIFEST_SEAMS, validateManifest, loadModules, moduleSettings, pullBeforeRead, sessionLogDir, collectSessionRow, collect, AGENT_DEFINITION_DIR, VENDOR_COMMAND, readAgentDirectory, resolveAgentRoster, missingPlanAgents, isStackList, stackPaths, stacksFromEccSkillName, DESCRIPTION_LIMIT, LISTING_LIMIT, SKILL_SIGNALS, countCharacters, toolOf, pathDirectories, checkReferences, checkFile, checkDirectory, bundledAgentsDirectory, sourceItem, byName, skillItem, readTrees, parseReportArgs, formatCount, alignRows, verdictOf, failingRows, formatRows, waitForChecks, recordPlanCi, formatTokens, formatTrendSegment, formatLoopsSegment, readTrendInputs, trendReportOf, buildReport, readSkillsReport, report, SPEC_EXTENSION, boardId, notesFileName, shellQuote, ghMissingMessage, ghUnauthenticatedMessage, ghHostOf, ghPreflightItems, parseWorkingTree, parseWorktrees, readMergeRefusal, resolvePrProvider, requireGhProvider, createGhPullRequests, ghPullRequestsIn, REMOTE, BRANCH_PREFIX2 as BRANCH_PREFIX, parseBaseStanding, hasDiverged, parseClaimMessage, claimBranchIssue, makeOwnershipCommit, fetchClaimBranches, readClaimBranch, pushOwnershipCommit, readClaimState, idleText, ROADMAP_TITLE, ROADMAP_SETTING, parseRoadmapBody, createGhRoadmapSearch, severalRoadmapsMessage, createGhOpenPullRequests, closedIssuesIn, branchClaims, scanClaimBranches, readEpicBody, SPEC_BLOCKED_LABEL, hasSpecBlockedLabel, readBlockedBy, EPIC_LABEL_PREFIX, epicSlugsOf, isNotPlanned, groupByEpicLabel, localDay, readEpics, BOARD_LISTING_LIMIT, createGhBoardListing, validate_default, RefsBlockError, fingerprintText, PREVIOUS_COPY_WARN_ABOVE, previousDir, countPreviousCopies, createGhSpecIssueReader, readRoadmapSetting, ROADMAP_LABEL, BOARD_LABELS, LABEL_LIST_LIMIT, SPEC_TEMPLATE_PATH, TEMPLATES_DIRNAME, boardChanged, listBoardLabels, missingBoardLabels, anythingAt, writeShippedFile, setUpBoard, resolveDefaultBoard, unlabelledRoadmapMessage, createGhRoadmapBody, tickSentence, appendLine, tickLine, editChecklist, noBoardListsLine, epicTickSentence, tickRoadmapAfterMerge, createGhIssueBoard, createLinePrompter, readBlockedIssues, renderBlockedIssues, resolveTracker, DEFAULT_ISSUE_SEAMS, lineRefusal, expectTwoArguments, readTextFlag, readNonBlankFlag, readRequiredFlag, readChoice, readChoiceFlag, issueProject, issueSubjectConfig, resolveIssueTracker, issueRef, issueName, urlLines, onTracker, unblock_default, unblockAfterMerge, HORIZON_LABEL_PREFIX, readEpicProblems, epicProblemMessage, isWaiting, blockerToken, addBlockerToBody, labelsLineBlockersOf, LABELS_READS, createLabelsRelations, EPIC_TYPE_LABEL, STAGE_LABELS, unlabelReleased, readRefsText, readCopyRefs, restampCopyRefs, RefVerifyError, blockerArg, createNativeRelations, selectBoardRelations, NATIVE_MODE, NATIVE_RETRY_HINT, nativeEpicLeft, nativeAlreadyMessage, nativeParentLine, readBoardRepository, configuredMoveRelations, readConfiguredRelations, blockedLineSentence, readDoctorRefs, renderDoctorRefs, readEpicDependents, REASON_FLAG, renderHorizonComment, renderParkedPullRequestComment, renderMoveComment, renderCloseComment, renderCancelComment, cancelMoveReason, renderDependentComment, renderUnblockNote, readReason, unaskedReasonMessage, blankReasonMessage, HORIZONS, horizonOf, readListedEpics, invalidateRows, runIssueList, ISSUE_LIST_FLAGS, list_default, firstNowEpic, show_default, samePlace, resolvePlace, createPlanDirNames, hasPlanFor, memoiseVerifier, LEARNED_DIRECTORY, ORIGIN_FIELD, DEMOTION_VERDICTS, WHEN_TO_USE_HEADING, bodySections, classifySkill, firstSentence, convertToInstinct, rankCandidates, readRankCandidate, NO_NEXT_STEP, readSchemaReport, gateMeaning, unknownAdditive, unknownAdditiveWarning, developmentApplied, isFirstDispatch, createStartPreflightClaim, checkDrift, driftLines, readDoctorEffortSync, renderDoctorEffortSync, effortSyncRefusal, SESSION_ID_FLAG2 as SESSION_ID_FLAG, readBoardBody, openBoards, boardOfEpic, createOwnerResolver, resolveLoopSeams, sessionIdFlag, refusal3 as refusal, isLive, planLabel, sessionLine, projectRoot2 as projectRoot, readRecords, pickSession, writeSession, readSessionChecklist, phaseNote, phasedCounts, checkboxAt, estimateEta, readSessionFinishes, formatDuration, etaLine, RELEASE_REMOTE, RELEASE_BASE_BRANCH, parseSemanticVersion, readManifestVersion, replaceManifestVersion, gitPathOf, receiptProblem, readReceiptVerdict, FRAGMENT_PLAN_ID_PATTERN, serializeFragment, allocateFragmentName, directoryPrefix, releaseCommitSubject, readSettle, buildSettle, waitingSettingsOf, readWaiting, forecastPhrase, DEFAULT_RELEASE_SEAMS, compareVersions, changelogVersions, readTags, status_default, epicEndLines, watchDryEpic, nextOwnerGate, resolveReleaseEnabled, refuseMisplacedRuntime, readBinPath, self_update_default, versionTag, INDENT4 as INDENT, cleanUpAfterMerge, reportFollowUps, RELEASE_BLOCK_OPEN, RELEASE_BLOCK_CLOSE, localPlanNotes, readGuard, guardLines, mergeGuardSettings, readMergeGuard, guardReaction, followsMerge, readSettleAfterMerge, DEFAULT_BASE_BRANCH, ghNextBoard, openNextSources, WORKTREES_SUBDIR, resolveWorktreePath, crossRepositoryRefusal, addResolveWorktree, removeResolveWorktree, pushResolved, worktreeAt, cleanupSteps, dryRunLines, runCleanupSteps, defaultCleanupSeams, readCleanup, cleanupCounts, openNextRelations, list_default2 as list_default1, readBranch2 as readBranch, readPlans, readOpenPull, readBranchPlan, readNextState, readHomeAfterLoop, commandWords, nextQuestion, NEXT_COMMAND_ACTIONS, LABELS_ONLY_ACTIONS, actionInvocation, runAction, HINT_FLAG_SPEC, actionOutput, endWithNextStep, endingWith, lazyPrompter2 as lazyPrompter, ready_default, DEFAULT_PLAN_FILE, resolvePlanPath, assessPlanRisk, renderRiskText, announceRiskTotal, resolveCreateSpec, TRIAGE_MODULE, namedSecrets, triageReport, unresolvedTracker, DISK_ROOTS_FILE_SYSTEM, gitToplevel, rootRefusal, rootCandidates, DEFAULT_CI_TIMEOUT_MIN, CI_POLL_INTERVAL_MS, DEFAULT_CI_ATTEMPTS, MECHANICAL_CONFLICT_SENTENCE, start, usage, createPlanRefsVerifier, plan };
+export { SERVE_CLI_VERSION, PROVENANCE_FIELD, SKILL_FILE2 as SKILL_FILE, provenanceBlock, serveVerdict, SKILL_USE_CLI_VERSION, MANIFEST_VERSION, FEATURE_TYPES, OUTPUT_CHANNELS, RUNNING_MANIFEST_SEAMS, validateManifest, loadModules, moduleSettings, pullBeforeRead, sessionLogDir, collectSessionRow, collect, AGENT_DEFINITION_DIR, VENDOR_COMMAND, readAgentDirectory, resolveAgentRoster, missingPlanAgents, isStackList, stackPaths, stacksFromEccSkillName, DESCRIPTION_LIMIT, LISTING_LIMIT, SKILL_SIGNALS, countCharacters, toolOf, pathDirectories, checkReferences, checkFile, checkDirectory, bundledAgentsDirectory, sourceItem, byName, skillItem, readTrees, parseReportArgs, formatCount, alignRows, verdictOf, failingRows, formatRows, waitForChecks, recordPlanCi, formatTokens, formatTrendSegment, formatLoopsSegment, readTrendInputs, trendReportOf, buildReport, readSkillsReport, report, SPEC_EXTENSION, boardId, notesFileName, shellQuote, ghMissingMessage, ghUnauthenticatedMessage, ghHostOf, ghPreflightItems, parseWorkingTree, parseWorktrees, readMergeRefusal, resolvePrProvider, requireGhProvider, createGhPullRequests, ghPullRequestsIn, REMOTE, BRANCH_PREFIX2 as BRANCH_PREFIX, parseBaseStanding, hasDiverged, parseClaimMessage, claimBranchIssue, makeOwnershipCommit, fetchClaimBranches, readClaimBranch, pushOwnershipCommit, readClaimState, idleText, ROADMAP_TITLE, ROADMAP_SETTING, parseRoadmapBody, createGhRoadmapSearch, severalRoadmapsMessage, createGhOpenPullRequests, closedIssuesIn, branchClaims, scanClaimBranches, readEpicBody, SPEC_BLOCKED_LABEL, hasSpecBlockedLabel, readBlockedBy, EPIC_LABEL_PREFIX, epicSlugsOf, isNotPlanned, groupByEpicLabel, localDay, readEpics, BOARD_LISTING_LIMIT, createGhBoardListing, validate_default, RefsBlockError, fingerprintText, PREVIOUS_COPY_WARN_ABOVE, previousDir, countPreviousCopies, createGhSpecIssueReader, readRoadmapSetting, ROADMAP_LABEL, BOARD_LABELS, LABEL_LIST_LIMIT, SPEC_TEMPLATE_PATH, TEMPLATES_DIRNAME, boardChanged, listBoardLabels, missingBoardLabels, setUpLabels, anythingAt, writeShippedFile, setUpBoard, resolveDefaultBoard, unlabelledRoadmapMessage, createGhRoadmapBody, tickSentence, appendLine, tickLine, editChecklist, noBoardListsLine, epicTickSentence, tickRoadmapAfterMerge, createGhIssueBoard, createLinePrompter, readBlockedIssues, renderBlockedIssues, resolveTracker, DEFAULT_ISSUE_SEAMS, lineRefusal, expectTwoArguments, readTextFlag, readNonBlankFlag, readRequiredFlag, readChoice, readChoiceFlag, issueProject, issueSubjectConfig, resolveIssueTracker, issueRef, issueName, urlLines, onTracker, unblock_default, unblockAfterMerge, HORIZON_LABEL_PREFIX, readEpicProblems, epicProblemMessage, isWaiting, blockerToken, addBlockerToBody, labelsLineBlockersOf, LABELS_READS, createLabelsRelations, EPIC_TYPE_LABEL, STAGE_LABELS, unlabelReleased, readRefsText, readCopyRefs, restampCopyRefs, RefVerifyError, blockerArg, createNativeRelations, selectBoardRelations, NATIVE_MODE, NATIVE_RETRY_HINT, nativeEpicLeft, nativeAlreadyMessage, nativeParentLine, readBoardRepository, configuredMoveRelations, readConfiguredRelations, blockedLineSentence, readDoctorRefs, renderDoctorRefs, readEpicDependents, REASON_FLAG, renderHorizonComment, renderParkedPullRequestComment, renderMoveComment, renderCloseComment, renderCancelComment, cancelMoveReason, renderDependentComment, renderUnblockNote, readReason, unaskedReasonMessage, blankReasonMessage, HORIZONS, horizonOf, readListedEpics, invalidateRows, runIssueList, ISSUE_LIST_FLAGS, list_default, firstNowEpic, show_default, samePlace, resolvePlace, createPlanDirNames, hasPlanFor, memoiseVerifier, LEARNED_DIRECTORY, ORIGIN_FIELD, DEMOTION_VERDICTS, WHEN_TO_USE_HEADING, bodySections, classifySkill, firstSentence, convertToInstinct, rankCandidates, readRankCandidate, NO_NEXT_STEP, readSchemaReport, gateMeaning, unknownAdditive, unknownAdditiveWarning, developmentApplied, isFirstDispatch, createStartPreflightClaim, checkDrift, driftLines, readDoctorEffortSync, renderDoctorEffortSync, effortSyncRefusal, SESSION_ID_FLAG2 as SESSION_ID_FLAG, readBoardBody, openBoards, boardOfEpic, createOwnerResolver, resolveLoopSeams, sessionIdFlag, refusal3 as refusal, isLive, planLabel, sessionLine, projectRoot2 as projectRoot, readRecords, pickSession, writeSession, readSessionChecklist, phaseNote, phasedCounts, checkboxAt, estimateEta, readSessionFinishes, formatDuration, etaLine, RELEASE_REMOTE, RELEASE_BASE_BRANCH, parseSemanticVersion, readManifestVersion, replaceManifestVersion, gitPathOf, receiptProblem, readReceiptVerdict, FRAGMENT_PLAN_ID_PATTERN, serializeFragment, allocateFragmentName, directoryPrefix, releaseCommitSubject, readSettle, buildSettle, waitingSettingsOf, readWaiting, forecastPhrase, DEFAULT_RELEASE_SEAMS, compareVersions, changelogVersions, readTags, status_default, epicEndLines, watchDryEpic, nextOwnerGate, resolveReleaseEnabled, refuseMisplacedRuntime, readBinPath, self_update_default, versionTag, INDENT4 as INDENT, cleanUpAfterMerge, reportFollowUps, RELEASE_BLOCK_OPEN, RELEASE_BLOCK_CLOSE, localPlanNotes, readGuard, guardLines, mergeGuardSettings, readMergeGuard, guardReaction, followsMerge, readSettleAfterMerge, DEFAULT_BASE_BRANCH, ghNextBoard, openNextSources, WORKTREES_SUBDIR, resolveWorktreePath, crossRepositoryRefusal, addResolveWorktree, removeResolveWorktree, pushResolved, worktreeAt, cleanupSteps, dryRunLines, runCleanupSteps, defaultCleanupSeams, readCleanup, cleanupCounts, openNextRelations, list_default2 as list_default1, readBranch2 as readBranch, readPlans, readOpenPull, readBranchPlan, readNextState, readHomeAfterLoop, commandWords, nextQuestion, NEXT_COMMAND_ACTIONS, LABELS_ONLY_ACTIONS, actionInvocation, runAction, HINT_FLAG_SPEC, actionOutput, endWithNextStep, endingWith, lazyPrompter2 as lazyPrompter, ready_default, DEFAULT_PLAN_FILE, resolvePlanPath, assessPlanRisk, renderRiskText, announceRiskTotal, resolveCreateSpec, TRIAGE_MODULE, namedSecrets, triageReport, unresolvedTracker, DISK_ROOTS_FILE_SYSTEM, gitToplevel, rootRefusal, rootCandidates, DEFAULT_CI_TIMEOUT_MIN, CI_POLL_INTERVAL_MS, DEFAULT_CI_ATTEMPTS, MECHANICAL_CONFLICT_SENTENCE, start, usage, createPlanRefsVerifier, plan };

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   start,
   usage,
   validateManifest
-} from "./index-4b3m7s0z.js";
+} from "./index-s8ff86xt.js";
 import {
   PLAN_BLOCK_KINDS,
   PLAN_HEADER_FIELDS,
@@ -53,7 +53,7 @@ import {
   scopeAt,
   selectEffortStore,
   selfAndAncestors
-} from "./index-bvfbfa63.js";
+} from "./index-bebv92ha.js";
 import {
   CONFIG_DEFAULTS,
   CONFIG_FILE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-tomato/rafa",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Alpha. Runs a plan through the ralph loop: one Claude Code session per task, one commit per task, then a pull request and a CI wait.",
   "private": false,
   "publishConfig": {
@@ -57,7 +57,9 @@
     "lint": "eslint .",
     "check-types": "tsc --noEmit && bun run --filter './packages/*' check-types",
     "gate:control-bytes": "bun scripts/control-byte-gate/control-byte-gate.ts",
-    "snapshot": "bun scripts/snapshot-runtime.ts"
+    "snapshot": "bun scripts/snapshot-runtime.ts",
+    "stretch": "bash scripts/stretch/stretch.sh",
+    "device:check": "bash scripts/device/check.sh"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",