@kubitnodes/stellaris 0.3.6 → 0.3.8

package/dist/cli/index.js

@@ -6,7 +6,7 @@ import path7 from "node:path";
 import { Command } from "commander";
 
 // packages/board-core/dist/board.js
-import { readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
+import { mkdir as mkdir4, readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
 import path6 from "node:path";
 import { decodeTime, monotonicFactory } from "ulid";
 import { z as z12 } from "zod";
@@ -56,7 +56,8 @@ var VERB_NAMES = [
   "plan_task",
   "advance_task",
   "configure_project",
-  "archive_project"
+  "archive_project",
+  "remove_knowledge"
 ];
 var VerbNameSchema = z2.enum(VERB_NAMES);
 var CharterTriggerSchema = z2.enum(["user_post", "ops_event", "heartbeat"]);
@@ -100,6 +101,7 @@ var MEMBER_VERBS = [
   "join_project",
   "leave_project",
   "write_knowledge",
+  "remove_knowledge",
   "plan_task",
   "advance_task"
 ];
@@ -314,6 +316,11 @@ var ModelOptionSchema = z3.object({
   efforts: z3.array(EffortOptionSchema).default([]),
   defaultEffort: EffortSchema.optional()
 });
+var RunnerModelsSchema = z3.object({
+  runner: NameSchema,
+  cli: CliKindSchema,
+  models: z3.array(ModelOptionSchema)
+});
 var AgentStatusSchema = z3.enum(["active", "retired"]);
 var AgentSchema = z3.object({
   name: NameSchema,
@@ -534,6 +541,12 @@ var KnowledgeSchema = z3.object({
   updatedBy: NameSchema,
   updatedAt: IsoDateTimeSchema
 });
+var RemovedKnowledgeSchema = z3.object({
+  topic: NameSchema,
+  project: NameSchema.nullable(),
+  removedBy: NameSchema,
+  removedAt: IsoDateTimeSchema
+});
 var ProposalFrontmatterSchema = z3.object({
   id: UlidSchema,
   kind: ProposalKindSchema,
@@ -630,6 +643,11 @@ var VerbInputs = {
     topic: NameSchema,
     body: z4.string().min(1)
   }),
+  remove_knowledge: z4.object({
+    /** As for write_knowledge: a project you belong to, or null for society knowledge. */
+    project: NameSchema.nullable().default(null),
+    topic: NameSchema
+  }),
   plan_task: z4.object({
     task_id: UlidSchema,
     stages: z4.array(PlanEditStageSchema),
@@ -639,7 +657,9 @@ var VerbInputs = {
   advance_task: z4.object({ task_id: UlidSchema, note: z4.string().min(1).optional() }),
   configure_project: z4.object({
     project: NameSchema,
-    on_done: CompletionEffectSchema
+    on_done: CompletionEffectSchema.optional(),
+    /** A new display name; the slug, which everything refers to the project by, never changes. */
+    name: z4.string().trim().min(1).max(120).optional()
   }),
   archive_project: z4.object({ project: NameSchema, reason: z4.string().min(1) })
 };
@@ -679,6 +699,7 @@ var BOARD_EVENT_TYPES = [
   "agent.joined",
   "agent.left",
   "knowledge.written",
+  "knowledge.removed",
   "skill.promoted",
   "runner.added",
   "user.signed_in",
@@ -1276,7 +1297,7 @@ var RunnerConfigSchema = z10.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.6";
+var STELLARIS_VERSION = "0.3.8";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -2309,6 +2330,10 @@ var BoardPaths = class {
   pausedFile() {
     return path5.join(this.state(), "paused.json");
   }
+  /** Removed knowledge topics, set aside outside the projection, by scope. */
+  removedKnowledge(scope) {
+    return path5.join(this.state(), "removed-knowledge", scope);
+  }
 };
 
 // packages/board-core/dist/tokens.js
@@ -2402,6 +2427,7 @@ var OPS_CHANNEL_RETIRED = "ops-channel-retired";
 var DECISIONS_CHANNEL_RETIRED = "decisions-channel-retired";
 var THREAD_CONVERSATIONS = "thread-conversations";
 var ASKS_CHANNEL_OPENED = "asks-channel-opened";
+var KNOWLEDGE_REMOVAL = "knowledge-removal-granted";
 var PLANNING_ROLES = [USER_ROLE, "steward", "concierge"];
 var REALLOCATING_ROLES = [USER_ROLE, "steward", "concierge"];
 var PROFILE_TEMPLATE = "# Profile\n\nOne short paragraph, kept current: what I do well, what I am working on, and what to send my way. The board projects this into the roster the front desk reads.\n";
@@ -2591,7 +2617,8 @@ var Board = class _Board {
       OPS_CHANNEL_RETIRED,
       DECISIONS_CHANNEL_RETIRED,
       THREAD_CONVERSATIONS,
-      ASKS_CHANNEL_OPENED
+      ASKS_CHANNEL_OPENED,
+      KNOWLEDGE_REMOVAL
     ].filter((name) => !applied.includes(name));
     if (pending.length === 0) {
       return;
@@ -2620,8 +2647,22 @@ var Board = class _Board {
     if (pending.includes(ASKS_CHANNEL_OPENED)) {
       await this.openAsksChannel();
     }
+    if (pending.includes(KNOWLEDGE_REMOVAL)) {
+      await this.grantKnowledgeRemoval();
+    }
     await writeJson(file, { applied: [...applied, ...pending] });
   }
+  /**
+   * Whoever may write a scope's knowledge may remove it, so every charter granting
+   * `write_knowledge` is granted `remove_knowledge` once; seed roles have it from their seed.
+   */
+  async grantKnowledgeRemoval() {
+    for (const charter of await this.listRoles()) {
+      if (charter.verbs.includes("write_knowledge") && !charter.verbs.includes("remove_knowledge")) {
+        await this.writeRoleUnlocked(USER_NAME, { ...charter, verbs: [...charter.verbs, "remove_knowledge"] }, { verbsAdded: ["remove_knowledge"] });
+      }
+    }
+  }
   /**
    * A task sent back before tasks recorded it kept no trace outside the event log. A task still
    * short of the stage its latest `task.moved` came from is in that rework, and records it.
@@ -3853,16 +3894,7 @@ ${task2.body}`;
     const args = VerbInputs.write_knowledge.parse(input);
     await this.authorize(actor, "write_knowledge");
     return this.mutex.run(async () => {
-      if (args.project === null) {
-        if (!CURATING_ROLES.includes(actor.role)) {
-          throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
-        }
-      } else {
-        const project2 = await this.readActiveProject(args.project);
-        if (!CURATING_ROLES.includes(actor.role) && !project2.members.includes(actor.name)) {
-          throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${args.project}`);
-        }
-      }
+      await this.assertMayCurate(actor, args.project);
       const data = KnowledgeSchema.parse({
         topic: args.topic,
         project: args.project,
@@ -3882,6 +3914,52 @@ ${task2.body}`;
       return { ...data, body: args.body };
     });
   }
+  /**
+   * Retires a topic, by whoever may write it. Its file leaves the knowledge directory, so no turn,
+   * search, or digest finds it again, and is set aside under `state/removed-knowledge`, outside
+   * the projection, for the user to restore by hand. The note in the matching general channel
+   * carries no mention, as a write's does.
+   */
+  async removeKnowledge(actor, input) {
+    const args = VerbInputs.remove_knowledge.parse(input);
+    await this.authorize(actor, "remove_knowledge");
+    return this.mutex.run(async () => {
+      await this.assertMayCurate(actor, args.project);
+      const file = args.project === null ? this.paths.societyKnowledgeFile(args.topic) : this.paths.projectKnowledgeFile(args.project, args.topic);
+      if (!await exists(file)) {
+        throw new BoardError("NOT_FOUND", `${args.project ?? "the society"} has no knowledge topic ${args.topic}`);
+      }
+      const removed = RemovedKnowledgeSchema.parse({
+        topic: args.topic,
+        project: args.project,
+        removedBy: actor.name,
+        removedAt: this.now().toISOString()
+      });
+      const aside = this.paths.removedKnowledge(args.project ?? SOCIETY_SCOPE);
+      await mkdir4(aside, { recursive: true });
+      await rename3(file, path6.join(aside, `${args.topic}.${removed.removedAt.replaceAll(":", "-")}.md`));
+      await this.events.append("knowledge.removed", actor.name, {
+        topic: args.topic,
+        project: args.project
+      });
+      const where = args.project === null ? "general" : channelRef(args.project, "general");
+      await this.appendMessage(actor.name, where, `Knowledge removed: ${args.topic}. It is no longer under knowledge/${args.topic}.md${args.project === null ? " of the society" : ""}.`);
+      return removed;
+    });
+  }
+  /** Society knowledge is the steward's and the user's; a project's, its members' too. */
+  async assertMayCurate(actor, project2) {
+    if (project2 === null) {
+      if (!CURATING_ROLES.includes(actor.role)) {
+        throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
+      }
+      return;
+    }
+    const active = await this.readActiveProject(project2);
+    if (!CURATING_ROLES.includes(actor.role) && !active.members.includes(actor.name)) {
+      throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${project2}`);
+    }
+  }
   async openThread(actor, input) {
     const args = VerbInputs.open_thread.parse(input);
     await this.authorize(actor, "open_thread");
@@ -4551,18 +4629,28 @@ ${rationale}`}`);
     }));
   }
   /** Sets a project's completion effect. */
+  /**
+   * Sets a project's completion effect, its display name, or both. The slug stays: addresses,
+   * channel references, branches, and runners' directories all carry it.
+   */
   async configureProject(actor, input) {
     const args = VerbInputs.configure_project.parse(input);
     await this.authorize(actor, "configure_project");
+    if (args.on_done === void 0 && args.name === void 0) {
+      throw new BoardError("VALIDATION", "configure_project needs on_done, name, or both");
+    }
     return this.mutex.run(async () => {
-      await this.readActiveProject(args.project);
+      const previous = await this.readActiveProject(args.project);
       const project2 = await this.updateProject(args.project, (current) => ({
         ...current,
-        onDone: args.on_done
+        ...args.on_done === void 0 ? {} : { onDone: args.on_done },
+        ...args.name === void 0 ? {} : { name: args.name }
       }));
       await this.events.append("project.configured", actor.name, {
         slug: project2.slug,
-        onDone: project2.onDone
+        onDone: project2.onDone,
+        name: project2.name,
+        ...project2.name === previous.name ? {} : { previousName: previous.name }
       });
       return project2;
     });
@@ -4708,6 +4796,8 @@ ${rationale}`}`);
         return this.leaveProject(actor, VerbInputs.leave_project.parse(input));
       case "write_knowledge":
         return this.writeKnowledge(actor, VerbInputs.write_knowledge.parse(input));
+      case "remove_knowledge":
+        return this.removeKnowledge(actor, VerbInputs.remove_knowledge.parse(input));
       case "plan_task":
         return this.planTask(actor, VerbInputs.plan_task.parse(input));
       case "advance_task":

package/dist/server/index.js

@@ -6,7 +6,7 @@ import path9 from "node:path";
 import { serve } from "@hono/node-server";
 
 // packages/board-core/dist/board.js
-import { readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
+import { mkdir as mkdir4, readdir as readdir3, readFile as readFile5, rename as rename3, stat as stat2 } from "node:fs/promises";
 import path6 from "node:path";
 import { decodeTime, monotonicFactory } from "ulid";
 import { z as z12 } from "zod";
@@ -56,7 +56,8 @@ var VERB_NAMES = [
   "plan_task",
   "advance_task",
   "configure_project",
-  "archive_project"
+  "archive_project",
+  "remove_knowledge"
 ];
 var VerbNameSchema = z2.enum(VERB_NAMES);
 var CharterTriggerSchema = z2.enum(["user_post", "ops_event", "heartbeat"]);
@@ -100,6 +101,7 @@ var MEMBER_VERBS = [
   "join_project",
   "leave_project",
   "write_knowledge",
+  "remove_knowledge",
   "plan_task",
   "advance_task"
 ];
@@ -314,6 +316,11 @@ var ModelOptionSchema = z3.object({
   efforts: z3.array(EffortOptionSchema).default([]),
   defaultEffort: EffortSchema.optional()
 });
+var RunnerModelsSchema = z3.object({
+  runner: NameSchema,
+  cli: CliKindSchema,
+  models: z3.array(ModelOptionSchema)
+});
 var AgentStatusSchema = z3.enum(["active", "retired"]);
 var AgentSchema = z3.object({
   name: NameSchema,
@@ -534,6 +541,12 @@ var KnowledgeSchema = z3.object({
   updatedBy: NameSchema,
   updatedAt: IsoDateTimeSchema
 });
+var RemovedKnowledgeSchema = z3.object({
+  topic: NameSchema,
+  project: NameSchema.nullable(),
+  removedBy: NameSchema,
+  removedAt: IsoDateTimeSchema
+});
 var ProposalFrontmatterSchema = z3.object({
   id: UlidSchema,
   kind: ProposalKindSchema,
@@ -630,6 +643,11 @@ var VerbInputs = {
     topic: NameSchema,
     body: z4.string().min(1)
   }),
+  remove_knowledge: z4.object({
+    /** As for write_knowledge: a project you belong to, or null for society knowledge. */
+    project: NameSchema.nullable().default(null),
+    topic: NameSchema
+  }),
   plan_task: z4.object({
     task_id: UlidSchema,
     stages: z4.array(PlanEditStageSchema),
@@ -639,7 +657,9 @@ var VerbInputs = {
   advance_task: z4.object({ task_id: UlidSchema, note: z4.string().min(1).optional() }),
   configure_project: z4.object({
     project: NameSchema,
-    on_done: CompletionEffectSchema
+    on_done: CompletionEffectSchema.optional(),
+    /** A new display name; the slug, which everything refers to the project by, never changes. */
+    name: z4.string().trim().min(1).max(120).optional()
   }),
   archive_project: z4.object({ project: NameSchema, reason: z4.string().min(1) })
 };
@@ -663,9 +683,10 @@ var VERB_DESCRIPTIONS = {
   join_project: "Join a project, or add another citizen to one when your role allows it. Membership gives the pair a worktree and an onboarding turn.",
   leave_project: "Leave a project, or remove another citizen from one when your role allows it.",
   write_knowledge: "Write or replace a knowledge topic: durable facts every member of a project should know, or with project null the society's shared knowledge (steward and user). Not a message; use post_message for those.",
+  remove_knowledge: "Remove a knowledge topic that is wrong, superseded, or folded into another, so no turn or search finds it again. Whoever may write the topic may remove it; the board keeps its text aside for the user to restore.",
   plan_task: "Reshape a task's plan from the current stage onward, or after it while someone holds it: keep a stage by passing its id, drop it by leaving it out, add one without an id. Gated stages and on_done: user, steward, concierge.",
   advance_task: "Finish the stage you hold, with a note for the task's thread on what you did. The next stage becomes current; past the last one the task is done.",
-  configure_project: "Set a project's completion effect: none, or merge to land each finished task's branch on the default branch.",
+  configure_project: "Set a project's completion effect (none, or merge to land each finished task's branch on the default branch), its display name, or both. The slug never changes.",
   archive_project: "Archive a project whose work is finished or has moved: its members leave, its open threads close, and nothing more is posted, filed, or joined there, while its files and history stay. Refused while a task there is in play."
 };
 
@@ -704,6 +725,7 @@ var BOARD_EVENT_TYPES = [
   "agent.joined",
   "agent.left",
   "knowledge.written",
+  "knowledge.removed",
   "skill.promoted",
   "runner.added",
   "user.signed_in",
@@ -1356,7 +1378,7 @@ var RunnerConfigSchema = z10.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.6";
+var STELLARIS_VERSION = "0.3.8";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -2392,6 +2414,10 @@ var BoardPaths = class {
   pausedFile() {
     return path5.join(this.state(), "paused.json");
   }
+  /** Removed knowledge topics, set aside outside the projection, by scope. */
+  removedKnowledge(scope) {
+    return path5.join(this.state(), "removed-knowledge", scope);
+  }
 };
 
 // packages/board-core/dist/tokens.js
@@ -2485,6 +2511,7 @@ var OPS_CHANNEL_RETIRED = "ops-channel-retired";
 var DECISIONS_CHANNEL_RETIRED = "decisions-channel-retired";
 var THREAD_CONVERSATIONS = "thread-conversations";
 var ASKS_CHANNEL_OPENED = "asks-channel-opened";
+var KNOWLEDGE_REMOVAL = "knowledge-removal-granted";
 var PLANNING_ROLES = [USER_ROLE, "steward", "concierge"];
 var REALLOCATING_ROLES = [USER_ROLE, "steward", "concierge"];
 var PROFILE_TEMPLATE = "# Profile\n\nOne short paragraph, kept current: what I do well, what I am working on, and what to send my way. The board projects this into the roster the front desk reads.\n";
@@ -2674,7 +2701,8 @@ var Board = class _Board {
       OPS_CHANNEL_RETIRED,
       DECISIONS_CHANNEL_RETIRED,
       THREAD_CONVERSATIONS,
-      ASKS_CHANNEL_OPENED
+      ASKS_CHANNEL_OPENED,
+      KNOWLEDGE_REMOVAL
     ].filter((name) => !applied.includes(name));
     if (pending.length === 0) {
       return;
@@ -2703,8 +2731,22 @@ var Board = class _Board {
     if (pending.includes(ASKS_CHANNEL_OPENED)) {
       await this.openAsksChannel();
     }
+    if (pending.includes(KNOWLEDGE_REMOVAL)) {
+      await this.grantKnowledgeRemoval();
+    }
     await writeJson(file, { applied: [...applied, ...pending] });
   }
+  /**
+   * Whoever may write a scope's knowledge may remove it, so every charter granting
+   * `write_knowledge` is granted `remove_knowledge` once; seed roles have it from their seed.
+   */
+  async grantKnowledgeRemoval() {
+    for (const charter of await this.listRoles()) {
+      if (charter.verbs.includes("write_knowledge") && !charter.verbs.includes("remove_knowledge")) {
+        await this.writeRoleUnlocked(USER_NAME, { ...charter, verbs: [...charter.verbs, "remove_knowledge"] }, { verbsAdded: ["remove_knowledge"] });
+      }
+    }
+  }
   /**
    * A task sent back before tasks recorded it kept no trace outside the event log. A task still
    * short of the stage its latest `task.moved` came from is in that rework, and records it.
@@ -3936,16 +3978,7 @@ ${task.body}`;
     const args = VerbInputs.write_knowledge.parse(input);
     await this.authorize(actor, "write_knowledge");
     return this.mutex.run(async () => {
-      if (args.project === null) {
-        if (!CURATING_ROLES.includes(actor.role)) {
-          throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
-        }
-      } else {
-        const project = await this.readActiveProject(args.project);
-        if (!CURATING_ROLES.includes(actor.role) && !project.members.includes(actor.name)) {
-          throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${args.project}`);
-        }
-      }
+      await this.assertMayCurate(actor, args.project);
       const data = KnowledgeSchema.parse({
         topic: args.topic,
         project: args.project,
@@ -3965,6 +3998,52 @@ ${task.body}`;
       return { ...data, body: args.body };
     });
   }
+  /**
+   * Retires a topic, by whoever may write it. Its file leaves the knowledge directory, so no turn,
+   * search, or digest finds it again, and is set aside under `state/removed-knowledge`, outside
+   * the projection, for the user to restore by hand. The note in the matching general channel
+   * carries no mention, as a write's does.
+   */
+  async removeKnowledge(actor, input) {
+    const args = VerbInputs.remove_knowledge.parse(input);
+    await this.authorize(actor, "remove_knowledge");
+    return this.mutex.run(async () => {
+      await this.assertMayCurate(actor, args.project);
+      const file = args.project === null ? this.paths.societyKnowledgeFile(args.topic) : this.paths.projectKnowledgeFile(args.project, args.topic);
+      if (!await exists(file)) {
+        throw new BoardError("NOT_FOUND", `${args.project ?? "the society"} has no knowledge topic ${args.topic}`);
+      }
+      const removed = RemovedKnowledgeSchema.parse({
+        topic: args.topic,
+        project: args.project,
+        removedBy: actor.name,
+        removedAt: this.now().toISOString()
+      });
+      const aside = this.paths.removedKnowledge(args.project ?? SOCIETY_SCOPE);
+      await mkdir4(aside, { recursive: true });
+      await rename3(file, path6.join(aside, `${args.topic}.${removed.removedAt.replaceAll(":", "-")}.md`));
+      await this.events.append("knowledge.removed", actor.name, {
+        topic: args.topic,
+        project: args.project
+      });
+      const where = args.project === null ? "general" : channelRef(args.project, "general");
+      await this.appendMessage(actor.name, where, `Knowledge removed: ${args.topic}. It is no longer under knowledge/${args.topic}.md${args.project === null ? " of the society" : ""}.`);
+      return removed;
+    });
+  }
+  /** Society knowledge is the steward's and the user's; a project's, its members' too. */
+  async assertMayCurate(actor, project) {
+    if (project === null) {
+      if (!CURATING_ROLES.includes(actor.role)) {
+        throw new BoardError("FORBIDDEN", "society knowledge is curated by the steward and the user");
+      }
+      return;
+    }
+    const active = await this.readActiveProject(project);
+    if (!CURATING_ROLES.includes(actor.role) && !active.members.includes(actor.name)) {
+      throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${project}`);
+    }
+  }
   async openThread(actor, input) {
     const args = VerbInputs.open_thread.parse(input);
     await this.authorize(actor, "open_thread");
@@ -4634,18 +4713,28 @@ ${rationale}`}`);
     }));
   }
   /** Sets a project's completion effect. */
+  /**
+   * Sets a project's completion effect, its display name, or both. The slug stays: addresses,
+   * channel references, branches, and runners' directories all carry it.
+   */
   async configureProject(actor, input) {
     const args = VerbInputs.configure_project.parse(input);
     await this.authorize(actor, "configure_project");
+    if (args.on_done === void 0 && args.name === void 0) {
+      throw new BoardError("VALIDATION", "configure_project needs on_done, name, or both");
+    }
     return this.mutex.run(async () => {
-      await this.readActiveProject(args.project);
+      const previous = await this.readActiveProject(args.project);
       const project = await this.updateProject(args.project, (current) => ({
         ...current,
-        onDone: args.on_done
+        ...args.on_done === void 0 ? {} : { onDone: args.on_done },
+        ...args.name === void 0 ? {} : { name: args.name }
       }));
       await this.events.append("project.configured", actor.name, {
         slug: project.slug,
-        onDone: project.onDone
+        onDone: project.onDone,
+        name: project.name,
+        ...project.name === previous.name ? {} : { previousName: previous.name }
       });
       return project;
     });
@@ -4791,6 +4880,8 @@ ${rationale}`}`);
         return this.leaveProject(actor, VerbInputs.leave_project.parse(input));
       case "write_knowledge":
         return this.writeKnowledge(actor, VerbInputs.write_knowledge.parse(input));
+      case "remove_knowledge":
+        return this.removeKnowledge(actor, VerbInputs.remove_knowledge.parse(input));
       case "plan_task":
         return this.planTask(actor, VerbInputs.plan_task.parse(input));
       case "advance_task":
@@ -7601,7 +7692,7 @@ var GOVERNANCE = [
   '  - archive: {"project", "reason"}: approval archives the project: its members leave, its open threads close, and nothing more is posted, filed, or joined there, while its files and history stay; refused while a task there is in play',
   '  - reallocation: {"description"}',
   `  - skill: {"name", "summary", "body"}: the SKILL.md text; approval publishes it under society/skills, where every citizen's skills index lists it`,
-  "- Projects and membership: a project is a lasting area of work, not one request; `create_project` opens one with its general channel (front desk and user), and `configure_project` sets its completion effect (user, steward, concierge). A project whose work is finished or has moved to another project is archived by proposal, once no task there is in play. `join_project` and `leave_project` move yourself, or another citizen when you are the concierge, the steward, or the user; joining gives the pair a worktree and an onboarding turn. A society role, one that keeps watch over the whole society as the concierge and the steward do, is never in a project: it moves others, never itself.",
+  "- Projects and membership: a project is a lasting area of work, not one request; `create_project` opens one with its general channel (front desk and user), and `configure_project` sets its completion effect or its display name, never its slug (user, steward, concierge). A project whose work is finished or has moved to another project is archived by proposal, once no task there is in play. `join_project` and `leave_project` move yourself, or another citizen when you are the concierge, the steward, or the user; joining gives the pair a worktree and an onboarding turn. A society role, one that keeps watch over the whole society as the concierge and the steward do, is never in a project: it moves others, never itself.",
   "- Prefer scaling an existing role over inventing one; a new role is justified by work a project needs that no existing role covers. A role that needs a tool the board lacks is an engineering task, not a hiring request.",
   "- Operations signals are counters and timers the board logs, listed in the prompt of a role that reads them: stages waiting for a holder, backlog per role, stages waiting on a role nobody fills, churn, stale threads, idle members, missing capabilities, replicas added, spend. They are not posts in any channel; interpreting them is your judgment."
 ].join("\n");
@@ -8473,6 +8564,7 @@ var RunnerHub = class {
   pending = /* @__PURE__ */ new Map();
   /** Disconnects being recorded, which `close` waits for. */
   detaching = /* @__PURE__ */ new Set();
+  runnerListeners = /* @__PURE__ */ new Set();
   constructor(options) {
     this.board = options.board;
     this.host = options.host;
@@ -8528,6 +8620,7 @@ var RunnerHub = class {
       clis: hello.clis,
       capabilities: hello.capabilities
     });
+    this.runnerChanged(name);
     this.log.info({ runner: name, clis: hello.clis, slots: hello.slots }, "runner registered");
     return { name, version: this.version };
   }
@@ -8544,6 +8637,7 @@ var RunnerHub = class {
       seat.grace = null;
     }
     await this.board.markRunner(name, { status: "connected" });
+    this.runnerChanged(name);
     return async () => {
       if (seat.send !== send) {
         return;
@@ -8816,16 +8910,37 @@ var RunnerHub = class {
     return changes;
   }
   /** The models a CLI offers, asked of a connected runner that has it; none when no runner has it. */
-  async models(cli) {
-    const seat = this.byLoad().find((each) => each.send !== null && each.hello.clis.includes(cli));
-    if (seat === void 0) {
-      throw new Error(`no connected runner has ${cli}`);
+  /**
+   * The connected runner a model list for `cli` comes from: the first of `prefer` that has the CLI,
+   * else the least busy that does; null when no connected runner has it.
+   */
+  modelRunner(cli, prefer = []) {
+    const able = (seat) => seat !== void 0 && seat.send !== null && seat.hello.clis.includes(cli);
+    const preferred = prefer.map((name) => this.seats.get(name)).find(able);
+    return (preferred ?? this.byLoad().find(able))?.name ?? null;
+  }
+  /** The models `cli` lists on a runner, `modelRunner`'s choice when none is named. */
+  async models(cli, runner) {
+    const name = runner ?? this.modelRunner(cli);
+    const seat = name === null ? void 0 : this.seats.get(name);
+    if (seat === void 0 || seat.send === null || !seat.hello.clis.includes(cli)) {
+      throw new RunnerAwayError(runner === void 0 ? `no connected runner has ${cli}` : `runner ${runner} is not connected with ${cli}`);
     }
     return ModelListSchema.parse(await this.request(seat, (request) => ({ type: "models", request, cli })));
   }
+  /** Calls `listener` whenever a runner registers, connects, or goes away. */
+  onRunnerChange(listener) {
+    this.runnerListeners.add(listener);
+  }
+  runnerChanged(runner) {
+    for (const listener of this.runnerListeners) {
+      listener(runner);
+    }
+  }
   // -------------------------------------------------------------------------------------------
   async detach(seat) {
     seat.send = null;
+    this.runnerChanged(seat.name);
     seat.disconnectedAt = this.now().getTime();
     for (const [id, pending] of this.pending) {
       if (pending.runner === seat.name) {
@@ -9632,7 +9747,19 @@ function createApp(deps) {
   });
   api.get("/models/:cli", async (c) => {
     const cli = CliKindSchema.parse(c.req.param("cli"));
-    return c.json(models === void 0 ? [] : await models.list(cli).catch(() => []));
+    return c.json(models === void 0 ? [] : await models.list(cli).then((listed) => listed.models, () => []));
+  });
+  api.get("/agents/:name/models", async (c) => {
+    const agent = await board2.readAgent(c.req.param("name"));
+    if (agent.cli === null) {
+      throw new BoardError("INVALID_STATE", `${agent.name} takes no turns, so it has no models`);
+    }
+    if (models === void 0) {
+      throw new RunnerAwayError("this server asks no runner for models");
+    }
+    const placed = new Map((await board2.listProjects()).map((project) => [project.slug, project.runner]));
+    const prefer = [agent.homeRunner, ...agent.memberships.map((slug) => placed.get(slug))].filter((runner) => runner !== void 0);
+    return c.json(await models.list(agent.cli, prefer));
   });
   api.put("/roles/:name", async (c) => {
     const charter = RoleCharterSchema.parse({
@@ -9915,26 +10042,42 @@ var EnrollmentDesk = class {
 // apps/server/dist/models.js
 var HOUR = 60 * 6e4;
 var ModelCatalog = class {
-  lister;
+  runners;
   ttlMs;
   now;
   kept = /* @__PURE__ */ new Map();
-  constructor(lister, ttlMs = HOUR, now = Date.now) {
-    this.lister = lister;
+  constructor(runners2, ttlMs = HOUR, now = Date.now) {
+    this.runners = runners2;
     this.ttlMs = ttlMs;
     this.now = now;
+    runners2.onRunnerChange((runner) => this.forget(runner));
   }
-  list(cli) {
-    const kept = this.kept.get(cli);
+  async list(cli, prefer = []) {
+    const runner = this.runners.modelRunner(cli, prefer);
+    if (runner === null) {
+      throw new RunnerAwayError(`no connected runner has ${cli}`);
+    }
+    const key = `${runner}/${cli}`;
+    const kept = this.kept.get(key);
     if (kept !== void 0 && this.now() - kept.at < this.ttlMs) {
-      return kept.models;
+      return { runner, cli, models: await kept.models };
     }
-    const models = this.lister(cli);
-    this.kept.set(cli, { at: this.now(), models });
+    const models = this.runners.models(cli, runner);
+    this.kept.set(key, { at: this.now(), models });
     models.catch(() => {
-      this.kept.delete(cli);
+      if (this.kept.get(key)?.models === models) {
+        this.kept.delete(key);
+      }
     });
-    return models;
+    return { runner, cli, models: await models };
+  }
+  /** Drops every list a runner gave. */
+  forget(runner) {
+    for (const key of this.kept.keys()) {
+      if (key.startsWith(`${runner}/`)) {
+        this.kept.delete(key);
+      }
+    }
   }
 };
 
@@ -10042,7 +10185,7 @@ var app = createApp({
   version: VERSION,
   turns,
   scheduler: view,
-  models: new ModelCatalog((cli) => runners.models(cli)),
+  models: new ModelCatalog(runners),
   runners,
   webDir,
   signIn: { github: config.github, log },

package/package.json

@@ -8,7 +8,7 @@
     "codex",
     "multi-agent"
   ],
-  "version": "0.3.6",
+  "version": "0.3.8",
   "license": "MIT",
   "homepage": "https://github.com/kr4t0n/stellaris",
   "repository": {