brainclaw 1.28.3 → 1.28.5

package/dist/facts.js

@@ -1,11 +1,11 @@
 // Generated by scripts/emit-site-facts.mjs at build time. Do not edit manually.
-// Source: brainclaw v1.28.3 on 2026-08-25T23:07:33.877Z
+// Source: brainclaw v1.28.5 on 2026-08-28T18:04:39.470Z
 export const FACTS = {
-  "version": "1.28.3",
-  "generated_at": "2026-08-25T23:07:33.877Z",
+  "version": "1.28.5",
+  "generated_at": "2026-08-28T18:04:39.470Z",
   "tools": {
-    "count": 70,
-    "published_count": 68,
+    "count": 71,
+    "published_count": 69,
     "names": [
       "bclaw_bootstrap",
       "bclaw_release_notes",
@@ -70,6 +70,7 @@ export const FACTS = {
       "bclaw_assignment_update",
       "bclaw_assignment_action",
       "bclaw_harvest_candidates",
+      "bclaw_harvest",
       "bclaw_find",
       "bclaw_get",
       "bclaw_create",
@@ -478,7 +479,7 @@ export const FACTS = {
   },
   "bench": {
     "schema": "brainclaw.bench.v1",
-    "generated_at": "2026-08-25T23:07:31.792Z",
+    "generated_at": "2026-08-28T18:04:37.892Z",
     "node_version": "v24.19.0",
     "platform": "linux-x64",
     "repeats": 3,
@@ -487,7 +488,7 @@ export const FACTS = {
         "name": "cold_onboard",
         "volume": "empty",
         "description": "fresh machine → init → first useful context. Baseline for time-to-first-value.",
-        "duration_ms_median": 79,
+        "duration_ms_median": 51,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -495,17 +496,17 @@ export const FACTS = {
         "name": "warm_work",
         "volume": "medium",
         "description": "bclaw_work consult over a real-shaped store (~200 plans / 500 handoffs / 450 claims).",
-        "duration_ms_median": 122,
-        "payload_chars_median": 2626,
-        "payload_tokens_est_median": 657
+        "duration_ms_median": 72,
+        "payload_chars_median": 2625,
+        "payload_tokens_est_median": 656
       },
       {
         "name": "first_edit",
         "volume": "medium",
         "description": "code_find + code_brief on the fresh-agent path (missing index, first touch).",
-        "duration_ms_median": 11,
-        "payload_chars_median": 1629,
-        "payload_tokens_est_median": 407
+        "duration_ms_median": 8,
+        "payload_chars_median": 1680,
+        "payload_tokens_est_median": 420
       }
     ]
   }

package/dist/facts.json

@@ -1,9 +1,9 @@
 {
-  "version": "1.28.3",
-  "generated_at": "2026-08-25T23:07:33.877Z",
+  "version": "1.28.5",
+  "generated_at": "2026-08-28T18:04:39.470Z",
   "tools": {
-    "count": 70,
-    "published_count": 68,
+    "count": 71,
+    "published_count": 69,
     "names": [
       "bclaw_bootstrap",
       "bclaw_release_notes",
@@ -68,6 +68,7 @@
       "bclaw_assignment_update",
       "bclaw_assignment_action",
       "bclaw_harvest_candidates",
+      "bclaw_harvest",
       "bclaw_find",
       "bclaw_get",
       "bclaw_create",
@@ -476,7 +477,7 @@
   },
   "bench": {
     "schema": "brainclaw.bench.v1",
-    "generated_at": "2026-08-25T23:07:31.792Z",
+    "generated_at": "2026-08-28T18:04:37.892Z",
     "node_version": "v24.19.0",
     "platform": "linux-x64",
     "repeats": 3,
@@ -485,7 +486,7 @@
         "name": "cold_onboard",
         "volume": "empty",
         "description": "fresh machine → init → first useful context. Baseline for time-to-first-value.",
-        "duration_ms_median": 79,
+        "duration_ms_median": 51,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -493,17 +494,17 @@
         "name": "warm_work",
         "volume": "medium",
         "description": "bclaw_work consult over a real-shaped store (~200 plans / 500 handoffs / 450 claims).",
-        "duration_ms_median": 122,
-        "payload_chars_median": 2626,
-        "payload_tokens_est_median": 657
+        "duration_ms_median": 72,
+        "payload_chars_median": 2625,
+        "payload_tokens_est_median": 656
       },
       {
         "name": "first_edit",
         "volume": "medium",
         "description": "code_find + code_brief on the fresh-agent path (missing index, first touch).",
-        "duration_ms_median": 11,
-        "payload_chars_median": 1629,
-        "payload_tokens_est_median": 407
+        "duration_ms_median": 8,
+        "payload_chars_median": 1680,
+        "payload_tokens_est_median": 420
       }
     ]
   }

package/docs/cli.md

@@ -632,18 +632,18 @@ brainclaw note create "Need follow-up on launcher script" --plan pln_abc123
 
 ## Code Map
 
-A per-project Tree-sitter symbol + import index (JS/TS, Python, PHP, Java) so agents
+A per-project Tree-sitter symbol + import index across 11 languages so agents
 can ask "where is X / what should I read first" before editing. The MCP equivalents
 are `bclaw_code_status` / `bclaw_code_find` / `bclaw_code_brief` / `bclaw_code_refresh`.
 Full reference (freshness model, supported languages, WASM bundling): [docs/code-map.md](code-map.md).
 
 ### `brainclaw code-map status [--cascade]`
 
-Store presence, freshness badge (`fresh` / `stale_changed_files` / `stale_extractor` / `stale_grammar` / `partial` / `missing_index`), and index stats (files, nodes, edges). Read-only. In a multi-project workspace, `--cascade` adds compact coverage counts and names only non-fresh projects. On the MCP surface, the equivalent `bclaw_code_status(cascade=true)` also follows the latest durable cascade job.
+Physical store-path presence, readable-index presence, freshness badge (`fresh` / `stale_changed_files` / `stale_extractor` / `stale_grammar` / `partial` / `missing_index`), and index stats (files, nodes, edges). Read-only. In a multi-project workspace, `--cascade` adds compact coverage counts and names only non-fresh projects. On MCP, status also follows the latest durable refresh job and accepts `project` for explicit targeting.
 
-### `brainclaw code-map refresh [--all|--changed] [--cascade]`
+### `brainclaw code-map refresh [--all|--changed|--scope changed|all] [--cascade]`
 
-Build or update the index. `--changed` (default) re-parses only touched files; `--all` does a full re-index. Run this when status shows `missing_index` or a stale badge. Fails fast (never blocks) if another writer holds the project lock. In a multi-project workspace, `--cascade` synchronously refreshes each discovered project into its own store plus a root store scoped to files no child owns (zero double-indexing). The MCP equivalent starts a durable background job instead; follow it with `bclaw_code_status(cascade=true)`. See [docs/code-map.md](code-map.md#cascading-a-multi-project-workspace---cascade).
+Build or update the index. `--changed` (default) re-parses only touched files; `--all` does a full re-index; `--scope changed|all` is the MCP-compatible spelling. Run this when status shows `missing_index` or a stale badge. Fails fast if another writer holds the project lock. In a multi-project workspace, `--cascade` synchronously refreshes each discovered project into its own store plus a root store scoped to files no child owns. MCP refreshes return durable jobs immediately; follow them with `bclaw_code_status`, preserving the same optional `project`, or use `cascade=true` for a workspace job. See [docs/code-map.md](code-map.md#cascading-a-multi-project-workspace---cascade).
 
 ### `brainclaw code-map find <query> [--limit <n>]`
 
@@ -1185,6 +1185,39 @@ brainclaw update-handoff hnd_001 --review-verdict request_changes --reviewed-by
 
 ---
 
+## Worker result harvest
+
+### `brainclaw harvest [assignment_id]`
+
+Ingest a worker's `LANE-RESULT.json`, reconcile any bound loop turn, and report
+the exact continuation. Pass one assignment id or use `--all`; this is distinct
+from `harvest-candidates`, which imports proposed memory items.
+
+| Option | Description |
+|---|---|
+| `--all` | Scan every managed worktree |
+| `--integrate` | Also commit a sandboxed worker's worktree diff and settle its lifecycle |
+| `--orphaned` | Recover a dead worker that left no lane result, without deleting/resetting work |
+| `--base <ref>` | Base ref used by orphan recovery (default `master`) |
+| `--dry-run` | Preview without writing events or markers |
+| `--worktree <path>` | Explicit worktree to scan; repeatable |
+| `--json` | Return lane results, warnings, and loop continuations as JSON |
+
+```bash
+brainclaw harvest asgn_123
+brainclaw harvest --all --json
+brainclaw harvest --integrate asgn_123
+```
+
+The exact filename is `LANE-RESULT.json`. A unique root-level JSON file whose
+schema and `assignment_id` match can be recovered when a worker chose the wrong
+name; Brainclaw refuses ambiguous candidates. `artifacts` accepts either string
+refs or `{type, ref, description?}` objects, while loop workers must also emit
+the `artifact_type` named in their brief. A repairable schema/contract error
+keeps the real turn replayable and eligible for corrected re-harvest.
+
+---
+
 ## Dispatch
 
 The `dispatch` command group manages the local agent dispatcher: it analyzes the active sequence for lane readiness and assigns work to available agents.

package/docs/code-map.md

@@ -13,7 +13,7 @@ code, never blocks `bclaw_work`, and degrades gracefully: if the index is
 missing or stale, every command says so via a freshness badge instead of
 returning silently wrong answers.
 
-The index lives under `.brainclaw/code-map/` (one JSONL shard per file, plus
+The index lives under `.brainclaw/code/` (one JSONL shard per file, plus
 named symbol/import indexes and a manifest). It is safe to delete; a refresh
 rebuilds it.
 
@@ -37,8 +37,10 @@ accepts `--json` for machine-readable output, and prints a `Freshness:` line.
 
 ### `brainclaw code-map status`
 
-Read-only. Reports whether the store exists, the freshness badge, and index
-stats (files indexed, nodes, edges). Never refreshes.
+Read-only. Reports whether the physical store path exists, whether a valid
+index is readable, the freshness badge, and index stats (files indexed, nodes,
+edges). `store_exists`, `index_exists`, and `index_manifest_exists` deliberately
+separate a directory containing job records from a usable index. Never refreshes.
 
 ```bash
 brainclaw code-map status
@@ -47,6 +49,7 @@ brainclaw code-map status
 ```
 Code Map status
   Store:    present
+  Index:    ready
   Root:     /workspace/apps/api
   Path:     /workspace/apps/api/.brainclaw/code
   Freshness: fresh
@@ -55,7 +58,7 @@ Code Map status
   Edges:    2410
 ```
 
-### `brainclaw code-map refresh [--changed | --all]`
+### `brainclaw code-map refresh [--changed | --all | --scope changed|all]`
 
 Rebuilds the index behind a per-project lock. Defaults to `--changed`.
 
@@ -63,6 +66,7 @@ Rebuilds the index behind a per-project lock. Defaults to `--changed`.
 |---|---|
 | `--changed` (default) | Re-parses files whose **content** changed (git status + file-hash diff) **and** any shard whose stored extractor-config / grammar / engine hashes no longer match the current ones (i.e. `stale_extractor` / `stale_grammar`). A config or grammar bump is therefore healed by this cheap path — not only by `--all`. Compaction is limited to git-proven deletes. |
 | `--all` | Enumerates every supported file, re-parses, and performs full orphan compaction (drops shards whose file is gone or now ignored). |
+| `--scope changed\|all` | Uses the same scope spelling as MCP. Existing `--changed` / `--all` flags remain supported. |
 
 If a live writer already holds the project lock, `refresh` **fails fast** with a
 clear status rather than blocking — it never stalls `bclaw_work`.
@@ -70,6 +74,7 @@ clear status rather than blocking — it never stalls `bclaw_work`.
 ```bash
 brainclaw code-map refresh            # changed (cheap, default)
 brainclaw code-map refresh --all      # full rebuild + compaction
+brainclaw code-map refresh --scope changed
 ```
 
 ### `brainclaw code-map find <query>`
@@ -126,11 +131,15 @@ all return a `freshness_badge`:
 
 | Tool | Kind | Purpose |
 |---|---|---|
-| `bclaw_code_status` | read | Active-session project store, freshness, index stats; `cascade=true` also follows the latest cascade job. Never refreshes. |
-| `bclaw_code_find` | read | Ranked symbol-index search (`query`, optional `limit`). Never refreshes. |
-| `bclaw_code_brief` | read | Reading brief for a symbol/path (`target`, optional `limit`, files capped at 12). Never refreshes. |
+| `bclaw_code_status` | read | Active-session or explicit `project` store/path/index diagnostics, freshness, stats, and latest refresh job; `cascade=true` also follows the latest cascade job. Never refreshes. |
+| `bclaw_code_find` | read | Ranked symbol-index search (`query`, optional `limit`/`project`). Never refreshes. |
+| `bclaw_code_brief` | read | Reading brief for a symbol/path (`target`, optional `limit`/`project`, files capped at 12). Never refreshes. |
 | `bclaw_code_export` | read | Bounded local subgraph around required `target`; direction/depth/node/edge caps, confidence filtering, and optional Mermaid projection. Never refreshes. |
-| `bclaw_code_refresh` | write | Rebuild the index. `scope` = `"changed"` (default) or `"all"`; MCP `cascade=true` starts a durable background job and returns immediately. |
+| `bclaw_code_refresh` | write | Accept a durable background rebuild and return immediately. `scope` = `"changed"` (default) or `"all"`; optional `project` targets a named/id/path project, and `cascade=true` spans a workspace. |
+
+Every MCP Code Map tool accepts the same optional `project` selector (project
+name, id, or workspace-relative path). It overrides the active session for that
+call without mutating the session.
 
 The read tools never trigger a parse — if `bclaw_code_status` /
 `bclaw_code_find` / `bclaw_code_brief` report `missing_index` or a stale badge,
@@ -186,9 +195,9 @@ reconciliation at the read path:
    file-hash diff vs the stored shards), so a stale index is always *visible*,
    never silently wrong.
 3. `refresh --changed` re-parses only the changed files (incremental); `--all` does
-   a full rebuild + orphan compaction. The one bounded background path is an
-   explicitly requested MCP monorepo cascade, whose durable progress is read
-   through `bclaw_code_status(cascade=true)`.
+   a full rebuild + orphan compaction. MCP refreshes are explicit durable jobs;
+   their progress is read through `bclaw_code_status` (or
+   `bclaw_code_status(cascade=true)` for a workspace cascade).
 4. `bclaw_work` nudges a refresh when the badge is `missing_index` or stale, so an
    agent knows to reconcile before trusting the map.
 
@@ -219,10 +228,12 @@ like any other directory.
 Both CLI and MCP status responses disclose the exact resolved project root and
 Code Map store path. The MCP response additionally includes `active_source`, the
 resolved project identity, the running server version, and the package version
-visible on disk. In a monorepo, compare these fields before concluding that an
-index is missing: a root store and a child store are intentionally distinct. If
-the versions differ, restart the MCP server; if the roots differ, select the
-intended project/session (or pass `cascade=true` at the workspace root).
+visible on disk. `store_exists` describes the physical directory;
+`index_exists` describes a valid readable manifest. In a monorepo, compare
+these fields before concluding that an index is missing: a root store and a
+child store are intentionally distinct. If the versions differ, restart the
+MCP server; if the roots differ, use `project="<name-or-path>"`, select the
+intended session project, or pass `cascade=true` at the workspace root.
 
 ### Cascading a multi-project workspace (`--cascade`)
 
@@ -242,9 +253,10 @@ double-indexing**, even when projects nest inside one another. `--cascade` is
 opt-in; without it, the root refresh keeps its single-tree behaviour (above), and
 single-project repos ignore the flag entirely.
 
-The CLI cascade stays synchronous. MCP `bclaw_code_refresh(cascade=true)` returns
-a durable `job_id` immediately, avoiding the client timeout that a large workspace
-can hit; follow it with `bclaw_code_status(cascade=true)`. Status reports completed
+The CLI cascade stays synchronous. Every MCP refresh returns a durable `job_id`
+immediately, avoiding client timeouts; follow a normal refresh with
+`bclaw_code_status(project=...)`, or a cascade with
+`bclaw_code_status(cascade=true)`. Status reports completed
 and total project counts, the project currently being indexed, and terminal
 outcomes. Successful rows are aggregated; only exceptions are named. A project
 with a valid empty index is labeled `no_eligible_files`, while lock contention and

package/docs/concepts/ideation-loop.md

@@ -49,7 +49,7 @@ proposal → critique ↔ revision → synthesis
 | Phase | Purpose | What the slot produces |
 |---|---|---|
 | `proposal` | Seed: the original idea / decision under consideration | A `proposal` artifact (the task text from the caller) |
-| `critique` | Adversarial review against project memory | One or more `critique` artifacts citing real memory ids |
+| `critique` | Adversarial review seeded by project memory and verified against the current worktree | One or more `critique` artifacts citing repository evidence and any memory ids used as leads |
 | `revision` | Champion's response to the critique batch | A `revision` artifact addressing the points raised |
 | `synthesis` | Final plan_draft folding the cycle's outputs | A `plan_draft` artifact with `addresses_critique:[ids]` |
 
@@ -171,6 +171,10 @@ goal: …
 ## what to produce
 - Phase "critique" expects you to act in role "critic".
 - Emit findings as LoopArtifacts via bclaw_loop intent='complete_turn'…
+- Treat memory as an investigation lead, not current-code proof.
+- Verify implementation findings against the worktree and cite a path plus a
+  line, symbol, assertion, or test/command result. Unverified concerns remain
+  questions, not findings.
 - Cite the memory ids you relied on so the synthesis can audit coverage.
 ```
 
@@ -222,26 +226,43 @@ filter, gate, iteration accounting) but want to drive each turn
 yourself — useful for one-shot consultations or when you don't have
 a separate critic agent on hand.
 
-### Multi-agent mode
+### Multi-instance, multi-turn mode
 
 ```
 bclaw_coordinate(intent='ideate',
                  task='Should we adopt approach A or approach B?',
-                 targetAgents=['codex'])
+                 targetAgents=['codex', 'codex', 'codex'],
+                 criticPerspectives=[
+                   'challenge assumptions and demand evidence',
+                   'focus on failure modes and recovery',
+                   'develop alternatives and compare trade-offs'
+                 ])
 ```
 
 - Opens a loop with `champion` slot (caller) + one `critic` slot per
-  target agent.
+  requested target instance. Repeated identities are intentional: a user with
+  only one installed agent can request three isolated Codex, Claude, or other
+  critic instances. Each occurrence gets its own slot, claim, worktree,
+  assignment, and turn authority; the three-artifact gate does not require
+  three different agent families.
 - Stores `task` as a `proposal` artifact.
 - Advances proposal → critique.
-- For each critic slot: assembles the brief via `buildIdeationBrief`
-  honouring the critique phase's context_filter, calls
-  `bclaw_loop(intent='turn')` to flip the slot to `assigned`, and
-  queues a coordinate message with the brief as body and
-  `{intent: 'ideate', loop_id, slot_id, phase, iteration,
-  proposal_artifact_id}` payload.
+- Persists a distinct `perspective` on every critic slot. When
+  `criticPerspectives` is omitted, Brainclaw supplies complementary evidence,
+  failure-mode, and alternatives/trade-off lenses.
+- Uses `ideation_schedule='sequential'` by default. Only critic A starts
+  initially. After its result is harvested, `continuations` and `next_actions`
+  name critic B's real `turn(dispatch=true)`; B's brief includes A's critique
+  from the current round. C then sees A+B. The champion revises after the gate,
+  and the ordered conversation starts again in the next iteration.
+- `ideation_schedule='parallel'` is an explicit latency/quality trade-off that
+  starts every critic immediately. It is useful when independent first
+  impressions matter more than cross-challenge and token cost.
+- `brainclaw harvest <assignment>` and MCP `bclaw_harvest` both surface the
+  loop continuation. Workers may also finish through `complete_turn` directly.
 - Returns `{loop_id, …, mode: 'multi_agent',
-  dispatched_critics: N, current_phase: 'critique'}`.
+  ideation_schedule, dispatched_critics, pending_critics,
+  current_phase: 'critique'}`.
 
 When the critique phase brief is truncated for any slot, a per-slot
 warning surfaces. When dispatch fails (e.g. an agent is unknown), the
@@ -299,9 +320,9 @@ which critiques were honoured vs ignored.
   framings, and "wrong question" findings that memory-driven critique
   is structurally unable to produce. Validated empirically; ships on
   its own cadence after MVP usage telemetry.
-- **Profile-based slot diversity.** Champion / simplifier / pessimist
-  as separate slot types with their own context filters. Deferred
-  until the single-slot model is validated in production.
+- **Richer perspective presets.** Slots already persist caller-provided or
+  default critic lenses. Named reusable perspective packs can build on that
+  contract without coupling diversity to agent identity.
 - **Cross-loop memory.** Promoting validated plan_drafts back into
   the project memory store with provenance. Today the synthesis
   artifact lives only in the loop event journal.

package/docs/integrations/mcp.md

@@ -47,7 +47,7 @@ Every tool has one of three tiers in its `annotations.tier` field:
 - **standard** — Day-to-day coordination tools: plans, claims, messaging, sequences, dispatch, review, memory. Returned by default alongside facades.
 - **advanced** — Specialized governance, audit, registry, and power tools.
 
-By default, `tools/list` returns **facade + standard** tools (49 tools). To get all tools including advanced, pass `{ "catalog": "all" }`, `{ "include": "all" }`, or `{ "advanced": true }`. To filter by a single tier, pass `{ "tier": "facade" }`, `{ "tier": "standard" }`, or `{ "tier": "advanced" }`.
+By default, `tools/list` returns **facade + standard** tools (50 tools). To get all tools including advanced, pass `{ "catalog": "all" }`, `{ "include": "all" }`, or `{ "advanced": true }`. To filter by a single tier, pass `{ "tier": "facade" }`, `{ "tier": "standard" }`, or `{ "tier": "advanced" }`.
 
 Published tools remain callable regardless of catalog filtering — the tier only affects discovery via `tools/list`.
 
@@ -101,6 +101,7 @@ Each tool also has an `annotations.category` field: `session`, `context`, `memor
 | `bclaw_assignment_update` | coordination | Report assignment lifecycle status; v2 logical Assignments require the full generation fence and accept only accepted/started/progress before settlement |
 | `bclaw_assignment_action` | coordination | Resolve or reject a pending ActionRequired item |
 | `bclaw_harvest_candidates` | coordination | Harvest sandboxed worktree candidate files into the main project store |
+| `bclaw_harvest` | coordination | Harvest or integrate worker `LANE-RESULT.json` files, reconcile loop turns, and return the exact continuation |
 | `bclaw_find` | memory | List canonical entities with filters |
 | `bclaw_get` | memory | Fetch a canonical entity by id or short label |
 | `bclaw_create` | memory | Create a canonical entity |
@@ -108,13 +109,13 @@ Each tool also has an `annotations.category` field: `session`, `context`, `memor
 | `bclaw_remove` | memory | Archive or purge a canonical entity |
 | `bclaw_transition` | memory | Move an entity through its validated state machine |
 | `bclaw_move` | memory | Relocate an item to another project, id-preserving (multi-project) |
-| `bclaw_code_status` | discovery | Active-session Code Map freshness + stats; `cascade:true` follows durable monorepo refresh progress and exceptions |
-| `bclaw_code_find` | discovery | Search the Code Map symbol index by name (function/class/component/hook/type) |
-| `bclaw_code_brief` | discovery | Ranked reading list + related decisions/traps before editing a symbol or path |
+| `bclaw_code_status` | discovery | Active-session or explicit `project` Code Map path/index diagnostics + freshness/stats; follows durable refresh jobs, with `cascade:true` for workspace progress |
+| `bclaw_code_find` | discovery | Search the active or explicit `project` Code Map symbol index by name |
+| `bclaw_code_brief` | discovery | Ranked reading list + related decisions/traps before editing a symbol or path, optionally targeted by `project` |
 | `bclaw_code_impact` | discovery | Explainable local blast radius from resolved imports: definition, direct dependents, opt-in bounded transitives, tests, and count-based risk |
 | `bclaw_code_export` | discovery | Compact bounded local nodes/edges around one symbol or file; preserves edge kind/source/confidence, with optional Mermaid projection |
 | `bclaw_code_outline` | discovery | Source-ordered symbols of one indexed file (span, exported, confidence) — no reparse |
-| `bclaw_code_refresh` | discovery | Rebuild the Code Map index (`scope: changed \| all`); `cascade:true` starts a durable background job |
+| `bclaw_code_refresh` | discovery | Accept a durable Code Map rebuild (`scope: changed \| all`, optional `project`) and return immediately; `cascade:true` spans a workspace |
 
 See [code map](../code-map.md) for the full Code Map reference (CLI, freshness model, supported languages).
 
@@ -403,11 +404,20 @@ bclaw_dispatch({ intent: 'review', openLoop: true, reviewMode: 'symmetric' })
 // synthesis are worker phases available through trusted turn(dispatch:true).
 bclaw_coordinate({ intent: 'ideate', task: 'Should we extract the dispatcher into a separate package?' })
 
-// Multi-agent ideation: critic gets a context-filtered, BM25-ranked brief auto-dispatched
+// Multi-instance ideation is sequential and multi-turn by default: each critic
+// sees the earlier contributions in its round. Repeated identities are valid.
 bclaw_coordinate({
   intent: 'ideate',
   task: 'Should we adopt approach A or approach B?',
-  targetAgents: ['codex'],
+  targetAgents: ['codex', 'codex', 'codex'],
+  criticPerspectives: ['assumptions/evidence', 'failure modes/recovery', 'alternatives/trade-offs'],
+})
+
+// Opt into independent immediate fan-out only when latency matters more than
+// cross-challenge and cost.
+bclaw_coordinate({
+  intent: 'ideate', task: 'Collect independent first impressions',
+  targetAgents: ['codex', 'codex', 'codex'], ideation_schedule: 'parallel',
 })
 
 // Open a direct implementation loop. The caller owns subsequent bind/turn

package/docs/mcp-schema-changelog.md

@@ -8,6 +8,62 @@ guarantees this changelog follows.
 
 ---
 
+## [1.28.5] — 2026-08-28
+
+- MCP public surface fingerprint: `sha256:f410416669e7fc9a`
+
+**Changed — Code Map project targeting and durable refresh**
+
+- Every `bclaw_code_*` input schema gains the same optional `project` selector
+  (name, id, or workspace-relative path). It overrides the active session for
+  one call without mutating it.
+- `bclaw_code_refresh` now acknowledges every refresh as a durable job, not
+  only multi-project cascades. Its `scope: "changed" | "all"` contract is
+  unchanged and no new field is required.
+- `bclaw_code_status` keeps its input compatibility while its result separates
+  physical path presence (`store_exists`) from a readable index
+  (`index_exists`, `index_manifest_exists`) and exposes the latest single-project
+  refresh job.
+
+All input changes are additive; no tool was added, removed, or renamed.
+
+## [1.28.4] — 2026-08-28
+
+- MCP public surface fingerprint: `sha256:42cd662667260792`
+
+**Added — lane-result harvest parity**
+
+- `bclaw_harvest` is a new standard coordination write tool matching the CLI
+  lane-result path. It accepts one `assignmentId` or `all=true`, optional
+  `worktreePaths`, `dryRun`, and `integrate`; successful report harvests return
+  reconciled `continuations` and executable `next_actions`.
+
+**Changed — ideation is instance-based and sequential by default**
+
+- `bclaw_coordinate(intent="ideate")` accepts repeated `targetAgents`, an
+  optional positionally aligned `criticPerspectives` array, and
+  `ideation_schedule: "sequential" | "parallel"` (default sequential).
+- The result adds `ideation_schedule` and `pending_critics`. Sequential briefs
+  include critiques already produced in the same round, so participants
+  challenge one another before champion revision and the next bounded round.
+
+**Changed — compact, actionable read projections**
+
+- `bclaw_find` accepts optional `fields`; one item larger than `budget_tokens`
+  is projected to identity/status fields and reports
+  `oversized_item_projected` rather than overrunning the response budget.
+- Agent rows add `declared_spawnable`, `executable_now`, `availability_code`,
+  and `availability_reason`.
+- Work context's `pending_notifications` is now a compact summary containing
+  `actionable_count`, `by_type`, and `telemetry_events_omitted`; the raw event
+  count remains available as `unseen_event_count`.
+- `bclaw_dispatch_status` adds canonical `terminal_signal` evidence and may
+  diagnose stale explicit progress as `stalled` despite a live wrapper PID or
+  unrelated filesystem activity.
+
+All changes are additive except the intentionally compacted
+`pending_notifications` value shape.
+
 ## [1.28.3] — 2026-08-26
 
 **Changed — durable Code Map cascade execution**
@@ -438,12 +494,13 @@ 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:be86e5571fcd0226`
-  (updated 2026-08-24 for persisted continuation authority: additive
-  `bclaw_loop(intent="continue")` inputs `action_index`, `autonomy_mode`, and
-  `risk`; the intent evaluates an attested Ideation→Implementation action,
-  persists AUTO/REQUIRE_APPROVAL/DENY, and reuses the public open/bind path.)
-  Previous: `sha256:681c47cba85b79c3`
+- MCP public surface fingerprint: `sha256:f410416669e7fc9a`
+  (updated 2026-08-28 for optional `project` targeting on every Code Map MCP
+  tool. Previous: `sha256:42cd662667260792`, updated for the additive
+  `bclaw_harvest` surface, sequential
+  ideation controls, compact read projections, and loop-slot perspective and
+  completion fields.)
+  Previous: `sha256:be86e5571fcd0226`
   (`LoopSlotInput` gains optional `lane`, `scope_hint`, `plan_ids`, and
   `step_ids` fields so implementation-loop lane scope and provenance survive
   through the public facade. Existing callers remain valid.)

package/package.json

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