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

package/dist/{chunk-B2U4AOZ5.js → chunk-YCBDNWX3.js}

@@ -6,60 +6,25 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   changeSteps,
   readNextState
-} from "./chunk-BPDS7KUR.js";
-import "./chunk-EP7ZBZLT.js";
-import "./chunk-5267F4BS.js";
-import "./chunk-X7XVMYIL.js";
-import "./chunk-HHZEXF7V.js";
-import "./chunk-AGAFNUYZ.js";
-import "./chunk-WA644MUQ.js";
-import "./chunk-YEGGQG5E.js";
-import "./chunk-TIOYZDRB.js";
-import "./chunk-5RDKQOY3.js";
-import "./chunk-5WZV37WS.js";
-import "./chunk-DBVQEPZB.js";
-import "./chunk-XP5DF5MC.js";
-import "./chunk-G5P7F6RQ.js";
-import "./chunk-J65TN6QU.js";
-import "./chunk-3G4YI4ZU.js";
-import "./chunk-MN2XDLDM.js";
-import "./chunk-H7GAPNGQ.js";
-import "./chunk-SEBBJQWK.js";
-import "./chunk-MUWDB4R4.js";
-import "./chunk-VOGCSYOI.js";
-import "./chunk-IWQEZFVV.js";
-import "./chunk-EM7F6XEU.js";
-import "./chunk-QSKY7FE3.js";
-import "./chunk-GDGE7ZHC.js";
+} from "./chunk-YXG2VQJJ.js";
 import {
   changeReport,
-  changeStore
-} from "./chunk-JQGWP3SC.js";
-import "./chunk-UTZMF5CV.js";
-import "./chunk-U7YZ3IRI.js";
-import "./chunk-DLNQ3HUM.js";
-import "./chunk-YRKAJ42V.js";
-import "./chunk-CGVRLQAY.js";
-import "./chunk-RL7PETU6.js";
-import "./chunk-PGKCRK77.js";
-import "./chunk-M6HI36T3.js";
-import "./chunk-2VN4TLGI.js";
-import "./chunk-4U3JLIRC.js";
-import "./chunk-MXPKXCGP.js";
-import "./chunk-QQD25YNF.js";
-import "./chunk-QA4O2GGC.js";
+  changeStore,
+  handoffName,
+  loadChangePolicy,
+  stageCompletion,
+  stageWorkDone
+} from "./chunk-SVOGRJO6.js";
 import {
   readChangeRepos
-} from "./chunk-WS7KBKP4.js";
+} from "./chunk-X5B7KYPD.js";
 import {
   changesDirOf,
   listQuestions,
   nextOwnersOf,
+  orgPackDirOf,
   ownersOfRole
-} from "./chunk-GLISHJ4G.js";
-import "./chunk-G3ZFEHCX.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-WJWSB65O.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -93,10 +58,60 @@ function waitsOnOf(c, storiesDone, custom = []) {
     return void 0;
   return { role, people: ownersOfRole(role, c.owners, custom), because: "phase", phase: c.state };
 }
-async function stageProgress(dir, stage, open) {
+var GATE_STEPS = /* @__PURE__ */ new Set(["handoff", "small-handoff", "merge"]);
+var RELEASE_GATE_STEPS = /* @__PURE__ */ new Set(["release", "release-prs", "release-prs-merge"]);
+function glanceNextStep(report, next, where = "glance") {
+  if (!report.ready || !report.phase || glanceReady(report, next))
+    return report.nextStep;
+  const not = `Not ready to raise "${handoffName(report.type, report.phase)}" yet`;
+  const why = next?.why?.trim();
+  if (where === "page" && why)
+    return `${not}: first, ${lowerFirst(why)}`;
+  return `${not}: the step below comes first.`;
+}
+var lowerFirst = (s) => /^[A-Z][a-z]/.test(s) ? s[0].toLowerCase() + s.slice(1) : s;
+function glanceReady(report, next) {
+  if (!report.ready || !report.phase)
+    return false;
+  if (!next || GATE_STEPS.has(next.step))
+    return true;
+  return report.phase === "release" && RELEASE_GATE_STEPS.has(next.step);
+}
+async function changeNextStep(root, id, report, state, where = "glance") {
+  const s = state ?? await readNextState(root).catch(() => void 0);
+  const own = s?.changes.find((c) => c.id === id);
+  const next = own ? changeSteps(own)[0] : void 0;
+  const ready = glanceReady(report, next);
+  const nextStep = glanceNextStep(report, next, where);
+  const stepFirst = report.ready && !ready;
+  let nextStepApp;
+  if (where === "page" && stepFirst && next?.why) {
+    const { commandShapes, stepInAppWords } = await import("./chunk-76DZJTU7.js");
+    nextStepApp = glanceNextStep(report, { ...next, why: stepInAppWords(next.why, await commandShapes()) }, where);
+  }
+  return {
+    nextStep,
+    ...nextStepApp ? { nextStepApp } : {},
+    ready,
+    // Nothing in the gate's checks blocks, yet another step comes first.
+    stepFirst,
+    ...next ? { next } : {}
+  };
+}
+async function stageProgress(dir, stage, open, done) {
   const text = await readFile(join(dir, "stage", `${stage}.yaml`), "utf8").catch(() => void 0);
-  if (!text)
-    return { stage, state: "not-started", drafts: 0, rounds: 0, openQuestions: 0, asked: [] };
+  if (!text) {
+    const state = done && done.state !== "unknown" ? done.state : "not-started";
+    return {
+      stage,
+      state,
+      ...done?.files?.length ? { files: done.files } : {},
+      drafts: 0,
+      rounds: 0,
+      openQuestions: 0,
+      asked: []
+    };
+  }
   const y = (0, import_yaml.parse)(text) ?? {};
   const asked = Array.isArray(y.questions) ? y.questions.filter((q) => typeof q === "string") : [];
   return {
@@ -116,14 +131,17 @@ async function cockpit(root, id, o = {}) {
     questions: []
   }));
   const open = new Set(questions.map((q) => q.id));
+  const lifecycle = await changeStore(root).read(id).catch(() => void 0);
+  const { policy } = await loadChangePolicy(orgPackDirOf(root));
+  const completion = await stageCompletion({ root, policy }, { id, ...lifecycle ? { state: lifecycle.state } : {} }).catch(() => []);
   const stages = [];
   for (const s of STAGES)
-    stages.push(await stageProgress(dir, s, open));
+    stages.push(await stageProgress(dir, s, open, completion.find((x) => x.stage === s)));
   const ofChange = /* @__PURE__ */ new Set([
     ...questions.filter((q) => q.repo === id).map((q) => q.id),
     ...stages.flatMap((s) => s.asked)
   ]);
-  const { stageQuestions, roleWithStage, personsRoles, customRoles } = await import("./chunk-KW4DIXUL.js");
+  const { stageQuestions, roleWithStage, personsRoles, customRoles } = await import("./chunk-HDWVR5KD.js");
   const raisedBy = await stageQuestions(root, id);
   const byRole = {};
   for (const q of questions) {
@@ -133,16 +151,15 @@ async function cockpit(root, id, o = {}) {
     if (r)
       byRole[r] = (byRole[r] ?? 0) + 1;
   }
-  const state = (await readNextState(root)).changes.find((c) => c.id === id);
-  const next = state ? changeSteps(state)[0] : void 0;
+  const said = await changeNextStep(root, id, report, await readNextState(root));
+  const next = said.next;
   const repos = await readChangeRepos(root, id).catch(() => void 0);
-  const lifecycle = await changeStore(root).read(id).catch(() => void 0);
-  const waitsOn = lifecycle ? waitsOnOf(lifecycle, stages.find((s) => s.stage === "stories")?.state === "done", await customRoles(root)) : void 0;
+  const waitsOn = lifecycle ? waitsOnOf(lifecycle, stageWorkDone(stages.find((s) => s.stage === "stories")?.state ?? ""), await customRoles(root)) : void 0;
   return {
     id,
     state: report.state,
     ...next ? { next } : {},
-    nextStep: report.nextStep,
+    nextStep: said.nextStep,
     reasons: report.reasons,
     risk: { level: report.risk.level, score: report.risk.score },
     ...report.progress ? { work: report.progress.summary } : {},
@@ -159,8 +176,12 @@ async function cockpit(root, id, o = {}) {
     }))
   };
 }
+
 export {
   STAGES,
-  cockpit,
-  waitsOnOf
+  waitsOnOf,
+  glanceNextStep,
+  glanceReady,
+  changeNextStep,
+  cockpit
 };