impeccable 4.0.4 → 4.0.5
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 -0
- package/README.npm.md +1 -0
- package/README.repo.md +22 -0
- package/package.json +9 -7
package/README.md
CHANGED
|
@@ -81,6 +81,7 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
81
81
|
|
|
82
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.
|
|
83
83
|
- For URL scans, an installed Chrome, Chromium, or Edge (set `IMPECCABLE_BROWSER` to point at one).
|
|
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.
|
|
84
85
|
|
|
85
86
|
Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/<version>/`, then a download of the pinned version into that cache. Set `IMPECCABLE_BIN` to a local build to skip all of that.
|
|
86
87
|
|
package/README.npm.md
CHANGED
|
@@ -81,6 +81,7 @@ impeccable detect [options] [file-or-dir-or-url...]
|
|
|
81
81
|
|
|
82
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.
|
|
83
83
|
- For URL scans, an installed Chrome, Chromium, or Edge (set `IMPECCABLE_BROWSER` to point at one).
|
|
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.
|
|
84
85
|
|
|
85
86
|
Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/<version>/`, then a download of the pinned version into that cache. Set `IMPECCABLE_BIN` to a local build to skip all of that.
|
|
86
87
|
|
package/README.repo.md
CHANGED
|
@@ -139,6 +139,16 @@ npx impeccable link --source=.impeccable --providers=claude,cursor
|
|
|
139
139
|
|
|
140
140
|
### Option 3: Plugin install
|
|
141
141
|
|
|
142
|
+
**GitHub Copilot in VS Code:**
|
|
143
|
+
|
|
144
|
+
Install [Impeccable from the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=renaissance-geek.impeccable), or run:
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
code --install-extension renaissance-geek.impeccable
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Requires VS Code 1.109.3+, Copilot Chat access, and a trusted local workspace. Open Chat in Agent mode and try `/impeccable polish`. This skill-only extension does not install automatic hooks; avoid a duplicate Impeccable skill in the same workspace/profile. See [VS Code distribution details](docs/VSCODE-EXTENSION.md).
|
|
151
|
+
|
|
142
152
|
**Claude Code:**
|
|
143
153
|
```bash
|
|
144
154
|
/plugin marketplace add pbakaus/impeccable
|
|
@@ -397,6 +407,8 @@ Installed hook surfaces:
|
|
|
397
407
|
|
|
398
408
|
Every command goes through the launcher shipped in the skill's `scripts/` directory (`impeccable`, or `impeccable.cmd` on Windows), guarded so a missing launcher is a silent no-op. The launcher runs the engine binary that ships next to it, or downloads the pinned version once into `~/.impeccable/bin/`. No Node or other runtime is required for the hook or the skill.
|
|
399
409
|
|
|
410
|
+
In Claude Code, installed command hooks run independently of model-tool approval. The first edit or Stop event can therefore download and cache the engine even if the session denies the model's launcher command. Review installed hooks before unattended runs; to disable all Claude Code hooks for a run, pass `--settings '{"disableAllHooks": true}'`. See [Claude Code's hook security guidance](https://code.claude.com/docs/en/hooks#security-considerations).
|
|
411
|
+
|
|
400
412
|
The installer preserves unrelated hook entries and settings. If a hook manifest is malformed, install/update aborts by default; rerun with `--force` to back up the malformed file as `.bak` and replace it.
|
|
401
413
|
|
|
402
414
|
On an interactive `install`/`update`, Impeccable explains the hook and offers to install it (default yes). Your choice is remembered per-developer in the gitignored `.impeccable/config.local.json`, so you are not asked again; `--no-hooks` skips it for that run without recording anything. Hook lifecycle settings live under the `hook` key of `.impeccable/config.json`; detector ignores live under `detector`, shared by `/impeccable hooks` and `npx impeccable detect`.
|
|
@@ -419,6 +431,8 @@ Codex requires one platform step that Impeccable cannot safely skip: open `/hook
|
|
|
419
431
|
|
|
420
432
|
Full hook docs: [impeccable.style/docs/hooks](https://impeccable.style/docs/hooks).
|
|
421
433
|
|
|
434
|
+
The Stop pass suppresses confirmed pre-existing findings when a verified before-edit baseline is available (currently Claude Edit/Write results for text scans). Other findings are marked new or attribution unknown; unknown is not evidence that your session caused the problem. Explicit `detect` scans remain unchanged.
|
|
435
|
+
|
|
422
436
|
Manual copy commands are fallback/debug instructions. The normal path is:
|
|
423
437
|
|
|
424
438
|
```bash
|
|
@@ -426,6 +440,14 @@ npx impeccable install
|
|
|
426
440
|
npx impeccable update
|
|
427
441
|
```
|
|
428
442
|
|
|
443
|
+
## Live mode and production sites
|
|
444
|
+
|
|
445
|
+
Live mode edits a local checkout through a development server or local static HTML. Injecting its localhost HTTP helper into a deployed production site, including an HTTPS site, is not supported. Do not disable browser security or weaken production CSP to make it work.
|
|
446
|
+
|
|
447
|
+
Use live mode only in projects you trust to run locally. Applying copy edits automatically runs `package.json`'s optional `scripts["impeccable:manual-edit-validate"]` command in a shell, with your user permissions; review that script before using live mode in an unfamiliar checkout.
|
|
448
|
+
|
|
449
|
+
For production inspection, use `npx impeccable detect https://example.com` or the browser extension. These inspect the rendered page; they do not provide live variant editing or write changes back to your source.
|
|
450
|
+
|
|
429
451
|
## CLI
|
|
430
452
|
|
|
431
453
|
Impeccable includes a standalone CLI for detecting anti-patterns without an AI harness. `npx impeccable` is a small shim that runs the same engine binary the skill uses (installed as a platform-specific optional dependency, or fetched once into `~/.impeccable/bin/`); Node is needed only for `npx` itself, and you can also download the binary directly and put it on your PATH.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "4.0.
|
|
3
|
+
"version": "4.0.5",
|
|
4
4
|
"author": "Paul Bakaus",
|
|
5
5
|
"description": "Design skills, commands, and anti-pattern detection for AI coding agents",
|
|
6
6
|
"keywords": [
|
|
@@ -40,6 +40,7 @@
|
|
|
40
40
|
"build": "bun run build:skills && mkdir -p build/_data && rm -rf build/_data/dist && cp -R dist build/_data/dist",
|
|
41
41
|
"build:release": "bun run build:skills:release && mkdir -p build/_data && rm -rf build/_data/dist && cp -R dist build/_data/dist",
|
|
42
42
|
"build:extension": "node scripts/build-extension.js",
|
|
43
|
+
"package:vscode": "bun run build:skills && cd dist/vscode && bunx --package @vscode/vsce@3.9.2 vsce package --no-dependencies",
|
|
43
44
|
"fetch:engine": "node scripts/fetch-engine.mjs",
|
|
44
45
|
"clean": "rm -rf dist build",
|
|
45
46
|
"rebuild": "bun run clean && bun run build",
|
|
@@ -58,6 +59,7 @@
|
|
|
58
59
|
"test:new-work-e2e": "node scripts/run-tests.mjs new-work-e2e",
|
|
59
60
|
"test:live-e2e-agent": "node scripts/run-tests.mjs live-e2e-agent",
|
|
60
61
|
"test:skill-behavior": "node scripts/run-tests.mjs skill-behavior",
|
|
62
|
+
"test:skill-workflow": "node scripts/run-tests.mjs skill-workflow",
|
|
61
63
|
"test:live-svelte-adapter-deepseek": "node scripts/run-tests.mjs live-svelte-adapter-deepseek",
|
|
62
64
|
"smoke:hooks": "node scripts/smoke-provider-hooks.mjs",
|
|
63
65
|
"audit": "bun audit --audit-level=moderate",
|
|
@@ -71,18 +73,18 @@
|
|
|
71
73
|
"check:engine-release": "node scripts/check-engine-release.mjs"
|
|
72
74
|
},
|
|
73
75
|
"optionalDependencies": {
|
|
74
|
-
"@impeccable/cli-darwin-arm64": "0.1.
|
|
75
|
-
"@impeccable/cli-darwin-x64": "0.1.
|
|
76
|
-
"@impeccable/cli-linux-x64": "0.1.
|
|
77
|
-
"@impeccable/cli-linux-arm64": "0.1.
|
|
78
|
-
"@impeccable/cli-windows-x64": "0.1.
|
|
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"
|
|
79
81
|
},
|
|
80
82
|
"devDependencies": {
|
|
81
83
|
"@ai-sdk/anthropic": "^4.0.7",
|
|
82
84
|
"@ai-sdk/google": "^4.0.8",
|
|
83
85
|
"@ai-sdk/openai": "^4.0.7",
|
|
84
86
|
"@anthropic-ai/claude-agent-sdk": "^0.3.165",
|
|
85
|
-
"@anthropic-ai/sdk": "^0.
|
|
87
|
+
"@anthropic-ai/sdk": "^0.123.0",
|
|
86
88
|
"@babel/parser": "^8.0.4",
|
|
87
89
|
"ai": "^7.0.14",
|
|
88
90
|
"archiver": "^8.0.0",
|