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/scenarios/memory/active-memory-preprompt-recall.yaml

@@ -0,0 +1,237 @@
+title: Active Memory pre-reply recall
+
+scenario:
+  id: active-memory-preprompt-recall
+  surface: memory
+  coverage:
+    primary:
+      - memory.active-recall
+    secondary:
+      - memory.recall
+  objective: Verify Active Memory surfaces a memory-only preference before the main reply, and that the same question stays unresolved when the plugin is off.
+  plugins:
+    - active-memory
+  gatewayConfigPatch:
+    plugins:
+      entries:
+        active-memory:
+          enabled: true
+          config:
+            enabled: true
+            agents:
+              - qa
+            allowedChatTypes:
+              - direct
+            logging: true
+            persistTranscripts: true
+            transcriptDir: qa-memory-e2e
+            queryMode: recent
+            maxSummaryChars: 220
+  successCriteria:
+    - With Active Memory off after doctor migrates the legacy session toggle, the session shows no Active Memory plugin activity.
+    - With Active Memory on, plugin-owned evidence shows the Active Memory sub-agent searched memory before the main reply.
+    - Live lane proves the first user-visible reply uses the recalled preference.
+  docsRefs:
+    - docs/concepts/active-memory.md
+    - docs/concepts/memory-search.md
+  codeRefs:
+    - extensions/active-memory/index.ts
+    - extensions/active-memory/doctor-contract-api.ts
+    - extensions/qa-lab/src/suite.ts
+    - extensions/qa-lab/src/mock-openai-server.ts
+  execution:
+    kind: flow
+    summary: Verify Active Memory stays off when session-toggled off, runs memory search/get when enabled, and helps a live model answer with the recalled preference in the first visible reply.
+    config:
+      requiredChannelDriver: qa-channel
+      baselineConversationId: qa-active-memory-off
+      activeConversationId: qa-active-memory-on
+      memoryFact: "Stable QA movie night usual favorite snack preference: lemon pepper wings with blue cheese."
+      memoryQuery: "QA movie night snack lemon pepper wings blue cheese"
+      expectedNeedle: lemon pepper wings
+      prompt: "Silent snack recall check: what snack do I usually want for QA movie night? Reply in one short sentence."
+      promptSnippet: "Silent snack recall check"
+      transcriptDir: qa-memory-e2e
+
+flow:
+  steps:
+    - name: only active memory surfaces the hidden snack preference
+      actions:
+        - call: reset
+        - call: fs.rm
+          args:
+            - expr: "path.join(env.gateway.workspaceDir, 'MEMORY.md')"
+            - force: true
+        - call: fs.rm
+          args:
+            - expr: "path.join(env.gateway.workspaceDir, 'memory', `${formatMemoryDreamingDay(Date.now())}.md`)"
+            - force: true
+        - call: fs.writeFile
+          args:
+            - expr: "path.join(env.gateway.workspaceDir, 'MEMORY.md')"
+            - expr: "`${config.memoryFact}\\n`"
+            - utf8
+        - call: forceMemoryIndex
+          args:
+            - env:
+                ref: env
+              query:
+                expr: config.memoryQuery
+              expectedNeedle:
+                expr: config.expectedNeedle
+        - set: baselineSessionKey
+          value:
+            expr: "'agent:qa:qa-channel:direct:active-memory-off'"
+        - set: activeSessionKey
+          value:
+            expr: "'agent:qa:qa-channel:direct:active-memory-on'"
+        - set: transcriptRoot
+          value:
+            expr: "path.join(env.gateway.tempRoot, 'state', 'plugins', 'active-memory', 'transcripts', 'agents', 'qa', config.transcriptDir)"
+        - set: toggleStorePath
+          value:
+            expr: "path.join(env.gateway.tempRoot, 'state', 'plugins', 'active-memory', 'session-toggles.json')"
+        - call: fs.rm
+          args:
+            - ref: transcriptRoot
+            - recursive: true
+              force: true
+        - call: fs.rm
+          args:
+            - ref: toggleStorePath
+            - force: true
+        - call: fs.mkdir
+          args:
+            - expr: "path.dirname(toggleStorePath)"
+            - recursive: true
+        - call: fs.writeFile
+          args:
+            - ref: toggleStorePath
+            - expr: "`${JSON.stringify({ sessions: { [baselineSessionKey]: { disabled: true, updatedAt: Date.now() } } }, null, 2)}\\n`"
+            - utf8
+        - call: runQaCli
+          saveAs: doctorFixOutput
+          args:
+            - ref: env
+            - - doctor
+              - --fix
+              - --yes
+            - timeoutMs:
+                expr: liveTurnTimeoutMs(env, 60000)
+        - assert:
+            expr: "String(doctorFixOutput).includes('Migrated 1 Active Memory session toggle entry')"
+            message:
+              expr: "`doctor --fix did not migrate the Active Memory session toggle: ${doctorFixOutput}`"
+        - set: requestCountBeforeBaseline
+          value:
+            expr: "env.mock ? (await fetchJson(`${env.mock.baseUrl}/debug/requests`)).length : 0"
+        - set: baselineStartIndex
+          value:
+            expr: "state.getSnapshot().messages.length"
+        - call: runAgentPrompt
+          args:
+            - ref: env
+            - sessionKey:
+                ref: baselineSessionKey
+              message:
+                expr: config.prompt
+              timeoutMs:
+                expr: liveTurnTimeoutMs(env, 45000)
+        - call: waitForOutboundMessage
+          saveAs: baselineOutbound
+          args:
+            - ref: state
+            - lambda:
+                params: [candidate]
+                expr: "candidate.conversation.id === 'qa-operator'"
+            - expr: liveTurnTimeoutMs(env, 30000)
+            - sinceIndex:
+                ref: baselineStartIndex
+        - set: baselineLower
+          value:
+            expr: "normalizeLowercaseStringOrEmpty(baselineOutbound.text)"
+        - if:
+            expr: "Boolean(env.mock)"
+            then:
+              - set: baselineMockRequests
+                value:
+                  expr: "(await fetchJson(`${env.mock.baseUrl}/debug/requests`)).slice(requestCountBeforeBaseline)"
+        - set: baselineSessionStore
+          value:
+            expr: "await readRawQaSessionStore(env)"
+        - assert:
+            expr: "!Array.isArray(baselineSessionStore[baselineSessionKey]?.pluginDebugEntries) || !baselineSessionStore[baselineSessionKey].pluginDebugEntries.some((pluginEntry) => pluginEntry?.pluginId === 'active-memory')"
+            message: baseline session unexpectedly recorded active-memory plugin activity
+        - set: requestCountBeforeActive
+          value:
+            expr: "env.mock ? (await fetchJson(`${env.mock.baseUrl}/debug/requests`)).length : 0"
+        - set: activeStartIndex
+          value:
+            expr: "state.getSnapshot().messages.length"
+        - call: runAgentPrompt
+          args:
+            - ref: env
+            - sessionKey:
+                ref: activeSessionKey
+              message:
+                expr: config.prompt
+              timeoutMs:
+                expr: liveTurnTimeoutMs(env, 45000)
+        - call: waitForOutboundMessage
+          saveAs: activeOutbound
+          args:
+            - ref: state
+            - lambda:
+                params: [candidate]
+                expr: "candidate.conversation.id === 'qa-operator'"
+            - expr: liveTurnTimeoutMs(env, 30000)
+            - sinceIndex:
+                ref: activeStartIndex
+        - set: activeLower
+          value:
+            expr: "normalizeLowercaseStringOrEmpty(activeOutbound.text)"
+        - if:
+            expr: "!env.mock"
+            then:
+              - assert:
+                  expr: "activeLower.includes(normalizeLowercaseStringOrEmpty(config.expectedNeedle))"
+                  message:
+                    expr: "`active memory reply missed the hidden preference: ${activeOutbound.text}`"
+        - call: waitForCondition
+          saveAs: transcriptPath
+          args:
+            - lambda:
+                async: true
+                expr: "await (async () => { const entries = (await fs.readdir(transcriptRoot).catch(() => [])).filter((entry) => entry.endsWith('.jsonl')).toSorted(); return entries.length > 0 ? path.join(transcriptRoot, entries.at(-1)) : undefined; })()"
+            - 10000
+        - call: fs.readFile
+          saveAs: transcriptText
+          args:
+            - ref: transcriptPath
+            - utf8
+        - assert:
+            expr: "transcriptText.includes('memory_search')"
+            message: active memory transcript missing memory_search
+        - assert:
+            expr: "transcriptText.includes('memory_get')"
+            message: active memory transcript missing memory_get
+        - call: waitForCondition
+          saveAs: activeSessionEntry
+          args:
+            - lambda:
+                async: true
+                expr: "await (async () => { const store = await readRawQaSessionStore(env); const entry = store[activeSessionKey]; if (!entry || !Array.isArray(entry.pluginDebugEntries)) return undefined; return entry.pluginDebugEntries.some((pluginEntry) => pluginEntry?.pluginId === 'active-memory' && Array.isArray(pluginEntry.lines) && pluginEntry.lines.some((line) => line.includes('Active Memory: status=ok'))) ? entry : undefined; })()"
+            - 10000
+        - if:
+            expr: "Boolean(env.mock)"
+            then:
+              - set: mockRequests
+                value:
+                  expr: "(await fetchJson(`${env.mock.baseUrl}/debug/requests`)).slice(requestCountBeforeActive)"
+              - assert:
+                  expr: "mockRequests.some((request) => request.allInputText.includes('You are a memory search agent.') && request.plannedToolName === 'memory_search')"
+                  message: expected mock Active Memory search request
+              - assert:
+                  expr: "mockRequests.some((request) => request.allInputText.includes('You are a memory search agent.') && request.plannedToolName === 'memory_get')"
+                  message: expected mock Active Memory memory_get request
+      detailsExpr: "`${activeOutbound.text}\\n\\ntranscript=${transcriptPath}`"