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

package/dist/{chunk-G2B4ZQGH.js → chunk-7IOWA5D5.js}

@@ -3,16 +3,21 @@ 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 {
+  appendLines
+} from "./chunk-S7FCV7S5.js";
 import {
   api_exports,
   changesDirOf,
-  orgPackDirOf,
-  require_dist
-} from "./chunk-S2A7YC3Q.js";
+  orgPackDirOf
+} from "./chunk-Q2TECDIT.js";
 import {
   ensureLocalIgnore,
   redactText
-} from "./chunk-D3PO4DOZ.js";
+} from "./chunk-TUULXQRW.js";
+import {
+  require_dist
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -21,7 +26,7 @@ import {
 var import_yaml = __toESM(require_dist(), 1);
 import { randomBytes } from "node:crypto";
 import { existsSync } from "node:fs";
-import { appendFile, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 var historyDirOf = (root) => join(root, ".atticus", "history");
 var ME = (root) => join(root, ".atticus", "me.yaml");
@@ -128,7 +133,7 @@ async function addHistory(root, i) {
   }
   await mkdir(dir, { recursive: true });
   await ensureLocalIgnore(root);
-  await appendFile(file, JSON.stringify(record) + "\n", "utf8");
+  await appendLines(file, [JSON.stringify(record)]);
   return { record };
 }
 async function readLines(file) {

package/dist/{chunk-EBEW3XXQ.js → chunk-7JITZFJC.js}

@@ -5,20 +5,22 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   readCatalog
-} from "./chunk-27NKUS3X.js";
+} from "./chunk-J2JAKCIW.js";
 import {
   scopeWords
-} from "./chunk-L24C55VN.js";
+} from "./chunk-745DAZ4L.js";
 import {
   baseClonePath,
   loadManifest
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-PKBHS4AA.js";
 import {
   Sources,
   catalogDirOf,
-  orgPackDirOf,
+  orgPackDirOf
+} from "./chunk-Q2TECDIT.js";
+import {
   require_dist
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/chunk-7MJSQTL5.js

@@ -0,0 +1,174 @@
+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 {
+  targetFlowsOf
+} from "./chunk-IH2XURVQ.js";
+import "./chunk-OHNCWBKF.js";
+import {
+  MAX_CHAIN_DEPTH,
+  changeImpact,
+  loadEstate
+} from "./chunk-R7NYHMUU.js";
+import "./chunk-IVBOQAGB.js";
+import "./chunk-ISUAAMGS.js";
+import "./chunk-S4PMJU6H.js";
+import "./chunk-IDKCWSM5.js";
+import "./chunk-UUU4CLJG.js";
+import "./chunk-7IGKHZ4Z.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import {
+  loadRepos
+} from "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import {
+  readTeams
+} from "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/change-impact.js
+var CHANGE_IMPACT_WORDS = {
+  usage: "Name the change: atticus change impact <change> [--json]",
+  noChange: (id) => `There is no change ${id}: atticus change list shows them.`,
+  noTargets: (id) => `${id} has no target flows yet, so there is nothing to weigh: run atticus change architecture ${id} first.`,
+  nothing: (id) => `${id}'s target flows break nothing the map shows: no entry or table they change loses a field, a caller or its type.`,
+  counts: (id, i) => `${id}: ${n(i.breaks, "caller")} ${i.breaks === 1 ? "breaks" : "break"}, ${n(i.mayBreak, "caller")} may break (link guessed), ${n(i.routes, "gateway route")} to update.`,
+  upstream: (u) => `Up the chain (who calls the callers): ${u.breaks} more ${u.breaks === 1 ? "breaks" : "break"}, ${u.mayBreak} may break (resting on a guessed link).`,
+  hopBreaks: (depth, via, who, owner, where) => `${"  ".repeat(depth)}Breaks via ${via}: ${who}, owned by ${owner}${where ? `; ${where}` : ""}.`,
+  hopMayBreak: (depth, via, who, owner, rests, where) => `${"  ".repeat(depth)}May break via ${via} (${rests}): ${who}, owned by ${owner}${where ? `; ${where}` : ""}. Not counted as a break.`,
+  restsOwn: (how) => `its own link guessed ${how}`,
+  restsOn: (who, how) => `rests on ${who}'s link, guessed ${how}`,
+  capped: (depth) => `  The walk up the chain stops at ${depth} hops; more callers are above the last ones listed.`,
+  item: (name, where, owner, why) => `${name} (${where}), owned by ${owner}: ${why.join("; ")}.`,
+  gone: (fields) => `  Stops crossing: ${fields.join(", ")}.`,
+  required: (fields) => `  Callers must now send: ${fields.join(", ")}.`,
+  breaks: (who, owner, where) => `  Breaks: ${who}, owned by ${owner}${where ? `; ${where}` : ""}.`,
+  mayBreak: (who, owner, how, where) => `  May break (link guessed ${how}): ${who}, owned by ${owner}${where ? `; ${where}` : ""}. Not counted as a break until someone confirms the link.`,
+  confirm: (rule, id) => `  The critic's ${rule} asks the caller's owner to confirm each guessed link: atticus critic ${id}.`,
+  nobody: "  The map shows nobody calling or using it.",
+  route: (id, what, owner, callers) => `  Gateway route to update: ${id}${what}, owned by ${owner}; ${callers.join(", ")} ${callers.length === 1 ? "calls" : "call"} through it.`,
+  teams: "Teams to involve:",
+  team: (owner, repos) => `  ${owner}: ${repos.join(", ")}`,
+  problem: (p) => `Note: ${p}`
+};
+var GUESS_WORDS = {
+  "joined-by-path": "by path",
+  "joined-by-label": "by a host's first label",
+  "joined-by-platform-setting": "by a platform-wide setting",
+  "joined-by-folder-name": "by a setting's folder name",
+  "joined-despite-conflict": "despite an open host conflict",
+  "joined-by-service-name": "by a Service's short name"
+};
+function n(count, what) {
+  return `${count} ${what}${count === 1 ? "" : "s"}`;
+}
+function ownerText(o) {
+  if ("none" in o)
+    return `no team (${o.none})`;
+  return o.name ? `${o.team} (${o.name})` : o.team;
+}
+async function changeImpactOf(root, change) {
+  const t = await targetFlowsOf(root, change);
+  if (!t)
+    return void 0;
+  const problems = [...t.problems];
+  const owners = /* @__PURE__ */ new Map();
+  try {
+    for (const r of await loadRepos(root))
+      owners.set(r.id, r.owner);
+  } catch (e) {
+    problems.push(`the repo manifests: ${e.message.split("\n")[0]}`);
+  }
+  const read = await readTeams(root);
+  const teams = read.teams;
+  if (read.problem)
+    problems.push(read.problem);
+  const impact = changeImpact(change, t.deltas, await loadEstate(root, t.records), {
+    owners,
+    teams
+  });
+  return { ...impact, flows: t.deltas.length, problems };
+}
+function impactLines(i) {
+  const W = CHANGE_IMPACT_WORDS;
+  if (!i.flows)
+    return [W.noTargets(i.change), ...i.problems.map(W.problem)];
+  if (!i.items.length)
+    return [W.nothing(i.change), ...i.problems.map(W.problem)];
+  const out = [W.counts(i.change, i)];
+  if (i.upstream && (i.upstream.breaks || i.upstream.mayBreak))
+    out.push(W.upstream(i.upstream));
+  for (const it of i.items) {
+    out.push(W.item(it.name, it.kind === "table" ? `a table ${it.flow} writes` : it.flow, ownerText(it.owner), it.why));
+    if (it.fields.gone.length)
+      out.push(W.gone(it.fields.gone));
+    if (it.fields.required.length)
+      out.push(W.required(it.fields.required));
+    if (!it.callers.length)
+      out.push(W.nobody);
+    for (const c of it.callers) {
+      const where = [
+        ...c.at.map((a) => `at ${a}`),
+        ...c.flows.map((f) => `its flow ${f}`),
+        ...c.routes.map((r) => `through ${r}`)
+      ].join(", ");
+      out.push(c.verdict === "breaks" ? W.breaks(c.component, ownerText(c.owner), where) : W.mayBreak(c.component, ownerText(c.owner), GUESS_WORDS[c.guessed ?? ""] ?? "", where));
+    }
+    for (const h of it.chain ?? []) {
+      const via = `${h.via.join(", ")}${h.entries.length ? ` (${h.entries.join(", ")})` : ""}`;
+      const where = [
+        ...h.at.map((a) => `at ${a}`),
+        ...h.flows.map((f) => `its flow ${f}`),
+        ...h.routes.map((r) => `through ${r}`)
+      ].join(", ");
+      const how = GUESS_WORDS[h.guessed ?? ""] ?? "";
+      out.push(h.verdict === "breaks" ? W.hopBreaks(h.depth, via, h.component, ownerText(h.owner), where) : W.hopMayBreak(h.depth, via, h.component, ownerText(h.owner), h.restsOn ? W.restsOn(h.restsOn, how) : W.restsOwn(how), where));
+    }
+    if (it.capped)
+      out.push(W.capped(MAX_CHAIN_DEPTH));
+    if ([...it.callers, ...it.chain ?? []].some((c) => c.verdict === "may-break"))
+      out.push(W.confirm(i.rule, i.change));
+    for (const r of it.routes) {
+      const what = [r.proxy, r.basepath, r.repo ? `in ${r.repo}` : void 0].filter(Boolean).join(", ");
+      out.push(W.route(r.id, what ? ` (${what})` : "", ownerText(r.owner), r.callers));
+    }
+  }
+  out.push(W.teams, ...i.owners.map((o) => W.team(ownerText(o.owner), o.repos)));
+  out.push(...i.problems.map(W.problem));
+  return out;
+}
+async function changeImpactCli(root, change, o, io) {
+  if (!change) {
+    io.err(CHANGE_IMPACT_WORDS.usage);
+    return 2;
+  }
+  const i = await changeImpactOf(root, change);
+  if (!i) {
+    io.err(CHANGE_IMPACT_WORDS.noChange(change));
+    return 1;
+  }
+  if (o.json)
+    io.out(JSON.stringify(i, null, 2));
+  else
+    for (const l of impactLines(i))
+      io.out(l);
+  return 0;
+}
+export {
+  CHANGE_IMPACT_WORDS,
+  changeImpactCli,
+  changeImpactOf,
+  impactLines,
+  ownerText
+};

package/dist/{chunk-I4JRCD6M.js → chunk-7UOMVMFG.js}

@@ -11,24 +11,26 @@ import {
   planJourney,
   recordCommitment,
   requestFromTeam
-} from "./chunk-MVZVGYXH.js";
+} from "./chunk-6PPOWY5E.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
-import "./chunk-XY3P7JW7.js";
-import "./chunk-4AK7IBVP.js";
-import "./chunk-7JUKDRSZ.js";
-import "./chunk-27NKUS3X.js";
-import "./chunk-L24C55VN.js";
-import "./chunk-PAMPPUR6.js";
-import "./chunk-23W7VWKR.js";
-import "./chunk-7EKXJZ2Y.js";
-import "./chunk-MC3H7736.js";
-import "./chunk-EFHQ3TWP.js";
-import "./chunk-GQ4N4WKF.js";
-import "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+import "./chunk-IDKCWSM5.js";
+import "./chunk-UUU4CLJG.js";
+import "./chunk-7IGKHZ4Z.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/initiative-commands.js
@@ -164,12 +166,18 @@ async function requestFromTeam2(root, initiativeId, partyId, o, io, deps = {}) {
 async function initiativeCommitment(root, id, status, o, io) {
   const states = ["open", "at-risk", "done", "slipped"];
   if (!id || !status || !o.by || !states.includes(status)) {
-    io.err(`Usage: atticus initiative commit <commitment> <${states.join("|")}> [--by <you>]`);
+    io.err(`Usage: atticus initiative commit <commitment> <${states.join("|")}> [--by <you>] [--note "<words>"]`);
     return 2;
   }
   try {
-    const r = await recordCommitment(root, id, { status, by: o.by });
+    const r = await recordCommitment(root, id, {
+      status,
+      by: o.by,
+      ...o.note ? { note: o.note } : {}
+    });
     io.out(`${r.commitment.id} is ${status}. Wrote ${r.written}.`);
+    if (r.notes)
+      io.out(`Noted in ${r.notes}.`);
     return 0;
   } catch (e) {
     return fail(io, e);

package/dist/{chunk-YY6ZQQBP.js → chunk-AFWUDXEM.js}

@@ -7,18 +7,18 @@ import {
   buildSite,
   catalogRecords,
   openChanges
-} from "./chunk-B2WLAWNJ.js";
+} from "./chunk-GUX3PTYM.js";
 import {
   doctorChecks
-} from "./chunk-AIOQPLA5.js";
+} from "./chunk-EGQRREQH.js";
 import {
   readProbes,
   whatRunsWhere
-} from "./chunk-IPKHE5D6.js";
+} from "./chunk-BEVTIBRH.js";
 import {
   baseClonePath,
   loadRepos
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-PKBHS4AA.js";
 import {
   CatalogBaseline,
   DEFAULT_RUNTIME,
@@ -26,9 +26,11 @@ import {
   catalogDirOf,
   inputsDirOf,
   loadOrgPack,
-  orgPackDirOf,
+  orgPackDirOf
+} from "./chunk-Q2TECDIT.js";
+import {
   require_dist
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -90,7 +92,17 @@ async function setupSteps(root, o = {}) {
       label: "The org pack has an owner",
       done: !!op.pack?.owner && op.pack.owner !== "unassigned",
       detail: op.pack?.owner && op.pack.owner !== "unassigned" ? op.pack.owner : "unassigned",
-      fix: "Set owner in org-pack/pack.yaml to the person who looks after the org pack (normally the platform lead), and commit it through a pull request."
+      fix: "Name the person who looks after the org pack (normally the platform lead): type their handle under this step on Home in the app, or run atticus orgpack owner <handle>. It is saved as owner in org-pack/pack.yaml; propose it for review."
+    },
+    {
+      // Ninth UX walk: the constitution's pattern rule has nothing to check against while the
+      // registry is empty (so it doesn't fire), and nobody can pick a code: register them here.
+      id: "patterns",
+      label: "The integration pattern registry has patterns",
+      done: op.patterns.length > 0,
+      detail: op.patterns.length ? `${op.patterns.length} pattern${op.patterns.length === 1 ? "" : "s"}: ${op.patterns.map((p) => p.code).sort().join(", ")}` : "empty: the critic can't check a hop's pattern until it has some",
+      fix: "Add one YAML file per integration pattern your organisation approves under org-pack/patterns/ (its code, status confirmed, its route and controls; the starter pack's patterns show the shape), run atticus orgpack validate, and propose it for review. The app has no editor for patterns yet.",
+      optional: true
     },
     {
       // ADR 0121 item 6: how AI runs here is a choice, not the default left by accident.

package/dist/chunk-AFZ3QA6W.js

@@ -0,0 +1,47 @@
+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 {
+  FRESH_STATES,
+  estateFresh,
+  estateFreshness,
+  factsCommitWords,
+  freshOrder,
+  freshWhy
+} from "./chunk-SQV37XO2.js";
+import "./chunk-OWNCM4ZN.js";
+import "./chunk-T6DQR5TV.js";
+import "./chunk-WXFLMQSR.js";
+import "./chunk-TYQBFTBR.js";
+import "./chunk-2F4CYZKJ.js";
+import "./chunk-LO6P2VYG.js";
+import "./chunk-SFUP7TTO.js";
+import "./chunk-7FTTA3HD.js";
+import "./chunk-ZQ3ON2VQ.js";
+import "./chunk-3G4YI4ZU.js";
+import "./chunk-VOGCSYOI.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-F3P7N7SF.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
+import "./chunk-TV45EUGM.js";
+export {
+  FRESH_STATES,
+  estateFresh,
+  estateFreshness,
+  factsCommitWords,
+  freshOrder,
+  freshWhy
+};