@brainervirus/workit-claude-code 7.5.2 → 7.7.0

package/dist/workit.js

@@ -65,7 +65,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@brainervirus/workit-cli",
-    version: "7.5.2",
+    version: "7.7.0",
     private: false,
     description: "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
     keywords: [
@@ -103,9 +103,9 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@babel/parser": "7.29.9",
-      "@brainervirus/workit-core": "^7.5.2",
-      "@brainervirus/workit-cursor": "^7.5.2",
-      "@brainervirus/workit-opencode": "^7.5.2",
+      "@brainervirus/workit-core": "^7.7.0",
+      "@brainervirus/workit-cursor": "^7.7.0",
+      "@brainervirus/workit-opencode": "^7.7.0",
       "@inkjs/ui": "2.0.0",
       ink: "7.1.1",
       react: "19.2.8"
@@ -13426,6 +13426,70 @@ function recordRuling(context, input) {
     refs: input.refs ?? []
   }, { now: context.now });
 }
+function activeStanding(rows, fanout, leads = null) {
+  const active = [];
+  for (const row of rows) {
+    if (row.fanout !== fanout || !fromLead(row, leads))
+      continue;
+    if (row.type === "standing" && typeof row.what === "string" && row.what.trim()) {
+      if (!row.superseded)
+        active.push(row);
+    } else if (row.type === "standing.cleared") {
+      const target = str2(row.target);
+      if (target === null)
+        active.length = 0;
+      else {
+        const index = active.findIndex((order) => order.id === target);
+        if (index >= 0)
+          active.splice(index, 1);
+      }
+    }
+  }
+  return active;
+}
+function leadOnly(context, lead) {
+  const session = context.actor.session;
+  if (lead !== null ? session === lead : !isDelegateSession(session))
+    return { ok: true, value: undefined };
+  return err("blocked", lead !== null ? `session ${session ?? "(none)"} is not the fanout's lead (${lead}): standing orders come from the lead` : `session ${session} is a worker or verifier: standing orders come from the lead`, lead !== null ? `the lead in a new session? workit fanout plan <plan.json> --take-lead from this session; a worker or verifier reports the order to the lead instead` : "a worker or verifier reports the order to the lead instead");
+}
+function recordStanding(context, input) {
+  const what = required2(input.what, "<order>");
+  if (!what.ok)
+    return what;
+  if (/\p{Cc}/u.test(what.value))
+    return err("invalid_input", "a standing order is one line: no newlines or control characters", 'add each order separately: workit ledger standing add "<order>"');
+  const lead = leadOnly(context, input.lead);
+  if (!lead.ok)
+    return lead;
+  const link = checkSupersede(context, "standing");
+  if (!link.ok)
+    return link;
+  return appendRow(context.cwd, {
+    ...common(context, noteKey(context)),
+    type: "standing",
+    fanout: input.fanout,
+    what: what.value
+  }, { now: context.now });
+}
+function clearStanding(context, input) {
+  const lead = leadOnly(context, input.lead);
+  if (!lead.ok)
+    return lead;
+  if (input.target !== null) {
+    const ledger = readLedger(context.cwd);
+    if (!ledger.ok)
+      return ledger;
+    if (!activeStanding(ledger.value.rows, input.fanout, input.leads ?? null).some((row) => row.id === input.target))
+      return err("not_found", `no standing order ${input.target} in force for fanout ${input.fanout}`, `workit ledger standing list --fanout ${input.fanout}`);
+  }
+  return appendRow(context.cwd, {
+    ...common(context, noteKey(context)),
+    type: "standing.cleared",
+    fanout: input.fanout,
+    target: input.target
+  }, { now: context.now });
+}
 function recordVerdict(context, input) {
   if (!VERDICT_RESULTS.includes(input.result))
     return err("invalid_input", `unknown verdict "${input.result}"; expected ${VERDICT_RESULTS.join("|")}`);
@@ -13504,6 +13568,12 @@ function summarizeRow(row) {
     case "handoff":
       summary = `next: ${text("next")}${text("note") ? ` (note: ${text("note")})` : ""}`;
       break;
+    case "standing":
+      summary = `${text("what")} (fanout ${text("fanout")})`;
+      break;
+    case "standing.cleared":
+      summary = `cleared ${text("target") || "every standing order"} (fanout ${text("fanout")})`;
+      break;
     case "commit.recorded":
       summary = `${(row.head ?? "?").slice(0, 12)} ${text("subject")}${row.actor.session ? "" : " (no session)"}`;
       break;
@@ -13730,7 +13800,7 @@ var LEDGER_VERSION = 1, MAX_LINE_BYTES = 4096, VERDICT_RESULTS, PASSING, FAILING
 }, required2 = (value, flag) => {
   const text = value?.trim();
   return text ? { ok: true, value: text } : err("invalid_input", `${flag} is required`);
-}, OBSERVED_ONLY, MAX_DIRTY_PATHS = 10, dirtyState = (cwd) => {
+}, fromLead = (row, leads) => leads === null || row.actor.session !== null && leads.includes(row.actor.session), isDelegateSession = (session) => session !== null && (/-w-[a-z0-9._-]+(?:\+try\d)?$/u.test(session) || /-v\d+$/u.test(session) || session.includes(":")), OBSERVED_ONLY, MAX_DIRTY_PATHS = 10, dirtyState = (cwd) => {
   const run = gitRun2(cwd, ["status", "--porcelain=v1", "-z", "--untracked-files=normal"], GIT_TIMEOUTS.worktree);
   if (!run.ok)
     return { dirty: false, files: 0, paths: [] };
@@ -63145,7 +63215,8 @@ var init_skill_manifests = __esm(() => {
     "workit-deslop",
     "workit-fanout",
     "workit-verify-app",
-    "workit-retro"
+    "workit-retro",
+    "workit-architecture"
   ];
   if (false) {}
 });
@@ -75712,6 +75783,7 @@ var init_stack2 = __esm(() => {
 
 // packages/workit-core/src/fanout.ts
 import { spawnSync as spawnSync21 } from "node:child_process";
+import { createHash as createHash16 } from "node:crypto";
 import fs23 from "node:fs";
 import path43 from "node:path";
 function expandBraces(pattern, limit = 64) {
@@ -75873,6 +75945,9 @@ function parsePlan(raw, defaults, name) {
     else
       shared.push(normalized.pattern);
   }
+  const fanIn = raw.fanIn ?? "prs";
+  if (!FAN_IN_MODES.includes(fanIn))
+    problems.push(`fanIn must be one of ${FAN_IN_MODES.join(", ")}`);
   if (!Array.isArray(raw.slices) || raw.slices.length === 0)
     return { ok: false, problems: [...problems, "slices: list at least one slice"] };
   const slices = [];
@@ -75954,7 +76029,9 @@ function parsePlan(raw, defaults, name) {
       verify,
       forbidden,
       context: optional("context"),
-      timebox: optional("timebox")
+      timebox: optional("timebox"),
+      hash: "",
+      hashSince: ""
     });
   });
   const byId = new Map(slices.map((slice) => [slice.id, slice]));
@@ -75987,8 +76064,11 @@ function parsePlan(raw, defaults, name) {
       v: FANOUT_VERSION,
       name: planName,
       trunk,
+      fanIn,
       shared,
       slices,
+      leadSession: null,
+      formerLeads: [],
       createdAt: "",
       updatedAt: ""
     }
@@ -76174,6 +76254,18 @@ function worktreeRoot(cwd) {
   const main = mainCheckout(cwd);
   return path43.join(path43.dirname(main), `${path43.basename(main)}-wt`);
 }
+function sliceHash(slice) {
+  const {
+    worktree: _worktree,
+    hash: _hash,
+    hashSince: _since,
+    tier: _tier,
+    timebox: _timebox,
+    context: _context,
+    ...definition
+  } = slice;
+  return createHash16("sha256").update(JSON.stringify(definition)).digest("hex").slice(0, 16);
+}
 function fanoutsDir(cwd) {
   const root = storeRoot(cwd);
   if (!root.ok)
@@ -76214,20 +76306,29 @@ function parseStored(raw) {
       verify: list(item.verify),
       forbidden: list(item.forbidden),
       context: typeof item.context === "string" ? item.context : null,
-      timebox: typeof item.timebox === "string" ? item.timebox : null
+      timebox: typeof item.timebox === "string" ? item.timebox : null,
+      hash: text(item.hash),
+      hashSince: text(item.hashSince) || text(raw.createdAt)
     });
   }
+  for (const slice of slices)
+    slice.hash ||= sliceHash(slice);
   const shared = globs(raw.shared);
   const ids = new Set(slices.map((slice) => slice.id));
   if (!globsValid || ids.size !== slices.length || slices.some((slice) => slice.dependsOn.some((dep) => dep === slice.id || !ids.has(dep))) || findCycle(slices))
     return null;
+  const fanIn = raw.fanIn === "integration" ? "integration" : "prs";
+  const createdAt = text(raw.createdAt);
   return {
     v: typeof raw.v === "number" ? raw.v : FANOUT_VERSION,
     name: raw.name,
     trunk: raw.trunk,
+    fanIn,
     shared,
     slices,
-    createdAt: text(raw.createdAt),
+    leadSession: typeof raw.leadSession === "string" && raw.leadSession ? raw.leadSession : null,
+    formerLeads: list(raw.formerLeads),
+    createdAt,
     updatedAt: text(raw.updatedAt)
   };
 }
@@ -76307,6 +76408,11 @@ function planFanout(cwd, input, now = new Date) {
   const dir = fanoutsDir(cwd);
   if (!dir.ok)
     return dir;
+  const session = input.actor.session;
+  if (input.takeLead && !session)
+    return fanoutFail("blocked", "--take-lead needs a session: WORKIT_SESSION_ID is not set", "export WORKIT_SESSION_ID=<your session id>, then plan again with --take-lead");
+  if (input.takeLead && isDelegateSession(session))
+    return fanoutFail("blocked", `session ${session} is a worker or verifier id; only a lead takes the lead`, "run --take-lead from the lead's own session");
   const parsed = parsePlan(input.trunk && isRecord8(input.raw) ? { ...input.raw, trunk: input.trunk } : input.raw, {
     trunk: input.trunk ?? defaultTrunk(cwd),
     root: mainCheckout(cwd),
@@ -76315,6 +76421,8 @@ function planFanout(cwd, input, now = new Date) {
   if (!parsed.ok)
     return fanoutFail("invalid_input", `the plan is incomplete: ${parsed.problems[0]}${parsed.problems.length > 1 ? ` (+${parsed.problems.length - 1} more)` : ""}`, "fill every listed field, then run workit fanout plan again", { problems: parsed.problems });
   const plan = parsed.plan;
+  if (plan.fanIn === "integration" && plan.trunk === defaultTrunk(cwd))
+    return fanoutFail("invalid_input", `fanIn "integration" needs an integration branch as the trunk, not ${plan.trunk}`, `workit git branch <integration-branch> --base ${plan.trunk}, then plan with --trunk <integration-branch>`);
   const badBranches = plan.slices.filter((slice) => !gitRun4(cwd, ["check-ref-format", "--branch", slice.branch]).ok).map((slice) => `slice ${slice.id}: ${slice.branch} is not a valid branch name`);
   if (badBranches.length)
     return fanoutFail("invalid_input", badBranches[0], "rename the branch in the plan", {
@@ -76343,20 +76451,50 @@ function planFanout(cwd, input, now = new Date) {
   const existing = readFanout(cwd, plan.name);
   const previous = existing.ok ? existing.data : null;
   plan.createdAt = previous?.createdAt || now.toISOString();
+  plan.leadSession = input.takeLead ? session : previous ? previous.leadSession : session;
+  plan.formerLeads = [
+    ...new Set([
+      ...previous?.formerLeads ?? [],
+      ...previous?.leadSession && previous.leadSession !== plan.leadSession ? [previous.leadSession] : []
+    ])
+  ].filter((former) => former !== plan.leadSession);
   plan.updatedAt = now.toISOString();
+  for (const slice of plan.slices) {
+    slice.hash = sliceHash(slice);
+    const before = previous?.slices.find((old) => old.id === slice.id);
+    slice.hashSince = before && before.hash === slice.hash ? before.hashSince || plan.updatedAt : plan.updatedAt;
+  }
   const written = writeFanout(cwd, plan);
   if (!written.ok)
     return written;
+  if (previous && plan.leadSession !== previous.leadSession)
+    appendObserved(cwd, {
+      type: "fanout.lead.changed",
+      actor: input.actor,
+      fanout: plan.name,
+      from: previous.leadSession,
+      to: plan.leadSession
+    });
   appendObserved(cwd, {
     type: "fanout.planned",
     actor: input.actor,
     fanout: plan.name,
     trunk: plan.trunk,
+    fanIn: plan.fanIn,
     slices: plan.slices.length,
     ids: plan.slices.slice(0, 20).map((slice) => slice.id)
   });
   const grouped = waves(plan.slices);
   const notes = [];
+  const warnings = [];
+  if (!input.takeLead && previous?.leadSession && session && session !== previous.leadSession)
+    notes.push(`the lead stays ${previous.leadSession}; this session is ${session}. Leading from this session now? workit fanout plan <plan.json> --take-lead`);
+  if (previous === null) {
+    const ledger = readLedger(cwd);
+    const inForce = ledger.ok ? activeStanding(ledger.value.rows, plan.name, planLeads(plan)) : [];
+    if (inForce.length)
+      warnings.push(`${inForce.length} standing order${inForce.length === 1 ? " is" : "s are"} already in force for fanout ${plan.name}, and every brief will carry ${inForce.length === 1 ? "it" : "them"}: ${inForce.map((row) => `"${String(row.what)}"`).join("; ")}. From an earlier run? workit ledger standing clear --fanout ${plan.name}`);
+  }
   if (!ref)
     notes.push(`trunk ${plan.trunk} does not resolve here; only sample paths of each glob were compared`);
   grouped.forEach((wave, index) => {
@@ -76371,6 +76509,7 @@ function planFanout(cwd, input, now = new Date) {
     data: {
       name: plan.name,
       trunk: plan.trunk,
+      fanIn: plan.fanIn,
       file: written.data,
       created: previous === null,
       slices: plan.slices.map(({ id, branch, base, worktree, tier, dependsOn, scope, owns }) => ({
@@ -76386,11 +76525,12 @@ function planFanout(cwd, input, now = new Date) {
       overlaps,
       waves: grouped,
       landingOrder: landingOrder(plan.slices),
-      notes
+      notes,
+      warnings
     }
   };
 }
-var FANOUT_VERSION = 1, TIERS, fanoutFail = (code, error, unblock, data) => ({
+var FANOUT_VERSION = 1, TIERS, FAN_IN_MODES, fanoutFail = (code, error, unblock, data) => ({
   ok: false,
   code,
   error,
@@ -76430,12 +76570,13 @@ var FANOUT_VERSION = 1, TIERS, fanoutFail = (code, error, unblock, data) => ({
     stdout: run.stdout ?? "",
     stderr: run.error ? String(run.error.message) : run.stderr ?? ""
   };
-}, nulList2 = (text) => text.split("\x00").filter(Boolean), IN_FLIGHT_CAP = 6;
+}, nulList2 = (text) => text.split("\x00").filter(Boolean), planLeads = (plan) => plan.leadSession ? [plan.leadSession, ...plan.formerLeads] : null, IN_FLIGHT_CAP = 6;
 var init_fanout = __esm(() => {
   init_rev();
   init_ledger();
   init_stack();
   TIERS = ["mundane", "standard", "hard"];
+  FAN_IN_MODES = ["prs", "integration"];
   DEFAULT_SHARED = [
     "**/package.json",
     "**/{package-lock.json,npm-shrinkwrap.json,bun.lock,bun.lockb,pnpm-lock.yaml,pnpm-workspace.yaml,yarn.lock}",
@@ -76451,6 +76592,488 @@ var init_fanout = __esm(() => {
   ID = /^[a-z0-9][a-z0-9._-]{0,63}$/u;
 });
 
+// packages/workit-core/src/fanout-worktree.ts
+import { randomBytes as randomBytes4 } from "node:crypto";
+import fs24 from "node:fs";
+import path44 from "node:path";
+function rowSample(lines) {
+  const out = [];
+  let bytes = 0;
+  for (const line of lines) {
+    const entry = line.slice(0, 200);
+    bytes += Buffer.byteLength(entry) + 3;
+    if (bytes > DIRTY_ROW_BYTES)
+      break;
+    out.push(entry);
+  }
+  return out;
+}
+function listWorktrees(cwd) {
+  const out = [];
+  let current = null;
+  for (const field of gitRun4(cwd, ["worktree", "list", "--porcelain", "-z"]).stdout.split("\x00")) {
+    if (field.startsWith("worktree ")) {
+      current = { path: field.slice(9), head: null, branch: null, locked: false };
+      out.push(current);
+    } else if (!current)
+      continue;
+    else if (field.startsWith("HEAD "))
+      current.head = field.slice(5);
+    else if (field.startsWith("branch "))
+      current.branch = field.slice(7);
+    else if (field === "locked" || field.startsWith("locked "))
+      current.locked = true;
+  }
+  return out;
+}
+function createdRow(cwd, plan, slice, target) {
+  const ledger = readLedger(cwd);
+  if (!ledger.ok)
+    return null;
+  const atPath = (row) => row.fanout === plan.name && row.slice === slice.id && typeof row.path === "string" && samePath(row.path, target);
+  const rows = ledger.value.rows;
+  const row = rows.findLast((candidate) => candidate.type === "fanout.worktree.created" && atPath(candidate));
+  if (!row)
+    return null;
+  const removedSince = rows.some((candidate) => candidate.seq > row.seq && candidate.type === "fanout.worktree.released" && candidate.outcome === "removed" && atPath(candidate));
+  if (removedSince)
+    return null;
+  const admin = adminDir(target);
+  if (!admin)
+    return null;
+  if (typeof row.adminToken === "string")
+    return row.adminToken === admin.token && row.adminId === admin.id && row.adminIno === admin.ino ? { row, exact: true } : null;
+  const made = admin.birthMs ?? admin.mtimeMs;
+  if (made + CLOCK_SLACK_MS < Date.parse(row.at))
+    return null;
+  return { row, exact: false };
+}
+function adminDir(worktree) {
+  const dir = gitRun4(worktree, ["rev-parse", "--absolute-git-dir"]);
+  if (!dir.ok)
+    return null;
+  const file = dir.stdout.trim();
+  let token = null;
+  try {
+    token = fs24.readFileSync(path44.join(file, TOKEN_FILE), "utf8").trim() || null;
+  } catch {
+    token = null;
+  }
+  try {
+    const stat = worktreeDeps.stat(file);
+    return {
+      path: file,
+      id: path44.basename(file),
+      ino: stat.ino.toString(),
+      token,
+      birthMs: stat.birthtimeNs > 0n ? Number(stat.birthtimeMs) : null,
+      mtimeMs: Number(stat.mtimeMs)
+    };
+  } catch {
+    return null;
+  }
+}
+function markAdminDir(worktree) {
+  const admin = adminDir(worktree);
+  if (!admin)
+    return null;
+  const token = randomBytes4(16).toString("hex");
+  try {
+    fs24.writeFileSync(path44.join(admin.path, TOKEN_FILE), `${token}
+`);
+  } catch {
+    return null;
+  }
+  return { ...admin, token };
+}
+function findSlice(plan, id) {
+  const slice = plan.slices.find((candidate) => candidate.id === id);
+  return slice ? { ok: true, data: slice } : fanoutFail("invalid_input", `${id}: not a slice of fanout ${plan.name}`, `slices: ${plan.slices.map((candidate) => candidate.id).join(", ")}`);
+}
+function excludeScratch(cwd) {
+  const common = gitCommonDir(cwd);
+  if (!common)
+    return;
+  const file = path44.join(common, "info", "exclude");
+  let text = "";
+  try {
+    text = fs24.readFileSync(file, "utf8");
+  } catch {
+    text = "";
+  }
+  if (text.split(/\r?\n/u).includes(EXCLUDE_LINE))
+    return;
+  fs24.mkdirSync(path44.dirname(file), { recursive: true });
+  fs24.appendFileSync(file, `${text && !text.endsWith(`
+`) ? `
+` : ""}# workit fanout: per-worker scratch dirs
+${EXCLUDE_LINE}
+`);
+}
+function ensureScratch(worktree) {
+  const scratch = path44.join(worktree, SCRATCH_DIR);
+  fs24.mkdirSync(scratch, { recursive: true });
+  return scratch;
+}
+function createSliceWorktree(cwd, plan, input) {
+  const found = findSlice(plan, input.slice);
+  if (!found.ok)
+    return found;
+  const slice = found.data;
+  if (!slice.worktree)
+    return fanoutFail("invalid_input", `slice ${slice.id} has no worktree path`, "re-plan it with workit fanout plan");
+  const target = slicePath(cwd, slice);
+  const worktrees = listWorktrees(cwd);
+  const localRef = `refs/heads/${slice.branch}`;
+  const existing = worktrees.find((entry) => samePath(entry.path, target));
+  const base = {
+    fanout: plan.name,
+    slice: slice.id,
+    branch: slice.branch,
+    base: slice.base,
+    path: target
+  };
+  if (existing) {
+    if (existing.branch !== null && existing.branch !== localRef)
+      return fanoutFail("blocked", `${target} is a worktree on ${existing.branch.replace(/^refs\/heads\//u, "")}, not ${slice.branch}`, `release it first, or set slice ${slice.id}'s worktree to another path`);
+    if (!createdRow(cwd, plan, slice, target))
+      return fanoutFail("blocked", `${target} is a worktree that workit fanout worktree create did not make for slice ${slice.id}`, `remove it yourself (git worktree remove ${target}) once you know what it holds`);
+    excludeScratch(cwd);
+    return {
+      ok: true,
+      data: {
+        ...base,
+        scratch: ensureScratch(target),
+        head: existing.head ?? "",
+        mode: resolveRef(cwd, localRef) ? "resume" : "new",
+        created: false,
+        notes: ["the worktree already exists; nothing was changed"]
+      }
+    };
+  }
+  const elsewhere = worktrees.find((entry) => entry.branch === localRef);
+  if (elsewhere)
+    return fanoutFail("blocked", `${slice.branch} is checked out at ${elsewhere.path}: never two live workers on one branch`, `stop that worker, then workit fanout worktree release ${slice.id} (or git worktree remove ${elsewhere.path})`);
+  let dirExisted = false;
+  try {
+    const stat = fs24.statSync(target);
+    if (!stat.isDirectory() || fs24.readdirSync(target).length > 0)
+      return fanoutFail("blocked", `${target} exists and is ${stat.isDirectory() ? "not empty" : "not a directory"} (not a worktree of this repository)`, `move it away, or set slice ${slice.id}'s worktree to another path`);
+    dirExisted = true;
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      return fanoutFail("failed", `cannot read ${target}: ${error.message}`);
+  }
+  const notes = [];
+  let mode = "resume";
+  if (resolveRef(cwd, localRef)) {
+    const added = gitRun4(cwd, ["worktree", "add", target, slice.branch], SLOW);
+    if (!added.ok)
+      return worktreeFailed(added.stderr);
+  } else {
+    const remote = pushRemoteName(cwd) ?? "origin";
+    const remoteRef = `refs/remotes/${remote}/${slice.branch}`;
+    if (resolveRef(cwd, remoteRef)) {
+      const added = gitRun4(cwd, ["worktree", "add", "-b", slice.branch, target, remoteRef], SLOW);
+      if (!added.ok)
+        return worktreeFailed(added.stderr);
+      notes.push(`resumed ${slice.branch} from ${remote}/${slice.branch}`);
+    } else {
+      mode = "new";
+      const parent = plan.slices.find((other) => other.branch === slice.base);
+      const from = slice.base === plan.trunk ? trunkRef(cwd, plan.trunk) : parent ? branchRef(cwd, parent.branch) : branchRef(cwd, slice.base);
+      if (!from)
+        return fanoutFail("not_found", `base ${slice.base} of slice ${slice.id} does not resolve here`, parent ? `start slice ${parent.id} first (its branch ${parent.branch} is the base)` : `git fetch origin ${slice.base}`);
+      const added = gitRun4(cwd, ["worktree", "add", "--detach", target, from], SLOW);
+      if (!added.ok)
+        return worktreeFailed(added.stderr);
+      const branched = gitBranch(target, { name: slice.branch, base: slice.base });
+      if (!branched.ok) {
+        gitRun4(cwd, ["worktree", "remove", target], SLOW);
+        return fanoutFail(branched.code, `workit git branch ${slice.branch} refused: ${branched.error}`, branched.unblock ?? `fix the branch name in the plan, then workit fanout worktree create ${slice.id}`);
+      }
+      notes.push(...branched.data.notes);
+    }
+  }
+  excludeScratch(cwd);
+  const scratch = ensureScratch(target);
+  const head = gitRun4(target, ["rev-parse", "HEAD"]).stdout.trim();
+  const baseSha = mode === "new" ? head : null;
+  const admin = markAdminDir(target);
+  appendObserved(cwd, {
+    type: "fanout.worktree.created",
+    actor: input.actor,
+    fanout: plan.name,
+    slice: slice.id,
+    branch: slice.branch,
+    path: target,
+    scratch,
+    mode,
+    head,
+    dirExisted,
+    planCreatedAt: plan.createdAt,
+    sliceHash: slice.hash,
+    ...admin ? { adminId: admin.id, adminIno: admin.ino, adminToken: admin.token } : {},
+    ...baseSha ? { baseSha } : {}
+  });
+  return { ok: true, data: { ...base, scratch, head, mode, created: true, notes } };
+}
+function releaseSliceWorktree(cwd, plan, input) {
+  const found = findSlice(plan, input.slice);
+  if (!found.ok)
+    return found;
+  const slice = found.data;
+  const target = slicePath(cwd, slice);
+  const worktrees = listWorktrees(cwd);
+  const index = worktrees.findIndex((entry) => samePath(entry.path, target));
+  const out = {
+    fanout: plan.name,
+    slice: slice.id,
+    branch: slice.branch,
+    path: target,
+    head: null,
+    dirty: [],
+    forced: input.force,
+    removed: false,
+    unpushed: null,
+    notes: []
+  };
+  if (index < 0) {
+    if (fs24.existsSync(target))
+      return fanoutFail("blocked", `${target} is not a worktree of this repository; nothing was removed`, "remove it yourself once you know what it holds");
+    out.notes.push(`no worktree at ${target}; nothing to release`);
+    return { ok: true, data: out };
+  }
+  const entry = worktrees[index];
+  if (index === 0)
+    return fanoutFail("blocked", `${target} is the main checkout; it is never released`);
+  if (inside2(cwd, entry.path))
+    return fanoutFail("blocked", `this command runs inside ${entry.path}`, `run it from the main checkout: workit --cwd <main checkout> fanout worktree release ${slice.id}`);
+  if (entry.branch !== null && entry.branch !== `refs/heads/${slice.branch}`)
+    return fanoutFail("blocked", `${entry.path} is on ${entry.branch.replace(/^refs\/heads\//u, "")}, not slice ${slice.id}'s ${slice.branch}; nothing was removed`);
+  const owned = createdRow(cwd, plan, slice, entry.path);
+  if (!owned)
+    return fanoutFail("blocked", `${entry.path} was not made by workit fanout worktree create for slice ${slice.id} (no ledger row); nothing was removed`, `remove it yourself (git worktree remove ${entry.path}) once you know what it holds`);
+  if (input.force && !owned.exact)
+    return fanoutFail("blocked", `${entry.path} was created before workit recorded worktree identity, so it cannot be told from a worktree someone re-added there; --force is refused and nothing was removed`, `release it without --force, or remove it yourself (git worktree remove ${entry.path}) once you know what it holds`);
+  const made = owned.row;
+  out.head = entry.head;
+  const status = gitRun4(entry.path, [
+    "status",
+    "--porcelain=v1",
+    "-z",
+    "--untracked-files=all",
+    "--ignore-submodules=none"
+  ]);
+  if (!status.ok)
+    return fanoutFail("failed", `git status in ${entry.path} failed: ${status.stderr.trim().split(`
+`)[0]}`, "nothing was removed; inspect the worktree by hand");
+  const entries = porcelainEntries(status.stdout);
+  const inScratch = (line) => line.slice(3).startsWith(`${SCRATCH_DIR}/`);
+  out.dirty = entries.filter((line) => !inScratch(line));
+  out.unpushed = unpushedCount(cwd, slice.branch);
+  const refused = out.dirty.length > 0 && !input.force;
+  const recorded = appendObserved(cwd, {
+    type: "fanout.worktree.released",
+    actor: input.actor,
+    fanout: plan.name,
+    slice: slice.id,
+    branch: slice.branch,
+    path: entry.path,
+    head: entry.head,
+    uncommittedCount: out.dirty.length,
+    uncommitted: rowSample(out.dirty),
+    forced: input.force,
+    outcome: refused ? "refused" : "removed"
+  });
+  if (!recorded.ok)
+    return fanoutFail("unavailable", `cannot record the worktree state in the ledger (${recorded.error}); nothing was removed`);
+  if (refused)
+    return fanoutFail("blocked", `${entry.path} has ${out.dirty.length} uncommitted change${out.dirty.length === 1 ? "" : "s"} (${out.dirty.slice(0, 3).join(", ")}${out.dirty.length > 3 ? ", …" : ""}); recorded in the ledger, nothing removed`, `commit them on ${slice.branch} (workit git commit), or pass --force to drop them`, { ...out });
+  const args = ["worktree", "remove", ...input.force ? ["--force"] : [], entry.path];
+  let removed = gitRun4(cwd, args, SLOW);
+  if (!removed.ok && entries.some(inScratch)) {
+    removeScratch(entry.path);
+    removed = gitRun4(cwd, args, SLOW);
+  }
+  if (!removed.ok)
+    return fanoutFail("failed", `git worktree remove failed: ${removed.stderr.trim().split(`
+`)[0]}`, entry.locked ? `git worktree unlock ${entry.path}, then release again` : undefined, { ...out });
+  out.removed = true;
+  if (made.dirExisted === true)
+    fs24.mkdirSync(entry.path, { recursive: true });
+  if (out.unpushed)
+    out.notes.push(`${slice.branch} is kept with ${out.unpushed} commit(s) not on the remote`);
+  return { ok: true, data: out };
+}
+function porcelainEntries(stdout) {
+  const fields = nulList2(stdout);
+  const out = [];
+  for (let index = 0;index < fields.length; index += 1) {
+    const entry = fields[index];
+    out.push(entry);
+    if (entry[0] === "R" || entry[0] === "C")
+      index += 1;
+  }
+  return out;
+}
+function unpushedCount(cwd, branch) {
+  const remote = pushRemoteName(cwd) ?? "origin";
+  const local = resolveRef(cwd, `refs/heads/${branch}`);
+  if (!local)
+    return null;
+  const tracking = resolveRef(cwd, `refs/remotes/${remote}/${branch}`);
+  if (!tracking)
+    return null;
+  const count = gitRun4(cwd, ["rev-list", "--count", `${tracking}..${local}`]);
+  return count.ok ? Number(count.stdout.trim()) : null;
+}
+function removeScratch(worktree) {
+  const scratch = path44.join(worktree, SCRATCH_DIR);
+  let stat;
+  try {
+    stat = fs24.lstatSync(scratch);
+  } catch {
+    return;
+  }
+  if (stat.isSymbolicLink() || !stat.isDirectory())
+    fs24.unlinkSync(scratch);
+  else
+    fs24.rmSync(scratch, { recursive: true, force: true, maxRetries: 2 });
+}
+var SLOW, SCRATCH_DIR = ".workit-scratch", EXCLUDE_LINE, DIRTY_ROW_BYTES = 2000, canonical2 = (target) => {
+  try {
+    return fs24.realpathSync.native(target);
+  } catch {
+    return path44.resolve(target);
+  }
+}, samePath = (a, b) => {
+  const left = canonical2(a);
+  const right = canonical2(b);
+  return process.platform === "win32" || process.platform === "darwin" ? left.toLowerCase() === right.toLowerCase() : left === right;
+}, inside2 = (child, parent) => {
+  const relative = path44.relative(canonical2(parent), canonical2(child));
+  return relative === "" || !relative.startsWith("..") && !path44.isAbsolute(relative);
+}, slicePath = (cwd, slice) => path44.isAbsolute(slice.worktree) ? slice.worktree : path44.resolve(mainCheckout(cwd), slice.worktree), CLOCK_SLACK_MS = 2000, TOKEN_FILE = "workit-fanout-token", worktreeDeps, worktreeFailed = (stderr) => fanoutFail("failed", `git worktree add failed: ${stderr.trim().split(`
+`)[0] || "unknown error"}`);
+var init_fanout_worktree = __esm(() => {
+  init_ops();
+  init_rev();
+  init_ledger();
+  init_fanout();
+  SLOW = GIT_TIMEOUTS.worktree;
+  EXCLUDE_LINE = `/${SCRATCH_DIR}/`;
+  worktreeDeps = {
+    stat: (file) => fs24.statSync(file, { bigint: true })
+  };
+});
+
+// packages/workit-core/src/fanout-brief.ts
+import { createHash as createHash17 } from "node:crypto";
+function workerSession(lead, slice, attempt) {
+  const tail = attempt === null ? "" : `+try${attempt}`;
+  const full = `${lead}-w-${slice}${tail}`;
+  if (full.length <= SESSION_MAX)
+    return full;
+  const digest = createHash17("sha256").update(slice).digest("hex").slice(0, 12);
+  return `${lead.slice(0, SESSION_MAX - 3 - digest.length - tail.length)}-w-${digest}${tail}`;
+}
+function renderBrief(cwd, plan, input) {
+  const found = findSlice(plan, input.slice);
+  if (!found.ok)
+    return found;
+  const slice = found.data;
+  const ledger = readLedger(cwd);
+  if (!ledger.ok)
+    return fanoutFail(ledger.code, ledger.error, ledger.unblock);
+  if (!input.actor.session)
+    return fanoutFail("blocked", "WORKIT_SESSION_ID is not set: worker session ids derive from the lead's", "export WORKIT_SESSION_ID=<your session id>, then render the brief again");
+  const branch = input.attempt === null ? slice.branch : `${slice.branch}-try${input.attempt}`;
+  const taken = plan.slices.find((other) => other.id !== slice.id && other.branch === branch);
+  if (taken)
+    return fanoutFail("invalid_input", `attempt branch ${branch} is slice ${taken.id}'s branch`, "pick another --attempt number, or rename one of the branches in the plan");
+  const head = branchRef(cwd, branch);
+  const mode = input.mode ?? (head ? "resume" : "new");
+  if (mode === "resume" && !head)
+    return fanoutFail("not_found", `MODE resume needs the branch ${branch}, which does not exist here`, `workit fanout brief ${slice.id} --mode new`);
+  const planned = `${slicePath(cwd, slice)}${input.attempt === null ? "" : `+try${input.attempt}`}`;
+  const exists = listWorktrees(cwd).some((entry) => samePath(entry.path, planned));
+  excludeScratch(cwd);
+  const scratch = exists ? `${planned}/${SCRATCH_DIR}` : SCRATCH_DIR;
+  const scratchLine = exists ? `SCRATCH: ${scratch}  (yours alone; temp files go here, never a shared path)` : `SCRATCH: ${SCRATCH_DIR}/ at your worktree root (mkdir -p it; git ignores it; never a shared path)`;
+  const standing = activeStanding(ledger.value.rows, plan.name, planLeads(plan)).map((row) => ({
+    id: row.id,
+    what: String(row.what)
+  }));
+  const session = workerSession(sessionSafe(input.actor.session), slice.id, input.attempt);
+  const fanIn = plan.fanIn === "integration" ? [
+    `FAN-IN: integration branch ${plan.trunk}. Before you report, merge its tip into your branch`,
+    `  (\`git merge --no-edit ${plan.trunk}\`), resolve conflicts inside SCOPE and re-run VERIFY, so the`,
+    "  lead's merge is a fast-forward. No other merge, and no rebase, retarget or force-push."
+  ] : [
+    "FAN-IN: one PR per slice. Never rebase, retarget, merge or force-push: the lead owns topology."
+  ];
+  const lines = [
+    `MODE: ${mode}${input.attempt === null ? "" : `  (race attempt ${input.attempt}: the lead keeps the attempt with the best verdict)`}`,
+    `GOAL: ${slice.goal}`,
+    `SCOPE: ${slice.scope.join(", ")}`,
+    ...slice.owns.length ? [`  owns: ${slice.owns.join(", ")}`] : [],
+    `  branch: ${branch}   base: ${slice.base}`,
+    `CONTEXT: ${slice.context ?? "none given: read the files in SCOPE and the neighbours they import"}`,
+    ...mode === "resume" && head ? [
+      `  resume: continue ${branch} from ${head.slice(0, 12)}; read \`git log ${slice.base}..${branch}\` and \`workit ledger list --branch ${branch}\` (the last report, verdicts, rulings)`
+    ] : [],
+    "ACCEPTANCE:",
+    ...slice.acceptance.map((line) => `  - ${line}`),
+    `VERIFY: ${slice.verify.join("; ")}`,
+    `TIER: ${slice.tier}`,
+    `TIMEBOX: ${slice.timebox ?? DEFAULT_TIMEBOX}; past it without a new commit you will be replaced`,
+    scratchLine,
+    `FORBIDDEN: ${slice.forbidden.join("; ")}`,
+    ...fanIn,
+    ...REPORT,
+    "STANDING:",
+    ...standing.length ? standing.map((order) => `  - ${order.what}`) : ["  - none recorded beyond this brief"],
+    `  export WORKIT_SESSION_ID=${session}`,
+    ...rules(mode, branch, slice.base)
+  ];
+  return {
+    ok: true,
+    data: {
+      fanout: plan.name,
+      slice: slice.id,
+      mode,
+      attempt: input.attempt,
+      branch,
+      base: slice.base,
+      tier: slice.tier,
+      scratch,
+      session,
+      standing,
+      text: `${lines.join(`
+`)}
+`
+    }
+  };
+}
+var DEFAULT_TIMEBOX = "30 minutes", REPORT, rules = (mode, branch, base) => [
+  "RULES:",
+  mode === "new" ? `  1. First command: \`workit git branch ${branch} --base ${base}\` (your worktree may start on another name).` : `  1. First command: \`git switch ${branch}\`, then continue from its head.`,
+  '  2. Decide ambiguities yourself: `workit ledger ruling "<what>" --why "<why>" --cost-if-wrong "<cost>"`; stop only for an irreversible, security-sensitive or out-of-worktree action.',
+  "  3. Commit with `workit git commit -m <msg> -- <paths in SCOPE>`; push only if this brief says so.",
+  "  4. Never record a verdict on your own work."
+], sessionSafe = (text) => text.replace(/[^A-Za-z0-9_.:@/+-]/gu, "-"), SESSION_MAX = 128;
+var init_fanout_brief = __esm(() => {
+  init_ledger();
+  init_fanout();
+  init_fanout_worktree();
+  REPORT = [
+    "REPORT: branch, head SHA, files changed, each VERIFY command with its exit code,",
+    "  each ACCEPTANCE line met / not met, rulings you made (`workit ledger ruling`),",
+    "  anything out of scope as a follow-up, not a diff."
+  ];
+});
+
 // packages/workit-core/src/fanout-landed.ts
 import { spawnSync as spawnSync22 } from "node:child_process";
 function forgeBreaker(resolved) {
@@ -76561,9 +77184,20 @@ function trunkPatchIds(ctx, fork) {
   cache.set(fork, ids);
   return ids;
 }
+function inSliceRun(row, slice) {
+  if (row.type === "fanout.worktree.created" && typeof row.sliceHash === "string" && slice.hash)
+    return row.sliceHash === slice.hash;
+  const since = Date.parse(slice.hashSince);
+  return Number.isNaN(since) || Date.parse(String(row.at)) >= since;
+}
 function linked(rows, input, slice, head) {
   const since = input.since ? Date.parse(input.since) : Number.NaN;
-  return rows.some((row) => (Number.isNaN(since) || Date.parse(String(row.at)) >= since) && (row.type === "fanout.worktree.created" && row.fanout === input.fanout && row.slice === slice.id || head !== null && row.branch === slice.branch && row.head === head));
+  const recent = (row) => Number.isNaN(since) || Date.parse(String(row.at)) >= since;
+  return rows.some((row) => {
+    if (row.type === "fanout.worktree.created" && row.fanout === input.fanout && row.slice === slice.id)
+      return typeof row.sliceHash === "string" && input.sliceHash ? row.sliceHash === input.sliceHash : recent(row);
+    return recent(row) && head !== null && row.branch === slice.branch && row.head === head;
+  });
 }
 function detectLanding(ctx, slice, input) {
   const out = {
@@ -76636,7 +77270,7 @@ function sliceStart(cwd, rows, fanout, slice) {
   const reflog = branchCreatedAt(cwd, slice.branch);
   if (reflog)
     return reflog;
-  const row = rows.findLast((candidate) => candidate.type === "fanout.worktree.created" && candidate.fanout === fanout && candidate.slice === slice.id && typeof candidate.baseSha === "string");
+  const row = rows.findLast((candidate) => candidate.type === "fanout.worktree.created" && candidate.fanout === fanout && candidate.slice === slice.id && typeof candidate.baseSha === "string" && inSliceRun(candidate, slice));
   return row?.baseSha ?? null;
 }
 var isAncestor2 = (cwd, a, b) => gitRun4(cwd, ["merge-base", "--is-ancestor", a, b]).ok, TRUNK_SCAN = 500;
@@ -76785,7 +77419,8 @@ function sliceLandings(cwd, plan, trunk, tips, rows, forge) {
       createdFrom: sliceStart(cwd, rows, plan.name, slice),
       parentHead,
       fanout: plan.name,
-      since: plan.createdAt || null,
+      since: slice.hashSince || plan.createdAt || null,
+      sliceHash: slice.hash || null,
       rows
     }));
   }
@@ -76927,7 +77562,7 @@ function activity(cwd, plan, slice, rows) {
     head,
     commit,
     last: newest(commit, reflog, ...ledger),
-    worktreeCreated: rows.some((row) => row.type === "fanout.worktree.created" && row.fanout === plan.name && row.slice === slice.id)
+    worktreeCreated: rows.some((row) => row.type === "fanout.worktree.created" && row.fanout === plan.name && row.slice === slice.id && inSliceRun(row, slice))
   };
 }
 function fanoutStatus(cwd, plan, options) {
@@ -77037,7 +77672,7 @@ function fanoutStatus(cwd, plan, options) {
     else if (row.branchExists)
       row.state = "active";
     else if (row.waitsFor.length === 0 || parent && row.waitsFor.length === 1 && row.waitsFor[0] === parent.id && out.get(parent.id)?.verdict.accepted) {
-      const created = rows.some((candidate) => candidate.type === "fanout.worktree.created" && candidate.fanout === plan.name && candidate.slice === id);
+      const created = rows.some((candidate) => candidate.type === "fanout.worktree.created" && candidate.fanout === plan.name && candidate.slice === id && inSliceRun(candidate, byId.get(id)));
       row.state = created ? "active" : "not_started";
       if (!created)
         spawnable.push(id);
@@ -77089,340 +77724,6 @@ var init_fanout_status = __esm(() => {
   DEFAULT_STUCK_MS = 30 * 60000;
 });
 
-// packages/workit-core/src/fanout-worktree.ts
-import fs24 from "node:fs";
-import path44 from "node:path";
-function rowSample(lines) {
-  const out = [];
-  let bytes = 0;
-  for (const line of lines) {
-    const entry = line.slice(0, 200);
-    bytes += Buffer.byteLength(entry) + 3;
-    if (bytes > DIRTY_ROW_BYTES)
-      break;
-    out.push(entry);
-  }
-  return out;
-}
-function listWorktrees(cwd) {
-  const out = [];
-  let current = null;
-  for (const field of gitRun4(cwd, ["worktree", "list", "--porcelain", "-z"]).stdout.split("\x00")) {
-    if (field.startsWith("worktree ")) {
-      current = { path: field.slice(9), head: null, branch: null, locked: false };
-      out.push(current);
-    } else if (!current)
-      continue;
-    else if (field.startsWith("HEAD "))
-      current.head = field.slice(5);
-    else if (field.startsWith("branch "))
-      current.branch = field.slice(7);
-    else if (field === "locked" || field.startsWith("locked "))
-      current.locked = true;
-  }
-  return out;
-}
-function createdRow(cwd, plan, slice, target) {
-  const ledger = readLedger(cwd);
-  if (!ledger.ok)
-    return null;
-  const atPath = (row) => row.fanout === plan.name && row.slice === slice.id && typeof row.path === "string" && samePath(row.path, target);
-  const rows = ledger.value.rows;
-  const row = rows.findLast((candidate) => candidate.type === "fanout.worktree.created" && atPath(candidate));
-  if (!row)
-    return null;
-  const removedSince = rows.some((candidate) => candidate.seq > row.seq && candidate.type === "fanout.worktree.released" && candidate.outcome === "removed" && atPath(candidate));
-  if (removedSince)
-    return null;
-  const made = adminDirTime(target);
-  if (made === null || made + CLOCK_SLACK_MS < Date.parse(row.at))
-    return null;
-  return row;
-}
-function adminDirTime(worktree) {
-  const dir = gitRun4(worktree, ["rev-parse", "--absolute-git-dir"]);
-  if (!dir.ok)
-    return null;
-  try {
-    const stat = fs24.statSync(dir.stdout.trim());
-    return stat.birthtimeMs > 0 ? stat.birthtimeMs : stat.mtimeMs;
-  } catch {
-    return null;
-  }
-}
-function findSlice(plan, id) {
-  const slice = plan.slices.find((candidate) => candidate.id === id);
-  return slice ? { ok: true, data: slice } : fanoutFail("invalid_input", `${id}: not a slice of fanout ${plan.name}`, `slices: ${plan.slices.map((candidate) => candidate.id).join(", ")}`);
-}
-function excludeScratch(cwd) {
-  const common = gitCommonDir(cwd);
-  if (!common)
-    return;
-  const file = path44.join(common, "info", "exclude");
-  let text = "";
-  try {
-    text = fs24.readFileSync(file, "utf8");
-  } catch {
-    text = "";
-  }
-  if (text.split(/\r?\n/u).includes(EXCLUDE_LINE))
-    return;
-  fs24.mkdirSync(path44.dirname(file), { recursive: true });
-  fs24.appendFileSync(file, `${text && !text.endsWith(`
-`) ? `
-` : ""}# workit fanout: per-worker scratch dirs
-${EXCLUDE_LINE}
-`);
-}
-function ensureScratch(worktree) {
-  const scratch = path44.join(worktree, SCRATCH_DIR);
-  fs24.mkdirSync(scratch, { recursive: true });
-  return scratch;
-}
-function createSliceWorktree(cwd, plan, input) {
-  const found = findSlice(plan, input.slice);
-  if (!found.ok)
-    return found;
-  const slice = found.data;
-  if (!slice.worktree)
-    return fanoutFail("invalid_input", `slice ${slice.id} has no worktree path`, "re-plan it with workit fanout plan");
-  const target = slicePath(cwd, slice);
-  const worktrees = listWorktrees(cwd);
-  const localRef = `refs/heads/${slice.branch}`;
-  const existing = worktrees.find((entry) => samePath(entry.path, target));
-  const base = {
-    fanout: plan.name,
-    slice: slice.id,
-    branch: slice.branch,
-    base: slice.base,
-    path: target
-  };
-  if (existing) {
-    if (existing.branch !== null && existing.branch !== localRef)
-      return fanoutFail("blocked", `${target} is a worktree on ${existing.branch.replace(/^refs\/heads\//u, "")}, not ${slice.branch}`, `release it first, or set slice ${slice.id}'s worktree to another path`);
-    if (!createdRow(cwd, plan, slice, target))
-      return fanoutFail("blocked", `${target} is a worktree that workit fanout worktree create did not make for slice ${slice.id}`, `remove it yourself (git worktree remove ${target}) once you know what it holds`);
-    excludeScratch(cwd);
-    return {
-      ok: true,
-      data: {
-        ...base,
-        scratch: ensureScratch(target),
-        head: existing.head ?? "",
-        mode: resolveRef(cwd, localRef) ? "resume" : "new",
-        created: false,
-        notes: ["the worktree already exists; nothing was changed"]
-      }
-    };
-  }
-  const elsewhere = worktrees.find((entry) => entry.branch === localRef);
-  if (elsewhere)
-    return fanoutFail("blocked", `${slice.branch} is checked out at ${elsewhere.path}: never two live workers on one branch`, `stop that worker, then workit fanout worktree release ${slice.id} (or git worktree remove ${elsewhere.path})`);
-  let dirExisted = false;
-  try {
-    const stat = fs24.statSync(target);
-    if (!stat.isDirectory() || fs24.readdirSync(target).length > 0)
-      return fanoutFail("blocked", `${target} exists and is ${stat.isDirectory() ? "not empty" : "not a directory"} (not a worktree of this repository)`, `move it away, or set slice ${slice.id}'s worktree to another path`);
-    dirExisted = true;
-  } catch (error) {
-    if (error.code !== "ENOENT")
-      return fanoutFail("failed", `cannot read ${target}: ${error.message}`);
-  }
-  const notes = [];
-  let mode = "resume";
-  if (resolveRef(cwd, localRef)) {
-    const added = gitRun4(cwd, ["worktree", "add", target, slice.branch], SLOW);
-    if (!added.ok)
-      return worktreeFailed(added.stderr);
-  } else {
-    const remote = pushRemoteName(cwd) ?? "origin";
-    const remoteRef = `refs/remotes/${remote}/${slice.branch}`;
-    if (resolveRef(cwd, remoteRef)) {
-      const added = gitRun4(cwd, ["worktree", "add", "-b", slice.branch, target, remoteRef], SLOW);
-      if (!added.ok)
-        return worktreeFailed(added.stderr);
-      notes.push(`resumed ${slice.branch} from ${remote}/${slice.branch}`);
-    } else {
-      mode = "new";
-      const parent = plan.slices.find((other) => other.branch === slice.base);
-      const from = slice.base === plan.trunk ? trunkRef(cwd, plan.trunk) : parent ? branchRef(cwd, parent.branch) : branchRef(cwd, slice.base);
-      if (!from)
-        return fanoutFail("not_found", `base ${slice.base} of slice ${slice.id} does not resolve here`, parent ? `start slice ${parent.id} first (its branch ${parent.branch} is the base)` : `git fetch origin ${slice.base}`);
-      const added = gitRun4(cwd, ["worktree", "add", "--detach", target, from], SLOW);
-      if (!added.ok)
-        return worktreeFailed(added.stderr);
-      const branched = gitBranch(target, { name: slice.branch, base: slice.base });
-      if (!branched.ok) {
-        gitRun4(cwd, ["worktree", "remove", target], SLOW);
-        return fanoutFail(branched.code, `workit git branch ${slice.branch} refused: ${branched.error}`, branched.unblock ?? `fix the branch name in the plan, then workit fanout worktree create ${slice.id}`);
-      }
-      notes.push(...branched.data.notes);
-    }
-  }
-  excludeScratch(cwd);
-  const scratch = ensureScratch(target);
-  const head = gitRun4(target, ["rev-parse", "HEAD"]).stdout.trim();
-  const baseSha = mode === "new" ? head : null;
-  appendObserved(cwd, {
-    type: "fanout.worktree.created",
-    actor: input.actor,
-    fanout: plan.name,
-    slice: slice.id,
-    branch: slice.branch,
-    path: target,
-    scratch,
-    mode,
-    head,
-    dirExisted,
-    planCreatedAt: plan.createdAt,
-    ...baseSha ? { baseSha } : {}
-  });
-  return { ok: true, data: { ...base, scratch, head, mode, created: true, notes } };
-}
-function releaseSliceWorktree(cwd, plan, input) {
-  const found = findSlice(plan, input.slice);
-  if (!found.ok)
-    return found;
-  const slice = found.data;
-  const target = slicePath(cwd, slice);
-  const worktrees = listWorktrees(cwd);
-  const index = worktrees.findIndex((entry) => samePath(entry.path, target));
-  const out = {
-    fanout: plan.name,
-    slice: slice.id,
-    branch: slice.branch,
-    path: target,
-    head: null,
-    dirty: [],
-    forced: input.force,
-    removed: false,
-    unpushed: null,
-    notes: []
-  };
-  if (index < 0) {
-    if (fs24.existsSync(target))
-      return fanoutFail("blocked", `${target} is not a worktree of this repository; nothing was removed`, "remove it yourself once you know what it holds");
-    out.notes.push(`no worktree at ${target}; nothing to release`);
-    return { ok: true, data: out };
-  }
-  const entry = worktrees[index];
-  if (index === 0)
-    return fanoutFail("blocked", `${target} is the main checkout; it is never released`);
-  if (inside2(cwd, entry.path))
-    return fanoutFail("blocked", `this command runs inside ${entry.path}`, `run it from the main checkout: workit --cwd <main checkout> fanout worktree release ${slice.id}`);
-  if (entry.branch !== null && entry.branch !== `refs/heads/${slice.branch}`)
-    return fanoutFail("blocked", `${entry.path} is on ${entry.branch.replace(/^refs\/heads\//u, "")}, not slice ${slice.id}'s ${slice.branch}; nothing was removed`);
-  const made = createdRow(cwd, plan, slice, entry.path);
-  if (!made)
-    return fanoutFail("blocked", `${entry.path} was not made by workit fanout worktree create for slice ${slice.id} (no ledger row); nothing was removed`, `remove it yourself (git worktree remove ${entry.path}) once you know what it holds`);
-  out.head = entry.head;
-  const status = gitRun4(entry.path, [
-    "status",
-    "--porcelain=v1",
-    "-z",
-    "--untracked-files=all",
-    "--ignore-submodules=none"
-  ]);
-  if (!status.ok)
-    return fanoutFail("failed", `git status in ${entry.path} failed: ${status.stderr.trim().split(`
-`)[0]}`, "nothing was removed; inspect the worktree by hand");
-  const entries = porcelainEntries(status.stdout);
-  const inScratch = (line) => line.slice(3).startsWith(`${SCRATCH_DIR}/`);
-  out.dirty = entries.filter((line) => !inScratch(line));
-  out.unpushed = unpushedCount(cwd, slice.branch);
-  const refused = out.dirty.length > 0 && !input.force;
-  const recorded = appendObserved(cwd, {
-    type: "fanout.worktree.released",
-    actor: input.actor,
-    fanout: plan.name,
-    slice: slice.id,
-    branch: slice.branch,
-    path: entry.path,
-    head: entry.head,
-    uncommittedCount: out.dirty.length,
-    uncommitted: rowSample(out.dirty),
-    forced: input.force,
-    outcome: refused ? "refused" : "removed"
-  });
-  if (!recorded.ok)
-    return fanoutFail("unavailable", `cannot record the worktree state in the ledger (${recorded.error}); nothing was removed`);
-  if (refused)
-    return fanoutFail("blocked", `${entry.path} has ${out.dirty.length} uncommitted change${out.dirty.length === 1 ? "" : "s"} (${out.dirty.slice(0, 3).join(", ")}${out.dirty.length > 3 ? ", …" : ""}); recorded in the ledger, nothing removed`, `commit them on ${slice.branch} (workit git commit), or pass --force to drop them`, { ...out });
-  const args = ["worktree", "remove", ...input.force ? ["--force"] : [], entry.path];
-  let removed = gitRun4(cwd, args, SLOW);
-  if (!removed.ok && entries.some(inScratch)) {
-    removeScratch(entry.path);
-    removed = gitRun4(cwd, args, SLOW);
-  }
-  if (!removed.ok)
-    return fanoutFail("failed", `git worktree remove failed: ${removed.stderr.trim().split(`
-`)[0]}`, entry.locked ? `git worktree unlock ${entry.path}, then release again` : undefined, { ...out });
-  out.removed = true;
-  if (made.dirExisted === true)
-    fs24.mkdirSync(entry.path, { recursive: true });
-  if (out.unpushed)
-    out.notes.push(`${slice.branch} is kept with ${out.unpushed} commit(s) not on the remote`);
-  return { ok: true, data: out };
-}
-function porcelainEntries(stdout) {
-  const fields = nulList2(stdout);
-  const out = [];
-  for (let index = 0;index < fields.length; index += 1) {
-    const entry = fields[index];
-    out.push(entry);
-    if (entry[0] === "R" || entry[0] === "C")
-      index += 1;
-  }
-  return out;
-}
-function unpushedCount(cwd, branch) {
-  const remote = pushRemoteName(cwd) ?? "origin";
-  const local = resolveRef(cwd, `refs/heads/${branch}`);
-  if (!local)
-    return null;
-  const tracking = resolveRef(cwd, `refs/remotes/${remote}/${branch}`);
-  if (!tracking)
-    return null;
-  const count = gitRun4(cwd, ["rev-list", "--count", `${tracking}..${local}`]);
-  return count.ok ? Number(count.stdout.trim()) : null;
-}
-function removeScratch(worktree) {
-  const scratch = path44.join(worktree, SCRATCH_DIR);
-  let stat;
-  try {
-    stat = fs24.lstatSync(scratch);
-  } catch {
-    return;
-  }
-  if (stat.isSymbolicLink() || !stat.isDirectory())
-    fs24.unlinkSync(scratch);
-  else
-    fs24.rmSync(scratch, { recursive: true, force: true, maxRetries: 2 });
-}
-var SLOW, SCRATCH_DIR = ".workit-scratch", EXCLUDE_LINE, DIRTY_ROW_BYTES = 2000, canonical2 = (target) => {
-  try {
-    return fs24.realpathSync.native(target);
-  } catch {
-    return path44.resolve(target);
-  }
-}, samePath = (a, b) => {
-  const left = canonical2(a);
-  const right = canonical2(b);
-  return process.platform === "win32" || process.platform === "darwin" ? left.toLowerCase() === right.toLowerCase() : left === right;
-}, inside2 = (child, parent) => {
-  const relative = path44.relative(canonical2(parent), canonical2(child));
-  return relative === "" || !relative.startsWith("..") && !path44.isAbsolute(relative);
-}, slicePath = (cwd, slice) => path44.isAbsolute(slice.worktree) ? slice.worktree : path44.resolve(mainCheckout(cwd), slice.worktree), CLOCK_SLACK_MS = 2000, worktreeFailed = (stderr) => fanoutFail("failed", `git worktree add failed: ${stderr.trim().split(`
-`)[0] || "unknown error"}`);
-var init_fanout_worktree = __esm(() => {
-  init_ops();
-  init_rev();
-  init_ledger();
-  init_fanout();
-  SLOW = GIT_TIMEOUTS.worktree;
-  EXCLUDE_LINE = `/${SCRATCH_DIR}/`;
-});
-
 // packages/workit-cli/src/verbs/fanout.ts
 var exports_fanout = {};
 __export(exports_fanout, {
@@ -77477,7 +77778,12 @@ function resolveTrunk(io, raw, flag, track) {
   return { trunk: derived.tracked || track !== null ? derived.trunk : null };
 }
 function plan2(argv, io) {
-  const flags = parseFlags(argv, { name: "value", trunk: "value", track: "value" });
+  const flags = parseFlags(argv, {
+    name: "value",
+    trunk: "value",
+    track: "value",
+    "take-lead": "boolean"
+  });
   if (typeof flags === "string")
     return usage3(io, flags, PLAN_USAGE2);
   const track = flags.values.track ?? null;
@@ -77499,7 +77805,8 @@ function plan2(argv, io) {
     raw,
     name: flags.values.name ?? null,
     trunk: trunk.trunk,
-    actor: actorFromEnv(io.env)
+    actor: actorFromEnv(io.env),
+    takeLead: flags.booleans.has("take-lead")
   });
   if (!result.ok) {
     const code = failed(io, result);
@@ -77507,15 +77814,42 @@ function plan2(argv, io) {
     return code;
   }
   return emit(io, ok(result.data), (data) => [
-    `${data.created ? "planned" : "re-planned"} fanout ${data.name} on ${data.trunk}: ${data.slices.length} slice${data.slices.length === 1 ? "" : "s"}`,
+    `${data.created ? "planned" : "re-planned"} fanout ${data.name} on ${data.trunk}${data.fanIn === "integration" ? " (integration branch: one PR)" : ""}: ${data.slices.length} slice${data.slices.length === 1 ? "" : "s"}`,
     ...data.slices.map((slice) => `  ${slice.id} [${slice.tier}] ${slice.branch} <- ${slice.base}${slice.dependsOn.length ? `  after ${slice.dependsOn.join(", ")}` : ""}
       worktree ${slice.worktree}`),
     ...data.overlaps.map((overlap) => `  shared ${overlap.path}: ${overlap.resolution === "owner" ? `owned by ${overlap.owner}` : `serialized (${overlap.slices.join(" -> ")})`}`),
     `waves: ${data.waves.map((wave) => wave.join(", ")).join("  |  ")}`,
     `landing order: ${data.landingOrder.join(", ")}`,
-    ...data.notes.map((note) => `note: ${note}`)
+    ...data.notes.map((note) => `note: ${note}`),
+    ...data.warnings.map((warning) => `warning: ${warning}`)
   ]);
 }
+function brief(argv, io) {
+  const flags = parseFlags(argv, { name: "value", mode: "value", attempt: "value" });
+  if (typeof flags === "string")
+    return usage3(io, flags, BRIEF_USAGE);
+  if (flags.positionals.length !== 1)
+    return usage3(io, flags.positionals.length ? `unexpected argument ${flags.positionals[1]}` : "missing <slice>", BRIEF_USAGE);
+  const mode = flags.values.mode ?? null;
+  if (mode !== null && mode !== "new" && mode !== "resume")
+    return usage3(io, "--mode takes new or resume", BRIEF_USAGE);
+  const rawAttempt = flags.values.attempt;
+  const attempt = rawAttempt === undefined ? null : Number(rawAttempt);
+  if (attempt !== null && !(Number.isInteger(attempt) && attempt >= 1 && attempt <= 9))
+    return usage3(io, "--attempt takes a number from 1 to 9", BRIEF_USAGE);
+  const selected = selectFanout(io.cwd, flags.values.name ?? null, currentBranch(io.cwd));
+  if (!selected.ok)
+    return failed(io, selected);
+  const result = renderBrief(io.cwd, selected.data, {
+    slice: flags.positionals[0],
+    mode,
+    attempt,
+    actor: actorFromEnv(io.env)
+  });
+  if (!result.ok)
+    return failed(io, result);
+  return emit(io, ok(result.data), (data) => data.text.trimEnd());
+}
 function check2(argv, io) {
   const flags = parseFlags(argv, { name: "value", base: "value", offline: "boolean" });
   if (typeof flags === "string")
@@ -77617,6 +77951,8 @@ async function run15(argv, io) {
   const [sub, ...rest] = argv.filter((arg) => arg !== "--json");
   if (sub === "plan")
     return plan2(rest, io);
+  if (sub === "brief")
+    return brief(rest, io);
   if (sub === "check")
     return check2(rest, io);
   if (sub === "status")
@@ -77625,7 +77961,7 @@ async function run15(argv, io) {
     return worktree(rest, io);
   return usage3(io, sub && !sub.startsWith("-") ? `unknown fanout subcommand "${sub}"` : "missing fanout subcommand", USAGE8);
 }
-var PLAN_USAGE2 = "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --track <t>] [--json]", CHECK_USAGE = "workit fanout check [<slice>…] [--name <n>] [--base <ref>] [--offline] [--json]", STATUS_USAGE3 = "workit fanout status [--name <n>] [--stuck-after 30m] [--offline] [--json]", WORKTREE_USAGE = "workit fanout worktree create <slice> [--name <n>] | worktree release <slice> [--name <n>] [--force] [--json]", USAGE8 = "workit fanout plan|check|status|worktree ... (workit help fanout)", failed = (io, result) => emit(io, fail(result.code, result.error, { unblock: result.unblock, data: result.data ?? {} })), renderCheck = (data) => [
+var PLAN_USAGE2 = "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --track <t>] [--take-lead] [--json]", BRIEF_USAGE = "workit fanout brief <slice> [--name <n>] [--mode new|resume] [--attempt <n>] [--json]", CHECK_USAGE = "workit fanout check [<slice>…] [--name <n>] [--base <ref>] [--offline] [--json]", STATUS_USAGE3 = "workit fanout status [--name <n>] [--stuck-after 30m] [--offline] [--json]", WORKTREE_USAGE = "workit fanout worktree create <slice> [--name <n>] | worktree release <slice> [--name <n>] [--force] [--json]", USAGE8 = "workit fanout plan|brief|check|status|worktree ... (workit help fanout)", failed = (io, result) => emit(io, fail(result.code, result.error, { unblock: result.unblock, data: result.data ?? {} })), renderCheck = (data) => [
   `fanout ${data.name} against ${data.trunkRef}: ${data.ready ? "ready to land" : "blocked"}`,
   ...data.slices.map((slice) => slice.status === "landed" ? `  -- ${slice.id} (${slice.branch}) landed (${slice.landed?.how}${slice.landed?.pr ? ` #${slice.landed.pr}` : ""})` : `  ${slice.status === "ready" ? "ok " : "x  "}${slice.id} (${slice.branch}) ${slice.changed} file${slice.changed === 1 ? "" : "s"} · verdict ${slice.verdict.accepted ? "accepted" : slice.verdict.basis}${slice.reasons.length ? `
       ${slice.reasons.join(`
@@ -77663,6 +77999,7 @@ var PLAN_USAGE2 = "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --
   ];
 };
 var init_fanout2 = __esm(() => {
+  init_fanout_brief();
   init_fanout_check();
   init_fanout_status();
   init_fanout_worktree();
@@ -77678,7 +78015,7 @@ var exports_ledger = {};
 __export(exports_ledger, {
   run: () => run16
 });
-import { randomBytes as randomBytes4 } from "node:crypto";
+import { randomBytes as randomBytes5 } from "node:crypto";
 import { parseArgs } from "node:util";
 function targetBranch(io, rows, branch, pr) {
   if (pr !== undefined) {
@@ -77724,8 +78061,10 @@ async function run16(argv, io) {
   const text = rest.join(" ");
   if (sub === undefined)
     return usage4(io, "missing subcommand");
-  if (!["decision", "ruling", "verdict", "list", "show", "check"].includes(sub))
+  if (!["decision", "ruling", "verdict", "standing", "list", "show", "check"].includes(sub))
     return usage4(io, `unknown ledger subcommand "${sub}"`);
+  if (sub === "standing")
+    return standing(io, values, rest);
   const ledger = readLedger(io.cwd);
   if (!ledger.ok)
     return failed2(io, ledger);
@@ -77803,7 +78142,62 @@ async function run16(argv, io) {
 `);
   return fromResult(io, verdict, (row) => `recorded verdict ${row.id}: ${row.result} [${row.kind}] for ${row.branch} @ ${(row.head ?? "").slice(0, 12)} as ${actor.session ?? "no session"}${row.self ? ` (self${row.selfReason === "no_session" ? ": WORKIT_SESSION_ID unset" : ""}; never accepted)` : ""}`);
 }
-var USAGE9 = "workit ledger decision|ruling|verdict|list|check ... (workit help ledger for the grammar)", OPTIONS, SESSION_SAFE2, ROLE_SAFE, actorFor = (io, values) => {
+function standingFanout(io, values) {
+  if (values.fanout !== undefined) {
+    const name = values.fanout.trim();
+    if (!name)
+      return new Error("--fanout needs a plan name");
+    const read = readFanout(io.cwd, name);
+    return { name, plan: read.ok ? read.data : null };
+  }
+  const selected = selectFanout(io.cwd, null, currentBranch(io.cwd));
+  return selected.ok ? { name: selected.data.name, plan: selected.data } : new Error(`${selected.error}; pass --fanout <name>`);
+}
+async function standing(io, values, args) {
+  const [action, ...rest] = args;
+  if (action !== "add" && action !== "list" && action !== "clear")
+    return emit(io, fail("invalid_input", action ? `unknown standing action "${action}"` : "missing add, list or clear", { unblock: STANDING_USAGE }));
+  const target = standingFanout(io, values);
+  if (target instanceof Error)
+    return emit(io, fail("invalid_input", target.message, { unblock: STANDING_USAGE }));
+  const fanout = target.name;
+  const lead = target.plan?.leadSession ?? null;
+  const leads = target.plan ? planLeads(target.plan) : null;
+  if (action === "list") {
+    if (rest.length)
+      return usage4(io, `unexpected argument: ${rest[0]}`);
+    const ledger = readLedger(io.cwd);
+    if (!ledger.ok)
+      return failed2(io, ledger);
+    const orders = activeStanding(ledger.value.rows, fanout, leads).map((row) => ({
+      id: row.id,
+      at: row.at,
+      what: row.what
+    }));
+    return emit(io, ok({ fanout, orders }), (data) => data.orders.length ? [
+      `standing orders for fanout ${fanout}:`,
+      ...data.orders.map((o) => `  ${o.id}  ${o.what}`)
+    ] : `no standing orders for fanout ${fanout}`);
+  }
+  const acting = actorFor(io, values);
+  if (acting instanceof Error)
+    return usage4(io, acting.message);
+  const context = {
+    cwd: io.cwd,
+    actor: acting.actor,
+    ...values.supersedes ? { supersedes: values.supersedes } : {}
+  };
+  if (action === "add" && target.plan === null)
+    return emit(io, fail("not_found", `no fanout plan named ${fanout}`, {
+      unblock: "workit fanout plan <plan.json> first, or name an existing plan with --fanout"
+    }));
+  if (action === "add")
+    return fromResult(io, recordStanding(context, { fanout, lead, what: rest.join(" ") }), (row) => `recorded standing order ${row.id} for fanout ${fanout}`);
+  if (rest.length > 1)
+    return usage4(io, `unexpected argument: ${rest[1]}`);
+  return fromResult(io, clearStanding(context, { fanout, lead, leads, target: rest[0] ?? null }), (row) => row.target ? `cleared standing order ${row.target} for fanout ${fanout}` : `cleared every standing order for fanout ${fanout}`);
+}
+var USAGE9 = "workit ledger decision|ruling|verdict|standing|list|check ... (workit help ledger for the grammar)", STANDING_USAGE = 'workit ledger standing add "<order>" | list | clear [<id>]  [--fanout <name>] [--json]', OPTIONS, SESSION_SAFE2, ROLE_SAFE, actorFor = (io, values) => {
   const actor = actorFromEnv(io.env);
   if (values.session !== undefined && values.as !== undefined)
     return new Error("pass --session or --as, not both");
@@ -77817,7 +78211,7 @@ var USAGE9 = "workit ledger decision|ruling|verdict|list|check ... (workit help
       return new Error("--as takes a lowercase role, e.g. verifier");
     const prefix = (actor.session ?? actor.host).slice(0, 96);
     return {
-      actor: { ...actor, session: `${prefix}:${values.as}:${randomBytes4(4).toString("hex")}` },
+      actor: { ...actor, session: `${prefix}:${values.as}:${randomBytes5(4).toString("hex")}` },
       derivedFrom: actor.session
     };
   }
@@ -77840,6 +78234,7 @@ var USAGE9 = "workit ledger decision|ruling|verdict|list|check ... (workit help
 };
 var init_ledger2 = __esm(() => {
   init_ledger();
+  init_fanout();
   init_rev();
   init_implicit_task();
   init_output();
@@ -77860,6 +78255,7 @@ var init_ledger2 = __esm(() => {
     supersedes: { type: "string" },
     session: { type: "string" },
     as: { type: "string" },
+    fanout: { type: "string" },
     json: { type: "boolean" }
   };
   SESSION_SAFE2 = /^[A-Za-z0-9_.:@/+-]{1,128}$/;
@@ -95043,15 +95439,15 @@ var VERBS = [
   {
     name: "fanout",
     group: "delivery",
-    usage: "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --track <t>] | fanout check [<slice>…] [--name <n>] [--base <ref>] [--offline] | fanout status [--name <n>] [--stuck-after 30m] [--offline] | fanout worktree create|release <slice> [--force] [--json]",
-    summary: "Register parallel slices (complete briefs, disjoint scopes, shared-file owners), watch them (STUCK, PR, CI, verdict, landed, landing order), make and release slice worktrees, and gate fan-in: out-of-scope edits, trunk and sibling merge conflicts",
+    usage: "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --track <t>] [--take-lead] | fanout brief <slice> [--mode new|resume] [--attempt <n>] | fanout check [<slice>…] [--name <n>] [--base <ref>] [--offline] | fanout status [--name <n>] [--stuck-after 30m] [--offline] | fanout worktree create|release <slice> [--force] [--json]",
+    summary: "Register parallel slices (complete briefs, disjoint scopes, shared-file owners), render each worker's brief with the standing orders, watch them (STUCK, PR, CI, verdict, landed, landing order), make and release slice worktrees, and gate fan-in: out-of-scope edits, trunk and sibling merge conflicts",
     load: () => Promise.resolve().then(() => (init_fanout2(), exports_fanout))
   },
   {
     name: "ledger",
     group: "delivery",
-    usage: "workit ledger decision|ruling|verdict|list|check ...",
-    summary: "Record and query decisions, rulings and SHA-keyed verdicts (patch-id carry-over across rebases)",
+    usage: "workit ledger decision|ruling|verdict|standing|list|check ...",
+    summary: "Record and query decisions, rulings, SHA-keyed verdicts (patch-id carry-over across rebases) and a fanout's standing orders",
     load: () => Promise.resolve().then(() => (init_ledger2(), exports_ledger))
   },
   {