This release includes 8 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+2 more
Affected surfaces
Summary
AI summaryRemoved LLM-based policy parser, several commands, reporters, and related flags; deterministic YAML policy loading introduced.
Full changelog
Major Changes
-
da2bccd: Trim vow: drop the LLM-based policy parser and command bloat.
Policy is now deterministic.
.vow.ymlaccepts the same
allow/deny/warn/min_confidencestructure as.vow.json(parsed
via plain YAML — no Claude API calls). Cargo and pip resolvers are
retained; this release does not narrow ecosystem scope.Removed:
src/policy/parser.ts(LLM-based parser) +src/policy/cache.tssrc/policy/lockfile.ts(the offline lockfile existed only to
skip the LLM call — no longer needed)
- commands:
fix,audit,diff,hook,policy(compile/status) - reporters:
audit(HTML),diff(PR markdown),sarif src/diff/engine.tsand related types@anthropic-ai/sdkdep--api-key,--offline,--fail-onlockfile-aware flag handling
fromcheck
Added:
loadYamlPolicy()— parses structured.vow.ymlthe same way as
.vow.json. The.vow.ymltemplate emitted byvow initnow
uses the structured shape, not plain English.
Kept:
scan,check,tree,export,attribution,sbom,init.
Library exports for graph/walker/SPDX/license-db,createTool, the
evaluator.Major version bump.
Patch Changes
-
4360845: Post-trim cleanup: sync READMEs with the actual command surface, drop a dead
chokidardep, and fix stale's summarypassedcount.- READMEs rewritten for the 5 trimmed tools so they match what the CLI actually ships. Removed references to commands and flags that no longer exist (
vow fix|hook|audit|diff|policy,vow --offline|--api-key|ANTHROPIC_API_KEY;stale fix|watch,stale --deep,STALE_AI_KEY, SARIF format;aware watch|validate|doctor|add,--exit-code;envalid onboard|hook|export|watch|fix|migrate, plugins, secret providers, framework adapters). Documented the flags each command actually accepts today (e.g.aware diff --check|--json|--target|--quiet,vow check --ignore). - aware: removed unused
chokidardependency (carried over from the droppedaware watchcommand —grep chokidar src/had zero hits). - stale: fixed
summary.passedgoing negative on reports with many issues.buildSummarywas computingtotalChecks - errors - warnings - infos, wheretotalCheckswas per (doc × analyzer) but issues are per finding, so a heavy report trivially overflowed it.totalChecksnow counts analyzers run, andpassedcounts analyzers whose category produced zero issues. Per-categorypassedis now1when that analyzer ran and produced no issues,0otherwise. Test fixture + snapshot updated for the post-trim DriftCategory set. - vow: deleted
docs/workflows/— the three example workflow YAMLs and their README referencedvow check --offline,vow diff,vow policy compile,ANTHROPIC_API_KEY, and the archivedwhenlabs-org/vow@v1composite action, none of which exist anymore.
- READMEs rewritten for the 5 trimmed tools so they match what the CLI actually ships. Removed references to commands and flags that no longer exist (
Breaking Changes
- Removed `src/policy/parser.ts` (LLM-based parser) and `src/policy/cache.ts`
- Removed `src/policy/lockfile.ts`
- Removed commands: `fix`, `audit`, `diff`, `hook`, `policy`
- Removed reporters: `audit` (HTML), `diff` (PR markdown), `sarif`
- Removed `src/diff/engine.ts` and related types
- Removed dependency `@anthropic-ai/sdk`
- Removed flags `--api-key`, `--offline`, lockfile‑aware flag handling from `check`
- Major version bump to v1.0.0
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About WhenLabs-org/when
Developer toolkit: auto-detect stack for AI context files, catch port conflicts, validate .env schemas, spot docs drift, audit dependency licenses, and time coding tasks — 7 MCP tools, one install.
Related context
Related tools
Beta — feedback welcome: [email protected]