codex-plugin-doctor 0.3.0 → 0.5.0

package/examples/codex-doctor-runtime/mock-server.js

@@ -0,0 +1,237 @@
+import readline from "node:readline";
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  crlfDelay: Infinity
+});
+
+rl.on("line", (line) => {
+  const message = JSON.parse(line);
+  const cursor = message.params?.cursor;
+
+  if (message.method === "initialize") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result: {
+          protocolVersion: "2025-11-25",
+          capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+          },
+          serverInfo: {
+            name: "doctor-runtime-server",
+            version: "1.0.0"
+          }
+        }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "tools/list") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result:
+          cursor === "tools-page-2"
+            ? {
+                tools: [
+                  {
+                    name: "format_status",
+                    description: "Return a formatted health status.",
+                    inputSchema: {
+                      type: "object",
+                      properties: {},
+                      required: []
+                    }
+                  }
+                ]
+              }
+            : {
+                tools: [
+                  {
+                    name: "ping",
+                    description: "Return a healthcheck response.",
+                    inputSchema: {
+                      type: "object",
+                      properties: {},
+                      required: []
+                    }
+                  }
+                ],
+                nextCursor: "tools-page-2"
+              }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "tools/call") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result: {
+          content: [
+            {
+              type: "text",
+              text: "doctor-runtime-ok"
+            }
+          ]
+        }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "resources/list") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result:
+          cursor === "resources-page-2"
+            ? {
+                resources: [
+                  {
+                    name: "workspace-license",
+                    uri: "file:///workspace/LICENSE"
+                  }
+                ]
+              }
+            : {
+                resources: [
+                  {
+                    name: "workspace-readme",
+                    uri: "file:///workspace/README.md"
+                  }
+                ],
+                nextCursor: "resources-page-2"
+              }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "resources/read") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result: {
+          contents: [
+            {
+              uri: "file:///workspace/README.md",
+              text: "# Workspace README"
+            }
+          ]
+        }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "resources/templates/list") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result:
+          cursor === "templates-page-2"
+            ? {
+                resourceTemplates: [
+                  {
+                    name: "log",
+                    uriTemplate: "file:///workspace/logs/{name}.log"
+                  }
+                ]
+              }
+            : {
+                resourceTemplates: [
+                  {
+                    name: "doc",
+                    uriTemplate: "file:///workspace/docs/{name}.md"
+                  }
+                ],
+                nextCursor: "templates-page-2"
+              }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "prompts/list") {
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result:
+          cursor === "prompts-page-2"
+            ? {
+                prompts: [
+                  {
+                    name: "summary",
+                    description: "Summarize the current change."
+                  }
+                ]
+              }
+            : {
+                prompts: [
+                  {
+                    name: "code_review",
+                    description: "Review code for bugs.",
+                    arguments: [
+                      {
+                        name: "diff",
+                        required: true
+                      }
+                    ]
+                  }
+                ],
+                nextCursor: "prompts-page-2"
+              }
+      })}\n`
+    );
+    return;
+  }
+
+  if (message.method === "prompts/get") {
+    if (message.params?.arguments?.diff !== "codex-plugin-doctor-probe") {
+      process.stdout.write(
+        `${JSON.stringify({
+          jsonrpc: "2.0",
+          id: message.id,
+          error: {
+            code: -32602,
+            message: "Missing required diff argument"
+          }
+        })}\n`
+      );
+      return;
+    }
+
+    process.stdout.write(
+      `${JSON.stringify({
+        jsonrpc: "2.0",
+        id: message.id,
+        result: {
+          description: "Prompt for code review",
+          messages: [
+            {
+              role: "user",
+              content: {
+                type: "text",
+                text: "Review this diff for bugs."
+              }
+            }
+          ]
+        }
+      })}\n`
+    );
+  }
+});
+

package/examples/codex-doctor-runtime/skills/context-check/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: context-check
+description: Validate the current repository context before taking action.
+---
+
+Use this skill when you need to confirm repository structure, expected files, and project readiness before deeper work begins.
+

package/examples/codex-doctor-starter/.codex-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "codex-doctor-starter",
+  "version": "1.0.0",
+  "description": "Minimal Codex Doctor sample plugin for local validation.",
+  "skills": "./skills/"
+}
+

package/examples/codex-doctor-starter/skills/repo-scan/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: repo-scan
+description: Scan the repository and summarize the main components.
+---
+
+Use this skill when you need a quick high-level map of the current repository.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-plugin-doctor",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI-first validator for Codex plugins, skills, and MCP package surfaces with runtime MCP protocol validation.",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,8 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "examples"
   ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",