Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

qa/new-scenarios-2026-04.md

@@ -0,0 +1,151 @@
+# QA Scenario Expansion - Round 2
+
+Ten repo-grounded candidate scenarios to add after the current seed suite.
+
+## 1. On-demand memory tools in channel context
+
+- Goal: verify the agent uses `memory_search` plus `memory_get` instead of bluffing when a channel message asks about prior notes.
+- Flow:
+  - Seed `MEMORY.md` or `memory/*.md` with a fact not present in the current transcript.
+  - Ask in a channel thread for that fact.
+  - Verify tool usage and final answer accuracy.
+- Pass:
+  - `memory_search` runs first.
+  - `memory_get` narrows to the right lines.
+  - Final answer cites the remembered fact correctly without cross-session leakage.
+- Docs: `docs/concepts/memory.md`, `docs/concepts/memory-search.md`
+- Code: `extensions/memory-core/src/tools.ts`, `extensions/memory-core/src/prompt-section.ts`
+
+## 2. Memory failure fallback
+
+- Goal: verify memory failure is graceful when embeddings/search are unavailable.
+- Flow:
+  - Disable or break the embedding-backed memory path.
+  - Ask for prior-note recall.
+  - Verify the agent surfaces uncertainty and next action instead of hallucinating.
+- Pass:
+  - Tool failure does not crash the run.
+  - Agent says it checked and could not confirm.
+  - Report includes the remediation hint.
+- Docs: `docs/concepts/memory.md`, `docs/help/faq.md`
+- Code: `extensions/memory-core/src/tools.shared.ts`, `extensions/memory-core/src/tools.citations.test.ts`
+
+## 3. Model switch with tool continuity
+
+- Goal: verify model switching preserves session context and tool availability, not just plain text continuity.
+- Flow:
+  - Start on one model.
+  - Switch to another configured model.
+  - Ask for a tool-using follow-up such as file read or memory lookup.
+- Pass:
+  - Switch is reflected in runtime state.
+  - Tool call still succeeds after the switch.
+  - Final answer keeps prior context.
+- Docs: `docs/help/testing.md`, `docs/concepts/model-failover.md`
+- Code: `extensions/qa-lab/src/suite.ts`, `docs/web/webchat.md`
+
+## 4. MCP-backed recall via QMD/mcporter
+
+- Goal: verify an MCP-backed tool path works end to end, not just core tools.
+- Flow:
+  - Enable `memory.qmd.mcporter`.
+  - Ask for recall that should route through the QMD MCP bridge.
+  - Verify response and captured MCP execution path.
+- Pass:
+  - MCP-backed search path is used.
+  - Returned snippet matches the right note.
+  - Failure mode is explicit if the daemon/tool is missing.
+- Docs: `docs/gateway/secrets.md`, `docs/concepts/memory-qmd.md`
+- Code: `extensions/memory-core/src/memory/qmd-manager.ts`, `extensions/memory-core/src/memory/qmd-manager.test.ts`
+
+## 5. Skill visibility and invocation
+
+- Goal: verify the agent sees a workspace/project skill and actually uses it.
+- Flow:
+  - Add a simple workspace or `.agents` skill.
+  - Confirm skill visibility through runtime inventory.
+  - Ask for a task that should trigger the skill.
+- Pass:
+  - Skill appears in `skills.status`.
+  - Agent invocation reflects the installed skill instructions.
+  - Per-agent allowlist behavior is respected.
+- Docs: `docs/tools/skills.md`, `docs/gateway/protocol.md`, `docs/gateway/configuration.md`
+- Code: `.agents/skills/openclaw-qa-testing/SKILL.md`, `docs/gateway/protocol.md`
+
+## 6. Skill install and hot availability
+
+- Goal: verify a newly installed skill becomes usable without a broken intermediate state.
+- Flow:
+  - Install a ClawHub or gateway-managed skill.
+  - Re-check skill inventory.
+  - Ask the agent to perform the skill-backed task.
+- Pass:
+  - Install succeeds.
+  - `skills.status` or `skills.bins` reflects the new skill.
+  - Agent can use the skill immediately or after the expected reload path.
+- Docs: `docs/tools/skills.md`, `docs/cli/skills.md`, `docs/gateway/protocol.md`
+- Code: `docs/gateway/protocol.md`, `docs/tools/skills.md`
+
+## 7. Native image generation
+
+- Goal: verify `image_generate` appears only when configured and returns a real attachment/artifact.
+- Flow:
+  - Configure `agents.defaults.imageGenerationModel.primary`.
+  - Ask for a simple generated image.
+  - Verify generated media is returned in the reply path.
+- Pass:
+  - `image_generate` is in the effective tool set.
+  - Generation succeeds with the configured provider/model.
+  - Output is attached and the agent summarizes what it created.
+- Docs: `docs/tools/image-generation.md`, `docs/providers/openai.md`
+- Code: `src/agents/openclaw-tools.image-generation.test.ts`, `src/image-generation/runtime.ts`
+
+## 8. Config patch skill disable
+
+- Goal: verify `config.patch` can disable a workspace skill and the restarted gateway exposes the disabled state cleanly.
+- Flow:
+  - Add a workspace skill and verify it is eligible.
+  - Use `config.patch` to disable that skill.
+  - Wait for the gateway restart and read `skills.status` again.
+- Pass:
+  - Patch succeeds.
+  - Gateway restarts cleanly.
+  - The skill flips from eligible to disabled.
+- Docs: `docs/gateway/configuration.md`, `docs/gateway/protocol.md`
+- Code: `docs/gateway/configuration.md`, `docs/web/control-ui.md`
+
+## 9. Restart-required config apply with wake-up
+
+- Goal: verify a restart-required config change restarts cleanly and wakes the session back up.
+- Flow:
+  - Use `config.apply` or `update.run` on a restart-required surface.
+  - Provide `sessionKey` so the operator gets the post-restart ping.
+  - Resume the task after restart.
+- Pass:
+  - Restart happens once.
+  - Session wake-up ping arrives.
+  - Agent continues in the same logical workflow after restart.
+- Docs: `docs/gateway/configuration.md`, `docs/web/control-ui.md`
+- Code: `docs/gateway/configuration.md`, `docs/gateway/protocol.md`
+
+## 10. Runtime inventory drift check
+
+- Goal: verify the reported tool and skill inventory matches what the agent can really use after config/plugin changes.
+- Flow:
+  - Read `tools.effective` and `skills.status`.
+  - Ask the agent to use one enabled thing and one disabled thing.
+  - Compare actual behavior vs reported inventory.
+- Pass:
+  - Enabled item is callable.
+  - Disabled item is absent or blocked for the right reason.
+  - Inventory and runtime behavior stay in sync.
+- Docs: `docs/gateway/protocol.md`, `docs/web/webchat.md`
+- Code: `docs/gateway/protocol.md`, `docs/web/control-ui.md`
+
+## Best next additions to the executable suite
+
+If we only promote three right away:
+
+1. On-demand memory tools in channel context
+2. Native image generation
+3. Config patch skill disable