brainclaw 1.9.1 → 1.10.0

package/dist/core/facade-schema.js

@@ -196,5 +196,14 @@ export const FacadeResponseSchema = z.object({
      * remains for the bootstrap hint; new consumers should read this array.
      */
     next_actions: z.array(NextActionSchema).optional(),
+    /**
+     * Code Map P0 (spec §10): opt-in, present ONLY when the project's Code Map
+     * manifest carries `code_map_enabled: true`. Absent for every project that
+     * has not turned Code Map on (the P0 default), so existing bclaw_work callers
+     * are unaffected and the off-path adds no work. Shape mirrors
+     * CodeMapWorkSection: { enabled, matches, freshness_badge, missing_index?,
+     * lock_wait_ms? }. Passthrough so the section can evolve without a schema bump.
+     */
+    code_map: z.object({}).passthrough().optional(),
 });
 //# sourceMappingURL=facade-schema.js.map

package/dist/core/instruction-templates.js

@@ -233,6 +233,7 @@ function renderSessionProtocol() {
         '1. Call `bclaw_work(intent)` (consult|execute|resume|review) — one call handles session, context, and claim (execute). Every response carries `next_actions` with the exact follow-up calls: follow those instead of memorizing the API.',
         '2. Canonical grammar for memory objects: `bclaw_find` / `bclaw_get` / `bclaw_create` / `bclaw_update` / `bclaw_remove` / `bclaw_transition` (entity, …).',
         '3. Do not assume project state without reading brainclaw context first.',
+        '4. Before editing unfamiliar code, orient with the **Code Map**: `bclaw_code_brief(target=<symbol|path>)` for a ranked reading list + related decisions/traps, `bclaw_code_find(query=<name>)` to locate a symbol/class/component. Don\'t grep the repo blind when a symbol index already answers "where is X / what should I read first". A `missing_index`/stale badge means run `bclaw_code_refresh` first.',
         '',
         'Escalation (only when orchestrating other agents): `bclaw_coordinate(intent=review|consult|assign)`. Verify any dispatch with `bclaw_dispatch_status(target_id)` — trust its sentinel-based verdict, not the tracked pid. Details: `docs/concepts/dispatch-lifecycle.md`.',
     ].join('\n');
@@ -322,6 +323,7 @@ function renderAvailableTools() {
         '**Session/claims:** `bclaw_session_start`, `bclaw_session_end`, `bclaw_claim`, `bclaw_release_claim` · **steps:** `bclaw_add_step`, `bclaw_complete_step`, `bclaw_update_step`, `bclaw_delete_step` · **sequences:** `bclaw_list_sequences`, `bclaw_create_sequence`, `bclaw_update_sequence`, `bclaw_delete_sequence`',
         '**Inbox:** `bclaw_read_inbox`, `bclaw_ack_message`, `bclaw_send_message`, `bclaw_correct_handoff` · **capture:** `bclaw_write_note`, `bclaw_quick_capture(text, type?)` · **search:** `bclaw_search` · **setup:** `bclaw_setup`, `bclaw_bootstrap`, `bclaw_switch`, `bclaw_release_notes`',
         '**Escalation (orchestrators):** `bclaw_coordinate(intent=review|consult|assign|ideate)` · `bclaw_dispatch(intent=execute)` on an active sequence · `bclaw_loop(intent=turn|complete_turn|advance|close)` to drive turns · `bclaw_dispatch_status(target_id)` to verify',
+        '**Code discovery (Code Map):** `bclaw_code_find(query)` locate a symbol/class/component · `bclaw_code_brief(target)` ranked reading list + related memory before editing · `bclaw_code_status` / `bclaw_code_refresh` check freshness / rebuild the symbol+import index. Use it before grepping unfamiliar code — see `docs/code-map.md`.',
         '',
         'Responses are self-teaching — follow their `next_actions`. Full catalog + stability contract: `docs/integrations/mcp.md`, `docs/concepts/mcp-governance.md`.',
     ].join('\n');

package/dist/core/mcp-command-resolution.js

@@ -216,7 +216,9 @@ export function brainclawMcpEntry(agentName, existing, workspacePath) {
 export function quoteShellArg(arg) {
     if (/^[A-Za-z0-9_./:=+-]+$/.test(arg))
         return arg;
-    return `"${arg.replace(/"/g, '\\"')}"`;
+    // Escape backslashes before quotes — otherwise an input like `\"` would
+    // collapse to a quote that breaks out of the quoted argument.
+    return `"${arg.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
 }
 /**
  * Resolve the brainclaw CLI invocation for hook configs.

package/dist/core/store-resolution.js

@@ -94,8 +94,10 @@ export function resolveTargetStore(cwd = process.cwd(), target = 'local', option
  * 2. BRAINCLAW_CWD env var → workspace anchor injected by MCP configs
  * 3. BRAINCLAW_PROJECT env var → resolved by name/path from workspace anchor
  * 4. Session-scoped active project (from .current-session under the anchor)
- * 5. Global active-project.json in workspace root
- * 6. Workspace anchor or process.cwd()
+ * 5. cwd_child — the child project the agent is physically inside, under the anchor
+ * 5b. cwd_child (no anchor) — same, ceiling = discovered workspace root (F2)
+ * 6. Global active-project.json in workspace root
+ * 7. Workspace anchor or process.cwd()
  */
 export function resolveEffectiveCwd(options = {}) {
     return resolveEffectiveCwdInfo(options).cwd;
@@ -138,7 +140,42 @@ export function resolveEffectiveCwdInfo(options = {}) {
             return { cwd: sp.path, active_source: 'session', resolved_project: { path: sp.path, name: sp.name } };
         }
     }
-    // 5. Global active-project.json from workspace root
+    // 5. cwd_child — when anchored and the agent is physically inside a child store
+    //    STRICTLY under the anchor, resolve THAT child rather than the shared global
+    //    pointer or the anchor root. This is the independence rule: physical location
+    //    beats a shared/stale global (an agent working in apps/api resolves api, not the
+    //    monorepo root, and is not hijacked by another agent's global switch).
+    //
+    //    GUARD (Codex review): only fire when baseCwd differs from the anchor AND is
+    //    at/below it. `findClosestStoreBelow` walks UP to the ceiling but does NOT prove
+    //    baseCwd sits below it — without the `isAtOrBelow` guard a baseCwd OUTSIDE the
+    //    anchor could match an unrelated `.brainclaw` before hitting the filesystem root.
+    if (baseCwd !== anchorCwd && isAtOrBelow(baseCwd, anchorCwd)) {
+        const child = findClosestStoreBelow(baseCwd, anchorCwd);
+        if (child && path.resolve(child) !== path.resolve(anchorCwd)) {
+            return { cwd: child, active_source: 'cwd_child', resolved_project: projectInfo(child) };
+        }
+    }
+    // 5b. cwd_child (NO anchor) — F2 [trp_71accb07]: even without a BRAINCLAW_CWD
+    //     anchor, an agent physically inside a child project must resolve THAT
+    //     child rather than a stale/shared global pointer set by another agent.
+    //     Ceiling = the discovered workspace root via resolveWorkspaceRoot(baseCwd)
+    //     — NOT os.homedir() (that would revive the F6 boundary edge and could let
+    //     an unrelated home store influence a monorepo worker). Same containment
+    //     guard as the anchored case (isAtOrBelow + a child strictly below).
+    //     For a single-project repo this is a strict no-op: findClosestStoreBelow
+    //     walks UP to the ceiling EXCLUSIVELY, so it can never return the lone root
+    //     store (Codex cadrage non-regression proof, batch 2).
+    if (!hasEnvWorkspace) {
+        const physicalRoot = resolveWorkspaceRoot(baseCwd, options.storeChainOptions);
+        if (physicalRoot && isAtOrBelow(baseCwd, physicalRoot)) {
+            const child = findClosestStoreBelow(baseCwd, physicalRoot);
+            if (child && path.resolve(child) !== path.resolve(physicalRoot)) {
+                return { cwd: child, active_source: 'cwd_child', resolved_project: projectInfo(child) };
+            }
+        }
+    }
+    // 6. Global active-project.json from workspace root
     const wsRoot = hasEnvWorkspace ? anchorCwd : resolveWorkspaceRoot(anchorCwd, options.storeChainOptions);
     if (wsRoot) {
         const active = loadActiveProject(wsRoot);
@@ -146,7 +183,7 @@ export function resolveEffectiveCwdInfo(options = {}) {
             return { cwd: active.path, active_source: 'global', resolved_project: { path: active.path, name: active.name } };
         }
     }
-    // 6. Default
+    // 7. Default
     return { cwd: anchorCwd, active_source: 'cwd', resolved_project: projectInfo(anchorCwd) };
 }
 function projectInfo(cwd) {

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.9.1 on 2026-06-18T15:15:04.496Z
+// Source: brainclaw v1.10.0 on 2026-06-20T21:43:38.629Z
 export const FACTS = {
-  "version": "1.9.1",
-  "generated_at": "2026-06-18T15:15:04.496Z",
+  "version": "1.10.0",
+  "generated_at": "2026-06-20T21:43:38.629Z",
   "tools": {
-    "count": 62,
-    "published_count": 61,
+    "count": 66,
+    "published_count": 65,
     "names": [
       "bclaw_bootstrap",
       "bclaw_release_notes",
@@ -31,6 +31,10 @@ export const FACTS = {
       "bclaw_read_inbox",
       "bclaw_get_thread",
       "bclaw_dispatch_status",
+      "bclaw_code_status",
+      "bclaw_code_find",
+      "bclaw_code_brief",
+      "bclaw_code_refresh",
       "bclaw_dispatch",
       "bclaw_send_message",
       "bclaw_ack_message",

package/dist/facts.json

@@ -1,9 +1,9 @@
 {
-  "version": "1.9.1",
-  "generated_at": "2026-06-18T15:15:04.496Z",
+  "version": "1.10.0",
+  "generated_at": "2026-06-20T21:43:38.629Z",
   "tools": {
-    "count": 62,
-    "published_count": 61,
+    "count": 66,
+    "published_count": 65,
     "names": [
       "bclaw_bootstrap",
       "bclaw_release_notes",
@@ -29,6 +29,10 @@
       "bclaw_read_inbox",
       "bclaw_get_thread",
       "bclaw_dispatch_status",
+      "bclaw_code_status",
+      "bclaw_code_find",
+      "bclaw_code_brief",
+      "bclaw_code_refresh",
       "bclaw_dispatch",
       "bclaw_send_message",
       "bclaw_ack_message",