Skip to content

Plan 5a — examples + launch - #8

Merged
rz1989s merged 13 commits into
masterfrom
feat/examples-publish-5
Aug 29, 2026
Merged

rz1989s merged 13 commits into
masterfrom
feat/examples-publish-5

Conversation

@rz1989s

@rz1989s rz1989s commented Aug 29, 2026

Copy link
Copy Markdown
Member

The launch slice. Five engine-verified example builds, the Tier-3 example regression, the comparison-harness tooling (executed in 5b), CI + release workflows, and the public-launch README. Merging flips the repo public and tags v0.1.0.

What's here

  • examples/01–05 — Cobalt/Split Studio observability (48/48 + self-audit 43/43), Garden/Long Document plant shop (48/48), Terminal/Manifesto CLI (48/48), Riso/Catalogue print studio (48/48), Hum/Bento language co-op (48/48). Each ships its openable keystone-report.html, 5 viewport screenshots, and a brief.md with the full decision + vision-verdict trail.
  • examples/README.md — the index + what the set proves (S3: five briefs, five different sites).
  • test/examples.test.mjs — Tier-3 regression: ≤7 distinct failed gate numbers per example, ≥3 perfectly clean, render-guarded.
  • test/compare/ — 8 verbatim briefs (Hallmark MIT _tests, attributed), the render→score runner, gallery template, and the 5b fairness protocol (same model, no intervention, losses published).
  • CI — typecheck + all suites incl. render + examples regression with version-matched Chromium. Release — org convention: v* tag → gates → npm publish → GitHub Release.
  • package.jsonkeystone bin (audit | check), NOTICE ships, playwright-core pinned 1.62.0.
  • render.ts — type-only strict fixes (behavior-identical, all suites re-green).

Verification

  • typecheck ✓ · engine 162+1skip ✓ · lint 103 ✓ · render 4 ✓ · examples 3 ✓ · CLI render 3 ✓
  • Independent review pass: 0 blocking; all 10 findings (5 should-fix, 5 nits) verified and fixed in-tree.

Post-merge launch sequence

flip public → tag v0.1.0 → release.yml publishes → 5b executes the comparison gallery.

rz1989s added 13 commits August 29, 2026 11:44
Floor: at most 7 distinct failed gate numbers per example (>=41/48), at least
three examples perfectly clean. Render-guarded like the other render tests.
… template

Verbatim prompts from Hallmark's MIT test suite (site/_tests), attributed.
Runner consumes pre-built candidate dirs (both skills' outputs), renders both
at 5 viewports, scores both with the same engine, writes gallery verdicts.
Execution is Plan 5b — protocol in test/compare/README.md.
ci.yml: pnpm frozen install, version-matched Chromium, typecheck, engine +
gates, structural lint, render extension, Tier-3 example regression, and the
env-guarded CLI render tests — all on every push/PR.

release.yml: org convention (tag v* → gates → npm publish with NPM_TOKEN →
GitHub Release), idempotent, render suites left to CI.

package.json: pin playwright-core 1.62.0 + devDep playwright 1.62.0 (browser
install), @types/node, scripts (typecheck/test:lint/test:render/test:examples),
NOTICE ships in the npm files array. render.ts: type-only strict fixes
(casts + widened pair types) — behavior unchanged, all suites green.
README: the thesis (prose gates vs executable gates), install, build/audit
verbs, engine summary, the five examples with scores, the comparison story
with the honesty clause, dev commands, release flow.

engine/keystone.mjs: standalone CLI dispatcher (audit | check) wired as the
npm bin.
- gallery template: add the #GALLERY mount the runtime script expects
- release.yml: tag-guard the GitHub Release step (workflow_dispatch ref is a branch)
- NOTICE: replace the /tmp license path with the upstream URL; README heading
  the NOTICE references now exists
- brief 01: self-audit count 44 → 43 (matches the committed report); audit
  report notes the raw data dir is intentionally local-only
- README: test count 273 → 275 (engine 162 + lint 103 + render 4 + examples 3 + CLI render 3)
- run-comparison.mjs: candidate contract comment matches the scorer (style.css only)
- examples.test.mjs: memoize one render per slug (5 Chromium runs, not 10)
- engine/keystone.mjs: usage documents the gates alias; spawn errors surfaced
- package.json: trailing EOF newline
@rz1989s
rz1989s merged commit 68cdc7b into master Aug 29, 2026
1 check passed
@rz1989s
rz1989s deleted the feat/examples-publish-5 branch August 29, 2026 13:49
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