@bolloon/bolloon-agent 0.1.41 → 0.2.0

package/dist/electron/window.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMainWindow = getMainWindow;
+exports.createMainWindow = createMainWindow;
+exports.focusMainWindow = focusMainWindow;
+/**
+ * 主窗口工厂 — preload 路径解析 + dev/prod loadURL + 外部链接走系统浏览器
+ */
+const electron_1 = require("electron");
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const config_1 = require("./config");
+const server_1 = require("./server");
+let mainWindow = null;
+function getMainWindow() {
+    return mainWindow;
+}
+async function createMainWindow() {
+    (0, logger_1.log)('创建主窗口...');
+    mainWindow = new electron_1.BrowserWindow({
+        width: config_1.MAIN_WINDOW_DEFAULT.width,
+        height: config_1.MAIN_WINDOW_DEFAULT.height,
+        minWidth: config_1.MAIN_WINDOW_MIN.width,
+        minHeight: config_1.MAIN_WINDOW_MIN.height,
+        title: 'Bolloon Agent',
+        webPreferences: {
+            nodeIntegration: false,
+            contextIsolation: true,
+            sandbox: false, // MCP/spawn 等需要 fs; 真正的隔离靠 preload 边界
+            preload: path.join(__dirname, '..', 'electron-preload.js'),
+        },
+        show: false,
+    });
+    if (config_1.isDev) {
+        // dev:web 用 tsx 起 server, 端口固定 preferredPort, 不会 EADDRINUSE 自增
+        const port = (0, config_1.preferredPort)();
+        mainWindow.loadURL(`http://localhost:${port}`);
+        mainWindow.webContents.openDevTools();
+    }
+    else {
+        try {
+            (0, logger_1.log)('启动内置 Web 服务器...');
+            const { port: actualPort } = await (0, server_1.startWebServer)((0, config_1.preferredPort)());
+            mainWindow.loadURL(`http://localhost:${actualPort}`);
+        }
+        catch (err) {
+            (0, logger_1.log)(`启动服务器失败: ${err.message}`, 'error');
+            console.error('启动服务器失败:', err);
+        }
+    }
+    mainWindow.once('ready-to-show', () => {
+        mainWindow?.show();
+        (0, logger_1.log)('窗口已显示');
+    });
+    // 外部链接走系统浏览器, 不在 app 内开新窗口
+    mainWindow.webContents.setWindowOpenHandler(({ url }) => {
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            electron_1.shell.openExternal(url);
+        }
+        return { action: 'deny' };
+    });
+    mainWindow.on('closed', () => {
+        mainWindow = null;
+    });
+    (0, logger_1.log)('窗口创建完成');
+}
+function focusMainWindow() {
+    if (!mainWindow)
+        return;
+    if (mainWindow.isMinimized())
+        mainWindow.restore();
+    mainWindow.show();
+    mainWindow.focus();
+}
+//# sourceMappingURL=window.js.map

package/dist/git-transport/chat-render.js

@@ -0,0 +1,155 @@
+// src/git-transport/chat-render.ts
+// 解析 markdown 消息文件 + 去重 key + 列表/过滤, 纯函数, 不碰 git.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { CHAT_PROTOCOL_VERSION } from './chat-types.js';
+function tryRead(p) {
+    try {
+        return fs.readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+// 极简 frontmatter 解析: 不引 gray-matter 这种依赖
+// 约定: 文件首行是 "---", 之后是 YAML-like 块 (key: value), 直到下一个 "---"
+// 字段值只支持 string / number / 嵌套对象字面量; 对我们够用
+function parseFrontmatter(raw) {
+    if (!raw.startsWith('---'))
+        return { fm: null, body: raw };
+    const lines = raw.split(/\r?\n/);
+    let end = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            end = i;
+            break;
+        }
+    }
+    if (end === -1)
+        return { fm: null, body: raw };
+    const headerLines = lines.slice(1, end);
+    const body = lines.slice(end + 1).join('\n').replace(/^\n+/, '');
+    const fm = { v: CHAT_PROTOCOL_VERSION };
+    let i = 0;
+    while (i < headerLines.length) {
+        const line = headerLines[i];
+        if (!line.trim() || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const m = /^([A-Za-z_][\w]*)\s*:\s*(.*)$/.exec(line);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const key = m[1];
+        let val = m[2].trim();
+        if (val === '') {
+            // 嵌套对象 — 收集到下一个顶级 key 之前
+            const obj = {};
+            i++;
+            while (i < headerLines.length) {
+                const l2 = headerLines[i];
+                if (/^[A-Za-z_][\w]*\s*:/.test(l2))
+                    break;
+                const m2 = /^(\s+)([A-Za-z_][\w]*)\s*:\s*(.*)$/.exec(l2);
+                if (m2) {
+                    obj[m2[2]] = stripQuotes(m2[3].trim());
+                }
+                i++;
+            }
+            val = obj;
+        }
+        else {
+            val = stripQuotes(val);
+            // 数字字面量尽量 parse 成 number, 让 fm.v 严格比较能过
+            if (/^-?\d+(\.\d+)?$/.test(val)) {
+                const n = Number(val);
+                if (!Number.isNaN(n))
+                    val = n;
+            }
+            i++;
+        }
+        fm[key] = val;
+    }
+    // 强校验
+    if (typeof fm.from !== 'string' || typeof fm.fromPk !== 'string' || typeof fm.ts !== 'string') {
+        return { fm: null, body: raw };
+    }
+    if (fm.v !== CHAT_PROTOCOL_VERSION) {
+        return { fm: null, body: raw };
+    }
+    return { fm: fm, body };
+}
+function stripQuotes(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+export function parseMessageFile(filePath, sha) {
+    const raw = tryRead(filePath);
+    if (raw === null)
+        return null;
+    const { fm, body } = parseFrontmatter(raw);
+    if (!fm)
+        return null;
+    return { filePath, frontmatter: fm, body, sha };
+}
+// 列出 .comm/<role>/*.md 下所有消息文件 (角色目录是按字母扫的, 不依赖 git)
+export function listMessageFiles(repoDir) {
+    const comm = path.join(repoDir, '.comm');
+    let entries = [];
+    try {
+        entries = fs.readdirSync(comm, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        if (e.name.startsWith('_'))
+            continue; // _state / _inbox 跳过
+        const roleDir = path.join(comm, e.name);
+        let files = [];
+        try {
+            files = fs.readdirSync(roleDir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith('.md'))
+                continue;
+            out.push(path.join(roleDir, f));
+        }
+    }
+    return out;
+}
+export function listMessages(repoDir, withRole, limit) {
+    const files = listMessageFiles(repoDir);
+    const out = [];
+    for (const f of files) {
+        if (withRole && !f.includes(`${path.sep}.comm${path.sep}${withRole}${path.sep}`))
+            continue;
+        const msg = parseMessageFile(f, '');
+        if (msg)
+            out.push(msg);
+    }
+    out.sort((a, b) => a.frontmatter.ts.localeCompare(b.frontmatter.ts));
+    return typeof limit === 'number' ? out.slice(-limit) : out;
+}
+// 去重 key: (fromPk, ts, contentHash8) — 不论 P2P 还是 git 谁先到都收敛到同一键
+export function dedupeKey(msg) {
+    const h = crypto.createHash('sha256').update(msg.body).digest('hex').slice(0, 8);
+    return `${msg.frontmatter.fromPk}:${msg.frontmatter.ts}:${h}`;
+}
+// 单行展示 — 给 chat-list / chat-watch 输出用
+export function renderOneLine(msg) {
+    const time = msg.frontmatter.ts.replace('T', ' ').replace(/\.\d+Z$/, 'Z').replace('Z', '');
+    const preview = msg.body.split('\n')[0].slice(0, 80);
+    return `[${time} ${msg.frontmatter.from}] ${preview}`;
+}

package/dist/git-transport/chat-repo.js

@@ -0,0 +1,370 @@
+// src/git-transport/chat-repo.ts
+// 负责 .comm/ 目录初始化、消息写盘、commit/pull/push、状态持久化.
+// 全部用 child_process.spawn('git', ...) — 不引 simple-git / nodegit.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { spawn } from 'child_process';
+import { chatPaths, CHAT_PROTOCOL_VERSION, CHAT_BODY_MAX_BYTES, COMMIT_MESSAGE_MAX, CHAT_P2P_NOTIFY_THRESHOLD, } from './chat-types.js';
+import { parseMessageFile, dedupeKey, listMessageFiles } from './chat-render.js';
+// ---------- helpers ----------
+function runGit(args, opts) {
+    return new Promise((resolve) => {
+        const child = spawn('git', args, { cwd: opts.cwd, env: { ...process.env, GIT_TERMINAL_PROMPT: '0' } });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { }
+            resolve({ stdout, stderr: stderr + '\n[killed: timeout]', code: 124 });
+        }, opts.timeoutMs ?? 30_000);
+        child.stdout.on('data', (d) => { stdout += d.toString(); });
+        child.stderr.on('data', (d) => { stderr += d.toString(); });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr, code: code ?? 1 });
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr: stderr + '\n' + err.message, code: 127 });
+        });
+    });
+}
+async function mkdirp(p) {
+    await fs.promises.mkdir(p, { recursive: true });
+}
+// 原子获取 lock — 用 mkdir 互斥, 失败重试最多 30s
+async function acquireLock(lockPath, timeoutMs = 30_000) {
+    const start = Date.now();
+    while (true) {
+        try {
+            await fs.promises.mkdir(lockPath);
+            break;
+        }
+        catch (e) {
+            if (e.code !== 'EEXIST')
+                throw e;
+            // 锁超过 60s 视为僵尸, 强行清掉
+            try {
+                const st = await fs.promises.stat(lockPath);
+                if (Date.now() - st.mtimeMs > 60_000) {
+                    await fs.promises.rmdir(lockPath).catch(() => { });
+                }
+            }
+            catch { }
+            if (Date.now() - start > timeoutMs) {
+                throw new Error(`acquire git lock timeout: ${lockPath}`);
+            }
+            await new Promise((r) => setTimeout(r, 200));
+        }
+    }
+    return async () => {
+        try {
+            await fs.promises.rmdir(lockPath);
+        }
+        catch { }
+    };
+}
+function readJsonSafe(p, fallback) {
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+async function writeJsonSafe(p, v) {
+    await fs.promises.mkdir(path.dirname(p), { recursive: true });
+    await fs.promises.writeFile(p, JSON.stringify(v, null, 2) + '\n', 'utf8');
+}
+// ---------- identity ----------
+import { loadOrCreateKeyPair } from '../network/p2p-secret.js';
+export async function resolveIdentity(roleOverride) {
+    const role = roleOverride || process.env.BOLLOON_ROLE || process.env.IROH_ROLE || 'default';
+    // loadOrCreateKeyPair 读 ~/.bolloon/p2p-direct-secret-{role}.json
+    const kp = await loadOrCreateKeyPair(role);
+    // 关键: 让 git author 反映 Ed25519 公钥, 这样 git log 一眼能认出"谁写的"
+    return {
+        role,
+        publicKey: kp.publicKey,
+        name: role,
+        email: `${kp.publicKey.slice(0, 12)}@bolloon.local`,
+    };
+}
+export async function chatInit(repoDir, opts = {}) {
+    const id = await resolveIdentity(opts.roleOverride);
+    const paths = chatPaths(repoDir);
+    await mkdirp(path.join(paths.root, id.role));
+    await mkdirp(paths.stateDir);
+    await mkdirp(paths.inboxDir);
+    // README.md
+    const readme = [
+        '# .comm/ — 跨机聊天收件箱',
+        '',
+        'Bolloon chat transport: commits-as-messages.',
+        '每条消息 = 一个 markdown 文件 + 一次 git commit + push.',
+        '',
+        '## 目录约定',
+        '',
+        '- `<role>/` — 每个 role 一个子目录, 里面是该角色发的所有消息',
+        '- `_state/` — 本地运行态 (cursor, seen, lock), 不 commit',
+        '- `_inbox/` — 看门狗把对方消息反写到本地, 不 commit',
+        '',
+        '## 子命令',
+        '',
+        '```',
+        'bolloon --chat-init',
+        'bolloon --chat-send "..."',
+        'bolloon --chat-pull',
+        'bolloon --chat-list',
+        'bolloon --chat-watch',
+        'bolloon --chat-status',
+        '```',
+        '',
+    ].join('\n');
+    await fs.promises.writeFile(paths.readmeFile, readme, 'utf8');
+    // REMOTE 文件
+    if (opts.remote) {
+        await fs.promises.writeFile(paths.remoteFile, opts.remote.trim() + '\n', 'utf8');
+    }
+    // 探测 remote / branch
+    const remote = opts.remote || (await runGit(['remote', 'get-url', 'origin'], { cwd: repoDir })).stdout.trim() || undefined;
+    const branch = opts.branch || (await runGit(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repoDir })).stdout.trim() || 'master';
+    // 配 git user.name/user.email
+    await runGit(['config', 'user.name', id.name], { cwd: repoDir });
+    await runGit(['config', 'user.email', id.email], { cwd: repoDir });
+    // 首次 rebase
+    const pull = await runGit(['pull', '--rebase', '--autostash'], { cwd: repoDir });
+    // 把 README + REMOTE 第一次 commit 上去 (若有变更)
+    await runGit(['add', '.comm/README.md'], { cwd: repoDir });
+    if (fs.existsSync(paths.remoteFile)) {
+        await runGit(['add', '.comm/REMOTE'], { cwd: repoDir });
+    }
+    const diff = await runGit(['diff', '--cached', '--name-only'], { cwd: repoDir });
+    const messages = [];
+    if (diff.stdout.trim()) {
+        const msg = `[chat-init] role=${id.role} pk=${id.publicKey.slice(0, 12)}`;
+        const commit = await runGit(['commit', '-m', msg], { cwd: repoDir });
+        if (commit.code === 0) {
+            messages.push(`created initial commit: ${msg}`);
+            if (remote) {
+                const push = await runGit(['push', remote, branch], { cwd: repoDir });
+                if (push.code === 0)
+                    messages.push(`pushed to ${remote}/${branch}`);
+                else
+                    messages.push(`push failed (will retry on next chat-send): ${push.stderr.trim().split('\n').slice(-1)[0]}`);
+            }
+            else {
+                messages.push('no remote configured, will only commit locally');
+            }
+        }
+    }
+    else {
+        messages.push('.comm/ already initialized, no changes');
+    }
+    return {
+        ok: true,
+        role: id.role,
+        publicKey: id.publicKey,
+        remote,
+        branch,
+        messages: [
+            `role: ${id.role}`,
+            `publicKey: ${id.publicKey.slice(0, 16)}...`,
+            ...(remote ? [`remote: ${remote}`] : []),
+            ...(branch ? [`branch: ${branch}`] : []),
+            ...messages,
+            ...(pull.code !== 0 ? [`pull warning: ${pull.stderr.trim().split('\n').slice(-1)[0] || 'unknown'}`] : []),
+        ],
+    };
+}
+function sanitizeRoleName(role) {
+    // 文件名只允许 [A-Za-z0-9._-]
+    return role.replace(/[^A-Za-z0-9._-]/g, '_');
+}
+function buildMessageFile(frontmatter, body) {
+    const lines = ['---'];
+    lines.push(`v: ${frontmatter.v}`);
+    lines.push(`from: ${frontmatter.from}`);
+    lines.push(`fromPk: ${frontmatter.fromPk}`);
+    if (frontmatter.to)
+        lines.push(`to: ${frontmatter.to}`);
+    lines.push(`ts: ${frontmatter.ts}`);
+    if (frontmatter.p2pRef)
+        lines.push(`p2pRef: ${frontmatter.p2pRef}`);
+    if (frontmatter.git?.sha) {
+        lines.push('git:');
+        if (frontmatter.git.branch)
+            lines.push(`  branch: ${frontmatter.git.branch}`);
+        if (frontmatter.git.sha)
+            lines.push(`  sha: ${frontmatter.git.sha}`);
+    }
+    lines.push('---');
+    lines.push('');
+    return lines.join('\n') + body.trimEnd() + '\n';
+}
+export async function chatSend(opts) {
+    const { repoDir, body } = opts;
+    if (!body || !body.trim())
+        return { ok: false, reason: 'empty body', p2pNotifyEligible: false, filePath: '' };
+    if (Buffer.byteLength(body, 'utf8') > CHAT_BODY_MAX_BYTES) {
+        return { ok: false, reason: `body too large (${Buffer.byteLength(body, 'utf8')} > ${CHAT_BODY_MAX_BYTES})`, p2pNotifyEligible: false, filePath: '' };
+    }
+    const id = await resolveIdentity(opts.roleOverride);
+    const paths = chatPaths(repoDir);
+    await mkdirp(path.join(paths.root, id.role));
+    await mkdirp(paths.stateDir);
+    const ts = new Date().toISOString();
+    const shortHash = crypto.createHash('sha256').update(`${id.publicKey}|${ts}|${body}`).digest('hex').slice(0, 8);
+    const safeTs = ts.replace(/[:.]/g, '-');
+    const filename = `${safeTs}-${shortHash}.md`;
+    const relPath = path.join('.comm', sanitizeRoleName(id.role), filename);
+    const fm = {
+        v: CHAT_PROTOCOL_VERSION,
+        from: id.role,
+        fromPk: id.publicKey,
+        to: opts.to,
+        ts,
+    };
+    const content = buildMessageFile(fm, body);
+    const release = await acquireLock(paths.lockFile);
+    try {
+        // 1) 写盘
+        await fs.promises.writeFile(path.join(repoDir, relPath), content, 'utf8');
+        // 2) git add (限定 .comm/<self>/, 避免把别人未 push 的修改带进来)
+        await runGit(['add', '--', relPath], { cwd: repoDir });
+        // 3) commit
+        const commitMsg = `chat(${id.role}): ${body.split('\n')[0].slice(0, 60)}`.slice(0, COMMIT_MESSAGE_MAX);
+        const commit = await runGit(['commit', '-m', commitMsg], { cwd: repoDir });
+        if (commit.code !== 0) {
+            return { ok: false, reason: `git commit failed: ${commit.stderr.trim()}`, p2pNotifyEligible: false, filePath: relPath };
+        }
+        const shaLine = (await runGit(['rev-parse', 'HEAD'], { cwd: repoDir })).stdout.trim();
+        // 4) rebase + push (失败不回滚 commit, 让本地 commit 留下, 下次 send 重试 push)
+        await runGit(['pull', '--rebase', '--autostash'], { cwd: repoDir });
+        let pushed = false;
+        const push = await runGit(['push'], { cwd: repoDir });
+        if (push.code === 0)
+            pushed = true;
+        // 5) 自己的 cursor 推进
+        await writeJsonSafe(paths.cursorFile, { lastHead: shaLine, lastSelfTs: ts, role: id.role });
+        return {
+            ok: true,
+            sha: shaLine,
+            pushed,
+            p2pNotifyEligible: Buffer.byteLength(body, 'utf8') <= CHAT_P2P_NOTIFY_THRESHOLD,
+            filePath: relPath,
+        };
+    }
+    finally {
+        await release();
+    }
+}
+export async function chatPull(opts) {
+    const { repoDir } = opts;
+    const paths = chatPaths(repoDir);
+    await mkdirp(paths.stateDir);
+    const fetch = await runGit(['fetch', '--all', '--prune'], { cwd: repoDir });
+    if (fetch.code !== 0) {
+        return { ok: false, newCommits: 0, newMessages: [], reason: `git fetch failed: ${fetch.stderr.trim().split('\n').slice(-1)[0]}` };
+    }
+    const rebase = await runGit(['pull', '--rebase', '--autostash'], { cwd: repoDir });
+    // 收集新增消息: 对比 rev-list HEAD~ <self-cursor-sha>..HEAD 的 .comm/* 变更
+    const cursor = readJsonSafe(paths.cursorFile, {});
+    let range = 'HEAD';
+    if (cursor.lastHead) {
+        range = `${cursor.lastHead}..HEAD`;
+    }
+    const rev = await runGit(['rev-list', range, '--', '.comm'], { cwd: repoDir });
+    if (rev.code !== 0) {
+        return { ok: false, newCommits: 0, newMessages: [], reason: `rev-list failed: ${rev.stderr.trim()}` };
+    }
+    const shas = rev.stdout.split('\n').map((s) => s.trim()).filter(Boolean);
+    const newMessages = [];
+    const seen = readJsonSafe(paths.seenFile, {});
+    const id = await resolveIdentity(opts.roleOverride);
+    for (const sha of shas) {
+        const show = await runGit(['show', '--name-only', '--pretty=format:', sha, '--', '.comm'], { cwd: repoDir });
+        const fileLines = show.stdout.split('\n').map((s) => s.trim()).filter(Boolean);
+        for (const f of fileLines) {
+            if (!f.endsWith('.md'))
+                continue;
+            if (f.includes(`${path.sep}_state${path.sep}`) || f.includes(`${path.sep}_inbox${path.sep}`))
+                continue;
+            const abs = path.isAbsolute(f) ? f : path.join(repoDir, f);
+            const msg = parseMessageFile(abs, sha);
+            if (!msg)
+                continue;
+            // 不是自己发的: 收
+            if (msg.frontmatter.fromPk !== id.publicKey) {
+                const key = dedupeKey(msg);
+                if (!seen[key]) {
+                    newMessages.push(msg);
+                    seen[key] = Date.now();
+                }
+                // 关键: 每个对方消息都顺手 addOrUpdatePeer (幂等), 让 web 模式 5s 后自动 joinPeer 直连
+                // 即使消息之前见过, 也值得刷一次"lastConnectedAt"语义
+                try {
+                    const { addOrUpdatePeer } = await import('../network/known-peers.js');
+                    const name = msg.frontmatter.from || `peer-${msg.frontmatter.fromPk.slice(0, 8)}`;
+                    addOrUpdatePeer(name, msg.frontmatter.fromPk, `auto from chat ${sha.slice(0, 8)}`);
+                }
+                catch {
+                    // known-peers import / 写盘失败 — 不影响消息收集
+                }
+            }
+        }
+    }
+    await writeJsonSafe(paths.seenFile, seen);
+    // 推进 cursor
+    const head = (await runGit(['rev-parse', 'HEAD'], { cwd: repoDir })).stdout.trim();
+    await writeJsonSafe(paths.cursorFile, { ...cursor, lastHead: head });
+    return { ok: true, newCommits: shas.length, newMessages };
+}
+export async function chatStatus(opts) {
+    const { repoDir } = opts;
+    const id = await resolveIdentity(opts.roleOverride);
+    const remote = (await runGit(['remote', 'get-url', 'origin'], { cwd: repoDir })).stdout.trim() || undefined;
+    const branch = (await runGit(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repoDir })).stdout.trim() || undefined;
+    const head = (await runGit(['rev-parse', 'HEAD'], { cwd: repoDir })).stdout.trim() || undefined;
+    let ahead;
+    let behind;
+    if (remote && branch) {
+        const rev = await runGit(['rev-list', '--left-right', '--count', `${branch}...${remote}/${branch}`], { cwd: repoDir });
+        if (rev.code === 0) {
+            const [a, b] = rev.stdout.trim().split(/\s+/).map((n) => parseInt(n, 10));
+            ahead = a;
+            behind = b;
+        }
+    }
+    const files = listMessageFilesLocal(repoDir);
+    const byRole = {};
+    for (const f of files) {
+        const m = /[\\/].comm[\\/]([^\\/]+)[\\/]/.exec(f);
+        const role = m ? m[1] : '?';
+        byRole[role] = (byRole[role] || 0) + 1;
+    }
+    let mode = 'synced';
+    if (!remote)
+        mode = 'no-remote';
+    else if (ahead && ahead > 0)
+        mode = 'local-only';
+    return {
+        role: id.role,
+        publicKey: id.publicKey,
+        repoDir,
+        remote,
+        branch,
+        head: head ? head.slice(0, 12) : undefined,
+        ahead,
+        behind,
+        mode,
+        fileCount: files.length,
+        byRole,
+    };
+}
+function listMessageFilesLocal(repoDir) {
+    return listMessageFiles(repoDir);
+}

package/dist/git-transport/chat-types.js

@@ -0,0 +1,23 @@
+// src/git-transport/chat-types.ts
+// 共享类型与常量 — 不依赖任何运行时副作用,可在 import 链路最底层使用.
+import * as path from 'path';
+export const CHAT_PROTOCOL_VERSION = 1;
+export const CHAT_BODY_MAX_BYTES = 256 * 1024; // 256 KiB 单条上限
+export const COMMIT_MESSAGE_MAX = 8192; // git commit message 自身 8 KiB 上限
+export const CHAT_P2P_NOTIFY_THRESHOLD = 4 * 1024; // > 4 KiB 只走 git, 不发 P2P notify
+export const CHAT_DEFAULT_PULL_INTERVAL_MS = 15_000;
+export const CHAT_PULL_BACKOFF_MAX_MS = 5 * 60_000;
+export function chatPaths(repoDir) {
+    const root = path.join(repoDir, '.comm');
+    return {
+        root,
+        stateDir: path.join(root, '_state'),
+        inboxDir: path.join(root, '_inbox'),
+        cursorFile: path.join(root, '_state', 'cursor'),
+        p2pStatusFile: path.join(root, '_state', 'p2p-status.json'),
+        seenFile: path.join(root, '_state', 'seen.json'),
+        lockFile: path.join(root, '_state', 'git.lock'),
+        remoteFile: path.join(root, 'REMOTE'),
+        readmeFile: path.join(root, 'README.md'),
+    };
+}