vigiles 3.0.0 → 4.0.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/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +14 -12
- package/action.yml +3 -3
- package/dist/cli.d.ts +1 -1
- package/dist/cli.js +384 -159
- package/dist/setup-plan.d.ts +47 -7
- package/dist/setup-plan.js +104 -29
- package/package.json +1 -1
- package/skills/audit-feedback-loop/SKILL.md +0 -76
- package/skills/enforce-rules-format/SKILL.md +0 -71
- package/skills/generate-logo/SKILL.md +0 -103
- package/skills/pr-to-lint-rule/SKILL.md +0 -97
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
{
|
|
8
8
|
"name": "vigiles",
|
|
9
9
|
"source": "./",
|
|
10
|
-
"description": "
|
|
11
|
-
"version": "
|
|
10
|
+
"description": "Verify CLAUDE.md/AGENTS.md references, compile typed specs, and test the agent harness",
|
|
11
|
+
"version": "3.0.0"
|
|
12
12
|
}
|
|
13
13
|
]
|
|
14
14
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vigiles",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
|
+
"description": "Verify CLAUDE.md/AGENTS.md references, compile typed specs, and test the agent harness",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "zernie"
|
|
7
7
|
},
|
package/README.md
CHANGED
|
@@ -27,16 +27,16 @@ deterministic layer for the harness: it **lints** the references your instructio
|
|
|
27
27
|
files make and **tests** that your hooks and skills actually fire. Two independent
|
|
28
28
|
pillars — adopt either, or both:
|
|
29
29
|
|
|
30
|
-
| | Pillar
|
|
31
|
-
| ----- |
|
|
32
|
-
| **①** | **
|
|
33
|
-
| **②** | **Test your harness**
|
|
30
|
+
| | Pillar | What it does |
|
|
31
|
+
| ----- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
32
|
+
| **①** | **Lint your instruction files** | Every linter rule, file path, script, and code symbol your CLAUDE.md cites is checked against reality, so stale references can't silently mislead the agent. → [guide](docs/verifying-instruction-files.md) |
|
|
33
|
+
| **②** | **Test your harness** | Your hooks and skills are code — vigiles tests they actually fire, **deterministically and free** (no model, no API key) before you pay for an eval. → [guide](docs/harness-testing.md) |
|
|
34
34
|
|
|
35
35
|
Neither pillar depends on the other — pick the one that hurts today. **Works with
|
|
36
36
|
Claude Code and Codex** ([`vigiles/codex`](docs/harnesses.md)) behind a five-port
|
|
37
37
|
adapter; [custom adapters welcome](docs/authoring-an-adapter.md).
|
|
38
38
|
|
|
39
|
-
## ①
|
|
39
|
+
## ① Lint — your CLAUDE.md lies to your agent
|
|
40
40
|
|
|
41
41
|
Your CLAUDE.md says _"enforce `eslint/no-console`."_ But it was switched off
|
|
42
42
|
months ago — and the agent trusts the claim. (Same story for the file path it
|
|
@@ -44,7 +44,7 @@ cites that got renamed, and the script that was deleted.)
|
|
|
44
44
|
|
|
45
45
|
**Without vigiles:** nobody checks. The agent acts on fiction.
|
|
46
46
|
|
|
47
|
-
**With vigiles:** `npx vigiles
|
|
47
|
+
**With vigiles:** `npx vigiles lint` resolves every reference against reality —
|
|
48
48
|
|
|
49
49
|
```text
|
|
50
50
|
CLAUDE.md (inline mode):
|
|
@@ -118,19 +118,21 @@ It's interactive in a terminal and non-interactive for agents/CI (or with
|
|
|
118
118
|
`--yes`), so "set up vigiles" from a Claude Code / Codex prompt Just Works — and
|
|
119
119
|
it installs a model-invocable **`test-harness` skill**, so afterward you can just
|
|
120
120
|
tell your agent _"test my skills"_ and it picks the tier and writes the test.
|
|
121
|
-
Scope `init` with `--
|
|
122
|
-
JS **or** TS (`*.harness.{mjs,ts}`) and run `npx vigiles test`.
|
|
123
|
-
|
|
121
|
+
Scope `init` with `--lint` / `--test` (one pillar or both). Or write harness
|
|
122
|
+
tests yourself in JS **or** TS (`*.harness.{mjs,ts}`) and run `npx vigiles test`.
|
|
123
|
+
`init` also adds `vigiles` to your `devDependencies` and installs the Claude Code
|
|
124
|
+
plugin (skills + hooks) via the marketplace — globally, never vendored into your
|
|
125
|
+
repo. It wires CI as a `zernie/vigiles@v1` workflow — a composite over the same CLI:
|
|
124
126
|
|
|
125
127
|
```yaml
|
|
126
128
|
- uses: actions/checkout@v4
|
|
127
|
-
- uses: zernie/vigiles@v1 #
|
|
129
|
+
- uses: zernie/vigiles@v1 # lints by default; posts a sticky PR comment + a `valid` output
|
|
128
130
|
```
|
|
129
131
|
|
|
130
132
|
## More
|
|
131
133
|
|
|
132
|
-
- **[CLI & GitHub Action →](docs/cli.md)** — every command, the Action (inputs / output / versioning), the Claude Code plugin, and the five `
|
|
133
|
-
- **[Skills →](docs/skills.md)** —
|
|
134
|
+
- **[CLI & GitHub Action →](docs/cli.md)** — every command, the Action (inputs / output / versioning), the Claude Code plugin, and the five `lint` rules.
|
|
135
|
+
- **[Skills →](docs/skills.md)** — consumer skills (`strengthen`, `migrate-to-spec`, `test-harness`, `edit-spec`, …) installed as a Claude Code plugin: `/plugin marketplace add zernie/vigiles` then `/plugin install vigiles@vigiles` (or let `vigiles init` do it).
|
|
134
136
|
- **[Docs index →](docs/README.md)** · **[Research →](research/README.md)** · **[Related tools →](docs/related-tools.md)** (ast-grep, Dependency Cruiser, Ruler, rulesync).
|
|
135
137
|
- Companion to [Feedback Loop Is All You Need](https://zernie.com/blog/feedback-loop-is-all-you-need).
|
|
136
138
|
|
package/action.yml
CHANGED
|
@@ -7,9 +7,9 @@ branding:
|
|
|
7
7
|
|
|
8
8
|
inputs:
|
|
9
9
|
command:
|
|
10
|
-
description: "Which vigiles command to run: '
|
|
10
|
+
description: "Which vigiles command to run: 'lint' (verify references + integrity + coverage) or 'compile' (specs → markdown)."
|
|
11
11
|
required: false
|
|
12
|
-
default: "
|
|
12
|
+
default: "lint"
|
|
13
13
|
paths:
|
|
14
14
|
description: "Comma- or space-separated paths to operate on (.md files for audit, .spec.ts files for compile). Auto-discovers when empty."
|
|
15
15
|
required: false
|
|
@@ -64,7 +64,7 @@ runs:
|
|
|
64
64
|
run: |
|
|
65
65
|
set -euo pipefail
|
|
66
66
|
|
|
67
|
-
cmd="${VIGILES_COMMAND:-
|
|
67
|
+
cmd="${VIGILES_COMMAND:-lint}"
|
|
68
68
|
args=("$cmd")
|
|
69
69
|
|
|
70
70
|
# paths: split on commas and whitespace into positional args.
|
package/dist/cli.d.ts
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* Commands:
|
|
6
6
|
* vigiles init — scaffold a spec from scratch
|
|
7
7
|
* vigiles compile — compile .spec.ts → .md with linter verification
|
|
8
|
-
* vigiles
|
|
8
|
+
* vigiles lint — verify hashes, report coverage, detect duplicates
|
|
9
9
|
* vigiles generate-types — emit .d.ts with types from project state
|
|
10
10
|
*/
|
|
11
11
|
export {};
|