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

package/dist/{chunk-YISXLPHN.js → chunk-4B6BT75O.js}

@@ -7,19 +7,19 @@ import {
   ATTICUS_FOLDER_IGNORE,
   CHECKLISTS_README,
   STARTER_CHECKLISTS_README
-} from "./chunk-GDLULHTC.js";
+} from "./chunk-2HTEMYTB.js";
 import {
   openspecRootOf,
   rewriteStories
-} from "./chunk-CKSITVS4.js";
+} from "./chunk-BEPCKDCP.js";
 import {
   STARTER_REVIEW_PATH,
   readPackFiles,
   starterReviewText
-} from "./chunk-3HI6Z55Y.js";
+} from "./chunk-K332XW7K.js";
 import {
   metarepoOrigin
-} from "./chunk-XY3P7JW7.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   ORG_FLOW_VERSION,
   STORE_MARKER,
@@ -28,16 +28,15 @@ import {
   storeIdOf,
   writeOrgFlowSchema,
   writeStoreMarker
-} from "./chunk-4AK7IBVP.js";
+} from "./chunk-D2WSW4GU.js";
 import {
-  VERSION,
-  versionAtLeast
-} from "./chunk-RZPYKDWS.js";
+  VERSION
+} from "./chunk-VUVGX5L2.js";
 import {
   IGNORED,
   ensureGitignore,
   gitUser
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-XOL3GFW2.js";
 import {
   MetarepoStamp,
   WORKSPACE_SCHEMA_VERSION,
@@ -49,21 +48,25 @@ import {
   loadOrgPack,
   migrateCatalog,
   migrateChangeTypesText,
+  migrateCorrections,
   migrateGatesText,
   migrateManifests,
   migrateQuestions,
+  migrateRolesText,
   migrateRuntimeText,
+  migrateRuntimeV3Text,
+  migrateRuntimeV4Text,
   migrateSourcesText,
   orgPackDirOf,
   require_dist,
   specsDirOf,
   specsRelOf
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-PAINMSID.js";
 import {
   LOCAL_ONLY,
   ensureLocalIgnore,
   writeFileAtomic
-} from "./chunk-D3PO4DOZ.js";
+} from "./chunk-ODMBPDDV.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -71,7 +74,7 @@ import {
 // packages/cli/dist/upgrade.js
 var import_yaml = __toESM(require_dist(), 1);
 import { cp, mkdir, readdir, readFile, stat } from "node:fs/promises";
-import { join } from "node:path";
+import { join, relative, sep } from "node:path";
 var STAMP_FILE = join(".atticus", "metarepo.yaml");
 var rel = (prefix, files) => files.map((f) => `${prefix}/${f}`);
 var MIGRATIONS = [
@@ -158,8 +161,9 @@ var MIGRATIONS = [
     }
   },
   {
-    id: "questions-v2",
-    summary: "Questions at schema version 2: a question can name the earlier one it may be the same as (ADR 0117)",
+    // The id is kept as it was first shipped (stamps record it); the step writes the current version.
+    id: "questions-v3",
+    summary: "Questions at schema version 5: a question can name the earlier one it may be the same as (ADR 0117), an answer can carry its rule and the proposal it accepted (ADR 0153), a question the code later disagreed with keeps why it reopened and the answer it had (ADR 0162), and a change's question carries the role that owns it, derived from the stage that asked when the file doesn't say (ADR 0181)",
     pending: (root) => migrateQuestions(root, { dryRun: true }),
     apply: (root) => migrateQuestions(root)
   },
@@ -180,6 +184,8 @@ var MIGRATIONS = [
   },
   // The version-2 files: only the number changes, no field gains a required (ADR 0125).
   catalogStep("catalog-schema-v3", "Catalog records at schema version 3: a Schema field can say whether it is required (ADR 0125)", [2]),
+  // The version-3 files: only the number changes; version 4 adds a Schema format (ADR 0164).
+  catalogStep("catalog-schema-v4", "Catalog records at schema version 4: a Schema can be a protobuf message (ADR 0164)", [3]),
   sourcesStep("sources-v2", "sources.yaml at version 2: a wiki can include and exclude pages by pattern; every wiki still reads every page (ADR 0083)", { from: 1, to: 2 }),
   // ADR 0132: from version 1 or 2 (a version 1 file is moved to 2 by the step before, then here).
   sourcesStep("sources-v3", "sources.yaml at version 3: a wiki can say how much its word counts (authority) and where it applies (appliesTo); every wiki still ranks as a team's and applies everywhere (ADR 0132)", { to: 3 }),
@@ -224,6 +230,48 @@ var MIGRATIONS = [
       return [rel2];
     }
   },
+  {
+    // ADR 0171: a runtime.yaml that names copilot-acp (a mode or its copilotAcp section) needs
+    // version 3; any other file means the same at 1 or 2 and is left as it is.
+    id: "runtime-v3",
+    summary: "runtime.yaml at version 3 where it names copilot-acp: GitHub Copilot driven unattended through its Agent Client Protocol (ADR 0171); the number only",
+    async pending(root) {
+      const rel2 = packRel(root, "runtime.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      return text !== void 0 && migrateRuntimeV3Text(text).changed ? [rel2] : [];
+    },
+    async apply(root) {
+      const rel2 = packRel(root, "runtime.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      if (text === void 0)
+        return [];
+      const r = migrateRuntimeV3Text(text);
+      if (!r.changed)
+        return [];
+      await writeFileAtomic(join(root, rel2), r.text);
+      return [rel2];
+    }
+  },
+  {
+    id: "roles-v2",
+    summary: "roles.yaml at version 2: it can name the teams repos are owned by and who is on each, so questions go to their owner; no team is named until a person writes one (ADR 0140)",
+    async pending(root) {
+      const rel2 = packRel(root, "roles.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      return text !== void 0 && migrateRolesText(text).changed ? [rel2] : [];
+    },
+    async apply(root) {
+      const rel2 = packRel(root, "roles.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      if (text === void 0)
+        return [];
+      const r = migrateRolesText(text);
+      if (!r.changed)
+        return [];
+      await writeFileAtomic(join(root, rel2), r.text);
+      return [rel2];
+    }
+  },
   {
     // ADR 0006 addendum (2026-10-25): org-flow version 2 lists Atticus 2's artifacts (proposal,
     // design, stories, specs, tasks), so `openspec status` and `validate` agree with Atticus.
@@ -249,22 +297,67 @@ var MIGRATIONS = [
     // call: short story files, task prompts in tasks/, tasks numbered per story, OpenSpec specs.
     id: "stories-b-short",
     summary: "Each change's stories in the short form, with OpenSpec spec deltas and a proposal, from the kept stories answer (no model call; ADR 0124 addendum B-short)",
+    // The whole change folder: writing the stories again also writes stories.md, tasks.md,
+    // requests.md, the proposal, specs/, the task prompts and the needs files, all backed up.
     async pending(root) {
-      return (await longStories(root)).map((c) => `${changesRelOf(root)}/${c}/stories`);
+      return (await longStories(root)).map((c) => `${changesRelOf(root)}/${c}`);
     },
     async apply(root) {
       const out = [];
-      for (const c of await longStories(root))
-        for (const f of await rewriteStories(root, c).catch(() => []))
+      for (const c of await longStories(root)) {
+        const files = await rewriteStories(root, c).catch((e) => {
+          throw new Error(`The stories of ${c} couldn't be written again (${e instanceof Error ? e.message : String(e)}).`, { cause: e });
+        });
+        for (const f of files)
           out.push(`${changesRelOf(root)}/${c}/${f}`);
+      }
       return out;
     }
   },
   {
     id: "manifest-schema-v2",
     summary: "repos.manifest.yaml at version 2: a repo can say what it is, in a person's words (ADR 0128)",
-    pending: (root) => migrateManifests(root, { dryRun: true }),
-    apply: (root) => migrateManifests(root)
+    pending: (root) => migrateManifests(root, { dryRun: true, to: 2 }),
+    apply: (root) => migrateManifests(root, { to: 2 })
+  },
+  {
+    id: "manifest-schema-v3",
+    summary: "repos.manifest.yaml at version 3: a repo can give the base path it answers under on a shared host (ADR 0134)",
+    pending: (root) => migrateManifests(root, { dryRun: true, to: 3 }),
+    apply: (root) => migrateManifests(root, { to: 3 })
+  },
+  // ADR 0181: the version-4 files: only the number changes; version 5 adds the evidence source
+  // `ai` with its run (a link the AI decided, flagged joined-by-ai).
+  catalogStep("catalog-schema-v5", "Catalog records at schema version 5: a link can be the AI's, with the run that decided it (ADR 0181)", [4]),
+  {
+    // ADR 0181: a runtime.yaml that sets `decide` needs version 4; any other file means the same
+    // at 1 to 3 and is left as it is.
+    id: "runtime-v4",
+    summary: "runtime.yaml at version 4 where it sets decide: whether the AI decides pairings and option questions itself (ADR 0181); the number only",
+    async pending(root) {
+      const rel2 = packRel(root, "runtime.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      return text !== void 0 && migrateRuntimeV4Text(text).changed ? [rel2] : [];
+    },
+    async apply(root) {
+      const rel2 = packRel(root, "runtime.yaml");
+      const text = await readFile(join(root, rel2), "utf8").catch(() => void 0);
+      if (text === void 0)
+        return [];
+      const r = migrateRuntimeV4Text(text);
+      if (!r.changed)
+        return [];
+      await writeFileAtomic(join(root, rel2), r.text);
+      return [rel2];
+    }
+  },
+  {
+    // ADR 0181: a corrections line that uses version 2's fields (ai, batch, rule, match, unlink)
+    // but says version 1 (written by hand) says 2; every other line means the same at 1.
+    id: "corrections-v2",
+    summary: "Corrections lines at version 2 where they use its fields: an AI pairing, a batch, a rule, an unlink (ADR 0181); the number only",
+    pending: (root) => migrateCorrections(root, { dryRun: true }),
+    apply: (root) => migrateCorrections(root)
   }
 ];
 var orgFlowRel = (root) => `${layoutOf(root).openspec.replace(/\/+$/, "")}/schemas/org-flow/schema.yaml`;
@@ -360,7 +453,45 @@ async function readStamp(root) {
     return void 0;
   }
 }
-var newerThan = (a, b) => !versionAtLeast(b, a.replace(/-.*$/, ""));
+function newerThan(a, b) {
+  const split = (v) => {
+    const [core, pre] = v.trim().replace(/^v/, "").split(/-(.*)/s, 2);
+    return { core: (core ?? "").split(".").map((n) => Number(n) || 0), pre: pre ?? "" };
+  };
+  const x = split(a);
+  const y = split(b);
+  for (let i = 0; i < Math.max(x.core.length, y.core.length); i++) {
+    const d = (x.core[i] ?? 0) - (y.core[i] ?? 0);
+    if (d)
+      return d > 0;
+  }
+  if (x.pre === y.pre)
+    return false;
+  if (!x.pre)
+    return true;
+  if (!y.pre)
+    return false;
+  const xp = x.pre.split(".");
+  const yp = y.pre.split(".");
+  for (let i = 0; i < Math.max(xp.length, yp.length); i++) {
+    const p = xp[i];
+    const q = yp[i];
+    if (p === void 0)
+      return false;
+    if (q === void 0)
+      return true;
+    if (p === q)
+      continue;
+    const pn = /^\d+$/.test(p);
+    const qn = /^\d+$/.test(q);
+    if (pn && qn)
+      return Number(p) > Number(q);
+    if (pn !== qn)
+      return !pn;
+    return p > q;
+  }
+  return false;
+}
 async function upgradeCheck(root, version = VERSION) {
   const [stamp, found] = await Promise.all([
     readStamp(root),
@@ -370,7 +501,7 @@ async function upgradeCheck(root, version = VERSION) {
   return {
     atticus: version,
     ...stamp ? { stamp } : {},
-    newer: !!stamp && newerThan(stamp.atticus.replace(/-.*$/, ""), version.replace(/-.*$/, "")),
+    newer: !!stamp && newerThan(stamp.atticus, version),
     pending
   };
 }
@@ -445,10 +576,21 @@ async function upgradeCommand(root, o, io, version = VERSION) {
     await ensureLocalIgnore(root);
     for (const p of c.pending)
       for (const f of p.files)
-        await cp(join(root, ...f.split("/")), join(backup, ...f.split("/"))).catch(() => void 0);
+        await cp(join(root, ...f.split("/")), join(backup, ...f.split("/")), {
+          recursive: true
+        }).catch((e) => {
+          if (e.code === "ENOENT")
+            return;
+          throw new Error(`Couldn't back up ${f} before upgrading (${e.message}); nothing was changed.`);
+        });
     for (const p of c.pending) {
       const m = MIGRATIONS.find((x) => x.id === p.id);
-      changed.push(...await m.apply(root));
+      try {
+        changed.push(...await m.apply(root));
+      } catch (e) {
+        const done = c.pending.slice(0, c.pending.indexOf(p)).map((x) => x.id);
+        throw new Error(`${e instanceof Error ? e.message : String(e)} The files as they were before this upgrade are in ${relative(root, backup).split(sep).join("/")}${done.length ? `; these steps had already run: ${done.join(", ")}` : ""}. Run atticus upgrade again once it's fixed.`, { cause: e });
+      }
     }
   }
   const stamp = MetarepoStamp.parse({
@@ -491,6 +633,7 @@ export {
   STAMP_FILE,
   MIGRATIONS,
   readStamp,
+  newerThan,
   upgradeCheck,
   upgradeCommand
 };

package/dist/{chunk-C6EKFH7J.js → chunk-4CLK2RJO.js}

@@ -3,9 +3,6 @@ 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 {
-  table
-} from "./chunk-VOGCSYOI.js";
 import {
   QueryError,
   askLookup,
@@ -13,10 +10,13 @@ import {
   openIndex,
   runContextTool,
   translate
-} from "./chunk-T6AIP7H5.js";
-import "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-5WERBKLE.js";
+import {
+  table
+} from "./chunk-VOGCSYOI.js";
+import "./chunk-QHJJMZLX.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/index-commands.js

package/dist/chunk-4CYTJ5TZ.js

@@ -0,0 +1,38 @@
+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 {
+  DEFAULT_IGNORES
+} from "./chunk-7AB6OWTV.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/reading-rules-files.js
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+async function listFiles(dir, max = 5e4) {
+  const out = [];
+  const skip = new Set(DEFAULT_IGNORES.map((x) => x.replace(/\/\*\*$/, "").replace(/^\*\*\//, "")));
+  const walk = async (d, rel) => {
+    if (out.length >= max)
+      return;
+    const items = await readdir(d, { withFileTypes: true }).catch(() => []);
+    for (const e of items.sort((a, b) => a.name < b.name ? -1 : 1)) {
+      if (e.name.startsWith(".") || skip.has(e.name))
+        continue;
+      const r = rel ? `${rel}/${e.name}` : e.name;
+      if (e.isDirectory())
+        await walk(join(d, e.name), r);
+      else
+        out.push(r);
+    }
+  };
+  await walk(dir, "");
+  return out;
+}
+export {
+  listFiles
+};

package/dist/{chunk-EYWIDJFU.js → chunk-4D62IZII.js}

@@ -5,18 +5,18 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   metarepoToolBox
-} from "./chunk-ZVM6AKKM.js";
+} from "./chunk-ZOSD4FXV.js";
 import {
   CONTEXT_TOOLS
-} from "./chunk-T6AIP7H5.js";
+} from "./chunk-5WERBKLE.js";
 import {
   TOOL_LIMITS,
   ToolSession,
   readToolCalls,
   recordToolCalls
-} from "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-QHJJMZLX.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/context-commands.js