brainclaw 1.7.1 → 1.7.3

package/docs/mcp-schema-changelog.md

@@ -19,7 +19,7 @@ guarantees this changelog follows.
   to `sha256:860fbaa30a486093` (zod 4). No tool was added, removed,
   renamed, or had its required arguments change.
 
-**Changed — `bclaw_loop(intent: 'open')` anti-pattern gate (pln#461)**
+**Changed — `bclaw_loop(intent: 'open')` anti-pattern gate (pln#461)**
 - New optional field `allow_orphan: boolean` on `BclawLoopOpenSchema`.
 - Default (absent / `false`) — handler rejects with `validation_error`
   and points to `bclaw_coordinate(intent: 'review', open_loop: true)`
@@ -28,9 +28,20 @@ guarantees this changelog follows.
   out in `CLAUDE.md`.
 - `allow_orphan: true` — explicit acknowledgement that the caller
   will drive `turn()` + dispatch manually (advanced / test use only).
-- Internal callers (`bclaw_coordinate`, `bclaw_dispatch`) are not
-  affected — they bypass `handleBclawLoop` and invoke the core
-  `openLoop()` directly.
+- Internal callers (`bclaw_coordinate`, `bclaw_dispatch`) are not
+  affected — they bypass `handleBclawLoop` and invoke the core
+  `openLoop()` directly.
+
+**Changed — sequence tools promoted to default discovery (pln#522)**
+- `bclaw_list_sequences`, `bclaw_create_sequence`,
+  `bclaw_update_sequence`, and `bclaw_delete_sequence` move from
+  `advanced` to `standard`, so fresh agents see them in the default
+  `tools/list` catalog. Sequences are a core agent-first coordination
+  primitive for parallel dispatch, not an advanced-only admin surface.
+- `bclaw_create_sequence.items` and `bclaw_update_sequence.items` now
+  expose the full item shape in JSON Schema: `planId`, optional
+  `stepId`, `rank`, `hard_after`, `soft_after`, `lane`, `scope_hint`,
+  and `rationale`.
 
 ---
 
@@ -82,7 +93,7 @@ will still succeed. A follow-up PR will strip the dead handler code.
   changelog records the published MCP surface fingerprint. When a tool
   name, tier, category, or input schema changes, the test fails until
   this section is updated.
-- MCP public surface fingerprint: `sha256:4a6f612ad952fb52`
+- MCP public surface fingerprint: `sha256:a1881ff57ddce377`
   (updated 2026-05-27: added the `ref` property to the bclaw_coordinate
   inputSchema — pln#520 Tier 2 / trp#371, the scope-aware dirty guard;
   `ref` lets a dispatch build its worktree from an explicit git ref.

package/docs/playbooks/team/index.md

@@ -48,11 +48,13 @@ These rules apply to any feature that touches this audience:
 - `bclaw_check_policy` — scope compliance with glob matching, returns blocks + warnings
 - `bclaw_who` — list all active agent sessions on the workspace
 
-### Planning & Sequencing
-- `bclaw_create(entity="plan", data)` / `bclaw_update(entity="plan", id, patch)` / `bclaw_transition(entity="plan", id, to)` — shared work planning with priority/effort/assignee/status
-- `bclaw_find(entity="plan", filter?)` — list plans
-- `bclaw_add_step` / `bclaw_complete_step` / `bclaw_update_step` / `bclaw_delete_step` — plan sub-steps for granular tracking
-- `bclaw_create_sequence` / `bclaw_list_sequences` / `bclaw_update_sequence` — multi-step coordination sequences with lane analysis
+### Planning & Sequencing
+- `bclaw_create(entity="plan", data)` / `bclaw_update(entity="plan", id, patch)` / `bclaw_transition(entity="plan", id, to)` — shared work planning with priority/effort/assignee/status
+- `bclaw_find(entity="plan", filter?)` — list plans
+- `bclaw_add_step` / `bclaw_complete_step` / `bclaw_update_step` / `bclaw_delete_step` — plan sub-steps for granular tracking
+- `bclaw_create_sequence` / `bclaw_list_sequences` / `bclaw_update_sequence` — multi-step coordination sequences with lane analysis
+
+Sequence items are explicit lane records: `{ planId, stepId?, rank, hard_after?, soft_after?, lane?, scope_hint?, rationale? }`. `planId` and `rank` are required; `stepId` lets a sequence dispatch a specific plan step instead of the whole plan. A normal parallel flow is: create sequence as `draft`, update it to `active`, run `bclaw_dispatch(intent="analysis")`, then run `bclaw_dispatch(intent="execute", agents=[...])`.
 
 ### Multi-Agent Dispatch
 - `bclaw_dispatch(intent)` — `analysis` analyses an active sequence (ready/active/blocked/done per lane), `execute` fans out parallel work across lanes, `review` dispatches code reviews for completed handoffs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainclaw",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "bin": {