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.
@@ -7,8 +7,8 @@
7
7
  {
8
8
  "name": "vigiles",
9
9
  "source": "./",
10
- "description": "Validate CLAUDE.md, audit feedback loops, and generate lint rules from PR comments",
11
- "version": "1.0.0"
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": "1.0.0",
4
- "description": "Validate CLAUDE.md, audit feedback loops, and generate lint rules from PR comments",
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 | What it does |
31
- | ----- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
32
- | **①** | **Verify 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) |
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
- ## ① Verify — your CLAUDE.md lies to your agent
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 audit` resolves every reference against reality —
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 `--pillars=verify|test|both`. Or write harness tests yourself in
122
- JS **or** TS (`*.harness.{mjs,ts}`) and run `npx vigiles test`. `init` wires CI as
123
- a `zernie/vigiles@v1` workflow a composite over the same CLI:
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 # audits by default; posts a sticky PR comment + a `valid` output
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 `audit` rules.
133
- - **[Skills →](docs/skills.md)** — 8 skills (`strengthen`, `migrate-to-spec`, `test-harness`, …) via `npx skills add zernie/vigiles`.
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: 'audit' (verify references + integrity + coverage) or 'compile' (specs → markdown)."
10
+ description: "Which vigiles command to run: 'lint' (verify references + integrity + coverage) or 'compile' (specs → markdown)."
11
11
  required: false
12
- default: "audit"
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:-audit}"
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 audit — verify hashes, report coverage, detect duplicates
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 {};