@maycombhq/atticus 2.0.0-beta.26 → 2.0.0-beta.27.1

package/dist/{chunk-YYV276DM.js → chunk-6MSACVCY.js}

@@ -8,32 +8,33 @@ import {
   knowledgeAppliesMarkdown,
   readKnowledgeApplies,
   setKnowledgeStatus
-} from "./chunk-CSHJZFOE.js";
-import "./chunk-5A4RHEEL.js";
-import "./chunk-VIQHZA53.js";
-import "./chunk-WH3ZFLXT.js";
-import "./chunk-UTZMF5CV.js";
-import "./chunk-6U65YB54.js";
-import "./chunk-SZDOBIWE.js";
-import "./chunk-2HDNOUJU.js";
-import "./chunk-RK5P2DWD.js";
+} from "./chunk-DTW37FJ6.js";
+import "./chunk-INCFIDCB.js";
+import "./chunk-LP6BFBE5.js";
+import "./chunk-YBAJ5SAR.js";
+import "./chunk-23TTURB2.js";
+import "./chunk-6H62UHY5.js";
+import "./chunk-YIGSUTW2.js";
 import {
   conflictLine
-} from "./chunk-K3QKOVZN.js";
-import "./chunk-QAFQLILX.js";
-import "./chunk-HQMLY2R6.js";
-import "./chunk-I2EWY3MG.js";
-import "./chunk-UFIQ5FWY.js";
-import "./chunk-ZDA72732.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-XIJBQM45.js";
+} from "./chunk-N5DLB74D.js";
+import "./chunk-4NPWOUI2.js";
+import "./chunk-I57IH5X6.js";
+import "./chunk-LCQIRCOT.js";
+import "./chunk-X5B7KYPD.js";
+import "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
 import {
   changesRelOf
-} from "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/knowledge-applies-commands.js

package/dist/{chunk-GXJ2PSDW.js → chunk-6OTGCKYH.js}

@@ -5,15 +5,15 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   conformanceCommand
-} from "./chunk-3KIMLBGZ.js";
-import "./chunk-RTCZKKG7.js";
-import "./chunk-6U65YB54.js";
-import "./chunk-I2EWY3MG.js";
-import "./chunk-UFIQ5FWY.js";
-import "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-UDM6HGF4.js";
+import "./chunk-IPMPLTEG.js";
+import "./chunk-I57IH5X6.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
+import "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-HSJKYDHI.js → chunk-6TXB2WR6.js}

@@ -5,7 +5,7 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   readCatalog
-} from "./chunk-2HDNOUJU.js";
+} from "./chunk-6H62UHY5.js";
 import {
   VIEW_NAMES,
   ViewError,
@@ -14,16 +14,16 @@ import {
   toDrawio,
   toMermaid,
   viewFromDiagram
-} from "./chunk-RK5P2DWD.js";
+} from "./chunk-YIGSUTW2.js";
 import {
   readDrawio
-} from "./chunk-HQMLY2R6.js";
+} from "./chunk-ELJ5Q4J2.js";
 import {
   orgPackDirOf
-} from "./chunk-6ZDAEUKB.js";
+} from "./chunk-WJWSB65O.js";
 import {
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 
 // packages/cli/dist/diagram-commands.js
 import { mkdir, readFile, writeFile } from "node:fs/promises";

package/dist/{chunk-KL7UHAOR.js → chunk-6VFR3DYS.js}

@@ -5,29 +5,31 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   upgradeCommand
-} from "./chunk-WT6EXYEY.js";
+} from "./chunk-LJEEVZIH.js";
 import {
   generateAssistantFiles
-} from "./chunk-IBIIKUC7.js";
+} from "./chunk-G33UIUG3.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
 import {
   changeStore
-} from "./chunk-WH3ZFLXT.js";
-import {
-  fileStepStore
-} from "./chunk-6U65YB54.js";
+} from "./chunk-YBAJ5SAR.js";
 import {
   readCatalog,
-  scanEstate,
-  writeCatalog
-} from "./chunk-2HDNOUJU.js";
+  scanIntoCatalog
+} from "./chunk-6H62UHY5.js";
+import {
+  ownerQuestionStillAsked
+} from "./chunk-N5DLB74D.js";
+import {
+  fileStepStore
+} from "./chunk-I57IH5X6.js";
 import {
   buildContextPack,
   formatOf,
   screenText
-} from "./chunk-ZDA72732.js";
+} from "./chunk-2MRYL45Z.js";
 import {
   LIFECYCLE_STATES,
   LifecycleState,
@@ -36,14 +38,15 @@ import {
   recordReferences,
   stateDirOf,
   toCanonicalYaml
-} from "./chunk-6ZDAEUKB.js";
+} from "./chunk-WJWSB65O.js";
 import {
   AgentDefinition,
   CORE_ROLES,
   Finding,
   RecordId,
-  external_exports
-} from "./chunk-LZFKJ2BR.js";
+  external_exports,
+  loadOrgPack
+} from "./chunk-A3LVMCA5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -612,9 +615,8 @@ async function startLesson(root, roleOrLesson, o = {}) {
   if (!resumed) {
     for (const s of lesson.setup) {
       if (s === "scan") {
-        const scan = await scanEstate({ root });
-        await writeCatalog(join4(catalogDirOf(root), "generated"), scan.records);
-        setup.push(`Scanned the sandbox: ${scan.records.length} records in catalog/generated.`);
+        const { scan, result } = await scanIntoCatalog({ root, command: "atticus learn start" });
+        setup.push(result?.write ? `Scanned the sandbox: ${scan.records.length} records in catalog/generated.` : `Scanned the sandbox, but wrote nothing: ${result?.guard.refused?.message.split("\n")[0] ?? "it read no repo in full"}`);
       }
     }
     p.lessons[lesson.id] = { startedAt: iso(o.now ?? /* @__PURE__ */ new Date()), steps: {} };
@@ -1617,7 +1619,7 @@ var STATE_TEXT = {
   archived: "archived"
 };
 var words = (r, keys) => keys.filter((k) => r[k] !== void 0 && r[k] !== "" && !(Array.isArray(r[k]) && r[k].length === 0));
-function recordLines(r, all) {
+function recordLines(r, all, o = {}) {
   const x = r;
   const lines = [];
   const seeAlso = [];
@@ -1670,7 +1672,10 @@ function recordLines(r, all) {
         lines.push(`Until then it blocks ${r.blocks.join(", ")}.`);
       break;
     case "OwnerQuestion":
-      lines.push(`${r.owner} was asked (${r.questionState}): ${r.question}`);
+      if (o.closed)
+        lines.push(`${r.owner} was asked: ${r.question}`, "The knowledge gap it asked about is closed now (the fact is in the catalog), so it waits on no answer.");
+      else
+        lines.push(`${r.owner} was asked (${r.questionState}): ${r.question}`);
       break;
     case "Capability":
       lines.push(`"${r.name}" starts at ${r.entryPoints.join(", ") || "no known entry point"} and reaches ${r.records.length} record${r.records.length === 1 ? "" : "s"}.`);
@@ -1690,9 +1695,9 @@ function recordLines(r, all) {
     lines.push(`It refers to ${ids.slice(0, 8).join(", ")}${ids.length > 8 ? ` and ${ids.length - 8} more` : ""}.`);
     seeAlso.push(...ids.slice(0, 5));
   }
-  const back = all.filter((o) => o !== r && recordReferences(o).some((f) => f.id === r.id));
+  const back = all.filter((o2) => o2 !== r && recordReferences(o2).some((f) => f.id === r.id));
   if (back.length) {
-    const ids = [...new Set(back.map((o) => o.id))];
+    const ids = [...new Set(back.map((o2) => o2.id))];
     lines.push(`${ids.length} record${ids.length === 1 ? " refers" : "s refer"} to it, such as ${ids.slice(0, 5).join(", ")}.`);
     seeAlso.push(`atticus impact ${r.id}`);
   }
@@ -1748,7 +1753,17 @@ async function explain(root, subject, o = {}) {
     const hits = records.filter((r) => r.id === s);
     if (hits.length) {
       const r = hits[0];
-      const { lines, seeAlso } = recordLines(r, records);
+      let closed = false;
+      if (r.kind === "OwnerQuestion" && r.questionState !== "answered") {
+        const orgPack = await loadOrgPack(orgPackDirOf(root)).catch(() => void 0);
+        if (orgPack)
+          closed = !ownerQuestionStillAsked({
+            records,
+            orgPack,
+            now: (o.now ?? /* @__PURE__ */ new Date()).toISOString()
+          })(r);
+      }
+      const { lines, seeAlso } = recordLines(r, records, { closed });
       out = {
         subject: s,
         kind: "record",

package/dist/{chunk-KS2IQYTZ.js → chunk-7BOGXFZ3.js}

@@ -7,18 +7,18 @@ import {
   INPUTS_SOURCE,
   INPUTS_SOURCE_ID,
   inputsPages
-} from "./chunk-F4EGHECF.js";
-import "./chunk-QAFQLILX.js";
-import "./chunk-HQMLY2R6.js";
-import "./chunk-I2EWY3MG.js";
-import "./chunk-UFIQ5FWY.js";
-import "./chunk-ZDA72732.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-EM6DKBTJ.js";
+import "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
+import "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
 import "./chunk-TV45EUGM.js";
 export {
   INPUTS_SOURCE,

package/dist/chunk-7GZ46N4V.js

@@ -0,0 +1,37 @@
+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 {
+  catalogRecords,
+  guideCommand,
+  openChanges,
+  siteBuildCommand
+} from "./chunk-RDFRB26Z.js";
+import "./chunk-YBAJ5SAR.js";
+import "./chunk-23TTURB2.js";
+import "./chunk-6H62UHY5.js";
+import "./chunk-YIGSUTW2.js";
+import "./chunk-N5DLB74D.js";
+import "./chunk-4NPWOUI2.js";
+import "./chunk-I57IH5X6.js";
+import "./chunk-X5B7KYPD.js";
+import "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
+import "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
+import "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
+import "./chunk-TV45EUGM.js";
+export {
+  catalogRecords,
+  guideCommand,
+  openChanges,
+  siteBuildCommand
+};

package/dist/{chunk-KFJMQUSK.js → chunk-7HUCEHUK.js}

@@ -5,36 +5,37 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   INPUTS_SOURCE_ID
-} from "./chunk-F4EGHECF.js";
+} from "./chunk-EM6DKBTJ.js";
 import {
   readCatalog
-} from "./chunk-2HDNOUJU.js";
-import "./chunk-RK5P2DWD.js";
+} from "./chunk-6H62UHY5.js";
+import "./chunk-YIGSUTW2.js";
 import {
   readKnowledge,
   readSnapshot
-} from "./chunk-K3QKOVZN.js";
+} from "./chunk-N5DLB74D.js";
+import "./chunk-4NPWOUI2.js";
+import "./chunk-X5B7KYPD.js";
 import {
   scanInputs
-} from "./chunk-QAFQLILX.js";
-import "./chunk-HQMLY2R6.js";
-import "./chunk-I2EWY3MG.js";
-import "./chunk-UFIQ5FWY.js";
-import "./chunk-ZDA72732.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-XIJBQM45.js";
+} from "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
 import {
   catalogDirOf,
   inputsDirOf,
   knowledgeRelOf,
   orgPackDirOf
-} from "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.js";
+} from "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
 import {
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/documents.js

package/dist/{chunk-LY7DOYX2.js → chunk-7LOXUBRB.js}

@@ -12,14 +12,11 @@ import {
   readChangeTasks,
   setTaskDone,
   taskBranchOwnCommits
-} from "./chunk-DPH4BS3F.js";
-import {
-  buildEngineFor
-} from "./chunk-IBIIKUC7.js";
+} from "./chunk-L3KSU4QU.js";
 import {
   slug,
   writeGateRound
-} from "./chunk-SAPX3PVK.js";
+} from "./chunk-4BK5EJ2C.js";
 import {
   conform,
   readConformDeltas,
@@ -27,56 +24,66 @@ import {
   renderTaskContext,
   taskContext,
   withBuildLine
-} from "./chunk-CSHJZFOE.js";
+} from "./chunk-DTW37FJ6.js";
+import {
+  buildEngineFor
+} from "./chunk-G33UIUG3.js";
 import {
   readChangeFiles,
   readRound,
   readStoryIndex,
   roundsOf,
   writeQuarantineItems
-} from "./chunk-VIQHZA53.js";
+} from "./chunk-LP6BFBE5.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-WH3ZFLXT.js";
+} from "./chunk-YBAJ5SAR.js";
+import {
+  scanEstate
+} from "./chunk-6H62UHY5.js";
 import {
   AdapterError,
   createAdapters,
   fileStepStore,
   requireApproval
-} from "./chunk-6U65YB54.js";
+} from "./chunk-I57IH5X6.js";
 import {
-  scanEstate
-} from "./chunk-2HDNOUJU.js";
+  baseClonePath,
+  createGit,
+  toRepoRelative
+} from "./chunk-X5B7KYPD.js";
 import {
   HandoffRuntime,
   buildContextPack,
   createRuntime,
   quarantineItems,
   toRunSummary
-} from "./chunk-ZDA72732.js";
-import {
-  baseClonePath,
-  createGit,
-  toRepoRelative
-} from "./chunk-XIJBQM45.js";
+} from "./chunk-2MRYL45Z.js";
 import {
   api_exports,
   changeBranch,
   changesDirOf,
   changesRelOf,
+  currentSignal,
   readRepoSpec,
   runsDirOf,
   runsRelOf,
   stateDirOf,
   taskBranch,
   toCanonicalYaml
-} from "./chunk-6ZDAEUKB.js";
+} from "./chunk-WJWSB65O.js";
 import {
   LockHeldError,
+  TREE_SIGNAL_GRACE_MS,
   acquireLock,
+  holdStop,
+  onStopping,
+  stopProcessGroup,
+  stopTrackedTrees,
+  trackTree,
   writeFileAtomic
-} from "./chunk-MEMEO7YO.js";
+} from "./chunk-SMFFUFMN.js";
 import {
   AgentDefinition,
   ChecklistPack,
@@ -85,7 +92,7 @@ import {
   RunSummary,
   RuntimeKind,
   external_exports
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -185,102 +192,21 @@ ${text}` : text;
     }
   };
 }
-function stopTree(child, signal = "SIGTERM") {
-  if (child.pid === void 0)
-    return;
-  if (process.platform === "win32") {
-    const k = spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"], { windowsHide: true });
-    k.on("error", () => child.kill());
-    return;
-  }
-  try {
-    process.kill(-child.pid, signal);
-  } catch {
-    child.kill(signal);
-  }
-}
-var live = /* @__PURE__ */ new Set();
-var SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+var stopTree = (child, signal = "SIGTERM") => stopProcessGroup(child, signal);
 var stopping = false;
 var stopRequested = () => stopping;
 var stopper = new AbortController();
 var stopSignal = stopper.signal;
-function stopAllBuilds() {
+onStopping(() => {
   stopping = true;
-  for (const c of live)
-    stopTree(c);
   if (!stopper.signal.aborted)
     stopper.abort();
+});
+function stopAllBuilds() {
+  stopTrackedTrees();
 }
-var holds = 0;
-var pending;
-var SIGNAL_GRACE_MS = 1e4;
-var onSignal = (sig) => {
-  stopAllBuilds();
-  if (process.listenerCount(sig) > 1)
-    return;
-  if (!pending) {
-    pending = sig;
-    setTimeout(raise, SIGNAL_GRACE_MS);
-  }
-  settle();
-};
-function raise() {
-  const sig = pending;
-  if (!sig)
-    return;
-  unhook();
-  process.kill(process.pid, sig);
-}
-function settle() {
-  if (holds > 0 || live.size > 0)
-    return;
-  if (pending)
-    raise();
-  else
-    unhook();
-}
-var onExit = () => {
-  for (const c of live)
-    stopTree(c, "SIGKILL");
-};
-var hooked = false;
-function hook() {
-  if (hooked)
-    return;
-  hooked = true;
-  for (const s of SIGNALS)
-    process.prependListener(s, onSignal);
-  process.on("exit", onExit);
-}
-function unhook() {
-  if (!hooked)
-    return;
-  hooked = false;
-  for (const s of SIGNALS)
-    process.off(s, onSignal);
-  process.off("exit", onExit);
-}
-function holdSignals() {
-  holds++;
-  hook();
-  let released = false;
-  return () => {
-    if (released)
-      return;
-    released = true;
-    holds--;
-    settle();
-  };
-}
-var track = (c) => {
-  live.add(c);
-  hook();
-};
-var untrack = (c) => {
-  live.delete(c);
-  settle();
-};
+var SIGNAL_GRACE_MS = TREE_SIGNAL_GRACE_MS;
+var holdSignals = () => holdStop();
 var STOP_GRACE_MS = 5e3;
 function shellCommandRunner() {
   return (command, cwd, o = {}) => new Promise((resolve) => {
@@ -288,6 +214,11 @@ function shellCommandRunner() {
       resolve({ exitCode: null, stdout: "", stderr: "Atticus is stopping.", stopped: true });
       return;
     }
+    const signal = o.signal ?? currentSignal();
+    if (signal?.aborted) {
+      resolve({ exitCode: null, stdout: "", stderr: "Stopped.", stopped: true });
+      return;
+    }
     const child = spawn(command, {
       cwd,
       shell: true,
@@ -296,7 +227,7 @@ function shellCommandRunner() {
       // Its own process group off Windows, so a timeout stops the build, not only the shell.
       detached: process.platform !== "win32"
     });
-    track(child);
+    const untrack = trackTree(child, (s) => stopTree(child, s));
     const out = tail();
     const err = tail();
     let done2 = false;
@@ -309,9 +240,15 @@ function shellCommandRunner() {
       clearTimeout(timer);
       clearTimeout(kill);
       clearTimeout(drain);
-      untrack(child);
-      resolve(stopping ? { ...r, stopped: true } : r);
+      signal?.removeEventListener("abort", onStop);
+      untrack();
+      resolve(stopping || signal?.aborted ? { ...r, stopped: true } : r);
+    };
+    const onStop = () => {
+      stopTree(child);
+      kill ??= setTimeout(() => stopTree(child, "SIGKILL"), STOP_GRACE_MS);
     };
+    signal?.addEventListener("abort", onStop, { once: true });
     const timer = setTimeout(() => {
       stopTree(child);
       kill = setTimeout(() => stopTree(child, "SIGKILL"), STOP_GRACE_MS);
@@ -675,7 +612,11 @@ function gitScanAt(root, git) {
         root,
         repos: [repo],
         repoDir: () => dir,
-        repoState: async () => ({ commit: commit2, dirty: false })
+        repoState: async () => ({ commit: commit2, dirty: false }),
+        git,
+        // Rule 4 at the branch's commit: the facts verify kept, carried to it as verify carries
+        // them, never facts citing a file the branch changed (eighth UX walk, ADR 0195 point 2).
+        carryFacts: true
       });
       const files = (await git(["ls-tree", "-r", "--name-only", commit2], base)).stdout.split("\n").map((l) => l.trim()).filter(Boolean);
       return {