@maycombhq/atticus 2.0.0-beta.26 → 2.0.0-beta.27.1

package/dist/{chunk-IGOE6KPG.js → chunk-I34CXV2C.js}

@@ -4,15 +4,82 @@ var require = __atticusCreateRequire(import.meta.url);
 var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
-  aliasArgv,
-  isLegacy
-} from "./chunk-24OXGB3P.js";
+  optionsFor
+} from "./chunk-R4TUWD4C.js";
 import {
   isHandoffStep
 } from "./chunk-4Q3NN7VF.js";
-import {
-  optionsFor
-} from "./chunk-QA4O2GGC.js";
+
+// packages/cli/dist/top-commands.js
+var TOP_WORDS = [
+  "init",
+  "map",
+  "verify",
+  "join",
+  "change",
+  "critic",
+  "stories",
+  "task",
+  "questions",
+  "knowledge",
+  "next",
+  "ui"
+];
+var TOP = new Set(TOP_WORDS);
+var isLegacy = (first) => !!first && !TOP.has(first) && first !== "legacy" && first !== "help";
+var TOP_HELP = `  atticus init <folder> --platform <p>  Start your team's metarepo (atticus adopt <path> uses Atticus inside one repo)
+  atticus map <repo>                    Your assistant reads a repo into facts, each citing its file and line (/atticus-map does it in one session)
+  atticus verify <repo> [--write]       Check the facts against the code; --write puts them in the catalog and renders the map
+  atticus join [--json]                 Follow flows from repo to repo through the calls the facts join; writes specs/estate.yaml
+  atticus change new "<title>"          Start a change; atticus help change lists its stages and the rest
+  atticus critic <change>               Review a change: rule checks, then four questions (is it true, complete, safe, can it ship)
+  atticus stories <change>              The stories stage: stories with acceptance criteria and tasks, from the design
+  atticus task <change> <task>          Run one task with your assistant: a plan, a draft or a pull request
+  atticus questions                     What Atticus needs a person to answer, and who can answer it
+  atticus knowledge scan                Read your wikis into patterns, standards, processes and decisions; atticus help knowledge lists the rest
+  atticus next                          The next step to take, its command and its slash command
+  atticus ui [--open]                   Open the app on this machine
+
+  atticus help <command>                What one command takes (atticus explain <command> says it in plain words)
+  atticus legacy                        Every other command (scan, plan, release, estate and more); each still runs by its own name
+  atticus help --all                    Every command, grouped by area`;
+function topHelp(versionLine) {
+  return [
+    versionLine,
+    "",
+    "Map a multi-repo estate from its code, then take each change from idea to code, with a person approving every gate.",
+    "",
+    TOP_HELP,
+    "",
+    "Every command also takes --root <dir> (the metarepo) and --by <handle> (who is acting)."
+  ].join("\n");
+}
+function aliasArgv(argv, positions) {
+  const out = [...argv];
+  let at = [...positions];
+  if (at.length > 1 && out[at[0]] === "legacy") {
+    out.splice(at[0], 1);
+    at = at.slice(1).map((i) => i - 1);
+  }
+  const first = at[0];
+  if (first === void 0)
+    return out;
+  const word = out[first];
+  const second = at[1] === void 0 ? void 0 : out[at[1]];
+  if (word === "join" && second === "measure")
+    out.splice(first, 2, "estate", "measure");
+  else if (word === "join" && second === "shared")
+    out.splice(first, 2, "estate", "shared");
+  else if (word === "join" && second === "contracts")
+    out.splice(first, 2, "estate", "contracts");
+  else if (word === "join")
+    out.splice(first, 1, "estate", "join");
+  else if (word === "stories")
+    out.splice(first, 1, "plan", "stories");
+  else if (word === "task" && !["run", "context", "run-ready"].includes(second ?? ""))
+    out.splice(first + 1, 0, "run");
+  return out;
+}
 
 // packages/cli/dist/command-catalog.js
 var AREAS = [
@@ -56,6 +123,8 @@ var AREA_BY_WORD = {
   map: "repos",
   spec: "repos",
   estate: "repos",
+  // ADR 0196: canaries, beside the sample audit.
+  canary: "repos",
   "repo-type": "repos",
   // ADR 0176, 0177: reading rules, and skills and agents, set up for the organisation.
   rules: "repos",
@@ -168,6 +237,9 @@ var APPROVE_WHEN = {
 };
 var isWord = (t) => /^[a-z][a-z-]*$/.test(t);
 function parseArgs(id, usage) {
+  return argsOf(id, usage).map((a) => a.arg);
+}
+function argsOf(id, usage) {
   const out = [];
   const kinds = KIND_BY_COMMAND[id];
   const re = /(\[|"?<)([a-z][a-z|-]*?)(\.\.\.)?(>"?|\])(\.\.\.)?/g;
@@ -183,11 +255,14 @@ function parseArgs(id, usage) {
     const name = isChoice ? "choice" : parts[0];
     const kind = kinds?.[out.length] ?? (isChoice ? "choice" : KIND_BY_NAME[name] ?? "text");
     out.push({
-      name,
-      kind,
-      optional: m[1] === "[",
-      many: !!(m[3] || m[5]),
-      ...isChoice ? { choices: parts } : {}
+      arg: {
+        name,
+        kind,
+        optional: m[1] === "[",
+        many: !!(m[3] || m[5]),
+        ...isChoice ? { choices: parts } : {}
+      },
+      quoted: m[1] === '"<'
     });
   }
   return out;
@@ -299,6 +374,100 @@ function parseHelp(help) {
   }
   return out;
 }
+var TITLE_ARG_KINDS = /* @__PURE__ */ new Set([
+  "repo",
+  "change",
+  "flow",
+  "system",
+  "question",
+  "finding",
+  "record",
+  "choice"
+]);
+var TITLE_ARG_NAMES = /* @__PURE__ */ new Set([
+  "action",
+  "batch",
+  "call",
+  "commitment",
+  "entry-points",
+  "field",
+  "from",
+  "handle",
+  "id",
+  "into",
+  "item",
+  "lesson",
+  "list",
+  "measure",
+  "n",
+  "name",
+  "new",
+  "old",
+  "party",
+  "platform",
+  "ref",
+  "role",
+  "run",
+  "run-id",
+  "source",
+  "stage",
+  "step",
+  "story",
+  "tags",
+  "task",
+  "team",
+  "term",
+  "type"
+]);
+function titleSlotsOf(help) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c of parseHelp(help)) {
+    const quoted = argsOf(c.id, c.usage).map((a) => a.quoted);
+    const slots = c.args.map((a, i) => ({
+      id: !quoted[i] && (TITLE_ARG_KINDS.has(a.kind) || a.kind === "text" && TITLE_ARG_NAMES.has(a.name)),
+      many: a.many,
+      ...a.choices ? { choices: a.choices } : {}
+    }));
+    const named = c.words.join(" ");
+    const runs = aliasArgv(c.words, c.words.map((_, i) => i)).join(" ");
+    for (const key of /* @__PURE__ */ new Set([named, runs])) {
+      const had = out.get(key);
+      if (!had || had.length < slots.length)
+        out.set(key, slots);
+    }
+  }
+  return out;
+}
+function titleWordsByHelp(words, slots) {
+  let k = 0;
+  for (let n = Math.min(words.length, 3); n > 0; n--)
+    if (words.slice(0, n).every(isWord) && slots.has(words.slice(0, n).join(" "))) {
+      k = n;
+      break;
+    }
+  const out = [];
+  const add = (w) => {
+    if (w !== "\u2026" || out.at(-1) !== "\u2026")
+      out.push(w);
+  };
+  if (k === 0) {
+    if (words[0] !== void 0)
+      add(isWord(words[0]) ? words[0] : "\u2026");
+    if (words.length > 1)
+      add("\u2026");
+    return out;
+  }
+  for (const w of words.slice(0, k))
+    add(w);
+  const places = slots.get(words.slice(0, k).join(" "));
+  for (let i = k; i < words.length; i++) {
+    const at = i - k;
+    const slot = at < places.length ? places[at] : places.at(-1)?.many ? places.at(-1) : void 0;
+    const w = words[i];
+    add(slot?.id && (!slot.choices || slot.choices.includes(w)) ? w : "\u2026");
+  }
+  return out;
+}
 function commandCatalog(help) {
   const seen = /* @__PURE__ */ new Set();
   return parseHelp(help).map((parsed) => {
@@ -325,8 +494,13 @@ function commandCatalog(help) {
 }
 
 export {
+  isLegacy,
+  topHelp,
+  aliasArgv,
   AREAS,
   requiredFlags,
   parseHelp,
+  titleSlotsOf,
+  titleWordsByHelp,
   commandCatalog
 };

package/dist/{chunk-DOU52XFZ.js → chunk-I4P72R2F.js}

@@ -3,30 +3,30 @@ 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 {
+  houseUntaughtLines,
+  houseUntaughtOf
+} from "./chunk-CLM5Z3R5.js";
 import {
   noCheckoutLine
 } from "./chunk-EHXDB3SA.js";
 import {
   componentTypeIds,
   componentTypesAt
-} from "./chunk-W4SMKUAK.js";
+} from "./chunk-OUGTAOGA.js";
 import {
   modelsData,
   modelsLine,
   reachHeadOf,
   reachPlanOf,
   readPathsOf
-} from "./chunk-MY3LDBMR.js";
-import {
-  houseUntaughtLines,
-  houseUntaughtOf
-} from "./chunk-2FTHLB2H.js";
+} from "./chunk-YAPVAYZN.js";
 import {
   effectiveRules,
   notesAt,
   readingRulesText,
   ruleIds
-} from "./chunk-V5FT3MZG.js";
+} from "./chunk-UXETN43F.js";
 import {
   loadReadPlan,
   modelsModeOf,
@@ -36,7 +36,7 @@ import {
   recordNotReached,
   saveReadPlan,
   writeReadPlan
-} from "./chunk-P6DM2EFI.js";
+} from "./chunk-VVLWEM2Y.js";
 import {
   carryOf,
   checkoutOf,
@@ -50,7 +50,7 @@ import {
   reviewedProblemsOf,
   slipNoteLines,
   writeVerifyFiles
-} from "./chunk-XDLMQL5A.js";
+} from "./chunk-QPAANKUR.js";
 import {
   ABOUT_RULE,
   MODELS_RULE,
@@ -62,7 +62,7 @@ import {
   taughtFrameworksText,
   tierSource,
   tierWords
-} from "./chunk-IBIIKUC7.js";
+} from "./chunk-G33UIUG3.js";
 import {
   FILE_KINDS,
   SHOWN_PROPOSALS,
@@ -85,7 +85,10 @@ import {
   sliceText,
   staleMessage,
   verifyFacts
-} from "./chunk-RK5P2DWD.js";
+} from "./chunk-YIGSUTW2.js";
+import {
+  loadRepos
+} from "./chunk-X5B7KYPD.js";
 import {
   DATA_RULE,
   HandoffRuntime,
@@ -97,10 +100,7 @@ import {
   promptBudget,
   quarantineReason,
   wrapData
-} from "./chunk-ZDA72732.js";
-import {
-  loadRepos
-} from "./chunk-XIJBQM45.js";
+} from "./chunk-2MRYL45Z.js";
 import {
   Fact,
   citedFiles,
@@ -118,17 +118,17 @@ import {
   runsDirOf,
   saysNotProduct,
   stackHelpersOff
-} from "./chunk-6ZDAEUKB.js";
+} from "./chunk-WJWSB65O.js";
 import {
   writeFileAtomic
-} from "./chunk-MEMEO7YO.js";
+} from "./chunk-SMFFUFMN.js";
 import {
   AgentDefinition,
   REPO_DESCRIPTION_MAX,
   componentTypesText,
   conventionsOf,
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 
 // packages/cli/dist/map-commands.js
 import { existsSync } from "node:fs";
@@ -601,11 +601,35 @@ function limitOf(o, op, tier) {
   const given = o.maxTokens ?? currentPromptLimit();
   if (given !== void 0)
     return { limit: given, from: "flag" };
+  return knownLimitOf(op, tier);
+}
+function knownLimitOf(op, tier) {
   if (tier?.maxTokensFrom === "probe" && tier.maxTokens !== void 0)
     return { limit: tier.maxTokens, from: "probe" };
   const maxInput = op.runtime.adapters.model?.settings.maxInput;
   return typeof maxInput === "number" ? { limit: maxInput, from: "runtime.yaml" } : {};
 }
+async function sessionTokensHere(root, repo, commit, o, op, tier) {
+  const lim = limitOf(o, op, tier);
+  const session = sessionTokensFor(lim.limit);
+  if (lim.from === "flag")
+    return { session, fromPlan: false };
+  const plan = await loadReadPlan(root, repo);
+  const planned = plan && sameCommit(plan.commit, commit) && plan.session > 0 && (plan.parts.length > 0 || plan.estimate !== void 0);
+  if (!planned)
+    return { session, fromPlan: false };
+  if (lim.limit === void 0)
+    return { session: plan.session, fromPlan: true };
+  return plan.session === session || !lim.from ? { session, fromPlan: false } : {
+    session,
+    fromPlan: false,
+    replanned: { was: plan.session, limit: lim.limit, from: lim.from }
+  };
+}
+function replannedLine(r, session) {
+  const n = (x) => x.toLocaleString("en-US");
+  return `The read plan on file was planned at ${n(r.was)} tokens a session; ${r.from === "probe" ? "the limit atticus probe measured" : "runtime.yaml's maxInput"} (${n(r.limit)} tokens) gives ${n(session)}, so it is planned again at that size. --max-tokens n plans it at another limit.`;
+}
 async function tierHere(root, op) {
   return assistantTier(op.runtime, { probes: (await readProbes(root)).results });
 }
@@ -645,7 +669,7 @@ async function mapCommand(root, repo, o, io, deps = {}) {
     componentTypesText(await componentTypesAt(root, op))
   ].filter(Boolean).join("\n\n");
   if (o.gaps) {
-    const { mapGaps } = await import("./chunk-76AHTJVY.js");
+    const { mapGaps } = await import("./chunk-NNURP7VO.js");
     const tier = await tierHere(root, op);
     let part;
     if (o.part !== void 0) {
@@ -662,7 +686,7 @@ async function mapCommand(root, repo, o, io, deps = {}) {
     return mapGaps(root, repo, {
       commit,
       source,
-      session: sessionTokensFor(limitOf(o, op, tier).limit),
+      session: (await sessionTokensHere(root, repo, commit, o, op, tier)).session,
       checkout: relative(root, dir).split(sep).join("/") || ".",
       ...o.json ? { json: true } : {},
       ...part ? { part } : {},
@@ -672,14 +696,14 @@ async function mapCommand(root, repo, o, io, deps = {}) {
     }, io);
   }
   if (o.rules && !deps.runtime) {
-    const { mapRules } = await import("./chunk-TQG2DDWH.js");
+    const { mapRules } = await import("./chunk-TUMHMISE.js");
     const tier = await tierHere(root, op);
     return mapRules(root, repo, {
       commit,
       source,
       exclude,
       conventions,
-      session: sessionTokensFor(limitOf(o, op, tier).limit),
+      session: (await sessionTokensHere(root, repo, commit, o, op, tier)).session,
       notes: notesPrompt,
       checkout: relative(root, dir).split(sep).join("/") || ".",
       ...o.json ? { json: true } : {},
@@ -759,7 +783,7 @@ async function mapCommand(root, repo, o, io, deps = {}) {
       return tooSmall(0);
     const frameworks = await frameworksFor(root, repo, existing);
     if (o.rules) {
-      const { topUpOf, recordRulesNow, ruleSetsOfFiles } = await import("./chunk-TQG2DDWH.js");
+      const { topUpOf, recordRulesNow, ruleSetsOfFiles } = await import("./chunk-TUMHMISE.js");
       const t = await topUpOf(root, repo, {
         commit,
         facts: existing,
@@ -1005,7 +1029,7 @@ async function takeAnswer(root, s, run, batch, source, exclude, now, io, at) {
   });
   const summary = await writeVerifyFiles(root, s.repo, report, s.commit, q.problems, [], reviewedProblemsOf(reviewed.bad, report), answer.slips, await newerLinesOf(root, s.repo));
   if (answer.about) {
-    const { keepDraftedDescription } = await import("./chunk-RCLBIJRN.js");
+    const { keepDraftedDescription } = await import("./chunk-UGJSKAZ2.js");
     const d = await keepDraftedDescription(root, s.repo, answer.about, now());
     if (d.kept)
       io.out(`Your assistant says ${s.repo} is: "${answer.about.text}" \u2014 written to the manifest as a draft, unconfirmed. Confirm it (atticus repo describe ${s.repo} --accept), change it (--description "...") or drop it (--reject).`);
@@ -1039,7 +1063,7 @@ async function finish(root, s, io, o) {
   await saveState(root, s);
   const last = s.last;
   if (last && !last.rejected && !s.reread) {
-    const { recordRulesNow } = await import("./chunk-TQG2DDWH.js");
+    const { recordRulesNow } = await import("./chunk-TUMHMISE.js");
     await recordRulesNow(root, s.repo, s.commit, s.sets);
   }
   const rel = factsRelOf(root);
@@ -1104,7 +1128,8 @@ async function estimate(root, repo, c, io) {
     saysNotProduct: saysNotProduct(about)
   });
   const left = proposed.proposals.map((p) => p.path.slice(0, -2));
-  const session = sessionTokensFor(given);
+  const sized = await sessionTokensHere(root, repo, c.commit, c.o, c.op, tier);
+  const session = sized.session;
   const product = files.filter((f) => !left.some((d) => f.path.startsWith(d))).map((f) => {
     if (f.tokens <= session)
       return f;
@@ -1177,7 +1202,7 @@ async function estimate(root, repo, c, io) {
     exclude: c.exclude
   });
   if (c.o.part !== void 0 && !parts[c.o.part - 1]) {
-    io.err(`${repo} is read in ${parts.length ? `parts 1 to ${parts.length}` : "one session (no parts)"} at this limit: there is no part ${c.o.part}.`);
+    io.err(`${repo} is read in ${parts.length ? `parts 1 to ${parts.length}` : "one session (no parts)"} at this limit (${session} tokens a session${sized.fromPlan ? ", the read plan's" : ""}): there is no part ${c.o.part}.${sized.replanned ? ` ${replannedLine(sized.replanned, session)}` : ""}${sized.fromPlan ? "" : ` A read planned at another limit names its parts at that one: atticus map ${repo} --estimate --max-tokens <n>, with the limit it was planned at.`}`);
     return 2;
   }
   if (c.o.json) {
@@ -1206,6 +1231,10 @@ async function estimate(root, repo, c, io) {
       },
       parts: {
         session,
+        // beta.27: the size came from the read plan on file (no --max-tokens given).
+        ...sized.fromPlan ? { sessionFrom: "read-plan" } : {},
+        // Review of fix/b27-copilot: the plan on file was of another size: planned again.
+        ...sized.replanned ? { replanned: sized.replanned } : {},
         parts,
         // A-ledger: the read plan on file and what the facts say each part has covered.
         ...progress ? {
@@ -1281,6 +1310,8 @@ async function estimate(root, repo, c, io) {
   for (const m of re.missing)
     io.out(`Some facts are of commit ${m.slice(0, 12)}, which this clone can't compare with ${c.commit.slice(0, 12)} (fetch it, or read the repo again whole): the read below is the whole repo.`);
   io.out(`${plural(whole.files, "source file")}${reread ? " to read" : ""}, ${plural(whole.lines, "line")}, about ${whole.tokens} tokens${whole.excluded.length ? `; ${whole.excluded.length} excluded` : ""}${reread ? ` (the repo has ${plural(repoWhole.files, "source file")}, about ${repoWhole.tokens} tokens)` : ""}.`);
+  if (sized.replanned)
+    io.out(replannedLine(sized.replanned, session));
   if (proposed.proposals.length) {
     const scan = relative(root, join(orgPackDirOf(root), "scan", `${repo}.yaml`)).replace(/\\/g, "/");
     io.out(`Folders that look like data, documentation or vendored code, not the product (${proposed.proposals.length}):`);
@@ -1301,7 +1332,7 @@ repo: ${repo}`);
   if (parts.length) {
     if (proposed.proposals.length)
       io.out(`The parts below are planned over what is left with the ${plural(proposed.proposals.length, "proposed folder")} left out (${plural(product.length, "source file")}, about ${proposed.after} tokens); no part reads a proposed folder.`);
-    io.out(`About ${parts.reduce((n, p) => n + p.tokens, 0)} tokens${proposed.proposals.length ? " with those left out" : ""} is more than one session reads (${session} tokens): read it in ${parts.length} parts, one per session or sub-agent, as /atticus-map says:`);
+    io.out(`About ${parts.reduce((n, p) => n + p.tokens, 0)} tokens${proposed.proposals.length ? " with those left out" : ""} is more than one session reads (${session} tokens${sized.fromPlan ? `, as the read plan on file was planned; --max-tokens n plans it again` : ""}): read it in ${parts.length} parts, one per session or sub-agent, as /atticus-map says:`);
     const stateOf = (i) => progress?.parts[i]?.state;
     const words = (s) => s === "done" ? "done" : s === "in-progress" ? "part-read" : "to read";
     parts.forEach((p, i) => io.out(`  part ${i + 1} (${words(stateOf(i))}, about ${p.tokens} tokens, ${plural(p.files, "file")}): ${p.paths.join(", ")}`));
@@ -1354,5 +1385,7 @@ export {
   rulesCovering,
   ruleLineOf,
   taughtIn,
+  knownLimitOf,
+  sessionTokensHere,
   mapCommand
 };