Skip to content

Add REPORT.html, the main report for people - #4

Merged
alextnetto merged 2 commits into
mainfrom
html-report
Oct 16, 2026
Merged

alextnetto merged 2 commits into
mainfrom
html-report

Conversation

@alextnetto

Copy link
Copy Markdown
Owner

Adds build-report.mjs: the knowledge base becomes REPORT.html, one self-contained page a person reads (summary and decisions first, then barriers, build plan, screens, rules, data model, API, design tokens, evidence). Images embedded, IDs linked, content escaped, no scripts, no network.

pack-kb.mjs now writes it and includes it in the zip, and the skill sends it with the zip as the main deliverable.

Stacked on #3: merge #3 first.

Checked on the real example KBs from #1 and #2: ClickUp 6.3 MB, Pipedrive 5.5 MB, 0 broken internal links, no horizontal scroll at 390 px, light and dark. 30 tests pass, including one that found and fixed a table broken by an HTML comment in the templates.

- pack-kb keeps sandbox/ledger.csv in the zip without object IDs,
  locations or URLs, so an unzipped handoff passes check-kb --closing
  and L-### references resolve. Test unzips the handoff and checks it.
- Baseline counts cover only the container and the operator's own
  records, by filter or count endpoint; teardown compares those.
- L3: item-level (operator-only) visibility when the container cannot
  be private; rule for unattended sessions that start during the
  team's working hours.
- Stop and skip: deleting your own ledger items inside the sandbox is
  exempt from the "cannot be undone" stop.
- mask.js: selectors become persistent CSS rules that cover elements
  rendered later; matching placeholders are masked, placeholders: true
  masks all; invalid selectors are reported. New Masking section.
- tools.md: Claude in Chrome notes (long results, network list, local
  servers, background clicks, where save_to_disk screenshots land).
build-report.mjs renders the knowledge base into one self-contained HTML
page: summary, decisions needed, barriers, build plan, features and
coverage, screens, components, rules, parity tests, flows, data model,
API, design tokens, topics, findings, questions, charter, glossary,
sources and an evidence gallery. Images are embedded once, IDs link to
their anchors, Markdown content is escaped, and the page has no scripts
and makes no network requests. pack-kb writes it and puts it in the zip;
the skill sends it with the zip as the main deliverable. Tested on the
ClickUp and Pipedrive example KBs: 0 broken links, no mobile overflow.
@alextnetto
alextnetto merged commit c4b32bd into main Oct 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant