@kubitnodes/stellaris 0.3.19 → 0.3.21

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";
@@ -146,7 +146,7 @@ var SEED_ROLES = [
   },
   {
     name: "steward",
-    purpose: "Watches the operations signals and the task board for capacity, skill, and capability gaps, and turns signals into proposals: a member when a project's plans need a role nobody fills or a backlog persists, a role when a project's work needs one no existing role covers, a retirement when a member has been idle for a long time. Opens a channel with create_channel when a topic or a workstream needs one, and archives it once its work is done. Owns how work is shaped over time: answers stages waiting too long, stages assigned to roles nobody fills, and work sent back again and again by replanning with plan_task, adjusting gates, or proposing the role a plan needs; sets each project's completion effect with configure_project; turns recurring plan shapes into society skills and planning norms into the society's norms. Prefers scaling an existing role over inventing a new one. Never approves its own proposals; hiring, roles, and retirements are decided by the user, and channels, reallocations, and skills the steward may decide. Curates society knowledge and skills.",
+    purpose: "Watches the operations signals and the task board for capacity, skill, and capability gaps, and turns signals into proposals: a member when a project's plans need a role nobody fills or a backlog persists, a role when a project's work needs one no existing role covers, a retirement when a member has been idle for a long time. Opens a channel with create_channel when a topic or a workstream needs one, and archives it once its work is done. Owns how work is shaped over time: answers stages waiting too long, stages assigned to roles nobody fills, and work sent back again and again by replanning with plan_task, adjusting gates, or proposing the role a plan needs; sets each project's completion effect with configure_project; turns recurring plan shapes into society skills and planning norms into the society's norms. Prefers scaling an existing role over inventing a new one, by a reallocation of its replicas, backlog threshold, wakes, or verbs. Never approves its own proposals; hiring, roles, retirements, and reallocations that change a role's verbs or replicas are decided by the user, and channels, skills, and other reallocations the steward may decide. Curates society knowledge and skills.",
     verbs: [...MEMBER_VERBS, ...GOVERNANCE_VERBS, ...PLANNING_VERBS, ...CURATING_VERBS],
     wakeTriggers: ["ops_event", "heartbeat"],
     maxReplicas: 1,
@@ -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({
@@ -608,9 +615,54 @@ var ChannelProposalSchema = z4.object({
   name: NameSchema,
   purpose: z4.string().min(1)
 });
+var RoleChangesSchema = z4.strictObject({
+  maxReplicas: z4.number().int().min(1).optional(),
+  backlogThreshold: z4.number().positive().optional(),
+  wakeTriggers: z4.array(CharterTriggerSchema).optional(),
+  verbs: z4.array(VerbNameSchema).optional()
+}).refine((changes) => Object.values(changes).some((value) => value !== void 0), {
+  message: "a reallocation changes at least one of maxReplicas, backlogThreshold, wakeTriggers, verbs"
+});
 var ReallocationProposalSchema = z4.object({
+  role: NameSchema,
+  changes: RoleChangesSchema,
   description: z4.string().min(1)
 });
+var LegacyReallocationSchema = z4.object({ description: z4.string().min(1) });
+function applyRoleChanges(role2, changes) {
+  return {
+    ...role2,
+    ...changes.maxReplicas === void 0 ? {} : { maxReplicas: changes.maxReplicas },
+    ...changes.backlogThreshold === void 0 ? {} : { backlogThreshold: changes.backlogThreshold },
+    ...changes.wakeTriggers === void 0 ? {} : { wakeTriggers: [...changes.wakeTriggers] },
+    ...changes.verbs === void 0 ? {} : { verbs: [...changes.verbs] }
+  };
+}
+function listedOrNone(values) {
+  return values.length === 0 ? "none" : values.join(", ");
+}
+function roleChangeLines(role2, changes) {
+  const lines = [];
+  if (changes.maxReplicas !== void 0 && changes.maxReplicas !== role2.maxReplicas) {
+    lines.push(`maxReplicas ${role2.maxReplicas} \u2192 ${changes.maxReplicas}`);
+  }
+  if (changes.backlogThreshold !== void 0 && changes.backlogThreshold !== role2.backlogThreshold) {
+    lines.push(`backlogThreshold ${role2.backlogThreshold} \u2192 ${changes.backlogThreshold}`);
+  }
+  const wakes = changes.wakeTriggers;
+  if (wakes !== void 0 && (wakes.length !== role2.wakeTriggers.length || wakes.some((trigger) => !role2.wakeTriggers.includes(trigger)))) {
+    lines.push(`wakeTriggers ${listedOrNone(role2.wakeTriggers)} \u2192 ${listedOrNone(wakes)}`);
+  }
+  if (changes.verbs !== void 0) {
+    const next = changes.verbs;
+    const added = next.filter((verb) => !role2.verbs.includes(verb)).map((verb) => `+${verb}`);
+    const removed = role2.verbs.filter((verb) => !next.includes(verb)).map((verb) => `\u2212${verb}`);
+    if (added.length + removed.length > 0) {
+      lines.push(`verbs ${[...added, ...removed].join(" ")}`);
+    }
+  }
+  return lines;
+}
 var RetirementProposalSchema = z4.object({
   agent: NameSchema,
   reason: z4.string().min(1)
@@ -642,6 +694,32 @@ var ROLE_KIND_APPROVERS = {
   reallocation: [USER_ROLE, "steward"],
   skill: [USER_ROLE, "steward"]
 };
+var USER_DECIDED_ROLE_CHANGES = ["verbs", "maxReplicas"];
+function proposalApprovers(kind, charter) {
+  if (kind === "reallocation") {
+    const parsed = ReallocationProposalSchema.safeParse(charter);
+    if (parsed.success && USER_DECIDED_ROLE_CHANGES.some((field) => parsed.data.changes[field] !== void 0)) {
+      return [USER_ROLE];
+    }
+  }
+  return ROLE_KIND_APPROVERS[kind];
+}
+function describeRoleChanges(changes) {
+  const parts = [];
+  if (changes.maxReplicas !== void 0) {
+    parts.push(`up to ${changes.maxReplicas} per project`);
+  }
+  if (changes.backlogThreshold !== void 0) {
+    parts.push(`backlog threshold ${changes.backlogThreshold}`);
+  }
+  if (changes.wakeTriggers !== void 0) {
+    parts.push(changes.wakeTriggers.length === 0 ? "no ambient wakes" : `wakes on ${changes.wakeTriggers.join(", ")}`);
+  }
+  if (changes.verbs !== void 0) {
+    parts.push(`${changes.verbs.length} verbs`);
+  }
+  return parts.join(", ");
+}
 function describeCharter(kind, charter) {
   switch (kind) {
     case "member": {
@@ -673,9 +751,14 @@ function describeCharter(kind, charter) {
     }
     case "reallocation": {
       const parsed = ReallocationProposalSchema.safeParse(charter);
-      if (!parsed.success)
+      if (parsed.success) {
+        const { role: role2, changes, description } = parsed.data;
+        return `reallocation of role ${role2} (${describeRoleChanges(changes)}): ${description}`;
+      }
+      const legacy = LegacyReallocationSchema.safeParse(charter);
+      if (!legacy.success)
         break;
-      return `reallocation: ${parsed.data.description}`;
+      return `reallocation: ${legacy.data.description}`;
     }
     case "skill": {
       const parsed = SkillProposalSchema.safeParse(charter);
@@ -1733,7 +1816,7 @@ var RunnerConfigSchema = z11.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.19";
+var STELLARIS_VERSION = "0.3.21";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -1746,7 +1829,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 +1914,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 +1943,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) {
-        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) {
+    await this.refresh();
+    const chosen = [];
+    for (const line of this.lines) {
+      if (since !== null && line.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 +2055,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 +2113,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 +2122,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 +2135,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 +2279,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 +3198,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 +3594,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 +3602,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 +3668,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 +4007,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 +4055,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 +4157,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
@@ -4383,18 +4550,16 @@ ${DASHBOARD_LINE}
   async readDigest(actor, input = {}) {
     const args = VerbInputs.read_inbox.parse(input);
     await this.authorize(actor, "read_inbox");
-    return this.mutex.run(async () => {
-      const stored = await this.readCursors(actor.name);
-      const from = args.since_cursor === void 0 ? stored : { ...NO_CURSORS, digest: args.since_cursor };
-      const conversation = actor.scope === void 0 ? void 0 : { scope: actor.scope, part: conversationPart(actor) ?? null };
-      const filed = (await this.digestSince(actor, from, conversation)).slice(0, args.limit);
-      if (args.advance) {
-        await this.advanceCursors(actor.name, filed);
-      }
-      const last = filed.at(-1)?.message.id;
-      const cursor = last ?? (conversation === void 0 ? from.digest : cursorOf(from, conversation.scope, conversation.part));
-      return { messages: filed.map((entry) => entry.message), cursor };
-    });
+    const { cursors: stored, upto } = await this.digestSnapshot(actor.name);
+    const from = args.since_cursor === void 0 ? stored : { ...NO_CURSORS, digest: args.since_cursor };
+    const conversation = actor.scope === void 0 ? void 0 : { scope: actor.scope, part: conversationPart(actor) ?? null };
+    const filed = (await this.digestSince(actor, from, upto, conversation)).slice(0, args.limit);
+    if (args.advance) {
+      await this.mutex.run(() => this.advanceCursors(actor.name, filed));
+    }
+    const last = filed.at(-1)?.message.id;
+    const cursor = last ?? (conversation === void 0 ? from.digest : cursorOf(from, conversation.scope, conversation.part));
+    return { messages: filed.map((entry) => entry.message), cursor };
   }
   /**
    * How many unread digest messages a member has in each conversation: a scope's home, for its
@@ -4406,28 +4571,39 @@ ${DASHBOARD_LINE}
    * whose signals that call for action wake their readers directly.
    */
   async unreadByConversation(actor) {
-    return this.mutex.run(async () => {
-      const counts = /* @__PURE__ */ new Map();
-      const unscoped = { name: actor.name, role: actor.role };
-      for (const { scope, part, message, news } of await this.digestSince(unscoped, await this.readCursors(actor.name))) {
-        if (news === true || message.step !== void 0 || message.author === SYSTEM_ACTOR.name) {
-          continue;
-        }
-        const posted = parseChannelRef(message.channel).project ?? SOCIETY_SCOPE;
-        if (posted !== scope && scope !== SOCIETY_SCOPE) {
-          continue;
-        }
-        const key = conversationKey(scope, part);
-        const entry = counts.get(key) ?? {
-          scope,
-          thread: threadOfPart(part) ?? null,
-          channel: channelOfPart(part) ?? null,
-          count: 0
-        };
-        counts.set(key, { ...entry, count: entry.count + 1 });
+    const { cursors, upto } = await this.digestSnapshot(actor.name);
+    const counts = /* @__PURE__ */ new Map();
+    const unscoped = { name: actor.name, role: actor.role };
+    for (const { scope, part, message, news } of await this.digestSince(unscoped, cursors, upto)) {
+      if (news === true || message.step !== void 0 || message.author === SYSTEM_ACTOR.name) {
+        continue;
       }
-      return [...counts.values()];
-    });
+      const posted = parseChannelRef(message.channel).project ?? SOCIETY_SCOPE;
+      if (posted !== scope && scope !== SOCIETY_SCOPE) {
+        continue;
+      }
+      const key = conversationKey(scope, part);
+      const entry = counts.get(key) ?? {
+        scope,
+        thread: threadOfPart(part) ?? null,
+        channel: channelOfPart(part) ?? null,
+        count: 0
+      };
+      counts.set(key, { ...entry, count: entry.count + 1 });
+    }
+    return [...counts.values()];
+  }
+  /**
+   * A reader's cursors and the id below which every message is already on disk, taken under the
+   * mutex, which a digest scan then leaves: messages carry ids from the same monotonic source and are
+   * written under the mutex, so the scan, which counts nothing newer than the mark, cannot pass over
+   * one written while it reads, and a post never waits for a scan.
+   */
+  digestSnapshot(agent2) {
+    return this.mutex.run(async () => ({
+      cursors: await this.readCursors(agent2),
+      upto: this.newId()
+    }));
   }
   async readCursors(agent2) {
     const file = this.paths.agentCursors(agent2);
@@ -4469,9 +4645,10 @@ ${DASHBOARD_LINE}
    * by the user wherever it is. With a conversation, only what is filed there: for a thread, every
    * message of the thread, since the conversation is about it; for a channel's, that channel's
    * top-level messages; for a scope's home, general's and those of a project the member is not in,
-   * since each thread and each other channel is a conversation of its own.
+   * since each thread and each other channel is a conversation of its own. Nothing newer than
+   * `upto` counts (see `digestSnapshot`).
    */
-  async digestSince(actor, cursors, conversation) {
+  async digestSince(actor, cursors, upto, conversation) {
     const conversationThread = threadOfPart(conversation?.part);
     if (conversation !== void 0 && conversationThread !== void 0) {
       const { scope, part } = conversation;
@@ -4479,7 +4656,7 @@ ${DASHBOARD_LINE}
       if (found === null) {
         return [];
       }
-      const messages = await this.readMessagesIn(this.paths.threadMessages(found.threads, conversationThread), cursorOf(cursors, scope, part));
+      const messages = await this.readMessagesIn(this.paths.threadMessages(found.threads, conversationThread), cursorOf(cursors, scope, part), upto);
       return messages.filter((message) => message.author !== actor.name).map((message) => ({ scope, part, message })).toSorted(byId);
     }
     const agent2 = await this.readAgent(actor.name);
@@ -4497,7 +4674,7 @@ ${DASHBOARD_LINE}
     ];
     const known = starts.filter((start) => start !== null);
     const since = known.length < starts.length ? null : known.toSorted((a, b) => a < b ? -1 : a > b ? 1 : 0)[0] ?? null;
-    for await (const message of this.iterateMessages(since)) {
+    for await (const message of this.iterateMessages(since, void 0, upto)) {
       const filedIn = wakeScope(agent2, parseChannelRef(message.channel).project);
       const thread2 = message.thread ?? null;
       const asked = message.mentions.includes(actor.name) || frontDesk && message.author === USER_NAME;
@@ -4513,12 +4690,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 +4760,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 +4798,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,
@@ -5621,6 +5798,9 @@ ${args.summary}`);
       }
       if (args.blocked_by !== void 0) {
         for (const id of args.blocked_by) {
+          if (id === current.id) {
+            throw new BoardError("VALIDATION", `task ${current.id} cannot be blocked by itself`);
+          }
           await this.findTask(id);
         }
         next = { ...next, blockedBy: [...args.blocked_by] };
@@ -5657,6 +5837,7 @@ ${args.summary}`);
           from: current.status,
           to: task2.status,
           note: args.note ?? null,
+          ...args.blocked_by === void 0 ? {} : { blockedBy: task2.blockedBy, previousBlockedBy: current.blockedBy },
           ...args.pull_request === void 0 ? {} : { pullRequest: task2.pullRequest?.url ?? null }
         });
       }
@@ -6110,7 +6291,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 +6770,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 });
           }
@@ -6955,12 +7136,37 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       case "archive":
         await this.validateArchive(ArchiveProposalSchema.parse(charter).project);
         return;
-      case "reallocation":
+      case "reallocation": {
+        const parsed = ReallocationProposalSchema.safeParse(charter);
+        if (parsed.success) {
+          await this.reallocatedRole(parsed.data);
+        } else {
+          LegacyReallocationSchema.parse(charter);
+        }
         return;
+      }
       default:
         return;
     }
   }
+  /**
+   * The role as a reallocation would leave it, with what changes: refused for the user's charter,
+   * a role that does not exist, a charter the changes would make invalid, and changes the role
+   * has already.
+   */
+  async reallocatedRole(reallocation) {
+    if (reallocation.role === USER_ROLE) {
+      throw new BoardError("FORBIDDEN", "the user charter is not subject to proposals");
+    }
+    const current = await this.readRole(reallocation.role);
+    const next = RoleCharterSchema.parse(applyRoleChanges(current, reallocation.changes));
+    await this.validateRole(next);
+    const changed = roleChangeLines(current, reallocation.changes);
+    if (changed.length === 0) {
+      throw new BoardError("VALIDATION", `role ${current.name} has these values already; the reallocation changes nothing`);
+    }
+    return { next, changed };
+  }
   async executeProvision(by, proposal2) {
     const meta = { proposalId: proposal2.id };
     switch (proposal2.kind) {
@@ -6997,8 +7203,15 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
         const { members } = await this.archiveUnlocked(by, input.project, input.reason, meta);
         return { project: input.project, members };
       }
-      case "reallocation":
-        return void 0;
+      case "reallocation": {
+        const parsed = ReallocationProposalSchema.safeParse(proposal2.charter);
+        if (!parsed.success) {
+          return void 0;
+        }
+        const { next, changed } = await this.reallocatedRole(parsed.data);
+        await this.writeRoleUnlocked(by, next, meta);
+        return { role: next.name, changed };
+      }
       default:
         return void 0;
     }
@@ -7167,7 +7380,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,
@@ -7698,7 +7911,7 @@ ${charter.purpose}
     if (filed.proposedBy === actor.name) {
       throw new BoardError("FORBIDDEN", "a proposer never decides its own proposal");
     }
-    const approvers = ROLE_KIND_APPROVERS[filed.kind];
+    const approvers = proposalApprovers(filed.kind, filed.charter);
     if (!approvers.includes(actor.role)) {
       throw new BoardError("FORBIDDEN", `a ${filed.kind} proposal requires one of: ${approvers.join(", ")}`);
     }
@@ -7781,7 +7994,7 @@ ${charter.purpose}
       }
       if (subject?.kind === "proposal") {
         const proposal2 = await this.readProposal(subject.id);
-        if (proposal2.proposedBy === actor.name || proposal2.decidedBy === actor.name || ROLE_KIND_APPROVERS[proposal2.kind].includes(actor.role)) {
+        if (proposal2.proposedBy === actor.name || proposal2.decidedBy === actor.name || proposalApprovers(proposal2.kind, proposal2.charter).includes(actor.role)) {
           return true;
         }
         return (await this.readRole(actor.role)).wakeTriggers.includes(OPS_WAKE_TRIGGER);
@@ -7838,11 +8051,12 @@ ${charter.purpose}
     });
     await this.endCronsUnlocked(by, `its thread closed: its ${found.thread.subject?.kind ?? "subject"} was ${ended}`, (cron2) => cron2.thread === subjectId);
   }
-  async readMessagesIn(dir, since) {
+  /** The messages in a folder after `since` and, when given, up to `upto`, read by name first. */
+  async readMessagesIn(dir, since, upto) {
     const messages = [];
     for (const file of await listFiles(dir)) {
       const id = file.slice(0, 26);
-      if (since !== null && id <= since) {
+      if (since !== null && id <= since || upto !== void 0 && id > upto) {
         continue;
       }
       const doc = await readMarkdown(path6.join(dir, file), MessageFrontmatterSchema);
@@ -7850,25 +8064,45 @@ ${charter.purpose}
     }
     return messages;
   }
-  /** Every message newer than `since` across society channels, project channels, and threads. */
-  async *iterateMessages(since, project2) {
+  /**
+   * Every message newer than `since`, and no newer than `upto` when given, across society
+   * channels, project channels, and threads.
+   */
+  async *iterateMessages(since, project2, upto) {
     if (project2 === void 0) {
       for (const channel of await listDirs(this.paths.societyChannels())) {
-        yield* await this.readMessagesIn(this.paths.societyChannel(channel), since);
+        yield* await this.readMessagesIn(this.paths.societyChannel(channel), since, upto);
       }
-      yield* this.threadMessagesIn(this.paths.societyThreads(), since);
+      yield* this.threadMessagesIn(this.paths.societyThreads(), since, upto);
     }
     const projects = project2 === void 0 ? await listDirs(this.paths.projects()) : [project2];
     for (const slug of projects) {
       for (const channel of await listDirs(this.paths.projectChannels(slug))) {
-        yield* await this.readMessagesIn(this.paths.projectChannel(slug, channel), since);
+        yield* await this.readMessagesIn(this.paths.projectChannel(slug, channel), since, upto);
+      }
+      yield* this.threadMessagesIn(this.paths.threads(slug), since, upto);
+    }
+  }
+  /** 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);
       }
-      yield* this.threadMessagesIn(this.paths.threads(slug), since);
     }
   }
-  async *threadMessagesIn(threads, since) {
+  async *threadMessagesIn(threads, since, upto) {
     for (const id of await listDirs(threads)) {
-      yield* await this.readMessagesIn(this.paths.threadMessages(threads, id), since);
+      yield* await this.readMessagesIn(this.paths.threadMessages(threads, id), since, upto);
     }
   }
 };
@@ -7882,7 +8116,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 +8162,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 +8171,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 +8181,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 +8189,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 +8197,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 +8212,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 +8231,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 +8241,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 +8250,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 +8281,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 +8290,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 +8299,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 +8308,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 +8325,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 +8337,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 +8347,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 +8355,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 +8370,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 +8392,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 +8411,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 +8420,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 +8431,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 +8451,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 +8460,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 +8470,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 +8478,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 +8486,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 +8497,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 +8523,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 +8549,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 +8559,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 +8568,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 +8581,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 +8593,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 +8608,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 +8617,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,