@drunkcoding/agents-and-skills 0.0.45 → 0.0.46

package/plugins/html-effectiveness/README.md

@@ -1,28 +0,0 @@
-# html-effectiveness
-
-Generate self-contained interactive HTML reports (status, incident, PR writeup, decision matrix, slide deck, code review, research explainer, etc.) from 20 upstream templates.
-
-## Usage
-
-Invoke the `report-builder` agent. It will pick a template, gather slot data conversationally, and render to `docs/reports/YYYY-MM-DD-<slug>.html`.
-
-Override output dir in repo `CLAUDE.md`:
-
-```
-html-effectiveness.reportDir: my/custom/reports
-```
-
-## Vendored templates
-
-Templates are vendored from `ThariqS/html-effectiveness`. The pinned SHA lives in `templates/manifest.json` (`_meta.upstream_sha`). Re-fetch is **manual** — only run when you want to refresh the snapshot:
-
-```bash
-node plugins/html-effectiveness/scripts/extract.js fetch <id>.html
-node plugins/html-effectiveness/scripts/extract.js split <id>.html
-```
-
-Files land under `.tmp/html-effectiveness/extract/` and are cleaned up automatically. Hand-merge any changes back into `templates/<id>.html.tmpl`.
-
-## Scratch convention
-
-All plugin scratch lives under `.tmp/html-effectiveness/<purpose>/` (gitignored). Helper API: `scripts/_tmp.js` exports `getTmpDir`, `cleanup`, and `withTmp` for try/finally + signal-handler cleanup.

package/plugins/html-effectiveness/agents/report-builder.md

@@ -1,66 +0,0 @@
----
-name: report-builder
-description: Conversational wizard that helps the user generate an HTML report from one of 20 templates (status, incident, PR writeup, decision matrix, slide deck, code review, research explainer, ...). Use when the user wants a polished interactive HTML output instead of markdown. Reads templates/manifest.json and CLAUDE.md html-effectiveness.reportDir for output path.
-tools: Read, Write, Bash, Glob, Grep
----
-
-You are `report-builder`, a conversational wizard that turns the user's intent into a polished, self-contained interactive HTML report.
-
-## Role
-
-Guide the user from intent → rendered HTML in a single file. Speak briefly. Ask one question at a time. Match the user's caveman setting if active.
-
-## Startup
-
-On every run:
-
-1. Read `CLAUDE.md` from the repo root. Extract `html-effectiveness.reportDir` if present; fallback `docs/reports/`.
-2. Read `plugins/html-effectiveness/templates/manifest.json` (catalog + slot schemas).
-3. Greet briefly; confirm the user's intent.
-
-## Conversation loop
-
-1. **Classify** — infer the top 2-3 templates from the user's stated need by matching `use_cases` and `pattern` fields in the manifest.
-2. **Confirm** — present the top picks with one-line summaries; let the user pick or override.
-3. **Slot fill** — walk the required slots from `manifest[id].slots` in order. Batch obvious slots and infer from prior context to minimize questions. Cap at 6 user-facing questions; force render with best-guess defaults beyond that, with a one-line note of what was assumed.
-4. **Preview data** — show a JSON summary of slot values; ask "looks right?" before rendering.
-
-## Render
-
-1. Compute slug from title (kebab-case, ASCII-only, max 60 chars).
-2. Build path `<reportDir>/YYYY-MM-DD-<slug>.html`.
-3. Write `<path>.data.json` first (so the user can re-render later).
-4. Invoke render script via Bash:
-
-   ```bash
-   node plugins/html-effectiveness/scripts/render.js \
-     --template=<id> \
-     --data=<path>.data.json \
-     --out=<path>
-   ```
-
-5. On success: print the absolute path; offer `snip render --format html < <path>` to preview in the browser.
-6. On render error: surface stderr; locate the offending slot from the `template:slot` prefix; ask the user to fix; retry.
-
-## Output
-
-A self-contained interactive HTML report at `<reportDir>/YYYY-MM-DD-<slug>.html` plus a `<slug>.html.data.json` sidecar for later re-rendering. The absolute path is printed to the user on success, with an offer to preview via `snip render --format html`.
-
-## Regen path
-
-If the user invokes the agent on an existing `<name>.data.json`:
-
-- Skip slot fill.
-- Edit only the slots the user wants changed.
-- Re-render to the same path (or new path if requested).
-
-## Guardrails
-
-- Never write to paths outside the repo root.
-- Create `reportDir` if missing.
-- If the output file already exists, ask the user before overwriting; suggest `-2`, `-3`, ... suffix.
-- Refuse to render if the manifest is missing or the requested template id doesn't exist; surface the valid id list.
-
-## Tone
-
-Terse, expert, no fluff. Caveman-mode-aware. Code blocks unchanged.

package/plugins/html-effectiveness/assets/base.css

@@ -1,51 +0,0 @@
-/* Shared design tokens + page baseline. Vendored from ThariqS/html-effectiveness. */
-:root {
-  --ivory: #FAF9F5;
-  --slate: #141413;
-  --clay: #D97757;
-  --oat: #E3DACC;
-  --olive: #788C5D;
-  --rust: #B04A3F;
-  --gray-100: #F0EEE6;
-  --gray-300: #D1CFC5;
-  --gray-500: #87867F;
-  --gray-700: #3D3D3A;
-  --white: #FFFFFF;
-
-  --serif: ui-serif, Georgia, serif;
-  --sans: system-ui, -apple-system, sans-serif;
-  --mono: ui-monospace, "SF Mono", Menlo, monospace;
-
-  --radius-panel: 12px;
-  --radius-row: 8px;
-  --border-thick: 1.5px solid var(--gray-300);
-
-  /* legacy aliases for components.css stubs */
-  --bg: var(--ivory);
-  --fg: var(--slate);
-  --muted: var(--gray-500);
-  --accent: var(--clay);
-  --border: 1px solid var(--gray-300);
-  --radius: var(--radius-panel);
-  --font: var(--sans);
-  --transition: 150ms ease;
-}
-* { box-sizing: border-box; }
-html, body {
-  margin: 0;
-  padding: 0;
-  background: var(--ivory);
-  color: var(--slate);
-  font-family: var(--sans);
-  font-size: 15px;
-  line-height: 1.6;
-  -webkit-font-smoothing: antialiased;
-}
-a { color: var(--clay); text-decoration: none; }
-a:hover { text-decoration: underline; }
-@media print {
-  details { display: block; }
-  details > summary { display: none; }
-  [hidden] { display: revert !important; }
-  body { background: white; color: black; }
-}

package/plugins/html-effectiveness/assets/base.js

@@ -1,11 +0,0 @@
-// Shared interactions: theme toggle, search, nav, copy-on-click. Populated from upstream during Task 7.
-(function () {
-  document.addEventListener('click', (e) => {
-    const t = e.target.closest('[data-copy]');
-    if (!t) return;
-    const text = t.getAttribute('data-copy');
-    navigator.clipboard?.writeText(text);
-    t.setAttribute('data-copied', '1');
-    setTimeout(() => t.removeAttribute('data-copied'), 1000);
-  });
-})();

package/plugins/html-effectiveness/assets/charts.js

@@ -1 +0,0 @@
-// Inline SVG chart helpers. Opt-in via manifest.extra_js. Populated from upstream during Task 7.

package/plugins/html-effectiveness/assets/components.css

@@ -1,10 +0,0 @@
-/* Shared components: cards, timeline, kanban, matrix, swatches, slides. Populated from upstream during Task 7. */
-.report { max-width: 1200px; margin: 0 auto; padding: 2rem 1rem; }
-.report header h1 { font-size: 1.75rem; margin: 0 0 .25rem; }
-.report header .subtitle { color: var(--muted); margin: 0 0 1.5rem; }
-.card { border: 1px solid var(--border); border-radius: var(--radius); padding: 1rem; transition: border-color var(--transition); }
-.stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 1rem; margin: 0 0 2rem; }
-.stat { display: flex; flex-direction: column; gap: .25rem; }
-.stat .value { font-size: 1.5rem; font-weight: 600; }
-.stat .label { color: var(--muted); font-size: .875rem; }
-.stat .delta { font-size: .75rem; }

package/plugins/html-effectiveness/commands/html-report.md

@@ -1,13 +0,0 @@
----
-description: Conversational wizard that renders dense info as a self-contained interactive HTML report (status, incident, PR writeup, slide deck, decision matrix, ...).
-argument-hint: [optional one-line intent or path to existing .data.json]
----
-
-Dispatch the `report-builder` subagent using the Agent tool. Pass `$ARGUMENTS` (which may be empty) as the initial intent seed in the subagent prompt.
-
-Subagent dispatch prompt template:
-
-> Run the html-effectiveness report wizard. Initial intent seed: `$ARGUMENTS`.
-> If the seed looks like a path to an existing `*.data.json` sidecar, enter the regen flow: load it, ask which slots to change, re-render. Otherwise classify the intent against `plugins/html-effectiveness/templates/manifest.json`, confirm the template pick with the user, fill slots (cap 6 questions), preview the data JSON, then render via `plugins/html-effectiveness/scripts/render.js`. Respect `html-effectiveness.reportDir` from repo `CLAUDE.md` (fallback `docs/reports/`).
-
-Do not render or write files in the main thread — the subagent owns the full wizard and the render call.

package/plugins/html-effectiveness/docs/template-gallery.md

@@ -1,28 +0,0 @@
-# Template Gallery
-
-Generated from `templates/manifest.json`. Upstream: `ThariqS/html-effectiveness@a1fb5673c26f87be9b833e1876cf4fd0f30f5f2d` (fetched 2026-05-13).
-
-| ID | Title | Pattern | Use cases | Required slots |
-|----|-------|---------|-----------|----------------|
-| `01-exploration-code-approaches` | Code-Approaches Exploration | `comparison_board` | "compare implementations", "approach trade-offs", "design alternatives" | `title` |
-| `02-exploration-visual-designs` | Visual Design Exploration | `comparison_board` | "compare designs", "UI alternatives", "visual options" | `title` |
-| `03-code-review-pr` | PR Code Review Board | `code_review_board` | "PR review", "code review", "diff review" | `title` |
-| `04-code-understanding` | Code Walkthrough | `knowledge_explorer` | "explain code", "walk through architecture", "trace logic" | `title` |
-| `05-design-system` | Design System Sheet | `design_system_sheet` | "design tokens", "color palette", "typography" | `title` |
-| `06-component-variants` | Component Variant Matrix | `design_system_sheet` | "component variants", "states gallery" | `title` |
-| `07-prototype-animation` | Animation Prototype | `interactive_report` | "animation prototype", "motion preview" | `title` |
-| `08-prototype-interaction` | Interaction Prototype | `interactive_report` | "interaction prototype", "ux flow" | `title` |
-| `09-slide-deck` | Slide Deck | `slide_deck` | "slide deck", "presentation", "pitch" | `title` |
-| `10-svg-illustrations` | SVG Illustration Gallery | `knowledge_explorer` | "illustrate concept", "svg gallery" | `title` |
-| `11-status-report` | Status Report | `interactive_report` | "weekly status", "project update", "team digest", "monthly recap", "engineering status" | `title`, `date_range` |
-| `12-incident-report` | Incident Report | `interactive_report` | "incident report", "post-mortem", "outage writeup" | `title` |
-| `13-flowchart-diagram` | Flowchart Diagram | `knowledge_explorer` | "flowchart", "process diagram", "decision tree" | `title` |
-| `14-research-feature-explainer` | Feature Explainer | `knowledge_explorer` | "explain feature", "feature deep-dive" | `title` |
-| `15-research-concept-explainer` | Concept Explainer | `knowledge_explorer` | "explain concept", "tutorial", "primer" | `title` |
-| `16-implementation-plan` | Implementation Plan | `annotated_timeline` | "implementation plan", "phased rollout", "roadmap" | `title` |
-| `17-pr-writeup` | PR Writeup | `interactive_report` | "PR description", "release notes", "change writeup" | `title` |
-| `18-editor-triage-board` | Triage Board | `kanban_board` | "bug triage", "issue board", "kanban" | `title` |
-| `19-editor-feature-flags` | Feature Flags Matrix | `decision_matrix` | "feature flags", "rollout matrix" | `title` |
-| `20-editor-prompt-tuner` | Prompt Tuner | `interactive_report` | "prompt tuning", "LLM config" | `title` |
-
-_20 templates._

package/plugins/html-effectiveness/package.json

@@ -1,6 +0,0 @@
-{
-  "name": "@local/html-effectiveness",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module"
-}

package/plugins/html-effectiveness/scripts/_tmp.js

@@ -1,37 +0,0 @@
-import { mkdirSync, rmSync } from 'node:fs';
-import { dirname, resolve, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const HERE = dirname(fileURLToPath(import.meta.url));
-const REPO_ROOT = resolve(HERE, '..', '..', '..');
-export const ROOT = join(REPO_ROOT, '.tmp', 'html-effectiveness');
-
-export function getTmpDir(purpose) {
-  if (!purpose || /[\\/]/.test(purpose)) {
-    throw new Error(`purpose must be a single path segment, got: ${purpose}`);
-  }
-  const dir = join(ROOT, purpose);
-  rmSync(dir, { recursive: true, force: true });
-  mkdirSync(dir, { recursive: true });
-  return dir;
-}
-
-export function cleanup(purpose) {
-  rmSync(join(ROOT, purpose), { recursive: true, force: true });
-}
-
-export function withTmp(purpose, fn) {
-  const dir = getTmpDir(purpose);
-  const onSig = () => {
-    try { cleanup(purpose); } finally { process.exit(130); }
-  };
-  process.once('SIGINT', onSig);
-  process.once('SIGTERM', onSig);
-  try {
-    return fn(dir);
-  } finally {
-    cleanup(purpose);
-    process.off('SIGINT', onSig);
-    process.off('SIGTERM', onSig);
-  }
-}

package/plugins/html-effectiveness/scripts/catalog.js

@@ -1,47 +0,0 @@
-#!/usr/bin/env node
-// Generate docs/template-gallery.md from templates/manifest.json.
-// Idempotent. Run after editing manifest.
-
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-const HERE = dirname(fileURLToPath(import.meta.url));
-const PLUGIN_ROOT = dirname(HERE);
-
-function build() {
-  const manifest = JSON.parse(readFileSync(join(PLUGIN_ROOT, 'templates/manifest.json'), 'utf8'));
-  const meta = manifest._meta || {};
-  const rows = Object.entries(manifest)
-    .filter(([k]) => k !== '_meta')
-    .sort(([a], [b]) => a.localeCompare(b));
-
-  const lines = [];
-  lines.push('# Template Gallery');
-  lines.push('');
-  lines.push(`Generated from \`templates/manifest.json\`. Upstream: \`${meta.upstream_repo}@${meta.upstream_sha}\` (fetched ${meta.fetched_at}).`);
-  lines.push('');
-  lines.push('| ID | Title | Pattern | Use cases | Required slots |');
-  lines.push('|----|-------|---------|-----------|----------------|');
-  for (const [id, e] of rows) {
-    const reqSlots = Object.entries(e.slots || {})
-      .filter(([, s]) => (typeof s === 'object' ? s.required : false))
-      .map(([n]) => `\`${n}\``)
-      .join(', ') || '—';
-    const use = (e.use_cases || []).map((u) => `"${u}"`).join(', ');
-    lines.push(`| \`${id}\` | ${e.title} | \`${e.pattern}\` | ${use} | ${reqSlots} |`);
-  }
-  lines.push('');
-  lines.push(`_${rows.length} templates._`);
-  lines.push('');
-  return lines.join('\n');
-}
-
-function main() {
-  const out = join(PLUGIN_ROOT, 'docs/template-gallery.md');
-  mkdirSync(dirname(out), { recursive: true });
-  writeFileSync(out, build(), 'utf8');
-  process.stdout.write(out + '\n');
-}
-
-if (import.meta.url === pathToFileURL(process.argv[1]).href) main();

package/plugins/html-effectiveness/scripts/extract.js

@@ -1,104 +0,0 @@
-#!/usr/bin/env node
-import { writeFileSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { getTmpDir, ROOT } from './_tmp.js';
-
-const UPSTREAM_REPO = 'ThariqS/html-effectiveness';
-const API_BASE = 'https://api.github.com';
-const RAW_BASE = 'https://raw.githubusercontent.com';
-
-async function ghFetch(url, accept = 'application/vnd.github+json') {
-  const headers = { 'Accept': accept, 'User-Agent': 'html-effectiveness-vendor' };
-  if (process.env.GITHUB_TOKEN) headers['Authorization'] = `Bearer ${process.env.GITHUB_TOKEN}`;
-  const res = await fetch(url, { headers });
-  if (!res.ok) {
-    throw new Error(`HTTP ${res.status} ${res.statusText} for ${url}`);
-  }
-  return res;
-}
-
-export async function fetchUpstreamFile(filename, ref = 'main') {
-  const url = `${RAW_BASE}/${UPSTREAM_REPO}/${ref}/${filename}`;
-  const res = await ghFetch(url, 'text/plain');
-  return await res.text();
-}
-
-export async function fetchUpstreamSha(ref = 'main') {
-  const url = `${API_BASE}/repos/${UPSTREAM_REPO}/commits/${ref}`;
-  const res = await ghFetch(url);
-  const json = await res.json();
-  return json.sha;
-}
-
-export async function listUpstreamFiles(ref = 'main') {
-  const url = `${API_BASE}/repos/${UPSTREAM_REPO}/contents?ref=${ref}`;
-  const res = await ghFetch(url);
-  const json = await res.json();
-  return json.filter((e) => e.type === 'file').map((e) => e.name);
-}
-
-export function extractParts(html) {
-  const styles = [];
-  const scripts = [];
-  let body = html;
-  body = body.replace(/<style[^>]*>([\s\S]*?)<\/style>/g, (_, css) => {
-    styles.push(css.trim());
-    return '';
-  });
-  body = body.replace(/<script[^>]*>([\s\S]*?)<\/script>/g, (_, js) => {
-    if (js.trim()) scripts.push(js.trim());
-    return '';
-  });
-  body = body
-    .replace(/<!doctype[^>]*>/i, '')
-    .replace(/<\/?html[^>]*>/gi, '')
-    .replace(/<head[\s\S]*?<\/head>/gi, '')
-    .replace(/<\/?body[^>]*>/gi, '');
-  return { styles, scripts, body: body.trim() };
-}
-
-function ensureWorkdir() {
-  return getTmpDir('extract');
-}
-
-function readFromWorkdir(name) {
-  return readFileSync(join(ROOT, 'extract', name), 'utf8');
-}
-
-function writeToWorkdir(dir, name, content) {
-  writeFileSync(join(dir, name), content);
-}
-
-async function cli() {
-  const [, , cmd, arg] = process.argv;
-  if (cmd === 'fetch') {
-    if (!arg) { process.stderr.write('usage: extract.js fetch <file>\n'); process.exit(1); }
-    const dir = ensureWorkdir();
-    const html = await fetchUpstreamFile(arg);
-    writeToWorkdir(dir, arg, html);
-    process.stdout.write(`${join(dir, arg)}\n`);
-  } else if (cmd === 'sha') {
-    process.stdout.write(await fetchUpstreamSha() + '\n');
-  } else if (cmd === 'list') {
-    const files = await listUpstreamFiles();
-    process.stdout.write(files.join('\n') + '\n');
-  } else if (cmd === 'split') {
-    if (!arg) { process.stderr.write('usage: extract.js split <file>\n'); process.exit(1); }
-    const html = readFromWorkdir(arg);
-    const { styles, scripts, body } = extractParts(html);
-    const base = arg.replace(/\.html$/, '');
-    const dir = join(ROOT, 'extract');
-    writeToWorkdir(dir, `${base}.body.html`, body + '\n');
-    writeToWorkdir(dir, `${base}.styles.css`, styles.join('\n\n/* --- */\n\n') + '\n');
-    writeToWorkdir(dir, `${base}.scripts.js`, scripts.join('\n\n/* --- */\n\n') + '\n');
-    process.stdout.write(`${dir}/${base}.{body.html,styles.css,scripts.js}\n`);
-  } else {
-    process.stderr.write('usage: extract.js {fetch <file>|sha|list|split <file>}\n');
-    process.exit(1);
-  }
-}
-
-if (import.meta.url === pathToFileURL(process.argv[1]).href) {
-  cli().catch((e) => { process.stderr.write(e.stack + '\n'); process.exit(1); });
-}

package/plugins/html-effectiveness/scripts/mustache.js

@@ -1,90 +0,0 @@
-// Hand-rolled mustache subset: {{var}}, {{{raw}}}, {{#section}}…{{/section}}, {{^inverted}}…{{/inverted}}
-// Zero runtime dependencies.
-
-const ESCAPE_MAP = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' };
-const escapeHtml = (s) => String(s).replace(/[&<>"']/g, (c) => ESCAPE_MAP[c]);
-
-function tokenize(template) {
-  const tokens = [];
-  const re = /\{\{(\{?)([\^#\/]?)\s*([\w.-]+)\s*\}?\}\}/g;
-  let lastIndex = 0;
-  let m;
-  while ((m = re.exec(template)) !== null) {
-    if (m.index > lastIndex) tokens.push({ type: 'text', value: template.slice(lastIndex, m.index) });
-    const [, triple, sigil, name] = m;
-    if (sigil === '#') tokens.push({ type: 'section', name });
-    else if (sigil === '^') tokens.push({ type: 'inverted', name });
-    else if (sigil === '/') tokens.push({ type: 'close', name });
-    else if (triple === '{') tokens.push({ type: 'raw', name });
-    else tokens.push({ type: 'var', name });
-    lastIndex = re.lastIndex;
-  }
-  if (lastIndex < template.length) tokens.push({ type: 'text', value: template.slice(lastIndex) });
-  return tokens;
-}
-
-function parse(tokens, end = null) {
-  const nodes = [];
-  while (tokens.length) {
-    const t = tokens.shift();
-    if (t.type === 'close') {
-      if (t.name !== end) throw new Error(`Mismatched close tag: expected ${end}, got ${t.name}`);
-      return nodes;
-    }
-    if (t.type === 'section' || t.type === 'inverted') {
-      const children = parse(tokens, t.name);
-      nodes.push({ ...t, children });
-    } else {
-      nodes.push(t);
-    }
-  }
-  if (end !== null) throw new Error(`Unclosed section: ${end}`);
-  return nodes;
-}
-
-function lookup(ctxStack, name) {
-  if (name === '.') return ctxStack[ctxStack.length - 1];
-  const parts = name.split('.');
-  for (let i = ctxStack.length - 1; i >= 0; i--) {
-    let cur = ctxStack[i];
-    let ok = true;
-    for (const p of parts) {
-      if (cur == null || typeof cur !== 'object' || !Object.prototype.hasOwnProperty.call(cur, p)) { ok = false; break; }
-      cur = cur[p];
-    }
-    if (ok) return cur;
-  }
-  return undefined;
-}
-
-function emit(nodes, ctxStack) {
-  let out = '';
-  for (const n of nodes) {
-    if (n.type === 'text') out += n.value;
-    else if (n.type === 'var') {
-      const v = lookup(ctxStack, n.name);
-      out += v == null ? '' : escapeHtml(v);
-    } else if (n.type === 'raw') {
-      const v = lookup(ctxStack, n.name);
-      out += v == null ? '' : String(v);
-    } else if (n.type === 'section') {
-      const v = lookup(ctxStack, n.name);
-      if (Array.isArray(v)) {
-        for (const item of v) out += emit(n.children, [...ctxStack, item]);
-      } else if (v && (typeof v !== 'object' || Object.keys(v).length > 0)) {
-        out += emit(n.children, [...ctxStack, v]);
-      }
-    } else if (n.type === 'inverted') {
-      const v = lookup(ctxStack, n.name);
-      const empty = v == null || v === false || (Array.isArray(v) && v.length === 0);
-      if (empty) out += emit(n.children, ctxStack);
-    }
-  }
-  return out;
-}
-
-export function render(template, data) {
-  const tokens = tokenize(template);
-  const tree = parse(tokens);
-  return emit(tree, [data]);
-}