@maycombhq/atticus 2.0.0-beta.22 → 2.0.0-beta.24

package/dist/{chunk-C3RY6KU6.js → chunk-W4EG25TI.js}

@@ -3,56 +3,65 @@ 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 {
-  QueryError,
-  askLookup,
-  graph,
-  impact,
-  openIndex,
-  translate
-} from "./chunk-ISUAAMGS.js";
 import {
   readRound,
   reviewedGates,
   roundsOf
-} from "./chunk-S4PMJU6H.js";
+} from "./chunk-A6ZG3UOS.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-IDKCWSM5.js";
+} from "./chunk-U2JTTRKS.js";
+import {
+  QueryError,
+  askLookup,
+  graph,
+  impact,
+  openIndex,
+  translate
+} from "./chunk-MCE74XMF.js";
 import {
   baseClonePath,
   gitUser,
   loadRepos
-} from "./chunk-PKBHS4AA.js";
+} from "./chunk-OSZTENIA.js";
 import {
   API_VERSION,
   DEFAULT_PORT,
-  Lens,
-  RECORD_KINDS,
-  RecordId,
-  Severity,
   api_exports,
+  asksOfFinding,
   catalogDirOf,
+  catalogMayHaveChangedAt,
   factsDirOf,
-  fastPathOf,
   inputsDirOf,
   knowledgeDirOf,
   layoutOf,
-  loadOrgPack,
   openspecDirOf,
   orgPackDirOf,
   proposalsDirOf,
-  questionOfLens,
   questionsDirOf,
+  rolesOfPerson,
   runsDirOf,
   specsDirOf,
   withSignal
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-GJVCBTSO.js";
 import {
   FileChangedError,
+  printToCurrent,
+  withPrinter
+} from "./chunk-G3ZFEHCX.js";
+import {
+  Lens,
+  RECORD_KINDS,
+  RecordId,
+  Severity,
+  fastPathOf,
+  loadOrgPack,
+  questionOfLens
+} from "./chunk-QFDPX6C4.js";
+import {
   SCHEMA_VERSION
-} from "./chunk-TUULXQRW.js";
+} from "./chunk-CTJHEG6A.js";
 
 // packages/server/dist/http.js
 var HttpError = class extends Error {
@@ -136,125 +145,73 @@ function intParam(q, name, min, max) {
 }
 var strParam = (q, name) => q.get(name) || void 0;
 
-// packages/server/dist/server.js
-import { randomBytes as randomBytes2 } from "node:crypto";
-import { createServer } from "node:http";
-
-// packages/server/dist/jobs.js
-var JobManager = class {
-  publish;
-  now;
-  jobs = /* @__PURE__ */ new Map();
-  cancelledIds = /* @__PURE__ */ new Set();
-  aborts = /* @__PURE__ */ new Map();
-  seq = 0;
-  /** Round 41: every running job of a kind, in start order (a later one never hides an earlier). */
-  running = /* @__PURE__ */ new Map();
-  constructor(publish, now = () => /* @__PURE__ */ new Date()) {
-    this.publish = publish;
-    this.now = now;
-  }
-  /**
-   * A running job of a kind, if any: the earliest still running (one scan at a time: a second
-   * ask gets 409).
-   */
-  runningOf(kind) {
-    for (const id of this.running.get(kind) ?? []) {
-      const j = this.jobs.get(id);
-      if (j?.state === "running")
-        return j;
-    }
-    return void 0;
-  }
-  get(id) {
-    return this.jobs.get(id);
-  }
-  start(kind, work) {
-    const id = `job-${++this.seq}`;
-    const job = {
-      id,
-      kind,
-      state: "running",
-      progress: { done: 0, total: 0, message: "Starting" },
-      startedAt: this.now().toISOString(),
-      errors: []
-    };
-    this.jobs.set(id, job);
-    const ofKind = this.running.get(kind) ?? /* @__PURE__ */ new Set();
-    ofKind.add(id);
-    this.running.set(kind, ofKind);
-    const abort = new AbortController();
-    this.aborts.set(id, abort);
-    const cancelled = this.cancelledIds;
-    const control = {
-      progress: (done, total, message) => {
-        job.progress = { done, total, message };
-        this.publish({ type: "job.progress", jobId: id, done, total, message });
-      },
-      get cancelled() {
-        return cancelled.has(id);
-      }
-    };
-    void (async () => {
-      try {
-        const out = await withSignal(abort.signal, () => work(control));
-        if (out?.result)
-          job.result = out.result;
-        if (out?.errors?.length)
-          job.errors.push(...out.errors);
-        job.state = this.cancelledIds.has(id) ? "cancelled" : job.errors.length ? "failed" : "done";
-      } catch (e) {
-        if (this.cancelledIds.has(id))
-          job.state = "cancelled";
-        else {
-          job.errors.push(e instanceof Error ? e.message : String(e));
-          job.state = "failed";
-        }
-      }
-      this.aborts.delete(id);
-      job.finishedAt = this.now().toISOString();
-      ofKind.delete(id);
-      if (!ofKind.size && this.running.get(kind) === ofKind)
-        this.running.delete(kind);
-      this.publish({ type: "job.done", jobId: id, state: job.state });
-    })();
-    return job;
-  }
-  /** Ask a running job to stop; false when it already finished. */
-  cancel(id) {
-    const j = this.jobs.get(id);
-    if (!j || j.state !== "running")
-      return false;
-    this.cancelledIds.add(id);
-    this.aborts.get(id)?.abort();
-    return true;
-  }
-  /** Wait for a job to finish (tests and the CLI). */
-  async settle(id, timeoutMs = 6e4) {
-    const start = Date.now();
-    for (; ; ) {
-      const j = this.jobs.get(id);
-      if (!j)
-        throw new Error(`No job ${id}`);
-      if (j.state !== "running" && j.state !== "queued")
-        return j;
-      if (Date.now() - start > timeoutMs)
-        throw new Error(`Job ${id} did not finish`);
-      await new Promise((r) => setTimeout(r, 20));
-    }
-  }
-};
-
 // packages/server/dist/routes.js
+import { existsSync } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
 import { join } from "node:path";
 var queues = /* @__PURE__ */ new Map();
-async function withIndex(root, f) {
+var checked = /* @__PURE__ */ new Map();
+var TRUST_MS = 3e4;
+var following = /* @__PURE__ */ new Set();
+var changes = /* @__PURE__ */ new Map();
+function trustIndexBetweenChanges(root, on) {
+  if (on)
+    following.add(root);
+  else {
+    following.delete(root);
+    checked.delete(root);
+  }
+}
+function indexFilesChanged(root) {
+  for (const r of root ? [root] : [...following, ...checked.keys()]) {
+    checked.delete(r);
+    changes.set(r, (changes.get(r) ?? 0) + 1);
+  }
+}
+var embedding = /* @__PURE__ */ new Map();
+var asked = /* @__PURE__ */ new Map();
+function embedSoon(root) {
+  if (embedding.has(root) || process.env.ATTICUS_EMBEDDINGS === "off")
+    return;
+  const step = () => {
+    if (Date.now() - (asked.get(root) ?? 0) < 1500) {
+      embedding.set(root, setTimeout(step, 1e3).unref());
+      return;
+    }
+    void withIndex(root, (ix) => ix.embed({ max: 8 }), { meaning: true }).then((n) => n > 0, () => false).then((more) => {
+      if (more && embedding.has(root))
+        embedding.set(root, setTimeout(step, 50).unref());
+      else
+        embedding.delete(root);
+    });
+  };
+  embedding.set(root, setTimeout(step, 2e3).unref());
+}
+function stopEmbedding(root) {
+  const t = embedding.get(root);
+  if (t)
+    clearTimeout(t);
+  embedding.delete(root);
+}
+async function withIndex(root, f, o = {}) {
+  if (!o.meaning)
+    asked.set(root, Date.now());
   const before = queues.get(root) ?? Promise.resolve();
   const mine = before.then(async () => {
-    const ix = await openIndex(root);
+    const trusted = following.has(root) && Date.now() - (checked.get(root) ?? -Infinity) < TRUST_MS;
+    const at = changes.get(root) ?? 0;
+    const ix = await openIndex(root, {
+      embedOnOpen: 0,
+      // Only search and ask compare by meaning; the counts, lists and graph never need the model.
+      ...o.meaning ? {} : { embeddings: "off" },
+      ...trusted ? { trusted: true } : {}
+    });
+    if (!trusted && following.has(root) && (changes.get(root) ?? 0) === at)
+      checked.set(root, Date.now());
+    if (!trusted && !o.meaning)
+      embedSoon(root);
     try {
-      return f(ix);
+      return await f(ix);
     } finally {
       ix.close();
     }
@@ -317,7 +274,9 @@ function apiRoutes(r, ctx) {
       root,
       openspec: layoutOf(root).openspec.replace(/\/+$/, ""),
       user: ctx.user,
-      full: ctx.full === true
+      full: ctx.full === true,
+      // ADR 0190: in a folder that isn't a metarepo yet, the app offers to create one.
+      metarepo: existsSync(join(root, "org-pack")) || existsSync(join(root, ".atticus", "org-pack"))
     }
   })).add("GET", "/api/catalog/kinds", async () => ({
     status: 200,
@@ -357,26 +316,25 @@ function apiRoutes(r, ctx) {
     const q = strParam(query, "q");
     if (!q)
       throw badRequest("Ask a question: ?q=<plain words>.");
-    return {
-      status: 200,
-      body: await withIndex(root, (ix) => {
-        const asked = translate(q, askLookup(ix));
-        if (asked.action === "impact")
-          return { question: q, ...asked, impact: impact(ix, asked.id, 4) };
-        if (asked.action === "owner") {
-          const r2 = ix.find(asked.id)[0];
-          const owner = r2?.owner ?? r2?.ownerComponent ?? (r2 ? ix.find(String(r2.system ?? ""))[0]?.owner : void 0);
-          return { question: q, ...asked, owner: owner ?? null };
-        }
-        try {
-          return { question: q, ...asked, result: ix.query(asked.query, { limit: 60 }) };
-        } catch (e) {
-          if (e instanceof QueryError)
-            return { question: q, ...asked, error: e.message };
-          throw e;
-        }
-      })
-    };
+    const knowledge = ctx.askKnowledge ? await ctx.askKnowledge(q).catch(() => void 0) : void 0;
+    const answer = await withIndex(root, (ix) => {
+      const asked2 = translate(q, askLookup(ix));
+      if (asked2.action === "impact")
+        return { question: q, ...asked2, impact: impact(ix, asked2.id, 4) };
+      if (asked2.action === "owner") {
+        const r2 = ix.find(asked2.id)[0];
+        const owner = r2?.owner ?? r2?.ownerComponent ?? (r2 ? ix.find(String(r2.system ?? ""))[0]?.owner : void 0);
+        return { question: q, ...asked2, owner: owner ?? null };
+      }
+      try {
+        return { question: q, ...asked2, result: ix.query(asked2.query, { limit: 60 }) };
+      } catch (e) {
+        if (e instanceof QueryError)
+          return { question: q, ...asked2, error: e.message };
+        throw e;
+      }
+    });
+    return { status: 200, body: knowledge ? { ...answer, knowledge } : answer };
   }).add("GET", "/api/graph", async ({ query }) => {
     const depth = intParam(query, "depth", 1, 6);
     const o = {
@@ -450,7 +408,7 @@ function apiRoutes(r, ctx) {
     if (!res)
       throw notFound(`There is no record ${params.id} in the catalog.`);
     const near = /* @__PURE__ */ new Set([...res.systems, params.id, ...res.reach.affected.map((a) => a.id)]);
-    const changes = (await changeStore(root).list()).filter((c) => c.systems.some((s) => near.has(s)) || [...c.touches.records, ...c.touches.tables, ...c.touches.dataStores].some((x) => near.has(x))).map((c) => ({
+    const changes2 = (await changeStore(root).list()).filter((c) => c.systems.some((s) => near.has(s)) || [...c.touches.records, ...c.touches.tables, ...c.touches.dataStores].some((x) => near.has(x))).map((c) => ({
       id: c.id,
       title: c.title,
       state: c.state,
@@ -467,7 +425,7 @@ function apiRoutes(r, ctx) {
         call: res.owners,
         ownerUnknown: res.unowned,
         watch: res.watch,
-        recentChanges: changes
+        recentChanges: changes2
       }
     };
   }).add("GET", "/api/repos", async () => {
@@ -480,13 +438,18 @@ function apiRoutes(r, ctx) {
     return { status: 200, body };
   }).add("GET", "/api/changes", async ({ query }) => {
     const state = strParam(query, "state");
-    const changes = (await changeStore(root).list()).filter((c) => !state || c.state === state);
+    const changes2 = (await changeStore(root).list()).filter((c) => !state || c.state === state);
     const body = [];
-    const types = await loadOrgPack(orgPackDirOf(root)).then((op) => op.changeTypes.types, () => []);
-    for (const c of changes.sort((a, b) => a.id.localeCompare(b.id))) {
+    const op = await loadOrgPack(orgPackDirOf(root)).catch(() => void 0);
+    const types = op?.changeTypes.types ?? [];
+    const custom = op?.roles?.custom ?? [];
+    for (const c of changes2.sort((a, b) => a.id.localeCompare(b.id))) {
       const type = types.find((t) => t.id === c.type);
       const fast = !!type && (type.size === "small" || !!type.smallWhenBriefSays) && fastPathOf(type, await readFile(join(changeFolder(root, c.id), "brief.md"), "utf8").catch(() => "")).fast;
-      body.push(summary(c, await latestFindings(root, c.id), fast));
+      body.push({
+        ...summary(c, await latestFindings(root, c.id), fast),
+        yourRoles: rolesOfPerson(ctx.user, c.owners ?? {}, custom)
+      });
     }
     return { status: 200, body };
   }).add("GET", "/api/findings", async ({ query }) => {
@@ -497,13 +460,16 @@ function apiRoutes(r, ctx) {
     const state = strParam(query, "state");
     const lens = enumParam(query, "lens", Lens.options);
     const severity = enumParam(query, "severity", Severity.options);
+    const asks = enumParam(query, "asks", ["business", "design", "delivery"]);
     const ids = change ? [change] : (await changeStore(root).list()).map((c) => c.id).sort();
     const body = [];
     for (const id of ids)
-      for (const f of await latestFindings(root, id))
+      for (const f of await latestFindings(root, id)) {
+        const level = asksOfFinding(f);
         if ((!gate || f.gate === gate) && (!state || f.state === state) && // A lens filter asks its question: an old lens name finds what its question raised.
-        (!lens || questionOfLens(f.lens) === questionOfLens(lens)) && (!severity || f.severity === severity))
-          body.push(f);
+        (!lens || questionOfLens(f.lens) === questionOfLens(lens)) && (!severity || f.severity === severity) && (!asks || level === asks))
+          body.push({ ...f, asks: level });
+      }
     return { status: 200, body };
   }).add("GET", "/api/findings/{changeId}/{findingId}", async ({ params }) => {
     if (!RecordId.safeParse(params.changeId).success)
@@ -550,6 +516,224 @@ function apiRoutes(r, ctx) {
   });
 }
 
+// packages/server/dist/server.js
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { createServer } from "node:http";
+
+// packages/server/dist/jobs.js
+var JOB_LINES = 5e3;
+var JOBS_KEPT = 100;
+var jobLine = (line) => printToCurrent(line);
+var JobManager = class {
+  publish;
+  now;
+  jobs = /* @__PURE__ */ new Map();
+  cancelledIds = /* @__PURE__ */ new Set();
+  aborts = /* @__PURE__ */ new Map();
+  seq = 0;
+  /** Round 41: every running job of a kind, in start order (a later one never hides an earlier). */
+  running = /* @__PURE__ */ new Map();
+  printed = /* @__PURE__ */ new Map();
+  metas = /* @__PURE__ */ new Map();
+  listeners = /* @__PURE__ */ new Set();
+  ends = /* @__PURE__ */ new Map();
+  constructor(publish, now = () => /* @__PURE__ */ new Date()) {
+    this.publish = publish;
+    this.now = now;
+  }
+  /**
+   * A running job of a kind, if any: the earliest still running (one scan at a time: a second
+   * ask gets 409).
+   */
+  runningOf(kind) {
+    for (const id of this.running.get(kind) ?? []) {
+      const j = this.jobs.get(id);
+      if (j?.state === "running")
+        return j;
+    }
+    return void 0;
+  }
+  get(id) {
+    return this.jobs.get(id);
+  }
+  /** Every job kept, newest first (ADR 0187). */
+  list() {
+    return [...this.jobs.values()].reverse();
+  }
+  /** What a job belongs to, as it was started. */
+  metaOf(id) {
+    return this.metas.get(id);
+  }
+  /** A job's printed lines from a line on (or its last `max`), and how many it printed. */
+  linesOf(id, from, max = JOB_LINES) {
+    const p = this.printed.get(id);
+    if (!p)
+      return void 0;
+    const total = p.from + p.lines.length;
+    const start = from === void 0 ? Math.max(total - max, p.from) : Math.max(Math.min(from, total), p.from);
+    return { from: start, lines: p.lines.slice(start - p.from, start - p.from + max), total };
+  }
+  /** Hear each job's new lines and changes of state. */
+  subscribe(f) {
+    this.listeners.add(f);
+    return () => this.listeners.delete(f);
+  }
+  tell(c) {
+    for (const f of this.listeners) {
+      try {
+        f(c);
+      } catch {
+      }
+    }
+  }
+  print(job, text) {
+    const p = this.printed.get(job.id);
+    if (!p)
+      return;
+    const lines = String(text).split(/\r?\n/);
+    const at = p.from + p.lines.length;
+    p.lines.push(...lines);
+    if (p.lines.length > JOB_LINES) {
+      const drop = p.lines.length - JOB_LINES;
+      p.lines.splice(0, drop);
+      p.from += drop;
+    }
+    this.tell({ type: "lines", job, at, lines });
+  }
+  /** Finished jobs past JOBS_KEPT go, oldest first; running ones stay. */
+  forget() {
+    let over = this.jobs.size - JOBS_KEPT;
+    if (over <= 0)
+      return;
+    for (const [id, j] of this.jobs) {
+      if (over <= 0)
+        break;
+      if (j.state === "running" || j.state === "queued")
+        continue;
+      this.jobs.delete(id);
+      this.printed.delete(id);
+      this.metas.delete(id);
+      this.cancelledIds.delete(id);
+      over--;
+    }
+  }
+  start(kind, work, o = {}) {
+    const id = `job-${++this.seq}`;
+    const job = {
+      id,
+      kind,
+      state: "running",
+      progress: { done: 0, total: 0, message: "Starting" },
+      ...o.title ? { title: o.title } : {},
+      startedAt: this.now().toISOString(),
+      errors: []
+    };
+    this.jobs.set(id, job);
+    this.printed.set(id, { from: 0, lines: [] });
+    if (o.meta)
+      this.metas.set(id, { ...o.meta });
+    this.forget();
+    const ofKind = this.running.get(kind) ?? /* @__PURE__ */ new Set();
+    ofKind.add(id);
+    this.running.set(kind, ofKind);
+    const abort = new AbortController();
+    this.aborts.set(id, abort);
+    const cancelled = this.cancelledIds;
+    const line = (text) => this.print(job, text);
+    const control = {
+      progress: (done, total, message) => {
+        job.progress = { done, total, message };
+        this.publish({ type: "job.progress", jobId: id, done, total, message });
+        this.tell({ type: "state", job });
+      },
+      line,
+      get cancelled() {
+        return cancelled.has(id);
+      }
+    };
+    this.tell({ type: "state", job });
+    void (async () => {
+      try {
+        const out = await withPrinter(line, () => withSignal(abort.signal, () => work(control)));
+        if (out?.result)
+          job.result = out.result;
+        if (out?.errors?.length)
+          job.errors.push(...out.errors);
+        job.state = this.cancelledIds.has(id) ? "cancelled" : job.errors.length ? "failed" : "done";
+      } catch (e) {
+        if (this.cancelledIds.has(id))
+          job.state = "cancelled";
+        else {
+          job.errors.push(e instanceof Error ? e.message : String(e));
+          job.state = "failed";
+        }
+      }
+      this.aborts.delete(id);
+      const p = this.printed.get(id);
+      if (p && p.from + p.lines.length === 0) {
+        const said = job.result?.lines;
+        const end = [
+          ...Array.isArray(said) ? said.filter((l) => typeof l === "string") : [],
+          ...job.errors.filter((e) => !(Array.isArray(said) && said.includes(e)))
+        ];
+        if (end.length)
+          line(end.join("\n"));
+      }
+      job.finishedAt = this.now().toISOString();
+      ofKind.delete(id);
+      if (!ofKind.size && this.running.get(kind) === ofKind)
+        this.running.delete(kind);
+      this.publish({ type: "job.done", jobId: id, state: job.state });
+      this.tell({ type: "state", job });
+      this.ends.get(id)?.();
+      this.ends.delete(id);
+    })();
+    return job;
+  }
+  /**
+   * Run work the caller waits for as a job (ADR 0187): the route keeps its answer, and the
+   * Console shows what it printed. Resolves with the work's value, or throws its error.
+   */
+  track(kind, work, o = {}) {
+    return new Promise((resolve2, reject) => {
+      let value;
+      let failed;
+      const job = this.start(kind, async (c) => {
+        try {
+          value = await work(c);
+        } catch (e) {
+          failed = { e };
+          throw e;
+        }
+      }, o);
+      this.ends.set(job.id, () => failed ? reject(failed.e) : resolve2(value));
+    });
+  }
+  /** Ask a running job to stop; false when it already finished. */
+  cancel(id) {
+    const j = this.jobs.get(id);
+    if (!j || j.state !== "running")
+      return false;
+    this.cancelledIds.add(id);
+    this.aborts.get(id)?.abort();
+    return true;
+  }
+  /** Wait for a job to finish (tests and the CLI). */
+  async settle(id, timeoutMs = 6e4) {
+    const start = Date.now();
+    for (; ; ) {
+      const j = this.jobs.get(id);
+      if (!j)
+        throw new Error(`No job ${id}`);
+      if (j.state !== "running" && j.state !== "queued")
+        return j;
+      if (Date.now() - start > timeoutMs)
+        throw new Error(`Job ${id} did not finish`);
+      await new Promise((r) => setTimeout(r, 20));
+    }
+  }
+};
+
 // packages/server/dist/static.js
 import { readFile as readFile2, stat as stat2 } from "node:fs/promises";
 import { extname, join as join2, normalize, resolve, sep } from "node:path";
@@ -689,9 +873,20 @@ var WITHOUT_THE_APP = {
     what: "Changing where runtime.yaml sends the model's key (its provider, keyEnv or address)",
     cli: "edit runtime.yaml yourself and propose it for review"
   },
+  // Review round 50: committing them doesn't stand for the person's yes (the assistant can
+  // commit); the address the person last confirmed does (kept outside the metarepo).
   "ai-test": {
-    what: "Testing model settings that aren't committed sends the key to them",
-    cli: "commit runtime.yaml first, or run the step from the command line"
+    what: "Testing the model settings sends the key to an address you haven't confirmed",
+    cli: "a step in model mode yourself"
+  },
+  // ADR 0191: the plan's work items written to a live tracker, and an owner question sent.
+  "work-items": {
+    what: "Putting the plan's stories and tasks in the work tracker writes work items",
+    cli: "atticus ado sync <change> --approve <you>"
+  },
+  "owner-ask": {
+    what: "Sending an owner question posts a message",
+    cli: "copy the question and ask the owner yourself"
   }
 };
 function needsConfirmation(write) {
@@ -707,8 +902,21 @@ function requireConfirmation(c, write, target, given) {
 import { statSync, watch } from "node:fs";
 import { join as join3, relative, sep as sep2 } from "node:path";
 var SKIP = /* @__PURE__ */ new Set([".git", "node_modules", ".index", "workspace", "logs", ".vitest-cache"]);
-var TEMP = /(~|\.swp|\.swx|\.tmp|\.crdownload|\.part)$/i;
+var TEMP = /(~|\.swp|\.swx|\.tmp|\.crdownload|\.part|(^|\/)\.doctor-\d+)$/i;
 var posix = (p) => p.split(sep2).join("/");
+function onlyRead(abs, seen, since) {
+  let s;
+  try {
+    s = statSync(abs);
+  } catch {
+    seen.delete(abs);
+    return false;
+  }
+  const now = `${s.size}:${s.mtimeMs}:${s.ctimeMs}`;
+  const was = seen.get(abs);
+  seen.set(abs, now);
+  return was !== void 0 ? was === now : Math.max(s.mtimeMs, s.ctimeMs) < since;
+}
 var isDir = (p) => {
   try {
     return statSync(p).isDirectory();
@@ -731,6 +939,8 @@ function watchMetarepo(o) {
   };
   const problems = [];
   const pending = /* @__PURE__ */ new Set();
+  const stamps = /* @__PURE__ */ new Map();
+  const since = Date.now();
   let timer;
   let first = 0;
   let closed = false;
@@ -776,17 +986,39 @@ function watchMetarepo(o) {
     const unique = [...new Set(all)].sort();
     return unique.filter((d) => !unique.some((p) => p !== d && d.startsWith(p + sep2)));
   };
+  const logsDir = join3(root, ".atticus", "logs");
+  const runLogDirs = [join3(logsDir, "running"), join3(logsDir, "runs")];
+  const runLogDelay = o.runLogDelayMs ?? 200;
+  let runLogTimer;
+  let runLogLast = 0;
+  const runLogChanged = () => {
+    if (runLogTimer || !o.onRunLog)
+      return;
+    runLogTimer = setTimeout(() => {
+      runLogTimer = void 0;
+      runLogLast = Date.now();
+      if (!closed)
+        o.onRunLog?.();
+    }, Math.max(runLogLast + runLogDelay - Date.now(), 0));
+  };
   const follow = (dir, recursive) => {
     if (closed || watchers.has(dir) || !isDir(dir))
       return;
     try {
-      const w = watch(dir, { recursive }, (_event, name) => {
+      const w = watch(dir, { recursive }, (event, name) => {
+        if (dir === logsDir)
+          return attach();
+        if (runLogDirs.includes(dir))
+          return runLogChanged();
         if (!recursive && name) {
           attach();
           if (watchers.has(join3(dir, String(name))))
             return;
         }
-        note(name ? join3(dir, String(name)) : dir);
+        const abs = name ? join3(dir, String(name)) : dir;
+        if (event === "change" && process.platform === "win32" && onlyRead(abs, stamps, since))
+          return;
+        note(abs);
       });
       w.on("error", (e) => {
         w.close();
@@ -821,16 +1053,22 @@ function watchMetarepo(o) {
     follow(join3(root, ".atticus"), false);
     for (const d of folders())
       follow(d, true);
+    if (o.onRunLog) {
+      follow(logsDir, false);
+      for (const d of runLogDirs)
+        follow(d, false);
+    }
   };
   attach();
   return {
     get following() {
-      return [...watchers.keys()].filter((d) => d !== root && d !== join3(root, ".atticus")).map((d) => posix(relative(root, d))).sort();
+      return [...watchers.keys()].filter((d) => d !== root && d !== join3(root, ".atticus") && d !== logsDir && !runLogDirs.includes(d)).map((d) => posix(relative(root, d))).sort();
     },
     problems,
     close() {
       closed = true;
       clearTimeout(timer);
+      clearTimeout(runLogTimer);
       for (const w of watchers.values())
         w.close();
       watchers.clear();
@@ -954,9 +1192,27 @@ function upgrade(req, sock, onClose) {
 }
 
 // packages/server/dist/server.js
+var JOB_KINDS = {
+  scan: true,
+  sync: true,
+  reconcile: true,
+  index: true,
+  intake: true,
+  step: true,
+  local: true,
+  work: true
+};
 var EventHub = class {
+  root;
   sockets = /* @__PURE__ */ new Set();
   listeners = /* @__PURE__ */ new Set();
+  /**
+   * `root`: each file.changed event is published saying whether it can change the catalog
+   * (`catalog`, beta.23 review), by the layout the org pack names, so a page needn't guess it.
+   */
+  constructor(root) {
+    this.root = root;
+  }
   /** Hear every event in this process too (ADR 0119: a reader that keeps files in memory). */
   listen(fn) {
     this.listeners.add(fn);
@@ -971,7 +1227,16 @@ var EventHub = class {
   get size() {
     return this.sockets.size;
   }
-  publish(e) {
+  publish(given) {
+    let e = given;
+    if (this.root !== void 0 && e.type === "file.changed" && typeof e.path === "string" && typeof e.catalog !== "boolean") {
+      let catalog = true;
+      try {
+        catalog = catalogMayHaveChangedAt(this.root, e.path);
+      } catch {
+      }
+      e = { ...e, catalog };
+    }
     for (const fn of this.listeners)
       fn(e);
     const text = JSON.stringify(e);
@@ -983,6 +1248,21 @@ var EventHub = class {
       s.close();
   }
 };
+var Signal = class {
+  fs = /* @__PURE__ */ new Set();
+  subscribe(f) {
+    this.fs.add(f);
+    return () => this.fs.delete(f);
+  }
+  emit() {
+    for (const f of this.fs) {
+      try {
+        f();
+      } catch {
+      }
+    }
+  }
+};
 var MAX_BODY = 4 * 1024 * 1024;
 var sameToken = sameSecret;
 var STRONG = /^[A-Za-z0-9_-]{32,}$/;
@@ -1029,10 +1309,13 @@ async function startServer(o) {
     throw new Error(`Atticus only listens on 127.0.0.1 (asked for ${host}).`);
   const token = o.token && STRONG.test(o.token) ? o.token : randomBytes2(32).toString("base64url");
   const pageKey = o.pageKey && STRONG.test(o.pageKey) && o.pageKey !== token ? o.pageKey : randomBytes2(32).toString("base64url");
-  const events = new EventHub();
+  const events = new EventHub(o.root);
+  let writing = 0;
   const jobs = new JobManager((e) => events.publish(e));
   const confirmations = new Confirmations();
   const person = o.user ? { handle: o.user, source: "given" } : await gitUser(o.root);
+  const runLogs = new Signal();
+  const onClose = /* @__PURE__ */ new Set();
   const ctx = {
     root: o.root,
     user: person.handle,
@@ -1041,7 +1324,9 @@ async function startServer(o) {
     full: o.full === true,
     events,
     jobs,
-    confirmations
+    confirmations,
+    runLogs,
+    onClose
   };
   const router = apiRoutes(new Router(), ctx).add("POST", "/api/confirmations", ({ body }) => {
     const b = api_exports.ConfirmationRequest.safeParse(body ?? {});
@@ -1078,7 +1363,15 @@ async function startServer(o) {
   };
   const server = createServer(async (req, res) => {
     const t0 = Date.now();
+    let writes = req.method !== "GET" && req.method !== "HEAD";
+    if (writes)
+      writing++;
     const done = (status, error) => {
+      if (writes) {
+        writes = false;
+        writing--;
+        indexFilesChanged(o.root);
+      }
       const path = (req.url ?? "/").split("?")[0];
       if (path.startsWith("/api/"))
         o.onRequest?.({
@@ -1157,7 +1450,17 @@ Connection: close\r
     server.listen(o.port ?? DEFAULT_PORT, host, () => resolve2());
   });
   port = server.address().port;
-  const watcher = o.watch === false ? void 0 : watchMetarepo({ root: o.root, publish: (e) => events.publish(e) });
+  const watcher = o.watch === false ? void 0 : watchMetarepo({
+    root: o.root,
+    publish: (e) => events.publish(e),
+    onRunLog: () => runLogs.emit()
+  });
+  const stopHearing = events.listen((e) => {
+    if (e.type === "file.changed" || e.type === "index.rebuilt" || e.type === "job.done")
+      indexFilesChanged(o.root);
+  });
+  if (watcher)
+    trustIndexBetweenChanges(o.root, true);
   return {
     url: `http://127.0.0.1:${port}`,
     port,
@@ -1170,8 +1473,20 @@ Connection: close\r
     get following() {
       return watcher?.following ?? [];
     },
+    get quiet() {
+      return writing === 0 && !Object.keys(JOB_KINDS).some((k) => jobs.runningOf(k));
+    },
     close: () => new Promise((resolve2) => {
       watcher?.close();
+      for (const f of onClose) {
+        try {
+          f();
+        } catch {
+        }
+      }
+      stopHearing();
+      trustIndexBetweenChanges(o.root, false);
+      stopEmbedding(o.root);
       events.closeAll();
       server.closeAllConnections?.();
       server.close(() => resolve2());
@@ -1184,7 +1499,33 @@ export {
   badRequest,
   notFound,
   conflict,
+  Router,
+  problem,
+  intParam,
   strParam,
+  trustIndexBetweenChanges,
+  indexFilesChanged,
+  stopEmbedding,
+  apiRoutes,
+  JOB_LINES,
+  JOBS_KEPT,
+  jobLine,
+  JobManager,
+  appCsp,
+  staticFile,
+  CONFIRM_TTL_MS,
+  Confirmations,
+  sameSecret,
+  needsConfirmation,
   requireConfirmation,
+  onlyRead,
+  watchMetarepo,
+  acceptKey,
+  frame,
+  Socket,
+  upgrade,
+  EventHub,
+  Signal,
+  HARDENING,
   startServer
 };