brainclaw 1.28.3 → 1.28.4

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.4 on 2026-08-28T07:25:30.486Z
 export const FACTS = {
-  "version": "1.28.3",
-  "generated_at": "2026-08-25T23:07:33.877Z",
+  "version": "1.28.4",
+  "generated_at": "2026-08-28T07:25:30.486Z",
   "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-28T07:25:28.367Z",
     "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": 80,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -495,7 +496,7 @@ 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,
+        "duration_ms_median": 124,
         "payload_chars_median": 2626,
         "payload_tokens_est_median": 657
       },

package/dist/facts.json

@@ -1,9 +1,9 @@
 {
-  "version": "1.28.3",
-  "generated_at": "2026-08-25T23:07:33.877Z",
+  "version": "1.28.4",
+  "generated_at": "2026-08-28T07:25:30.486Z",
   "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-28T07:25:28.367Z",
     "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": 80,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -493,7 +494,7 @@
         "name": "warm_work",
         "volume": "medium",
         "description": "bclaw_work consult over a real-shaped store (~200 plans / 500 handoffs / 450 claims).",
-        "duration_ms_median": 122,
+        "duration_ms_median": 124,
         "payload_chars_median": 2626,
         "payload_tokens_est_median": 657
       },

package/docs/cli.md

@@ -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/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 |
@@ -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,43 @@ guarantees this changelog follows.
 
 ---
 
+## [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 +475,11 @@ 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:42cd662667260792`
+  (updated 2026-08-28 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.4",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "repository": {