impeccable 4.5.2 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Impeccable CLI
2
2
 
3
- Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 59 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
3
+ Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 61 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
4
4
 
5
5
  The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
6
6
 
@@ -57,7 +57,7 @@ npx impeccable detect --json src/
57
57
 
58
58
  **Quality**: tiny body text, cramped padding, long line lengths, small touch targets
59
59
 
60
- 59 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
60
+ 61 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
61
61
 
62
62
  ## Exit Codes
63
63
 
@@ -79,7 +79,7 @@ impeccable detect [options] [file-or-dir-or-url...]
79
79
 
80
80
  ## Requirements
81
81
 
82
- - Node.js 22.18+ to run `npx impeccable`. The engine itself is a self-contained binary and needs no runtime; the skill installed into your harness calls it directly.
82
+ - Node.js 18.19+ to run `npx impeccable`. The engine itself is a self-contained binary and needs no runtime; the skill installed into your harness calls it directly.
83
83
  - For URL scans, an installed Chrome, Chromium, or Edge (set `IMPECCABLE_BROWSER` to point at one).
84
84
  - Behind a TLS-inspecting proxy, downloads trust your OS certificate store as well as the bundled Mozilla roots. Set `SSL_CERT_FILE` or `SSL_CERT_DIR` to use a specific CA bundle instead.
85
85
 
package/README.npm.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Impeccable CLI
2
2
 
3
- Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 59 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
3
+ Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 61 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
4
4
 
5
5
  The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
6
6
 
@@ -57,7 +57,7 @@ npx impeccable detect --json src/
57
57
 
58
58
  **Quality**: tiny body text, cramped padding, long line lengths, small touch targets
59
59
 
60
- 59 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
60
+ 61 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
61
61
 
62
62
  ## Exit Codes
63
63
 
@@ -79,7 +79,7 @@ impeccable detect [options] [file-or-dir-or-url...]
79
79
 
80
80
  ## Requirements
81
81
 
82
- - Node.js 22.18+ to run `npx impeccable`. The engine itself is a self-contained binary and needs no runtime; the skill installed into your harness calls it directly.
82
+ - Node.js 18.19+ to run `npx impeccable`. The engine itself is a self-contained binary and needs no runtime; the skill installed into your harness calls it directly.
83
83
  - For URL scans, an installed Chrome, Chromium, or Edge (set `IMPECCABLE_BROWSER` to point at one).
84
84
  - Behind a TLS-inspecting proxy, downloads trust your OS certificate store as well as the bundled Mozilla roots. Set `SSL_CERT_FILE` or `SSL_CERT_DIR` to use a specific CA bundle instead.
85
85
 
package/README.repo.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Impeccable
2
2
 
3
- Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and 59 deterministic detector rules for AI-generated frontend design.
3
+ Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design.
4
4
 
5
5
  > **Quick start:** From your project root, run `npx impeccable install`, then run `/impeccable init` inside your AI coding tool. Full docs: [impeccable.style](https://impeccable.style).
6
6
 
@@ -13,7 +13,7 @@ Every model trained on the same SaaS templates. Skip the guidance and you get th
13
13
  Impeccable adds:
14
14
  - **One setup flow.** `/impeccable init` records durable product truth in `PRODUCT.md`, so later commands know the audience, purpose, operating context, constraints, voice, and evidence without confusing those facts with surface-level visual direction.
15
15
  - **24 commands.** A shared design vocabulary with your AI: `polish`, `audit`, `critique`, `distill`, `animate`, `bolder`, `quieter`, and more.
16
- - **59 deterministic detector rules** plus LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key.
16
+ - **61 deterministic detector rules** plus LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key.
17
17
 
18
18
  ## What's Included
19
19
 
@@ -391,8 +391,24 @@ The block is wrapped in `# impeccable-ignore-start` / `# impeccable-ignore-end`
391
391
  - `.impeccable/surfaces/*.md` (route- or artifact-specific strategy and direction contracts)
392
392
  - `.impeccable/critique/*.md` (review reports)
393
393
 
394
+ Impeccable also keeps its own `.gitignore` in the folders that hold decision-round state: `.impeccable/questions/` and `.impeccable/mocks/worlds/` ignore everything in them, and `.impeccable/build/` ignores `state.json`. That keeps new runtime files out of commits even in a project without the block above. A `.gitignore` cannot untrack a file git already tracks, though: when one of these files was committed earlier, the next roll prints a one-time notice with the fix, `git rm -r --cached .impeccable/questions` (plus any other folder it names), and writes its roll record to an untracked file until then.
395
+
394
396
  If an ephemeral file (a screenshot, `config.local.json`) was committed before you added the block, `.gitignore` will not untrack it automatically. Run `git rm --cached <path>` to stop tracking it without deleting your local copy.
395
397
 
398
+ ## Telemetry
399
+
400
+ When a new design starts, the skill asks the roll API at impeccable.style to deal a hand of visual worlds from the catalog. That request is the feature, so it always happens. Unless you opt out, it also feeds an anonymous record of which hand was shown and which card won, which is how the catalog learns what works.
401
+
402
+ What is sent, on the roll request and on the choice that follows it:
403
+
404
+ - the roll key (a random value per decision round), scope (direction or surface), visitor mode, and re-roll round
405
+ - the catalog revision the hand came from, and on the choice the kind of card that won (assigned, pick, challenger, canon, or a re-roll), its catalog id when a catalog world won, and its position on the page
406
+ - the client version, whether the choice came from the decision page or the agent, and a random id for that choice so a report sent twice is counted once
407
+
408
+ Never sent: your project's name, files, code, PRODUCT.md, or the names of the directions your agent wrote. Committed files such as surface briefs record only a seed reference, a hash of the roll key under a random salt kept in `~/.impeccable/seed-salt`, never the key itself. If no salt can be kept on a machine, the brief records no seed at all rather than a weaker hash. Roll keys are 128 random bits. If you pass your own short key with `--from`, its reference is easy to guess, so do not rely on it to keep that key private.
409
+
410
+ To turn it off, run `npx impeccable telemetry off` (stored in `~/.impeccable/config.json`), or set `DO_NOT_TRACK=1` or `IMPECCABLE_NO_TELEMETRY=1`. A project can opt everyone out with `"telemetry": false` in `.impeccable/config.json`. `npx impeccable telemetry status` shows the current state. Opted out, the roll still works and the API is told not to record it. Details: https://impeccable.style/privacy
411
+
396
412
  ## Design hook
397
413
 
398
414
  On Claude Code, GitHub Copilot, Codex, Cursor, and Grok Build, `npx impeccable install` and `npx impeccable update` install a provider-native hook manifest along with the skill payload. The hook runs the Impeccable design detector on direct UI file edits and surfaces findings back into the agent flow. Claude Code, GitHub Copilot, and Codex surface findings after the edit (and run a deeper pass on Stop where supported). Grok Build scans after the edit to warm Stop, then surfaces on Stop; PostToolUse stdout never reaches the model. Cursor blocks bad proposed writes before they land.
@@ -463,7 +479,7 @@ npx impeccable ignores add-file "src/legacy/**"
463
479
  npx impeccable ignores add-value overused-font Inter --reason "Brand font"
464
480
  ```
465
481
 
466
- The detector catches 59 deterministic issues across AI slop (side-tab borders, purple gradients, bounce easing, dark glows) and general design quality (line length, cramped padding, small touch targets, skipped headings, and more).
482
+ The detector catches 61 deterministic issues across AI slop (side-tab borders, purple gradients, bounce easing, dark glows) and general design quality (line length, cramped padding, small touch targets, skipped headings, and more).
467
483
 
468
484
  Human-readable findings are diagnostics written to stderr, so redirect them with `2> findings.txt`. Use `--json` for machine-readable results on stdout. Exit `0` means the scan completed without primary findings, exit `2` means it completed with primary findings, and exit `1` means at least one requested target could not be scanned; operational failure takes precedence for a partial multi-target scan. URL scans inspect the rendered DOM, computed layout, and accessible linked stylesheets; browser security still prevents reading cross-origin CSS without CORS. A clean detector run is evidence, not proof of visual or accessibility quality: it does not replace inspecting the rendered experience across relevant viewports.
469
485
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "impeccable",
3
- "version": "4.5.2",
3
+ "version": "4.7.0",
4
4
  "author": "Paul Bakaus",
5
5
  "description": "Design skills, commands, and anti-pattern detection for AI coding agents",
6
6
  "keywords": [
@@ -24,7 +24,14 @@
24
24
  "url": "git+https://github.com/pbakaus/impeccable.git"
25
25
  },
26
26
  "engines": {
27
- "node": ">=22.18.0"
27
+ "node": ">=18.19.0"
28
+ },
29
+ "devEngines": {
30
+ "runtime": {
31
+ "name": "node",
32
+ "version": ">=22.18.0",
33
+ "onFail": "warn"
34
+ }
28
35
  },
29
36
  "type": "module",
30
37
  "bin": {
@@ -59,8 +66,10 @@
59
66
  "test:new-work-e2e": "node scripts/run-tests.mjs new-work-e2e",
60
67
  "test:live-e2e-agent": "node scripts/run-tests.mjs live-e2e-agent",
61
68
  "test:skill-behavior": "node scripts/run-tests.mjs skill-behavior",
69
+ "test:skill-activation": "node scripts/run-tests.mjs skill-activation",
62
70
  "test:skill-workflow": "node scripts/run-tests.mjs skill-workflow",
63
71
  "test:live-svelte-adapter-deepseek": "node scripts/run-tests.mjs live-svelte-adapter-deepseek",
72
+ "test:rust-changed": "node scripts/test-rust-changed.mjs",
64
73
  "smoke:hooks": "node scripts/smoke-provider-hooks.mjs",
65
74
  "audit": "bun audit --audit-level=moderate",
66
75
  "prepack": "cp README.md README.repo.md && cp README.npm.md README.md",
@@ -74,18 +83,18 @@
74
83
  "build:component-review": "bun scripts/build-component-review.mjs"
75
84
  },
76
85
  "optionalDependencies": {
77
- "@impeccable/cli-darwin-arm64": "0.1.14",
78
- "@impeccable/cli-darwin-x64": "0.1.14",
79
- "@impeccable/cli-linux-x64": "0.1.14",
80
- "@impeccable/cli-linux-arm64": "0.1.14",
81
- "@impeccable/cli-windows-x64": "0.1.14"
86
+ "@impeccable/cli-darwin-arm64": "0.1.16",
87
+ "@impeccable/cli-darwin-x64": "0.1.16",
88
+ "@impeccable/cli-linux-x64": "0.1.16",
89
+ "@impeccable/cli-linux-arm64": "0.1.16",
90
+ "@impeccable/cli-windows-x64": "0.1.16"
82
91
  },
83
92
  "devDependencies": {
84
93
  "@ai-sdk/anthropic": "^4.0.7",
85
94
  "@ai-sdk/google": "^4.0.8",
86
95
  "@ai-sdk/openai": "^4.0.7",
87
96
  "@anthropic-ai/claude-agent-sdk": "^0.3.165",
88
- "@anthropic-ai/sdk": "^0.131.0",
97
+ "@anthropic-ai/sdk": "^0.133.0",
89
98
  "@babel/parser": "^8.0.4",
90
99
  "ai": "^7.0.14",
91
100
  "archiver": "^8.0.0",