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

package/dist/{chunk-ILDGIXNH.js → chunk-2V2ZPQQU.js}

@@ -5,17 +5,17 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   changeStore
-} from "./chunk-IOW6BF3U.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   ManualNotifier,
   fileStepStore
-} from "./chunk-V3UEPUHT.js";
+} from "./chunk-4KNOJC6J.js";
 import {
   readCatalog
-} from "./chunk-EZBAS5BL.js";
+} from "./chunk-4SLBCEPD.js";
 import {
   readServiceRequestExports
-} from "./chunk-TNCROWPQ.js";
+} from "./chunk-CPK7QSBG.js";
 import {
   Initiative,
   IsoDate,
@@ -32,10 +32,11 @@ import {
   serializeRecord,
   stateDirOf,
   toCanonicalYaml
-} from "./chunk-YK6CSODO.js";
+} from "./chunk-PAINMSID.js";
 import {
-  SCHEMA_VERSION
-} from "./chunk-MMB2OHUY.js";
+  SCHEMA_VERSION,
+  renameRetrying
+} from "./chunk-ODMBPDDV.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -717,7 +718,7 @@ var stepsOf = (j) => j.phases.flatMap((p) => p.steps.map((s) => ({ ...s, phase:
 
 // packages/initiatives/dist/store.js
 var import_yaml2 = __toESM(require_dist(), 1);
-import { mkdir, readFile as readFile2, rename, rm, writeFile } from "node:fs/promises";
+import { mkdir, readFile as readFile2, rm, writeFile } from "node:fs/promises";
 import { dirname, join as join2 } from "node:path";
 var curatedDirOf = (root) => join2(catalogDirOf(root), "curated");
 var initiativesDirOf = (root) => join2(stateDirOf(root), "initiatives");
@@ -736,7 +737,7 @@ async function writeAtomic(path, text) {
   const tmp = `${path}.tmp`;
   try {
     await writeFile(tmp, text, "utf8");
-    await rename(tmp, path);
+    await renameRetrying(tmp, path);
   } catch (e) {
     await rm(tmp, { force: true });
     throw e;
@@ -854,6 +855,44 @@ async function readPlan(root, id) {
     throw new InitiativeError(`initiatives/${id}/plan.yaml: ${r.error.issues.map((i) => `${i.path.join(".")} ${i.message}`).join("; ")}`);
   return r.data;
 }
+var CommitmentNote = external_exports.strictObject({
+  at: IsoDateTime,
+  by: external_exports.string().min(1),
+  commitment: RecordId,
+  status: external_exports.enum(["open", "at-risk", "done", "slipped"]),
+  note: external_exports.string().min(1)
+});
+var NotesFile = external_exports.strictObject({
+  schemaVersion: external_exports.literal(1),
+  initiative: RecordId,
+  notes: external_exports.array(CommitmentNote).default([])
+});
+var notesPath = (root, id) => join2(initiativeDir(root, id), "notes.yaml");
+async function readNotes(root, id) {
+  let text;
+  try {
+    text = await readFile2(notesPath(root, id), "utf8");
+  } catch {
+    return [];
+  }
+  const r = NotesFile.safeParse((0, import_yaml2.parse)(text));
+  if (!r.success)
+    throw new InitiativeError(`initiatives/${id}/notes.yaml: ${r.error.issues.map((i) => `${i.path.join(".")} ${i.message}`).join("; ")}`);
+  return r.data.notes;
+}
+async function appendNote(root, id, note) {
+  const notes = [...await readNotes(root, id), CommitmentNote.parse(note)];
+  await writeAtomic(notesPath(root, id), toCanonicalYaml(NotesFile.parse({ schemaVersion: 1, initiative: id, notes }), [
+    "schemaVersion",
+    "initiative",
+    "at",
+    "by",
+    "commitment",
+    "status",
+    "note"
+  ]));
+  return `initiatives/${id}/notes.yaml`;
+}
 var slugOf = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80).replace(/-+$/, "");
 
 // packages/initiatives/dist/dates.js
@@ -1285,6 +1324,9 @@ async function initiativeStatus(root, id, o = {}) {
   }
   const commitmentRecords = view.all("Commitment").filter((c) => c.initiative === id);
   const recordOf = new Map(commitmentRecords.map((c) => [c.id, c]));
+  const lastNote = /* @__PURE__ */ new Map();
+  for (const n of await readNotes(root, id))
+    lastNote.set(n.commitment, { at: n.at, by: n.by, status: n.status, note: n.note });
   const items = [];
   let projectedRelease;
   if (plan) {
@@ -1331,9 +1373,14 @@ async function initiativeStatus(root, id, o = {}) {
       const d = done.get(i.key);
       const finish = ef.get(i.key);
       const float = d ? 0 : workingDays(finish, lf.get(i.key));
-      const status2 = d ? "done" : today > i.due ? "slipped" : finish > i.due ? "at-risk" : "open";
+      let status2 = d ? "done" : today > i.due ? "slipped" : finish > i.due ? "at-risk" : "open";
+      const said = i.commitment ? commitmentRecords.find((c) => c.id === i.commitment)?.commitmentStatus : void 0;
+      const recorded = said === "at-risk" || said === "slipped" ? said : void 0;
+      const rank = { slipped: 3, "at-risk": 2 };
+      if (!d && recorded && rank[recorded] > (rank[status2] ?? 0))
+        status2 = recorded;
       const lateBefore = i.after.filter((a) => !done.get(a) && ef.get(a) > byKey.get(a).due);
-      const why = status2 === "done" ? "Done." : status2 === "slipped" ? `Due ${i.due} and not done.` : status2 === "at-risk" ? `Projected to finish ${finish}, after its due date ${i.due}${lateBefore.length ? `, because ${lateBefore.join(", ")} ${lateBefore.length === 1 ? "is" : "are"} late` : ""}.` : `On plan: due ${i.due}.`;
+      const why = status2 === "done" ? "Done." : recorded && status2 === recorded ? recorded === "slipped" ? "Recorded as slipped." : "Recorded as at risk." : status2 === "slipped" ? `Due ${i.due} and not done.` : status2 === "at-risk" ? `Projected to finish ${finish}, after its due date ${i.due}${lateBefore.length ? `, because ${lateBefore.join(", ")} ${lateBefore.length === 1 ? "is" : "are"} late` : ""}.` : `On plan: due ${i.due}.`;
       items.push({
         key: i.key,
         kind: i.kind,
@@ -1377,6 +1424,13 @@ async function initiativeStatus(root, id, o = {}) {
       [status2, why] = ["at-risk", `Needed by ${c.neededBy}: two working days or less left.`];
     else
       [status2, why] = ["open", `Needed by ${c.neededBy}.`];
+    const rank = { slipped: 3, "at-risk": 2 };
+    const said = c.commitmentStatus;
+    if ((said === "at-risk" || said === "slipped") && rank[said] > (rank[status2] ?? 0))
+      [status2, why] = [
+        said,
+        said === "slipped" ? "Recorded as slipped." : "Recorded as at risk."
+      ];
     return {
       id: c.id,
       what: c.what,
@@ -1384,7 +1438,8 @@ async function initiativeStatus(root, id, o = {}) {
       neededBy: c.neededBy,
       recorded: c.commitmentStatus,
       status: status2,
-      why
+      why,
+      ...lastNote.get(c.id) ? { note: lastNote.get(c.id) } : {}
     };
   });
   const changes = initiative.changes.map((c) => {
@@ -1442,7 +1497,19 @@ async function recordCommitment(root, id, o) {
   const by = o.by.replace(/^@/, "");
   const evidence = c.evidence.some((e) => e.source === "manual" && e.by === by) ? c.evidence : [...c.evidence, ...manualEvidence(by)];
   const updated = { ...c, commitmentStatus: o.status, evidence };
-  return { commitment: updated, written: await writeCurated(root, updated) };
+  const written = await writeCurated(root, updated);
+  const note = o.note?.trim();
+  if (!note)
+    return { commitment: updated, written };
+  const at = (o.now ?? /* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
+  const notes = await appendNote(root, c.initiative, {
+    at,
+    by,
+    commitment: id,
+    status: o.status,
+    note
+  });
+  return { commitment: updated, written, notes };
 }
 
 // packages/initiatives/dist/card.js
@@ -1599,6 +1666,7 @@ export {
   workingDays,
   laterOf,
   JOURNEYS,
+  initiativesDirOf,
   InitiativeError,
   readView,
   readPlan,

package/dist/{chunk-YSEZQ6D3.js → chunk-36RY7ZXM.js}

@@ -12,13 +12,13 @@ import {
   readPlan,
   readView,
   workingDays
-} from "./chunk-ILDGIXNH.js";
+} from "./chunk-2V2ZPQQU.js";
 import {
   traceMatrix
-} from "./chunk-YC2K3FJG.js";
+} from "./chunk-EZIN5E5B.js";
 import {
   SYNC_FILE
-} from "./chunk-XO5RQKNM.js";
+} from "./chunk-BEPCKDCP.js";
 import {
   contentLines,
   docOf,
@@ -38,7 +38,7 @@ import {
   sectionLines,
   sectionMatching,
   tableWith
-} from "./chunk-VEJYZEPC.js";
+} from "./chunk-K332XW7K.js";
 import {
   changeFolder,
   changeReport,
@@ -47,17 +47,17 @@ import {
   outsideKindOf,
   outsideSystemsOf,
   outsideWords
-} from "./chunk-IOW6BF3U.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   fileStepStore,
   stepOfProvisional
-} from "./chunk-V3UEPUHT.js";
+} from "./chunk-4KNOJC6J.js";
 import {
   readServiceRequestExports
-} from "./chunk-TNCROWPQ.js";
+} from "./chunk-CPK7QSBG.js";
 import {
   readChangeRepos
-} from "./chunk-ZQC7MNQB.js";
+} from "./chunk-XOL3GFW2.js";
 import {
   BREAKING_SPEC,
   NAMES_SECRET_SPEC,
@@ -67,7 +67,7 @@ import {
   settle,
   tokenFormatIn,
   verdictOf
-} from "./chunk-QNMLLYTN.js";
+} from "./chunk-QHJJMZLX.js";
 import {
   ChangeOutcomes,
   WORKSPACE_SCHEMA_VERSION,
@@ -77,7 +77,7 @@ import {
   readRunSummary,
   require_dist,
   toCanonicalYaml
-} from "./chunk-YK6CSODO.js";
+} from "./chunk-PAINMSID.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -232,56 +232,6 @@ async function loadRelease(root, changeId, o = {}) {
   };
 }
 
-// packages/release/dist/judged.js
-function breakingItem(h, notes) {
-  return {
-    inputs: {
-      v: 1,
-      change: h.change,
-      operation: h.operation,
-      caller: h.caller,
-      callee: h.callee,
-      notes
-    },
-    texts: { notes },
-    facts: [
-      `operation: ${h.operation}`,
-      `caller: ${h.caller}`,
-      `callee: ${h.callee}`,
-      `change: ${h.change.replace(/^planned-/, "")}`
-    ]
-  };
-}
-function undoesItem(sentence, step, others) {
-  return {
-    inputs: {
-      v: 1,
-      sentence,
-      step: step.key,
-      names: [...new Set(step.names)].sort(),
-      others: [...new Set(others.filter((n) => !step.names.includes(n)))].sort()
-    },
-    texts: { sentence },
-    facts: [
-      `the step: ${step.kind} in ${step.repo}`,
-      ...step.what.map((w) => `it deploys: ${w}`),
-      `its names: ${[...new Set(step.names)].join(", ")}`
-    ]
-  };
-}
-function secretItem(line) {
-  return { inputs: { v: 1, line }, texts: { line } };
-}
-async function judgedFor(ctx, spec, items) {
-  const results = items.length ? await settle(spec, items, {
-    store: ctx.judging.store,
-    runtime: ctx.judging.runtime,
-    change: ctx.change.id,
-    now: new Date(ctx.now)
-  }) : /* @__PURE__ */ new Map();
-  return (item) => verdictOf(results, spec, item.inputs);
-}
-
 // packages/release/dist/model.js
 var cmp = (a, b) => a < b ? -1 : a > b ? 1 : 0;
 var sortStrings = (xs) => [...new Set(xs)].sort(cmp);
@@ -374,6 +324,7 @@ function buildModel(ctx) {
   };
 }
 var opOf = (h) => h.operation || (h.path ?? "");
+var pathKey = (h) => h.path ? normalizePath(h.path) : "";
 function sectionOf(ctx, file, re) {
   const doc = docOf(ctx.files, file);
   const s = doc?.sections.find((x) => re.test(x.heading));
@@ -438,6 +389,56 @@ function hasWord(text, word) {
   return new RegExp(`(^|[^A-Za-z0-9_-])${esc3}($|[^A-Za-z0-9_-])`, "i").test(text);
 }
 
+// packages/release/dist/judged.js
+function breakingItem(h, notes) {
+  return {
+    inputs: {
+      v: 1,
+      change: h.change,
+      operation: h.operation,
+      caller: h.caller,
+      callee: h.callee,
+      notes
+    },
+    texts: { notes },
+    facts: [
+      `operation: ${h.operation}`,
+      `caller: ${h.caller}`,
+      `callee: ${h.callee}`,
+      `change: ${h.change.replace(/^planned-/, "")}`
+    ]
+  };
+}
+function undoesItem(sentence, step, others) {
+  return {
+    inputs: {
+      v: 1,
+      sentence,
+      step: step.key,
+      names: [...new Set(step.names)].sort(),
+      others: [...new Set(others.filter((n) => !step.names.includes(n)))].sort()
+    },
+    texts: { sentence },
+    facts: [
+      `the step: ${step.kind} in ${step.repo}`,
+      ...step.what.map((w) => `it deploys: ${w}`),
+      `its names: ${[...new Set(step.names)].join(", ")}`
+    ]
+  };
+}
+function secretItem(line) {
+  return { inputs: { v: 1, line }, texts: { line } };
+}
+async function judgedFor(ctx, spec, items) {
+  const results = items.length ? await settle(spec, items, {
+    store: ctx.judging.store,
+    runtime: ctx.judging.runtime,
+    change: ctx.change.id,
+    now: new Date(ctx.now)
+  }) : /* @__PURE__ */ new Map();
+  return (item) => verdictOf(results, spec, item.inputs);
+}
+
 // packages/release/dist/plan.js
 var RANK = { migration: 0, topic: 1, "gateway-route": 2, code: 3 };
 var cmp2 = (a, b) => a < b ? -1 : a > b ? 1 : 0;
@@ -557,6 +558,7 @@ async function deploymentPlan(ctx) {
   }
   for (const h of m.hops) {
     const live = /^planned-(new|modify)$/.test(h.change);
+    const retire = h.change === "planned-retire";
     const op = opOf(h);
     const src = `interfaces.md:${h.line}`;
     const callerInternal = !h.callerOutside;
@@ -574,6 +576,18 @@ async function deploymentPlan(ctx) {
       else
         unplaced.set(h.callee, placeWhy(ctx, h.callee, `callee of ${op}`));
     }
+    if (retire && callerInternal) {
+      if (h.callerRepo)
+        addWhat(codeUnit(h.callerRepo), `${h.caller} stops calling ${op} on ${h.callee} (retired)`, src);
+      else
+        unplaced.set(h.caller, placeWhy(ctx, h.caller, `caller of ${op}`));
+    }
+    if (retire && calleeInternal) {
+      if (h.calleeRepo)
+        addWhat(codeUnit(h.calleeRepo), `${h.callee} retires ${op}`, src);
+      else
+        unplaced.set(h.callee, placeWhy(ctx, h.callee, `callee of ${op}`));
+    }
     if (live && !calleeInternal && h.calleeSystem) {
       const what = h.calleeOutside === "other-team" ? `${op} must be live on ${m.systemName(h.calleeSystem)}'s side (another team's system: it deploys on its own team's plan, not here)` : `${op} must be live on ${m.systemName(h.calleeSystem)}'s side (a vendor: nothing of theirs deploys here)`;
       external.push({ system: h.calleeSystem, name: m.systemName(h.calleeSystem), what });
@@ -618,6 +632,12 @@ async function deploymentPlan(ctx) {
         to: `code:${h.callerRepo}`,
         why: `${h.caller} calls ${h.callee}'s ${verb} ${op}, so ${h.callee} deploys first`
       });
+    if (retire && h.callerRepo && h.calleeRepo && h.callerRepo !== h.calleeRepo && callerInternal && calleeInternal)
+      edges.push({
+        from: `code:${h.callerRepo}`,
+        to: `code:${h.calleeRepo}`,
+        why: `${h.caller} calls ${h.callee}'s retired ${op}, so ${h.caller} stops calling it first`
+      });
   }
   for (const t of tasks) {
     if (!ctx.repos.some((r) => r.id === t.repo) && !m.componentsOfRepo(t.repo).length)
@@ -958,6 +978,12 @@ async function releaseForecast(ctx, plan) {
   };
 }
 
+// packages/release/dist/evidence.js
+var import_yaml3 = __toESM(require_dist(), 1);
+import { createHash } from "node:crypto";
+import { copyFile, mkdir as mkdir2, readdir, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname2, join as join3 } from "node:path";
+
 // packages/release/dist/outcomes.js
 var import_yaml2 = __toESM(require_dist(), 1);
 import { mkdir, readFile as readFile2, rename, rm, writeFile } from "node:fs/promises";
@@ -1093,10 +1119,6 @@ async function recordOutcome(ctx, input) {
 }
 
 // packages/release/dist/evidence.js
-var import_yaml3 = __toESM(require_dist(), 1);
-import { createHash } from "node:crypto";
-import { copyFile, mkdir as mkdir2, readdir, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname2, join as join3 } from "node:path";
 async function walk(dir, rel = "") {
   let entries;
   try {
@@ -1992,16 +2014,37 @@ function estimateChange(input) {
 
 export {
   ReleaseError,
+  REQUESTS_FILE,
   readServiceRequests,
   loadRelease,
+  sortStrings,
+  buildModel,
+  opOf,
+  pathKey,
+  sectionOf,
+  sectionsOf,
+  sentences,
+  hasWord,
+  breakingItem,
+  undoesItem,
+  secretItem,
+  judgedFor,
   deploymentPlan,
   releaseForecast,
+  OUTCOMES_FILE,
+  MEASURABLE,
+  measureId,
+  measuresOf,
+  readOutcomes,
   outcomesView,
+  findMeasure,
   recordOutcome,
+  changeFiles,
   evidencePack,
   writeEvidencePack,
   AUDIENCES,
   releaseNotes,
   securityReview,
+  classOf,
   estimateChange
 };

package/dist/{chunk-QXFDM2FZ.js → chunk-37WE3LS2.js}

@@ -8,11 +8,11 @@ import {
   historyEntry,
   listHistory,
   setLocalRecording
-} from "./chunk-6AP2ZUUM.js";
+} from "./chunk-3WON4G3M.js";
 import {
   api_exports
-} from "./chunk-YK6CSODO.js";
-import "./chunk-MMB2OHUY.js";
+} from "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/history-commands.js