@lifeaitools/rdc-skills 0.11.0 → 0.13.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.11.0",
+  "version": "0.13.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",
@@ -9,9 +9,11 @@
   "homepage": "https://github.com/LIFEAI/rdc-skills",
   "repository": "https://github.com/LIFEAI/rdc-skills",
   "skills": [
+    "brochure",
     "build",
     "co-develop",
     "collab",
+    "convert",
     "deploy",
     "design",
     "fixit",
@@ -53,6 +55,41 @@
     "codeflow_required": "bool — true if the skill MUST consult CodeFlow before acting on the codebase"
   },
   "skills_meta": {
+    "brochure": {
+      "name": "brochure",
+      "slash": "rdc:brochure",
+      "category": "tooling",
+      "usage": "rdc:brochure <input> [--out path] [--template name] [--format Letter|A4]",
+      "args": {
+        "positional": [
+          { "name": "input", "required": true, "description": "Path to .zip, folder, .html, .md, or http(s)://... URL", "accepts": "path|url" }
+        ],
+        "flags": [
+          { "name": "--out", "type": "path", "default": null, "description": "Output PDF path. Defaults to <input-basename>.pdf next to the input." },
+          { "name": "--template", "type": "string", "default": "studio-default", "description": "Compose-mode template (scaffold/templates/brochure-<name>.html)." },
+          { "name": "--format", "type": "string", "default": "Letter", "description": "Page size: Letter or A4." },
+          { "name": "--margin", "type": "string", "default": null, "description": "Override CSS @page margin (e.g. \"0.5in\")." },
+          { "name": "--no-print-emulate", "type": "bool", "default": false, "description": "Render with screen media instead of print." },
+          { "name": "--keep-workdir", "type": "bool", "default": false, "description": "Keep the staged working directory for inspection." }
+        ]
+      },
+      "requires": [],
+      "produces": ["pdf_artifact"],
+      "default_model": "sonnet",
+      "triggers": [
+        "make a brochure",
+        "render this html to pdf",
+        "convert this zip to pdf",
+        "puppeteer pdf",
+        "print this to pdf"
+      ],
+      "follows": [],
+      "leads_to": [],
+      "sandbox_aware": true,
+      "output_contract": "guides/output-contract.md",
+      "enabled_default": true,
+      "codeflow_required": false
+    },
     "build": {
       "name": "build",
       "slash": "rdc:build",
@@ -189,6 +226,98 @@
       "enabled_default": true,
       "codeflow_required": true
     },
+    "convert": {
+      "name": "convert",
+      "slash": "rdc:convert",
+      "category": "tooling",
+      "usage": "rdc:convert <input> [--out <dir>] [--to markdown|word] [--images assets|base64|s3]",
+      "args": {
+        "positional": [
+          {
+            "name": "input",
+            "required": true,
+            "description": "One or more .docx, .pptx, .ppt, or .md files or directories",
+            "accepts": "path"
+          }
+        ],
+        "flags": [
+          {
+            "name": "--out",
+            "type": "path",
+            "default": null,
+            "description": "Output directory for the converted tree."
+          },
+          {
+            "name": "--out-same-dir",
+            "type": "bool",
+            "default": false,
+            "description": "Write .md, .assets, and reports beside each source file."
+          },
+          {
+            "name": "--to",
+            "type": "string",
+            "default": "auto",
+            "description": "Output target: auto | markdown | word."
+          },
+          {
+            "name": "--images",
+            "type": "string",
+            "default": "assets",
+            "description": "Image handling: assets | base64 | s3."
+          },
+          {
+            "name": "--equations",
+            "type": "string",
+            "default": "tex",
+            "description": "OMML equations: tex (KaTeX) | image (debug)."
+          },
+          {
+            "name": "--inline-images",
+            "type": "bool",
+            "default": false,
+            "description": "Emit <name>.inline.md with images as data URIs."
+          },
+          {
+            "name": "--word-template",
+            "type": "path",
+            "default": null,
+            "description": ".docx/.dotx template for Markdown -> Word."
+          },
+          {
+            "name": "--move-sources",
+            "type": "bool",
+            "default": false,
+            "description": "Move processed sources into a sources/ folder."
+          },
+          {
+            "name": "--config",
+            "type": "path",
+            "default": null,
+            "description": "JSON config with conversion/output/S3 defaults."
+          }
+        ]
+      },
+      "requires": [],
+      "produces": [
+        "markdown_artifact",
+        "word_artifact"
+      ],
+      "default_model": "inherit",
+      "triggers": [
+        "convert this docx to markdown",
+        "convert to word",
+        "docx to markdown",
+        "pptx to markdown",
+        "build a markdown corpus",
+        "open the report in regen-mde"
+      ],
+      "follows": [],
+      "leads_to": [],
+      "sandbox_aware": false,
+      "output_contract": null,
+      "enabled_default": true,
+      "codeflow_required": false
+    },
     "deploy": {
       "name": "deploy",
       "slash": "rdc:deploy",

package/package.json

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

package/skills/build/SKILL.md

@@ -194,11 +194,28 @@ Read the task title and description, then:
    ### ⛔ Agent Dispatch Non-Negotiable Defaults
    Every `Agent()` call MUST include these parameters — no exceptions:
    ```
-   model: "sonnet"
+   model: <chosen per the routing table below>
    max_turns: 70
    isolation: "worktree"
    ```
-   Agents run Sonnet 4.6 — capable for implementation work, budget-safe for parallel dispatch. The supervisor session model does NOT cascade to agents; you must set it explicitly.
+
+   **Agent model routing — pick per task, not per wave.** The supervisor session model does NOT cascade to agents; you must set `model` explicitly on every dispatch.
+
+   | Task character | Model | When to pick it |
+   |---|---|---|
+   | Updates, edits, mechanical refactors, small fixes, content tweaks, config patches, doc/copy edits, straightforward API wiring | `claude-sonnet-4-6` | Default for `frontend.md`/`content.md`/`infrastructure.md` work whose checklist is mostly "change X to Y" or "wire up endpoint Z". Budget-safe for parallel dispatch. |
+   | Harder coding tasks — non-trivial algorithm, migration with backfill, schema reshape, multi-file refactor with subtle invariants, performance-sensitive code, anything where correctness is the bar | `claude-opus-4-6` | Default for `backend.md`/`data.md` work and any `frontend.md` task that involves state machines, race conditions, or cross-package contracts. |
+   | Design or innovative thought — new component design, brand/UX work, CS 2.0 paradigm work (HAIL/Quad Pixel/AEMG/Virtue), grammar evolution, architecture-first design, anything where the *shape* of the solution is the deliverable rather than the implementation | `claude-opus-4-8` | Default for `design.md`/`cs2.md` work. Also use for `backend.md`/`data.md` tasks tagged with `architecture` or `design-decision` in work item labels. |
+
+   **How to choose when the task straddles categories:**
+   - If the task's checklist contains the word "design", "decide", "propose", "evaluate alternatives", "novel", or any CS 2.0 primitive → **Opus 4.8**.
+   - If the task touches `packages/cs2*`, `packages/hail`, `packages/quad-pixel`, `packages/virtue-engine`, `packages/aemg`, `packages/planetary-ontology`, or `packages/being-state-processor` → **Opus 4.8** (CS 2.0 paradigm requires innovative thought, not transcription).
+   - If the task is a Supabase migration that drops/renames/reshapes anything, or a refactor across ≥5 files → **Opus 4.6**.
+   - Otherwise → **Sonnet 4.6**.
+
+   **State the choice in the wave plan.** Before dispatching a wave, the supervisor must log one line per agent in the form `[wave-N agent-K] role=<role> task=<id> model=<chosen> reason=<one phrase>`. This keeps routing decisions reviewable in the transcript and lets `rdc:report` summarize the fleet mix.
+
+   **Cost guardrail.** If a single wave would dispatch more than 3 Opus 4.8 agents in parallel, downshift the lowest-priority Opus-4.8 tasks to Opus 4.6 unless their work items are tagged `priority=urgent`. Opus 4.8 fast-mode is cheap individually but still ~5× a Sonnet agent at scale.
    Without `max_turns: 70`, agents hit the default turn cap mid-task and stop.
    `isolation: "worktree"` gives each agent its own git worktree and branch — eliminates push race conditions and index lock contention when multiple agents commit in parallel. The supervisor merges worktree branches after each wave (Step 9).
 
@@ -382,5 +399,5 @@ NEVER run pnpm build or pnpm turbo. Use npx vitest run only.
 - Push after each wave, not just at the end
 - Unattended: NEVER pause — continue automatically
 - Unattended: max 2 retries per task before escalating to advisor
-- Every Agent() dispatch: `model: "sonnet"` + `max_turns: 70` + `isolation: "worktree"` — non-negotiable (Sonnet agents, Opus supervisor). Exception: validator agent in Step 10 omits isolation.
+- Every Agent() dispatch: `model: <routed>` + `max_turns: 70` + `isolation: "worktree"` — non-negotiable. Model is chosen per task per the routing table in Step 7: Sonnet 4.6 for updates/edits, Opus 4.6 for harder coding, Opus 4.8 for design/innovative thought (CS 2.0, brand/UX, architecture). Supervisor logs `model=<chosen> reason=<phrase>` per agent. Exception: validator agent in Step 10 omits isolation; validator model stays `claude-sonnet-4-6` (verification, not generation).
 - Finding an existing file is NOT task completion — verify it satisfies the spec

package/skills/convert/SKILL.md

@@ -0,0 +1,124 @@
+---
+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 (PyPI `build-corpus`, npm `regen-mde`). 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)."
+---
+
+# rdc:convert — Office ↔ Markdown conversion (build-corpus) + regen-mde editor
+
+> **⚠️ 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.
+
+`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
+fetch and run the tool in its own session (this is how claude.ai uses it).
+
+## When to Use
+- Convert `.docx`, `.pptx`, or `.ppt` → Markdown, preserving Word OMML equations
+  (as KaTeX-readable TeX), tables, images, headings, and lists.
+- Convert Markdown → Word (`.docx`), optionally with a `.dotx` template.
+- Build a Markdown corpus from a folder of Office files (one pass, recursive).
+- Inline a Markdown file's images as data URIs, or rehost them to R2/S3.
+- "Open the report / open this doc to edit" → `regen-mde <file>` (Windows GUI only).
+
+## When NOT to Use
+- Rendering a folder/HTML/zip into a print-ready **PDF** brochure → use `rdc:brochure`.
+- Authoring brochure JSX for the Brochurify pipeline → use `lifeai-brochure-author`.
+
+## Obtain & Run (portable — pick whatever the current runtime supports)
+
+The command is always `build-corpus <input> [flags]`. Resolve the binary like this:
+
+1. **Already on PATH?** Use it directly: `build-corpus --help`.
+2. **Python runtime (recommended on Linux/macOS/claude.ai):**
+   - one-off, no install:  `pipx run build-corpus <input> [flags]`
+   - or install:           `pipx install build-corpus`  (PEP 668-safe)
+   - in a disposable sandbox: `python3 -m pip install build-corpus && build-corpus <input> [flags]`
+   - S3/R2 image upload needs the extra: `pip install "build-corpus[s3]"`
+3. **Node runtime:**         `npx -y -p regen-mde build-corpus <input> [flags]`
+4. **Legacy `.ppt` input** additionally needs LibreOffice (`soffice`) on PATH
+   (`sudo apt install libreoffice`). `.docx`/`.pptx` need nothing extra.
+
+claude.ai note: pull from PyPI (`build-corpus`) or npm (`regen-mde`) and run in the
+analysis/session sandbox. No local repo checkout is required.
+
+## 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 (see below). |
+| `--equations` | `tex` \| `image` (default `tex`) | OMML equations → KaTeX TeX, or rendered images (debug only). |
+| `--inline-images` | — | Emit `<name>.inline.md` with local/HTTP 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`.
+Prefer keeping S3 secrets in `--config`, not on the command line.
+
+### Image modes (`--images`)
+- `assets` — copy images into an `.assets` folder and reference them (default).
+- `base64` — embed images directly as Markdown data URIs.
+- `s3` — upload to S3-compatible storage (Cloudflare R2 / AWS S3); needs the S3 flags or `--config`.
+
+### Equation modes (`--equations`)
+- `tex` — convert Word OMML equations to KaTeX-readable TeX (default).
+- `image` — render equations as images (visual debugging only).
+
+## Editor — `regen-mde` (Windows only)
+
+```
+regen-mde <document.md|document.docx> [options]
+```
+Aliases: `mdeditor`, `regen-mdeditor`, `build-corpus-editor`.
+
+| Flag | Effect |
+|------|--------|
+| `--foreground`, `--visible` | Show the editor as an attached foreground process. |
+| `--background` | Launch hidden/offscreen (smoke checks). |
+| `--self-test` | Verify the editor bridge can open the document. |
+| `--document-self-test` | Open, edit, save Markdown, export Word, reconvert. |
+| `--out <dir>` | Output directory for the document self-test. |
+
+The GUI is a .NET 8 + WebView2 app and is **Windows-only by design**. On Linux/macOS
+use the `build-corpus` CLI; there is no Linux editor build.
+
+## 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.docx --images base64                        # embed images inline
+build-corpus input.md --to word --out out                      # markdown → Word
+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
+
+# portable one-offs when build-corpus is not yet installed:
+pipx run build-corpus input.docx --out out
+npx -y -p regen-mde build-corpus input.docx --out out
+```
+
+## Boundaries
+- Does not commit, deploy, or upload outputs (except images when `--images s3` is set).
+- Does not modify source documents unless `--move-sources` is passed.
+- Does not install global dependencies implicitly — fetch via `pipx`/`npx` as shown.
+- The `regen-mde` GUI is Windows-only; do not attempt to launch it on Linux/macOS.
+
+## Reference
+- Package: PyPI `build-corpus`, npm `regen-mde` (version-locked, dual-channel).
+- Source: `github.com/LIFEAI/build-corpus` (`C:/Dev/build-corpus` locally).