@lifeaitools/rdc-skills 0.25.3 → 0.25.5

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.25.0",
+  "version": "0.25.5",
   "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",
@@ -1432,6 +1432,52 @@
       "enabled_default": true,
       "codeflow_required": false
     },
+    "new-model": {
+      "name": "new-model",
+      "slash": "rdc:new-model",
+      "category": "tooling",
+      "usage": "rdc:new-model <slug-or-model-brief>",
+      "args": {
+        "positional": [
+          {
+            "name": "slug-or-model-brief",
+            "required": true,
+            "description": "Reference model slug or natural-language model request to check/register",
+            "accepts": "string"
+          }
+        ],
+        "flags": []
+      },
+      "requires": [
+        "supabase",
+        "git"
+      ],
+      "produces": [
+        "work_items",
+        "supabase_writes",
+        "git_commits"
+      ],
+      "default_model": "opus",
+      "triggers": [
+        "rdc:new-model",
+        "rdc new model",
+        "create model",
+        "new reference model",
+        "add a model",
+        "register model",
+        "new model for",
+        "model registration check"
+      ],
+      "follows": [],
+      "leads_to": [
+        "plan",
+        "build"
+      ],
+      "sandbox_aware": false,
+      "output_contract": "guides/output-contract.md",
+      "enabled_default": true,
+      "codeflow_required": true
+    },
     "workitems": {
       "name": "workitems",
       "slash": "rdc:workitems",

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## v0.25.5 — MCP catalog release hygiene
+
+### Fixed
+- Synced `.claude-plugin/plugin.json` to the package release version so strict
+  self-test passes before publishing the MCP catalog.
+- Added the missing output-contract banner to `new-model`.
+
+### Changed
+- Updated `rdc:convert` cloud/CLI guidance to prefer npm `regen.mde` for
+  build-corpus instead of stale GitHub-install instructions.
+
+---
+
 ## v0.25.0 — rdc:onramp Phase-1 enrollment skill
 
 ### Added

package/README.md

@@ -13,7 +13,7 @@ From any Claude Code session:
 /plugin install rdc-skills
 ```
 
-The full catalog is available through the MCP as 31 skills. Nineteen common
+The full catalog is available through the MCP as 34 skills. Nineteen common
 workflows also ship as `/rdc:*` command shorthands. Agent playbooks in
 `guides/agents/` are dispatched internally by `rdc:build` and are not
 user-invocable.
@@ -181,7 +181,7 @@ Throughout the skills, the following substitutions have been made to make them p
 
 ## Skills Overview
 
-31 MCP skills organized into 8 manifest categories. Nineteen of these also have
+34 MCP skills organized into 8 manifest categories. Nineteen of these also have
 `/rdc:*` command shorthands for Claude Code/plugin callers.
 
 Use `rdc_skill_list` for the authoritative live catalog, including names,
@@ -312,6 +312,7 @@ skills/
   deploy/SKILL.md      (Coolify ops: deploy, new, diagnose, audit)
   design/SKILL.md      (RDC/Studio design, Palette Library, Rampa CLI)
   edit/SKILL.md        (local website editor launcher)
+  env/SKILL.md         (environment status, install, repair, update)
   fixit/SKILL.md       (quick-fix bypass)
   fs-mcp/SKILL.md      (File System MCP bridge guidance)
   regen-media/SKILL.md (primary image generation + Regen Media upload)
@@ -319,6 +320,8 @@ skills/
   help/SKILL.md        (manifest-driven skill index)
   housekeeping/SKILL.md (weekly maintenance audit)
   lifeai-brochure-author/SKILL.md (brochure JSX authoring)
+  new-model/SKILL.md   (reference model registration gate)
+  onramp/SKILL.md      (Place Fund phase-1 enrollment)
   overnight/SKILL.md   (unattended multi-epic supervisor)
   plan/SKILL.md        (create architecture + tasks)
   preplan/SKILL.md     (research before planning)

package/RELEASE.md

@@ -26,7 +26,14 @@ npm publish
 # 5. Install globally (serves both Claude Code CLI + MCP server)
 npm install -g @lifeaitools/rdc-skills@latest
 
-# 6. Verify
+# 6. Refresh the MCP server and verify the catalog
+pm2 restart rdc-skills-mcp --update-env
+curl -s http://127.0.0.1:3110/health
+curl -s https://rdc-skills.regendevcorp.com/health
+REMOTE=1 node tests/mcp.test.mjs
+REMOTE=1 node tests/curl-surface.test.mjs
+
+# 7. Verify installed package
 npm list -g @lifeaitools/rdc-skills --depth=0
 ```
 
@@ -36,13 +43,30 @@ npm list -g @lifeaitools/rdc-skills --depth=0
 rdc:release rdc-skills --patch
 ```
 
-This runs steps 1–6 automatically.
+This runs the package release flow. Before calling a release complete, also verify
+that the MCP catalog has refreshed locally and at the public endpoint.
 
 ## Environment targets
 - **Local dev:** `npm install -g` + PM2 `rdc-skills-mcp` process
 - **Remote MCP:** PM2 on Vultr `64.237.54.189` (auto-deploys via webhook on push to master)
 - **Production:** N/A (npm global install is the distribution mechanism)
 
+## MCP release gate
+
+Every release that changes skills, manifests, commands, guides, MCP server code,
+or installer behavior must prove the running MCP serves the released package:
+
+1. `npm view @lifeaitools/rdc-skills version` equals `package.json`.
+2. Global install is updated with `npm install -g @lifeaitools/rdc-skills@latest`.
+3. PM2 `rdc-skills-mcp` is restarted locally after the global install.
+4. Local `/health` reports the released version and expected skill count.
+5. Public `/health` at `https://rdc-skills.regendevcorp.com/health` reports the released version and expected skill count.
+6. `REMOTE=1 node tests/mcp.test.mjs` and `REMOTE=1 node tests/curl-surface.test.mjs` pass against the public endpoint.
+
+The installer also performs this update path in `scripts/install-rdc-skills.js`:
+it registers the MCP endpoint, syncs the global MCP package when PM2 is serving
+from npm, restarts `rdc-skills-mcp`, and verifies the live catalog freshness.
+
 ## Version policy
 - patch: new skill, skill fix, manifest update
 - minor: new capability, breaking skill interface change

package/git-sha.json

@@ -1,3 +1,3 @@
 {
-  "sha": "7a77a9d962212b9731c805820f4f59127fe9ca9b"
+  "sha": "2b3eea42ba468dc330b7212be01b7739220234b6"
 }

package/package.json

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

package/skills/convert/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rdc:convert
-description: "Usage `rdc:convert <input> [--out <dir>] [--to markdown|word] [--images assets|base64|s3]` — Convert .docx/.pptx/.ppt → Markdown (Word OMML equations as KaTeX TeX, tables, images) or Markdown → Word via the build-corpus CLI (npm `regen.mde`, or pip from GitHub). Portable: runs in any session that can reach npm or PyPI — Claude Code CLI and claude.ai both fetch + run it. Use whenever the user asks to convert an Office document, build a Markdown corpus from .docx/.pptx, turn Markdown into a .docx, or 'open the report' in the regen-mde editor (Windows)."
+description: "Usage `rdc:convert <input> [--out <dir>] [--to markdown|word] [--images assets|base64|s3]` — Convert .docx/.pptx/.ppt → Markdown (Word OMML equations as KaTeX TeX, tables, images) or Markdown → Word via the build-corpus CLI from npm `regen.mde`. Portable: runs in any session that can reach npm — Claude Code CLI, Codex, and claude.ai can fetch + run it. Use whenever the user asks to convert an Office document, build a Markdown corpus from .docx/.pptx, turn Markdown into a .docx, or open the report in the regen-mde editor on Windows."
 ---
 
 # rdc:convert — Office ↔ Markdown conversion (build-corpus) + regen-mde editor
@@ -11,7 +11,7 @@ description: "Usage `rdc:convert <input> [--out <dir>] [--to markdown|word] [--i
 
 `build-corpus` is the conversion CLI; `regen-mde` is the Windows GUI editor. Same
 package, two surfaces. This skill is a **when-to-use + full call/switch reference** —
-it does NOT require a local checkout. Any runtime that can reach npm or PyPI can
+it does NOT require a local checkout. Any runtime that can reach npm can
 fetch and run the tool in its own session (this is how claude.ai uses it).
 
 ## Working model — stay in Markdown ("MD time"), materialize at the end
@@ -58,25 +58,16 @@ build-corpus repo (`C:/Dev/build-corpus/AGENTS.md` locally).
 The command is always `build-corpus <input> [flags]`. Resolve the binary like this:
 
 1. **Already on PATH?** Use it directly: `build-corpus --help`.
-2. **Install straight from GitHub — REQUIRED for current behavior** (native LaTeX→OMML
-   equations, the fidelity report, and the escaped-currency fix; the PyPI/npm packages
-   below currently LAG GitHub):
-   ```bash
-   pip install "git+https://github.com/LIFEAI/build-corpus.git"
-   # (the feat/dual-package-ubuntu branch is kept in sync with main as an alias)
-   ```
-   This installs the `build-corpus` CLI and its deps (latex2mathml, python-docx,
-   Pillow, omml2latex). The MathML→OMML step is an OWNED converter — there is NO
-   `mathml2omml` dependency. On Debian/Ubuntu externally-managed Python, add
-   `--break-system-packages`, use a venv, or `pipx install "git+https://github.com/LIFEAI/build-corpus.git"`.
-3. **npm (only if you do NOT need the latest fixes — lags GitHub; `build-corpus` is
-   NOT on PyPI):** `npx -y -p regen.mde build-corpus <input> [flags]`
+2. **One-off npm run, preferred for claude.ai/sandboxes:** `npx -y -p regen.mde build-corpus <input> [flags]`
+3. **Install npm package when repeated use is expected:** `npm install -g regen.mde`
+   then run `build-corpus <input> [flags]`.
 4. **Legacy `.ppt` input** additionally needs LibreOffice (`soffice`) on PATH
    (`sudo apt install libreoffice`). `.docx`/`.pptx` need nothing extra.
-5. **S3/R2 image upload** needs the extra: append `[s3]` to the package spec.
+5. **S3/R2 image upload** uses the S3/R2 flags or a `--config` file.
 
-claude.ai note: install from GitHub (step 2) into the analysis/session sandbox and run
-`build-corpus` there. GitHub is the source of truth until PyPI/npm are republished.
+claude.ai note: use the npm one-off command in the analysis/session sandbox. Do not
+ask Claude to install build-corpus from Git unless Dave explicitly requests source
+testing.
 
 ## Command Reference
 
@@ -150,7 +141,6 @@ build-corpus report.md --inline-images                         # → report.inli
 build-corpus input.docx --images s3 --config build-corpus.config.json
 
 # portable one-offs when build-corpus is not yet installed:
-pipx run --spec "git+https://github.com/LIFEAI/build-corpus.git" build-corpus input.docx --out out
 npx -y -p regen.mde build-corpus input.docx --out out
 ```
 
@@ -161,7 +151,6 @@ npx -y -p regen.mde build-corpus input.docx --out out
 - The `regen-mde` GUI is Windows-only; do not attempt to launch it on Linux/macOS.
 
 ## Reference
-- Package: npm `regen.mde` (CLI bin `build-corpus`, editor bin `regen-mde`). NOT on
-  PyPI — install the Python CLI from GitHub (step 2). MathML→OMML is an owned converter
-  (no `mathml2omml` dependency).
+- Package: npm `regen.mde` (CLI bin `build-corpus`, editor bin `regen-mde`).
+  MathML→OMML is an owned converter (no `mathml2omml` dependency).
 - Source: `github.com/LIFEAI/build-corpus` (`C:/Dev/build-corpus` locally).

package/skills/new-model/SKILL.md

@@ -1,16 +1,27 @@
 ---
 name: new-model
+triggers:
+  - rdc:new-model
+  - rdc new model
+  - create model
+  - new reference model
+  - add a model
+  - register model
+  - new model for
+  - model registration check
 description: >
   Register a new Reference Model completely — the yes/no gate that prevents half-registered models.
   A reference model is DEFINED as registered in all four homes: (1) RPMS project_nodes row
   (node_type=reference_model), (2) apps/vlas route group /models/<slug>, (3) apps/vlas
   src/data/models/<slug> definitions, (4) global-corpus Drive directory. If ANY of the four is
   missing, the model does not exist yet — run this skill.
-  TRIGGER: 'rdc:new-model', 'rdc new model', 'create model', 'new reference model', 'add a model',
-  'register model', 'new model for', 'model for conservation easements', 'is this model registered',
-  'model registration check'.
+  Trigger when asked to create, register, or check whether a reference model exists.
 ---
 
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
 # rdc:new-model — Reference Model Registration (complete or not at all)
 
 ## When to run

package/tests/curl-surface.test.mjs

@@ -12,6 +12,7 @@ import { spawn, spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { listSkills } from '../lib/catalog.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const REPO_ROOT = path.resolve(__dirname, '..');
@@ -20,6 +21,7 @@ const TEST_PORT = parseInt(process.env.TEST_PORT || '3199', 10);
 const LOCAL = `http://127.0.0.1:${TEST_PORT}`;
 const REMOTE = 'https://rdc-skills.regendevcorp.com';
 const TARGET = process.env.REMOTE || process.argv.includes('--remote') ? REMOTE : LOCAL;
+const EXPECTED_SKILL_COUNT = listSkills().length;
 const REPORT_DIR = path.join(REPO_ROOT, '.rdc', 'reports');
 const REPORT_FILE = path.join(
   REPORT_DIR,
@@ -142,7 +144,7 @@ async function main() {
   try {
     const health = await waitHealth();
     check('health reports ok', health.status === 'ok');
-    check('health reports 30 skills', health.skills === 30, `skills ${health.skills}`);
+    check('health reports catalog skill count', health.skills === EXPECTED_SKILL_COUNT, `skills ${health.skills}`);
 
     const init = postMcp({
       jsonrpc: '2.0',
@@ -168,7 +170,7 @@ async function main() {
     check('rdc_skill_list curl exits 0', list.status === 0, list.stderr);
     check('rdc_skill_list returns SSE data line', /^data:/m.test(list.stdout));
     const listed = JSON.parse(resultText(latestEnvelope(list.stdout)));
-    check('rdc_skill_list exposes 30 skills', listed.count === 30, `count ${listed.count}`);
+    check('rdc_skill_list exposes catalog skill count', listed.count === EXPECTED_SKILL_COUNT, `count ${listed.count}`);
     check('rdc_skill_list includes visible slash name', listed.skills.some((s) => s.slash === 'rdc:build'));
     const buildRow = listed.skills.find((s) => s.name === 'build');
     check('rdc_skill_list exposes aliases for slash callers', buildRow?.aliases?.includes('/rdc:build'));

package/tests/help-surface.test.mjs

@@ -35,7 +35,7 @@ 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, /30 MCP skills organized into 8 manifest categories/, 'README should use manifest category count');
+assert.match(docs.readme, /34 MCP skills organized into 8 manifest categories/, 'README should use manifest category count');
 assert.match(docs.readme, /Nineteen[\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');

package/tests/install-rdc-skills.test.mjs

@@ -24,7 +24,7 @@ const plugin = JSON.parse(readFileSync(join(REPO_ROOT, '.claude-plugin', 'plugin
 const skillCount = Array.isArray(plugin.skills_meta)
   ? plugin.skills_meta.length
   : Object.keys(plugin.skills_meta || {}).length;
-assert.equal(skillCount, 30, 'test fixture should expose all 30 MCP skills from plugin skills_meta');
+assert.equal(skillCount, 34, 'test fixture should expose all 34 MCP skills from plugin skills_meta');
 assert.match(
   source,
   /Available MCP skills.*\/rdc:\* command shorthands/,