Files
command-center/agent/managed-skills/html-change-report/SKILL.md
T
Frank 9bfa0be85d chore(skills): promote runbook skills to managed-skills; drop superseded SKILL.md
- 31 new managed skills (anubis/arr/authentik/hermes/freetoken/podman/llm-swap
  runbooks etc.) now tracked.
- Removed superseded skills: omp_harness_config, peon_ping_integration
  (replaced by user-authored peon-ping-* managed skills),
  rocmfp4-strix-benchmark-orchestration.
- New memory-root skills: niri_compositor_ops, omp_git_workflow,
  omp_model_config, quadlet-media-migration, homelab-service-triage,
  hermes-dankclaw-ops, frank-default-large-ops, caddy-auth-dns-playbook.
2026-09-09 16:20:28 -07:00

2.2 KiB

name, description
name description
html-change-report Generate and open a self-contained dark-theme HTML change report (Keep a Changelog categories + code samples) for a git repo time window; use when Frank asks for a rendered report of recent work.

HTML change report (Keep a Changelog + review aids)

Produce a self-contained HTML report of repo work in a time window and open it in Firefox.

Data gathering

  • Window commits: git log --since="24 hours ago" --pretty='%h|%ad|%s' --date=format:%H:%M (split on |).
  • Metrics: git diff --shortstat <first>^..HEAD, per-area file counts via git diff --name-only … | awk -F/ '{print $1"/"$2}' | sort | uniq -c | sort -rn.
  • Bucket commits into phase/theme rows by time-of-day for the timeline table.

Report structure (standard: Keep a Changelog 1.1.0)

  1. Executive summary (metrics + 3-5 bullets).
  2. Full commit timeline table, phase-color-tagged (border-left per phase).
  3. git show <hash> command list per theme — Frank uses this for his review pass.
  4. Changes by category: Added/Changed/Fixed/Removed/Security; omit empty categories; cite commit hashes per item. Fixed = old behavior was a bug; Changed = intentional.
  5. 4-6 notable code excerpts: read real files, pick load-bearing/instructive code, note file:lines + commits + why it matters. HTML-escape everything (html.escape).
  6. Verification evidence table (what / how / result).
  7. Incidents & open risks.
  8. Actions required from Frank (numbered, effort hints).

HTML requirements

  • Self-contained: inline CSS only, NO CDNs (must work from file:// offline). Dark theme CSS vars (#1a1b26 bg family works).
  • Sticky top nav, section anchors, <pre class=code><code> blocks, commit hashes as .tag chips.
  • Build via python (eval kernel): subprocess for git data, string concat for CSS (avoid f-string brace pain), f-strings for rows.

Delivery + verification

  • Write to /home/dank/Reports/<repo>-<window>-<date>.html (outside repo, tree stays clean).
  • Validate: python HTMLParser feed (parse errors) + open in headless browser (write JSON to xd://browser: open → run with document.querySelectorAll counts + fullPage screenshot) → close tab.
  • Open for Frank: nohup firefox --new-tab file:///<path> >/dev/null 2>&1 & disown.