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

package/dist/chunk-5F3RJCHB.js

@@ -0,0 +1,45 @@
+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 {
+  BASELINE_FILE,
+  baselineCommand,
+  readBaseline,
+  setupCommand,
+  setupSteps
+} from "./chunk-XTVDAHH2.js";
+import "./chunk-DPHCFZ7W.js";
+import "./chunk-FV5YFR6I.js";
+import "./chunk-3G4YI4ZU.js";
+import "./chunk-Y4BRGOJR.js";
+import "./chunk-R64GLVBO.js";
+import "./chunk-LK44ULGI.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-CHC5FKTU.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 {
+  BASELINE_FILE,
+  baselineCommand,
+  readBaseline,
+  setupCommand,
+  setupSteps
+};

package/dist/chunk-5IALSMZ2.js

@@ -0,0 +1,34 @@
+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 {
+  coverageCommand,
+  patternsScan,
+  questionsCommand,
+  sourcesAdd,
+  sourcesSync
+} from "./chunk-F2FOQLJ7.js";
+import "./chunk-IV7BCWWN.js";
+import "./chunk-ROTY5J2L.js";
+import "./chunk-VOGCSYOI.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";
+export {
+  coverageCommand,
+  patternsScan,
+  questionsCommand,
+  sourcesAdd,
+  sourcesSync
+};

package/dist/chunk-5KTOPOEP.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 {
+  setupSteps
+} from "./chunk-XTVDAHH2.js";
+import "./chunk-DPHCFZ7W.js";
+import {
+  doctorChecks
+} from "./chunk-FV5YFR6I.js";
+import "./chunk-3G4YI4ZU.js";
+import "./chunk-Y4BRGOJR.js";
+import "./chunk-R64GLVBO.js";
+import "./chunk-LK44ULGI.js";
+import "./chunk-KC5DROFC.js";
+import "./chunk-RK6MKKKP.js";
+import "./chunk-47QE246J.js";
+import {
+  changeStore
+} from "./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 {
+  VERSION
+} from "./chunk-CHC5FKTU.js";
+import {
+  loadRepos
+} from "./chunk-PGKHJYOB.js";
+import "./chunk-MKRBG5EF.js";
+import "./chunk-5XDNUJ4P.js";
+import {
+  API_VERSION,
+  catalogDirOf,
+  inputsDirOf,
+  isAdopted,
+  loadOrgPack,
+  orgPackDirOf,
+  zip
+} from "./chunk-577AJVRS.js";
+import {
+  SCHEMA_VERSION,
+  logFileOf,
+  redactText,
+  writeFileAtomic
+} from "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/support.js
+import { readdir, readFile, stat } from "node:fs/promises";
+import { arch, platform, release } from "node:os";
+import { join, resolve } from "node:path";
+var LOG_LINES = 2e3;
+function scrub(text, root) {
+  const variants = [root, root.replace(/\\/g, "/"), root.replace(/\//g, "\\")];
+  let out = text;
+  for (const v of variants)
+    if (v.length > 3)
+      out = out.split(v).join("<metarepo>");
+  return redactText(out);
+}
+async function countFiles(dir) {
+  try {
+    return (await readdir(dir, { recursive: true, withFileTypes: true })).filter((e) => e.isFile()).length;
+  } catch {
+    return 0;
+  }
+}
+async function lastLines(file, n) {
+  try {
+    const text = await readFile(file, "utf8");
+    return text.split("\n").slice(-n - 1).join("\n");
+  } catch {
+    return void 0;
+  }
+}
+async function bundleFiles(root, deps = {}) {
+  const op = await loadOrgPack(orgPackDirOf(root));
+  const doctor = await doctorChecks(root, deps);
+  const setup = await setupSteps(root, { doctor });
+  const kinds = {};
+  for (const sub of ["generated", "curated"]) {
+    const dir = join(catalogDirOf(root), sub);
+    for (const k of await readdir(dir).catch(() => [])) {
+      if (!(await stat(join(dir, k)).catch(() => void 0))?.isDirectory())
+        continue;
+      kinds[`${sub}/${k}`] = await countFiles(join(dir, k));
+    }
+  }
+  const states = {};
+  for (const c of await changeStore(root).list().catch(() => []))
+    states[c.state] = (states[c.state] ?? 0) + 1;
+  const repos = await loadRepos(root).catch(() => []);
+  const about = {
+    atticus: VERSION,
+    catalogSchema: SCHEMA_VERSION,
+    api: API_VERSION,
+    node: process.versions.node,
+    os: { platform: platform(), release: release(), arch: arch() },
+    layout: isAdopted(root) ? "adopted" : "metarepo",
+    ai: op.runtime.ai,
+    modes: op.runtime.modes,
+    adapters: Object.fromEntries(Object.entries(op.runtime.adapters).filter(([, a]) => a).map(([k, a]) => [k, a.type])),
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const counts = {
+    records: kinds,
+    changes: states,
+    repos: repos.length,
+    inputs: await countFiles(inputsDirOf(root))
+  };
+  const files = [
+    {
+      name: "README.txt",
+      text: [
+        "Atticus support bundle",
+        "",
+        "Written by `atticus support bundle` on this machine. Nothing was sent anywhere.",
+        "",
+        "What is in it:",
+        "  about.json      versions, operating system, layout, AI mode and adapter types",
+        "  doctor.json     the machine checks (atticus doctor)",
+        "  setup.json      the setup checklist",
+        "  org-pack.json   problems loading the org pack (file and message)",
+        "  counts.json     how many records, changes, repos and input files: numbers, never names",
+        "  atticus.log     the last lines of the local log, redacted",
+        "",
+        "What is not in it: catalog records, changes, org-pack files, documents, code, tokens",
+        "or passwords. Paths start at <metarepo>, and your home folder and user name are hidden.",
+        "",
+        "Read every file before you send this outside your organisation. Error messages can",
+        "name a system, change or file of yours; remove anything you can't share.",
+        ""
+      ].join("\n")
+    },
+    { name: "about.json", text: JSON.stringify(about, null, 2) },
+    { name: "doctor.json", text: JSON.stringify(doctor, null, 2) },
+    { name: "setup.json", text: JSON.stringify(setup, null, 2) },
+    { name: "org-pack.json", text: JSON.stringify(op.problems, null, 2) },
+    { name: "counts.json", text: JSON.stringify(counts, null, 2) }
+  ];
+  const log = await lastLines(logFileOf(root), LOG_LINES);
+  if (log !== void 0)
+    files.push({ name: "atticus.log", text: log });
+  return files.map((f) => ({ name: f.name, text: scrub(f.text, root) }));
+}
+async function supportBundleCommand(root, o, io, deps = {}) {
+  const now = o.now ?? /* @__PURE__ */ new Date();
+  const files = await bundleFiles(root, deps);
+  const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\..*$/, "").replace("T", "-");
+  const out = resolve(o.out ?? join(root, ".atticus", "logs", `atticus-support-${stamp}.zip`));
+  await writeFileAtomic(out, zip(files.map((f) => ({ name: f.name, data: f.text })), now));
+  if (o.json)
+    io.out(JSON.stringify({ file: out, files: files.map((f) => f.name) }, null, 2));
+  else {
+    io.out(`Wrote ${out} (${files.length} files, nothing sent anywhere):`);
+    for (const f of files)
+      io.out(`  ${f.name}`);
+    io.out("Read every file before you send it outside your organisation (README.txt says why).");
+  }
+  return 0;
+}
+export {
+  bundleFiles,
+  supportBundleCommand
+};

package/dist/chunk-5MI2SEV5.js

@@ -0,0 +1,242 @@
+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 {
+  AUDIENCES,
+  ReleaseError,
+  deploymentPlan,
+  evidencePack,
+  loadRelease,
+  outcomesView,
+  recordOutcome,
+  releaseForecast,
+  releaseNotes,
+  securityReview,
+  writeEvidencePack
+} from "./chunk-5YIBJXGB.js";
+import {
+  judgingRuntime
+} from "./chunk-ROTY5J2L.js";
+import {
+  changeStore
+} from "./chunk-XQ3YIV5R.js";
+
+// packages/cli/dist/release-commands.js
+import { resolve } from "node:path";
+function fail(io, e) {
+  if (e instanceof ReleaseError) {
+    io.err(e.message);
+    return e.code === "usage" ? 2 : 1;
+  }
+  throw e;
+}
+var load = async (root, id, deps) => {
+  const runtime = await judgingRuntime(root, deps.runtime);
+  return loadRelease(root, id, {
+    ...deps.now ? { now: deps.now() } : {},
+    ...runtime ? { runtime } : {}
+  });
+};
+function lines(io, text) {
+  for (const l of text.replace(/\n$/, "").split("\n"))
+    io.out(l);
+}
+function planText(p, f) {
+  const out = [`Deployment plan for ${p.change} (${p.state}), ${p.today}`, ""];
+  for (const w of p.before)
+    out.push(`0. Before anything: ${w.requestType}${w.record ? ` for ${w.record}` : ""} (${w.state}${w.readyBy ? `, ready by ${w.readyBy}` : ""}). ${w.source}`);
+  for (const s of p.steps) {
+    out.push(`${s.n}. ${s.repo} (${s.kind})${s.waitDays ? `, from ${s.earliest}` : ""}`);
+    for (const w of s.what)
+      out.push(`   - ${w}`);
+    for (const y of s.why)
+      out.push(`   why: ${y}`);
+    for (const w of s.waitsOn)
+      out.push(`   waits on: ${w.requestType}${w.record ? ` for ${w.record}` : ""}, ${w.state === "filed" ? `filed${w.number ? ` as ${w.number}` : ""}` : w.state === "waiting" ? "waiting for a person to file it" : "not filed"}${w.readyBy ? `, ready by ${w.readyBy} (${w.waitDays} working days)` : ""}${w.missing.length ? `; missing ${w.missing.join(", ")}` : ""}`);
+    out.push(`   rollback: ${s.rollback.text ? `${s.rollback.text} (${s.rollback.source})` : `GAP: ${s.rollback.gap}`}`);
+  }
+  if (!p.steps.length)
+    out.push("No repo to deploy: the change names no interface, data change, task or repo.");
+  for (const x of p.external)
+    out.push(`External: ${x.what}${x.beforeStep ? `, before step ${x.beforeStep}` : ""}.`);
+  out.push("", "Release sections (design.md):");
+  for (const s of p.sections)
+    out.push(`  ${s.name}: ${s.text ? `${s.heading} (${s.source})` : `GAP: ${s.gap}`}`);
+  if (p.findings.length) {
+    out.push("", "Release lens findings still open:");
+    for (const x of p.findings)
+      out.push(`  ${x.severity}: ${x.summary} (${x.path})`);
+  }
+  out.push("", `Forecast: ${f.ready ? `ready by ${f.ready}` : "no date"}${f.target ? `, target ${f.target.date} (${f.status})` : ""}.`);
+  for (const d of f.drivers)
+    out.push(`  ${d.until}: ${d.what}. ${d.source}`);
+  const gaps = p.gaps.filter((g) => !/^No rollback step (written|judged)|^design\.md (has no|says nothing)/.test(g));
+  if (gaps.length) {
+    out.push("", "Gaps:");
+    for (const g of gaps)
+      out.push(`  - ${g}`);
+  }
+  for (const n of [...p.notes, ...f.notes])
+    out.push(`Note: ${n}`);
+  return out;
+}
+async function releasePlanCommand(root, id, o, io, deps = {}) {
+  if (!id) {
+    io.err("Usage: atticus release plan <change> [--json]");
+    return 2;
+  }
+  try {
+    const ctx = await load(root, id, deps);
+    const plan = await deploymentPlan(ctx);
+    const forecast = await releaseForecast(ctx, plan);
+    if (o.json)
+      io.out(JSON.stringify({ ...plan, forecast }, null, 2));
+    else
+      for (const l of planText(plan, forecast))
+        io.out(l);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function releaseForecastCommand(root, id, o, io, deps = {}) {
+  if (!id) {
+    io.err("Usage: atticus release forecast <change> [--json]");
+    return 2;
+  }
+  try {
+    const f = await releaseForecast(await load(root, id, deps));
+    if (o.json) {
+      io.out(JSON.stringify(f, null, 2));
+      return 0;
+    }
+    io.out(f.status === "released" ? `${f.change} is released${f.ready ? ` (${f.ready})` : ""}.` : `${f.change}: ready by ${f.ready} (${f.waitDays} working days)${f.target ? `; target ${f.target.date}, ${f.status} (${f.target.source})` : "; no target date"}.`);
+    for (const d of f.drivers)
+      io.out(`  ${d.until}: ${d.what}. ${d.source}`);
+    for (const n of f.notes)
+      io.out(`Note: ${n}`);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function releaseEvidenceCommand(root, id, o, io, deps = {}) {
+  if (!id) {
+    io.err("Usage: atticus release evidence <change> [--out <dir>] [--json]");
+    return 2;
+  }
+  try {
+    const ctx = await load(root, id, deps);
+    if (o.out) {
+      const dir = resolve(o.out);
+      const written = await writeEvidencePack(ctx, dir);
+      if (o.json)
+        io.out(JSON.stringify({ out: dir, written }, null, 2));
+      else
+        io.out(`Wrote the evidence pack for ${id} to ${dir}: evidence.md, manifest.json and ${written.length - 2} files.`);
+      return 0;
+    }
+    const pack = await evidencePack(ctx);
+    if (o.json)
+      io.out(JSON.stringify(pack, null, 2));
+    else
+      lines(io, pack.markdown);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function releaseNotesCommand(root, id, o, io, deps = {}) {
+  const audience = o.audience ?? "business";
+  if (!id || !AUDIENCES.includes(audience)) {
+    io.err("Usage: atticus release notes <change> [--audience business|technical] [--json]");
+    return 2;
+  }
+  try {
+    const n = await releaseNotes(await load(root, id, deps), audience);
+    if (o.json)
+      io.out(JSON.stringify(n, null, 2));
+    else
+      lines(io, n.markdown);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function releaseSecurityCommand(root, id, o, io, deps = {}) {
+  if (!id) {
+    io.err("Usage: atticus release security <change> [--json]");
+    return 2;
+  }
+  try {
+    const s = await securityReview(await load(root, id, deps));
+    if (o.json)
+      io.out(JSON.stringify(s, null, 2));
+    else
+      lines(io, s.markdown);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function outcomeList(root, o, io, deps = {}) {
+  try {
+    const ids = o.change ? [o.change] : (await changeStore(root).list()).map((c) => c.id).sort();
+    const views = [];
+    for (const id of ids)
+      views.push(await outcomesView(await load(root, id, deps)));
+    if (o.json) {
+      io.out(JSON.stringify(o.change ? views[0] : views, null, 2));
+      return 0;
+    }
+    if (!views.length)
+      io.out("No changes yet.");
+    for (const v of views) {
+      io.out(`${v.change} (${v.state}): ${v.title}`);
+      if (!v.measures.length)
+        io.out(`  ${v.gaps[0] ?? "No success measures."}`);
+      for (const m of v.measures)
+        io.out(`  ${m.n}. ${m.measure} [${m.id}]: ${m.latest ? `${m.latest.value} (${m.latest.by}, ${m.latest.at.slice(0, 10)})` : "not measured yet"}`);
+      for (const x of v.orphans)
+        io.out(`  ! ${x.id}: recorded, but brief.md no longer has this measure`);
+      if (v.why && v.measures.length)
+        io.out(`  ${v.why}`);
+    }
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function outcomeRecord(root, id, measure, o, io, deps = {}) {
+  if (!id || !measure || !o.value?.trim() || !o.by) {
+    io.err('Usage: atticus outcome record <change> <measure id or number> --value "<what you measured>" [--by <you>] [--note "<how>"]');
+    return 2;
+  }
+  try {
+    const r = await recordOutcome(await load(root, id, deps), {
+      measure,
+      value: o.value,
+      by: o.by,
+      ...o.note ? { note: o.note } : {}
+    });
+    if (o.json)
+      io.out(JSON.stringify(r, null, 2));
+    else
+      io.out(`Recorded "${r.value.value}" for ${r.measure.id} as ${r.value.by}. Wrote ${r.written}.`);
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+
+export {
+  releasePlanCommand,
+  releaseForecastCommand,
+  releaseEvidenceCommand,
+  releaseNotesCommand,
+  releaseSecurityCommand,
+  outcomeList,
+  outcomeRecord
+};