impeccable 4.0.5 → 4.5.1

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 61 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 59 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
- 61 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
60
+ 59 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
 
@@ -87,7 +87,7 @@ Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/
87
87
 
88
88
  ## Part of Impeccable
89
89
 
90
- This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 23 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
90
+ This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 24 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
91
91
 
92
92
  ## License
93
93
 
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 61 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 59 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
- 61 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
60
+ 59 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
 
@@ -87,7 +87,7 @@ Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/
87
87
 
88
88
  ## Part of Impeccable
89
89
 
90
- This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 23 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
90
+ This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 24 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
91
91
 
92
92
  ## License
93
93
 
package/README.repo.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Impeccable
2
2
 
3
- Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design.
3
+ Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and 59 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
 
@@ -12,8 +12,8 @@ Every model trained on the same SaaS templates. Skip the guidance and you get th
12
12
 
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
- - **23 commands.** A shared design vocabulary with your AI: `polish`, `audit`, `critique`, `distill`, `animate`, `bolder`, `quieter`, and more.
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.
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.
17
17
 
18
18
  ## What's Included
19
19
 
@@ -33,7 +33,7 @@ Start every new project with:
33
33
 
34
34
  `init` inspects the project, asks only for material gaps in durable product truth, and writes `PRODUCT.md`. Visitor mode and visual direction are chosen later for each surface; incumbent or newly built visual systems are recorded separately in `DESIGN.md`.
35
35
 
36
- ### 23 Commands
36
+ ### 24 Commands
37
37
 
38
38
  All commands are accessed through `/impeccable`:
39
39
 
@@ -62,6 +62,7 @@ All commands are accessed through `/impeccable`:
62
62
  | `/impeccable adapt` | Adapt for different devices |
63
63
  | `/impeccable optimize` | Performance improvements |
64
64
  | `/impeccable live` | Visual variant mode: iterate on elements in the browser |
65
+ | `/impeccable generate` | Generate variants of a named element in the live browser, no manual picking |
65
66
 
66
67
  Use `/impeccable pin <command>` to create standalone shortcuts (e.g., `pin audit` creates `/audit`).
67
68
 
@@ -357,31 +358,30 @@ As you run commands, Impeccable writes working files under `.impeccable/`: criti
357
358
  ```gitignore
358
359
  # impeccable-ignore-start
359
360
  # Ephemeral output, runtime state, and per-dev overrides.
360
- # Unanchored: .impeccable may sit at the repo root or under a nested
361
- # workspace (apps/web/.impeccable/...); anchored patterns would miss it.
361
+ # The **/ prefix covers .impeccable at the repo root or in a nested workspace.
362
362
  # Shared artifacts stay tracked: config.json, live/config.json,
363
363
  # design.json, surfaces/*.md, critique/*.md.
364
- .impeccable/config.local.json
365
- .impeccable/hook.cache.json
366
- .impeccable/hook.pending.json
367
- .impeccable/*.png
368
- .impeccable/review/
369
- .impeccable/questions/
370
- .impeccable/live/server.json
371
- .impeccable/live/sessions/
372
- .impeccable/live/previews/
373
- .impeccable/live/annotations/
374
- .impeccable/live/cache/
375
- .impeccable/live/manual-edit-apply-transaction.json
376
- .impeccable/live/manual-edit-events.jsonl
377
- .impeccable/live/manual-edit-evidence/
378
- .impeccable/live/pending-manual-edits.json
379
- .impeccable/live/deferred-svelte-component-accepts.json
380
- .impeccable/live/*.png
364
+ **/.impeccable/config.local.json
365
+ **/.impeccable/hook.cache.json
366
+ **/.impeccable/hook.pending.json
367
+ **/.impeccable/*.png
368
+ **/.impeccable/review/
369
+ **/.impeccable/questions/
370
+ **/.impeccable/live/server.json
371
+ **/.impeccable/live/sessions/
372
+ **/.impeccable/live/previews/
373
+ **/.impeccable/live/annotations/
374
+ **/.impeccable/live/cache/
375
+ **/.impeccable/live/manual-edit-apply-transaction.json
376
+ **/.impeccable/live/manual-edit-events.jsonl
377
+ **/.impeccable/live/manual-edit-evidence/
378
+ **/.impeccable/live/pending-manual-edits.json
379
+ **/.impeccable/live/deferred-svelte-component-accepts.json
380
+ **/.impeccable/live/*.png
381
381
  # impeccable-ignore-end
382
382
  ```
383
383
 
384
- The block is wrapped in `# impeccable-ignore-start` / `# impeccable-ignore-end` markers so you can recognize and refresh it later. Patterns are unanchored on purpose: in a monorepo the active project (and its `.impeccable/` directory) often lives under a nested workspace path like `apps/web/`, and a root-anchored pattern would miss it.
384
+ The block is wrapped in `# impeccable-ignore-start` / `# impeccable-ignore-end` markers so you can recognize and refresh it later. The `**/` prefix makes each pattern match whether the active project's `.impeccable/` directory is at the repository root or under a nested workspace path like `apps/web/`.
385
385
 
386
386
  **Keep these tracked** (they are shared project artifacts, do not add them to `.gitignore`):
387
387
 
@@ -417,7 +417,7 @@ For debugging, set `hook.auditLog` in `.impeccable/config.json` to a path (or th
417
417
 
418
418
  ## Build path: comp-first or code-first
419
419
 
420
- When a new surface gets designed, Impeccable either generates a full-fidelity comp first and builds to match it, or builds straight in code with the ambition written into a development-only direction contract in the surface brief and checked at the finish. Comp-first composes bolder and takes longer; code-first is leaner and faster. `/impeccable init` asks once and records the answer as `buildPath` in `.impeccable/config.json`:
420
+ When a new surface gets designed, Impeccable either generates a full-fidelity comp first and builds to match it, or builds straight in code with the ambition written into a development-only direction contract in the surface brief and checked at the finish. Comp-first composes bolder and takes longer; code-first is leaner and faster. The choice covers landing pages and showcase surfaces. App screens and documents are built code-first either way, because they come out better built than pictured. `/impeccable init` asks once and records the answer as `buildPath` in `.impeccable/config.json`:
421
421
 
422
422
  ```json
423
423
  { "buildPath": "comp" }
@@ -463,7 +463,7 @@ npx impeccable ignores add-file "src/legacy/**"
463
463
  npx impeccable ignores add-value overused-font Inter --reason "Brand font"
464
464
  ```
465
465
 
466
- 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).
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).
467
467
 
468
468
  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
469
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "impeccable",
3
- "version": "4.0.5",
3
+ "version": "4.5.1",
4
4
  "author": "Paul Bakaus",
5
5
  "description": "Design skills, commands, and anti-pattern detection for AI coding agents",
6
6
  "keywords": [
@@ -70,21 +70,22 @@
70
70
  "release:ext": "node scripts/release.mjs extension",
71
71
  "release:engine": "node scripts/release.mjs engine",
72
72
  "release:platform-packages": "node scripts/publish-platform-packages.mjs",
73
- "check:engine-release": "node scripts/check-engine-release.mjs"
73
+ "check:engine-release": "node scripts/check-engine-release.mjs",
74
+ "build:component-review": "bun scripts/build-component-review.mjs"
74
75
  },
75
76
  "optionalDependencies": {
76
- "@impeccable/cli-darwin-arm64": "0.1.4",
77
- "@impeccable/cli-darwin-x64": "0.1.4",
78
- "@impeccable/cli-linux-x64": "0.1.4",
79
- "@impeccable/cli-linux-arm64": "0.1.4",
80
- "@impeccable/cli-windows-x64": "0.1.4"
77
+ "@impeccable/cli-darwin-arm64": "0.1.12",
78
+ "@impeccable/cli-darwin-x64": "0.1.12",
79
+ "@impeccable/cli-linux-x64": "0.1.12",
80
+ "@impeccable/cli-linux-arm64": "0.1.12",
81
+ "@impeccable/cli-windows-x64": "0.1.12"
81
82
  },
82
83
  "devDependencies": {
83
84
  "@ai-sdk/anthropic": "^4.0.7",
84
85
  "@ai-sdk/google": "^4.0.8",
85
86
  "@ai-sdk/openai": "^4.0.7",
86
87
  "@anthropic-ai/claude-agent-sdk": "^0.3.165",
87
- "@anthropic-ai/sdk": "^0.123.0",
88
+ "@anthropic-ai/sdk": "^0.131.0",
88
89
  "@babel/parser": "^8.0.4",
89
90
  "ai": "^7.0.14",
90
91
  "archiver": "^8.0.0",