impeccable 4.5.1 → 4.6.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 +1 -1
- package/README.npm.md +1 -1
- package/README.repo.md +16 -0
- package/package.json +15 -8
package/README.md
CHANGED
|
@@ -79,7 +79,7 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
79
79
|
|
|
80
80
|
## Requirements
|
|
81
81
|
|
|
82
|
-
- Node.js
|
|
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
|
@@ -79,7 +79,7 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
79
79
|
|
|
80
80
|
## Requirements
|
|
81
81
|
|
|
82
|
-
- Node.js
|
|
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
|
@@ -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.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.6.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": ">=
|
|
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": {
|
|
@@ -74,18 +81,18 @@
|
|
|
74
81
|
"build:component-review": "bun scripts/build-component-review.mjs"
|
|
75
82
|
},
|
|
76
83
|
"optionalDependencies": {
|
|
77
|
-
"@impeccable/cli-darwin-arm64": "0.1.
|
|
78
|
-
"@impeccable/cli-darwin-x64": "0.1.
|
|
79
|
-
"@impeccable/cli-linux-x64": "0.1.
|
|
80
|
-
"@impeccable/cli-linux-arm64": "0.1.
|
|
81
|
-
"@impeccable/cli-windows-x64": "0.1.
|
|
84
|
+
"@impeccable/cli-darwin-arm64": "0.1.15",
|
|
85
|
+
"@impeccable/cli-darwin-x64": "0.1.15",
|
|
86
|
+
"@impeccable/cli-linux-x64": "0.1.15",
|
|
87
|
+
"@impeccable/cli-linux-arm64": "0.1.15",
|
|
88
|
+
"@impeccable/cli-windows-x64": "0.1.15"
|
|
82
89
|
},
|
|
83
90
|
"devDependencies": {
|
|
84
91
|
"@ai-sdk/anthropic": "^4.0.7",
|
|
85
92
|
"@ai-sdk/google": "^4.0.8",
|
|
86
93
|
"@ai-sdk/openai": "^4.0.7",
|
|
87
94
|
"@anthropic-ai/claude-agent-sdk": "^0.3.165",
|
|
88
|
-
"@anthropic-ai/sdk": "^0.
|
|
95
|
+
"@anthropic-ai/sdk": "^0.133.0",
|
|
89
96
|
"@babel/parser": "^8.0.4",
|
|
90
97
|
"ai": "^7.0.14",
|
|
91
98
|
"archiver": "^8.0.0",
|