impeccable 4.6.0 → 4.8.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 +13 -6
- package/README.npm.md +13 -6
- package/README.repo.md +21 -8
- package/cli/bin/cli.js +36 -15
- package/package.json +10 -7
- package/skill/scripts/engine-checksums.txt +9 -0
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable CLI
|
|
2
2
|
|
|
3
|
-
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for
|
|
3
|
+
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 62 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
|
|
4
4
|
|
|
5
5
|
The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
|
|
6
6
|
|
|
@@ -36,6 +36,11 @@ npx impeccable detect https://example.com
|
|
|
36
36
|
|
|
37
37
|
# JSON output for CI/tooling
|
|
38
38
|
npx impeccable detect --json src/
|
|
39
|
+
|
|
40
|
+
# GitHub Actions annotations
|
|
41
|
+
npx impeccable detect --github src/
|
|
42
|
+
# Catalog of detector rules (no scan)
|
|
43
|
+
npx impeccable detect --list-rules
|
|
39
44
|
```
|
|
40
45
|
|
|
41
46
|
`npx impeccable skills <command>` is the legacy namespace and still works.
|
|
@@ -57,7 +62,7 @@ npx impeccable detect --json src/
|
|
|
57
62
|
|
|
58
63
|
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
59
64
|
|
|
60
|
-
|
|
65
|
+
62 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
|
|
61
66
|
|
|
62
67
|
## Exit Codes
|
|
63
68
|
|
|
@@ -65,16 +70,18 @@ npx impeccable detect --json src/
|
|
|
65
70
|
- `1`: at least one requested target could not be scanned
|
|
66
71
|
- `2`: scan completed with primary findings
|
|
67
72
|
|
|
68
|
-
Operational failure takes precedence when a multi-target scan is partial. In JSON mode, stdout remains a findings array and diagnostics are written to stderr.
|
|
73
|
+
Operational failure takes precedence when a multi-target scan is partial. In JSON mode, stdout remains a findings array and diagnostics are written to stderr. With `--github`, stdout is one GitHub Actions annotation per finding; GitHub displays at most 10 annotations of each type per step and 50 per job, and the rest stay in the log.
|
|
69
74
|
|
|
70
75
|
## Options
|
|
71
76
|
|
|
72
77
|
```
|
|
73
78
|
impeccable detect [options] [file-or-dir-or-url...]
|
|
74
79
|
|
|
75
|
-
--json
|
|
76
|
-
--
|
|
77
|
-
--
|
|
80
|
+
--json Output findings as JSON
|
|
81
|
+
--github Write GitHub Actions annotations for each finding
|
|
82
|
+
--list-rules Print the detector rule catalog and exit
|
|
83
|
+
--scope Only report rules in a design domain (type, layout)
|
|
84
|
+
--help Show help
|
|
78
85
|
```
|
|
79
86
|
|
|
80
87
|
## Requirements
|
package/README.npm.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable CLI
|
|
2
2
|
|
|
3
|
-
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for
|
|
3
|
+
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 62 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
|
|
4
4
|
|
|
5
5
|
The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
|
|
6
6
|
|
|
@@ -36,6 +36,11 @@ npx impeccable detect https://example.com
|
|
|
36
36
|
|
|
37
37
|
# JSON output for CI/tooling
|
|
38
38
|
npx impeccable detect --json src/
|
|
39
|
+
|
|
40
|
+
# GitHub Actions annotations
|
|
41
|
+
npx impeccable detect --github src/
|
|
42
|
+
# Catalog of detector rules (no scan)
|
|
43
|
+
npx impeccable detect --list-rules
|
|
39
44
|
```
|
|
40
45
|
|
|
41
46
|
`npx impeccable skills <command>` is the legacy namespace and still works.
|
|
@@ -57,7 +62,7 @@ npx impeccable detect --json src/
|
|
|
57
62
|
|
|
58
63
|
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
59
64
|
|
|
60
|
-
|
|
65
|
+
62 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
|
|
61
66
|
|
|
62
67
|
## Exit Codes
|
|
63
68
|
|
|
@@ -65,16 +70,18 @@ npx impeccable detect --json src/
|
|
|
65
70
|
- `1`: at least one requested target could not be scanned
|
|
66
71
|
- `2`: scan completed with primary findings
|
|
67
72
|
|
|
68
|
-
Operational failure takes precedence when a multi-target scan is partial. In JSON mode, stdout remains a findings array and diagnostics are written to stderr.
|
|
73
|
+
Operational failure takes precedence when a multi-target scan is partial. In JSON mode, stdout remains a findings array and diagnostics are written to stderr. With `--github`, stdout is one GitHub Actions annotation per finding; GitHub displays at most 10 annotations of each type per step and 50 per job, and the rest stay in the log.
|
|
69
74
|
|
|
70
75
|
## Options
|
|
71
76
|
|
|
72
77
|
```
|
|
73
78
|
impeccable detect [options] [file-or-dir-or-url...]
|
|
74
79
|
|
|
75
|
-
--json
|
|
76
|
-
--
|
|
77
|
-
--
|
|
80
|
+
--json Output findings as JSON
|
|
81
|
+
--github Write GitHub Actions annotations for each finding
|
|
82
|
+
--list-rules Print the detector rule catalog and exit
|
|
83
|
+
--scope Only report rules in a design domain (type, layout)
|
|
84
|
+
--help Show help
|
|
78
85
|
```
|
|
79
86
|
|
|
80
87
|
## Requirements
|
package/README.repo.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable
|
|
2
2
|
|
|
3
|
-
Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and
|
|
3
|
+
Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and 62 deterministic detector rules for AI-generated frontend design.
|
|
4
4
|
|
|
5
5
|
> **Quick start:** From your project root, run `npx impeccable install`, then run `/impeccable init` inside your AI coding tool. Full docs: [impeccable.style](https://impeccable.style).
|
|
6
6
|
|
|
@@ -13,7 +13,7 @@ Every model trained on the same SaaS templates. Skip the guidance and you get th
|
|
|
13
13
|
Impeccable adds:
|
|
14
14
|
- **One setup flow.** `/impeccable init` records durable product truth in `PRODUCT.md`, so later commands know the audience, purpose, operating context, constraints, voice, and evidence without confusing those facts with surface-level visual direction.
|
|
15
15
|
- **24 commands.** A shared design vocabulary with your AI: `polish`, `audit`, `critique`, `distill`, `animate`, `bolder`, `quieter`, and more.
|
|
16
|
-
- **
|
|
16
|
+
- **62 deterministic detector rules** plus LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key.
|
|
17
17
|
|
|
18
18
|
## What's Included
|
|
19
19
|
|
|
@@ -106,7 +106,7 @@ From the root of your project, run:
|
|
|
106
106
|
npx impeccable install
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
This shows the harness folders or installed CLIs it detected (for example `~/.claude`, `~/.codex`, `~/.grok`, `~/.hermes`, `~/.veto`, or project-local `.cursor`), lets you keep the detected set or customize providers, then asks whether to install into the current project or globally. Use `--providers=claude,codex,cursor,grok,hermes,veto` and `--scope=project|global` to skip those choices in scripts. On Claude Code, Cursor, Codex, GitHub Copilot, and Grok Build, it also installs the provider-native hook manifest for the current project. Veto receives the packaged skill under `~/.veto/skills/` and does not run native Impeccable edit hooks. Works with Cursor, Claude Code, Gemini CLI, Codex CLI, Grok Build, Hermes Agent, Veto, and every other supported tool. Reload your harness afterward.
|
|
109
|
+
This shows the harness folders or installed CLIs it detected (for example `~/.claude`, `~/.codex`, `~/.grok`, `~/.hermes`, `~/.veto`, or project-local `.cursor`), lets you keep the detected set or customize providers, then asks whether to install into the current project or globally. Use `--providers=claude,codex,replit,cursor,grok,hermes,veto` and `--scope=project|global` to skip those choices in scripts. On Claude Code, Cursor, Codex, GitHub Copilot, and Grok Build, it also installs the provider-native hook manifest for the current project. Veto receives the packaged skill under `~/.veto/skills/` and does not run native Impeccable edit hooks. Works with Cursor, Claude Code, Gemini CLI, Codex CLI, Replit Agent, Grok Build, Hermes Agent, Veto, and every other supported tool. Reload your harness afterward.
|
|
110
110
|
|
|
111
111
|
To refresh an existing install, run:
|
|
112
112
|
|
|
@@ -129,7 +129,7 @@ git add .gitmodules .impeccable .claude .cursor
|
|
|
129
129
|
git commit -m "Add Impeccable skills"
|
|
130
130
|
```
|
|
131
131
|
|
|
132
|
-
Use the providers your project needs, for example `claude`, `cursor`, `gemini`, `codex`, `github`, `grok`, `hermes`, `opencode`, `pi`, `qoder`, `trae`, `trae-cn`, `rovo-dev`, `vibe`, or `veto`. The command links individual skill folders from `.impeccable/dist/universal/` and leaves existing real skill directories untouched unless you pass `--force`.
|
|
132
|
+
Use the providers your project needs, for example `claude`, `cursor`, `gemini`, `codex`, `github`, `grok`, `devin`, `hermes`, `opencode`, `pi`, `qoder`, `trae`, `trae-cn`, `rovo-dev`, `vibe`, or `veto`. The command links individual skill folders from `.impeccable/dist/universal/` and leaves existing real skill directories untouched unless you pass `--force`.
|
|
133
133
|
|
|
134
134
|
To update later:
|
|
135
135
|
|
|
@@ -207,6 +207,16 @@ cp -r dist/dsh/.dsh/skills/* "${DSH_HOME:-$HOME/.dsh}/skills/"
|
|
|
207
207
|
|
|
208
208
|
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`.
|
|
209
209
|
|
|
210
|
+
**Devin:**
|
|
211
|
+
```bash
|
|
212
|
+
# Project-specific (Devin web, CLI, and Desktop all read .devin/skills/)
|
|
213
|
+
cp -r dist/devin/.devin your-project/
|
|
214
|
+
|
|
215
|
+
# Or global (Devin CLI and Desktop; use %APPDATA%\devin\skills on Windows)
|
|
216
|
+
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/devin/skills"
|
|
217
|
+
cp -r dist/devin/.devin/skills/* "${XDG_CONFIG_HOME:-$HOME/.config}/devin/skills/"
|
|
218
|
+
```
|
|
219
|
+
|
|
210
220
|
**Hermes Agent:**
|
|
211
221
|
```bash
|
|
212
222
|
# Global (applies to all projects; uses the active profile, or ~/.hermes by default)
|
|
@@ -411,13 +421,13 @@ To turn it off, run `npx impeccable telemetry off` (stored in `~/.impeccable/con
|
|
|
411
421
|
|
|
412
422
|
## Design hook
|
|
413
423
|
|
|
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
|
|
424
|
+
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, Codex, and Cursor 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.
|
|
415
425
|
|
|
416
426
|
Installed hook surfaces:
|
|
417
427
|
|
|
418
428
|
- Claude Code: `.claude/settings.local.json` (gitignored, machine-local) runs `${CLAUDE_PROJECT_DIR}/.claude/skills/impeccable/scripts/impeccable hook`. A hook moved into the shared `settings.json` is honored in place.
|
|
419
429
|
- GitHub Copilot: `.github/hooks/impeccable.json` (committed, shared by the Copilot CLI and the cloud agent) runs `.github/skills/impeccable/scripts/impeccable hook`. The Copilot CLI activates it once the file is on the repository's default branch and the folder is trusted.
|
|
420
|
-
- Cursor: `.cursor/hooks.json` runs `.cursor/skills/impeccable/scripts/impeccable hook-
|
|
430
|
+
- Cursor: `.cursor/hooks.json` runs `.cursor/skills/impeccable/scripts/impeccable hook` on `postToolUse` for file writes. Projects set up with the older `preToolUse` write gate keep working; `npx impeccable update` moves them to the post-edit hook.
|
|
421
431
|
- Codex: `.codex/hooks.json` runs `.agents/skills/impeccable/scripts/impeccable hook`, with a `commandWindows` sibling that calls `impeccable.cmd` for cmd.exe.
|
|
422
432
|
- Grok Build: `.grok/hooks/impeccable.json` runs `.grok/skills/impeccable/scripts/impeccable hook`. Requires `/hooks-trust` or `--trust`. Findings reach the model on Stop, not after each edit.
|
|
423
433
|
|
|
@@ -473,15 +483,17 @@ npx impeccable detect src/ # scan a directory
|
|
|
473
483
|
npx impeccable detect index.html # scan an HTML file
|
|
474
484
|
npx impeccable detect https://example.com # scan a URL (uses an installed Chrome, Chromium, or Edge)
|
|
475
485
|
npx impeccable detect --json . # CI-friendly JSON output
|
|
486
|
+
npx impeccable detect --github src/ # GitHub Actions annotations on stdout
|
|
487
|
+
npx impeccable detect --list-rules # catalog of detector rule ids, names, and descriptions
|
|
476
488
|
npx impeccable detect --no-config src/ # raw scan, ignoring project config/context
|
|
477
489
|
npx impeccable ignores list # show detector ignores
|
|
478
490
|
npx impeccable ignores add-file "src/legacy/**"
|
|
479
491
|
npx impeccable ignores add-value overused-font Inter --reason "Brand font"
|
|
480
492
|
```
|
|
481
493
|
|
|
482
|
-
The detector catches
|
|
494
|
+
The detector catches 62 deterministic issues across AI slop (side-tab borders, purple gradients, bounce easing, dark glows) and general design quality (line length, cramped padding, small touch targets, skipped headings, and more).
|
|
483
495
|
|
|
484
|
-
Human-readable findings are diagnostics written to stderr, so redirect them with `2> findings.txt`. Use `--json` for machine-readable results on stdout. Exit `0` means the scan completed without primary findings, exit `2` means it completed with primary findings, and exit `1` means at least one requested target could not be scanned; operational failure takes precedence for a partial multi-target scan. URL scans inspect the rendered DOM, computed layout, and accessible linked stylesheets; browser security still prevents reading cross-origin CSS without CORS. A clean detector run is evidence, not proof of visual or accessibility quality: it does not replace inspecting the rendered experience across relevant viewports.
|
|
496
|
+
Human-readable findings are diagnostics written to stderr, so redirect them with `2> findings.txt`. Use `--json` for machine-readable results on stdout, or `--github` for GitHub Actions annotations (one workflow command per finding). GitHub displays at most 10 annotations of each type per step and 50 per job, and the rest stay in the log; findings from the HTML engine may carry no line number, so they annotate the file. `--list-rules` prints the detector catalog to stdout and does not scan. Exit `0` means the scan completed without primary findings, exit `2` means it completed with primary findings, and exit `1` means at least one requested target could not be scanned; operational failure takes precedence for a partial multi-target scan. URL scans inspect the rendered DOM, computed layout, and accessible linked stylesheets; browser security still prevents reading cross-origin CSS without CORS. A clean detector run is evidence, not proof of visual or accessibility quality: it does not replace inspecting the rendered experience across relevant viewports.
|
|
485
497
|
|
|
486
498
|
By default, `detect` respects the same `.impeccable/config.json` and `.impeccable/config.local.json` detector config as the design hook: `detector.ignoreRules`, `detector.ignoreFiles`, `detector.ignoreValues`, and `detector.designSystem.enabled`. Hook lifecycle settings such as `hook.enabled` only affect automatic hook execution.
|
|
487
499
|
|
|
@@ -494,6 +506,7 @@ Full detector docs: [impeccable.style/docs/detector](https://impeccable.style/do
|
|
|
494
506
|
- [Cursor](https://cursor.com)
|
|
495
507
|
- [Claude Code](https://claude.ai/code)
|
|
496
508
|
- [GitHub Copilot](https://github.com/features/copilot)
|
|
509
|
+
- [Devin](https://devin.ai)
|
|
497
510
|
- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
|
|
498
511
|
- [Gemini CLI](https://github.com/google-gemini/gemini-cli)
|
|
499
512
|
- [Codex CLI](https://github.com/openai/codex)
|
package/cli/bin/cli.js
CHANGED
|
@@ -2,13 +2,16 @@
|
|
|
2
2
|
// `impeccable` npm shim: finds the platform binary and execs it with argv.
|
|
3
3
|
// Order: $IMPECCABLE_BIN, the @impeccable/cli-<os>-<arch> optional dependency,
|
|
4
4
|
// the version-pinned user cache (~/.impeccable/bin/<version>/), then a
|
|
5
|
-
// download into that cache from the public release channel.
|
|
5
|
+
// download into that cache from the public release channel. The cache and the
|
|
6
|
+
// download are verified against skill/scripts/engine-checksums.txt (shipped in
|
|
7
|
+
// the package); a <binary>.verified stamp records that a cached binary passed.
|
|
6
8
|
import { spawnSync } from 'node:child_process';
|
|
7
9
|
import { createHash } from 'node:crypto';
|
|
8
10
|
import fs from 'node:fs';
|
|
9
11
|
import { createRequire } from 'node:module';
|
|
10
12
|
import os from 'node:os';
|
|
11
13
|
import path from 'node:path';
|
|
14
|
+
import { fileURLToPath } from 'node:url';
|
|
12
15
|
|
|
13
16
|
const require = createRequire(import.meta.url);
|
|
14
17
|
const pkg = require('../../package.json');
|
|
@@ -22,29 +25,37 @@ const VERSION = String(pkg.optionalDependencies?.[PLATFORM_PKG] || Object.values
|
|
|
22
25
|
const CACHE_ROOT = process.env.IMPECCABLE_HOME || path.join(os.homedir(), '.impeccable');
|
|
23
26
|
const CACHED = path.join(CACHE_ROOT, 'bin', VERSION, EXE);
|
|
24
27
|
const BASE = (process.env.IMPECCABLE_DOWNLOAD_BASE || 'https://github.com/pbakaus/impeccable/releases/download').replace(/\/$/, '');
|
|
25
|
-
const
|
|
28
|
+
const ASSET = `impeccable-${TARGET}${OS === 'windows' ? '.exe' : ''}`;
|
|
29
|
+
const URL = `${BASE}/engine-v${VERSION}/${ASSET}`;
|
|
30
|
+
const MANIFEST = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'skill', 'scripts', 'engine-checksums.txt');
|
|
31
|
+
const STAMP = `${CACHED}.verified`;
|
|
26
32
|
|
|
27
33
|
function exists(p) { try { return !!p && fs.statSync(p).isFile(); } catch { return false; } }
|
|
34
|
+
// The digest MANIFEST records for this version and asset, or '' when none.
|
|
35
|
+
function expectedDigest() {
|
|
36
|
+
try {
|
|
37
|
+
for (const line of fs.readFileSync(MANIFEST, 'utf8').split(/\r?\n/)) {
|
|
38
|
+
const [version, asset, sum] = line.trim().split(/\s+/);
|
|
39
|
+
if (version === VERSION && asset === ASSET) return (sum || '').toLowerCase();
|
|
40
|
+
}
|
|
41
|
+
} catch { /* no manifest: nothing verifies */ }
|
|
42
|
+
return '';
|
|
43
|
+
}
|
|
28
44
|
function fromPackage() {
|
|
29
45
|
try { return path.join(path.dirname(require.resolve(`${PLATFORM_PKG}/package.json`)), 'bin', EXE); } catch { return null; }
|
|
30
46
|
}
|
|
31
47
|
async function download() {
|
|
32
48
|
if (!VERSION) return null;
|
|
49
|
+
// Fail closed, like the skill launcher and `impeccable install`: no digest
|
|
50
|
+
// on record refuses the download before any request, and nothing is written
|
|
51
|
+
// until the hash matches, so a refusal leaves the cache dir untouched.
|
|
52
|
+
const expected = expectedDigest();
|
|
53
|
+
if (!expected) {
|
|
54
|
+
throw new Error(`no checksum for engine ${VERSION} (${ASSET}) in ${MANIFEST}; refusing the unverified download`);
|
|
55
|
+
}
|
|
33
56
|
const res = await fetch(URL, { redirect: 'follow' });
|
|
34
57
|
if (!res.ok) return null;
|
|
35
58
|
const buf = Buffer.from(await res.arrayBuffer());
|
|
36
|
-
// Fail closed, like the skill launcher and `impeccable install`: a sidecar
|
|
37
|
-
// that cannot be fetched, or that carries no hash, refuses the download
|
|
38
|
-
// instead of caching an unverified binary. Nothing is written until the
|
|
39
|
-
// hash matches, so a refusal leaves the cache dir untouched.
|
|
40
|
-
const sum = await fetch(`${URL}.sha256`, { redirect: 'follow' }).then(r => (r.ok ? r.text() : ''), () => '');
|
|
41
|
-
const expected = sum.trim().split(/\s+/)[0].toLowerCase();
|
|
42
|
-
if (!expected) {
|
|
43
|
-
throw new Error(
|
|
44
|
-
`cannot verify ${URL} against ${URL}.sha256 (sidecar unavailable or empty); `
|
|
45
|
-
+ 'refusing the unverified download',
|
|
46
|
-
);
|
|
47
|
-
}
|
|
48
59
|
if (createHash('sha256').update(buf).digest('hex') !== expected) {
|
|
49
60
|
throw new Error(`checksum mismatch downloading ${URL}`);
|
|
50
61
|
}
|
|
@@ -57,6 +68,7 @@ async function download() {
|
|
|
57
68
|
try { fs.rmSync(tmp, { force: true }); } catch { /* best effort */ }
|
|
58
69
|
throw err;
|
|
59
70
|
}
|
|
71
|
+
try { fs.writeFileSync(STAMP, `${expected}\n`); } catch { /* next run hashes again */ }
|
|
60
72
|
return CACHED;
|
|
61
73
|
}
|
|
62
74
|
async function locate() {
|
|
@@ -64,7 +76,16 @@ async function locate() {
|
|
|
64
76
|
if (exists(envBin)) return envBin;
|
|
65
77
|
const fromPkg = fromPackage();
|
|
66
78
|
if (exists(fromPkg)) return fromPkg;
|
|
67
|
-
if (exists(CACHED))
|
|
79
|
+
if (exists(CACHED)) {
|
|
80
|
+
if (exists(STAMP)) return CACHED;
|
|
81
|
+
let digest = '';
|
|
82
|
+
try { digest = createHash('sha256').update(fs.readFileSync(CACHED)).digest('hex'); } catch { /* unreadable: unverified */ }
|
|
83
|
+
if (digest && digest === expectedDigest()) {
|
|
84
|
+
try { fs.writeFileSync(STAMP, `${digest}\n`); } catch { /* read-only cache: verified this run */ }
|
|
85
|
+
return CACHED;
|
|
86
|
+
}
|
|
87
|
+
process.stderr.write(`impeccable: cannot verify the cached engine ${CACHED} against ${MANIFEST}; downloading engine ${VERSION} again\n`);
|
|
88
|
+
}
|
|
68
89
|
return download().catch((err) => { process.stderr.write(`impeccable: ${err.message}\n`); return null; });
|
|
69
90
|
}
|
|
70
91
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.8.0",
|
|
4
4
|
"author": "Paul Bakaus",
|
|
5
5
|
"description": "Design skills, commands, and anti-pattern detection for AI coding agents",
|
|
6
6
|
"keywords": [
|
|
@@ -39,6 +39,7 @@
|
|
|
39
39
|
},
|
|
40
40
|
"files": [
|
|
41
41
|
"cli/bin/",
|
|
42
|
+
"skill/scripts/engine-checksums.txt",
|
|
42
43
|
"LICENSE"
|
|
43
44
|
],
|
|
44
45
|
"scripts": {
|
|
@@ -66,8 +67,10 @@
|
|
|
66
67
|
"test:new-work-e2e": "node scripts/run-tests.mjs new-work-e2e",
|
|
67
68
|
"test:live-e2e-agent": "node scripts/run-tests.mjs live-e2e-agent",
|
|
68
69
|
"test:skill-behavior": "node scripts/run-tests.mjs skill-behavior",
|
|
70
|
+
"test:skill-activation": "node scripts/run-tests.mjs skill-activation",
|
|
69
71
|
"test:skill-workflow": "node scripts/run-tests.mjs skill-workflow",
|
|
70
72
|
"test:live-svelte-adapter-deepseek": "node scripts/run-tests.mjs live-svelte-adapter-deepseek",
|
|
73
|
+
"test:rust-changed": "node scripts/test-rust-changed.mjs",
|
|
71
74
|
"smoke:hooks": "node scripts/smoke-provider-hooks.mjs",
|
|
72
75
|
"audit": "bun audit --audit-level=moderate",
|
|
73
76
|
"prepack": "cp README.md README.repo.md && cp README.npm.md README.md",
|
|
@@ -81,18 +84,18 @@
|
|
|
81
84
|
"build:component-review": "bun scripts/build-component-review.mjs"
|
|
82
85
|
},
|
|
83
86
|
"optionalDependencies": {
|
|
84
|
-
"@impeccable/cli-darwin-arm64": "0.1.
|
|
85
|
-
"@impeccable/cli-darwin-x64": "0.1.
|
|
86
|
-
"@impeccable/cli-linux-x64": "0.1.
|
|
87
|
-
"@impeccable/cli-linux-arm64": "0.1.
|
|
88
|
-
"@impeccable/cli-windows-x64": "0.1.
|
|
87
|
+
"@impeccable/cli-darwin-arm64": "0.1.18",
|
|
88
|
+
"@impeccable/cli-darwin-x64": "0.1.18",
|
|
89
|
+
"@impeccable/cli-linux-x64": "0.1.18",
|
|
90
|
+
"@impeccable/cli-linux-arm64": "0.1.18",
|
|
91
|
+
"@impeccable/cli-windows-x64": "0.1.18"
|
|
89
92
|
},
|
|
90
93
|
"devDependencies": {
|
|
91
94
|
"@ai-sdk/anthropic": "^4.0.7",
|
|
92
95
|
"@ai-sdk/google": "^4.0.8",
|
|
93
96
|
"@ai-sdk/openai": "^4.0.7",
|
|
94
97
|
"@anthropic-ai/claude-agent-sdk": "^0.3.165",
|
|
95
|
-
"@anthropic-ai/sdk": "^
|
|
98
|
+
"@anthropic-ai/sdk": "^1.2.0",
|
|
96
99
|
"@babel/parser": "^8.0.4",
|
|
97
100
|
"ai": "^7.0.14",
|
|
98
101
|
"archiver": "^8.0.0",
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Engine binary digests for the pinned ENGINE_VERSION: <engine-version> <asset> <sha256>.
|
|
2
|
+
# The launchers, the npm shim, `impeccable install` and scripts/fetch-engine.mjs verify
|
|
3
|
+
# every engine download against this file. Written by
|
|
4
|
+
# `node scripts/check-engine-release.mjs --record` after each engine release.
|
|
5
|
+
0.1.18 impeccable-darwin-arm64 543ee2f72036ad185dc9991ac3ba86b74d91f988f3d497776a088b8b65c8a9e1
|
|
6
|
+
0.1.18 impeccable-darwin-x64 1f1eee78c142f7e40e16f481aeeeb1fad1d8515d8a1ef033d7c6d133e52232b3
|
|
7
|
+
0.1.18 impeccable-linux-x64 736ed785e74ae2344d3036127f614ddde5ab520a527d8bc82a891612ef71f648
|
|
8
|
+
0.1.18 impeccable-linux-arm64 317cb18d64b0f7715681dd6e574ad64b2adb5a6caf8e7a1b3b57965f805404be
|
|
9
|
+
0.1.18 impeccable-windows-x64.exe 8f61e96b0c97001546a824d79b44f46b423b560f3eb1a0cc44a8695a1b395d9f
|