@maycombhq/atticus 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/{chunk-SP2I63OO.js → chunk-GCS3FZOB.js}

@@ -4,15 +4,26 @@ var require = __atticusCreateRequire(import.meta.url);
 var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
+  ACP_ERRORS,
+  ACP_METHODS,
+  ACP_OFFERED,
+  ACP_PROTOCOL_VERSION,
   ANSWERED_BY_SPEC,
   APPLIES_SPEC,
   ASKS_CHECK_SPEC,
+  AcpClient,
+  AcpRpcError,
+  AcpSetupError,
+  AcpSignInError,
   AiOffError,
+  BATCH_OUTPUT,
   BIGGER_MODEL,
   BREAKING_SPEC,
   CLASSIFIED_PERSONAL,
   COVERS_FIELD_SPEC,
+  CopilotAcpRuntime,
   DATA_RULE,
+  DEFAULT_BATCH_MAX_TOKENS,
   DEFENCES_VERSION,
   FLAG_OPEN,
   HandoffRuntime,
@@ -20,6 +31,7 @@ import {
   HeadlessClaudeCodeRuntime,
   INSTRUCTION_RULES,
   JUDGE_AGENT,
+  MAX_NUDGES,
   MockModelProvider,
   MockRuntime,
   ModelRuntime,
@@ -44,16 +56,25 @@ import {
   ToolError,
   ToolSession,
   UNDOES_SPEC,
+  UPDATE,
+  acpPathsOf,
   answerJudge,
   answerProblem,
   assess,
+  atticusArgvOf,
+  atticusExec,
+  batchSections,
   buildContextPack,
+  carryOnPrompt,
   chatWithTools,
   checkAllowed,
+  chunkText,
   claudeCodeCliRunner,
   clearModelProviders,
   collectChild,
   combine,
+  commandLineOf,
+  copilotAcpProbe,
   cosine,
   createRuntime,
   currentPromptLimit,
@@ -62,24 +83,31 @@ import {
   dotInt8,
   escapeDelimiters,
   estimateTokens,
+  factsOnly,
   fitBudget,
   formatOf,
   guardToolText,
   hiddenDiagramLabels,
   hiddenOfficeRuns,
   hiddenSpans,
+  isAuthRequired,
+  isPersonsFactsFile,
   judge,
   judgeInstructions,
   judgeItemsOf,
   judgeStandIn,
   judgesDirectly,
+  keepAcpRun,
+  killTree,
   makeModelProvider,
   makeRunId,
   modelEnvOf,
   modelSourceWords,
   modelsByClass,
   namesWord,
+  needsShell,
   neutralise,
+  personOnlyWhy,
   personalItem,
   posixPath,
   promptBudget,
@@ -90,16 +118,22 @@ import {
   quarantineItems,
   quarantineReason,
   questionJudge,
+  quoteForCmd,
+  quoteForCmdAlways,
+  readRootsOf,
   readToolCalls,
   recordRun,
   recordToolCalls,
   recordedJudge,
+  registerCopilotAcp,
   registerModelProvider,
   registerModelProviderPluginLoader,
   registerToolSource,
   registeredModelProviders,
+  resolveWindowsCommand,
   resumedAttempt,
   riskAtLeast,
+  runAcpSession,
   runtimeForCli,
   screenAbsorbed,
   screenDiagramXml,
@@ -110,6 +144,7 @@ import {
   settle,
   sha256,
   skeleton,
+  spawnAcpServer,
   stepClassOf,
   stepClassOfCommand,
   stepClassOfNextStep,
@@ -119,25 +154,38 @@ import {
   tokenFormatIn,
   toolStops,
   transition,
+  usageOf,
   vectorFromText,
   vectorToText,
   verdictOf,
+  windowsName,
   withPromptLimit,
   wrapData
-} from "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-QHJJMZLX.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 export {
+  ACP_ERRORS,
+  ACP_METHODS,
+  ACP_OFFERED,
+  ACP_PROTOCOL_VERSION,
   ANSWERED_BY_SPEC,
   APPLIES_SPEC,
   ASKS_CHECK_SPEC,
+  AcpClient,
+  AcpRpcError,
+  AcpSetupError,
+  AcpSignInError,
   AiOffError,
+  BATCH_OUTPUT,
   BIGGER_MODEL,
   BREAKING_SPEC,
   CLASSIFIED_PERSONAL,
   COVERS_FIELD_SPEC,
+  CopilotAcpRuntime,
   DATA_RULE,
+  DEFAULT_BATCH_MAX_TOKENS,
   DEFENCES_VERSION,
   FLAG_OPEN,
   HandoffRuntime,
@@ -145,6 +193,7 @@ export {
   HeadlessClaudeCodeRuntime,
   INSTRUCTION_RULES,
   JUDGE_AGENT,
+  MAX_NUDGES,
   MockModelProvider,
   MockRuntime,
   ModelRuntime,
@@ -169,16 +218,25 @@ export {
   ToolError,
   ToolSession,
   UNDOES_SPEC,
+  UPDATE,
+  acpPathsOf,
   answerJudge,
   answerProblem,
   assess,
+  atticusArgvOf,
+  atticusExec,
+  batchSections,
   buildContextPack,
+  carryOnPrompt,
   chatWithTools,
   checkAllowed,
+  chunkText,
   claudeCodeCliRunner,
   clearModelProviders,
   collectChild,
   combine,
+  commandLineOf,
+  copilotAcpProbe,
   cosine,
   createRuntime,
   currentPromptLimit,
@@ -187,24 +245,31 @@ export {
   dotInt8,
   escapeDelimiters,
   estimateTokens,
+  factsOnly,
   fitBudget,
   formatOf,
   guardToolText,
   hiddenDiagramLabels,
   hiddenOfficeRuns,
   hiddenSpans,
+  isAuthRequired,
+  isPersonsFactsFile,
   judge,
   judgeInstructions,
   judgeItemsOf,
   judgeStandIn,
   judgesDirectly,
+  keepAcpRun,
+  killTree,
   makeModelProvider,
   makeRunId,
   modelEnvOf,
   modelSourceWords,
   modelsByClass,
   namesWord,
+  needsShell,
   neutralise,
+  personOnlyWhy,
   personalItem,
   posixPath,
   promptBudget,
@@ -215,16 +280,22 @@ export {
   quarantineItems,
   quarantineReason,
   questionJudge,
+  quoteForCmd,
+  quoteForCmdAlways,
+  readRootsOf,
   readToolCalls,
   recordRun,
   recordToolCalls,
   recordedJudge,
+  registerCopilotAcp,
   registerModelProvider,
   registerModelProviderPluginLoader,
   registerToolSource,
   registeredModelProviders,
+  resolveWindowsCommand,
   resumedAttempt,
   riskAtLeast,
+  runAcpSession,
   runtimeForCli,
   screenAbsorbed,
   screenDiagramXml,
@@ -235,6 +306,7 @@ export {
   settle,
   sha256,
   skeleton,
+  spawnAcpServer,
   stepClassOf,
   stepClassOfCommand,
   stepClassOfNextStep,
@@ -244,9 +316,11 @@ export {
   tokenFormatIn,
   toolStops,
   transition,
+  usageOf,
   vectorFromText,
   vectorToText,
   verdictOf,
+  windowsName,
   withPromptLimit,
   wrapData
 };

package/dist/{chunk-6TACQN3N.js → chunk-GDZB57IU.js}

@@ -5,18 +5,18 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   PluginProvider
-} from "./chunk-YEDDOYSC.js";
+} from "./chunk-PRW3HXM3.js";
 import {
   RuntimeConfigError,
   registerModelProviderPluginLoader
-} from "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-QHJJMZLX.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/model-plugins.js
 async function pluginProviderFactory(p, deps = {}) {
-  const { readPinnedEntry, runTranslator } = await import("./chunk-HFQCFSJR.js");
+  const { readPinnedEntry, runTranslator } = await import("./chunk-5PV7S2ZP.js");
   const entry = await readPinnedEntry(p.dir, p.manifest);
   if (!entry.ok)
     throw new RuntimeConfigError(`The model-provider plugin org-pack/plugins/model-providers/${p.manifest.id}/ ${entry.message}.`);

package/dist/chunk-GIFMBCTW.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 {
+  estateRepos,
+  matchRepoType
+} from "./chunk-4SLBCEPD.js";
+import {
+  baseClonePath
+} from "./chunk-XOL3GFW2.js";
+import {
+  fsRepo,
+  globToRegExp
+} from "./chunk-7AB6OWTV.js";
+import {
+  ReadingRulesFile,
+  isAdopted,
+  loadOrgPack,
+  notesFor,
+  orgPackDirOf,
+  require_dist
+} from "./chunk-PAINMSID.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/reading-rules.js
+var import_yaml = __toESM(require_dist(), 1);
+import { createHash } from "node:crypto";
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+
+// packages/cli/dist/org-notes.js
+async function repoTypeOf(op, repo, dir) {
+  const named = estateRepos(op).find((r2) => r2.id === repo)?.type;
+  const byName = op.repoTypes.find((t) => t.id === named);
+  if (byName)
+    return byName;
+  if (!dir || !op.repoTypes.length)
+    return void 0;
+  const r = await matchRepoType(fsRepo(repo, dir, "0".repeat(40)), op.repoTypes).catch(() => void 0);
+  return r && (r.verdict === "clear" || r.verdict === "partial") ? op.repoTypes.find((t) => t.id === r.best) : void 0;
+}
+async function notesAt(root, repo, dir, given) {
+  const op = given ?? await loadOrgPack(orgPackDirOf(root)).catch(() => void 0);
+  if (!op)
+    return { notes: [] };
+  const type = await repoTypeOf(op, repo, dir);
+  return { ...type ? { type: type.id } : {}, notes: notesFor(type, op.conventions) };
+}
+
+// packages/cli/dist/reading-rules.js
+var rulesDirOf = (root) => join(orgPackDirOf(root), "reading-rules");
+var relDir = (root) => `${isAdopted(root) ? ".atticus/org-pack" : "org-pack"}/reading-rules`;
+var ruleId = (r) => `org:${r.key}@${createHash("sha256").update(JSON.stringify([r.rule, r.files ?? []])).digest("hex").slice(0, 8)}`;
+async function readLayer(root, rel) {
+  const text = await readFile(join(rulesDirOf(root), ...rel.split("/")), "utf8").catch(() => void 0);
+  if (text === void 0)
+    return {};
+  let data;
+  try {
+    data = (0, import_yaml.parse)(text);
+  } catch (e) {
+    return {
+      problem: `${relDir(root)}/${rel} can't be read: ${e.message.split("\n")[0]}`
+    };
+  }
+  const r = ReadingRulesFile.safeParse(data);
+  return r.success ? { file: r.data } : {
+    problem: `${relDir(root)}/${rel} isn't valid: ${r.error.issues.map((i) => `${i.path.join(".") || "(top)"}: ${i.message}`).join("; ")}`
+  };
+}
+async function layerFiles(root, repo, type) {
+  const out = [];
+  if (type) {
+    const teams = await readdir(join(rulesDirOf(root), "imported"), { withFileTypes: true }).catch(() => []);
+    for (const t of teams.filter((x) => x.isDirectory()).map((x) => x.name).sort())
+      out.push({ layer: "imported", rel: `imported/${t}/${type}.yaml` });
+  }
+  out.push({ layer: "org", rel: "org.yaml" });
+  if (type)
+    out.push({ layer: "type", rel: `types/${type}.yaml` });
+  out.push({ layer: "repo", rel: `repos/${repo}.yaml` });
+  return out;
+}
+async function effectiveRules(root, repo, o = {}) {
+  const op = o.op ?? await loadOrgPack(orgPackDirOf(root)).catch(() => void 0);
+  const cloneOf = () => {
+    try {
+      const c = isAdopted(root) ? root : baseClonePath(root, repo);
+      return existsSync(c) ? c : void 0;
+    } catch {
+      return void 0;
+    }
+  };
+  const dir = o.dir ?? (op ? cloneOf() : void 0);
+  const type = op ? (await repoTypeOf(op, repo, dir))?.id ?? estateRepos(op).find((r) => r.id === repo)?.type : void 0;
+  const byKey = /* @__PURE__ */ new Map();
+  const drafts = [];
+  const off = [];
+  const problems = [];
+  const builtinOff = /* @__PURE__ */ new Set();
+  for (const { layer, rel } of await layerFiles(root, repo, type)) {
+    const { file, problem } = await readLayer(root, rel);
+    if (problem)
+      problems.push(problem);
+    if (!file)
+      continue;
+    const at = `${relDir(root)}/${rel}`;
+    for (const x of layer === "imported" ? [] : file.off) {
+      off.push({ ...x, layer, file: at });
+      if (x.key.startsWith("builtin:"))
+        builtinOff.add(x.key.slice("builtin:".length));
+      else
+        byKey.delete(x.key);
+    }
+    for (const r of file.rules) {
+      const e = { ...r, layer, file: at, id: ruleId(r) };
+      if (r.status === "draft")
+        drafts.push(e);
+      else {
+        const had = byKey.get(r.key);
+        if (had && had.layer === "imported" && layer === "imported")
+          problems.push(`${had.file} and ${at} both have an active rule ${r.key}: ${at}'s is given to reads. Rename one, or set one back to draft.`);
+        byKey.set(r.key, e);
+      }
+    }
+  }
+  return {
+    rules: [...byKey.values()],
+    drafts,
+    off,
+    problems,
+    builtinOff: [...builtinOff].sort()
+  };
+}
+var ruleMatches = (r, path) => !r.files?.length || r.files.some((g) => globToRegExp(g).test(path));
+var ruleIds = (e) => e.rules.map((r) => r.id).sort();
+function orgRulesLacking(rec, e) {
+  const had = new Set(rec?.sets ?? []);
+  return e.rules.filter((r) => !had.has(r.id));
+}
+function readingRulesText(e, only) {
+  const rules = only ? e.rules.filter((r) => only.has(r.id)) : e.rules;
+  if (!rules.length && !e.builtinOff.length)
+    return "";
+  return [
+    "## The organisation's reading rules for this repo",
+    "",
+    "These come from the organisation's org pack, reviewed like code. Follow them as you follow the rules above; every fact still cites its line, and a rule never changes a fact's shape.",
+    "",
+    ...rules.map((r) => `- ${r.key} (${r.layer}${r.files?.length ? `; for ${r.files.join(", ")}` : ""}): ${r.rule.replace(/\s+/g, " ").trim()}${exampleOf(r.example)}`),
+    ...e.builtinOff.length ? [
+      "",
+      `Switched off here by the organisation: Atticus's ${e.builtinOff.join(", ")} rules; leave out what only they ask for.`
+    ] : []
+  ].join("\n");
+}
+var exampleOf = (e) => {
+  if (!e || e.length > 300)
+    return "";
+  const m = /^(.+):(\d+)$/.exec(e);
+  if (!m)
+    return "";
+  const rel = m[1].replace(/\\/g, "/");
+  if (/^([A-Za-z]:|\/|~)/.test(rel))
+    return "";
+  const segs = rel.split("/");
+  const last = segs.at(-1);
+  const folders = segs.slice(0, -1);
+  const ok = /^[^\s`/:,]+$/.test(last) && folders.every((x) => x !== ".." && !/[`\n\r:,!?]|\.\s/.test(x) && x.split(/\s+/).length <= 2) && folders.filter((x) => /\s/.test(x)).length <= 1;
+  return ok ? ` For example \`${e}\`.` : "";
+};
+async function rulesLackingAll(root, repo, rec, o = {}) {
+  const { rulesLacking } = await import("./chunk-G6X4YL4D.js");
+  return [
+    ...rulesLacking(rec),
+    ...orgRulesLacking(rec, await effectiveRules(root, repo, o).catch(() => void 0) ?? {
+      rules: [],
+      drafts: [],
+      off: [],
+      problems: [],
+      builtinOff: []
+    }).filter((r) => r.files?.length).map((r) => r.id)
+  ];
+}
+function kindGlob(file) {
+  const base = file.split("/").pop() ?? file;
+  const m = /([A-Z][a-z0-9]+)\.([A-Za-z0-9]+)$/.exec(base);
+  return m ? `**/*${m[1]}.${m[2]}` : `**/${base}`;
+}
+function ruleFromPairing(o) {
+  const key = `paths-to-${o.to}`.toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 60);
+  return {
+    key,
+    status: "draft",
+    rule: `In ${o.type} repos, a call to ${o.to} can name its path through a field, a setting or a helper (here \`${o.value}\`), not the path itself: follow it to the literal path the code or its settings give, and write that as the call's path, with the line that sets it in cite.with. The routes it reaches start like ${[o.method, o.path].filter(Boolean).join(" ")}.`,
+    files: [kindGlob(o.file)],
+    example: `${o.file}:${o.line}`,
+    by: `drafted${o.drafter ? ` by ${o.drafter}` : ""} from ${o.by}'s pairing on the canvas`
+  };
+}
+
+export {
+  repoTypeOf,
+  notesAt,
+  rulesDirOf,
+  ruleId,
+  effectiveRules,
+  ruleMatches,
+  ruleIds,
+  orgRulesLacking,
+  readingRulesText,
+  exampleOf,
+  rulesLackingAll,
+  kindGlob,
+  ruleFromPairing
+};

package/dist/{chunk-YY6ZQQBP.js → chunk-GK4PYVEC.js}

@@ -3,22 +3,22 @@ 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 {
+  doctorChecks
+} from "./chunk-HGHRSF3E.js";
 import {
   buildSite,
   catalogRecords,
   openChanges
-} from "./chunk-B2WLAWNJ.js";
-import {
-  doctorChecks
-} from "./chunk-AIOQPLA5.js";
+} from "./chunk-FY3QIRTL.js";
 import {
   readProbes,
   whatRunsWhere
-} from "./chunk-IPKHE5D6.js";
+} from "./chunk-3AQ2R5NL.js";
 import {
   baseClonePath,
   loadRepos
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-XOL3GFW2.js";
 import {
   CatalogBaseline,
   DEFAULT_RUNTIME,
@@ -28,7 +28,7 @@ import {
   loadOrgPack,
   orgPackDirOf,
   require_dist
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-PAINMSID.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -90,7 +90,17 @@ async function setupSteps(root, o = {}) {
       label: "The org pack has an owner",
       done: !!op.pack?.owner && op.pack.owner !== "unassigned",
       detail: op.pack?.owner && op.pack.owner !== "unassigned" ? op.pack.owner : "unassigned",
-      fix: "Set owner in org-pack/pack.yaml to the person who looks after the org pack (normally the platform lead), and commit it through a pull request."
+      fix: "Name the person who looks after the org pack (normally the platform lead): type their handle under this step on Home in the app, or run atticus orgpack owner <handle>. It is saved as owner in org-pack/pack.yaml; propose it for review."
+    },
+    {
+      // Ninth UX walk: the constitution's pattern rule has nothing to check against while the
+      // registry is empty (so it doesn't fire), and nobody can pick a code: register them here.
+      id: "patterns",
+      label: "The integration pattern registry has patterns",
+      done: op.patterns.length > 0,
+      detail: op.patterns.length ? `${op.patterns.length} pattern${op.patterns.length === 1 ? "" : "s"}: ${op.patterns.map((p) => p.code).sort().join(", ")}` : "empty: the critic can't check a hop's pattern until it has some",
+      fix: "Add one YAML file per integration pattern your organisation approves under org-pack/patterns/ (its code, status confirmed, its route and controls; the starter pack's patterns show the shape), run atticus orgpack validate, and propose it for review. The app has no editor for patterns yet.",
+      optional: true
     },
     {
       // ADR 0121 item 6: how AI runs here is a choice, not the default left by accident.

package/dist/{chunk-TDD55CJH.js → chunk-GNWAOVFQ.js}

@@ -5,26 +5,26 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   loadCatalog
-} from "./chunk-FITWGOJ2.js";
+} from "./chunk-5QUOPNLN.js";
 import {
   TARGET_DIR,
   mergeDelta,
   readDeltas
-} from "./chunk-CKSITVS4.js";
+} from "./chunk-BEPCKDCP.js";
 import {
   changeStore
-} from "./chunk-XY3P7JW7.js";
+} from "./chunk-HSZMPH5T.js";
 import {
   changeView,
   toDrawio,
   toMermaid
-} from "./chunk-PAMPPUR6.js";
+} from "./chunk-JYMIB5XY.js";
 import {
   changesDirOf,
   changesRelOf,
   readRepoSpec,
   specRepos
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-PAINMSID.js";
 
 // packages/cli/dist/change-map.js
 import { stat } from "node:fs/promises";
@@ -56,6 +56,7 @@ async function targetFlowsOf(root, change) {
     title,
     source: `${changesRelOf(root)}/${change}/${TARGET_DIR}`,
     merged,
+    deltas,
     problems,
     records,
     known