@lifeaitools/rdc-skills 0.17.1 → 0.19.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "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/lib/catalog.mjs

@@ -43,18 +43,25 @@ function readFrontmatter(skillMdPath) {
 
 /** Map a raw skills_meta entry + SKILL.md frontmatter into a compact catalog row. */
 function toCatalogEntry(name, meta, frontmatter) {
-  const description = frontmatter.description || meta.description || '';
-  // `summary` is the short customer-facing line; `when_to_use` pulls the triggers.
-  const triggers = Array.isArray(meta.triggers) ? meta.triggers : [];
+  const fm = frontmatter || {};
+  const description = fm.description || meta.description || '';
+  // triggers/usage/slash/etc. may live in skills_meta OR the SKILL.md frontmatter.
+  // Fall back to frontmatter so a skill not (yet) registered in skills_meta stays
+  // searchable — these fields are what `rdc_skill_search` routes on.
+  const metaTriggers = Array.isArray(meta.triggers) && meta.triggers.length ? meta.triggers : null;
+  const fmTriggers = Array.isArray(fm.triggers) ? fm.triggers : [];
+  const slash = meta.slash || fm.slash || `rdc:${name}`;
   return {
     name,
-    slash: meta.slash || `rdc:${name}`,
-    category: meta.category || 'tooling',
+    slash,
+    category: meta.category || fm.category || 'tooling',
     summary: description,
-    when_to_use: triggers,
-    usage: meta.usage || '',
-    args: meta.args || { positional: [], flags: [] },
-    requires: Array.isArray(meta.requires) ? meta.requires : [],
+    when_to_use: metaTriggers || fmTriggers,
+    // usage falls back to the slash form so every skill carries an invocation hint.
+    usage: meta.usage || fm.usage || slash,
+    args: meta.args || fm.args || { positional: [], flags: [] },
+    requires: Array.isArray(meta.requires) ? meta.requires
+            : Array.isArray(fm.requires) ? fm.requires : [],
   };
 }
 

package/package.json

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

package/scripts/install-rdc-skills.js

@@ -52,9 +52,19 @@ const codexIdx   = args.indexOf('--codex-root');
 const codexRoot  = codexIdx >= 0
   ? path.resolve(args[codexIdx + 1])
   : (() => {
-      if (projectRootArg) return null;
-      const sibling = path.resolve(repoRoot, '..', 'regen-root');
-      return fs.existsSync(path.join(sibling, '.agents')) ? sibling : null;
+      // Auto-detect the consuming project's .agents tree so a plain `install`
+      // refreshes Codex without needing --codex-root. Check, in order: an
+      // explicit --project-root, the current working directory, then the
+      // regen-root sibling of this repo. First one with a `.agents` wins.
+      const candidates = [
+        projectRootArg ? path.resolve(projectRootArg) : null,
+        process.cwd(),
+        path.resolve(repoRoot, '..', 'regen-root'),
+      ].filter(Boolean);
+      for (const c of candidates) {
+        if (fs.existsSync(path.join(c, '.agents'))) return c;
+      }
+      return null;
     })();
 const codexSkillDirIdx = args.indexOf('--codex-skill-dir');
 const explicitCodexSkillDir = codexSkillDirIdx >= 0
@@ -117,7 +127,13 @@ function copyDirRecursive(src, dst) {
     const s = path.join(src, entry.name);
     const d = path.join(dst, entry.name);
     if (entry.isDirectory()) copyDirRecursive(s, d);
-    else fs.copyFileSync(s, d);
+    else {
+      // Atomic write (temp + rename) so a live Claude Code / Codex session never
+      // reads a half-written skill file when the installer runs over a live box.
+      const tmp = `${d}.tmp-${process.pid}`;
+      fs.copyFileSync(s, tmp);
+      fs.renameSync(tmp, d);
+    }
   }
 }
 
@@ -507,6 +523,46 @@ function addCodexTarget(targets, label, targetDir) {
   targets.push({ label, targetDir: resolved });
 }
 
+// Register the rdc-skills MCP endpoint at the USER/GLOBAL level for every client
+// so all Claude Code projects and all Codex sessions can reach the skills via MCP
+// (not just where a project .mcp.json exists). Idempotent + non-fatal. Mirrors the
+// existing clauth/codeflow entries exactly. claude.ai web still needs the one-time
+// connector add in its UI (no programmatic API).
+function registerMcpEndpoints() {
+  const MCP_URL = 'https://rdc-skills.regendevcorp.com/mcp';
+  const out = [];
+
+  // Claude Code — user-level ~/.claude.json mcpServers (covers EVERY project).
+  try {
+    const claudeJson = path.join(os.homedir(), '.claude.json');
+    if (fs.existsSync(claudeJson)) {
+      const data = readJson(claudeJson);
+      if (!data.mcpServers || typeof data.mcpServers !== 'object') data.mcpServers = {};
+      const cur = data.mcpServers['rdc-skills'];
+      if (!cur || cur.url !== MCP_URL) {
+        data.mcpServers['rdc-skills'] = { type: 'http', url: MCP_URL };
+        writeJson(claudeJson, data, 2);
+        out.push('claude(~/.claude.json)');
+      }
+    }
+  } catch (e) { out.push(`claude WARN:${e.message}`); }
+
+  // Codex — append [mcp_servers.rdc-skills] to ~/.codex/config.toml if absent.
+  try {
+    const codexToml = path.join(os.homedir(), '.codex', 'config.toml');
+    if (fs.existsSync(codexToml)) {
+      const toml = fs.readFileSync(codexToml, 'utf8');
+      if (!/\[mcp_servers\.rdc-skills\]/.test(toml)) {
+        const block = `\n[mcp_servers.rdc-skills]\nurl = '${MCP_URL}'\n`;
+        fs.writeFileSync(codexToml, toml.replace(/\s*$/, '\n') + block);
+        out.push('codex(~/.codex/config.toml)');
+      }
+    }
+  } catch (e) { out.push(`codex WARN:${e.message}`); }
+
+  return out;
+}
+
 function findCodexTargets() {
   const targets = [];
   if (codexRoot) {
@@ -918,6 +974,15 @@ async function main() {
     info('[2.5] Codex      — skipped (no Codex skill dirs found; use --codex-root or --codex-skill-dir)');
   }
 
+  // 2.6. Register the rdc-skills MCP endpoint globally (Claude Code + Codex) so
+  // EVERY agent can reach the skills via MCP, not only where a project .mcp.json exists.
+  const mcpReg = registerMcpEndpoints();
+  if (mcpReg.length > 0) {
+    ok(`[2.6] MCP        — registered rdc-skills endpoint: ${mcpReg.join(', ')}`);
+  } else {
+    info('[2.6] MCP        — rdc-skills endpoint already registered (claude + codex)');
+  }
+
   // 2.7. Symlinks in regen-root/.claude/skills/ (FS MCP + claude.ai access)
   if (codexRoot) {
     const skillsLinkDir = path.join(codexRoot, '.claude', 'skills');

package/tests/mcp.test.mjs

@@ -94,6 +94,17 @@ function unitTests() {
   check('unit: search ranks exact name first', searchSkills('deploy')[0]?.name === 'deploy');
   check('unit: empty search returns []', searchSkills('').length === 0);
 
+  // Searchability gate — the dimension the first "100% coverage" missed. Every
+  // catalog entry MUST carry triggers + usage (frontmatter or skills_meta) so
+  // rdc_skill_search can route to it. Caught by an audit: brochurify-suite skills
+  // had frontmatter triggers the loader ignored → invisible to search.
+  check('unit: every skill has non-empty triggers (searchable)',
+    cat.every((s) => Array.isArray(s.when_to_use) && s.when_to_use.length > 0),
+    cat.filter((s) => !s.when_to_use?.length).map((s) => s.name).join(',') || 'all good');
+  check('unit: every skill has a non-empty usage string',
+    cat.every((s) => s.usage && s.usage.length > 0),
+    cat.filter((s) => !s.usage).map((s) => s.name).join(',') || 'all good');
+
   // cloud-rewrite contract
   const sample = '```bash\n_T=$(curl -s http://127.0.0.1:52437/v/coolify-api)\npm2 restart app\n```';
   const rw = toCloudBody(sample);

package/skills/rdc-convert/SKILL.md

@@ -1,127 +0,0 @@
----
-name: rdc-convert
-version: 0.1.0
-description: |
-  Convert Office documents to/from Markdown with the build-corpus CLI: .docx/.pptx/.ppt → Markdown (Word OMML equations become KaTeX-readable TeX; tables, images, headings preserved), and Markdown → Word (.docx) where inline $...$ and display $$...$$ LaTeX become NATIVE Office Math (OMML) that Word renders as real equations. Use this skill whenever the user asks to convert a Word/PowerPoint document to Markdown, build a Markdown corpus from Office files, turn Markdown into a .docx (optionally with a .dotx template), or "open the report" to edit. Install build-corpus straight from GitHub and run it in the session.
-triggers:
-  - "convert this docx to markdown"
-  - "convert to word"
-  - "docx to markdown"
-  - "pptx to markdown"
-  - "markdown to docx"
-  - "build a markdown corpus"
-  - "render the equations to word"
-  - "build-corpus"
----
-
-# rdc-convert — Office ↔ Markdown conversion (build-corpus)
-
-`build-corpus` is a Python CLI that converts between Office documents and Markdown.
-This is a self-contained skill: install the tool from GitHub into the current
-session and run `build-corpus`. No local checkout or other rdc skill is required.
-
-## When to Use
-- `.docx` / `.pptx` / `.ppt` → Markdown — preserves Word OMML equations (as
-  KaTeX-readable TeX), tables, images, headings, and lists.
-- Markdown → Word (`.docx`) — inline `$...$` and display `$$...$$` LaTeX are
-  converted to **native OMML** Word renders as real equations; optional `.dotx`
-  template via `--word-template`.
-- Build a Markdown corpus from a folder of Office files (recursive, one pass).
-- Inline a Markdown file's images as data URIs, or rehost them to R2/S3.
-
-## When NOT to Use
-- Rendering a folder/HTML/zip into a print-ready **PDF** brochure (that is a
-  separate brochure pipeline).
-- Rasterizing HTML/JSX/SVG to images — build-corpus is a format converter, not a
-  render engine; it flags those and a separate render step handles them.
-
-## Install & Run (install from GitHub — it is the source of truth)
-
-The published PyPI/npm packages lag GitHub. Install from the repository to get the
-current behavior (native LaTeX→OMML, the fidelity report, the escaped-currency fix):
-
-```bash
-pip install "git+https://github.com/LIFEAI/build-corpus.git@feat/dual-package-ubuntu"
-# once merged to main, drop the @branch:
-#   pip install "git+https://github.com/LIFEAI/build-corpus.git"
-build-corpus --help
-```
-
-This installs the `build-corpus` command and its dependencies (latex2mathml,
-mathml2omml, python-docx, Pillow, omml2latex). Notes:
-- Debian/Ubuntu externally-managed Python (PEP 668): add `--break-system-packages`,
-  use a venv, or `pipx install "git+https://github.com/LIFEAI/build-corpus.git@feat/dual-package-ubuntu"`.
-- S3/R2 image upload: append `[s3]` to the package spec.
-- Legacy `.ppt` input also needs LibreOffice (`soffice`) on PATH (`apt install libreoffice`).
-  `.docx`/`.pptx` need nothing extra.
-
-## Command Reference
-
-```
-build-corpus <input> [input ...] [options]
-```
-
-`<input>` — one or more `.md`, `.docx`, `.pptx`, or `.ppt` files or directories.
-
-| Flag | Values / default | Effect |
-|------|------------------|--------|
-| `--out <dir>` | path | Output directory for the converted tree. |
-| `--out-same-dir` | — | Write `.md`, `.assets`, and reports beside each source file. |
-| `--to` | `auto` \| `markdown` \| `word` (default `auto`) | Output target. `auto` infers from a single-file input. |
-| `--images` | `assets` \| `base64` \| `s3` (default `assets`) | Image handling. |
-| `--equations` | `tex` \| `image` (default `tex`) | docx→md: OMML → KaTeX TeX, or rendered images (debug). |
-| `--inline-images` | — | Emit `<name>.inline.md` with images embedded as data URIs. |
-| `--word-template <file>` | `.docx`/`.dotx` | Template for Markdown → Word exports. |
-| `--move-sources` | — | After a successful convert, move sources into a `sources/` folder. |
-| `--config <file>` | JSON | Conversion/output/S3 defaults (CLI flags override). |
-
-S3/R2 (only with `--images s3`): `--s3-bucket`, `--s3-public-base-url`,
-`--s3-prefix`, `--s3-endpoint-url` (required for R2), `--s3-region` (`auto` for R2),
-`--s3-access-key-id`, `--s3-secret-access-key`, `--s3-cache-control`, `--s3-acl`.
-
-## Equations (real in both directions)
-- **docx → markdown** (`--equations`): `tex` converts Word OMML equations to
-  KaTeX-readable TeX (default); `image` renders them as images (debug only).
-- **markdown → word** (`--to word`): inline `$...$` and display `$$...$$` LaTeX are
-  converted to **native OMML** (`\sum`, `\int`, `\frac`, `\Delta`, `\rightarrow`,
-  `\leq`, …). Escaped currency like `\$252.3B` is kept as literal text, never mistaken
-  for math. Unparseable fragments fall back to Cambria-Math text and are flagged in the
-  report. Fence display math with `$$` on their own lines, no blank lines inside.
-
-## Fidelity report (md → word)
-Each md→word export writes `export-report.json` (and a batch report) so you can
-confirm nothing was silently dropped or changed:
-- **`fidelity_ok`** — top-level ship gate (`true` only when every row matches and no
-  equation fell back).
-- **`reconciliation`** — input vs output per type (`tables`, `equations`
-  {in/out_omml/fell_back}, `images` {in/out/failed}, `code_blocks`, `headings`, `links`).
-- **`issues`** — `{ type, line, source|target, reason }` per problem.
-- **`text_fixups`** — markdown escapes the engine resolved (e.g. `currency_unescaped`).
-- A one-line **stdout digest** for a quick glance.
-
-Image-failure `reason` values: `missing-file`, `unsupported-on-platform` (EMF/WMF —
-install LibreOffice), `unsupported-format` (.html/.jsx — route to a render pipeline),
-`svg-needs-rasterization` / `mislabeled-svg` (rasterize the SVG to PNG and repoint),
-`skipped-remote`.
-
-## Examples
-
-```bash
-build-corpus input.docx --out out                              # docx → markdown
-build-corpus deck.pptx --out out                               # pptx → markdown
-build-corpus ./word-files --out ./markdown                     # whole folder, recursive
-build-corpus ./word-files --out-same-dir                       # write beside each source
-build-corpus input.md --to word --out out                      # markdown → Word (LaTeX → OMML)
-build-corpus input.md --to word --word-template custom.dotx --out out
-build-corpus report.md --inline-images                         # → report.inline.md
-build-corpus input.docx --images s3 --config build-corpus.config.json
-```
-
-## Boundaries
-- Does not commit, deploy, or upload outputs (except images when `--images s3`).
-- Does not modify source documents unless `--move-sources` is passed.
-- Does not rasterize HTML/JSX/SVG — flags them for an external render step.
-
-## Reference
-- Source (install from here): `github.com/LIFEAI/build-corpus`
-- Packages (currently lag GitHub): PyPI `build-corpus`, npm `regen-mde`.