@lifeaitools/rdc-skills 0.24.41 → 0.25.0

package/scripts/rdc-design-cli.mjs

@@ -1,134 +1,134 @@
-#!/usr/bin/env node
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const repoRoot = resolve(__dirname, "..");
-const skillRoot = join(repoRoot, "skills", "design");
-const reportsRoot = join(repoRoot, ".rdc", "reports", "rdc-design-cli");
-
-const args = process.argv.slice(2);
-const json = args.includes("--json");
-const cleanArgs = args.filter((arg) => arg !== "--json");
-const command = cleanArgs[0] || "help";
-const brief = cleanArgs.slice(1).join(" ").trim();
-
-const commandRefs = {
-  studio: ["studio-model", "ownership"],
-  tokens: ["studio-model", "ownership"],
-  palette: ["studio-model", "rampa", "ownership"],
-  theme: ["studio-model", "rampa", "ownership"],
-  colorize: ["rampa", "studio-model", "ownership"],
-  audit: ["studio-model", "ownership"],
-  critique: ["studio-model", "ownership"],
-  polish: ["studio-model", "ownership"],
-  craft: ["studio-model", "rampa", "ownership"],
-  help: ["ownership"],
-};
-
-function readText(path) {
-  return readFileSync(path, "utf8").replace(/\r\n/g, "\n");
-}
-
-function stripFrontmatter(text) {
-  return text.replace(/^---\n[\s\S]*?\n---\n?/, "").trim();
-}
-
-function approxTokens(text) {
-  return Math.ceil(text.length / 4);
-}
-
-function wordCount(text) {
-  const m = text.trim().match(/\S+/g);
-  return m ? m.length : 0;
-}
-
-function loadReferences(names) {
-  return names.map((name) => {
-    const path = join(skillRoot, "reference", `${name}.md`);
-    if (!existsSync(path)) throw new Error(`Missing reference: ${path}`);
-    return { name, path, text: readText(path) };
-  });
-}
-
-function buildPrompt() {
-  const skillPath = join(skillRoot, "SKILL.md");
-  if (!existsSync(skillPath)) throw new Error(`Missing skill file: ${skillPath}`);
-
-  const refs = loadReferences(commandRefs[command] || ["studio-model", "ownership"]);
-  const skill = stripFrontmatter(readText(skillPath));
-  const refText = refs.map((ref) => `## Reference: ${ref.name}\n\n${ref.text}`).join("\n\n");
-  const target = brief || "(no brief supplied)";
-
-  const prompt = [
-    "# rdc:design CLI Prompt",
-    "",
-    `Command: ${command}`,
-    `Brief: ${target}`,
-    "",
-    "## Operating Instructions",
-    "",
-    skill,
-    "",
-    refText,
-    "",
-    "## User Task",
-    "",
-    `Execute \`rdc:design ${command}\` for: ${target}`,
-    "",
-    "Return checklist-first output, cite concrete Studio files/routes/tables when relevant, and do not mutate unrelated installed skills or vendor artifacts.",
-  ].join("\n");
-
-  return { prompt, refs };
-}
-
-function writeReport(report) {
-  mkdirSync(reportsRoot, { recursive: true });
-  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const base = join(reportsRoot, `${stamp}-${command}`);
-  writeFileSync(`${base}.txt`, report.prompt);
-  writeFileSync(`${base}.json`, JSON.stringify(report, null, 2));
-  return { textPath: `${base}.txt`, jsonPath: `${base}.json` };
-}
-
-try {
-  const { prompt, refs } = buildPrompt();
-  const report = {
-    command,
-    brief,
-    generated_at: new Date().toISOString(),
-    references: refs.map((ref) => ({
-      name: ref.name,
-      path: ref.path,
-      chars: ref.text.length,
-      words: wordCount(ref.text),
-      approx_tokens: approxTokens(ref.text),
-    })),
-    totals: {
-      chars: prompt.length,
-      words: wordCount(prompt),
-      approx_tokens: approxTokens(prompt),
-    },
-    prompt,
-  };
-  const paths = writeReport(report);
-  report.paths = paths;
-
-  if (json) {
-    console.log(JSON.stringify(report, null, 2));
-  } else {
-    console.log(`rdc-design-cli`);
-    console.log(`command: ${command}`);
-    console.log(`brief: ${brief || "(none)"}`);
-    console.log(`chars: ${report.totals.chars}`);
-    console.log(`words: ${report.totals.words}`);
-    console.log(`approx_tokens: ${report.totals.approx_tokens}`);
-    console.log(`references: ${report.references.map((r) => r.name).join(", ")}`);
-    console.log(`text: ${paths.textPath}`);
-    console.log(`json: ${paths.jsonPath}`);
-  }
-} catch (error) {
-  console.error(`rdc-design-cli error: ${error.message}`);
-  process.exit(1);
-}
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(__dirname, "..");
+const skillRoot = join(repoRoot, "skills", "design");
+const reportsRoot = join(repoRoot, ".rdc", "reports", "rdc-design-cli");
+
+const args = process.argv.slice(2);
+const json = args.includes("--json");
+const cleanArgs = args.filter((arg) => arg !== "--json");
+const command = cleanArgs[0] || "help";
+const brief = cleanArgs.slice(1).join(" ").trim();
+
+const commandRefs = {
+  studio: ["studio-model", "ownership"],
+  tokens: ["studio-model", "ownership"],
+  palette: ["studio-model", "rampa", "ownership"],
+  theme: ["studio-model", "rampa", "ownership"],
+  colorize: ["rampa", "studio-model", "ownership"],
+  audit: ["studio-model", "ownership"],
+  critique: ["studio-model", "ownership"],
+  polish: ["studio-model", "ownership"],
+  craft: ["studio-model", "rampa", "ownership"],
+  help: ["ownership"],
+};
+
+function readText(path) {
+  return readFileSync(path, "utf8").replace(/\r\n/g, "\n");
+}
+
+function stripFrontmatter(text) {
+  return text.replace(/^---\n[\s\S]*?\n---\n?/, "").trim();
+}
+
+function approxTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+
+function wordCount(text) {
+  const m = text.trim().match(/\S+/g);
+  return m ? m.length : 0;
+}
+
+function loadReferences(names) {
+  return names.map((name) => {
+    const path = join(skillRoot, "reference", `${name}.md`);
+    if (!existsSync(path)) throw new Error(`Missing reference: ${path}`);
+    return { name, path, text: readText(path) };
+  });
+}
+
+function buildPrompt() {
+  const skillPath = join(skillRoot, "SKILL.md");
+  if (!existsSync(skillPath)) throw new Error(`Missing skill file: ${skillPath}`);
+
+  const refs = loadReferences(commandRefs[command] || ["studio-model", "ownership"]);
+  const skill = stripFrontmatter(readText(skillPath));
+  const refText = refs.map((ref) => `## Reference: ${ref.name}\n\n${ref.text}`).join("\n\n");
+  const target = brief || "(no brief supplied)";
+
+  const prompt = [
+    "# rdc:design CLI Prompt",
+    "",
+    `Command: ${command}`,
+    `Brief: ${target}`,
+    "",
+    "## Operating Instructions",
+    "",
+    skill,
+    "",
+    refText,
+    "",
+    "## User Task",
+    "",
+    `Execute \`rdc:design ${command}\` for: ${target}`,
+    "",
+    "Return checklist-first output, cite concrete Studio files/routes/tables when relevant, and do not mutate unrelated installed skills or vendor artifacts.",
+  ].join("\n");
+
+  return { prompt, refs };
+}
+
+function writeReport(report) {
+  mkdirSync(reportsRoot, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const base = join(reportsRoot, `${stamp}-${command}`);
+  writeFileSync(`${base}.txt`, report.prompt);
+  writeFileSync(`${base}.json`, JSON.stringify(report, null, 2));
+  return { textPath: `${base}.txt`, jsonPath: `${base}.json` };
+}
+
+try {
+  const { prompt, refs } = buildPrompt();
+  const report = {
+    command,
+    brief,
+    generated_at: new Date().toISOString(),
+    references: refs.map((ref) => ({
+      name: ref.name,
+      path: ref.path,
+      chars: ref.text.length,
+      words: wordCount(ref.text),
+      approx_tokens: approxTokens(ref.text),
+    })),
+    totals: {
+      chars: prompt.length,
+      words: wordCount(prompt),
+      approx_tokens: approxTokens(prompt),
+    },
+    prompt,
+  };
+  const paths = writeReport(report);
+  report.paths = paths;
+
+  if (json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    console.log(`rdc-design-cli`);
+    console.log(`command: ${command}`);
+    console.log(`brief: ${brief || "(none)"}`);
+    console.log(`chars: ${report.totals.chars}`);
+    console.log(`words: ${report.totals.words}`);
+    console.log(`approx_tokens: ${report.totals.approx_tokens}`);
+    console.log(`references: ${report.references.map((r) => r.name).join(", ")}`);
+    console.log(`text: ${paths.textPath}`);
+    console.log(`json: ${paths.jsonPath}`);
+  }
+} catch (error) {
+  console.error(`rdc-design-cli error: ${error.message}`);
+  process.exit(1);
+}

package/scripts/rebuild-mcp.mjs

@@ -1,107 +1,107 @@
-#!/usr/bin/env node
-/**
- * scripts/rebuild-mcp.mjs — "build hook" for the rdc-skills MCP server.
- *
- * The server reads skills live from disk, so a skill edit is usually picked up
- * without a restart. This script exists to (a) bounce the PM2 process so any
- * in-memory module cache is dropped, and (b) assert the local /health endpoint
- * reports the current on-disk skill count — a fast smoke that the server is up
- * and seeing the same catalog this script does.
- *
- * Tolerant of a missing PM2: if pm2 is not installed/registered, it prints how
- * to start the server and exits 0. It never hard-fails the caller.
- */
-
-import { execSync } 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, '..');
-const PM2_NAME = 'rdc-skills-mcp';
-const PORT = parseInt(process.env.PORT || '3110', 10);
-const BIN = path.join(REPO_ROOT, 'bin', 'rdc-skills-mcp.mjs');
-
-const ok = (m) => console.log(`  \x1b[32m✓\x1b[0m ${m}`);
-const info = (m) => console.log(`  \x1b[36m→\x1b[0m ${m}`);
-const warn = (m) => console.log(`  \x1b[33m⚠\x1b[0m ${m}`);
-
-function sh(cmd) {
-  return execSync(cmd, { encoding: 'utf8', stdio: 'pipe' }).trim();
-}
-
-function pm2Available() {
-  try {
-    sh('pm2 -v');
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function pm2HasProcess() {
-  try {
-    const list = JSON.parse(sh('pm2 jlist'));
-    return Array.isArray(list) && list.some((p) => p.name === PM2_NAME);
-  } catch {
-    return false;
-  }
-}
-
-async function checkHealth(expectedSkills) {
-  // Node 22 has global fetch.
-  try {
-    const res = await fetch(`http://127.0.0.1:${PORT}/health`, { signal: AbortSignal.timeout(4000) });
-    if (!res.ok) {
-      warn(`/health returned HTTP ${res.status}`);
-      return false;
-    }
-    const json = await res.json();
-    if (json.skills === expectedSkills) {
-      ok(`/health OK — skills=${json.skills} (matches disk), version=${json.version}`);
-      return true;
-    }
-    warn(`/health skills=${json.skills} but disk has ${expectedSkills} — server may be stale`);
-    return false;
-  } catch (err) {
-    warn(`/health unreachable on port ${PORT}: ${err?.message || err}`);
-    return false;
-  }
-}
-
-async function main() {
-  const diskSkills = listSkills().length;
-  info(`On-disk catalog: ${diskSkills} skill(s)`);
-
-  if (!pm2Available()) {
-    warn('pm2 not found — cannot bounce the MCP process.');
-    info(`Start it manually:  PORT=${PORT} pm2 start ${BIN} --name ${PM2_NAME}`);
-    info(`Or run directly:    PORT=${PORT} node ${BIN}`);
-    process.exit(0);
-  }
-
-  if (pm2HasProcess()) {
-    try {
-      sh(`pm2 restart ${PM2_NAME} --update-env`);
-      ok(`pm2 restart ${PM2_NAME}`);
-    } catch (err) {
-      warn(`pm2 restart failed: ${err?.message || err}`);
-    }
-  } else {
-    info(`pm2 process '${PM2_NAME}' not registered.`);
-    info(`Start it:  PORT=${PORT} pm2 start ${BIN} --name ${PM2_NAME}`);
-    process.exit(0);
-  }
-
-  // Give the process a beat to bind, then probe /health (no long sleeps).
-  await new Promise((r) => setTimeout(r, 1200));
-  await checkHealth(diskSkills);
-  process.exit(0);
-}
-
-main().catch((err) => {
-  warn(`rebuild-mcp error (non-fatal): ${err?.message || err}`);
-  process.exit(0);
-});
+#!/usr/bin/env node
+/**
+ * scripts/rebuild-mcp.mjs — "build hook" for the rdc-skills MCP server.
+ *
+ * The server reads skills live from disk, so a skill edit is usually picked up
+ * without a restart. This script exists to (a) bounce the PM2 process so any
+ * in-memory module cache is dropped, and (b) assert the local /health endpoint
+ * reports the current on-disk skill count — a fast smoke that the server is up
+ * and seeing the same catalog this script does.
+ *
+ * Tolerant of a missing PM2: if pm2 is not installed/registered, it prints how
+ * to start the server and exits 0. It never hard-fails the caller.
+ */
+
+import { execSync } 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, '..');
+const PM2_NAME = 'rdc-skills-mcp';
+const PORT = parseInt(process.env.PORT || '3110', 10);
+const BIN = path.join(REPO_ROOT, 'bin', 'rdc-skills-mcp.mjs');
+
+const ok = (m) => console.log(`  \x1b[32m✓\x1b[0m ${m}`);
+const info = (m) => console.log(`  \x1b[36m→\x1b[0m ${m}`);
+const warn = (m) => console.log(`  \x1b[33m⚠\x1b[0m ${m}`);
+
+function sh(cmd) {
+  return execSync(cmd, { encoding: 'utf8', stdio: 'pipe' }).trim();
+}
+
+function pm2Available() {
+  try {
+    sh('pm2 -v');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function pm2HasProcess() {
+  try {
+    const list = JSON.parse(sh('pm2 jlist'));
+    return Array.isArray(list) && list.some((p) => p.name === PM2_NAME);
+  } catch {
+    return false;
+  }
+}
+
+async function checkHealth(expectedSkills) {
+  // Node 22 has global fetch.
+  try {
+    const res = await fetch(`http://127.0.0.1:${PORT}/health`, { signal: AbortSignal.timeout(4000) });
+    if (!res.ok) {
+      warn(`/health returned HTTP ${res.status}`);
+      return false;
+    }
+    const json = await res.json();
+    if (json.skills === expectedSkills) {
+      ok(`/health OK — skills=${json.skills} (matches disk), version=${json.version}`);
+      return true;
+    }
+    warn(`/health skills=${json.skills} but disk has ${expectedSkills} — server may be stale`);
+    return false;
+  } catch (err) {
+    warn(`/health unreachable on port ${PORT}: ${err?.message || err}`);
+    return false;
+  }
+}
+
+async function main() {
+  const diskSkills = listSkills().length;
+  info(`On-disk catalog: ${diskSkills} skill(s)`);
+
+  if (!pm2Available()) {
+    warn('pm2 not found — cannot bounce the MCP process.');
+    info(`Start it manually:  PORT=${PORT} pm2 start ${BIN} --name ${PM2_NAME}`);
+    info(`Or run directly:    PORT=${PORT} node ${BIN}`);
+    process.exit(0);
+  }
+
+  if (pm2HasProcess()) {
+    try {
+      sh(`pm2 restart ${PM2_NAME} --update-env`);
+      ok(`pm2 restart ${PM2_NAME}`);
+    } catch (err) {
+      warn(`pm2 restart failed: ${err?.message || err}`);
+    }
+  } else {
+    info(`pm2 process '${PM2_NAME}' not registered.`);
+    info(`Start it:  PORT=${PORT} pm2 start ${BIN} --name ${PM2_NAME}`);
+    process.exit(0);
+  }
+
+  // Give the process a beat to bind, then probe /health (no long sleeps).
+  await new Promise((r) => setTimeout(r, 1200));
+  await checkHealth(diskSkills);
+  process.exit(0);
+}
+
+main().catch((err) => {
+  warn(`rebuild-mcp error (non-fatal): ${err?.message || err}`);
+  process.exit(0);
+});