@bolloon/bolloon-agent 0.1.34 → 0.1.35

package/dist/web/server.js

@@ -5,6 +5,7 @@ import { fileURLToPath } from 'url';
 import * as fs from 'fs/promises';
 import * as fsSync from 'fs';
 import * as path from 'path';
+import * as os from 'os';
 import { createHyperswarmCommunicator, createTopic, KeyManager, AgentAuthManager, } from '@diap/sdk';
 import { documentReader } from '../documents/reader.js';
 import { initMinimax, getMinimax } from '../constraints/index.js';
@@ -657,7 +658,13 @@ async function handleV3P2PMessage(parsed, conn, comm) {
             let fullResponse = '';
             // v3 新增: 流式 token 节流推给 B — 让 B 看到过程
             let lastFlushAt = 0;
+            let usedJudgmentIds = [];
             const streamCallback = (event) => {
+                // P0.5: 注入门回传
+                if (event?.type === 'used_judgments' && Array.isArray(event.usedIds)) {
+                    usedJudgmentIds = event.usedIds;
+                    return;
+                }
                 if (event.type === 'token') {
                     fullResponse += event.content;
                     if (fullResponse.length - lastFlushAt >= 20) {
@@ -671,7 +678,7 @@ async function handleV3P2PMessage(parsed, conn, comm) {
                 }
             };
             const agent = await getAgentForChannel(channelId, ch.did || '', ch.name, ch.didDocRef);
-            fullResponse = await agent.promptStream(fullPrompt, streamCallback);
+            fullResponse = await agent.promptStream(fullPrompt, streamCallback, undefined, channelId);
             // v3 新增: 存 A 的 assistant 消息到 session — B 拉历史时能看到完整对话
             try {
                 const existing = await loadSession(channelId, 'default');
@@ -682,6 +689,7 @@ async function handleV3P2PMessage(parsed, conn, comm) {
                     id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
                     type: 'ai',
                     content: fullResponse,
+                    ...(usedJudgmentIds.length > 0 ? { metadata: { usedJudgmentIds } } : {}),
                     timestamp: new Date().toISOString()
                 });
                 session.lastUpdated = new Date().toISOString();
@@ -967,6 +975,16 @@ export async function createWebServer(port = 3000, options = {}) {
     process.on('unhandledRejection', (reason, promise) => {
         console.error('[警告] 未处理的 Promise 拒绝:', reason);
     });
+    // Bolloon Bootstrap (幂等, 重复调不会重复挂定时器)
+    // 这里独立调一次以保证 CLI-only 模式 (无 index.ts 引导) 也能 bootstrap
+    try {
+        const { bootstrapBolloon } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+        const bs = await bootstrapBolloon({ cwd: process.cwd() });
+        console.log(`[createWebServer] bootstrap 完成 (${bs.durationMs}ms)`);
+    }
+    catch (err) {
+        console.warn('[createWebServer] bootstrap 失败 (非致命):', err);
+    }
     // 重置旧的 agent session，确保使用新的 LLM 配置
     const { resetAgentSession } = await import('../agents/pi-sdk.js');
     resetAgentSession();
@@ -1410,10 +1428,40 @@ export async function createWebServer(port = 3000, options = {}) {
         const autoToolsEnabled = channel?.autoInvokeTools !== false; // 默认开启
         // 捕获外层 channel 到独立变量, 避免被 try 块内 (line 740+) 的 const channel 遮蔽
         const channelForJudgment = channel;
+        // per-channel queue 检查: 已在跑就入队, 等当前跑完自动接上
+        const runState = getOrCreateRunState(channelId);
+        if (runState.running) {
+            runState.queue.push({ channelId, text, boundWalletAddress, autoToolsEnabled });
+            broadcastQueueUpdate(channelId);
+            console.log(`[queue] /message 入队 channel=${channelId}, queue len=${runState.queue.length}`);
+            return;
+        }
+        runState.running = true;
+        runState.abortController = new AbortController();
+        broadcastQueueUpdate(channelId);
         try {
             const agent = await getAgentForChannel(channelId, realChannelDid, realChannelName, realChannelDidDoc);
             let fullResponse = '';
+            // P0.5: 注入门回传的 usedIds, 落 session message metadata, UI 可查
+            let usedJudgmentIds = [];
             const streamCallback = (event) => {
+                // P0.5: 捕获注入门回传
+                if (event.type === 'used_judgments' && Array.isArray(event.usedIds)) {
+                    usedJudgmentIds = event.usedIds;
+                    // 同步推给前端 (用于 finalizeTimelineAsMessage 时给 addMessage 传 usedIds)
+                    broadcast({ type: 'used_judgments', usedIds: usedJudgmentIds }, channelId);
+                    return;
+                }
+                // 阶段事件 (注入门 / D 触发)
+                if (event.type === 'phase') {
+                    broadcast({
+                        type: 'phase',
+                        phase: event.phase,
+                        detail: event.detail,
+                        usedCount: event.usedCount,
+                    }, channelId);
+                    return;
+                }
                 // 同时发送给流式显示和工作流显示
                 if (event.type === 'token' || event.type === 'thinking') {
                     broadcast({ type: 'stream', streamType: event.type, content: event.content }, channelId);
@@ -1583,7 +1631,22 @@ export async function createWebServer(port = 3000, options = {}) {
             }
             if (contextHint)
                 contextHint += '\n';
-            fullResponse = await agent.promptStream(contextHint + text, streamCallback);
+            try {
+                fullResponse = await agent.promptStream(contextHint + text, streamCallback, runState.abortController?.signal, channelId);
+            }
+            catch (err) {
+                // abort 抛错: 保留已输出的部分 (fullResponse 可能是空字符串)
+                if (runState.abortController?.signal.aborted || err?.name === 'AbortError') {
+                    console.log(`[chat] aborted channel=${channelId}`);
+                }
+                else {
+                    throw err;
+                }
+            }
+            // abort 模式: 给 partial 拼后缀
+            if (runState.abortController?.signal.aborted && fullResponse.trim().length > 0) {
+                fullResponse = fullResponse + '\n\n_[生成已中断]_';
+            }
             // v3 新增: 解析 LLM 回复里的 @-mentions, 转发到目标 channel
             await routeMentionsInReply(channelId, fullResponse, localChannels, remoteChannels);
             broadcast({ type: 'ai', content: fullResponse }, channelId);
@@ -1592,7 +1655,15 @@ export async function createWebServer(port = 3000, options = {}) {
             session.sessionId = currentSessionId;
             // v3: 加 source 标记 (local = 内部 owner, remote = 远端访客)
             session.messages.push({ id: crypto.randomUUID(), type: 'user', content: text, timestamp: new Date().toISOString(), source: 'local' });
-            session.messages.push({ id: crypto.randomUUID(), type: 'ai', content: fullResponse, timestamp: new Date().toISOString(), source: 'local' });
+            session.messages.push({
+                id: crypto.randomUUID(),
+                type: 'ai',
+                content: fullResponse,
+                timestamp: new Date().toISOString(),
+                source: 'local',
+                // P0.5: 这条 AI 回复引用了哪些 judgment (注入门回传)
+                ...(usedJudgmentIds.length > 0 ? { metadata: { usedJudgmentIds } } : {}),
+            });
             session.lastUpdated = new Date().toISOString();
             await saveSession(session);
             const channels = await loadChannels();
@@ -1605,6 +1676,46 @@ export async function createWebServer(port = 3000, options = {}) {
                 await saveChannels(channels);
             }
             broadcast({ type: 'done' }, channelId);
+            // D 触发: AI 被动捕获判断力 (后台异步, 不阻塞主对话)
+            setImmediate(() => {
+                try {
+                    const lastTurns = session.messages.slice(-6).map((m) => ({
+                        role: (m.type === 'user' ? 'human' : 'agent'),
+                        content: m.content,
+                    }));
+                    if (lastTurns.length < 2)
+                        return;
+                    broadcast({ type: 'phase', phase: 'd_detect', detail: '监测对话...' }, channelId);
+                    import('../pi-ecosystem-judgment/human-value-pipeline.js')
+                        .then(async ({ detectAndDistillFromChannel, throttleDHook }) => {
+                        // channel 维度 5min 节流, 防对话卡顿时 LLM 反复触发
+                        if (!throttleDHook(channelId, 5 * 60_000)) {
+                            console.log(`[D-hook ${channelId}] throttled (within 5min)`);
+                            broadcast({ type: 'phase', phase: 'd_skip', detail: 'throttled' }, channelId);
+                            return null;
+                        }
+                        broadcast({ type: 'phase', phase: 'd_distill', detail: '蒸馏判断力...' }, channelId);
+                        return detectAndDistillFromChannel(lastTurns, { channelId });
+                    })
+                        .then((result) => {
+                        if (result && result.triggered) {
+                            console.log(`[D-hook ${channelId}] stored: ${result.reason}`, result.evolved);
+                            broadcast({ type: 'phase', phase: 'd_done', detail: result.reason }, channelId);
+                        }
+                        else if (result && result.reason) {
+                            console.log(`[D-hook ${channelId}] skipped: ${result.reason}`);
+                            broadcast({ type: 'phase', phase: 'd_skip', detail: result.reason }, channelId);
+                        }
+                    })
+                        .catch((err) => {
+                        console.warn(`[D-hook ${channelId}] failed:`, err);
+                        broadcast({ type: 'phase', phase: 'd_error', detail: String(err) }, channelId);
+                    });
+                }
+                catch (err) {
+                    console.warn(`[D-hook ${channelId}] sync error:`, err);
+                }
+            });
             // 2026-06-11: 202 已发的话, 不要重复 res.json (会抛 ERR_HTTP_HEADERS_SENT)
             if (!res.headersSent)
                 res.json({ ok: true });
@@ -1615,6 +1726,15 @@ export async function createWebServer(port = 3000, options = {}) {
             if (!res.headersSent)
                 res.status(500).json({ error: err.message });
         }
+        finally {
+            // queue dequeue: 跑完或失败都要清状态
+            // 当前实现: 自动接下一条需要把 ~200 行 try 块抽函数, 暂不抽.
+            // 替代: 用户点 [队列 +N] 按钮时, 客户端发起一个特殊的 HTTP 请求触发下一条
+            // (在 client.js 实现). 这里只清状态 + 广播.
+            runState.running = false;
+            runState.abortController = null;
+            broadcastQueueUpdate(channelId);
+        }
     });
     // ---------- 频道元数据后台修复队列 ----------
     // 关键点: 旧实现会在每次 GET /channels 时同步执行 KeyManager.generate() + IPFS POST,
@@ -1623,6 +1743,24 @@ export async function createWebServer(port = 3000, options = {}) {
     const didFixQueue = new Set(); // 待修复的 channelId
     let didFixRunning = false;
     let didFixTimer = null;
+    const channelRunState = new Map();
+    function getOrCreateRunState(channelId) {
+        let s = channelRunState.get(channelId);
+        if (!s) {
+            s = { running: false, queue: [], abortController: null };
+            channelRunState.set(channelId, s);
+        }
+        return s;
+    }
+    function broadcastQueueUpdate(channelId) {
+        const s = channelRunState.get(channelId);
+        const queueLength = s ? s.queue.length : 0;
+        const running = s ? s.running : false;
+        try {
+            broadcast({ type: 'queue_update', channelId, queueLength, running }, channelId);
+        }
+        catch { /* */ }
+    }
     function scheduleDidFix(channelId) {
         didFixQueue.add(channelId);
         if (didFixTimer)
@@ -2312,7 +2450,13 @@ export async function createWebServer(port = 3000, options = {}) {
             broadcast({ type: 'regenerating', channelId }, channelId);
             const agent = await getAgentForChannel(channelId, realChannelDid, realChannelName, realChannelDidDoc);
             let fullResponse = '';
+            let usedJudgmentIds = [];
             const streamCallback = (event) => {
+                // P0.5: 注入门回传
+                if (event.type === 'used_judgments' && Array.isArray(event.usedIds)) {
+                    usedJudgmentIds = event.usedIds;
+                    return;
+                }
                 if (event.type === 'token' || event.type === 'thinking') {
                     broadcast({ type: 'stream', streamType: event.type, content: event.content }, channelId);
                 }
@@ -2325,7 +2469,7 @@ export async function createWebServer(port = 3000, options = {}) {
             };
             // 重新生成时只发送用户消息 (v3: 同时注入 channel 绑定的判断力)
             const regenHint = await buildJudgmentHint(channel, channelId);
-            fullResponse = await agent.promptStream(regenHint + userMessage, streamCallback);
+            fullResponse = await agent.promptStream(regenHint + userMessage, streamCallback, undefined, channelId);
             broadcast({ type: 'ai', content: fullResponse }, channelId);
             // 更新 session
             const existingSession = await loadSession(channelId, currentSessionId);
@@ -2339,7 +2483,8 @@ export async function createWebServer(port = 3000, options = {}) {
                     id: crypto.randomUUID(),
                     type: 'ai',
                     content: fullResponse,
-                    timestamp: new Date().toISOString()
+                    timestamp: new Date().toISOString(),
+                    ...(usedJudgmentIds.length > 0 ? { metadata: { usedJudgmentIds } } : {}),
                 });
                 existingSession.lastUpdated = new Date().toISOString();
                 await saveSession(existingSession);
@@ -3664,6 +3809,24 @@ export async function createWebServer(port = 3000, options = {}) {
             res.status(500).json({ error: err.message });
         }
     });
+    // 终止当前 channel 的 LLM 流 (UI 终止按钮)
+    app.post('/api/chat/abort', async (req, res) => {
+        try {
+            const { channelId } = req.body;
+            if (!channelId)
+                return res.status(400).json({ error: 'channelId required' });
+            const s = channelRunState.get(channelId);
+            if (s?.abortController) {
+                s.abortController.abort();
+                console.log(`[abort] user aborted channel=${channelId}`);
+                return res.json({ ok: true, aborted: true });
+            }
+            res.json({ ok: true, aborted: false });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // 主人审阅: 批准 draft
     app.post('/api/chat/approve', async (req, res) => {
         try {
@@ -4046,20 +4209,378 @@ export async function createWebServer(port = 3000, options = {}) {
             res.status(500).json({ error: err.message });
         }
     });
-    app.get('/api/judgments', async (_req, res) => {
+    app.get('/api/judgments', async (req, res) => {
         try {
-            const { loadAllJudgments, initializeValueStore } = await import('../pi-ecosystem-judgment/human-value-store.js');
+            const { listJudgmentsByStatus, initializeValueStore } = await import('../pi-ecosystem-judgment/human-value-store.js');
             await initializeValueStore();
-            const all = await loadAllJudgments();
-            // 新的在前
+            const status = (typeof req.query.status === 'string' ? req.query.status : 'all');
+            const all = await listJudgmentsByStatus(status);
             all.sort((a, b) => (b.timestamp || '').localeCompare(a.timestamp || ''));
-            res.json({ count: all.length, judgments: all });
+            res.json({ count: all.length, status, judgments: all });
         }
         catch (err) {
             console.error('[judgments] GET failed:', err);
             res.status(500).json({ error: err.message });
         }
     });
+    // 蒸馏 B 触发 (人类点按钮) — 同步执行演化对齐
+    app.post('/api/judgments/distill-from-conversation', async (req, res) => {
+        try {
+            const { channelId, messageId, recentTurns } = req.body;
+            if (!channelId) {
+                return res.status(400).json({ error: 'channelId required' });
+            }
+            // 取 channel 最近的对话
+            const channels = await loadChannels();
+            const channel = channels.find((c) => c.id === channelId);
+            if (!channel)
+                return res.status(404).json({ error: 'channel not found' });
+            const currentSessionId = channel.currentSessionId;
+            if (!currentSessionId) {
+                return res.status(400).json({ error: 'no active session in channel' });
+            }
+            const session = await loadSession(channelId, currentSessionId);
+            if (!session)
+                return res.status(404).json({ error: 'session not found' });
+            // 取最近 N 轮 (默认 10), 转成 DistillTurn 格式
+            const limit = Math.min(Math.max(recentTurns ?? 10, 2), 30);
+            const turns = session.messages.slice(-limit).map((m) => ({
+                role: (m.type === 'user' ? 'human' : 'agent'),
+                content: m.content,
+            }));
+            const { distillAndStoreFromChannel } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const result = await distillAndStoreFromChannel(turns, { channelId });
+            res.json({
+                ok: true,
+                triggered: result.triggered,
+                reason: result.reason,
+                judgment: result.judgment,
+                evolved: result.evolved,
+            });
+        }
+        catch (err) {
+            console.error('[judgments] distill-from-conversation failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 蒸馏 D 触发 (AI 被动) — 后台异步,不阻塞 HTTP 响应
+    app.post('/api/judgments/detect-and-distill', async (req, res) => {
+        try {
+            const { channelId, turns } = req.body;
+            // 先立即返回 202, 不等 LLM
+            res.status(202).json({ ok: true, queued: true });
+            if (!channelId || !Array.isArray(turns) || turns.length === 0) {
+                return;
+            }
+            // 异步处理 (不 await, 不阻塞响应)
+            setImmediate(async () => {
+                try {
+                    const { detectAndDistillFromChannel } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+                    const result = await detectAndDistillFromChannel(turns, { channelId });
+                    if (result.triggered) {
+                        console.log(`[D-hook] ${channelId}: ${result.reason}`, result.evolved);
+                    }
+                }
+                catch (err) {
+                    console.warn('[D-hook] background failed:', err);
+                }
+            });
+        }
+        catch (err) {
+            console.error('[judgments] detect-and-distill failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 判断力使用回溯 (P0.5): 给定 judgmentIds, 反查对应的 decision 文本
+    // 用途: UI 上"这条 AI 回复引用了哪些原则"
+    app.post('/api/judgments/resolve-usage', async (req, res) => {
+        try {
+            const { ids } = req.body;
+            if (!Array.isArray(ids) || ids.length === 0) {
+                return res.json({ items: [] });
+            }
+            const { loadAllJudgments } = await import('../pi-ecosystem-judgment/human-value-store.js');
+            const all = await loadAllJudgments();
+            const byId = new Map(all.map((j) => [j.id, j]));
+            const items = ids
+                .map((id) => byId.get(id))
+                .filter((j) => Boolean(j))
+                .map((j) => ({
+                id: j.id,
+                decision: j.decision,
+                status: j.status ?? 'active',
+                timestamp: j.timestamp,
+            }));
+            res.json({ items });
+        }
+        catch (err) {
+            console.error('[judgments] resolve-usage failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 判断力违规日志 (P3 UI): 读 violations.jsonl
+    app.get('/api/judgments/violations', async (req, res) => {
+        try {
+            const { getRecentViolations } = await import('../pi-ecosystem-judgment/monitor-gate.js');
+            const limit = Math.min(Math.max(parseInt(String(req.query.limit ?? '20'), 10) || 20, 1), 200);
+            const items = await getRecentViolations(limit);
+            res.json({ count: items.length, items });
+        }
+        catch (err) {
+            console.error('[judgments] violations failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 类 B 自适应扫描: 读 judgments.json + usage.jsonl, 给出 stale/rising/unused 建议
+    // ?force=1 跳过 24h 缓存
+    app.get('/api/judgments/adaptive-suggestions', async (req, res) => {
+        try {
+            const { getCachedScan } = await import('../pi-ecosystem-judgment/adaptive-scan.js');
+            const force = String(req.query.force ?? '') === '1';
+            const result = await getCachedScan(force);
+            res.json(result);
+        }
+        catch (err) {
+            console.error('[judgments] adaptive-scan failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // Bootstrap Context 调试视图: 返出完整 BolloonContext
+    app.get('/api/bolloon/context', async (req, res) => {
+        try {
+            const { getCachedBolloonContext } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const force = String(req.query.force ?? '') === '1';
+            const ctx = await getCachedBolloonContext({ cwd: process.cwd() }, force);
+            res.json(ctx);
+        }
+        catch (err) {
+            console.error('[bolloon] context failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 阶段 B: 周报 (weekly-report.ts 产物) — 仅 API 读取, 不做 UI tab
+    // GET /api/reports           → { files: ['2026-W24.md', ...] }
+    // GET /api/reports/2026-W24  → { week, content }
+    app.get('/api/reports', async (_req, res) => {
+        try {
+            const dir = path.join(os.homedir(), '.bolloon', 'reports');
+            try {
+                const entries = await fs.readdir(dir);
+                const files = entries
+                    .filter((f) => f.endsWith('.md'))
+                    .sort()
+                    .reverse(); // 新的在前
+                res.json({ dir, files });
+            }
+            catch {
+                res.json({ dir, files: [] });
+            }
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.get('/api/reports/:week', async (req, res) => {
+        try {
+            const week = req.params.week;
+            // 严格校验, 防路径穿越
+            if (!/^\d{4}-W\d{1,2}$/.test(week)) {
+                return res.status(400).json({ error: 'week must match YYYY-Www' });
+            }
+            const file = path.join(os.homedir(), '.bolloon', 'reports', `${week}.md`);
+            try {
+                const content = await fs.readFile(file, 'utf-8');
+                res.json({ week, content, length: content.length });
+            }
+            catch {
+                res.status(404).json({ error: 'not found', week });
+            }
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 阶段 C 护栏 5: auto-evolve baseline 管理 (无 UI, 仅 API)
+    // GET    /api/auto-evolve/baselines             → 列出所有 baseline tag
+    // GET    /api/auto-evolve/baselines/:tag/diff  → 看某 baseline 的 diff 摘要
+    // POST   /api/auto-evolve/rollback {tag}       → 回滚到指定 baseline
+    app.get('/api/auto-evolve/baselines', async (_req, res) => {
+        try {
+            const { execFile } = await import('child_process');
+            const { promisify } = await import('util');
+            const pExec = promisify(execFile);
+            const { stdout } = await pExec('git', [
+                'tag', '-l', 'auto-evolve-baseline-*', '--format=%(refname:short)|%(contents)|%(objectname:short)|%(taggerdate:iso)',
+            ], { cwd: process.cwd() });
+            const tags = stdout.trim().split('\n').filter(Boolean).map((line) => {
+                const [tag, msg, sha, date] = line.split('|');
+                return { tag, message: msg || '', sha, date };
+            });
+            res.json({ tags, count: tags.length });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.get('/api/auto-evolve/baselines/:tag/diff', async (req, res) => {
+        try {
+            const { execFile } = await import('child_process');
+            const { promisify } = await import('util');
+            const pExec = promisify(execFile);
+            const tag = req.params.tag;
+            if (!/^auto-evolve-baseline-[\w-]+$/.test(tag)) {
+                return res.status(400).json({ error: 'tag must match auto-evolve-baseline-*' });
+            }
+            const { stdout } = await pExec('git', ['show', '--stat', '--no-color', tag], { cwd: process.cwd() });
+            res.json({ tag, diff: stdout.slice(0, 5000) }); // 限长 5KB
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // Bootstrap Context → 拼好的 system prompt 片段 (供调试看注入效果)
+    app.get('/api/bolloon/context/system-prompt', async (req, res) => {
+        try {
+            const { getCachedBolloonContext } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const { formatContextForSystemPrompt } = await import('../bootstrap/project-context.js');
+            const ctx = await getCachedBolloonContext({ cwd: process.cwd() });
+            const systemAddition = formatContextForSystemPrompt(ctx, {
+                maxChars: parseInt(String(req.query.max ?? '4000'), 10) || 4000,
+            });
+            res.json({ systemAddition, length: systemAddition.length, truncated: systemAddition.includes('截断模式') });
+        }
+        catch (err) {
+            console.error('[bolloon] context/system-prompt failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 自适应接受/拒绝: 写 evolution.jsonl 留痕, 接受时同时 patch judgments.json
+    // body: { action: 'accept'|'reject'|'revert', suggestion, appliedPatch? }
+    // query: ?auto=1  → 类 B 自动路径, 受 auto-evolve-policy 网关保护
+    //         缺省    → 用户在 UI 手动触发, 不查开关 (避免阻塞用户)
+    app.post('/api/judgments/adaptive-apply', async (req, res) => {
+        try {
+            const isAuto = req.query.auto === '1' || req.query.auto === 'true';
+            const { action, suggestion, appliedPatch } = req.body;
+            if (!action || !suggestion?.judgmentId) {
+                return res.status(400).json({ error: 'action and suggestion.judgmentId required' });
+            }
+            const { updateJudgmentStatus } = await import('../pi-ecosystem-judgment/human-value-store.js');
+            const { logEvolution } = await import('../pi-ecosystem-judgment/adaptive-scan.js');
+            // accept 时: 真正改库
+            if (action === 'accept') {
+                // 阶段 A: 自动路径需先过 auto-evolve-policy 网关
+                if (isAuto) {
+                    const { requireDataLayerAutoEvolve } = await import('../utils/auto-evolve-policy.js');
+                    try {
+                        await requireDataLayerAutoEvolve('adaptive-apply.auto.deprecate');
+                    }
+                    catch (err) {
+                        return res.status(423).json({
+                            error: 'data-layer-auto-evolve-disabled',
+                            message: err.message,
+                            hint: '设 BOLLOON_AUTO_EVOLVE_DATA=1 或在 self-improve-policy.json 加 dataLayerAutoEvolve: true',
+                        });
+                    }
+                }
+                if (suggestion.action === 'deprecate') {
+                    // 标记 superseded (语义: 不再用, 但保留可回滚)
+                    await updateJudgmentStatus(suggestion.judgmentId, 'superseded', {
+                        evolutionReason: 'merged', // 借 merged 字段表达"被自适应废弃"
+                    });
+                }
+                else if (suggestion.action === 'boost') {
+                    // boost: 用户手动接受后, 不改库本身 (weight 在 getRelevantValues 里动态算),
+                    // 但写 evolution 留痕, 未来可以基于此调整算法
+                    // 当前不直接改库, 仅留痕
+                }
+                // 'review' 类不需要自动改库, 仅 log 接受
+            }
+            await logEvolution({
+                ts: new Date().toISOString(),
+                action,
+                suggestion: suggestion,
+                appliedPatch,
+            });
+            res.json({ ok: true });
+        }
+        catch (err) {
+            console.error('[judgments] adaptive-apply failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 演化日志 (audit / 一键回滚源)
+    app.get('/api/judgments/evolution-log', async (req, res) => {
+        try {
+            const { readEvolutionLog } = await import('../pi-ecosystem-judgment/adaptive-scan.js');
+            const limit = Math.min(Math.max(parseInt(String(req.query.limit ?? '50'), 10) || 50, 1), 200);
+            const items = await readEvolutionLog(limit);
+            res.json({ count: items.length, items });
+        }
+        catch (err) {
+            console.error('[judgments] evolution-log failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 阶段 2: Causal-judge 4 个 endpoint
+    app.get('/api/judgments/causal/correlation', async (req, res) => {
+        try {
+            const { runCorrelationAnalysis } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const topN = Math.min(Math.max(parseInt(String(req.query.topN ?? '5'), 10) || 5, 1), 50);
+            const useLLM = String(req.query.useLLM ?? '1') !== '0';
+            const items = await runCorrelationAnalysis({ topN, useLLM });
+            res.json({ count: items.length, items });
+        }
+        catch (err) {
+            console.error('[causal] correlation failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.get('/api/judgments/causal/intervention', async (req, res) => {
+        try {
+            const { runIntervention } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const { judgmentId, scenario } = req.query;
+            if (!judgmentId)
+                return res.status(400).json({ error: 'judgmentId required' });
+            const result = await runIntervention(judgmentId, { scenarioContext: scenario });
+            res.json(result);
+        }
+        catch (err) {
+            console.error('[causal] intervention failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.post('/api/judgments/causal/counterfactual', async (req, res) => {
+        try {
+            const { runCounterfactualAudit } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const { userInput, aiReply, violatedPrinciples } = req.body;
+            if (!userInput || !aiReply) {
+                return res.status(400).json({ error: 'userInput and aiReply required' });
+            }
+            const audit = await runCounterfactualAudit({
+                userInput,
+                aiReply,
+                violatedPrinciples: violatedPrinciples ?? [],
+            });
+            res.json(audit);
+        }
+        catch (err) {
+            console.error('[causal] counterfactual failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.get('/api/judgments/causal/audit-log', async (req, res) => {
+        try {
+            const { readCounterfactualLog } = await import('../pi-ecosystem-judgment/human-value-pipeline.js');
+            const limit = Math.min(Math.max(parseInt(String(req.query.limit ?? '20'), 10) || 20, 1), 200);
+            const items = await readCounterfactualLog(limit);
+            res.json({ count: items.length, items });
+        }
+        catch (err) {
+            console.error('[causal] audit-log failed:', err);
+            res.status(500).json({ error: err.message });
+        }
+    });
     // 导入判断: 接受 { filename, content (base64), context }.
     // 支持 .json / .yaml / .yml / .md / .txt / .html. 完全离线解析, 不调 LLM.
     // 解析规则: