evolcore 0.0.1 → 0.0.3

package/dist/cli/cli-argv.js

@@ -0,0 +1,66 @@
+export function normalizeCliArgv(argv) {
+    if (argv[0] === 'ec' && argv[1])
+        return argv.slice(1);
+    return argv;
+}
+export function validateCliArgv(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return { ok: false, reason: 'args.argv must be a non-empty string array' };
+    if (value.length > 64)
+        return { ok: false, reason: 'args.argv exceeds the 64 argument limit' };
+    if (value.some(arg => typeof arg !== 'string'))
+        return { ok: false, reason: 'args.argv entries must be strings' };
+    const argv = value;
+    if (argv.some(arg => arg.length > 4 * 1024))
+        return { ok: false, reason: 'args.argv entry exceeds 4096 characters' };
+    if (argv.some(arg => arg.includes('\0')))
+        return { ok: false, reason: 'args.argv entries must not contain NUL' };
+    if (argv.reduce((total, arg) => total + arg.length, 0) > 16 * 1024) {
+        return { ok: false, reason: 'args.argv exceeds the 16 KiB total limit' };
+    }
+    return { ok: true, argv };
+}
+export function parseLegacyCliCommand(command) {
+    const argv = [];
+    let current = '';
+    let quote = null;
+    let escaped = false;
+    for (const char of command) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (char === quote)
+                quote = null;
+            else
+                current += char;
+            continue;
+        }
+        if (char === "'" || char === '"') {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            if (current) {
+                argv.push(current);
+                current = '';
+            }
+            continue;
+        }
+        if ('|&;<>()$`'.includes(char)) {
+            return { ok: false, reason: 'args.command contains a forbidden shell operator' };
+        }
+        current += char;
+    }
+    if (escaped || quote)
+        return { ok: false, reason: 'args.command contains an incomplete escape or quote' };
+    if (current)
+        argv.push(current);
+    return validateCliArgv(argv);
+}

package/dist/cli/code-stats.js

@@ -0,0 +1,329 @@
+import fs from 'fs';
+import path from 'path';
+const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.mts', '.cts',
+    '.js', '.jsx', '.mjs', '.cjs',
+]);
+const SECTION_DEFINITIONS = [
+    { key: 'core', label: '核心模块' },
+    { key: 'agents', label: 'Agent 模块' },
+    { key: 'channels', label: '渠道适配' },
+    { key: 'utils', label: '工具库' },
+    { key: 'cli', label: 'CLI' },
+    { key: 'aun', label: 'AUN 协议' },
+    { key: 'trigger', label: 'Trigger 系统' },
+    { key: 'config', label: '配置系统' },
+    { key: 'stats', label: '统计系统' },
+    { key: 'eck', label: 'ECK' },
+    { key: 'response', label: '响应系统' },
+    { key: 'ecweb', label: 'ECWeb' },
+    { key: 'other', label: '其他源码目录' },
+    { key: 'entry', label: '根入口文件' },
+];
+const V2_SECTION_KEYS = [
+    'core', 'agents', 'channels', 'utils', 'cli', 'aun',
+    'subsystems', 'eck', 'response', 'other', 'entry', 'bin',
+];
+const V3_SECTION_KEYS = [
+    'core', 'agents', 'channels', 'utils', 'cli', 'aun',
+    'trigger', 'config', 'stats', 'eck', 'response', 'other', 'entry', 'bin',
+];
+const TOP_LEVEL_SECTION = {
+    core: 'core',
+    agents: 'agents',
+    channels: 'channels',
+    utils: 'utils',
+    cli: 'cli',
+    aun: 'aun',
+    trigger: 'trigger',
+    config: 'config',
+    stats: 'stats',
+    eck: 'eck',
+    'response-system': 'response',
+};
+const COMBINING_MARK_RE = /\p{Mark}/u;
+function isWideCodePoint(codePoint) {
+    return codePoint >= 0x1100 && (codePoint <= 0x115f
+        || codePoint === 0x2329
+        || codePoint === 0x232a
+        || (codePoint >= 0x2e80 && codePoint <= 0x303e)
+        || (codePoint >= 0x3040 && codePoint <= 0xa4cf && codePoint !== 0x303f)
+        || (codePoint >= 0xac00 && codePoint <= 0xd7a3)
+        || (codePoint >= 0xf900 && codePoint <= 0xfaff)
+        || (codePoint >= 0xfe10 && codePoint <= 0xfe19)
+        || (codePoint >= 0xfe30 && codePoint <= 0xfe6f)
+        || (codePoint >= 0xff00 && codePoint <= 0xff60)
+        || (codePoint >= 0xffe0 && codePoint <= 0xffe6)
+        || (codePoint >= 0x1b000 && codePoint <= 0x1b001)
+        || (codePoint >= 0x1f200 && codePoint <= 0x1f251)
+        || (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+function displayWidth(value) {
+    let width = 0;
+    for (const char of value) {
+        const codePoint = char.codePointAt(0);
+        if (codePoint === 0
+            || codePoint < 0x20
+            || (codePoint >= 0x7f && codePoint < 0xa0)
+            || codePoint === 0x200d
+            || (codePoint >= 0xfe00 && codePoint <= 0xfe0f)
+            || COMBINING_MARK_RE.test(char))
+            continue;
+        width += isWideCodePoint(codePoint) ? 2 : 1;
+    }
+    return width;
+}
+function padDisplayEnd(value, targetWidth) {
+    return value + ' '.repeat(Math.max(0, targetWidth - displayWidth(value)));
+}
+function isSourceFile(fileName) {
+    return SOURCE_EXTENSIONS.has(path.extname(fileName).toLowerCase());
+}
+function countFileLines(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    if (content.length === 0)
+        return 0;
+    const newlines = content.match(/\n/g)?.length ?? 0;
+    return newlines + (content.endsWith('\n') ? 0 : 1);
+}
+function walkSourceFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const files = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...walkSourceFiles(full));
+        }
+        else if (entry.isFile() && isSourceFile(entry.name)) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+function resolveSourceRoot(pkgRoot) {
+    const direct = path.join(pkgRoot, 'src');
+    if (fs.existsSync(direct))
+        return { packageDir: pkgRoot, sourceDir: direct };
+    const parent = path.resolve(pkgRoot, '..');
+    const sibling = path.join(parent, 'src');
+    if (fs.existsSync(sibling))
+        return { packageDir: parent, sourceDir: sibling };
+    return { packageDir: pkgRoot, sourceDir: direct };
+}
+/**
+ * Scan EvolCore and ECWeb source files. Classification happens after discovery,
+ * so a newly added main-package src directory or root source file is still
+ * included even when it has not been assigned a named section yet.
+ */
+export function collectCodeStats(pkgRoot) {
+    const { packageDir, sourceDir } = resolveSourceRoot(pkgRoot);
+    const sections = new Map(SECTION_DEFINITIONS.map(def => [def.key, { ...def, lines: 0, files: 0 }]));
+    const otherDirectories = new Set();
+    const scannedFiles = [];
+    for (const file of walkSourceFiles(sourceDir)) {
+        const relative = path.relative(sourceDir, file);
+        const parts = relative.split(path.sep);
+        let sectionKey;
+        if (parts.length === 1) {
+            sectionKey = 'entry';
+        }
+        else {
+            sectionKey = TOP_LEVEL_SECTION[parts[0]] ?? 'other';
+            if (sectionKey === 'other')
+                otherDirectories.add(parts[0]);
+        }
+        const section = sections.get(sectionKey);
+        section.lines += countFileLines(file);
+        section.files++;
+        scannedFiles.push(path.relative(packageDir, file));
+    }
+    const ecwebSourceDir = path.join(packageDir, 'ecweb', 'src');
+    for (const file of walkSourceFiles(ecwebSourceDir)) {
+        const section = sections.get('ecweb');
+        section.lines += countFileLines(file);
+        section.files++;
+        scannedFiles.push(path.relative(packageDir, file));
+    }
+    const sectionList = SECTION_DEFINITIONS.map(def => sections.get(def.key));
+    return {
+        sourceDir,
+        sections: sectionList,
+        totalLines: sectionList.reduce((sum, section) => sum + section.lines, 0),
+        totalFiles: sectionList.reduce((sum, section) => sum + section.files, 0),
+        scannedFiles: scannedFiles.sort(),
+        otherDirectories: [...otherDirectories].sort(),
+    };
+}
+function parseHistoryLine(line) {
+    const parts = line.split('\t');
+    const currentTotalIndex = SECTION_DEFINITIONS.length + 2;
+    if (parts[1] === 'v4' && parts.length >= currentTotalIndex + 3) {
+        const values = {};
+        SECTION_DEFINITIONS.forEach((def, index) => {
+            values[def.key] = Number.parseInt(parts[index + 2], 10) || 0;
+        });
+        return {
+            time: parts[0],
+            values,
+            total: Number.parseInt(parts[currentTotalIndex], 10) || 0,
+            files: Number.parseInt(parts[currentTotalIndex + 1], 10) || 0,
+            delta: parts[currentTotalIndex + 2],
+            version: 4,
+        };
+    }
+    if (parts[1] === 'v3' && parts.length >= 19) {
+        const values = {};
+        V3_SECTION_KEYS.forEach((key, index) => {
+            values[key] = Number.parseInt(parts[index + 2], 10) || 0;
+        });
+        return {
+            time: parts[0],
+            values,
+            total: Number.parseInt(parts[16], 10) || 0,
+            files: Number.parseInt(parts[17], 10) || 0,
+            delta: parts[18],
+            version: 3,
+        };
+    }
+    if (parts[1] === 'v2' && parts.length >= 17) {
+        const values = {};
+        V2_SECTION_KEYS.forEach((key, index) => {
+            values[key] = Number.parseInt(parts[index + 2], 10) || 0;
+        });
+        return {
+            time: parts[0],
+            values,
+            total: Number.parseInt(parts[14], 10) || 0,
+            files: Number.parseInt(parts[15], 10) || 0,
+            delta: parts[16],
+            version: 2,
+        };
+    }
+    // Legacy TSV formats, newest first:
+    // 11 columns: time core agents channels utils cli aun sys entry total delta
+    // 10 columns: time core agents channels utils cli aun entry total delta
+    // 8 columns:  time core agents channels utils entry total delta
+    // 7 columns:  time core agents channels utils entry total
+    // 6 columns:  time core channels utils entry total
+    const values = {};
+    let totalIndex;
+    let deltaIndex;
+    if (parts.length >= 11) {
+        [values.core, values.agents, values.channels, values.utils, values.cli, values.aun, values.subsystems, values.entry]
+            = [parts[1], parts[2], parts[3], parts[4], parts[5], parts[6], parts[7], parts[8]].map(Number);
+        totalIndex = 9;
+        deltaIndex = 10;
+    }
+    else if (parts.length >= 10) {
+        [values.core, values.agents, values.channels, values.utils, values.cli, values.aun, values.entry]
+            = [parts[1], parts[2], parts[3], parts[4], parts[5], parts[6], parts[7]].map(Number);
+        totalIndex = 8;
+        deltaIndex = 9;
+    }
+    else if (parts.length >= 8) {
+        [values.core, values.agents, values.channels, values.utils, values.entry]
+            = [parts[1], parts[2], parts[3], parts[4], parts[5]].map(Number);
+        totalIndex = 6;
+        deltaIndex = 7;
+    }
+    else if (parts.length >= 7) {
+        [values.core, values.agents, values.channels, values.utils, values.entry]
+            = [parts[1], parts[2], parts[3], parts[4], parts[5]].map(Number);
+        totalIndex = 6;
+    }
+    else if (parts.length >= 6) {
+        [values.core, values.channels, values.utils, values.entry]
+            = [parts[1], parts[2], parts[3], parts[4]].map(Number);
+        totalIndex = 5;
+    }
+    else {
+        return null;
+    }
+    const total = Number.parseInt(parts[totalIndex], 10);
+    if (!Number.isFinite(total))
+        return null;
+    return {
+        time: parts[0],
+        values,
+        total,
+        delta: deltaIndex === undefined ? undefined : parts[deltaIndex],
+        version: 1,
+    };
+}
+function historyRecords(statsFile) {
+    if (!fs.existsSync(statsFile))
+        return [];
+    return fs.readFileSync(statsFile, 'utf-8')
+        .split('\n')
+        .filter(Boolean)
+        .map(parseHistoryLine)
+        .filter((record) => record !== null);
+}
+function appendHistory(statsFile, stats, previous) {
+    const values = Object.fromEntries(stats.sections.map(section => [section.key, section.lines]));
+    const unchanged = previous?.version === 4
+        && previous.files === stats.totalFiles
+        && SECTION_DEFINITIONS.every(def => previous.values[def.key] === values[def.key]);
+    if (unchanged)
+        return;
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const timestamp = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
+    const delta = stats.totalLines - (previous?.total ?? 0);
+    const fields = [
+        timestamp,
+        'v4',
+        ...SECTION_DEFINITIONS.map(def => values[def.key]),
+        stats.totalLines,
+        stats.totalFiles,
+        delta >= 0 ? `+${delta}` : String(delta),
+    ];
+    fs.mkdirSync(path.dirname(statsFile), { recursive: true });
+    fs.appendFileSync(statsFile, `${fields.join('\t')}\n`);
+}
+function showHistory(records) {
+    if (records.length < 2)
+        return;
+    console.log('\n==================================================');
+    console.log('历史记录（最近 10 次）');
+    console.log('==================================================');
+    console.log(`${'Time'.padEnd(19)} ${'Files'.padStart(7)} ${'Total'.padStart(8)} ${'Delta'.padStart(8)}`);
+    console.log('--------------------------------------------------');
+    let previousTotal = null;
+    for (const record of records.slice(-10)) {
+        const inferredDelta = previousTotal === null ? '-' : record.total - previousTotal;
+        const delta = record.delta ?? (typeof inferredDelta === 'number' && inferredDelta >= 0 ? `+${inferredDelta}` : String(inferredDelta));
+        console.log(`${record.time.padEnd(19)} ${String(record.files ?? '-').padStart(7)} ${String(record.total).padStart(8)} ${delta.padStart(8)}`);
+        previousTotal = record.total;
+    }
+    console.log('==================================================');
+}
+export function printCodeStats(pkgRoot, logDir) {
+    console.log('\n[launcher] 正在统计代码行数...\n');
+    const stats = collectCodeStats(pkgRoot);
+    const statsFile = path.join(logDir, 'line-stats.log');
+    console.log('==================================================');
+    console.log('EvolCore 代码统计');
+    console.log('==================================================');
+    const rows = stats.sections
+        .filter(section => section.key !== 'other' || section.files > 0)
+        .map(section => {
+        const suffix = section.key === 'other' && stats.otherDirectories.length > 0
+            ? ` (${stats.otherDirectories.join(', ')})`
+            : '';
+        return { section, label: `${section.label}${suffix}:` };
+    });
+    const labelWidth = Math.max(24, ...rows.map(row => displayWidth(row.label)));
+    for (const { section, label } of rows) {
+        console.log(`${padDisplayEnd(label, labelWidth)} ${String(section.lines).padStart(8)} 行  ${String(section.files).padStart(4)} 文件`);
+    }
+    console.log('--------------------------------------------------');
+    console.log(`${padDisplayEnd('总计:', labelWidth)} ${String(stats.totalLines).padStart(8)} 行  ${String(stats.totalFiles).padStart(4)} 文件`);
+    console.log(`扫描范围: src + ecweb/src (${SOURCE_EXTENSIONS.size} 种源码扩展名)`);
+    console.log('==================================================');
+    const records = historyRecords(statsFile);
+    appendHistory(statsFile, stats, records.at(-1));
+    showHistory(historyRecords(statsFile));
+    return stats;
+}

package/dist/cli/command-log.js

@@ -0,0 +1,82 @@
+/**
+ * 命令集执行日志 —— 每执行一条 `ec` 命令追加一行 JSONL。日志按天切分（一天一个文件，
+ * 文件名 commands-YYYYMMDD.jsonl）。
+ *
+ * 挂在唯一 choke-point（src/cli/index.ts 的 main() 第一行），所有子命令必经，
+ * 无需改动任何具体命令集代码。
+ *
+ * 两级落盘：
+ *   - 汇总日志 $EVOLCORE_HOME/logs/commands-YYYYMMDD.jsonl：所有命令（不论有无 AID）都记
+ *     一份，一处看全貌；记录带 selfAid，按 agent 过滤一行 grep 即可。
+ *   - per-agent 日志 agents/<aid>/logs/commands-YYYYMMDD.jsonl：能同步解析出 self-AID 时
+ *     额外再记一份，便于单独查看某个 agent。
+ *
+ * 原则：日志写失败静默降级，绝不影响命令执行（沿用 log-writer.ts 的取舍）。
+ */
+import fs from 'fs';
+import path from 'path';
+import { agentLogsDir, resolvePaths } from '../paths.js';
+import { getArgValue } from './help.js';
+import { readTaskRuntimeContextFromEnv } from './task-context.js';
+/**
+ * 同步解析当前执行者 self-AID（零延迟，绝不走 IPC）。
+ * 优先级：--as <aid> > EVOLCORE_SELF_AID > runtime context 里的 selfAid。
+ */
+function resolveSelfAid(args) {
+    return (getArgValue(args, '--as') ||
+        process.env.EVOLCORE_SELF_AID ||
+        readTaskRuntimeContextFromEnv()?.selfAid);
+}
+/**
+ * 记录一条命令执行。同步、best-effort。
+ * @param cmd  子命令（args[0]，缺省时为 'start'）
+ * @param args 完整 argv 原样
+ */
+export function logCliCommand(cmd, args) {
+    const selfAid = resolveSelfAid(args);
+    const line = JSON.stringify({
+        ts: localTimestamp(),
+        cmd,
+        // 完整命令行，可直接拷贝执行（含 ec 前缀，含空格的参数自动加引号）
+        command: `ec ${args.map(shellQuote).join(' ')}`,
+        selfAid: selfAid || undefined,
+        sessionId: process.env.EVOLCORE_SESSION_ID || undefined,
+    }) + '\n';
+    const fileName = `commands-${dayTag()}.jsonl`;
+    // 汇总日志：所有命令（不论有无 AID）都记一份，一处看全貌。
+    appendLine(resolvePaths().logs, fileName, line);
+    // per-agent 日志：有 AID 时再额外记一份到该 agent 自己的 logs/，便于单独查看。
+    if (selfAid)
+        appendLine(agentLogsDir(selfAid), fileName, line);
+}
+/** 本地时间字符串 YYYY-MM-DD HH:mm:ss（不含时区偏移，直接可读）。 */
+function localTimestamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+        `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`);
+}
+/** 拼命令行时给单个参数按需加引号：含空格/引号/特殊字符才包一层单引号。 */
+function shellQuote(arg) {
+    if (arg === '')
+        return "''";
+    if (/^[A-Za-z0-9_@%+=:,./-]+$/.test(arg))
+        return arg;
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+/** 本地日期 tag YYYYMMDD，用于日志文件按天切分（一天一个文件）。 */
+function dayTag() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}`;
+}
+/** 追加一行到 <dir>/<fileName>，best-effort——写失败静默降级，绝不影响命令执行。 */
+function appendLine(dir, fileName, line) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.appendFileSync(path.join(dir, fileName), line);
+    }
+    catch {
+        // 日志不能影响业务
+    }
+}

package/dist/cli/config-selector.js

@@ -0,0 +1,69 @@
+import { normalizePeer, ModelScopeError } from '../core/model/config-scope.js';
+export function parseConfigSelector(args, options) {
+    let self;
+    let peerRaw;
+    let isDefault = false;
+    let isProcess = false;
+    const seen = new Set();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--self' || arg === '--peer') {
+            if (seen.has(arg))
+                return { ok: false, code: 'SELECTOR_CONFLICT', reason: `Duplicate selector: ${arg}` };
+            seen.add(arg);
+            const value = args[i + 1];
+            if (!value || value.startsWith('-')) {
+                return { ok: false, code: 'MISSING_FLAG_VALUE', reason: `${arg} requires a value` };
+            }
+            if (arg === '--self')
+                self = value;
+            else
+                peerRaw = value;
+            i += 1;
+            continue;
+        }
+        if (arg === '--default') {
+            if (seen.has('--default'))
+                return { ok: false, code: 'SELECTOR_CONFLICT', reason: 'Duplicate selector: --default' };
+            seen.add('--default');
+            isDefault = true;
+            continue;
+        }
+        if (arg === '--process' || arg === '--daemon') {
+            if (seen.has('--process'))
+                return { ok: false, code: 'SELECTOR_CONFLICT', reason: 'Duplicate process selector' };
+            seen.add('--process');
+            isProcess = true;
+        }
+    }
+    if (isProcess && (self || peerRaw !== undefined || isDefault)) {
+        return { ok: false, code: 'SELECTOR_CONFLICT', reason: '--process cannot be combined with --self/--peer/--default' };
+    }
+    if (isDefault && (self || peerRaw !== undefined)) {
+        return { ok: false, code: 'SELECTOR_CONFLICT', reason: '--default cannot be combined with --self/--peer' };
+    }
+    if (peerRaw !== undefined && !self) {
+        return { ok: false, code: 'PEER_WITHOUT_SELF', reason: '--peer requires --self' };
+    }
+    if (isProcess)
+        return { ok: true, scope: 'process' };
+    if (isDefault)
+        return { ok: true, scope: 'defaults' };
+    if (self) {
+        if (peerRaw !== undefined) {
+            try {
+                return { ok: true, scope: 'relation', self, peerKey: normalizePeer(peerRaw) };
+            }
+            catch (error) {
+                if (error instanceof ModelScopeError)
+                    return { ok: false, code: error.code, reason: error.message };
+                throw error;
+            }
+        }
+        return { ok: true, scope: 'agent', self };
+    }
+    if (options.requireSelector) {
+        return { ok: false, code: 'SELECTOR_REQUIRED', reason: 'A config selector is required' };
+    }
+    return { ok: true, scope: 'agent' };
+}