@maycombhq/atticus 2.0.0-beta.22 → 2.0.0-beta.24

package/dist/{chunk-LDLL7LB3.js → chunk-ZCU2UY47.js}

@@ -6,33 +6,35 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   renderTaskContext,
   taskContext
-} from "./chunk-R7NYHMUU.js";
-import "./chunk-IVBOQAGB.js";
-import "./chunk-ISUAAMGS.js";
-import "./chunk-S4PMJU6H.js";
+} from "./chunk-WECCLSYY.js";
+import "./chunk-5FUFVNXB.js";
+import "./chunk-A6ZG3UOS.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-IDKCWSM5.js";
-import "./chunk-UUU4CLJG.js";
-import "./chunk-7IGKHZ4Z.js";
-import "./chunk-J2JAKCIW.js";
-import "./chunk-745DAZ4L.js";
-import "./chunk-CXJ6FUKN.js";
+} from "./chunk-U2JTTRKS.js";
+import "./chunk-5MKV4TV6.js";
+import "./chunk-ESJALLOK.js";
+import "./chunk-MCE74XMF.js";
+import "./chunk-25CUJJTP.js";
+import "./chunk-HNPKCRCE.js";
+import "./chunk-CZ75S2EZ.js";
 import {
   attachToChange
-} from "./chunk-QKUJMING.js";
-import "./chunk-6ZGLAACW.js";
-import "./chunk-CQDGOPGH.js";
-import "./chunk-3NFFJL5D.js";
-import "./chunk-PKBHS4AA.js";
-import "./chunk-P32RUW3B.js";
+} from "./chunk-GFYVVTKH.js";
+import "./chunk-DIYNRYXW.js";
+import "./chunk-5FPAKAGE.js";
+import "./chunk-IJQHBK76.js";
+import "./chunk-MOWUP33K.js";
 import "./chunk-QA4O2GGC.js";
+import "./chunk-OSZTENIA.js";
 import {
   changesRelOf,
   inputsDirOf
-} from "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-GJVCBTSO.js";
+import "./chunk-G3ZFEHCX.js";
+import "./chunk-QFDPX6C4.js";
+import "./chunk-CTJHEG6A.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 
@@ -92,7 +94,7 @@ async function promoteChangeInput(root, change, file) {
   } catch {
     throw new AttachError("not-found", `inputs/${name} isn't attached to ${c.id}: atticus change attach ${c.id} adds it.`);
   }
-  const { addToInbox } = await import("./chunk-UWMJKX5U.js");
+  const { addToInbox } = await import("./chunk-WWSCJBF6.js");
   const r = await addToInbox(root, [{ name, bytes }]);
   const added = r.added[0];
   if (!added)
@@ -109,11 +111,11 @@ function attachedLine(rel, a) {
 async function changeAttachCli(root, change, paths, o, io) {
   if (change && o.prototype) {
     if (paths.length) {
-      const { PROTOTYPE_CLI_WORDS } = await import("./chunk-7ASNL4Q4.js");
+      const { PROTOTYPE_CLI_WORDS } = await import("./chunk-77AZRGWE.js");
       io.err(PROTOTYPE_CLI_WORDS.usage(change, o.prototype));
       return 2;
     }
-    const { attachPrototype } = await import("./chunk-7ASNL4Q4.js");
+    const { attachPrototype } = await import("./chunk-77AZRGWE.js");
     return attachPrototype(root, change, o.prototype, { by: o.by, ...o.json ? { json: true } : {}, ...o.now ? { now: o.now } : {} }, io);
   }
   if (change && o.like) {
@@ -121,7 +123,7 @@ async function changeAttachCli(root, change, paths, o, io) {
       io.err("--like names an archived change, attached on its own: atticus change attach add-refund-window --like raise-transfer-limit");
       return 2;
     }
-    const { attachPastChange, findPastChange } = await import("./chunk-W7VWI2YH.js");
+    const { attachPastChange, findPastChange } = await import("./chunk-H7KERB6Q.js");
     const folder = await findPastChange(root, o.like);
     if (!folder) {
       io.err(`There is no archived change ${o.like}: atticus change similar "<what it is about>" lists them.`);

package/dist/{chunk-OWNCM4ZN.js → chunk-ZIAYNHHE.js}

@@ -5,19 +5,27 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   contractCheckOf
-} from "./chunk-T6DQR5TV.js";
+} from "./chunk-AM7PYKVP.js";
+import {
+  HttpError,
+  badRequest,
+  conflict,
+  notFound
+} from "./chunk-W4EG25TI.js";
 import {
   readCatalog
-} from "./chunk-J2JAKCIW.js";
+} from "./chunk-25CUJJTP.js";
 import {
   frameworkFacts,
   frameworkGaps
-} from "./chunk-CXJ6FUKN.js";
+} from "./chunk-HNPKCRCE.js";
 import {
   baseClonePath,
   loadRepos
-} from "./chunk-PKBHS4AA.js";
+} from "./chunk-OSZTENIA.js";
 import {
+  QuestionError,
+  api_exports,
   auditItemHolds,
   auditPrecision,
   catalogDirOf,
@@ -29,7 +37,13 @@ import {
   listQuestions,
   parseAuditFile,
   parseFacts
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-GJVCBTSO.js";
+import {
+  FileChangedError
+} from "./chunk-G3ZFEHCX.js";
+import {
+  keptParse
+} from "./chunk-CTJHEG6A.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -37,9 +51,62 @@ import {
   __toESM
 } from "./chunk-TV45EUGM.js";
 
+// packages/cli/dist/watched-memo.js
+import { stat } from "node:fs/promises";
+import { resolve } from "node:path";
+var MAX_AGE_MS = 6e4;
+var watched;
+var generation = 0;
+var kept = /* @__PURE__ */ new Map();
+async function stampOfFiles(paths) {
+  const parts = await Promise.all(paths.map((p) => stat(p).then((s) => `${s.size}:${s.mtimeMs}`, () => "-")));
+  return parts.join("|");
+}
+function keepAnswersWhileWatched(root, following) {
+  const me = { root: resolve(root), following };
+  watched = me;
+  kept.clear();
+  return () => {
+    if (watched === me)
+      watched = void 0;
+    kept.clear();
+  };
+}
+function answersMayHaveChanged() {
+  generation++;
+  kept.clear();
+}
+var misses = [];
+var miss = (key, why) => {
+  if (misses.length < 200)
+    misses.push(`${key}: ${why}`);
+};
+async function keptAnswer(root, key, work, stamp) {
+  if (!watched || watched.root !== resolve(root) || !watched.following()) {
+    miss(key, !watched ? "no server follows the files" : watched.root !== resolve(root) ? `another root (${watched.root} is followed)` : "the server follows no folder");
+    return work();
+  }
+  const at = generation;
+  const s = stamp ? await stamp() : "";
+  const hit = kept.get(key);
+  if (hit && hit.generation === generation && hit.stamp === s && Date.now() - hit.at < MAX_AGE_MS)
+    return hit.value;
+  miss(key, !hit ? "not asked before" : hit.generation !== generation ? "a change was heard" : hit.stamp !== s ? "a checkout moved" : "kept a minute already");
+  if (at !== generation)
+    return work();
+  const value = work();
+  const entry = { generation, at: Date.now(), value, stamp: s };
+  kept.set(key, entry);
+  value.catch(() => {
+    if (kept.get(key) === entry)
+      kept.delete(key);
+  });
+  return value;
+}
+
 // packages/cli/dist/ui-api-trust.js
 var import_yaml = __toESM(require_dist(), 1);
-import { readdir, readFile, stat } from "node:fs/promises";
+import { readdir, readFile, stat as stat2 } from "node:fs/promises";
 import { join, relative, sep } from "node:path";
 function rejectedLines(text2) {
   const out = [];
@@ -71,6 +138,15 @@ var FACT_BY = /* @__PURE__ */ new Set(["assistant", "reader", "person"]);
 var UNKNOWN_SHOWN = 50;
 var firstLine = (e) => String(e.message ?? e).split("\n")[0];
 var text = (p) => readFile(p, "utf8").catch(() => void 0);
+function secretsOf(raw) {
+  if (!Array.isArray(raw))
+    return {};
+  const secrets = raw.flatMap((x) => {
+    const s = x;
+    return s && typeof s.file === "string" && typeof s.key === "string" && Number.isInteger(s.line) ? [{ file: s.file, line: s.line, key: s.key }] : [];
+  });
+  return secrets.length ? { secrets } : {};
+}
 function reportOf(raw) {
   const r = raw;
   if (!r || typeof r.accepted !== "number" || typeof r.rejected !== "number")
@@ -88,6 +164,7 @@ function reportOf(raw) {
       excluded: list(r.coverage?.excluded).length
     },
     unknownFiles: unknown.slice(0, UNKNOWN_SHOWN),
+    ...secretsOf(r.secrets),
     ...typeof r.commit === "string" && SHA.test(r.commit) ? { commit: r.commit } : {}
   };
 }
@@ -170,21 +247,22 @@ async function trustView(root) {
   const repos = [];
   for (const repo of ids) {
     const factsPath = join(dir, `${repo}.jsonl`);
-    const raw = await text(factsPath);
+    const read = await keptParse(factsPath, "facts", (t) => t.trim() ? parseFacts(t) : null).catch(() => void 0);
+    const factsPresent = read !== void 0;
     const facts = {
       path: rel(factsPath),
-      present: raw !== void 0,
+      present: factsPresent,
       count: 0,
       unverified: 0
     };
     let frameworks;
     let terms;
-    let kept = [];
+    let kept2 = [];
     const lists = { rejected: [], excluded: [], asked: [], unverified: [] };
-    if (raw !== void 0 && raw.trim()) {
-      const parsed = parseFacts(raw);
+    if (read) {
+      const parsed = read;
       if (parsed.ok) {
-        kept = parsed.facts;
+        kept2 = parsed.facts;
         facts.count = parsed.facts.length;
         const unchecked = parsed.facts.filter((f) => f.verified === "none");
         facts.unverified = unchecked.length;
@@ -258,7 +336,7 @@ async function trustView(root) {
       if (!a.ok)
         problems.push({ file: rel(auditPath), message: `isn't an audit file: ${a.issues[0]}` });
       else {
-        const byId = new Map(kept.map((f) => [f.id, f]));
+        const byId = new Map(kept2.map((f) => [f.id, f]));
         const p = auditPrecision(a.file.items, (i) => auditItemHolds(i, byId));
         audit = {
           path: rel(auditPath),
@@ -277,7 +355,7 @@ async function trustView(root) {
       checkoutDir = void 0;
     }
     const head = checkoutDir ? await headFromFiles(checkoutDir) : void 0;
-    const present = checkoutDir ? await stat(join(checkoutDir, ".git")).then(() => true, () => false) : false;
+    const present = checkoutDir ? await stat2(join(checkoutDir, ".git")).then(() => true, () => false) : false;
     const checkout = {
       path: checkoutDir ? rel(checkoutDir) : `workspace/${repo}`,
       present,
@@ -305,11 +383,78 @@ async function trustView(root) {
     });
   }
   const contracts = await contractCheckOf(root).then((c) => c.result.counts.compared ? c.result.counts : void 0, () => void 0);
-  return { factsDir: factsRel, repos, problems, ...contracts ? { contracts } : {} };
+  const { answerBoxesOf } = await import("./chunk-C7BB6IQT.js");
+  const answerBoxes = await answerBoxesOf(root).catch(() => []);
+  return {
+    factsDir: factsRel,
+    repos,
+    problems,
+    ...contracts ? { contracts } : {},
+    ...answerBoxes.length ? { answerBoxes } : {}
+  };
+}
+async function checkoutsStamp(root) {
+  const dirs = isAdopted(root) ? [root] : (await loadRepos(root).catch(() => [])).flatMap((r) => {
+    try {
+      return [baseClonePath(root, r.id)];
+    } catch {
+      return [];
+    }
+  });
+  const files = await Promise.all(dirs.map(async (d) => {
+    const git = join(d, ".git");
+    const head = await readFile(join(git, "HEAD"), "utf8").catch(() => "");
+    const branch = /^ref: (refs\/\S+)/.exec(head)?.[1];
+    const remotes = await readdir(join(git, "refs", "remotes")).catch(() => []);
+    const worktrees = await readdir(join(git, "worktrees")).catch(() => []);
+    const branches = await Promise.all([
+      join(git, "refs", "heads", "task"),
+      join(git, "refs", "heads", "change"),
+      ...remotes.flatMap((r) => [
+        join(git, "refs", "remotes", r, "task"),
+        join(git, "refs", "remotes", r, "change")
+      ])
+    ].map(refFiles));
+    return [
+      join(git, "HEAD"),
+      join(git, "packed-refs"),
+      join(git, "logs", "HEAD"),
+      ...branch ? [join(git, ...branch.split("/"))] : [],
+      ...branches.flat(),
+      ...worktrees.sort().flatMap((w) => [
+        join(git, "worktrees", w, "HEAD"),
+        join(git, "worktrees", w, "logs", "HEAD")
+      ])
+    ];
+  }));
+  const heads = await Promise.all(dirs.map((d) => readFile(join(d, ".git", "HEAD"), "utf8").catch(() => "-")));
+  const all = files.flat();
+  const names = all.map((f) => relative(root, f)).join(",");
+  return `${heads.join("|")}#${names}#${await stampOfFiles(all)}`;
+}
+async function refFiles(dir) {
+  const out = [];
+  const walk = async (d, depth) => {
+    if (depth > 8)
+      return;
+    const es = await readdir(d, { withFileTypes: true }).catch(() => []);
+    for (const e of es) {
+      const p = join(d, e.name);
+      if (e.isDirectory())
+        await walk(p, depth + 1);
+      else if (e.isFile() && !e.name.endsWith(".lock"))
+        out.push(p);
+    }
+  };
+  await walk(dir, 0);
+  return out.sort();
 }
 function uiTrustRoutes(r, ctx) {
-  return r.add("GET", "/api/trust", async () => ({ status: 200, body: await trustView(ctx.root) })).add("GET", "/api/trust/fresh", async () => {
-    const { estateFreshness } = await import("./chunk-AFZ3QA6W.js");
+  return r.add("GET", "/api/trust", async () => ({
+    status: 200,
+    body: await keptAnswer(ctx.root, "trust", () => trustView(ctx.root), () => checkoutsStamp(ctx.root))
+  })).add("POST", "/api/trust/answer-boxes/ignore", ({ body }) => answerBoxRoute(ctx, body, false)).add("POST", "/api/trust/answer-boxes/rename", ({ body }) => answerBoxRoute(ctx, body, true)).add("GET", "/api/trust/fresh", async () => {
+    const { estateFreshness } = await import("./chunk-T2HXLDY3.js");
     const v = await estateFreshness(ctx.root);
     const body = {
       ...v,
@@ -323,8 +468,43 @@ function uiTrustRoutes(r, ctx) {
     return { status: 200, body };
   });
 }
+async function answerBoxRoute(ctx, body, rename) {
+  const b = api_exports.AnswerBoxRequest.safeParse(body ?? {});
+  if (!b.success || rename && !b.data.name)
+    throw badRequest(rename ? "Say which box and its real name: { id, name, preview }." : "Say which box: { id, preview }.");
+  const { AnswerBoxError, ignoreAnswerBox, renameAnswerBox } = await import("./chunk-C7BB6IQT.js");
+  const o = {
+    by: ctx.user,
+    at: (/* @__PURE__ */ new Date()).toISOString(),
+    ...b.data.preview ? { preview: true } : {}
+  };
+  try {
+    const r = rename ? await renameAnswerBox(ctx.root, b.data.id, b.data.name, o) : await ignoreAnswerBox(ctx.root, b.data.id, o);
+    if (r.written) {
+      for (const a of r.answers)
+        ctx.events.publish({ type: "file.changed", path: `questions/${a.id}.yaml` });
+      if (r.profile)
+        ctx.events.publish({ type: "file.changed", path: r.profile.path });
+    }
+    return { status: 200, body: r };
+  } catch (e) {
+    if (e instanceof AnswerBoxError)
+      throw e.code === "not-found" ? notFound(e.message) : badRequest(e.message);
+    if (e instanceof FileChangedError)
+      throw conflict(e.message);
+    if (e instanceof QuestionError)
+      throw new HttpError(422, "Atticus can't do that", e.message);
+    if (e instanceof Error && / would not be valid: /.test(e.message))
+      throw new HttpError(422, "Atticus can't do that", e.message.split("\n")[0]);
+    throw e;
+  }
+}
 
 export {
+  keepAnswersWhileWatched,
+  answersMayHaveChanged,
+  keptAnswer,
   catalogSources,
+  checkoutsStamp,
   uiTrustRoutes
 };

package/dist/{chunk-WJF2CS6M.js → chunk-ZJ2W2RDE.js}

@@ -45,16 +45,18 @@ import {
   utf8,
   visioIngestor,
   xlsxIngestor
-} from "./chunk-6ZGLAACW.js";
-import "./chunk-CQDGOPGH.js";
-import "./chunk-3NFFJL5D.js";
+} from "./chunk-DIYNRYXW.js";
+import "./chunk-5FPAKAGE.js";
+import "./chunk-IJQHBK76.js";
 import {
   ZIP_LIMITS,
   ZipError,
   peekZip,
   readZip
-} from "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-GJVCBTSO.js";
+import "./chunk-G3ZFEHCX.js";
+import "./chunk-QFDPX6C4.js";
+import "./chunk-CTJHEG6A.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-REWWDVQB.js → chunk-ZRQHSMPK.js}

@@ -78,10 +78,12 @@ import {
   writeAssistantFiles,
   writeProbe,
   zeroInstallCommands
-} from "./chunk-BEVTIBRH.js";
-import "./chunk-PKBHS4AA.js";
-import "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-J4K4C4T5.js";
+import "./chunk-OSZTENIA.js";
+import "./chunk-GJVCBTSO.js";
+import "./chunk-G3ZFEHCX.js";
+import "./chunk-QFDPX6C4.js";
+import "./chunk-CTJHEG6A.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-O7XLYEFA.js → chunk-ZSD75FYI.js}

@@ -5,18 +5,18 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   storeChangeRows
-} from "./chunk-JENSEMXF.js";
-import {
-  metarepoOpenSpec
-} from "./chunk-R7NYHMUU.js";
+} from "./chunk-HI7ADE4E.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
+import {
+  metarepoOpenSpec
+} from "./chunk-WECCLSYY.js";
 import {
   gateStatus,
   ownerWaitsLine,
   reviewedGates
-} from "./chunk-S4PMJU6H.js";
+} from "./chunk-A6ZG3UOS.js";
 import {
   ChangeError,
   RELEASE_PR_STATES,
@@ -37,26 +37,28 @@ import {
   returnToPo,
   syncHandoff,
   syncReleasePrs
-} from "./chunk-IDKCWSM5.js";
+} from "./chunk-U2JTTRKS.js";
 import {
   MockGitHost,
   createAdapters,
   fileStepStore
-} from "./chunk-7IGKHZ4Z.js";
+} from "./chunk-ESJALLOK.js";
 import {
   baseClonePath,
   createWorkspace,
   isInPlace,
   loadRepos,
   readChangeRepos
-} from "./chunk-PKBHS4AA.js";
+} from "./chunk-OSZTENIA.js";
 import {
   changeBranch,
   changesRelOf,
   handoffBranch,
-  loadOrgPack,
   orgPackDirOf
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-GJVCBTSO.js";
+import {
+  loadOrgPack
+} from "./chunk-QFDPX6C4.js";
 
 // packages/cli/dist/change-commands.js
 import { existsSync } from "node:fs";
@@ -80,11 +82,37 @@ async function syncAfterManualStep(root, s, by, io, deps = {}) {
   if (s.state === "open")
     return false;
   const pr = await handoffPrStep(root, s);
-  if (!pr)
+  if (pr) {
+    await changeSync(root, s.change, { by, ...pr.repo ? { repo: pr.repo } : {} }, io, deps);
+    return true;
+  }
+  const head = await prStepHead(root, s);
+  if (!head || !s.change)
     return false;
-  await changeSync(root, s.change, { by, ...pr.repo ? { repo: pr.repo } : {} }, io, deps);
+  if (head === changeBranch(s.change)) {
+    await changeSync(root, s.change, { by }, io, deps);
+    return true;
+  }
+  const task = head.startsWith(`task/${s.change}/`) ? head.split("/").at(-1) : void 0;
+  if (!task)
+    return false;
+  const { settleTaskPr } = await import("./chunk-FDL2JOLB.js");
+  const settled = await settleTaskPr(root, s.change, task, {
+    ...deps.gitHost ? { gitHost: deps.gitHost } : {},
+    ...deps.now ? { now: () => new Date(deps.now) } : {}
+  }).catch(() => ({}));
+  if (settled.state !== "merged")
+    return false;
+  io.out(`Task ${task}'s PR is merged into ${changeBranch(s.change)}${settled.ticked ? `; ticked ${task} in tasks.md` : ""}.`);
   return true;
 }
+async function prStepHead(root, s) {
+  if (s.system !== "git-host" || !s.change)
+    return void 0;
+  const open = s.action === "open-pull-request" ? s : (await fileStepStore(root).list({ change: s.change, system: "git-host" })).find((x) => x.action === "open-pull-request" && s.dependsOn.includes(x.id));
+  const head = open?.inputs.head;
+  return typeof head === "string" ? head : void 0;
+}
 function printReasons(io, reasons) {
   for (const r of reasons)
     io.err(`  - ${r.message}`);
@@ -129,7 +157,10 @@ function handoffPublisherFor(deps, io, gitHost) {
       try {
         return await git.publish(input);
       } catch (e) {
-        io?.out(`The branch ${input.branch} wasn't pushed (${e.message.split("\n")[0]}): push it yourself before you open the PR.`);
+        io?.out(
+          // App-only audit: the branch is kept here (the publisher makes it before the push).
+          `The branch ${input.branch} wasn't pushed (${e.message.split("\n")[0]}): it is kept here with the hand-off's files. Push again on the change page once that is fixed, or push it yourself (git push origin ${input.branch}) before you open the PR.`
+        );
         return { commit: "" };
       }
     }
@@ -171,7 +202,7 @@ async function changeNew(root, o, io, deps = {}) {
   }
   let like;
   if (o.like) {
-    const { findPastChange } = await import("./chunk-W7VWI2YH.js");
+    const { findPastChange } = await import("./chunk-H7KERB6Q.js");
     like = await findPastChange(root, o.like);
     if (!like) {
       io.err(`There is no archived change ${o.like}: atticus change similar "<what it is about>" lists them.`);
@@ -180,7 +211,7 @@ async function changeNew(root, o, io, deps = {}) {
   }
   let impact;
   if (o.impact) {
-    const { loadVendorImpact } = await import("./chunk-N3XIYPU3.js");
+    const { loadVendorImpact } = await import("./chunk-X7HFXXTZ.js");
     const got = await loadVendorImpact(root, o.impact, io);
     if ("error" in got) {
       io.err(got.error);
@@ -210,16 +241,16 @@ async function changeNew(root, o, io, deps = {}) {
     });
     io.out(`Created ${c.id} (${c.type}, from the ${c.template} template). It is in ${c.state}.`);
     if (impact) {
-      const { attachToChange } = await import("./chunk-RLDGWLQ7.js");
-      const { changeFolder } = await import("./chunk-FPJPLKDW.js");
-      const { impactDocument, IMPACT_WORDS } = await import("./chunk-N3XIYPU3.js");
+      const { attachToChange } = await import("./chunk-4DX4DIND.js");
+      const { changeFolder } = await import("./chunk-HRHXTLUM.js");
+      const { impactDocument, IMPACT_WORDS } = await import("./chunk-X7HFXXTZ.js");
       const doc = impactDocument(impact);
       const attached = await attachToChange(changeFolder(root, c.id), [{ name: doc.name, bytes: new TextEncoder().encode(doc.text) }], { by: o.by, at: deps.now ?? (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z") });
       const path = attached.added[0]?.path ?? `inputs/${doc.name}`;
       io.out(IMPACT_WORDS.started(impact.name, impact.impact.newer.version ?? impact.impact.newer.id, impact.impact, path));
     }
     if (like) {
-      const { attachPastChange } = await import("./chunk-W7VWI2YH.js");
+      const { attachPastChange } = await import("./chunk-H7KERB6Q.js");
       const name = await attachPastChange(root, c.id, like, o.by, deps.now ? new Date(deps.now) : /* @__PURE__ */ new Date());
       io.out(`It starts from ${like}: attached as inputs/${name}, which its steps read as an example.`);
     }
@@ -290,7 +321,7 @@ async function usedUpGates(root, id) {
   for (const g of await reviewedGates(root, id).catch(() => [])) {
     const s = await gateStatus(root, id, g).catch(() => void 0);
     if (s && (s.humanDecides || s.checkRound || ownerWaitsLine(s, id)))
-      out.push((await import("./chunk-PMUAJGLI.js")).statusLine(s, id));
+      out.push((await import("./chunk-AAY6VPPO.js")).statusLine(s, id));
   }
   return out;
 }
@@ -318,11 +349,14 @@ async function changeHandoff(root, id, o, io, deps = {}) {
       ...o.base ? { base: o.base } : {},
       publisher: handoffPublisherFor(deps, io, gitHost),
       // WP7.4: the PR reviews itself: the change as a picture, its estimate, its open findings.
-      review: await (await import("./chunk-EIPTLPFC.js")).handoffReview(root, id),
+      review: await (await import("./chunk-CFSHLQPK.js")).handoffReview(root, id),
       ...metarepoOpenSpec(root) ? { openspec: metarepoOpenSpec(root) } : {}
     });
     io.out(h.pr.url.startsWith("manual:") ? `Hand-off raised as a step for you (Home \u203A Manual steps): open its PR on the Git host from ${h.branch}, then record its link.` : `Hand-off PR #${h.pr.number} (${h.branch}) is open: ${h.pr.url}`);
-    io.out(`Reviewers: ${h.reviewers.length ? h.reviewers.map((r) => `@${r}`).join(", ") : "none named"}.`);
+    io.out(`Reviewers: ${h.reviewers.length ? h.reviewers.map((r) => `@${r}`).join(", ") : "none named: name the next role under Owners on the change's page"}.`);
+    const { notifyHandoffReviewers } = await import("./chunk-ZSNNF26J.js");
+    for (const line of await notifyHandoffReviewers(root, await changeStore(root).read(id), h, approvalOf(o.by, now, ref), deps.notify).catch(() => []))
+      io.out(line);
     io.out(`Merging it approves the gate; the Git host's own rules decide who may approve it.`);
     return 0;
   } catch (e) {
@@ -570,7 +604,7 @@ async function rescanAfterArchive(root, id, plan, io, deps) {
       io.out(`Couldn't update the base clone of ${s.id} (${s.reason ?? s.action}); scanning what is there.`);
   }
   io.out(`Rescanning for ${id}'s repos: ${here.join(", ")}.`);
-  const code = await (await import("./chunk-WNKPRSGI.js")).scanCommand(root, {}, io);
+  const code = await (await import("./chunk-L27KUL5B.js")).scanCommand(root, {}, io);
   if (away.length)
     io.out(`Not in a base clone here: ${away.join(", ")}. To add them, run: ${command(away)}`);
   return code;