@maycombhq/atticus 0.0.0-stage → 2.0.0-beta.11

package/dist/chunk-SNHOLLGN.js

@@ -0,0 +1,280 @@
+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,
+  estateFreshness
+} from "./chunk-G3PBLW4K.js";
+import {
+  loadReadPlan,
+  readCostOf
+} from "./chunk-LVBPY2M6.js";
+import "./chunk-EW7MRMD5.js";
+import "./chunk-IA2RKC6I.js";
+import "./chunk-ASKDCMW5.js";
+import "./chunk-LDIARP6F.js";
+import "./chunk-MYKQVS5W.js";
+import "./chunk-EBWIOODZ.js";
+import "./chunk-BA5DTXHQ.js";
+import "./chunk-3G4YI4ZU.js";
+import "./chunk-VOGCSYOI.js";
+import {
+  componentRenames,
+  estateFacts,
+  isPrototypeRepo,
+  joinReposOf,
+  outsideSystems
+} from "./chunk-IILZ7J3L.js";
+import "./chunk-TEBBD4XH.js";
+import "./chunk-XPWSNKF3.js";
+import "./chunk-WIMOJMAK.js";
+import "./chunk-5V5BJACL.js";
+import "./chunk-GVFUEGGM.js";
+import "./chunk-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import {
+  HOSTS_STEP,
+  LINK_QUESTION_STEPS,
+  TARGETS_STEP_ID,
+  TERM_STEP,
+  TOPICS_STEP_ID,
+  factsDirOf,
+  factsFileOf,
+  helperOn,
+  isGuessedJoin,
+  joinConventions,
+  joinFacts,
+  joinGuessesOf,
+  listQuestions,
+  loadOrgPack,
+  orgPackDirOf,
+  parseFacts,
+  require_dist
+} from "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/doctor-counts.js
+var import_yaml = __toESM(require_dist(), 1);
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+var QUESTION_STEPS = /* @__PURE__ */ new Set([
+  "map",
+  "scan-survey",
+  "scan-verify",
+  "spec-draft",
+  "spec-check",
+  HOSTS_STEP,
+  TARGETS_STEP_ID,
+  TOPICS_STEP_ID,
+  TERM_STEP,
+  ...LINK_QUESTION_STEPS,
+  // The planner's, a change's stages (planner/src/stages) and its gaps; the knowledge conflicts.
+  "change-feature",
+  "change-architecture",
+  "change-stories",
+  "change-small",
+  "context-gap",
+  "knowledge-conflict"
+]);
+var OTHER_STEP = "other";
+var bump = (m, k, n = 1) => {
+  m[k] = (m[k] ?? 0) + n;
+};
+var sorted = (m) => Object.fromEntries(Object.entries(m).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
+var LISTENS = /^(subscribe|consume|listen)$/i;
+async function doctorCounts(root, o = {}) {
+  let problems = 0;
+  const qs = await listQuestions(root, { state: "open" }).catch(() => {
+    problems++;
+    return { questions: [], problems: [] };
+  });
+  problems += qs.problems.length;
+  const byKind = {};
+  for (const q of qs.questions)
+    bump(byKind, QUESTION_STEPS.has(q.askedBy.step) ? q.askedBy.step : OTHER_STEP);
+  const fresh = await estateFreshness(root, o.git ? { git: o.git } : {}).catch(() => {
+    problems++;
+    return { repos: [], problems: [] };
+  });
+  problems += fresh.problems.length;
+  const byState = Object.fromEntries(FRESH_STATES.map((s) => [s, 0]));
+  for (const r of fresh.repos)
+    byState[r.state]++;
+  const total = fresh.repos.length;
+  const facts = { accepted: 0, rejected: 0, notVerified: 0, filesNotRead: 0 };
+  const dir = factsDirOf(root);
+  const names = (await readdir(dir).catch(() => [])).sort();
+  const read = async (n) => readFile(join(dir, n), "utf8").catch(() => void 0);
+  for (const n of names) {
+    const of = factsFileOf(n);
+    if (!of)
+      continue;
+    const text = await read(n);
+    if (text === void 0) {
+      problems++;
+      continue;
+    }
+    if (of.facts) {
+      const p = parseFacts(text);
+      if (!p.ok) {
+        problems++;
+        continue;
+      }
+      for (const f of p.facts)
+        if (f.verified === "none")
+          facts.notVerified++;
+        else
+          facts.accepted++;
+    } else if (n.endsWith(".rejected.jsonl"))
+      facts.rejected += text.split("\n").filter((l) => l.trim()).length;
+    else if (n.endsWith(".verify.yaml"))
+      try {
+        const v = (0, import_yaml.parse)(text);
+        const u = v?.coverage?.unknown;
+        facts.filesNotRead += Array.isArray(u) ? u.length : typeof u === "number" ? u : 0;
+      } catch {
+        problems++;
+      }
+  }
+  const tokens = { reported: 0, reports: 0, repos: 0 };
+  for (const r of fresh.repos) {
+    const plan = await Promise.resolve().then(() => loadReadPlan(root, r.repo)).catch(() => {
+      problems++;
+      return void 0;
+    });
+    const cost = plan ? readCostOf(plan).reported : void 0;
+    if (!cost)
+      continue;
+    tokens.repos++;
+    tokens.reports += cost.reports;
+    tokens.reported += cost.tokens ?? 0;
+  }
+  const links = { verified: 0, inferred: 0, inferredBy: {}, asked: 0, outside: 0, unresolved: 0 };
+  let op;
+  try {
+    op = await loadOrgPack(orgPackDirOf(root));
+  } catch {
+    if (total)
+      problems++;
+  }
+  if (op)
+    try {
+      Object.assign(links, await linkCounts(root, op));
+    } catch {
+      problems++;
+    }
+  return {
+    questions: { open: qs.questions.length, byKind: sorted(byKind) },
+    links,
+    repos: {
+      total,
+      read: total - byState["not-read"],
+      unread: byState["not-read"],
+      stale: byState.stale,
+      byState
+    },
+    facts,
+    tokens,
+    problems
+  };
+}
+async function linkCounts(root, op) {
+  const estate = await estateFacts(root, op, "");
+  const repos = estate.repos.filter((x) => !isPrototypeRepo(op, x.repo));
+  const join2 = joinFacts({
+    repos: joinReposOf(op, repos, componentRenames(repos, op)),
+    ...Object.keys(estate.targets).length ? { targets: estate.targets } : {},
+    outside: outsideSystems(op),
+    ...joinConventions(op),
+    walkGateways: helperOn("gateway-walk")
+  });
+  const factOf = /* @__PURE__ */ new Map();
+  for (const r of repos)
+    for (const f of r.facts)
+      factOf.set(`${r.repo}\0${f.id}`, f);
+  const key = (e) => `${e.repo}\0${e.fact}`;
+  const declared = (e) => factOf.get(key(e))?.conf === "declared";
+  const out = {
+    verified: 0,
+    inferred: 0,
+    inferredBy: {},
+    asked: 0,
+    outside: 0,
+    unresolved: 0
+  };
+  const answered = /* @__PURE__ */ new Set();
+  for (const j of join2.joins) {
+    answered.add(key(j.call));
+    if (!isGuessedJoin(j) && declared(j.call) && declared(j.entry))
+      out.verified++;
+    else {
+      out.inferred++;
+      const flags = joinGuessesOf(j);
+      if (flags.length)
+        for (const f of flags)
+          bump(out.inferredBy, f);
+      else
+        bump(out.inferredBy, "one-end-inferred");
+    }
+  }
+  for (const a of join2.asks) {
+    if (answered.has(key(a.call)))
+      continue;
+    answered.add(key(a.call));
+    out.asked++;
+  }
+  for (const x of join2.outside ?? []) {
+    if (answered.has(key(x.call)))
+      continue;
+    answered.add(key(x.call));
+    out.outside++;
+  }
+  for (const r of repos)
+    for (const f of r.facts) {
+      if (f.kind !== "call" || LISTENS.test(f.method ?? ""))
+        continue;
+      if (!answered.has(`${r.repo}\0${f.id}`))
+        out.unresolved++;
+    }
+  out.inferredBy = sorted(out.inferredBy);
+  return out;
+}
+var kv = (m) => Object.entries(m).filter(([, n]) => n > 0).map(([k, n]) => `${k} ${n}`).join(", ");
+function countsLines(c) {
+  const by = kv(c.questions.byKind);
+  const inferred = kv(c.links.inferredBy);
+  const states = kv(c.repos.byState);
+  return [
+    `Questions: ${c.questions.open} open${by ? ` (${by})` : ""}`,
+    `Links: ${c.links.verified} verified, ${c.links.inferred} inferred${inferred ? ` (${inferred})` : ""}, ${c.links.asked} asked, ${c.links.outside} to outside systems, ${c.links.unresolved} unresolved calls`,
+    `Repos: ${c.repos.total} in all, ${c.repos.read} read, ${c.repos.unread} unread, ${c.repos.stale} stale${states ? ` (${states})` : ""}`,
+    `Facts: ${c.facts.accepted} accepted, ${c.facts.rejected} rejected, ${c.facts.notVerified} not verified; ${c.facts.filesNotRead} source files not read`,
+    `Tokens reported: ${c.tokens.reported} tokens over ${c.tokens.reports} reports for ${c.tokens.repos} repos`,
+    "Counts and flags only: nothing here names a repo, system, host or file, so it is safe to paste."
+  ];
+}
+async function doctorCountsCommand(root, o, io, deps = {}) {
+  const { problems, ...c } = await doctorCounts(root, deps);
+  if (o.json)
+    io.out(JSON.stringify({ ...c, problems }, null, 2));
+  else {
+    for (const l of countsLines(c))
+      io.out(l);
+    if (problems)
+      io.out(`${problems} file${problems === 1 ? "" : "s"} didn't read; atticus doctor and atticus estate fresh say which.`);
+  }
+  return 0;
+}
+export {
+  OTHER_STEP,
+  QUESTION_STEPS,
+  countsLines,
+  doctorCounts,
+  doctorCountsCommand
+};

package/dist/chunk-SUQZGPVG.js

@@ -0,0 +1,119 @@
+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 {
+  estimateOf
+} from "./chunk-BX52REMA.js";
+import {
+  changeMapBody,
+  changeMapOf
+} from "./chunk-JEUXCIRD.js";
+import "./chunk-7A7IG7OA.js";
+import "./chunk-Z46OXTBE.js";
+import "./chunk-BUWSOQLU.js";
+import "./chunk-PQW7PYUR.js";
+import "./chunk-SKMHS4CL.js";
+import {
+  knowledgeAppliesMarkdown,
+  readKnowledgeApplies
+} from "./chunk-EV4TEFOD.js";
+import "./chunk-6N2GUZMZ.js";
+import {
+  readRound,
+  reviewedGates,
+  roundsOf
+} from "./chunk-T6ESD5KM.js";
+import "./chunk-3LU6YCSQ.js";
+import "./chunk-L7I5PKGD.js";
+import "./chunk-CAN3EBE5.js";
+import "./chunk-IILZ7J3L.js";
+import "./chunk-TEBBD4XH.js";
+import "./chunk-XPWSNKF3.js";
+import "./chunk-WIMOJMAK.js";
+import "./chunk-5V5BJACL.js";
+import "./chunk-GVFUEGGM.js";
+import "./chunk-XNRPCI23.js";
+import "./chunk-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/handoff-review.js
+var days = (d) => `${d.p20}\u2013${d.p80} days (most likely ${d.p50})`;
+async function handoffReview(root, change) {
+  const lines = [];
+  lines.push("### What it changes", "");
+  const map = await changeMapOf(root, change).catch(() => void 0);
+  if (map && map.flows > 0) {
+    lines.push("```mermaid", changeMapBody(change, map).mermaid.trimEnd(), "```", "");
+    lines.push(`From ${map.flows} target flow${map.flows === 1 ? "" : "s"} in ${map.source}.`, "");
+  } else
+    lines.push("No target flows yet: the architecture stage writes them.", "");
+  const applies = await readKnowledgeApplies(root, change).catch(() => void 0);
+  if (applies)
+    lines.push(knowledgeAppliesMarkdown(applies).trimEnd(), "");
+  lines.push("### Estimate", "");
+  const est = await estimateOf(root, change).catch(() => void 0);
+  if (est?.effort) {
+    lines.push(days(est.effort), "");
+    for (const d of est.drivers.filter((x) => x.count > 0).slice(0, 5))
+      lines.push(`- ${d.what}: ${d.count}`);
+    if (est.needsClass)
+      lines.push(`- ${est.needsClass} unit${est.needsClass === 1 ? "" : "s"} not sized yet`);
+    lines.push("");
+  } else
+    lines.push(est ? "Not sized yet: the org pack's estimates don't cover these units." : "Not sized yet.", "");
+  lines.push("### Since the last round", "");
+  const reviewed = await reviewedGates(root, change).catch(() => []);
+  const openIds = async (gate, n) => new Set((await readRound(root, change, gate, n)).findings.filter(({ finding: f }) => f.state === "open").map(({ finding: f }) => f.id));
+  const code = (ids) => ids.map((i) => `\`${i}\``).join(", ");
+  let any = false;
+  for (const gate of reviewed) {
+    const rounds = await roundsOf(root, change, gate);
+    if (!rounds.length)
+      continue;
+    any = true;
+    if (rounds.length === 1) {
+      lines.push(`- ${gate} gate: the first round.`);
+      continue;
+    }
+    const [before, now] = [rounds.at(-2), rounds.at(-1)];
+    const [was, is] = [await openIds(gate, before), await openIds(gate, now)];
+    const closed = [...was].filter((i) => !is.has(i)).sort();
+    const added = [...is].filter((i) => !was.has(i)).sort();
+    const still = [...is].filter((i) => was.has(i)).length;
+    lines.push(`- ${gate} gate, round ${now} against round ${before}: ${closed.length} closed${closed.length ? ` (${code(closed)})` : ""}, ${added.length} new${added.length ? ` (${code(added)})` : ""}, ${still} still open.`);
+  }
+  if (!any)
+    lines.push("No gate has been reviewed yet.");
+  lines.push("");
+  lines.push("### Findings still open", "");
+  const gates = await reviewedGates(root, change).catch(() => []);
+  const open = [];
+  for (const gate of gates) {
+    const rounds = await roundsOf(root, change, gate);
+    if (!rounds.length)
+      continue;
+    for (const { finding: f } of (await readRound(root, change, gate, rounds.at(-1))).findings)
+      if (f.state === "open")
+        open.push({ gate, severity: f.severity, summary: f.summary, id: f.id });
+  }
+  if (!gates.length)
+    lines.push("No gate has been reviewed yet.", "");
+  else if (!open.length)
+    lines.push("None open.", "");
+  else {
+    const order = ["blocking", "gap", "risk", "idea"];
+    for (const f of open.sort((a, b) => order.indexOf(a.severity) - order.indexOf(b.severity)))
+      lines.push(`- **${f.severity}** (${f.gate}): ${f.summary} \`${f.id}\``);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+export {
+  handoffReview
+};