@drunkcoding/agents-and-skills 0.0.13 → 0.0.14

package/plugins/html-effectiveness/templates/manifest.json

@@ -1,7 +1,441 @@
 {
   "_meta": {
     "upstream_repo": "ThariqS/html-effectiveness",
-    "upstream_sha": "PENDING",
-    "extracted_at": "PENDING"
+    "upstream_sha": "a1fb5673c26f87be9b833e1876cf4fd0f30f5f2d",
+    "fetched_at": "2026-05-13",
+    "note": "Templates vendored. Re-fetch is manual; see scripts/fetch-upstream.js."
+  },
+  "11-status-report": {
+    "title": "Status Report",
+    "use_cases": [
+      "weekly status",
+      "project update",
+      "team digest",
+      "monthly recap",
+      "engineering status"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/11-status-report.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      },
+      "auto_pill": {
+        "type": "string"
+      },
+      "date_range": {
+        "type": "string",
+        "required": true
+      },
+      "repo": {
+        "type": "string"
+      },
+      "summary": {
+        "type": "array",
+        "of": {
+          "num": "string",
+          "label": "string",
+          "delta": "string",
+          "delta_kind": "string",
+          "warn": "boolean"
+        }
+      },
+      "highlights": {
+        "type": "object"
+      },
+      "shipped": {
+        "type": "object"
+      },
+      "velocity_svg": {
+        "type": "html"
+      },
+      "velocity_caption": {
+        "type": "string"
+      },
+      "carryover": {
+        "type": "object"
+      },
+      "footer": {
+        "type": "html"
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "01-exploration-code-approaches": {
+    "title": "Code-Approaches Exploration",
+    "use_cases": [
+      "compare implementations",
+      "approach trade-offs",
+      "design alternatives"
+    ],
+    "pattern": "comparison_board",
+    "tmpl": "templates/01-exploration-code-approaches.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "02-exploration-visual-designs": {
+    "title": "Visual Design Exploration",
+    "use_cases": [
+      "compare designs",
+      "UI alternatives",
+      "visual options"
+    ],
+    "pattern": "comparison_board",
+    "tmpl": "templates/02-exploration-visual-designs.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "03-code-review-pr": {
+    "title": "PR Code Review Board",
+    "use_cases": [
+      "PR review",
+      "code review",
+      "diff review"
+    ],
+    "pattern": "code_review_board",
+    "tmpl": "templates/03-code-review-pr.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "04-code-understanding": {
+    "title": "Code Walkthrough",
+    "use_cases": [
+      "explain code",
+      "walk through architecture",
+      "trace logic"
+    ],
+    "pattern": "knowledge_explorer",
+    "tmpl": "templates/04-code-understanding.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "05-design-system": {
+    "title": "Design System Sheet",
+    "use_cases": [
+      "design tokens",
+      "color palette",
+      "typography"
+    ],
+    "pattern": "design_system_sheet",
+    "tmpl": "templates/05-design-system.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "06-component-variants": {
+    "title": "Component Variant Matrix",
+    "use_cases": [
+      "component variants",
+      "states gallery"
+    ],
+    "pattern": "design_system_sheet",
+    "tmpl": "templates/06-component-variants.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "07-prototype-animation": {
+    "title": "Animation Prototype",
+    "use_cases": [
+      "animation prototype",
+      "motion preview"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/07-prototype-animation.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "08-prototype-interaction": {
+    "title": "Interaction Prototype",
+    "use_cases": [
+      "interaction prototype",
+      "ux flow"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/08-prototype-interaction.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "09-slide-deck": {
+    "title": "Slide Deck",
+    "use_cases": [
+      "slide deck",
+      "presentation",
+      "pitch"
+    ],
+    "pattern": "slide_deck",
+    "tmpl": "templates/09-slide-deck.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "10-svg-illustrations": {
+    "title": "SVG Illustration Gallery",
+    "use_cases": [
+      "illustrate concept",
+      "svg gallery"
+    ],
+    "pattern": "knowledge_explorer",
+    "tmpl": "templates/10-svg-illustrations.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "12-incident-report": {
+    "title": "Incident Report",
+    "use_cases": [
+      "incident report",
+      "post-mortem",
+      "outage writeup"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/12-incident-report.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "13-flowchart-diagram": {
+    "title": "Flowchart Diagram",
+    "use_cases": [
+      "flowchart",
+      "process diagram",
+      "decision tree"
+    ],
+    "pattern": "knowledge_explorer",
+    "tmpl": "templates/13-flowchart-diagram.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "14-research-feature-explainer": {
+    "title": "Feature Explainer",
+    "use_cases": [
+      "explain feature",
+      "feature deep-dive"
+    ],
+    "pattern": "knowledge_explorer",
+    "tmpl": "templates/14-research-feature-explainer.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "15-research-concept-explainer": {
+    "title": "Concept Explainer",
+    "use_cases": [
+      "explain concept",
+      "tutorial",
+      "primer"
+    ],
+    "pattern": "knowledge_explorer",
+    "tmpl": "templates/15-research-concept-explainer.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "16-implementation-plan": {
+    "title": "Implementation Plan",
+    "use_cases": [
+      "implementation plan",
+      "phased rollout",
+      "roadmap"
+    ],
+    "pattern": "annotated_timeline",
+    "tmpl": "templates/16-implementation-plan.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "17-pr-writeup": {
+    "title": "PR Writeup",
+    "use_cases": [
+      "PR description",
+      "release notes",
+      "change writeup"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/17-pr-writeup.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "18-editor-triage-board": {
+    "title": "Triage Board",
+    "use_cases": [
+      "bug triage",
+      "issue board",
+      "kanban"
+    ],
+    "pattern": "kanban_board",
+    "tmpl": "templates/18-editor-triage-board.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "19-editor-feature-flags": {
+    "title": "Feature Flags Matrix",
+    "use_cases": [
+      "feature flags",
+      "rollout matrix"
+    ],
+    "pattern": "decision_matrix",
+    "tmpl": "templates/19-editor-feature-flags.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
+  },
+  "20-editor-prompt-tuner": {
+    "title": "Prompt Tuner",
+    "use_cases": [
+      "prompt tuning",
+      "LLM config"
+    ],
+    "pattern": "interactive_report",
+    "tmpl": "templates/20-editor-prompt-tuner.html.tmpl",
+    "slots": {
+      "title": {
+        "type": "string",
+        "required": true
+      }
+    },
+    "asset_bundles": [
+      "base"
+    ],
+    "extra_js": null
   }
 }

package/plugins/html-effectiveness/tests/_tmp.test.js

@@ -0,0 +1,58 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTmpDir, cleanup, withTmp, ROOT } from '../scripts/_tmp.js';
+
+test('getTmpDir creates a fresh dir under .tmp/html-effectiveness/', () => {
+  const dir = getTmpDir('unit-a');
+  assert.ok(dir.endsWith('/.tmp/html-effectiveness/unit-a'));
+  assert.ok(existsSync(dir));
+  cleanup('unit-a');
+});
+
+test('getTmpDir wipes existing dir contents', () => {
+  const dir = getTmpDir('unit-b');
+  writeFileSync(join(dir, 'old.txt'), 'stale');
+  const dir2 = getTmpDir('unit-b');
+  assert.equal(dir, dir2);
+  assert.equal(existsSync(join(dir2, 'old.txt')), false);
+  cleanup('unit-b');
+});
+
+test('cleanup removes dir', () => {
+  const dir = getTmpDir('unit-c');
+  cleanup('unit-c');
+  assert.equal(existsSync(dir), false);
+});
+
+test('cleanup is idempotent on missing dir', () => {
+  cleanup('unit-never-created');
+  assert.ok(true);
+});
+
+test('withTmp runs callback and cleans up on success', () => {
+  let observed;
+  const result = withTmp('unit-d', (dir) => {
+    observed = dir;
+    writeFileSync(join(dir, 'x'), 'y');
+    return 'done';
+  });
+  assert.equal(result, 'done');
+  assert.equal(existsSync(observed), false);
+});
+
+test('withTmp cleans up even when callback throws', () => {
+  let observed;
+  assert.throws(() => {
+    withTmp('unit-e', (dir) => {
+      observed = dir;
+      throw new Error('boom');
+    });
+  }, /boom/);
+  assert.equal(existsSync(observed), false);
+});
+
+test('ROOT is anchored at repo .tmp/html-effectiveness', () => {
+  assert.ok(ROOT.endsWith('/.tmp/html-effectiveness'));
+});

package/plugins/html-effectiveness/tests/fixtures/01-exploration-code-approaches.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Code-Approaches Exploration"
+}

package/plugins/html-effectiveness/tests/fixtures/02-exploration-visual-designs.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Visual Design Exploration"
+}

package/plugins/html-effectiveness/tests/fixtures/03-code-review-pr.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "PR Code Review Board"
+}

package/plugins/html-effectiveness/tests/fixtures/04-code-understanding.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Code Walkthrough"
+}

package/plugins/html-effectiveness/tests/fixtures/05-design-system.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Design System Sheet"
+}

package/plugins/html-effectiveness/tests/fixtures/06-component-variants.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Component Variant Matrix"
+}

package/plugins/html-effectiveness/tests/fixtures/07-prototype-animation.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Animation Prototype"
+}

package/plugins/html-effectiveness/tests/fixtures/08-prototype-interaction.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Interaction Prototype"
+}

package/plugins/html-effectiveness/tests/fixtures/09-slide-deck.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Slide Deck"
+}

package/plugins/html-effectiveness/tests/fixtures/10-svg-illustrations.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "SVG Illustration Gallery"
+}

package/plugins/html-effectiveness/tests/fixtures/11-status-report.data.json

@@ -0,0 +1,37 @@
+{
+  "title": "Engineering Status",
+  "auto_pill": "Auto-generated",
+  "date_range": "Apr 29 — May 13, 2026",
+  "repo": "drunkcoding/agents-and-skills",
+  "summary": [
+    { "num": "12", "label": "Shipped",    "delta": "+3 vs prev", "delta_kind": "up" },
+    { "num": "47", "label": "Open bugs",  "delta": "-8",          "delta_kind": "down" },
+    { "num": "14", "label": "On-call",    "delta": "+2",          "delta_kind": "up", "warn": true },
+    { "num": "92%","label": "CI green",   "delta": "flat",        "delta_kind": "flat" }
+  ],
+  "highlights": {
+    "items": [
+      { "strong": "Auth v2 cutover.",  "body": "All traffic on new identity stack; p95 latency down <em>30%</em>." },
+      { "strong": "Search reindex.",   "body": "Full corpus rebuilt in 11h, down from 26h." },
+      { "strong": "Mobile beta.",      "body": "iOS 17 build live to internal testers." }
+    ]
+  },
+  "shipped": {
+    "rows": [
+      { "pr": "#1042", "title": "feat(auth): rotate session keys",       "author": "alice",   "risk": "low" },
+      { "pr": "#1048", "title": "fix(search): off-by-one in date filter", "author": "bob",     "risk": "low" },
+      { "pr": "#1055", "title": "perf(api): cache permission lookups",    "author": "charlie", "risk": "med" },
+      { "pr": "#1061", "title": "feat(mobile): push notif opt-in",        "author": "dana",    "risk": "high" }
+    ]
+  },
+  "velocity_svg": "<svg viewBox=\"0 0 600 160\" xmlns=\"http://www.w3.org/2000/svg\"><polyline fill=\"none\" stroke=\"#D97757\" stroke-width=\"2\" points=\"0,120 75,90 150,100 225,70 300,60 375,80 450,40 525,30 600,50\"/><line x1=\"0\" y1=\"150\" x2=\"600\" y2=\"150\" stroke=\"#D1CFC5\"/></svg>",
+  "velocity_caption": "Merged PRs per day, 2-week window. Source: GitHub API.",
+  "carryover": {
+    "items": [
+      { "tag": "BLOCKED", "body": "App Store review for iOS 17 build.",        "who": "dana" },
+      { "tag": "REVIEW",  "body": "Permission cache invalidation edge case.",  "who": "charlie" },
+      { "tag": "SCOPE",   "body": "Q3 platform RFC pending review.",           "who": "alice" }
+    ]
+  },
+  "footer": "Generated 2026-05-13 · <a href=\"#\">runbook</a>"
+}

package/plugins/html-effectiveness/tests/fixtures/12-incident-report.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Incident Report"
+}

package/plugins/html-effectiveness/tests/fixtures/13-flowchart-diagram.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Flowchart Diagram"
+}

package/plugins/html-effectiveness/tests/fixtures/14-research-feature-explainer.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Feature Explainer"
+}

package/plugins/html-effectiveness/tests/fixtures/15-research-concept-explainer.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Concept Explainer"
+}

package/plugins/html-effectiveness/tests/fixtures/16-implementation-plan.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Implementation Plan"
+}

package/plugins/html-effectiveness/tests/fixtures/17-pr-writeup.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "PR Writeup"
+}

package/plugins/html-effectiveness/tests/fixtures/18-editor-triage-board.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Triage Board"
+}

package/plugins/html-effectiveness/tests/fixtures/19-editor-feature-flags.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Feature Flags Matrix"
+}

package/plugins/html-effectiveness/tests/fixtures/20-editor-prompt-tuner.data.json

@@ -0,0 +1,3 @@
+{
+  "title": "Prompt Tuner"
+}