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

package/dist/{chunk-JJEXMHNZ.js → chunk-HUMM4S5I.js}

@@ -10,12 +10,12 @@ import {
   typesListCommand,
   typesNotesCommand,
   uiComponentTypeRoutes
-} from "./chunk-ZQGFZJH5.js";
-import "./chunk-W4SMKUAK.js";
-import "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-523NRKHF.js";
+import "./chunk-OUGTAOGA.js";
+import "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-DARX3ATP.js → chunk-HVPS2YCW.js}

@@ -7,28 +7,28 @@ import {
   acpStepRunner,
   copilotAcpAllowed,
   copilotAcpByDefault
-} from "./chunk-DXBXZNKV.js";
+} from "./chunk-KMYB2XO7.js";
 import {
   REF
-} from "./chunk-BABRMZET.js";
+} from "./chunk-GZILYRGC.js";
 import {
   originOf
-} from "./chunk-BSZII65X.js";
+} from "./chunk-SFCFL7Y5.js";
 import {
   effectiveRules,
   exampleOf,
   ruleMatches,
   rulesDirOf
-} from "./chunk-V5FT3MZG.js";
+} from "./chunk-FKAUBC4Y.js";
 import {
   checkoutOf
-} from "./chunk-XDLMQL5A.js";
+} from "./chunk-QPAANKUR.js";
 import {
   estateRepos
-} from "./chunk-2HDNOUJU.js";
+} from "./chunk-QC6GSNIK.js";
 import {
   AcpSignInError
-} from "./chunk-ZDA72732.js";
+} from "./chunk-2MRYL45Z.js";
 import {
   ReadingRule,
   ReadingRulesFile,
@@ -41,15 +41,15 @@ import {
   orgPackDirOf,
   parseCorrections,
   parseFacts
-} from "./chunk-6ZDAEUKB.js";
+} from "./chunk-WJWSB65O.js";
 import {
   FileChangedError,
   writeFileAtomic,
   writeFileIfUnchanged
-} from "./chunk-MEMEO7YO.js";
+} from "./chunk-SMFFUFMN.js";
 import {
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -464,7 +464,7 @@ async function rulesTryCommand(root, repo, o, io) {
   };
   if (o.compare)
     return show();
-  const { listFiles } = await import("./chunk-PLSCWC2V.js");
+  const { listFiles } = await import("./chunk-D3L5SO27.js");
   const files = (await listFiles(dir)).filter((p) => ruleMatches(rule, p)).slice(0, o.files ?? 5);
   if (!files.length) {
     io.err(`No file of ${repo} is one ${rule.key} names (${(rule.files ?? []).join(", ")}).`);

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
 };