Triage the three surfaced divergences the governance-correct way (no stack->React
back-edit, no ir/ hand-edit); make adapt-lit/parity-lit/designbook-refresh now
exit 0:
- PipelineStrip: documented TAG_OVERRIDES in scripts/ir-extract.mjs maps the
React 'PipelineStrip' to the established tag wn-pipeline (the web-component tag
is an IR-projection detail, not React-dictated; the component name stays
faithful). Tag now matches the element; parity tests it (no longer skipped).
- PageHeader.actions: the drift detector now collects each element's named slots
and treats an IR prop honoured by a same-named slot (<slot name="actions">) as
satisfied (prop-via-slot, informational) rather than prop-missing.
- Sidebar.current: recorded as an auditable accepted divergence in
adapters/lit/drift.accepted.json (React monolithic 'current' key vs Lit per-item
'active' on composable <wn-sidebar-item>) — listed, downgraded to info, not gated.
Rendered surfaces (src/, examples/) untouched — verified zero diff; parity renders
all 10 components green. Adapt/parity outputs idempotent (stable re-run).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A deliberately-unfinished second adapter that consumes the same ir/ and honours
the same adapters/ADAPTER_CONTRACT.md (token full-gen + write-once stubs + drift
roll-up shape + exit codes), with zero changes to ir/. Every IR component is
'new' for a fresh stack → 10 class stubs + tokens.css (80 props). Not a usable
plain-CSS kit — the deliverable is confidence the boundary holds so the
architecture can be lifted into a coulomb-level tool later. make adapt-plain-css.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
scripts/designbook-refresh.mjs chains the automatable steps
(check->pull->sync->ir->adapt-lit->parity) and stops for the human drift-triage
step, propagating the adapter-contract exit codes (3=stop for triage, 4=parity
fail). Gating steps call the node scripts directly so make doesn't collapse the
3/4 codes to 2. Best-effort steps (check/pull/sync) warn and continue; --no-pull
/--no-check/--no-parity flags. Documented the loop in stack-and-commands.md and a
step-6 drift-resolution runbook in designbook/README.md.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Render every <wn-*> in a real browser (Playwright, --no-sandbox; reuses an
external static server when present) and write the adapter-contract parity result
to adapters/lit/parity/_parity.json:
- Contract parity: element must upgrade + carry no attribute-mismatch vs IR
(computed statically via scaffold.componentDrift, avoiding runtime
type-coercion false positives). prop-missing is a coverage note, not a failure.
- Visual parity: render smoke (non-empty + positive box) + per-component
screenshot artifact (gitignored). Pixel-exact regression stays with the
Playwright baseline suite; IR exemplars are gallery cards, not single-component
baselines, so they are the human reference, not an auto pixel gate.
- Result: 10 components, contractFail=0 visualFail=0, PipelineStrip skipped
(wn-pipeline-strip rename drift). Exit 4 on failure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Extend make adapt-lit beyond tokens: parse src/elements/*.js, compare each IR
component contract against its <wn-*> element, and emit per-component drift
reports + a machine roll-up (adapters/lit/drift/), with write-once stubs
(adapters/lit/stubs/) for genuinely new components. Never overwrites
hand-authored sources.
- Severity split: actionable drift (prop-missing, attribute-mismatch,
variant-axis-missing, tag-mismatch) gates with exit 3; non-portable + prop-extra
are informational (the IR carries React style/onClick; Lit is richer than the
minimal designbook) and don't gate.
- Current state: 7 ok, 3 actionable drift for human triage — PipelineStrip
(wn-pipeline-strip vs hand-authored wn-pipeline rename), PageHeader (actions is
a slot, not a prop), Sidebar (IR 'current' axis absent on the element).
- _report.json reuses generatedAt/irRef when drift is unchanged (no git churn).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
make release bumps package.json but not the IR; regenerate so the manifest
version anchor (and INDEX header) read 0.4.0 to match the published package.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
WnBreadcrumb._onSlot inserted separator <span>s into its own light DOM on
slotchange but cleaned up in the shadow DOM, so they were never removed — each
insertion re-fired slotchange, looping the main thread and wedging the showcase
page. Made _onSlot idempotent: exclude own separators when reading items, and
mutate only when separators are not already correct.
- Un-fixme the showcase visual test; add a warm-up full-page capture so
deviceScaleFactor-2 sub-pixel snapping settles before the assertion. All 5
visual tests pass.
- Remove the dead Google-Fonts @import from colors_and_type.css (token stacks are
system-ui; webfont unused + a CI-flake source; no visual change).
- Unblocks WHYNOT-WP-0003 T08 (showcase = per-version visual catalog); both T11
and T08 marked done.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- scripts/release.mjs + `make release VERSION=x.y.z`: guarded release cut —
bumps package.json, relabels CHANGELOG [Unreleased] → [x.y.z], commits, and
creates the annotated git tag. Refuses on dirty tree, existing tag, duplicate
section, or empty [Unreleased]. Never pushes (outward step stays manual).
- DesignSystemIntroduction.md §6: document the release ritual; §9: fix the
stale bootstrap host + tag note.
- README: bump the install pin to the first real tag (v0.3.0).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- README: correct the Node-tooled install host (placeholder gitea.example.com →
gitea.coulomb.social/coulomb/whynot-design) and rewrite the Type/font prose to
match the actual tokens (system font stacks, no webfont; Plex kept as history).
- WHYNOT-WP-0003 T06: add a "Tracking whynot-design from a consuming repo" README
section (pin → inspect → drift → adopt) and reconcile the install pin once
T01/T02 publish a tag.
- Record the README fixes as ADHOC-2026-06-27.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Versioned IR releases (Gitea npm) + a consumer-side drift-check so downstream
repos can pin whynot-design, inspect a version, and track changes at their own
pace. Status: proposed (awaiting review). Defaults: Gitea npm distribution +
snapshot-diff drift basis; live contract-parity deferred.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Visual baselines are large binary test artifacts; keep them out of the repo.
They stay on disk locally (regenerate with `pnpm test:visual:update`); the
infra fixes that make rendering deterministic remain committed. Also folds in
the state_hub_task_id writeback from `make fix-consistency`.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Regenerate the four whynot-control visual baselines against the T06 token
regen, and make the harness render deterministically:
- serve.json (cleanUrls:false): serve was 301-redirecting /…/index.html and
stripping the trailing slash, shifting the document base so every relative
asset 404'd (also broke `pnpm showcase` in a browser).
- examples/whynot-control/index.html: token stylesheet pointed at a
non-existent root path; repoint to ../../src/styles/colors_and_type.css so
the page actually loads the T06 tokens.
- examples/vendor/lit.js: vendor a self-contained esbuild lit bundle and point
the showcase importmap at it, removing the multi-hop live esm.sh dependency.
- tests/visual/ui-kit.spec.mjs: abort the unused Google-Fonts CDN (fonts are
system-ui post-IBM-Plex); a hung font request blocked module execution.
The showcase "every component" test is marked test.fixme: that page wedges the
renderer main thread (a demo composition loops) and has never produced a
baseline. Tracked as WHYNOT-WP-0002-T11. Components + vendored lit render fine
in isolation; the four control baselines pass deterministically.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Review integration files; fill SCOPE where templated
- Document dev workflow in stack-and-commands.md
- Seed WP-0002 implementation workplan; mark bootstrap finished
- Hub sync via fix-consistency
- designbook/ local mirror of the Claude Design project, with conventions
(@dsCard/manifest) and freshness marker docs.
- make designbook-sync + scripts/designbook-sync.mjs: record what a sync
changed into RecentChanges.md, grouped by layer, with last /design-sync time.
- make designbook-check + scripts/check_designbook_staleness.py: llm-connect
(claude-code adapter) backend that detects when the cloud designbook moved
ahead and warns the local mirror is outdated.
- .design-sync/config.json: recorded target project pin (WhyNot Design System).
- WHYNOT-WP-0002: workplan for a technology-neutral designbook IR with
scaffold+drift-detect stack adapters (Lit reference).
- gitignore Python artifacts.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
CLAUDE.md modular rules, AGENTS/INTENT/SCOPE/.custodian-brief, and the
state-hub bootstrap workplan (WHYNOT-WP-0001).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
