@modootoday/pmcp 0.5.0 → 0.6.0

package/README.md

@@ -70,6 +70,49 @@ Paths resolve against the file's directory. Keys are `roots`, `scopes`,
 the same meaning; an unknown key is an error. A flag replaces the file's list
 of its kind. `--config <file>` names another file and `--no-config` ignores it.
 
+## Native files for each agent tool
+
+`pmcp project` writes what Claude Code, Codex, Gemini CLI, Grok Build and
+Antigravity read natively, from cross-tool sources under `.agents/`
+(`skills/<name>/SKILL.md`, `agents/<name>/agent.md`, `rules/*.md`) and the rest
+of `pmcp.toml`:
+
+```toml
+[targets]
+tools = ["claude", "codex", "gemini", "grok", "antigravity"]
+
+[skills.deploy]
+invocation = "user"          # the person starts it; the model is not offered it
+
+[agents.reviewer.claude]
+tools = "Read, Grep"         # fields one tool reads stay out of agent.md
+
+[rules.packages]
+file = ".agent/rules/PACKAGE.RULE.md"   # each package's path-scoped rule
+strip = ["apps"]                        # dropped from derived link names
+
+[mcp.skills]
+command = "node"
+args = ["${PROJECT_ROOT}/node_modules/@modootoday/pmcp/dist/cli.js", "serve"]
+```
+
+```sh
+pmcp project              # write
+pmcp project --check      # exit 2 on drift, stale or undeclared outputs
+pmcp project add <name>   # copy a catalog skill or agent into .agents/
+pmcp project remove <name>
+pmcp doctor               # ask each installed tool what it loads
+```
+
+Rules go to `.claude/rules/<dir>/`, never the top level, because Grok Build
+loads top-level `.claude/rules/*.md` in every session regardless of `paths:`.
+A server that names `${PROJECT_ROOT}` is launched through `sh`, which finds
+`pmcp.toml` at spawn time, so the generated files hold no machine's path.
+`pmcp.lock` records what was written; a file pmcp did not write is never
+overwritten. `doctor` calls no model: it reads `claude mcp list`,
+`codex mcp list`, `gemini skills list`, `gemini mcp list` and
+`grok inspect --json`, and skips a tool that is not installed.
+
 ## Package skills
 
 Skills are discovered by filename, including `skills/`, `.agents/skills/`,

package/dist/{chunk-JOQTOVTJ.js → chunk-5TX2IAVD.js}

@@ -1009,6 +1009,10 @@ var readOnly = {
   idempotentHint: true,
   openWorldHint: false
 };
+var readOnlyTool = (title) => ({
+  title,
+  annotations: { ...readOnly, title }
+});
 var kindInput = z2.enum(["skill", "agent", "hook", "mcp", "any"]).optional().describe(
   "skill (default), agent, hook, mcp, or any. Commands are skills; agents, hooks and MCP servers are installed with pmcp add rather than read."
 );
@@ -1019,22 +1023,21 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_catalog",
     {
-      title: "List installed skills without their bodies",
+      ...readOnlyTool("List skills"),
       description: "Every skill the installed packages and marketplaces ship, grouped by package or plugin, with names, one-line descriptions and tier, and no bodies. Paged by group. Use it to see what exists, or when skill_find returns nothing. Pass kind to list agents, hooks or MCP servers instead.",
       inputSchema: z2.object({
         page: z2.number().int().min(1).optional(),
         pageSize: z2.number().int().min(1).max(20).optional(),
         tier: z2.enum(["open", "free", "paid", "internal"]).optional(),
         kind: kindInput
-      }),
-      annotations: readOnly
+      })
     },
     async (request) => asText(tools.catalog(request))
   );
   server.registerTool(
     "skill_find",
     {
-      title: "Find skills by describing the problem",
+      ...readOnlyTool("Find skills"),
       description: "Ranked skill names for an intent. Describe the problem in a full sentence in English rather than a keyword: a single word matches far worse, and the ranking is over descriptions. Returns names only -- read one with skill_call.",
       inputSchema: z2.object({
         intent: z2.string().min(1).max(256).describe("What you are trying to do, as an English sentence."),
@@ -1047,20 +1050,18 @@ function registerSkillTools(server, tools) {
           domain: z2.string().optional(),
           medium: z2.string().optional()
         }).optional().describe("Exact-match filters over the catalog before ranking.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ intent, limit, filters }) => asText(await tools.find(intent, limit, filters))
   );
   server.registerTool(
     "skill_describe",
     {
-      title: "Check one skill's properties before loading it",
+      ...readOnlyTool("Describe a skill"),
       description: "Frontmatter, metadata (tier, level, requirements, licence, approval), and the files the skill carries with sizes and sha256, without any body. Use it to decide between candidates before skill_call.",
       inputSchema: z2.object({
         name: z2.string().min(1).describe("The skill name skill_find or skill_catalog returned.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name }) => {
       const described = tools.describe(name);
@@ -1080,15 +1081,14 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_read",
     {
-      title: "Read one file a skill carries",
-      description: "A reference or script file inside one skill's directory, as text, with its sha256. Read only when the skill body points at the file. Scripts are returned, never run. Files over 256 KiB and paths outside the skill are refused.",
+      ...readOnlyTool("Read a skill file"),
+      description: "A reference or script file inside one skill's directory in this catalog, as text, with its sha256. It reads only files the catalog ships and calls no external API; path is relative to the skill, as skill_describe lists it (layout: https://pmcp.build). Read only when the skill body points at the file. Scripts are returned, never run. Files over 256 KiB and paths outside the skill are refused.",
       inputSchema: z2.object({
         name: z2.string().min(1),
         path: z2.string().min(1).optional().describe(
           "Path relative to the skill directory, as skill_describe lists it. Defaults to SKILL.md."
         )
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name, path }) => {
       const result = tools.read(name, path);
@@ -1105,12 +1105,11 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_call",
     {
-      title: "Read one skill",
+      ...readOnlyTool("Read a skill"),
       description: "The body of a single skill, by the name skill_find or skill_catalog returned. This is the only call that costs a document.",
       inputSchema: z2.object({
         name: z2.string().min(1).describe("The skill name, as <package>/<slug>.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name }) => {
       const found = tools.call(name);
@@ -1130,7 +1129,7 @@ function registerSkillTools(server, tools) {
   return server;
 }
 function createSkillServer(options) {
-  const server = new McpServer({ name: SERVER_NAME, version: "0.5.0" });
+  const server = new McpServer({ name: SERVER_NAME, version: "0.6.0" });
   const tools = createSkillTools(options);
   registerSkillsExtension(server, tools.skills);
   return registerSkillTools(server, tools);
@@ -1168,4 +1167,4 @@ export {
   registerSkillTools,
   createSkillServer
 };
-//# sourceMappingURL=chunk-JOQTOVTJ.js.map
+//# sourceMappingURL=chunk-5TX2IAVD.js.map