evolcore 0.0.33 → 0.0.35-test.0

package/dist/cli/getmeta-command.js

@@ -0,0 +1,211 @@
+import path from 'path';
+import fs from 'fs';
+import { resolvePaths, agentThreadIndexPath } from '../paths.js';
+import { scanChatDirs, readLastJsonlLine, } from '../core/session/session-fs-store.js';
+const HELP_TEXT = `
+ec getmeta <id> [选项]
+
+按任意一种会话标识查询本地会话的完整元数据（不经过 daemon，直接读存档）。
+
+<id> 接受三种形态:
+  meta_YYYYMMDD_<ts>   ec 会话 id（meta 文件名）
+  thread-<...>         话题 id（threadId）
+  <uuid>               provider 侧会话 id（agentSessionId）
+
+输出字段:
+  sessionId / threadId / agentSessionId / peer / selfAID / baseagent
+  name / chatType / projectPath / updatedAt / metaFile
+  source              命中位置：meta（主会话）/ thread（话题）/ active / trash
+  indexed             该会话是否登记在话题索引里
+
+选项:
+  --self <aid>         只扫描指定 agent，减少全量扫描开销
+  --format json        以 JSON 格式输出
+`.trim();
+function argValue(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+function hasFlag(args, flag) {
+    return args.includes(flag);
+}
+function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 该 agent 的话题索引里是否登记了 (peer, threadId, sessionId)。 */
+function isIndexed(selfAID, peer, threadId, sessionId) {
+    if (!selfAID)
+        return false;
+    const raw = readJsonFile(agentThreadIndexPath(selfAID));
+    if (!raw?.threads)
+        return false;
+    return raw.threads.some(t => (t.sessionId === sessionId
+        && (t.threadId ?? '') === threadId
+        && (peer == null || t.peer === peer)));
+}
+function makeHit(meta, metaFile, source, selfAID, chatPeer) {
+    const threadId = meta.threadId ?? '';
+    return {
+        sessionId: meta.id,
+        threadId,
+        agentSessionId: meta.agentSessionId ?? null,
+        peer: meta.channelId ?? chatPeer ?? null,
+        selfAID: meta.selfAID ?? selfAID,
+        baseagent: meta.baseagent ?? null,
+        name: meta.name ?? null,
+        chatType: meta.chatType ?? null,
+        projectPath: meta.projectPath ?? null,
+        updatedAt: meta.updatedAt ?? null,
+        updatedAtStr: meta.updatedAtStr ?? null,
+        createdAtStr: meta.createdAtStr ?? null,
+        metaFile,
+        source,
+        indexed: isIndexed(meta.selfAID ?? selfAID, meta.channelId ?? chatPeer ?? null, threadId, meta.id),
+    };
+}
+/**
+ * id 形态判定。
+ * - `meta_...` 按文件名直接命中，不读文件内容
+ * - `thread-...` / uuid 需要扫末行比对，成本高但只在必要时发生
+ */
+function classifyId(id) {
+    if (id.startsWith('meta_'))
+        return 'session';
+    if (id.startsWith('thread-'))
+        return 'thread';
+    return 'agentSession';
+}
+async function cmdGetMeta(args) {
+    const jsonFormat = hasFlag(args, '--format') && argValue(args, '--format') === 'json'
+        || hasFlag(args, '--json');
+    // 位置参数 = 第一个不是 flag、也不属于任何 flag 取值的参数。
+    // 不能简单取"首个非 - 开头"，否则 `--self <aid>` 的值会被当成 id。
+    const VALUE_FLAGS = new Set(['--self', '--format']);
+    let rawId;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith('-')) {
+            if (VALUE_FLAGS.has(a))
+                i++;
+            continue;
+        }
+        rawId = a;
+        break;
+    }
+    if (!rawId) {
+        console.error('用法: ec getmeta <sessionId|threadId|agentSessionId> [--self <aid>] [--format json]');
+        process.exitCode = 1;
+        return;
+    }
+    const id = rawId.endsWith('.jsonl') ? rawId.slice(0, -'.jsonl'.length) : rawId;
+    const selfFilter = argValue(args, '--self');
+    const kind = classifyId(id);
+    const p = resolvePaths();
+    const chatDirs = scanChatDirs(p.sessionsDir).filter(c => !selfFilter || c.selfAID === selfFilter);
+    const hits = [];
+    for (const chat of chatDirs) {
+        // 主会话 meta 在目录根，话题在 _threads/，已删除话题在 _trash/
+        const locations = [
+            { dir: chat.dirPath, source: 'meta' },
+            { dir: path.join(chat.dirPath, '_threads'), source: 'thread' },
+            { dir: path.join(chat.dirPath, '_trash'), source: 'trash' },
+        ];
+        for (const loc of locations) {
+            let entries;
+            try {
+                entries = fs.readdirSync(loc.dir);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.endsWith('.jsonl') || entry.includes('.fork-history'))
+                    continue;
+                const entryId = entry.slice(0, -'.jsonl'.length);
+                // 文件名直接命中时只读这一个文件；否则必须读末行比对
+                if (kind === 'session' && entryId !== id)
+                    continue;
+                const filePath = path.join(loc.dir, entry);
+                const meta = readLastJsonlLine(filePath);
+                if (!meta)
+                    continue;
+                if (kind === 'thread' && (meta.threadId ?? '') !== id)
+                    continue;
+                if (kind === 'agentSession' && (meta.agentSessionId ?? '') !== id)
+                    continue;
+                if (kind === 'session' && meta.id !== id && entryId !== id)
+                    continue;
+                hits.push(makeHit(meta, filePath, loc.source, chat.selfAID, chat.channelId));
+            }
+        }
+    }
+    // 兜底：active.json 的 id/threadId/agentSessionId 也可能命中（active 是 meta 的最新快照）
+    if (hits.length === 0) {
+        for (const chat of chatDirs) {
+            const active = readJsonFile(path.join(chat.dirPath, 'active.json'));
+            if (!active)
+                continue;
+            const match = kind === 'session'
+                ? active.id === id
+                : kind === 'thread'
+                    ? (active.threadId ?? '') === id
+                    : (active.agentSessionId ?? '') === id;
+            if (!match)
+                continue;
+            hits.push(makeHit(active, path.join(chat.dirPath, 'active.json'), 'active', chat.selfAID, chat.channelId));
+        }
+    }
+    if (hits.length === 0) {
+        if (jsonFormat) {
+            console.log(JSON.stringify({ ok: false, id, kind, hits: [] }, null, 2));
+        }
+        else {
+            console.error(`✗ 未找到会话 ${id}（${kind === 'session' ? 'ec 会话 id' : kind === 'thread' ? '话题 id' : 'provider 会话 id'}；已扫描 ${chatDirs.length} 个 chat 目录）`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (jsonFormat) {
+        console.log(JSON.stringify({ ok: true, id, kind, hits }, null, 2));
+        return;
+    }
+    const sourceLabel = {
+        meta: '主会话 meta 文件',
+        thread: '话题 meta 文件',
+        active: 'active.json 快照',
+        trash: '已删除（_trash）',
+    };
+    for (const h of hits) {
+        console.log(`会话 id: ${h.sessionId}`);
+        console.log(`  话题 id: ${h.threadId || '(主会话)'}`);
+        console.log(`  provider 会话: ${h.agentSessionId ?? '(空)'}`);
+        console.log(`  来源: ${sourceLabel[h.source]}${h.source === 'trash' ? '  ⚠ 话题已删除' : ''}`);
+        console.log(`  索引: ${h.indexed ? '已登记' : '未登记（仅磁盘存档）'}`);
+        console.log(`  名称: ${h.name ?? '(未命名)'}`);
+        if (h.chatType)
+            console.log(`  类型: ${h.chatType === 'group' ? '群聊' : '单聊'}`);
+        console.log(`  对端: ${h.peer ?? ''}`);
+        console.log(`  本端 AID: ${h.selfAID ?? ''}`);
+        if (h.baseagent)
+            console.log(`  基座: ${h.baseagent}`);
+        if (h.projectPath)
+            console.log(`  项目: ${h.projectPath}`);
+        if (h.updatedAtStr)
+            console.log(`  最近更新: ${h.updatedAtStr}`);
+        console.log(`  文件: ${h.metaFile}`);
+        console.log('');
+    }
+}
+export async function runGetMetaCommand(args) {
+    const sub = args[0];
+    if (!sub || sub === 'help' || hasFlag(args, '--help') || hasFlag(args, '-h')) {
+        console.log(HELP_TEXT);
+        return;
+    }
+    await cmdGetMeta(args);
+}

package/dist/cli/index.js

@@ -37,6 +37,7 @@ Agent 与会话:
   ctl               当前托管会话的控制命令
   queue             查询或操作 agent 消息队列
   session           按 ec 会话 id 查询本地 session 存档（含 agentSessionId）
+  getmeta           按会话 id / threadId / agentSessionId 查询会话元数据
   task              恢复暂停或异常中断的会话任务
   trigger           管理定时与事件触发器
   handoff           查询和完成跨会话回流
@@ -78,7 +79,7 @@ AUN:
   EVENT_LOG         事件日志（默认: true）`;
 function printLifecycleHelp(command) {
     const help = {
-        start: `用法: ec start [--foreground] [--diagnose|-d]\n\n  --foreground   前台运行，适合 systemd 或容器直接管理\n  --diagnose, -d 以诊断模式启动 daemon`,
+        start: `用法: ec start [--foreground] [--diagnose|-d] [--debug] [--as-mode dev|install]\n\n  --foreground   前台运行，适合 systemd 或容器直接管理\n  --diagnose, -d 以诊断模式启动 daemon\n  --debug        调试模式：注册调试 IPC，可在宿主终端以任意 session 身份发命令\n  --as-mode      覆盖运行模式判定（仅本次启动生效，不写配置）：\n                   install = 按安装模式（校验随包文件完整性，篡改自动恢复）\n                   dev     = 按开发模式（不校验随包文件）`,
         stop: '用法: ec stop\n\n停止当前 EVOLCORE_HOME 下运行的 EvolCore 服务。',
         restart: `用法: ec restart [--clear] [--diagnose|-d]\n\n  --clear        同时清理跨 HOME 残留的 EvolCore 主进程\n  --diagnose, -d 以诊断模式启动新 daemon`,
         status: '用法: ec status\n\n查看 daemon、agent、渠道与会话运行状态。',
@@ -237,11 +238,20 @@ export async function main(args) {
                 printLifecycleHelp('start');
                 break;
             }
-            await cmdStart({
-                diagnose: strippedArgs.includes('--diagnose') || strippedArgs.includes('-d'),
-                foreground: strippedArgs.includes('--foreground'),
-                debug: strippedArgs.includes('--debug'),
-            });
+            {
+                const asModeRaw = getArgValue(strippedArgs, '--as-mode');
+                if (asModeRaw !== undefined && asModeRaw !== 'dev' && asModeRaw !== 'install') {
+                    console.error(`❌ --as-mode 只接受 dev 或 install，收到: ${asModeRaw}`);
+                    process.exitCode = 1;
+                    break;
+                }
+                await cmdStart({
+                    diagnose: strippedArgs.includes('--diagnose') || strippedArgs.includes('-d'),
+                    foreground: strippedArgs.includes('--foreground'),
+                    debug: strippedArgs.includes('--debug'),
+                    asMode: asModeRaw,
+                });
+            }
             break;
         case 'stop':
             if (wantsHelp(strippedArgs.slice(1))) {
@@ -339,6 +349,11 @@ export async function main(args) {
             await cmdNet(strippedArgs.slice(1));
             break;
         }
+        case 'integrity': {
+            const { cmdIntegrity } = await import('./integrity-command.js');
+            await cmdIntegrity(strippedArgs.slice(1));
+            break;
+        }
         case 'ctl':
             await cmdCtl(strippedArgs.slice(1));
             break;
@@ -435,6 +450,11 @@ export async function main(args) {
             await runSessionCommand(strippedArgs.slice(1));
             break;
         }
+        case 'getmeta': {
+            const { runGetMetaCommand } = await import('./getmeta-command.js');
+            await runGetMetaCommand(strippedArgs.slice(1));
+            break;
+        }
         case 'group': {
             const { suppressSdkLogs } = await import('../aun/aid/index.js');
             suppressSdkLogs();

package/dist/cli/integrity-command.js

@@ -0,0 +1,196 @@
+/**
+ * integrity-command.ts — `ec integrity` 子命令
+ *
+ * 子命令：
+ *   ec integrity check <path>    — 检查单个文件的台账状态（不修改，不恢复）
+ *   ec integrity seal <path>     — 把当前磁盘内容作为新基线登记（确认一次合法的带外修改）
+ *   ec integrity query <path>    — 打印台账记录（sha256、时间、登记方）
+ *   ec integrity list            — 列出所有已登记文件的状态摘要
+ *
+ * 所有操作都是本地 CLI，不经过 daemon IPC。
+ * 注意：ec integrity 不在 managed 白名单里，agent 会话内执行会被拒绝。
+ */
+import { createRequire } from 'module';
+import { checkFile, queryRecord, registerFile } from '../core/file-integrity/store.js';
+import { integrityDbPath, resolveRoot } from '../paths.js';
+import fs from 'fs';
+import path from 'path';
+const requireFromHere = createRequire(import.meta.url);
+const HELP = `用法: ec integrity <subcommand> [path]
+
+子命令:
+  check <path>    检查文件台账状态（不修改，不恢复文件）
+  seal <path>     把当前磁盘内容登记为新基线（确认合法的带外修改）
+  query <path>    查看台账记录（hash、时间、登记方）
+  list            列出所有已登记文件的摘要状态
+
+说明:
+  台账库位于 $EVOLCORE_HOME/data/integrity/file-integrity.db
+  "seal" 操作相当于手动确认一次合法修改，使其成为新的校验基线。
+  在开发模式下（非 node_modules 安装），系统文件不会自动校验，
+  但可以用 seal 主动建立基线，便于后续对比。
+`;
+function fmtTime(unix) {
+    if (!unix)
+        return '—';
+    return new Date(unix * 1000).toLocaleString('zh-CN', {
+        year: 'numeric', month: '2-digit', day: '2-digit',
+        hour: '2-digit', minute: '2-digit', second: '2-digit',
+        hour12: false,
+    });
+}
+function fmtHash(h) {
+    return h.slice(0, 16) + '…';
+}
+function resolveTarget(arg) {
+    return path.isAbsolute(arg) ? arg : path.resolve(process.cwd(), arg);
+}
+function cmdCheck(target) {
+    const result = checkFile(target);
+    const rel = path.relative(resolveRoot(), target) || path.basename(target);
+    switch (result.status) {
+        case 'missing':
+            console.log(`❓ 文件不存在: ${rel}`);
+            process.exitCode = 1;
+            break;
+        case 'unregistered':
+            console.log(`🆕 未登记（使用 seal 建立基线）: ${rel}`);
+            process.exitCode = 1;
+            break;
+        case 'verified':
+            console.log(`✅ 校验通过: ${rel}`);
+            console.log(`   sha256: ${fmtHash(result.actual)}`);
+            break;
+        case 'tampered':
+            console.log(`❌ 已被修改: ${rel}`);
+            console.log(`   预期: ${fmtHash(result.expected)}`);
+            console.log(`   实际: ${fmtHash(result.actual)}`);
+            console.log(`   可恢复: ${result.restorable ? '是（快照完好）' : '否（快照已损坏）'}`);
+            process.exitCode = 1;
+            break;
+    }
+}
+function cmdSeal(target) {
+    if (!fs.existsSync(target)) {
+        console.error(`❌ 文件不存在: ${target}`);
+        process.exitCode = 1;
+        return;
+    }
+    registerFile(target);
+    const rel = path.relative(resolveRoot(), target) || path.basename(target);
+    console.log(`✅ 已登记为新基线: ${rel}`);
+}
+function cmdQuery(target) {
+    const rec = queryRecord(target);
+    const rel = path.relative(resolveRoot(), target) || path.basename(target);
+    if (!rec) {
+        console.log(`🆕 台账无记录: ${rel}`);
+        return;
+    }
+    console.log(`文件: ${rel}`);
+    console.log(`  sha256:       ${rec.sha256}`);
+    console.log(`  登记时间:     ${fmtTime(rec.registered_at)}`);
+    console.log(`  最后校验:     ${fmtTime(rec.last_verified_at)}`);
+    console.log(`  登记方:       ${rec.registrar_aid ?? '（系统）'}`);
+}
+function cmdList() {
+    if (!fs.existsSync(integrityDbPath())) {
+        console.log('台账库尚未创建（还没有任何文件被登记过）');
+        return;
+    }
+    let DatabaseSync;
+    try {
+        ({ DatabaseSync } = requireFromHere('node:sqlite'));
+    }
+    catch {
+        console.error('❌ node:sqlite 不可用（需要 Node.js 22.5+）');
+        process.exitCode = 1;
+        return;
+    }
+    const db = new DatabaseSync(integrityDbPath(), { readonly: true });
+    const rows = db.prepare('SELECT file_path, sha256, registered_at, last_verified_at FROM file_integrity ORDER BY file_path').all();
+    if (rows.length === 0) {
+        console.log('台账为空');
+        return;
+    }
+    // 台账主键在 Windows 下是小写，root 也要按同样规则归一化才能前缀匹配
+    const rootSlash = resolveRoot().replace(/\\/g, '/');
+    const root = (process.platform === 'win32' ? rootSlash.toLowerCase() : rootSlash) + '/';
+    let ok = 0, tampered = 0, missing = 0;
+    console.log(`台账共 ${rows.length} 条记录（${integrityDbPath()}）\n`);
+    for (const row of rows) {
+        const rel = row.file_path.replace(/\\/g, '/').startsWith(root)
+            ? row.file_path.replace(/\\/g, '/').slice(root.length)
+            : row.file_path;
+        const chk = checkFile(row.file_path);
+        let icon;
+        switch (chk.status) {
+            case 'verified':
+                icon = '✅';
+                ok++;
+                break;
+            case 'tampered':
+                icon = '❌';
+                tampered++;
+                break;
+            case 'missing':
+                icon = '❓';
+                missing++;
+                break;
+            case 'unregistered':
+                icon = '🆕';
+                break;
+            default: icon = ' ';
+        }
+        console.log(`${icon} ${rel}`);
+        if (chk.status === 'tampered') {
+            console.log(`     预期: ${fmtHash(row.sha256)}  实际: ${fmtHash(chk.actual)}`);
+        }
+    }
+    console.log(`\n摘要：通过 ${ok}，已改 ${tampered}，不存在 ${missing}`);
+    if (tampered > 0 || missing > 0)
+        process.exitCode = 1;
+}
+export async function cmdIntegrity(args) {
+    const sub = args[0];
+    if (!sub || sub === '--help' || sub === '-h') {
+        console.log(HELP);
+        return;
+    }
+    switch (sub) {
+        case 'check': {
+            if (!args[1]) {
+                console.error('用法: ec integrity check <path>');
+                process.exitCode = 1;
+                return;
+            }
+            cmdCheck(resolveTarget(args[1]));
+            break;
+        }
+        case 'seal': {
+            if (!args[1]) {
+                console.error('用法: ec integrity seal <path>');
+                process.exitCode = 1;
+                return;
+            }
+            cmdSeal(resolveTarget(args[1]));
+            break;
+        }
+        case 'query': {
+            if (!args[1]) {
+                console.error('用法: ec integrity query <path>');
+                process.exitCode = 1;
+                return;
+            }
+            cmdQuery(resolveTarget(args[1]));
+            break;
+        }
+        case 'list':
+            cmdList();
+            break;
+        default:
+            console.error(`未知子命令: ${sub}`);
+            console.log(HELP);
+            process.exitCode = 1;
+    }
+}

package/dist/cli/managed-command-guard.js

@@ -21,6 +21,9 @@ const MANAGED_TASK_COMMANDS = new Set([
     // `session` 按 ec 会话 id 只读查询本地 session 存档（meta 文件尾行的
     // agentSessionId 等），不触碰 daemon 与进程生命周期。
     'session',
+    // `getmeta` 按 ec 会话 id / threadId / agentSessionId 之一只读查询本地
+    // 会话存档，同样不触碰 daemon 与进程生命周期。
+    'getmeta',
     // `skill` 管理 EC 技能（安装/开关/校验）。它的主要使用者就是 agent 自己——
     // ec-skill 技能的 SKILL.md 明确指导 agent 调用它。脚本只读写
     // `thread` 提供话题链操作，通过 thread.op IPC 鉴权