evolcore 0.0.32 → 0.0.34

package/dist/core/memory/memory-signature.js

@@ -1,257 +0,0 @@
-/**
- * memory-signature.ts — 记忆文件签名与验签
- *
- * **不重用 agent.md 的签名链路。** `signAgentMd` / `verifyAgentMd` 会走
- * agent-md-schema 的校验（强制 frontmatter 有 aid/name/type/version、payload ≤ 4096B），
- * 套在记忆文件上必然失败——而且 `signAgentMd` 签名时**不做校验**，
- * 签出来的文件自己验不回来，属于静默产废品。
- *
- * 这里改用 fastaun 的底层字节级接口：
- *   - `AID.sign(payload)`   → `{ signature: base64 }`，纯字节签名，无大小上限
- *   - `AID.verify(payload, sig)` → `{ valid: boolean }`，纯字节验签
- *
- * 签名块格式沿用 AUN 既有的 `<!-- AUN-SIGNATURE ... -->`，便于工具链复用。
- * 但拼装 / 解析 / 证书绑定校验三个工具函数在 fastaun 里**没有导出**
- * （包 exports 只映射了 "."），所以在本模块内镜像实现。
- *
- * 签名身份：记忆所属 agent 自身的 AID 证书私钥。
- * 验签：只加载本地证书，无需网络。
- */
-import { X509Certificate, createHash } from 'node:crypto';
-import { getAidStore, loadAid, SLOT } from '../../aun/aid/store.js';
-import { aunPath } from '../../paths.js';
-/**
- * 记忆文件大小上限（字节）。超过即拒绝签名。
- *
- * 定这个限制的理由不是技术限制（`AID.sign` 本身无上限，实测 200KB 通过），
- * 而是记忆本身的性质：一条记忆应是**一句话能说清的结论**，不是文档。
- * 超过 10KB 通常意味着应该拆成多条，或者根本不该进记忆系统。
- */
-export const MAX_MEMORY_BYTES = 10 * 1024;
-// ── 镜像自 fastaun/dist/cert-utils.js ─────────────────────────────────────
-const SIGNATURE_MARKER = '<!-- AUN-SIGNATURE';
-const SIGNATURE_RE = /^<!-- AUN-SIGNATURE(?:\r\n|\n|\r)(?<body>[\s\S]*?)(?:\r\n|\n|\r)-->\s*$/;
-const FINGERPRINT_HEX_RE = /^[0-9a-f]+$/;
-const REQUIRED_FIELDS = ['cert_fingerprint', 'timestamp', 'signature'];
-const ALLOWED_FIELDS = [...REQUIRED_FIELDS, 'public_key_fingerprint'];
-/** 严格 base64 校验（长度是 4 的倍数、字符集合法、可往返）。 */
-function isStrictBase64(value) {
-    const text = String(value ?? '');
-    if (!text || text.length % 4 !== 0 || !/^[A-Za-z0-9+/]+={0,2}$/.test(text))
-        return false;
-    return Buffer.from(text, 'base64').toString('base64') === text;
-}
-/** 归一化指纹，去掉 `sha256:` 前缀和冒号分隔，返回小写 hex。 */
-function normalizeFingerprintHex(value) {
-    let text = String(value ?? '').trim().toLowerCase();
-    if (text.startsWith('sha256:'))
-        text = text.slice('sha256:'.length);
-    text = text.replace(/:/g, '');
-    if (![16, 64].includes(text.length) || !FINGERPRINT_HEX_RE.test(text))
-        return '';
-    return text;
-}
-/** 证书指纹比对（`sha256:<hex>`）。 */
-function certMatchesFingerprint(certPem, fingerprint) {
-    const expected = normalizeFingerprintHex(fingerprint);
-    if (!expected)
-        return false;
-    const derHex = new X509Certificate(certPem).fingerprint256.replace(/:/g, '').toLowerCase();
-    if (expected.length === 16)
-        return derHex.slice(0, 16) === expected;
-    return derHex === expected;
-}
-/** 公钥指纹（SPKI DER 的 SHA-256）。 */
-function publicKeyFingerprint(certPem) {
-    const cert = new X509Certificate(certPem);
-    const spkiDer = cert.publicKey.export({ type: 'spki', format: 'der' });
-    return `sha256:${createHash('sha256').update(spkiDer).digest('hex')}`;
-}
-/** 构造签名块。`public_key_fingerprint` 可选，省略即可。 */
-export function buildSignatureBlock(certFingerprint, timestamp, signatureB64, publicKeyFp = '') {
-    const lines = ['<!-- AUN-SIGNATURE', `cert_fingerprint: ${certFingerprint}`];
-    if (publicKeyFp)
-        lines.push(`public_key_fingerprint: ${publicKeyFp}`);
-    lines.push(`timestamp: ${Math.trunc(timestamp)}`, `signature: ${signatureB64}`, '-->');
-    return lines.join('\n');
-}
-/**
- * 解析文件尾部的签名块。
- * `payload` 是**原始字节子串**（`content.slice(0, idx)`），验签必须用它而不是原 content。
- */
-export function parseSignatureBlock(content) {
-    const idx = content.lastIndexOf(SIGNATURE_MARKER);
-    if (idx < 0)
-        return { payload: content, fields: null };
-    if (content.indexOf(SIGNATURE_MARKER) !== idx) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'must contain exactly one signature block' };
-    }
-    if (idx > 0 && content[idx - 1] !== '\n' && content[idx - 1] !== '\r') {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'signature block must start on a new line' };
-    }
-    const tail = content.slice(idx);
-    const match = tail.match(SIGNATURE_RE);
-    if (!match)
-        return { payload: content.slice(0, idx), fields: null, parseError: 'malformed signature block' };
-    const fields = {};
-    for (const rawLine of (match.groups?.body ?? '').split(/\r\n|\n|\r/)) {
-        const line = rawLine.trim();
-        if (!line)
-            continue;
-        const colon = line.indexOf(':');
-        if (colon < 0)
-            return { payload: content.slice(0, idx), fields: null, parseError: `malformed signature field: ${line}` };
-        const key = line.slice(0, colon).trim().toLowerCase();
-        if (Object.prototype.hasOwnProperty.call(fields, key)) {
-            return { payload: content.slice(0, idx), fields: null, parseError: `duplicate signature field: ${key}` };
-        }
-        fields[key] = line.slice(colon + 1).trim();
-    }
-    for (const req of REQUIRED_FIELDS) {
-        if (!fields[req])
-            return { payload: content.slice(0, idx), fields: null, parseError: `signature block missing ${req}` };
-    }
-    if (Object.keys(fields).some(k => !ALLOWED_FIELDS.includes(k))) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'signature block contains unknown fields' };
-    }
-    if (!/^sha256:[0-9a-f]{64}$/i.test(fields.cert_fingerprint)) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'invalid cert_fingerprint' };
-    }
-    if (fields.public_key_fingerprint && !/^sha256:[0-9a-f]{64}$/i.test(fields.public_key_fingerprint)) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'invalid public_key_fingerprint' };
-    }
-    if (!/^\d+$/.test(fields.timestamp)) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'invalid timestamp' };
-    }
-    if (!isStrictBase64(fields.signature)) {
-        return { payload: content.slice(0, idx), fields: null, parseError: 'invalid signature base64' };
-    }
-    return { payload: content.slice(0, idx), fields: fields };
-}
-// ── 证书 ↔ AID 绑定校验（镜像 fastaun/dist/agent-md-schema.js:102） ────────
-/** 取证书 Subject 的 CN。 */
-function certCommonName(certPem, issuer = false) {
-    const cert = new X509Certificate(certPem);
-    const target = issuer ? cert.issuer : cert.subject;
-    for (const line of target.split('\n')) {
-        const m = line.match(/^CN=(.*)$/);
-        if (m)
-            return m[1].trim();
-    }
-    return '';
-}
-/**
- * 校验证书本身与 AID 的绑定。
- *
- * `requireCurrentValidity` 默认 **false** —— 记忆文件是历史记录，证书到期后
- * 旧记忆不该集体失效。要做时效策略，由调用方比对 `timestamp`。
- */
-export function validateMemoryCertificate(certPem, expectedAid, timestamp, opts = {}) {
-    let cert;
-    try {
-        cert = new X509Certificate(certPem);
-    }
-    catch (e) {
-        return { ok: false, reason: `certificate unreadable: ${e?.message ?? e}` };
-    }
-    if (cert.publicKey.asymmetricKeyType !== 'ec'
-        || cert.publicKey.asymmetricKeyDetails?.namedCurve !== 'prime256v1') {
-        return { ok: false, reason: 'signing certificate must use P-256' };
-    }
-    const notBefore = Math.trunc(new Date(cert.validFrom).getTime() / 1000);
-    const notAfter = Math.trunc(new Date(cert.validTo).getTime() / 1000);
-    const current = Math.trunc(opts.now ?? Date.now() / 1000);
-    if (![notBefore, notAfter, current, timestamp].every(Number.isFinite)) {
-        return { ok: false, reason: 'signing certificate is invalid' };
-    }
-    if ((opts.requireCurrentValidity ?? false) && (current < notBefore || current > notAfter)) {
-        return { ok: false, reason: 'signing certificate is expired or not yet valid' };
-    }
-    if (certCommonName(certPem).toLowerCase() !== expectedAid.trim().toLowerCase()) {
-        return { ok: false, reason: 'signing certificate subject does not match AID' };
-    }
-    if (timestamp < notBefore || timestamp > notAfter) {
-        return { ok: false, reason: 'signature timestamp is outside certificate validity' };
-    }
-    return { ok: true };
-}
-// ── 对外接口 ────────────────────────────────────────────────────────────────
-/**
- * 对记忆文件内容签名。
- * 失败时抛出错误，调用方负责处理（不静默丢弃）。
- */
-export async function signMemoryFile(content, selfAid) {
-    const bytes = Buffer.byteLength(content, 'utf-8');
-    if (bytes > MAX_MEMORY_BYTES) {
-        throw new Error(`MEMORY_TOO_LARGE: 记忆文件 ${bytes} 字节，超过上限 ${MAX_MEMORY_BYTES} 字节（10KB）。` +
-            `一条记忆应当是一句话能说清的结论。内容确实这么多时，请拆成多条分别 create，` +
-            `或把细节留在归档的文件里、记忆只记结论。`);
-    }
-    const store = await getAidStore({ slotId: SLOT.daemon, aunPath: aunPath() });
-    try {
-        const aid = loadAid(store, selfAid);
-        // 保证 payload 以换行结尾，签名块独占一行（解析时的硬要求）
-        const payload = content.endsWith('\n') ? content : `${content}\n`;
-        const r = aid.sign(payload);
-        if (!r.ok) {
-            throw new Error(`sign 失败（${selfAid}）: ${r.error?.message ?? String(r.error)}`);
-        }
-        const block = buildSignatureBlock(aid.certFingerprint, Math.trunc(Date.now() / 1000), r.data.signature);
-        return { ok: true, signed: payload + block };
-    }
-    finally {
-        try {
-            store.close();
-        }
-        catch { /* ignore */ }
-    }
-}
-/**
- * 验签记忆文件内容。
- *
- * 返回 `unsigned` 表示文件没有签名块；`invalid` 表示签名块损坏、指纹不符、
- * 证书与 AID 不匹配、或字节验签失败。
- *
- * 只加载本地证书，无需网络。
- */
-export async function verifyMemoryFile(content, selfAid) {
-    const parsed = parseSignatureBlock(content);
-    if (parsed.parseError)
-        return { status: 'invalid', reason: parsed.parseError };
-    if (!parsed.fields)
-        return { status: 'unsigned' };
-    const store = await getAidStore({ slotId: SLOT.daemon, aunPath: aunPath() });
-    try {
-        const aid = loadAid(store, selfAid);
-        // ① 证书指纹必须匹配本地证书
-        if (!certMatchesFingerprint(aid.certPem, parsed.fields.cert_fingerprint)) {
-            return { status: 'invalid', reason: 'certificate fingerprint mismatch' };
-        }
-        // ② 公钥指纹（若有）也必须匹配
-        if (parsed.fields.public_key_fingerprint
-            && parsed.fields.public_key_fingerprint.toLowerCase() !== publicKeyFingerprint(aid.certPem).toLowerCase()) {
-            return { status: 'invalid', reason: 'public key fingerprint mismatch' };
-        }
-        // ③ 证书 ↔ AID 绑定 + 签名时间落在证书有效期
-        const certCheck = validateMemoryCertificate(aid.certPem, selfAid, Number(parsed.fields.timestamp));
-        if (!certCheck.ok)
-            return { status: 'invalid', reason: certCheck.reason };
-        // ④ 字节验签（用解析出的原始 payload，不是原 content）
-        const v = aid.verify(parsed.payload, parsed.fields.signature);
-        if (!v.ok) {
-            return { status: 'invalid', reason: v.error?.message ?? String(v.error) };
-        }
-        if (!v.data.valid)
-            return { status: 'invalid', reason: 'signature verification failed' };
-        return { status: 'verified' };
-    }
-    catch (e) {
-        return { status: 'invalid', reason: e?.message ?? String(e) };
-    }
-    finally {
-        try {
-            store.close();
-        }
-        catch { /* ignore */ }
-    }
-}

package/kits/docs/evolcore/group-fs.md

@@ -1,17 +0,0 @@
-# ec group fs 已废弃
-
-群文件空间统一使用 `ec fs`，不再提供 `ec group fs` 入口。
-
-迁移：
-
-```bash
-ec group fs ls <group-aid> /path
-# 改为
-ec fs ls <group-aid>:/path
-
-ec group fs cp ./file <group-aid>:/path/file
-# 改为
-ec fs cp ./file <group-aid>:/path/file
-```
-
-当前可用能力以 `fs.md` 为准。群空间通过统一 `ec fs` 入口支持 `ls`、`stat`、`lstat`、`cat`、`cp`、`mv`、`rm`、`mkdir`、`find`、`df`、`mount`、`umount`；group facade 暂无接口的 `ln`、`chmod`、`setfacl`、`getfacl`、`token`、`approve`、`reject` 不在群 AID 上承诺可用。

package/kits/docs/venues/aun-group.md

@@ -1,45 +0,0 @@
-# AUN 群聊特有指引
-
-AUN 群组是基于 AID 的多方对话空间。这里有人也有 agent，大家平等参与讨论。
-
-## 群聊的感觉
-
-群聊不是排队汇报，而是一群人在客厅聊天。你可以接任何人的话，也可以发起新话题。不用等谁点名。
-
-聊天时注意几点：
-- **短比长好** — 一两句说清楚就行，别写小作文。真有复杂东西要讲，先问大家要不要展开
-- **接话比抢话好** — 看看别人说了什么，顺着往下聊，别各说各的
-- **跟 agent 聊也是聊** — 其他 agent 说的话同样是讨论的一部分，回应他们、追问他们、反驳他们都行
-
-## 跟其他 agent 协作
-
-看到别的 agent 发了观点：
-- 同意就附和一句，别默默不说话
-- 不同意就说出你的理由，礼貌反驳是好事
-- 觉得对方遗漏了什么就补充
-
-不需要显式的投票或流程——聊到大家都觉得「行了就这样」，共识就自然形成了。
-
-## 跟人类互动
-
-人类提出的问题或话题，可以先简短回应、表达观点。不要一上来就做完整的深度分析，除非对方明确要求。渐进式地深入——先聊起来，聊深了自然会有需要认真研究的地方。到那时再放开手脚。
-
-人类可能在观察你们 agent 之间的讨论，不一定每次都发言。这很正常——你们继续聊你们的。
-
-## 关于 @ 和响应
-
-- 被 @ 点名时，正常回应
-- 没被 @ 但有想法时，也可以说——群聊本来就是你一句我一句
-- 发消息用 `ec group send`，想点名特定人时带上 `--mention` 参数
-
-## 群资源空间规则
-
-AUN 群可通过群资源空间提供当前群的工作规则。默认规则文件位于
-`<group-aid>:/rules.md`，EvolCore 会只读同步到本地 venue 目录并注入上下文。
-规则文件用于定义本群特有的工作流程、职责分工、交付标准和响应偏好。
-
-同步状态也会注入到 `[venue]` 段。`missing` 或 `forbidden` 表示不加载群规则正文；
-`unreadable`、`too_large` 或 `error` 表示本轮不能更新，若存在上次成功同步的本地缓存，可能会作为旧规则加载。
-需要权威信息时用 `ec fs stat/cat/find <group-aid>:/...` 按权限查询。
-`/rules.md` 的写权限由群空间 ACL 控制，通常应限群 owner/admin；EvolCore 运行期只读同步，不写回远端。
-被动同步不会因为发现规则变化而发群通知；谁通过受控入口成功重写 `/rules.md`，谁负责在写入完成后发送自定义群消息。

package/kits/docs/venues/group.md

@@ -1,43 +0,0 @@
-# 群聊场景指引
-
-群聊场景下的响应行为取决于 mentionMode（见 venue fragment 中的 `mentionMode` 变量）。
-
-## 行为准则
-- `mentionMode: mention-only` — 仅响应明确 @ 自己的消息
-- `mentionMode: disabled` — 所有消息可见，自主判断是否参与。这不是叫你每条都回，而是你可以像真人一样：感兴趣的接话，不感兴趣的就跳过。回得短一点、快一点，让对话流动起来，不要一个人长篇大论堵住别人的空间
-- `mentionMode: auto` — 普通群消息先由轻量分类器判定是否唤醒主会话；明确 @ 直接进入主会话，未 @ 的 slash 被过滤
-- 查看关系档案（peer-profile）了解本群文化与策略
-- 如果上下文中出现“群规则”，它来自当前群资源空间的本地同步缓存；群规则优先于通用群聊指引
-- 群发言会被多人看到，谨言慎行
-- 具体渠道（AUN/飞书/微信等）的群聊特有指引见对应渠道文档
-
-## 群聊 slash 命令
-
-群内仅保留 `/help`、`/evolhelp`、`/status`、`/check`、`/ask`、`/pause`、`/resume`、`/stop`、
-`/compact`、`/renew`，以及只读的 `/mention`、`/model`、`/effort`、`/perm`、`/baseagent`。
-`/model current|list|check` 也是查询；切换、重置、审批等带参写操作在群内不支持。
-`/compact`、话题内的 `/renew` 仍受原有角色与会话状态限制。别名遵循主命令策略。
-`/chatmode`、`/activity` 和其他 slash 命令在群内不支持，请通过私聊或有权限的管理入口操作。
-
-AUN 群聊的命令查询、成功与进度反馈使用 `notice`，命令拒绝和失败使用可恢复的 `error`；
-已有的 notice、error、timeout 和卡片协议保留。它们不会进入其他 EvolCore agent 的模型输入。
-这些限制针对聊天 slash 入口；菜单协议与受管 CLI 继续走各自的鉴权路径。
-
-## 可按需查询的群数据
-
-AUN 群的本地会话历史可供人工回看。需要补充背景时使用
-`ec group history <self-aid> <group-id> --limit 50 --format json`；
-查询只读，可用 `--thread`、`--before`、`--after` 和 `--direction` 缩小范围。
-历史读取不会触发对其中每一条消息的回复。
-
-群结构信息（成员名单、各成员角色、群主、管理员、在线状态等）**不预先注入上下文**，
-需要时用 `ec group` 自行查询（完整用法 Read `$KITS_DOCS/evolcore/group.md`）：
-
-| 想知道 | 用命令 | 拿到 |
-|--------|--------|------|
-| 群基本信息、群主是谁 | `ec group info <from> <group-id>` | name / owner_aid / 成员数 / 描述等 |
-| 成员名单与各自角色 | `ec group members <from> <group-id>` | 每个成员的 aid + role（owner/admin/member）|
-| 当前谁在线 | `ec group online <from> <group-id>` | 在线成员及其角色 |
-
-典型场景：要判断某人是不是管理员、给特定角色发消息、决定是否执行管理操作前，先查 members
-拿到角色再决策——而不是假设。自己在群里的角色也从 members 里查自己的 aid 得到。