@maycombhq/atticus 2.0.0-beta.18 → 2.0.0-beta.21

package/dist/{chunk-UTSFKZ72.js → chunk-WCEF7H6L.js}

@@ -5,10 +5,10 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   badRequest
-} from "./chunk-Q2X4IREC.js";
+} from "./chunk-HK3VOHIE.js";
 import {
   catalogRecords
-} from "./chunk-KLRZKW7Y.js";
+} from "./chunk-FY3QIRTL.js";
 import {
   RecordId,
   catalogDirOf,
@@ -17,7 +17,7 @@ import {
   require_dist,
   specRepos,
   specsDirOf
-} from "./chunk-YK6CSODO.js";
+} from "./chunk-PAINMSID.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/{chunk-DXPUYG5L.js → chunk-WEOMJHPV.js}

@@ -7,12 +7,12 @@ import {
   exportFrameworksKit,
   formatFrameworkSurvey,
   surveyFrameworks
-} from "./chunk-G5BYKJIM.js";
-import "./chunk-EZBAS5BL.js";
-import "./chunk-KCQS52TH.js";
-import "./chunk-IPSFMTK2.js";
-import "./chunk-TNCROWPQ.js";
-import "./chunk-7IM4BVVH.js";
+} from "./chunk-P2VBXX7N.js";
+import "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
 import {
   houseDependencies,
   learnFramework,
@@ -20,14 +20,14 @@ import {
   learnJsFramework,
   learnJsFrameworkFromTarball,
   runFrameworkTests
-} from "./chunk-RBXDHCN7.js";
+} from "./chunk-TWQRPM76.js";
 import {
   baseClonePath
-} from "./chunk-ZQC7MNQB.js";
+} from "./chunk-XOL3GFW2.js";
+import "./chunk-QHJJMZLX.js";
 import {
   fsRepo
-} from "./chunk-TLDL2ZZI.js";
-import "./chunk-QNMLLYTN.js";
+} from "./chunk-7AB6OWTV.js";
 import {
   FrameworkModel,
   RecordId,
@@ -35,8 +35,8 @@ import {
   orgPackDirOf,
   require_dist,
   toCanonicalYaml
-} from "./chunk-YK6CSODO.js";
-import "./chunk-MMB2OHUY.js";
+} from "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/{chunk-NFKBU2UH.js → chunk-WFU77T3A.js}

@@ -5,25 +5,25 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   targetFlowsOf
-} from "./chunk-VBSJ5NRB.js";
+} from "./chunk-GNWAOVFQ.js";
 import {
   estimateChange,
   loadRelease,
   releaseForecast
-} from "./chunk-YSEZQ6D3.js";
+} from "./chunk-36RY7ZXM.js";
 import {
   gateStatus,
   reviewedGates
-} from "./chunk-VEJYZEPC.js";
+} from "./chunk-K332XW7K.js";
 import {
   detectConflicts,
   outsideSystemsOf
-} from "./chunk-IOW6BF3U.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   loadEstimates,
   loadOrgPack,
   orgPackDirOf
-} from "./chunk-YK6CSODO.js";
+} from "./chunk-PAINMSID.js";
 
 // packages/cli/dist/change-estimate.js
 import { relative, sep } from "node:path";

package/dist/chunk-WIWTJMMR.js

@@ -0,0 +1,292 @@
+import { createRequire as __atticusCreateRequire } from "node:module";
+import { fileURLToPath as __atticusFileURLToPath } from "node:url";
+var require = __atticusCreateRequire(import.meta.url);
+var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
+var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  targetFlowsOf
+} from "./chunk-GNWAOVFQ.js";
+import {
+  withFileLock
+} from "./chunk-THN26IEF.js";
+import "./chunk-5QUOPNLN.js";
+import {
+  TARGET_DIR,
+  applyStroke,
+  endpointKey,
+  loadEstate,
+  planSketchWrite,
+  readDeltas,
+  writeSketch
+} from "./chunk-BEPCKDCP.js";
+import "./chunk-HWD4JPU7.js";
+import "./chunk-5WERBKLE.js";
+import "./chunk-K332XW7K.js";
+import {
+  changeFolder
+} from "./chunk-HSZMPH5T.js";
+import "./chunk-D2WSW4GU.js";
+import "./chunk-4KNOJC6J.js";
+import "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import {
+  labelText,
+  readDrawio
+} from "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-XOL3GFW2.js";
+import "./chunk-QHJJMZLX.js";
+import "./chunk-7AB6OWTV.js";
+import {
+  changesRelOf
+} from "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/change-sketch.js
+import { readFile } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+var METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+function lineParts(text) {
+  const toks = text.trim().split(/\s+/).filter(Boolean);
+  if (toks.length >= 2 && METHODS.has(toks[0].toUpperCase()) && toks[1].startsWith("/"))
+    return { method: toks[0].toUpperCase(), path: toks[1] };
+  if (toks.length === 1 && /^[A-Za-z0-9][\w.-]*\.[\w.-]+$/.test(toks[0]))
+    return { topic: toks[0] };
+  return {};
+}
+function readMermaidSketch(text) {
+  const labels = /* @__PURE__ */ new Map();
+  const lines = [];
+  const problems = [];
+  const legendOf = (s) => {
+    const m = /^\s*[[(]\s*(new|modify|modified|changed|retire|retired|removed)\s*[\])]\s*(.*)$/i.exec(s);
+    if (!m)
+      return { text: s.trim() };
+    const w = m[1].toLowerCase();
+    return {
+      legend: w.startsWith("new") ? "new" : w.startsWith("ret") || w === "removed" ? "retire" : "modify",
+      text: m[2].trim()
+    };
+  };
+  const node = (tok) => {
+    const m = /^([A-Za-z0-9_.-]+)(?:\[\s*"?([^\]"]*)"?\s*\]|\(+\s*"?([^)"]*)"?\s*\)+|\{+\s*"?([^}"]*)"?\s*\}+|>\s*"?([^\]"]*)"?\s*\])?$/.exec(tok.trim());
+    if (!m)
+      return tok.trim();
+    const label = (m[2] ?? m[3] ?? m[4] ?? m[5])?.trim();
+    if (label)
+      labels.set(m[1], label);
+    return m[1];
+  };
+  const rows = text.split(/\r?\n/);
+  rows.forEach((raw, i) => {
+    const row = raw.replace(/%%.*$/, "").trim();
+    if (!row || /^(flowchart|graph)\b/i.test(row) || /^(subgraph|end|classDef|class|style|direction)\b/i.test(row))
+      return;
+    if (/<\s*[-=.]/.test(row)) {
+      problems.push(`line ${i + 1}: a two-way line: draw one line each way: ${row}`);
+      return;
+    }
+    const m = /^(.+?)\s*(?:--+|==+|-\.+-?)\s*(?:\|([^|]*)\||"?([^">=-]*?)"?\s*(?:--+|==+|\.-+))?\s*>\s*(?:\|([^|]*)\|)?\s*(.+)$/.exec(row);
+    if (!m) {
+      if (/^[A-Za-z0-9_.-]+\s*[[({]/.test(row))
+        node(row);
+      else
+        problems.push(`line ${i + 1}: not a box or a line: ${row}`);
+      return;
+    }
+    if (/-->|==>|\.->|&/.test(m[1]) || /-->|==>|\.->|&/.test(m[5])) {
+      problems.push(`line ${i + 1}: one line between two boxes at a time (no chains or &): ${row}`);
+      return;
+    }
+    const from = node(m[1]);
+    const to = node(m[5]);
+    const { legend, text: label } = legendOf((m[2] ?? m[3] ?? m[4] ?? "").trim().replace(/^"(.*)"$/, "$1"));
+    lines.push({
+      from: labels.get(from) ?? from,
+      to: labels.get(to) ?? to,
+      label,
+      ...lineParts(label),
+      ...legend ? { legend } : {},
+      at: `line ${i + 1}`
+    });
+  });
+  for (const l of lines) {
+    l.from = labels.get(l.from) ?? l.from;
+    l.to = labels.get(l.to) ?? l.to;
+  }
+  return { lines, problems };
+}
+function readDrawioSketch(xml) {
+  const d = readDrawio(xml);
+  const lines = d.edges.map((e) => ({
+    from: e.from,
+    to: e.to,
+    label: labelText(e.label),
+    ...e.method ? { method: e.method } : {},
+    ...e.path ? { path: e.path } : {},
+    ...e.topic ? { topic: e.topic } : {},
+    ...e.legend ? { legend: e.legend } : {},
+    at: `${e.page}:${e.line}`
+  }));
+  return { lines, problems: d.problems.map((p) => `${p.cell}: ${p.message}`) };
+}
+var slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+function componentOf(label, estate) {
+  const s = slug(label);
+  const known = (id) => estate.ids.has(id) || estate.flows.some((f) => f.flow.component === id);
+  if (known(label))
+    return label;
+  if (known(s))
+    return s;
+  for (const r of estate.records)
+    if (r.kind === "Component" && (slug(("name" in r && typeof r.name === "string" ? r.name : "") ?? "") === s || slug(r.id) === s))
+      return r.id;
+  return void 0;
+}
+function strokesOfLines(lines, estate, drawnAlready = []) {
+  const plan = { strokes: [], skipped: [] };
+  for (const l of lines) {
+    const from = componentOf(l.from, estate);
+    const to = componentOf(l.to, estate) ?? slug(l.to);
+    if (!from) {
+      plan.skipped.push({
+        line: l,
+        why: `${l.from} isn't a component of the catalog: a stroke can't start from it here (a new box needs a flow name and a trigger; draw it in the app).`
+      });
+      continue;
+    }
+    const entry = l.topic ?? (l.method && l.path ? `${l.method} ${l.path}` : l.label);
+    if (!entry) {
+      plan.skipped.push({
+        line: l,
+        why: "the line has no label: say the API (METHOD /path) or the topic."
+      });
+      continue;
+    }
+    const todaySteps = estate.flows.filter((f) => f.flow.component === from).flatMap((f) => f.flow.steps.map((s, i) => ({ flow: f.flow.id, step: i + 1, s })).filter(({ s }) => s.to?.component === to && (s.to.entry === entry || !!l.path && s.to.entry.replace(/^[A-Z]+\s+/, "") === l.path)));
+    if (l.legend === "retire") {
+      if (!todaySteps.length) {
+        plan.skipped.push({
+          line: l,
+          why: `marked retired, but today's map has no step from ${from} to ${to} ${entry}.`
+        });
+        continue;
+      }
+      for (const t of todaySteps)
+        plan.strokes.push({
+          line: l,
+          stroke: {
+            kind: "remove",
+            flow: t.flow,
+            step: t.step,
+            why: `Removed in the sketch (${l.at}).`
+          }
+        });
+      continue;
+    }
+    if (todaySteps.length && l.legend !== "new") {
+      plan.skipped.push({ line: l, why: "already on today's map; nothing to draw." });
+      continue;
+    }
+    const drawnBefore = drawnAlready.some((d) => (d.repo === from || d.runsOn?.component === from || d.flow.startsWith(`${from}.`)) && d.steps.some((st) => st.op === "add" && (l.topic && st.kind === "publish" && st.to?.entry === l.topic || !l.topic && st.to?.component === to && st.to.entry === entry)));
+    if (drawnBefore) {
+      plan.skipped.push({ line: l, why: "already drawn in this change; nothing to add." });
+      continue;
+    }
+    const isNew = !componentOf(l.to, estate) || !!l.method && !estate.endpoints.has(endpointKey(entry));
+    plan.strokes.push({
+      line: l,
+      stroke: l.topic ? {
+        kind: "topic",
+        from: { component: from },
+        topic: l.topic,
+        ...componentOf(l.to, estate) && to !== from ? { listener: { component: to } } : {},
+        what: `Publishes ${l.topic} (${l.at}).`
+      } : {
+        kind: "call",
+        from: { component: from },
+        to: { component: to, entry, new: isNew },
+        what: `Calls ${to}'s ${entry} (${l.at}).`
+      }
+    });
+  }
+  return plan;
+}
+async function changeSketchCommand(root, change, o, io) {
+  if (!change || !o.from) {
+    io.err("Usage: atticus change sketch <change> --from <file.drawio|.mmd> [--save]");
+    return 2;
+  }
+  const t = await targetFlowsOf(root, change);
+  if (!t) {
+    io.err(`There is no change ${change}.`);
+    return 2;
+  }
+  const text = await readFile(o.from, "utf8").catch(() => void 0);
+  if (text === void 0) {
+    io.err(`${o.from} can't be read.`);
+    return 2;
+  }
+  const ext = extname(o.from).toLowerCase();
+  const read = ext === ".drawio" || ext === ".xml" || text.trimStart().startsWith("<") ? readDrawioSketch(text) : readMermaidSketch(text);
+  const estate = await loadEstate(root, t.records);
+  const dir = changeFolder(root, change);
+  const plan = strokesOfLines(read.lines, estate, (await readDeltas(dir)).deltas);
+  const by = `${o.by ?? "a person"} from ${basename(o.from)}`;
+  const problems = [...read.problems];
+  const drawn = [];
+  await withFileLock(join(dir, TARGET_DIR), async () => {
+    const read2 = await readDeltas(dir);
+    if (read2.problems.length) {
+      problems.push(...read2.problems.map((x) => `${x} (fix it before drawing over it)`));
+      return;
+    }
+    let deltas = read2.deltas;
+    const changed = [];
+    for (const s of plan.strokes) {
+      const r = applyStroke(deltas, s.stroke, estate, by);
+      if (r.problem) {
+        plan.skipped.push({ line: s.line, why: r.problem });
+        continue;
+      }
+      deltas = r.deltas;
+      changed.push(...r.changed);
+      drawn.push(`${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at})`);
+    }
+    if (o.save && drawn.length)
+      await writeSketch(dir, await planSketchWrite(dir, deltas, changed, estate, by));
+  });
+  if (o.json) {
+    io.out(JSON.stringify({
+      change,
+      written: !!o.save && drawn.length > 0,
+      drawn,
+      skipped: plan.skipped,
+      problems
+    }, null, 2));
+    return 0;
+  }
+  for (const d of drawn)
+    io.out(`${o.save ? "Drawn" : "Would draw"}: ${d}`);
+  for (const s of plan.skipped)
+    io.out(`Left out: ${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at}): ${s.why}`);
+  for (const p of problems)
+    io.out(`Didn't read: ${p}`);
+  if (!drawn.length) {
+    io.out("Nothing to draw from this file.");
+    return plan.skipped.length || problems.length ? 1 : 0;
+  }
+  io.out(o.save ? `${drawn.length} stroke${drawn.length === 1 ? "" : "s"} written to ${changesRelOf(root)}/${change}/${TARGET_DIR}/; the change diagram shows them, and atticus change architecture ${change} fills in the rest.` : `${drawn.length} stroke${drawn.length === 1 ? "" : "s"} to draw; nothing written. Add --save to draw them.`);
+  return 0;
+}
+export {
+  changeSketchCommand,
+  componentOf,
+  lineParts,
+  readDrawioSketch,
+  readMermaidSketch,
+  strokesOfLines
+};

package/dist/{chunk-MRFSUAJH.js → chunk-WNTIOBOG.js}

@@ -3,35 +3,35 @@ import { fileURLToPath as __atticusFileURLToPath } from "node:url";
 var require = __atticusCreateRequire(import.meta.url);
 var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
-import "./chunk-KCF7TFOE.js";
+import "./chunk-K6JB6XTX.js";
 import {
   loadCatalog
-} from "./chunk-WWPC2AZ2.js";
+} from "./chunk-5QUOPNLN.js";
 import {
   repoFor
-} from "./chunk-LGDW4G73.js";
+} from "./chunk-TGVVUKTG.js";
+import "./chunk-P2VBXX7N.js";
 import {
   askHosts
-} from "./chunk-IO6DQCZX.js";
-import "./chunk-G5BYKJIM.js";
+} from "./chunk-TYD6I4CZ.js";
+import "./chunk-ZOSD4FXV.js";
+import "./chunk-5WERBKLE.js";
 import {
   estateFlow,
   estateStepKey,
   fieldLineage,
   joinEstate
-} from "./chunk-EZBAS5BL.js";
-import "./chunk-KCQS52TH.js";
-import "./chunk-IPSFMTK2.js";
-import "./chunk-TNCROWPQ.js";
-import "./chunk-7IM4BVVH.js";
-import "./chunk-RBXDHCN7.js";
-import "./chunk-JZOOX3PQ.js";
-import "./chunk-YXUIUOQZ.js";
-import "./chunk-ZQC7MNQB.js";
+} from "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-XOL3GFW2.js";
+import "./chunk-QHJJMZLX.js";
 import {
   fsRepo
-} from "./chunk-TLDL2ZZI.js";
-import "./chunk-QNMLLYTN.js";
+} from "./chunk-7AB6OWTV.js";
 import {
   listQuestions,
   loadOrgPack,
@@ -45,8 +45,8 @@ import {
   specsRelOf,
   templateRef,
   writeEstateJoins
-} from "./chunk-YK6CSODO.js";
-import "./chunk-MMB2OHUY.js";
+} from "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/estate-commands.js

package/dist/{chunk-UROTYIGJ.js → chunk-X2CUXTWU.js}

@@ -7,18 +7,18 @@ import {
   readRound,
   reviewedGates,
   roundsOf
-} from "./chunk-VEJYZEPC.js";
+} from "./chunk-K332XW7K.js";
 import {
   changeStore,
   liveHandoff
-} from "./chunk-IOW6BF3U.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   createAdapters
-} from "./chunk-V3UEPUHT.js";
+} from "./chunk-4KNOJC6J.js";
 import {
   loadOrgPack,
   orgPackDirOf
-} from "./chunk-YK6CSODO.js";
+} from "./chunk-PAINMSID.js";
 
 // packages/cli/dist/digest-commands.js
 var norm = (s) => s.toLowerCase().replace(/^@/, "");
@@ -68,8 +68,8 @@ async function buildDigest(root, user) {
   }
   if (!lines.length)
     lines.push("Nothing waits on you.");
-  const { readMe } = await import("./chunk-GBGJ6WSO.js");
-  const { watchLine } = await import("./chunk-XLHL6WTI.js");
+  const { readMe } = await import("./chunk-ZLS6PU2O.js");
+  const { watchLine } = await import("./chunk-LIRVU3HW.js");
   const watching = [];
   for (const c of (await readMe(root)).watch)
     watching.push(await watchLine(root, c));

package/dist/chunk-X7EMBM5X.js

@@ -0,0 +1,34 @@
+import { createRequire as __atticusCreateRequire } from "node:module";
+import { fileURLToPath as __atticusFileURLToPath } from "node:url";
+var require = __atticusCreateRequire(import.meta.url);
+var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
+var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  citesCli,
+  fileInRepo,
+  uiCiteRoutes
+} from "./chunk-WCEF7H6L.js";
+import "./chunk-HK3VOHIE.js";
+import "./chunk-FY3QIRTL.js";
+import "./chunk-5WERBKLE.js";
+import "./chunk-K332XW7K.js";
+import "./chunk-HSZMPH5T.js";
+import "./chunk-D2WSW4GU.js";
+import "./chunk-4KNOJC6J.js";
+import "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-XOL3GFW2.js";
+import "./chunk-QHJJMZLX.js";
+import "./chunk-7AB6OWTV.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
+import "./chunk-TV45EUGM.js";
+export {
+  citesCli,
+  fileInRepo,
+  uiCiteRoutes
+};

package/dist/{chunk-OO5TKEAG.js → chunk-XEQCQO66.js}

@@ -12,14 +12,14 @@ import {
   loadLinkEvidence,
   repoContractsOf,
   writeRepoContracts
-} from "./chunk-RUOGHYSK.js";
-import "./chunk-TNCROWPQ.js";
-import "./chunk-7IM4BVVH.js";
-import "./chunk-RBXDHCN7.js";
-import "./chunk-TLDL2ZZI.js";
-import "./chunk-QNMLLYTN.js";
-import "./chunk-YK6CSODO.js";
-import "./chunk-MMB2OHUY.js";
+} from "./chunk-LPV6T362.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-QHJJMZLX.js";
+import "./chunk-7AB6OWTV.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 export {
   denyHash,

package/dist/{chunk-NBQO75XT.js → chunk-XG4WJHLQ.js}

@@ -54,6 +54,13 @@ var AREA_BY_WORD = {
   spec: "repos",
   estate: "repos",
   "repo-type": "repos",
+  // ADR 0176, 0177: reading rules, and skills and agents, set up for the organisation.
+  rules: "repos",
+  // ADR 0178: Copilot proposes pairings of a repo's calls with another box's APIs.
+  connect: "repos",
+  // ADR 0180: the organisation's component types.
+  types: "start",
+  skills: "start",
   repo: "repos",
   repos: "repos",
   workspace: "repos",
@@ -138,6 +145,7 @@ var KIND_BY_COMMAND = {
   "change status": ["change"],
   "change handoff": ["change"],
   "change sync": ["change"],
+  "change release-prs": ["change"],
   "change return": ["change"],
   "change archive": ["change"],
   finding: ["change", "finding"],
@@ -148,6 +156,13 @@ var KIND_BY_COMMAND = {
 };
 var SERVES = /* @__PURE__ */ new Set(["ui", "stub serve", "mcp"]);
 var APPROVE_FLAGS = ["--approve", "--send"];
+var LOCAL_ALWAYS = /* @__PURE__ */ new Set(["handoff done"]);
+var APPROVE_WHEN = {
+  "task run": { flag: "--level", value: "pr" },
+  // ADR 0181 part 4: Run all ready tasks runs each task itself; only --level pr pushes and opens PRs.
+  "task run-ready": { flag: "--level", value: "pr" },
+  task: { flag: "--level", value: "pr" }
+};
 var isWord = (t) => /^[a-z][a-z-]*$/.test(t);
 function parseArgs(id, usage) {
   const out = [];
@@ -267,7 +282,7 @@ function commandCatalog(help) {
     }
     seen.add(c.id);
     const area = AREA_BY_ID[c.id] ?? AREA_BY_WORD[c.words[0] ?? ""] ?? "";
-    const approve = APPROVE_FLAGS.find((f) => c.flags.some((x) => x.name === f));
+    const approve = LOCAL_ALWAYS.has(c.id) ? void 0 : APPROVE_FLAGS.find((f) => c.flags.some((x) => x.name === f));
     const [w0, w1] = aliasArgv(c.words, c.words.map((_, i) => i));
     const runs = isHandoffStep(w0, w1) || c.id === "critic" || c.id === "map" ? "ai" : SERVES.has(c.id) ? "serve" : approve ? "shared" : "local";
     return {
@@ -275,6 +290,7 @@ function commandCatalog(help) {
       area,
       runs,
       ...approve && runs === "shared" ? { approve } : {},
+      ...approve && runs === "shared" && APPROVE_WHEN[c.id] ? { approveWhen: APPROVE_WHEN[c.id] } : {},
       legacy: isLegacy(c.words[0])
     };
   });