v0.2.8

[0.2.8] - 2026-09-13

This release includes the changes since the last PyPI release, 0.2.4.

Added

• Human Resume Briefs, non-blocking yellow/green Attention, and an
  attention-first dashboard for human oversight of active runs.
• Offline comem eval commands for immutable baseline snapshots, reproducible
  experiment manifests, validation, and JSON Schema export. This foundation
  prepares evaluations; it does not execute benchmarks.
• Explicit codex_subagent and comem_loop execution-mode guidance in agent
  onboarding templates.
• A searchable documentation site at https://yanqiw.github.io/comem/.

Changed

• Breaking: MCP workspace discovery, pending reviews, snapshots, and contract
  lists now return compact responses. High-volume reads require one exact
  team_id; discover a workspace, inspect its teams, and select the team first.
• Breaking: get_event_detail(event_id) is the explicit full-event detail
  read. Exactly eleven Ack tools now return a compact ten-field acknowledgement
  without a payload echo: append_event, submit_handoff, heartbeat_run,
  checkpoint_run, raise_attention, record_run_binding,
  request_intervention, respond_intervention, review_event,
  accept_event, and reject_event. claim_assignment and
  actor/workspace/team/assignment/contract mutations retain their existing
  responses, including active_run_id in the full claim response.
• Breaking: get_team_board now returns a compact flat assignment list and
  accepts one exact status filter. The default omits accepted, rejected,
  cancelled, and superseded assignments; use get_assignment_detail for full
  assignment fields.

Fixed

• Constrain the MCP SDK to compatible 1.x releases so a fresh install can
  start comem; MCP 2.x removes the FastMCP import used by this release.
• CI now builds and installs the wheel with freshly resolved dependencies to
  catch installation failures that the development lockfile can hide.
• Compact snapshot governance now uses bulk reads, and read-only compact
  queries support legacy database schemas without migrating them.
• Release metadata consistency is checked across Python, npm, lockfiles, and
  MCP Registry metadata.

Upgrading

• Upgrade the package, restart MCP clients, and refresh agent onboarding with
  comem init so clients use the compact discovery/detail protocol. See the
  0.2.8 upgrade guide.