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

package/dist/chunk-XKZHAD6Y.js

@@ -0,0 +1,184 @@
+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 {
+  InitiativeError,
+  JOURNEYS,
+  initiativeStatus,
+  newInitiative,
+  planJourney,
+  recordCommitment,
+  requestFromTeam
+} from "./chunk-UYYN2IUZ.js";
+import {
+  table
+} from "./chunk-VOGCSYOI.js";
+import "./chunk-XQ3YIV5R.js";
+import "./chunk-MGVYVW7Q.js";
+import "./chunk-NGPU2ARF.js";
+import "./chunk-AY2IUF4K.js";
+import "./chunk-6JLPXDWN.js";
+import "./chunk-4GZXS6S2.js";
+import "./chunk-R4TBNKKC.js";
+import "./chunk-NIXVDQVO.js";
+import "./chunk-UR7RMZ3R.js";
+import "./chunk-PGKHJYOB.js";
+import "./chunk-MKRBG5EF.js";
+import "./chunk-5XDNUJ4P.js";
+import "./chunk-577AJVRS.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/initiative-commands.js
+function fail(io, e) {
+  if (e instanceof InitiativeError) {
+    io.err(e.message);
+    return e.code === "usage" ? 2 : 1;
+  }
+  throw e;
+}
+async function initiativeNew(root, o, io) {
+  if (!o.title || !o.journey || !o.by) {
+    io.err(`Usage: atticus initiative new "<title>" --journey <${JOURNEYS.join("|")}> [--by <you>] [--release YYYY-MM-DD]`);
+    return 2;
+  }
+  try {
+    const r = await newInitiative(root, {
+      title: o.title,
+      journey: o.journey,
+      by: o.by,
+      ...o.id ? { id: o.id } : {},
+      ...o.release ? { targetRelease: o.release } : {},
+      ...o.epic ? { adoEpic: o.epic } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify(r, null, 2));
+      return 0;
+    }
+    io.out(`Started ${r.initiative.id} (${r.initiative.journey}). Wrote ${r.written}.`);
+    io.out(`Plan it: atticus initiative plan ${r.initiative.id} --target <system>${o.release ? "" : " --release YYYY-MM-DD"}`);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function initiativePlan(root, id, o, io, deps = {}) {
+  if (!id || !o.by) {
+    io.err("Usage: atticus initiative plan <id> --target <system> [--release YYYY-MM-DD] [--by <you>] [--dry-run]");
+    return 2;
+  }
+  try {
+    const r = await planJourney(root, id, {
+      by: o.by,
+      ...o.target ? { target: o.target } : {},
+      ...o.release ? { targetRelease: o.release } : {},
+      ...o.systems?.length ? { systems: o.systems } : {},
+      ...o.dryRun ? { dryRun: true } : {},
+      ...deps.now ? { now: deps.now } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify(r, null, 2));
+      return 0;
+    }
+    io.out(`${r.initiative.title}: ${r.plan.items.length} items from ${r.plan.target} back to ${r.plan.targetRelease} (${r.plan.journey} journey, ${r.plan.journeySource}).`);
+    for (const l of table(["ITEM", "KIND", "WITH", "START", "DUE", "DAYS", "LEAD TIME FROM"], r.plan.items.map((i) => [
+      i.key,
+      i.kind,
+      i.party ?? i.change ?? i.owner ?? "",
+      i.start,
+      i.due,
+      String(i.days),
+      i.leadTime
+    ])))
+      io.out(l);
+    if (r.changes.length) {
+      io.out("Changes to start:");
+      for (const c of r.changes)
+        io.out(`  ${c.command}`);
+    }
+    for (const n of r.notes)
+      io.out(`Note: ${n}`);
+    io.out(o.dryRun ? "Dry run: nothing written." : `Wrote ${r.written.length} files (the plan and ${r.commitments.length} commitments).`);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function initiativeStatus2(root, id, o, io, deps = {}) {
+  if (!id) {
+    io.err("Usage: atticus initiative status <id> [--json]");
+    return 2;
+  }
+  try {
+    const s = await initiativeStatus(root, id, deps.now ? { now: deps.now } : {});
+    const bad = s.status === "at-risk" || s.status === "slipped";
+    if (o.json) {
+      io.out(JSON.stringify(s, null, 2));
+      return bad ? 1 : 0;
+    }
+    io.out(`${s.title} (${s.journey}): ${s.status}${s.targetRelease ? `; target ${s.targetRelease}` : ""}${s.projectedRelease ? `, projected ${s.projectedRelease}` : ""}.`);
+    if (s.criticalPath.length)
+      io.out(`Critical path: ${s.criticalPath.join(" \u2192 ")}`);
+    if (s.items.length)
+      for (const l of table(["ITEM", "STATUS", "DUE", "PROJECTED", "FLOAT", "WHY"], s.items.map((i) => [i.key, i.status, i.due, i.projectedFinish, String(i.float), i.why])))
+        io.out(l);
+    const open = s.commitments.filter((c) => c.status === "slipped" || c.status === "at-risk");
+    if (open.length) {
+      io.out("Commitments slipped or at risk:");
+      for (const c of open)
+        io.out(`  ${c.id} (${c.party}, needed by ${c.neededBy}): ${c.status}. ${c.why}`);
+    }
+    for (const n of s.notes)
+      io.out(`Note: ${n}`);
+    return bad ? 1 : 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function requestFromTeam2(root, initiativeId, partyId, o, io, deps = {}) {
+  if (!initiativeId || !partyId || !o.by) {
+    io.err("Usage: atticus initiative request <id> <party> [--by <you>] [--system s]...");
+    return 2;
+  }
+  try {
+    const r = await requestFromTeam(root, initiativeId, partyId, {
+      by: o.by,
+      ...o.systems?.length ? { systems: o.systems } : {},
+      ...deps.now ? { now: deps.now } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify({ ...r, card: void 0 }, null, 2));
+      return 0;
+    }
+    io.out(`Wrote the system card ${r.cardPath}.`);
+    io.out(`Tracked as ${r.commitment.id}: reply needed by ${r.commitment.neededBy}.`);
+    io.out(`Send it: atticus todo show ${r.step.id} (then atticus todo done ${r.step.id}).`);
+    io.out("When the reply comes, add it with atticus intake add <file>.");
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+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>]`);
+    return 2;
+  }
+  try {
+    const r = await recordCommitment(root, id, { status, by: o.by });
+    io.out(`${r.commitment.id} is ${status}. Wrote ${r.written}.`);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+export {
+  initiativeCommitment,
+  initiativeNew,
+  initiativePlan,
+  initiativeStatus2 as initiativeStatus,
+  requestFromTeam2 as requestFromTeam
+};

package/dist/chunk-XNYNEEBR.js

@@ -0,0 +1,214 @@
+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 {
+  contextFlags,
+  contextLines
+} from "./chunk-R6RY4Q5T.js";
+import {
+  findNeeds,
+  markNeed,
+  readNeeds
+} from "./chunk-KC5DROFC.js";
+import "./chunk-RK6MKKKP.js";
+import {
+  table
+} from "./chunk-VOGCSYOI.js";
+import "./chunk-47QE246J.js";
+import "./chunk-XQ3YIV5R.js";
+import "./chunk-MGVYVW7Q.js";
+import "./chunk-NGPU2ARF.js";
+import "./chunk-AY2IUF4K.js";
+import {
+  readKnowledge
+} from "./chunk-6JLPXDWN.js";
+import "./chunk-4GZXS6S2.js";
+import "./chunk-R4TBNKKC.js";
+import "./chunk-NIXVDQVO.js";
+import "./chunk-UR7RMZ3R.js";
+import "./chunk-N4QZJJVB.js";
+import "./chunk-PGKHJYOB.js";
+import "./chunk-MKRBG5EF.js";
+import {
+  RuntimeConfigError,
+  runtimeForCli
+} from "./chunk-5XDNUJ4P.js";
+import {
+  changesDirOf,
+  changesRelOf,
+  loadOrgPack,
+  orgPackDirOf
+} from "./chunk-577AJVRS.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/needs-commands.js
+import { readdir } from "node:fs/promises";
+var plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
+var stamp = (d) => d.toISOString().replace(/\.\d{3}Z$/, "Z");
+var forWords = (t) => t === "change" ? "the change" : t.replace(":", " ");
+async function changeNeeds(root, change, o, deps, io) {
+  let runtime = deps.runtime;
+  if (!runtime)
+    try {
+      runtime = (await runtimeForCli(root, o.mode ? { mode: o.mode } : {})).runtime;
+    } catch (e) {
+      if (e instanceof RuntimeConfigError) {
+        io.err(e.message);
+        return 2;
+      }
+      throw e;
+    }
+  const k = await readKnowledge(root, { cacheRoot: root });
+  if (!k.items.length) {
+    io.err("There are no knowledge items to check the change against yet. Run atticus sources sync, then atticus knowledge scan.");
+    return 2;
+  }
+  const op = await loadOrgPack(orgPackDirOf(root));
+  const r = await findNeeds(root, change, {
+    runtime,
+    orgPack: op,
+    ...deps.now ? { now: deps.now } : {},
+    ...o.resume ? { resume: o.resume } : {},
+    maxAttempts: o.attempts ?? 3,
+    ...o.context ? { context: o.context } : {}
+  }).catch((e) => {
+    io.err(e.message);
+    return void 0;
+  });
+  if (!r)
+    return 2;
+  if (o.json) {
+    io.out(JSON.stringify(r, null, 2));
+    return r.status === "failed" ? 1 : 0;
+  }
+  if (r.status === "waiting") {
+    io.out(`Handed the change's needs to your assistant (run ${r.runId}). When it is done: atticus handoff done ${r.runId}, then atticus change needs ${change} --resume ${r.runId}`);
+    return 0;
+  }
+  if (r.status === "failed") {
+    io.err(`No answer passed the checks after ${plural(r.attempts.length, "attempt")}: ${r.attempts.at(-1)?.problems.join("; ") ?? "no run"}. Nothing was written.`);
+    return 1;
+  }
+  for (const l of contextLines(r.context))
+    io.out(l);
+  const f = r.file;
+  const open = f.needs.filter((n) => n.status === "open");
+  io.out(`${change} needs ${plural(f.needs.length, "thing")} from the organisation (${open.length} open), each checked against the change's own words.`);
+  for (const n of f.needs)
+    io.out(`  ${line(n)}`);
+  io.out(`Written to ${changesRelOf(root)}/${change}/needs.yaml and needs.md. Mark each with atticus needs done or atticus needs skip.`);
+  return 0;
+}
+function line(n) {
+  const box = n.status === "open" ? "[ ]" : n.status === "done" ? "[x]" : "[-]";
+  return `${box} ${n.title} (${n.kind}, for ${forWords(n.for)})${n.leadTime ? `, ${n.leadTime}` : ""}${n.handledBy ? `, ${n.handledBy}` : ""}`;
+}
+async function changeIds(root) {
+  return (await readdir(changesDirOf(root), { withFileTypes: true }).catch(() => [])).filter((e) => e.isDirectory() && e.name !== "archive").map((e) => e.name).sort();
+}
+async function needsList(root, o, io) {
+  const k = await readKnowledge(root, { cacheRoot: root });
+  const rows = [];
+  for (const c of o.change ? [o.change] : await changeIds(root)) {
+    const f = await readNeeds(root, c);
+    for (const n of f?.needs ?? [])
+      if (o.all || n.status === "open") {
+        const rv = k.reviews[n.item];
+        rows.push({
+          ...n,
+          change: c,
+          ...rv && (rv.state === "verified" || rv.state === "corrected") ? { verified: rv.by } : {}
+        });
+      }
+  }
+  if (o.json) {
+    io.out(JSON.stringify(rows, null, 2));
+    return 0;
+  }
+  if (!rows.length) {
+    io.out(o.change ? `${o.change} has no ${o.all ? "" : "open "}needs. atticus change needs ${o.change} finds them.` : "No change has an open need.");
+    return 0;
+  }
+  for (const l of table(["CHANGE", "NEED", "KIND", "FOR", "LEAD TIME", "HANDLED BY", "STATE"], rows.map((n) => [
+    n.change,
+    `${n.item}${n.verified ? " \u2713" : ""}`,
+    n.kind,
+    forWords(n.for),
+    n.leadTime ?? "",
+    n.handledBy ?? "",
+    n.status
+  ])))
+    io.out(l);
+  if (rows.some((n) => n.verified))
+    io.out("\u2713 a person verified the knowledge item it comes from");
+  return 0;
+}
+async function needsCli(root, positionals, values, io, who, deps = {}) {
+  const [group, command, a, b] = positionals;
+  const str = (v) => typeof v === "string" && v.trim() ? v : void 0;
+  const json = values.json === true;
+  if (group === "change" && command === "needs") {
+    if (!a) {
+      io.err("Usage: atticus change needs <change> [--mode m] [--resume run] [--attempts 3]");
+      return 2;
+    }
+    const attempts = Number(str(values.attempts) ?? "3");
+    if (!Number.isInteger(attempts) || attempts < 1 || attempts > 10) {
+      io.err("--attempts is a whole number from 1 to 10.");
+      return 2;
+    }
+    const flags = contextFlags(values);
+    if ("error" in flags) {
+      io.err(flags.error);
+      return 2;
+    }
+    return changeNeeds(root, a, {
+      attempts,
+      json,
+      context: flags.context,
+      ...str(values.resume) ? { resume: str(values.resume) } : {},
+      ...str(values.mode) ? { mode: str(values.mode) } : {}
+    }, deps, io);
+  }
+  if (group !== "needs")
+    return void 0;
+  if (command === "done" || command === "skip" || command === "reopen") {
+    if (!a || !b) {
+      io.err(`Usage: atticus needs ${command} <change> <item> [--for target]${command === "skip" ? " --note why" : " [--note text]"}`);
+      return 2;
+    }
+    const r = await markNeed(root, a, b, {
+      status: command === "done" ? "done" : command === "skip" ? "not-needed" : "open",
+      by: who(),
+      at: stamp(deps.now ?? /* @__PURE__ */ new Date()),
+      ...str(values.note) ? { note: str(values.note) } : {},
+      ...str(values.for) ? { for: str(values.for) } : {}
+    });
+    if ("error" in r) {
+      io.err(r.error);
+      return 2;
+    }
+    if (json)
+      io.out(JSON.stringify(r.need, null, 2));
+    else
+      io.out(`${r.need.title} (${forWords(r.need.for)}) is ${r.need.status === "not-needed" ? "not needed" : r.need.status} for ${a}${r.need.by && r.need.status !== "open" ? `, by ${r.need.by}` : ""}. Commit ${changesRelOf(root)}/${a}/needs.yaml with the change.`);
+    return 0;
+  }
+  if (command && command !== "list") {
+    io.err("Usage: atticus needs [--change id] [--all] | needs done|skip|reopen <change> <item>");
+    return 2;
+  }
+  return needsList(root, {
+    json,
+    all: values.all === true,
+    ...str(values.change) ? { change: str(values.change) } : {}
+  }, io);
+}
+export {
+  changeNeeds,
+  needsCli,
+  needsList
+};

package/dist/chunk-XPCWQXTY.js

@@ -0,0 +1,37 @@
+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 {
+  changeMapBody,
+  changeMapCommand,
+  changeMapOf,
+  targetFlowsOf
+} from "./chunk-67J3VZBA.js";
+import "./chunk-P3TKKBAH.js";
+import "./chunk-KC5DROFC.js";
+import "./chunk-RK6MKKKP.js";
+import "./chunk-47QE246J.js";
+import "./chunk-XQ3YIV5R.js";
+import "./chunk-MGVYVW7Q.js";
+import "./chunk-NGPU2ARF.js";
+import "./chunk-AY2IUF4K.js";
+import "./chunk-6JLPXDWN.js";
+import "./chunk-4GZXS6S2.js";
+import "./chunk-R4TBNKKC.js";
+import "./chunk-NIXVDQVO.js";
+import "./chunk-UR7RMZ3R.js";
+import "./chunk-N4QZJJVB.js";
+import "./chunk-PGKHJYOB.js";
+import "./chunk-MKRBG5EF.js";
+import "./chunk-5XDNUJ4P.js";
+import "./chunk-577AJVRS.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+export {
+  changeMapBody,
+  changeMapCommand,
+  changeMapOf,
+  targetFlowsOf
+};