brainclaw 1.28.1 → 1.28.2

package/dist/facts.js

@@ -1,8 +1,8 @@
 // Generated by scripts/emit-site-facts.mjs at build time. Do not edit manually.
-// Source: brainclaw v1.28.1 on 2026-08-24T17:40:07.204Z
+// Source: brainclaw v1.28.2 on 2026-08-25T18:22:09.950Z
 export const FACTS = {
-  "version": "1.28.1",
-  "generated_at": "2026-08-24T17:40:07.204Z",
+  "version": "1.28.2",
+  "generated_at": "2026-08-25T18:22:09.950Z",
   "tools": {
     "count": 70,
     "published_count": 68,
@@ -478,7 +478,7 @@ export const FACTS = {
   },
   "bench": {
     "schema": "brainclaw.bench.v1",
-    "generated_at": "2026-08-24T17:40:05.036Z",
+    "generated_at": "2026-08-25T18:22:07.761Z",
     "node_version": "v24.19.0",
     "platform": "linux-x64",
     "repeats": 3,
@@ -487,7 +487,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": 85,
+        "duration_ms_median": 82,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -495,7 +495,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": 128,
+        "duration_ms_median": 132,
         "payload_chars_median": 2626,
         "payload_tokens_est_median": 657
       },
@@ -503,9 +503,9 @@ export const FACTS = {
         "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": 1305,
-        "payload_tokens_est_median": 326
+        "duration_ms_median": 13,
+        "payload_chars_median": 1629,
+        "payload_tokens_est_median": 407
       }
     ]
   }

package/dist/facts.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.28.1",
-  "generated_at": "2026-08-24T17:40:07.204Z",
+  "version": "1.28.2",
+  "generated_at": "2026-08-25T18:22:09.950Z",
   "tools": {
     "count": 70,
     "published_count": 68,
@@ -476,7 +476,7 @@
   },
   "bench": {
     "schema": "brainclaw.bench.v1",
-    "generated_at": "2026-08-24T17:40:05.036Z",
+    "generated_at": "2026-08-25T18:22:07.761Z",
     "node_version": "v24.19.0",
     "platform": "linux-x64",
     "repeats": 3,
@@ -485,7 +485,7 @@
         "name": "cold_onboard",
         "volume": "empty",
         "description": "fresh machine → init → first useful context. Baseline for time-to-first-value.",
-        "duration_ms_median": 85,
+        "duration_ms_median": 82,
         "payload_chars_median": 1640,
         "payload_tokens_est_median": 410
       },
@@ -493,7 +493,7 @@
         "name": "warm_work",
         "volume": "medium",
         "description": "bclaw_work consult over a real-shaped store (~200 plans / 500 handoffs / 450 claims).",
-        "duration_ms_median": 128,
+        "duration_ms_median": 132,
         "payload_chars_median": 2626,
         "payload_tokens_est_median": 657
       },
@@ -501,9 +501,9 @@
         "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": 1305,
-        "payload_tokens_est_median": 326
+        "duration_ms_median": 13,
+        "payload_chars_median": 1629,
+        "payload_tokens_est_median": 407
       }
     ]
   }

package/docs/code-map.md

@@ -47,6 +47,8 @@ brainclaw code-map status
 ```
 Code Map status
   Store:    present
+  Root:     /workspace/apps/api
+  Path:     /workspace/apps/api/.brainclaw/code
   Freshness: fresh
   Files:    142
   Nodes:    1873
@@ -212,6 +214,14 @@ Code Map to **that child** — the same per-project scoping that powers `bclaw_w
 juggling. A submodule that is itself an application (under e.g. `apps/`) is indexed
 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).
+
 ### Cascading a multi-project workspace (`--cascade`)
 
 In a `project_mode: multi-project` workspace, one refresh at the root can index

package/docs/concepts/loop-engine.md

@@ -518,6 +518,11 @@ The Loop engine is a **control plane**; existing primitives remain the **data pl
 
 A Loop never copies these objects — it links them. Deleting the linked primitive does not break the loop; the reference just becomes dangling, surfaced in diagnostics.
 
+Inline `LoopArtifact.body` values are capped at **4096 UTF-8 bytes**, not 4096
+characters. Larger task and result text remains available through its source
+object or a `ref`; any inline projection is byte-truncated with an explicit
+`…[truncated]` marker. This contract is identical for review and ideation.
+
 ## Per-protocol guides
 
 Each of the five kinds has its own operator-facing guide with the same

package/package.json

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