@rolexjs/mcp-server 0.6.0 → 0.7.0

package/dist/index.js

@@ -21,6 +21,12 @@ import {
   DESC_FINISH,
   renderFeatures,
   renderFeature,
+  renderStatusBar,
+  renderError,
+  next,
+  NEXT,
+  nextHire,
+  nextFinish,
   bootstrap
 } from "rolexjs";
 import { LocalPlatform } from "@rolexjs/local-platform";
@@ -32,6 +38,7 @@ var platform = new LocalPlatform(rolexDir);
 bootstrap(platform);
 var rolex = new Rolex(platform);
 var currentRole = null;
+var currentRoleName = "";
 var server = new FastMCP({
   name: "Rolex MCP Server",
   version: "0.1.0",
@@ -43,6 +50,15 @@ function requireRole() {
   }
   return currentRole;
 }
+function safeTool(toolName, fn) {
+  return async (args) => {
+    try {
+      return await fn(args);
+    } catch (error) {
+      throw new Error(renderError(toolName, error));
+    }
+  };
+}
 server.addTool({
   name: "society",
   description: DESC_SOCIETY,
@@ -54,17 +70,17 @@ server.addTool({
     type: z.enum(["knowledge", "experience", "voice"]).optional().describe("Growth dimension for teach operation"),
     dimensionName: z.string().optional().describe("Name for the knowledge being taught (e.g. 'distributed-systems')")
   }),
-  execute: async ({ operation, name, source, roleId, type, dimensionName }) => {
+  execute: safeTool("society", async ({ operation, name, source, roleId, type, dimensionName }) => {
     switch (operation) {
       case "born": {
         if (!name || !source) throw new Error("born requires: name, source");
         const feature = rolex.born(name, source);
-        return `Role born: ${feature.name}`;
+        return next(`Role born: ${feature.name}`, NEXT.born);
       }
       case "found": {
         if (!name) throw new Error("found requires: name");
         rolex.found(name);
-        return `Organization founded: ${name}`;
+        return next(`Organization founded: ${name}`, NEXT.found);
       }
       case "directory": {
         const dir = rolex.directory();
@@ -77,7 +93,15 @@ server.addTool({
             lines.push(`  - ${role.name} (team: ${role.team})`);
           }
         }
-        return lines.join("\n") || "No organizations found.";
+        const unaffiliated = dir.roles.filter((r) => !r.team);
+        if (unaffiliated.length > 0) {
+          lines.push("");
+          lines.push("Unaffiliated:");
+          for (const role of unaffiliated) {
+            lines.push(`  - ${role.name}`);
+          }
+        }
+        return lines.join("\n") || "No roles or organizations found.";
       }
       case "find": {
         if (!name) throw new Error("find requires: name");
@@ -93,12 +117,12 @@ server.addTool({
         if (!roleId || !type || !dimensionName || !source)
           throw new Error("teach requires: roleId, type, dimensionName, source");
         const feature = rolex.teach(roleId, type, dimensionName, source);
-        return `Taught ${type}: ${feature.name}`;
+        return next(`Taught ${type}: ${feature.name}`, NEXT.teach);
       }
       default:
         throw new Error(`Unknown society operation: ${operation}`);
     }
-  }
+  })
 });
 server.addTool({
   name: "organization",
@@ -107,22 +131,22 @@ server.addTool({
     operation: z.enum(["hire", "fire"]).describe("The organization operation to perform"),
     name: z.string().describe("Role name to hire or fire")
   }),
-  execute: async ({ operation, name }) => {
+  execute: safeTool("organization", async ({ operation, name }) => {
     const dir = rolex.directory();
     const org = rolex.find(dir.organizations[0].name);
     switch (operation) {
       case "hire": {
         org.hire(name);
-        return `Role hired: ${name}`;
+        return next(`Role hired: ${name}`, nextHire(name));
       }
       case "fire": {
         org.fire(name);
-        return `Role fired: ${name}`;
+        return next(`Role fired: ${name}`, NEXT.fire);
       }
       default:
         throw new Error(`Unknown organization operation: ${operation}`);
     }
-  }
+  })
 });
 server.addTool({
   name: "identity",
@@ -130,11 +154,16 @@ server.addTool({
   parameters: z.object({
     roleId: z.string().describe("Role name (e.g. 'sean')")
   }),
-  execute: async ({ roleId }) => {
+  execute: safeTool("identity", async ({ roleId }) => {
     currentRole = rolex.role(roleId);
+    currentRoleName = roleId;
     const features = currentRole.identity();
-    return renderFeatures(features);
-  }
+    const { current } = currentRole.focus();
+    const statusBar = renderStatusBar(roleId, current);
+    return `${statusBar}
+
+${renderFeatures(features)}`;
+  })
 });
 server.addTool({
   name: "growup",
@@ -146,11 +175,11 @@ server.addTool({
     name: z.string().describe("Name for this growth (used as filename, e.g. 'distributed-systems')"),
     source: z.string().describe("Gherkin feature source text")
   }),
-  execute: async ({ type, name, source }) => {
+  execute: safeTool("growup", async ({ type, name, source }) => {
     const role = requireRole();
     const feature = role.growup(type, name, source);
-    return `Growth added (${type}): ${feature.name}`;
-  }
+    return next(`Growth added (${type}): ${feature.name}`, NEXT.growup);
+  })
 });
 server.addTool({
   name: "focus",
@@ -158,11 +187,15 @@ server.addTool({
   parameters: z.object({
     name: z.string().optional().describe("Optional goal name to switch focus to")
   }),
-  execute: async ({ name }) => {
+  execute: safeTool("focus", async ({ name }) => {
     const role = requireRole();
     const { current, otherGoals } = role.focus(name);
-    if (!current && otherGoals.length === 0) return "No active goal. Use want() to set a new goal.";
-    const parts = [];
+    const statusBar = renderStatusBar(currentRoleName, current);
+    if (!current && otherGoals.length === 0)
+      return `${statusBar}
+
+No active goal. Use want() to set a new goal.`;
+    const parts = [statusBar];
     if (current) {
       parts.push(renderFeature(current));
       if (current.plan) {
@@ -179,7 +212,7 @@ server.addTool({
       }
     }
     return parts.join("\n\n");
-  }
+  })
 });
 server.addTool({
   name: "want",
@@ -189,11 +222,11 @@ server.addTool({
     source: z.string().describe("Gherkin feature source text for the goal"),
     testable: z.boolean().optional().default(false).describe("Whether this goal's scenarios should become persistent automated verification")
   }),
-  execute: async ({ name, source, testable }) => {
+  execute: safeTool("want", async ({ name, source, testable }) => {
     const role = requireRole();
     const goal = role.want(name, source, testable);
-    return `Goal created: ${goal.name}`;
-  }
+    return next(`Goal created: ${goal.name}`, NEXT.want);
+  })
 });
 server.addTool({
   name: "plan",
@@ -201,11 +234,11 @@ server.addTool({
   parameters: z.object({
     source: z.string().describe("Gherkin feature source text for the plan")
   }),
-  execute: async ({ source }) => {
+  execute: safeTool("plan", async ({ source }) => {
     const role = requireRole();
     const p = role.plan(source);
-    return `Plan created: ${p.name}`;
-  }
+    return next(`Plan created: ${p.name}`, NEXT.plan);
+  })
 });
 server.addTool({
   name: "todo",
@@ -215,11 +248,11 @@ server.addTool({
     source: z.string().describe("Gherkin feature source text for the task"),
     testable: z.boolean().optional().default(false).describe("Whether this task's scenarios should become unit or integration tests")
   }),
-  execute: async ({ name, source, testable }) => {
+  execute: safeTool("todo", async ({ name, source, testable }) => {
     const role = requireRole();
     const task = role.todo(name, source, testable);
-    return `Task created: ${task.name}`;
-  }
+    return next(`Task created: ${task.name}`, NEXT.todo);
+  })
 });
 server.addTool({
   name: "achieve",
@@ -229,11 +262,12 @@ server.addTool({
       "Optional Gherkin feature source capturing what was learned \u2014 auto-saved as experience growup"
     )
   }),
-  execute: async ({ experience }) => {
+  execute: safeTool("achieve", async ({ experience }) => {
     const role = requireRole();
     role.achieve(experience);
-    return experience ? "Goal achieved. Experience captured." : "Goal achieved.";
-  }
+    const msg = experience ? "Goal achieved. Experience captured." : "Goal achieved.";
+    return next(msg, NEXT.achieve);
+  })
 });
 server.addTool({
   name: "abandon",
@@ -243,11 +277,12 @@ server.addTool({
       "Optional Gherkin feature source capturing what was learned \u2014 auto-saved as experience growup"
     )
   }),
-  execute: async ({ experience }) => {
+  execute: safeTool("abandon", async ({ experience }) => {
     const role = requireRole();
     role.abandon(experience);
-    return experience ? "Goal abandoned. Experience captured." : "Goal abandoned.";
-  }
+    const msg = experience ? "Goal abandoned. Experience captured." : "Goal abandoned.";
+    return next(msg, NEXT.abandon);
+  })
 });
 server.addTool({
   name: "reflect",
@@ -261,11 +296,14 @@ server.addTool({
     ),
     knowledgeSource: z.string().describe("Gherkin feature source text for the knowledge")
   }),
-  execute: async ({ experienceNames, knowledgeName, knowledgeSource }) => {
+  execute: safeTool("reflect", async ({ experienceNames, knowledgeName, knowledgeSource }) => {
     const role = requireRole();
     const feature = role.reflect(experienceNames, knowledgeName, knowledgeSource);
-    return `Reflected: ${experienceNames.length} experience(s) \u2192 knowledge "${feature.name}"`;
-  }
+    return next(
+      `Reflected: ${experienceNames.length} experience(s) \u2192 knowledge "${feature.name}"`,
+      NEXT.reflect
+    );
+  })
 });
 server.addTool({
   name: "finish",
@@ -273,11 +311,13 @@ server.addTool({
   parameters: z.object({
     name: z.string().describe("Task name to mark as done")
   }),
-  execute: async ({ name }) => {
+  execute: safeTool("finish", async ({ name }) => {
     const role = requireRole();
     role.finish(name);
-    return `Task finished: ${name}`;
-  }
+    const { current } = role.focus();
+    const remaining = current ? current.tasks.filter((t) => !t.tags?.some((tag) => tag.name === "@done")).length : -1;
+    return next(`Task finished: ${name}`, remaining >= 0 ? nextFinish(remaining) : NEXT.achieve);
+  })
 });
 server.start({
   transportType: "stdio"

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @rolexjs/mcp-server\n *\n * MCP server for Rolex — Role-Driven Development.\n *\n * Tools:\n *   society      — Admin: born, found, directory, find, teach\n *   organization — Admin: hire, fire\n *   identity     — Activate a role\n *   growup/focus/want/plan/todo/achieve/abandon/finish — Role lifecycle\n *\n * Usage:\n *   rolex-mcp [.rolex-dir]\n */\n\nimport { FastMCP } from \"fastmcp\";\nimport { z } from \"zod\";\nimport {\n  Rolex,\n  Organization,\n  Role,\n  INSTRUCTIONS,\n  DESC_SOCIETY,\n  DESC_ORGANIZATION,\n  DESC_GROWUP,\n  DESC_IDENTITY,\n  DESC_FOCUS,\n  DESC_WANT,\n  DESC_PLAN,\n  DESC_TODO,\n  DESC_ACHIEVE,\n  DESC_ABANDON,\n  DESC_REFLECT,\n  DESC_FINISH,\n  renderFeatures,\n  renderFeature,\n  bootstrap,\n} from \"rolexjs\";\nimport { LocalPlatform } from \"@rolexjs/local-platform\";\n\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nconst DEFAULT_ROLEX_DIR = join(homedir(), \".rolex\");\nconst rolexDir = process.argv[2] || process.env.ROLEX_DIR || DEFAULT_ROLEX_DIR;\nconst platform = new LocalPlatform(rolexDir);\nbootstrap(platform);\nconst rolex = new Rolex(platform);\nlet currentRole: Role | null = null;\n\nconst server = new FastMCP({\n  name: \"Rolex MCP Server\",\n  version: \"0.1.0\",\n  instructions: INSTRUCTIONS,\n});\n\n// ========== Helpers ==========\n\nfunction requireRole(): Role {\n  if (!currentRole) {\n    throw new Error(\"No active role. Call identity(roleId) first to activate a role.\");\n  }\n  return currentRole;\n}\n\n// ========== Society (folded) ==========\n\nserver.addTool({\n  name: \"society\",\n  description: DESC_SOCIETY,\n  parameters: z.object({\n    operation: z\n      .enum([\"born\", \"found\", \"directory\", \"find\", \"teach\"])\n      .describe(\"The society operation to perform\"),\n    name: z\n      .string()\n      .optional()\n      .describe(\"Role name (born/find/teach) or organization name (found)\"),\n    source: z\n      .string()\n      .optional()\n      .describe(\"Gherkin feature source (born: persona, teach: knowledge)\"),\n    roleId: z.string().optional().describe(\"Target role name for teach operation\"),\n    type: z\n      .enum([\"knowledge\", \"experience\", \"voice\"])\n      .optional()\n      .describe(\"Growth dimension for teach operation\"),\n    dimensionName: z\n      .string()\n      .optional()\n      .describe(\"Name for the knowledge being taught (e.g. 'distributed-systems')\"),\n  }),\n  execute: async ({ operation, name, source, roleId, type, dimensionName }) => {\n    switch (operation) {\n      case \"born\": {\n        if (!name || !source) throw new Error(\"born requires: name, source\");\n        const feature = rolex.born(name, source);\n        return `Role born: ${feature.name}`;\n      }\n      case \"found\": {\n        if (!name) throw new Error(\"found requires: name\");\n        rolex.found(name);\n        return `Organization founded: ${name}`;\n      }\n      case \"directory\": {\n        const dir = rolex.directory();\n        const lines: string[] = [];\n        for (const entry of dir.organizations) {\n          const orgInstance = rolex.find(entry.name) as Organization;\n          const info = orgInstance.info();\n          lines.push(`Organization: ${info.name}`);\n          for (const role of info.roles) {\n            lines.push(`  - ${role.name} (team: ${role.team})`);\n          }\n        }\n        return lines.join(\"\\n\") || \"No organizations found.\";\n      }\n      case \"find\": {\n        if (!name) throw new Error(\"find requires: name\");\n        const result = rolex.find(name);\n        if (result instanceof Organization) {\n          const info = result.info();\n          return `Organization: ${info.name} (${info.roles.length} roles)`;\n        }\n        const features = (result as Role).identity();\n        return renderFeatures(features);\n      }\n      case \"teach\": {\n        if (!roleId || !type || !dimensionName || !source)\n          throw new Error(\"teach requires: roleId, type, dimensionName, source\");\n        const feature = rolex.teach(roleId, type, dimensionName, source);\n        return `Taught ${type}: ${feature.name}`;\n      }\n      default:\n        throw new Error(`Unknown society operation: ${operation}`);\n    }\n  },\n});\n\n// ========== Organization (folded) ==========\n\nserver.addTool({\n  name: \"organization\",\n  description: DESC_ORGANIZATION,\n  parameters: z.object({\n    operation: z.enum([\"hire\", \"fire\"]).describe(\"The organization operation to perform\"),\n    name: z.string().describe(\"Role name to hire or fire\"),\n  }),\n  execute: async ({ operation, name }) => {\n    const dir = rolex.directory();\n    const org = rolex.find(dir.organizations[0].name) as Organization;\n\n    switch (operation) {\n      case \"hire\": {\n        org.hire(name);\n        return `Role hired: ${name}`;\n      }\n      case \"fire\": {\n        org.fire(name);\n        return `Role fired: ${name}`;\n      }\n      default:\n        throw new Error(`Unknown organization operation: ${operation}`);\n    }\n  },\n});\n\n// ========== Role Activation ==========\n\nserver.addTool({\n  name: \"identity\",\n  description: DESC_IDENTITY,\n  parameters: z.object({\n    roleId: z.string().describe(\"Role name (e.g. 'sean')\"),\n  }),\n  execute: async ({ roleId }) => {\n    currentRole = rolex.role(roleId);\n    const features = currentRole.identity();\n    return renderFeatures(features);\n  },\n});\n\n// ========== Role Tools ==========\n\nserver.addTool({\n  name: \"growup\",\n  description: DESC_GROWUP,\n  parameters: z.object({\n    type: z\n      .enum([\"knowledge\", \"experience\", \"voice\"])\n      .describe(\n        \"Growth dimension: knowledge (what I know), experience (what I've lived), voice (how I'm perceived)\"\n      ),\n    name: z\n      .string()\n      .describe(\"Name for this growth (used as filename, e.g. 'distributed-systems')\"),\n    source: z.string().describe(\"Gherkin feature source text\"),\n  }),\n  execute: async ({ type, name, source }) => {\n    const role = requireRole();\n    const feature = role.growup(type, name, source);\n    return `Growth added (${type}): ${feature.name}`;\n  },\n});\n\nserver.addTool({\n  name: \"focus\",\n  description: DESC_FOCUS,\n  parameters: z.object({\n    name: z.string().optional().describe(\"Optional goal name to switch focus to\"),\n  }),\n  execute: async ({ name }) => {\n    const role = requireRole();\n    const { current, otherGoals } = role.focus(name);\n    if (!current && otherGoals.length === 0) return \"No active goal. Use want() to set a new goal.\";\n\n    const parts: string[] = [];\n\n    if (current) {\n      parts.push(renderFeature(current));\n      if (current.plan) {\n        parts.push(renderFeature(current.plan));\n      }\n      for (const task of current.tasks) {\n        parts.push(renderFeature(task));\n      }\n    }\n\n    if (otherGoals.length > 0) {\n      parts.push(\"Other active goals:\");\n      for (const g of otherGoals) {\n        parts.push(`  - ${g.name}`);\n      }\n    }\n\n    return parts.join(\"\\n\\n\");\n  },\n});\n\nserver.addTool({\n  name: \"want\",\n  description: DESC_WANT,\n  parameters: z.object({\n    name: z.string().describe(\"Goal name (used as directory name, e.g. 'local-platform')\"),\n    source: z.string().describe(\"Gherkin feature source text for the goal\"),\n    testable: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Whether this goal's scenarios should become persistent automated verification\"),\n  }),\n  execute: async ({ name, source, testable }) => {\n    const role = requireRole();\n    const goal = role.want(name, source, testable);\n    return `Goal created: ${goal.name}`;\n  },\n});\n\nserver.addTool({\n  name: \"plan\",\n  description: DESC_PLAN,\n  parameters: z.object({\n    source: z.string().describe(\"Gherkin feature source text for the plan\"),\n  }),\n  execute: async ({ source }) => {\n    const role = requireRole();\n    const p = role.plan(source);\n    return `Plan created: ${p.name}`;\n  },\n});\n\nserver.addTool({\n  name: \"todo\",\n  description: DESC_TODO,\n  parameters: z.object({\n    name: z.string().describe(\"Task name (used as filename, e.g. 'implement-loader')\"),\n    source: z.string().describe(\"Gherkin feature source text for the task\"),\n    testable: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Whether this task's scenarios should become unit or integration tests\"),\n  }),\n  execute: async ({ name, source, testable }) => {\n    const role = requireRole();\n    const task = role.todo(name, source, testable);\n    return `Task created: ${task.name}`;\n  },\n});\n\nserver.addTool({\n  name: \"achieve\",\n  description: DESC_ACHIEVE,\n  parameters: z.object({\n    experience: z\n      .string()\n      .optional()\n      .describe(\n        \"Optional Gherkin feature source capturing what was learned — auto-saved as experience growup\"\n      ),\n  }),\n  execute: async ({ experience }) => {\n    const role = requireRole();\n    role.achieve(experience);\n    return experience ? \"Goal achieved. Experience captured.\" : \"Goal achieved.\";\n  },\n});\n\nserver.addTool({\n  name: \"abandon\",\n  description: DESC_ABANDON,\n  parameters: z.object({\n    experience: z\n      .string()\n      .optional()\n      .describe(\n        \"Optional Gherkin feature source capturing what was learned — auto-saved as experience growup\"\n      ),\n  }),\n  execute: async ({ experience }) => {\n    const role = requireRole();\n    role.abandon(experience);\n    return experience ? \"Goal abandoned. Experience captured.\" : \"Goal abandoned.\";\n  },\n});\n\nserver.addTool({\n  name: \"reflect\",\n  description: DESC_REFLECT,\n  parameters: z.object({\n    experienceNames: z\n      .array(z.string())\n      .describe(\n        \"Names of experience files to distill (without .experience.identity.feature suffix)\"\n      ),\n    knowledgeName: z\n      .string()\n      .describe(\n        \"Name for the resulting knowledge (used as filename, e.g. 'authentication-principles')\"\n      ),\n    knowledgeSource: z.string().describe(\"Gherkin feature source text for the knowledge\"),\n  }),\n  execute: async ({ experienceNames, knowledgeName, knowledgeSource }) => {\n    const role = requireRole();\n    const feature = role.reflect(experienceNames, knowledgeName, knowledgeSource);\n    return `Reflected: ${experienceNames.length} experience(s) → knowledge \"${feature.name}\"`;\n  },\n});\n\nserver.addTool({\n  name: \"finish\",\n  description: DESC_FINISH,\n  parameters: z.object({\n    name: z.string().describe(\"Task name to mark as done\"),\n  }),\n  execute: async ({ name }) => {\n    const role = requireRole();\n    role.finish(name);\n    return `Task finished: ${name}`;\n  },\n});\n\nserver.start({\n  transportType: \"stdio\",\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @rolexjs/mcp-server\n *\n * MCP server for Rolex — Role-Driven Development.\n *\n * Tools:\n *   society      — Admin: born, found, directory, find, teach\n *   organization — Admin: hire, fire\n *   identity     — Activate a role\n *   growup/focus/want/plan/todo/achieve/abandon/finish — Role lifecycle\n *\n * Usage:\n *   rolex-mcp [.rolex-dir]\n */\n\nimport { FastMCP } from \"fastmcp\";\nimport { z } from \"zod\";\nimport {\n  Rolex,\n  Organization,\n  Role,\n  INSTRUCTIONS,\n  DESC_SOCIETY,\n  DESC_ORGANIZATION,\n  DESC_GROWUP,\n  DESC_IDENTITY,\n  DESC_FOCUS,\n  DESC_WANT,\n  DESC_PLAN,\n  DESC_TODO,\n  DESC_ACHIEVE,\n  DESC_ABANDON,\n  DESC_REFLECT,\n  DESC_FINISH,\n  renderFeatures,\n  renderFeature,\n  renderStatusBar,\n  renderError,\n  next,\n  NEXT,\n  nextHire,\n  nextFinish,\n  bootstrap,\n} from \"rolexjs\";\nimport { LocalPlatform } from \"@rolexjs/local-platform\";\n\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nconst DEFAULT_ROLEX_DIR = join(homedir(), \".rolex\");\nconst rolexDir = process.argv[2] || process.env.ROLEX_DIR || DEFAULT_ROLEX_DIR;\nconst platform = new LocalPlatform(rolexDir);\nbootstrap(platform);\nconst rolex = new Rolex(platform);\nlet currentRole: Role | null = null;\nlet currentRoleName: string = \"\";\n\nconst server = new FastMCP({\n  name: \"Rolex MCP Server\",\n  version: \"0.1.0\",\n  instructions: INSTRUCTIONS,\n});\n\n// ========== Helpers ==========\n\nfunction requireRole(): Role {\n  if (!currentRole) {\n    throw new Error(\"No active role. Call identity(roleId) first to activate a role.\");\n  }\n  return currentRole;\n}\n\n/**\n * Wrap a tool execute function with unified error handling.\n * Catches errors and renders them as formatted markdown.\n */\nfunction safeTool<T>(\n  toolName: string,\n  fn: (args: T) => Promise<string>\n): (args: T) => Promise<string> {\n  return async (args: T) => {\n    try {\n      return await fn(args);\n    } catch (error) {\n      throw new Error(renderError(toolName, error));\n    }\n  };\n}\n\n// ========== Society (folded) ==========\n\nserver.addTool({\n  name: \"society\",\n  description: DESC_SOCIETY,\n  parameters: z.object({\n    operation: z\n      .enum([\"born\", \"found\", \"directory\", \"find\", \"teach\"])\n      .describe(\"The society operation to perform\"),\n    name: z\n      .string()\n      .optional()\n      .describe(\"Role name (born/find/teach) or organization name (found)\"),\n    source: z\n      .string()\n      .optional()\n      .describe(\"Gherkin feature source (born: persona, teach: knowledge)\"),\n    roleId: z.string().optional().describe(\"Target role name for teach operation\"),\n    type: z\n      .enum([\"knowledge\", \"experience\", \"voice\"])\n      .optional()\n      .describe(\"Growth dimension for teach operation\"),\n    dimensionName: z\n      .string()\n      .optional()\n      .describe(\"Name for the knowledge being taught (e.g. 'distributed-systems')\"),\n  }),\n  execute: safeTool(\"society\", async ({ operation, name, source, roleId, type, dimensionName }) => {\n    switch (operation) {\n      case \"born\": {\n        if (!name || !source) throw new Error(\"born requires: name, source\");\n        const feature = rolex.born(name, source);\n        return next(`Role born: ${feature.name}`, NEXT.born);\n      }\n      case \"found\": {\n        if (!name) throw new Error(\"found requires: name\");\n        rolex.found(name);\n        return next(`Organization founded: ${name}`, NEXT.found);\n      }\n      case \"directory\": {\n        const dir = rolex.directory();\n        const lines: string[] = [];\n\n        // Organizations and their hired roles\n        for (const entry of dir.organizations) {\n          const orgInstance = rolex.find(entry.name) as Organization;\n          const info = orgInstance.info();\n          lines.push(`Organization: ${info.name}`);\n          for (const role of info.roles) {\n            lines.push(`  - ${role.name} (team: ${role.team})`);\n          }\n        }\n\n        // Unaffiliated roles (born but not hired)\n        const unaffiliated = dir.roles.filter((r) => !r.team);\n        if (unaffiliated.length > 0) {\n          lines.push(\"\");\n          lines.push(\"Unaffiliated:\");\n          for (const role of unaffiliated) {\n            lines.push(`  - ${role.name}`);\n          }\n        }\n\n        return lines.join(\"\\n\") || \"No roles or organizations found.\";\n      }\n      case \"find\": {\n        if (!name) throw new Error(\"find requires: name\");\n        const result = rolex.find(name);\n        if (result instanceof Organization) {\n          const info = result.info();\n          return `Organization: ${info.name} (${info.roles.length} roles)`;\n        }\n        const features = (result as Role).identity();\n        return renderFeatures(features);\n      }\n      case \"teach\": {\n        if (!roleId || !type || !dimensionName || !source)\n          throw new Error(\"teach requires: roleId, type, dimensionName, source\");\n        const feature = rolex.teach(roleId, type, dimensionName, source);\n        return next(`Taught ${type}: ${feature.name}`, NEXT.teach);\n      }\n      default:\n        throw new Error(`Unknown society operation: ${operation}`);\n    }\n  }),\n});\n\n// ========== Organization (folded) ==========\n\nserver.addTool({\n  name: \"organization\",\n  description: DESC_ORGANIZATION,\n  parameters: z.object({\n    operation: z.enum([\"hire\", \"fire\"]).describe(\"The organization operation to perform\"),\n    name: z.string().describe(\"Role name to hire or fire\"),\n  }),\n  execute: safeTool(\"organization\", async ({ operation, name }) => {\n    const dir = rolex.directory();\n    const org = rolex.find(dir.organizations[0].name) as Organization;\n\n    switch (operation) {\n      case \"hire\": {\n        org.hire(name);\n        return next(`Role hired: ${name}`, nextHire(name));\n      }\n      case \"fire\": {\n        org.fire(name);\n        return next(`Role fired: ${name}`, NEXT.fire);\n      }\n      default:\n        throw new Error(`Unknown organization operation: ${operation}`);\n    }\n  }),\n});\n\n// ========== Role Activation ==========\n\nserver.addTool({\n  name: \"identity\",\n  description: DESC_IDENTITY,\n  parameters: z.object({\n    roleId: z.string().describe(\"Role name (e.g. 'sean')\"),\n  }),\n  execute: safeTool(\"identity\", async ({ roleId }) => {\n    currentRole = rolex.role(roleId);\n    currentRoleName = roleId;\n    const features = currentRole.identity();\n    const { current } = currentRole.focus();\n    const statusBar = renderStatusBar(roleId, current);\n    return `${statusBar}\\n\\n${renderFeatures(features)}`;\n  }),\n});\n\n// ========== Role Tools ==========\n\nserver.addTool({\n  name: \"growup\",\n  description: DESC_GROWUP,\n  parameters: z.object({\n    type: z\n      .enum([\"knowledge\", \"experience\", \"voice\"])\n      .describe(\n        \"Growth dimension: knowledge (what I know), experience (what I've lived), voice (how I'm perceived)\"\n      ),\n    name: z\n      .string()\n      .describe(\"Name for this growth (used as filename, e.g. 'distributed-systems')\"),\n    source: z.string().describe(\"Gherkin feature source text\"),\n  }),\n  execute: safeTool(\"growup\", async ({ type, name, source }) => {\n    const role = requireRole();\n    const feature = role.growup(type, name, source);\n    return next(`Growth added (${type}): ${feature.name}`, NEXT.growup);\n  }),\n});\n\nserver.addTool({\n  name: \"focus\",\n  description: DESC_FOCUS,\n  parameters: z.object({\n    name: z.string().optional().describe(\"Optional goal name to switch focus to\"),\n  }),\n  execute: safeTool(\"focus\", async ({ name }) => {\n    const role = requireRole();\n    const { current, otherGoals } = role.focus(name);\n\n    const statusBar = renderStatusBar(currentRoleName, current);\n\n    if (!current && otherGoals.length === 0)\n      return `${statusBar}\\n\\nNo active goal. Use want() to set a new goal.`;\n\n    const parts: string[] = [statusBar];\n\n    if (current) {\n      parts.push(renderFeature(current));\n      if (current.plan) {\n        parts.push(renderFeature(current.plan));\n      }\n      for (const task of current.tasks) {\n        parts.push(renderFeature(task));\n      }\n    }\n\n    if (otherGoals.length > 0) {\n      parts.push(\"Other active goals:\");\n      for (const g of otherGoals) {\n        parts.push(`  - ${g.name}`);\n      }\n    }\n\n    return parts.join(\"\\n\\n\");\n  }),\n});\n\nserver.addTool({\n  name: \"want\",\n  description: DESC_WANT,\n  parameters: z.object({\n    name: z.string().describe(\"Goal name (used as directory name, e.g. 'local-platform')\"),\n    source: z.string().describe(\"Gherkin feature source text for the goal\"),\n    testable: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Whether this goal's scenarios should become persistent automated verification\"),\n  }),\n  execute: safeTool(\"want\", async ({ name, source, testable }) => {\n    const role = requireRole();\n    const goal = role.want(name, source, testable);\n    return next(`Goal created: ${goal.name}`, NEXT.want);\n  }),\n});\n\nserver.addTool({\n  name: \"plan\",\n  description: DESC_PLAN,\n  parameters: z.object({\n    source: z.string().describe(\"Gherkin feature source text for the plan\"),\n  }),\n  execute: safeTool(\"plan\", async ({ source }) => {\n    const role = requireRole();\n    const p = role.plan(source);\n    return next(`Plan created: ${p.name}`, NEXT.plan);\n  }),\n});\n\nserver.addTool({\n  name: \"todo\",\n  description: DESC_TODO,\n  parameters: z.object({\n    name: z.string().describe(\"Task name (used as filename, e.g. 'implement-loader')\"),\n    source: z.string().describe(\"Gherkin feature source text for the task\"),\n    testable: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Whether this task's scenarios should become unit or integration tests\"),\n  }),\n  execute: safeTool(\"todo\", async ({ name, source, testable }) => {\n    const role = requireRole();\n    const task = role.todo(name, source, testable);\n    return next(`Task created: ${task.name}`, NEXT.todo);\n  }),\n});\n\nserver.addTool({\n  name: \"achieve\",\n  description: DESC_ACHIEVE,\n  parameters: z.object({\n    experience: z\n      .string()\n      .optional()\n      .describe(\n        \"Optional Gherkin feature source capturing what was learned — auto-saved as experience growup\"\n      ),\n  }),\n  execute: safeTool(\"achieve\", async ({ experience }) => {\n    const role = requireRole();\n    role.achieve(experience);\n    const msg = experience ? \"Goal achieved. Experience captured.\" : \"Goal achieved.\";\n    return next(msg, NEXT.achieve);\n  }),\n});\n\nserver.addTool({\n  name: \"abandon\",\n  description: DESC_ABANDON,\n  parameters: z.object({\n    experience: z\n      .string()\n      .optional()\n      .describe(\n        \"Optional Gherkin feature source capturing what was learned — auto-saved as experience growup\"\n      ),\n  }),\n  execute: safeTool(\"abandon\", async ({ experience }) => {\n    const role = requireRole();\n    role.abandon(experience);\n    const msg = experience ? \"Goal abandoned. Experience captured.\" : \"Goal abandoned.\";\n    return next(msg, NEXT.abandon);\n  }),\n});\n\nserver.addTool({\n  name: \"reflect\",\n  description: DESC_REFLECT,\n  parameters: z.object({\n    experienceNames: z\n      .array(z.string())\n      .describe(\n        \"Names of experience files to distill (without .experience.identity.feature suffix)\"\n      ),\n    knowledgeName: z\n      .string()\n      .describe(\n        \"Name for the resulting knowledge (used as filename, e.g. 'authentication-principles')\"\n      ),\n    knowledgeSource: z.string().describe(\"Gherkin feature source text for the knowledge\"),\n  }),\n  execute: safeTool(\"reflect\", async ({ experienceNames, knowledgeName, knowledgeSource }) => {\n    const role = requireRole();\n    const feature = role.reflect(experienceNames, knowledgeName, knowledgeSource);\n    return next(\n      `Reflected: ${experienceNames.length} experience(s) → knowledge \"${feature.name}\"`,\n      NEXT.reflect\n    );\n  }),\n});\n\nserver.addTool({\n  name: \"finish\",\n  description: DESC_FINISH,\n  parameters: z.object({\n    name: z.string().describe(\"Task name to mark as done\"),\n  }),\n  execute: safeTool(\"finish\", async ({ name }) => {\n    const role = requireRole();\n    role.finish(name);\n\n    // Dynamic hint: check remaining tasks\n    const { current } = role.focus();\n    const remaining = current\n      ? current.tasks.filter((t) => !t.tags?.some((tag) => tag.name === \"@done\")).length\n      : -1;\n    return next(`Task finished: ${name}`, remaining >= 0 ? nextFinish(remaining) : NEXT.achieve);\n  }),\n});\n\nserver.start({\n  transportType: \"stdio\",\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolexjs/mcp-server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for Rolex — expose RDD role management as MCP tools",
   "keywords": [
     "rolex",
@@ -41,8 +41,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "rolexjs": "^0.6.0",
-    "@rolexjs/local-platform": "^0.6.0",
+    "rolexjs": "^0.7.0",
+    "@rolexjs/local-platform": "^0.7.0",
     "fastmcp": "^3.0.0",
     "zod": "^3.25.0"
   },