@drunkcoding/agents-and-skills 0.0.44 → 0.0.46

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]);
-}

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

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-// CLI + library: render a template + data into a self-contained HTML file.
-// Exit codes: 0 ok, 1 generic, 2 template-not-found, 3 slot schema mismatch, 4 fs write error.
-
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, resolve, join } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { parseArgs } from 'node:util';
-import { render as mustache } from './mustache.js';
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const PLUGIN_ROOT = dirname(SCRIPT_DIR);
-
-const ASSET_BUNDLES = {
-  base: { css: 'assets/base.css', js: 'assets/base.js' },
-  components: { css: 'assets/components.css' },
-  charts: { js: 'assets/charts.js' },
-};
-
-function validateSlot(templateId, slotPath, schema, value) {
-  if (schema.required && (value === undefined || value === null)) {
-    const err = new Error(`${templateId}:${slotPath} required but missing`);
-    err.code = 3;
-    throw err;
-  }
-  if (value === undefined || value === null) return;
-  const type = schema.type;
-  if (type === 'string' || type === 'html') {
-    if (typeof value !== 'string') {
-      const err = new Error(`${templateId}:${slotPath} expected string got ${typeof value}`);
-      err.code = 3;
-      throw err;
-    }
-  } else if (type === 'number') {
-    if (typeof value !== 'number') {
-      const err = new Error(`${templateId}:${slotPath} expected number got ${typeof value}`);
-      err.code = 3;
-      throw err;
-    }
-  } else if (type === 'boolean') {
-    if (typeof value !== 'boolean') {
-      const err = new Error(`${templateId}:${slotPath} expected boolean got ${typeof value}`);
-      err.code = 3;
-      throw err;
-    }
-  } else if (type === 'array') {
-    if (!Array.isArray(value)) {
-      const err = new Error(`${templateId}:${slotPath} expected array got ${typeof value}`);
-      err.code = 3;
-      throw err;
-    }
-    if (schema.of) {
-      value.forEach((item, i) => {
-        for (const [k, subType] of Object.entries(schema.of)) {
-          const subSchema = typeof subType === 'string' ? { type: subType } : subType;
-          validateSlot(templateId, `${slotPath}[${i}].${k}`, subSchema, item?.[k]);
-        }
-      });
-    }
-  } else if (type === 'object') {
-    if (typeof value !== 'object' || Array.isArray(value)) {
-      const err = new Error(`${templateId}:${slotPath} expected object got ${typeof value}`);
-      err.code = 3;
-      throw err;
-    }
-  }
-}
-
-function validate(templateId, slots, data) {
-  for (const [name, schemaRaw] of Object.entries(slots)) {
-    const schema = typeof schemaRaw === 'string' ? { type: schemaRaw } : schemaRaw;
-    validateSlot(templateId, name, schema, data[name]);
-  }
-}
-
-function loadAssets(pluginRoot, bundles, extraJs) {
-  const css = [];
-  const js = [];
-  for (const name of bundles || []) {
-    const b = ASSET_BUNDLES[name];
-    if (!b) continue;
-    if (b.css) css.push(readFileSync(join(pluginRoot, b.css), 'utf8'));
-    if (b.js) js.push(readFileSync(join(pluginRoot, b.js), 'utf8'));
-  }
-  if (extraJs) js.push(readFileSync(join(pluginRoot, extraJs), 'utf8'));
-  return { css: css.join('\n'), js: js.join('\n') };
-}
-
-function escapeForTitle(s) {
-  return String(s).replace(/[&<>"']/g, (c) => ({
-    '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
-  }[c]));
-}
-
-export function renderReport({ templateId, data, outPath, manifestPath, pluginRoot }) {
-  const root = pluginRoot || PLUGIN_ROOT;
-  const mPath = manifestPath || join(root, 'templates/manifest.json');
-  const manifest = JSON.parse(readFileSync(mPath, 'utf8'));
-  const entry = manifest[templateId];
-  if (!entry) {
-    const ids = Object.keys(manifest).filter((k) => k !== '_meta');
-    const err = new Error(`template not found: ${templateId}. valid: ${ids.join(', ')}`);
-    err.code = 2;
-    throw err;
-  }
-
-  validate(templateId, entry.slots, data);
-
-  const tmplRelPath = entry.tmpl || `templates/${templateId}.html.tmpl`;
-  const tmpl = readFileSync(join(root, tmplRelPath), 'utf8');
-  const body = mustache(tmpl, data);
-
-  const { css, js } = loadAssets(root, entry.asset_bundles, entry.extra_js);
-  const title = escapeForTitle(data.title || entry.title || 'Report');
-
-  const html = `<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>${title}</title>
-<style>${css}</style>
-</head>
-<body>
-${body}
-<script>${js}</script>
-</body>
-</html>
-`;
-
-  try {
-    mkdirSync(dirname(outPath), { recursive: true });
-    writeFileSync(outPath, html, 'utf8');
-    const sidecar = {
-      template: templateId,
-      rendered_at: new Date().toISOString(),
-      render_version: '0.1.0',
-      data,
-    };
-    writeFileSync(outPath + '.data.json', JSON.stringify(sidecar, null, 2), 'utf8');
-  } catch (e) {
-    const err = new Error(`failed to write ${outPath}: ${e.message}`);
-    err.code = 4;
-    throw err;
-  }
-
-  return outPath;
-}
-
-function cli() {
-  const { values } = parseArgs({
-    options: {
-      template: { type: 'string' },
-      data: { type: 'string' },
-      out: { type: 'string' },
-    },
-  });
-  if (!values.template || !values.data || !values.out) {
-    process.stderr.write('usage: render.js --template=<id> --data=<json-path> --out=<html-path>\n');
-    process.exit(1);
-  }
-  try {
-    const data = JSON.parse(readFileSync(resolve(values.data), 'utf8'));
-    const finalPath = renderReport({
-      templateId: values.template,
-      data,
-      outPath: resolve(values.out),
-    });
-    process.stdout.write(finalPath + '\n');
-  } catch (e) {
-    process.stderr.write((e.stack || e.message) + '\n');
-    process.exit(e.code ?? 1);
-  }
-}
-
-if (import.meta.url === pathToFileURL(process.argv[1]).href) cli();

package/plugins/html-effectiveness/skills/html-effectiveness/SKILL.md

@@ -1,94 +0,0 @@
----
-name: html-effectiveness
-description: Use when the user wants dense information, status, comparison, plan, code review, or research output rendered as a self-contained interactive HTML report instead of plain markdown. Renders via plugin templates and scripts/render.js into a single HTML file under docs/reports/ (overridable via CLAUDE.md).
----
-
-# HTML Effectiveness — Interactive Output
-
-Turn dense information into a self-contained, browser-based HTML document the user can explore interactively. Markdown is a wall of text; HTML is a spatial, interactive document. Zero dependencies, single file, opens anywhere.
-
-## When to invoke
-
-Invoke this skill when the user asks for any of:
-
-- "Make a report", "render as HTML", "interactive view"
-- Status updates: weekly status, monthly recap, project digest
-- Incident: post-mortem, outage writeup
-- Code: PR review, code understanding, exploration of implementation approaches
-- Design: design system, component variants, prototypes
-- Research: feature explainer, concept explainer, tutorial
-- Planning: implementation plan, rollout, roadmap
-- Decisions: comparison board, decision matrix
-- Visual: slide deck, flowchart, SVG illustration
-- Editor tooling: triage board, feature flags, prompt tuner
-
-If the request fits a report-style output and rendering as HTML would be clearer than markdown, invoke the skill and delegate to the `report-builder` agent.
-
-## Template catalog
-
-20 templates ship with this plugin. Full table in `plugins/html-effectiveness/docs/template-gallery.md` (regen via `node plugins/html-effectiveness/scripts/catalog.js`). Highlights:
-
-- `01` / `02` — exploration comparisons (code approaches, visual designs)
-- `03` — code review board
-- `04` — code understanding / architecture walk-through
-- `05` / `06` — design system, component variants
-- `07` / `08` — prototype animation, prototype interaction
-- `09` — slide deck (arrow-key nav)
-- `10` — SVG illustrations
-- `11` — status report
-- `12` — incident report
-- `13` — flowchart diagram
-- `14` / `15` — research explainers (feature, concept)
-- `16` — implementation plan (annotated timeline)
-- `17` — PR writeup
-- `18` / `19` / `20` — editor tools (triage board, feature flags, prompt tuner)
-
-## Render contract
-
-Always uphold these invariants:
-
-1. **Inline-bundle** — the final HTML is single-file, self-contained. No `<link>` or `<script src>` references. The render script inlines `base.css`, `components.css`, `base.js`, plus any per-template extras.
-2. **Escape strings** — string slots are HTML-escaped. Raw-HTML slots are only allowed when the manifest flags the slot as `"html"`.
-3. **Output path** — read repo `CLAUDE.md` for `html-effectiveness.reportDir`; fallback to `docs/reports/`. Filename: `YYYY-MM-DD-<slug>.html`; slug derived from title (kebab-case, ASCII-only, max 60 chars).
-4. **Sidecar** — `<report>.html.data.json` is always written alongside the HTML so the report can be regenerated by re-running `render.js` on the sidecar.
-
-## Workflow
-
-1. Pick template via `manifest.json` (match user intent against `use_cases` and `pattern`).
-2. Fill slot data from the conversation; record it as JSON.
-3. Invoke render script:
-
-   ```bash
-   node plugins/html-effectiveness/scripts/render.js \
-     --template=<id> \
-     --data=<data.json> \
-     --out=<reportDir>/YYYY-MM-DD-<slug>.html
-   ```
-
-4. Confirm output path to the user; offer `snip render --format html < <path>` to preview in browser.
-
-## Design principles
-
-Preserved from upstream `ThariqS/html-effectiveness`:
-
-- Avoid purple/blue gradient backgrounds, generic feature grids, center-everything layouts, decorative patterns.
-- Prioritize real data, scannable hierarchy, spatial grouping, progressive disclosure over decoration.
-
-## Technical requirements
-
-- Single `.html` file, fully self-contained.
-- CSS variables for theming (light-only baseline, matching upstream palette).
-- System font stack and 150ms smooth transitions.
-- Responsive design 375px–1440px.
-- Semantic HTML5 with ARIA labels.
-- Print styles that expand all hidden content.
-
-## Failure modes
-
-- **No template fits**: present the top 2 closest matches with one-line summaries; ask the user to confirm, or offer plain-markdown fallback. Never silently force a poor fit.
-- **Missing slot data**: ask one question at a time; respect the cap of 6 questions before forcing render with best-guess defaults plus a note of what was assumed.
-- **Render error**: surface `template:slot expected <type> got <type>` to the user; fix the slot value; retry.
-
-## Vendored templates
-
-Templates are vendored, not auto-synced. The pinned upstream SHA lives at `templates/manifest.json` → `_meta.upstream_sha`. To refresh a single template: `node plugins/html-effectiveness/scripts/extract.js fetch <id>.html` then `split <id>.html`. Files land in `.tmp/html-effectiveness/extract/` (gitignored). Hand-merge the diff back into `templates/<id>.html.tmpl` and update `_meta.upstream_sha` if pinning a new revision.