impeccable 4.0.4 → 4.1.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 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.4",
3
+ "version": "4.1.0",
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.3",
75
- "@impeccable/cli-darwin-x64": "0.1.3",
76
- "@impeccable/cli-linux-x64": "0.1.3",
77
- "@impeccable/cli-linux-arm64": "0.1.3",
78
- "@impeccable/cli-windows-x64": "0.1.3"
76
+ "@impeccable/cli-darwin-arm64": "0.1.5",
77
+ "@impeccable/cli-darwin-x64": "0.1.5",
78
+ "@impeccable/cli-linux-x64": "0.1.5",
79
+ "@impeccable/cli-linux-arm64": "0.1.5",
80
+ "@impeccable/cli-windows-x64": "0.1.5"
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",