docs: update async task documentation and enhance references for OpenClaw and SimpleX

Revised `ASYNC_HITL_SCOPE.md` to clarify cross-repo HITL wiring, including SimpleX and optional Signal. Enhanced `SESSION_BOOTSTRAP.md` with additional context for OpenClaw and SimpleX, linking to relevant documentation for gateway and token handling. Updated `CHEATSHEET.md` to provide more details on the brain map viewer's functionality and its relation to OpenGrimoire. Added a new entry in `async_tasks.yaml` for OpenClaw, documenting context window considerations. Improved `README.md` to include guidance on external tool config shims for model limits.

Author: ManintheCrowds

docs/ASYNC_HITL_SCOPE.md

@@ -2,7 +2,7 @@
 
 This document defines **policy and machine-readable shape** for multi-session and async-tolerant work. It complements narrative handoff (`handoff_latest.md`): handoff remains the story; **[state/async_tasks.yaml](../state/async_tasks.yaml)** is the single source of truth for **task identity, status, and ownership** when using async flows.
 
-**See also:** [HANDOFF_FLOW.md](HANDOFF_FLOW.md), [PUBLIC_AND_PRIVATE_HARNESS.md](PUBLIC_AND_PRIVATE_HARNESS.md), [state/README.md](../state/README.md). **Cross-repo HITL wiring (Signal, orchestrator, OpenClaw, matrix):** [local-proto `HITL_CONNECTIVITY.md`](../../MiscRepos/local-proto/docs/HITL_CONNECTIVITY.md) when both repos sit under the same parent directory (e.g. `GitHub/OpenHarness` and `GitHub/MiscRepos/local-proto`).
+**See also:** [HANDOFF_FLOW.md](HANDOFF_FLOW.md), [PUBLIC_AND_PRIVATE_HARNESS.md](PUBLIC_AND_PRIVATE_HARNESS.md), [state/README.md](../state/README.md). **Cross-repo HITL wiring (SimpleX, orchestrator, optional Signal, OpenClaw, matrix):** [local-proto `HITL_CONNECTIVITY.md`](../../MiscRepos/local-proto/docs/HITL_CONNECTIVITY.md) when both repos sit under the same parent directory (e.g. `GitHub/OpenHarness` and `GitHub/MiscRepos/local-proto`).
 
 ---
 

docs/CHEATSHEET.md

@@ -47,7 +47,7 @@ Use this table for **action parity** with humans (same script, agent via `run_te
 | `verify_contract_hash.py` | Verify `docs/contracts/scp_mcp_v1.md` SHA-256 matches `docs/contracts/scp_mcp_v1.sha256` | `python scripts/verify_contract_hash.py` |
 | `verify_script_index.py` | Parity: `capabilities.harness.yaml` `scripts[]` == on-disk scripts; each basename in this table | `python scripts/verify_script_index.py` |
 | `verify_skills_readme.py` | `.cursor/skills/README.md` table vs each `SKILL.md` `description:` | `python scripts/verify_skills_readme.py` |
-| `brain_map_viewer.html` | Local HTML viewer for graph JSON | Open in browser; optional dev aid |
+| `brain_map_viewer.html` | Local HTML viewer for graph JSON (vis-network; drag-drop or co-located `brain-map-graph.json`) | Open in browser; optional dev aid. **Operator-facing map (canonical UI in OpenGrimoire):** [OpenGrimoire `docs/GUI_ACTION_MAP_BRAIN_MAP.md`](../../OpenGrimoire/docs/GUI_ACTION_MAP_BRAIN_MAP.md) |
 
 **Clipboard / headless:** `copy_continue_prompt.*` copies to the **system clipboard** and assumes an interactive session with clipboard support. In **headless or CI** environments, agents should read [`state/continue_prompt.txt`](../state/continue_prompt.txt) directly or paste from that file instead of relying on clipboard APIs.
 

docs/SESSION_BOOTSTRAP.md

@@ -14,7 +14,7 @@
 7. **known-issues** — `state/known-issues.md` (if present)
 8. **daily** — optional: `state/daily/YYYY-MM-DD.md` for today or recent days (session summaries)
 
-9. **Async / multi-session** — if handoff sets `latency_tolerance: async_ok` or work may overlap across sessions: [ASYNC_HITL_SCOPE.md](ASYNC_HITL_SCOPE.md), then `state/async_tasks.yaml` (SSOT for task id, status, owner).
+9. **Async / multi-session** — if handoff sets `latency_tolerance: async_ok` or work may overlap across sessions: [ASYNC_HITL_SCOPE.md](ASYNC_HITL_SCOPE.md), then `state/async_tasks.yaml` (SSOT for task id, status, owner). If the session involves **OpenClaw**, **SimpleX** (default phone HITL), or phone/async continuation off the IDE, read sibling [MiscRepos `local-proto/docs/OPENCLAW_READINESS.md`](../../MiscRepos/local-proto/docs/OPENCLAW_READINESS.md) (gateway listen, token handling, VRAM / tool-capable model table) before changing `openclaw.json` or debugging channels; for ledger ↔ **SimpleX** / optional Signal / orchestrator, see [MiscRepos `local-proto/docs/HITL_CONNECTIVITY.md`](../../MiscRepos/local-proto/docs/HITL_CONNECTIVITY.md).
 
 Then use project-specific docs, rules, and skills as routed (e.g. [.cursor/rules/](../.cursor/rules/), [.cursor/skills/](../.cursor/skills/)).
 
@@ -24,6 +24,8 @@ Then use project-specific docs, rules, and skills as routed (e.g. [.cursor/rules
 
 - [HANDOFF_FLOW.md](HANDOFF_FLOW.md) — archive, write handoff, continue prompt
 - [ASYNC_HITL_SCOPE.md](ASYNC_HITL_SCOPE.md) — async task ids, ownership, conflict rules; `state/async_tasks.yaml`
+- [OPENCLAW_READINESS.md](../../MiscRepos/local-proto/docs/OPENCLAW_READINESS.md) — OpenClaw gateway, token, Ollama tool-capable model checks (sibling clone layout)
+- [HITL_CONNECTIVITY.md](../../MiscRepos/local-proto/docs/HITL_CONNECTIVITY.md) — harness ledger ↔ SimpleX / OpenClaw / optional Signal (sibling clone layout)
 - [CHEATSHEET.md](CHEATSHEET.md) — one-page map and script index
 - [AGENT_ENTRY.md](AGENT_ENTRY.md) — agent entry chain
 - [OPENHARNESS_CONTEXT_MAP.md](OPENHARNESS_CONTEXT_MAP.md) — checklist → file paths

docs/examples/HANDOFF_EXAMPLE_SYNTHETIC.md

@@ -34,6 +34,7 @@
 
 - Use zod for request body; reject unknown keys.
 - Rate limit deferred to milestone 2.
+- **Fictional external shim:** ExampleBot’s `micro-llm` entry in the vendor config registry declares an inflated `contextWindow` so the host agent runtime passes its minimum-context check; the **real** model window is ~2k tokens—long threads and merge-quality reasoning are still a harness concern, not a chat-bot concern.
 
 ## Context (optional)
 

scripts/brain_map_viewer.html

@@ -1,4 +1,5 @@
 <!DOCTYPE html>
+<!-- Canonical operator brain-map UI: OpenGrimoire /context-atlas + GET /api/brain-map/graph. This file is a harness-only static viewer; merge OpenHarness state into the graph via MiscRepos build_brain_map.py + CURSOR_STATE_DIRS (see OpenGrimoire docs/GUI_ACTION_MAP_BRAIN_MAP.md). -->
 <html lang="en">
 <head>
   <meta charset="UTF-8">

state/README.md

@@ -49,6 +49,7 @@ Updated: <ISO8601>
 
 ## Decisions / gotchas (optional)
 - <decision or caveat>
+- Document **external tool config shims** when the declared registry limits differ from the true model or API limits (e.g. OpenClaw model registry vs. actual context or tool support).
 
 ## scope (optional)
 <session boundary>

state/async_tasks.yaml

@@ -8,3 +8,9 @@ tasks:
     updated_at: "2026-03-26T12:00:00Z"
     paths: []
     notes: Synthetic placeholder for CI; replace or add real tasks as needed.
+  - id: task-20260404-openclaw-tinyllama
+    status: backlog
+    owner: human:harness-placeholder
+    updated_at: "2026-04-04T12:00:00Z"
+    paths: []
+    notes: "openclaw:tinyllama — Registry may declare raised contextWindow to satisfy OpenClaw minimum-context; treat effective context as ~2k. OpenClaw is not wired to this ledger by default; reconcile HITL outcomes here after operator actions. Merge-quality verification stays in harness (tests/lint/build), not OpenClaw."