evolcore 0.0.39 → 0.0.40

package/dist/channels/wecom.js

@@ -257,8 +257,9 @@ export class PersistentWecomCardStore {
         let changed = false;
         for (const [taskId, record] of this.records) {
             const terminalExpiry = record.updatedAt + DEFAULT_CARD_RETENTION_MS;
-            const pendingExpiry = (record.expiresAt ?? record.createdAt + 7 * DEFAULT_CARD_RETENTION_MS)
-                + DEFAULT_CARD_RETENTION_MS;
+            const pendingExpiry = record.interaction.blocking === true
+                ? Number.POSITIVE_INFINITY
+                : (record.expiresAt ?? record.createdAt + 7 * DEFAULT_CARD_RETENTION_MS) + DEFAULT_CARD_RETENTION_MS;
             const expiresAt = record.status === 'pending' ? pendingExpiry : terminalExpiry;
             if (now > expiresAt) {
                 this.records.delete(taskId);
@@ -322,7 +323,10 @@ export function buildWecomInteractionCard(interaction, taskId) {
             .filter(({ button }) => !('disabled' in button) || !button.disabled)
             .slice(0, 6)
             .map(({ button, index }) => ({
-            text: truncate(button.label, 10) || `选项 ${index + 1}`,
+            text: truncate(interaction.kind.kind === 'action' && 'key' in button
+                && interaction.kind.recommendedOption === button.key
+                ? `💡 ${button.label}`
+                : button.label, 10) || `选项 ${index + 1}`,
             style: buttonStyle(button.style),
             key: interaction.kind.kind === 'command-card' ? `cmd_${index}` : `act_${index}`,
         })),

package/dist/cli/agent-create.js

@@ -881,8 +881,15 @@ export class AgentInitializationService {
             return;
         try {
             const record = readInitialization(aid);
-            if (!record || record.status !== 'in_progress' || record.phase !== 'ownerpending'
-                || this.running.has(aid))
+            if (!record || this.running.has(aid))
+                return;
+            const waitingForOwner = record.status === 'in_progress' && record.phase === 'ownerpending';
+            // Records written before ownerBindSubmitted existed could fail by resubmitting the bind
+            // while SDK ownership events invalidated the consensus cache. Retry them once the
+            // requested Owner is observable; other failures still require an explicit --resume.
+            const lostConsensusRace = record.status === 'failed' && record.code === 'CONSENSUS_REQUIRED'
+                && record.plan.ownerAid === ownerAid;
+            if (!waitingForOwner && !lostConsensusRace)
                 return;
             this.resume(aid, record.actor);
         }
@@ -1052,8 +1059,20 @@ export class AgentInitializationService {
         }
         this.phase(r, 'hot_loading');
         await this.deps.hotLoad(p.aid);
-        if (this.deps.bindOwner)
-            await this.deps.bindOwner(p.aid, p.ownerAid);
+        if (this.deps.bindOwner) {
+            // Owner-consensus recovery and --resume re-run from the start. The SDK keeps emitting
+            // ownership events for a few seconds after approval, each invalidating the cached
+            // consensus, so resubmitting an accepted bind then fails with CONSENSUS_REQUIRED.
+            // Retry when no pending or completed task for this Owner remains.
+            const bindStillActive = this.deps.ownerBindActive
+                ? this.deps.ownerBindActive(p.aid, p.ownerAid)
+                : r.ownerBindSubmitted === true;
+            if (!bindStillActive) {
+                this.phase(r, 'binding_owner');
+                await this.deps.bindOwner(p.aid, p.ownerAid);
+                r.ownerBindSubmitted = true;
+            }
+        }
         this.phase(r, 'ownerpending');
         const ownership = await this.deps.checkOwner(p.aid, p.ownerAid);
         this.check(r);

package/dist/cli/aid-bind-command.js

@@ -20,10 +20,11 @@ export async function cmdAidBind(args) {
         const delegationToken = sessionId ? readDelegationCredential() : undefined;
         if (sessionId && !delegationToken)
             throw Object.assign(new Error('Active task delegation is required'), { code: 'DELEGATION_REQUIRED' });
+        const isDecision = args[0] === 'accept' || args[0] === 'reject';
         const response = await ipcQuery(resolvePaths().socket, {
             type: 'aid.ownership', argv: ['aid', 'bind', ...args],
             ...(sessionId ? { sessionId, delegationToken } : {}),
-        }, 30_000);
+        }, isDecision ? 150_000 : 30_000);
         if (!response?.ok)
             throw Object.assign(new Error(response?.error ?? 'daemon 未运行或 IPC 不可用'), { code: response?.code, retryable: response?.retryable });
         if (formatJson)
@@ -40,6 +41,8 @@ export async function cmdAidBind(args) {
                 console.log(`绑定任务: ${state.task.operation_id} (${state.task.status}/${state.task.step})`);
             if (state.decisionTask)
                 console.log(`审批任务: ${state.decisionTask.operation_id} (${state.decisionTask.status}/${state.decisionTask.step})`);
+            if (state.decisionConsensus)
+                console.log(`审批目标共识: ${state.decisionConsensus.status} (owner=${state.decisionConsensus.owner_aid ?? '-'}, version=${state.decisionConsensus.relation_version}, lock=${state.decisionConsensus.lock})`);
             for (const request of state.requests ?? []) {
                 console.log(`待确认邀约: ${request.operation_id} (sub=${request.sub_aid}, owner=${request.owner_aid}, 本端=${request.local_role})`);
             }

package/dist/cli/daemon-commands.js

@@ -31,6 +31,8 @@ import { rotateStdoutLog } from '../utils/log-writer.js';
 import { inspectDataMigrationRequirement } from '../core/data-migration.js';
 import { isInitCancelledError, printInitCancelHint } from './init-cancel.js';
 import { computeBuildId } from '../utils/evolcore-version.js';
+import { readHostInfo } from '../utils/host-info.js';
+import { queryStatusActivity, queryStatusActivityByAgent } from '../stats/query.js';
 import { listCodexAppServerProcesses, unregisterCodexAppServerProcess } from '../agents/codex/app-server-registry.js';
 import { DEFAULT_ECWEB_PORT, ecwebService, setEcwebEnabled } from '../config/daemon-services.js';
 import { checkCodexProjectPath, inspectCodexManagedHook, ensureCodexManagedHook, runCodexHookLaunchDiagnostic, } from '../agents/codex/diagnostics.js';
@@ -301,7 +303,20 @@ async function requireFreshSourceBuild() {
 async function launchPackageLifecycle(source, log, options = {}) {
     const correlated = options.requestId ?? process.env[RESTART_REQUEST_ID_ENV];
     const upgradeJobId = correlated ? readRestartRequest(path.join(daemonControlDir(), 'restart-pending.json'), correlated)?.upgradeJobId : undefined;
-    if (!options.prepared && !upgradeJobId)
+    let configuredAutoUpgrade = true;
+    if (!upgradeJobId && options.applyPackageUpgrades === undefined) {
+        try {
+            configuredAutoUpgrade = loadDaemonConfig().upgrade?.autoOnStart !== false;
+        }
+        catch {
+            configuredAutoUpgrade = false;
+            log('Could not read autoOnStart; skipping automatic package upgrade');
+        }
+    }
+    const applyPackageUpgrades = upgradeJobId
+        ? true
+        : options.applyPackageUpgrades ?? configuredAutoUpgrade;
+    if (!options.prepared && !upgradeJobId && applyPackageUpgrades)
         await ensureFreshPackageVersionInfo(undefined, { source, log });
     const root = resolvePaths().root;
     const launch = platform.resolveMonitorLaunch(getPackageRoot(), path.join(root, 'data', 'monitor-stage'));
@@ -313,7 +328,12 @@ async function launchPackageLifecycle(source, log, options = {}) {
         return { ok: false, reason: 'RESTART_ENTRY_MISSING' };
     }
     const requestId = options.requestId ?? process.env[RESTART_REQUEST_ID_ENV];
-    const args = [...launch.args, 'restart-monitor', ...(options.clear ? ['--clear'] : [])];
+    const args = [
+        ...launch.args,
+        'restart-monitor',
+        ...(options.clear ? ['--clear'] : []),
+        applyPackageUpgrades ? '--apply-package-upgrades' : '--skip-package-upgrades',
+    ];
     const env = {
         ...options.env,
         [RUNTIME_HOME_ENV]: root,
@@ -758,7 +778,7 @@ export async function cmdStart(opts = {}) {
         // 这条路由 restart-monitor 拉起 daemon，同样靠覆盖文件把 --as-mode 带过去
         const overrideFile = writeAsModeOverride(opts.asMode);
         const launched = await launchPackageLifecycle('start', console.log, {
-            prepared: true, foreground: opts.foreground, env: buildDaemonEnv(p, opts),
+            prepared: true, foreground: opts.foreground, env: buildDaemonEnv(p, opts), applyPackageUpgrades: true,
         });
         if (!launched.ok) {
             if (!launched.pending)
@@ -1291,7 +1311,180 @@ function showConfigChannels(config) {
         console.log('  (no channels configured)');
     }
 }
-export async function cmdStatus() {
+function showLiveChannels(status) {
+    const channels = status?.channels;
+    if (!channels || typeof channels !== 'object' || Array.isArray(channels))
+        return false;
+    const entries = Object.entries(channels);
+    console.log('🔌 Channels (live status):');
+    if (entries.length === 0) {
+        console.log('  (no channel instances loaded)');
+        return true;
+    }
+    for (const [name, channel] of entries) {
+        const state = channel?.connected === true ? '✓ Connected'
+            : channel?.connected === false ? '✗ Disconnected' : '? Unknown';
+        const type = typeof channel?.channelType === 'string' ? ` (${channel.channelType})` : '';
+        console.log(`  ${name}: ${state}${type}`);
+    }
+    return true;
+}
+function localDayStartMs(now = new Date()) {
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+}
+function statusActivityJson(window) {
+    return {
+        received: window.received,
+        sent: window.sent,
+        completed: window.completed,
+        errors: window.errors,
+        interrupts: window.interrupts,
+        avgResponseMs: window.avgResponseMs,
+        modelCalls: window.modelCalls,
+        tokens: window.tokens,
+        cost: window.cost,
+    };
+}
+function readLocalPackageVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(getPackageRoot(), 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function cmdStatusJson() {
+    const p = resolvePaths();
+    const started = Date.now();
+    const instanceStatus = scanInstances();
+    const aliveMains = instanceStatus.mains.filter(instance => instance.alive);
+    let ipcError;
+    const pingPromise = probeDaemon(p.socket, DAEMON_PROBE_TIMEOUT_MS, true).catch(error => {
+        ipcError = error;
+        return null;
+    });
+    const [ping, statusResponse, aidsResponse, agentsResponse, agentStatsResponse] = await Promise.all([
+        pingPromise,
+        ipcQuery(p.socket, { type: 'status' }).catch(() => null),
+        ipcQuery(p.socket, { type: 'aun-aids' }).catch(() => null),
+        ipcQuery(p.socket, { type: 'evolagent.list' }).catch(() => null),
+        ipcQuery(p.socket, { type: 'agent-stats' }).catch(() => null),
+    ]);
+    const now = Date.now();
+    const runningPid = ping?.pid ?? aliveMains[0]?.record.pid ?? null;
+    const mainRecord = runningPid ? aliveMains.find(instance => instance.record.pid === runningPid)?.record : undefined;
+    const statusAvailable = !!statusResponse;
+    const overallStatus = statusAvailable
+        ? 'running'
+        : platform.isWindows && ipcError instanceof IpcTransportError
+            && ['ENOENT', 'ECONNREFUSED'].includes(ipcError.code)
+            ? 'stopped'
+            : 'unknown';
+    const todayStart = localDayStartMs(new Date(now));
+    const lastHourActivity = queryStatusActivity(p.root, now - 3_600_000, now);
+    const todayActivity = statusResponse?.activity?.today ?? queryStatusActivity(p.root, todayStart, now);
+    const daemonLastHourActivity = statusResponse?.activity?.lastHour;
+    const effectiveLastHourActivity = daemonLastHourActivity ?? lastHourActivity;
+    const agents = agentsResponse?.agents ?? [];
+    const agentStats = new Map((agentStatsResponse?.stats ?? []).map((item) => [item.aid, item]));
+    const statusAgents = Array.isArray(statusResponse?.agents) ? statusResponse.agents : null;
+    const agentUsage = statusAgents
+        ? new Map()
+        : queryStatusActivityByAgent(p.root, todayStart, now, agents.map((agent) => String(agent.aid ?? agent.name ?? '')));
+    const diagnostics = [];
+    if (!statusAvailable) {
+        diagnostics.push({ code: 'DAEMON_IPC_UNAVAILABLE', message: ipcError instanceof Error ? ipcError.message : 'daemon status unavailable' });
+    }
+    const agentItems = statusAgents ?? agents.map((agent) => {
+        const aid = String(agent.aid ?? agent.name ?? '');
+        const runtime = agentStats.get(aid);
+        const usage = agentUsage.get(aid) ?? queryStatusActivity(p.root, todayStart, now, aid);
+        return {
+            aid,
+            name: agent.name ?? aid,
+            status: agent.status ?? 'unknown',
+            baseagent: agent.baseagent ?? null,
+            model: agent.model ?? null,
+            effort: agent.effort ?? null,
+            queue: runtime ? { pending: runtime.queued ?? 0, processing: runtime.processing ?? 0 } : null,
+            usage: {
+                calls: usage.modelCalls,
+                tokens: usage.tokens,
+                cost: usage.cost,
+            },
+        };
+    });
+    const channels = Object.entries(statusResponse?.channels ?? {})
+        .filter(([, channel]) => channel?.channelType !== 'aun')
+        .map(([name, channel]) => ({
+        name,
+        type: channel?.channelType ?? name,
+        status: channel?.status ?? (channel?.connected ? 'connected' : 'disconnected'),
+        connected: channel?.connected ?? false,
+    }));
+    const aunItems = (aidsResponse?.aids ?? []).map((aid) => ({
+        aid: aid.aid,
+        channelName: aid.channelName,
+        status: aid.status ?? 'unknown',
+        connected: aid.status === 'connected',
+        queue: aid.queueStatus ? {
+            pending: aid.queueStatus.queued ?? 0,
+            processing: aid.queueStatus.processing ?? 0,
+        } : null,
+        reconnectCount: aid.reconnectCount ?? 0,
+    }));
+    const host = statusResponse?.host ?? readHostInfo(readLocalPackageVersion());
+    const ecwebEntry = readEcwebInstanceEntries(p)[0];
+    const ecweb = ecwebEntry
+        ? { source: 'instance-record', status: platform.isProcessRunning(ecwebEntry.record.pid) ? 'running' : 'unknown', port: ecwebEntry.record.port, url: `http://localhost:${ecwebEntry.record.port}` }
+        : { source: 'instance-record', status: 'stopped', port: null, url: null };
+    const triggerSummary = statusResponse?.triggers
+        ? { source: 'runtime+history', ...statusResponse.triggers }
+        : { source: 'unavailable', enabled: null, today: { calls: null, failures: null } };
+    const build = statusResponse?.build
+        ? { runtimeMode: statusResponse.build.runtimeMode, version: statusResponse.build.version ?? null }
+        : null;
+    const output = {
+        schemaVersion: 1,
+        generatedAt: new Date(now).toISOString(),
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        overall: {
+            status: overallStatus,
+            degraded: !statusAvailable || statusResponse?.agentRuntime?.state === 'error',
+        },
+        host,
+        daemon: {
+            pid: runningPid,
+            uptimeMs: ping?.uptime ?? statusResponse?.uptime ?? null,
+            ipc: { reachable: statusAvailable, latencyMs: Date.now() - started },
+            runMode: statusResponse?.runMode ?? mainRecord?.runMode ?? null,
+            build,
+            queue: statusResponse?.queue ?? { pending: null, processing: null },
+        },
+        baseagents: statusResponse?.baseagents ?? { source: 'unavailable', items: [] },
+        activity: {
+            lastHour: statusActivityJson(effectiveLastHourActivity),
+            today: statusActivityJson(todayActivity),
+        },
+        agents: {
+            source: statusAvailable ? 'daemon+stats-db' : 'stats-db',
+            items: agentItems,
+        },
+        aun: { source: aidsResponse ? 'daemon' : 'unavailable', items: aunItems },
+        channels: { source: statusAvailable ? 'daemon' : 'unavailable', items: channels },
+        controlAid: statusResponse?.controlAid ?? null,
+        triggers: triggerSummary,
+        ecweb,
+        diagnostics,
+    };
+    console.log(JSON.stringify(output, null, 2));
+}
+export async function cmdStatus(options = {}) {
+    if (options.format === 'json') {
+        await cmdStatusJson();
+        return;
+    }
     const p = resolvePaths();
     const status = scanInstances();
     const aliveMains = status.mains.filter(m => m.alive);
@@ -1300,13 +1493,19 @@ export async function cmdStatus() {
     // query can otherwise wait behind the same IPC/event-loop delay and make the
     // total `ec status` time the sum of several individual timeouts.
     let ipcFailure;
+    let agentsQueryFailure;
     const pingPromise = probeDaemon(p.socket, DAEMON_PROBE_TIMEOUT_MS, true).catch(error => {
         ipcFailure = error;
         return null;
     });
     const statusPromise = ipcQuery(p.socket, { type: 'status' }).catch(() => null);
     const aidsPromise = ipcQuery(p.socket, { type: 'aun-aids' }).catch(() => null);
-    const agentsPromise = ipcQuery(p.socket, { type: 'evolagent.list' }).catch(() => null);
+    const agentsPromise = process.env.EVOLCORE_SESSION_ID
+        ? Promise.resolve({ ok: false, error: 'per-agent listing requires a local control token' })
+        : ipcQuery(p.socket, { type: 'evolagent.list' }, 5_000).catch(error => {
+            agentsQueryFailure = error;
+            return null;
+        });
     // Only the ping is needed to decide whether to show the live-daemon
     // sections. The remaining responses continue in parallel while local
     // process/session information is rendered.
@@ -1484,6 +1683,7 @@ export async function cmdStatus() {
     // Channel status. A running daemon is authoritative and avoids reading
     // protected config files from the CLI's potentially sandboxed process.
     let agentsResponse = null;
+    let liveAgentRuntime = null;
     if (pid) {
         console.log('');
         const [statusResponse, aidsResponse, agentResponse] = await Promise.all([
@@ -1492,6 +1692,7 @@ export async function cmdStatus() {
             agentsPromise,
         ]);
         agentsResponse = agentResponse;
+        liveAgentRuntime = statusResponse?.agentRuntime ?? null;
         if (statusResponse) {
             if (statusResponse.build) {
                 if (statusResponse.build.runtimeMode === 'source') {
@@ -1511,6 +1712,16 @@ export async function cmdStatus() {
                 console.log(`  Build ID: runtime=unavailable (daemon 未提供 build identity) dist=${computeBuildId(path.join(getPackageRoot(), 'dist')) ?? '?'}`);
                 console.log('  ⚠ 当前 daemon 未提供 build ID；请重启到包含 build identity 的版本后再判断源码行为。');
             }
+            if (!showLiveChannels(statusResponse)) {
+                const config = readStatusDefaultsConfig(p.defaultsConfig);
+                if (config) {
+                    console.log('🔌 Channels (live status unavailable; configuration is stale):');
+                    showConfigChannels(config);
+                }
+                else {
+                    console.log('🔌 Channels: live status unavailable');
+                }
+            }
             // 🔑 AUN AIDs 表格（详细 AUN 实例状态）
             try {
                 if (aidsResponse?.ok && aidsResponse.aids?.length > 0) {
@@ -1558,17 +1769,17 @@ export async function cmdStatus() {
     if (pid) {
         try {
             const agentResult = agentsResponse;
-            if (agentResult?.ok && agentResult.agents?.length > 0) {
+            if (agentResult?.ok && Array.isArray(agentResult.agents)) {
                 const agents = agentResult.agents;
-                if (agents.length > 0) {
-                    console.log('');
-                    console.log('🤖 EvolAgents:');
-                    for (const a of agents) {
-                        const statusIcon = a.status === 'running' ? '●' : a.status === 'error' ? '✗' : a.status === 'disabled' ? '○' : '◌';
-                        const channels = summarizeChannelFingerprints(a.channels || []);
-                        const shortName = a.name.replace(/\.agentid\.pub$/, '');
-                        console.log(`  ${statusIcon} ${shortName.padEnd(20)} ${a.status.padEnd(10)} ${channels}`);
-                    }
+                console.log('');
+                console.log('🤖 EvolAgents (live status):');
+                if (agents.length === 0)
+                    console.log('  (no agents loaded)');
+                for (const a of agents) {
+                    const statusIcon = a.status === 'running' ? '●' : a.status === 'error' ? '✗' : a.status === 'disabled' ? '○' : '◌';
+                    const channels = summarizeChannelFingerprints(a.channels || []);
+                    const shortName = a.name.replace(/\.agentid\.pub$/, '');
+                    console.log(`  ${statusIcon} ${shortName.padEnd(20)} ${a.status.padEnd(10)} ${channels}`);
                 }
             }
             else {
@@ -1578,7 +1789,18 @@ export async function cmdStatus() {
                 const agents = diskRegistry.list();
                 if (agents.length > 0) {
                     console.log('');
-                    console.log('🤖 EvolAgents (live status unavailable; stale configuration):');
+                    const detail = typeof agentResult?.error === 'string'
+                        ? agentResult.error
+                        : agentsQueryFailure instanceof Error ? agentsQueryFailure.message : 'IPC request failed';
+                    const running = Number.isFinite(liveAgentRuntime?.runningAgents) ? liveAgentRuntime.runningAgents : null;
+                    const runnable = Number.isFinite(liveAgentRuntime?.runnableAgents) ? liveAgentRuntime.runnableAgents : null;
+                    if (running !== null && runnable !== null) {
+                        console.log(`🤖 EvolAgents (live aggregate: ${running} running / ${runnable} runnable):`);
+                        console.log(`  Per-agent details unavailable (${detail}); following entries are stale configuration only:`);
+                    }
+                    else {
+                        console.log(`🤖 EvolAgents (live status unavailable: ${detail}; stale configuration):`);
+                    }
                     for (const a of agents) {
                         const diskStatus = a.status === 'disabled' || a.status === 'error' ? a.status : 'unknown';
                         const channels = summarizeChannelFingerprints(a.channels || []);
@@ -2965,7 +3187,7 @@ async function printEcwebStatus(p) {
     console.log('');
     if (aliveEntries.length > 0) {
         const visibleEntry = aliveEntries[0];
-        console.log(`🔭 ECWeb: 进程存活 (PID: ${visibleEntry.record.pid}) 但 HTTP 未就绪 (端口 ${visibleEntry.record.port})，查看 logs/watch-web.log`);
+        console.log(`🔭 ECWeb: 进程存活 (PID: ${visibleEntry.record.pid}) 但 HTTP 未就绪 (端口 ${visibleEntry.record.port})，查看 logs/ecweb-daemon.log`);
     }
     else if (occupiedPids.size > 0) {
         console.log(`🔭 ECWeb: 端口仍被未登记进程占用 (PID: ${[...occupiedPids].join(', ')})，请先执行 ec restart`);
@@ -2973,6 +3195,9 @@ async function printEcwebStatus(p) {
     else if (entries.length > 0) {
         console.log('🔭 ECWeb: instance 记录存在，但宿主 PID 不可见且 HTTP 未就绪');
     }
+    else if (externalUrl) {
+        console.log('🔭 ECWeb: 已启用但未运行，查看 logs/ecweb-daemon.log');
+    }
     else {
         console.log('🔭 ECWeb: 未运行');
     }

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/memory-command.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 }`；
@@ -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,6 +437,12 @@ 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 queryDaemon(socketPath, {
         type: 'memory.create', argv: ['memory', 'create', ...args], ...session, scope, slug, description: desc,
@@ -437,6 +451,9 @@ async function cmdMemoryCreate(args, json) {
         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,10 +464,11 @@ 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)
@@ -458,19 +476,20 @@ async function cmdMemoryConsolidatedUpdate(args, json) {
     const { socketPath, ...session } = requireManagedSession('ec memory update', flags, json);
     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 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;