This release includes 6 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+2 more
Affected surfaces
Summary
AI summaryDropped 14 CLI subcommands and their supporting subsystems, trimming Berth to a focused port‑conflict detective.
Full changelog
Major Changes
-
2bb57e4: Trim berth to a focused port-conflict detective.
Dropped 14 CLI subcommands and their supporting subsystems. Berth is now
status,check,kill,resolve,reassign, andinit— the detective job.Removed:
- commands:
free,list,register,start,predict,watch,reserve,unreserve,reservations,team,doctor,install-shell-hook,remote,history - subsystems:
src/registry/(project + reservation registry),src/history/(event recorder),src/config/team.ts(team config),src/mcp/(the wrapper handles MCP; standaloneberth-mcpbin is gone) - conflict engine: stripped reservation, team, and range-violation handling
- reporters:
renderList(registry-only) - package.json: dropped
berth-mcpbin,@modelcontextprotocol/sdkandnode-notifierdeps
Kept: all detectors (lsof/netstat/docker/package-json/docker-compose/dotenv/procfile/makefile/devcontainer/framework/berthrc), the core resolver, the
--quickcache, thecreateTool()library entry.Major version bump.
- commands:
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 CLI subcommands: free, list, register, start, predict, watch, reserve, unreserve, reservations, team, doctor, install-shell-hook, remote, history
- Dropped subsystems: src/registry/, src/history/, src/config/team.ts, src/mcp/
- Conflict engine no longer handles reservation, team, or range‑violation logic
- Removed reporters: renderList (registry‑only)
- Package.json entry for bin `berth-mcp` removed and dependencies `@modelcontextprotocol/sdk`, `node-notifier` dropped
- Major version bump to 1.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]