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 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",
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.2",
75
- "@impeccable/cli-darwin-x64": "0.1.2",
76
- "@impeccable/cli-linux-x64": "0.1.2",
77
- "@impeccable/cli-linux-arm64": "0.1.2",
78
- "@impeccable/cli-windows-x64": "0.1.2"
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.122.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",