noteconnection 1.7.0 → 1.9.0

package/dist/src/routes/knowledge.js

@@ -0,0 +1,981 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerKnowledgeRoutes = registerKnowledgeRoutes;
+const CrashLogger_1 = require("../backend/utils/CrashLogger");
+const requestNormalization_1 = require("../learning/requestNormalization");
+const knowledgePayload_1 = require("./knowledgePayload");
+function registerKnowledgeRoutes(ctx) {
+    const { knowledgeLearningPlatform, knowledgeIngestor, knowledgeQuerier, LOOPBACK_HOST, finalPort, KNOWLEDGE_GRAPH_STORE_BACKEND, KNOWLEDGE_GRAPHDB_ADAPTER_PROVIDER, KNOWLEDGE_GRAPHDB_ADAPTER_ID, KNOWLEDGE_GRAPHDB_FALLBACK_ENABLED, KNOWLEDGE_GRAPHDB_OPERATION_MODE, runtimeRunbookOps, scheduleKnowledgeLearningPlatformWarmup, } = ctx;
+    const api = (path) => `/api/knowledge${path}`;
+    const json = (res, code, data) => {
+        res.writeHead(code, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(data));
+    };
+    const ok = (res, data) => json(res, 200, { success: true, ...data });
+    const fail = (res, error, label) => {
+        console.error(error);
+        CrashLogger_1.CrashLogger.log(error, label);
+        if (error instanceof InvalidJsonPayloadError) {
+            res.setHeader?.('X-Error-Code', error.code);
+            json(res, 400, { error: error.message, errorCode: error.code, success: false });
+            return;
+        }
+        if (error instanceof knowledgePayload_1.KnowledgePayloadError) {
+            json(res, error.statusCode, { success: false, error: error.message, code: error.code });
+            return;
+        }
+        json(res, 500, { success: false, error: String(error) });
+    };
+    class InvalidJsonPayloadError extends Error {
+        constructor() {
+            super('Invalid JSON body.');
+            this.code = 'invalid_json';
+            this.name = 'InvalidJsonPayloadError';
+        }
+    }
+    const parseJsonBody = (body) => {
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            throw new InvalidJsonPayloadError();
+        }
+    };
+    const readBody = (req) => new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalBytes = 0;
+        req.on('data', (c) => {
+            totalBytes += c.length;
+            if (totalBytes > 128 * 1024 * 1024) {
+                reject(new knowledgePayload_1.KnowledgePayloadError('Request body exceeds 128 MiB.'));
+                req.destroy?.();
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+    const parseQuery = (req) => new URL(req.url || '/', `http://${LOOPBACK_HOST}:${finalPort}`).searchParams;
+    return [
+        // --- GET routes (self-contained, no external normalize functions) ---
+        {
+            method: 'GET',
+            path: api('/state'),
+            handler: async (_req, res) => {
+                try {
+                    scheduleKnowledgeLearningPlatformWarmup?.('knowledge_state_request');
+                    const payload = await knowledgeLearningPlatform.getKnowledgeState();
+                    ok(res, payload);
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/state');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/store-diagnostics'),
+            handler: async (_req, res) => {
+                try {
+                    const store = await knowledgeLearningPlatform.getStoreDiagnostics();
+                    ok(res, {
+                        configuredBackend: KNOWLEDGE_GRAPH_STORE_BACKEND,
+                        configuredGraphDbAdapterProvider: KNOWLEDGE_GRAPHDB_ADAPTER_PROVIDER,
+                        configuredGraphDbAdapterId: KNOWLEDGE_GRAPHDB_ADAPTER_ID,
+                        graphDbFallbackEnabled: KNOWLEDGE_GRAPHDB_FALLBACK_ENABLED,
+                        configuredGraphDbOperationMode: KNOWLEDGE_GRAPHDB_OPERATION_MODE,
+                        store,
+                    });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/store-diagnostics');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/tutor/catalog'),
+            handler: async (_req, res) => {
+                try {
+                    const catalog = await knowledgeLearningPlatform.getTutorAdapterCatalog();
+                    ok(res, { catalog });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/tutor/catalog');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/tutor/telemetry'),
+            handler: async (_req, res) => {
+                try {
+                    const result = await knowledgeLearningPlatform.getTutorAdapterTelemetry();
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/tutor/telemetry');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/tutor/trace-diagnostics'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const fallbackUsedToken = String(params.get('fallbackUsed') || '').trim().toLowerCase();
+                    const result = await knowledgeLearningPlatform.queryTutorTraceDiagnostics({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        source: String(params.get('source') || '').trim() || undefined,
+                        actionKind: String(params.get('actionKind') || '').trim() || undefined,
+                        providerName: String(params.get('providerName') || '').trim() || undefined,
+                        providerMode: String(params.get('providerMode') || '').trim() || undefined,
+                        fallbackUsed: fallbackUsedToken === 'true'
+                            ? true
+                            : fallbackUsedToken === 'false'
+                                ? false
+                                : undefined,
+                        limit: Number(params.get('limit')) || 20,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/tutor/trace-diagnostics');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/query-backend-diagnostics'),
+            handler: async (_req, res) => {
+                try {
+                    const diag = await knowledgeLearningPlatform.getQueryBackendDiagnostics();
+                    ok(res, { queryBackendDiagnostics: diag });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/query-backend-diagnostics');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/query/compare-backends/history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryKnowledgeQueryBackendComparisonHistory({
+                        limit: Number(params.get('limit')) || 8,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/query/compare-backends/history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/query/compare-backends/trend'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryKnowledgeQueryBackendComparisonTrend({
+                        limit: Number(params.get('limit')) || 12,
+                        windowSize: Number(params.get('windowSize')) || 2,
+                        minSamples: Number(params.get('minSamples')) || 1,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/query/compare-backends/trend');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/query-backend-config'),
+            handler: async (_req, res) => {
+                try {
+                    const config = knowledgeLearningPlatform.getQueryBackendConfig();
+                    ok(res, { queryBackendConfig: config });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/query-backend-config');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/quality/trend'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryLearningQualityTrend({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        limit: Number(params.get('limit')) || 10,
+                        windowSize: Number(params.get('windowSize')) || undefined,
+                        minSamples: Number(params.get('minSamples')) || undefined,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/quality/trend');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/quality/history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryLearningQualityHistory({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        limit: Number(params.get('limit')) || 20,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/quality/history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/quality/baseline'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const userId = String(params.get('userId') || '').trim();
+                    const result = await knowledgeLearningPlatform.getLearningQualityBaseline({ userId });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/quality/baseline');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/session/history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryStudySessionHistory({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        limit: Number(params.get('limit')) || 20,
+                        sinceMinutes: Number(params.get('sinceMinutes')) || undefined,
+                        refreshSource: String(params.get('refreshSource') || '').trim() || undefined,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/session/history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/workflow-artifacts'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const artifactKinds = String(params.get('artifactKinds') || '').trim()
+                        ? String(params.get('artifactKinds') || '')
+                            .split(',')
+                            .map((value) => String(value || '').trim())
+                            .filter(Boolean)
+                        : undefined;
+                    const result = await knowledgeLearningPlatform.queryWorkflowArtifacts?.({
+                        workspaceId: String(params.get('workspaceId') || '').trim() || undefined,
+                        sessionId: String(params.get('sessionId') || '').trim() || undefined,
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        artifactId: String(params.get('artifactId') || '').trim() || undefined,
+                        runId: String(params.get('runId') || '').trim() || undefined,
+                        artifactKinds,
+                        limit: Number(params.get('limit')) || 12,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/workflow-artifacts');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/session/plan/quality/trend'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryStudySessionPlanQualityTrend({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        limit: Number(params.get('limit')) || 10,
+                        windowSize: Number(params.get('windowSize')) || undefined,
+                        minSamples: Number(params.get('minSamples')) || undefined,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/session/plan/quality/trend');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/session/plan/quality/history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const result = await knowledgeLearningPlatform.queryStudySessionPlanQualityHistory({
+                        userId: String(params.get('userId') || '').trim() || undefined,
+                        limit: Number(params.get('limit')) || 20,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/session/plan/quality/history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/memory-policy/diagnostics'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const persistRecordToken = String(params.get('persistRecord') || '').trim().toLowerCase();
+                    const result = await knowledgeLearningPlatform.queryMemoryPolicyDiagnostics({
+                        limit: Number(params.get('limit')) || undefined,
+                        sampleLimit: Number(params.get('sampleLimit')) || undefined,
+                        staleAfterHours: Number(params.get('staleAfterHours')) || undefined,
+                        nearExpiryHours: Number(params.get('nearExpiryHours')) || undefined,
+                        lowConfidenceThreshold: Number(params.get('lowConfidenceThreshold')) || undefined,
+                        now: String(params.get('now') || '').trim() || undefined,
+                        persistRecord: persistRecordToken === 'false'
+                            ? false
+                            : persistRecordToken === 'true'
+                                ? true
+                                : undefined,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/memory-policy/diagnostics');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-matrix'),
+            handler: async (_req, res) => {
+                try {
+                    const matrix = await knowledgeLearningPlatform.getRuntimeCapabilityMatrix();
+                    ok(res, { matrix });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-matrix');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const runbook = runtimeRunbookOps?.getRunbook
+                        ? await runtimeRunbookOps.getRunbook({
+                            checkId: String(params.get('checkId') || '').trim(),
+                        })
+                        : await knowledgeLearningPlatform.getRuntimeCapabilityRunbook();
+                    ok(res, { runbook });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/verify'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const request = {
+                        checkId: String(params.get('checkId') || '').trim(),
+                        focus: String(params.get('focus') || '').trim(),
+                        focusLimit: Number(params.get('focusLimit')) || 12,
+                        sinceMinutes: Number(params.get('sinceMinutes')) || 1440,
+                        status: String(params.get('status') || '').trim(),
+                        checkQuery: String(params.get('checkQuery') || '').trim(),
+                        limit: Number(params.get('limit')) || 20,
+                    };
+                    const result = runtimeRunbookOps?.verify
+                        ? await runtimeRunbookOps.verify(request)
+                        : await knowledgeLearningPlatform.verifyRuntimeCapabilityRunbook(request);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/verify');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const request = {
+                        limit: Number(params.get('limit')) || 20,
+                        checkId: String(params.get('checkId') || '').trim(),
+                        sinceMinutes: Number(params.get('sinceMinutes')) || 10080,
+                        status: String(params.get('status') || '').trim(),
+                    };
+                    const result = runtimeRunbookOps?.getHistory
+                        ? await runtimeRunbookOps.getHistory(request)
+                        : await knowledgeLearningPlatform.getRuntimeCapabilityRunbookHistory(request);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/history/checks'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const request = {
+                        limit: Number(params.get('limit')) || 8,
+                        sinceMinutes: Number(params.get('sinceMinutes')) || 10080,
+                        status: String(params.get('status') || '').trim(),
+                        checkQuery: String(params.get('checkQuery') || '').trim(),
+                    };
+                    const result = runtimeRunbookOps?.getChecks
+                        ? await runtimeRunbookOps.getChecks(request)
+                        : await knowledgeLearningPlatform.queryRuntimeCapabilityRunbookChecks(request);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/history/checks');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/history/action-queue'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const request = {
+                        limit: Number(params.get('limit')) || 8,
+                        sinceMinutes: Number(params.get('sinceMinutes')) || 10080,
+                        status: String(params.get('status') || '').trim(),
+                        checkQuery: String(params.get('checkQuery') || '').trim(),
+                        queueLimit: Number(params.get('queueLimit')) || 12,
+                        priority: String(params.get('priority') || '').trim(),
+                        category: String(params.get('category') || '').trim(),
+                        checkId: String(params.get('checkId') || '').trim(),
+                        remediationStatus: String(params.get('remediationStatus') || '').trim(),
+                        remediationTrend: String(params.get('remediationTrend') || '').trim(),
+                    };
+                    const result = runtimeRunbookOps?.getActionQueue
+                        ? await runtimeRunbookOps.getActionQueue(request)
+                        : await knowledgeLearningPlatform.queryRuntimeCapabilityRunbookActionQueue(request);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/history/action-queue');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/remediation-history'),
+            handler: async (req, res) => {
+                try {
+                    const params = parseQuery(req);
+                    const request = {
+                        limit: Number(params.get('limit')) || 20,
+                        sinceMinutes: Number(params.get('sinceMinutes')) || 10080,
+                        status: String(params.get('status') || '').trim(),
+                        source: String(params.get('source') || '').trim(),
+                        checkId: String(params.get('checkId') || '').trim(),
+                    };
+                    const result = runtimeRunbookOps?.getRemediationHistory
+                        ? await runtimeRunbookOps.getRemediationHistory(request)
+                        : await knowledgeLearningPlatform.getRuntimeCapabilityRunbookRemediationHistory(request);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/remediation-history');
+                }
+            },
+        },
+        {
+            method: 'GET',
+            path: api('/runtime-capability-runbook/replay-schedule'),
+            handler: async (_req, res) => {
+                try {
+                    const schedule = runtimeRunbookOps?.getReplaySchedule
+                        ? await runtimeRunbookOps.getReplaySchedule()
+                        : await knowledgeLearningPlatform.getRuntimeCapabilityRunbookReplaySchedule();
+                    ok(res, { schedule });
+                }
+                catch (e) {
+                    fail(res, e, 'GET /api/knowledge/runtime-capability-runbook/replay-schedule');
+                }
+            },
+        },
+        // --- POST routes ---
+        {
+            method: 'POST',
+            path: api('/ingest'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeIngestor.ingestKnowledge((0, knowledgePayload_1.parseKnowledgeIngestBody)(body));
+                    // Preserve the legacy response shape; diagnostics remain available via runtime metrics.
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/ingest');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/query'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    // Keep the migration boundary on the legacy platform facade so
+                    // registry dispatch preserves the established response contract.
+                    const result = await knowledgeLearningPlatform.queryKnowledge((0, requestNormalization_1.normalizeKnowledgeQueryRequestPayload)(parseJsonBody(body)));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/query');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/workspace-readiness'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const payload = JSON.parse(body);
+                    const result = await knowledgeLearningPlatform.inspectKnowledgeWorkspaceRequest({
+                        query: String(payload?.query || '').trim(),
+                        scope: payload?.scope,
+                        queryBackend: payload?.queryBackend,
+                    });
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/workspace-readiness');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/mastery/diagnostics'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.queryMasteryDiagnostics(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/mastery/diagnostics');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/learning-path'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.generateLearningPath(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/learning-path');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/session/build'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.buildStudySession(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/session/build');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/session/execute'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.executeStudySessionPlan(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/session/execute');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/workflow-artifacts/review-follow-up'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.executeWorkflowArtifactReviewFollowUp((0, requestNormalization_1.normalizeWorkflowArtifactReviewFollowUpRequestPayload)(JSON.parse(body)));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/workflow-artifacts/review-follow-up');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/session/graph-focus-diagnostics'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.recordGraphFocusRenderDiagnostics(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/session/graph-focus-diagnostics');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/export/workspace'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.buildWorkspaceExportBundle(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/export/workspace');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/quality/evaluate'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.evaluateLearningQuality(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/quality/evaluate');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/quality/snapshot'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.captureLearningQualitySnapshot(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/quality/snapshot');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/quality/baseline'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.setLearningQualityBaseline(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/quality/baseline');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/quality/baseline/clear'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.clearLearningQualityBaseline(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/quality/baseline/clear');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/quality/baseline/evaluate'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.evaluateLearningQualityAgainstBaseline(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/quality/baseline/evaluate');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/tutor/action'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.executeTutorAction(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/tutor/action');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/memory-policy'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.applyMemoryPolicy(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/memory-policy');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/query/compare-backends'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.compareQueryBackends(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/query/compare-backends');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/store/reload'),
+            handler: async (_req, res) => {
+                try {
+                    await knowledgeLearningPlatform.reloadStore();
+                    ok(res, { reloaded: true });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/store/reload');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/query-backend-config'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    if (ctx.executeQueryBackendConfigUpdate) {
+                        ok(res, await ctx.executeQueryBackendConfigUpdate(JSON.parse(body)));
+                        return;
+                    }
+                    const result = await knowledgeLearningPlatform.updateQueryBackendConfig(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/query-backend-config');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/ingest/guardrail'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.evaluateIngestGuardrail(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/ingest/guardrail');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/runtime-capability-runbook/remediation-event'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const payload = JSON.parse(body);
+                    const result = runtimeRunbookOps?.recordRemediationEvent
+                        ? await runtimeRunbookOps.recordRemediationEvent(payload, String(req.requestId || req.headers['x-request-id'] || ''))
+                        : await knowledgeLearningPlatform.recordRuntimeCapabilityRemediationEvent(payload);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/runtime-capability-runbook/remediation-event');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/runtime-capability-runbook/remediation-event/replay'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const payload = JSON.parse(body);
+                    const result = runtimeRunbookOps?.replayRemediationEvent
+                        ? await runtimeRunbookOps.replayRemediationEvent(payload)
+                        : await knowledgeLearningPlatform.replayRuntimeCapabilityRemediationEvent(payload);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/runtime-capability-runbook/remediation-event/replay');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/runtime-capability-runbook/replay-schedule'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const payload = JSON.parse(body);
+                    const result = runtimeRunbookOps?.updateReplaySchedule
+                        ? await runtimeRunbookOps.updateReplaySchedule(payload)
+                        : await knowledgeLearningPlatform.updateRuntimeCapabilityReplaySchedule(payload);
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/runtime-capability-runbook/replay-schedule');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/runtime-capability-runbook/replay-schedule/tick'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const payload = body.trim() ? JSON.parse(body) : {};
+                    const result = runtimeRunbookOps?.tickReplaySchedule
+                        ? await runtimeRunbookOps.tickReplaySchedule(payload)
+                        : await knowledgeLearningPlatform.tickRuntimeCapabilityReplaySchedule();
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/runtime-capability-runbook/replay-schedule/tick');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/session/orchestration/config'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.updateStudySessionOrchestrationConfig(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/session/orchestration/config');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/conversation-memory/add'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.addConversationMemory(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/conversation-memory/add');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/conversation-memory/search'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.searchConversationMemory(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/conversation-memory/search');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/conversation-memory/delete'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.deleteConversationMemory(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/conversation-memory/delete');
+                }
+            },
+        },
+        {
+            method: 'POST',
+            path: api('/conversation-memory/feedback'),
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const result = await knowledgeLearningPlatform.feedbackConversationMemory(JSON.parse(body));
+                    ok(res, { result });
+                }
+                catch (e) {
+                    fail(res, e, 'POST /api/knowledge/conversation-memory/feedback');
+                }
+            },
+        },
+    ];
+}