evolcore 0.0.1 → 0.0.2

package/dist/cli/config.js

@@ -0,0 +1,261 @@
+import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
+import { initConfigManager } from '../config/config-manager.js';
+import { resolveConfigCommand } from '../config/resolved-config-op.js';
+import { AUTHENTICATED_CONFIG_ROLE_ENV, executeResolvedConfigCommand, } from '../config/config-operation-service.js';
+import { ipcQuery } from '../ipc.js';
+import { resolvePaths } from '../paths.js';
+import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
+import { splitConfigBatchGetArgv } from '../config/config-batch-get.js';
+function emit(formatJson, payload, text) {
+    if (formatJson)
+        console.log(JSON.stringify(payload, null, 2));
+    else
+        console.log(text());
+}
+function fail(formatJson, code, message, data) {
+    if (formatJson)
+        console.log(JSON.stringify({ ok: false, code, error: message, ...(data !== undefined ? { data } : {}) }, null, 2));
+    else
+        console.error(`Error: ${message} (${code})`);
+    process.exit(1);
+}
+function isAgentEnv() {
+    return !!process.env.EVOLCORE_SESSION_ID;
+}
+function getResultPayload(result) {
+    return {
+        ok: true,
+        field: result.field,
+        value: result.value,
+        scope: result.scope,
+        ...(result.source ? { source: result.source } : {}),
+        ...(result.schemaDefault ? { schemaDefault: true } : {}),
+        ...(result.note ? { note: result.note } : {}),
+    };
+}
+function getResultLine(result) {
+    const head = result.schemaDefault
+        ? `${result.field} = ${JSON.stringify(result.value)} [source: schema default]`
+        : !result.source
+            ? `${result.field} = ${JSON.stringify(result.value)} (${result.scope})`
+            : `${result.field} = ${JSON.stringify(result.value)} [source: ${result.source.target}]`;
+    return result.note ? `${head}\n  ↳ ${result.note}` : head;
+}
+function renderConfigExecution(result, formatJson) {
+    if (!result.ok)
+        fail(formatJson, result.code, result.error, result.data);
+    switch (result.subcommand) {
+        case 'get':
+            return emit(formatJson, getResultPayload(result), () => getResultLine(result));
+        case 'set':
+            return emit(formatJson, {
+                ok: true,
+                field: result.field,
+                value: result.value,
+                scope: result.scope,
+                file: result.file,
+            }, () => `Set ${result.field} = ${JSON.stringify(result.value)} [${result.scope}]`);
+        case 'unset':
+            return emit(formatJson, {
+                ok: true,
+                field: result.field,
+                removed: result.removed,
+                ...(result.removed ? { scope: result.scope } : {}),
+            }, () => result.removed ? `Removed ${result.field} from ${result.scope}` : `${result.field} was not set`);
+        case 'show':
+            return emit(formatJson, { ok: true, scope: result.scope, configs: result.configs }, () => JSON.stringify(result.configs, null, 2));
+        case 'effective':
+            return emit(formatJson, { ok: true, scope: result.scope, effective: result.effective }, () => JSON.stringify(result.effective, null, 2));
+        case 'fields':
+            return emit(formatJson, { ok: true, scope: result.scope, fields: result.fields }, () => result.fields.map(field => `${field.field} merge=${field.merge}`).join('\n'));
+        case 'validate':
+            return emit(formatJson, { ok: result.valid, results: result.results }, () => result.results.map(item => `${item.ok ? 'OK' : 'ERROR'} ${item.target}${item.error ? ` ${item.error}` : ''}`).join('\n'));
+        case 'init':
+            return emit(formatJson, { ok: true, scope: result.scope }, () => `Initialized ${result.scope} config`);
+        case 'list':
+            return emit(formatJson, { ok: true, files: result.files }, () => result.files.join('\n'));
+        case 'snapshot': {
+            const { subcommand: _subcommand, ...payload } = result;
+            return emit(formatJson, payload, () => result.created ? `Created snapshot ${result.version}` : `No snapshot created: ${result.reason}`);
+        }
+        case 'prune': {
+            const { subcommand: _subcommand, ...payload } = result;
+            return emit(formatJson, payload, () => result.dryRun
+                ? `[dry-run] would delete ${result.wouldDelete.join(', ')}`
+                : `Deleted ${result.deleted.join(', ')}`);
+        }
+        case 'history':
+            return emit(formatJson, { ok: true, versions: result.versions }, () => result.versions.map(version => `${version.version} ${version.type} ${version.createdAt}`).join('\n'));
+        case 'diff': {
+            const { subcommand: _subcommand, ...payload } = result;
+            return emit(formatJson, payload, () => [
+                ...result.added.map(file => `+ ${file}`),
+                ...result.modified.map(file => `~ ${file}`),
+                ...result.deleted.map(file => `- ${file}`),
+            ].join('\n'));
+        }
+        case 'restore':
+            return emit(formatJson, { ok: true, version: result.version, appliedFiles: result.appliedFiles }, () => `Restored ${result.version} (${result.appliedFiles} files)`);
+        case 'current':
+            return emit(formatJson, { ok: true, current: result.current, lastBoot: result.lastBoot }, () => result.current ? `Current version: ${result.current.delta} (full ${result.current.full})` : '(no current.json)');
+        case 'boots':
+            return emit(formatJson, { ok: true, boots: result.boots }, () => result.boots.map(boot => `${boot.bootedAt} ${boot.startMethod}`).join('\n'));
+        case 'schema': {
+            if (result.mode === 'overview') {
+                const pad = Math.max(0, ...result.schemas.map(s => s.name.length));
+                return emit(formatJson, { ok: true, schemas: result.schemas }, () => result.schemas.map(s => `${s.name.padEnd(pad)}  v${s.current}`).join('\n'));
+            }
+            if (result.mode === 'versions') {
+                return emit(formatJson, { ok: true, name: result.name, current: result.current, versions: result.versions }, () => result.versions.map(v => {
+                    const marker = v.current ? '*' : ' ';
+                    const meta = [v.date, v.description].filter(Boolean).join('  ');
+                    return `${marker} v${v.version}${meta ? `  ${meta}` : ''}${v.current ? '  (current)' : ''}`;
+                }).join('\n'));
+            }
+            return emit(formatJson, { ok: true, name: result.name, version: result.version, current: result.current, content: result.content }, () => JSON.stringify(result.content, null, 2));
+        }
+    }
+}
+function managedSession(formatJson) {
+    const sessionId = process.env.EVOLCORE_SESSION_ID;
+    if (!sessionId)
+        fail(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
+    const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+    if (!delegationToken) {
+        fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
+    }
+    return { sessionId, delegationToken };
+}
+async function managedConfigQuery(args, sessionId, delegationToken) {
+    try {
+        return await ipcQuery(resolvePaths().socket, {
+            type: 'config.op',
+            argv: ['config', ...args],
+            sessionId,
+            delegationToken,
+        }, 10_000);
+    }
+    catch {
+        return null;
+    }
+}
+async function runManagedConfig(args, formatJson) {
+    const { sessionId, delegationToken } = managedSession(formatJson);
+    const response = await managedConfigQuery(args, sessionId, delegationToken);
+    if (!response)
+        fail(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
+    if (!response.ok || !response.result) {
+        fail(formatJson, response.code || 'CONFIG_AUTH_FAILED', response.error || 'config operation failed', response.data);
+    }
+    renderConfigExecution(response.result, formatJson);
+}
+function renderBatchGet(results, formatJson) {
+    const allOk = results.every(entry => entry.ok);
+    if (formatJson) {
+        console.log(JSON.stringify({
+            ok: allOk,
+            results: results.map(entry => entry.ok
+                ? getResultPayload(entry)
+                : { ok: false, field: entry.field, code: entry.code, error: entry.error }),
+        }, null, 2));
+    }
+    else {
+        for (const entry of results) {
+            if (entry.ok)
+                console.log(getResultLine(entry));
+            else
+                console.error(`${entry.field}: Error: ${entry.error} (${entry.code})`);
+        }
+    }
+    if (!allOk)
+        process.exit(1);
+}
+function runDirectBatchGet(fields, rest, formatJson) {
+    const results = fields.map(field => {
+        const resolved = resolveConfigCommand(['config', 'get', field, ...rest]);
+        if (!resolved.ok)
+            return { ok: false, field, code: resolved.code, error: resolved.reason };
+        const result = executeResolvedConfigCommand(resolved.command);
+        if (!result.ok)
+            return { ok: false, field, code: result.code, error: result.error };
+        if (result.subcommand === 'get')
+            return result;
+        return { ok: false, field, code: 'UNEXPECTED_RESULT', error: `config get ${field} produced a non-get result` };
+    });
+    renderBatchGet(results, formatJson);
+}
+async function runManagedBatchGet(fields, rest, formatJson) {
+    const { sessionId, delegationToken } = managedSession(formatJson);
+    const results = [];
+    for (const field of fields) {
+        const response = await managedConfigQuery(['get', field, ...rest], sessionId, delegationToken);
+        if (!response) {
+            results.push({ ok: false, field, code: 'DAEMON_UNAVAILABLE', error: 'Unable to connect to the evolcore daemon' });
+        }
+        else if (!response.ok || !response.result || !response.result.ok) {
+            results.push({ ok: false, field, code: response.code || 'CONFIG_AUTH_FAILED', error: response.error || 'config operation failed' });
+        }
+        else if (response.result.subcommand === 'get') {
+            results.push(response.result);
+        }
+        else {
+            results.push({ ok: false, field, code: 'UNEXPECTED_RESULT', error: `config get ${field} produced a non-get result` });
+        }
+    }
+    renderBatchGet(results, formatJson);
+}
+const HELP = `Usage: ec config <command> [options]
+
+Fields:
+  get <field> [<field> ...]     one or more fields (batch)
+  set <field> <value>
+  unset <field>
+
+Scoped commands:
+  show | effective | fields [field] | validate | init
+
+Global commands:
+  list | snapshot | prune | history | diff | restore | current | boots
+  schema                        overview of all schemas
+  schema <name> [<version>]     view a schema definition
+  schema <name> --list          list a schema's versions
+
+Selectors:
+  --self <aid> [--peer <peerKey>] | --default | --process
+
+Output:
+  --format json`;
+export async function cmdConfig(args) {
+    const subcommand = args[0];
+    const formatJson = getArgValue(args, '--format') === 'json';
+    if (!subcommand || isHelpFlag(subcommand) || wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    // 批量 get：多个字段各自独立解析/鉴权/执行，聚合输出。单字段时行为与非批量完全一致。
+    const batchGet = subcommand === 'get' ? splitConfigBatchGetArgv(['config', ...args]) : null;
+    const isBatchGet = !!batchGet && batchGet.fields.length > 1;
+    if (isAgentEnv()) {
+        if (isBatchGet)
+            await runManagedBatchGet(batchGet.fields, batchGet.rest, formatJson);
+        else
+            await runManagedConfig(args, formatJson);
+        return;
+    }
+    try {
+        initConfigManager();
+    }
+    catch (error) {
+        fail(formatJson, 'SCHEMA_INIT_FAILED', error instanceof Error ? error.message : String(error));
+    }
+    if (isBatchGet) {
+        runDirectBatchGet(batchGet.fields, batchGet.rest, formatJson);
+        return;
+    }
+    const resolved = resolveConfigCommand(['config', ...args]);
+    if (!resolved.ok)
+        fail(formatJson, resolved.code, resolved.reason);
+    renderConfigExecution(executeResolvedConfigCommand(resolved.command, {
+        role: process.env[AUTHENTICATED_CONFIG_ROLE_ENV],
+    }), formatJson);
+}

package/dist/cli/ctl-command.js

@@ -0,0 +1,62 @@
+import { resolvePaths } from '../paths.js';
+import { ipcQuery } from '../ipc.js';
+import { isHelpFlag } from './help.js';
+import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
+// ==================== Ctl ====================
+const CTL_HELP = `用法: ec ctl <command> [args...]
+
+查询:
+  status                    查看会话状态
+  pwd                       显示当前项目路径
+  help                      显示帮助
+
+会话:
+  name <名称>               重命名当前会话
+
+消息:
+  send <消息内容>           主动发送文本消息（proactive 模式）
+  file [channel] <path>     发送项目内文件
+  queue                     查看/管理会话消息队列
+
+示例:
+  ec ctl status
+  ec ctl name "新会话名称"
+  ec ctl send "任务已完成"
+  ec ctl file report.md
+  ec ctl queue --full`;
+export async function cmdCtl(args) {
+    if (args.length === 0) {
+        console.error(CTL_HELP);
+        process.exit(1);
+    }
+    // help 不需要连接服务。
+    if (isHelpFlag(args[0])) {
+        console.log(CTL_HELP);
+        return;
+    }
+    const sessionId = process.env.EVOLCORE_SESSION_ID;
+    if (!sessionId) {
+        console.error('错误: EVOLCORE_SESSION_ID 未设置（仅在 evolcore 托管环境中可用）');
+        process.exit(1);
+    }
+    const cmd = '/' + args.join(' ');
+    const socketPath = resolvePaths().socket;
+    const result = await ipcQuery(socketPath, {
+        type: 'ctl',
+        cmd,
+        sessionId,
+        delegationToken: process.env[AGENT_DELEGATION_TOKEN_ENV],
+    }, 10_000);
+    if (!result) {
+        console.error('错误: 无法连接 evolcore 服务');
+        process.exit(1);
+    }
+    const ctlResult = result;
+    if (ctlResult.ok) {
+        console.log(ctlResult.result);
+    }
+    else {
+        console.error(ctlResult.error || '执行失败');
+        process.exit(1);
+    }
+}