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

package/dist/chunk-UFBKJOWB.js

@@ -0,0 +1,325 @@
+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 {
+  ANSWERS_TEXT,
+  BUILT_IN_CHECKS,
+  CONSTITUTION_FILE_LABEL,
+  CriticError,
+  DRAFT_DIR,
+  LENS_RECORDS,
+  MERGED_FLOWS,
+  OPEN_FINDINGS,
+  PERSON_CLOSES,
+  PatchError,
+  Proposal,
+  QUARANTINE_RULE,
+  QUESTIONS,
+  QUESTION_ROLES,
+  QUESTION_TEXT,
+  REVIEWED,
+  SOURCE_PREFIX,
+  STARTER_REVIEW_FILE,
+  STARTER_REVIEW_PATH,
+  act,
+  answersText,
+  applyPatch,
+  artifactOf,
+  askedElsewhere,
+  assistantClosed,
+  assistantNames,
+  assistantOf,
+  breakingItems,
+  buildContext,
+  catalogHas,
+  catalogSlice,
+  changeAnswers,
+  checkAbsences,
+  checkRegistry,
+  checkRoundDue,
+  checkRoundRule,
+  checkRoundState,
+  checkedAnswerLink,
+  clean,
+  codeRepos,
+  codeSearchFor,
+  completeLensRun,
+  contentLines,
+  countedRounds,
+  criticModel,
+  decidedAt,
+  decidedElsewhere,
+  decidedReason,
+  diffLines,
+  diffText,
+  docOf,
+  draftDocs,
+  dropReviewedBefore,
+  escapeRe,
+  evaluateNeeds,
+  explicitQuestion,
+  failLens,
+  filesOf,
+  findingIdFor,
+  fingerprint,
+  focusTerms,
+  gateStatus,
+  gateStatusOf,
+  hasField,
+  hasWord,
+  headingAt,
+  hopNotes,
+  hopRoutes,
+  isFilledDoc,
+  keepLensRecords,
+  keepReviewed,
+  lastReviewed,
+  layerRank,
+  layerRules,
+  leftOut,
+  lensAgent,
+  lensAnswerProblem,
+  lensRunOf,
+  lineEvidence,
+  linePatch,
+  loadConstitution,
+  loosenings,
+  lower,
+  markNeedHit,
+  matchServiceRequestTriggers,
+  matchesWhere,
+  maxRoundsOf,
+  mergeHits,
+  modelFamily,
+  nearestCode,
+  normalizePath,
+  overrideStats,
+  ownerWaitsLine,
+  parseDoc,
+  parseLensOutput,
+  patchTarget,
+  patternSettingKinds,
+  personalItems,
+  proposalWords,
+  quarantineHits,
+  quarantineRule,
+  questionOfRule,
+  questionOwner,
+  questionsOf,
+  quoteOf,
+  readChangeFiles,
+  readDataChanges,
+  readHops,
+  readPack,
+  readPackFiles,
+  readProposals,
+  readRound,
+  readRoundMeta,
+  readSnowDrafts,
+  readStoreWrites,
+  readStoryIndex,
+  readTasks,
+  recordEvidence,
+  recordedFacts,
+  recordedText,
+  registerCodeSearch,
+  relatedRecords,
+  renderQuestion,
+  reviewedDir,
+  reviewedGates,
+  roundsOf,
+  roundsUsed,
+  ruleQuestion,
+  runCritic,
+  runLenses,
+  sectionLines,
+  sectionMatching,
+  sentence,
+  serializeFinding,
+  severityRank,
+  sinceReview,
+  starterReviewText,
+  strictestLayer,
+  tableSlug,
+  tableWith,
+  toFinding,
+  triggerReason,
+  trimSources,
+  typeTakes,
+  waitingLenses,
+  writeFinding,
+  writeProposals,
+  writeQuarantineItems,
+  wroteIn
+} from "./chunk-T6ESD5KM.js";
+import {
+  BUILT_IN_GATES
+} from "./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-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+export {
+  ANSWERS_TEXT,
+  BUILT_IN_CHECKS,
+  BUILT_IN_GATES,
+  CONSTITUTION_FILE_LABEL,
+  CriticError,
+  DRAFT_DIR,
+  LENS_RECORDS,
+  MERGED_FLOWS,
+  OPEN_FINDINGS,
+  PERSON_CLOSES,
+  PatchError,
+  Proposal,
+  QUARANTINE_RULE,
+  QUESTIONS,
+  QUESTION_ROLES,
+  QUESTION_TEXT,
+  REVIEWED,
+  SOURCE_PREFIX,
+  STARTER_REVIEW_FILE,
+  STARTER_REVIEW_PATH,
+  act,
+  answersText,
+  applyPatch,
+  artifactOf,
+  askedElsewhere,
+  assistantClosed,
+  assistantNames,
+  assistantOf,
+  breakingItems,
+  buildContext,
+  catalogHas,
+  catalogSlice,
+  changeAnswers,
+  checkAbsences,
+  checkRegistry,
+  checkRoundDue,
+  checkRoundRule,
+  checkRoundState,
+  checkedAnswerLink,
+  clean,
+  codeRepos,
+  codeSearchFor,
+  completeLensRun,
+  contentLines,
+  countedRounds,
+  criticModel,
+  decidedAt,
+  decidedElsewhere,
+  decidedReason,
+  diffLines,
+  diffText,
+  docOf,
+  draftDocs,
+  dropReviewedBefore,
+  escapeRe,
+  evaluateNeeds,
+  explicitQuestion,
+  failLens,
+  filesOf,
+  findingIdFor,
+  fingerprint,
+  focusTerms,
+  gateStatus,
+  gateStatusOf,
+  hasField,
+  hasWord,
+  headingAt,
+  hopNotes,
+  hopRoutes,
+  isFilledDoc,
+  keepLensRecords,
+  keepReviewed,
+  lastReviewed,
+  layerRank,
+  layerRules,
+  leftOut,
+  lensAgent,
+  lensAnswerProblem,
+  lensRunOf,
+  lineEvidence,
+  linePatch,
+  loadConstitution,
+  loosenings,
+  lower,
+  markNeedHit,
+  matchServiceRequestTriggers,
+  matchesWhere,
+  maxRoundsOf,
+  mergeHits,
+  modelFamily,
+  nearestCode,
+  normalizePath,
+  overrideStats,
+  ownerWaitsLine,
+  parseDoc,
+  parseLensOutput,
+  patchTarget,
+  patternSettingKinds,
+  personalItems,
+  proposalWords,
+  quarantineHits,
+  quarantineRule,
+  questionOfRule,
+  questionOwner,
+  questionsOf,
+  quoteOf,
+  readChangeFiles,
+  readDataChanges,
+  readHops,
+  readPack,
+  readPackFiles,
+  readProposals,
+  readRound,
+  readRoundMeta,
+  readSnowDrafts,
+  readStoreWrites,
+  readStoryIndex,
+  readTasks,
+  recordEvidence,
+  recordedFacts,
+  recordedText,
+  registerCodeSearch,
+  relatedRecords,
+  renderQuestion,
+  reviewedDir,
+  reviewedGates,
+  roundsOf,
+  roundsUsed,
+  ruleQuestion,
+  runCritic,
+  runLenses,
+  sectionLines,
+  sectionMatching,
+  sentence,
+  serializeFinding,
+  severityRank,
+  sinceReview,
+  starterReviewText,
+  strictestLayer,
+  tableSlug,
+  tableWith,
+  toFinding,
+  triggerReason,
+  trimSources,
+  typeTakes,
+  waitingLenses,
+  writeFinding,
+  writeProposals,
+  writeQuarantineItems,
+  wroteIn
+};

package/dist/chunk-UFTQIK2J.js

@@ -0,0 +1,43 @@
+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 {
+  explainCommand,
+  learnCheck,
+  learnList,
+  learnStart,
+  sandboxCreate
+} from "./chunk-UABFFMWH.js";
+import "./chunk-LUPW4WLK.js";
+import "./chunk-NG5R2WIY.js";
+import "./chunk-6RGIM2ZH.js";
+import "./chunk-EV4TEFOD.js";
+import "./chunk-6N2GUZMZ.js";
+import "./chunk-VOGCSYOI.js";
+import "./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-7RUMD56V.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";
+export {
+  explainCommand,
+  learnCheck,
+  learnList,
+  learnStart,
+  sandboxCreate
+};

package/dist/chunk-UNFCFJMF.js

@@ -0,0 +1,95 @@
+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 {
+  askKnowledgeConflicts,
+  knowledgeAppliesMarkdown,
+  readKnowledgeApplies,
+  setKnowledgeStatus
+} from "./chunk-EV4TEFOD.js";
+import "./chunk-6N2GUZMZ.js";
+import "./chunk-T6ESD5KM.js";
+import "./chunk-3LU6YCSQ.js";
+import "./chunk-L7I5PKGD.js";
+import "./chunk-CAN3EBE5.js";
+import "./chunk-IILZ7J3L.js";
+import {
+  conflictLine
+} from "./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 {
+  changesRelOf
+} from "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/knowledge-applies-commands.js
+async function changeKnowledge(root, change, o, io) {
+  const said = [];
+  try {
+    for (const [id, status] of [
+      [o.confirm, "confirmed"],
+      [o.exclude, "excluded"]
+    ]) {
+      if (!id)
+        continue;
+      const d = await setKnowledgeStatus(root, change, id, status);
+      const i = d.items.find((x) => x.id === id);
+      const what = `${id} (${i.kind}${i.title && i.title !== id ? `, ${i.title}` : ""})`;
+      said.push(status === "confirmed" ? `Confirmed ${what}: every later stage that takes it selects it.` : `Excluded ${what}: every later stage leaves it out.`);
+    }
+  } catch (e) {
+    io.err(e.message);
+    return 2;
+  }
+  if (said.length) {
+    if (o.json)
+      io.out(JSON.stringify(await readKnowledgeApplies(root, change), null, 2));
+    else
+      for (const l of said)
+        io.out(l);
+    if (!o.json)
+      io.out(`Written to ${changesRelOf(root)}/${change}/knowledge.yaml; commit it with the change's files.`);
+    return 0;
+  }
+  const doc = await readKnowledgeApplies(root, change);
+  if (!doc) {
+    io.err(`${change} has no knowledge list yet: its feature stage writes ${changesRelOf(root)}/${change}/knowledge.yaml with the patterns, standards, decisions, processes and requests and the wiki and document sections it picks, and every later stage adds what it picks (atticus change feature ${change}).`);
+    return 2;
+  }
+  const command = `atticus change knowledge ${change}`;
+  const asked = await askKnowledgeConflicts(root, change, {
+    command,
+    rerun: command,
+    at: (o.now ?? /* @__PURE__ */ new Date()).toISOString()
+  });
+  if (o.json)
+    io.out(JSON.stringify({ ...doc, conflicts: asked.touching }, null, 2));
+  else {
+    for (const l of knowledgeAppliesMarkdown(doc).trimEnd().split("\n"))
+      io.out(l);
+    if (asked.touching.length) {
+      io.out("");
+      io.out("### Pages that disagree");
+      io.out("");
+      for (const v of asked.touching)
+        io.out(`- ${conflictLine(v)}`);
+      for (const q of asked.raised)
+        io.out(`Asked a person which page applies: question ${q.id} (atticus questions answer ${q.id} --option <n>).`);
+    }
+    io.out(`Confirm or exclude an item: atticus change knowledge ${change} --confirm <id> (or --exclude <id>); an excluded one stays out of later stages.`);
+  }
+  return 0;
+}
+export {
+  changeKnowledge
+};

package/dist/chunk-UTR67XU2.js

@@ -0,0 +1,164 @@
+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 {
+  resumedAttempt,
+  stepClassOf
+} from "./chunk-BKFGGJKA.js";
+import {
+  RUN_SCHEMA_VERSION,
+  STEP_CLASSES,
+  changesDirOf,
+  runsDirOf,
+  runsRelOf
+} from "./chunk-JMOLB347.js";
+
+// packages/cli/dist/runs-view.js
+import { createHash } from "node:crypto";
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join, relative, resolve, sep } from "node:path";
+var RUN_ID = /^run-[0-9a-z-]+$/;
+var sha = (s) => createHash("sha256").update(s).digest("hex");
+var dataBlocks = (prompt) => [
+  ...prompt.matchAll(/<atticus-data [^>]*origin="([^"]+)"[^>]*>\n([\s\S]*?)\n<\/atticus-data>/g)
+].map((m) => ({ origin: m[1], text: m[2].trimEnd() }));
+function handedBack(prompt) {
+  const blocks = dataBlocks(prompt);
+  const out = [];
+  for (const b of blocks) {
+    const m = /^checks on attempt (\d+)$/.exec(b.origin);
+    if (!m)
+      continue;
+    const attempt = Number(m[1]);
+    const problems = b.text.split("\n").filter((l) => l.startsWith("- ")).map((l) => l.slice(2).trim());
+    const previous = blocks.find((x) => x.origin === `attempt ${attempt}`)?.text;
+    out.push({
+      attempt,
+      problems,
+      ...previous !== void 0 ? { previousAnswer: previous } : {}
+    });
+  }
+  return out.sort((a, b) => a.attempt - b.attempt);
+}
+async function readStored(root, change, runId) {
+  const dir = join(runsDirOf(root), change, runId);
+  const text = await readFile(join(dir, "run.json"), "utf8").catch(() => void 0);
+  if (!text)
+    return void 0;
+  const run = JSON.parse(text);
+  const prompt = await readFile(join(dir, "prompt.md"), "utf8").catch(() => void 0) ?? run.request.pack?.prompt ?? "";
+  return { run, dir, prompt };
+}
+async function answerOf(root, s) {
+  if (typeof s.run.output === "string")
+    return s.run.output;
+  const out = s.run.request.outputPath;
+  if (!out)
+    return void 0;
+  const inRun = join(s.dir, basename(out));
+  const inChange = resolve(changesDirOf(root), s.run.request.change, out);
+  const candidates = [inRun];
+  if (s.run.request.outputIn !== "run" && !relative(changesDirOf(root), inChange).startsWith(".."))
+    candidates.push(inChange);
+  for (const f of candidates) {
+    const t = await readFile(f, "utf8").catch(() => void 0);
+    if (t !== void 0)
+      return t;
+  }
+  return void 0;
+}
+async function item(root, s) {
+  const r = s.run;
+  const manifest = await readFile(join(s.dir, "context-manifest.json"), "utf8").catch(() => "");
+  const attempt = r.request.pack?.manifest ? resumedAttempt(r).attempt : r.attempt ?? 1;
+  const back = handedBack(s.prompt);
+  const answer = await answerOf(root, s);
+  const agent = r.request.agent;
+  return {
+    schemaVersion: RUN_SCHEMA_VERSION,
+    runId: r.runId,
+    change: r.request.change,
+    agent: typeof agent === "string" ? agent : agent.id,
+    runtime: r.runtime,
+    state: r.state,
+    startedAt: r.startedAt,
+    ...r.finishedAt ? { finishedAt: r.finishedAt } : {},
+    ...r.request.outputPath ? { output: r.request.outputPath } : {},
+    ...r.usage ? { usage: r.usage } : {},
+    contextManifestSha256: sha(manifest),
+    promptPath: `${runsRelOf(root)}/${r.request.change}/${r.runId}/prompt.md`,
+    attempt,
+    answered: answer !== void 0,
+    handedBack: back.reduce((n, b) => n + b.problems.length, 0),
+    ...r.request.pack?.manifest ? { promptTokens: r.request.pack.manifest.totalTokens } : {},
+    ...r.tools ? { toolCalls: r.tools.calls.length } : {},
+    // ADR 0121 addendum: the kind of step and the model that ran it. A run kept before either
+    // was recorded is given its kind from its agent; its model stays unsaid.
+    ...classOf(r) ? { stepClass: classOf(r) } : {},
+    ...r.model ? { model: r.model } : {}
+  };
+}
+function classOf(r) {
+  if (r.stepClass && STEP_CLASSES.includes(r.stepClass))
+    return r.stepClass;
+  const agent = r.request.agent;
+  return agent && typeof agent === "object" && "id" in agent ? stepClassOf(r.request) : void 0;
+}
+async function allRuns(root, change) {
+  const out = [];
+  const changes = change ? [change] : await readdir(runsDirOf(root)).catch(() => []);
+  for (const c of changes) {
+    if (c.includes("/") || c.includes("\\") || c.includes("..") || c.includes(sep))
+      continue;
+    for (const id of await readdir(join(runsDirOf(root), c)).catch(() => [])) {
+      if (!RUN_ID.test(id))
+        continue;
+      const s = await readStored(root, c, id);
+      if (s)
+        out.push(s);
+    }
+  }
+  return out;
+}
+async function listRuns(root, o = {}) {
+  const items = await Promise.all((await allRuns(root, o.change)).map((s) => item(root, s)));
+  items.sort((a, b) => b.startedAt.localeCompare(a.startedAt) || b.runId.localeCompare(a.runId));
+  return items.slice(0, o.limit ?? 200);
+}
+async function runTranscript(root, runId) {
+  if (!RUN_ID.test(runId))
+    return void 0;
+  const all = await allRuns(root);
+  const s = all.find((x) => x.run.runId === runId);
+  if (!s)
+    return void 0;
+  const agentOf = (x) => {
+    const a = x.run.request.agent;
+    return typeof a === "string" ? a : a.id;
+  };
+  const same = all.filter((x) => x.run.request.change === s.run.request.change && agentOf(x) === agentOf(s));
+  const rounds = await Promise.all(same.map((x) => item(root, x)));
+  rounds.sort((a, b) => a.startedAt.localeCompare(b.startedAt) || a.runId.localeCompare(b.runId));
+  const answer = await answerOf(root, s);
+  return {
+    run: await item(root, s),
+    prompt: s.prompt,
+    ...answer !== void 0 ? { answer } : {},
+    ...s.run.tools ? { tools: s.run.tools } : {},
+    ...s.run.request.retrieval ? { retrieval: s.run.request.retrieval } : {},
+    handedBack: handedBack(s.prompt),
+    rounds: rounds.map((x) => ({
+      runId: x.runId,
+      attempt: x.attempt,
+      state: x.state,
+      startedAt: x.startedAt
+    }))
+  };
+}
+
+export {
+  listRuns,
+  runTranscript
+};