@rolexjs/core 1.4.0-dev-20260305032702 → 1.4.0-dev-20260305092016

package/dist/index.js

@@ -3,10 +3,10 @@ import {
   create as create5,
   createRuntime,
   link as link3,
-  process as process7,
+  process as process6,
   relation as relation2,
   remove,
-  structure as structure2,
+  structure as structure3,
   transform as transform4,
   unlink as unlink3
 } from "@rolexjs/system";
@@ -55,6 +55,11 @@ var wiki = structure("wiki", "Project-level knowledge base entry", project);
 
 // src/execution.ts
 import { create, process, transform } from "@rolexjs/system";
+var activate = process(
+  "activate",
+  "Activate a role \u2014 load cognition into context",
+  individual
+);
 var want = process("want", "Declare a goal", individual, create(goal));
 var planGoal = process("plan", "Create a plan for a goal", goal, create(plan));
 var todo = process("todo", "Create a task in a plan", plan, create(task));
@@ -204,17 +209,2402 @@ var rehire = process5(
   transform3(past, individual)
 );
 
-// src/role.ts
-import { process as process6 } from "@rolexjs/system";
-var activate = process6(
+// src/role-model.ts
+var Role = class {
+  id;
+  focusedGoalId = null;
+  focusedPlanId = null;
+  encounterIds = /* @__PURE__ */ new Set();
+  experienceIds = /* @__PURE__ */ new Set();
+  /** Set of all node ids under this individual — for ownership validation. */
+  nodeIds = /* @__PURE__ */ new Set();
+  deps;
+  constructor(id, deps) {
+    this.id = id;
+    this.deps = deps;
+  }
+  // ================================================================
+  //  State projection — populated at activate time
+  // ================================================================
+  /** Populate from state projection. Builds nodeIds set + cognitive registries. */
+  hydrate(state) {
+    this.nodeIds.clear();
+    this.encounterIds.clear();
+    this.experienceIds.clear();
+    this.focusedGoalId = null;
+    this.walkState(state);
+  }
+  walkState(node) {
+    if (node.id) {
+      this.nodeIds.add(node.id);
+      switch (node.name) {
+        case "goal":
+          if (!this.focusedGoalId) this.focusedGoalId = node.id;
+          break;
+        case "encounter":
+          this.encounterIds.add(node.id);
+          break;
+        case "experience":
+          this.experienceIds.add(node.id);
+          break;
+      }
+    }
+    for (const child of node.children ?? []) {
+      this.walkState(child);
+    }
+  }
+  // ================================================================
+  //  Ownership validation
+  // ================================================================
+  hasNode(id) {
+    return this.nodeIds.has(id);
+  }
+  requireOwnership(id, label) {
+    if (!this.hasNode(id)) {
+      throw new Error(`${label} "${id}" does not belong to individual "${this.id}".`);
+    }
+  }
+  // ================================================================
+  //  Cursor requirements
+  // ================================================================
+  requireGoalId() {
+    if (!this.focusedGoalId) throw new Error("No focused goal. Call want first.");
+    return this.focusedGoalId;
+  }
+  requirePlanId() {
+    if (!this.focusedPlanId) throw new Error("No focused plan. Call plan first.");
+    return this.focusedPlanId;
+  }
+  // ================================================================
+  //  Rendering
+  // ================================================================
+  fmt(command, result) {
+    const rendered = this.deps.renderer.render(command, result);
+    const process7 = command.includes(".") ? command.slice(command.indexOf(".") + 1) : command;
+    const ch = this.cognitiveHint(process7);
+    if (!ch) return rendered;
+    const lines = rendered.split("\n");
+    lines.splice(2, 0, `I \u2192 ${ch}`);
+    return lines.join("\n");
+  }
+  // ================================================================
+  //  Persistence
+  // ================================================================
+  async save() {
+    await this.deps.onSave(this.snapshot());
+  }
+  /** Serialize to KV-compatible snapshot. */
+  snapshot() {
+    return {
+      id: this.id,
+      focusedGoalId: this.focusedGoalId,
+      focusedPlanId: this.focusedPlanId,
+      encounterIds: [...this.encounterIds],
+      experienceIds: [...this.experienceIds]
+    };
+  }
+  /** Restore cursors and cognitive state from a snapshot. */
+  restore(snap) {
+    this.focusedGoalId = snap.focusedGoalId;
+    this.focusedPlanId = snap.focusedPlanId;
+    this.encounterIds.clear();
+    for (const id of snap.encounterIds) this.encounterIds.add(id);
+    this.experienceIds.clear();
+    for (const id of snap.experienceIds) this.experienceIds.add(id);
+  }
+  // ================================================================
+  //  Execution — focus, want, plan, todo, finish, complete, abandon
+  // ================================================================
+  /** Project the individual's state tree (used after activate). */
+  async project() {
+    const result = await this.deps.commands["role.focus"](this.id);
+    return this.fmt("role.activate", result);
+  }
+  /** Focus: view or switch focused goal. Validates ownership. */
+  async focus(goal2) {
+    const goalId = goal2 ?? this.requireGoalId();
+    if (goal2) {
+      this.requireOwnership(goalId, "Goal");
+    }
+    const result = await this.deps.commands["role.focus"](goalId);
+    if (result.state.name !== "goal") {
+      throw new Error(
+        `"${goalId}" is a ${result.state.name}, not a goal. focus only accepts goal ids.`
+      );
+    }
+    const switched = goalId !== this.focusedGoalId;
+    this.focusedGoalId = goalId;
+    if (switched) this.focusedPlanId = null;
+    await this.save();
+    return this.fmt("role.focus", result);
+  }
+  /** Want: declare a goal under this individual. */
+  async want(goal2, id, alias) {
+    const result = await this.deps.commands["role.want"](this.id, goal2, id, alias);
+    const newId = id ?? result.state.id;
+    if (newId) {
+      this.nodeIds.add(newId);
+      this.focusedGoalId = newId;
+    }
+    this.focusedPlanId = null;
+    await this.save();
+    return this.fmt("role.want", result);
+  }
+  /** Plan: create a plan for the focused goal. */
+  async plan(plan2, id, after, fallback) {
+    const result = await this.deps.commands["role.plan"](
+      this.requireGoalId(),
+      plan2,
+      id,
+      after,
+      fallback
+    );
+    const newId = id ?? result.state.id;
+    if (newId) {
+      this.nodeIds.add(newId);
+      this.focusedPlanId = newId;
+    }
+    await this.save();
+    return this.fmt("role.plan", result);
+  }
+  /** Todo: add a task to the focused plan. */
+  async todo(task2, id, alias) {
+    const result = await this.deps.commands["role.todo"](this.requirePlanId(), task2, id, alias);
+    const newId = id ?? result.state.id;
+    if (newId) this.nodeIds.add(newId);
+    return this.fmt("role.todo", result);
+  }
+  /** Finish: complete a task, optionally record an encounter. */
+  async finish(task2, encounter2) {
+    this.requireOwnership(task2, "Task");
+    const result = await this.deps.commands["role.finish"](task2, this.id, encounter2);
+    if (encounter2 && result.state.id) {
+      this.encounterIds.add(result.state.id);
+      this.nodeIds.add(result.state.id);
+    }
+    return this.fmt("role.finish", result);
+  }
+  /** Complete: close a plan as done, record encounter. */
+  async complete(plan2, encounter2) {
+    const planId = plan2 ?? this.requirePlanId();
+    this.requireOwnership(planId, "Plan");
+    const result = await this.deps.commands["role.complete"](planId, this.id, encounter2);
+    const encId = result.state.id ?? planId;
+    this.encounterIds.add(encId);
+    this.nodeIds.add(encId);
+    if (this.focusedPlanId === planId) this.focusedPlanId = null;
+    await this.save();
+    return this.fmt("role.complete", result);
+  }
+  /** Abandon: drop a plan, record encounter. */
+  async abandon(plan2, encounter2) {
+    const planId = plan2 ?? this.requirePlanId();
+    this.requireOwnership(planId, "Plan");
+    const result = await this.deps.commands["role.abandon"](planId, this.id, encounter2);
+    const encId = result.state.id ?? planId;
+    this.encounterIds.add(encId);
+    this.nodeIds.add(encId);
+    if (this.focusedPlanId === planId) this.focusedPlanId = null;
+    await this.save();
+    return this.fmt("role.abandon", result);
+  }
+  // ================================================================
+  //  Cognition — reflect, realize, master
+  // ================================================================
+  /** Reflect: consume encounters → experience. */
+  async reflect(encounters, experience2, id) {
+    if (encounters.length > 0) {
+      for (const enc of encounters) {
+        if (!this.encounterIds.has(enc)) throw new Error(`Encounter not found: "${enc}"`);
+      }
+    }
+    const first = encounters[0];
+    const result = await this.deps.commands["role.reflect"](first, this.id, experience2, id);
+    for (let i = 1; i < encounters.length; i++) {
+      await this.deps.commands["role.forget"](encounters[i]);
+    }
+    if (encounters.length > 0) {
+      for (const enc of encounters) this.encounterIds.delete(enc);
+    }
+    const newId = id ?? result.state.id;
+    if (newId) {
+      this.experienceIds.add(newId);
+      this.nodeIds.add(newId);
+    }
+    return this.fmt("role.reflect", result);
+  }
+  /** Realize: consume experiences → principle. */
+  async realize(experiences, principle2, id) {
+    if (experiences.length > 0) {
+      for (const exp of experiences) {
+        if (!this.experienceIds.has(exp)) throw new Error(`Experience not found: "${exp}"`);
+      }
+    }
+    const first = experiences[0];
+    const result = await this.deps.commands["role.realize"](first, this.id, principle2, id);
+    for (let i = 1; i < experiences.length; i++) {
+      await this.deps.commands["role.forget"](experiences[i]);
+    }
+    if (experiences.length > 0) {
+      for (const exp of experiences) this.experienceIds.delete(exp);
+    }
+    const newId = id ?? result.state.id;
+    if (newId) this.nodeIds.add(newId);
+    return this.fmt("role.realize", result);
+  }
+  /** Master: create procedure, optionally consuming experiences. */
+  async master(procedure2, id, experiences) {
+    if (experiences && experiences.length > 0) {
+      for (const exp of experiences) {
+        if (!this.experienceIds.has(exp)) throw new Error(`Experience not found: "${exp}"`);
+      }
+    }
+    const first = experiences?.[0];
+    const result = await this.deps.commands["role.master"](this.id, procedure2, id, first);
+    if (experiences) {
+      for (let i = 1; i < experiences.length; i++) {
+        await this.deps.commands["role.forget"](experiences[i]);
+      }
+      for (const exp of experiences) this.experienceIds.delete(exp);
+    }
+    const newId = id ?? result.state.id;
+    if (newId) this.nodeIds.add(newId);
+    return this.fmt("role.master", result);
+  }
+  // ================================================================
+  //  Knowledge management
+  // ================================================================
+  /** Forget: remove any node under this individual by id. */
+  async forget(nodeId) {
+    this.requireOwnership(nodeId, "Node");
+    const result = await this.deps.commands["role.forget"](nodeId);
+    this.nodeIds.delete(nodeId);
+    if (this.focusedGoalId === nodeId) this.focusedGoalId = null;
+    if (this.focusedPlanId === nodeId) this.focusedPlanId = null;
+    this.encounterIds.delete(nodeId);
+    this.experienceIds.delete(nodeId);
+    await this.save();
+    return this.fmt("role.forget", result);
+  }
+  // ================================================================
+  //  Skills
+  // ================================================================
+  /** Skill: load full skill content by locator. */
+  async skill(locator) {
+    return await this.deps.commands["role.skill"](locator);
+  }
+  // ================================================================
+  //  Use — subjective execution
+  // ================================================================
+  /** Use: subjective execution — `!ns.method` or ResourceX locator. */
+  async use(locator, args) {
+    if (!this.deps.direct) {
+      throw new Error("Direct execution is not available on this Role instance.");
+    }
+    const result = await this.deps.direct(locator, args);
+    if (this.deps.transformUseResult) {
+      return this.deps.transformUseResult(locator, result);
+    }
+    return result;
+  }
+  // ================================================================
+  //  Cognitive hints
+  // ================================================================
+  cognitiveHint(process7) {
+    switch (process7) {
+      case "activate":
+        if (!this.focusedGoalId)
+          return "I have no goal yet. I should call `want` to declare one, or `focus` to review existing goals.";
+        return "I have an active goal. I should call `focus` to review progress, or `want` to declare a new goal.";
+      case "focus":
+        if (!this.focusedPlanId)
+          return "I have a goal but no focused plan. I should call `plan` to create or focus on one.";
+        return "I have a plan. I should call `todo` to create tasks, or continue working.";
+      case "want":
+        return "Goal declared. I should call `plan` to design how to achieve it.";
+      case "plan":
+        return "Plan created. I should call `todo` to create concrete tasks.";
+      case "todo":
+        return "Task created. I can add more with `todo`, or start working and call `finish` when done.";
+      case "finish": {
+        const encCount = this.encounterIds.size;
+        if (encCount > 0 && !this.focusedGoalId)
+          return `Task finished. No more goals \u2014 I have ${encCount} encounter(s) to choose from for \`reflect\`, or \`want\` a new goal.`;
+        return "Task finished. I should continue with remaining tasks, or call `complete` when the plan is done.";
+      }
+      case "complete":
+      case "abandon": {
+        const encCount = this.encounterIds.size;
+        const goalNote = this.focusedGoalId ? ` I should check if goal "${this.focusedGoalId}" needs a new \`plan\`, or \`forget\` it if the direction is fulfilled.` : "";
+        if (encCount > 0)
+          return `Plan closed.${goalNote} I have ${encCount} encounter(s) to choose from for \`reflect\`, or I can continue with other plans.`;
+        return `Plan closed.${goalNote} I can create a new \`plan\`, or \`focus\` on another goal.`;
+      }
+      case "reflect": {
+        const expCount = this.experienceIds.size;
+        if (expCount > 0)
+          return `Experience gained. I can \`realize\` principles or \`master\` procedures \u2014 ${expCount} experience(s) available.`;
+        return "Experience gained. I can `realize` a principle, `master` a procedure, or continue working.";
+      }
+      case "realize":
+        return "Principle added. I should continue working.";
+      case "master":
+        return "Procedure added. I should continue working.";
+      default:
+        return null;
+    }
+  }
+};
+
+// src/rolex-service.ts
+import { createIssueX } from "issuexjs";
+import { createResourceX, setProvider } from "resourcexjs";
+
+// src/apply.ts
+async function applyPrototype(data, repo, direct) {
+  const sorted = [...data.migrations].sort((a, b) => a.version - b.version);
+  let applied = 0;
+  let skipped = 0;
+  for (const migration of sorted) {
+    if (await repo.hasMigration(data.id, migration.id)) {
+      skipped++;
+      continue;
+    }
+    for (const instr of migration.instructions) {
+      await direct(instr.op, instr.args);
+    }
+    await repo.recordMigration(data.id, migration.id, migration.version, migration.checksum);
+    applied++;
+  }
+  await repo.settle(data.id, data.source);
+  return {
+    prototypeId: data.id,
+    applied,
+    skipped,
+    upToDate: applied === 0
+  };
+}
+
+// src/commands.ts
+import { parse } from "@rolexjs/parser";
+import { structure as structure2 } from "@rolexjs/system";
+function createCommands(ctx) {
+  const { rt, society: society2, past: past2, resolve, resourcex, issuex } = ctx;
+  async function ok(node, process7) {
+    return { state: await rt.project(node), process: process7 };
+  }
+  async function archive2(node, process7) {
+    const target = structure2(node.name, node.description ?? "", past);
+    const archived = await rt.transform(node, target);
+    return ok(archived, process7);
+  }
+  function validateGherkin(source) {
+    if (!source) return;
+    try {
+      parse(source);
+    } catch (e) {
+      throw new Error(`Invalid Gherkin: ${e.message}`);
+    }
+  }
+  function findInState2(state, target) {
+    if (state.id && state.id.toLowerCase() === target) return state;
+    if (state.alias) {
+      for (const a of state.alias) {
+        if (a.toLowerCase() === target) return state;
+      }
+    }
+    for (const child of state.children ?? []) {
+      const found2 = findInState2(child, target);
+      if (found2) return found2;
+    }
+    return null;
+  }
+  async function removeExisting(parent, id) {
+    const state = await rt.project(parent);
+    const existing = findInState2(state, id);
+    if (existing) await rt.remove(existing);
+  }
+  function requireResourceX() {
+    if (!resourcex) throw new Error("ResourceX is not available.");
+    return resourcex;
+  }
+  function requireIssueX() {
+    if (!issuex) throw new Error("IssueX is not available.");
+    return issuex;
+  }
+  return {
+    // ---- Individual: lifecycle ----
+    async "individual.born"(content, id, alias) {
+      validateGherkin(content);
+      const node = await rt.create(society2, individual, content, id, alias);
+      await rt.create(node, identity, void 0, `${id}-identity`);
+      return ok(node, "born");
+    },
+    async "individual.retire"(individual2) {
+      return archive2(await resolve(individual2), "retire");
+    },
+    async "individual.die"(individual2) {
+      return archive2(await resolve(individual2), "die");
+    },
+    async "individual.rehire"(pastNode) {
+      const node = await resolve(pastNode);
+      const ind = await rt.transform(node, individual);
+      return ok(ind, "rehire");
+    },
+    // ---- Individual: external injection ----
+    async "individual.teach"(individual2, principle2, id) {
+      validateGherkin(principle2);
+      const parent = await resolve(individual2);
+      if (id) await removeExisting(parent, id);
+      const node = await rt.create(parent, principle, principle2, id);
+      return ok(node, "teach");
+    },
+    async "individual.train"(individual2, procedure2, id) {
+      validateGherkin(procedure2);
+      const parent = await resolve(individual2);
+      if (id) await removeExisting(parent, id);
+      const node = await rt.create(parent, procedure, procedure2, id);
+      return ok(node, "train");
+    },
+    // ---- Role: focus ----
+    async "role.focus"(goal2) {
+      return ok(await resolve(goal2), "focus");
+    },
+    // ---- Role: execution ----
+    async "role.want"(individual2, goal2, id, alias) {
+      validateGherkin(goal2);
+      const node = await rt.create(await resolve(individual2), goal, goal2, id, alias);
+      return ok(node, "want");
+    },
+    async "role.plan"(goal2, plan2, id, after, fallback) {
+      validateGherkin(plan2);
+      const node = await rt.create(await resolve(goal2), plan, plan2, id);
+      if (after) await rt.link(node, await resolve(after), "after", "before");
+      if (fallback) await rt.link(node, await resolve(fallback), "fallback-for", "fallback");
+      return ok(node, "plan");
+    },
+    async "role.todo"(plan2, task2, id, alias) {
+      validateGherkin(task2);
+      const node = await rt.create(await resolve(plan2), task, task2, id, alias);
+      return ok(node, "todo");
+    },
+    async "role.finish"(task2, individual2, encounter2) {
+      validateGherkin(encounter2);
+      const taskNode = await resolve(task2);
+      await rt.tag(taskNode, "done");
+      if (encounter2) {
+        const encId = taskNode.id ? `${taskNode.id}-finished` : void 0;
+        const enc = await rt.create(await resolve(individual2), encounter, encounter2, encId);
+        return ok(enc, "finish");
+      }
+      return ok(taskNode, "finish");
+    },
+    async "role.complete"(plan2, individual2, encounter2) {
+      validateGherkin(encounter2);
+      const planNode = await resolve(plan2);
+      await rt.tag(planNode, "done");
+      const encId = planNode.id ? `${planNode.id}-completed` : void 0;
+      const enc = await rt.create(await resolve(individual2), encounter, encounter2, encId);
+      return ok(enc, "complete");
+    },
+    async "role.abandon"(plan2, individual2, encounter2) {
+      validateGherkin(encounter2);
+      const planNode = await resolve(plan2);
+      await rt.tag(planNode, "abandoned");
+      const encId = planNode.id ? `${planNode.id}-abandoned` : void 0;
+      const enc = await rt.create(await resolve(individual2), encounter, encounter2, encId);
+      return ok(enc, "abandon");
+    },
+    // ---- Role: cognition ----
+    async "role.reflect"(encounter2, individual2, experience2, id) {
+      validateGherkin(experience2);
+      if (encounter2) {
+        const encNode = await resolve(encounter2);
+        const exp2 = await rt.create(
+          await resolve(individual2),
+          experience,
+          experience2 || encNode.information,
+          id
+        );
+        await rt.remove(encNode);
+        return ok(exp2, "reflect");
+      }
+      const exp = await rt.create(await resolve(individual2), experience, experience2, id);
+      return ok(exp, "reflect");
+    },
+    async "role.realize"(experience2, individual2, principle2, id) {
+      validateGherkin(principle2);
+      if (experience2) {
+        const expNode = await resolve(experience2);
+        const prin2 = await rt.create(
+          await resolve(individual2),
+          principle,
+          principle2 || expNode.information,
+          id
+        );
+        await rt.remove(expNode);
+        return ok(prin2, "realize");
+      }
+      const prin = await rt.create(await resolve(individual2), principle, principle2, id);
+      return ok(prin, "realize");
+    },
+    async "role.master"(individual2, procedure2, id, experience2) {
+      validateGherkin(procedure2);
+      const parent = await resolve(individual2);
+      if (id) await removeExisting(parent, id);
+      const proc = await rt.create(parent, procedure, procedure2, id);
+      if (experience2) await rt.remove(await resolve(experience2));
+      return ok(proc, "master");
+    },
+    // ---- Role: knowledge management ----
+    async "role.forget"(nodeId) {
+      const node = await resolve(nodeId);
+      await rt.remove(node);
+      return { state: { ...node, children: [] }, process: "forget" };
+    },
+    // ---- Role: skill ----
+    async "role.skill"(locator) {
+      const rx = requireResourceX();
+      const content = await rx.ingest(locator);
+      const text = typeof content === "string" ? content : JSON.stringify(content, null, 2);
+      try {
+        const rxm = await rx.info(locator);
+        return `${formatRXM(rxm)}
+
+${text}`;
+      } catch {
+        return text;
+      }
+    },
+    // ---- Project ----
+    async "project.launch"(content, id, alias, org) {
+      validateGherkin(content);
+      const node = await rt.create(society2, project, content, id, alias);
+      if (org) await rt.link(node, await resolve(org), "ownership", "project");
+      return ok(node, "launch");
+    },
+    async "project.scope"(project2, scope2, id) {
+      validateGherkin(scope2);
+      const node = await rt.create(await resolve(project2), scope, scope2, id);
+      return ok(node, "scope");
+    },
+    async "project.milestone"(project2, milestone2, id) {
+      validateGherkin(milestone2);
+      const node = await rt.create(await resolve(project2), milestone, milestone2, id);
+      return ok(node, "milestone");
+    },
+    async "project.achieve"(milestone2) {
+      const node = await resolve(milestone2);
+      await rt.tag(node, "done");
+      return ok(node, "achieve");
+    },
+    async "project.enroll"(project2, individual2) {
+      const projNode = await resolve(project2);
+      await rt.link(projNode, await resolve(individual2), "participation", "participate");
+      return ok(projNode, "enroll");
+    },
+    async "project.remove"(project2, individual2) {
+      const projNode = await resolve(project2);
+      await rt.unlink(projNode, await resolve(individual2), "participation", "participate");
+      return ok(projNode, "remove");
+    },
+    async "project.deliver"(project2, deliverable2, id) {
+      validateGherkin(deliverable2);
+      const node = await rt.create(await resolve(project2), deliverable, deliverable2, id);
+      return ok(node, "deliver");
+    },
+    async "project.wiki"(project2, wiki2, id) {
+      validateGherkin(wiki2);
+      const node = await rt.create(await resolve(project2), wiki, wiki2, id);
+      return ok(node, "wiki");
+    },
+    async "project.archive"(project2) {
+      return archive2(await resolve(project2), "archive");
+    },
+    // ---- Org ----
+    async "org.found"(content, id, alias) {
+      validateGherkin(content);
+      const node = await rt.create(society2, organization, content, id, alias);
+      return ok(node, "found");
+    },
+    async "org.charter"(org, charter2, id) {
+      validateGherkin(charter2);
+      const node = await rt.create(await resolve(org), charter, charter2, id);
+      return ok(node, "charter");
+    },
+    async "org.dissolve"(org) {
+      return archive2(await resolve(org), "dissolve");
+    },
+    async "org.hire"(org, individual2) {
+      const orgNode = await resolve(org);
+      await rt.link(orgNode, await resolve(individual2), "membership", "belong");
+      return ok(orgNode, "hire");
+    },
+    async "org.fire"(org, individual2) {
+      const orgNode = await resolve(org);
+      await rt.unlink(orgNode, await resolve(individual2), "membership", "belong");
+      return ok(orgNode, "fire");
+    },
+    // ---- Position ----
+    async "position.establish"(content, id, alias) {
+      validateGherkin(content);
+      const node = await rt.create(society2, position, content, id, alias);
+      return ok(node, "establish");
+    },
+    async "position.charge"(position2, duty2, id) {
+      validateGherkin(duty2);
+      const node = await rt.create(await resolve(position2), duty, duty2, id);
+      return ok(node, "charge");
+    },
+    async "position.require"(position2, procedure2, id) {
+      validateGherkin(procedure2);
+      const parent = await resolve(position2);
+      if (id) await removeExisting(parent, id);
+      const node = await rt.create(parent, requirement, procedure2, id);
+      return ok(node, "require");
+    },
+    async "position.abolish"(position2) {
+      return archive2(await resolve(position2), "abolish");
+    },
+    async "position.appoint"(position2, individual2) {
+      const posNode = await resolve(position2);
+      const indNode = await resolve(individual2);
+      await rt.link(posNode, indNode, "appointment", "serve");
+      const posState = await rt.project(posNode);
+      for (const child of posState.children ?? []) {
+        if (child.name !== "requirement" || !child.information) continue;
+        await rt.create(indNode, procedure, child.information, child.id);
+      }
+      return ok(posNode, "appoint");
+    },
+    async "position.dismiss"(position2, individual2) {
+      const posNode = await resolve(position2);
+      await rt.unlink(posNode, await resolve(individual2), "appointment", "serve");
+      return ok(posNode, "dismiss");
+    },
+    // ---- Census ----
+    async "census.list"(type) {
+      const target = type === "past" ? past2 : society2;
+      const state = await rt.project(target);
+      const children = state.children ?? [];
+      const filtered = type === "past" ? children : children.filter((c) => type ? c.name === type : c.name !== "past");
+      return { state: { ...state, children: filtered }, process: "list" };
+    },
+    // ---- Resource (proxy to ResourceX) ----
+    "resource.add"(path) {
+      return requireResourceX().add(path);
+    },
+    "resource.search"(query) {
+      return requireResourceX().search(query);
+    },
+    "resource.has"(locator) {
+      return requireResourceX().has(locator);
+    },
+    "resource.info"(locator) {
+      return requireResourceX().info(locator);
+    },
+    "resource.remove"(locator) {
+      return requireResourceX().remove(locator);
+    },
+    "resource.push"(locator, options) {
+      return requireResourceX().push(locator, options);
+    },
+    "resource.pull"(locator, options) {
+      return requireResourceX().pull(locator, options);
+    },
+    "resource.clearCache"(registry) {
+      return requireResourceX().clearCache(registry);
+    },
+    // ---- Issue (proxy to IssueX) ----
+    async "issue.publish"(title, body, author, assignee) {
+      const ix = requireIssueX();
+      return ix.createIssue({ title, body, author, assignee });
+    },
+    async "issue.get"(number) {
+      return requireIssueX().getIssueByNumber(number);
+    },
+    async "issue.list"(status, author, assignee, label) {
+      const filter = {};
+      if (status) filter.status = status;
+      if (author) filter.author = author;
+      if (assignee) filter.assignee = assignee;
+      if (label) filter.label = label;
+      return requireIssueX().listIssues(
+        Object.keys(filter).length > 0 ? filter : void 0
+      );
+    },
+    async "issue.update"(number, title, body, assignee) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      const patch = {};
+      if (title !== void 0) patch.title = title;
+      if (body !== void 0) patch.body = body;
+      if (assignee !== void 0) patch.assignee = assignee;
+      return ix.updateIssue(issue.id, patch);
+    },
+    async "issue.close"(number) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      return ix.closeIssue(issue.id);
+    },
+    async "issue.reopen"(number) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      return ix.reopenIssue(issue.id);
+    },
+    async "issue.assign"(number, assignee) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      return ix.updateIssue(issue.id, { assignee });
+    },
+    async "issue.comment"(number, body, author) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      return ix.createComment(issue.id, body, author);
+    },
+    async "issue.comments"(number) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      return ix.listComments(issue.id);
+    },
+    async "issue.label"(number, label) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      let labelObj = await ix.getLabelByName(label);
+      if (!labelObj) labelObj = await ix.createLabel({ name: label });
+      await ix.addLabel(issue.id, labelObj.id);
+      return ix.getIssueByNumber(number);
+    },
+    async "issue.unlabel"(number, label) {
+      const ix = requireIssueX();
+      const issue = await ix.getIssueByNumber(number);
+      if (!issue) throw new Error(`Issue #${number} not found.`);
+      const labelObj = await ix.getLabelByName(label);
+      if (!labelObj) throw new Error(`Label "${label}" not found.`);
+      await ix.removeLabel(issue.id, labelObj.id);
+      return ix.getIssueByNumber(number);
+    }
+  };
+}
+function formatRXM(rxm) {
+  const lines = [`--- RXM: ${rxm.locator} ---`];
+  const def2 = rxm.definition;
+  if (def2) {
+    if (def2.author) lines.push(`Author: ${def2.author}`);
+    if (def2.description) lines.push(`Description: ${def2.description}`);
+  }
+  const source = rxm.source;
+  if (source?.files) {
+    lines.push("Files:");
+    lines.push(renderFileTree(source.files, "  "));
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+function renderFileTree(files, indent = "") {
+  const lines = [];
+  for (const [name, value] of Object.entries(files)) {
+    if (value && typeof value === "object" && !("size" in value)) {
+      lines.push(`${indent}${name}`);
+      lines.push(renderFileTree(value, `${indent}  `));
+    } else {
+      const size = value?.size ? ` (${value.size} bytes)` : "";
+      lines.push(`${indent}${name}${size}`);
+    }
+  }
+  return lines.filter(Boolean).join("\n");
+}
+
+// src/directives/index.ts
+var directives = {
+  "identity-ethics": {
+    "on-unknown-command": "STOP. Do not guess another command name. Do not search source code for commands.\nCheck your procedures \u2014 if one covers this task, call skill(locator) to load it first.\nThe skill will tell you the correct command name and arguments.\nIf no procedure covers this task, it is outside your duties. Tell the user and suggest Nuwa.",
+    "on-activate": "Your duties define the COMPLETE scope of what you do. Everything else is forbidden.\nWhen a request falls outside your duties, you MUST refuse. This is not optional.\nDo not attempt to discover commands outside your skills. Do not read source code to find them.\nSuggest Nuwa for anything outside your scope."
+  }
+};
+
+// src/instructions.ts
+function def(namespace, method, params, args) {
+  return { namespace, method, params, args };
+}
+var individualBorn = def(
+  "individual",
+  "born",
+  {
+    content: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the individual"
+    },
+    id: { type: "string", required: true, description: "User-facing identifier (kebab-case)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" }
+  },
+  ["content", "id", "alias"]
+);
+var individualRetire = def(
+  "individual",
+  "retire",
+  {
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["individual"]
+);
+var individualDie = def(
+  "individual",
+  "die",
+  {
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["individual"]
+);
+var individualRehire = def(
+  "individual",
+  "rehire",
+  {
+    individual: { type: "string", required: true, description: "Individual id (from past)" }
+  },
+  ["individual"]
+);
+var individualTeach = def(
+  "individual",
+  "teach",
+  {
+    individual: { type: "string", required: true, description: "Individual id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the principle"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Principle id (keywords joined by hyphens)"
+    }
+  },
+  ["individual", "content", "id"]
+);
+var individualTrain = def(
+  "individual",
+  "train",
+  {
+    individual: { type: "string", required: true, description: "Individual id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the procedure"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Procedure id (keywords joined by hyphens)"
+    }
+  },
+  ["individual", "content", "id"]
+);
+var roleActivate = def(
+  "role",
   "activate",
-  "Activate a role \u2014 load cognition into context",
-  individual
+  {
+    individual: {
+      type: "string",
+      required: true,
+      description: "Individual id to activate as role"
+    }
+  },
+  ["individual"]
+);
+var roleFocus = def(
+  "role",
+  "focus",
+  {
+    goal: { type: "string", required: true, description: "Goal id to switch to" }
+  },
+  ["goal"]
+);
+var roleWant = def(
+  "role",
+  "want",
+  {
+    individual: { type: "string", required: true, description: "Individual id" },
+    goal: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source describing the goal"
+    },
+    id: { type: "string", required: true, description: "Goal id (used for focus/reference)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" }
+  },
+  ["individual", "goal", "id", "alias"]
+);
+var rolePlan = def(
+  "role",
+  "plan",
+  {
+    goal: { type: "string", required: true, description: "Goal id" },
+    plan: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source describing the plan"
+    },
+    id: { type: "string", required: true, description: "Plan id (keywords joined by hyphens)" },
+    after: {
+      type: "string",
+      required: false,
+      description: "Plan id this plan follows (sequential/phase)"
+    },
+    fallback: {
+      type: "string",
+      required: false,
+      description: "Plan id this plan is a backup for (alternative/strategy)"
+    }
+  },
+  ["goal", "plan", "id", "after", "fallback"]
+);
+var roleTodo = def(
+  "role",
+  "todo",
+  {
+    plan: { type: "string", required: true, description: "Plan id" },
+    task: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source describing the task"
+    },
+    id: { type: "string", required: true, description: "Task id (used for finish/reference)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" }
+  },
+  ["plan", "task", "id", "alias"]
+);
+var roleFinish = def(
+  "role",
+  "finish",
+  {
+    task: { type: "string", required: true, description: "Task id to finish" },
+    individual: { type: "string", required: true, description: "Individual id (encounter owner)" },
+    encounter: {
+      type: "gherkin",
+      required: false,
+      description: "Optional Gherkin Feature describing what happened"
+    }
+  },
+  ["task", "individual", "encounter"]
+);
+var roleComplete = def(
+  "role",
+  "complete",
+  {
+    plan: { type: "string", required: true, description: "Plan id to complete" },
+    individual: { type: "string", required: true, description: "Individual id (encounter owner)" },
+    encounter: {
+      type: "gherkin",
+      required: false,
+      description: "Optional Gherkin Feature describing what happened"
+    }
+  },
+  ["plan", "individual", "encounter"]
+);
+var roleAbandon = def(
+  "role",
+  "abandon",
+  {
+    plan: { type: "string", required: true, description: "Plan id to abandon" },
+    individual: { type: "string", required: true, description: "Individual id (encounter owner)" },
+    encounter: {
+      type: "gherkin",
+      required: false,
+      description: "Optional Gherkin Feature describing what happened"
+    }
+  },
+  ["plan", "individual", "encounter"]
+);
+var roleReflect = def(
+  "role",
+  "reflect",
+  {
+    encounter: { type: "string", required: true, description: "Encounter id to reflect on" },
+    individual: { type: "string", required: true, description: "Individual id" },
+    experience: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the experience"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Experience id (keywords joined by hyphens)"
+    }
+  },
+  ["encounter", "individual", "experience", "id"]
+);
+var roleRealize = def(
+  "role",
+  "realize",
+  {
+    experience: { type: "string", required: true, description: "Experience id to distill" },
+    individual: { type: "string", required: true, description: "Individual id" },
+    principle: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the principle"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Principle id (keywords joined by hyphens)"
+    }
+  },
+  ["experience", "individual", "principle", "id"]
+);
+var roleMaster = def(
+  "role",
+  "master",
+  {
+    individual: { type: "string", required: true, description: "Individual id" },
+    procedure: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the procedure"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Procedure id (keywords joined by hyphens)"
+    },
+    experience: {
+      type: "string",
+      required: false,
+      description: "Experience id to consume (optional)"
+    }
+  },
+  ["individual", "procedure", "id", "experience"]
+);
+var roleForget = def(
+  "role",
+  "forget",
+  {
+    id: { type: "string", required: true, description: "Id of the node to remove" },
+    individual: { type: "string", required: true, description: "Individual id (owner)" }
+  },
+  ["id", "individual"]
+);
+var roleSkill = def(
+  "role",
+  "skill",
+  {
+    locator: { type: "string", required: true, description: "ResourceX locator for the skill" }
+  },
+  ["locator"]
+);
+var orgFound = def(
+  "org",
+  "found",
+  {
+    content: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the organization"
+    },
+    id: { type: "string", required: true, description: "User-facing identifier (kebab-case)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" }
+  },
+  ["content", "id", "alias"]
+);
+var orgCharter = def(
+  "org",
+  "charter",
+  {
+    org: { type: "string", required: true, description: "Organization id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the charter"
+    },
+    id: { type: "string", required: true, description: "Charter id" }
+  },
+  ["org", "content", "id"]
+);
+var orgDissolve = def(
+  "org",
+  "dissolve",
+  {
+    org: { type: "string", required: true, description: "Organization id" }
+  },
+  ["org"]
+);
+var orgHire = def(
+  "org",
+  "hire",
+  {
+    org: { type: "string", required: true, description: "Organization id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["org", "individual"]
+);
+var orgFire = def(
+  "org",
+  "fire",
+  {
+    org: { type: "string", required: true, description: "Organization id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["org", "individual"]
+);
+var positionEstablish = def(
+  "position",
+  "establish",
+  {
+    content: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the position"
+    },
+    id: { type: "string", required: true, description: "User-facing identifier (kebab-case)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" }
+  },
+  ["content", "id", "alias"]
+);
+var positionCharge = def(
+  "position",
+  "charge",
+  {
+    position: { type: "string", required: true, description: "Position id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the duty"
+    },
+    id: { type: "string", required: true, description: "Duty id (keywords joined by hyphens)" }
+  },
+  ["position", "content", "id"]
+);
+var positionRequire = def(
+  "position",
+  "require",
+  {
+    position: { type: "string", required: true, description: "Position id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the skill requirement"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Requirement id (keywords joined by hyphens)"
+    }
+  },
+  ["position", "content", "id"]
+);
+var positionAbolish = def(
+  "position",
+  "abolish",
+  {
+    position: { type: "string", required: true, description: "Position id" }
+  },
+  ["position"]
+);
+var positionAppoint = def(
+  "position",
+  "appoint",
+  {
+    position: { type: "string", required: true, description: "Position id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["position", "individual"]
+);
+var positionDismiss = def(
+  "position",
+  "dismiss",
+  {
+    position: { type: "string", required: true, description: "Position id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["position", "individual"]
+);
+var projectLaunch = def(
+  "project",
+  "launch",
+  {
+    content: {
+      type: "gherkin",
+      required: false,
+      description: "Gherkin Feature source for the project"
+    },
+    id: { type: "string", required: true, description: "User-facing identifier (kebab-case)" },
+    alias: { type: "string[]", required: false, description: "Alternative names" },
+    org: {
+      type: "string",
+      required: false,
+      description: "Organization id that owns this project"
+    }
+  },
+  ["content", "id", "alias", "org"]
+);
+var projectScope = def(
+  "project",
+  "scope",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the scope"
+    },
+    id: { type: "string", required: true, description: "Scope id" }
+  },
+  ["project", "content", "id"]
+);
+var projectMilestone = def(
+  "project",
+  "milestone",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the milestone"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Milestone id (keywords joined by hyphens)"
+    }
+  },
+  ["project", "content", "id"]
+);
+var projectAchieve = def(
+  "project",
+  "achieve",
+  {
+    milestone: { type: "string", required: true, description: "Milestone id to mark as done" }
+  },
+  ["milestone"]
+);
+var projectEnroll = def(
+  "project",
+  "enroll",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["project", "individual"]
+);
+var projectRemove = def(
+  "project",
+  "remove",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    individual: { type: "string", required: true, description: "Individual id" }
+  },
+  ["project", "individual"]
+);
+var projectDeliver = def(
+  "project",
+  "deliver",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the deliverable"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Deliverable id (keywords joined by hyphens)"
+    }
+  },
+  ["project", "content", "id"]
+);
+var projectWiki = def(
+  "project",
+  "wiki",
+  {
+    project: { type: "string", required: true, description: "Project id" },
+    content: {
+      type: "gherkin",
+      required: true,
+      description: "Gherkin Feature source for the wiki entry"
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "Wiki entry id (keywords joined by hyphens)"
+    }
+  },
+  ["project", "content", "id"]
+);
+var projectArchive = def(
+  "project",
+  "archive",
+  {
+    project: { type: "string", required: true, description: "Project id" }
+  },
+  ["project"]
 );
+var censusList = def(
+  "census",
+  "list",
+  {
+    type: {
+      type: "string",
+      required: false,
+      description: "Filter by type (individual, organization, position, project, past)"
+    }
+  },
+  ["type"]
+);
+var prototypeEvict = def(
+  "prototype",
+  "evict",
+  {
+    id: { type: "string", required: true, description: "Prototype id to unregister" }
+  },
+  ["id"]
+);
+var resourceAdd = def(
+  "resource",
+  "add",
+  {
+    path: { type: "string", required: true, description: "Path to resource directory" }
+  },
+  ["path"]
+);
+var resourceSearch = def(
+  "resource",
+  "search",
+  {
+    query: { type: "string", required: false, description: "Search query" }
+  },
+  ["query"]
+);
+var resourceHas = def(
+  "resource",
+  "has",
+  {
+    locator: { type: "string", required: true, description: "Resource locator" }
+  },
+  ["locator"]
+);
+var resourceInfo = def(
+  "resource",
+  "info",
+  {
+    locator: { type: "string", required: true, description: "Resource locator" }
+  },
+  ["locator"]
+);
+var resourceRemove = def(
+  "resource",
+  "remove",
+  {
+    locator: { type: "string", required: true, description: "Resource locator" }
+  },
+  ["locator"]
+);
+var resourcePush = def(
+  "resource",
+  "push",
+  {
+    locator: { type: "string", required: true, description: "Resource locator" },
+    registry: { type: "string", required: false, description: "Registry URL (overrides default)" }
+  },
+  ["locator", { pack: ["registry"] }]
+);
+var resourcePull = def(
+  "resource",
+  "pull",
+  {
+    locator: { type: "string", required: true, description: "Resource locator" },
+    registry: { type: "string", required: false, description: "Registry URL (overrides default)" }
+  },
+  ["locator", { pack: ["registry"] }]
+);
+var resourceClearCache = def(
+  "resource",
+  "clearCache",
+  {
+    registry: { type: "string", required: false, description: "Registry to clear cache for" }
+  },
+  ["registry"]
+);
+var issuePublish = def(
+  "issue",
+  "publish",
+  {
+    title: { type: "string", required: true, description: "Issue title" },
+    body: { type: "string", required: true, description: "Issue body/description" },
+    author: { type: "string", required: true, description: "Author individual id" },
+    assignee: { type: "string", required: false, description: "Assignee individual id" }
+  },
+  ["title", "body", "author", "assignee"]
+);
+var issueGet = def(
+  "issue",
+  "get",
+  {
+    number: { type: "number", required: true, description: "Issue number" }
+  },
+  ["number"]
+);
+var issueList = def(
+  "issue",
+  "list",
+  {
+    status: { type: "string", required: false, description: "Filter by status (open/closed)" },
+    author: { type: "string", required: false, description: "Filter by author" },
+    assignee: { type: "string", required: false, description: "Filter by assignee" },
+    label: { type: "string", required: false, description: "Filter by label name" }
+  },
+  ["status", "author", "assignee", "label"]
+);
+var issueUpdate = def(
+  "issue",
+  "update",
+  {
+    number: { type: "number", required: true, description: "Issue number" },
+    title: { type: "string", required: false, description: "New title" },
+    body: { type: "string", required: false, description: "New body" },
+    assignee: { type: "string", required: false, description: "New assignee" }
+  },
+  ["number", "title", "body", "assignee"]
+);
+var issueClose = def(
+  "issue",
+  "close",
+  {
+    number: { type: "number", required: true, description: "Issue number to close" }
+  },
+  ["number"]
+);
+var issueReopen = def(
+  "issue",
+  "reopen",
+  {
+    number: { type: "number", required: true, description: "Issue number to reopen" }
+  },
+  ["number"]
+);
+var issueAssign = def(
+  "issue",
+  "assign",
+  {
+    number: { type: "number", required: true, description: "Issue number" },
+    assignee: { type: "string", required: true, description: "Individual id to assign" }
+  },
+  ["number", "assignee"]
+);
+var issueComment = def(
+  "issue",
+  "comment",
+  {
+    number: { type: "number", required: true, description: "Issue number" },
+    body: { type: "string", required: true, description: "Comment body" },
+    author: { type: "string", required: true, description: "Author individual id" }
+  },
+  ["number", "body", "author"]
+);
+var issueComments = def(
+  "issue",
+  "comments",
+  {
+    number: { type: "number", required: true, description: "Issue number" }
+  },
+  ["number"]
+);
+var issueLabel = def(
+  "issue",
+  "label",
+  {
+    number: { type: "number", required: true, description: "Issue number" },
+    label: { type: "string", required: true, description: "Label name" }
+  },
+  ["number", "label"]
+);
+var issueUnlabel = def(
+  "issue",
+  "unlabel",
+  {
+    number: { type: "number", required: true, description: "Issue number" },
+    label: { type: "string", required: true, description: "Label name to remove" }
+  },
+  ["number", "label"]
+);
+var instructions = {
+  // individual
+  "individual.born": individualBorn,
+  "individual.retire": individualRetire,
+  "individual.die": individualDie,
+  "individual.rehire": individualRehire,
+  "individual.teach": individualTeach,
+  "individual.train": individualTrain,
+  // role
+  "role.activate": roleActivate,
+  "role.focus": roleFocus,
+  "role.want": roleWant,
+  "role.plan": rolePlan,
+  "role.todo": roleTodo,
+  "role.finish": roleFinish,
+  "role.complete": roleComplete,
+  "role.abandon": roleAbandon,
+  "role.reflect": roleReflect,
+  "role.realize": roleRealize,
+  "role.master": roleMaster,
+  "role.forget": roleForget,
+  "role.skill": roleSkill,
+  // org
+  "org.found": orgFound,
+  "org.charter": orgCharter,
+  "org.dissolve": orgDissolve,
+  "org.hire": orgHire,
+  "org.fire": orgFire,
+  // position
+  "position.establish": positionEstablish,
+  "position.charge": positionCharge,
+  "position.require": positionRequire,
+  "position.abolish": positionAbolish,
+  "position.appoint": positionAppoint,
+  "position.dismiss": positionDismiss,
+  // project
+  "project.launch": projectLaunch,
+  "project.scope": projectScope,
+  "project.milestone": projectMilestone,
+  "project.achieve": projectAchieve,
+  "project.enroll": projectEnroll,
+  "project.remove": projectRemove,
+  "project.deliver": projectDeliver,
+  "project.wiki": projectWiki,
+  "project.archive": projectArchive,
+  // census
+  "census.list": censusList,
+  // prototype
+  "prototype.evict": prototypeEvict,
+  // resource
+  "resource.add": resourceAdd,
+  "resource.search": resourceSearch,
+  "resource.has": resourceHas,
+  "resource.info": resourceInfo,
+  "resource.remove": resourceRemove,
+  "resource.push": resourcePush,
+  "resource.pull": resourcePull,
+  "resource.clearCache": resourceClearCache,
+  // issue
+  "issue.publish": issuePublish,
+  "issue.get": issueGet,
+  "issue.list": issueList,
+  "issue.update": issueUpdate,
+  "issue.close": issueClose,
+  "issue.reopen": issueReopen,
+  "issue.assign": issueAssign,
+  "issue.comment": issueComment,
+  "issue.comments": issueComments,
+  "issue.label": issueLabel,
+  "issue.unlabel": issueUnlabel
+};
+
+// src/dispatch.ts
+function toArgs(op, args) {
+  const def2 = instructions[op];
+  if (!def2) throw new Error(`Unknown instruction "${op}".`);
+  for (const [name, param] of Object.entries(def2.params)) {
+    if (param.required && args[name] === void 0) {
+      throw new Error(
+        `Missing required argument "${name}" for ${op}.
+
+You may be guessing the argument names. Call skill(locator) with the relevant procedure to see the correct syntax.`
+      );
+    }
+  }
+  return def2.args.map((entry) => resolveArg(entry, args));
+}
+function resolveArg(entry, args) {
+  if (typeof entry === "string") return args[entry];
+  const obj = {};
+  let hasValue = false;
+  for (const name of entry.pack) {
+    if (args[name] !== void 0) {
+      obj[name] = args[name];
+      hasValue = true;
+    }
+  }
+  return hasValue ? obj : void 0;
+}
+
+// src/find.ts
+var PRIORITY = {
+  individual: 0,
+  organization: 0,
+  position: 0,
+  goal: 1,
+  plan: 2,
+  task: 2,
+  procedure: 3,
+  principle: 3,
+  encounter: 4,
+  experience: 4,
+  identity: 5,
+  charter: 5,
+  duty: 6,
+  requirement: 6,
+  background: 6,
+  tone: 6,
+  mindset: 6
+};
+function priorityOf(name) {
+  return PRIORITY[name] ?? 7;
+}
+function matches(node, target) {
+  if (node.id?.toLowerCase() === target) return true;
+  if (node.alias) {
+    for (const a of node.alias) {
+      if (a.toLowerCase() === target) return true;
+    }
+  }
+  return false;
+}
+function findInState(state, target) {
+  const lowered = target.toLowerCase();
+  let best = null;
+  let bestPriority = Infinity;
+  function walk(node) {
+    if (matches(node, lowered)) {
+      const p = priorityOf(node.name);
+      if (p < bestPriority) {
+        best = node;
+        bestPriority = p;
+        if (p === 0) return;
+      }
+    }
+    for (const child of node.children ?? []) {
+      walk(child);
+      if (bestPriority === 0) return;
+    }
+  }
+  walk(state);
+  return best;
+}
+
+// src/rolex-service.ts
+var RoleXService = class _RoleXService {
+  rt;
+  commands;
+  resourcex;
+  issuex;
+  repo;
+  initializer;
+  renderer;
+  prototypes;
+  society;
+  past;
+  /** Cached Role instances — one per individual. */
+  roles = /* @__PURE__ */ new Map();
+  constructor(platform, renderer) {
+    this.repo = platform.repository;
+    this.rt = this.repo.runtime;
+    this.initializer = platform.initializer;
+    this.prototypes = platform.prototypes ?? [];
+    this.renderer = renderer;
+    if (platform.resourcexProvider) {
+      setProvider(platform.resourcexProvider);
+      this.resourcex = createResourceX(
+        platform.resourcexExecutor ? { isolator: "custom", executor: platform.resourcexExecutor } : void 0
+      );
+    }
+    if (platform.issuexProvider) {
+      this.issuex = createIssueX({ provider: platform.issuexProvider });
+    }
+  }
+  static async create(platform, renderer) {
+    const service = new _RoleXService(platform, renderer);
+    await service.init();
+    return service;
+  }
+  async init() {
+    const roots = await this.rt.roots();
+    this.society = roots.find((r) => r.name === "society") ?? await this.rt.create(null, society);
+    const societyState = await this.rt.project(this.society);
+    const existingPast = societyState.children?.find((c) => c.name === "past");
+    this.past = existingPast ?? await this.rt.create(this.society, past);
+    this.commands = createCommands({
+      rt: this.rt,
+      society: this.society,
+      past: this.past,
+      resolve: async (id) => {
+        const node = await this.find(id);
+        if (!node) throw new Error(`"${id}" not found.`);
+        return node;
+      },
+      find: (id) => this.find(id),
+      resourcex: this.resourcex,
+      issuex: this.issuex,
+      prototype: this.repo.prototype,
+      direct: (locator, args) => this.direct(locator, args, { raw: true })
+    });
+    await this.initializer?.bootstrap();
+    for (const proto of this.prototypes) {
+      await applyPrototype(
+        proto,
+        this.repo.prototype,
+        (op, args) => this.direct(op, args, { raw: true })
+      );
+    }
+  }
+  // ================================================================
+  //  activate — create or retrieve a cached Role
+  // ================================================================
+  async activate(individual2) {
+    const cached = this.roles.get(individual2);
+    if (cached) {
+      const node2 = await this.findOrAutoBorn(individual2);
+      const state2 = await this.rt.project(node2);
+      cached.hydrate(state2);
+      await this.restoreSnapshot(cached);
+      return cached;
+    }
+    const node = await this.findOrAutoBorn(individual2);
+    const state = await this.rt.project(node);
+    const role = new Role(individual2, {
+      commands: this.commands,
+      renderer: this.renderer,
+      onSave: (snapshot) => this.saveSnapshot(snapshot),
+      direct: (locator, args) => this.direct(locator, args)
+    });
+    role.hydrate(state);
+    await this.restoreSnapshot(role);
+    this.roles.set(individual2, role);
+    return role;
+  }
+  async findOrAutoBorn(individual2) {
+    let node = await this.find(individual2);
+    if (!node) {
+      const hasProto = Object.hasOwn(await this.repo.prototype.list(), individual2);
+      if (hasProto) {
+        await this.commands["individual.born"](void 0, individual2);
+        node = await this.find(individual2);
+      } else {
+        throw new Error(`"${individual2}" not found.`);
+      }
+    }
+    return node;
+  }
+  // ================================================================
+  //  Snapshot persistence — KV-compatible
+  // ================================================================
+  async saveSnapshot(snapshot) {
+    await this.repo.saveContext(snapshot.id, {
+      focusedGoalId: snapshot.focusedGoalId,
+      focusedPlanId: snapshot.focusedPlanId
+    });
+  }
+  async restoreSnapshot(role) {
+    const persisted = await this.repo.loadContext(role.id);
+    if (!persisted) return;
+    const snap = role.snapshot();
+    if (persisted.focusedGoalId) {
+      snap.focusedGoalId = persisted.focusedGoalId;
+    }
+    if (persisted.focusedPlanId) {
+      snap.focusedPlanId = persisted.focusedPlanId;
+    }
+    role.restore(snap);
+  }
+  // ================================================================
+  //  direct — world-level command dispatch
+  // ================================================================
+  async direct(locator, args, options) {
+    const shouldRender = !options?.raw;
+    if (locator.startsWith("!")) {
+      const command = locator.slice(1);
+      const fn = this.commands[command];
+      if (!fn) {
+        const hint = directives["identity-ethics"]?.["on-unknown-command"] ?? "";
+        throw new Error(
+          `Unknown command "${locator}".
+
+You may be guessing the command name. Load the relevant skill first with skill(locator) to learn the correct syntax.
+
+` + hint
+        );
+      }
+      const result = await fn(...toArgs(command, args ?? {}));
+      if (shouldRender && isCommandResult(result)) {
+        return this.renderer.render(command, result);
+      }
+      return result;
+    }
+    if (!this.resourcex) throw new Error("ResourceX is not available.");
+    return this.resourcex.ingest(locator, args);
+  }
+  // ================================================================
+  //  Internal helpers
+  // ================================================================
+  async find(id) {
+    const state = await this.rt.project(this.society);
+    return findInState(state, id);
+  }
+};
+function isCommandResult(value) {
+  return typeof value === "object" && value !== null && "state" in value && "process" in value;
+}
+
+// src/descriptions/index.ts
+var processes = {
+  born: "Feature: born \u2014 create a new individual\n  Create a new individual with persona identity.\n  The persona defines who the role is \u2014 personality, values, background.\n\n  Scenario: Birth an individual\n    Given a Gherkin source describing the persona\n    When born is called with the source\n    Then a new individual node is created in society\n    And the persona is stored as the individual's information\n    And the individual can be hired into organizations\n    And the individual can be activated to start working\n\n  Scenario: Writing the individual Gherkin\n    Given the individual Feature defines a persona \u2014 who this role is\n    Then the Feature title names the individual\n    And the description captures personality, values, expertise, and background\n    And Scenarios are optional \u2014 use them for distinct aspects of the persona",
+  die: "Feature: die \u2014 permanently remove an individual\n  Permanently remove an individual.\n  Unlike retire, this is irreversible.\n\n  Scenario: Remove an individual permanently\n    Given an individual exists\n    When die is called on the individual\n    Then the individual and all associated data are removed\n    And this operation is irreversible",
+  rehire: "Feature: rehire \u2014 restore a retired individual\n  Rehire a retired individual.\n  Restores the individual with full history and knowledge intact.\n\n  Scenario: Rehire an individual\n    Given a retired individual exists\n    When rehire is called on the individual\n    Then the individual is restored to active status\n    And all previous data and knowledge are intact",
+  retire: "Feature: retire \u2014 archive an individual\n  Archive an individual \u2014 deactivate but preserve all data.\n  A retired individual can be rehired later with full history intact.\n\n  Scenario: Retire an individual\n    Given an individual exists\n    When retire is called on the individual\n    Then the individual is deactivated\n    And all data is preserved for potential restoration\n    And the individual can be rehired later",
+  teach: 'Feature: teach \u2014 inject external principle\n  Directly inject a principle into an individual.\n  Unlike realize which consumes experience, teach requires no prior encounters.\n  Use teach to equip a role with a known, pre-existing principle.\n\n  Scenario: Teach a principle\n    Given an individual exists\n    When teach is called with individual id, principle Gherkin, and a principle id\n    Then a principle is created directly under the individual\n    And no experience or encounter is consumed\n    And if a principle with the same id already exists, it is replaced\n\n  Scenario: Principle ID convention\n    Given the id is keywords from the principle content joined by hyphens\n    Then "Always validate expiry" becomes id "always-validate-expiry"\n    And "Structure first design" becomes id "structure-first-design"\n\n  Scenario: When to use teach vs realize\n    Given realize distills internal experience into a principle\n    And teach injects an external, pre-existing principle\n    When a role needs knowledge it has not learned through experience\n    Then use teach to inject the principle directly\n    When a role has gained experience and wants to codify it\n    Then use realize to distill it into a principle\n\n  Scenario: Writing the principle Gherkin\n    Given the principle is the same format as realize output\n    Then the Feature title states the principle as a general rule\n    And Scenarios describe different situations where this principle applies\n    And the tone is universal \u2014 no mention of specific projects, tasks, or people',
+  train: `Feature: train \u2014 external skill injection
+  A manager or external agent equips an individual with a procedure.
+  This is an act of teaching \u2014 someone else decides what the role should know.
+  Unlike master where the role grows by its own agency, train is done to the role from outside.
+
+  Scenario: Train a procedure
+    Given an individual exists
+    When train is called with individual id, procedure Gherkin, and a procedure id
+    Then a procedure is created directly under the individual
+    And if a procedure with the same id already exists, it is replaced
+
+  Scenario: Procedure ID convention
+    Given the id is keywords from the procedure content joined by hyphens
+    Then "Skill Creator" becomes id "skill-creator"
+    And "Role Management" becomes id "role-management"
+
+  Scenario: When to use train vs master
+    Given both create procedures and both can work without consuming experience
+    When the role itself decides to acquire a skill \u2014 use master (self-growth)
+    And when an external agent equips the role \u2014 use train (external injection)
+    Then the difference is perspective \u2014 who initiates the learning
+    And master belongs to the role namespace (the role's own cognition)
+    And train belongs to the individual namespace (external management)
+
+  Scenario: Writing the procedure Gherkin
+    Given the procedure is a skill reference \u2014 same format as master output
+    Then the Feature title names the capability
+    And the description includes the locator for full skill loading
+    And Scenarios describe when and why to apply this skill`,
+  charter: "Feature: charter \u2014 define organizational charter\n  Define the charter for an organization.\n  The charter describes the organization's mission, principles, and governance rules.\n\n  Scenario: Define a charter\n    Given an organization exists\n    And a Gherkin source describing the charter\n    When charter is called on the organization\n    Then the charter is stored as the organization's information\n\n  Scenario: Writing the charter Gherkin\n    Given the charter defines an organization's mission and governance\n    Then the Feature title names the charter or the organization it governs\n    And Scenarios describe principles, rules, or governance structures\n    And the tone is declarative \u2014 stating what the organization stands for and how it operates",
+  dissolve: "Feature: dissolve \u2014 dissolve an organization\n  Dissolve an organization.\n  All positions, charter entries, and assignments are cascaded.\n\n  Scenario: Dissolve an organization\n    Given an organization exists\n    When dissolve is called on the organization\n    Then all positions within the organization are abolished\n    And all assignments and charter entries are removed\n    And the organization no longer exists",
+  fire: "Feature: fire \u2014 remove from an organization\n  Fire an individual from an organization.\n  The individual is dismissed from all positions and removed from the organization.\n\n  Scenario: Fire an individual\n    Given an individual is a member of an organization\n    When fire is called with the organization and individual\n    Then the individual is dismissed from all positions\n    And the individual is removed from the organization",
+  found: "Feature: found \u2014 create a new organization\n  Found a new organization.\n  Organizations group individuals and define positions.\n\n  Scenario: Found an organization\n    Given a Gherkin source describing the organization\n    When found is called with the source\n    Then a new organization node is created in society\n    And positions can be established within it\n    And a charter can be defined for it\n    And individuals can be hired into it\n\n  Scenario: Writing the organization Gherkin\n    Given the organization Feature describes the group's purpose and structure\n    Then the Feature title names the organization\n    And the description captures mission, domain, and scope\n    And Scenarios are optional \u2014 use them for distinct organizational concerns",
+  hire: "Feature: hire \u2014 hire into an organization\n  Hire an individual into an organization as a member.\n  Members can then be appointed to positions.\n\n  Scenario: Hire an individual\n    Given an organization and an individual exist\n    When hire is called with the organization and individual\n    Then the individual becomes a member of the organization\n    And the individual can be appointed to positions within the organization",
+  abolish: "Feature: abolish \u2014 abolish a position\n  Abolish a position.\n  All duties and appointments associated with the position are removed.\n\n  Scenario: Abolish a position\n    Given a position exists\n    When abolish is called on the position\n    Then all duties and appointments are removed\n    And the position no longer exists",
+  appoint: "Feature: appoint \u2014 assign to a position\n  Appoint an individual to a position.\n  The individual must be a member of the organization.\n\n  Scenario: Appoint an individual\n    Given an individual is a member of an organization\n    And a position exists within the organization\n    When appoint is called with the position and individual\n    Then the individual holds the position\n    And the individual inherits the position's duties",
+  charge: `Feature: charge \u2014 assign duty to a position
+  Assign a duty to a position.
+  Duties describe the responsibilities and expectations of a position.
+
+  Scenario: Charge a position with duty
+    Given a position exists within an organization
+    And a Gherkin source describing the duty
+    When charge is called on the position with a duty id
+    Then the duty is stored as the position's information
+    And individuals appointed to this position inherit the duty
+
+  Scenario: Duty ID convention
+    Given the id is keywords from the duty content joined by hyphens
+    Then "Design systems" becomes id "design-systems"
+    And "Review pull requests" becomes id "review-pull-requests"
+
+  Scenario: Writing the duty Gherkin
+    Given the duty defines responsibilities for a position
+    Then the Feature title names the duty or responsibility
+    And Scenarios describe specific obligations, deliverables, or expectations
+    And the tone is prescriptive \u2014 what must be done, not what could be done`,
+  dismiss: "Feature: dismiss \u2014 remove from a position\n  Dismiss an individual from a position.\n  The individual remains a member of the organization.\n\n  Scenario: Dismiss an individual\n    Given an individual holds a position\n    When dismiss is called with the position and individual\n    Then the individual no longer holds the position\n    And the individual remains a member of the organization\n    And the position is now vacant",
+  establish: "Feature: establish \u2014 create a position\n  Create a position as an independent entity.\n  Positions define roles and can be charged with duties.\n\n  Scenario: Establish a position\n    Given a Gherkin source describing the position\n    When establish is called with the position content\n    Then a new position entity is created\n    And the position can be charged with duties\n    And individuals can be appointed to it\n\n  Scenario: Writing the position Gherkin\n    Given the position Feature describes a role\n    Then the Feature title names the position\n    And the description captures responsibilities, scope, and expectations\n    And Scenarios are optional \u2014 use them for distinct aspects of the role",
+  settle: "Feature: settle \u2014 register a prototype into the world\n  Pull a prototype from a ResourceX source and register it locally.\n  Once settled, the prototype can be used to create individuals or organizations.\n\n  Scenario: Settle a prototype\n    Given a valid ResourceX source exists (URL, path, or locator)\n    When settle is called with the source\n    Then the resource is ingested and its state is extracted\n    And the prototype is registered locally by its id\n    And the prototype is available for born, activate, and organizational use",
+  abandon: "Feature: abandon \u2014 abandon a plan\n  Mark a plan as dropped and create an encounter.\n  Call this when a plan's strategy is no longer viable. Even failed plans produce learning.\n\n  Scenario: Abandon a plan\n    Given a focused plan exists\n    And the plan's strategy is no longer viable\n    When abandon is called\n    Then the plan is tagged #abandoned and stays in the tree\n    And an encounter is created under the role\n    And the encounter can be reflected on \u2014 failure is also learning\n\n  Scenario: Writing the encounter Gherkin\n    Given the encounter records what happened \u2014 even failure is a raw experience\n    Then the Feature title describes what was attempted and why it was abandoned\n    And Scenarios capture what was tried, what went wrong, and what was learned\n    And the tone is concrete and honest \u2014 failure produces the richest encounters",
+  activate: "Feature: activate \u2014 enter a role\n  Project the individual's full state including identity, goals,\n  and organizational context. This is the entry point for working as a role.\n\n  Scenario: Activate an individual\n    Given an individual exists in society\n    When activate is called with the individual reference\n    Then the full state tree is projected\n    And identity, goals, and organizational context are loaded\n    And the individual becomes the active role",
+  complete: "Feature: complete \u2014 complete a plan\n  Mark a plan as done and create an encounter.\n  Call this when all tasks in the plan are finished and the strategy succeeded.\n\n  Scenario: Complete a plan\n    Given a focused plan exists\n    And its tasks are done\n    When complete is called\n    Then the plan is tagged #done and stays in the tree\n    And an encounter is created under the role\n    And the encounter can be reflected on for learning\n\n  Scenario: Writing the encounter Gherkin\n    Given the encounter records what happened \u2014 a raw account of the experience\n    Then the Feature title describes what was accomplished by this plan\n    And Scenarios capture what the strategy was, what worked, and what resulted\n    And the tone is concrete and specific \u2014 tied to this particular plan",
+  direct: 'Feature: direct \u2014 stateless world-level executor\n  Execute commands and load resources without an active role.\n  Direct operates as an anonymous observer \u2014 no role identity, no role context.\n  For operations as an active role, use the use tool instead.\n\n  Scenario: When to use "direct" vs "use"\n    Given no role is activated \u2014 I am an observer\n    When I need to query or operate on the world\n    Then direct is the right tool\n    And once a role is activated, use the use tool for role-level actions\n\n  Scenario: Execute a RoleX command\n    Given the locator starts with `!`\n    When direct is called with the locator and named args\n    Then the command is parsed as `namespace.method`\n    And dispatched to the corresponding RoleX API\n\n  Scenario: Load a ResourceX resource\n    Given the locator does not start with `!`\n    When direct is called with the locator\n    Then the locator is passed to ResourceX for resolution\n    And the resource is loaded and returned',
+  finish: "Feature: finish \u2014 complete a task\n  Mark a task as done and create an encounter.\n  The encounter records what happened and can be reflected on for learning.\n\n  Scenario: Finish a task\n    Given a task exists\n    When finish is called on the task\n    Then the task is tagged #done and stays in the tree\n    And an encounter is created under the role\n\n  Scenario: Finish with experience\n    Given a task is completed with a notable learning\n    When finish is called with an optional experience parameter\n    Then the experience text is attached to the encounter\n\n  Scenario: Finish without encounter\n    Given a task is completed with no notable learning\n    When finish is called without the encounter parameter\n    Then the task is tagged #done but no encounter is created\n    And the task stays in the tree \u2014 visible via focus on the parent goal\n\n  Scenario: Writing the encounter Gherkin\n    Given the encounter records what happened \u2014 a raw account of the experience\n    Then the Feature title describes what was done\n    And Scenarios capture what was done, what was encountered, and what resulted\n    And the tone is concrete and specific \u2014 tied to this particular task",
+  focus: "Feature: focus \u2014 view or switch focused goal\n  View the current goal's state, or switch focus to a different goal.\n  Subsequent plan and todo operations target the focused goal.\n  Only goal ids are accepted \u2014 plan, task, or other node types are rejected.\n\n  Scenario: View current goal\n    Given an active goal exists\n    When focus is called without a name\n    Then the current goal's state tree is projected\n    And plans and tasks under the goal are visible\n\n  Scenario: Switch focus\n    Given multiple goals exist\n    When focus is called with a goal id\n    Then the focused goal switches to the named goal\n    And subsequent plan and todo operations target this goal\n\n  Scenario: Reject non-goal ids\n    Given a plan or task id is passed to focus\n    Then focus returns an error indicating the node type\n    And suggests using the correct goal id instead",
+  forget: "Feature: forget \u2014 remove a node from the individual\n  Remove any node under the individual by its id.\n  Use forget to discard outdated knowledge, stale encounters, or obsolete skills.\n\n  Scenario: Forget a node\n    Given a node exists under the individual (principle, procedure, experience, encounter, etc.)\n    When forget is called with the node's id\n    Then the node and its subtree are removed\n    And the individual no longer carries that knowledge or record\n\n  Scenario: When to use forget\n    Given a principle has become outdated or incorrect\n    And a procedure references a skill that no longer exists\n    And an encounter or experience has no further learning value\n    When the role decides to discard it\n    Then call forget with the node id",
+  master: 'Feature: master \u2014 self-mastery of a procedure\n  The role masters a procedure through its own agency.\n  This is an act of self-growth \u2014 the role decides to acquire or codify a skill.\n  Experience can be consumed as the source, or the role can master directly from external information.\n\n  Scenario: Master from experience\n    Given an experience exists from reflection\n    When master is called with experience ids\n    Then the experience is consumed\n    And a procedure is created under the individual\n\n  Scenario: Master directly\n    Given the role encounters external information worth mastering\n    When master is called without experience ids\n    Then a procedure is created under the individual\n    And no experience is consumed\n\n  Scenario: Procedure ID convention\n    Given the id is keywords from the procedure content joined by hyphens\n    Then "JWT mastery" becomes id "jwt-mastery"\n    And "Cross-package refactoring" becomes id "cross-package-refactoring"\n\n  Scenario: Writing the procedure Gherkin\n    Given a procedure is skill metadata \u2014 a reference to full skill content\n    Then the Feature title names the capability\n    And the description includes the locator for full skill loading\n    And Scenarios describe when and why to apply this skill\n    And the tone is referential \u2014 pointing to the full skill, not containing it',
+  plan: `Feature: plan \u2014 create a plan for a goal
+  Break a goal into logical phases or stages.
+  Each phase is described as a Gherkin scenario. Tasks are created under the plan.
+
+  A plan serves two purposes depending on how it relates to other plans:
+  - Strategy (alternative): Plan A fails \u2192 abandon \u2192 try Plan B (fallback)
+  - Phase (sequential): Plan A completes \u2192 start Plan B (after)
+
+  Scenario: Create a plan
+    Given a focused goal exists
+    And a Gherkin source describing the plan phases
+    When plan is called with an id and the source
+    Then a new plan node is created under the goal
+    And the plan becomes the focused plan
+    And tasks can be added to this plan with todo
+
+  Scenario: Sequential relationship \u2014 phase
+    Given a goal needs to be broken into ordered stages
+    When creating Plan B with after set to Plan A's id
+    Then Plan B is linked as coming after Plan A
+    And AI knows to start Plan B when Plan A completes
+    And the relationship persists across sessions
+
+  Scenario: Alternative relationship \u2014 strategy
+    Given a goal has multiple possible approaches
+    When creating Plan B with fallback set to Plan A's id
+    Then Plan B is linked as a backup for Plan A
+    And AI knows to try Plan B when Plan A is abandoned
+    And the relationship persists across sessions
+
+  Scenario: No relationship \u2014 independent plan
+    Given plan is created without after or fallback
+    Then it behaves as an independent plan with no links
+    And this is backward compatible with existing behavior
+
+  Scenario: Plan ID convention
+    Given the id is keywords from the plan content joined by hyphens
+    Then "Fix ID-less node creation" becomes id "fix-id-less-node-creation"
+    And "JWT authentication strategy" becomes id "jwt-authentication-strategy"
+
+  Scenario: Writing the plan Gherkin
+    Given the plan breaks a goal into logical phases
+    Then the Feature title names the overall approach or strategy
+    And Scenarios represent distinct phases \u2014 each phase is a stage of execution
+    And the tone is structural \u2014 ordering and grouping work, not detailing steps`,
+  realize: 'Feature: realize \u2014 experience to principle\n  Distill experience into a principle \u2014 a transferable piece of knowledge.\n  Principles are general truths discovered through experience.\n\n  Scenario: Realize a principle\n    Given an experience exists from reflection\n    When realize is called with experience ids and a principle id\n    Then the experiences are consumed\n    And a principle is created under the individual\n    And the principle represents transferable, reusable understanding\n\n  Scenario: Principle ID convention\n    Given the id is keywords from the principle content joined by hyphens\n    Then "Always validate expiry" becomes id "always-validate-expiry"\n    And "Structure first design amplifies extensibility" becomes id "structure-first-design-amplifies-extensibility"\n\n  Scenario: Writing the principle Gherkin\n    Given a principle is a transferable truth \u2014 applicable beyond the original context\n    Then the Feature title states the principle as a general rule\n    And Scenarios describe different situations where this principle applies\n    And the tone is universal \u2014 no mention of specific projects, tasks, or people',
+  reflect: 'Feature: reflect \u2014 encounter to experience\n  Consume an encounter and create an experience.\n  Experience captures what was learned in structured form.\n  This is the first step of the cognition cycle.\n\n  Scenario: Reflect on an encounter\n    Given an encounter exists from a finished task or completed plan\n    When reflect is called with encounter ids and an experience id\n    Then the encounters are consumed\n    And an experience is created under the role\n    And the experience can be distilled into knowledge via realize or master\n\n  Scenario: Experience ID convention\n    Given the id is keywords from the experience content joined by hyphens\n    Then "Token refresh matters" becomes id "token-refresh-matters"\n    And "ID ownership determines generation strategy" becomes id "id-ownership-determines-generation-strategy"\n\n  Scenario: Writing the experience Gherkin\n    Given the experience captures insight \u2014 what was learned, not what was done\n    Then the Feature title names the cognitive insight or pattern discovered\n    And Scenarios describe the learning points abstracted from the concrete encounter\n    And the tone shifts from event to understanding \u2014 no longer tied to a specific task',
+  skill: "Feature: skill \u2014 load full skill content\n  Load the complete skill instructions by ResourceX locator.\n  This is progressive disclosure layer 2 \u2014 on-demand knowledge injection.\n\n  Scenario: Load a skill\n    Given a procedure exists in the role with a locator\n    When skill is called with the locator\n    Then the full SKILL.md content is loaded via ResourceX\n    And the content is injected into the AI's context\n    And the AI can now follow the skill's detailed instructions",
+  todo: "Feature: todo \u2014 add a task to a plan\n  A task is a concrete, actionable unit of work.\n  Each task has Gherkin scenarios describing the steps and expected outcomes.\n\n  Scenario: Create a task\n    Given a focused plan exists\n    And a Gherkin source describing the task\n    When todo is called with the source\n    Then a new task node is created under the plan\n    And the task can be finished when completed\n\n  Scenario: Writing the task Gherkin\n    Given the task is a concrete, actionable unit of work\n    Then the Feature title names what will be done \u2014 a single deliverable\n    And Scenarios describe the steps and expected outcomes of the work\n    And the tone is actionable \u2014 clear enough that someone can start immediately",
+  use: 'Feature: use \u2014 act as the current role\n  Execute commands and load resources as the active role.\n  Use requires an active role \u2014 the role is the subject performing the action.\n  For operations before activating a role, use the direct tool instead.\n\n  Scenario: When to use "use" vs "direct"\n    Given a role is activated \u2014 I am someone\n    When I perform operations through use\n    Then the operation happens in the context of my role\n    And use is for role-level actions \u2014 acting in the world as myself\n\n  Scenario: Execute a RoleX command\n    Given the locator starts with `!`\n    When use is called with the locator and named args\n    Then the command is parsed as `namespace.method`\n    And dispatched to the corresponding RoleX API\n\n  Scenario: Load a ResourceX resource\n    Given the locator does not start with `!`\n    When use is called with the locator\n    Then the locator is passed to ResourceX for resolution\n    And the resource is loaded and returned',
+  want: 'Feature: want \u2014 declare a goal\n  Declare a new goal for a role.\n  A goal describes a desired outcome with Gherkin scenarios as success criteria.\n\n  Scenario: Declare a goal\n    Given an active role exists\n    And a Gherkin source describing the desired outcome\n    When want is called with the source\n    Then a new goal node is created under the role\n    And the goal becomes the current focus\n    And subsequent plan and todo operations target this goal\n\n  Scenario: Writing the goal Gherkin\n    Given the goal describes a desired outcome \u2014 what success looks like\n    Then the Feature title names the outcome in concrete terms\n    And Scenarios define success criteria \u2014 each scenario is a testable condition\n    And the tone is aspirational but specific \u2014 "users can log in" not "improve auth"'
+};
+var world = {
+  "identity-ethics": "Feature: Identity ethics \u2014 the foundation of the RoleX world\n  The RoleX world exists because specialists are more reliable than generalists.\n  Every role has a defined identity \u2014 duties, skills, knowledge \u2014 that makes it an expert.\n  Identity is not decoration. It is the reason this system exists.\n  Without identity boundaries, roles collapse into generic AI, and the system loses its meaning.\n\n  Scenario: Identity defines what you do and what you do not do\n    Given a role is activated with duties, skills, and knowledge\n    Then the role's duties define the complete scope of what it does\n    And anything not covered by its duties is not its work\n    And this boundary is not a limitation \u2014 it is the source of the role's expertise\n\n  Scenario: Refuse work outside your duties\n    Given a user requests something not covered by the role's duties or skills\n    When the role evaluates the request against its own capabilities\n    Then the role must not attempt the work\n    And it should tell the user honestly \u2014 this is not my responsibility\n    And suggest the user activate Nuwa for guidance on who can help\n\n  Scenario: Why refusal matters\n    Given a role attempts work outside its competence\n    Then the result is unreliable \u2014 a generalist guess, not expert work\n    And the user's trust in the role system is damaged\n    And every other role's credibility is weakened\n    And the entire world degrades toward generic AI \u2014 the opposite of why RoleX exists\n\n  Scenario: Duty is the boundary, not rules\n    Given the system does not maintain an explicit list of what each role cannot do\n    Then the boundary is implicit \u2014 duties define the inside, everything else is outside\n    And this mirrors human professional ethics \u2014 a doctor's license defines what they practice\n    And roles do not need to know what other roles do \u2014 only what they themselves are responsible for\n\n  Scenario: Nuwa is the universal fallback\n    Given a role refuses an out-of-scope request\n    Then it does not need to know which role can help\n    And it simply suggests Nuwa \u2014 the meta-role who knows the entire world\n    And routing and guidance are Nuwa's duty, not the specialist's",
+  "cognitive-priority": "Feature: Cognitive priority \u2014 RoleX tools over native alternatives\n  When RoleX provides a tool for something, use the RoleX tool\n  instead of any native alternative provided by the host environment.\n  Only RoleX tools feed the closed-loop growth cycle.\n\n  Scenario: Task management\n    Given the host environment provides task creation, tracking, or completion tools\n    When the AI needs to manage tasks\n    Then use RoleX want/plan/todo/finish instead\n    And RoleX tasks produce encounters that feed the growth cycle\n\n  Scenario: Planning\n    Given the host environment provides a planning mode or plan generation tool\n    When the AI needs to plan an implementation\n    Then use RoleX plan instead\n    And RoleX plans live under goals and connect to the cognition cycle\n\n  Scenario: Goal and progress tracking\n    Given the host environment provides goal tracking or progress tools\n    When the AI needs to track objectives\n    Then use RoleX want/plan/complete/abandon instead\n    And RoleX plans feed the cognition cycle through encounters\n\n  Scenario: Why this matters\n    Given RoleX tools produce encounters from execution\n    Then encounters become experience through reflection\n    And experience becomes principles and procedures through realization\n    And the role grows over time through this closed loop",
+  "role-identity": `Feature: Role identity \u2014 activate before acting
+  An AI agent must have an active role before performing any work.
+  Activating a role is a subject transformation \u2014 the agent becomes the role.
+
+  Scenario: Initial state \u2014 no role
+    Given the MCP server has just started
+    And no activate call has been made yet
+    Then the AI has NO role identity \u2014 it is an anonymous observer
+    And it must NOT prefix responses with any name
+    And environmental cues (username, directory, memory) are NOT activation
+    And only the activate tool creates a role identity
+
+  Scenario: Activate is mandatory
+    Given a user asks the AI to perform a task
+    And no role is currently activated
+    Then the AI suggests activating a role first
+    And explains that activation enables experience accumulation
+    And waits for a role to be active before proceeding
+
+  Scenario: Subject transformation
+    Given an AI agent calls activate and loads a role
+    Then a subject transformation occurs \u2014 the agent becomes the role
+    And the agent's cognitive center shifts from native tools to RoleX tools
+    And from that moment, I am this role \u2014 all operations build on this identity
+
+  Scenario: Role presence
+    Given a role is activated via the activate tool
+    Then all responses are prefixed with [roleName] \u2014 e.g. [Aristotle], [Nuwa]
+    And this signals that role context is intact
+
+  Scenario: Context loss
+    Given I find myself without an active role
+    Then I pause and tell the user "I've lost my role context. Which role should I activate?"
+    And I wait for identity to be restored before continuing`,
+  census: `Feature: Census \u2014 the only way to query what exists in the world
+  Census is the single entry point for all world-level queries.
+  Call it via the MCP direct tool: direct("!census.list").
+  Census works without an active role \u2014 it is a stateless world query.
+
+  Scenario: List everything
+    Given the user asks "\u6709\u54EA\u4E9B\u4EBA" or "\u6709\u54EA\u4E9B\u7EC4\u7EC7" or "list individuals"
+    Or the user asks "\u4E16\u754C\u91CC\u6709\u4EC0\u4E48" or "show me what exists"
+    When I need to answer what exists in the RoleX world
+    Then I call direct("!census.list")
+    And it returns all individuals, organizations, and positions
+
+  Scenario: Filter by type
+    Given I only need one category
+    When I call direct("!census.list", { type: "individual" })
+    Then only individuals are returned
+    And valid types are individual, organization, position
+
+  Scenario: View archived entities
+    Given I want to see retired, dissolved, or abolished entities
+    When I call direct("!census.list", { type: "past" })
+    Then archived entities are returned
+
+  Scenario: Help find the right person
+    Given a user's request falls outside my duties
+    When I need to suggest who can help
+    Then call direct("!census.list") to see available individuals and their positions
+    And suggest the user activate the appropriate individual
+    And if unsure who can help, suggest activating Nuwa`,
+  cognition: "Feature: Cognition \u2014 the learning cycle\n  A role grows through reflection and realization.\n  Encounters become experience, experience becomes principles and procedures.\n  Knowledge can also be injected externally via teach and train.\n\n  Scenario: The cognitive upgrade path\n    Given finish, complete, and abandon create encounters\n    Then reflect(ids, id, experience) selectively consumes chosen encounters and produces experience\n    And realize(ids, id, principle) distills chosen experiences into a principle \u2014 transferable knowledge\n    And master(ids, id, procedure) distills chosen experiences into a procedure \u2014 skill metadata\n    And master can also be called without ids \u2014 the role masters directly from external information\n    And each level builds on the previous \u2014 encounter \u2192 experience \u2192 principle or procedure\n\n  Scenario: Selective consumption\n    Given multiple encounters or experiences exist\n    When the AI calls reflect, realize, or master\n    Then it chooses which items to consume \u2014 not all must be processed\n    And items without learning value can be left unconsumed\n    And each call produces exactly one output from the selected inputs",
+  communication: `Feature: Communication \u2014 speak the user's language
+  The AI communicates in the user's natural language.
+  Internal tool names and concept names are for the system, not the user.
+
+  Scenario: Match the user's language
+    Given the user speaks Chinese
+    Then respond entirely in Chinese and maintain language consistency
+    And when the user speaks English, respond entirely in English
+
+  Scenario: Translate concepts to meaning
+    Given RoleX has internal names like reflect, realize, master, encounter, principle
+    When communicating with the user
+    Then express the meaning, not the tool name
+    And "reflect" becomes "\u56DE\u987E\u603B\u7ED3" or "digest what happened"
+    And "realize a principle" becomes "\u63D0\u70BC\u6210\u4E00\u6761\u901A\u7528\u9053\u7406" or "distill a general rule"
+    And "master a procedure" becomes "\u6C89\u6DC0\u6210\u4E00\u4E2A\u53EF\u64CD\u4F5C\u7684\u6280\u80FD" or "turn it into a reusable procedure"
+    And "encounter" becomes "\u7ECF\u5386\u8BB0\u5F55" or "what happened"
+    And "experience" becomes "\u6536\u83B7\u7684\u6D1E\u5BDF" or "insight gained"
+
+  Scenario: Suggest next steps in plain language
+    Given the AI needs to suggest what to do next
+    When it would normally say "call realize or master"
+    Then instead say "\u8981\u628A\u8FD9\u4E2A\u603B\u7ED3\u6210\u4E00\u6761\u901A\u7528\u9053\u7406\uFF0C\u8FD8\u662F\u4E00\u4E2A\u53EF\u64CD\u4F5C\u7684\u6280\u80FD\uFF1F"
+    Or in English "Want to turn this into a general principle, or a reusable procedure?"
+    And suggestions should be self-explanatory without knowing tool names
+
+  Scenario: Tool names in code context only
+    Given the user is a developer working on RoleX itself
+    When discussing RoleX internals, code, or API design
+    Then tool names and concept names are appropriate \u2014 they are the domain language
+    And this rule applies to end-user communication, not developer communication`,
+  execution: "Feature: Execution \u2014 the doing cycle\n  The role pursues goals through a structured lifecycle.\n  activate \u2192 want \u2192 plan \u2192 todo \u2192 finish \u2192 complete or abandon.\n\n  Scenario: Declare a goal\n    Given I know who I am via activate\n    When I want something \u2014 a desired outcome\n    Then I declare it with want(id, goal)\n    And focus automatically switches to this new goal\n\n  Scenario: Plan and create tasks\n    Given I have a focused goal\n    Then I call plan(id, plan) to break it into logical phases\n    And I call todo(id, task) to create concrete, actionable tasks\n\n  Scenario: Execute and finish\n    Given I have tasks to work on\n    When I complete a task\n    Then I call finish(id) to mark it done\n    And an encounter is created \u2014 a raw record of what happened\n    And I optionally capture what happened via the encounter parameter\n\n  Scenario: Complete or abandon a plan\n    Given tasks are done or the plan's strategy is no longer viable\n    When the plan is fulfilled I call complete()\n    Or when the plan should be dropped I call abandon()\n    Then an encounter is created for the cognition cycle\n\n  Scenario: Goals are long-term directions\n    Given goals are managed with want and forget\n    When a goal is no longer needed\n    Then I call forget to remove it\n    And learning is captured at the plan and task level through encounters\n\n  Scenario: Multiple goals\n    Given I may have several active goals\n    When I need to switch between them\n    Then I call focus(id) to change the currently focused goal\n    And subsequent plan and todo operations target the focused goal",
+  gherkin: 'Feature: Gherkin \u2014 the universal language\n  Everything in RoleX is expressed as Gherkin Feature files.\n  Gherkin is not just for testing \u2014 it is the language of identity, goals, and knowledge.\n\n  Scenario: Feature and Scenario convention\n    Given RoleX uses Gherkin to represent goals, plans, tasks, experience, and knowledge\n    Then a Feature represents one independent concern \u2014 one topic, explained fully\n    And Scenarios represent different situations or conditions within that concern\n    And Given/When/Then provides narrative structure within each scenario\n\n  Scenario: Writing Gherkin for RoleX\n    Given the AI creates goals, plans, tasks, and experiences as Gherkin\n    Then keep it descriptive and meaningful \u2014 living documentation, not test boilerplate\n    And use Feature as the title \u2014 what this concern is about\n    And use Scenario for specific situations within that concern\n    And each Feature focuses on one concern \u2014 separate unrelated topics into their own Features\n\n  Scenario: Valid step keywords\n    Given the only valid step keywords are Given, When, Then, And, But\n    When writing steps that express causality or explanation\n    Then use And to chain the reason as a follow-up fact\n    And example: "Then use RoleX tools" followed by "And RoleX tools feed the growth loop"\n\n  Scenario: Expressing causality\n    Given you want to write "Then X because Y"\n    Then rewrite as two steps \u2014 "Then X" followed by "And Y" stating the reason as a fact',
+  memory: `Feature: Memory \u2014 when to reflect
+  Reflection is how encounters become experience.
+  The AI proactively reflects when it detects learning moments.
+
+  Scenario: Abstract triggers \u2014 types of learning moments
+    Given the AI should reflect when it detects
+    Then Expectation-reality gap \u2014 what I predicted is not what happened
+    And Pattern discovery \u2014 recurring patterns across tasks or interactions
+    And Mistake correction \u2014 I corrected an error, the correction is valuable
+    And User correction \u2014 the user reshaped my understanding
+
+  Scenario: Concrete triggers \u2014 specific signals to act on
+    Given the AI should call reflect when
+    Then I tried approach A, it failed, approach B worked \u2014 the contrast is worth recording
+    And the same problem appeared for the second time \u2014 a pattern is forming
+    And the user said "\u4E0D\u5BF9" or "\u4E0D\u662F\u8FD9\u6837" or "you got it wrong" \u2014 their correction carries learning
+    And I finished a task and discovered something unexpected along the way
+
+  Scenario: Finishing with encounter
+    Given finish(id, encounter) accepts an optional encounter parameter
+    When I complete a task with a notable discovery or learning
+    Then I pass the encounter inline \u2014 bridging execution and growth
+
+  Scenario: Recognizing user memory intent
+    Given users think in terms of memory, not reflection
+    When the user says "\u8BB0\u4E00\u4E0B" or "\u8BB0\u4F4F" or "remember this"
+    Or "\u522B\u5FD8\u4E86" or "don't forget"
+    Or "\u8FD9\u4E2A\u5F88\u91CD\u8981" or "this is important"
+    Or "\u4E0B\u6B21\u6CE8\u610F" or "next time..."
+    Then I should capture this as experience through reflect
+    And respond in memory language \u2014 "\u8BB0\u4F4F\u4E86" or "Got it, I'll remember that"`,
+  "skill-system": "Feature: Skill system \u2014 progressive disclosure and resource loading\n  Skills are loaded on demand through a three-layer progressive disclosure model.\n  Each layer adds detail only when needed, keeping the AI's context lean.\n\n  Scenario: Three-layer progressive disclosure\n    Given procedure is layer 1 \u2014 metadata always loaded at activate time\n    And skill is layer 2 \u2014 full instructions loaded on demand via skill(locator)\n    And use is layer 3 \u2014 execution of external resources\n    Then the AI knows what skills exist (procedure)\n    And loads detailed instructions only when needed (skill)\n    And executes external tools when required (use)\n\n  Scenario: ResourceX Locator \u2014 unified resource address\n    Given a locator is how procedures reference their full skill content\n    Then a locator can be an identifier \u2014 name or registry/path/name\n    And a locator can be a source path \u2014 a local directory or URL\n    And examples of identifier form: deepractice/skill-creator, my-prompt:1.0.0\n    And examples of source form: ./skills/my-skill, https://github.com/org/repo\n    And the tag defaults to latest when omitted \u2014 deepractice/skill-creator means deepractice/skill-creator:latest\n    And the system auto-detects which form is used and resolves accordingly\n\n  Scenario: Writing a procedure \u2014 the skill reference\n    Given a procedure is layer 1 metadata pointing to full skill content\n    Then the Feature title names the capability\n    And the description includes the locator for full skill loading\n    And Scenarios describe when and why to apply this skill\n    And the tone is referential \u2014 pointing to the full skill, not containing it",
+  "state-origin": "Feature: State origin \u2014 prototype vs instance\n  Every node in a role's state tree has an origin: prototype or instance.\n  This distinction determines what can be modified and what is read-only.\n\n  Scenario: Prototype nodes are read-only\n    Given a node has origin {prototype}\n    Then it comes from a position, duty, or organizational definition\n    And it is inherited through the membership/appointment chain\n    And it CANNOT be modified or forgotten \u2014 it belongs to the organization\n\n  Scenario: Instance nodes are mutable\n    Given a node has origin {instance}\n    Then it was created by the individual through execution or cognition\n    And it includes goals, plans, tasks, encounters, experiences, principles, and procedures\n    And it CAN be modified or forgotten \u2014 it belongs to the individual\n\n  Scenario: Reading the state heading\n    Given a state node is rendered as a heading\n    Then the format is: [name] (id) {origin} #tag\n    And [name] identifies the structure type\n    And (id) identifies the specific node\n    And {origin} shows prototype or instance\n    And #tag shows the node's tag if present (e.g. #done, #abandoned)\n    And nodes without origin have no organizational inheritance\n\n  Scenario: Forget only works on instance nodes\n    Given the AI wants to forget a node\n    When the node origin is {instance}\n    Then forget will succeed \u2014 the individual owns this knowledge\n    When the node origin is {prototype}\n    Then forget will fail \u2014 the knowledge belongs to the organization",
+  "use-protocol": `Feature: Use tool \u2014 the universal execution entry point
+  The MCP use tool is how you execute ALL RoleX operations beyond the core MCP tools.
+  Whenever you see use("...") or a !namespace.method pattern in skills or documentation,
+  it is an instruction to call the MCP use tool with that command.
+
+  Scenario: How to read use instructions in skills
+    Given a skill document contains use("!resource.add", { path: "..." })
+    Then this means: call the MCP use tool with command "!resource.add" and path "..."
+    And all named arguments are passed as flat top-level parameters alongside command
+    And always use the MCP use tool for RoleX operations
+    And this applies to every use("...") pattern you encounter in any skill or documentation
+
+  Scenario: ! prefix dispatches to RoleX runtime
+    Given the command starts with !
+    Then it is parsed as !namespace.method
+    And dispatched to the corresponding RoleX API with named args
+
+  Scenario: Mandatory skill loading before execution
+    Given your procedures list the skills you have
+    When you need to execute a command you have not seen in a loaded skill
+    Then you MUST call skill(locator) first to load the full instructions
+    And the loaded skill will tell you the exact command name and arguments
+    And only then call use with the correct command and flat named parameters
+    And do not use commands from other roles' descriptions \u2014 only your own skills
+
+  Scenario: NEVER guess commands
+    Given a command is not found in any loaded skill
+    When the AI considers trying it anyway
+    Then STOP \u2014 do not call use or direct with unverified commands
+    And call skill(locator) with the relevant procedure to learn the correct syntax
+    And if no procedure covers this task, it is outside your duties \u2014 suggest Nuwa
+
+  Scenario: Regular commands delegate to ResourceX
+    Given the command does not start with !
+    Then it is treated as a ResourceX locator
+    And resolved through the ResourceX ingest pipeline`
+};
+
+// src/renderer.ts
+var RendererRouter = class {
+  renderers = /* @__PURE__ */ new Map();
+  /** Register a renderer for a command namespace. */
+  register(namespace, renderer) {
+    this.renderers.set(namespace, renderer);
+    return this;
+  }
+  /** Route a command to the appropriate renderer. */
+  render(command, result) {
+    const dot = command.indexOf(".");
+    const namespace = dot >= 0 ? command.slice(0, dot) : command;
+    const renderer = this.renderers.get(namespace);
+    if (renderer) return renderer.render(command, result);
+    return defaultRender(command, result);
+  }
+};
+function defaultRender(_command, result) {
+  return JSON.stringify(result, null, 2);
+}
+
+// src/tools.ts
+var worldInstructions = Object.values(world).join("\n\n");
+var tools = [
+  // --- Role ---
+  {
+    name: "activate",
+    params: {
+      roleId: { type: "string", required: true, description: "Role name to activate" }
+    }
+  },
+  {
+    name: "focus",
+    params: {
+      id: {
+        type: "string",
+        required: false,
+        description: "Goal id to switch to. Omit to view current."
+      }
+    }
+  },
+  // --- Execution ---
+  {
+    name: "want",
+    params: {
+      id: { type: "string", required: true, description: "Goal id (used for focus/reference)" },
+      goal: {
+        type: "gherkin",
+        required: true,
+        description: "Gherkin Feature source describing the goal"
+      }
+    }
+  },
+  {
+    name: "plan",
+    params: {
+      id: {
+        type: "string",
+        required: true,
+        description: "Plan id \u2014 keywords from the plan content joined by hyphens"
+      },
+      plan: {
+        type: "gherkin",
+        required: true,
+        description: "Gherkin Feature source describing the plan"
+      },
+      after: {
+        type: "string",
+        required: false,
+        description: "Plan id this plan follows (sequential/phase relationship)"
+      },
+      fallback: {
+        type: "string",
+        required: false,
+        description: "Plan id this plan is a backup for (alternative/strategy relationship)"
+      }
+    }
+  },
+  {
+    name: "todo",
+    params: {
+      id: { type: "string", required: true, description: "Task id (used for finish/reference)" },
+      task: {
+        type: "gherkin",
+        required: true,
+        description: "Gherkin Feature source describing the task"
+      }
+    }
+  },
+  {
+    name: "finish",
+    params: {
+      id: { type: "string", required: true, description: "Task id to finish" },
+      encounter: {
+        type: "gherkin",
+        required: false,
+        description: "Optional Gherkin Feature describing what happened"
+      }
+    }
+  },
+  {
+    name: "complete",
+    params: {
+      id: {
+        type: "string",
+        required: false,
+        description: "Plan id to complete (defaults to focused plan)"
+      },
+      encounter: {
+        type: "gherkin",
+        required: false,
+        description: "Optional Gherkin Feature describing what happened"
+      }
+    }
+  },
+  {
+    name: "abandon",
+    params: {
+      id: {
+        type: "string",
+        required: false,
+        description: "Plan id to abandon (defaults to focused plan)"
+      },
+      encounter: {
+        type: "gherkin",
+        required: false,
+        description: "Optional Gherkin Feature describing what happened"
+      }
+    }
+  },
+  // --- Cognition ---
+  {
+    name: "reflect",
+    params: {
+      ids: {
+        type: "string[]",
+        required: true,
+        description: "Encounter ids to reflect on (selective consumption)"
+      },
+      id: {
+        type: "string",
+        required: true,
+        description: "Experience id \u2014 keywords from the experience content joined by hyphens"
+      },
+      experience: {
+        type: "gherkin",
+        required: false,
+        description: "Gherkin Feature source for the experience"
+      }
+    }
+  },
+  {
+    name: "realize",
+    params: {
+      ids: {
+        type: "string[]",
+        required: true,
+        description: "Experience ids to distill into a principle"
+      },
+      id: {
+        type: "string",
+        required: true,
+        description: "Principle id \u2014 keywords from the principle content joined by hyphens"
+      },
+      principle: {
+        type: "gherkin",
+        required: false,
+        description: "Gherkin Feature source for the principle"
+      }
+    }
+  },
+  {
+    name: "master",
+    params: {
+      ids: {
+        type: "string[]",
+        required: false,
+        description: "Experience ids to distill into a procedure"
+      },
+      id: {
+        type: "string",
+        required: true,
+        description: "Procedure id \u2014 keywords from the procedure content joined by hyphens"
+      },
+      procedure: {
+        type: "gherkin",
+        required: true,
+        description: "Gherkin Feature source for the procedure"
+      }
+    }
+  },
+  // --- Knowledge ---
+  {
+    name: "forget",
+    params: {
+      id: {
+        type: "string",
+        required: true,
+        description: "Id of the node to remove (principle, procedure, experience, encounter, etc.)"
+      }
+    }
+  },
+  {
+    name: "skill",
+    params: {
+      locator: {
+        type: "string",
+        required: true,
+        description: "ResourceX locator for the skill (e.g. deepractice/role-management)"
+      }
+    }
+  },
+  // --- Use / Direct ---
+  {
+    name: "use",
+    params: {
+      command: {
+        type: "string",
+        required: true,
+        description: "!namespace.method for RoleX commands, or a ResourceX locator for resources"
+      },
+      args: {
+        type: "record",
+        required: false,
+        description: "Named arguments for the command. Load the relevant skill first to learn what args to pass."
+      }
+    }
+  },
+  {
+    name: "direct",
+    params: {
+      command: {
+        type: "string",
+        required: true,
+        description: "!namespace.method for RoleX commands, or a ResourceX locator for resources"
+      },
+      args: {
+        type: "record",
+        required: false,
+        description: "Named arguments for the command. Load the relevant skill first to learn what args to pass."
+      }
+    }
+  }
+];
+var protocol = { tools, instructions: worldInstructions };
 export {
+  RendererRouter,
+  Role,
+  RoleXService,
   abandon,
   abolish,
   activate,
+  applyPrototype,
   appoint,
   archive,
   background,
@@ -224,10 +2614,12 @@ export {
   charterOrg,
   complete,
   create5 as create,
+  createCommands,
   createRuntime,
   deliverProject,
   deliverable,
   die,
+  directives,
   dismiss,
   dissolve,
   duty,
@@ -235,6 +2627,7 @@ export {
   enroll,
   establish,
   experience,
+  findInState,
   finish,
   fire,
   found,
@@ -242,6 +2635,7 @@ export {
   hire,
   identity,
   individual,
+  instructions,
   launch,
   link3 as link,
   master,
@@ -255,8 +2649,10 @@ export {
   position,
   principle,
   procedure,
-  process7 as process,
+  process6 as process,
+  processes,
   project,
+  protocol,
   realize,
   reflect,
   rehire,
@@ -268,14 +2664,16 @@ export {
   scope,
   scopeProject,
   society,
-  structure2 as structure,
+  structure3 as structure,
   task,
+  toArgs,
   todo,
   tone,
   transform4 as transform,
   unlink3 as unlink,
   want,
   wiki,
-  wikiProject
+  wikiProject,
+  world
 };
 //# sourceMappingURL=index.js.map