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

package/dist/{chunk-ZX7235KR.js → chunk-ZR6J4QFQ.js}

@@ -3,63 +3,42 @@ 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 {
-  generateTests,
-  matrixCsv,
-  matrixMarkdown,
-  traceMatrix,
-  writeTraceFindings
-} from "./chunk-EZIN5E5B.js";
-import {
-  table
-} from "./chunk-VOGCSYOI.js";
 import {
   readChangeFiles,
   readDataChanges,
   readHops,
   reviewedGates
-} from "./chunk-K332XW7K.js";
+} from "./chunk-D6BVLTDV.js";
 import {
   assess,
   changeFolder,
   changeStore,
   checkFindings,
   loadChangeContext,
-  nothingToRelease
-} from "./chunk-HSZMPH5T.js";
+  nothingToRelease,
+  staleReleasePrs
+} from "./chunk-WZYM5M4U.js";
 import {
-  GlossaryError,
-  aliasDecision,
-  completeGlossaryDefinitions,
-  defineDecision,
-  linkDecision,
-  loadGlossary,
-  readCatalog,
-  resolveTermId,
-  scanGlossary,
-  writeDecisions
-} from "./chunk-4SLBCEPD.js";
+  readCatalog
+} from "./chunk-IKAW2KJU.js";
 import {
   BUILT_IN_EXTRACTORS,
   SHIPPED_DIALECTS_DIR,
   dialectExtractor,
   loadShippedDialects,
   runDialectTests
-} from "./chunk-TWQRPM76.js";
+} from "./chunk-G6EFXTUO.js";
+import {
+  DEFAULT_IGNORES,
+  fsRepo,
+  scanRepo
+} from "./chunk-PQQKZPBU.js";
 import {
   baseClonePath,
   checkoutState,
   createGit,
   readChangeRepos
-} from "./chunk-XOL3GFW2.js";
-import {
-  runtimeForCli
-} from "./chunk-QHJJMZLX.js";
-import {
-  DEFAULT_IGNORES,
-  fsRepo,
-  scanRepo
-} from "./chunk-7AB6OWTV.js";
+} from "./chunk-3EWKO457.js";
 import {
   catalogDirOf,
   effectiveComponentTypes,
@@ -69,17 +48,15 @@ import {
   mergeCatalog,
   normalizePath,
   orgPackDirOf,
-  parseFacts,
+  parseFacts
+} from "./chunk-FPBUTZI5.js";
+import {
   require_dist
-} from "./chunk-PAINMSID.js";
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
 
-// packages/cli/dist/quality-commands.js
-import { appendFile, mkdir, writeFile } from "node:fs/promises";
-import { dirname, join as join4 } from "node:path";
-
 // packages/ci/dist/config.js
 var import_yaml = __toESM(require_dist(), 1);
 import { readFile } from "node:fs/promises";
@@ -663,17 +640,17 @@ function driftMarkdown(r) {
   const n = r.items.filter((i) => i.kind !== "planned").length;
   const planned = r.counts.planned;
   const head = !r.drift ? `No drift: ${r.repo} matches the catalog${planned ? ` (${planned} planned by approved changes)` : ""}.` : `${n} drift ${n === 1 ? "finding" : "findings"} in ${r.repo}${r.mode === "warn" ? " (warn-only: the pipeline passes)" : ""}.`;
-  const lines2 = [`## Atticus drift check: ${r.repo}`, "", head];
+  const lines = [`## Atticus drift check: ${r.repo}`, "", head];
   if (r.items.length) {
-    lines2.push("", "| What | Kind | Id | Details |", "| --- | --- | --- | --- |");
+    lines.push("", "| What | Kind | Id | Details |", "| --- | --- | --- | --- |");
     for (const i of r.items)
-      lines2.push(`| ${KIND_WORD[i.kind]} | ${i.subject} | ${cell(i.id)} | ${cell(i.summary)}${where(i).length ? ` (${where(i).join(", ")})` : ""} |`);
+      lines.push(`| ${KIND_WORD[i.kind]} | ${i.subject} | ${cell(i.id)} | ${cell(i.summary)}${where(i).length ? ` (${where(i).join(", ")})` : ""} |`);
   }
   if (r.drift && r.mode === "block")
-    lines2.push("", "Fix the code, or record the change in the catalog: plan it in an approved change's design, or rescan the estate once it is merged.");
+    lines.push("", "Fix the code, or record the change in the catalog: plan it in an approved change's design, or rescan the estate once it is merged.");
   if (r.problems.length)
-    lines2.push("", "Problems:", ...r.problems.map((p) => `- ${p}`));
-  return `${lines2.join("\n")}
+    lines.push("", "Problems:", ...r.problems.map((p) => `- ${p}`));
+  return `${lines.join("\n")}
 `;
 }
 
@@ -868,6 +845,7 @@ async function archiveGate(root, changeId, o = {}) {
   const repos = (await readChangeRepos(root, change.id))?.repos ?? [];
   const mustMerge = config.archive.requireMergedPrs;
   const nothing = await nothingToRelease(root, change.id, o.git ? { git: o.git } : {});
+  const stale = await staleReleasePrs(root, change.id, o.git ? { git: o.git } : {});
   for (const r of repos) {
     if (!r.pr && nothing.has(r.id))
       continue;
@@ -881,6 +859,11 @@ async function archiveGate(root, changeId, o = {}) {
         code: "pr-open",
         message: `${r.id}: release PR #${r.pr.number} is ${r.pr.state}; a person merges it on the Git host before archiving.`
       });
+    else if (mustMerge && r.pr?.state === "merged" && stale.has(r.id))
+      blockers.push({
+        code: "release-pr-stale",
+        message: `${r.id}: the change branch moved past release PR #${r.pr.number} after it merged, so the newer work isn't in ${r.base}: raise the release PRs again (atticus change release-prs ${change.id} --approve) and merge the new one.`
+      });
     if (r.build.status === "failed")
       blockers.push({
         code: "build-failed",
@@ -980,342 +963,20 @@ async function archiveGate(root, changeId, o = {}) {
   };
 }
 
-// packages/cli/dist/quality-commands.js
-var KNOWN = /* @__PURE__ */ new Set([
-  "TestgenError",
-  "PlannerError",
-  "ChangeError",
-  "ChangeFileError",
-  "GlossaryError",
-  "RuntimeConfigError"
-]);
-function fail(io, e) {
-  if (e instanceof Error && KNOWN.has(e.name)) {
-    io.err(e.message);
-    return e.code === "invalid" ? 2 : 1;
-  }
-  throw e;
-}
-var iso = (d) => d.toISOString().replace(/\.\d{3}Z$/, "Z");
-var lines = (io, text) => {
-  for (const l of text.trimEnd().split("\n"))
-    io.out(l);
-};
-var plural2 = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
-async function runtimeOf(root, mode, deps) {
-  if (deps.runtime)
-    return deps.runtime;
-  if (!mode && !process.env.ATTICUS_RUNTIME)
-    return void 0;
-  return (await runtimeForCli(root, mode ? { mode } : {})).runtime;
-}
-async function testsGenerate(root, changeId, storyId, o, io, deps = {}) {
-  if (!changeId || !storyId) {
-    io.err("Usage: atticus tests generate <change> <story> [--framework <id>] [--force] [--check] [--mode <mode>] [--json]");
-    return 2;
-  }
-  try {
-    const runtime = await runtimeOf(root, o.mode, deps);
-    const r = await generateTests(root, changeId, storyId, {
-      ...o.framework ? { framework: o.framework } : {},
-      ...o.force ? { force: true } : {},
-      ...o.check ? { check: true } : {},
-      ...o.resume ? { resume: o.resume } : {},
-      ...runtime ? { runtime } : {},
-      now: deps.now?.() ?? /* @__PURE__ */ new Date()
-    });
-    const kept = r.files.filter((f) => f.action === "kept-edited" || f.action === "kept-not-generated");
-    if (o.json) {
-      io.out(JSON.stringify({
-        change: r.change,
-        story: r.story,
-        strategy: r.model.strategy,
-        kinds: r.model.kinds,
-        names: r.names.by,
-        ...r.names.waiting ? { waiting: r.names.waiting } : {},
-        files: r.files,
-        manifest: r.manifest,
-        notes: r.notes,
-        gaps: r.gaps
-      }, null, 2));
-      return kept.length ? 1 : 0;
-    }
-    const count = (a) => r.files.filter((f) => f.action === a).length;
-    const cases = r.model.repos.reduce((n, x) => n + x.cases.length, 0);
-    io.out(`${o.check ? "Would write" : "Generated"} ${plural2(cases, "test case")} for ${r.story} in ${plural2(r.files.length, "file")}: ${count("created")} new, ${count("updated")} updated, ${count("unchanged")} unchanged${kept.length ? `, ${kept.length} kept` : ""}.`);
-    for (const l of table(["ACTION", "REPO", "FRAMEWORK", "FILE"], r.files.map((f) => [f.action, f.repo || "-", f.generator, f.path])))
-      io.out(l);
-    for (const k of r.model.kinds.filter((x) => !x.generated))
-      io.out(`No ${k.type} tests: ${k.why}`);
-    for (const n of r.notes)
-      io.out(n);
-    for (const g of r.gaps)
-      io.out(`Gap: ${g}`);
-    if (r.names.waiting)
-      io.out(`The test writer is with your assistant (run ${r.names.waiting}); the files use plain names until you run: atticus tests generate ${changeId} ${storyId} --resume ${r.names.waiting}`);
-    if (!o.check)
-      io.out(`Manifest: ${r.manifest}`);
-    return kept.length ? 1 : 0;
-  } catch (e) {
-    return fail(io, e);
-  }
-}
-async function traceCommand(root, changeId, o, io, deps = {}) {
-  if (!changeId) {
-    io.err("Usage: atticus trace <change> [--json | --csv] [--no-write]");
-    return 2;
-  }
-  try {
-    const m = await traceMatrix(root, changeId, { git: deps.git ?? createGit() });
-    for (const p of m.problems)
-      io.err(p);
-    const w = o.write === false ? void 0 : await writeTraceFindings(root, m, iso(deps.now?.() ?? /* @__PURE__ */ new Date()));
-    if (o.json)
-      io.out(JSON.stringify({ ...m, ...w ? { round: w.round ?? null } : {} }, null, 2));
-    else if (o.csv)
-      lines(io, matrixCsv(m));
-    else {
-      lines(io, matrixMarkdown(m));
-      if (w)
-        io.out(w.unchanged ? `Findings on the trace gate are unchanged (round ${w.round ?? "none"}).` : `Wrote ${plural2(w.findings.length, "finding")} to review/trace/${w.round}/.`);
-    }
-    return m.gaps.some((g) => g.kind !== "test-without-requirement") ? 1 : 0;
-  } catch (e) {
-    return fail(io, e);
-  }
-}
-async function ciDrift(repoDir, o, io, deps = {}) {
-  if (!o.catalog) {
-    io.err("Usage: atticus ci drift [repo-dir] --catalog <metarepo or catalog folder> [--repo <id>] [--json [file]] [--junit <file>] [--summary <file>] [--warn-only]");
-    return 2;
-  }
-  try {
-    const r = await repoDrift({
-      repoDir,
-      catalog: o.catalog,
-      ...o.repo ? { repo: o.repo } : {},
-      ...o.warnOnly ? { warnOnly: true } : {},
-      ...deps.commit ? { commit: deps.commit } : {},
-      ...deps.git ? { git: deps.git } : {}
-    });
-    const put = async (file, text) => {
-      await mkdir(dirname(file), { recursive: true });
-      await writeFile(file, text, "utf8");
-    };
-    if (typeof o.json === "string")
-      await put(o.json, driftJson(r));
-    if (o.junit)
-      await put(o.junit, driftJUnit(r));
-    if (o.summary) {
-      await mkdir(dirname(o.summary), { recursive: true });
-      await appendFile(o.summary, driftMarkdown(r), "utf8");
-    }
-    if (o.json === true)
-      io.out(driftJson(r).trimEnd());
-    else
-      lines(io, driftMarkdown(r));
-    return driftExitCode(r);
-  } catch (e) {
-    if (e instanceof DriftError) {
-      io.err(e.message);
-      return 2;
-    }
-    throw e;
-  }
-}
-async function ciSnippet(kind, io, o = {}) {
-  const s = kind ? pipelineSnippet(kind) : void 0;
-  if (!s) {
-    io.err(`Usage: atticus ci snippet <${SNIPPET_KINDS.join("|")}> [--write <repo-dir>]`);
-    return 2;
-  }
-  if (o.write) {
-    const file = join4(o.write, ...s.path.split("/"));
-    await mkdir(dirname(file), { recursive: true });
-    await writeFile(file, s.content, "utf8");
-    io.out(`Wrote ${s.path}. Set the variables its first lines name, then commit it.`);
-    return 0;
-  }
-  lines(io, s.content);
-  return 0;
-}
-async function ciArchiveGate(root, changeId, o, io, deps = {}) {
-  if (!changeId) {
-    io.err("Usage: atticus ci archive-gate <change> [--drift <report.json>...] [--json]");
-    return 2;
-  }
-  let r;
-  try {
-    r = await archiveGate(root, changeId, {
-      ...o.drift?.length ? { driftReports: o.drift } : {},
-      ...deps.commit ? { commit: deps.commit } : {}
-    });
-  } catch (e) {
-    if (e instanceof Error && e.name === "ChangeFileError") {
-      io.err(e.message);
-      return 2;
-    }
-    throw e;
-  }
-  if (o.json)
-    io.out(JSON.stringify(r, null, 2));
-  else {
-    io.out(r.pass ? `${changeId} may be archived: no blockers, its release PRs merged and built, and the catalog says what shipped.` : `${changeId} can't be archived yet (${plural2(r.blockers.length, "blocker")}):`);
-    for (const b of r.blockers)
-      io.out(`- ${b.message}`);
-    for (const n of r.notes)
-      io.out(n);
-  }
-  return r.pass ? 0 : 1;
-}
-var short2 = (s, n = 70) => s.length <= n ? s : `${s.slice(0, n - 3)}...`;
-var sourceOf = (flags, confidence) => confidence === "asserted" ? "person" : flags?.includes("ai-proposed") ? "ai" : flags?.includes("undefined") ? "code" : "wiki";
-async function glossaryList(root, o, io) {
-  const g = await loadGlossary(root);
-  for (const p of g.problems)
-    io.err(p);
-  if (o.json) {
-    io.out(JSON.stringify({
-      terms: g.terms,
-      conflicts: g.build.conflicts,
-      hints: g.build.hints,
-      synonyms: Object.fromEntries(g.build.entries.filter((e) => e.aliases.length).map((e) => [e.id, e.aliases]))
-    }, null, 2));
-    return 0;
-  }
-  if (!g.terms.length) {
-    io.out("The glossary is empty: no wiki page defines a term and the catalog has no domain words yet.");
-    return 0;
-  }
-  for (const l of table(["TERM", "ID", "FROM", "FLAGS", "DEFINITION"], g.terms.map((t) => [
-    t.term,
-    t.id,
-    sourceOf(t.flags, t.confidence),
-    (t.flags ?? []).join(","),
-    short2(t.definition)
-  ])))
-    io.out(l);
-  io.out(`${plural2(g.terms.length, "term")}, ${plural2(g.build.conflicts.filter((c) => !c.resolved).length, "conflict")}.`);
-  return 0;
-}
-async function glossaryScan(root, o, io, deps = {}) {
-  try {
-    const runtime = await runtimeOf(root, o.mode, deps);
-    const r = await scanGlossary(root, {
-      ...runtime ? { runtime } : {},
-      ...deps.now ? { now: deps.now() } : {}
-    });
-    if (o.json) {
-      for (const p of r.problems)
-        io.err(p);
-      io.out(JSON.stringify({
-        terms: r.terms.length,
-        written: r.written,
-        removed: r.removed,
-        conflicts: r.build.conflicts,
-        hints: r.build.hints,
-        ...r.propose ? { proposals: r.propose.proposals.length, discarded: r.propose.discarded } : {}
-      }, null, 2));
-      return 0;
-    }
-    printGlossaryScan(r, io);
-    return 0;
-  } catch (e) {
-    return fail(io, e);
-  }
-}
-function printGlossaryScan(r, io) {
-  for (const p of r.problems)
-    io.err(p);
-  const open = r.build.conflicts.filter((c) => !c.resolved);
-  io.out(`The glossary has ${plural2(r.terms.length, "term")}; ${plural2(r.written.length, "file")} written and ${plural2(r.removed.length, "file")} removed in catalog/generated.`);
-  if (r.propose)
-    io.out(r.propose.waiting ? `The glossary definer is with your assistant (run ${r.propose.waiting}). When it is done, run: atticus handoff done ${r.propose.waiting}` : `The glossary definer proposed ${plural2(r.propose.proposals.length, "definition")} (kept inferred until a person defines the term).`);
-  for (const d of r.propose?.discarded ?? [])
-    if (d.term && !r.propose?.waiting)
-      io.err(`Discarded ${d.term}: ${d.reason}`);
-  for (const c of open)
-    io.out(`Conflict: ${c.message}`);
-  for (const h of r.build.hints)
-    io.out(`Naming: ${h.message}`);
-}
-async function completeGlossaryScan(root, run, io, deps = {}) {
-  try {
-    const r = await completeGlossaryDefinitions(root, run, deps.now ? { now: deps.now } : {});
-    printGlossaryScan(r, io);
-    return 0;
-  } catch (e) {
-    return fail(io, e);
-  }
-}
-async function decide(root, io, make, said) {
-  try {
-    const g = await loadGlossary(root);
-    const ds = make(g);
-    const files = await writeDecisions(join4(g.catalogDir, "curated"), ds);
-    await scanGlossary(root);
-    io.out(`Wrote ${files.map((f) => `catalog/curated/${f}`).join(" and ")}: ${said}. Commit it so every scan keeps it.`);
-    return 0;
-  } catch (e) {
-    if (e instanceof GlossaryError) {
-      io.err(e.message);
-      return e.code === "invalid" ? 2 : 1;
-    }
-    throw e;
-  }
-}
-async function glossaryDefine(root, term, definition, o, io) {
-  if (!term || !definition || !o.by) {
-    io.err('Usage: atticus glossary define <term> "<definition>" [--by <handle>] [--owner <team>]');
-    return 2;
-  }
-  return decide(root, io, (g) => {
-    const existing = g.terms.find((t) => t.id === resolveTermId(term));
-    return [
-      defineDecision(term, definition, {
-        by: o.by,
-        ...o.owner ? { owner: o.owner } : {},
-        ...existing ? { existing } : {}
-      })
-    ];
-  }, `${resolveTermId(term)} is defined and asserted`);
-}
-async function glossaryLink(root, term, recordId, o, io) {
-  if (!term || !recordId || !o.by) {
-    io.err("Usage: atticus glossary link <term> <record-id | schema#field> [--by <handle>]");
-    return 2;
-  }
-  return decide(root, io, (g) => {
-    const id = resolveTermId(term);
-    const t = g.terms.find((x) => x.id === id);
-    if (!t)
-      throw new GlossaryError("not-found", `There is no term ${id}. Define it first: atticus glossary define`);
-    return [linkDecision(t, recordId, g.base, { by: o.by })];
-  }, `${recordId} is linked to ${resolveTermId(term)}`);
-}
-async function glossaryAlias(root, term, names, o, io) {
-  if (!term || !names.length || !o.by) {
-    io.err('Usage: atticus glossary alias <term> "<other name>"... [--by <handle>]');
-    return 2;
-  }
-  return decide(root, io, (g) => {
-    const id = resolveTermId(term);
-    const before = g.build.entries.find((e) => e.id === id)?.aliases ?? [];
-    return [aliasDecision(id, [...before, ...names], { by: o.by })];
-  }, `${names.join(", ")} ${names.length === 1 ? "is another name" : "are other names"} for ${resolveTermId(term)}`);
-}
-
 export {
-  archiveGate,
-  testsGenerate,
-  traceCommand,
-  ciDrift,
-  ciSnippet,
-  ciArchiveGate,
-  glossaryList,
-  glossaryScan,
-  completeGlossaryScan,
-  glossaryDefine,
-  glossaryLink,
-  glossaryAlias
+  CiConfig,
+  DEFAULT_CI_CONFIG,
+  loadCiConfig,
+  ignored,
+  DRIFT_SCHEMA_VERSION,
+  DriftError,
+  resolveCatalog,
+  repoDrift,
+  driftExitCode,
+  driftJson,
+  driftJUnit,
+  driftMarkdown,
+  SNIPPET_KINDS,
+  pipelineSnippet,
+  archiveGate
 };

package/dist/{chunk-F6H2RJ3N.js → chunk-ZSNOILL5.js}

@@ -5,7 +5,7 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   runtimeForCli
-} from "./chunk-QHJJMZLX.js";
+} from "./chunk-3424TLIJ.js";
 
 // packages/cli/dist/judging.js
 async function judgingRuntime(root, given) {