vigiles 30.0.2 → 31.0.0

package/dist/linting.js

@@ -1,38 +1,26 @@
 "use strict";
+// 🔴 PUBLIC ENTRY POINT `vigiles/linting` — every export here is a promise to users. The default for a
+// symbol is INTERNAL. It is exported only if (a) a NAMED external consumer uses it, or (b) it is
+// a deliberate extension point listed in STABILITY.md (the adapter kit is the example). "Might
+// be useful" is neither. Review point: the diff of `api-surface/vigiles-linting.api.md`, which
+// `npm run api:check` fails on.
 /**
- * `vigiles/linting` — Pillar 1 entry point: the **linting layer** for instruction
- * files. The spec builders/types that describe a CLAUDE.md, a SKILL.md or an
- * agent, plus the public compile entry points, under one concern-named import.
+ * `vigiles/linting` — Pillar 1 entry point: what a spec AUTHOR imports to describe a CLAUDE.md,
+ * a SKILL.md or an agent — the builders, the verified-reference constructors and their types.
+ * Compiling is the CLI's job (`vigiles compile` / `vigiles lint`), not this subpath's.
  *
- * Curated (named, not `export *`) so the internal compiler validators, hash
- * helpers, and the linter cross-reference ENGINE stay out of the public surface,
- * the api reports, and the docs site (the CLI imports those from the source).
+ * Curated (named, not `export *`) so the internal compiler, validators, hash helpers and the
+ * linter cross-reference ENGINE stay out of the public surface, the api reports and the docs.
  *
- * 🔴 THAT SENTENCE USED TO BE FALSE, and so did the one after it (fixed
- * 2026-08-21). The file claimed to be curated while `export * from
- * "./core/spec.js"` sat one line below it, and it claimed "the spec builders are
- * also at the package root (`vigiles`)" — measured against `vigiles.api.md`: 191
- * exports there and zero matches for `claude`, `agent`, `enforce` or `result`.
- * The builders' second door is `vigiles/spec`, not the root. Both claims read as
- * documentation of a decision and were descriptions of the opposite one; a
- * header nobody re-reads is where an `export *` hides best.
- *
- * WHAT THE CURATION DROPS (28 symbols, measured — nothing in this repo imported
- * any of them from here; every in-repo user takes them from `vigiles/spec`, and
- * the one live consumer of this subpath in the docs takes `compileAgent`): the
- * typed-COMPOSITION family — `experimental_pipe`/`_pipeStep`/`_start`/
- * `_andThen`/`_needs`, `Pipeline`, `PipeStep`, `Supplies`, `Handoff`,
- * `NeedsContract`, `OkOf`, `TypedAgentSpec`, `TypedOutcome`, `Shape`,
- * `OutputFieldType` and the `result()` builder. Those verify HANDOFFS between
- * workers; they compile to nothing and lint nothing, so they are not pillar 1.
- *
- * ⚠️ The cut is not a clean slice along that line, and pretending otherwise
- * would strand a signature: the `result()` FUNCTION leaves, but the
- * `OutputContract` TYPE stays, because `compileAgent`/`compileSkill` name it in
- * their own types. A consumer who needs to BUILD one imports `vigiles/spec`.
+ * WHAT THE CURATION DROPS (28 symbols, measured 2026-08-21 — nothing in this repo imported any
+ * of them from here; every in-repo user takes them from `vigiles/spec`): the typed-COMPOSITION
+ * family — `experimental_pipe`/`_pipeStep`/`_start`/`_andThen`/`_needs`, `Pipeline`, `PipeStep`,
+ * `Supplies`, `Handoff`, `NeedsContract`, `OkOf`, `TypedAgentSpec`, `TypedOutcome`, `Shape`,
+ * `OutputFieldType` and the `result()` builder. Those verify HANDOFFS between workers; they
+ * compile to nothing and lint nothing, so they are not pillar 1.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileRailway = exports.compileAgent = exports.compileSkill = exports.compileClaude = exports.BUILTIN_LINTERS = exports.agent = exports.instructions = exports.claude = exports.experimental_agent = exports.experimental_skill = exports.project = exports.glob = exports.dir = exports.ref = exports.symbol = exports.cmd = exports.file = exports.guard = exports.guidance = exports.enforce = exports.experimental_effect = exports.prose = exports.instructionFile = void 0;
+exports.BUILTIN_LINTERS = exports.agent = exports.instructions = exports.claude = exports.experimental_agent = exports.experimental_skill = exports.project = exports.glob = exports.dir = exports.ref = exports.symbol = exports.cmd = exports.file = exports.guard = exports.guidance = exports.enforce = exports.experimental_effect = exports.prose = exports.instructionFile = void 0;
 // --- the spec authoring builders: rules, refs, prose, and the three spec kinds ---
 var spec_js_1 = require("./core/spec.js");
 // instruction files
@@ -67,12 +55,11 @@ Object.defineProperty(exports, "instructions", { enumerable: true, get: function
 Object.defineProperty(exports, "agent", { enumerable: true, get: function () { return spec_js_1.agent; } });
 var spec_js_2 = require("./core/spec.js");
 Object.defineProperty(exports, "BUILTIN_LINTERS", { enumerable: true, get: function () { return spec_js_2.BUILTIN_LINTERS; } });
-// Compile: only the public entry points + their option/result types.
-var compile_js_1 = require("./core/compile.js");
-Object.defineProperty(exports, "compileClaude", { enumerable: true, get: function () { return compile_js_1.compileClaude; } });
-Object.defineProperty(exports, "compileSkill", { enumerable: true, get: function () { return compile_js_1.compileSkill; } });
-Object.defineProperty(exports, "compileAgent", { enumerable: true, get: function () { return compile_js_1.compileAgent; } });
-Object.defineProperty(exports, "compileRailway", { enumerable: true, get: function () { return compile_js_1.compileRailway; } });
+// NO COMPILE ENTRY POINTS HERE (removed in the major that ships #257). `compileClaude`,
+// `compileSkill`, `compileAgent`, `compileRailway` and their option/result types were public
+// with no external caller — measured across the repos that depend on vigiles, every import is a
+// spec builder — and the promise froze them synchronous while the symbol check they run became
+// async. Spec authors run `vigiles compile`; the CLI imports the compiler from source.
 // core/linters is the cross-reference ENGINE (checkLinterRule/editDistance/…),
 // consumed by compile — not part of the public authoring surface.
 //# sourceMappingURL=linting.js.map

package/dist/test.js

@@ -1,4 +1,9 @@
 "use strict";
+// 🔴 PUBLIC ENTRY POINT `vigiles` — every export here is a promise to users. The default for a
+// symbol is INTERNAL. It is exported only if (a) a NAMED external consumer uses it, or (b) it is
+// a deliberate extension point listed in STABILITY.md (the adapter kit is the example). "Might
+// be useful" is neither. Review point: the diff of `api-surface/vigiles.api.md`, which
+// `npm run api:check` fails on.
 /**
  * `vigiles` (the package root) — the **free** testing surface: everything you can
  * run without a model call, and therefore without a bill.

package/dist/vitest.mjs

@@ -1,3 +1,8 @@
+// 🔴 PUBLIC ENTRY POINT `vigiles/vitest` — every export here is a promise to users. The default for a
+// symbol is INTERNAL. It is exported only if (a) a NAMED external consumer uses it, or (b) it is
+// a deliberate extension point listed in STABILITY.md (the adapter kit is the example). "Might
+// be useful" is neither. Review point: the diff of `api-surface/vigiles-vitest.api.md`, which
+// `npm run api:check` fails on.
 /* eslint-disable max-params, @typescript-eslint/no-explicit-any --
    The matcher signatures mirror the runtime vigilesMatchers (positional args),
    and `Matchers<T = any>` must match @vitest/expect's generic default to merge. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vigiles",
-  "version": "30.0.2",
+  "version": "31.0.0",
   "description": "Audit, test and measure the harness your AI agent runs on — grade your CLAUDE.md / AGENTS.md, skills, subagents and hooks, run them against a scripted model, and measure whether they actually fire.",
   "keywords": [
     "claude-code",
@@ -138,6 +138,7 @@
   "dependencies": {
     "@ast-grep/napi": "^0.43.0",
     "@iarna/toml": "^2.2.5",
+    "@vscode/tree-sitter-wasm": "0.3.1",
     "ci-info": "^4.4.0",
     "cosmiconfig": "^9.0.1",
     "glob": "^13.0.6",
@@ -148,10 +149,5 @@
     "ts-essentials": "^10.2.1",
     "typescript": "^5.9.3",
     "zod": "^4.6.5"
-  },
-  "optionalDependencies": {
-    "@ast-grep/lang-python": "^0.0.6",
-    "@ast-grep/lang-ruby": "^0.0.7",
-    "@ast-grep/lang-rust": "^0.0.7"
   }
 }