evolcore 0.0.27 → 0.0.29-test.0

package/dist/cli/memory-command.js

@@ -0,0 +1,441 @@
+/**
+ * memory-command.ts — `ec memory` 子命令实现（v3）
+ *
+ * 主会话可用：
+ *   ec memory note --slug <slug> [--tags <...>] <content>
+ *   ec memory note update <slug> [--slug <新slug>] [--tags <...>] [<content>]
+ *   ec memory note drop <slug>
+ *   ec memory note list
+ *   ec memory consolidate [--mode notes|generalize|promote|profile|forget]
+ *
+ * 整理会话（sessionType=memory）另有 create / update / archive 三个写命令，
+ * 实现见 core/memory/memory-writer.ts，在这里只做 CLI 分发与权限委托。
+ */
+import { resolvePaths } from '../paths.js';
+import { ipcQuery } from '../ipc.js';
+import { isHelpFlag, wantsHelp } from './help.js';
+import { readDelegationCredential } from '../core/auth/agent-delegation.js';
+export const MEMORY_MODES = ['notes', 'generalize', 'promote', 'profile', 'forget'];
+const MEMORY_HELP = `用法: ec memory <command> [选项]
+
+命令:
+  note         写入 / 修改 / 撤销 / 查看临时记忆（主会话）
+  create       新建正式记忆（仅整理会话）
+  update       修改正式记忆的标签，或续期（仅整理会话）
+  archive      归档正式记忆（仅整理会话）
+  demote       把记忆降级回上一层（agent→relation，owner→agent）
+  consolidate  触发记忆整理（启动整理会话）
+
+ec memory note --slug <slug> [--tags <tag1,tag2,...>] <content>
+
+选项:
+  --slug <slug>      文件名标识，字母/数字/连字符，长度 1-64（必填）
+  --tags <...>       标签列表，逗号分隔；取值见 \$KITS_DOCS/evolcore/memory-tags.md
+
+ec memory note update <slug> [--slug <新slug>] [--tags <...>] [<content>]
+ec memory note drop <slug>
+ec memory note list
+
+ec memory create --scope <relation|agent|owner> --slug <slug> --desc <description> \\
+    --tags <...> [--keywords <...>] [--replaces <path,...>] <content>
+
+ec memory update <path> [--tags <...>] [--touch]
+
+ec memory archive <path...>
+
+ec memory consolidate [--mode <notes|generalize|promote|profile|forget>]
+
+选项:
+  --mode              整理模式（默认 notes）
+
+公共选项（所有子命令）:
+  --debug <sessionId> 在宿主终端模拟该会话的托管环境（仅开发仓 daemon 支持）；
+                      会话没有运行中任务时，daemon 从会话文件重建运行时上下文
+
+示例:
+  ec memory note --slug commit-convention --tags "rule,long-term" "commit 消息必须用中文"
+  ec memory note update commit-convention --tags "rule,done" "commit 消息必须用中文"
+  ec memory note drop commit-convention
+  ec memory note list
+  ec memory consolidate
+  ec memory consolidate --mode promote
+  ec memory create --scope relation --slug profile --desc "对端画像" --tags "profile" --replaces consolidated/profile.md "（画像正文）"
+  ec memory update consolidated/commit-convention.md --tags "rule,done"
+  ec memory archive consolidated/obsolete.md`;
+export async function cmdMemory(args) {
+    if (args.length === 0 || isHelpFlag(args[0]) || wantsHelp(args)) {
+        console.log(MEMORY_HELP);
+        return;
+    }
+    const sub = args[0];
+    if (sub === 'note') {
+        await cmdMemoryNote(args.slice(1));
+    }
+    else if (sub === 'consolidate') {
+        await cmdMemoryConsolidate(args.slice(1));
+    }
+    else if (sub === 'create') {
+        await cmdMemoryCreate(args.slice(1));
+    }
+    else if (sub === 'update') {
+        await cmdMemoryConsolidatedUpdate(args.slice(1));
+    }
+    else if (sub === 'archive') {
+        await cmdMemoryArchive(args.slice(1));
+    }
+    else if (sub === 'demote') {
+        await cmdMemoryDemote(args.slice(1));
+    }
+    else if (sub === 'feedback') {
+        await cmdMemoryFeedback(args.slice(1));
+    }
+    else {
+        console.error(`❌ 未知子命令: ${sub}`);
+        console.error(MEMORY_HELP);
+        process.exit(1);
+    }
+}
+/**
+ * 解析 `--key value` 与位置参数。未识别的 `--xxx` 一律报错，避免静默忽略。
+ * `--debug <sessionId>` 是所有子命令的公共参数，不用每处声明。
+ */
+function parseArgs(args, known) {
+    const flags = new Map();
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith('--')) {
+            if (a !== '--debug' && !known.includes(a)) {
+                console.error(`❌ 未知参数: ${a}`);
+                process.exit(1);
+            }
+            if (i + 1 >= args.length || args[i + 1].startsWith('--')) {
+                // --touch 这类布尔开关不带值
+                flags.set(a, '');
+                continue;
+            }
+            flags.set(a, args[++i]);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    return { flags, positional };
+}
+function parseTags(raw) {
+    if (raw === undefined)
+        return undefined;
+    const tags = raw.split(',').map(t => t.trim()).filter(Boolean);
+    return tags.length > 0 ? tags : undefined;
+}
+/** 各子命令的一行完整用法：缺参报错时附上，模型照抄即可重试。 */
+const USAGE = {
+    note: 'ec memory note --slug <slug> [--tags <tag1,tag2>] [--speakers <aid1,aid2>] "<正文>"',
+    noteUpdate: 'ec memory note update <slug> [--slug <新slug>] [--tags <...>] ["<新正文>"]',
+    noteDrop: 'ec memory note drop <slug>',
+    create: 'ec memory create --scope <relation|agent|owner> --slug <slug> --desc "<描述>" --tags <tag1,tag2> [--keywords <...>] [--replaces <路径,...>] [--peer <peerKey>] "<正文>"',
+    update: 'ec memory update <路径> [--tags <tag1,tag2>] [--touch]（至少给一项）',
+    archive: 'ec memory archive <路径...>',
+};
+function failWithUsage(message, usage) {
+    console.error(`❌ ${message}`);
+    console.error(`用法: ${usage}`);
+    process.exit(1);
+}
+/**
+ * 取当前会话。`--debug <sessionId>` 在宿主终端模拟托管环境（仅开发仓 daemon 认）；
+ * 否则读 EVOLCORE_SESSION_ID。
+ */
+function requireManagedSession(cmd, flags) {
+    const debugSessionId = flags.get('--debug');
+    if (flags.has('--debug') && !debugSessionId) {
+        console.error(`❌ --debug 需要提供 sessionId（如 --debug meta_20260910_1789013149542）`);
+        process.exit(1);
+    }
+    const sessionId = debugSessionId || process.env.EVOLCORE_SESSION_ID;
+    if (!sessionId) {
+        console.error(`错误: EVOLCORE_SESSION_ID 未设置（${cmd} 仅在 evolcore 托管环境中可用；调试可加 --debug <sessionId>）`);
+        process.exit(1);
+    }
+    if (debugSessionId)
+        console.error(`[debug] 模拟会话 ${debugSessionId}`);
+    return {
+        sessionId,
+        socketPath: resolvePaths().socket,
+        delegationToken: readDelegationCredential(),
+        ...(debugSessionId ? { debug: true } : {}),
+    };
+}
+// ── note ───────────────────────────────────────────────────────────────────
+async function cmdMemoryNote(args) {
+    if (wantsHelp(args)) {
+        console.log(MEMORY_HELP);
+        return;
+    }
+    const sub = args[0];
+    if (sub === 'update')
+        return cmdMemoryNoteUpdate(args.slice(1));
+    if (sub === 'drop')
+        return cmdMemoryNoteDrop(args.slice(1));
+    if (sub === 'list')
+        return cmdMemoryNoteList(args.slice(1));
+    return cmdMemoryNoteCreate(args);
+}
+async function cmdMemoryNoteCreate(args) {
+    const { flags, positional } = parseArgs(args, ['--slug', '--tags', '--speakers']);
+    const content = positional.join(' ').trim();
+    const slug = flags.get('--slug');
+    const tags = parseTags(flags.get('--tags'));
+    const speakers = parseTags(flags.get('--speakers'));
+    if (!slug)
+        failWithUsage('必须提供 --slug', USAGE.note);
+    if (!content)
+        failWithUsage('必须提供记忆内容（content）', USAGE.note);
+    const { socketPath, ...session } = requireManagedSession('ec memory note', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.note', ...session, slug, content, tags,
+        speakers: speakers && speakers.length > 0 ? speakers : undefined,
+    }, 15_000);
+    reportResult(result, (r) => {
+        if (r.filePath)
+            console.log(r.filePath);
+    });
+}
+async function cmdMemoryNoteUpdate(args) {
+    const { flags, positional } = parseArgs(args, ['--slug', '--tags']);
+    const slug = positional[0];
+    const content = positional.slice(1).join(' ').trim();
+    const newSlug = flags.get('--slug');
+    const tagsRaw = flags.get('--tags');
+    const tags = parseTags(tagsRaw);
+    if (!slug)
+        failWithUsage('必须提供要修改的 slug', USAGE.noteUpdate);
+    if (!newSlug && tagsRaw === undefined && !content) {
+        failWithUsage('至少提供一项要改的内容（--slug / --tags / 正文）', USAGE.noteUpdate);
+    }
+    const { socketPath, ...session } = requireManagedSession('ec memory note update', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.note.update', ...session, slug,
+        newSlug, tags, tagsProvided: tagsRaw !== undefined,
+        content: content || undefined,
+    }, 15_000);
+    reportResult(result, (r) => {
+        if (r.filePath)
+            console.log(r.filePath);
+    });
+}
+async function cmdMemoryNoteDrop(args) {
+    const { flags, positional } = parseArgs(args, []);
+    const slug = positional[0];
+    if (!slug)
+        failWithUsage('必须提供要撤销的 slug', USAGE.noteDrop);
+    const { socketPath, ...session } = requireManagedSession('ec memory note drop', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.note.drop', ...session, slug,
+    }, 15_000);
+    reportResult(result, (r) => {
+        console.log(`✓ 已撤销: ${r.filePath ?? slug}`);
+    });
+}
+async function cmdMemoryNoteList(args) {
+    const { flags } = parseArgs(args, []);
+    const { socketPath, ...session } = requireManagedSession('ec memory note list', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.note.list', ...session,
+    }, 15_000);
+    reportResult(result, (r) => {
+        const notes = r.notes ?? [];
+        if (notes.length === 0) {
+            console.log('（没有待整理的 note）');
+            return;
+        }
+        for (const n of notes) {
+            const tags = n.tags?.length ? ` [${n.tags.join(', ')}]` : '';
+            console.log(`${n.slug}${tags}${n.updatedAt ? `  (${n.updatedAt})` : ''}`);
+            if (n.firstLine)
+                console.log(`    ${n.firstLine}`);
+        }
+    });
+}
+// ── create / update / archive（仅整理会话） ─────────────────────────────────
+async function cmdMemoryCreate(args) {
+    const { flags, positional } = parseArgs(args, [
+        '--scope', '--slug', '--desc', '--tags', '--keywords', '--replaces', '--peer',
+    ]);
+    const content = positional.join(' ').trim();
+    const scope = flags.get('--scope');
+    const slug = flags.get('--slug');
+    const desc = flags.get('--desc');
+    const tagsRaw = flags.get('--tags');
+    const keywordsRaw = flags.get('--keywords');
+    const replacesRaw = flags.get('--replaces');
+    const targetPeerKey = flags.get('--peer');
+    if (!scope || !['agent', 'relation', 'owner'].includes(scope)) {
+        failWithUsage('--scope 必须是 agent / relation / owner 之一', USAGE.create);
+    }
+    if (!slug)
+        failWithUsage('必须提供 --slug', USAGE.create);
+    if (!desc)
+        failWithUsage('必须提供 --desc', USAGE.create);
+    if (tagsRaw === undefined)
+        failWithUsage('必须提供 --tags', USAGE.create);
+    if (!content)
+        failWithUsage('必须提供记忆内容（content）', USAGE.create);
+    if (targetPeerKey !== undefined && scope !== 'relation') {
+        failWithUsage('--peer 只在 --scope relation 时有效', USAGE.create);
+    }
+    const { socketPath, ...session } = requireManagedSession('ec memory create', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.create', ...session, scope, slug, description: desc,
+        content,
+        tags: parseTags(tagsRaw),
+        keywords: parseTags(keywordsRaw),
+        replaces: replacesRaw ? replacesRaw.split(',').map(s => s.trim()).filter(Boolean) : undefined,
+        targetPeerKey: targetPeerKey ?? undefined,
+    }, 15_000);
+    reportResult(result, (r) => {
+        if (r.filePath)
+            console.log(r.filePath);
+        if (Array.isArray(r.archived) && r.archived.length > 0) {
+            console.log(`已归档: ${r.archived.join(', ')}`);
+        }
+    });
+}
+async function cmdMemoryConsolidatedUpdate(args) {
+    const { flags, positional } = parseArgs(args, ['--tags', '--touch']);
+    const filePath = positional[0];
+    const tagsRaw = flags.get('--tags');
+    const touch = flags.has('--touch');
+    if (!filePath)
+        failWithUsage('必须提供要修改的记忆文件路径', USAGE.update);
+    if (tagsRaw === undefined && !touch)
+        failWithUsage('至少提供 --tags 或 --touch', USAGE.update);
+    const { socketPath, ...session } = requireManagedSession('ec memory update', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.update', ...session, filePath,
+        tags: parseTags(tagsRaw), touch,
+    }, 15_000);
+    reportResult(result, () => {
+        console.log(`✓ 已更新: ${filePath}`);
+    });
+}
+async function cmdMemoryArchive(args) {
+    const { flags, positional } = parseArgs(args, []);
+    if (positional.length === 0)
+        failWithUsage('必须提供至少一个要归档的文件路径', USAGE.archive);
+    const { socketPath, ...session } = requireManagedSession('ec memory archive', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.archive', ...session, filePaths: positional,
+    }, 15_000);
+    reportResult(result, (r) => {
+        const archived = r.archived ?? positional;
+        console.log(`✓ 已归档 ${archived.length} 个文件:`);
+        for (const f of archived)
+            console.log(`  ${f}`);
+    });
+}
+// ── consolidate ────────────────────────────────────────────────────────────
+async function cmdMemoryDemote(args) {
+    if (wantsHelp(args)) {
+        console.log(MEMORY_HELP);
+        return;
+    }
+    const { flags, positional } = parseArgs(args, ['--scope']);
+    const slug = positional[0];
+    if (!slug) {
+        console.error('用法: ec memory demote <slug> [--scope agent|owner]');
+        process.exit(1);
+    }
+    const scope = flags.get('--scope') ?? 'agent';
+    if (scope !== 'agent' && scope !== 'owner') {
+        console.error('--scope 必须是 agent 或 owner');
+        process.exit(1);
+    }
+    const { socketPath, ...session } = requireManagedSession('ec memory demote', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.demote', ...session, slug, scope,
+    }, 15_000);
+    reportResult(result, (r) => {
+        if (r.conflictArchived) {
+            console.log(`⚠ 目标层已有同名文件，当前记忆已归档至:`);
+            console.log(`  ${r.conflictArchived}`);
+        }
+        else {
+            console.log(`✓ 已降级`);
+            console.log(`  ${r.destPath}`);
+        }
+    });
+}
+async function cmdMemoryConsolidate(args) {
+    if (wantsHelp(args)) {
+        console.log(MEMORY_HELP);
+        return;
+    }
+    // 先于通用解析处理已废弃的 --scope，给出可操作的提示而不是「未知参数」
+    if (args.includes('--scope')) {
+        console.error('❌ `--scope` 已废弃。作用域由模式唯一决定，请改用 `--mode <notes|generalize|promote|profile|forget>`');
+        process.exit(1);
+    }
+    const { flags } = parseArgs(args, ['--mode']);
+    const mode = (flags.get('--mode') ?? 'notes');
+    if (!MEMORY_MODES.includes(mode)) {
+        console.error(`❌ --mode 必须是 ${MEMORY_MODES.join(' / ')} 之一`);
+        process.exit(1);
+    }
+    const { socketPath, ...session } = requireManagedSession('ec memory consolidate', flags);
+    console.log(`正在触发记忆整理（mode=${mode}）...`);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.consolidate', ...session, mode,
+    }, 30_000);
+    reportResult(result, (r) => {
+        console.log(`✓ 整理会话已启动（${mode} 模式）`);
+        if (r.triggerId)
+            console.log(`  triggerId:      ${r.triggerId}`);
+        if (r.executionSessionId)
+            console.log(`  sessionId:      ${r.executionSessionId}`);
+        console.log(`  agentSessionId: ${r.agentSessionId ?? '（会话仍在初始化，稍后用 sessionId 查）'}`);
+        if (r.contextFilePath)
+            console.log(`  context:        ${r.contextFilePath}`);
+        console.log('整理会话在后台继续运行。');
+    });
+}
+// ── feedback（整理会话反馈）─────────────────────────────────────────────────
+/**
+ * 整理会话用 `ec memory feedback "<文本>"` 记录本次整理的反馈内容。
+ * 文本写入批次目录的 ops.jsonl（op=feedback-set），收尾时据此投递回发起会话。
+ * 未调用则不写，收尾回退到默认统计模板。
+ */
+async function cmdMemoryFeedback(args) {
+    if (wantsHelp(args)) {
+        console.log(MEMORY_HELP);
+        return;
+    }
+    const { flags, positional } = parseArgs(args, []);
+    const text = positional.join(' ').trim();
+    if (!text) {
+        console.error('用法: ec memory feedback "<反馈文本>"');
+        process.exit(1);
+    }
+    const { socketPath, ...session } = requireManagedSession('ec memory feedback', flags);
+    const result = await ipcQuery(socketPath, {
+        type: 'memory.feedback', ...session, text,
+    }, 15_000);
+    reportResult(result, () => {
+        console.log('✓ 已记录反馈内容');
+    });
+}
+// ── 结果输出 ───────────────────────────────────────────────────────────────
+function reportResult(result, ok) {
+    if (!result) {
+        console.error('错误: 无法连接 evolcore 服务');
+        process.exit(1);
+    }
+    const r = result;
+    if (r.ok) {
+        ok(r);
+    }
+    else {
+        console.error(r.error || '操作失败');
+        process.exit(1);
+    }
+}

package/dist/cli/menu-client.js

@@ -111,4 +111,8 @@ export async function cmdMenuClient(args) {
     else
         response = await executeMenuClientRequest(parseMenuClientArgs(args));
     console.log(JSON.stringify(response, null, 2));
+    // Transport success does not imply the requested operation succeeded.
+    // Preserve the complete wire response for callers while failing the CLI.
+    if (response?.error)
+        process.exitCode = 1;
 }