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

package/dist/chunk-CR3MTH32.js

@@ -0,0 +1,207 @@
+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 {
+  repoFor
+} from "./chunk-O3WI5KWW.js";
+import {
+  frameworkFacts,
+  insideRepo,
+  parseReviewed
+} from "./chunk-PAMPPUR6.js";
+import {
+  changesSince,
+  createGit
+} from "./chunk-EFHQ3TWP.js";
+import {
+  QuestionDraft,
+  factsDirOf,
+  isAdopted,
+  isSecretPath,
+  orgPackDirOf,
+  parseCorrections,
+  raiseQuestions,
+  require_dist,
+  serializeFacts
+} from "./chunk-S2A7YC3Q.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/facts-files.js
+var import_yaml = __toESM(require_dist(), 1);
+import { existsSync } from "node:fs";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+async function checkoutOf(root, repo, dir) {
+  return dir ?? (isAdopted(root) ? root : (await repoFor(root, repo))?.dir ?? void 0);
+}
+async function headOf(dir) {
+  try {
+    const r = await createGit({ timeoutMs: 3e4 })(["rev-parse", "HEAD"], dir);
+    return r.stdout.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function carryOf(dir, facts, commit, git) {
+  if (!commit)
+    return { carry: {}, missing: [] };
+  const r = await changesSince(dir, facts.map((f) => f.commit), commit, git);
+  return { carry: r.changes, missing: r.missing };
+}
+async function excludesOf(root, repo) {
+  const file = join(orgPackDirOf(root), "scan", `${repo}.yaml`);
+  if (!existsSync(file))
+    return [];
+  try {
+    const doc = (0, import_yaml.parse)(await readFile(file, "utf8"));
+    return (doc?.exclude ?? []).map((e) => e.path).filter((p) => !!p);
+  } catch {
+    return [];
+  }
+}
+async function raiseReadQuestions(root, repo, lines, source, by) {
+  const drafts = [];
+  const problems = [];
+  for (const raw of lines) {
+    const line = JSON.stringify(raw);
+    const r2 = QuestionDraft.safeParse(raw);
+    if (!r2.success) {
+      problems.push({
+        line,
+        message: `not a question: ${r2.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`
+      });
+      continue;
+    }
+    const bad = r2.data.evidence.find((e) => {
+      const file = e.slice(0, e.lastIndexOf(":"));
+      const n = Number(e.slice(e.lastIndexOf(":") + 1));
+      if (!insideRepo(file) || isSecretPath(file))
+        return true;
+      const text = source.read(file);
+      return text === void 0 || n < 1 || n > text.split(/\r?\n/).length;
+    });
+    if (bad) {
+      problems.push({ line, message: `its evidence ${bad} is no line of the repo` });
+      continue;
+    }
+    drafts.push(r2.data);
+  }
+  if (!drafts.length)
+    return { raised: [], known: [], problems };
+  const r = await raiseQuestions(root, drafts, {
+    step: "map",
+    repo,
+    command: by.command,
+    rerun: `atticus map ${repo}`,
+    ...by.run ? { run: by.run } : {},
+    at: by.at
+  });
+  return { raised: r.raised, known: [...r.known, ...r.reused], problems };
+}
+async function writeVerifyFiles(root, repo, report, commit, questionProblems = [], badLines = [], reviewedProblems = []) {
+  const dir = factsDirOf(root);
+  await mkdir(dir, { recursive: true });
+  await writeFile(join(dir, `${repo}.jsonl`), serializeFacts(report.accepted), "utf8");
+  const rejectedFile = join(dir, `${repo}.rejected.jsonl`);
+  const lines = [
+    ...report.rejected.map((r) => JSON.stringify({ code: r.code, message: r.message, fact: r.fact })),
+    ...questionProblems.map((q) => JSON.stringify({ code: "bad-question", message: q.message, question: JSON.parse(q.line) })),
+    ...badLines.map((b) => JSON.stringify({ code: "schema", message: b.message, raw: b.raw })),
+    ...reviewedProblems.map((r) => JSON.stringify({ code: "bad-reviewed", message: r.message, reviewed: r.raw }))
+  ];
+  if (lines.length)
+    await writeFile(rejectedFile, lines.join("\n") + "\n", "utf8");
+  else
+    await rm(rejectedFile, { force: true });
+  const summary = {
+    repo,
+    ...commit ? { commit } : {},
+    accepted: report.accepted.length,
+    rejected: report.rejected.length,
+    redacted: report.redacted,
+    ...report.quotesDropped ? { quotesDropped: report.quotesDropped } : {},
+    coverage: {
+      ratio: report.coverage.ratio,
+      read: report.coverage.read.length,
+      ...report.coverage.reviewed.length ? { reviewed: report.coverage.reviewed.length } : {},
+      unknown: report.coverage.unknown,
+      excluded: report.coverage.excluded
+    },
+    rejections: report.rejected.map((r) => ({ id: r.fact.id, code: r.code, message: r.message })),
+    // ADR 0124 addendum D-app: a person's corrections, said only when there are some.
+    ...report.corrections.applied.length || report.corrections.stale.length ? {
+      corrections: {
+        applied: report.corrections.applied,
+        stale: report.corrections.stale.map((s) => ({
+          fact: s.correction.fact,
+          why: s.why,
+          message: s.message
+        }))
+      }
+    } : {}
+  };
+  if (report.carried.length) {
+    const by = /* @__PURE__ */ new Map();
+    for (const c of report.carried)
+      by.set(c.from, [...by.get(c.from) ?? [], c.id]);
+    summary.carried = [...by.entries()].sort((a, b) => a[0] < b[0] ? -1 : 1).map(([from, facts]) => ({ from, facts: facts.sort() }));
+  }
+  if (report.entriesNoFlowFollows.length)
+    summary.entriesNoFlowFollows = report.entriesNoFlowFollows;
+  if (report.reviewed.length)
+    summary.reviewed = report.reviewed;
+  if (report.authUncited.length)
+    summary.authUncited = report.authUncited;
+  const fws = frameworkFacts(report.accepted);
+  if (fws.length)
+    summary.frameworks = fws.map((f) => ({
+      name: f.name,
+      ...f.version ? { version: f.version } : {},
+      cite: `${f.cite.file}:${f.cite.line}`,
+      ...f.component ? { component: f.component } : {}
+    }));
+  if (report.frameworkGaps.length)
+    summary.frameworkGaps = report.frameworkGaps;
+  await writeFile(join(dir, `${repo}.verify.yaml`), (0, import_yaml.stringify)(summary), "utf8");
+  return summary;
+}
+async function readCorrections(root, repo) {
+  const text = await readFile(join(factsDirOf(root), `${repo}.corrections.jsonl`), "utf8").catch(() => void 0);
+  return text === void 0 ? { corrections: [], bad: [] } : parseCorrections(text);
+}
+async function readReviewed(root, repo) {
+  const text = await readFile(join(factsDirOf(root), `${repo}.reviewed.jsonl`), "utf8").catch(() => void 0);
+  if (text === void 0)
+    return { entries: [], bad: [] };
+  const r = parseReviewed(text);
+  return {
+    entries: r.entries,
+    bad: r.bad.map((b) => ({ line: b.line, raw: b.raw, message: b.message }))
+  };
+}
+function reviewedProblemsOf(bad, report) {
+  return [
+    ...bad,
+    ...report.reviewedProblems.map((p) => ({
+      ...p.line !== void 0 ? { line: p.line } : {},
+      raw: { path: p.path, why: p.why },
+      message: p.message
+    }))
+  ].sort((a, b) => (a.line ?? 0) - (b.line ?? 0));
+}
+
+export {
+  checkoutOf,
+  headOf,
+  carryOf,
+  excludesOf,
+  raiseReadQuestions,
+  writeVerifyFiles,
+  readCorrections,
+  readReviewed,
+  reviewedProblemsOf
+};

package/dist/chunk-CSZ4C5N6.js

@@ -0,0 +1,307 @@
+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 {
+  RunLevel,
+  completeTaskHandoff,
+  runTask
+} from "./chunk-CEXSU4S6.js";
+import {
+  driftCheck,
+  handDown,
+  handUp
+} from "./chunk-OT2O76OS.js";
+import {
+  generateAssistantFiles,
+  smokeCheck
+} from "./chunk-IPKHE5D6.js";
+import {
+  createAdapters,
+  fileStepStore
+} from "./chunk-7JUKDRSZ.js";
+import {
+  RUNTIME_MODES,
+  runtimeForCli
+} from "./chunk-CNUKCS2T.js";
+import {
+  changesRelOf,
+  loadOrgPack,
+  orgPackDirOf,
+  runsRelOf
+} from "./chunk-S2A7YC3Q.js";
+
+// packages/cli/dist/run-commands.js
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+var KNOWN = /* @__PURE__ */ new Set([
+  "SpecKitError",
+  "TaskRunError",
+  "RuntimeConfigError",
+  "AssistantFilesError",
+  "ChangeError",
+  "ChangeFileError",
+  "AdapterError",
+  "WorkspaceFileError"
+]);
+function fail(io, e) {
+  if (e instanceof Error && KNOWN.has(e.name)) {
+    io.err(e.message);
+    return e.code === "invalid" ? 2 : 1;
+  }
+  throw e;
+}
+var plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
+function describeRun(root, r, io) {
+  const what = {
+    planned: `Wrote the plan for task ${r.task}: ${changesRelOf(root)}/${r.change}/tasks/${r.task}/plan.md.`,
+    waiting: `Handed task ${r.task} to your assistant. The prompt is in ${runsRelOf(root)}/${r.change}/${r.waiting}/prompt.md; it ends with: atticus handoff done ${r.waiting}`,
+    built: `Task ${r.task} is drafted on ${r.branch} and the build passes (${plural(r.attempts.length, "attempt")}); committed ${r.commit?.slice(0, 12) ?? ""}.`,
+    unverified: `Task ${r.task} is drafted on ${r.branch} but wasn't built: ${r.repo} has no build command.`,
+    "pr-open": `Opened PR ${r.pr?.url ?? ""} from ${r.branch} for review.`,
+    "needs-person": `Task ${r.task} needs a person in ${r.worktree}.`,
+    failed: `The run for task ${r.task} failed.`
+  };
+  const reason = r.state === "failed" ? r.notes.at(-1) : void 0;
+  io.out(reason ? `The run for task ${r.task} failed: ${reason}` : what[r.state]);
+  for (const n of reason ? r.notes.slice(0, -1) : r.notes)
+    io.out(`  ${n}`);
+  return r.state === "failed" || r.state === "needs-person" ? 1 : 0;
+}
+async function taskRun(root, changeId, taskId, o, io, deps = {}) {
+  if (!changeId || !taskId) {
+    io.err("Usage: atticus task run <change> <task> [--by <you>] [--level plan|draft|pr] [--mode hand-off|model|headless-claude-code] [--approve]");
+    return 2;
+  }
+  if (!o.by) {
+    io.err("Say who is running the task: set your Git user (git config user.name), or pass --by <you>.");
+    return 2;
+  }
+  if (o.level !== void 0 && !RunLevel.safeParse(o.level).success) {
+    io.err(`Unknown level ${o.level}. Use one of: plan, draft, pr.`);
+    return 2;
+  }
+  const env = deps.env ?? process.env;
+  const mode = o.mode ?? env.ATTICUS_RUNTIME;
+  if (mode !== void 0 && (!RUNTIME_MODES.includes(mode) || mode === "mock")) {
+    io.err(`Unknown mode ${mode}. Use one of: hand-off, model, headless-claude-code, replay.`);
+    return 2;
+  }
+  const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+  try {
+    const r = await runTask(root, changeId, taskId, {
+      by: o.by,
+      ...o.level ? { level: o.level } : {},
+      ...mode ? { mode } : {},
+      ...env.ATTICUS_REPLAY_DIR ? { replayDir: env.ATTICUS_REPLAY_DIR } : {},
+      ...o.approve ? {
+        approval: {
+          by: o.by,
+          at: now().toISOString(),
+          ref: `task ${taskId} of ${changeId}: push and PR`
+        }
+      } : {},
+      ...deps.runtime ? { runtime: deps.runtime } : {},
+      ...deps.runtimeOptions ? { runtimeOptions: deps.runtimeOptions } : {},
+      ...deps.commands ? { commands: deps.commands } : {},
+      ...deps.git ? { git: deps.git } : {},
+      ...deps.gitHost ? { gitHost: deps.gitHost } : {},
+      now
+    });
+    if (o.json) {
+      io.out(JSON.stringify(r, null, 2));
+      return r.state === "failed" || r.state === "needs-person" ? 1 : 0;
+    }
+    return describeRun(root, r, io);
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function taskHandoff(root, runId, o, io, deps = {}) {
+  if (!runId) {
+    io.err("Usage: atticus handoff done <run-id>");
+    return 2;
+  }
+  const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+  try {
+    const r = await completeTaskHandoff(root, runId, {
+      ...o.approve && o.by ? { approval: { by: o.by, at: now().toISOString(), ref: `${runId}: push and PR` } } : {},
+      ...deps.commands ? { commands: deps.commands } : {},
+      ...deps.git ? { git: deps.git } : {},
+      ...deps.gitHost ? { gitHost: deps.gitHost } : {},
+      now
+    });
+    if (o.json)
+      io.out(JSON.stringify(r, null, 2));
+    else if (r.state === "waiting")
+      io.out(`The build still fails; fix it in ${r.worktree} and run atticus handoff done ${runId} again.`);
+    else
+      return describeRun(root, r, io);
+    return r.state === "waiting" ? 1 : 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function specHandDown(root, changeId, taskId, o, io, deps = {}) {
+  if (!changeId || !taskId) {
+    io.err("Usage: atticus spec hand-down <change> <task> [--force]");
+    return 2;
+  }
+  try {
+    const r = await handDown(root, changeId, taskId, {
+      ...o.force ? { force: true } : {},
+      ...deps.git ? { git: deps.git } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify(r, null, 2));
+      return 0;
+    }
+    io.out(r.engine === "speckit" ? `Handed task ${r.task} down to ${r.repo} as the Spec Kit feature ${r.feature}, in ${r.worktree}.` : `Handed task ${r.task} down to ${r.repo} as ${r.feature}/${r.task}.md, in ${r.worktree}.`);
+    for (const f of r.written)
+      io.out(`  wrote ${f}`);
+    for (const f of r.kept)
+      io.out(`  kept ${f} (changed since the last hand-down; --force replaces it)`);
+    const af = r.assistantFiles.results.filter((x) => x.written).length;
+    if (af)
+      io.out(`  ${plural(af, "assistant file")} written or updated`);
+    for (const p of r.problems)
+      io.err(p);
+    io.out(r.commit ? `Committed ${r.commit.slice(0, 12)} on change/${r.change}; nothing was pushed.` : "Nothing new to commit.");
+    return 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function specHandUp(root, changeId, taskId, o, io, deps = {}) {
+  if (!changeId || !taskId) {
+    io.err("Usage: atticus spec hand-up <change> <task> [--by <you>] [--pr <number> --pr-url <url>]");
+    return 2;
+  }
+  if (!o.by) {
+    io.err("Say who is handing the task up: set your Git user (git config user.name), or pass --by <you>.");
+    return 2;
+  }
+  if (o.pr === void 0 !== (o.prUrl === void 0)) {
+    io.err("Give both --pr <number> and --pr-url <url>, or neither.");
+    return 2;
+  }
+  try {
+    const runtime = deps.runtime ?? (await runtimeForCli(root, { ...deps.env ? { env: deps.env } : {} })).runtime;
+    let gitHost = deps.gitHost;
+    if (!gitHost && o.pr === void 0) {
+      const op = await loadOrgPack(join(orgPackDirOf(root)));
+      gitHost = createAdapters(op.runtime, {}, { store: fileStepStore(root), root, procedures: op.procedures }).gitHost;
+    }
+    const r = await handUp(root, changeId, taskId, {
+      by: o.by,
+      runtime,
+      ...gitHost ? { gitHost } : {},
+      ...o.pr !== void 0 ? { pr: { number: o.pr, url: o.prUrl } } : {},
+      ...deps.git ? { git: deps.git } : {},
+      ...deps.now ? {
+        now: deps.now().toISOString().replace(/\.\d{3}Z$/, "Z")
+      } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify(r, null, 2));
+      return 0;
+    }
+    io.out(`Task ${r.task} is handed up from PR ${r.pr.url}${r.markedDone ? " and marked done in tasks.md" : ""}.`);
+    for (const e of r.evidence)
+      io.out(`  evidence: ${changesRelOf(root)}/${r.change}/${e}`);
+    const lens = r.lens.state === "ran" ? `the complete lens raised ${plural(r.review?.findings.filter((f) => f.finding.artifact.startsWith(`tasks/${r.task}/`)).length ?? 0, "finding")}` : `the complete lens ${r.lens.state === "waiting" ? "is waiting" : `was ${r.lens.state}`}${r.lens.reason ? `: ${r.lens.reason}` : ""}`;
+    io.out(`  ${lens[0].toUpperCase()}${lens.slice(1)}.`);
+    io.out(`  Drift: ${r.drift.found.length ? plural(r.drift.found.length, "finding") : "none"}.`);
+    return r.drift.found.some((f) => f.severity === "blocking") ? 1 : 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function driftCommand(root, changeId, o, io, deps = {}) {
+  if (!changeId) {
+    io.err("Usage: atticus drift <change> [--json]");
+    return 2;
+  }
+  try {
+    const r = await driftCheck(root, changeId, deps.now ? {
+      now: deps.now().toISOString().replace(/\.\d{3}Z$/, "Z")
+    } : {});
+    const open = r.findings.filter((f) => f.finding.state === "open");
+    if (o.json) {
+      io.out(JSON.stringify({
+        change: r.change,
+        round: r.round,
+        unchanged: r.unchanged,
+        plans: r.plans.map((p) => ({ repo: p.repo, feature: p.feature.feature, from: p.from })),
+        findings: r.findings.map((f) => ({ ...f.finding, path: f.path }))
+      }, null, 2));
+      return open.length ? 1 : 0;
+    }
+    if (r.plans.length === 0)
+      io.out(`No repo plans for ${r.change} yet; the design was compared with the code only.`);
+    else
+      io.out(`Compared the design of ${r.change} with ${plural(r.plans.length, "repo plan")} and the code.`);
+    if (!r.findings.length) {
+      io.out("No drift.");
+      return 0;
+    }
+    for (const f of r.findings)
+      io.out(`  [${f.finding.severity}${f.finding.state === "open" ? "" : `, ${f.finding.state}`}] ${f.finding.summary} (${f.path})`);
+    io.out(`${plural(open.length, "open finding")} on the drift gate, round ${r.round}${r.unchanged ? " (unchanged)" : ""}. A blocking one stops the PR until the design is amended or the plan is fixed.`);
+    return open.length ? 1 : 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+async function assistantFiles(root, o, io) {
+  if (o.change && !o.repo) {
+    io.err("--change goes with --repo: atticus assistant-files --repo <id> --change <id>");
+    return 2;
+  }
+  const { isMetarepo, notMetarepo } = await import("./chunk-76WKMA4J.js");
+  if (!isMetarepo(root)) {
+    io.err(notMetarepo(root));
+    return 2;
+  }
+  try {
+    const r = await generateAssistantFiles(root, {
+      ...o.repo ? { repo: o.repo } : {},
+      ...o.change ? { change: o.change } : {},
+      ...o.force ? { force: true } : {},
+      ...o.check ? { check: true } : {}
+    });
+    const files = o.check ? [] : await Promise.all(r.results.filter((x) => x.action !== "kept-not-generated").map(async (x) => ({
+      path: x.path,
+      content: await readFile(join(r.dir, x.path), "utf8")
+    })));
+    const smoke = smokeCheck(files);
+    if (o.json) {
+      io.out(JSON.stringify({ dir: r.dir, profile: r.profile, results: r.results, problems: r.problems, smoke }, null, 2));
+    } else {
+      for (const x of r.results.filter((y) => y.action !== "unchanged"))
+        io.out(`  ${o.check ? `would be ${x.action}` : x.action === "kept-edited" ? "kept (edited by hand; --force replaces it)" : x.action === "kept-not-generated" ? "kept (not written by Atticus)" : x.action}: ${x.path}`);
+      for (const p of r.problems)
+        io.err(p);
+      for (const p of smoke)
+        io.err(`${p.path}: ${p.message}`);
+      const where = r.profile.kind === "metarepo" ? "the metarepo" : `${r.profile.repo} (${r.profile.engine})`;
+      io.out(r.upToDate ? `Assistant files for ${where} are up to date.` : o.check ? `Assistant files for ${where} are out of date; run atticus assistant-files${o.repo ? ` --repo ${o.repo}` : ""}.` : `Wrote assistant files for ${where} from the org pack.`);
+    }
+    if (smoke.length || r.problems.length)
+      return 1;
+    return o.check && !r.upToDate ? 1 : 0;
+  } catch (e) {
+    return fail(io, e);
+  }
+}
+
+export {
+  describeRun,
+  taskRun,
+  taskHandoff,
+  specHandDown,
+  specHandUp,
+  driftCommand,
+  assistantFiles
+};