@lifeaitools/rdc-skills 0.24.42 → 0.25.0

package/scripts/watch-init.mjs

@@ -1,100 +1,100 @@
-#!/usr/bin/env node
-// watch-init.mjs — initialize a session log + viewer for rdc:watch.
-//
-// Usage:
-//   node scripts/watch-init.mjs [--project-root <path>]
-//
-// Creates:
-//   <projectRoot>/.rdc/session-log/<runId>.log    (with banner line)
-//   <projectRoot>/.rdc/session-log/current.log    (copy of the new log)
-//   <projectRoot>/.rdc/session-log/viewer.html    (copied from plugin assets)
-//
-// Exits 0 on success, 1 on error.
-
-import { mkdirSync, writeFileSync, copyFileSync, existsSync, statSync, readFileSync } from "node:fs";
-import { join, resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { platform } from "node:os";
-
-function parseArgs(argv) {
-  const out = { projectRoot: process.cwd() };
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === "--project-root" && argv[i + 1]) {
-      out.projectRoot = resolve(argv[++i]);
-    }
-  }
-  return out;
-}
-
-function randId(n) {
-  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
-  let s = "";
-  for (let i = 0; i < n; i++) s += chars[Math.floor(Math.random() * chars.length)];
-  return s;
-}
-
-function makeRunId() {
-  const d = new Date();
-  const pad = (x) => String(x).padStart(2, "0");
-  const stamp =
-    d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()) +
-    "-" + pad(d.getHours()) + pad(d.getMinutes()) + pad(d.getSeconds());
-  return stamp + "-" + randId(6);
-}
-
-function openHint(viewerPath) {
-  const p = platform();
-  if (p === "win32") return `start "" "${viewerPath}"`;
-  if (p === "darwin") return `open "${viewerPath}"`;
-  return `xdg-open "${viewerPath}"`;
-}
-
-function main() {
-  const { projectRoot } = parseArgs(process.argv.slice(2));
-  const here = dirname(fileURLToPath(import.meta.url));                    // .../rdc-skills/scripts
-  const pluginRoot = resolve(here, "..");                                   // .../rdc-skills
-  const assetViewer = join(pluginRoot, "assets", "watcher", "viewer.html");
-
-  if (!existsSync(assetViewer)) {
-    console.error(`watch-init: viewer asset missing at ${assetViewer}`);
-    process.exit(1);
-  }
-
-  const logDir = join(projectRoot, ".rdc", "session-log");
-  mkdirSync(logDir, { recursive: true });
-
-  const runId = makeRunId();
-  const logPath = join(logDir, `${runId}.log`);
-  const currentPath = join(logDir, "current.log");
-  const viewerPath = join(logDir, "viewer.html");
-
-  const iso = new Date().toISOString();
-  const banner = `[${iso}] [banner] Session started: ${runId}\n`;
-  writeFileSync(logPath, banner, "utf8");
-  writeFileSync(currentPath, banner, "utf8");
-
-  // Copy viewer.html if missing or stale (source newer than dest).
-  let needsCopy = !existsSync(viewerPath);
-  if (!needsCopy) {
-    try {
-      const srcM = statSync(assetViewer).mtimeMs;
-      const dstM = statSync(viewerPath).mtimeMs;
-      if (srcM > dstM) needsCopy = true;
-    } catch { needsCopy = true; }
-  }
-  if (needsCopy) copyFileSync(assetViewer, viewerPath);
-
-  console.log("run_id:     " + runId);
-  console.log("log_path:   " + logPath);
-  console.log("current:    " + currentPath);
-  console.log("viewer:     " + viewerPath);
-  console.log("open_hint:  " + openHint(viewerPath));
-  process.exit(0);
-}
-
-try {
-  main();
-} catch (err) {
-  console.error("watch-init: " + (err && err.message ? err.message : String(err)));
-  process.exit(1);
-}
+#!/usr/bin/env node
+// watch-init.mjs — initialize a session log + viewer for rdc:watch.
+//
+// Usage:
+//   node scripts/watch-init.mjs [--project-root <path>]
+//
+// Creates:
+//   <projectRoot>/.rdc/session-log/<runId>.log    (with banner line)
+//   <projectRoot>/.rdc/session-log/current.log    (copy of the new log)
+//   <projectRoot>/.rdc/session-log/viewer.html    (copied from plugin assets)
+//
+// Exits 0 on success, 1 on error.
+
+import { mkdirSync, writeFileSync, copyFileSync, existsSync, statSync, readFileSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
+
+function parseArgs(argv) {
+  const out = { projectRoot: process.cwd() };
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--project-root" && argv[i + 1]) {
+      out.projectRoot = resolve(argv[++i]);
+    }
+  }
+  return out;
+}
+
+function randId(n) {
+  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+  let s = "";
+  for (let i = 0; i < n; i++) s += chars[Math.floor(Math.random() * chars.length)];
+  return s;
+}
+
+function makeRunId() {
+  const d = new Date();
+  const pad = (x) => String(x).padStart(2, "0");
+  const stamp =
+    d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()) +
+    "-" + pad(d.getHours()) + pad(d.getMinutes()) + pad(d.getSeconds());
+  return stamp + "-" + randId(6);
+}
+
+function openHint(viewerPath) {
+  const p = platform();
+  if (p === "win32") return `start "" "${viewerPath}"`;
+  if (p === "darwin") return `open "${viewerPath}"`;
+  return `xdg-open "${viewerPath}"`;
+}
+
+function main() {
+  const { projectRoot } = parseArgs(process.argv.slice(2));
+  const here = dirname(fileURLToPath(import.meta.url));                    // .../rdc-skills/scripts
+  const pluginRoot = resolve(here, "..");                                   // .../rdc-skills
+  const assetViewer = join(pluginRoot, "assets", "watcher", "viewer.html");
+
+  if (!existsSync(assetViewer)) {
+    console.error(`watch-init: viewer asset missing at ${assetViewer}`);
+    process.exit(1);
+  }
+
+  const logDir = join(projectRoot, ".rdc", "session-log");
+  mkdirSync(logDir, { recursive: true });
+
+  const runId = makeRunId();
+  const logPath = join(logDir, `${runId}.log`);
+  const currentPath = join(logDir, "current.log");
+  const viewerPath = join(logDir, "viewer.html");
+
+  const iso = new Date().toISOString();
+  const banner = `[${iso}] [banner] Session started: ${runId}\n`;
+  writeFileSync(logPath, banner, "utf8");
+  writeFileSync(currentPath, banner, "utf8");
+
+  // Copy viewer.html if missing or stale (source newer than dest).
+  let needsCopy = !existsSync(viewerPath);
+  if (!needsCopy) {
+    try {
+      const srcM = statSync(assetViewer).mtimeMs;
+      const dstM = statSync(viewerPath).mtimeMs;
+      if (srcM > dstM) needsCopy = true;
+    } catch { needsCopy = true; }
+  }
+  if (needsCopy) copyFileSync(assetViewer, viewerPath);
+
+  console.log("run_id:     " + runId);
+  console.log("log_path:   " + logPath);
+  console.log("current:    " + currentPath);
+  console.log("viewer:     " + viewerPath);
+  console.log("open_hint:  " + openHint(viewerPath));
+  process.exit(0);
+}
+
+try {
+  main();
+} catch (err) {
+  console.error("watch-init: " + (err && err.message ? err.message : String(err)));
+  process.exit(1);
+}

package/skills/brochure/SKILL.md

@@ -1,107 +1,107 @@
----
-name: rdc:brochure
-description: "Usage `rdc:brochure <input> [--out <path>] [--template <name>] [--format Letter|A4]` — Turn a zip, folder, HTML file, URL, or markdown folder into a print-quality PDF brochure via Puppeteer. Auto-detects print-variant HTML, honors @page CSS, falls back to a Studio-token-aware template when no HTML 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.
-
-> **Sandbox contract:** Honors `RDC_TEST=1`. Under the flag the skill renders to a fixture path and skips any post-deploy or upload steps.
-
-# rdc:brochure — Zip / Folder / HTML → PDF Brochure
-
-A focused render pipeline. Two modes:
-
-1. **Render mode** — input already contains print-ready HTML. Skill picks the best HTML file and renders it.
-2. **Compose mode** — input is a folder of assets + markdown/text with no HTML. Skill composes a Studio-token-aware brochure layout, then renders it.
-
-## When to Use
-- A client zip of deliverables that includes a print-first HTML doc (FuturVille ASP, ranch reports, project plans).
-- A `places/<slug>/` or `apps/<app>/` markdown package that needs a PDF artifact.
-- A single URL or HTML file you want as a clean PDF.
-
-## When NOT to Use
-- Production marketing collateral that lives in `apps/*` and ships via Coolify — that goes through `rdc:design` + `rdc:deploy`.
-- Multi-document publication systems — use `rdc:plan` to scaffold first.
-
-## Arguments
-- `rdc:brochure <input>` — path to `.zip`, folder, `.html`, `.md`, or `http(s)://...` URL.
-- `--out <path>` — output PDF path. Default: `<input-basename>.pdf` next to the input (or `./brochure.pdf` for URLs).
-- `--template <name>` — compose-mode template. Default `studio-default`. Templates live in `scaffold/templates/brochure-*.html`. An unknown name errors out and lists the available template(s) — it does not silently fall back.
-- `--format Letter|A4` — page size. Default `Letter`.
-- `--margin <css>` — override margin. Default honors `@page` from source CSS, else `0.6in 0.7in`.
-- `--no-print-emulate` — render with screen media instead of print.
-- `--keep-workdir` — keep the staged working directory for inspection.
-- `--auto-fit` — inject corrective print-fit CSS (oversized images, wide tables, long code, heading orphans, figure splits) and log overflow diagnostics. Use when source HTML overflows page boundaries.
-- `--scale <n>` — PDF scale factor (e.g. `0.92` to tighten). Default `1`.
-
-## Procedure
-
-1. **Resolve input.**
-   - Zip → extract to `tmp/rdc-brochure/<hash>/src`.
-   - Folder → stage in place (read-only).
-   - URL → fetch into a sandbox dir as `index.html` + linked assets via Puppeteer.
-   - `.html` → stage as-is.
-   - `.md` or folder-without-html → compose mode.
-
-2. **Pick HTML in render mode.**
-   - Prefer the largest standalone HTML containing `@page` or `@media print` rules.
-   - Else prefer files matching `*-print.html`, `*-brochure.html`, `print.html`.
-   - Else the largest HTML at root.
-
-3. **Compose mode.**
-   - Read the chosen template (`scaffold/templates/brochure-studio-default.html`).
-   - Inventory the input dir: `*.md`, `*.txt`, images grouped by directory, `cover.*`, `logo.*`.
-   - Render markdown to HTML, inject into template slots: cover, foreword, sections, figures, back-matter.
-   - Use Studio token CSS (Source Serif 4 + Hanken Grotesk, loam/moss/ochre palette) as the default. If a sibling `tokens.css` is present, prefer that.
-
-4. **Render with Puppeteer.**
-   - `headless: 'new'`, `--font-render-hinting=none`.
-   - `waitUntil: 'networkidle0'`, await `document.fonts.ready`, then 1500ms settle.
-   - `emulateMediaType('print')` unless `--no-print-emulate`.
-   - `printBackground: true`, `preferCSSPageSize: true`.
-   - Letter @ `0.6in 0.7in` default margins.
-
-5. **Verify.**
-   - Output exists and `> 50KB`.
-   - PDF metadata: page count > 0.
-   - Log: input, picked HTML or template, page count, file size, output path.
-
-## Output
-
-```
-PDF:    <absolute path>
-Pages:  <n>
-Size:   <human bytes>
-Source: <input> → <chosen html or template>
-```
-
-## Boundaries
-- Does not commit, publish, or upload the resulting PDF. The user moves it.
-- Does not modify the source input.
-- Does not auto-install global dependencies — uses `npx puppeteer` via the skill's own `node_modules` if present, otherwise an on-demand local install under `~/.cache/rdc-brochure/`.
-- Compose-mode templates live in `scaffold/templates/brochure-*.html`. New templates need `rdc:plan` if they cross the architectural-change-approval triggers.
-
-## Implementation
-The executable is `scripts/rdc-brochure.mjs` (in the rdc-skills repo). Invoke directly:
-
-```powershell
-node {RDC_SKILLS_ROOT}/scripts/rdc-brochure.mjs <input> [--out path] [--template name] [--format Letter|A4]
-```
-
-## Examples
-
-```powershell
-# Zip of deliverables with print HTML inside
-rdc:brochure "C:/Users/me/Downloads/FuturVille Deliverables.zip"
-
-# Folder of markdown + images, compose a brochure
-rdc:brochure "places/futurville-vulcan" --template studio-default --out reports/futurville.pdf
-
-# Single HTML to PDF, A4
-rdc:brochure docs/source/some-prototype.html --format A4
-
-# URL
-rdc:brochure https://example.com/spec.html --out spec.pdf
-```
+---
+name: rdc:brochure
+description: "Usage `rdc:brochure <input> [--out <path>] [--template <name>] [--format Letter|A4]` — Turn a zip, folder, HTML file, URL, or markdown folder into a print-quality PDF brochure via Puppeteer. Auto-detects print-variant HTML, honors @page CSS, falls back to a Studio-token-aware template when no HTML 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.
+
+> **Sandbox contract:** Honors `RDC_TEST=1`. Under the flag the skill renders to a fixture path and skips any post-deploy or upload steps.
+
+# rdc:brochure — Zip / Folder / HTML → PDF Brochure
+
+A focused render pipeline. Two modes:
+
+1. **Render mode** — input already contains print-ready HTML. Skill picks the best HTML file and renders it.
+2. **Compose mode** — input is a folder of assets + markdown/text with no HTML. Skill composes a Studio-token-aware brochure layout, then renders it.
+
+## When to Use
+- A client zip of deliverables that includes a print-first HTML doc (FuturVille ASP, ranch reports, project plans).
+- A `places/<slug>/` or `apps/<app>/` markdown package that needs a PDF artifact.
+- A single URL or HTML file you want as a clean PDF.
+
+## When NOT to Use
+- Production marketing collateral that lives in `apps/*` and ships via Coolify — that goes through `rdc:design` + `rdc:deploy`.
+- Multi-document publication systems — use `rdc:plan` to scaffold first.
+
+## Arguments
+- `rdc:brochure <input>` — path to `.zip`, folder, `.html`, `.md`, or `http(s)://...` URL.
+- `--out <path>` — output PDF path. Default: `<input-basename>.pdf` next to the input (or `./brochure.pdf` for URLs).
+- `--template <name>` — compose-mode template. Default `studio-default`. Templates live in `scaffold/templates/brochure-*.html`. An unknown name errors out and lists the available template(s) — it does not silently fall back.
+- `--format Letter|A4` — page size. Default `Letter`.
+- `--margin <css>` — override margin. Default honors `@page` from source CSS, else `0.6in 0.7in`.
+- `--no-print-emulate` — render with screen media instead of print.
+- `--keep-workdir` — keep the staged working directory for inspection.
+- `--auto-fit` — inject corrective print-fit CSS (oversized images, wide tables, long code, heading orphans, figure splits) and log overflow diagnostics. Use when source HTML overflows page boundaries.
+- `--scale <n>` — PDF scale factor (e.g. `0.92` to tighten). Default `1`.
+
+## Procedure
+
+1. **Resolve input.**
+   - Zip → extract to `tmp/rdc-brochure/<hash>/src`.
+   - Folder → stage in place (read-only).
+   - URL → fetch into a sandbox dir as `index.html` + linked assets via Puppeteer.
+   - `.html` → stage as-is.
+   - `.md` or folder-without-html → compose mode.
+
+2. **Pick HTML in render mode.**
+   - Prefer the largest standalone HTML containing `@page` or `@media print` rules.
+   - Else prefer files matching `*-print.html`, `*-brochure.html`, `print.html`.
+   - Else the largest HTML at root.
+
+3. **Compose mode.**
+   - Read the chosen template (`scaffold/templates/brochure-studio-default.html`).
+   - Inventory the input dir: `*.md`, `*.txt`, images grouped by directory, `cover.*`, `logo.*`.
+   - Render markdown to HTML, inject into template slots: cover, foreword, sections, figures, back-matter.
+   - Use Studio token CSS (Source Serif 4 + Hanken Grotesk, loam/moss/ochre palette) as the default. If a sibling `tokens.css` is present, prefer that.
+
+4. **Render with Puppeteer.**
+   - `headless: 'new'`, `--font-render-hinting=none`.
+   - `waitUntil: 'networkidle0'`, await `document.fonts.ready`, then 1500ms settle.
+   - `emulateMediaType('print')` unless `--no-print-emulate`.
+   - `printBackground: true`, `preferCSSPageSize: true`.
+   - Letter @ `0.6in 0.7in` default margins.
+
+5. **Verify.**
+   - Output exists and `> 50KB`.
+   - PDF metadata: page count > 0.
+   - Log: input, picked HTML or template, page count, file size, output path.
+
+## Output
+
+```
+PDF:    <absolute path>
+Pages:  <n>
+Size:   <human bytes>
+Source: <input> → <chosen html or template>
+```
+
+## Boundaries
+- Does not commit, publish, or upload the resulting PDF. The user moves it.
+- Does not modify the source input.
+- Does not auto-install global dependencies — uses `npx puppeteer` via the skill's own `node_modules` if present, otherwise an on-demand local install under `~/.cache/rdc-brochure/`.
+- Compose-mode templates live in `scaffold/templates/brochure-*.html`. New templates need `rdc:plan` if they cross the architectural-change-approval triggers.
+
+## Implementation
+The executable is `scripts/rdc-brochure.mjs` (in the rdc-skills repo). Invoke directly:
+
+```powershell
+node {RDC_SKILLS_ROOT}/scripts/rdc-brochure.mjs <input> [--out path] [--template name] [--format Letter|A4]
+```
+
+## Examples
+
+```powershell
+# Zip of deliverables with print HTML inside
+rdc:brochure "C:/Users/me/Downloads/FuturVille Deliverables.zip"
+
+# Folder of markdown + images, compose a brochure
+rdc:brochure "places/futurville-vulcan" --template studio-default --out reports/futurville.pdf
+
+# Single HTML to PDF, A4
+rdc:brochure docs/source/some-prototype.html --format A4
+
+# URL
+rdc:brochure https://example.com/spec.html --out spec.pdf
+```