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

package/dist/{chunk-BPDS7KUR.js → chunk-YXG2VQJJ.js}

@@ -3,27 +3,24 @@ 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 {
-  onboardingView
-} from "./chunk-EP7ZBZLT.js";
 import {
   onboardingQueue,
   queueWhy,
   reasonOf
-} from "./chunk-5267F4BS.js";
+} from "./chunk-ALCSTVWQ.js";
 import {
   houseUntaughtOf,
   houseUntaughtWords
-} from "./chunk-HHZEXF7V.js";
+} from "./chunk-CLM5Z3R5.js";
 import {
   catalogSources
-} from "./chunk-AGAFNUYZ.js";
+} from "./chunk-VN2VJ6BV.js";
 import {
   readTaskRun
-} from "./chunk-5RDKQOY3.js";
+} from "./chunk-SHFY73RI.js";
 import {
   rulesLackingAll
-} from "./chunk-5WZV37WS.js";
+} from "./chunk-FKAUBC4Y.js";
 import {
   loadReadPlan,
   partOfWords,
@@ -32,31 +29,31 @@ import {
   readPlanProgress,
   readPlanRelOf,
   tokensWords
-} from "./chunk-DBVQEPZB.js";
+} from "./chunk-VVLWEM2Y.js";
 import {
   checkoutOf,
   conventionsAt
-} from "./chunk-XP5DF5MC.js";
+} from "./chunk-QPAANKUR.js";
 import {
   isMetarepo,
   notMetarepo
 } from "./chunk-3G4YI4ZU.js";
 import {
   readChangeTasks
-} from "./chunk-MN2XDLDM.js";
+} from "./chunk-YSSFS3YC.js";
+import {
+  readNeeds,
+  seedCollisions
+} from "./chunk-JL2VOYSL.js";
 import {
   ASSISTANT_FORMATS,
   probedAssistant,
   readProbes,
   whatRunsWhere
-} from "./chunk-H7GAPNGQ.js";
-import {
-  readNeeds,
-  seedCollisions
-} from "./chunk-IWQEZFVV.js";
+} from "./chunk-G33UIUG3.js";
 import {
   readChangeFiles
-} from "./chunk-GDGE7ZHC.js";
+} from "./chunk-U3Z2QZE3.js";
 import {
   assess,
   changeStore,
@@ -65,26 +62,29 @@ import {
   loadChangeContext,
   loadChangePolicy,
   releasePrReasons,
-  stageCompletion
-} from "./chunk-JQGWP3SC.js";
-import {
-  fileStepStore
-} from "./chunk-U7YZ3IRI.js";
+  stageCompletion,
+  stageWorkDone
+} from "./chunk-SVOGRJO6.js";
 import {
   readCatalog
-} from "./chunk-YRKAJ42V.js";
+} from "./chunk-QC6GSNIK.js";
 import {
   readKnowledge,
+  scopeWords,
   snapshotDates,
   workingDays
-} from "./chunk-RL7PETU6.js";
+} from "./chunk-N5DLB74D.js";
 import {
-  stepClassOfNextStep
-} from "./chunk-QQD25YNF.js";
+  fileStepStore
+} from "./chunk-I57IH5X6.js";
 import {
   baseClonePath,
+  loadManifest,
   repoIdKey
-} from "./chunk-WS7KBKP4.js";
+} from "./chunk-X5B7KYPD.js";
+import {
+  stepClassOfNextStep
+} from "./chunk-2MRYL45Z.js";
 import {
   ScanVerifyProposal,
   catalogDirOf,
@@ -102,12 +102,13 @@ import {
   questionWeights,
   readRepoSpec,
   readSpecFindings
-} from "./chunk-GLISHJ4G.js";
+} from "./chunk-WJWSB65O.js";
 import {
+  Sources,
   fastPathOf,
   loadOrgPack,
   stepModelsOf
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -116,20 +117,159 @@ import {
 } from "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/next-commands.js
-var import_yaml = __toESM(require_dist(), 1);
+var import_yaml2 = __toESM(require_dist(), 1);
 import { existsSync } from "node:fs";
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
+import { readdir as readdir2, readFile as readFile2 } from "node:fs/promises";
+import { join as join2 } from "node:path";
+
+// packages/cli/dist/ui-api-onboarding.js
+var import_yaml = __toESM(require_dist(), 1);
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+var exists = (p) => stat(p).then(() => true, () => false);
+var firstLine = (e) => String(e.message ?? e).split("\n")[0];
+async function onboardingView(root) {
+  const rel = (p) => relative(root, p).split(sep).join("/");
+  const orgPack = orgPackDirOf(root);
+  const problems = [];
+  const manifests = [];
+  const listed = [];
+  const profiles = join(orgPack, "profiles");
+  const names = await readdir(profiles, { withFileTypes: true }).then((d) => d.filter((x) => x.isDirectory()).map((x) => x.name).sort(), () => []);
+  const seen = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    const path = join(profiles, name, "repos.manifest.yaml");
+    if (!await exists(path))
+      continue;
+    try {
+      const m = await loadManifest(path);
+      manifests.push({ platform: m.platform, path: rel(path), repos: m.repos.length });
+      for (const r of m.repos) {
+        const other = seen.get(r.id);
+        if (other) {
+          problems.push({ file: rel(path), message: `repo id ${r.id} is also in ${other}` });
+          continue;
+        }
+        seen.set(r.id, rel(path));
+        listed.push({
+          repo: {
+            id: r.id,
+            platform: m.platform,
+            type: r.type,
+            owner: r.owner,
+            manifest: rel(path),
+            // ADR 0128: what it is, in a person's words, or a draft waiting for one.
+            ...r.description ? { description: r.description } : {},
+            // ADR 0123: the branch the catalog is read from, and those scanned beside it.
+            defaultBranch: r.defaultBranch,
+            branches: r.branches
+          }
+        });
+      }
+    } catch (e) {
+      problems.push({ file: rel(path), message: firstLine(e) });
+    }
+  }
+  const catalog = await readCatalog(join(catalogDirOf(root), "generated"), { cacheRoot: root });
+  for (const p of catalog.problems)
+    problems.push({ file: rel(join(catalogDirOf(root), "generated", p.file)), message: p.message });
+  const scans = /* @__PURE__ */ new Map();
+  for (const r of catalog.records) {
+    const repos2 = new Set(r.evidence.map((e) => e.repo).filter((x) => !!x));
+    for (const repo of repos2) {
+      const s = scans.get(repo) ?? { records: 0, kinds: {} };
+      s.records += 1;
+      s.kinds[r.kind] = (s.kinds[r.kind] ?? 0) + 1;
+      for (const e of r.evidence) {
+        if (e.repo !== repo || !e.scannedAt)
+          continue;
+        if (!s.scannedAt || e.scannedAt > s.scannedAt) {
+          s.scannedAt = e.scannedAt;
+          if (e.commit)
+            s.commit = e.commit;
+        }
+      }
+      if (!s.commit) {
+        const c = r.evidence.find((e) => e.repo === repo && e.commit)?.commit;
+        if (c)
+          s.commit = c;
+      }
+      scans.set(repo, s);
+    }
+  }
+  const repos = [];
+  for (const { repo } of listed) {
+    const settings = join(orgPack, "scan", `${repo.id}.yaml`);
+    repos.push({
+      ...repo,
+      cloned: await exists(join(baseClonePath(root, repo.id), ".git")),
+      scanSettings: { path: rel(settings), present: await exists(settings) },
+      lastScan: scans.get(repo.id) ?? null
+    });
+  }
+  const sourcesFile = join(orgPack, "sources.yaml");
+  const sources = {
+    path: rel(sourcesFile),
+    present: await exists(sourcesFile),
+    wikis: [],
+    absorbed: []
+  };
+  if (sources.present) {
+    try {
+      const s = Sources.safeParse((0, import_yaml.parse)(await readFile(sourcesFile, "utf8")));
+      if (!s.success)
+        problems.push({
+          file: rel(sourcesFile),
+          message: s.error.issues.map((i) => `${i.path.map(String).join(".") || "(file)"}: ${i.message}`).join("; ")
+        });
+      else {
+        sources.wikis = s.data.wikis.map((w) => ({
+          id: w.id,
+          type: w.type,
+          location: w.location,
+          spaces: w.spaces,
+          ...w.owner ? { owner: w.owner } : {},
+          // 2.30.0 (ADR 0132): how much its word counts, and where it applies.
+          ...w.authority ? { authority: w.authority } : {},
+          ...w.appliesTo ? { scope: scopeWords(w.appliesTo) } : {}
+        }));
+        sources.absorbed = s.data.absorbed.map((a) => ({
+          id: a.id,
+          url: a.url,
+          format: a.format,
+          mode: a.mode
+        }));
+      }
+    } catch (e) {
+      problems.push({ file: rel(sourcesFile), message: `can't read YAML: ${firstLine(e)}` });
+    }
+  }
+  return {
+    manifests,
+    repos,
+    sources,
+    catalog: { records: catalog.records.length },
+    problems
+  };
+}
+function uiOnboardingRoutes(r, ctx) {
+  return r.add("GET", "/api/onboarding", async () => ({
+    status: 200,
+    body: await onboardingView(ctx.root)
+  }));
+}
+
+// packages/cli/dist/next-commands.js
 var METAREPO = "metarepo";
 var DRAFTING = ["feature", "architecture", "stories"];
 var draftingAt = (s) => DRAFTING.indexOf(s);
 var STALE_DAYS = 14;
 var plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
 async function verifyState(root, repo) {
-  const text = await readFile(join(proposalsDirOf(root), "scan", `${repo}.yaml`), "utf8").catch(() => void 0);
+  const text = await readFile2(join2(proposalsDirOf(root), "scan", `${repo}.yaml`), "utf8").catch(() => void 0);
   if (text === void 0)
     return "none";
-  const p = ScanVerifyProposal.safeParse((0, import_yaml.parse)(text));
+  const p = ScanVerifyProposal.safeParse((0, import_yaml2.parse)(text));
   if (!p.success)
     return "none";
   const s = p.data.settings;
@@ -139,10 +279,10 @@ async function verifyState(root, repo) {
   return "done";
 }
 async function staleOf(root, repo) {
-  const text = await readFile(join(factsDirOf(root), `${repo}.verify.yaml`), "utf8").catch(() => void 0);
+  const text = await readFile2(join2(factsDirOf(root), `${repo}.verify.yaml`), "utf8").catch(() => void 0);
   let facts;
   try {
-    const c = (0, import_yaml.parse)(text ?? "")?.commit;
+    const c = (0, import_yaml2.parse)(text ?? "")?.commit;
     if (typeof c === "string" && /^[0-9a-f]{7,64}$/.test(c))
       facts = c;
   } catch {
@@ -165,10 +305,10 @@ async function readNextState(root) {
   const view = await onboardingView(root);
   const problems = [...view.problems];
   const repos = [];
-  const factIds = (await readdir(factsDirOf(root)).catch(() => [])).map((n) => factsFileOf(n)).flatMap((f) => f?.facts ? [f.repo] : []);
-  const fromFacts = catalogSources((await readCatalog(join(catalogDirOf(root), "generated"), { cacheRoot: root })).records);
+  const factIds = (await readdir2(factsDirOf(root)).catch(() => [])).map((n) => factsFileOf(n)).flatMap((f) => f?.facts ? [f.repo] : []);
+  const fromFacts = catalogSources((await readCatalog(join2(catalogDirOf(root), "generated"), { cacheRoot: root })).records);
   for (const r of view.repos) {
-    const hasFacts = existsSync(join(factsDirOf(root), `${r.id}.jsonl`));
+    const hasFacts = existsSync(join2(factsDirOf(root), `${r.id}.jsonl`));
     const near = hasFacts ? [] : factIds.filter((x) => x !== r.id && repoIdKey(x) === repoIdKey(r.id)).sort().map((x) => ({ id: x, file: `${factsRelOf(root)}/${x}.jsonl` }));
     const spec = await readRepoSpec(root, r.id, { cacheRoot: root });
     problems.push(...spec.problems);
@@ -251,9 +391,9 @@ async function readNextState(root) {
     const names = new Set(op.profiles.flatMap((p) => (p.profile?.systems ?? []).flatMap((x) => [x.name, ...x.aliases])).map((n) => n.toLowerCase()));
     const missing = knowledge.items.filter((i) => (i.kind === "Product" && i.productKind === "product" || i.kind === "Party" && i.partyKind === "vendor" && !!i.quote) && ![i.name, ...i.aliases].some((n) => names.has(n.toLowerCase()))).length;
     let draft;
-    for (const f of await readdir(join(proposalsDirOf(root), "orgpack")).catch(() => []))
+    for (const f of await readdir2(join2(proposalsDirOf(root), "orgpack")).catch(() => []))
       if (f.endsWith(".yaml")) {
-        const d = (0, import_yaml.parse)(await readFile(join(proposalsDirOf(root), "orgpack", f), "utf8"));
+        const d = (0, import_yaml2.parse)(await readFile2(join2(proposalsDirOf(root), "orgpack", f), "utf8"));
         if (d?.platform && d.proposals?.length)
           draft = { platform: d.platform, proposals: d.proposals.length };
       }
@@ -273,8 +413,10 @@ async function readNextState(root) {
   try {
     for (const c of await changeStore(root).list()) {
       const clash = clashes.filter((x) => x.change === c.id).map(({ seed, repo, capability, flow }) => ({ seed, repo, capability, flow }));
-      const files = await readChangeFiles(join(changesDirOf(root), c.id)).catch(() => void 0);
-      const stagesDone = (await stageCompletion({ root, policy }, c)).filter((s) => s.state === "done").map((s) => s.stage);
+      const files = await readChangeFiles(join2(changesDirOf(root), c.id)).catch(() => void 0);
+      const completion = await stageCompletion({ root, policy }, c);
+      const stagesDone = completion.filter((s) => stageWorkDone(s.state)).map((s) => s.stage);
+      const byPerson = completion.find((s) => s.state === "person");
       const needs = await readNeeds(root, c.id);
       const open2 = needs?.needs.filter((n) => n.status === "open") ?? [];
       unverifiedNeeds += open2.filter((n) => {
@@ -304,8 +446,9 @@ async function readNextState(root) {
           const run = t.done ? void 0 : (await readTaskRun(root, c.id, t.id).catch(() => void 0))?.state;
           return { id: t.id, repo: t.repo, done: t.done, ...run ? { run } : {} };
         })) : [],
-        feature: existsSync(join(changesDirOf(root), c.id, "feature.yaml")),
+        feature: existsSync(join2(changesDirOf(root), c.id, "feature.yaml")),
         ...missing.draft ? { undrafted: true } : {},
+        ...byPerson ? { byPerson: { stage: byPerson.stage, files: byPerson.files ?? [] } } : {},
         ...blocking ? { blocking } : {},
         ...gate.length ? { gate } : {},
         ...c.state === "released" ? await releasedOf(root, c.id) : {},
@@ -327,7 +470,7 @@ async function readNextState(root) {
         ...clash.length ? { seedCollisions: clash } : {},
         ...await isFast(root, c, types) ? {
           fast: true,
-          .../^state: done$/m.test(await readFile(join(changesDirOf(root), c.id, "stage", "small.yaml"), "utf8").catch(() => "")) ? { fastDone: true } : {}
+          .../^state: done$/m.test(await readFile2(join2(changesDirOf(root), c.id, "stage", "small.yaml"), "utf8").catch(() => "")) ? { fastDone: true } : {}
         } : {},
         ...needs ? {
           needs: {
@@ -356,12 +499,12 @@ async function readNextState(root) {
 }
 var UNDER_WAY = /* @__PURE__ */ new Set(["drafting", "waiting", "questions", "stopped"]);
 async function stageInProgress(root, change) {
-  const dir = join(changesDirOf(root), change, "stage");
+  const dir = join2(changesDirOf(root), change, "stage");
   let newest;
-  for (const f of (await readdir(dir).catch(() => [])).filter((x) => x.endsWith(".yaml"))) {
-    const loop = await readFile(join(dir, f), "utf8").then((t) => {
+  for (const f of (await readdir2(dir).catch(() => [])).filter((x) => x.endsWith(".yaml"))) {
+    const loop = await readFile2(join2(dir, f), "utf8").then((t) => {
       try {
-        return (0, import_yaml.parse)(t);
+        return (0, import_yaml2.parse)(t);
       } catch {
         return null;
       }
@@ -373,11 +516,11 @@ async function stageInProgress(root, change) {
   return newest;
 }
 async function loopState(root, change, stage) {
-  const t = await readFile(join(changesDirOf(root), change, "stage", `${stage}.yaml`), "utf8").catch(() => void 0);
+  const t = await readFile2(join2(changesDirOf(root), change, "stage", `${stage}.yaml`), "utf8").catch(() => void 0);
   if (t === void 0)
     return void 0;
   try {
-    const s = (0, import_yaml.parse)(t)?.state;
+    const s = (0, import_yaml2.parse)(t)?.state;
     return typeof s === "string" ? s : void 0;
   } catch {
     return void 0;
@@ -386,10 +529,10 @@ async function loopState(root, change, stage) {
 async function stageQuestions(root, change, open) {
   const out = [];
   for (const s of DRAFTING) {
-    const t = await readFile(join(changesDirOf(root), change, "stage", `${s}.yaml`), "utf8").catch(() => "");
+    const t = await readFile2(join2(changesDirOf(root), change, "stage", `${s}.yaml`), "utf8").catch(() => "");
     let y;
     try {
-      y = (0, import_yaml.parse)(t);
+      y = (0, import_yaml2.parse)(t);
     } catch {
       continue;
     }
@@ -405,7 +548,7 @@ async function isFast(root, c, types) {
   const type = types.find((t) => t.id === c.type);
   if (!type || type.size !== "small" && !type.smallWhenBriefSays)
     return false;
-  const brief = await readFile(join(changesDirOf(root), c.id, "brief.md"), "utf8").catch(() => "");
+  const brief = await readFile2(join2(changesDirOf(root), c.id, "brief.md"), "utf8").catch(() => "");
   return fastPathOf(type, brief).fast;
 }
 async function draftMissing(ctx, c) {
@@ -462,7 +605,7 @@ function gateBlockedStep(c, stage, gate) {
 }
 async function releasedOf(root, id) {
   try {
-    const { archiveGate } = await import("./chunk-F4WKGX7K.js");
+    const { archiveGate } = await import("./chunk-KKUCBKJE.js");
     const g = await archiveGate(root, id);
     return {
       released: { blockers: g.blockers.map((b) => ({ code: b.code, message: b.message })) }
@@ -745,7 +888,7 @@ function stageSteps(c) {
         step: "handoff",
         command: `atticus change handoff ${id} --approve`,
         where: METAREPO,
-        why: `${id}'s ${stage} stage is done${later.length ? ` (and ${later.join(" and ")} ran ahead)` : ""}, but the change is still in ${c.state}: a person raises its ${gate} hand-off PR, and merging it approves the ${gate} gate and moves it on (ADR 0073).`,
+        why: `${c.byPerson?.stage === stage ? `${id}'s ${c.byPerson.files.join(" and ")} ${c.byPerson.files.length === 1 ? "is" : "are"} written by a person (the ${stage} stage never ran)` : `${id}'s ${stage} stage is done`}${later.length ? ` (and ${later.join(" and ")} ran ahead)` : ""}, but the change is still in ${c.state}: a person raises its ${gate} hand-off PR, and merging it approves the ${gate} gate and moves it on (ADR 0073).`,
         change: id,
         person: true
       }
@@ -1209,6 +1352,7 @@ function queueOut(s, o, io) {
 }
 
 export {
+  uiOnboardingRoutes,
   readNextState,
   changeSteps,
   nextSteps,

package/dist/{chunk-XC5ZDFW7.js → chunk-Z4GLFTEH.js}

@@ -3,33 +3,33 @@ 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 {
-  doctorChecks
-} from "./chunk-F36DIKJ3.js";
 import {
   buildSite,
   catalogRecords,
   openChanges
-} from "./chunk-N3OEBQTA.js";
+} from "./chunk-CDC6VECU.js";
+import {
+  doctorChecks
+} from "./chunk-2666BPJE.js";
 import {
   readProbes,
   whatRunsWhere
-} from "./chunk-H7GAPNGQ.js";
+} from "./chunk-G33UIUG3.js";
 import {
   baseClonePath,
   loadRepos
-} from "./chunk-WS7KBKP4.js";
+} from "./chunk-X5B7KYPD.js";
 import {
   catalogDirOf,
   inputsDirOf,
   orgPackDirOf
-} from "./chunk-GLISHJ4G.js";
+} from "./chunk-WJWSB65O.js";
 import {
   CatalogBaseline,
   DEFAULT_RUNTIME,
   WORKSPACE_SCHEMA_VERSION,
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";