Skip to content

This release includes 6 breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-tools claude-code cli developer-tools devex mcp
+2 more
npm-package typescript

Affected surfaces

breaking_upgrade

Summary

AI summary

Dropped 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, and init — 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; standalone berth-mcp bin is gone)
    • conflict engine: stripped reservation, team, and range-violation handling
    • reporters: renderList (registry-only)
    • package.json: dropped berth-mcp bin, @modelcontextprotocol/sdk and node-notifier deps

    Kept: all detectors (lsof/netstat/docker/package-json/docker-compose/dotenv/procfile/makefile/devcontainer/framework/berthrc), the core resolver, the --quick cache, the createTool() library entry.

    Major version bump.

Patch Changes

  • 4360845: Post-trim cleanup: sync READMEs with the actual command surface, drop a dead chokidar dep, and fix stale's summary passed count.

    • 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 chokidar dependency (carried over from the dropped aware watch command — grep chokidar src/ had zero hits).
    • stale: fixed summary.passed going negative on reports with many issues. buildSummary was computing totalChecks - errors - warnings - infos, where totalChecks was per (doc × analyzer) but issues are per finding, so a heavy report trivially overflowed it. totalChecks now counts analyzers run, and passed counts analyzers whose category produced zero issues. Per-category passed is now 1 when that analyzer ran and produced no issues, 0 otherwise. Test fixture + snapshot updated for the post-trim DriftCategory set.
    • vow: deleted docs/workflows/ — the three example workflow YAMLs and their README referenced vow check --offline, vow diff, vow policy compile, ANTHROPIC_API_KEY, and the archived whenlabs-org/vow@v1 composite action, none of which exist anymore.

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

Track WhenLabs-org/when

Get notified when new releases ship.

Sign up free

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.

All releases →

Related context

Beta — feedback welcome: [email protected]