evolclaw 3.0.0 → 3.1.0

package/dist/cli/watch-msg.js

@@ -0,0 +1,589 @@
+import fs from 'fs';
+import path from 'path';
+import { resolvePaths, getPackageRoot } from '../paths.js';
+import { decodeDirSegment, readAllJsonlLines } from '../core/session/session-fs-store.js';
+// ==================== ANSI ====================
+const isTTY = !!process.stdout.isTTY;
+const RST = isTTY ? '\x1b[0m' : '';
+const DIM = isTTY ? '\x1b[2m' : '';
+const BOLD = isTTY ? '\x1b[1m' : '';
+const CYAN = isTTY ? '\x1b[36m' : '';
+const GREEN = isTTY ? '\x1b[32m' : '';
+const BLUE = isTTY ? '\x1b[34m' : '';
+const ORANGE = isTTY ? '\x1b[38;5;208m' : '';
+const MAGENTA = isTTY ? '\x1b[35m' : '';
+const BG_SEL = isTTY ? '\x1b[48;5;236m' : ''; // dark gray background for selected row
+// ==================== Helpers ====================
+function visualWidth(s) {
+    const stripped = s.replace(/\x1b\[[0-9;]*m/g, '');
+    let w = 0;
+    for (const ch of stripped) {
+        const code = ch.charCodeAt(0);
+        w += (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3000 && code <= 0x30ff) ||
+            (code >= 0xff00 && code <= 0xffef) ? 2 : 1;
+    }
+    return w;
+}
+function padRight(s, width) {
+    const pad = Math.max(0, width - visualWidth(s));
+    return s + ' '.repeat(pad);
+}
+function truncate(s, maxWidth) {
+    let w = 0;
+    let i = 0;
+    for (const ch of s) {
+        const code = ch.charCodeAt(0);
+        const cw = (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3000 && code <= 0x30ff) ||
+            (code >= 0xff00 && code <= 0xffef) ? 2 : 1;
+        if (w + cw > maxWidth - 1)
+            return s.slice(0, i) + '…';
+        w += cw;
+        i += ch.length;
+    }
+    return s;
+}
+function wrapText(s, lineWidth, maxLines) {
+    const result = [];
+    let remaining = s;
+    while (remaining.length > 0 && result.length < maxLines) {
+        let w = 0;
+        let cutIdx = 0;
+        for (const ch of remaining) {
+            const code = ch.charCodeAt(0);
+            const cw = (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3000 && code <= 0x30ff) ||
+                (code >= 0xff00 && code <= 0xffef) ? 2 : 1;
+            if (w + cw > lineWidth)
+                break;
+            w += cw;
+            cutIdx += ch.length;
+        }
+        if (cutIdx === 0)
+            break;
+        const isLast = result.length === maxLines - 1;
+        if (isLast && cutIdx < remaining.length) {
+            result.push(truncate(remaining, lineWidth));
+        }
+        else {
+            result.push(remaining.slice(0, cutIdx));
+        }
+        remaining = remaining.slice(cutIdx);
+    }
+    if (result.length === 0)
+        result.push('');
+    return result;
+}
+function formatTimeAgo(ms) {
+    const sec = Math.floor(ms / 1000);
+    if (sec < 60)
+        return `${sec}s`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min}m`;
+    const hour = Math.floor(min / 60);
+    if (hour < 24)
+        return `${hour}h`;
+    return `${Math.floor(hour / 24)}d`;
+}
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+function formatTime(ts) {
+    const d = new Date(ts);
+    return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}
+function formatDateTime(ts) {
+    const d = new Date(ts);
+    const mo = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    return `${mo}-${dd} ${hh}:${mm}`;
+}
+function shortAid(aid) {
+    return aid.split('.')[0];
+}
+// ==================== Data Layer ====================
+function getSessionsAunDir() {
+    const p = resolvePaths();
+    return path.join(p.sessionsDir, 'aun');
+}
+function listLocalAids(aunDir) {
+    try {
+        return fs.readdirSync(aunDir, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => decodeDirSegment(e.name));
+    }
+    catch {
+        return [];
+    }
+}
+function listPeers(aunDir, localAid) {
+    const aidDir = path.join(aunDir, encodeSegment(localAid));
+    try {
+        return fs.readdirSync(aidDir, { withFileTypes: true })
+            .filter(e => e.isDirectory() && !e.name.startsWith('_'))
+            .map(e => decodeDirSegment(e.name));
+    }
+    catch {
+        return [];
+    }
+}
+function readMessages(aunDir, localAid, peerId) {
+    const msgPath = path.join(aunDir, encodeSegment(localAid), encodeSegment(peerId), 'messages.jsonl');
+    return readAllJsonlLines(msgPath);
+}
+function readPeerName(aunDir, localAid, peerId) {
+    const activePath = path.join(aunDir, encodeSegment(localAid), encodeSegment(peerId), 'active.json');
+    try {
+        const data = JSON.parse(fs.readFileSync(activePath, 'utf-8'));
+        return data?.metadata?.peerName || null;
+    }
+    catch {
+        return null;
+    }
+}
+function encodeSegment(s) {
+    return s.replace(/[/%\\:*?"<>|]/g, ch => '%' + ch.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0'));
+}
+function loadAidInfo(aunDir, aid) {
+    const peers = listPeers(aunDir, aid);
+    let totalIn = 0, totalOut = 0;
+    for (const peer of peers) {
+        const msgs = readMessages(aunDir, aid, peer);
+        for (const m of msgs) {
+            if (m.dir === 'in')
+                totalIn++;
+            else
+                totalOut++;
+        }
+    }
+    return { aid, totalIn, totalOut, peerCount: peers.length };
+}
+function loadPeerInfos(aunDir, localAid) {
+    const peers = listPeers(aunDir, localAid);
+    const infos = [];
+    for (const peerId of peers) {
+        const msgs = readMessages(aunDir, localAid, peerId);
+        let inbound = 0, outbound = 0, lastAt = 0;
+        for (const m of msgs) {
+            if (m.dir === 'in')
+                inbound++;
+            else
+                outbound++;
+            if (m.ts > lastAt)
+                lastAt = m.ts;
+        }
+        const peerName = readPeerName(aunDir, localAid, peerId);
+        infos.push({ peerId, peerName, inbound, outbound, lastAt });
+    }
+    infos.sort((a, b) => b.lastAt - a.lastAt);
+    return infos;
+}
+function loadAllMessages(aunDir, localAid) {
+    const peers = listPeers(aunDir, localAid);
+    const all = [];
+    for (const peer of peers) {
+        all.push(...readMessages(aunDir, localAid, peer));
+    }
+    all.sort((a, b) => a.ts - b.ts);
+    if (all.length > 1000)
+        return all.slice(-1000);
+    return all;
+}
+// ==================== Rendering ====================
+function renderScrollbar(totalLines, visibleLines, offset, height) {
+    if (totalLines <= visibleLines)
+        return Array(height).fill(' ');
+    const thumbSize = Math.max(1, Math.floor(height * visibleLines / totalLines));
+    const maxOffset = totalLines - visibleLines;
+    const thumbPos = Math.floor((maxOffset - offset) / maxOffset * (height - thumbSize));
+    const bar = [];
+    for (let i = 0; i < height; i++) {
+        bar.push(i >= thumbPos && i < thumbPos + thumbSize ? `${DIM}█${RST}` : `${DIM}░${RST}`);
+    }
+    return bar;
+}
+function renderScopePanel(state, width, height) {
+    const lines = [];
+    const title = `${DIM}─ Scope ─${RST}`;
+    lines.push(padRight(title, width));
+    const isActive = state.activePanel === 'scope';
+    for (let i = 0; i < state.localAids.length && lines.length < height; i++) {
+        const a = state.localAids[i];
+        const sel = isActive && i === state.scopeIndex;
+        const chosen = state.selectedLocalAid === a.aid;
+        const bg = sel ? BG_SEL : '';
+        const marker = sel ? `${bg}${CYAN}${BOLD}▸ ` : (chosen ? `${CYAN}  ` : '  ');
+        const name = truncate(shortAid(a.aid), width - 4);
+        lines.push(padRight(`${marker}${name}${RST}`, width));
+        const statsBg = sel ? BG_SEL : '';
+        const stats = `${statsBg}  ${DIM}↓${a.totalIn} ↑${a.totalOut} peers:${a.peerCount}${RST}`;
+        lines.push(padRight(stats, width));
+        if (lines.length < height)
+            lines.push(padRight('', width));
+    }
+    while (lines.length < height)
+        lines.push(padRight('', width));
+    return lines.slice(0, height);
+}
+function renderStatsPanel(state, width, height) {
+    const lines = [];
+    const title = `${DIM}─ Stats ─${RST}`;
+    lines.push(padRight(title, width));
+    if (!state.selectedLocalAid) {
+        lines.push(padRight(`${DIM}  select an AID${RST}`, width));
+        while (lines.length < height)
+            lines.push(padRight('', width));
+        return lines.slice(0, height);
+    }
+    const isActive = state.activePanel === 'stats';
+    const now = Date.now();
+    // "All" item at index 0
+    const allSel = isActive && state.statsIndex === 0;
+    const allBg = allSel ? BG_SEL : '';
+    const allMarker = allSel ? `${allBg}${CYAN}${BOLD}▸ ` : '  ';
+    lines.push(padRight(`${allMarker}All (${state.peers.length} peers)${RST}`, width));
+    if (lines.length < height)
+        lines.push(padRight('', width));
+    for (let i = 0; i < state.peers.length && lines.length < height; i++) {
+        const p = state.peers[i];
+        const sel = isActive && state.statsIndex === i + 1;
+        const bg = sel ? BG_SEL : '';
+        const marker = sel ? `${bg}${CYAN}${BOLD}▸ ` : '  ';
+        const displayName = p.peerName || shortAid(p.peerId);
+        const name = truncate(displayName, width - 4);
+        lines.push(padRight(`${marker}${name}${RST}`, width));
+        const detailBg = sel ? BG_SEL : '';
+        const ago = p.lastAt ? formatTimeAgo(now - p.lastAt) : '-';
+        const detail = `${detailBg}  ${DIM}↓${p.inbound} ↑${p.outbound}  ${ago}${RST}`;
+        lines.push(padRight(detail, width));
+        if (lines.length < height)
+            lines.push(padRight('', width));
+    }
+    while (lines.length < height)
+        lines.push(padRight('', width));
+    return lines.slice(0, height);
+}
+// ==================== Messages Panel ====================
+function renderMessagesPanel(state, width, height) {
+    const lines = [];
+    const title = `${DIM}─ Messages ─${RST}`;
+    lines.push(padRight(title, width));
+    const contentHeight = height - 1;
+    const msgs = state.messages;
+    const totalMsgs = msgs.length;
+    const visibleCount = contentHeight;
+    const startIdx = Math.max(0, totalMsgs - visibleCount - state.messageScrollOffset);
+    const endIdx = Math.min(totalMsgs, startIdx + visibleCount);
+    const scrollbar = renderScrollbar(totalMsgs, visibleCount, state.messageScrollOffset, contentHeight);
+    const msgWidth = width - 3;
+    const contentLineWidth = msgWidth - 2;
+    const maxContentLines = 3;
+    for (let i = startIdx; i < endIdx; i++) {
+        const m = msgs[i];
+        const time = formatDateTime(m.ts);
+        const dir = m.dir === 'in' ? `${GREEN}↓${RST}` : `${BLUE}↑${RST}`;
+        const isGroup = m.chatType === 'group';
+        const chatTag = isGroup ? `${MAGENTA}[群聊]${RST} ` : '';
+        const byteLen = Buffer.byteLength(m.content, 'utf-8');
+        const lenTag = `${DIM}${formatNumber(byteLen)}B${RST}`;
+        const fromDisplay = isGroup && m.groupId && m.dir === 'in' ? m.groupId : m.from;
+        const toDisplay = isGroup && m.groupId && m.dir === 'out' ? m.groupId : m.to;
+        const header = `${DIM}${time}${RST} ${dir}${chatTag} ${ORANGE}${fromDisplay}${RST}${DIM}→${RST}${GREEN}${toDisplay}${RST} ${lenTag}`;
+        const headerLine = padRight(header, msgWidth);
+        const sbIdx = lines.length - 1;
+        lines.push(`${headerLine} ${scrollbar[sbIdx] || ' '}`);
+        if (lines.length - 1 < contentHeight) {
+            const rawContent = m.content.replace(/\n/g, ' ');
+            const wrappedLines = wrapText(rawContent, contentLineWidth, maxContentLines);
+            for (const wl of wrappedLines) {
+                if (lines.length - 1 >= contentHeight)
+                    break;
+                const contentLine = padRight(`  ${wl}`, msgWidth);
+                const sbIdx2 = lines.length - 1;
+                lines.push(`${contentLine} ${scrollbar[sbIdx2] || ' '}`);
+            }
+        }
+    }
+    while (lines.length < height) {
+        const sbIdx = lines.length - 1;
+        lines.push(padRight('', msgWidth) + ` ${scrollbar[sbIdx] || ' '}`);
+    }
+    return lines.slice(0, height);
+}
+// ==================== Main Render ====================
+function renderFrame(state) {
+    const cols = process.stdout.columns || 120;
+    const rows = (process.stdout.rows || 40) - 3;
+    const leftW = Math.max(20, Math.floor(cols * 0.20));
+    const midW = Math.max(24, Math.floor(cols * 0.22));
+    const rightW = Math.max(40, cols - leftW - midW - 4);
+    const bodyHeight = rows - 2;
+    const leftLines = renderScopePanel(state, leftW, bodyHeight);
+    const midLines = renderStatsPanel(state, midW, bodyHeight);
+    const msgLines = renderMessagesPanel(state, rightW, bodyHeight);
+    const sep = `${DIM}│${RST}`;
+    let buf = '\x1b[H';
+    const topBorder = `${DIM}┌${'─'.repeat(leftW)}┬${'─'.repeat(midW)}┬${'─'.repeat(rightW + 1)}┐${RST}`;
+    buf += `\x1b[2K${topBorder}\n`;
+    for (let i = 0; i < bodyHeight; i++) {
+        const l = leftLines[i] || padRight('', leftW);
+        const m = midLines[i] || padRight('', midW);
+        const r = msgLines[i] || padRight('', rightW);
+        buf += `\x1b[2K${sep}${l}${sep}${m}${sep}${r}${sep}\n`;
+    }
+    const bottomBorder = `${DIM}├${'─'.repeat(leftW)}┴${'─'.repeat(midW)}┴${'─'.repeat(rightW + 1)}┤${RST}`;
+    buf += `\x1b[2K${bottomBorder}\n`;
+    const pkgRoot = getPackageRoot();
+    const helpLine = `${DIM}│ Tab: panel  ↑↓: nav  Enter: select  Backspace: back  ESC: exit  ${pkgRoot}${RST}`;
+    buf += `\x1b[2K${helpLine}\n`;
+    const closeBorder = `${DIM}└${'─'.repeat(cols - 2)}┘${RST}`;
+    buf += `\x1b[2K${closeBorder}\n`;
+    return buf;
+}
+// ==================== Main ====================
+export async function cmdWatchMsg() {
+    const aunDir = getSessionsAunDir();
+    if (!fs.existsSync(aunDir)) {
+        console.log('No session data found.');
+        return;
+    }
+    let watcher = null;
+    const state = {
+        activePanel: 'scope',
+        localAids: [],
+        scopeIndex: 0,
+        selectedLocalAid: null,
+        peers: [],
+        statsIndex: 0,
+        selectedPeer: null,
+        messages: [],
+        messageScrollOffset: 0,
+        dirty: true,
+    };
+    function loadScope() {
+        const aids = listLocalAids(aunDir);
+        state.localAids = aids.map(aid => loadAidInfo(aunDir, aid));
+        state.localAids.sort((a, b) => (b.totalIn + b.totalOut) - (a.totalIn + a.totalOut));
+    }
+    function selectAid(aid) {
+        state.selectedLocalAid = aid;
+        state.peers = loadPeerInfos(aunDir, aid);
+        state.statsIndex = 0;
+        state.selectedPeer = null;
+        state.messages = loadAllMessages(aunDir, aid);
+        state.messageScrollOffset = 0;
+        startWatching(aid);
+    }
+    function selectPeer(peerId) {
+        state.selectedPeer = peerId;
+        if (!state.selectedLocalAid)
+            return;
+        if (peerId) {
+            state.messages = readMessages(aunDir, state.selectedLocalAid, peerId);
+            if (state.messages.length > 1000)
+                state.messages = state.messages.slice(-1000);
+        }
+        else {
+            state.messages = loadAllMessages(aunDir, state.selectedLocalAid);
+        }
+        state.messageScrollOffset = 0;
+    }
+    function startWatching(aid) {
+        if (watcher) {
+            watcher.close();
+            watcher = null;
+        }
+        const aidDir = path.join(aunDir, encodeSegment(aid));
+        try {
+            watcher = fs.watch(aidDir, { recursive: true }, (_, filename) => {
+                if (filename && filename.endsWith('messages.jsonl')) {
+                    refreshData();
+                    render();
+                }
+            });
+        }
+        catch { /* directory may not exist */ }
+    }
+    function refreshData() {
+        if (!state.selectedLocalAid)
+            return;
+        state.peers = loadPeerInfos(aunDir, state.selectedLocalAid);
+        if (state.selectedPeer) {
+            state.messages = readMessages(aunDir, state.selectedLocalAid, state.selectedPeer);
+            if (state.messages.length > 1000)
+                state.messages = state.messages.slice(-1000);
+        }
+        else {
+            state.messages = loadAllMessages(aunDir, state.selectedLocalAid);
+        }
+        // Also refresh scope stats for the selected AID
+        const idx = state.localAids.findIndex(a => a.aid === state.selectedLocalAid);
+        if (idx >= 0) {
+            state.localAids[idx] = loadAidInfo(aunDir, state.selectedLocalAid);
+        }
+    }
+    function render() {
+        process.stdout.write(renderFrame(state));
+    }
+    function cleanup() {
+        if (watcher) {
+            watcher.close();
+            watcher = null;
+        }
+        if (process.stdin.isTTY)
+            try {
+                process.stdin.setRawMode(false);
+            }
+            catch { }
+        process.stdin.pause();
+        process.stdout.write('\x1b[?25h\x1b[2J\x1b[H');
+    }
+    function handleKey(data) {
+        // ESC
+        if (data[0] === 0x1b && data.length === 1) {
+            cleanup();
+            process.exit(0);
+        }
+        // Ctrl+C
+        if (data[0] === 0x03) {
+            cleanup();
+            process.exit(0);
+        }
+        // Arrow keys
+        if (data[0] === 0x1b && data[1] === 0x5b) {
+            const code = data[2];
+            if (code === 0x41)
+                handleUp();
+            else if (code === 0x42)
+                handleDown();
+            else if (code === 0x43)
+                handleRight();
+            else if (code === 0x44)
+                handleLeft();
+            else if (code === 0x35)
+                handlePageUp(); // Page Up: \x1b[5~
+            else if (code === 0x36)
+                handlePageDown(); // Page Down: \x1b[6~
+            render();
+            return;
+        }
+        // Tab
+        if (data[0] === 0x09) {
+            handleRight();
+            render();
+            return;
+        }
+        // Shift+Tab (some terminals: \x1b[Z)
+        if (data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x5a) {
+            handleLeft();
+            render();
+            return;
+        }
+        // Enter
+        if (data[0] === 0x0d) {
+            handleEnter();
+            render();
+            return;
+        }
+        // Backspace
+        if (data[0] === 0x7f || data[0] === 0x08) {
+            handleBackspace();
+            render();
+            return;
+        }
+    }
+    function handleUp() {
+        if (state.activePanel === 'scope') {
+            state.scopeIndex = Math.max(0, state.scopeIndex - 1);
+        }
+        else if (state.activePanel === 'stats') {
+            state.statsIndex = Math.max(0, state.statsIndex - 1);
+        }
+        else if (state.activePanel === 'messages') {
+            state.messageScrollOffset = Math.min(Math.max(0, state.messages.length - 5), state.messageScrollOffset + 3);
+        }
+    }
+    function handleDown() {
+        if (state.activePanel === 'scope') {
+            state.scopeIndex = Math.min(state.localAids.length - 1, state.scopeIndex + 1);
+        }
+        else if (state.activePanel === 'stats') {
+            state.statsIndex = Math.min(state.peers.length, state.statsIndex + 1);
+        }
+        else if (state.activePanel === 'messages') {
+            state.messageScrollOffset = Math.max(0, state.messageScrollOffset - 3);
+        }
+    }
+    function handleLeft() {
+        if (state.activePanel === 'messages')
+            state.activePanel = 'stats';
+        else if (state.activePanel === 'stats')
+            state.activePanel = 'scope';
+    }
+    function handleRight() {
+        if (state.activePanel === 'scope')
+            state.activePanel = 'stats';
+        else if (state.activePanel === 'stats')
+            state.activePanel = 'messages';
+    }
+    function handlePageUp() {
+        if (state.activePanel === 'messages') {
+            const pageSize = (process.stdout.rows || 40) - 6;
+            state.messageScrollOffset = Math.min(Math.max(0, state.messages.length - 5), state.messageScrollOffset + pageSize);
+        }
+    }
+    function handlePageDown() {
+        if (state.activePanel === 'messages') {
+            const pageSize = (process.stdout.rows || 40) - 6;
+            state.messageScrollOffset = Math.max(0, state.messageScrollOffset - pageSize);
+        }
+    }
+    function handleEnter() {
+        if (state.activePanel === 'scope' && state.localAids.length > 0) {
+            const aid = state.localAids[state.scopeIndex];
+            selectAid(aid.aid);
+            state.activePanel = 'stats';
+        }
+        else if (state.activePanel === 'stats') {
+            if (state.statsIndex === 0) {
+                selectPeer(null);
+            }
+            else {
+                const peer = state.peers[state.statsIndex - 1];
+                if (peer)
+                    selectPeer(peer.peerId);
+            }
+            state.activePanel = 'messages';
+        }
+    }
+    function handleBackspace() {
+        if (state.activePanel === 'messages') {
+            state.activePanel = 'stats';
+            state.messageScrollOffset = 0;
+        }
+        else if (state.activePanel === 'stats') {
+            state.activePanel = 'scope';
+            state.selectedLocalAid = null;
+            state.peers = [];
+            state.messages = [];
+            if (watcher) {
+                watcher.close();
+                watcher = null;
+            }
+        }
+    }
+    // ── Init ──
+    process.on('SIGINT', () => { cleanup(); process.exit(0); });
+    process.on('SIGTERM', () => { cleanup(); process.exit(0); });
+    loadScope();
+    process.stdout.write('\x1b[?25l\x1b[2J\x1b[H');
+    render();
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', handleKey);
+    }
+    // Keep process alive
+    await new Promise(() => { });
+}

package/dist/config-store.js

@@ -77,6 +77,15 @@ export function loadDefaults() {
 export function saveDefaults(value) {
     atomicWriteJson(resolvePaths().defaultsConfig, value);
 }
+export function loadProcessConfig() {
+    const raw = atomicReadJson(resolvePaths().processConfig);
+    if (raw === null)
+        return {};
+    return expandEnvRefs(raw);
+}
+export function saveProcessConfig(value) {
+    atomicWriteJson(resolvePaths().processConfig, value);
+}
 // ── 自动迁移 ───────────────────────────────────────────────────────────
 /**
  * 启动时自动迁移：如果 agents/defaults.json 不存在但 data/evolclaw.json 存在，
@@ -455,21 +464,44 @@ export function ensureAgentDirSkeleton(aid) {
     const root = agentDir(aid);
     const subs = [
         'personal',
-        'identities/contacts',
-        'identities/_observed',
-        'identities/_index',
-        'identities/_observed/_index',
-        'identities/_trash',
+        'personal/memory',
+        'personal/skills',
+        'relations/contacts',
+        'relations/_observed',
+        'relations/_observed/_index',
+        'relations/_index',
+        'relations/_trash',
         'venues',
         'venues/_index',
         'venues/_trash',
         'sessions',
         'data/cache',
+        'index',
     ];
     for (const sub of subs) {
         fs.mkdirSync(path.join(root, sub), { recursive: true });
     }
 }
+// ── identities → relations 迁移 ──────────────────────────────────────
+/**
+ * 启动时自动迁移：如果 agents/<aid>/identities/ 存在但 relations/ 不存在，
+ * 将 identities/ 重命名为 relations/。幂等。
+ */
+export function migrateIdentitiesIfNeeded() {
+    const agentsDir = resolvePaths().agentsDir;
+    if (!fs.existsSync(agentsDir))
+        return;
+    for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const oldDir = path.join(agentsDir, entry.name, 'identities');
+        const newDir = path.join(agentsDir, entry.name, 'relations');
+        if (fs.existsSync(oldDir) && !fs.existsSync(newDir)) {
+            fs.renameSync(oldDir, newDir);
+            logger.info(`[migrate] Renamed agents/${entry.name}/identities/ → relations/`);
+        }
+    }
+}
 // ── Project Migration ────────────────────────────────────────────────────────
 import os from 'os';
 /** 将绝对路径编码为 Claude Code 的目录名格式（/ \ . 替换为 -） */