@lifeaitools/rdc-skills 0.24.22 → 0.24.24

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.24.22",
+  "version": "0.24.24",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
   "author": {
     "name": "LIFEAI",

package/README.md

@@ -13,7 +13,10 @@ From any Claude Code session:
 /plugin install rdc-skills
 ```
 
-All user-invocable skills become available as slash commands. Agent playbooks in `guides/agents/` are dispatched internally by `rdc:build` and are not user-invocable.
+The full catalog is available through the MCP as 29 skills. Eighteen common
+workflows also ship as `/rdc:*` command shorthands. Agent playbooks in
+`guides/agents/` are dispatched internally by `rdc:build` and are not
+user-invocable.
 
 ### Option B — Directory plugin (LIFEAI dev machines)
 
@@ -162,39 +165,47 @@ Throughout the skills, the following substitutions have been made to make them p
 
 ## Skills Overview
 
-29 skills organized into 6 categories:
+29 MCP skills organized into 8 manifest categories. Eighteen of these also have
+`/rdc:*` command shorthands for Claude Code/plugin callers.
 
-### Orchestration Skills (workflow drivers)
-- rdc:build, rdc:plan, rdc:preplan, rdc:review, rdc:overnight, rdc:fixit, rdc:status, rdc:report
+Use `rdc_skill_list` for the authoritative live catalog, including names,
+visible slash forms, requirements, triggers, and usage.
+
+### Planning
+- rdc:preplan, rdc:plan, rdc:handoff
 
 ### Agent Guides (dispatched by rdc:build, not user-invocable)
 Located in `guides/agents/` — plain markdown playbooks spawned as sub-agents:
 - frontend, backend, data, design, infrastructure, content, cs2, viz, setup, verify
 
-### Bridge Skills (Planning → CLI)
-- rdc:handoff, rdc:prototype, rdc:workitems
+### Build
+- rdc:build, rdc:design, rdc:prototype, rdc:overnight, rdc:review
 
-### Utility Skills
-- rdc:collab
-- rdc:co-develop — peer-aware Claude/Codex co-development over clauth
-- rdc:fs-mcp — File System MCP bridge guidance for live repo reads/writes
-- rdc:terminal-config — Windows Terminal and hidden-launch policy audit
-- rdc:watch — session-log viewer initialization for attended sessions
-- rdc:channel-formatter — channel-native formatting and content repurposing for LinkedIn, Twitter/X, Slack/Teams, email, decks, Word/PDF structure, web copy, and content packs
+### Deploy
+- rdc:deploy
 
-### Design Skills
-- rdc:design — RDC/Studio design, tokens, palettes, themes, and Rampa CLI-assisted color systems
+### Release
+- rdc:release
 
-### Document and Brochure Skills
-- rdc:convert — Office/Markdown conversion via build-corpus
+### Dev Loop
+- rdc:fixit, rdc:collab, rdc:co-develop
+
+### Reporting
+- rdc:help, rdc:housekeeping, rdc:report, rdc:status, rdc:watch
+
+### Tooling
+- rdc:channel-formatter — channel-native formatting and content repurposing for LinkedIn, Twitter/X, Slack/Teams, email, decks, Word/PDF structure, web copy, and content packs
 - rdc:brochure — HTML/folder/zip/URL/Markdown to print-quality PDF
-- rdc:brochurify — six-wave Brochurify orchestration contract
-- lifeai-brochure-author — brochure JSX authoring contract for @lifeai/brochure-kit
-- rdc:extract-verifier-rules — verifier-rule candidates from enhancement logs
-- rpms-filemap — canonical RPMS file-map lookup
+- rdc:brochurify — Brochurify orchestration for polished PDF jobs
+- lifeai-brochure-author — JSX authoring contract for Brochurify inputs
+- rdc:convert — Office/Markdown conversion via build-corpus
+- rdc:fs-mcp — File System MCP bridge guidance for live repo reads/writes
+- rdc:extract-verifier-rules — verifier-rule extraction from enhancement logs
+- rdc:rpms-filemap — generated RPMS file-map guidance
+- rdc:workitems — manual work item CRUD
 
-### Reference
-- rdc:help, rdc:self-test
+### Infra
+- rdc:self-test, rdc:terminal-config
 
 ## Channel Formatting and Content Packs
 

package/bin/rdc-skills-mcp.mjs

@@ -125,6 +125,36 @@ function textResult(text) {
   return { content: [{ type: 'text', text }] };
 }
 
+function directMcpUsage(message) {
+  return {
+    jsonrpc: '2.0',
+    error: {
+      code: -32000,
+      message,
+      help: {
+        endpoint: '/mcp',
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json, text/event-stream',
+        },
+        tools: ['rdc_skill_list', 'rdc_skill_search', 'rdc_skill_get'],
+        response: 'Streamable HTTP returns Server-Sent Events. Parse the JSON-RPC envelope from each data: line; tool text is at result.content[0].text.',
+        curl: `curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \\
+  -H 'Content-Type: application/json' \\
+  -H 'Accept: application/json, text/event-stream' \\
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"rdc_skill_list","arguments":{}}}'`,
+      },
+    },
+    id: null,
+  };
+}
+
+function acceptsStreamableHttp(req) {
+  const accept = String(req.headers.accept || '');
+  return accept.includes('application/json') && accept.includes('text/event-stream');
+}
+
 function buildMcpServer() {
   const srv = new McpServer({ name: 'rdc-skills', version: pkgVersion() });
 
@@ -225,6 +255,10 @@ function startHttp() {
   // POST /mcp — stateless StreamableHTTP transport, no Authorization required.
   app.post('/mcp', async (req, res) => {
     try {
+      if (!acceptsStreamableHttp(req)) {
+        res.status(406).json(directMcpUsage('MCP Streamable HTTP requires Accept: application/json, text/event-stream'));
+        return;
+      }
       const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
       const srv = buildMcpServer();
       await srv.connect(transport);
@@ -246,11 +280,7 @@ function startHttp() {
   });
 
   app.get('/mcp', (_req, res) => {
-    res.status(405).json({
-      jsonrpc: '2.0',
-      error: { code: -32000, message: 'Use POST for MCP requests' },
-      id: null,
-    });
+    res.status(405).json(directMcpUsage('Use POST for MCP requests.'));
   });
 
   app.listen(PORT, () => {

package/commands/help.md

@@ -1,15 +1,15 @@
 ---
 name: rdc:help
 description: >-
-  Usage `rdc:help` or `rdc` — manifest-driven menu of all rdc:* skills with
+  Usage `rdc:help` or `rdc` — manifest-driven menu of all MCP skills with
   argument syntax, requirements, decision hints, and direct MCP/curl access.
 ---
 
 > **Output contract:** Checklist/table output only. No raw MCP/JSON/log dumps.
 
-# rdc:help — Manifest-Driven Command Reference
+# rdc:help — Manifest-Driven Skill Reference
 
-Print a concise command reference from the plugin manifest, then stop. Do not
+Print a concise skill reference from the plugin manifest, then stop. Do not
 ask which command to run unless the user explicitly asks for a recommendation.
 
 ## Source Of Truth

package/git-sha.json

@@ -1,3 +1,3 @@
 {
-  "sha": "ccf246fa1ef9ef5a55e35db979053e7367d937e0"
+  "sha": "337ec305ad032632e314baec4d0d7ddcccca6b8c"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.24.22",
+  "version": "0.24.24",
   "description": "RDC typed-agent dispatch skill suite for Claude Code - plan, build, review, overnight builds",
   "keywords": [
     "claude-code",

package/skills/help/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: rdc:help
-description: "Usage `rdc:help` — Show all rdc:* skills with usage, requirements, and codeflow status. Reads `.claude-plugin/plugin.json` skills_meta (single source of truth). Call when unsure which skill to use or what args it takes."
+description: "Usage `rdc:help` — Show all MCP skills with usage, requirements, slash forms, and codeflow status. Reads `.claude-plugin/plugin.json` skills_meta (single source of truth). Call when unsure which skill to use or what args it takes."
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
 > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
 
-# rdc:help — Command Reference (manifest-driven)
+# rdc:help — Skill Reference (manifest-driven)
 
 > **⚠️ HARD OUTPUT RULE:** Read the plugin manifest, render the table, exit.
 > No preamble. No follow-up question. No summary.

package/tests/curl-surface.test.mjs

@@ -67,6 +67,16 @@ function curl(args, label) {
   return { status: res.status, stdout, stderr };
 }
 
+function curlWithStatus(args, label) {
+  const res = curl([...args, '-w', '\n%{http_code}'], label);
+  const marker = res.stdout.match(/\n(\d{3})$/);
+  return {
+    ...res,
+    httpStatus: marker ? Number(marker[1]) : null,
+    body: marker ? res.stdout.slice(0, marker.index) : res.stdout,
+  };
+}
+
 function postMcp(payload, label) {
   return curl([
     '-s',
@@ -191,7 +201,19 @@ async function main() {
     check('rdc_skill_get returns tool text path', getText.length > 500, `length ${getText.length}`);
     check('rdc_skill_get accepts visible rdc:build alias', /rdc:build/i.test(getText));
 
-    const badAccept = curl([
+    const getMcp = curlWithStatus([
+      '-s',
+      `${TARGET}/mcp`,
+    ], 'get_mcp_help');
+    check('GET /mcp curl exits 0', getMcp.status === 0, getMcp.stderr);
+    check('GET /mcp returns 405', getMcp.httpStatus === 405, `status ${getMcp.httpStatus}`);
+    const getHelp = JSON.parse(getMcp.body);
+    check('GET /mcp explains POST method', getHelp.error?.help?.method === 'POST');
+    check('GET /mcp includes Streamable HTTP Accept header', getHelp.error?.help?.headers?.Accept === 'application/json, text/event-stream');
+    check('GET /mcp points to discovery tools', getHelp.error?.help?.tools?.includes('rdc_skill_list'));
+    check('GET /mcp explains result.content text path', /result\.content\[0\]\.text/.test(getHelp.error?.help?.response || ''));
+
+    const badAccept = curlWithStatus([
       '-s',
       '-X', 'POST',
       `${TARGET}/mcp`,
@@ -199,7 +221,10 @@ async function main() {
       '-d', JSON.stringify({ jsonrpc: '2.0', id: 5, method: 'tools/list' }),
     ], 'missing_accept_header');
     check('missing Accept header still returns inspectable response', badAccept.status === 0, badAccept.stderr);
-    check('missing Accept header mentions Accept or returns JSON/SSE', /Accept|data:|jsonrpc|result/i.test(badAccept.stdout));
+    check('missing Accept header returns 406', badAccept.httpStatus === 406, `status ${badAccept.httpStatus}`);
+    const badAcceptHelp = JSON.parse(badAccept.body);
+    check('missing Accept header names required header', badAcceptHelp.error?.help?.headers?.Accept === 'application/json, text/event-stream');
+    check('missing Accept header includes curl example', /curl -s -X POST/.test(badAcceptHelp.error?.help?.curl || ''));
   } finally {
     if (proc) proc.kill();
   }

package/tests/help-surface.test.mjs

@@ -31,6 +31,13 @@ for (const [name, text] of Object.entries(docs)) {
   assert.doesNotMatch(text, /https:\/\/rdc-skills\.dev\.regendevcorp\.com\/mcp/, `${name} must not point callers at dev MCP`);
 }
 
+assert.match(docs.readme, /29 MCP skills organized into 8 manifest categories/, 'README should use manifest category count');
+assert.match(docs.readme, /Eighteen[\s\S]*\/rdc:\*` command shorthands/i, 'README should distinguish slash-command shorthands from full MCP skills');
+assert.match(docs.readme, /Use `rdc_skill_list` for the authoritative live catalog/, 'README should point callers to live MCP catalog');
+assert.doesNotMatch(docs.readme, /All user-invocable skills become available as slash commands/, 'README must not imply all MCP skills are slash commands');
+assert.doesNotMatch(docs.readme, /29 skills organized into 6 categories/, 'README must not carry stale category count');
+assert.match(docs.commandHelp, /menu of all MCP skills/, 'command help should refer to MCP skill catalog');
+assert.match(docs.skillHelp, /Show all MCP skills/, 'skill help should refer to MCP skill catalog');
 assert.match(docs.skillHelp, /manifest-driven/i, 'skill help should be manifest-driven');
 assert.match(docs.commandHelp, /manifest-driven/i, 'command help should be manifest-driven');
 assert.doesNotMatch(docs.commandHelp, /Print the full usage menu below verbatim/, 'command help must not use stale static menu wording');