@lifeaitools/rdc-skills 0.35.18 → 0.35.21

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.35.18",
+  "version": "0.35.21",
   "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/.github/workflows/self-test.yml

@@ -1,29 +1,29 @@
-name: self-test
-
-on:
-  push:
-    branches: ['**']
-    tags: ['v*']
-  pull_request:
-
-jobs:
-  tier1:
-    name: Tier 1 static lint
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
-      - name: Run rdc:self-test --strict (Tier 1)
-        # Tier 2 requires headless claude + clauth daemon — not available in standard CI.
-        # Tier 1 catches the backtick-drift + frontmatter class of bugs.
-        run: node scripts/self-test.mjs --strict
-
+name: self-test
+
+on:
+  push:
+    branches: ['**']
+    tags: ['v*']
+  pull_request:
+
+jobs:
+  tier1:
+    name: Tier 1 static lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Run rdc:self-test --strict (Tier 1)
+        # Tier 2 requires headless claude + clauth daemon — not available in standard CI.
+        # Tier 1 catches the backtick-drift + frontmatter class of bugs.
+        run: node scripts/self-test.mjs --strict
+
   tier2-gate:
     name: Tier 2 behavioral (tag releases only)
     runs-on: ubuntu-latest
@@ -32,14 +32,14 @@ jobs:
     env:
       ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
       - name: Install claude CLI
         if: env.ANTHROPIC_API_KEY != ''
         run: npm install -g @anthropic-ai/claude-code

package/MANIFEST.md

@@ -1,224 +1,224 @@
-# RDC Skills Library — Manifest
-
-**Created:** 2026-04-13  
-**Last updated:** 2026-05-01  
-**Source:** Regen Root project `.claude/skills/user/`  
-**Files:** 31 skill files, 10 agent guides, command mirrors, and support scripts  
-**Size:** ~480K  
-
-## Generic Conversion Summary
-
-All skills have been converted from project-specific to generic/portable:
-
-### Path Replacements
-- `C:/Dev/regen-root/` → `{PROJECT_ROOT}/`
-- Hardcoded app names (rdc-marketing-engine, brand-studio, prt, etc.) → generic examples
-- Specific Supabase project IDs → generic table references
-- Developer-specific paths → variables
-
-### TDD Enhancements
-- Added mandatory post-wave test gate to rdc:build
-- Updated rdc:review with test coverage delta reporting
-- Added test-first requirement to all agent skills
-- TDD enforcement: red → implement → green cycle
-
-### Preserved Elements
-- All logic and procedures (100%)
-- All safety rules
-- All RPC patterns
-- Branch strategy (development → production)
-- Work item lifecycle
-- Escalation protocols
-- Unattended mode patterns
-- Status block format
-
-## Files Created
-
-```
-/c/Dev/rdc-skills/
-├── README.md
-├── MANIFEST.md (this file)
-└── skills/
-    ├── build/SKILL.md        [+TDD enforcement, +verify gate]
-    ├── plan/SKILL.md
-    ├── preplan/SKILL.md
-    ├── review/SKILL.md       [+test coverage delta, +verify gate]
-    ├── overnight/SKILL.md
-    ├── fixit/SKILL.md
-    ├── status/SKILL.md
-    ├── report/SKILL.md
-    ├── co-develop/SKILL.md   [peer-aware Claude/Codex co-development]
-    ├── collab/SKILL.md       [claude.ai ↔ Claude Code relay]
-    ├── handoff/SKILL.md
-    ├── prototype/SKILL.md
-    ├── workitems/SKILL.md
-    ├── design/SKILL.md       [RDC/Studio design, Palette Library, Rampa CLI]
-    ├── help/SKILL.md
-    ├── regen-media/SKILL.md [primary image generation + Regen Media upload]
-    ├── deploy/SKILL.md       [Coolify deployment ops]
-    ├── release/SKILL.md      [atomic version release]
-    ├── self-test/SKILL.md    [static lint + tier2 smoke tests]
-    └── watch/SKILL.md        [session log + browser viewer]
-└── guides/agents/     (agent-only playbooks — dispatched by rdc:build, not user-invocable)
-    ├── frontend.md
-    ├── backend.md
-    ├── cs2.md
-    ├── data.md
-    ├── design.md
-    ├── infrastructure.md
-    ├── content.md
-    ├── viz.md
-    ├── setup.md
-    └── verify.md
-```
-
-**Note (v0.7.9):** Skills migrated from flat `rdc-<name>.md` files to `<name>/SKILL.md` subdirectories. Plugin namespace is `rdc`, so composed skill names are `rdc:<name>` — matching the frontmatter. This eliminates the duplicate `rdc:rdc-*` registration that occurred when directories were named `rdc-<name>/`.
-
-## Skill Categories
-
-### Orchestration (8)
-- rdc:build — dispatch typed agents in waves
-- rdc:plan — architecture + epic/tasks
-- rdc:preplan — research before planning
-- rdc:review — quality gate
-- rdc:overnight — unattended build supervisor
-- rdc:fixit — quick-fix bypass
-- rdc:status — project dashboard
-- rdc:report — nightly report
-
-### DevOps (3)
-- rdc:deploy — Coolify deployment ops (deploy, new, diagnose, audit)
-- rdc:release — atomic version release with git tag + changelog
-- rdc:watch — session log + browser viewer for Claude activity
-
-### Quality (1)
-- rdc:self-test — static lint (tier1) + smoke tests (tier2)
-
-### Collaboration (1)
-- rdc:co-develop — peer-aware Claude/Codex co-development over clauth
-
-### Agent Guides (10, in `guides/agents/`) — [agent-only — dispatched by rdc:build, not user-invocable]
-- frontend — React, UI, Tailwind
-- backend — API, database, auth
-- data — migrations, schema
-- design — brand, tokens
-- infrastructure — deployment, CI/CD
-- content — copy, messaging
-- cs2 — paradigm-level work
-- viz — visualizations
-- setup — project scan + .rdc/config.json generation
-- verify — evidence-before-claims verification gate
-
-### Utility (1)
-- rdc:collab — bidirectional claude.ai ↔ Claude Code relay via file transport
-- rdc:channel-formatter — channel-native formatting and content repurposing,
-  including article-to-post, social-pack, campaign-pack, exec-pack, and
-  launch-pack outputs
-- rdc:regen-media — primary image generation and Regen Media upload workflow,
-  defaulting to local keyless Codex `gpt-image-2` via built-in `image_gen`
-
-### Bridge (3)
-- rdc:handoff — planning → work items
-- rdc:prototype — JSX prototypes
-- rdc:workitems — work item CRUD
-
-### Design (1)
-- rdc:design — Studio-aware design workflow with token, Palette Library, and Rampa CLI context
-
-### Reference (1)
-- rdc:help — skill index
-
-## Usage Instructions
-
-1. **Clone or reference** the `/c/Dev/rdc-skills/` directory
-2. **Update path variables** in all skills for your project
-3. **Create project guides** (agent-bootstrap.md, frontend.md, etc.)
-4. **Set up database** (work_items RPC, prototype_registry, design_context)
-5. **Invoke skills** via your agent framework
-   - Interactive: `/rdc:build <epic-id>`
-   - Unattended: `/rdc:overnight`
-   - Quality: `/rdc:review --unattended`
-   - Content repurposing: `/rdc:channel-formatter social-pack article.md`
-
-## Channel Formatter Content Packs
-
-`rdc:channel-formatter` can strictly format copy for one channel or repurpose a
-long source into a channel-native output set.
-
-Examples:
-
-```bash
-rdc:channel-formatter linkedin article.md
-rdc:channel-formatter twitter-thread article.md
-rdc:channel-formatter social-pack article.md
-rdc:channel-formatter campaign-pack report.md
-```
-
-Use `rdc:convert` for actual Office/Markdown file conversion, `rdc:brochure`
-for HTML/folder/URL PDF rendering, and `rdc:brochurify` for Brochurify
-orchestration. Channel formatter writes and repurposes text; it does not produce
-binary Word or PDF artifacts.
-
-## Key Differences from Source
-
-### Added: TDD Enforcement
-
-**rdc:build (Step 8):**
-```bash
-# Post-wave test gate (mandatory)
-cd packages/<name> && npx vitest run 2>&1 | tail -20
-```
-All tests must pass before next wave.
-
-**All agent skills:**
-```
-TDD REQUIREMENT: Write tests FIRST for new functions/modules.
-Run: npx vitest run packages/<name>
-```
-
-**rdc:review (Step 3):**
-```bash
-# Check test coverage delta
-git diff origin/main...HEAD -- packages/*/src/ | grep -c "^+"
-git diff origin/main...HEAD -- packages/*/test* | grep -c "^+"
-```
-Flags any package with implementation added but 0 new tests.
-
-**rdc:review report format:**
-```
-| Package | Tests | Pass/Fail | New Tests Added | Issues |
-```
-
-### Preserved: All Logic
-
-- Work item RPC patterns (never raw SQL)
-- Agent type classification
-- Wave-based parallelization
-- Escalation protocols
-- Unattended mode patterns
-- Status block formatting
-- Safety rules (100%)
-- Branch strategy
-
-## Deployment
-
-These skills are ready to use in any project that has:
-
-1. A monorepo with `packages/`, `apps/`, or `sites/` structure
-2. A database (Supabase, PostgreSQL, etc.) with work_items RPC functions
-3. Capability to run agents (Claude Code, subagents, or CLI)
-4. Git-based version control with at least 2 branches (dev + prod)
-5. A credential management system (clauth daemon or equivalent)
-
-## Questions?
-
-- **Specific project integration:** Refer to your project's infrastructure documentation
-- **Skill logic:** All skills are pure logic extracted from Regen Root; no project-specific magic
-- **TDD requirements:** Built into every skill; red → implement → green is mandatory
-- **Database schema:** You define; skills use generic `work_items` table and RPC patterns
-
----
-
-**Manifest created:** 2026-04-13  
-**Source project:** Regen Root (github.com/LIFEAI/regen-root)  
-**Genericization:** Complete — all hardcoded references removed, all logic preserved
+# RDC Skills Library — Manifest
+
+**Created:** 2026-04-13  
+**Last updated:** 2026-05-01  
+**Source:** Regen Root project `.claude/skills/user/`  
+**Files:** 31 skill files, 10 agent guides, command mirrors, and support scripts  
+**Size:** ~480K  
+
+## Generic Conversion Summary
+
+All skills have been converted from project-specific to generic/portable:
+
+### Path Replacements
+- `C:/Dev/regen-root/` → `{PROJECT_ROOT}/`
+- Hardcoded app names (rdc-marketing-engine, brand-studio, prt, etc.) → generic examples
+- Specific Supabase project IDs → generic table references
+- Developer-specific paths → variables
+
+### TDD Enhancements
+- Added mandatory post-wave test gate to rdc:build
+- Updated rdc:review with test coverage delta reporting
+- Added test-first requirement to all agent skills
+- TDD enforcement: red → implement → green cycle
+
+### Preserved Elements
+- All logic and procedures (100%)
+- All safety rules
+- All RPC patterns
+- Branch strategy (development → production)
+- Work item lifecycle
+- Escalation protocols
+- Unattended mode patterns
+- Status block format
+
+## Files Created
+
+```
+/c/Dev/rdc-skills/
+├── README.md
+├── MANIFEST.md (this file)
+└── skills/
+    ├── build/SKILL.md        [+TDD enforcement, +verify gate]
+    ├── plan/SKILL.md
+    ├── preplan/SKILL.md
+    ├── review/SKILL.md       [+test coverage delta, +verify gate]
+    ├── overnight/SKILL.md
+    ├── fixit/SKILL.md
+    ├── status/SKILL.md
+    ├── report/SKILL.md
+    ├── co-develop/SKILL.md   [peer-aware Claude/Codex co-development]
+    ├── collab/SKILL.md       [claude.ai ↔ Claude Code relay]
+    ├── handoff/SKILL.md
+    ├── prototype/SKILL.md
+    ├── workitems/SKILL.md
+    ├── design/SKILL.md       [RDC/Studio design, Palette Library, Rampa CLI]
+    ├── help/SKILL.md
+    ├── regen-media/SKILL.md [primary image generation + Regen Media upload]
+    ├── deploy/SKILL.md       [Coolify deployment ops]
+    ├── release/SKILL.md      [atomic version release]
+    ├── self-test/SKILL.md    [static lint + tier2 smoke tests]
+    └── watch/SKILL.md        [session log + browser viewer]
+└── guides/agents/     (agent-only playbooks — dispatched by rdc:build, not user-invocable)
+    ├── frontend.md
+    ├── backend.md
+    ├── cs2.md
+    ├── data.md
+    ├── design.md
+    ├── infrastructure.md
+    ├── content.md
+    ├── viz.md
+    ├── setup.md
+    └── verify.md
+```
+
+**Note (v0.7.9):** Skills migrated from flat `rdc-<name>.md` files to `<name>/SKILL.md` subdirectories. Plugin namespace is `rdc`, so composed skill names are `rdc:<name>` — matching the frontmatter. This eliminates the duplicate `rdc:rdc-*` registration that occurred when directories were named `rdc-<name>/`.
+
+## Skill Categories
+
+### Orchestration (8)
+- rdc:build — dispatch typed agents in waves
+- rdc:plan — architecture + epic/tasks
+- rdc:preplan — research before planning
+- rdc:review — quality gate
+- rdc:overnight — unattended build supervisor
+- rdc:fixit — quick-fix bypass
+- rdc:status — project dashboard
+- rdc:report — nightly report
+
+### DevOps (3)
+- rdc:deploy — Coolify deployment ops (deploy, new, diagnose, audit)
+- rdc:release — atomic version release with git tag + changelog
+- rdc:watch — session log + browser viewer for Claude activity
+
+### Quality (1)
+- rdc:self-test — static lint (tier1) + smoke tests (tier2)
+
+### Collaboration (1)
+- rdc:co-develop — peer-aware Claude/Codex co-development over clauth
+
+### Agent Guides (10, in `guides/agents/`) — [agent-only — dispatched by rdc:build, not user-invocable]
+- frontend — React, UI, Tailwind
+- backend — API, database, auth
+- data — migrations, schema
+- design — brand, tokens
+- infrastructure — deployment, CI/CD
+- content — copy, messaging
+- cs2 — paradigm-level work
+- viz — visualizations
+- setup — project scan + .rdc/config.json generation
+- verify — evidence-before-claims verification gate
+
+### Utility (1)
+- rdc:collab — bidirectional claude.ai ↔ Claude Code relay via file transport
+- rdc:channel-formatter — channel-native formatting and content repurposing,
+  including article-to-post, social-pack, campaign-pack, exec-pack, and
+  launch-pack outputs
+- rdc:regen-media — primary image generation and Regen Media upload workflow,
+  defaulting to local keyless Codex `gpt-image-2` via built-in `image_gen`
+
+### Bridge (3)
+- rdc:handoff — planning → work items
+- rdc:prototype — JSX prototypes
+- rdc:workitems — work item CRUD
+
+### Design (1)
+- rdc:design — Studio-aware design workflow with token, Palette Library, and Rampa CLI context
+
+### Reference (1)
+- rdc:help — skill index
+
+## Usage Instructions
+
+1. **Clone or reference** the `/c/Dev/rdc-skills/` directory
+2. **Update path variables** in all skills for your project
+3. **Create project guides** (agent-bootstrap.md, frontend.md, etc.)
+4. **Set up database** (work_items RPC, prototype_registry, design_context)
+5. **Invoke skills** via your agent framework
+   - Interactive: `/rdc:build <epic-id>`
+   - Unattended: `/rdc:overnight`
+   - Quality: `/rdc:review --unattended`
+   - Content repurposing: `/rdc:channel-formatter social-pack article.md`
+
+## Channel Formatter Content Packs
+
+`rdc:channel-formatter` can strictly format copy for one channel or repurpose a
+long source into a channel-native output set.
+
+Examples:
+
+```bash
+rdc:channel-formatter linkedin article.md
+rdc:channel-formatter twitter-thread article.md
+rdc:channel-formatter social-pack article.md
+rdc:channel-formatter campaign-pack report.md
+```
+
+Use `rdc:convert` for actual Office/Markdown file conversion, `rdc:brochure`
+for HTML/folder/URL PDF rendering, and `rdc:brochurify` for Brochurify
+orchestration. Channel formatter writes and repurposes text; it does not produce
+binary Word or PDF artifacts.
+
+## Key Differences from Source
+
+### Added: TDD Enforcement
+
+**rdc:build (Step 8):**
+```bash
+# Post-wave test gate (mandatory)
+cd packages/<name> && npx vitest run 2>&1 | tail -20
+```
+All tests must pass before next wave.
+
+**All agent skills:**
+```
+TDD REQUIREMENT: Write tests FIRST for new functions/modules.
+Run: npx vitest run packages/<name>
+```
+
+**rdc:review (Step 3):**
+```bash
+# Check test coverage delta
+git diff origin/main...HEAD -- packages/*/src/ | grep -c "^+"
+git diff origin/main...HEAD -- packages/*/test* | grep -c "^+"
+```
+Flags any package with implementation added but 0 new tests.
+
+**rdc:review report format:**
+```
+| Package | Tests | Pass/Fail | New Tests Added | Issues |
+```
+
+### Preserved: All Logic
+
+- Work item RPC patterns (never raw SQL)
+- Agent type classification
+- Wave-based parallelization
+- Escalation protocols
+- Unattended mode patterns
+- Status block formatting
+- Safety rules (100%)
+- Branch strategy
+
+## Deployment
+
+These skills are ready to use in any project that has:
+
+1. A monorepo with `packages/`, `apps/`, or `sites/` structure
+2. A database (Supabase, PostgreSQL, etc.) with work_items RPC functions
+3. Capability to run agents (Claude Code, subagents, or CLI)
+4. Git-based version control with at least 2 branches (dev + prod)
+5. A credential management system (clauth daemon or equivalent)
+
+## Questions?
+
+- **Specific project integration:** Refer to your project's infrastructure documentation
+- **Skill logic:** All skills are pure logic extracted from Regen Root; no project-specific magic
+- **TDD requirements:** Built into every skill; red → implement → green is mandatory
+- **Database schema:** You define; skills use generic `work_items` table and RPC patterns
+
+---
+
+**Manifest created:** 2026-04-13  
+**Source project:** Regen Root (github.com/LIFEAI/regen-root)  
+**Genericization:** Complete — all hardcoded references removed, all logic preserved

package/VALIDATOR-ARCHITECTURE.md

@@ -36,6 +36,24 @@ LLM reviewer (`pr-review-toolkit:code-reviewer`, or a Codex peer via
 `rdc:co-develop`) — listed at the bottom of this document, not hidden inside
 the tool tables.
 
+## Rendered UI evidence boundary
+
+Rendered UI verification belongs to the target application, not to a global
+browser installation or an interactive connector. A UI-bearing application
+therefore owns a pinned `@playwright/test` dependency, matching browser
+installation, `test:ui` command, and route/state assertions. The test launches
+a fresh app-owned server or the explicitly documented deploy-equivalent target;
+route `200`, source inspection, and an editor iframe remain structural evidence
+only. Headless execution is allowed by the shared environment; interactive
+`--headed`, `--ui`, `codegen`, `open`, `show-report`, and `PWDEBUG=1` are
+blocked by managed guards. Screenshot and trace artifacts are diagnostic output
+on failure, while the passing route assertion is the receipt.
+
+`rdc:open` discovers this contract, `rdc:edit` runs it after a UI change, and
+`rdc:build`/`rdc:review` reject a UI work item that lacks it. This keeps the
+ATF ladder’s visual rung attached to the application that can actually prove
+the rendered behavior.
+
 ## Shared contract
 
 Four tools (SOLID, Clean Code, Patterns, Refactoring) read from one shape:

package/bin/rdc-skills-mcp.mjs

@@ -40,6 +40,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execFileSync } from 'node:child_process';
+import { buildHealthPayload } from '@lifeaitools/clauth-surface-sdk';
 
 import {
   listSkills,
@@ -53,7 +54,7 @@ import { toCloudBody } from '../lib/cloud-rewrite.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const REPO_ROOT = path.resolve(__dirname, '..');
-const PORT = parseInt(process.env.PORT || '3110', 10);
+const PORT = Number.parseInt(process.env.PORT || '3110', 10);
 
 function pkgVersion() {
   try {
@@ -251,6 +252,45 @@ function buildMcpServer() {
     },
   );
 
+  // ── Per-skill Prompts ──────────────────────────────────────────────────────
+  // The 3 tools above were the ONLY way to reach a skill: a client had to know
+  // to call rdc_skill_list/search first, then rdc_skill_get by name. Nothing
+  // in the MCP protocol surfaced individual skills as their own first-class,
+  // browsable entities — prompts/list would return zero results, so a host
+  // app (claude.ai's connector UI, any MCP client with a prompt picker) had
+  // nothing to show a user beyond three generic tool names.
+  //
+  // MCP's Prompts primitive exists exactly for this: a named, user-invokable
+  // template a client can list and pick from. Registering every catalog skill
+  // as its own prompt makes each one independently discoverable via
+  // prompts/list, with prompts/get returning the rendered SKILL.md body as
+  // the prompt's message — the same content rdc_skill_get already renders,
+  // reused rather than duplicated. The 3 tools stay for programmatic/agent
+  // callers that already depend on them; this is additive.
+  for (const skill of listSkills()) {
+    srv.registerPrompt(
+      skill.name,
+      {
+        title: skill.slash,
+        description: skill.summary || skill.usage || skill.slash,
+        argsSchema: {
+          args: z.string().optional().describe(`Optional arguments for ${skill.slash}, e.g. the epic id for rdc:build.`),
+        },
+      },
+      async ({ args }) => {
+        const resolved = lastDetectedVariant || 'cloud';
+        const rendered = renderSkill(skill.name, resolved);
+        if (!rendered) {
+          return { messages: [{ role: 'user', content: { type: 'text', text: `Skill '${skill.name}' has no SKILL.md body on disk.` } }] };
+        }
+        const text = args
+          ? `${rendered.header}\n\nARGUMENTS: ${args}\n\n${rendered.body}`
+          : `${rendered.header}\n\n${rendered.body}`;
+        return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+      },
+    );
+  }
+
   return srv;
 }
 
@@ -266,7 +306,12 @@ function startHttp() {
     } catch {
       skills = 0;
     }
-    res.json({ status: 'ok', service: 'rdc-skills-mcp', version: pkgVersion(), git_sha: GIT_SHA, skills });
+    res.json({
+      ...buildHealthPayload({ service: 'rdc-skills-mcp', version: pkgVersion(), commands: ['start', 'stop', 'restart'] }),
+      status: 'ok',
+      git_sha: GIT_SHA,
+      skills,
+    });
   });
 
   // Block OAuth discovery so connectors skip OAuth and connect direct — /mcp is open.

package/clauth-plugin.json

@@ -34,6 +34,8 @@
       "start": [
         "pm2",
         "start",
+        "bin/rdc-skills-mcp.mjs",
+        "--name",
         "rdc-skills-mcp"
       ],
       "restart": [