feat: strengthen foundation readiness evidence

Author: Jacobinwwey

docs/brainstorms/2026-04-19-mainline-progress-reconciliation-and-post-m7-direction-requirements.md

@@ -162,7 +162,7 @@ This document re-baselines current mainline truth on 2026-04-19, records what ch
   - `npm test -- src/learning/KnowledgeLearningPlatform.persistence.test.ts --runInBand`
 - The current working branch remains a reference source for future lanes, not a justification for direct wide merge.
 
-## Execution Note (2026-04-20 M8.1-M8.7)
+## Execution Note (2026-04-20 M8.1-M8.8)
 
 - The smallest executed post-M7 slice is now an evidence bundle, not an adapter claim:
   - `npm run verify:foundation:readiness`
@@ -189,6 +189,10 @@ This document re-baselines current mainline truth on 2026-04-19, records what ch
   - agent-workspace toolbar now exposes `Foundation Readiness`
   - runtime diagnostics snapshots persist `lastFoundationReadiness`
   - no status flip occurs; the route still reports `in_progress` / `no-go`.
+- The next bounded execution slice after that strengthens readiness evidence without overclaiming independent ANN:
+  - readiness now reports `queryBackendDefaultMode`
+  - readiness now reports `vectorAdapterLinkedIntoQueryBackend`
+  - operator UI and diagnostics snapshots expose the same linkage evidence, while overall status still remains `in_progress` / `no-go`.
 - Current expected outcome on `main` remains:
   - status `in_progress`
   - decision `no-go`

docs/diataxis/en/explanation/development-progress-dashboard.md

@@ -639,6 +639,24 @@ Execution anchor:
   - `npm run docs:diataxis:check`
   - `npm run docs:site:build`
 
+## Latest Mainline Increment (2026-04-20 M8.8 Foundation Readiness Adapter-Linkage Evidence)
+
+- Strengthened the readiness bundle so it now distinguishes static module presence from actual query-backend linkage evidence:
+  - `queryBackendDefaultMode`
+  - `vectorAdapterLinkedIntoQueryBackend`
+- Kept the readiness decision honest:
+  - current mainline still reports `in_progress` / `no-go`
+  - vector status remains `prefilter_only`
+  - independent ANN evidence is still absent
+- Surfaced the same linkage evidence through the agent-workspace toolbar summary and diagnostics snapshot:
+  - `src/frontend/agent_workspace_runtime.js`
+  - `src/frontend/locales/en.json`
+  - `src/frontend/locales/zh.json`
+- Added focused regression coverage for readiness utility contracts, platform mapping, and toolbar diagnostics:
+  - `src/foundation.readiness.contract.test.ts`
+  - `src/learning/KnowledgeLearningPlatform.test.ts`
+  - `src/agent_workspace.runtime.behavior.test.ts`
+
 ## Latest Mainline Increment (2026-04-20 M8.7 Foundation Readiness Toolbar Inspectability)
 
 - Added a bounded operator-side foundation-readiness entry point directly in the agent-workspace toolbar:

docs/diataxis/en/explanation/foundation-reentry-readiness-checklist.md

@@ -57,6 +57,8 @@ Bundle note:
   - decision `No-Go`
   - rationale: file-backed baseline exists, query-backend and vector-boundary modules are now present, but the vector adapter is still only `prefilter_only`, so independent ANN evidence is still absent.
 - The readiness payload now makes that distinction explicit:
+  - `queryBackendDefaultMode`
+  - `vectorAdapterLinkedIntoQueryBackend`
   - `vectorAdapterStatus`
   - `vectorAdapterIndependent`
 

docs/diataxis/zh/explanation/development-progress-dashboard.md

@@ -642,6 +642,24 @@
   - `npm run docs:diataxis:check`
   - `npm run docs:site:build`
 
+## 主线最新增量（2026-04-20 M8.8 Foundation Readiness Adapter 接线证据）
+
+- 已强化 readiness bundle，使其不再只停留在模块存在性，而是显式区分当前 query backend 与 vector adapter 的接线证据：
+  - `queryBackendDefaultMode`
+  - `vectorAdapterLinkedIntoQueryBackend`
+- 仍保持 readiness 决策诚实：
+  - 当前主线结果依旧是 `in_progress` / `no-go`
+  - vector 状态仍为 `prefilter_only`
+  - 独立 ANN 证据仍未进入主线
+- 同一份接线证据现在也会出现在 agent-workspace 工具栏摘要与 diagnostics snapshot 中：
+  - `src/frontend/agent_workspace_runtime.js`
+  - `src/frontend/locales/en.json`
+  - `src/frontend/locales/zh.json`
+- 已补 readiness utility 合同、platform 映射与工具栏 diagnostics 的聚焦回归：
+  - `src/foundation.readiness.contract.test.ts`
+  - `src/learning/KnowledgeLearningPlatform.test.ts`
+  - `src/agent_workspace.runtime.behavior.test.ts`
+
 ## 主线最新增量（2026-04-20 M8.7 Foundation Readiness 工具栏可检查性）
 
 - 已在 agent-workspace 工具栏补上受限 foundation-readiness 入口，方便执行侧直接检查当前主线基线：

docs/diataxis/zh/explanation/foundation-reentry-readiness-checklist.md

@@ -57,6 +57,8 @@
   - 决策 `No-Go`
   - 原因：file-backed 基线已存在，query-backend 与 vector 边界都已进入主线，但该 vector adapter 仍只是 `prefilter_only`，独立 ANN 证据仍未进入主线。
 - readiness 载荷现在也显式区分这层语义：
+  - `queryBackendDefaultMode`
+  - `vectorAdapterLinkedIntoQueryBackend`
   - `vectorAdapterStatus`
   - `vectorAdapterIndependent`
 

scripts/foundation-readiness-utils.js

@@ -38,6 +38,28 @@ function resolveVectorAdapterStatus(vectorAdapterSource, vectorAdapterModulePres
   return 'prefilter_only';
 }
 
+function resolveQueryBackendDefaultMode(queryBackendSource, graphAdapterModulePresent) {
+  if (!graphAdapterModulePresent) {
+    return 'absent';
+  }
+
+  const modeMatch = queryBackendSource.match(/request\.mode\s*\|\|\s*['"]([^'"]+)['"]/);
+  if (modeMatch && (modeMatch[1] === 'local_hybrid' || modeMatch[1] === 'keyword_only')) {
+    return modeMatch[1];
+  }
+
+  return 'unknown';
+}
+
+function resolveVectorAdapterLinkedIntoQueryBackend(queryBackendSource, graphAdapterModulePresent) {
+  if (!graphAdapterModulePresent) {
+    return false;
+  }
+
+  return queryBackendSource.includes('createLocalVectorAccelerationAdapter')
+    && queryBackendSource.includes('vectorAccelerationAdapter.accelerate');
+}
+
 function evaluateFoundationReadiness(options = {}) {
   const repoRoot = options.repoRoot || path.resolve(__dirname, '..');
   const packageJson = readJsonIfExists(path.join(repoRoot, 'package.json'));
@@ -80,6 +102,7 @@ function evaluateFoundationReadiness(options = {}) {
   );
 
   const storeSource = readTextIfExists(storePath);
+  const queryBackendSource = readTextIfExists(graphAdapterPath);
   const vectorAdapterSource = readTextIfExists(vectorAdapterPath);
   const enDashboard = readTextIfExists(enDashboardPath);
   const zhDashboard = readTextIfExists(zhDashboardPath);
@@ -89,9 +112,14 @@ function evaluateFoundationReadiness(options = {}) {
     storeSource.includes('createFileBackedKnowledgeGraphStore')
     && storeSource.includes("storeType: 'file'");
   const graphAdapterModulePresent = fileExists(graphAdapterPath);
+  const queryBackendDefaultMode = resolveQueryBackendDefaultMode(queryBackendSource, graphAdapterModulePresent);
   const vectorAdapterModulePresent = fileExists(vectorAdapterPath);
   const vectorAdapterStatus = resolveVectorAdapterStatus(vectorAdapterSource, vectorAdapterModulePresent);
   const vectorAdapterIndependent = vectorAdapterStatus === 'independent';
+  const vectorAdapterLinkedIntoQueryBackend = resolveVectorAdapterLinkedIntoQueryBackend(
+    queryBackendSource,
+    graphAdapterModulePresent
+  );
   const checklistPagesPresent = fileExists(enChecklistPath) && fileExists(zhChecklistPath);
   const dashboardReferencesPresent =
     enDashboard.includes('foundation-reentry-readiness-checklist')
@@ -193,9 +221,11 @@ function evaluateFoundationReadiness(options = {}) {
       loaded: storeModulePresent && storeSource.includes('loadSnapshot'),
       fileBackedStore,
       graphAdapterModulePresent,
+      queryBackendDefaultMode,
       vectorAdapterModulePresent,
       vectorAdapterStatus,
       vectorAdapterIndependent,
+      vectorAdapterLinkedIntoQueryBackend,
     },
     documents: {
       checklistPagesPresent,
@@ -224,9 +254,11 @@ function formatFoundationReadinessMarkdown(result, reportPaths) {
     `- Store load capability present: ${result.baseline.loaded ? 'yes' : 'no'}`,
     `- File-backed store evidence: ${result.baseline.fileBackedStore ? 'yes' : 'no'}`,
     `- Dedicated graph adapter module present: ${result.baseline.graphAdapterModulePresent ? 'yes' : 'no'}`,
+    `- Query backend default mode: ${result.baseline.queryBackendDefaultMode}`,
     `- Dedicated vector adapter module present: ${result.baseline.vectorAdapterModulePresent ? 'yes' : 'no'}`,
     `- Vector adapter status: ${result.baseline.vectorAdapterStatus}`,
     `- Vector adapter independent: ${result.baseline.vectorAdapterIndependent ? 'yes' : 'no'}`,
+    `- Vector adapter linked into query backend: ${result.baseline.vectorAdapterLinkedIntoQueryBackend ? 'yes' : 'no'}`,
     '',
     '## Documentation',
     '',

scripts/verify-foundation-readiness.js

@@ -20,13 +20,17 @@ function printHumanReport(result, reportPaths) {
   console.log(
     `[Foundation Readiness] Dedicated graph adapter present: ${result.baseline.graphAdapterModulePresent ? 'yes' : 'no'}`
   );
+  console.log(`[Foundation Readiness] Query backend default mode: ${result.baseline.queryBackendDefaultMode}`);
   console.log(
     `[Foundation Readiness] Dedicated vector adapter present: ${result.baseline.vectorAdapterModulePresent ? 'yes' : 'no'}`
   );
   console.log(`[Foundation Readiness] Vector adapter status: ${result.baseline.vectorAdapterStatus}`);
   console.log(
     `[Foundation Readiness] Vector adapter independent: ${result.baseline.vectorAdapterIndependent ? 'yes' : 'no'}`
   );
+  console.log(
+    `[Foundation Readiness] Vector adapter linked into query backend: ${result.baseline.vectorAdapterLinkedIntoQueryBackend ? 'yes' : 'no'}`
+  );
   console.log(
     `[Foundation Readiness] Checklist pages present: ${result.documents.checklistPagesPresent ? 'yes' : 'no'}`
   );

src/agent_workspace.runtime.behavior.test.ts

@@ -1665,9 +1665,11 @@ describe('agent workspace runtime behavior', () => {
                         loaded: true,
                         fileBackedStore: true,
                         graphAdapterModulePresent: true,
+                        queryBackendDefaultMode: 'local_hybrid',
                         vectorAdapterModulePresent: true,
                         vectorAdapterStatus: 'prefilter_only',
                         vectorAdapterIndependent: false,
+                        vectorAdapterLinkedIntoQueryBackend: true,
                     },
                     documents: {
                         checklistPagesPresent: true,
@@ -1707,15 +1709,18 @@ describe('agent workspace runtime behavior', () => {
         const messages = document.getElementById('agent-workspace-messages') as HTMLElement;
         expect(messages.textContent || '').toContain('Foundation readiness');
         expect(messages.textContent || '').toContain('prefilter_only');
+        expect(messages.textContent || '').toContain('local_hybrid');
 
         const snapshot = runtime.getDiagnosticsSnapshot();
         expect(snapshot.lastFoundationReadiness).toEqual(
             expect.objectContaining({
                 status: 'in_progress',
                 decision: 'no-go',
                 storeType: 'file',
+                queryBackendDefaultMode: 'local_hybrid',
                 vectorAdapterStatus: 'prefilter_only',
                 vectorAdapterIndependent: false,
+                vectorAdapterLinkedIntoQueryBackend: true,
                 recommendationsCount: 1,
             })
         );

src/foundation.readiness.contract.test.ts

@@ -15,9 +15,11 @@ type FoundationReadinessResult = {
     loaded: boolean;
     fileBackedStore: boolean;
     graphAdapterModulePresent: boolean;
+    queryBackendDefaultMode: 'absent' | 'unknown' | 'local_hybrid' | 'keyword_only';
     vectorAdapterModulePresent: boolean;
     vectorAdapterStatus: 'absent' | 'prefilter_only' | 'independent';
     vectorAdapterIndependent: boolean;
+    vectorAdapterLinkedIntoQueryBackend: boolean;
   };
   documents: {
     checklistPagesPresent: boolean;
@@ -108,9 +110,11 @@ describe('foundation readiness contract', () => {
     expect(result.baseline.loaded).toBe(true);
     expect(result.baseline.fileBackedStore).toBe(true);
     expect(result.baseline.graphAdapterModulePresent).toBe(true);
+    expect(result.baseline.queryBackendDefaultMode).toBe('local_hybrid');
     expect(result.baseline.vectorAdapterModulePresent).toBe(true);
     expect(result.baseline.vectorAdapterStatus).toBe('prefilter_only');
     expect(result.baseline.vectorAdapterIndependent).toBe(false);
+    expect(result.baseline.vectorAdapterLinkedIntoQueryBackend).toBe(true);
     expect(result.documents.checklistPagesPresent).toBe(true);
     expect(result.documents.dashboardReferencesPresent).toBe(true);
     expect(result.packageScripts.readinessVerifierPresent).toBe(true);
@@ -166,9 +170,11 @@ describe('foundation readiness contract', () => {
     expect(result.baseline.loaded).toBe(false);
     expect(result.baseline.fileBackedStore).toBe(true);
     expect(result.baseline.graphAdapterModulePresent).toBe(true);
+    expect(result.baseline.queryBackendDefaultMode).toBe('unknown');
     expect(result.baseline.vectorAdapterModulePresent).toBe(true);
     expect(result.baseline.vectorAdapterStatus).toBe('independent');
     expect(result.baseline.vectorAdapterIndependent).toBe(true);
+    expect(result.baseline.vectorAdapterLinkedIntoQueryBackend).toBe(false);
     expect(result.documents.checklistPagesPresent).toBe(true);
     expect(result.documents.dashboardReferencesPresent).toBe(true);
   });

src/frontend/agent_workspace_runtime.js

@@ -1433,8 +1433,10 @@
                     status: 'pending',
                     decision: '',
                     storeType: '',
+                    queryBackendDefaultMode: '',
                     vectorAdapterStatus: '',
                     vectorAdapterIndependent: false,
+                    vectorAdapterLinkedIntoQueryBackend: false,
                     recommendationsCount: 0,
                 };
                 setBusy(true);
@@ -1460,21 +1462,27 @@
                         status: trimString(readiness && readiness.status),
                         decision: trimString(readiness && readiness.decision),
                         storeType: trimString(baseline.storeType),
+                        queryBackendDefaultMode: trimString(baseline.queryBackendDefaultMode),
                         vectorAdapterStatus: trimString(baseline.vectorAdapterStatus),
                         vectorAdapterIndependent: Boolean(baseline.vectorAdapterIndependent),
+                        vectorAdapterLinkedIntoQueryBackend: Boolean(baseline.vectorAdapterLinkedIntoQueryBackend),
                         recommendationsCount,
                     };
                     appendMessage(
                         'assistant',
                         getI18nText(
                             'agentWorkspace.messages.foundationReadinessLoaded',
-                            `Foundation readiness ${trimString(readiness && readiness.status) || 'unknown'} / ${trimString(readiness && readiness.decision) || 'unknown'} (store ${trimString(baseline.storeType) || 'n/a'}, vector ${trimString(baseline.vectorAdapterStatus) || 'n/a'}, independent ${Boolean(baseline.vectorAdapterIndependent) ? 'yes' : 'no'}).`,
+                            `Foundation readiness ${trimString(readiness && readiness.status) || 'unknown'} / ${trimString(readiness && readiness.decision) || 'unknown'} (store ${trimString(baseline.storeType) || 'n/a'}, backend ${trimString(baseline.queryBackendDefaultMode) || 'n/a'}, vector ${trimString(baseline.vectorAdapterStatus) || 'n/a'}, independent ${Boolean(baseline.vectorAdapterIndependent) ? 'yes' : 'no'}, linked ${Boolean(baseline.vectorAdapterLinkedIntoQueryBackend) ? 'yes' : 'no'}).`,
                             {
                                 status: trimString(readiness && readiness.status) || 'unknown',
                                 decision: trimString(readiness && readiness.decision) || 'unknown',
                                 storeType: trimString(baseline.storeType) || 'n/a',
+                                queryBackendDefaultMode: trimString(baseline.queryBackendDefaultMode) || 'n/a',
                                 vectorAdapterStatus: trimString(baseline.vectorAdapterStatus) || 'n/a',
                                 vectorAdapterIndependent: Boolean(baseline.vectorAdapterIndependent) ? 'yes' : 'no',
+                                vectorAdapterLinkedIntoQueryBackend: Boolean(baseline.vectorAdapterLinkedIntoQueryBackend)
+                                    ? 'yes'
+                                    : 'no',
                             }
                         )
                     );
@@ -1486,8 +1494,10 @@
                         status: 'failed',
                         decision: '',
                         storeType: '',
+                        queryBackendDefaultMode: '',
                         vectorAdapterStatus: '',
                         vectorAdapterIndependent: false,
+                        vectorAdapterLinkedIntoQueryBackend: false,
                         recommendationsCount: 0,
                     };
                     recordFailure('loadFoundationReadiness', errorMessage);