mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-17 08:36:25 +03:00
* Add oracle harness: verb goldens and function-level vectors
Records stdout/stderr/exit/files for every impeccable verb over a fixed
corpus and replays them against an alternate implementation. Adds a loader
hook that captures per-function call vectors from the pure engine modules.
Prepared with AI assistance (Claude Code).
* Oracle: hook, hook-before-edit, hook-admin cases and goldens
Prepared with AI assistance (Claude Code).
* Add docs/CLI-CONTRACT.md: observable behavior of every impeccable verb
Prepared with AI assistance (Claude Code).
* Oracle: context/doctor/pin/surface-brief/critique/palette/embed/signals/csp/seed/genimg/question cases and goldens
Prepared with AI assistance (Claude Code).
* Oracle: live-mode cases and goldens (roots, inject, wrap, insert, accept, session, manual edits, daemon)
Prepared with AI assistance (Claude Code).
* Oracle: mask the binary path before HOME; export launcher env to the binary
Prepared with AI assistance (Claude Code).
* detect: set process.exitCode instead of exiting after the final write
process.exit() right after a large piped stdout write truncated JSON output
at the pipe buffer boundary; found by the oracle harness. Re-record the six
directory-scan goldens that had captured the truncation.
Prepared with AI assistance (Claude Code).
* Oracle: normalize the hook-admin command in both runtimes' forms and audit chars
Prepared with AI assistance (Claude Code).
* Skill text: invoke the impeccable launcher instead of node scripts
Every `node {{scripts_path}}/<name>.mjs` becomes `{{scripts_path}}/impeccable <verb>`
(context-signals -> signals, hook-admin -> hooks). Setup step 1 drops Node, points
Windows shells without sh at impeccable.cmd, and says the launcher runs a
self-contained binary. allowed-tools follows.
Prepared with AI assistance (Claude Code).
* Scripts dir: replace the Node scripts with the impeccable launcher
skill/scripts keeps command-metadata.json and the page JS; every .mjs entry
point, lib/, and live/ are gone (the binary owns those verbs). Adds the POSIX
launcher, impeccable.cmd, VERSION (copied from the new root ENGINE_VERSION),
scripts/fetch-engine.mjs (bun run fetch:engine) to pull the pinned binary
into skill/scripts/bin/<os>-<arch>/, and gitignores that bin dir.
Prepared with AI assistance (Claude Code).
* Build: ship the launcher instead of bundling the JS engine
readSourceFiles no longer copies cli/engine into the skill; the scripts
payload is the launcher (executable bit preserved through dist, plugin/, and
universal.zip), impeccable.cmd, VERSION (synced from ENGINE_VERSION on every
build), the page JS, and command-metadata.json. Hook manifests call
`<scripts>/impeccable hook` behind an existence guard (Codex adds a
commandWindows sibling calling impeccable.cmd; Cursor runs hook-before-edit;
GitHub keeps the git rev-parse form; Grok mirrors Claude); the Node probe and
systemMessage notice are gone. build:release fetches the pinned engine for
every target (lenient) and stages bin/<os-arch>/ into the dist skill copies
after root harness dirs and plugin/ were synced, so git-delivered trees stay
launcher-only. The detection-rule count check reads the vendored
extension/detector/antipatterns.json and is skipped when absent.
build:browser is a stub; the codex prefix rewrite leaves
`{{scripts_path}}/impeccable` alone.
Prepared with AI assistance (Claude Code).
* CLI: turn the impeccable npm package into a platform-binary shim
cli/engine, cli/lib, and cli/bin/commands are gone; their behavior lives in
the engine binary. cli/bin/cli.js now resolves the binary from IMPECCABLE_BIN,
the @impeccable/cli-<os>-<arch> optional dependency (templates under
cli/platform-packages/, published by the engine release), the
~/.impeccable/bin/<version>/ cache, or a checksum-verified download, and
execs it. package.json drops the engine dependencies and the library
exports; puppeteer moves to devDependencies for the icon scripts.
README.npm.md describes the shim.
Prepared with AI assistance (Claude Code).
* Tests: gate behavior on the oracle and the engine binary
Unit tests of the deleted Node scripts and the JS detector are removed;
their behavior is pinned by tests/oracle goldens (frozen JS behavior plus
reviewed deltas) and the engine's own tests. tests/oracle.test.mjs replays
the corpus against the binary (IMPECCABLE_BIN or skill/scripts/bin/<target>/,
via tests/lib/engine-bin.mjs) and skips cleanly without one; the framework
fixture sweep drives live-inject, live-wrap, and detect-csp through the
binary the same way. record.mjs learns --bin. The function-level vectors
under tests/oracle/vectors/calls are committed as the frozen snapshot they
can no longer be regenerated from. Suites: core trimmed to build and
transformer tests, oracle added to the default run, detector/live reduced to
packaging and reference checks, the live-e2e helper tests move to the opt-in
live-e2e lane pending its retarget, cli-remote-e2e is an empty placeholder.
Prepared with AI assistance (Claude Code).
* Docs: describe the launcher, the engine pin, and the oracle gate
CLAUDE.md gains an Engine binary section (launcher lookup order, ENGINE_VERSION,
untracked binaries, how tests get one, the oracle as behavior gate, what stays
JavaScript) and drops the Node-script and JS-detector descriptions; the CLI
and detection-rule sections point at the shim and the engine repo. README.md
states the skill needs no runtime and lists the launcher-based hook commands;
AGENTS.md follows. CLI-CONTRACT.md's intro notes the scripts it quotes are
the recorded source, not the tree.
Prepared with AI assistance (Claude Code).
* Tests: tighten the hook command guard assertion
Prepared with AI assistance (Claude Code).
* Oracle: re-golden 46 cases for the engine's own command names; record them in DELTAS.md
Prepared with AI assistance (Claude Code).
* Build: ship launcher-only release zips by default
IMPECCABLE_BUNDLE_ENGINE=1 opts in to staging the engine binaries into the
dist skill copies. Bundling every target into every provider copy put
dist/universal.zip near 340 MB, past the 25 MB Cloudflare Pages file cap
that impeccable install downloads through.
Prepared with AI assistance (Claude Code).
* Tests: drive the live-e2e orchestrator through the engine binary
The session, fake-agent loop, steer test, and manual-edit probe spawn
<binary> <verb> (live-server, live, live-inject, live-wrap, live-insert,
live-accept, live-poll, live-complete) resolved by tests/lib/engine-bin.mjs
instead of node skill/scripts/live-*.mjs; the completion typing the agent
imported from the deleted live/completion.mjs is a small local helper. The
live-e2e helper unit tests move back into the default live suite (the steer
loop skips without a binary).
Prepared with AI assistance (Claude Code).
* Tests: run new-work-e2e through the engine's serve-question and generate-image verbs
Prepared with AI assistance (Claude Code).
* Tests: point the skill-behavior harness at the launcher and engine binary
The bash tool exports IMPECCABLE_BIN so the staged skill's launcher runs
without a download; scenarios assert on 'impeccable context' instead of
context.mjs and skip without a binary.
Prepared with AI assistance (Claude Code).
* Tests: note what plugin-e2e validates before and after the generated-output sync
Prepared with AI assistance (Claude Code).
* Oracle: record the engine's 'wasm-unsafe-eval' CSP meta patch as a reviewed delta
Prepared with AI assistance (Claude Code).
* Rebase reconciliation: fold main's post-freeze work into the swapped tree
The rebase onto origin/main brought changes whose JS engine halves left the
tree with the swap. This commit reconciles what survives:
- Suite map: register main's comp-fidelity unit tests (build-phase,
comp-diff, font-match, hero-checks) in the core suite and
live-browser-ignores in the live suite.
- Payload guard: the skill scripts payload now allowlists the comp-fidelity
build pipeline (comp-spec/comp-diff/build-phase/font-match and their libs),
the one Node toolchain that has not moved into the engine.
- Drop skill/scripts/live/project-ignores.mjs, lib/live-path-globs.mjs, and
their test: they import hook-lib/live-inject/impeccable-paths, which the
swap deleted, and their consumer (the JS live server) is the engine now.
- skill text: the comp pipeline's calls to engine verbs (generate-image,
embed-prompt) use the launcher spelling.
- Oracle: re-record 17 detect goldens over the fixture set main changed
(oklch #592, color-mix #578, 1D grid #615, the two comp-fidelity rules)
and record the gap in DELTAS.md; those JS rule changes are not yet ported
to the engine, and the goldens pin its current behavior.
bun run test (oracle included) and bun run build are green on this tree.
AI-assisted change: implemented with Claude Code.
Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* Launcher: engine-probe PATH validation, working .cmd download path; CI: drop stale path, add oracle job
Byte-identical copies of the engine repo's launchers (engine main
af7572c): the retired 3.x npm CLI on PATH or in ~/.impeccable/bin is
rejected by the engine-probe handshake instead of hijacking every verb;
impeccable.cmd's download path is rewritten as straight-line goto flow
(the parenthesized blocks expanded %url%/%cached% at parse time, making
it dead code) with certutil sha256 verification and a windows-arm64 ->
x64 asset fallback; the final error points at the release download
instead of npm i -g (npm still serves the 3.x CLI).
ci.yml: the generated-output check no longer diffs the deleted
cli/engine/detect-antipatterns-browser.js, and a new oracle job fetches
the pinned engine (bun run fetch:engine) and replays tests/oracle/
against it. The job is continue-on-error with a loud warning until the
first engine release exists; flipping it to required is a release-time
toggle, documented in the workflow.
Verified here: sh -n on both launcher copies, bun run build green, full
oracle replay against the rebuilt engine binary green (770 pass, 0
fail), and a launcher behavior test proving a fake 3.x CLI on PATH is
skipped while the download + checksum chain completes against a local
file server.
Prepared with AI assistance (Claude Code).
* Oracle: restore detector goldens to post-fix behavior after the engine ports
The Aug 17-31 detector fixes (oklch parsing, color-mix nested hex, 1D grid
pass, comment stripping, root-relative linked stylesheets, URL userinfo
redaction, inert ignore-value refusal) and the comp-fidelity rules
organic-clip-path / buried-raster are ported to the engine. Re-records the
gap-pinning detect goldens from the fixed binary (glow.html included: its
.photo-opaque-grad column now carries the buried-raster finding it was
written for), replays the frozen checkHtmlPatterns call vectors through the
last JS engine state in history (db1462b9^; args untouched, 14 of 101
results moved), and rewrites the DELTAS gap section into the landed-ports
note. Each re-recorded json fixture golden byte-matches that JS state's
output; oracle: 770 pass, 0 fail.
Prepared with AI assistance (Claude Code).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* Oracle: pin the Aug 17-31 verb fixes ported to the Rust engine
New cases: hook-session-grok-edit-then-stop (Grok Build camelCase envelope,
end_turn/shutdown/stopHookActive Stop handling, 35ae0733 + bfe634e2 +
3c442af7, #646), hook-session-codex-stop-decision (Codex Stop emits
decision/block, c9e7cd8a, #603), and doctor-order-boot-and-deep (boot and
deep findings keep their established artifact order, 80997663).
Re-recorded goldens whose old bytes froze pre-fix behavior, with a
DELTAS.md entry naming each upstream hash: the Stop finding-cache sync
(3c442af7), the Edit|Write manifests without the retired MultiEdit matcher
(7d5c60d2), and the failWithRollback field order (1f2c3f9d).
Prepared with AI assistance (Claude Code).
* Oracle: drop a duplicated DELTAS section
The verb-fix section landed twice when two porting sessions staged the
same file; keep one copy.
Prepared with AI assistance (Claude Code).
* Oracle: pin the hooks ignore-value inert-entry refusal
Three hadmin-ignore-value-inert-* cases record the engine's port of
be87f5eb (#662) to hooks ignore-value: an exact value for a rule whose
findings can never extract one is refused with the wildcard-plus-file
route (and no config write), while the wildcard scoped form for the same
rule is accepted. Goldens recorded from the engine binary and verified
byte-for-byte against the ea360025 hook-admin.mjs on the same sequences.
No existing golden changes, so no DELTAS entry is owed.
Prepared with AI assistance (Claude Code).
* Launcher: fail closed on a missing download checksum (engine triage C1)
Byte-identical sync of the engine repo's launchers: a freshly downloaded
engine binary now runs only after verifying against its .sha256 sidecar.
A sidecar that cannot be fetched, or a machine with no sha256 tool,
refuses the download instead of exec'ing an unverified binary; the
wget-only path fetches the sidecar too. Binaries already on PATH or in
the cache that pass engine-probe are unaffected.
Prepared with AI assistance (Claude Code).
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* Enforce engine-before-skill release order (triage D4)
The launcher, npm shim, and `impeccable install` all resolve the engine
binary for the pinned ENGINE_VERSION, so a skill/CLI release or a rust-swap
merge published ahead of the engine release + platform packages dead-ends
every install path. Add a mechanical guard:
- scripts/check-engine-release.mjs: verifies all five dist binaries +
.sha256 and the five @impeccable/cli-<os>-<arch> npm platform packages
exist for the pinned ENGINE_VERSION; names missing assets, exits non-zero.
Honors IMPECCABLE_DOWNLOAD_BASE.
- release.mjs: hard-fails release:skill and release:cli when assets are
missing; extension is exempt (vendored WASM detector, no engine exec).
- CI engine-release-ready job: runs the check, continue-on-error with a
loud ::warning until the first engine release exists (flip to false then).
- CLAUDE.md Releases: documents the enforced ordering.
Prepared with AI assistance (Claude Code).
* Oracle: re-record the Sep-1 verb fixes ported to the Rust engine
Five fixes landed on main in JS between the swap branch and its rebase and were
ported to the engine; the goldens they touch are re-recorded from the fixed
binary, each engine output first diffed byte-for-byte against the upstream JS on
the same inputs. DELTAS.md documents every case with its upstream hash.
- critique-* (usage/unknown/latest-existing/write-then-read/write-monorepo-child):
the #660 critique close path (identity + fingerprint freshness, ~NNNN
collision suffix, closed flag, close verb, latest --json). Upstream 5211bdf4.
- detect-* (new overused-font fixture cases, dir/scope/no-advisory sweeps):
the #678 overused-font primary-face change (a system stack keeps its system
face, so a Roboto fallback no longer flags). Upstream 2cfd6076.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* Tests: fix pre-existing release-guard staging on the swap branch
release.test.mjs was already red on the swap branch: release.mjs imports
check-engine-release.mjs and fetch-engine.mjs (the D4 engine release-order
guard), which the temp work tree never staged, so every dry run failed to
resolve the module instead of exercising the guard. Stage both modules and set
IMPECCABLE_SKIP_ENGINE_CHECK=1 so the guard does not probe the network; this
suite predates the guard and only covers the version/changelog/artifact checks.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* oracle: pin E8 stale-hook-manifest detector fallback (context)
Cover the v3-to-launcher upgrade fix (triage E8) recorded from the engine
binary and hand-reviewed:
- context-stale-hook-manifest: a .claude/settings.local.json naming the retired
`node .../hook.mjs` script under the claude-code provider emits
MANUAL_DETECTOR_REQUIRED, because the stale marker no longer counts as an
active hook (its script is gone after the update).
- context-launcher-hook-active: the same manifest in the launcher form still
suppresses MANUAL_DETECTOR_REQUIRED, confirming the launcher marker is
recognized as active.
The only difference between the two goldens is the MANUAL_DETECTOR_REQUIRED
block. No existing golden moved: every other context case runs under the source
provider, whose hook-manifest list is empty, so none of them scan a manifest.
Also null IMPECCABLE_PROVIDER_ID in the case BASE_ENV so a recording machine's
value cannot leak. DELTAS.md records the intentional divergence from JS parity.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaJv2c4oN8wS7Ttq4XRqyx
* Tests: stop two harness hangs from wedging a whole run
Two suites could hang forever and never print a tally, because the one
mechanism that could interrupt the wedged work was missing on both paths.
Hang 1 (bun run test / build-phase.test.mjs): the test's run() helper
spawned every child with spawnSync and no timeout. spawnSync blocks the
test worker's thread, so node's --test-timeout (an event-loop timer)
cannot interrupt a child that wedges (a fork/exec blocked on OS resources
under concurrency, a gate's comp-diff grandchild, or a stray browser
launch). Bound every child with spawnSync timeout + killSignal SIGKILL so
a wedge becomes a fast, named failure the next test survives.
Hang 2 (bun run test:skill-behavior): runTurn called generateText with no
client-side deadline, so a stalled provider stream kept the fetch (and the
whole node process) alive past the per-test timeout, producing no tally.
Attach a real AbortSignal (default 840s, under the 900s per-test cap):
on expiry the fetch aborts, the turn throws, and the scenario
fails-and-continues. The unref'd timer is cleared on completion.
Runner backstops: run-tests.mjs now spawns each command as a detached
process-group leader and enforces a per-suite wall-clock cap that SIGKILLs
the entire group (workers, grandchildren, browsers) on expiry, with
SIGINT/SIGTERM forwarded so Ctrl-C still reaps the tree. The core node
batch gets a finite --test-timeout (180s); skill-behavior gets a 60min
group cap. Env overrides: IMPECCABLE_TEST_WALL_CLOCK_MS,
IMPECCABLE_SKILL_BEHAVIOR_TURN_TIMEOUT_MS,
IMPECCABLE_BUILD_PHASE_RUN_TIMEOUT_MS.
Proof: bun run test green twice (~60s); scoped claude-sonnet-5
skill-behavior sweep terminates with a tally (20 tests, ~32min) where the
840s abort caught a wedged redesign turn and the sweep continued instead
of hanging.
Prepared with AI assistance (Claude Code).
* launcher: export skill-dir env before the IMPECCABLE_BIN exec (sync engine fix)
Prepared with AI assistance (Claude Code).
* Node-free swap: comp-fidelity verbs move to the engine
The four comp-fidelity scripts (comp-spec, comp-diff, font-match, build-phase)
and their six libs are ported into the impeccable-engine binary. This removes
the last Node .mjs from the skill: `git ls-files skill/scripts | grep '\.mjs$'`
now returns nothing.
- reference/new-work.md, reference/visualize.md, and the asset-producer /
finish-reviewer agents now invoke `{{scripts_path}}/impeccable <verb>` instead
of `node <script>.mjs`.
- Deleted the ten ported .mjs and the four JS unit tests that imported them
(their behavior is now covered by the engine's Rust tests and the oracle);
removed those files from scripts/test-suites.mjs.
- Added oracle cases (comp-*, font-match-*, build-phase-*) over a comp-basic
workspace, recorded from the engine binary; the deterministic outputs are
byte-identical to the JS the scripts left behind.
- docs/CLI-CONTRACT.md documents the four verbs, the CDP font rendering, and
the runtime-resolved (never-committed) font-index catalog.
The font-index catalog JSON stays shipped in the skill (data/font-index.json);
the engine resolves it at run time and never vendors it.
Prepared with AI assistance (Claude Code).
* reorg: public plumbing for the in-repo Rust workspace and the two-release flow
The engine binaries move from the impeccable-dist channel to this repo's own
GitHub Releases (tag engine-v<ENGINE_VERSION>), and the closed detector the
engine links arrives as detector-v<DETECTOR_VERSION> releases on the same
repo. This commit wires the public side for that; the crates themselves land
in the next commit.
- Launcher (sh + cmd), npm shim, fetch-engine and check-engine-release now
download from github.com/pbakaus/impeccable/releases/download/engine-v<X>/.
- release.mjs gains `engine`: verifies ENGINE_VERSION against the platform
package pins and the detector release, tags, pushes; release-engine.yml
builds the five targets and publishes. check-detector-release.mjs is the
matching release-order guard (with tests).
- Root Cargo.toml (workspace, lto = false with the reason), rust-toolchain.toml
(exact pin), DETECTOR_VERSION, /target ignored.
- CI: rust + rust-windows jobs and an oracle job that replays the goldens
against a source build, warn-only until the first detector release exists;
ci-test-plan exposes a `rust` output.
- docs/ENGINE.md (the crate map and the closed-detector mechanism) and the
CLAUDE.md engine, release-order and rules sections.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* reorg C: the open Rust runtime joins this repo as one Cargo workspace
The engine no longer lives in a separate repo. `crates/` is a snapshot of the
open crates (foundation, core, common, context, live, hook, skills, comp,
comp-verbs, html, browser, detect, cli) plus `Cargo.lock`, taken as a git
archive of the engine repo at the commit that finished the boundary split.
None of that repo's history comes with it, and none of it should: the closed
half stays private.
The closed half is the rule engine. It ships as a prebuilt native archive per
target, `libimpeccable_detector.a`, published as a `detector-v<X>` GitHub
Release on this repo. `crates/core/build.rs` resolves and links it three ways:
`IMPECCABLE_DETECTOR_LIB=<dir>` for a local detector build, else the
`~/.impeccable/detector/<version>/<target>/` cache, else a download verified
against its `.sha256` sidecar. `crates/core` is a thin shim over a three-symbol
C ABI; nothing above it knows the boundary exists.
What changed versus the engine repo copy:
- Every crate manifest moves from `license-file.workspace` to
`license.workspace` (this workspace declares Apache-2.0), and the workspace
gains the `postcard` dependency the boundary encoding needs.
- The launcher contract test reads `skill/scripts/impeccable{,.cmd}` instead of
a sibling `launcher/` dir, and `engine_binary` downloads from
`github.com/pbakaus/impeccable/releases/download/engine-v<version>/` instead
of the retired dist repo. No oracle golden carried the old URL, so no
re-recording was owed.
- The tests that hunted for a public repo through `IMPECCABLE_PUBLIC_REPO`,
`../impeccable-second` or a hardcoded home directory now resolve the root as
`CARGO_MANIFEST_DIR/../..`, because they are in it. The env var stays as an
override for an out-of-tree checkout.
- The in-page bundle (`detect-antipatterns-browser.js`, 2 MB of generated wasm
glue) is no longer tracked. `crates/core/build.rs` resolves it beside the
archive, hands the path to `impeccable_core::browser::IN_PAGE_BUNDLE_JS`, and
live mode serves that. `scripts/check-detector-release.mjs` now requires it
and its `.sha256` in a detector release.
- The live crate embeds `skill/scripts/live-browser*.js` and
`modern-screenshot.umd.js` directly rather than through vendored copies, so
the binary and the installed skill cannot drift.
- `crates/browser/assets/` (an unused second copy of the bundle) is gone.
- `tests/lib/engine-bin.mjs` also accepts `target/release/impeccable`, so a
plain `cargo build --release -p impeccable` is enough to run `bun run test`.
Verified with the archive from a local detector build: `cargo test --workspace`
267 pass, oracle 795 pass / 0 fail / 0 missing, `bun run build` clean, the
default suite green, and the launcher's `engine-probe` handshake answering
through `skill/scripts/impeccable`.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* docs: bring RUNTIME-ENV and PORTING-GUIDE over with the runtime
They describe the binary's environment contract and the parity method every
crate here was ported with; both belong next to the crates now.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* core/build.rs: refuse a detector archive built by another rustc, in plain words
The archive links only against the exact rustc that built it; a mismatch
used to surface as pages of undefined std symbols from the linker. The
detector repo now writes rustc-version.txt next to the archive (and ships it
with the release); when it is present, build.rs compares it with its own
compiler and names both versions.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* build:extension: ship the wasm-core extension shell and vendor its detector from the detector release
`bun run build:extension` was broken on this branch: it still imported the
deleted JS engine (cli/engine/registry/antipatterns.mjs,
scripts/lib/browser-detector-bundle.js).
The shipped shell now matches the new design. The content script only
snapshots the DOM; an extension-owned offscreen document runs the
WebAssembly rule core over that snapshot, so the scanned page's CSP no
longer matters. That replaces the old approach of injecting a JS rules
bundle into the page. New files: extension/offscreen/offscreen.html, plus
the "offscreen" permission and a 'wasm-unsafe-eval' extension_pages CSP in
the manifest.
The manifest version stays at 1.3.3. The shell's own manifest carried
2.0.0; feature branches never bump versions, so the bump is a release step.
The five generated detector pieces (core.js, core_bg.wasm, snapshot.js,
overlay.js, antipatterns.json) are vendored at build time into the
gitignored extension/detector/ by the new scripts/lib/detector-bundle.mjs,
which resolves them the same three ways crates/core/build.rs resolves the
native archive: IMPECCABLE_DETECTOR_LIB/extension-detector/, the
~/.impeccable/detector/<DETECTOR_VERSION>/ cache, then a checksum-verified
download of detector-browser-bundle.zip from the detector release.
antipatterns.json is no longer regenerated here.
The zip packaging is unchanged. The Firefox variant still builds so
`web-ext lint` keeps covering the shared shell, but it cannot scan: Gecko
has no chrome.offscreen API. The build prints a one-line warning saying so.
Also here: a referenced-path check that fails the build when the manifest
or the service worker points at a file that is not in extension/, a
resolver unit test wired into the core suite, and the detector rule count
in the READMEs synced to the 61 the vendored registry carries.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* oracle: replay byte-for-byte on Linux too
The corpus was recorded on macOS and eight cases failed on ubuntu CI for
reasons that were all environment, not behavior:
- stageWorkspace returns the realpath of the staged dir. macOS's tmpdir is a
symlink and two goldens (context-dir-override, live-accept-source-locked)
had recorded that artifact; both re-recorded, reviewed in DELTAS.md. The
source-locked case now actually exercises the lock it is named for.
- context-lowercase-product-name declares platforms: ['darwin', 'win32'];
run.mjs skips such cases elsewhere and says so in the summary.
- The hook-project workspace's empty provider skill folders (.claude,
.cursor) are now tracked with .gitkeep; git cannot track empty
directories, so a fresh checkout had none and hooks on found nothing to
repair.
- crates/live's read_dir_raw sorts entries by name: the goldens hold the
order macOS returned, Linux returns hash order, and the source-candidate
lists in live-commit output depended on it.
macOS: 795 pass, 0 fail. The Svelte accept cases additionally need the
public repo's node_modules on the machine that runs them (CI now installs
them).
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* oracle: mask <HOME> only at path boundaries (a short home like /root ate 'roots.json')
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* oracle: track live-html's dist/generated.html (the root dist/ ignore hid it from CI checkouts)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* release-engine: darwin-x64 builds on macos-14 (macos-13 is retired)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Open the detector: the rule crates join the workspace, the C-ABI goes away
The detector is open source. The rules it ships were already public in this
repo's git history and in every npm tarball of the JS engine, so a closed
binary bought nothing it could keep; the moat is the service (the catalog,
the labs, the review pipeline), not the check functions. Keeping them behind
a prebuilt archive cost a C-ABI, an exact toolchain pin, a build-time
download, a second release to order ahead of every engine release, and a
serde layer that had to serve two encodings.
Deleted
- crates/core/src/ffi.rs, crates/core/build.rs, crates/core/tests/boundary.rs
and the shim modules under src/checks and src/browser.
- crates/foundation/src/boundary.rs and the postcard dependency.
- DETECTOR_VERSION, scripts/check-detector-release.mjs and its test, the
check:detector-release script, the detector gate and
IMPECCABLE_SKIP_DETECTOR_CHECK in scripts/release.mjs.
- scripts/lib/detector-bundle.mjs and tests/detector-bundle.test.mjs (the
vendoring path for the closed browser bundle).
- scripts/build-browser-detector.js and the build:browser script (a stub
since the JS engine left the tree).
- xtask's detector-archive subcommand and its public-repo lookup.
Came back
- crates/core is now the rule logic itself: every check_* / scan_*, the
browser adapters, the visual-contrast decisions. It re-exports foundation
as before, so no consumer changed. Its vectors dispatcher is the union of
both id tables again, and tests/vectors.rs replays the frozen vectors
straight through it.
- crates/wasm and crates/xtask join the workspace. cargo xtask bundle builds
the in-page bundle from browser-bundle/ plus the wasm core, writes
dist/, refreshes the tracked crates/live/assets/detect-antipatterns-
browser.js, and writes extension/detector/. bun run build:extension runs
it instead of downloading.
- crates/live/assets/detect-antipatterns-browser.js is tracked again; live
mode embeds it and serves it as /detect.js.
- Serde is back to plain derives: no is_human_readable branch in
js::json_number, derived Serialize for Rgba and BrowserFinding with their
skip_serializing_if attributes.
- profile.release has lto = "fat" again; rust-toolchain.toml is plain
stable plus the wasm32 target. The rust, rust-windows and oracle CI jobs
lose continue-on-error and can be required.
Verified
- cargo build --workspace --all-targets: clean, no warnings.
- cargo test --workspace: 346 pass, 0 fail (the 8 boundary tests are gone
with the boundary).
- cargo build -p impeccable-wasm --target wasm32-unknown-unknown --release: ok.
- cargo xtask bundle && cargo xtask bundle --check: reproducible; the
regenerated bundle is committed (it differs from the archived one, which
was built with a pinned rustc and lto = false).
- cargo build --release -p impeccable: no linker warnings, 12.5 MB (the
same source at lto = false is 13.1 MB).
- oracle: 795 pass, 0 fail, 0 accepted deltas, 0 missing goldens.
- bun run build, bun run build:extension, web-ext lint (0 errors,
8 warnings), bun run test: 363 + 80 + 1 + 1 + 133 + 180 + 4 pass, 0 fail.
- impeccable detect --no-config --json tests/fixtures/antipatterns: 128.7 ms
median of 5.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* core: doc comments drop the open/closed split
The rule crate and the foundation crate are both Apache-2.0 in one
workspace now, so "open", "closed" and "crosses the boundary" no longer
describe anything. Comments only.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Rule packs: downstream crates add rules on all three engines; wasm detect surface
A crate that depends on this workspace can now add rules without forking
it. `impeccable_core::rule_pack::RulePack` (object-safe, Send + Sync +
Debug) carries a pack's registry rows plus three hooks that default to
empty: `check_text` for the text engine, `check_element_dom` and
`check_page_dom` for the browser driver. `impeccable_html::StaticRulePack`
adds `check_document` for the static engine, where the document model
belongs to the html crate and detect cannot name it.
The registry keeps ANTIPATTERNS as the built-in list; `registry::extend`
appends a pack's rows and every lookup consults them after the built-ins,
so a pack can never shadow a built-in id (extend panics on a collision and
is idempotent per slice). `all_antipatterns()` is the built-ins followed by
the registered rows.
Hook order, chosen so built-in output cannot move:
- detect_text: after every matcher, analyzer and the dedupe, before inline
ignores, so `impeccable-disable` waives pack rules like built-in ones.
- detect_html_source: after the element rules, the design-system merge and
the page passes, again before inline ignores. One pack pass per HTML
file: the document hook when set, otherwise the text hook over the raw
source, so a pack implementing both never reports twice.
- collect_browser_findings: the element hook at the end of the per-element
loop through the same disabled-rules filter and group, the page hook
after every built-in page pass with the same el-or-body attribution.
A pack travels on TextOptions / ScanOptions, DetectHtmlOptions
(static_rule_pack plus rule_pack), StaticHtmlEngine, and BrowserConfig
(serde-skipped: a pack is a Rust value, not JSON from the page). The
shipped binary installs none.
`crates/wasm --features detect` exposes the two file engines as JSON
exports for hosts that cannot exec the binary: `detect_text_json` and
`detect_html_source_json`, options `{ inlineIgnores?, designSystem? }`,
returning the findings array `detect --json` prints. `antipatterns_json`
now includes a pack's rows. `set_rule_pack` and `set_static_rule_pack` are
Rust-only, for a crate that links this one as an rlib.
Tests: registry extension and collision in foundation, one test pack per
engine (crates/core, crates/detect, crates/html tests) proving each hook
fires, that the built-in findings are unchanged, and that the waivers and
the disabled-rules list cover pack rules, plus the wasm export shapes.
Workspace tests 346 to 361, oracle 795/0 unchanged.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* docs: the cutover checklist under the open design
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* bundle: the page JS and the bundler become a library crate downstream packs can reuse
The in-page bundle, the extension pieces, the registry JSON and the
wasm-pack call were reachable only through `cargo xtask bundle`, which read
`browser-bundle/*.js` from the repo root. A downstream crate that links
impeccable-core + impeccable-wasm with its own rule pack had to copy the
page JS to produce a detector bundle for its module.
They move to `impeccable-bundle` (crates/bundle), which embeds every
`browser-bundle/*.js` with `include_str!` and exposes `in_page_bundle`,
`extension_pieces`, `registry_json`, `check_capture_contract` and
`wasm_pack_build`. Nothing writes files or exits the process; the caller
places the bytes. `registry_json` now reads `all_antipatterns()`, so an
installed pack's rows land in `antipatterns.json` too (no built-in change).
xtask becomes the workspace's caller and writes the same files to the same
places; `cargo xtask bundle` is byte-identical, tracked live asset included.
`IMPECCABLE_BUNDLE_SKIP_WASM_PACK` is the skip switch's new name, the old
`IMPECCABLE_XTASK_SKIP_WASM_PACK` still works.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* The immediate tier moves to the registry, and reaches wasm
The design hook's immediate-tier list is the set of rule ids worth fixing
at the edit site, and a downstream reviewer wants the same set to decide
how loudly a finding is reported. `impeccable-hook` is native-only, so the
list moves to `impeccable_core::registry` (the hook re-exports it) and the
`detect` feature gains `immediate_tier_rules_json()`.
The export is behind `detect`, which the in-page bundle does not build, so
the tracked browser asset is unchanged.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* docs: Pristine tracks the engine by revision pin, not npm
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* docs: the cutover checklist is maintainer-side, not part of the tree
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: Fix flat type hierarchy false positives (#702)
Upstream sha 84728e9ce4.
The rule now reads rendered semantic roles and the dominant size per role
instead of the raw set of font sizes on the page, and it fires only when
every adjacent role step is under 1.25x.
- crates/core checks::rules gains TYPE_HIERARCHY_SELECTOR / MIN_ROLES /
MIN_STEP_RATIO, typeHierarchyRole, dominantTypeRoleSize and
checkFlatTypeHierarchySamples, the shared half of checks.mjs.
- crates/core browser::page_checks gets checkFlatTypeHierarchyFromDoc over
the Dom trait, with the overlay skip selector checkTypography passes.
- crates/html page.rs gets the same walk over StaticDocument.
- crates/detect drops the source-only analyzer: flat-type-hierarchy leaves
REGEX_ANALYZERS, the text-content analyzers shift to index 1, and
analyzer_rule_id loses its first row.
- crates/html cascade defaults gain contentVisibility, and crates/foundation
registry carries the reworded description.
Goldens re-recorded (the binary now matches origin/main's JS engine on every
one of these fixtures, verified by scanning the shared corpus with both):
glow, icon-tile-stack, layout, modern-color-borders, motion,
named-color-borders, numbered-section-markers, oklch-neon-text,
typography-should-flag, json and text.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: Fix detector URL scans and advisory handling (#709)
Upstream sha fa44839f72.
Advisory handling. `severity` becomes the canonical registry field: the
`advisory` bool leaves `Antipattern`, `advisory_rule_ids` filters on
`severity == "advisory"`, and `derive_advisory_flag` stamps the finding's
`advisory: true` from the effective severity, so a per-finding promotion or
demotion carries the flag. The html and browser engines call it after their
severity override; the detect CLI and the hook accept either spelling; the
driver's serializer and the wasm registry exports derive it the same way.
em-dash-overuse moves from `advisory: true` to `severity: "advisory"`.
URL scans. `expand_joined_url_targets` splits an argv value that is entirely
whitespace-separated URLs and leaves paths with spaces alone. The browser
driver reads the readable linked-stylesheet corpus into the HTML pattern
corpora and resolves a finding's selector with `selector_nodes_for_live_dom`
/ `pseudo_element_host_selector`, so an unresolvable selector drops the
finding instead of keeping it page-level. The CSSOM walk itself is page JS:
`browser-bundle/15-snapshot.js` gains `__snapLinkedStylesheetText` (grouping
rules flattened, container-query probes, effective keyframes) and puts it in
the snapshot as `linkedCss`; `10-probe.js` exposes the same for the in-page
route, and the Dom trait carries `linked_stylesheet_text`.
Also `enclosing_css_selector` blanks comments before hunting the previous
declaration delimiter, and `check_typography` reports the uniquely most-used
family instead of every family over a 15% share.
Verified: `impeccable detect --no-config --json tests/fixtures/antipatterns`
is now byte-identical to `node cli/bin/cli.js` on an origin/main worktree
over the shared corpus (432 findings). The two changed lines in
tests/oracle/vectors/calls/rules.checks/checkHtmlPatterns.jsonl were
re-recorded by running origin/main's `checkHtmlPatterns` over the frozen
args; only the comment-polluted selector changed. Goldens re-recorded for
the advisory partition (config-*, fixture gemini/gpt-tells,
numbered-section-labels, scoped-ignore, shape-assembled-illustration,
color, em-dash-entities) and the help text, each cross-checked against the
JS on origin/main.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: stop gray-on-color false positives on Tailwind opacity and JSX (#707)
Upstream sha 32b270f4e8.
`find_solid_chromatic_bg` replaces the bare `bg-<hue>-<n>` match in both
engines: a `bg-blue-500/10` tint is a wash, not a solid fill. The `regex`
crate has no lookahead, so the maximal digit run plus the word boundary is
matched as before and the byte after it is tested for `/`.
The text engine gains the JS-source scanner (`scan_js`) and the scope
helpers on top of it: `containing_markup_tag` keeps a gray text class from
pairing with a background in a sibling tag on the same line, and
`find_ternary_split` / `exclusive_class_scopes` split a `cond ? a : b`
class expression into its arms, recursing into nested ternaries, ignoring
`?.` and `??`, and keeping a common prefix and post-ternary suffix in every
arm. `MatchCtx` now carries the match offset the scope lookup needs.
Verified against origin/main's JS: all eleven cases from the upstream test
file plus a nested / nullish / suffix set produce byte-identical findings on
both engines; they are pinned as Rust unit tests in `regex_matchers` and
`checks::rules`. The shared fixture corpus stays byte-identical.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: resolve unique --target names in monorepos (#706)
Upstream sha 8b326fc81e.
`resolve_target_path` / `find_unique_bare_target` in `crates/context`: a
`--target` that does not exist and reduces to a single path segment under
cwd resolves to the one workspace candidate with that name, so `--target a`
selects `apps/a`. A caller that already absolutized the name against cwd
(live and the other helpers do) takes the same route. Ambiguous or unknown
names still report the miss.
The context CLI resolves the target once and hands the resolved path to
`load_context`, replacing `path_exists_for_target`.
Oracle: four new `context-monorepo-target-bare-*` cases (bare name,
absolutized bare name, unknown name, bare name from a child cwd).
`context-monorepo-target-b-inherits` was re-recorded: resolving the target
before `load_context` changes its `surfaceBriefReason` from `not-found` to
`invalid-target`, which is what origin/main's `context.mjs` prints for the
same run.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: Fix Next.js 16 CSP and parent hook discovery (#710)
Upstream sha 672ca29642.
CSP. `detect-csp` recognizes Next.js 16's `proxy.{ts,js,mjs}` request hook
beside `middleware.*`, but only where it sits at a project root or its `src/`
directory: the scan root itself, or a nested directory carrying a Next
project marker (a `next.config.*`, an `app` / `pages` dir, or a `next`
dependency). A same-named helper elsewhere in the tree is not the framework
hook.
Context. `find_git_boundary_root` gives `resolve_project` a git-boundary
notion: an explicit target inside its own repository resolves against that
repository, and an external target resolves against its own root, so caller
context never leaks across the boundary. `hook_manifest_search_roots`
replaces the cwd/projectRoot/repoRoot triple with a walk up from the
project root that stops at the first git boundary, and each root's own hook
lifecycle config is honored before its manifest counts as coverage.
Verified against origin/main's JS: nine `detect-csp` placements and five
hook-discovery scenarios (enclosing harness root, that root disabled,
sibling target, nested git target, markerless nested git target) produce
identical output.
Oracle: five `csp-proxy-*` cases and five `context-hook-*` /
`context-markerless-nested-git-target` cases. Four route-target goldens were
re-recorded because #710 resolves a `/`-prefixed target outside the
workspace; each was cross-checked against origin/main, and
`surface-brief-write-route` has a DELTAS entry for the one wording
difference (an unwritable filesystem root).
`tests/framework-fixtures.test.mjs`'s new proxy-placement block came in from
the merge importing the deleted `detectCsp`; it now drives `detect-csp`
through the binary like the rest of that file.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: fail URL scans when the browser is unavailable (#711)
Upstream sha f2f9958be1e6a4ecb1fbd5ef1ae1b7d9c53e0d24 (Fix: fail URL scans
when the browser is unavailable).
`detect` gains an operational-failure flag. Exit 1 now means at least one
requested target could not be scanned, and it takes precedence over exit 2,
because findings from the targets that did scan do not turn a partial scan
into a complete one. The flag is set by an unreachable path, an unreadable
directory or file in a dir walk, a per-file scan that throws, a URL scan
that throws, and a shared-browser setup failure.
- `walk_dir_reporting` and `build_import_graph_reporting` take a read-error
callback; the plain wrappers stay for callers that do not report. A file
the graph could not read is skipped for the scan too.
- `SharedBrowser::ensure_launched` is the eager half of
`createBrowserDetector()`: the CLI brings the browser up before the loop so
a launch failure prints one `Error:` line and every URL target is skipped,
instead of the lazy launch reporting once per URL.
- The static engine and the text path spell a permission failure the way Node
does (`EACCES: permission denied, open '<path>'`), which is what
`Error: cannot scan <target>: <message>` prints.
- Usage text and docs/CLI-CONTRACT.md carry the exit-status block.
Verified against origin/main's JS: missing target, missing target alongside a
flagging file, unreadable file, unreadable file beside a readable sibling,
unreadable directory, unreadable nested directory, a clean scan, and a
browser-unavailable scan of one and of two URLs all agree on exit code,
stdout and stderr (the browser-not-found wording is the pre-existing
puppeteer-vs-discovery difference).
Oracle: `detect-missing-file` and `detect-missing-file-json` re-recorded at
exit 1, plus new `detect-missing-file-with-findings`,
`detect-unreadable-file-json` and `detect-unreadable-file-in-dir`, each
cross-checked against origin/main. `detect-help` carries the new block.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: OpenCode slash command bridge (#483)
Upstream sha 9736a9f6e9.
OpenCode does not honor `user-invocable: true` on SKILL.md frontmatter, so a
pinned skill never reaches its slash menu. `pin` now writes
`commands/impeccable-<cmd>.md` on the OpenCode command schema instead, and
skips `.opencode` in the SKILL.md loop so no unreachable
`.opencode/skills/<cmd>` is left behind. `unpin` mirrors it, marker-guarded,
and reaches both scopes even when the skill itself is gone.
`find_opencode_commands_dirs` covers the project-local dir when the project
has the skill and the user config dir when Impeccable is installed globally,
resolving that dir the way the CLI does (`OPENCODE_CONFIG_DIR` ->
`XDG_CONFIG_HOME/opencode` -> `~/.config/opencode`).
The build-tooling half of the upstream change (transformers, the OpenCode
command the build generates, `root-commands-sync`) came in with the merge and
needed no port.
Verified against origin/main's pin.mjs across seven scenarios (no harness,
project scope, user scope, a foreign command file, pin then unpin, unpin over
a foreign file, unpin with nothing pinned): identical stdout, identical file
sets, identical file contents apart from the one deliberate difference.
Oracle: five `pin-opencode-*` cases, with a DELTAS entry for the bridge body
naming the launcher rather than `node .../context.mjs`.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: Fix Codex skill version metadata (#703)
Upstream sha 482368511a.
Codex's validator rejects unknown top-level keys, so the Codex and `.agents`
skills now carry `version` under the spec-defined `metadata:` map. Both
version readers learn the same parser: `parse_skill_frontmatter_version` in
`crates/context` (the boot update check) and `extract_version` in
`crates/skills` (`getSkillsVersion`). A metadata version wins, a legacy
top-level one still reads, only the map's own indent level counts, tabs count
as two spaces, and a comment line is skipped.
The build-tooling half (`versionInMetadata` on the two providers, the YAML
emitter's nested-object branch) came in with the merge.
Fourteen frontmatter shapes were recorded from origin/main's
`parseSkillFrontmatterVersion` and pinned as unit tests in both crates.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: Fix skill subcommand help handling (#708)
Upstream sha a264199177.
`install`, `link`, `update` and `check` render static help before entering
any operational path, through both the top-level verb and the legacy `skills`
namespace, for `--help` and `-h` alike.
Verified against origin/main's `cli/bin/cli.js`: all six spellings produce
identical text and exit codes.
Oracle: a new `tests/oracle/cases/skills.mjs` with seven help cases. Only the
help paths are pinned there; every other installer path writes into harness
directories or reaches the network.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Oracle: goldens for the three fixtures the merge added
`tests/fixtures/antipatterns/` gained `flat-type-hierarchy.html` (#702) and
`linked-url-patterns.{css,html}` (#709) with the merge, so the corpus
generator produced six `detect-fixture-*` cases with no goldens and the
directory-wide cases (`detect-dir-*`, `detect-scope-*`, `detect-no-advisory-*`)
moved.
Every golden here was recorded from the binary and then cross-checked against
`node cli/bin/cli.js` on an origin/main worktree over the same files: the six
per-fixture cases agree byte for byte in JSON and text, and a full scan of
`tests/fixtures/antipatterns` produces 432 findings identical on both engines
after normalizing the repo path.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Port: the installer half of the OpenCode command bridge (#483)
Upstream sha 9736a9f6e9, the part of it that
lives in `cli/bin/commands/skills.mjs` rather than `pin.mjs`.
`copy_provider_commands` mirrors `copy_provider_skills` for a provider's
compiled `commands/` dir: project scope writes `<root>/<configDir>/commands`,
user scope writes the config dir OpenCode actually scans
(`OPENCODE_CONFIG_DIR` -> `XDG_CONFIG_HOME/opencode` -> `~/.config/opencode`),
and a pre-#406 global install at `~/.opencode/commands/` loses exactly the
files just written while siblings, symlinked dirs and home-rooted git repos
are left alone. It runs on install, on the reinstall refresh, on update, and
on link, which is the only path that can deliver the bridge to a linked
install.
`is_up_to_date` now compares the bundle's command files too, so an install
whose skills match but whose bridge is missing or drifted refreshes instead of
reporting success while the slash command stays absent. Only bundle-shipped
files are compared, so a pinned shortcut never affects freshness.
`tests/copy-provider-commands.test.js` arrived with the merge importing the
deleted `cli/bin/commands/skills.mjs`; its scenarios are ported to
`crates/skills/tests/provider_commands_tests.rs` (project scope, the three
user-scope dir resolutions, the legacy migration and its two guards, a
provider with no commands dir, and the four `isUpToDate` command-awareness
cases), and the file is removed and deregistered.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* CI: the first full run on the branch, three fixes
- The oracle harness masks the climb to the root a /-prefixed target
produces (<UP_TO_ROOT>/): the number of `../` is the staged tmpdir's depth
(7 on macOS, 2 on Linux), not the verb's behavior. surface-brief-path-slash
re-recorded.
- Two context test helpers canonicalized their temp dir, which on Windows
yields a \\?\ verbatim path that takes `/` literally; they strip the prefix
like Node's realpathSync. The critique-storage identity test compares
against the platform's own resolved path.
- Every job that drives the binary end to end (live-e2e smoke and full,
accept-cleanup, the DeepSeek sweep, the remote CLI smoke) builds it from
the checkout first; before, they looked for a release that does not exist.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* context tests: the verbatim-prefix strip spells the prefix once
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* context test: derive the snapshot identity from the verb's own resolver
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* context test: JSON-quote the snapshot identity, as the verb does
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* detect test: import resolution against platform-form paths
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* hook test: the stock cache path in the host's path form; Windows CI runs every crate's tests before failing
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: skills tests pass on Windows
The two test temp roots kept `canonicalize`'s `\\?\` verbatim prefix, and the
kernel takes a verbatim path literally, so every `/`-joined path built under
them was an invalid filename. Strip it the way Node's `realpathSync` does.
The manifest, artifact and sibling-binary expectations hard-coded POSIX
separators for paths the product joins with the host's semantics; derive them
from `jsp::join` instead.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: hook tests pass on Windows
Same verbatim-prefix strip on the test temp roots, plus expectations derived
from the helpers the product uses: cache keys and scan targets from
`jsp::join`, the config path in an admin message from the same relative form
`path.relative` renders, and the footer hints from `quote_command_arg`, which
deliberately switches to the double-quoted Windows form (#476 / #533). The
env lock no longer poisons the sibling tests when one of them fails.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: html oracle goldens compare on Windows
The goldens pin the `<REPO>`-masked fixture path recorded on POSIX. Mask, then
render the remainder with `/` so a Windows checkout's backslashes are not read
as a finding difference. The goldens are untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: widen the live read-deadline test's margin
Timing only. The watchdog polls in 50ms steps against a ~15.6ms Windows system
timer while the crate's tests run in parallel, so the later request takes its
turn later there. The bound stays far under the 60s read timeout a
deadline-less read would hold the ticket for, so the test still distinguishes
the fix from the regression.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: the request read deadline was not enforced on Windows
Windows does not unblock a `recv` already parked in the kernel when another
thread calls `shutdown` on the same socket, so the watchdog could not end a
silent connection's read and it held its turnstile place for the whole 60s
header timeout instead of the 10s deadline. Bound the read at the socket too,
which enforces the same deadline everywhere; the watchdog stays as the backstop
for a connection that trickles bytes without ever completing a request. POSIX
behavior is unchanged: the watchdog already closed the socket at the deadline.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: hook tests derive the rest of the host path forms
The test temp helper's `write` returned a `PathBuf::join` result, which keeps
the `/` inside the relative part and so does not match what the hook resolves a
relative target to on Windows. Three more admin messages and the cache-root slug
pinned the POSIX spelling of paths the product renders with the host's
semantics (`path.resolve` also prefixes the current drive there).
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: skills test fixtures name USERPROFILE, and the win32 quoted form
`os.homedir()` reads USERPROFILE on Windows, so a fixture home that named only
HOME sent the global installs into the runner's real profile. The Windows hook
command carries the JSON-quoted path, so a host path's backslashes arrive
escaped; derive the expectation instead of pinning the POSIX spelling.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: check the oracle fixtures out with LF
A finding's snippet carries the scanned file's own bytes, and the goldens were
recorded from a POSIX checkout, so a CRLF checkout of a linked stylesheet reads
as a finding difference. The goldens are untouched.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* windows: check the grok global-install manifests as JSON
The Windows hook command carries the JSON-quoted launcher path, so the path's
backslashes are escaped once inside the command and again by the manifest file
itself. Read the manifest as JSON and look for either quoting form instead of
counting escaping layers in a raw substring match.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* npm shim: refuse a download with no verifiable sidecar
The skill launcher and `impeccable install` both fail closed when a
release binary's `.sha256` sidecar cannot be fetched or carries no hash:
they refuse rather than cache an unverified binary. The npm shim did not.
It only compared when a hash was present, so a 404, an empty sidecar, or
a truncated one all wrote the payload straight into
`~/.impeccable/bin/<version>/` and exec'd it.
It now refuses in the same cases, with wording that matches the launcher,
and writes nothing until the hash matches, so a refusal leaves the cache
dir empty. IMPECCABLE_BIN and the optional-dependency lookup are
untouched: neither downloads.
tests/cli-shim.test.mjs runs the real shim against a throwaway HTTP
server and covers missing, empty, and mismatched sidecars, plus the
matching-sidecar and IMPECCABLE_BIN paths. The two refusal cases fail
against the old shim.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Oracle fixture: declare the vite plugin the web workspace imports
`live-workspaces/apps/web/vite.config.js` imports `@vitejs/plugin-react`
but the workspace's package.json listed only `vite`. No oracle case
installs or evaluates that config (the three `live-boot-workspaces-*`
cases stop at root resolution), so the fixture was never wrong at
runtime, only self-contradictory to read. Adding the devDependency keeps
the goldens byte-equal.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Vectors: drop the 12,208 byte-identical repeat lines
The recorder deduplicated by arguments per run, not across runs, so the
frozen call snapshot arrived with 12,208 lines (43% of 28,266) that
repeat an earlier line byte for byte. Every one re-asserts what its first
occurrence already asserts, and `crates/core/tests/vectors.rs` replays
line by line with no count anywhere, so removing them changes nothing it
checks: the replay still reports 8,321 pass, 0 fail.
Duplicates were removed with `awk '!seen[$0]++'`, keeping first
occurrences and file order, and every changed file was checked to equal
that transform of its old contents. No line was added, reordered, or
rewritten, and no vector file gained or lost a distinct call. The tree
drops from 9.2 MB to 5.7 MB.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Fix: restore the live overlay's disabledValues waivers in the engine
The JS engine applied value-level ignore waivers at the tail of
collectBrowserFindings: `_disabledValues` read the entries the live
overlay resolved for the page (skill/scripts/live-browser-ignores.js
sends them as config.disabledValues), and filtered the assembled
findings by the value each one reported, with design-system-color
compared by color value rather than by spelling so a hex waiver
suppressed a finding the browser reported as rgb(...). The Rust port
dropped that stage: `disabledValues` appeared nowhere in the workspace
or in browser-bundle, so a project entry like
[detector]
ignoreValues = [{ rule = "overused-font", value = "geist mono" }]
stopped reaching the overlay. The rules the CLI and the edit hook waive
kept drawing markers and counting toward the badge.
Restore it end to end:
* BrowserConfig gains `disabled_values`, parsed leniently so a
hand-edited __IMPECCABLE_CONFIG__ entry of the wrong shape is dropped
rather than failing the whole config, the way the JS filter did.
* The driver applies the waivers after every pass, so a rule pack's
findings are covered the same way the built-in ones are, honoring the
entries only in extension mode exactly as the JS read them. The
normalizer, the value extractor (including the rule that bounce-easing
without a direct ignoreValue offers no value) and the hex/rgb color
key are ported alongside it.
* collectConfigJson in the in-page bundle and configJson in the
offscreen bundle forward the field. The extension never sends it, so
its behavior is unchanged.
Coverage: two driver unit tests (suppression by font value, by hex
waiver across the rgb spelling, and the extension-mode gate; plus the
config parse and the normalizers), a skipScan test that pins the empty
shape for every stage the core produces, and
crates/wasm/tools/disabled-values-check.mjs, a browser-backed check
ported from the retired tests/detect-antipatterns-browser.test.mjs case
that the swap left without a replacement. Against the previous bundle it
fails on exactly the three waiver assertions and passes the skipScan
one, which is the shape of the regression.
Two related review findings were checked and are not defects. skipScan
is gated on extension mode in both the driver and the bundle, which is
what the JS did (index.mjs#skipScanActive), and the live overlay runs in
extension mode: live-browser.js sets `s.dataset.impeccableExtension` on
the injected /detect.js tag, and the overlay's whole detect toggle
travels over the postMessage loop that 50-scan.js installs only under
EXTENSION_MODE. The visual contrast stage is not leaking either:
collectBrowserFindingsAsync and scan() both consult skipScanActive(),
and the offscreen path skips its visual pass on config.skipScan.
The tracked live asset is regenerated (cargo xtask bundle). The oracle
replays with zero unreviewed differences: the new field defaults empty
and the filter is inert without it, and no CLI path sets extension mode.
AI-assisted change: implemented with Claude Code under maintainer
direction.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Shim test: run from a staged copy and prove the download happened
The three fail-closed cases cleared IMPECCABLE_BIN and pointed
IMPECCABLE_HOME at a temp dir, but locate() prefers an installed
@impeccable/cli-<os>-<arch> before the cache or a download. Those
platform packages ship with every engine release and are a merge
prerequisite, so as soon as one is installed under the repo the cases
would resolve it and go green without fetching anything. Confirmed by
hand: with a platform package staged in node_modules, running the shim
against an unreachable download base still exits 0 from the package.
The shim now runs from a throwaway copy at <tmp>/cli/bin/cli.js beside a
copy of the repo's package.json, with no node_modules on the lookup path
above it, so require.resolve of the platform package fails the way it
does on a machine without the optional dependency. Production code is
unchanged; there is no test-only branch in the shim.
The fixture server also records every request now, and each download case
asserts the asset and sidecar URLs were actually requested, so a future
lookup shortcut fails loudly instead of passing on an untested path. A
sixth case installs a fake platform package next to the staged shim and
asserts the shim prefers it with the server untouched, which pins the
precedence the other cases depend on being absent.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Live: the loader now hands off when the resume is the arrival
The overlay could sit in its generating shader over a DOM that already
held all three variants, and only a page refresh cleared it (#719).
The server's generation preflight runs live-wrap with
--defer-source-write, so the wrapper and every variant reach the DOM in a
single HMR batch. The deferred-wrapper scout is constructed at init and
the variant MutationObserver at Go; observer callbacks run in
construction order, so on that batch the scout resumes first and
resumeSession, not the observer, is the transition into CYCLING. It set
the state and the bar but never called hideShaderOverlay(), so the frozen
capture of the original stayed painted over the variants. It also
reported browser_resumed, which does not count as publication progress,
and then disconnected and re-created the observer, dropping the records
that observer had already queued for the same batch, so variants_ready
never fired at all.
resumeSession now finishes the same transition the observer does (shader
down, inline edit off, insert session finalized, params panel rebuilt)
and reports variants_ready when it already holds every variant. The
deferred scout names itself in the journal as
browser_resumed_deferred_wrapper, so the two resume paths are no longer
indistinguishable.
Wrapper resolution goes through findVariantsWrapper, which prefers a
wrapper that actually holds non-original variants. A target inside a
.map() renders one wrapper per item, and an agent that relocates the
wrapper out of the shared primitive live-wrap scaffolded leaves an empty
one behind; first match could pin either and strand the session at 0/N.
With zero or one match this is the querySelector it replaces.
Tests: waitForCycling now asserts the generating shader is gone once the
bar cycles, across every runtime fixture (it failed on vite8-react-plain
before this change and passes after), marked no-retry so the reload
recovery cannot hide it. Source-shape tests pin the transition, the
variants_ready report, and the wrapper preference.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Live server: stop ends the process, SSE skips the mutation lane
Two Rust-only regressions found while investigating #719, both of which
can leave a tab waiting on a broadcast that never comes.
/stop ran shutdown() but never set shutting_down, and the accept loop
only breaks on that flag or a signal, so a stopped server kept its port
and kept answering while its server.json was already deleted. The next
`impeccable live` then booted a second server on another port and a tab
could reattach to the zombie. Node's shutdown() ended in process.exit(0).
The flag is now set after the response is written, so `stop` still reads
"stopping" instead of a reset connection, and the accept loop (already
non-blocking) exits on its next pass.
GET /events took a turnstile ticket and waited its turn before
registering, even though handle_sse releases that ticket two statements
later and needs no arrival ordering. A peer that stalls mid-request holds
the lane for the whole READ_REQUEST_DEADLINE, so a reconnecting stream
could sit unregistered for up to 10 seconds (measured 9.71s against 0.00s
on Node); broadcast is fire-and-forget, so a `done` landing in that
window reaches an empty client set and is gone. Registering early can
only make a stream see more broadcasts. The one cost is that the
connected frame's activeSessions snapshot may miss a mutation still in
flight, and the browser treats that snapshot as a hint. Preflights still
take a turn: answering those out of order reorders the POSTs the browser
issues behind them.
The route classification moved into releases_ticket_up_front so it can be
unit tested. tests/live-server-leak.test.mjs gains a guard that a stopped
server's pid is gone and its port is free.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Live: the shader teardown can no longer race its own construction
The new cycling assertion caught a real defect on CI: vite8-react-insert
reached CYCLING with #impeccable-live-shader still painted over the page.
showShaderOverlay is async. It appends its canvas synchronously, then
awaits createImageBitmap and finishes the GL setup before it publishes
shaderState. hideShaderOverlay returned early on a null shaderState, so a
teardown that landed inside that window did nothing, and the construction
then published itself over a session that had already left GENERATING,
with no teardown left to run. The scroll tick kept repositioning it,
which is why the CI page.html shows the canvas sized from the capture
rect but styled to the cycling anchor.
Every teardown now bumps a shader epoch before it does anything else, and
a construction pins the epoch it owns and abandons its canvas (releasing
the GL context) at every point past an await and before any publish,
including both bitmap-fallback publishes. A teardown also drops a shader
node that no shaderState owns, so an already-orphaned canvas cannot
survive one.
Reproduced by widening the append-to-publish window: with a 400ms delay
after uiAppend, vite8-react-insert failed with the CI error and the probe
showed the teardown arriving at CYCLING with shaderState still null.
The same run passes with this change, as does a 1500ms window on insert
and plain. Locally that window is about 4ms, which is why it only showed
on a slower runner.
The four remaining setLiveState('CYCLING') sites that did not lower the
loader now do: the SSE done handler (the one route that can reach CYCLING
from GENERATING), the Svelte republish remount, and the two accept
failure recoveries.
The e2e assertion already waits up to 5s for the shader to clear, so it
was never racing a legitimate teardown; it is left as it is.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Live: every active-session wrapper lookup goes through the resolver
Cursor Bugbot on #720: findVariantsWrapper alone was not enough.
resolveBarAnchor, the visible-variant element, mountedParameterCount,
readVisibleVariantFromDOM, showVariantInDOM, the source injection, and
the whole accept path still took the first [data-impeccable-variants]
match, so in the relocated-wrapper case Tune never bound and the bar kept
anchoring to the empty scaffold even after the resume reached CYCLING.
Thirteen call sites now resolve through findVariantsWrapper. The resolver
split in two so a missing id cannot silently widen the lookup to any
session: findVariantsWrapper(sessionId) returns null without an id, and
findAnyVariantsWrapper() is the entry point for the two resume paths that
have no id yet. Both share pickPopulatedVariantsWrapper, which is the old
querySelector whenever there are fewer than two matches.
Discard cleanup now hides every duplicate wrapper rather than the first,
since a target inside a `.map()` renders one per item and hiding one left
the rest of the discarded variants on screen.
What still takes a raw first match is deliberate: bare existence checks,
selector strings for stylesheets and observers (which want to cover every
match), querySelectorAll sweeps, the parsed source document, and the
Svelte component wrapper, which holds no variant children at all. The
source-shape test pins that exact set by name, so a new raw lookup fails
until it is either routed through the resolver or justified there.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Live: a discard releases every wrapper it hid
Bugbot on #720: the non-restoreOriginal discard now hides every matching
wrapper, but the delayed fallback still released only the first
querySelector hit. A target inside a `.map()` renders one wrapper per
item, so the rest stayed at display:none and their original content never
came back on the static and missed-HMR flows that fallback exists for.
The hide, the existence checks, and the release now all speak about the
same set. discardedWrappers(sessionId) is the one place that collects it;
releaseDiscardedStaticWrappers takes the stylesheet down once and
releases each wrapper; releaseDiscardedStaticWrapper drops its sessionId
argument and just unwinds the node it is given. The HMR-ownership
decision still reads the first wrapper, which is fair: duplicates all
render from one source element, so ownership is uniform across them. The
reload branch is unchanged because a reload restores every original at
once.
Covered by a source-shape test rather than an e2e scenario:
hasFrameworkHmrOwnership is true for every React, Vue, and Svelte runtime
fixture, so all of them take the watcher path and none can reach the
static release. The existing framework-ownership guards in the same file
move to the new shape and keep their intent, including the one that says
only non-discard cleanup may blank the wrapper while waiting for HMR.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Release: publish the npm platform packages in one command
bun run release:platform-packages downloads each engine-v<ENGINE_VERSION>
binary with its .sha256 sidecar (required; nothing unverified is
published), stages the package from cli/platform-packages/<target> with
the version stamped, the executable at bin/ and the repo LICENSE, and
runs npm publish --access public. Targets already on the registry are
skipped so a re-run resumes after a partial failure. Preconditions:
package.json pins equal ENGINE_VERSION and npm is logged in.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* release-engine: pin checkout, upload-artifact and download-artifact at v7
The v4 pins target Node 20, which the runner now deprecates and forces
onto Node 24 with a warning on every step. The rest of the workflows
already use v7.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Tests: make the temp-dir helpers unique under a coarse clock
Windows' system clock is coarse enough that two parallel tests could get
the same pid-plus-nanoseconds directory name and then remove each
other's files (rust-windows: close_verb_round_trip_and_ownership,
NotFound). A per-process counter is appended to the name.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
* Tests: declare the temp-dir counter in the hook cache-root tests
The previous commit referenced TMP_SEQ there without defining it.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vau2X53xGTjjTCXWMVBoNY
---------
Co-authored-by: Claude <noreply@anthropic.com>
287 lines
44 KiB
JSON
287 lines
44 KiB
JSON
{"args":["Should pass paragraph in centered container with 32px padding This paragraph sits inside a max-width container that's centered and has 32px horizontal padding. It does not touch the viewport edges and should not trigger the rule. paragraph inside <nav> (excluded — nav can bleed) This nav legitimately bleeds to the edges as a full-width header strip; the rule excludes elements inside <nav> or <header> so this does not flag. paragraph inside <header> (excluded — header can bleed) Banner headers commonly bleed to viewport edges with their own internal layout. The rule excludes <header> descendants. paragraph inside full-bleed section with own background This paragraph sits in a full-bleed section that has its own background-color set (intentional design move). The rule excludes paragraphs whose element has its own background-color. short label / button-ish text (excluded — < 40 chars) Short label."],"result":null}
|
|
{"args":["Rounded card with colored left border Classic side tab: border-left is thick, colored, and paired with rounded corners."],"result":null}
|
|
{"args":["Rounded card with colored right border The right-side version is the same visual trope mirrored."],"result":null}
|
|
{"args":["Thick colored side border without radius A thick chromatic side stripe still reads as a tab even without rounded corners."],"result":null}
|
|
{"args":["Rounded card with top accent border A heavy top accent on a rounded card is the horizontal variant of the same pattern."],"result":null}
|
|
{"args":["Rounded card with bottom accent border The bottom accent is also a decorative stripe on a card surface."],"result":null}
|
|
{"args":["Should flag Rounded card with colored left border Classic side tab: border-left is thick, colored, and paired with rounded corners. Rounded card with colored right border The right-side version is the same visual trope mirrored. Thick colored side border without radius A thick chromatic side stripe still reads as a tab even without rounded corners. Rounded card with top accent border A heavy top accent on a rounded card is the horizontal variant of the same pattern. Rounded card with bottom accent border The bottom accent is also a decorative stripe on a card surface. Dark card with bright side stripe Dark surfaces can hide the cliche, but the thick colored side stripe remains."],"result":null}
|
|
{"args":["Uniform full border A quiet all-around border frames the card instead of creating a side tab."],"result":null}
|
|
{"args":["Neutral structural side rule A gray structural rule can be a legitimate divider when it is not chromatic emphasis."],"result":null}
|
|
{"args":["Thin colored side rule A 1px colored rule is below the decorative side-tab threshold."],"result":null}
|
|
{"args":["Status toast with severity accent A live status region carries a colored side bar as a severity accent, not a decorative side tab."],"result":null}
|
|
{"args":["Square top border A chromatic top stripe on a card is the horizontal variant of the side tab."],"result":null}
|
|
{"args":["Selected tab underline An active-state underline inside a tablist is an affordance, not a stripe."],"result":null}
|
|
{"args":["Thick color band A band well past stripe thickness is a compositional block, not an accent stripe."],"result":null}
|
|
{"args":["Pure #000 background"],"result":null}
|
|
{"args":["Gray text on green background"],"result":null}
|
|
{"args":["Welcome to Our Platform The best solution for modern teams and businesses"],"result":null}
|
|
{"args":["Submit"],"result":null}
|
|
{"args":["SEV-2"],"result":null}
|
|
{"args":["text-gray-400 on bg-blue-500 — gray on color"],"result":null}
|
|
{"args":["Purple-to-indigo gradient"],"result":null}
|
|
{"args":["Should flag Pure black surfaces Pure #000 background Gray on color Gray text on blue background Gray text on green background Low contrast Light gray text on white — very low contrast Dark gray text on near-black — low contrast Welcome to Our Platform The best solution for modern teams and businesses Gradient text Gradient Heading AI color palette Purple heading text Styled <a> and <button> with low contrast Get started Submit Text-bearing chip with low contrast SEV-2 Tailwind color anti-patterns bg-black — pure black bg text-gray-400 on bg-blue-500 — gray on color text-purple-500 heading Purple-to-indigo gradient currentcolor surface via var() token Faint warm gray on a bone currentcolor surface"],"result":null}
|
|
{"args":["Near-white bg, near-black text — good contrast, tinted"],"result":null}
|
|
{"args":["Pure #fff background with dark text — acceptable contrast"],"result":null}
|
|
{"args":["Dark green text on green bg — same hue family"],"result":null}
|
|
{"args":["White text on image background — should not flag low-contrast"],"result":null}
|
|
{"args":["bg-black/50 — 50% opacity, not pure black"],"result":null}
|
|
{"args":["Read more about this if you want to learn more about the topic."],"result":null}
|
|
{"args":["High contrast pill"],"result":null}
|
|
{"args":["HEALTHY"],"result":null}
|
|
{"args":["tick"],"result":null}
|
|
{"args":["light text over the dark panel, not the light code surface"],"result":null}
|
|
{"args":["Light body copy on a faint accent glow that composites to near-black Muted secondary line on the same faint glow area here"],"result":null}
|
|
{"args":["Light copy on a faint mixed wash over a dark ground stays readable"],"result":null}
|
|
{"args":["Dark ink text on a bone currentcolor surface"],"result":null}
|
|
{"args":["Light text on an unknowable currentcolor surface"],"result":null}
|
|
{"args":["16px body, 4px padding, background only A colored background containment with only 4px padding around 16px body text. The colored edge feels like it's pressing in."],"result":null}
|
|
{"args":["12px vertical / 4px horizontal, 14px body Comfortable vertical padding can't fix horizontal text running right up against the side edges. Words feel like they're falling off the container."],"result":null}
|
|
{"args":["32px hero, 6px vertical / 16px horizontal padding Hero Section With Tight Vertical Padding"],"result":null}
|
|
{"args":["Should flag Cramped body in cards 14px body, 4px padding all sides This text is crammed against the border with only 4px padding. It feels claustrophobic and hard to read because the eye has nowhere to rest. 14px body, 2px padding all sides Two pixels of padding is essentially nothing — body text needs room to breathe inside its container, especially across multiple lines. 16px body, 4px padding, background only A colored background containment with only 4px padding around 16px body text. The colored edge feels like it's pressing in. Asymmetric cramping 1px vertical / 16px horizontal, 14px body Generous horizontal padding doesn't save you when the vertical padding is just one pixel. Lines stack on top of each other against the container edge. 12px vertical / 4px horizontal, 14px body Comfortable vertical padding can't fix horizontal text running right up against the side edges. Words feel like they're falling off the container. Currently missed: cramped large text 24px heading, 8px padding (passes the 8px floor but is too tight for the text size) Tight Heading Container Label 32px hero, 6px vertical / 16px horizontal padding Hero Section With Tight Vertical Padding Cramped multi-line code block <pre>, 2px padding, 14px monospace function example() { const value = \"cramped\"; return value; }"],"result":null}
|
|
{"args":["long inline code chip: compact inline code should not be treated like a padded card npx impeccable check"],"result":null}
|
|
{"args":["18px body, 12px padding (proportional) Larger body text gets proportionally more padding. 12px around 18px text feels balanced."],"result":null}
|
|
{"args":["multi-line <pre>, 12px padding, 14px font function example() { const value = \"comfortable\"; return value; }"],"result":null}
|
|
{"args":["form input: 16px font, 8px / 12px padding"],"result":null}
|
|
{"args":["gradients stop tripping the contrast rules when the glyph fill is transparent."],"result":null}
|
|
{"args":["The Tailwind form pairs bg-clip-text with bg-gradient-to-r on one element; the two utilities together are the tell."],"result":null}
|
|
{"args":[".status-dot { width: 8px; height: 8px; border-radius: 50%; animation: pulse 2s ease-in-out infinite; }"],"result":null}
|
|
{"args":["Edge-flush cards fixture (browser-only) body { font-family: system-ui, sans-serif; margin: 0; color: #1a1a1a; background: #f2f2f4; } h2 { padding: 16px 24px 0; font-size: 16px; } .scroller { width: 600px; margin: 8px 24px 24px; overflow-x: auto; display: flex; scroll-snap-type: x mandatory; background: #e4e4e8; } .panel { flex: 0 0 auto; scroll-snap-align: start; } .card { background: #fff; border-radius: 10px; height: 90px; padding: 12px; box-sizing: border-box; margin-bottom: 12px; } .plain { height: 90px; padding: 12px; box-sizing: border-box; } /* FLAG: first panel is wider than the scroller's clip box, so its cards keep a 16px left gutter but end 4px past the right clip edge. */ .flag-pager .panel-wide { width: 620px; } .flag-pager .panel-wide .card { margin-left: 16px; width: 588px; } .flag-pager .panel-ok { width: 600px; } .flag-pager .panel-ok .card { margin-left: 16px; width: 568px; } /* PASS: every panel keeps a symmetric inset. */ .pass-even .panel { width: 600px; } .pass-even .card { margin-left: 16px; width: 568px; } /* PASS: deliberate peek carousel; the third card is cut mid-card, far past the clip edge, which reads as an affordance rather than a bug. */ .pass-peek { gap: 12px; padding: 12px 0 12px 16px; } .pass-peek .card { flex: 0 0 auto; width: 260px; margin: 0; } /* PASS: flush children without card styling are plain content, not cards. */ .pass-plain .panel { width: 620px; } .pass-plain .plain { margin-left: 16px; width: 588px; }"],"result":null}
|
|
{"args":["Card cut off at the right clip edge while keeping its left gutter. Second card in the oversized panel, also flush against the edge. Sibling panel card with the intended inset on both sides."],"result":null}
|
|
{"args":["Card with an even gutter on both sides of the clip box. Second panel card, also properly inset."],"result":null}
|
|
{"args":["First peek card fully visible. Second peek card fully visible. Third card cut mid-card as a scroll affordance. Fourth card entirely off-screen."],"result":null}
|
|
{"args":["Tracking crushed pixels heading line"],"result":null}
|
|
{"args":["section: full border, padding 28px 0 0; label and pills touch the left/right border lines. Supported dev servers Vite Next.js SvelteKit Astro"],"result":null}
|
|
{"args":["card: 1px border on all sides, padding 0; heading and body touch every side."],"result":null}
|
|
{"args":["card: 1px border on all sides, padding 0; heading and body touch every side. Card flush against the borders Body copy sits flush against every visible border line."],"result":null}
|
|
{"args":["no border, but a non-transparent bg; text flush against the bg's edge counts too."],"result":null}
|
|
{"args":["no border, but a non-transparent bg; text flush against the bg's edge counts too. Title flush against the bg edge Body copy with zero padding around a colored fill."],"result":null}
|
|
{"args":["outline draws outside the box; content at the box edge sits next to the outline."],"result":null}
|
|
{"args":["outline draws outside the box; content at the box edge sits next to the outline. Title flush against the outline The outline counts as a visible boundary too."],"result":null}
|
|
{"args":["card: padding 12px 16px 12px 0; text touches the left border, other sides are inset."],"result":null}
|
|
{"args":["Should flag Border + zero side-padding section: full border, padding 28px 0 0; label and pills touch the left/right border lines. Supported dev servers Vite Next.js SvelteKit Astro All sides flush against a border card: 1px border on all sides, padding 0; heading and body touch every side. Card flush against the borders Body copy sits flush against every visible border line. Background color, zero padding no border, but a non-transparent bg; text flush against the bg's edge counts too. Title flush against the bg edge Body copy with zero padding around a colored fill. Outline (not border), zero padding outline draws outside the box; content at the box edge sits next to the outline. Title flush against the outline The outline counts as a visible boundary too. Left-side flush, other sides fine card: padding 12px 16px 12px 0; text touches the left border, other sides are inset. Title flush only on the left Padding-left zero with a full border."],"result":null}
|
|
{"args":["no bg, no border, no outline; zero padding is fine. Supported dev servers Vite Next.js SvelteKit"],"result":null}
|
|
{"args":["border-top only, padding-top 24px; no left/right border to be flush against. Supported dev servers Vite Next.js SvelteKit"],"result":null}
|
|
{"args":["card: 1px border + padding 18px 20px; comfortable inset on every side."],"result":null}
|
|
{"args":["card: 1px border + padding 18px 20px; comfortable inset on every side. Card with proper inset Body copy sits comfortably away from the borders."],"result":null}
|
|
{"args":["non-transparent bg + padding 14px 18px; content has room to breathe."],"result":null}
|
|
{"args":["non-transparent bg + padding 14px 18px; content has room to breathe. Title with inset on bg Body copy is comfortably inset from the bg edge."],"result":null}
|
|
{"args":["outline + padding 14px 18px; content is comfortably inside."],"result":null}
|
|
{"args":["outline + padding 14px 18px; content is comfortably inside. Title with inset and outline Outline boundary with proper inset works."],"result":null}
|
|
{"args":["card: padding 0, border all sides; no text means nothing can be flush."],"result":null}
|
|
{"args":["card: parent padding 0, but text children have margins that create visible inset."],"result":null}
|
|
{"args":["card: parent padding 0, but text children have margins that create visible inset. Title inset by child margin Body copy is not visually flush even though the parent has zero padding."],"result":null}
|
|
{"args":["card: parent padding 0, but an inner shell is offset from every edge. Title inset by inner shell The direct child creates the breathing room."],"result":null}
|
|
{"args":["child padding 0, but it has the same background as the parent, so no child boundary is visible. Same-surface visual shell The text belongs to the parent surface, not to a distinct zero-padding card."],"result":null}
|
|
{"args":["marquee shell clips animated cards intentionally; the cards, not the shell, own text padding. Quote card with its own comfortable padding. Another moving card, also padded inside."],"result":null}
|
|
{"args":["Blue glow box-shadow: 0 0 20px rgba(59, 130, 246, 0.4)"],"result":null}
|
|
{"args":["Purple glow box-shadow: 0 0 25px rgba(139, 92, 246, 0.35)"],"result":null}
|
|
{"args":["Cyan glow box-shadow: 0 0 15px rgba(6, 182, 212, 0.5)"],"result":null}
|
|
{"args":["Blue glow box-shadow: 0 0 20px rgba(59, 130, 246, 0.4) Purple glow box-shadow: 0 0 25px rgba(139, 92, 246, 0.35) Cyan glow box-shadow: 0 0 15px rgba(6, 182, 212, 0.5) Multi-shadow with colored glow Normal shadow + purple glow combined."],"result":null}
|
|
{"args":["Inline pink glow Inline style for regex detection path."],"result":null}
|
|
{"args":["OKLCH glow box-shadow: 0 0 18px oklch(0.72 0.15 195 / 0.5)"],"result":null}
|
|
{"args":["Hex glow box-shadow: 0 0 16px #3b82f6"],"result":null}
|
|
{"args":["HSL glow box-shadow: 0 0 22px hsl(280, 80%, 60%)"],"result":null}
|
|
{"args":["Glow via var() box-shadow: 0 0 10px var(--fixture-glow)"],"result":null}
|
|
{"args":["OKLCH glow box-shadow: 0 0 18px oklch(0.72 0.15 195 / 0.5) Hex glow box-shadow: 0 0 16px #3b82f6 HSL glow box-shadow: 0 0 22px hsl(280, 80%, 60%) Glow via var() box-shadow: 0 0 10px var(--fixture-glow) Glowing text text-shadow: 0 0 12px #22d3ee on the heading."],"result":null}
|
|
{"args":["Chromatic halo on light page box-shadow: 0 0 20px oklch(0.65 0.2 300 / 0.45)"],"result":null}
|
|
{"args":["Halo over photo background box-shadow: 0 0 26px rgba(217, 70, 239, 0.5)"],"result":null}
|
|
{"args":["Should flag CSS colored glows on dark background Blue glow box-shadow: 0 0 20px rgba(59, 130, 246, 0.4) Purple glow box-shadow: 0 0 25px rgba(139, 92, 246, 0.35) Cyan glow box-shadow: 0 0 15px rgba(6, 182, 212, 0.5) Multi-shadow with colored glow Normal shadow + purple glow combined. Inline-style glow (regex path) Inline pink glow Inline style for regex detection path. Modern color formats, var() refs, text-shadow OKLCH glow box-shadow: 0 0 18px oklch(0.72 0.15 195 / 0.5) Hex glow box-shadow: 0 0 16px #3b82f6 HSL glow box-shadow: 0 0 22px hsl(280, 80%, 60%) Glow via var() box-shadow: 0 0 10px var(--fixture-glow) Glowing text text-shadow: 0 0 12px #22d3ee on the heading. Zero-offset halo on LIGHT background Chromatic halo on light page box-shadow: 0 0 20px oklch(0.65 0.2 300 / 0.45) Zero-offset halo on unreadable (image) surface Halo over photo background box-shadow: 0 0 26px rgba(217, 70, 239, 0.5) Colored glow under an opaque gradient over an image (browser) Opaque dark gradient covers the photo box-shadow: 0 6px 22px rgba(249, 115, 22, 0.5)"],"result":null}
|
|
{"args":["Colored shadow on light background Not dark mode, colored shadow is fine."],"result":null}
|
|
{"args":["Normal gray shadow on dark card Gray/black shadow is not a glow."],"result":null}
|
|
{"args":["Focus ring (spread, no blur) Functional ring, not decorative glow."],"result":null}
|
|
{"args":["Tiny blur (<5px) Too subtle to be \"glowing\"."],"result":null}
|
|
{"args":["Small dark elevation Subtle shadow on dark card."],"result":null}
|
|
{"args":["Medium dark elevation Standard dark card shadow."],"result":null}
|
|
{"args":["Large dark elevation Prominent shadow on dark card."],"result":null}
|
|
{"args":["Inset shadow Inner shadow, not a glow."],"result":null}
|
|
{"args":["Normal gray shadow on dark card Gray/black shadow is not a glow. Focus ring (spread, no blur) Functional ring, not decorative glow. Tiny blur (<5px) Too subtle to be \"glowing\". Small dark elevation Subtle shadow on dark card. Medium dark elevation Standard dark card shadow. Large dark elevation Prominent shadow on dark card. Inset shadow Inner shadow, not a glow. Multi-shadow dark card Layered gray shadows, no color glow."],"result":null}
|
|
{"args":["Not dark enough background Medium gray doesn't qualify as \"dark mode\"."],"result":null}
|
|
{"args":["Offset colored drop shadow Real drop shadow with a color tint — not a halo."],"result":null}
|
|
{"args":["Soft neutral halo Achromatic zero-offset shadow is ambient elevation."],"result":null}
|
|
{"args":["Offset colored shadow over photo background Surface unknown, offset shadow — abstain, not flag."],"result":null}
|
|
{"args":["The wash blends with unknowable image pixels Surface unknown — abstain, never score the wash stops as dark."],"result":null}
|
|
{"args":["Offset neutral text-shadow Legibility aid, not a glow."],"result":null}
|
|
{"args":["Small elevation (Tailwind shadow-sm) Standard subtle card shadow."],"result":null}
|
|
{"args":["Medium elevation (Tailwind shadow-md) Standard card shadow."],"result":null}
|
|
{"args":["Heading rhythm fixture * { margin: 0; padding: 0; box-sizing: border-box; } body { font-family: Georgia, serif; font-size: 16px; line-height: 1.5; width: 720px; } h2 { font-size: 28px; line-height: 1.2; } h3 { font-size: 20px; line-height: 1.2; } p { max-width: 60ch; } /* FLAG: zero space above the heading, clear space below it */ .flag-crowded { margin: 0 0 40px; } .flag-crowded + p { margin: 0 0 24px; } /* PASS: generous space above, tight below */ .pass-generous { margin: 64px 0 16px; } /* PASS: near-equal spacing is ambiguous, not inverted */ .pass-near-equal { margin: 20px 0 24px; } /* PASS: eyebrow label bound to the heading; real space sits above the cluster */ .pass-eyebrow-label { font-size: 12px; letter-spacing: 0.1em; text-transform: uppercase; margin: 72px 0 8px; } .pass-eyebrow-heading { margin: 0 0 24px; } /* PASS: small card, its boundary provides the separation */ .pass-card { box-shadow: 0 1px 4px rgba(0,0,0,0.2); background: #f4f4f4; padding: 16px; margin: 48px 0; width: 320px; } .pass-card h3 { margin: 0 0 20px; } /* PASS: heading first inside a banded section; the band edge separates */ .pass-band { background: #ececec; padding: 8px 0 32px; margin-top: 8px; } .pass-band h2 { margin: 0 0 24px; }"],"result":null}
|
|
{"args":["A closing paragraph of the previous block of content, sitting directly above the crowded heading with no gap at all between them."],"result":null}
|
|
{"args":["Another closing paragraph of a previous content block, again flush against the heading that follows it in the document flow."],"result":null}
|
|
{"args":["A third closing paragraph that the next heading will visually attach to, which is exactly the inversion this rule measures."],"result":null}
|
|
{"args":["Third crowded case, this time an h3, to confirm the rule reads h2 through h4."],"result":null}
|
|
{"args":["Sixty-four pixels above and sixteen below. The heading clearly binds to this paragraph, which is the healthy shape."],"result":null}
|
|
{"args":["Chapter Four"],"result":null}
|
|
{"args":["The tiny label above belongs to the heading cluster. Space is measured from the top of the cluster, where seventy-two pixels separate it from this text."],"result":null}
|
|
{"args":["Pass Card Heading A heading inside a small card. The card boundary provides the separation, so the rule exempts headings inside panels shorter than two hundred pixels."],"result":null}
|
|
{"args":["Should flag AI-NATIVE WORKFLOWS Eyebrow Above Hero Classic uppercase tracked div eyebrow above an 88px hero. NEW IN 2026 Span Eyebrow Above Hero Span variant with the same uppercase + tracking + small-size shape. FEATURED Pill Chip Above Hero Pill-shaped chip with background, border-radius, padding. NEW Already Uppercase Text Text typed uppercase, no text-transform, but matching tracking and size. A VERY LONG UPPERCASE TABLE OF CONTENTS HEADER Long Uppercase Sentence Above Hero 46-char uppercase tracked label — under the 60-char eyebrow ceiling, so it still reads as an oversized eyebrow."],"result":null}
|
|
{"args":["Hero With No Eyebrow Bare h1 at 64px, nothing above it."],"result":null}
|
|
{"args":[""],"result":null}
|
|
{"args":["⚡"],"result":null}
|
|
{"args":["Should flag Lightning Fast Built for speed and performance from the ground up. Secure Storage Enterprise-grade security for your peace of mind. Easy Setup Get started in minutes with zero configuration. Powerful Analytics Insights that drive smarter business decisions. ⚡ Emoji Inline Icon The tile contains an emoji directly, no SVG child."],"result":null}
|
|
{"args":["Inline Side By Side Icon sits next to the heading, not above it."],"result":null}
|
|
{"args":["Should flag Fraunces 88px italic The Lumina hero pattern: oversized Fraunces italic display. Recoleta 64px italic Recoleta italic at 64px, generic serif fallback. Playfair 72px italic Playfair Display italic at hero scale. Unknown Serif Generic Fallback Primary font unknown to the detector, but the stack ends in generic serif."],"result":null}
|
|
{"args":["Inline Em Inside Roman Roman h1 with an inline italic em — v1 deliberately does not flag this."],"result":null}
|
|
{"args":["Invitation protocol"],"result":null}
|
|
{"args":["Output model"],"result":null}
|
|
{"args":["Preview sequence"],"result":null}
|
|
{"args":["Access window"],"result":null}
|
|
{"args":["materials briefing"],"result":null}
|
|
{"args":["Home / Journal / Archive"],"result":null}
|
|
{"args":["News · Jan 12, 2026"],"result":null}
|
|
{"args":["Section 4.2"],"result":null}
|
|
{"args":["§ 12.3"],"result":null}
|
|
{"args":["Next from"],"result":null}
|
|
{"args":["Home Docs \"Page Title After Nav\" A navigation landmark preceding the page title is chrome, not a kicker."],"result":null}
|
|
{"args":["A quiet lead-in sentence"],"result":null}
|
|
{"args":["New arrivals"],"result":null}
|
|
{"args":["Outer Card Inner Card Card inside card."],"result":null}
|
|
{"args":["Level 1 Level 2 Level 3 — nesting inception."],"result":null}
|
|
{"args":["Outer (CSS) Inner card via CSS."],"result":null}
|
|
{"args":["Should flag Nested cards (cardocalypse) Outer Card Inner Card Card inside card. Level 1 Level 2 Level 3 — nesting inception. Outer (CSS) Inner card via CSS. shadcn-style Outer Card Another shadcn Card nested inside."],"result":null}
|
|
{"args":["Card Title Card description goes here. CardContent — a sub-section, not a nested card. No shadow, no border-radius of its own. Action"],"result":null}
|
|
{"args":["Settings Select option"],"result":null}
|
|
{"args":["Installation npm install @acme/sdk"],"result":null}
|
|
{"args":["Tags React TypeScript Tailwind"],"result":null}
|
|
{"args":["Project Preview Image with rounded corners and shadow."],"result":null}
|
|
{"args":["Free $0"],"result":null}
|
|
{"args":["Pro $29"],"result":null}
|
|
{"args":["Every border here is a well-established web pattern. None should be flagged."],"result":null}
|
|
{"args":["\"Design is not just what it looks like and feels like. Design is how it works.\""],"result":null}
|
|
{"args":["Dashboard Projects Settings"],"result":null}
|
|
{"args":["Email Please enter a valid email address."],"result":null}
|
|
{"args":["Order placed March 15, 2026 Shipped March 16, 2026 Delivered Expected March 18"],"result":null}
|
|
{"args":["- const old = getValue(); + const value = getNewValue(); return value;"],"result":null}
|
|
{"args":["Overview Analytics Settings"],"result":null}
|
|
{"args":["Name Revenue Acme Corp$1.2M Globex$850K"],"result":null}
|
|
{"args":["External side-tab class border-left plus border-radius from a linked stylesheet."],"result":null}
|
|
{"args":["Should flag External side-tab class border-left plus border-radius from a linked stylesheet. External top accent class border-top plus border-radius from a linked stylesheet."],"result":null}
|
|
{"args":["External clean card Uniform 1px border from the linked stylesheet."],"result":null}
|
|
{"args":["External neutral side rule Thick side border, but the color is structural gray."],"result":null}
|
|
{"args":["oklch checklistoklch border-left 3px + radius"],"result":null}
|
|
{"args":["oklch medication cardneutral all + colored left 4px"],"result":null}
|
|
{"args":["oklch alertwarm border-left 4px + radius"],"result":null}
|
|
{"args":["oklab cardoklab border-left 4px + radius"],"result":null}
|
|
{"args":["lch cardlch border-left 4px + radius"],"result":null}
|
|
{"args":["Card-shaped label with rgb side border"],"result":null}
|
|
{"args":["var() shorthandborder-left 5px + var(--brand)"],"result":null}
|
|
{"args":["var() mixedneutral all + colored var left"],"result":null}
|
|
{"args":["Should flag oklch checklistoklch border-left 3px + radius oklch medication cardneutral all + colored left 4px oklch alertwarm border-left 4px + radius oklab cardoklab border-left 4px + radius lch cardlch border-left 4px + radius lab cardlab border-left 4px + radius Card-shaped label with oklch side border Card-shaped label with rgb side border var() shorthandborder-left 5px + var(--brand) var() mixedneutral all + colored var left var() right sideborder-right 4px + var(--terracotta) Card-shaped label with var() side border"],"result":null}
|
|
{"args":["oklch neutralchroma 0 gray"],"result":null}
|
|
{"args":["oklch near-neutralchroma 0.01"],"result":null}
|
|
{"args":["oklch all sidesuniform border"],"result":null}
|
|
{"args":["oklch thin1px too thin"],"result":null}
|
|
{"args":["lab neutralchroma 0"],"result":null}
|
|
{"args":["Label with 1px colored left border (too thin)"],"result":null}
|
|
{"args":["var() neutral--line resolves to gray"],"result":null}
|
|
{"args":["var() thin1px too thin to qualify"],"result":null}
|
|
{"args":["var() all sidesuniform, not a side-tab"],"result":null}
|
|
{"args":["CSS bounce animation animation: bounce 1s infinite"],"result":null}
|
|
{"args":["Elastic cubic-bezier cubic-bezier(0.68, -0.55, 0.265, 1.55)"],"result":null}
|
|
{"args":["transition: width Animating width causes layout thrash."],"result":null}
|
|
{"args":["transition: height Animating height causes layout thrash."],"result":null}
|
|
{"args":["transition: padding Animating padding causes layout thrash."],"result":null}
|
|
{"args":["transition: margin Animating margin causes layout thrash."],"result":null}
|
|
{"args":["transition: max-height Use grid-template-rows instead."],"result":null}
|
|
{"args":["transition: width, height Multiple layout properties."],"result":null}
|
|
{"args":["transition: width, opacity Layout property mixed with OK property."],"result":null}
|
|
{"args":["Should flag Bounce / elastic easing CSS bounce animation animation: bounce 1s infinite Elastic cubic-bezier cubic-bezier(0.68, -0.55, 0.265, 1.55) Layout property transitions transition: width Animating width causes layout thrash. transition: height Animating height causes layout thrash. transition: padding Animating padding causes layout thrash. transition: margin Animating margin causes layout thrash. transition: max-height Use grid-template-rows instead. transition: width, height Multiple layout properties. transition: width, opacity Layout property mixed with OK property. transition-property: width Longhand form."],"result":null}
|
|
{"args":["Smooth fade in animation: fadeIn with exponential ease-out"],"result":null}
|
|
{"args":["Ease-out quart cubic-bezier(0.25, 1, 0.5, 1) — smooth deceleration"],"result":null}
|
|
{"args":["Ease-out expo cubic-bezier(0.16, 1, 0.3, 1) — natural feel"],"result":null}
|
|
{"args":["transition: transform Transform is GPU-accelerated and safe."],"result":null}
|
|
{"args":["transition: opacity Opacity is GPU-accelerated and safe."],"result":null}
|
|
{"args":["transition: color, background-color Color transitions are paint-only, no layout."],"result":null}
|
|
{"args":["transition: box-shadow Shadow transitions are paint-only."],"result":null}
|
|
{"args":["transition: all Too common to flag — usually paired with transform/opacity."],"result":null}
|
|
{"args":["named purpleborder-left 4px solid purple + radius"],"result":null}
|
|
{"args":["rebeccapurpleborder-left 4px + radius"],"result":null}
|
|
{"args":["crimson top stripeborder-top 4px, horizontal variant"],"result":null}
|
|
{"args":["named tealborder-left 3px, no radius"],"result":null}
|
|
{"args":["var() to namedborder-left 4px solid var(--accent)"],"result":null}
|
|
{"args":["Should flag named purpleborder-left 4px solid purple + radius rebeccapurpleborder-left 4px + radius crimson top stripeborder-top 4px, horizontal variant named tealborder-left 3px, no radius var() to namedborder-left 4px solid var(--accent) inline named purplestyle attribute, issue #359 case (a); width 7px keeps the snippet unique"],"result":null}
|
|
{"args":["dimgrayneutral named color"],"result":null}
|
|
{"args":["gainsborolight neutral named color"],"result":null}
|
|
{"args":["named blackneutral side border"],"result":null}
|
|
{"args":["1px purpletoo thin to qualify"],"result":null}
|
|
{"args":["01"],"result":{"index":1,"text":"01"}}
|
|
{"args":["02"],"result":{"index":2,"text":"02"}}
|
|
{"args":["03"],"result":{"index":3,"text":"03"}}
|
|
{"args":["04 / ROLLOUT"],"result":{"index":4,"text":"04 / ROLLOUT"}}
|
|
{"args":["05"],"result":{"index":5,"text":"05"}}
|
|
{"args":["12 · minute read"],"result":{"index":12,"text":"12 · minute read"}}
|
|
{"args":["Step 6"],"result":null}
|
|
{"args":["7"],"result":null}
|
|
{"args":["Readable date Updated June 14, 2026."],"result":null}
|
|
{"args":["Statistic cards Revenue grew 18%, margin reached 24%, and churn fell to 3%."],"result":null}
|
|
{"args":["CSS generated content Generated numbers in CSS should not count as body copy."],"result":null}
|
|
{"args":["Inline SVG coordinates"],"result":null}
|
|
{"args":["Each scenario places a detectable anti-pattern inside a layout context that can cause overlay misalignment."],"result":null}
|
|
{"args":["1e. Transform + absolute child Absolutely positioned tiny text inside transformed parent."],"result":null}
|
|
{"args":["2d. Transform inside closed details Closed with transform inside Tiny text inside transform inside closed details. Double trouble."],"result":null}
|
|
{"args":["Tiny text in a fixed footer -- overlay should track this on scroll."],"result":null}
|
|
{"args":["4b. overflow:hidden + transform ancestor Visible inside transform + overflow. Clipped tiny text inside a transformed overflow:hidden container."],"result":null}
|
|
{"args":["5c. Negative top offset Tiny text pulled upward via negative top offset."],"result":null}
|
|
{"args":["6c. Flex with transform AI Gradient Button in Flex + Transform"],"result":null}
|
|
{"args":["7d. backdrop-filter Tiny text inside a backdrop-filter container."],"result":null}
|
|
{"args":["8a. Negative margin shifting element position Tiny text pulled out of its parent via negative margins."],"result":null}
|
|
{"args":["Panel"],"result":null}
|
|
{"args":["no max-width on a paragraph This paragraph has no max-width constraint at all, which means on a wide monitor or ultrawide display, each line of text can stretch to 150 or even 200 characters wide. Research consistently shows that line lengths beyond 75 characters significantly reduce reading speed and comprehension. The eye has to travel too far to find the beginning of the next line, causing readers to lose their place. A simple max-width of 65ch to 75ch on the paragraph or its container would fix this entirely."],"result":null}
|
|
{"args":["line-height: 1.0 This paragraph has a line-height of 1.0, which means the lines are touching. Multi-line body text needs breathing room between lines for readability. A line-height of 1.5 to 1.7 is generally recommended for body text."],"result":null}
|
|
{"args":["10px body text This body text is only 10px. While this might be fine for a disclaimer or legal footnote, it's too small for primary content that users need to actually read. Aim for at least 14px for body content, 16px is ideal."],"result":null}
|
|
{"args":["text-align: justify, no hyphens: auto This paragraph uses text-align: justify, which forces each line to stretch to fill the full width. Without hyphenation support, this creates uneven gaps between words known as \"rivers of white space\" that flow vertically through the text. Left-aligned text is almost always more readable on the web."],"result":null}
|
|
{"args":["text-transform: uppercase on a long passage This entire paragraph is in uppercase via text-transform. While all-caps works for short labels, headings, or navigation items, longer body text in uppercase is significantly harder to read because we lose the word shape cues that come from ascenders and descenders in mixed-case text."],"result":null}
|
|
{"args":["letter-spacing: 0.15em on body text This body text has letter-spacing: 0.15em applied to it. While subtle tracking adjustments can improve readability for headings or all-caps text, adding significant letter spacing to body text actually makes it harder to read by disrupting natural character groupings."],"result":null}
|
|
{"args":["Should flag Line length too long no max-width on a paragraph This paragraph has no max-width constraint at all, which means on a wide monitor or ultrawide display, each line of text can stretch to 150 or even 200 characters wide. Research consistently shows that line lengths beyond 75 characters significantly reduce reading speed and comprehension. The eye has to travel too far to find the beginning of the next line, causing readers to lose their place. A simple max-width of 65ch to 75ch on the paragraph or its container would fix this entirely. Tight line height line-height: 1.0 This paragraph has a line-height of 1.0, which means the lines are touching. Multi-line body text needs breathing room between lines for readability. A line-height of 1.5 to 1.7 is generally recommended for body text. Tiny body text 10px body text This body text is only 10px. While this might be fine for a disclaimer or legal footnote, it's too small for primary content that users need to actually read. Aim for at least 14px for body content, 16px is ideal. Justified text without hyphens text-align: justify, no hyphens: auto This paragraph uses text-align: justify, which forces each line to stretch to fill the full width. Without hyphenation support, this creates uneven gaps between words known as \"rivers of white space\" that flow vertically through the text. Left-aligned text is almost always more readable on the web. All-caps body text text-transform: uppercase on a long passage This entire paragraph is in uppercase via text-transform. While all-caps works for short labels, headings, or navigation items, longer body text in uppercase is significantly harder to read because we lose the word shape cues that come from ascenders and descenders in mixed-case text. Wide letter spacing on body text letter-spacing: 0.15em on body text This body text has letter-spacing: 0.15em applied to it. While subtle tracking adjustments can improve readability for headings or all-caps text, adding significant letter spacing to body text actually makes it harder to read by disrupting natural character groupings. Skipped heading levels h1 → h3 (missing h2) Top heading Skips straight to h3"],"result":null}
|
|
{"args":["max-width: 65ch on the paragraph This paragraph has a max-width of 65ch, keeping the line length comfortable for reading. The eye can easily track from the end of one line to the beginning of the next without losing its place."],"result":null}
|
|
{"args":["line-height: 1.6 This paragraph has a line-height of 1.6, which gives multi-line text plenty of room to breathe and improves the rhythm of the page."],"result":null}
|
|
{"args":["16px body text This is 16px body text — the recommended baseline for comfortable reading on modern displays."],"result":null}
|
|
{"args":["text-align: justify + hyphens: auto When justified text is paired with hyphens: auto, the browser can break long words across lines, eliminating the rivers of white space and making the justification look intentional rather than awkward."],"result":null}
|
|
{"args":["short label, uppercase Featured"],"result":null}
|
|
{"args":["letter-spacing on a short uppercase label Beta"],"result":null}
|
|
{"args":["h1 → h2 → h3 Top heading Second level Third level"],"result":null}
|
|
{"args":["Museumplein departure Suspended Suspended This service is Suspended until further notice."],"result":null}
|
|
{"args":["Evening show Unavailable Unavailable Unavailable Currently Unavailable at this venue."],"result":null}
|
|
{"args":["Deploy history build 12Rolled back build 13Rolled back build 14Rolled back"],"result":null}
|
|
{"args":["Departures On schedule On schedule On schedule"],"result":null}
|
|
{"args":["Sections Overview page Overview page Overview page"],"result":null}
|
|
{"args":["Toggles Off Off Off"],"result":null}
|
|
{"args":["Standby mode"],"result":null}
|
|
{"args":["Availability Open slot Open slot Open slot"],"result":null}
|
|
{"args":["Template content never renders and never counts."],"result":null}
|
|
{"args":["First revealed section This block starts at opacity zero, exactly like a broken page would, but its IntersectionObserver is alive. During the sweep it gains the in-view class and transitions to full opacity, so the post-sweep measurement sees it as visible."],"result":null}
|
|
{"args":["Second revealed section More reveal-on-scroll copy that carries a meaningful share of the page's character count. If the sweep or the exclusion rules regress, this fixture is the page that starts producing a false content-hidden-at-rest finding."],"result":null}
|
|
{"args":["The opening paragraph renders normally, exactly like the real broken sample: the first viewport looks fine while everything below it never appears."],"result":null}
|
|
{"args":["First hidden section This block waits for an IntersectionObserver that will never construct, because the single script tag below fails to parse. Its text ships in the document but the reveal class never lands, so the reader scrolls through blank space."],"result":null}
|
|
{"args":["Second hidden section More shipped-but-invisible copy. Together the hidden sections carry well over thirty percent of the character count of the page, which is the failed-reveal signature this fixture exists to reproduce for the detector tests."],"result":null}
|
|
{"args":["Every example on this page should be detected by the anti-pattern scanner."],"result":null}
|
|
{"args":["border-l-4 + rounded-r The classic AI tell."],"result":null}
|
|
{"args":["border-r-4 + rounded-l Right side variant."],"result":null}
|
|
{"args":["border-l-4 + rounded-r The classic AI tell. border-r-4 + rounded-l Right side variant. border-e-8 + rounded-l Logical inline-end, extra thick."],"result":null}
|
|
{"args":["border-left: 4px solid CSS shorthand."],"result":null}
|
|
{"args":["border-right: 5px solid CSS shorthand right."],"result":null}
|
|
{"args":["border-left-width: 3px CSS longhand."],"result":null}
|
|
{"args":["border-left: 4px solid CSS shorthand. border-right: 5px solid CSS shorthand right. border-left-width: 3px CSS longhand. border-right-width: 6px CSS longhand right."],"result":null}
|
|
{"args":["border-t-4 + rounded-lg Top accent on rounded card."],"result":null}
|
|
{"args":["border-b-4 + rounded-xl Bottom accent on rounded card."],"result":null}
|
|
{"args":["border-t-2 + rounded-md Even thin top border on rounded."],"result":null}
|
|
{"args":["CSS border-top + border-radius Top border from style block."],"result":null}
|
|
{"args":["border-t-4 + rounded-lg Top accent on rounded card. border-b-4 + rounded-xl Bottom accent on rounded card. border-t-2 + rounded-md Even thin top border on rounded. CSS border-top + border-radius Top border from style block. CSS border-bottom + border-radius Bottom border from style block."],"result":null}
|
|
{"args":["Dark card + border-l-4 + rounded Dark background doesn't make the side-tab OK."],"result":null}
|
|
{"args":["Dark card + border-t-2 + rounded Top accent on dark rounded card."],"result":null}
|
|
{"args":["None of these should be flagged. They're all intentional, well-established web patterns."],"result":null}
|
|
{"args":["Full border card Subtle 1px border all around. Clean and intentional."],"result":null}
|
|
{"args":["Top border, no radius A hairline top rule without rounded corners is a clean section divider."],"result":null}
|
|
{"args":["New"],"result":null}
|
|
{"args":["Full border card Subtle 1px border all around. Clean and intentional. Top border, no radius A hairline top rule without rounded corners is a clean section divider. Bottom border, no radius Bottom accent without rounded corners is also clean. New No border at all Just a shadow. Simple and effective."],"result":null}
|
|
{"args":["border-left: 1px solid, no radius — not flagged border-right: 2px solid, no radius — not flagged 1px inline border-left, no radius — not flagged"],"result":null}
|
|
{"args":["Dark card, full border Uniform 1px border all around. Clean."],"result":null}
|
|
{"args":["Dark section, bottom border, no radius Bottom accent without radius is fine."],"result":null}
|
|
{"args":["This page triggers three typography detections:"],"result":null}
|
|
{"args":["Inter is loaded from Google Fonts and set as the only font-family. It's the most common AI default."],"result":null}
|
|
{"args":["There's no second font for headings or display text. Everything uses Inter — no typographic variety."],"result":null}
|
|
{"args":["This caption is barely distinguishable from body text."],"result":null}
|
|
{"args":["This page uses distinctive fonts, proper pairing, and strong hierarchy."],"result":null}
|
|
{"args":["Newsreader (serif) for headings, Karla for body. Clear contrast in both structure and personality, and neither face has been adopted into the current AI-default monoculture."],"result":null}
|
|
{"args":["Should flag Typography Anti-Patterns This side uses element-level typography failures that can be highlighted directly in the detector lab. Tight Leading This paragraph has a line-height that is too tight for body copy. The lines press into each other and make scanning harder, especially once the text wraps across multiple lines in a production layout. Tiny Body Text This body text is set at 10px, which is too small for real reading content and should be reserved for neither primary copy nor explanatory product text. All-Caps Body This entire paragraph is transformed to uppercase, which removes useful word shapes and makes longer body copy feel like a shout instead of a readable passage. Wide Tracking This paragraph spreads every letter apart, a treatment that belongs on short labels at most, not on body copy that people need to read comfortably. Justified Text This paragraph uses justified alignment without automatic hyphenation. In narrow columns it creates uneven word spacing and distracting rivers through the text block. Overused Font Inter is also the dominant face on this side of the page, so the browser page-level detector has enough real text elements to show the global overused-font banner."],"result":null}
|
|
{"args":["Should flag Flag Nav Link Flag Category Flag Meta Row Flag Button Flag Table Cell Flag Caps Label Flag Footer Link"],"result":null}
|
|
{"args":["Should flag after pixel sampling White text on light image should be sampled by pixel contrast. Dark text on dark image should be sampled by pixel contrast. Translucent white text on a pale pattern should use rendered pixels. Muted gray text on a misty image should be sampled by pixel contrast."],"result":null}
|