Report this MCP server process's version, git SHA, start time, and Blackboard root.

A long-lived stdio connection keeps the tool schema it had at startup, so a tool added to the source after connecting (e.g. a newly released one) will not appear until a fresh connection is made. If an expected tool seems to be missing, call this first: an old started_at/git_sha relative to the source you expect means the connection is stale, not that the feature is missing.

Read a persistent Memory document by id.

List Memory metadata in deterministic ID order without full content.

Create or update Memory. Updates require the revision returned by read_memory.

List named Plans in this Blackboard root, each with its in_progress tasks.

Check this before claiming work when multiple actors may be active: it shows what is already claimed, by whom, across every Plan in this root.

Report which roles each actor_id has claimed tasks under, across every Plan.

This is an observation aid, not authentication: actors still self-declare their role on every call, and nothing here is enforced. Use it to sanity check who has been active and under which roles before trusting a Memory/Event entry attributed to an unfamiliar actor_id.

Read one Plan and its executable tasks, optionally for one Role.

Diagnose Plan metadata, task audit fields, dependencies, and Outbox without changing it.

Append one new task to an already-initialized Plan. A stale revision is rejected as a conflict.

task uses the same shape as one entry of initialize_project's tasks (id/task/role). dependencies lists the IDs of tasks the new task requires; targets must already exist in the Plan.

Edit a pending task's text, required Role, or dependencies with revision CAS.

Task IDs are immutable. Pass dependencies=[] to remove all dependencies.

Logically cancel a pending or owned in-progress task with an audit Event.

Set a pending task's advisory P0-P3 priority with CAS and an audit Event.

Priority is human-facing backlog guidance. It does not choose, claim, or block work for any LLM.

Recover a blocked task to pending; the declared Role needs recover_task permission.

Atomically claim one executable task. A stale revision is rejected as a conflict.

work_scope optionally declares the files/paths you expect to touch (e.g. ["src/blackboard/service.py", "tests/test_service.py"]). It is recorded on the task_started Event for other actors to see before they start their own work, but it is not enforced.

Finish, block, cancel, or recover a task.

Claim owners may set done/blocked/cancelled on in_progress tasks. Roles with recover_task permission may set pending on blocked tasks. The Plan state is authoritative. Its corresponding audit Event is placed in the Plan Outbox and is retried idempotently if Event persistence fails.

Read a State document by id.

The response includes a stale_warning field if the document hasn't been updated in a while. This is a read-time nudge only — State is never auto-rewritten from Plan (see CONTRIBUTING.md).

List State metadata in deterministic ID order without full content.

Create or update current State. Updates require the revision returned by read_state.

List audit Events, optionally filtered by type, task, or created time range.

Append an independent audit Event. This tool does not change Plan state.

Create the Blackboard directories and one named Plan file.

This bootstrap utility is used by a human when creating a project. LLM collaboration thereafter uses the core Blackboard tools above. Additional Plans may be created in the same root by calling this again with a new plan_id.

Retry pending Plan-generated Events after a previous Event write failure.