@kubitnodes/stellaris 0.3.16 → 0.3.18

package/dist/cli/index.js

@@ -63,7 +63,8 @@ var VERB_NAMES = [
   "update_dashboard",
   "create_cron",
   "update_cron",
-  "remove_cron"
+  "remove_cron",
+  "remove_skill"
 ];
 var VerbNameSchema = z2.enum(VERB_NAMES);
 var CharterTriggerSchema = z2.enum(["user_post", "ops_event", "heartbeat"]);
@@ -123,6 +124,7 @@ var PLANNING_VERBS = [
   "archive_channel"
 ];
 var ARCHIVE_VERBS = ["archive_project"];
+var CURATING_VERBS = ["remove_skill"];
 var SEED_ROLES = [
   {
     name: USER_ROLE,
@@ -132,7 +134,8 @@ var SEED_ROLES = [
       ...GOVERNANCE_VERBS,
       ...FRONT_DESK_VERBS,
       ...PLANNING_VERBS,
-      ...ARCHIVE_VERBS
+      ...ARCHIVE_VERBS,
+      ...CURATING_VERBS
     ],
     wakeTriggers: [],
     maxReplicas: 1,
@@ -144,7 +147,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.",
-    verbs: [...MEMBER_VERBS, ...GOVERNANCE_VERBS, ...PLANNING_VERBS],
+    verbs: [...MEMBER_VERBS, ...GOVERNANCE_VERBS, ...PLANNING_VERBS, ...CURATING_VERBS],
     wakeTriggers: ["ops_event", "heartbeat"],
     maxReplicas: 1,
     backlogThreshold: 3,
@@ -697,6 +700,12 @@ var SkillSchema = z4.object({
   scope: z4.enum(["own", "society"]),
   path: z4.string().min(1)
 });
+var RemovedSkillSchema = z4.object({
+  name: NameSchema,
+  reason: z4.string().min(1),
+  removedBy: NameSchema,
+  removedAt: IsoDateTimeSchema
+});
 var HomeConflictSchema = z4.object({
   /** The copy, relative to the home. */
   path: z4.string().min(1),
@@ -940,7 +949,8 @@ var VerbInputs = {
     timezone: TimeZoneSchema.nullable().optional(),
     at: MomentSchema.optional()
   }),
-  remove_cron: z5.object({ cron_id: UlidSchema, reason: z5.string().trim().min(1) })
+  remove_cron: z5.object({ cron_id: UlidSchema, reason: z5.string().trim().min(1) }),
+  remove_skill: z5.object({ name: NameSchema, reason: z5.string().trim().min(1) })
 };
 
 // packages/shared/dist/events.js
@@ -982,6 +992,7 @@ var BOARD_EVENT_TYPES = [
   "knowledge.removed",
   "dashboard.updated",
   "skill.promoted",
+  "skill.removed",
   "runner.added",
   "user.signed_in",
   "user.signed_out",
@@ -1695,7 +1706,7 @@ var RunnerConfigSchema = z11.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.16";
+var STELLARIS_VERSION = "0.3.18";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -2717,11 +2728,11 @@ var BoardPaths = class {
   agentSkills(name) {
     return path5.join(this.agent(name), "skills");
   }
-  agentSkill(name, skill) {
-    return path5.join(this.agentSkills(name), skill);
+  agentSkill(name, skill2) {
+    return path5.join(this.agentSkills(name), skill2);
   }
-  agentSkillFile(name, skill) {
-    return path5.join(this.agentSkill(name, skill), "SKILL.md");
+  agentSkillFile(name, skill2) {
+    return path5.join(this.agentSkill(name, skill2), "SKILL.md");
   }
   agentProjects(name) {
     return path5.join(this.agent(name), "projects");
@@ -2755,6 +2766,10 @@ var BoardPaths = class {
   removedKnowledge(scope) {
     return path5.join(this.state(), "removed-knowledge", scope);
   }
+  /** Skills removed from the society, set aside outside the projection, one directory per removal. */
+  removedSkills() {
+    return path5.join(this.state(), "removed-skills");
+  }
 };
 
 // packages/board-core/dist/tokens.js
@@ -2874,6 +2889,12 @@ var KNOWLEDGE_REMOVAL = "knowledge-removal-granted";
 var CHANNEL_CONVERSATIONS = "channel-conversations";
 var DASHBOARD_UPDATES = "dashboard-updates-granted";
 var CRON_VERBS = "cron-verbs-granted";
+var KNOWLEDGE_NOTICES = "knowledge-notices";
+var KnowledgeEventSchema = z13.object({
+  topic: NameSchema,
+  project: NameSchema.nullable(),
+  replaced: z13.boolean().optional()
+});
 var CRON_VERB_NAMES = ["create_cron", "update_cron", "remove_cron"];
 var OLD_DASHBOARD_LINE = "Agents may edit this file. It is rendered by the board UI.";
 var DASHBOARD_LINE = "The project's members keep this page current with update_dashboard.";
@@ -3077,7 +3098,8 @@ var Board = class _Board {
       KNOWLEDGE_REMOVAL,
       CHANNEL_CONVERSATIONS,
       DASHBOARD_UPDATES,
-      CRON_VERBS
+      CRON_VERBS,
+      KNOWLEDGE_NOTICES
     ].filter((name) => !applied.includes(name));
     if (pending.length === 0) {
       return;
@@ -3119,8 +3141,49 @@ var Board = class _Board {
     if (pending.includes(CRON_VERBS)) {
       await this.grantToEveryRole(CRON_VERB_NAMES);
     }
+    if (pending.includes(KNOWLEDGE_NOTICES)) {
+      await this.noticeKnowledgeNotes();
+    }
     await writeJson(file, { applied: [...applied, ...pending] });
   }
+  /**
+   * Gives each knowledge note from before notes carried their notice the notice it would carry
+   * now. The event log, not the note's words, says which post is one: a knowledge verb appends
+   * its event and then its note under the mutex, so a note is the post right after such an event,
+   * by the same actor, at the top of the general channel of the topic's place. A post written to
+   * look like a note follows no such event and is left as it is.
+   */
+  async noticeKnowledgeNotes() {
+    let before;
+    for (const event of await this.events.readSince(null, Number.POSITIVE_INFINITY)) {
+      const verb = before;
+      before = event;
+      if (event.type !== "message.posted" || verb === void 0 || verb.actor !== event.actor || verb.type !== "knowledge.written" && verb.type !== "knowledge.removed") {
+        continue;
+      }
+      const knowledge2 = KnowledgeEventSchema.safeParse(verb.payload);
+      const id = UlidSchema.safeParse(event.payload["id"]);
+      if (!knowledge2.success || !id.success || (event.payload["thread"] ?? null) !== null || event.payload["channel"] !== channelRef(knowledge2.data.project, "general")) {
+        continue;
+      }
+      const { topic, project: project2, replaced } = knowledge2.data;
+      const file = this.paths.messageFile(this.paths.channelDir(channelRef(project2, "general")), id.data, event.actor);
+      if (!await exists(file)) {
+        continue;
+      }
+      const { data, body, error } = await readLooseMarkdown(file);
+      if (error !== null || data["notice"] !== void 0) {
+        continue;
+      }
+      const notice = {
+        kind: "knowledge",
+        action: verb.type === "knowledge.removed" ? "removed" : replaced === true ? "updated" : "written",
+        topic,
+        project: project2
+      };
+      await writeMarkdown(file, { ...data, notice }, body);
+    }
+  }
   /**
    * Grants `verb` once to every charter granting `write_knowledge`, the work roles' charters in
    * practice; seed roles have it from their seed.
@@ -4428,11 +4491,11 @@ ${task2.body}`;
         file: path6.join(this.paths.societyKnowledge(), file)
       });
     }
-    for (const skill of await this.listSocietySkills()) {
-      shared.push({ kind: "skill", ref: `society/skills/${skill.name}`, file: skill.path });
+    for (const skill2 of await this.listSocietySkills()) {
+      shared.push({ kind: "skill", ref: `society/skills/${skill2.name}`, file: skill2.path });
     }
-    for (const skill of await this.listAgentSkills(actor.name)) {
-      shared.push({ kind: "skill", ref: `skills/${skill.name}`, file: skill.path });
+    for (const skill2 of await this.listAgentSkills(actor.name)) {
+      shared.push({ kind: "skill", ref: `skills/${skill2.name}`, file: skill2.path });
     }
     for (const file of await listFiles(this.paths.agentMemory(actor.name))) {
       shared.push({
@@ -4535,6 +4598,40 @@ ${task2.body}`;
       throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${project2}`);
     }
   }
+  /**
+   * Takes a skill out of the society's skills, by the steward or the user. Its directory leaves
+   * the projection, so no skills index or search lists it from the next turn, and is set aside
+   * under `state/removed-skills` for the user to restore by hand. The notice is the board's, as a
+   * promotion's is, so a removal by the user wakes no front desk, and quotes the reason without
+   * its mentions. The proposer's own copy in its home is not touched.
+   */
+  async removeSkill(actor, input) {
+    const args = VerbInputs.remove_skill.parse(input);
+    await this.authorize(actor, "remove_skill");
+    if (!CURATING_ROLES.includes(actor.role)) {
+      throw new BoardError("FORBIDDEN", "the society's skills are curated by the steward and the user");
+    }
+    return this.mutex.run(async () => {
+      if (!await exists(this.paths.societySkillFile(args.name))) {
+        throw new BoardError("NOT_FOUND", `the society has no skill ${args.name}`);
+      }
+      const removed = RemovedSkillSchema.parse({
+        name: args.name,
+        reason: args.reason,
+        removedBy: actor.name,
+        removedAt: this.now().toISOString()
+      });
+      const aside = this.paths.removedSkills();
+      await mkdir4(aside, { recursive: true });
+      await rename3(this.paths.societySkill(args.name), path6.join(aside, `${args.name}.${removed.removedAt.replaceAll(":", "-")}`));
+      await this.events.append("skill.removed", actor.name, {
+        name: args.name,
+        reason: args.reason
+      });
+      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${sentence(withoutMentions(args.reason))}. Every citizen's skills index stops listing it from its next turn.`);
+      return removed;
+    });
+  }
   /**
    * Replaces a project's dashboard, by a member or the user. A turn reads the dashboard from the
    * copy of the projection pulled when it started, so a revision other than the current one means
@@ -5757,6 +5854,8 @@ ${rationale}`}`);
         return this.writeKnowledge(actor, VerbInputs.write_knowledge.parse(input));
       case "remove_knowledge":
         return this.removeKnowledge(actor, VerbInputs.remove_knowledge.parse(input));
+      case "remove_skill":
+        return this.removeSkill(actor, VerbInputs.remove_skill.parse(input));
       case "plan_task":
         return this.planTask(actor, VerbInputs.plan_task.parse(input));
       case "advance_task":
@@ -6600,7 +6699,7 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
       ...agent2.model === void 0 ? {} : { model: agent2.model },
       ...lastModel === void 0 ? {} : { lastModel },
       ...agent2.effort === void 0 ? {} : { effort: agent2.effort },
-      skills: (await this.listAgentSkills(name)).map((skill) => skill.name),
+      skills: (await this.listAgentSkills(name)).map((skill2) => skill2.name),
       memberships: agent2.memberships,
       subscriptions: agent2.subscriptions,
       claimsHeld,
@@ -6749,9 +6848,9 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
         return { agent: agent2.name, releasedTasks };
       }
       case "skill": {
-        const skill = SkillProposalSchema.parse(proposal2.charter);
-        const replaced = await this.promoteSkillUnlocked(by, proposal2.proposedBy, skill, meta);
-        return { skill: skill.name, replaced };
+        const skill2 = SkillProposalSchema.parse(proposal2.charter);
+        const replaced = await this.promoteSkillUnlocked(by, proposal2.proposedBy, skill2, meta);
+        return { skill: skill2.name, replaced };
       }
       case "archive": {
         const input = ArchiveProposalSchema.parse(proposal2.charter);
@@ -6765,23 +6864,23 @@ Short, curated, loaded on every turn. Keep entries that change future behavior a
     }
   }
   /** Writes a promoted skill under the society's skills, where every citizen's skills index lists it. */
-  async promoteSkillUnlocked(by, proposedBy, skill, meta) {
-    const file = this.paths.societySkillFile(skill.name);
+  async promoteSkillUnlocked(by, proposedBy, skill2, meta) {
+    const file = this.paths.societySkillFile(skill2.name);
     const replaced = await exists(file);
-    await ensureDir(this.paths.societySkill(skill.name));
+    await ensureDir(this.paths.societySkill(skill2.name));
     await writeMarkdown(file, {
-      name: skill.name,
-      description: skill.summary,
+      name: skill2.name,
+      description: skill2.summary,
       metadata: { proposedBy, promotedBy: by, promotedAt: this.now().toISOString() }
-    }, skill.body);
+    }, skill2.body);
     await this.events.append("skill.promoted", by, {
-      name: skill.name,
-      summary: skill.summary,
+      name: skill2.name,
+      summary: skill2.summary,
       proposedBy,
       replaced,
       ...meta
     });
-    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill.name} ${replaced ? "updated in" : "promoted to"} the society: ${sentence(skill.summary)}. Every citizen's skills index now lists it.`);
+    await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${skill2.name} ${replaced ? "updated in" : "promoted to"} the society: ${sentence(skill2.summary)}. Every citizen's skills index now lists it.`);
     return replaced;
   }
   async validateAddAgent(input) {
@@ -7960,7 +8059,8 @@ knowledge.command("write <topic>").description("Write a knowledge topic as the u
   });
   print(written, () => `Wrote ${written.topic} for ${written.project ?? "the society"}`);
 });
-program.command("skill").description("Skills promoted to the society").command("list").description("List the society's skills, and each member's own").action(async () => {
+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 society = await board.listSocietySkills();
   const own = [];
@@ -7975,6 +8075,14 @@ program.command("skill").description("Skills promoted to the society").command("
     ...own.flatMap(({ agent: name, skills }) => skills.map((s) => `${name}	${s.name}	${s.summary}`))
   ].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 removed = await board.removeSkill(await actorFor(board, opts.as), {
+    name,
+    reason: opts.reason
+  });
+  print(removed, () => `Removed ${removed.name} from the society's skills: ${removed.reason}`);
+});
 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();

package/dist/server/index.js

@@ -63,7 +63,8 @@ var VERB_NAMES = [
   "update_dashboard",
   "create_cron",
   "update_cron",
-  "remove_cron"
+  "remove_cron",
+  "remove_skill"
 ];
 var VerbNameSchema = z2.enum(VERB_NAMES);
 var CharterTriggerSchema = z2.enum(["user_post", "ops_event", "heartbeat"]);
@@ -123,6 +124,7 @@ var PLANNING_VERBS = [
   "archive_channel"
 ];
 var ARCHIVE_VERBS = ["archive_project"];
+var CURATING_VERBS = ["remove_skill"];
 var SEED_ROLES = [
   {
     name: USER_ROLE,
@@ -132,7 +134,8 @@ var SEED_ROLES = [
       ...GOVERNANCE_VERBS,
       ...FRONT_DESK_VERBS,
       ...PLANNING_VERBS,
-      ...ARCHIVE_VERBS
+      ...ARCHIVE_VERBS,
+      ...CURATING_VERBS
     ],
     wakeTriggers: [],
     maxReplicas: 1,
@@ -144,7 +147,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.",
-    verbs: [...MEMBER_VERBS, ...GOVERNANCE_VERBS, ...PLANNING_VERBS],
+    verbs: [...MEMBER_VERBS, ...GOVERNANCE_VERBS, ...PLANNING_VERBS, ...CURATING_VERBS],
     wakeTriggers: ["ops_event", "heartbeat"],
     maxReplicas: 1,
     backlogThreshold: 3,
@@ -712,6 +715,12 @@ var SkillSchema = z4.object({
   scope: z4.enum(["own", "society"]),
   path: z4.string().min(1)
 });
+var RemovedSkillSchema = z4.object({
+  name: NameSchema,
+  reason: z4.string().min(1),
+  removedBy: NameSchema,
+  removedAt: IsoDateTimeSchema
+});
 var HomeConflictSchema = z4.object({
   /** The copy, relative to the home. */
   path: z4.string().min(1),
@@ -955,7 +964,8 @@ var VerbInputs = {
     timezone: TimeZoneSchema.nullable().optional(),
     at: MomentSchema.optional()
   }),
-  remove_cron: z5.object({ cron_id: UlidSchema, reason: z5.string().trim().min(1) })
+  remove_cron: z5.object({ cron_id: UlidSchema, reason: z5.string().trim().min(1) }),
+  remove_skill: z5.object({ name: NameSchema, reason: z5.string().trim().min(1) })
 };
 var VERB_DESCRIPTIONS = {
   post_message: "Post a markdown message to a channel, or into a thread when thread_id is given; a thread's message goes to the thread's channel.",
@@ -987,7 +997,8 @@ var VERB_DESCRIPTIONS = {
   update_dashboard: "Replace the dashboard of a project you are a member of, the status page the user reads on its view, with a whole markdown body. Pass the revision from the frontmatter of the dashboard you read; if it was updated since, the call is refused with the current text to merge yours into. dashboard.md in the board projection is a copy, so editing it changes nothing.",
   create_cron: "Set a cron that wakes you later: a title, a note on what to do then, and either cron, a five-field expression (minute hour day-of-month month day-of-week) read in timezone or the society's, or at, one time. It fires in this turn's conversation unless you name a project, thread_id, or channel, at most every 15 minutes, and every fire is a turn. Only the user, the steward, and the concierge set one that wakes another citizen (agent).",
   update_cron: "Pause or resume a cron, or change its title, note, or schedule; resuming or rescheduling starts it afresh from now. Yours, or anyone's for the user, the steward, and the concierge.",
-  remove_cron: "End a cron for good, with a reason. Yours, or anyone's for the user, the steward, and the concierge. A cron also ends with its conversation, and a one-time cron once it fires."
+  remove_cron: "End a cron for good, with a reason. Yours, or anyone's for the user, the steward, and the concierge. A cron also ends with its conversation, and a one-time cron once it fires.",
+  remove_skill: "Remove a skill from the society's skills, with a reason, when it is wrong, superseded, or no longer used: no skills index lists it from the next turn, and a notice in general says so with the reason. Its proposer's own copy stays in its home. Steward and user only; the board keeps its text aside for the user to restore."
 };
 
 // packages/shared/dist/events.js
@@ -1029,6 +1040,7 @@ var BOARD_EVENT_TYPES = [
   "knowledge.removed",
   "dashboard.updated",
   "skill.promoted",
+  "skill.removed",
   "runner.added",
   "user.signed_in",
   "user.signed_out",
@@ -1822,7 +1834,7 @@ var RunnerConfigSchema = z11.object({
 });
 
 // packages/shared/dist/version.js
-var STELLARIS_VERSION = "0.3.16";
+var STELLARIS_VERSION = "0.3.18";
 
 // packages/board-core/dist/errors.js
 var BoardError = class extends Error {
@@ -2885,6 +2897,10 @@ var BoardPaths = class {
   removedKnowledge(scope) {
     return path5.join(this.state(), "removed-knowledge", scope);
   }
+  /** Skills removed from the society, set aside outside the projection, one directory per removal. */
+  removedSkills() {
+    return path5.join(this.state(), "removed-skills");
+  }
 };
 
 // packages/board-core/dist/tokens.js
@@ -3004,6 +3020,12 @@ var KNOWLEDGE_REMOVAL = "knowledge-removal-granted";
 var CHANNEL_CONVERSATIONS = "channel-conversations";
 var DASHBOARD_UPDATES = "dashboard-updates-granted";
 var CRON_VERBS = "cron-verbs-granted";
+var KNOWLEDGE_NOTICES = "knowledge-notices";
+var KnowledgeEventSchema = z13.object({
+  topic: NameSchema,
+  project: NameSchema.nullable(),
+  replaced: z13.boolean().optional()
+});
 var CRON_VERB_NAMES = ["create_cron", "update_cron", "remove_cron"];
 var OLD_DASHBOARD_LINE = "Agents may edit this file. It is rendered by the board UI.";
 var DASHBOARD_LINE = "The project's members keep this page current with update_dashboard.";
@@ -3207,7 +3229,8 @@ var Board = class _Board {
       KNOWLEDGE_REMOVAL,
       CHANNEL_CONVERSATIONS,
       DASHBOARD_UPDATES,
-      CRON_VERBS
+      CRON_VERBS,
+      KNOWLEDGE_NOTICES
     ].filter((name) => !applied.includes(name));
     if (pending.length === 0) {
       return;
@@ -3249,8 +3272,49 @@ var Board = class _Board {
     if (pending.includes(CRON_VERBS)) {
       await this.grantToEveryRole(CRON_VERB_NAMES);
     }
+    if (pending.includes(KNOWLEDGE_NOTICES)) {
+      await this.noticeKnowledgeNotes();
+    }
     await writeJson(file, { applied: [...applied, ...pending] });
   }
+  /**
+   * Gives each knowledge note from before notes carried their notice the notice it would carry
+   * now. The event log, not the note's words, says which post is one: a knowledge verb appends
+   * its event and then its note under the mutex, so a note is the post right after such an event,
+   * by the same actor, at the top of the general channel of the topic's place. A post written to
+   * look like a note follows no such event and is left as it is.
+   */
+  async noticeKnowledgeNotes() {
+    let before;
+    for (const event of await this.events.readSince(null, Number.POSITIVE_INFINITY)) {
+      const verb = before;
+      before = event;
+      if (event.type !== "message.posted" || verb === void 0 || verb.actor !== event.actor || verb.type !== "knowledge.written" && verb.type !== "knowledge.removed") {
+        continue;
+      }
+      const knowledge = KnowledgeEventSchema.safeParse(verb.payload);
+      const id = UlidSchema.safeParse(event.payload["id"]);
+      if (!knowledge.success || !id.success || (event.payload["thread"] ?? null) !== null || event.payload["channel"] !== channelRef(knowledge.data.project, "general")) {
+        continue;
+      }
+      const { topic, project, replaced } = knowledge.data;
+      const file = this.paths.messageFile(this.paths.channelDir(channelRef(project, "general")), id.data, event.actor);
+      if (!await exists(file)) {
+        continue;
+      }
+      const { data, body, error } = await readLooseMarkdown(file);
+      if (error !== null || data["notice"] !== void 0) {
+        continue;
+      }
+      const notice = {
+        kind: "knowledge",
+        action: verb.type === "knowledge.removed" ? "removed" : replaced === true ? "updated" : "written",
+        topic,
+        project
+      };
+      await writeMarkdown(file, { ...data, notice }, body);
+    }
+  }
   /**
    * Grants `verb` once to every charter granting `write_knowledge`, the work roles' charters in
    * practice; seed roles have it from their seed.
@@ -4665,6 +4729,40 @@ ${task.body}`;
       throw new BoardError("FORBIDDEN", `${actor.name} is not a member of ${project}`);
     }
   }
+  /**
+   * Takes a skill out of the society's skills, by the steward or the user. Its directory leaves
+   * the projection, so no skills index or search lists it from the next turn, and is set aside
+   * under `state/removed-skills` for the user to restore by hand. The notice is the board's, as a
+   * promotion's is, so a removal by the user wakes no front desk, and quotes the reason without
+   * its mentions. The proposer's own copy in its home is not touched.
+   */
+  async removeSkill(actor, input) {
+    const args = VerbInputs.remove_skill.parse(input);
+    await this.authorize(actor, "remove_skill");
+    if (!CURATING_ROLES.includes(actor.role)) {
+      throw new BoardError("FORBIDDEN", "the society's skills are curated by the steward and the user");
+    }
+    return this.mutex.run(async () => {
+      if (!await exists(this.paths.societySkillFile(args.name))) {
+        throw new BoardError("NOT_FOUND", `the society has no skill ${args.name}`);
+      }
+      const removed = RemovedSkillSchema.parse({
+        name: args.name,
+        reason: args.reason,
+        removedBy: actor.name,
+        removedAt: this.now().toISOString()
+      });
+      const aside = this.paths.removedSkills();
+      await mkdir4(aside, { recursive: true });
+      await rename3(this.paths.societySkill(args.name), path6.join(aside, `${args.name}.${removed.removedAt.replaceAll(":", "-")}`));
+      await this.events.append("skill.removed", actor.name, {
+        name: args.name,
+        reason: args.reason
+      });
+      await this.appendMessage(SYSTEM_ACTOR.name, "general", `Skill ${args.name} removed from the society by ${actor.name}: ${sentence(withoutMentions(args.reason))}. Every citizen's skills index stops listing it from its next turn.`);
+      return removed;
+    });
+  }
   /**
    * Replaces a project's dashboard, by a member or the user. A turn reads the dashboard from the
    * copy of the projection pulled when it started, so a revision other than the current one means
@@ -5887,6 +5985,8 @@ ${rationale}`}`);
         return this.writeKnowledge(actor, VerbInputs.write_knowledge.parse(input));
       case "remove_knowledge":
         return this.removeKnowledge(actor, VerbInputs.remove_knowledge.parse(input));
+      case "remove_skill":
+        return this.removeSkill(actor, VerbInputs.remove_skill.parse(input));
       case "plan_task":
         return this.planTask(actor, VerbInputs.plan_task.parse(input));
       case "advance_task":
@@ -9259,7 +9359,7 @@ var GOVERNANCE = [
   '  - retirement: {"agent", "reason"}',
   '  - 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`,
+  '  - skill: {"name", "summary", "body"}: the SKILL.md text; approval publishes it under society/skills, where every citizen\'s skills index lists it until the steward or the user removes it with `remove_skill`; ask the steward to remove one that is wrong or superseded',
   "- 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, its display name, or its default branch, never its slug (user, steward, concierge). A workstream within a project or the society, such as a release, gets a channel of its own: `create_channel` opens it, which its opener follows, and announces it in the place's general, where members subscribe when it concerns them, `create_task` with `channel` files the workstream's tasks there, and `archive_channel` ends it once none of its tasks is in play, leaving its history readable (user, steward, concierge; others propose a channel). 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."

package/package.json

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

package/web/dist/assets/BackLink-DUOMS3fv.js

@@ -0,0 +1 @@
+import{Pt as e,x as t,yn as n}from"./format-CkySAdH1.js";import{D as r,n as i,r as a,t as o,v as s}from"./index-CwkK8XtJ.js";var c=n(),l=`grid size-7 shrink-0 place-items-center rounded-lg text-fg-tertiary hover:bg-surface-2/70 hover:text-fg-primary`;function u({fallback:n}){let u=e(),d=r({select:e=>e.location.state.__TSR_index}),f=a(),p=s(),m=t(),h=i(f,d);if(h===null)return n;let g=o(h,{entity:e=>p.get(e)?.title,project:e=>m.data?.find(t=>t.slug===e)?.name});return(0,c.jsx)(`button`,{type:`button`,onClick:()=>u.history.back(),"aria-label":`Back to ${g}`,title:`Back to ${g}`,className:l,children:`←`})}export{u as t};

package/web/dist/assets/{ChannelForms-mdOuU6eZ.js → ChannelForms-DfG4vYvk.js}

@@ -1 +1 @@
-import{Cn as e,Dn as t,Sn as n,k as r,t as i,wn as a}from"./format-qPQgH1PF.js";import{c as o,l as s,s as c}from"./compose-BCqmtrsZ.js";import{t as l}from"./link-DF__7B1f.js";import{n as u,r as d}from"./ThreadForms-Bciw71n3.js";var f=t(a(),1),p=e();function m({project:e,onDone:t}){let{api:i}=r(),a=n(),l=o(),[m,h]=(0,f.useState)(``),[g,_]=(0,f.useState)(``),v=(0,f.useRef)(null);(0,f.useEffect)(()=>v.current?.focus(),[]);let y=s({mutationFn:()=>i.createChannel({project:e,name:m.trim(),purpose:g.trim()}),onSuccess:async e=>{await a.invalidateQueries({queryKey:[`channels`]}),t(),await l({to:`/c/$`,params:{_splat:e}})}});return(0,p.jsxs)(`form`,{"aria-label":`New channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),y.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`div`,{className:`w-40 shrink-0`,children:(0,p.jsx)(`input`,{ref:v,value:m,maxLength:64,spellCheck:!1,"aria-label":`Channel name`,placeholder:`release-0-4`,onChange:e=>h(e.target.value),className:`${u} font-mono`})}),(0,p.jsx)(`input`,{value:g,"aria-label":`Purpose`,placeholder:`What the channel is for`,onChange:e=>_(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(c,{onClick:t,children:`Cancel`}),(0,p.jsx)(c,{variant:`primary`,type:`submit`,disabled:y.isPending||m.trim()===``||g.trim()===``,children:y.isPending?`Opening…`:`Open`})]}),(0,p.jsx)(`p`,{className:`text-meta`,children:e===null?`Announced in the society's general, and followed by whoever subscribes to it; you read every channel without following one.`:`Announced in ${e}'s general, where its members choose to follow it; you read every channel without following one. Tasks filed in it hang their threads here, and it is archived once its tasks are done.`}),(0,p.jsx)(d,{error:y.error})]})}function h({channel:e,onDone:t}){let{api:i}=r(),a=n(),[o,l]=(0,f.useState)(``),m=s({mutationFn:()=>i.archiveChannel({channel:e,reason:o.trim()}),onSuccess:async()=>{await a.invalidateQueries({queryKey:[`channels`]}),t()}});return(0,p.jsxs)(`form`,{"aria-label":`Archive the channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),m.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`input`,{value:o,"aria-label":`Reason`,placeholder:`Why its work is done`,onChange:e=>l(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(c,{onClick:t,children:`Cancel`}),(0,p.jsx)(c,{variant:`primary`,type:`submit`,disabled:m.isPending||o.trim()===``,children:m.isPending?`Archiving…`:`Archive channel`})]}),(0,p.jsx)(`p`,{className:`text-meta`,children:`Its open threads close, nobody follows it, and nothing more is posted or filed here; its posts, threads, and tasks stay readable. The board refuses while a task filed here is in play.`}),(0,p.jsx)(d,{error:m.error})]})}function g({channels:e,now:t}){return e.length===0?(0,p.jsx)(`p`,{className:`text-meta`,children:`No channels.`}):(0,p.jsx)(`ul`,{className:`space-y-1`,children:e.map(e=>(0,p.jsxs)(`li`,{children:[(0,p.jsxs)(l,{to:`/c/$`,params:{_splat:e.ref},className:`text-sm hover:text-fg-primary ${e.archived===void 0?`text-fg-secondary`:`text-fg-tertiary`}`,children:[`# `,e.name]}),(0,p.jsxs)(`span`,{className:`text-meta`,children:[` `,`· `,e.messages,` messages`,e.archived===void 0?``:` · archived ${i(e.archived.at,t)}`]})]},e.ref))})}export{g as n,m as r,h as t};
+import{Cn as e,bn as t,k as n,t as r,vn as i,yn as a}from"./format-CkySAdH1.js";import{a as o,o as s,s as c}from"./compose-D-SO-HE-.js";import{t as l}from"./link-BN04dcBX.js";import{n as u,r as d}from"./ThreadForms-CXsunS-N.js";var f=e(t(),1),p=a();function m({project:e,onDone:t}){let{api:r}=n(),a=i(),l=s(),[m,h]=(0,f.useState)(``),[g,_]=(0,f.useState)(``),v=(0,f.useRef)(null);(0,f.useEffect)(()=>v.current?.focus(),[]);let y=c({mutationFn:()=>r.createChannel({project:e,name:m.trim(),purpose:g.trim()}),onSuccess:async e=>{await a.invalidateQueries({queryKey:[`channels`]}),t(),await l({to:`/c/$`,params:{_splat:e}})}});return(0,p.jsxs)(`form`,{"aria-label":`New channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),y.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`div`,{className:`w-40 shrink-0`,children:(0,p.jsx)(`input`,{ref:v,value:m,maxLength:64,spellCheck:!1,"aria-label":`Channel name`,placeholder:`release-0-4`,onChange:e=>h(e.target.value),className:`${u} font-mono`})}),(0,p.jsx)(`input`,{value:g,"aria-label":`Purpose`,placeholder:`What the channel is for`,onChange:e=>_(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(o,{onClick:t,children:`Cancel`}),(0,p.jsx)(o,{variant:`primary`,type:`submit`,disabled:y.isPending||m.trim()===``||g.trim()===``,children:y.isPending?`Opening…`:`Open`})]}),(0,p.jsx)(`p`,{className:`text-meta`,children:e===null?`Announced in the society's general, and followed by whoever subscribes to it; you read every channel without following one.`:`Announced in ${e}'s general, where its members choose to follow it; you read every channel without following one. Tasks filed in it hang their threads here, and it is archived once its tasks are done.`}),(0,p.jsx)(d,{error:y.error})]})}function h({channel:e,onDone:t}){let{api:r}=n(),a=i(),[s,l]=(0,f.useState)(``),m=c({mutationFn:()=>r.archiveChannel({channel:e,reason:s.trim()}),onSuccess:async()=>{await a.invalidateQueries({queryKey:[`channels`]}),t()}});return(0,p.jsxs)(`form`,{"aria-label":`Archive the channel`,className:`space-y-2 border-b border-line bg-surface-2/20 p-3`,onSubmit:e=>{e.preventDefault(),m.mutate()},children:[(0,p.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,p.jsx)(`input`,{value:s,"aria-label":`Reason`,placeholder:`Why its work is done`,onChange:e=>l(e.target.value),className:`${u} min-w-0 flex-1`}),(0,p.jsx)(o,{onClick:t,children:`Cancel`}),(0,p.jsx)(o,{variant:`primary`,type:`submit`,disabled:m.isPending||s.trim()===``,children:m.isPending?`Archiving…`:`Archive channel`})]}),(0,p.jsx)(`p`,{className:`text-meta`,children:`Its open threads close, nobody follows it, and nothing more is posted or filed here; its posts, threads, and tasks stay readable. The board refuses while a task filed here is in play.`}),(0,p.jsx)(d,{error:m.error})]})}function g({channels:e,now:t}){return e.length===0?(0,p.jsx)(`p`,{className:`text-meta`,children:`No channels.`}):(0,p.jsx)(`ul`,{className:`space-y-1`,children:e.map(e=>(0,p.jsxs)(`li`,{children:[(0,p.jsxs)(l,{to:`/c/$`,params:{_splat:e.ref},className:`text-sm hover:text-fg-primary ${e.archived===void 0?`text-fg-secondary`:`text-fg-tertiary`}`,children:[`# `,e.name]}),(0,p.jsxs)(`span`,{className:`text-meta`,children:[` `,`· `,e.messages,` messages`,e.archived===void 0?``:` · archived ${r(e.archived.at,t)}`]})]},e.ref))})}export{g as n,m as r,h as t};

package/web/dist/assets/ChannelView-DTLhLXy4.js

@@ -0,0 +1,2 @@
+import{Cn as e,Qt as t,R as n,V as r,_ as i,b as a,bn as o,c as s,k as c,mt as l,t as u,x as d,yn as f}from"./format-CkySAdH1.js";import{a as p}from"./compose-D-SO-HE-.js";import{t as m}from"./link-BN04dcBX.js";import{S as h,i as g,k as _,s as v}from"./index-CwkK8XtJ.js";import{i as y}from"./ThreadForms-CXsunS-N.js";import{t as b}from"./ChannelForms-DfG4vYvk.js";import{t as x}from"./MessageItem-DDs7m3-4.js";import{n as S,t as C}from"./Pane-v044FaP5.js";import{n as w}from"./ThreadCard-BRLvjdz3.js";import{t as T}from"./useStickyScroll-WSVpAMrA.js";var E=e(o(),1);function D(e,t){let n=e.notices.at(-1);return n!==void 0&&n.kind===`knowledge`&&t.kind===`knowledge`&&n.action!==`removed`&&t.action===`updated`&&n.topic===t.topic&&n.project===t.project}function O(e,t){let n=[],r=null;for(let i of e){let e=t(i),a=e?.notice;e===void 0||a===void 0?(n.push({kind:`item`,item:i}),r=null):r!==null&&D(r,a)?(r.messages.push(e),r.notices.push(a)):(r={messages:[e],notices:[a]},n.push({kind:`notices`,run:r}))}return n}function k(e){let[t]=e,n=e.length-1;return t===void 0||t.action===`removed`?{did:`removed`,times:null}:t.action===`written`?{did:`wrote`,times:n===0?null:`then updated it ${n===1?`once`:`${n} times`}`}:{did:`updated`,times:n===0?null:`${e.length} times`}}function A(e){let t=[...new Set(e)];return t.length<=2?t.join(` and `):`${t.slice(0,-1).join(`, `)}, and ${t.at(-1)??``}`}var j=f();function M(){return(0,j.jsx)(`svg`,{viewBox:`0 0 16 16`,"aria-hidden":`true`,className:`size-3.5`,children:(0,j.jsx)(`path`,{d:`M8 4.2C6.4 3 4.4 2.8 2.2 3.4v9.2c2.2-.6 4.2-.4 5.8.8m0-9.2c1.6-1.2 3.6-1.4 5.8-.8v9.2c-2.2-.6-4.2-.4-5.8.8m0-9.2v9.2`,fill:`none`,stroke:`currentColor`,strokeWidth:`1.2`,strokeLinejoin:`round`})})}function N({notices:e}){let[t]=e;if(t===void 0)return null;let{did:n,times:r}=k(e);return(0,j.jsxs)(j.Fragment,{children:[n,` knowledge`,` `,t.action===`removed`?(0,j.jsx)(`span`,{className:`text-fg-secondary`,children:t.topic}):(0,j.jsx)(m,{to:`/knowledge/$scope/$topic`,params:{scope:t.project??`society`,topic:t.topic},className:`text-fg-secondary hover:text-fg-primary`,children:t.topic}),r===null?null:` · ${r}`]})}function P(e){let t=e.notices.filter(e=>e.kind===`knowledge`);return{mark:(0,j.jsx)(M,{}),text:(0,j.jsx)(N,{notices:t})}}function F({run:e,now:t}){let n=v(),r=e.messages.at(-1);if(r===void 0)return null;let{mark:i,text:a}=P(e);return(0,j.jsxs)(`div`,{className:`flex items-center gap-3 px-4 py-1 text-meta`,children:[(0,j.jsx)(`span`,{className:`grid w-7 shrink-0 place-items-center text-fg-muted`,children:i}),(0,j.jsxs)(`p`,{className:`min-w-0 flex-1 truncate`,children:[A(e.messages.map(e=>n(e.author))),` `,a]}),(0,j.jsx)(`time`,{dateTime:r.ts,title:e.messages.map(e=>`${n(e.author)} ${e.ts}`).join(`
+`),className:`shrink-0`,children:u(r.ts,t)})]})}function I(){let{_splat:e=`general`}=_({from:`/c/$`});return(0,j.jsx)(L,{channel:e},e)}function L({channel:e}){let{api:o}=c(),f=t({queryKey:[`channel`,e],queryFn:()=>o.channel(e)}),m=n(),_=i(),v=d(),D=s(),k=a(3e4),[A,M]=(0,E.useState)(!1),[N,P]=(0,E.useState)(!1),I=(0,E.useMemo)(()=>{let t=(f.data??[]).map(e=>({kind:`message`,at:e.ts,id:e.id,message:e})),n=(m.data??[]).filter(t=>t.channel===e).map(e=>({kind:`thread`,at:e.openedAt,id:e.id,thread:e}));return[...t,...n].toSorted((e,t)=>e.at.localeCompare(t.at)||e.id.localeCompare(t.id))},[f.data,m.data,e]),L=(0,E.useMemo)(()=>O(I,e=>e.kind===`message`?e.message:void 0),[I]),R=f.data?.at(-1)?.id??null;(0,E.useEffect)(()=>h(e,R),[e,R]);let{ref:z,onScroll:B}=T(),[V,H]=e.split(`/`),U=H??V??e,W=H===void 0?void 0:v.data?.find(e=>e.slug===V),G=H===void 0?`society`:W?.name??V,K=D.data?.find(t=>t.ref===e)?.archived,q=W?.archived!==void 0||K!==void 0,J=!q&&!l(H===void 0?null:V??null,U),Y=I.filter(e=>e.kind===`thread`&&e.thread.state===`open`);return(0,j.jsxs)(j.Fragment,{children:[(0,j.jsx)(C,{title:`# ${U}`,subtitle:`${G} · ${f.data?.length??0} messages${Y.length>0?` · ${Y.length} open threads`:``}`,trailing:A||N||q?null:(0,j.jsxs)(j.Fragment,{children:[J?(0,j.jsx)(p,{onClick:()=>P(!0),children:`Archive…`}):null,(0,j.jsx)(p,{onClick:()=>M(!0),children:`New thread`})]})}),A?(0,j.jsx)(y,{channel:e,onDone:()=>M(!1)}):null,N?(0,j.jsx)(b,{channel:e,onDone:()=>P(!1)}):null,(0,j.jsx)(`div`,{ref:z,onScroll:B,className:`flex-1 overflow-y-auto py-2`,children:f.error instanceof r&&f.error.status===404?(0,j.jsxs)(S,{children:[`There is no channel `,e,`.`]}):f.data===void 0?(0,j.jsx)(S,{children:`Reading the channel…`}):I.length===0?(0,j.jsx)(S,{children:`Nothing has been said here yet.`}):L.map(e=>{if(e.kind===`notices`){let t=e.run.messages[0]?.id??``;return(0,j.jsx)(F,{run:e.run,now:k},t)}let{item:t}=e;return t.kind===`message`?(0,j.jsx)(x,{message:t.message,members:_.data,now:k},t.id):(0,j.jsx)(w,{thread:t.thread,now:k},t.id)})}),f.data===void 0?null:K===void 0?q?(0,j.jsxs)(`p`,{className:`border-t border-line px-4 py-3 text-meta`,children:[G,` is archived, so its channels are read-only.`]}):(0,j.jsx)(g,{target:{channel:e},placeholder:`Message #${U}`}):(0,j.jsxs)(`p`,{className:`border-t border-line px-4 py-3 text-meta`,children:[`Archived `,u(K.at,k),` by `,K.by,`: `,K.reason,`. Its posts, threads, and tasks stay readable; nothing more is posted or filed here.`]})]})}export{I as ChannelView};