vigiles 3.0.0 → 4.0.1

package/.claude-plugin/marketplace.json

@@ -7,8 +7,8 @@
     {
       "name": "vigiles",
       "source": "./",
-      "description": "Validate CLAUDE.md, audit feedback loops, and generate lint rules from PR comments",
-      "version": "1.0.0"
+      "description": "Verify CLAUDE.md/AGENTS.md references, compile typed specs, and test the agent harness",
+      "version": "3.0.0"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vigiles",
-  "version": "1.0.0",
-  "description": "Validate CLAUDE.md, audit feedback loops, and generate lint rules from PR comments",
+  "version": "3.0.0",
+  "description": "Verify CLAUDE.md/AGENTS.md references, compile typed specs, and test the agent harness",
   "author": {
     "name": "zernie"
   },

package/README.md

@@ -27,16 +27,16 @@ deterministic layer for the harness: it **lints** the references your instructio
 files make and **tests** that your hooks and skills actually fire. Two independent
 pillars — adopt either, or both:
 
-|       | Pillar                            | What it does                                                                                                                                                                                                |
-| ----- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **①** | **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) |
-| **②** | **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)                     |
+|       | Pillar                          | What it does                                                                                                                                                                                                |
+| ----- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **①** | **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) |
+| **②** | **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)                     |
 
 Neither pillar depends on the other — pick the one that hurts today. **Works with
 Claude Code and Codex** ([`vigiles/codex`](docs/harnesses.md)) behind a five-port
 adapter; [custom adapters welcome](docs/authoring-an-adapter.md).
 
-## ① Verify — your CLAUDE.md lies to your agent
+## ① Lint — your CLAUDE.md lies to your agent
 
 Your CLAUDE.md says _"enforce `eslint/no-console`."_ But it was switched off
 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.)
 
 **Without vigiles:** nobody checks. The agent acts on fiction.
 
-**With vigiles:** `npx vigiles audit` resolves every reference against reality —
+**With vigiles:** `npx vigiles lint` resolves every reference against reality —
 
 ```text
 CLAUDE.md (inline mode):
@@ -100,13 +100,15 @@ hijacking unrelated ones (precision). **[Full guide →](docs/harness-testing.md
 
 ## Quick start
 
-> **Paste into Claude Code or Codex:**
->
-> > Install vigiles in this repo and run it. Verify my CLAUDE.md / AGENTS.md
-> > references and show me what's stale, then write and run a harness test for one
-> > of my hooks or skills. Use good defaults (both pillars, non-interactive), but
-> > **ask me first** whether to gate it in CI, whether to add a real-model eval,
-> > and whether to enforce strictly (`--strict`).
+**Paste into Claude Code or Codex:**
+
+```text
+Install vigiles in this repo and run it. Verify my CLAUDE.md / AGENTS.md
+references and show me what's stale, then write and run a harness test for one
+of my hooks or skills. Use good defaults (both pillars, non-interactive), but
+ask me first whether to gate it in CI, whether to add a real-model eval, and
+whether to enforce strictly (--strict).
+```
 
 Or do it yourself:
 
@@ -118,19 +120,30 @@ It's interactive in a terminal and non-interactive for agents/CI (or with
 `--yes`), so "set up vigiles" from a Claude Code / Codex prompt Just Works — and
 it installs a model-invocable **`test-harness` skill**, so afterward you can just
 tell your agent _"test my skills"_ and it picks the tier and writes the test.
-Scope `init` with `--pillars=verify|test|both`. Or write harness tests yourself in
-JS **or** TS (`*.harness.{mjs,ts}`) and run `npx vigiles test`. `init` wires CI as
-a `zernie/vigiles@v1` workflow — a composite over the same CLI:
 
-```yaml
-- uses: actions/checkout@v4
-- uses: zernie/vigiles@v1 # audits by default; posts a sticky PR comment + a `valid` output
-```
+<details>
+<summary>What <code>init</code> sets up</summary>
+
+- **Both pillars** by default; scope with `--lint` / `--test` (one or both).
+- Adds `vigiles` to your `devDependencies`.
+- Installs the Claude Code plugin (skills + hooks) via the marketplace —
+  globally, never vendored into your repo.
+- Wires CI as a `zernie/vigiles@v1` workflow (a composite over the same CLI):
+
+  ```yaml
+  - uses: actions/checkout@v4
+  - uses: zernie/vigiles@v1 # lints by default; posts a sticky PR comment + a `valid` output
+  ```
+
+Prefer to write tests yourself? They can be JS **or** TS
+(`*.harness.{mjs,ts}`) — run them with `npx vigiles test`.
+
+</details>
 
 ## More
 
-- **[CLI & GitHub Action →](docs/cli.md)** — every command, the Action (inputs / output / versioning), the Claude Code plugin, and the five `audit` rules.
-- **[Skills →](docs/skills.md)** — 8 skills (`strengthen`, `migrate-to-spec`, `test-harness`, …) via `npx skills add zernie/vigiles`.
+- **[CLI & GitHub Action →](docs/cli.md)** — every command, the Action (inputs / output / versioning), the Claude Code plugin, and the five `lint` rules.
+- **[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).
 - **[Docs index →](docs/README.md)** · **[Research →](research/README.md)** · **[Related tools →](docs/related-tools.md)** (ast-grep, Dependency Cruiser, Ruler, rulesync).
 - Companion to [Feedback Loop Is All You Need](https://zernie.com/blog/feedback-loop-is-all-you-need).
 

package/action.yml

@@ -7,11 +7,11 @@ branding:
 
 inputs:
   command:
-    description: "Which vigiles command to run: 'audit' (verify references + integrity + coverage) or 'compile' (specs → markdown)."
+    description: "Which vigiles command to run: 'lint' (verify references + integrity + coverage) or 'compile' (specs → markdown)."
     required: false
-    default: "audit"
+    default: "lint"
   paths:
-    description: "Comma- or space-separated paths to operate on (.md files for audit, .spec.ts files for compile). Auto-discovers when empty."
+    description: "Comma- or space-separated paths to operate on (.md files for lint, .spec.ts files for compile). Auto-discovers when empty."
     required: false
     default: ""
   version:
@@ -64,7 +64,7 @@ runs:
       run: |
         set -euo pipefail
 
-        cmd="${VIGILES_COMMAND:-audit}"
+        cmd="${VIGILES_COMMAND:-lint}"
         args=("$cmd")
 
         # paths: split on commas and whitespace into positional args.

package/dist/adapters/claude-code/adapter.js

@@ -14,7 +14,7 @@ const layout_js_1 = require("./layout.js");
 const runtime_js_1 = require("./runtime.js");
 const hook_protocol_js_1 = require("./hook-protocol.js");
 const model_mock_js_1 = require("./model-mock.js");
-const harness_test_js_1 = require("./harness-test.js");
+const harness_test_js_1 = require("../../harness-test.js");
 exports.claudeCodeAdapter = {
     name: "claude-code",
     // The reference harness: every tier. Mockable transport (Anthropic SSE) and

package/dist/claude-code.d.ts

@@ -6,7 +6,7 @@
  * is the adapter, so a future `vigiles/<other-harness>` can sit beside it.
  */
 export * from "./adapters/claude-code/plugin-loader.js";
-export * from "./adapters/claude-code/mock-model.js";
+export * from "./mock-model.js";
 export * from "./adapters/claude-code/dialect.js";
 export * from "./adapters/claude-code/layout.js";
 export * from "./adapters/claude-code/runtime.js";

package/dist/claude-code.js

@@ -22,7 +22,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * is the adapter, so a future `vigiles/<other-harness>` can sit beside it.
  */
 __exportStar(require("./adapters/claude-code/plugin-loader.js"), exports);
-__exportStar(require("./adapters/claude-code/mock-model.js"), exports);
+__exportStar(require("./mock-model.js"), exports);
 __exportStar(require("./adapters/claude-code/dialect.js"), exports);
 __exportStar(require("./adapters/claude-code/layout.js"), exports);
 __exportStar(require("./adapters/claude-code/runtime.js"), exports);

package/dist/cli.d.ts

@@ -5,7 +5,7 @@
  * Commands:
  *   vigiles init            — scaffold a spec from scratch
  *   vigiles compile         — compile .spec.ts → .md with linter verification
- *   vigiles audit           — verify hashes, report coverage, detect duplicates
+ *   vigiles lint            — verify hashes, report coverage, detect duplicates
  *   vigiles generate-types  — emit .d.ts with types from project state
  */
 export {};