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

package/dist/chunk-YPIEYQF4.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-XB5RFZHH.js";
+import {
+  driftCheck,
+  handDown,
+  handUp
+} from "./chunk-IDGSU7JF.js";
+import {
+  generateAssistantFiles,
+  smokeCheck
+} from "./chunk-LK44ULGI.js";
+import {
+  createAdapters,
+  fileStepStore
+} from "./chunk-NGPU2ARF.js";
+import {
+  RUNTIME_MODES,
+  runtimeForCli
+} from "./chunk-5XDNUJ4P.js";
+import {
+  changesRelOf,
+  loadOrgPack,
+  orgPackDirOf,
+  runsRelOf
+} from "./chunk-577AJVRS.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
+};

package/dist/chunk-YVLMBAYE.js

@@ -0,0 +1,221 @@
+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 {
+  badRequest
+} from "./chunk-HHUFVJF7.js";
+import {
+  catalogRecords
+} from "./chunk-DPHCFZ7W.js";
+import {
+  RecordId,
+  catalogDirOf,
+  changesDirOf,
+  readRepoSpec,
+  require_dist,
+  specRepos,
+  specsDirOf
+} from "./chunk-577AJVRS.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/ui-api-cites.js
+import { readdir, readFile, stat } from "node:fs/promises";
+import { isAbsolute, join, relative, sep } from "node:path";
+var import_yaml = __toESM(require_dist(), 1);
+async function fingerprint(dirs) {
+  let count = 0;
+  let newest = 0;
+  const walk = async (d) => {
+    const entries = await readdir(d, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+      const p = join(d, e.name);
+      if (e.isDirectory())
+        await walk(p);
+      else {
+        count++;
+        const s = await stat(p).catch(() => void 0);
+        if (s && s.mtimeMs > newest)
+          newest = s.mtimeMs;
+      }
+    }
+  };
+  for (const d of dirs)
+    await walk(d);
+  return `${count}:${newest}`;
+}
+async function build(root) {
+  const index = /* @__PURE__ */ new Map();
+  const lineOf = (repo, path, line) => {
+    const files = index.get(repo) ?? /* @__PURE__ */ new Map();
+    index.set(repo, files);
+    const lines = files.get(path) ?? /* @__PURE__ */ new Map();
+    files.set(path, lines);
+    const l = lines.get(line) ?? { line, flows: [], records: [] };
+    lines.set(line, l);
+    return l;
+  };
+  for (const specRepo of await specRepos(root))
+    for (const f of (await readRepoSpec(root, specRepo, { cacheRoot: root })).flows) {
+      const parts = [
+        { step: 0, kind: f.trigger.kind, evidence: f.trigger.evidence },
+        ...f.steps.map((s, i) => ({
+          step: i + 1,
+          kind: s.kind,
+          ...s.confirmedBy ? { confirmedBy: s.confirmedBy } : {},
+          evidence: s.evidence
+        }))
+      ];
+      for (const part of parts)
+        for (const e of part.evidence) {
+          if (!e.path || e.line === void 0)
+            continue;
+          const l = lineOf(e.repo ?? specRepo, e.path, e.line);
+          if (l.flows.some((x) => x.flow === f.id && x.step === part.step))
+            continue;
+          l.flows.push({
+            repo: specRepo,
+            flow: f.id,
+            name: f.name,
+            step: part.step,
+            kind: part.kind,
+            ...part.confirmedBy ? { confirmedBy: part.confirmedBy } : {}
+          });
+        }
+    }
+  for (const r of await catalogRecords(root)) {
+    const name = r.name;
+    for (const e of r.evidence) {
+      if (!e.repo || !e.path || e.line === void 0)
+        continue;
+      const l = lineOf(e.repo, e.path, e.line);
+      if (l.records.some((x) => x.kind === r.kind && x.id === r.id))
+        continue;
+      l.records.push({
+        kind: r.kind,
+        id: r.id,
+        ...typeof name === "string" && name !== r.id ? { name } : {},
+        source: e.source
+      });
+    }
+  }
+  return index;
+}
+var DONE = /* @__PURE__ */ new Set(["released", "archived", "post-release-review"]);
+async function inFlight(root) {
+  const out = /* @__PURE__ */ new Map();
+  const dir = changesDirOf(root);
+  for (const e of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+    if (!e.isDirectory() || e.name === "archive")
+      continue;
+    const yaml = await readFile(join(dir, e.name, "change.yaml"), "utf8").catch(() => "");
+    const state = (() => {
+      try {
+        return (0, import_yaml.parse)(yaml)?.state;
+      } catch {
+        return void 0;
+      }
+    })();
+    if (!yaml || typeof state === "string" && DONE.has(state))
+      continue;
+    for (const f of await readdir(join(dir, e.name, "target-flows")).catch(() => []))
+      if (f.endsWith(".yaml")) {
+        const flow = f.slice(0, -".yaml".length);
+        out.set(flow, [...out.get(flow) ?? [], e.name]);
+      }
+  }
+  return out;
+}
+async function citeList(root, index, repo, path) {
+  const lines = [...index.get(repo)?.get(path)?.values() ?? []].sort((a, b) => a.line - b.line);
+  const flying = await inFlight(root);
+  const shown = lines.map((l) => ({
+    ...l,
+    flows: [...l.flows].sort((a, b) => a.flow.localeCompare(b.flow) || a.step - b.step).map((f) => flying.get(f.flow)?.length ? { ...f, changes: flying.get(f.flow) } : f)
+  }));
+  return { repo, path, lines: shown };
+}
+function fileInRepo(root, file) {
+  const rel = relative(root, file);
+  if (!rel || rel.startsWith("..") || isAbsolute(rel))
+    return void 0;
+  const parts = rel.split(sep);
+  if (parts[0] !== "workspace")
+    return { path: parts.join("/") };
+  const at = parts[1] === ".worktrees" ? 3 : parts[1] === ".branches" ? 2 : 1;
+  const repo = parts[at];
+  const rest = parts.slice(parts[1] === ".branches" ? 4 : at + 1);
+  if (!repo || !rest.length || !RecordId.safeParse(repo).success)
+    return void 0;
+  return { repo, path: rest.join("/") };
+}
+async function citesCli(root, o, io) {
+  let repo = o.repo;
+  let path = o.path;
+  const index = await build(root);
+  if (o.file) {
+    const at = fileInRepo(root, o.file);
+    if (!at) {
+      io.err(`${o.file} isn't in this metarepo or a repo's checkout in its workspace.`);
+      return 1;
+    }
+    path = at.path;
+    repo = at.repo ?? [...index.keys()].find((r) => index.get(r).has(at.path)) ?? void 0;
+    if (!repo) {
+      if (o.json)
+        io.out(JSON.stringify({ repo: "", path, lines: [] }, null, 2));
+      else
+        io.out(`Nothing in the specs or the catalog cites ${path}.`);
+      return 0;
+    }
+  }
+  if (!repo || !path || !RecordId.safeParse(repo).success) {
+    io.err("Say which file: atticus cites --repo <repo> --path <its path in the repo>, or --file <path on disk>.");
+    return 2;
+  }
+  const v = await citeList(root, index, repo, path);
+  if (o.json) {
+    io.out(JSON.stringify(v, null, 2));
+    return 0;
+  }
+  if (!v.lines.length) {
+    io.out(`Nothing in the specs or the catalog cites ${repo}/${path}.`);
+    return 0;
+  }
+  for (const l of v.lines) {
+    const flows = l.flows.map((f) => `${f.name} (step ${f.step})${f.changes?.length ? `, changed by ${f.changes.join(", ")}` : ""}`);
+    const records = l.records.map((r) => `${r.kind} ${r.name ?? r.id}`);
+    io.out(`Line ${l.line}: ${[...flows, ...records].join("; ")}`);
+  }
+  return 0;
+}
+function uiCiteRoutes(r, ctx) {
+  const root = ctx.root;
+  let cached;
+  const indexNow = async () => {
+    const print = await fingerprint([specsDirOf(root), catalogDirOf(root)]);
+    if (cached?.print !== print)
+      cached = { print, index: build(root) };
+    return cached.index;
+  };
+  void indexNow().catch(() => void 0);
+  r.add("GET", "/api/cites", async ({ query }) => {
+    const repo = query.get("repo");
+    const path = query.get("path");
+    if (!repo || !RecordId.safeParse(repo).success)
+      throw badRequest("Say which repo: ?repo=<the repo's id>.");
+    if (!path)
+      throw badRequest("Say which file: ?path=<its path in the repo>.");
+    return { status: 200, body: await citeList(root, await indexNow(), repo, path) };
+  });
+  return r;
+}
+
+export {
+  fileInRepo,
+  citesCli,
+  uiCiteRoutes
+};