impeccable 4.0.3 → 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 +35 -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
|
|
@@ -184,6 +194,18 @@ cp -r dist/claude-code/.claude/* ~/.claude/
|
|
|
184
194
|
cp -r dist/opencode/.opencode your-project/
|
|
185
195
|
```
|
|
186
196
|
|
|
197
|
+
**DeepSeek Harness:**
|
|
198
|
+
```bash
|
|
199
|
+
# Project-specific
|
|
200
|
+
cp -r dist/dsh/.dsh your-project/
|
|
201
|
+
|
|
202
|
+
# Or global (applies to all projects)
|
|
203
|
+
mkdir -p "${DSH_HOME:-$HOME/.dsh}/skills"
|
|
204
|
+
cp -r dist/dsh/.dsh/skills/* "${DSH_HOME:-$HOME/.dsh}/skills/"
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
The CLI honors `DSH_HOME` only when it resolves inside your home directory (or to home itself); otherwise it uses `~/.dsh`. An outside-home manual copy is not managed by `impeccable install/update`.
|
|
208
|
+
|
|
187
209
|
**Hermes Agent:**
|
|
188
210
|
```bash
|
|
189
211
|
# Global (applies to all projects; uses the active profile, or ~/.hermes by default)
|
|
@@ -385,6 +407,8 @@ Installed hook surfaces:
|
|
|
385
407
|
|
|
386
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.
|
|
387
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
|
+
|
|
388
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.
|
|
389
413
|
|
|
390
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`.
|
|
@@ -407,6 +431,8 @@ Codex requires one platform step that Impeccable cannot safely skip: open `/hook
|
|
|
407
431
|
|
|
408
432
|
Full hook docs: [impeccable.style/docs/hooks](https://impeccable.style/docs/hooks).
|
|
409
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
|
+
|
|
410
436
|
Manual copy commands are fallback/debug instructions. The normal path is:
|
|
411
437
|
|
|
412
438
|
```bash
|
|
@@ -414,6 +440,14 @@ npx impeccable install
|
|
|
414
440
|
npx impeccable update
|
|
415
441
|
```
|
|
416
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
|
+
|
|
417
451
|
## CLI
|
|
418
452
|
|
|
419
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.
|
|
@@ -444,6 +478,7 @@ Full detector docs: [impeccable.style/docs/detector](https://impeccable.style/do
|
|
|
444
478
|
- [Cursor](https://cursor.com)
|
|
445
479
|
- [Claude Code](https://claude.ai/code)
|
|
446
480
|
- [GitHub Copilot](https://github.com/features/copilot)
|
|
481
|
+
- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
|
|
447
482
|
- [Gemini CLI](https://github.com/google-gemini/gemini-cli)
|
|
448
483
|
- [Codex CLI](https://github.com/openai/codex)
|
|
449
484
|
- [Grok Build](https://x.ai/cli)
|
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",
|