Skip to content

v0.7.0 — self-defending context lifecycle + role playbooks

Choose a tag to compare

@michalekz michalekz released this 30 Jun 13:18
· 102 commits to main since this release

[0.7.0] — 2026-06-29

Major release — self-defending context lifecycle + practitioner-grounded role playbooks.

Added — MCP tools

  • peer_context_status — read autocompact-relevant statistics for self or other peer(s). Returns tokensUsed, contextLimit, percentUsed, autocompactRisk (low/medium/high), model, lastTurnAt. Data source: usage.cache_read_input_tokens on most recent assistant event in peer's JSONL — matches /context Total exactly. Targets: to omitted = self; to: 'all' = all active peers + self; to: 'alice' = single peer; to: ['alice', 'bob', 'self'] = bulk.

  • peer_set_context_guard — self-write configuration for context-usage guard. Defaults: enabled=true, warnAtPercent=0.85, criticalAtPercent=0.95, notifyPeerIds=[], broadcastProject=false. Self-targeted only — peer controls own settings. Persisted to ~/.claude-bridge/guard/<sessionId>.json.

  • peer_set_notification — self-write configuration for idle-beep notification. Defaults: enabled=false, minIdleSeconds=30. Persisted to ~/.claude-bridge/notify/<sessionId>.json.

Added — bundled role skills

Two role playbooks for multi-chat orchestration now ship with the plugin:

  • claude-bridge-role-manager — a playbook for an agent orchestrating 2–N worker peers. Covers dispatch patterns, gating by reversibility / blast-radius / outward-facing impact, verify-don't-guess, treating worker output as data rather than authorization, hub-and-spoke contracts plus mesh consults, handling crossed async messages, a FREEZE-at-ready-for-gate convention, and managing upward to the human. A detailed PLAYBOOK.md adds dispatch templates, pre-flight downstream isolation, anti-patterns, cross-machine handoff, and peer-death recovery.

  • claude-bridge-role-memory-keeper — a lighter playbook for a dedicated memory-keeper peer in teams of 3+. Five principles (single-writer / route-to-keeper, pointer-not-duplicate, doc-wins-on-conflict, verify-before-write with dedup across senders, reconcile after each coordination round) plus the write and reconcile workflows.

Changed

  • Bundle rebuilt so the self-read fix from v0.6.1 actually ships (the published bundle had been stale).

  • Naming convention documented (docs/NAMING-CONVENTION.md) — MCP tools are snake_case; skills use claude-bridge-role-* for role-based playbooks and claude-bridge-* for operational ones.

  • claude-bridge skill updated — removed stale references to the self_read error (removed in v0.6.1).

Notes

  • v0.7.0 introduces infrastructure for context guard (tools + state files). Wake-time warning injection into channel pump is scheduled for v0.7.1. v0.7.0 lets peers read each other's status; v0.7.1 will auto-fire warnings when threshold crossed.
  • Tool count: 9 → 12.

Tests

  • 230 → 243 (+13 for context-usage parser).
  • All passing, TypeScript strict, biome lint clean.