evolcore 0.0.38 → 0.0.40

package/dist/cli/diag.js

@@ -1,4 +1,4 @@
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { resolvePaths } from '../paths.js';
 import { readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { parseDiagArgs } from '../core/command/diag-service.js';
@@ -13,13 +13,17 @@ export async function cmdDiag(args) {
     let result;
     try {
         parseDiagArgs(args);
-        result = await ipcQuery(resolvePaths().socket, {
+        const { response, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'diag', argv,
             ...(process.env.EVOLCORE_SESSION_ID ? {
                 sessionId: process.env.EVOLCORE_SESSION_ID,
                 delegationToken: readDelegationCredential(),
             } : {}),
-        }, 30_000) ?? { ok: false, code: 'DAEMON_UNAVAILABLE', message: 'daemon 未返回结果，请检查其运行状态；发送结果尚未确认' };
+        }, 30_000);
+        result = response ?? {
+            ok: false, code: 'DAEMON_UNAVAILABLE',
+            message: daemonUnavailableMessage(transportError, 'daemon 未返回结果，请检查其运行状态；发送结果尚未确认'),
+        };
     }
     catch (error) {
         result = { ok: false, code: 'INVALID_ARGUMENT', message: error.message };

package/dist/cli/fs-command.js

@@ -3,7 +3,7 @@ import path from 'path';
 import { TextDecoder } from 'util';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { agentmdGet, getAidStore, isValidAid, loadClient, SLOT } from '../aun/aid/index.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { resolvePaths } from '../paths.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { DEFAULT_FS_CAT_BYTES, MAX_FS_CAT_BYTES, FsReadBudgetError, downloadGroupFsBytes, readPersonalFsBytesWithinBudget, } from '../aun/group/fs-download.js';
@@ -222,14 +222,15 @@ async function runManagedFs(args, formatJson) {
         fail('NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
     if (!delegationToken)
         fail('DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
-    const response = await ipcQuery(resolvePaths().socket, {
+    const { response, transportError } = await queryDaemon(resolvePaths().socket, {
         type: 'fs.op',
         argv: ['fs', ...args],
         sessionId,
         delegationToken,
     }, 30_000);
-    if (!response)
-        return fail('DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
+    if (!response) {
+        return fail('DAEMON_UNAVAILABLE', daemonUnavailableMessage(transportError, 'Unable to connect to the evolcore daemon'));
+    }
     if (!response.ok || !response.result)
         fail(String(response.code || 'FS_OPERATION_FAILED'), response.error || 'Filesystem operation failed');
     const result = response.result;

package/dist/cli/handoff-command.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import { resolvePaths } from '../paths.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { HANDOFF_QUERY_DEFAULT_LIMIT, HANDOFF_QUERY_MAX_LIMIT, HANDOFF_STATES } from '../core/handoff/types.js';
 import { HANDOFF_ID_RE } from '../core/handoff/store.js';
 import { isHelpFlag, wantsHelp } from './help.js';
@@ -191,7 +191,7 @@ Commands:
             process.exitCode = 1;
             return;
         }
-        const result = await ipcQuery(resolvePaths().socket, {
+        const { response: result, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'handoff-return',
             argv: ['handoff', ...args],
             sessionId: process.env.EVOLCORE_SESSION_ID,
@@ -200,7 +200,7 @@ Commands:
             delegationToken: readDelegationCredential(),
         }, 5000);
         if (!result) {
-            console.error('✗ daemon 暂时不可用');
+            console.error(`✗ ${daemonUnavailableMessage(transportError, 'daemon 暂时不可用')}`);
             process.exitCode = 1;
             return;
         }
@@ -222,7 +222,7 @@ Commands:
             process.exitCode = 1;
             return;
         }
-        const result = await ipcQuery(resolvePaths().socket, {
+        const { response: result, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'handoff-recover-return',
             argv: ['handoff', ...args],
             sessionId: process.env.EVOLCORE_SESSION_ID,
@@ -231,7 +231,7 @@ Commands:
             delegationToken: readDelegationCredential(),
         }, 5000);
         if (!result) {
-            console.error('✗ daemon 暂时不可用');
+            console.error(`✗ ${daemonUnavailableMessage(transportError, 'daemon 暂时不可用')}`);
             process.exitCode = 1;
             return;
         }
@@ -245,13 +245,13 @@ Commands:
             process.exitCode = 1;
             return;
         }
-        const result = await ipcQuery(resolvePaths().socket, {
+        const { response: result, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'handoff-status', sessionId: process.env.EVOLCORE_SESSION_ID, handoffId,
             argv: ['handoff', ...args],
             delegationToken: readDelegationCredential(),
         }, 5000);
         if (!result) {
-            console.error('✗ daemon 暂时不可用');
+            console.error(`✗ ${daemonUnavailableMessage(transportError, 'daemon 暂时不可用')}`);
             process.exitCode = 1;
             return;
         }
@@ -273,7 +273,7 @@ Commands:
             process.exitCode = 1;
             return;
         }
-        const result = await ipcQuery(resolvePaths().socket, {
+        const { response: result, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'handoff-list',
             argv: ['handoff', ...args],
             sessionId: process.env.EVOLCORE_SESSION_ID,
@@ -284,7 +284,7 @@ Commands:
             delegationToken: readDelegationCredential(),
         }, 5000);
         if (!result) {
-            console.error('✗ daemon 暂时不可用');
+            console.error(`✗ ${daemonUnavailableMessage(transportError, 'daemon 暂时不可用')}`);
             process.exitCode = 1;
             return;
         }
@@ -318,7 +318,7 @@ Commands:
             process.exitCode = 1;
             return;
         }
-        const result = await ipcQuery(resolvePaths().socket, {
+        const { response: result, transportError } = await queryDaemon(resolvePaths().socket, {
             type: 'handoff-trace',
             argv: ['handoff', ...args],
             sessionId: process.env.EVOLCORE_SESSION_ID,
@@ -328,7 +328,7 @@ Commands:
             delegationToken: readDelegationCredential(),
         }, 5000);
         if (!result) {
-            console.error('✗ daemon 暂时不可用');
+            console.error(`✗ ${daemonUnavailableMessage(transportError, 'daemon 暂时不可用')}`);
             process.exitCode = 1;
             return;
         }

package/dist/cli/help.js

@@ -11,7 +11,25 @@
  *   - 单层命令（如 cmdLinkRules、cmdAid 的具体 sub 处理块内）用 wantsHelp(args)，
  *     支持 option 风格帮助，同时不把 `--` 后的正文误判为帮助。
  */
+import { IpcTransportError, ipcQuery } from '../ipc.js';
 const HELP_TOKENS = new Set(['help', '--help', '-h']);
+/** Query a daemon-backed command while preserving concrete transport failures. */
+export async function queryDaemon(socketPath, command, timeoutMs = 3000) {
+    try {
+        return {
+            response: await ipcQuery(socketPath, command, timeoutMs, { throwOnError: true }),
+        };
+    }
+    catch (error) {
+        if (error instanceof IpcTransportError) {
+            return { response: null, transportError: error };
+        }
+        throw error;
+    }
+}
+export function daemonUnavailableMessage(transportError, fallback) {
+    return transportError?.message ?? fallback;
+}
 export function isHelpFlag(token) {
     return token !== undefined && HELP_TOKENS.has(token);
 }

package/dist/cli/index.js

@@ -82,7 +82,7 @@ function printLifecycleHelp(command) {
         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、渠道与会话运行状态。',
+        status: '用法: ec status [--format json]\n\n查看 daemon、Agent、渠道与队列运行状态。JSON 模式输出结构化状态快照。',
         logs: `用法: ec logs [选项]\n\n  --level <error|warn|info|debug>  最低日志级别\n  --module <name>                  只显示指定模块\n  --raw                            原始输出\n  --no-color                       禁用颜色`,
         watch: `用法: ec watch [logs|log|aid|msg|diag|web|session]\n\n  ec watch                 打开监控选择菜单\n  ec watch logs            选择日志类型后监控\n  ec watch log <类型...>   直接监控指定日志类型\n  ec watch aid             监控 AID 连接\n  ec watch msg             打开消息 TUI\n  ec watch diag            实时诊断消息生命周期（AUN→daemon→任务）\n  ec watch web             安装/升级并启动 EC Web\n  ec watch session         ec watch web 的兼容别名`,
         'restart-monitor': '用法: ec restart-monitor\n\n运行内 daemon 重启与升级监控器。',
@@ -266,21 +266,33 @@ export async function main(args) {
                 printLifecycleHelp('status');
                 break;
             }
-            if (process.env.EVOLCORE_SESSION_ID) {
-                const sessionId = process.env.EVOLCORE_SESSION_ID;
-                const delegationToken = readDelegationCredential();
-                const result = await ipcQuery(resolvePaths().socket, {
-                    type: 'status.auth', sessionId, delegationToken,
-                });
-                if (!result?.ok) {
-                    console.error(`❌ ${result?.error || 'status is not allowed in this task'}`);
+            {
+                const statusArgs = strippedArgs.slice(1);
+                const formatValue = getArgValue(statusArgs, '--format');
+                const validStatusArgs = statusArgs.length === 0
+                    || (statusArgs.length === 2 && statusArgs[0] === '--format' && formatValue === 'json');
+                if (!validStatusArgs) {
+                    console.error('用法: ec status [--format json]');
                     process.exitCode = 1;
                     break;
                 }
-                await cmdStatus();
-            }
-            else {
-                await cmdStatus();
+                const format = formatValue;
+                if (process.env.EVOLCORE_SESSION_ID) {
+                    const sessionId = process.env.EVOLCORE_SESSION_ID;
+                    const delegationToken = readDelegationCredential();
+                    const result = await ipcQuery(resolvePaths().socket, {
+                        type: 'status.auth', sessionId, delegationToken,
+                    });
+                    if (!result?.ok) {
+                        console.error(`❌ ${result?.error || 'status is not allowed in this task'}`);
+                        process.exitCode = 1;
+                        break;
+                    }
+                    await cmdStatus({ format });
+                }
+                else {
+                    await cmdStatus({ format });
+                }
             }
             break;
         case 'logs':

package/dist/cli/init-channel.js

@@ -8,6 +8,7 @@
 import readline from 'readline';
 import { cmdAidBind } from './aid-bind-command.js';
 import { getOwners } from '../core/ownership/owner-resolver.js';
+import { MAIN_CLI_BIN } from '../product.js';
 import crypto from 'crypto';
 import { selectInstance } from './init.js';
 import { loadAllAgents, loadAgent, loadDaemonConfig } from '../config-store.js';
@@ -695,7 +696,7 @@ export async function cmdInitWechat() {
 // ==================== AUN ====================
 export async function cmdInitAun() {
     console.log('AUN 协议 Owner 统一使用 ec aid bind <ownerAid> [--subject <subjectAid>]');
-    console.log('状态查询: ec aid bind status [--subject <subjectAid>]；Evol App 扫码绑定留待二期。');
+    console.log(`状态查询: ${MAIN_CLI_BIN} aid bind status [--subject <subjectAid>]；邀约审批: ${MAIN_CLI_BIN} aid bind accept|reject <operationId>。`);
 }
 async function pickAunOwnerBindTarget(rl, daemonAid) {
     const { agents } = loadAllAgents();

package/dist/cli/memory-command.js

@@ -13,7 +13,7 @@
  */
 import fs from 'node:fs';
 import { resolvePaths } from '../paths.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
 import { readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
@@ -43,11 +43,12 @@ ec memory note drop <slug>
 ec memory note list
 
 ec memory create --scope <relation|agent|owner> --slug <slug> --desc '<description>' \\
-    --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<path1>,<path2>'] '<content>'
+    --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<path1>,<path2>'] \\
+    [--peer <peerKey>] [--reason '<why>'] [--generalized-from <path>] [--promoted-from <path>] '<content>'
 
-ec memory update <path> [--tags '<tag1>,<tag2>'] [--touch]
+ec memory update <path> [--tags '<tag1>,<tag2>'] [--touch] [--reason '<why>']
 
-ec memory archive <path...>
+ec memory archive <path...> [--reason '<why>']
 
 ec memory consolidate [--mode <notes|generalize|promote|profile|forget>]
 
@@ -168,8 +169,9 @@ export function resolveMemoryCommandArgv(argv) {
     const kind = noteSub ? `note.${noteSub}` : argv[1];
     const known = {
         note: ['--slug', '--tags', '--speakers'], 'note.update': ['--slug', '--tags'],
-        'note.drop': [], 'note.list': [], create: ['--scope', '--slug', '--desc', '--tags', '--keywords', '--replaces', '--peer'],
-        update: ['--tags', '--touch'], archive: [], demote: ['--scope'], consolidate: ['--mode'],
+        'note.drop': [], 'note.list': [],
+        create: ['--scope', '--slug', '--desc', '--tags', '--keywords', '--replaces', '--peer', '--reason', '--generalized-from', '--promoted-from'],
+        update: ['--tags', '--touch', '--reason'], archive: ['--reason'], demote: ['--scope'], consolidate: ['--mode'],
     };
     // feedback 已移除：旧会话/旧文档可能还在调用，给一句能照做的说明而不是泛化的非法命令。
     if (kind === 'feedback') {
@@ -209,17 +211,19 @@ export function resolveMemoryCommandArgv(argv) {
             throw new Error('--peer requires relation scope');
         return { type, scope, slug: required(flags.get('--slug'), '--slug'), description: required(flags.get('--desc'), '--desc'),
             content: required(content, 'content'), tags: parseTags(flags.get('--tags')), keywords: parseTags(flags.get('--keywords')),
-            replaces: parseTags(flags.get('--replaces')), targetPeerKey: flags.get('--peer') };
+            replaces: parseTags(flags.get('--replaces')), targetPeerKey: flags.get('--peer'),
+            reason: flags.get('--reason'), generalizedFrom: flags.get('--generalized-from'), promotedFrom: flags.get('--promoted-from') };
     }
     if (kind === 'update') {
         if (!flags.has('--tags') && !flags.has('--touch'))
             throw new Error('No memory changes supplied');
-        return { type, filePath: required(positional[0], 'path'), tags: parseTags(flags.get('--tags')), touch: flags.has('--touch') };
+        return { type, filePath: required(positional[0], 'path'), tags: parseTags(flags.get('--tags')), touch: flags.has('--touch'),
+            reason: flags.get('--reason') };
     }
     if (kind === 'archive') {
         if (!positional.length)
             throw new Error('Memory paths are required');
-        return { type, filePaths: positional };
+        return { type, filePaths: positional, reason: flags.get('--reason') };
     }
     if (kind === 'demote') {
         const scope = flags.get('--scope') ?? 'agent';
@@ -240,9 +244,9 @@ const USAGE = {
     note: "ec memory note --slug <slug> [--tags '<tag1>,<tag2>'] [--speakers '<aid1>,<aid2>'] '<正文>'",
     noteUpdate: "ec memory note update <slug> [--slug <新slug>] [--tags '<tag1>,<tag2>'] ['<新正文>']",
     noteDrop: 'ec memory note drop <slug>',
-    create: "ec memory create --scope <relation|agent|owner> --slug <slug> --desc '<描述>' --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] [--peer <peerKey>] '<正文>'",
-    update: "ec memory update <路径> [--tags '<tag1>,<tag2>'] [--touch]（至少给一项）",
-    archive: 'ec memory archive <路径...>',
+    create: "ec memory create --scope <relation|agent|owner> --slug <slug> --desc '<描述>' --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] [--peer <peerKey>] [--reason '<为什么>'] [--generalized-from <路径>] [--promoted-from <路径>] '<正文>'",
+    update: "ec memory update <路径> [--tags '<tag1>,<tag2>'] [--touch] [--reason '<为什么>']（至少给一项）",
+    archive: "ec memory archive <路径...> [--reason '<为什么>']",
 };
 /**
  * 统一失败出口。JSON 模式与 `ec fs` / `ec response` 一致：stdout 输出 `{ ok: false, code, error }`；
@@ -337,7 +341,7 @@ async function cmdMemoryNoteCreate(args, json) {
     if (!content)
         failWithUsage(json, '必须提供记忆内容（content）', USAGE.note);
     const { socketPath, ...session } = requireManagedSession('ec memory note', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.note', argv: ['memory', 'note', ...args], ...session, slug, content, tags,
         speakers: speakers && speakers.length > 0 ? speakers : undefined,
     }, 15_000);
@@ -359,7 +363,7 @@ async function cmdMemoryNoteUpdate(args, json) {
         failWithUsage(json, '至少提供一项要改的内容（--slug / --tags / 正文）', USAGE.noteUpdate);
     }
     const { socketPath, ...session } = requireManagedSession('ec memory note update', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.note.update', argv: ['memory', 'note', 'update', ...args], ...session, slug,
         newSlug, tags, tagsProvided: tagsRaw !== undefined,
         content: content || undefined,
@@ -375,7 +379,7 @@ async function cmdMemoryNoteDrop(args, json) {
     if (!slug)
         failWithUsage(json, '必须提供要撤销的 slug', USAGE.noteDrop);
     const { socketPath, ...session } = requireManagedSession('ec memory note drop', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.note.drop', argv: ['memory', 'note', 'drop', ...args], ...session, slug,
     }, 15_000);
     reportResult(result, json, (r) => {
@@ -385,7 +389,7 @@ async function cmdMemoryNoteDrop(args, json) {
 async function cmdMemoryNoteList(args, json) {
     const { flags } = parseCliArgs(args, [], json);
     const { socketPath, ...session } = requireManagedSession('ec memory note list', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.note.list', argv: ['memory', 'note', 'list', ...args], ...session,
     }, 15_000);
     reportResult(result, json, (r) => {
@@ -406,6 +410,7 @@ async function cmdMemoryNoteList(args, json) {
 async function cmdMemoryCreate(args, json) {
     const { flags, positional } = parseCliArgs(args, [
         '--scope', '--slug', '--desc', '--tags', '--keywords', '--replaces', '--peer',
+        '--reason', '--generalized-from', '--promoted-from',
     ], json);
     const content = positional.join(' ').trim();
     const scope = flags.get('--scope');
@@ -415,6 +420,9 @@ async function cmdMemoryCreate(args, json) {
     const keywordsRaw = flags.get('--keywords');
     const replacesRaw = flags.get('--replaces');
     const targetPeerKey = flags.get('--peer');
+    const reason = flags.get('--reason');
+    const generalizedFrom = flags.get('--generalized-from');
+    const promotedFrom = flags.get('--promoted-from');
     if (!scope || !['agent', 'relation', 'owner'].includes(scope)) {
         failWithUsage(json, '--scope 必须是 agent / relation / owner 之一', USAGE.create);
     }
@@ -429,14 +437,23 @@ async function cmdMemoryCreate(args, json) {
     if (targetPeerKey !== undefined && scope !== 'relation') {
         failWithUsage(json, '--peer 只在 --scope relation 时有效', USAGE.create);
     }
+    if (generalizedFrom !== undefined && scope !== 'agent') {
+        failWithUsage(json, '--generalized-from 只在 --scope agent 时有效', USAGE.create);
+    }
+    if (promotedFrom !== undefined && scope !== 'owner') {
+        failWithUsage(json, '--promoted-from 只在 --scope owner 时有效', USAGE.create);
+    }
     const { socketPath, ...session } = requireManagedSession('ec memory create', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.create', argv: ['memory', 'create', ...args], ...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,
+        reason: reason ?? undefined,
+        generalizedFrom: generalizedFrom ?? undefined,
+        promotedFrom: promotedFrom ?? undefined,
     }, 15_000);
     reportResult(result, json, (r) => {
         if (r.filePath)
@@ -447,30 +464,32 @@ async function cmdMemoryCreate(args, json) {
     });
 }
 async function cmdMemoryConsolidatedUpdate(args, json) {
-    const { flags, positional } = parseCliArgs(args, ['--tags', '--touch'], json);
+    const { flags, positional } = parseCliArgs(args, ['--tags', '--touch', '--reason'], json);
     const filePath = positional[0];
     const tagsRaw = flags.get('--tags');
     const touch = flags.has('--touch');
+    const reason = flags.get('--reason');
     if (!filePath)
         failWithUsage(json, '必须提供要修改的记忆文件路径', USAGE.update);
     if (tagsRaw === undefined && !touch)
         failWithUsage(json, '至少提供 --tags 或 --touch', USAGE.update);
     const { socketPath, ...session } = requireManagedSession('ec memory update', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.update', argv: ['memory', 'update', ...args], ...session, filePath,
-        tags: parseTags(tagsRaw), touch,
+        tags: parseTags(tagsRaw), touch, reason: reason ?? undefined,
     }, 15_000);
     reportResult(result, json, () => {
         console.log(`✓ 已更新: ${filePath}`);
     });
 }
 async function cmdMemoryArchive(args, json) {
-    const { flags, positional } = parseCliArgs(args, [], json);
+    const { flags, positional } = parseCliArgs(args, ['--reason'], json);
     if (positional.length === 0)
         failWithUsage(json, '必须提供至少一个要归档的文件路径', USAGE.archive);
     const { socketPath, ...session } = requireManagedSession('ec memory archive', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.archive', argv: ['memory', 'archive', ...args], ...session, filePaths: positional,
+        reason: flags.get('--reason') ?? undefined,
     }, 15_000);
     reportResult(result, json, (r) => {
         const archived = r.archived ?? positional;
@@ -496,7 +515,7 @@ async function cmdMemoryDemote(args, json) {
         fail(json, 'INVALID_ARGUMENT', '--scope 必须是 agent 或 owner', { text: '--scope 必须是 agent 或 owner' });
     }
     const { socketPath, ...session } = requireManagedSession('ec memory demote', flags, json);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.demote', argv: ['memory', 'demote', ...args], ...session, slug, scope,
     }, 15_000);
     reportResult(result, json, (r) => {
@@ -528,7 +547,7 @@ async function cmdMemoryConsolidate(args, json) {
     // JSON 模式下 stdout 只留结果对象
     if (!json)
         console.log(`正在触发记忆整理（mode=${mode}）...`);
-    const result = await ipcQuery(socketPath, {
+    const result = await queryDaemon(socketPath, {
         type: 'memory.consolidate', argv: ['memory', 'consolidate', ...args], ...session, mode,
     }, 30_000);
     reportResult(result, json, (r) => {
@@ -551,10 +570,11 @@ async function cmdMemoryConsolidate(args, json) {
 }
 // ── 结果输出 ───────────────────────────────────────────────────────────────
 function reportResult(result, json, ok) {
-    if (!result) {
-        fail(json, 'DAEMON_UNAVAILABLE', '无法连接 evolcore 服务', { text: '错误: 无法连接 evolcore 服务' });
+    if (!result.response) {
+        const message = daemonUnavailableMessage(result.transportError, '无法连接 evolcore 服务');
+        fail(json, 'DAEMON_UNAVAILABLE', message, { text: `错误: ${message}` });
     }
-    const r = result;
+    const r = result.response;
     if (!r.ok) {
         const message = r.error || '操作失败';
         fail(json, r.code || 'MEMORY_OPERATION_FAILED', message, { text: message });

package/dist/cli/model.js

@@ -16,7 +16,7 @@ import { resolveEffectiveFieldWithSource } from '../config/config-manager.js';
 import { getCatalog, getModelInfo, catalogEfforts, resolveCatalogModel, assertCatalogSelectable } from '../core/model/model-catalog.js';
 import { constrainResolvedModelForRole, filterModelsForRole, validateModelSelectionForRole, } from '../core/model/model-permission.js';
 import { resolvePaths } from '../paths.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { parsePeerKey } from '../core/relation/peer-identity.js';
 import { resolvePeerRoleDetail } from '../config/peer-role-resolver.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
@@ -50,11 +50,12 @@ async function runManagedCliOperation(args, formatJson, timeoutMs = 10_000) {
     const delegationToken = readDelegationCredential();
     if (!delegationToken)
         fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} 未设置`);
-    const response = await ipcQuery(resolvePaths().socket, {
+    const { response, transportError } = await queryDaemon(resolvePaths().socket, {
         type: 'ctl', argv: args, sessionId, delegationToken,
     }, timeoutMs);
-    if (!response)
-        fail(formatJson, 'DAEMON_UNAVAILABLE', '无法连接 evolcore 服务');
+    if (!response) {
+        fail(formatJson, 'DAEMON_UNAVAILABLE', daemonUnavailableMessage(transportError, '无法连接 evolcore 服务'));
+    }
     if (!response.ok)
         fail(formatJson, response.code || 'CTL_FAILED', response.error || '命令执行失败');
     printCtlResult({ text: response.result || '', data: response.data }, formatJson);

package/dist/cli/queue-command.js

@@ -1,5 +1,5 @@
 import { resolvePaths } from '../paths.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
@@ -94,7 +94,7 @@ JSON 时间字段:
                 : undefined;
     const socketPath = resolvePaths().socket;
     const managed = process.env.EVOLCORE_SESSION_ID;
-    const result = await ipcQuery(socketPath, managed ? {
+    const { response: result, transportError } = await queryDaemon(socketPath, managed ? {
         type: 'queue.op',
         argv: ['queue', ...args],
         agent,
@@ -115,7 +115,7 @@ JSON 时间字段:
         before,
     });
     if (!result) {
-        console.error('错误: 无法连接 evolcore 服务');
+        console.error(`错误: ${daemonUnavailableMessage(transportError, '无法连接 evolcore 服务')}`);
         process.exit(1);
     }
     const r = result;

package/dist/cli/response.js

@@ -15,7 +15,7 @@ import { readField, writeField, determineFieldScope, normalizePeer, ModelScopeEr
 import { readFieldWithSource, resolveAgentConfig, ConfigTarget } from '../config/config-manager.js';
 import { ResponseModeRegistry } from '../response-system/registry.js';
 import { registerBuiltinModes } from '../response-system/modes/index.js';
-import { ipcQuery } from '../ipc.js';
+import { daemonUnavailableMessage, queryDaemon } from './help.js';
 import { resolvePaths } from '../paths.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 const RESPONSE_MODE_FIELD = 'responseMode';
@@ -64,11 +64,12 @@ async function runManagedResponse(args, formatJson) {
         fail(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
     if (!delegationToken)
         fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set`);
-    const response = await ipcQuery(resolvePaths().socket, {
+    const { response, transportError } = await queryDaemon(resolvePaths().socket, {
         type: 'ctl', argv: ['response', ...args], sessionId, delegationToken,
     }, 10_000);
-    if (!response)
-        fail(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
+    if (!response) {
+        fail(formatJson, 'DAEMON_UNAVAILABLE', daemonUnavailableMessage(transportError, 'Unable to connect to the evolcore daemon'));
+    }
     if (!response.ok)
         fail(formatJson, response.code || 'CTL_FAILED', response.error || 'response operation failed');
     emit(formatJson, response.data ?? { ok: true, result: response.result }, () => response.result || 'ok');

package/dist/cli/restart-monitor.js

@@ -130,6 +130,18 @@ export async function cmdRestartMonitor() {
     const hasCorrelatedRequest = requestId !== 'unknown';
     const upgradeJobId = hasCorrelatedRequest ? readRestartRequest(pendingFile, requestId)?.upgradeJobId : undefined;
     const upgradeJob = typeof upgradeJobId === 'string' ? readUpgradeJob(upgradeJobId) : null;
+    let configuredAutoUpgrade = true;
+    if (!upgradeJob && !process.argv.includes('--apply-package-upgrades') && !process.argv.includes('--skip-package-upgrades')) {
+        try {
+            configuredAutoUpgrade = loadDaemonConfig().upgrade?.autoOnStart !== false;
+        }
+        catch {
+            configuredAutoUpgrade = false;
+        }
+    }
+    const applyPackageUpgrades = !!upgradeJob
+        || process.argv.includes('--apply-package-upgrades')
+        || (!process.argv.includes('--skip-package-upgrades') && configuredAutoUpgrade);
     if (upgradeJobId && (!upgradeJob || upgradeJob.restartRequestId !== requestId || upgradeJob.released || upgradeJob.deadline <= Date.now())) {
         if (upgradeJob)
             updateUpgradeJob(upgradeJob.jobId, { status: 'timeout', success: false, released: true, code: 'UPGRADE_TIMEOUT', reason: 'Update expired before restart preflight' }, '更新已超时，未执行重启');
@@ -371,16 +383,24 @@ export async function cmdRestartMonitor() {
     const stoppedCodex = stopCodexAppServerOrphans();
     if (stoppedCodex)
         log(`Cleaned ${stoppedCodex} EvolCore codex app-server orphan(s)`);
-    // Apply only the preflight cache. There is no registry VERSION query after
-    // shutdown (npm still downloads the exact cached package when needed).
-    log('Applying cached version information...');
-    // 升级会原地替换整包，先留一个可回退的产物副本。备份放 EVOLCORE_HOME 而非包目录：
-    // Linux/macOS 的全局目录常常不可写，而 HOME 一定可写。
-    const upgradeBackup = await backupDistForUpgrade(p, log);
-    const [upgrade] = await applyCachedPackageUpgrades(undefined, {
-        log,
-        ...(upgradeJob ? { target: upgradeJob.target, distTag: upgradeJob.distTag, npmConfig: upgradeJob.npmConfig } : {}),
-    });
+    let upgradeBackup = null;
+    let upgrade;
+    if (applyPackageUpgrades) {
+        // Apply only the preflight cache. There is no registry VERSION query after
+        // shutdown (npm still downloads the exact cached package when needed).
+        log('Applying cached version information...');
+        // 升级会原地替换整包，先留一个可回退的产物副本。备份放 EVOLCORE_HOME 而非包目录：
+        // Linux/macOS 的全局目录常常不可写，而 HOME 一定可写。
+        upgradeBackup = await backupDistForUpgrade(p, log);
+        [upgrade] = await applyCachedPackageUpgrades(undefined, {
+            log,
+            ...(upgradeJob ? { target: upgradeJob.target, distTag: upgradeJob.distTag, npmConfig: upgradeJob.npmConfig } : {}),
+        });
+    }
+    else {
+        log('Skipping cached package upgrade because upgrade.autoOnStart=false');
+        upgrade = { status: 'skipped', error: 'Automatic package upgrades disabled by autoOnStart' };
+    }
     let upgradeRolledBack;
     switch (upgrade.status) {
         case 'upgraded':
@@ -405,9 +425,11 @@ export async function cmdRestartMonitor() {
             log(`Already up to date (${upgrade.from})`);
             break;
         case 'skipped':
-            log(upgrade.error
-                ? 'Skipped upgrade (network unavailable)'
-                : 'Skipped upgrade check (dev mode)');
+            log(upgrade.error === 'Automatic package upgrades disabled by autoOnStart'
+                ? 'Skipped package upgrade (autoOnStart=false)'
+                : upgrade.error
+                    ? 'Skipped upgrade (network unavailable)'
+                    : 'Skipped upgrade check (dev mode)');
             break;
         case 'failed':
             log(`⚠ Upgrade failed (${upgrade.from} → ${upgrade.to}): ${upgrade.error}`);