@kubitnodes/stellaris 0.3.19 → 0.3.20

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
 // apps/cli/dist/index.js
-import { readFile as readFile6 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 import path7 from "node:path";
 import { Command } from "commander";
 
 // packages/board-core/dist/board.js
-import { chmod as chmod2, cp, mkdir as mkdir4, readdir as readdir3, readFile as readFile5, rename as rename3, rm as rm2, stat as stat2, writeFile as writeFile4 } from "node:fs/promises";
+import { chmod as chmod2, cp, mkdir as mkdir4, readdir as readdir3, readFile as readFile4, rename as rename3, rm as rm2, stat as stat3, writeFile as writeFile4 } from "node:fs/promises";
 import path6 from "node:path";
 import { decodeTime, monotonicFactory } from "ulid";
 import { z as z13 } from "zod";
@@ -422,6 +422,13 @@ var MessageFrontmatterSchema = z4.object({
   ts: IsoDateTimeSchema,
   mentions: z4.array(NameSchema)
 });
+var MessageRefSchema = MessageFrontmatterSchema.pick({
+  id: true,
+  author: true,
+  channel: true,
+  thread: true,
+  ts: true
+});
 var TaskStatusSchema = z4.enum(["open", "claimed", "done", "abandoned"]);
 var ThreadStateSchema = z4.enum(["open", "closed"]);
 var ThreadSubjectSchema = z4.object({
@@ -1733,7 +1740,7 @@ var RunnerConfigSchema = z11.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.19";
+var STELLARIS_VERSION = "0.3.20";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -1746,7 +1753,7 @@ var BoardError = class extends Error {
 };
 
 // packages/board-core/dist/events.js
-import { appendFile, readFile as readFile2 } from "node:fs/promises";
+import { appendFile, open, stat } from "node:fs/promises";
 import path2 from "node:path";
 
 // packages/board-core/dist/fs.js
@@ -1831,10 +1838,19 @@ async function listDirs(dir) {
 
 // packages/board-core/dist/events.js
 var LEADING_ID = /^\{"id":"([0-9A-HJKMNP-TV-Z]{26})"/;
+var ID_PREFIX_BYTES = 64;
+var NEWLINE = 10;
 var EventLog = class {
   file;
   newId;
   now;
+  lines = [];
+  /** Bytes the index covers: always the end of a complete line. */
+  indexed = 0;
+  /** The indexed file, to tell a replaced log from a grown one. */
+  inode = null;
+  scanning = Promise.resolve();
+  listeners = /* @__PURE__ */ new Set();
   constructor(file, newId, now) {
     this.file = file;
     this.newId = newId;
@@ -1851,48 +1867,97 @@ var EventLog = class {
     await ensureDir(path2.dirname(this.file));
     await appendFile(this.file, `${JSON.stringify(event)}
 `, "utf8");
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch {
+      }
+    }
     return event;
   }
+  /**
+   * Calls `listener` after each event this process appends, until the returned function is
+   * called. Another process's appends, such as the admin CLI's, are seen only by the next read.
+   */
+  onAppend(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
   /** Events with an id greater than `since`, oldest first. `null` reads from the beginning. */
   async readSince(since, limit = 1e3) {
-    if (!await exists(this.file)) {
-      return [];
-    }
-    const raw = await readFile2(this.file, "utf8");
-    const events = [];
-    for (const line of raw.split("\n")) {
-      if (line.trim().length === 0) {
+    await this.refresh();
+    const chosen = [];
+    for (const line of this.lines) {
+      if (since !== null && line.id <= since) {
         continue;
       }
-      const leading = LEADING_ID.exec(line)?.[1];
-      if (since !== null && leading !== void 0 && leading <= since) {
-        continue;
-      }
-      const event = BoardEventSchema.parse(JSON.parse(line));
-      if (since !== null && event.id <= since) {
-        continue;
-      }
-      events.push(event);
-      if (events.length >= limit) {
+      chosen.push(line);
+      if (chosen.length >= limit) {
         break;
       }
     }
-    return events;
+    const first = chosen[0];
+    const last = chosen.at(-1);
+    if (first === void 0 || last === void 0) {
+      return [];
+    }
+    const span = await this.readBytes(first.start, last.end);
+    return chosen.map((line) => BoardEventSchema.parse(JSON.parse(span.toString("utf8", line.start - first.start, line.end - first.start))));
   }
   /** The id of the newest event, or null for an empty log. */
   async lastId() {
-    if (!await exists(this.file)) {
-      return null;
+    await this.refresh();
+    return this.lines.at(-1)?.id ?? null;
+  }
+  /** Brings the index up to the file's end, one scan at a time. */
+  refresh() {
+    this.scanning = this.scanning.then(() => this.scan(), () => this.scan());
+    return this.scanning;
+  }
+  async scan() {
+    const info = await stat(this.file).catch((error) => {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+        return null;
+      }
+      throw error;
+    });
+    if (info === null || info.ino !== this.inode || info.size < this.indexed) {
+      this.lines = [];
+      this.indexed = 0;
+      this.inode = info?.ino ?? null;
+    }
+    if (info === null || info.size === this.indexed) {
+      return;
+    }
+    const added = await this.readBytes(this.indexed, info.size);
+    let start = 0;
+    for (let at = added.indexOf(NEWLINE); at >= 0; at = added.indexOf(NEWLINE, start)) {
+      const prefix = added.toString("utf8", start, Math.min(at, start + ID_PREFIX_BYTES));
+      if (prefix.trim().length > 0) {
+        const id = LEADING_ID.exec(prefix)?.[1] ?? BoardEventSchema.parse(JSON.parse(added.toString("utf8", start, at))).id;
+        this.lines.push({ id, start: this.indexed + start, end: this.indexed + at });
+      }
+      start = at + 1;
+    }
+    this.indexed += start;
+  }
+  async readBytes(from, to) {
+    const handle = await open(this.file, "r");
+    try {
+      const buffer = Buffer.alloc(to - from);
+      const { bytesRead } = await handle.read(buffer, 0, buffer.length, from);
+      return buffer.subarray(0, bytesRead);
+    } finally {
+      await handle.close();
     }
-    const lines = (await readFile2(this.file, "utf8")).trimEnd().split("\n");
-    const last = lines.at(-1) ?? "";
-    return last.length === 0 ? null : BoardEventSchema.parse(JSON.parse(last)).id;
   }
 };
 
 // packages/board-core/dist/files.js
 import { createHash } from "node:crypto";
-import { mkdir as mkdir2, readdir as readdir2, readFile as readFile3, rename as rename2, rm, stat, writeFile as writeFile2 } from "node:fs/promises";
+import { mkdir as mkdir2, readdir as readdir2, readFile as readFile2, rename as rename2, rm, stat as stat2, writeFile as writeFile2 } from "node:fs/promises";
 import path3 from "node:path";
 var MAX_FILE_BYTES = 8 * 1024 * 1024;
 function isMissing2(error) {
@@ -1914,9 +1979,9 @@ var FileTree = class {
       }
       try {
         const absolute = path3.join(root, ...relative.split("/"));
-        const info = await stat(absolute);
+        const info = await stat2(absolute);
         if (info.isFile() && info.size <= MAX_FILE_BYTES) {
-          files[relative] = (await readFile3(absolute)).toString("base64");
+          files[relative] = (await readFile2(absolute)).toString("base64");
         }
       } catch (error) {
         if (!isMissing2(error)) {
@@ -1972,7 +2037,7 @@ var FileTree = class {
   }
   async hash(absolute) {
     try {
-      const info = await stat(absolute);
+      const info = await stat2(absolute);
       if (info.size > MAX_FILE_BYTES) {
         return null;
       }
@@ -1981,7 +2046,7 @@ var FileTree = class {
       if (known !== void 0 && known.mtimeMs === info.mtimeMs && known.size === info.size) {
         return fileVersion(known.sha, executable);
       }
-      const sha = createHash("sha256").update(await readFile3(absolute)).digest("hex");
+      const sha = createHash("sha256").update(await readFile2(absolute)).digest("hex");
       this.hashes.set(absolute, { mtimeMs: info.mtimeMs, size: info.size, sha });
       return fileVersion(sha, executable);
     } catch (error) {
@@ -1994,7 +2059,7 @@ var FileTree = class {
 };
 
 // packages/board-core/dist/homes.js
-import { chmod, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
+import { chmod, mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
 import path4 from "node:path";
 import { execa } from "execa";
 var HOME_GITIGNORE = [
@@ -2138,7 +2203,7 @@ var HomeRepos = class {
       await writeFile3(ignore, IGNORE_FILE, "utf8");
       await git(["add", "--all"], home);
       await git(["commit", "--quiet", "--allow-empty", "-m", "home: created by the board"], home);
-    } else if (await readFile4(ignore, "utf8").catch(() => "") !== IGNORE_FILE) {
+    } else if (await readFile3(ignore, "utf8").catch(() => "") !== IGNORE_FILE) {
       await writeFile3(ignore, IGNORE_FILE, "utf8");
       await git(["add", ".gitignore"], home);
       await git(["commit", "--quiet", "-m", "home: the board's ignore file"], home);
@@ -3057,8 +3122,8 @@ function restage(existing, edit) {
   };
 }
 function reopenStage(stage) {
-  const { completedBy: _by, completedAt: _at, ...open2 } = stage;
-  return open2;
+  const { completedBy: _by, completedAt: _at, ...open3 } = stage;
+  return open3;
 }
 function gateChanges(before, after) {
   const changes = [];
@@ -3453,7 +3518,7 @@ var Board = class _Board {
         const task2 = { ...TaskFrontmatterSchema.parse(raw.data), body: raw.body };
         if ((legacy === "open" || legacy === "closed") && !await exists(this.paths.threadFile(threads, task2.id))) {
           const ended = task2.status === "done" || task2.status === "abandoned";
-          const open2 = legacy === "open" && !ended;
+          const open3 = legacy === "open" && !ended;
           const openedBy = opened.get(task2.id);
           const closedBy = closed.get(task2.id);
           await this.writeThread(threads, {
@@ -3461,10 +3526,10 @@ var Board = class _Board {
             channel: channelRef(slug, "general"),
             title: task2.title,
             subject: { kind: "task", id: task2.id },
-            state: open2 ? "open" : "closed",
+            state: open3 ? "open" : "closed",
             openedBy: openedBy?.actor ?? task2.createdBy,
             openedAt: openedBy?.ts ?? task2.createdAt,
-            ...open2 ? {} : {
+            ...open3 ? {} : {
               closedBy: closedBy?.actor ?? SYSTEM_ACTOR.name,
               closedAt: closedBy?.ts ?? this.now().toISOString()
             },
@@ -3527,7 +3592,7 @@ var Board = class _Board {
     for (const agent2 of await this.listAgents()) {
       const file = this.paths.agentCursors(agent2.name);
       if (await exists(file)) {
-        const legacy = Legacy.safeParse(JSON.parse(await readFile5(file, "utf8")));
+        const legacy = Legacy.safeParse(JSON.parse(await readFile4(file, "utf8")));
         if (legacy.success) {
           await writeJson(file, { digest: legacy.data.inbox });
         }
@@ -3866,6 +3931,10 @@ ${charter.purpose}
   async latestEventId() {
     return this.events.lastId();
   }
+  /** Calls `listener` after each event the board appends, until the returned function is called. */
+  onEventAppended(listener) {
+    return this.events.onAppend(listener);
+  }
   /** The roster as projected: every citizen with identity, reach, availability, and profile. */
   async listMembers() {
     const members = [];
@@ -3910,7 +3979,7 @@ ${charter.purpose}
       project: project2,
       revision: revision.success ? revision.data : 0,
       updatedBy: updatedBy.success ? updatedBy.data : SYSTEM_ACTOR.name,
-      updatedAt: updatedAt.success ? updatedAt.data : (await stat2(file)).mtime.toISOString(),
+      updatedAt: updatedAt.success ? updatedAt.data : (await stat3(file)).mtime.toISOString(),
       body
     };
   }
@@ -4012,6 +4081,28 @@ ${charter.purpose}
   async readThread(id) {
     return (await this.findThread(id)).thread;
   }
+  /**
+   * Where each of the messages named is and who wrote it, for text that names them by id; an id
+   * that names no message is left out. Message files start with their ids, so only the files
+   * asked for are read.
+   */
+  async findMessages(ids) {
+    const wanted = new Set(ids);
+    const found = [];
+    for await (const dir of this.messageDirs()) {
+      for (const file of await listFiles(dir)) {
+        if (!wanted.delete(file.slice(0, 26))) {
+          continue;
+        }
+        const { data } = await readMarkdown(path6.join(dir, file), MessageFrontmatterSchema);
+        found.push(MessageRefSchema.parse(data));
+      }
+      if (wanted.size === 0) {
+        break;
+      }
+    }
+    return found;
+  }
   /**
    * What citizens have asked the user and the user has not answered, oldest first: every message
    * by someone else that mentions the user, in an open thread or a channel the society or an
@@ -4513,12 +4604,12 @@ ${DASHBOARD_LINE}
         continue;
       }
       const named = thread2 === null ? channelConversation(filedIn, message.channel) : void 0;
-      let open2 = named === void 0 ? void 0 : openChannels.get(message.channel);
-      if (named !== void 0 && open2 === void 0) {
-        open2 = await this.channelOpen(message.channel);
-        openChannels.set(message.channel, open2);
+      let open3 = named === void 0 ? void 0 : openChannels.get(message.channel);
+      if (named !== void 0 && open3 === void 0) {
+        open3 = await this.channelOpen(message.channel);
+        openChannels.set(message.channel, open3);
       }
-      const part = thread2 ?? (open2 === true ? `#${named}` : null);
+      const part = thread2 ?? (open3 === true ? `#${named}` : null);
       if (conversation !== void 0 && (filedIn !== conversation.scope || part !== conversation.part)) {
         continue;
       }
@@ -4583,7 +4674,7 @@ ${task2.body}`;
         }
       }
       for (const file of await listFiles(this.paths.projectKnowledge(project2))) {
-        const content = await readFile5(path6.join(this.paths.projectKnowledge(project2), file), "utf8");
+        const content = await readFile4(path6.join(this.paths.projectKnowledge(project2), file), "utf8");
         if (content.toLowerCase().includes(needle)) {
           hits.push({
             kind: "knowledge",
@@ -4621,7 +4712,7 @@ ${task2.body}`;
       });
     }
     for (const entry of shared) {
-      const content = await readFile5(entry.file, "utf8");
+      const content = await readFile4(entry.file, "utf8");
       if (content.toLowerCase().includes(needle)) {
         hits.push({
           kind: entry.kind,
@@ -6110,7 +6201,7 @@ ${rationale}`}`);
       throw new BoardError("NOT_FOUND", `no transcript of turn ${turnId} for ${agent2}`);
     }
     const entries = [];
-    for (const line of (await readFile5(file, "utf8")).split("\n")) {
+    for (const line of (await readFile4(file, "utf8")).split("\n")) {
       if (line.trim() === "")
         continue;
       const parsed = TranscriptEntrySchema.safeParse(JSON.parse(line));
@@ -6589,7 +6680,7 @@ ${rationale}`}`);
         }
         const file = entry.isFile() ? conflictCopyOf(relative) : null;
         if (file !== null) {
-          const since = await this.homes.changedAt(home, relative) ?? (await stat2(path6.join(home, relative)).catch(() => null))?.mtime.toISOString();
+          const since = await this.homes.changedAt(home, relative) ?? (await stat3(path6.join(home, relative)).catch(() => null))?.mtime.toISOString();
           if (since !== void 0) {
             found.push({ path: relative, file, since });
           }
@@ -7167,7 +7258,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       if (!isSafeRelativePath(entry.path)) {
         continue;
       }
-      const bytes = await readFile5(path6.join(dir, ...entry.path.split("/"))).catch(() => null);
+      const bytes = await readFile4(path6.join(dir, ...entry.path.split("/"))).catch(() => null);
       const text = bytes === null || bytes.includes(0) ? null : bytes.toString("utf8");
       files.push({
         ...entry,
@@ -7866,6 +7957,23 @@ ${charter.purpose}
       yield* this.threadMessagesIn(this.paths.threads(slug), since);
     }
   }
+  /** Every folder that holds messages: each channel's and each thread's, in the society and every project. */
+  async *messageDirs() {
+    for (const channel of await listDirs(this.paths.societyChannels())) {
+      yield this.paths.societyChannel(channel);
+    }
+    for (const id of await listDirs(this.paths.societyThreads())) {
+      yield this.paths.threadMessages(this.paths.societyThreads(), id);
+    }
+    for (const slug of await listDirs(this.paths.projects())) {
+      for (const channel of await listDirs(this.paths.projectChannels(slug))) {
+        yield this.paths.projectChannel(slug, channel);
+      }
+      for (const id of await listDirs(this.paths.threads(slug))) {
+        yield this.paths.threadMessages(this.paths.threads(slug), id);
+      }
+    }
+  }
   async *threadMessagesIn(threads, since) {
     for (const id of await listDirs(threads)) {
       yield* await this.readMessagesIn(this.paths.threadMessages(threads, id), since);
@@ -7882,7 +7990,7 @@ function globals() {
 function print(value, human) {
   console.log(globals().json ? JSON.stringify(value, null, 2) : human());
 }
-async function open() {
+async function open2() {
   return Board.open(globals().data);
 }
 async function actorFor(board, as) {
@@ -7928,7 +8036,7 @@ user.command("token").description("Issue the user a new token and print it once;
   if (!opts.rotate) {
     throw new BoardError("VALIDATION", "the board keeps only a hash of the user token, so it cannot show it again; `user token --rotate` issues a new one");
   }
-  const board = await open();
+  const board = await open2();
   const userToken = await board.rotateUserToken();
   print({ userToken }, () => [
     `User token (shown once): ${userToken}`,
@@ -7937,7 +8045,7 @@ user.command("token").description("Issue the user a new token and print it once;
 });
 var project = program.command("project").description("Manage projects");
 project.command("add <slug>").description("Add a project with its default channels").option("--name <name>", "display name").option("--repo <url>", "git remote").option("--on-done <effect>", "what finishing a task does: none, or merge its branch").action(async (slug, opts) => {
-  const board = await open();
+  const board = await open2();
   const added = await board.addProject(board.userActor(), {
     slug,
     name: opts.name,
@@ -7947,7 +8055,7 @@ project.command("add <slug>").description("Add a project with its default channe
   print(added, () => `Project ${added.slug} added with channels ${added.channels.join(", ")}`);
 });
 project.command("configure <slug>").description("Set a project's completion effect").requiredOption("--on-done <effect>", "none, or merge").option("--as <agent>", "act as this agent instead of the user").action(async (slug, opts) => {
-  const board = await open();
+  const board = await open2();
   const configured = await board.configureProject(await actorFor(board, opts.as), {
     project: slug,
     on_done: CompletionEffectSchema.parse(opts.onDone)
@@ -7955,7 +8063,7 @@ project.command("configure <slug>").description("Set a project's completion effe
   print(configured, () => `Project ${configured.slug}: on done ${configured.onDone}`);
 });
 project.command("archive <slug>").description("Archive a project with no task in play: its members leave and its threads close").requiredOption("--reason <text>", "why the project is archived").action(async (slug, opts) => {
-  const board = await open();
+  const board = await open2();
   const archived = await board.archiveProject(board.userActor(), {
     project: slug,
     reason: opts.reason
@@ -7963,13 +8071,13 @@ project.command("archive <slug>").description("Archive a project with no task in
   print(archived, () => `Project ${archived.slug} archived`);
 });
 project.command("list").description("List projects").action(async () => {
-  const board = await open();
+  const board = await open2();
   const projects = await board.listProjects();
   print(projects, () => projects.map((p) => p.archived === void 0 ? `${p.slug}	${p.name}	members: ${p.members.join(", ") || "none"}` : `${p.slug}	${p.name}	archived ${p.archived.at} by ${p.archived.by}`).join("\n"));
 });
 var runner = program.command("runner").description("Manage runners");
 runner.command("add <name>").description("Register a runner and print its token once").action(async (name) => {
-  const board = await open();
+  const board = await open2();
   const { runner: added, token } = await board.addRunner(board.userActor(), name);
   print({ runner: added, token }, () => [
     `Runner ${added.name} added`,
@@ -7978,13 +8086,13 @@ runner.command("add <name>").description("Register a runner and print its token
   ].join("\n"));
 });
 runner.command("list").description("List runners and what they offer").action(async () => {
-  const board = await open();
+  const board = await open2();
   const runners = await board.listRunners();
   print(runners, () => runners.length === 0 ? "No runners yet; add one with `runner add <name>`." : runners.map((each) => `${each.name}  ${each.status}  ${each.os}${each.version === void 0 ? "" : `  v${each.version}`}  ${each.clis.join(",") || "no CLIs yet"}${each.capabilities.length === 0 ? "" : `  ${each.capabilities.join(",")}`}`).join("\n"));
 });
 var agent = program.command("agent").description("Manage agents");
 agent.command("add <name>").description("Add an agent and print its board token once").requiredOption("--role <role>", "role charter name").option("--cli <cli>", "claude or codex").option("--model <model>", "model to run the CLI with; the CLI's own default otherwise").option("--runner <name>", "runner preferred for its turns; any with its CLI otherwise").option("-p, --project <slug...>", "project memberships").action(async (name, opts) => {
-  const board = await open();
+  const board = await open2();
   const cli = opts.cli === void 0 ? null : CliKindSchema.parse(opts.cli);
   const { agent: added, token } = await board.addAgent(board.userActor(), {
     name,
@@ -7997,7 +8105,7 @@ agent.command("add <name>").description("Add an agent and print its board token
   print({ agent: added, token }, () => [`Agent ${added.name} added as ${added.role}`, `Token (shown once): ${token}`].join("\n"));
 });
 agent.command("runner <name> [runner]").description("Show or set the runner a citizen's work outside any project runs on; `none` pins it again on its next turn").action(async (name, chosen) => {
-  const board = await open();
+  const board = await open2();
   if (chosen === void 0) {
     const current = await board.readAgent(name);
     print({ agent: name, homeRunner: current.homeRunner ?? null }, () => current.homeRunner === void 0 ? `${name} is not pinned; its next turn outside a project pins it` : `${name} runs on ${current.homeRunner}`);
@@ -8007,7 +8115,7 @@ agent.command("runner <name> [runner]").description("Show or set the runner a ci
   print({ agent: name, homeRunner: updated.homeRunner ?? null }, () => updated.homeRunner === void 0 ? `${name} will be pinned on its next turn` : `${name} runs on ${updated.homeRunner} from its next turn`);
 });
 agent.command("list").description("List agents").action(async () => {
-  const board = await open();
+  const board = await open2();
   const agents = await board.listAgents();
   const members = await board.listMembers();
   print(agents, () => agents.map((a) => {
@@ -8016,28 +8124,28 @@ agent.command("list").description("List agents").action(async () => {
   }).join("\n"));
 });
 agent.command("model <name> [model]").description("Set the model a member's turns run with, from its next turn; no model means the CLI's default").action(async (name, model) => {
-  const board = await open();
+  const board = await open2();
   const updated = await board.setAgentModel(board.userActor(), name, model ?? null);
   print(updated, () => `${updated.name} runs with ${updated.model ?? "its CLI's default model"} from its next turn`);
 });
 agent.command("effort <name> [effort]").description("Set the reasoning effort a member's turns run with, from its next turn, such as high; no effort means the model's default").action(async (name, effort) => {
-  const board = await open();
+  const board = await open2();
   const updated = await board.setAgentEffort(board.userActor(), name, effort ?? null);
   print(updated, () => `${updated.name} runs with ${updated.effort === void 0 ? "its model's default effort" : `${updated.effort} effort`} from its next turn`);
 });
 agent.command("retire <name>").description("Retire a member: no more wakes, claims released, token revoked, sessions archived").requiredOption("--reason <text>", "why").action(async (name, opts) => {
-  const board = await open();
+  const board = await open2();
   const retired = await board.retireAgent(board.userActor(), { name, reason: opts.reason });
   print(retired, () => `Agent ${retired.name} retired: ${opts.reason}`);
 });
 var proposal = program.command("proposal").description("Governance proposals");
 proposal.command("list").description("List proposals").action(async () => {
-  const board = await open();
+  const board = await open2();
   const proposals = await board.listProposals();
   print(proposals, () => proposals.length === 0 ? "No proposals." : proposals.map((p) => `${p.id}	${p.kind}	${p.status}	by ${p.proposedBy}`).join("\n"));
 });
 proposal.command("show <id>").description("Show a proposal with its charter and rationale").action(async (id) => {
-  const board = await open();
+  const board = await open2();
   const found = await board.readProposal(id);
   print(found, () => [
     `${found.id}  ${found.kind}  ${found.status}  by ${found.proposedBy}`,
@@ -8047,7 +8155,7 @@ proposal.command("show <id>").description("Show a proposal with its charter and
   ].filter((line) => line.length > 0).join("\n"));
 });
 proposal.command("create").description("Propose a member, role, channel, reallocation, or retirement").requiredOption("--kind <kind>", "member, role, channel, reallocation, or retirement").requiredOption("--charter <json>", "the charter as a JSON object").option("--rationale <text>", "why", "").option("--as <agent>", "act as this agent instead of the user").action(async (opts) => {
-  const board = await open();
+  const board = await open2();
   const created = await board.propose(await actorFor(board, opts.as), {
     kind: ProposalKindSchema.parse(opts.kind),
     charter: parseCharter(opts.charter),
@@ -8056,7 +8164,7 @@ proposal.command("create").description("Propose a member, role, channel, realloc
   print(created, () => `Proposal ${created.id} (${created.kind}) is ${created.status}`);
 });
 proposal.command("approve <id>").description("Approve a proposal; the board provisions it").option("--reason <text>", "a note for the record").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const decision = await board.approve(await actorFor(board, opts.as), {
     proposal_id: id,
     ...opts.reason === void 0 ? {} : { reason: opts.reason }
@@ -8065,7 +8173,7 @@ proposal.command("approve <id>").description("Approve a proposal; the board prov
   print({ decision, proposal: after }, () => `Proposal ${id} approved; it is now ${after.status}`);
 });
 proposal.command("reject <id>").description("Reject a proposal with a reason").requiredOption("--reason <text>", "why").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const decision = await board.reject(await actorFor(board, opts.as), {
     proposal_id: id,
     reason: opts.reason
@@ -8074,14 +8182,14 @@ proposal.command("reject <id>").description("Reject a proposal with a reason").r
 });
 var role = program.command("role").description("Role charters");
 role.command("list").description("List role charters").action(async () => {
-  const board = await open();
+  const board = await open2();
   const roles = await board.listRoles();
   print(roles, () => roles.map((r) => `${r.name}	replicas up to ${r.maxReplicas}	backlog threshold ${r.backlogThreshold}	wakes on ${r.wakeTriggers.join(", ") || "direct wakes only"}`).join("\n"));
 });
 role.command("add <name>").description("Write a new role charter directly as the user").requiredOption("--purpose <text>", "what the role is for; its members read this every turn").option("--verbs <verbs...>", "board verbs granted; the member verbs by default").option("--triggers <triggers...>", "wakes it opts into: user_post, ops_event, heartbeat", [
   "heartbeat"
 ]).action(async (name, opts) => {
-  const board = await open();
+  const board = await open2();
   const added = await board.setRoleCharter(board.userActor(), {
     name,
     purpose: opts.purpose,
@@ -8091,7 +8199,7 @@ role.command("add <name>").description("Write a new role charter directly as the
   print(added, () => `Role ${added.name} written with ${added.verbs.length} verbs`);
 });
 role.command("set <name>").description("Change a charter directly as the user: scaling cap, threshold, or purpose").option("--max-replicas <n>", "active members of the role per project the scheduler may reach").option("--backlog-threshold <n>", "load per member that adds a replica").option("--purpose <text>", "the charter's purpose").action(async (name, opts) => {
-  const board = await open();
+  const board = await open2();
   const current = await board.readRole(name);
   const updated = await board.setRoleCharter(board.userActor(), {
     ...current,
@@ -8103,7 +8211,7 @@ role.command("set <name>").description("Change a charter directly as the user: s
 });
 var channelCommand = program.command("channel").description("Channels");
 channelCommand.command("add <ref>").description("Open a channel: <name> for the society or <project>/<name>").requiredOption("--purpose <text>", "what the channel is for").option("--as <agent>", "act as this agent instead of the user").action(async (ref, opts) => {
-  const board = await open();
+  const board = await open2();
   const parsed = parseChannelRef(ref);
   const added = await board.addChannel(await actorFor(board, opts.as), {
     project: parsed.project,
@@ -8113,7 +8221,7 @@ channelCommand.command("add <ref>").description("Open a channel: <name> for the
   print({ channel: added }, () => `Channel ${added} opened`);
 });
 channelCommand.command("archive <ref>").description("Archive a channel whose workstream is done, once no task filed there is in play").requiredOption("--reason <text>", "why its work is done").option("--as <agent>", "act as this agent instead of the user").action(async (ref, opts) => {
-  const board = await open();
+  const board = await open2();
   const archived = await board.archiveChannel(await actorFor(board, opts.as), {
     channel: ref,
     reason: opts.reason
@@ -8121,12 +8229,12 @@ channelCommand.command("archive <ref>").description("Archive a channel whose wor
   print(archived, () => `Channel ${ref} archived: ${archived.reason}`);
 });
 program.command("signals").description("Recent operations signals, oldest first").option("--limit <n>", "how many", "50").action(async (opts) => {
-  const board = await open();
+  const board = await open2();
   const signals = await board.listSignals(Number(opts.limit));
   print(signals, () => signals.length === 0 ? "No signals yet." : signals.map((s) => `[${s.ts}] ${s.signal.kind}	${s.signal.summary}`).join("\n"));
 });
 program.command("post <channel> <body>").description("Post a message to a channel, or into one of its threads").option("--as <agent>", "act as this agent instead of the user").option("--thread <threadId>", "post into the thread, which must hang off the channel").action(async (channel, body, opts) => {
-  const board = await open();
+  const board = await open2();
   const who = await actorFor(board, opts.as);
   const message = await board.postMessage(who, {
     channel,
@@ -8136,13 +8244,13 @@ program.command("post <channel> <body>").description("Post a message to a channe
   print(message, () => `Posted ${message.id} to ${message.channel}${message.thread === void 0 ? "" : ` (thread ${message.thread})`}`);
 });
 program.command("ask <text>").description("Post to the society's general channel as the user; the front desk routes it").action(async (text) => {
-  const board = await open();
+  const board = await open2();
   const message = await board.postMessage(board.userActor(), { channel: "general", body: text });
   print(message, () => `Posted ${message.id} to general; the concierge wakes on it`);
 });
 var task = program.command("task").description("Manage tasks");
 task.command("create <project> <title>").description("Create a task with a plan, or with one stage anyone in the project may take").option("--body <text>", "task body", "").option("--parent <id>", "parent task id").option("--plan <json>", `stages, for example '[{"name":"analysis","role":"analyst"}]'`).option("--channel <name>", "the project's channel to file it in, such as a release's", "general").option("--as <agent>", "act as this agent instead of the user").action(async (projectSlug, title, opts) => {
-  const board = await open();
+  const board = await open2();
   const who = await actorFor(board, opts.as);
   const created = await board.createTask(who, {
     project: projectSlug,
@@ -8158,17 +8266,17 @@ task.command("create <project> <title>").description("Create a task with a plan,
   ].join("\n"));
 });
 task.command("claim <id>").description("Hold the task's current stage").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const claimed = await board.claimTask(await actorFor(board, opts.as), { task_id: id });
   print(claimed, () => `Stage ${claimed.stage} of task ${claimed.id} held by ${claimed.claimedBy ?? "?"} until ${claimed.leaseExpiresAt ?? "?"}`);
 });
 task.command("release <id>").description("Let go of the stage held on a task").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const released = await board.releaseTask(await actorFor(board, opts.as), { task_id: id });
   print(released, () => `Stage ${released.stage} of task ${released.id} released`);
 });
 task.command("advance <id>").description("Finish the current stage; past the last one the task is done").option("--note <text>", "what was done, posted to the task's thread").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const advanced = await board.advanceTask(await actorFor(board, opts.as), {
     task_id: id,
     ...opts.note === void 0 ? {} : { note: opts.note }
@@ -8177,7 +8285,7 @@ task.command("advance <id>").description("Finish the current stage; past the las
 ${describePlan(advanced)}`);
 });
 task.command("plan <id> <stages>").description("Reshape the stages ahead: pass existing stages with their id to keep them, new ones without").option("--on-done <effect>", "override the completion effect for this task").option("--as <agent>", "act as this agent instead of the user").action(async (id, stages, opts) => {
-  const board = await open();
+  const board = await open2();
   const planned = await board.planTask(await actorFor(board, opts.as), {
     task_id: id,
     stages: PlanEditSchema.parse(JSON.parse(stages)),
@@ -8186,7 +8294,7 @@ task.command("plan <id> <stages>").description("Reshape the stages ahead: pass e
   print(planned, () => describePlan(planned));
 });
 task.command("update <id>").description("Send a task back to an earlier stage, abandon it, or set blockers, with a note for its thread").option("--stage <stageId>", "move back to this earlier stage").option("--abandon", "abandon the task", false).option("--note <text>", "a note, posted to the task's thread").option("--blocked-by <ids...>", "task ids this task waits on").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const updated = await board.updateTask(await actorFor(board, opts.as), {
     task_id: id,
     ...opts.stage === void 0 ? {} : { stage: opts.stage },
@@ -8197,7 +8305,7 @@ task.command("update <id>").description("Send a task back to an earlier stage, a
   print(updated, () => `Task ${updated.id} is ${updated.status} at ${updated.stage}`);
 });
 task.command("show <id>").description("Show a task with its plan and its thread").action(async (id) => {
-  const board = await open();
+  const board = await open2();
   const found = await board.getTask(board.userActor(), { task_id: id });
   const threadState = await board.readThread(id).then((t) => t.state).catch(() => "none");
   const said = found.messages.map((message) => {
@@ -8217,7 +8325,7 @@ ${message.body.trim()}
   ].join("\n"));
 });
 task.command("list <project>").description("List a project's tasks with their current stage").action(async (projectSlug) => {
-  const board = await open();
+  const board = await open2();
   const tasks = await board.listTasks(projectSlug);
   print(tasks, () => tasks.length === 0 ? "No tasks." : tasks.map((t) => {
     const stage = t.stages[stageIndex(t, t.stage)];
@@ -8226,7 +8334,7 @@ task.command("list <project>").description("List a project's tasks with their cu
 });
 var thread = program.command("thread").description("Manage threads");
 thread.command("open [taskId]").description("Open a thread on a task, on a proposal, or on a channel with a title").option("--proposal <id>", "open the proposal's thread").option("--channel <ref>", "the channel it hangs off; required for a topic").option("--title <text>", "the thread's title; required for a topic").option("--as <agent>", "act as this agent instead of the user").action(async (taskId, opts) => {
-  const board = await open();
+  const board = await open2();
   const opened = await board.openThread(await actorFor(board, opts.as), {
     ...taskId === void 0 ? {} : { task_id: taskId },
     ...opts.proposal === void 0 ? {} : { proposal_id: opts.proposal },
@@ -8236,7 +8344,7 @@ thread.command("open [taskId]").description("Open a thread on a task, on a propo
   print(opened, () => `Thread ${opened.id} opened on ${opened.channel}: ${opened.title}`);
 });
 thread.command("close <threadId>").description("Close a thread with a summary posted to its channel").requiredOption("--summary <text>", "closure summary").option("--as <agent>", "act as this agent instead of the user").action(async (threadId, opts) => {
-  const board = await open();
+  const board = await open2();
   const summary = await board.closeThread(await actorFor(board, opts.as), {
     thread_id: threadId,
     summary: opts.summary
@@ -8244,7 +8352,7 @@ thread.command("close <threadId>").description("Close a thread with a summary po
   print(summary, () => `Thread closed; summary posted as ${summary.id} to ${summary.channel}`);
 });
 thread.command("list").description("List threads, the society's first, then each project's").option("--open", "only open threads", false).action(async (opts) => {
-  const board = await open();
+  const board = await open2();
   const threads = (await board.listThreads()).filter((t) => !opts.open || t.state === "open");
   print(threads, () => threads.length === 0 ? "No threads." : threads.map((t) => {
     const about = t.subject === void 0 ? "topic" : t.subject.kind;
@@ -8252,7 +8360,7 @@ thread.command("list").description("List threads, the society's first, then each
   }).join("\n"));
 });
 thread.command("show <threadId>").description("Show a thread and its messages").action(async (threadId) => {
-  const board = await open();
+  const board = await open2();
   const found = await board.readThread(threadId);
   const messages = await board.listThread(threadId);
   print({ thread: found, messages }, () => [
@@ -8263,17 +8371,17 @@ thread.command("show <threadId>").description("Show a thread and its messages").
   ].join("\n"));
 });
 program.command("pause").description("Stop all wakeups; turns in flight finish").action(async () => {
-  const board = await open();
+  const board = await open2();
   await board.setPaused(board.userActor(), true);
   print({ paused: true }, () => "Society paused");
 });
 program.command("resume").description("Allow wakeups again").action(async () => {
-  const board = await open();
+  const board = await open2();
   await board.setPaused(board.userActor(), false);
   print({ paused: false }, () => "Society resumed");
 });
 program.command("society").description("The society's settings").command("timezone [zone]").description("Show the society's time zone, or set it: crons that name none are read in it").action(async (zone) => {
-  const board = await open();
+  const board = await open2();
   const society = zone === void 0 ? await board.society() : await board.setTimezone(board.userActor(), zone);
   print({ timezone: society.timezone }, () => `Time zone: ${society.timezone}`);
 });
@@ -8289,13 +8397,13 @@ function describeCron(cron2, timeZone) {
 }
 var cron = program.command("cron").description("Crons that wake citizens on a clock");
 cron.command("list").description("List crons, ended ones too with --all").option("--all", "include ended crons", false).action(async (opts) => {
-  const board = await open();
+  const board = await open2();
   const { timezone } = await board.society();
   const crons = (await board.listCrons()).filter((each) => opts.all || each.ended === void 0);
   print(crons, () => crons.length === 0 ? "No crons." : crons.map((each) => describeCron(each, timezone)).join("\n"));
 });
 cron.command("add <agent> <title>").description("Set a cron that wakes a citizen, with a note on what to do then").requiredOption("--note <text>", "what the citizen does when it fires").option("--cron <expression>", "five fields: minute hour day-of-month month day-of-week").option("--timezone <zone>", "the zone the expression is read in; the society's otherwise").option("--at <time>", "one time to fire, with its offset, instead of --cron").option("--project <slug>", "where it fires: a project the citizen is in, or society").option("--thread <id>", "an open thread there whose conversation it fires in").option("--channel <name>", "an open channel there, other than general, whose conversation it fires in").option("--as <agent>", "act as this agent instead of the user").action(async (agentName, title, opts) => {
-  const board = await open();
+  const board = await open2();
   const created = await board.createCron(await actorFor(board, opts.as), {
     title,
     note: opts.note,
@@ -8315,7 +8423,7 @@ for (const [name, paused] of [
   ["resume", false]
 ]) {
   cron.command(`${name} <id>`).description(paused ? "Pause a cron" : "Resume a paused cron from its next time").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-    const board = await open();
+    const board = await open2();
     const updated = await board.updateCron(await actorFor(board, opts.as), {
       cron_id: id,
       paused
@@ -8325,7 +8433,7 @@ for (const [name, paused] of [
   });
 }
 cron.command("remove <id>").description("End a cron for good").requiredOption("--reason <text>", "why it ends").option("--as <agent>", "act as this agent instead of the user").action(async (id, opts) => {
-  const board = await open();
+  const board = await open2();
   const removed = await board.removeCron(await actorFor(board, opts.as), {
     cron_id: id,
     reason: opts.reason
@@ -8334,12 +8442,12 @@ cron.command("remove <id>").description("End a cron for good").requiredOption("-
 });
 var knowledge = program.command("knowledge").description("Shared knowledge, by project or society");
 knowledge.command("list [project]").description("List knowledge topics of a project, or of the society when no project is given").action(async (projectSlug) => {
-  const board = await open();
+  const board = await open2();
   const topics = await board.listKnowledge(projectSlug ?? null);
   print(topics, () => topics.length === 0 ? "No knowledge yet." : topics.map((t) => `${t.topic}	revision ${t.revision}, updated by ${t.updatedBy} at ${t.updatedAt}`).join("\n"));
 });
 knowledge.command("show <topic>").description("Print a knowledge topic").option("--project <slug>", "the project's topic instead of the society's").action(async (topic, opts) => {
-  const board = await open();
+  const board = await open2();
   const found = (await board.listKnowledge(opts.project ?? null)).find((t) => t.topic === topic);
   if (found === void 0) {
     throw new BoardError("NOT_FOUND", `no knowledge topic ${topic}`);
@@ -8347,8 +8455,8 @@ knowledge.command("show <topic>").description("Print a knowledge topic").option(
   print(found, () => found.body);
 });
 knowledge.command("write <topic>").description("Write a knowledge topic as the user, from a file or standard input").requiredOption("--revision <n>", "the revision it replaces, as knowledge list shows it; 0 for a new topic").option("--project <slug>", "the project's topic instead of the society's").option("--file <path>", "read the body from this file instead of standard input").option("--as <agent>", "act as this agent instead of the user").action(async (topic, opts) => {
-  const board = await open();
-  const body = opts.file === void 0 ? await readStdin() : await readFile6(path7.resolve(opts.file), "utf8");
+  const board = await open2();
+  const body = opts.file === void 0 ? await readStdin() : await readFile5(path7.resolve(opts.file), "utf8");
   const written = await board.writeKnowledge(await actorFor(board, opts.as), {
     project: opts.project ?? null,
     topic,
@@ -8359,7 +8467,7 @@ knowledge.command("write <topic>").description("Write a knowledge topic as the u
 });
 var skill = program.command("skill").description("Skills promoted to the society");
 skill.command("list").description("List the society's skills, and each member's own").action(async () => {
-  const board = await open();
+  const board = await open2();
   const society = await board.listSocietySkills();
   const own = [];
   for (const member of await board.listAgents()) {
@@ -8374,7 +8482,7 @@ skill.command("list").description("List the society's skills, and each member's
   ].join("\n") || "No skills yet.");
 });
 skill.command("remove <name>").description("Remove a skill from the society's skills; its text is set aside, not destroyed").requiredOption("--reason <text>", "why it is wrong, superseded, or no longer used").option("--as <agent>", "act as this agent instead of the user").action(async (name, opts) => {
-  const board = await open();
+  const board = await open2();
   const removed = await board.removeSkill(await actorFor(board, opts.as), {
     name,
     reason: opts.reason
@@ -8383,13 +8491,13 @@ skill.command("remove <name>").description("Remove a skill from the society's sk
 });
 var turn = program.command("turn").description("Turn operations");
 turn.command("digest <agent>").description("Show the unread messages the agent's next turn opens with, in one scope or all; the cursors stay put").option("--limit <n>", "maximum messages", "50").option("--project <slug>", "the scope whose turn to show: a project, or society").action(async (agentName, opts) => {
-  const board = await open();
+  const board = await open2();
   const actor = await board.actorFor(agentName);
   const digest = await board.readDigest(opts.project === void 0 ? actor : { ...actor, scope: opts.project }, { advance: false, limit: Number(opts.limit) });
   print(digest, () => digest.messages.length === 0 ? "No unread messages." : digest.messages.map((m) => `[${m.ts}] ${m.channel}${m.thread === void 0 ? "" : ` (thread ${m.thread})`} @${m.author}: ${m.body.trim()}`).join("\n"));
 });
 turn.command("run <agent>").description("Enqueue a manual wake for an agent on a project, or a reflection turn").requiredOption("--project <slug>", "project to act on, or society for a society-scope turn").option("--reason <text>", "why", "manual wake from the admin CLI").option("--reflect", "a reflection turn instead of a working turn", false).action(async (agentName, opts) => {
-  const board = await open();
+  const board = await open2();
   const event = await board.requestWake(board.userActor(), {
     agent: agentName,
     project: opts.project,