kitty-hive 0.1.1 → 0.3.0

package/dist/index.js

@@ -1,12 +1,14 @@
 #!/usr/bin/env node
 import { startServer, setLogLevel } from './server.js';
-import { initDB, addPeer, listPeers, removePeer, updatePeerExposed, getPeerByName } from './db.js';
+import { initDB, addPeer, listPeers, removePeer, updatePeerExposed, getPeerByName, setPeerNodeName, setPeerStatus, touchPeer } from './db.js';
+import { pingPeer } from './federation-heartbeat.js';
 import { generateToken } from './utils.js';
 import { writeFileSync, existsSync, readFileSync, unlinkSync, mkdirSync } from 'node:fs';
-import { join, dirname } from 'node:path';
+import { join, dirname, basename, delimiter } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { homedir } from 'node:os';
+import { homedir, hostname } from 'node:os';
 import { createInterface } from 'node:readline';
+import { execSync } from 'node:child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const args = process.argv.slice(2);
@@ -45,124 +47,260 @@ async function cmdServe() {
         setLogLevel('warn');
     await startServer(port, dbPath);
 }
-async function cmdInit() {
-    console.log('🐝 kitty-hive init\n');
-    // Parse flags first
-    let explicitPort = false;
-    let explicitHttp = false;
-    let agentName = '';
-    let port = 4123;
-    for (let i = 1; i < args.length; i++) {
-        if (args[i] === '--http') {
-            explicitHttp = true;
-        }
-        else if ((args[i] === '--port' || args[i] === '-p') && args[i + 1]) {
-            port = parseInt(args[i + 1], 10);
-            explicitPort = true;
-            i++;
-        }
-        else if (args[i] === '--db') {
-            i++;
-        }
-        else if (!args[i].startsWith('-')) {
-            agentName = args[i];
-        }
-    }
-    // Interactive: ask what wasn't provided
-    if (!agentName) {
-        agentName = await ask('Agent name', getDefaultAgentName());
+const INIT_TOOLS = ['claude', 'cursor', 'vscode'];
+const ALL_INIT_TARGETS = ['claude', 'cursor', 'vscode', 'antigravity'];
+function findNpx() {
+    const probe = process.platform === 'win32' ? 'where npx' : 'command -v npx';
+    try {
+        const out = execSync(probe, { encoding: 'utf8' }).trim().split(/\r?\n/)[0];
+        return out || 'npx';
     }
-    if (!explicitPort) {
-        const p = await ask('Hive server port', '4123');
-        port = parseInt(p, 10) || 4123;
+    catch {
+        return 'npx';
     }
-    let useChannel = !explicitHttp;
-    if (!explicitHttp) {
-        const mode = await ask('Mode: (c)hannel push or (h)ttp pull?', 'c');
-        useChannel = mode.toLowerCase() !== 'h';
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
     }
-    const channelPath = join(__dirname, '..', 'channel.ts');
-    const mcpJsonPath = join(process.cwd(), '.mcp.json');
-    let existing = {};
-    if (existsSync(mcpJsonPath)) {
-        try {
-            existing = JSON.parse(readFileSync(mcpJsonPath, 'utf8'));
-        }
-        catch { /* ignore */ }
+    catch {
+        return {};
     }
-    if (!existing.mcpServers)
-        existing.mcpServers = {};
-    if (useChannel) {
-        existing.mcpServers['hive-channel'] = {
-            command: 'npx',
-            args: ['tsx', channelPath],
-            env: {
-                HIVE_URL: `http://localhost:${port}/mcp`,
-                HIVE_AGENT_NAME: agentName,
+}
+function writeJson(path, data) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2) + '\n');
+}
+function writeForTool(tool, port) {
+    const url = `http://localhost:${port}/mcp`;
+    const cwd = process.cwd();
+    if (tool === 'claude') {
+        const p = join(cwd, '.mcp.json');
+        const data = readJson(p);
+        if (!data.mcpServers)
+            data.mcpServers = {};
+        data.mcpServers['hive'] = { url };
+        delete data.mcpServers['hive-channel'];
+        writeJson(p, data);
+        return p;
+    }
+    if (tool === 'cursor') {
+        const p = join(cwd, '.cursor', 'mcp.json');
+        const data = readJson(p);
+        if (!data.mcpServers)
+            data.mcpServers = {};
+        data.mcpServers['hive'] = { url };
+        writeJson(p, data);
+        return p;
+    }
+    if (tool === 'vscode') {
+        const p = join(cwd, '.vscode', 'mcp.json');
+        const data = readJson(p);
+        if (!data.servers)
+            data.servers = {};
+        data.servers['hive'] = { type: 'http', url };
+        writeJson(p, data);
+        return p;
+    }
+    throw new Error(`Unknown tool: ${tool}`);
+}
+function antigravitySnippet(port) {
+    // Antigravity has no public on-disk config path — users edit via
+    // "..." → MCP Store → Manage MCP Servers → View raw config.
+    // It also doesn't speak streamable HTTP directly, so we route through a stdio→HTTP adapter.
+    const url = `http://localhost:${port}/mcp`;
+    // Pre-seed PATH so the GUI app can find npx even when launched without a shell.
+    const pathDirs = process.platform === 'win32'
+        ? [
+            process.env.SystemRoot ? join(process.env.SystemRoot, 'System32') : 'C:\\Windows\\System32',
+            process.env.APPDATA ? join(process.env.APPDATA, 'npm') : '',
+        ].filter(Boolean)
+        : ['/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin'];
+    return JSON.stringify({
+        mcpServers: {
+            hive: {
+                command: findNpx(),
+                args: ['-y', '@pyroprompts/mcp-stdio-to-streamable-http-adapter'],
+                env: {
+                    PATH: pathDirs.join(delimiter),
+                    URI: url,
+                },
             },
-        };
-        delete existing.mcpServers['hive'];
+        },
+    }, null, 2);
+}
+function showInitUsage() {
+    console.log('🐝 kitty-hive init — write MCP config for an IDE\n');
+    console.log('Usage:');
+    console.log('  kitty-hive init <tool> [--port 4123]\n');
+    console.log('Tools:');
+    console.log('  claude        .mcp.json          (Claude Code — prefer the plugin instead)');
+    console.log('  cursor        .cursor/mcp.json');
+    console.log('  vscode        .vscode/mcp.json   (VS Code Copilot)');
+    console.log('  antigravity   prints snippet to paste via MCP Store UI');
+    console.log('  all           run all of the above');
+}
+async function cmdInit() {
+    const tool = args[1];
+    if (!tool || tool.startsWith('-')) {
+        showInitUsage();
+        process.exit(1);
+    }
+    const known = ALL_INIT_TARGETS;
+    let targets;
+    if (tool === 'all') {
+        targets = [...ALL_INIT_TARGETS];
+    }
+    else if (known.includes(tool)) {
+        targets = [tool];
     }
     else {
-        existing.mcpServers['hive'] = {
-            url: `http://localhost:${port}/mcp`,
-        };
-        delete existing.mcpServers['hive-channel'];
+        console.log(`Unknown tool: "${tool}"`);
+        showInitUsage();
+        process.exit(1);
     }
-    writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + '\n');
-    console.log(`\n🐝 kitty-hive configured`);
-    console.log(`   Agent: ${agentName}`);
-    console.log(`   Server: http://localhost:${port}/mcp`);
-    console.log(`   Mode: ${useChannel ? 'channel (push)' : 'HTTP (pull)'}`);
-    if (useChannel) {
-        console.log(`\n   Run: claude --dangerously-load-development-channels server:hive-channel`);
+    let port = 4123;
+    for (let i = 2; i < args.length; i++) {
+        if ((args[i] === '--port' || args[i] === '-p') && args[i + 1]) {
+            port = parseInt(args[i + 1], 10) || 4123;
+            i++;
+        }
     }
+    console.log(`🐝 Configuring hive → http://localhost:${port}/mcp\n`);
+    for (const t of targets) {
+        if (t === 'antigravity') {
+            console.log(`  antigravity  (no on-disk path — paste this snippet)`);
+            console.log(`               Open: "..." → MCP Store → Manage MCP Servers → View raw config`);
+            console.log(`               Merge "hive" into mcpServers:\n`);
+            const snippet = antigravitySnippet(port).split('\n').map(l => '    ' + l).join('\n');
+            console.log(snippet);
+            console.log('');
+        }
+        else {
+            const path = writeForTool(t, port);
+            console.log(`  ${t.padEnd(12)} ${path}`);
+        }
+    }
+    console.log(`\n  Agent registers via hive.start when first used.`);
+}
+function relativeTime(iso) {
+    if (!iso)
+        return '-';
+    const then = new Date(iso).getTime();
+    if (Number.isNaN(then))
+        return iso;
+    const diff = Math.max(0, Date.now() - then);
+    const s = Math.floor(diff / 1000);
+    if (s < 5)
+        return 'now';
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    const d = Math.floor(h / 24);
+    return `${d}d ago`;
+}
+function visualWidth(s) {
+    let w = 0;
+    for (const c of s) {
+        const cp = c.codePointAt(0);
+        const wide = (cp >= 0x1100 && cp <= 0x115F) || (cp >= 0x2E80 && cp <= 0x303E) ||
+            (cp >= 0x3041 && cp <= 0x33FF) || (cp >= 0x3400 && cp <= 0x4DBF) ||
+            (cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0xA000 && cp <= 0xA4CF) ||
+            (cp >= 0xAC00 && cp <= 0xD7A3) || (cp >= 0xF900 && cp <= 0xFAFF) ||
+            (cp >= 0xFE30 && cp <= 0xFE4F) || (cp >= 0xFF00 && cp <= 0xFF60) ||
+            (cp >= 0xFFE0 && cp <= 0xFFE6) || (cp >= 0x20000 && cp <= 0x3FFFD);
+        w += wide ? 2 : 1;
+    }
+    return w;
+}
+function padCell(s, width) {
+    return s + ' '.repeat(Math.max(0, width - visualWidth(s)));
 }
+function renderTable(headers, rows, indent = '') {
+    const widths = headers.map((h, i) => Math.max(visualWidth(h), ...rows.map(r => visualWidth(r[i] ?? ''))));
+    const fmt = (cells) => indent + cells.map((c, i) => padCell(c ?? '', widths[i])).join('  ').trimEnd();
+    const sep = indent + widths.map(w => '─'.repeat(w)).join('  ');
+    return [fmt(headers), sep, ...rows.map(fmt)].join('\n');
+}
+function agentRows(db, agents) {
+    const teamStmt = db.prepare(`
+    SELECT t.name, tm.nickname FROM teams t
+    JOIN team_members tm ON tm.team_id = t.id
+    WHERE tm.agent_id = ? AND t.closed_at IS NULL
+    ORDER BY t.name
+  `);
+    return agents.map(a => {
+        const memberTeams = teamStmt.all(a.id);
+        const teamLabels = memberTeams.map(t => t.nickname ? `${t.name}:${t.nickname}` : t.name).join(', ') || '-';
+        return [
+            a.id.slice(0, 12),
+            a.display_name,
+            a.tool || '-',
+            a.status,
+            a.roles || '-',
+            teamLabels,
+            relativeTime(a.last_seen),
+        ];
+    });
+}
+const AGENT_HEADERS = ['ID', 'NAME', 'TOOL', 'STATUS', 'ROLES', 'TEAMS', 'LAST SEEN'];
 async function cmdStatus() {
     const { port, dbPath } = parseFlags(1);
     const url = `http://localhost:${port}/mcp`;
-    // Check server
+    const nodeName = getNodeConfig().name || hostname().split('.')[0];
     try {
-        const res = await fetch(url, { method: 'GET' });
+        await fetch(url, { method: 'GET' });
         console.log(`🐝 Server: http://localhost:${port}/mcp (online)`);
     }
     catch {
         console.log(`❌ Server: http://localhost:${port}/mcp (offline)`);
         process.exit(1);
     }
-    // Check DB
+    console.log(`   Node: ${nodeName}`);
     try {
         const db = initDB(dbPath);
-        const agents = db.prepare('SELECT id, display_name, status, last_seen FROM agents ORDER BY last_seen DESC').all();
-        const rooms = db.prepare("SELECT id, name, kind FROM rooms WHERE closed_at IS NULL").all();
+        const agents = db.prepare("SELECT id, display_name, tool, roles, status, last_seen FROM agents WHERE origin_peer = '' ORDER BY last_seen DESC").all();
+        const remotes = db.prepare("SELECT id, display_name, tool, roles, status, last_seen, origin_peer FROM agents WHERE origin_peer != '' ORDER BY last_seen DESC").all();
+        const teams = db.prepare("SELECT id, name FROM teams WHERE closed_at IS NULL ORDER BY name").all();
         const tasks = db.prepare("SELECT count(*) as cnt FROM tasks WHERE status NOT IN ('completed','failed','canceled')").get();
-        console.log(`\n📊 Database: ${dbPath || '~/.kitty-hive/hive.db'}`);
-        console.log(`   Rooms: ${rooms.length}  Active tasks: ${tasks.cnt}`);
-        console.log(`\n👥 Agents (${agents.length}):`);
-        for (const a of agents) {
-            // Find rooms this agent is in
-            const memberRooms = db.prepare(`
-        SELECT DISTINCT r.name FROM rooms r
-        JOIN room_events e ON e.room_id = r.id AND e.type = 'join' AND e.actor_agent_id = ?
-        WHERE r.closed_at IS NULL AND NOT EXISTS (
-          SELECT 1 FROM room_events e2 WHERE e2.room_id = r.id AND e2.type = 'leave' AND e2.actor_agent_id = ? AND e2.seq > e.seq
-        )
-      `).all(a.id, a.id);
-            const roomNames = memberRooms.map((r) => r.name).filter(Boolean).join(', ');
-            console.log(`   ${a.display_name} (${a.status}) — ${roomNames || 'no rooms'}`);
+        const peers = listPeers();
+        console.log(`📊 Database: ${dbPath || '~/.kitty-hive/hive.db'}`);
+        console.log(`   ${agents.length} local agents · ${remotes.length} remote · ${teams.length} teams · ${tasks.cnt} active tasks · ${peers.length} peers`);
+        if (agents.length > 0) {
+            console.log(`\n👥 Agents`);
+            console.log(renderTable(AGENT_HEADERS, agentRows(db, agents), '   '));
         }
-        if (rooms.length > 0) {
-            console.log(`\n🏠 Rooms:`);
-            for (const r of rooms) {
-                const memberCount = db.prepare(`
-          SELECT COUNT(DISTINCT e.actor_agent_id) as cnt FROM room_events e
-          WHERE e.room_id = ? AND e.type = 'join'
-        `).get(r.id);
-                console.log(`   ${r.name || r.id} (${r.kind}) — ${memberCount.cnt} members`);
+        if (teams.length > 0) {
+            console.log(`\n🏠 Teams`);
+            const rows = teams.map(t => {
+                const cnt = db.prepare('SELECT COUNT(*) as cnt FROM team_members WHERE team_id = ?').get(t.id).cnt;
+                return [t.name, String(cnt)];
+            });
+            console.log(renderTable(['NAME', 'MEMBERS'], rows, '   '));
+        }
+        if (peers.length > 0) {
+            console.log(`\n🤝 Peers`);
+            const rows = peers.map(p => [
+                p.name, p.node_name || '-', p.status, p.exposed || '-', relativeTime(p.last_seen),
+            ]);
+            console.log(renderTable(['NAME', 'NODE', 'STATUS', 'EXPOSED', 'LAST SEEN'], rows, '   '));
+            if (remotes.length > 0) {
+                console.log(`\n🌐 Remote agents (placeholders)`);
+                const rrows = remotes.map(a => [
+                    a.id.slice(0, 12), a.display_name, a.origin_peer, a.status, relativeTime(a.last_seen),
+                ]);
+                console.log(renderTable(['ID', 'NAME', 'PEER', 'STATUS', 'LAST SEEN'], rrows, '   '));
             }
         }
     }
-    catch (err) {
+    catch {
         console.log(`\n⚠️  Cannot read database`);
     }
 }
@@ -187,40 +325,80 @@ async function cmdDbClear() {
 }
 async function cmdAgentRemove() {
     const { dbPath } = parseFlags(1);
-    const name = args[2];
-    if (!name) {
-        console.log('Usage: kitty-hive agent remove <name>');
+    const target = args[2];
+    if (!target) {
+        console.log('Usage: kitty-hive agent remove <name-or-id>');
         process.exit(1);
     }
     const db = initDB(dbPath);
-    const agent = db.prepare('SELECT id, display_name FROM agents WHERE display_name = ?').get(name);
-    if (!agent) {
-        console.log(`Agent "${name}" not found.`);
+    const matches = db.prepare('SELECT id, display_name FROM agents WHERE id = ? OR display_name = ?').all(target, target);
+    if (matches.length === 0) {
+        console.log(`Agent "${target}" not found.`);
         process.exit(1);
     }
+    if (matches.length > 1) {
+        console.log(`"${target}" matches ${matches.length} agents. Use id to disambiguate.`);
+        for (const m of matches)
+            console.log(`  ${m.id}  ${m.display_name}`);
+        process.exit(1);
+    }
+    const agent = matches[0];
+    const name = agent.display_name;
     const confirm = await ask(`Remove agent "${name}" and all related data? (y/n)`, 'n');
     if (confirm.toLowerCase() !== 'y') {
         console.log('Cancelled.');
         process.exit(0);
     }
+    // Delete in dependency order to satisfy foreign keys
     db.prepare('DELETE FROM read_cursors WHERE agent_id = ?').run(agent.id);
+    // Tasks
+    db.prepare(`DELETE FROM task_events WHERE task_id IN (SELECT id FROM tasks WHERE creator_agent_id = ?)`).run(agent.id);
     db.prepare('DELETE FROM task_events WHERE actor_agent_id = ?').run(agent.id);
-    db.prepare('DELETE FROM room_events WHERE actor_agent_id = ?').run(agent.id);
+    db.prepare('DELETE FROM tasks WHERE creator_agent_id = ?').run(agent.id);
     db.prepare('UPDATE tasks SET assignee_agent_id = NULL WHERE assignee_agent_id = ?').run(agent.id);
+    // DMs
+    db.prepare('DELETE FROM dm_messages WHERE from_agent_id = ? OR to_agent_id = ?').run(agent.id, agent.id);
+    // Team membership + events
+    db.prepare('DELETE FROM team_members WHERE agent_id = ?').run(agent.id);
+    db.prepare('DELETE FROM team_events WHERE actor_agent_id = ?').run(agent.id);
+    // Teams hosted by this agent (and their content)
+    db.prepare(`DELETE FROM team_events WHERE team_id IN (SELECT id FROM teams WHERE host_agent_id = ?)`).run(agent.id);
+    db.prepare(`DELETE FROM team_members WHERE team_id IN (SELECT id FROM teams WHERE host_agent_id = ?)`).run(agent.id);
+    db.prepare(`DELETE FROM read_cursors WHERE target_id IN (SELECT id FROM teams WHERE host_agent_id = ?)`).run(agent.id);
+    db.prepare('DELETE FROM teams WHERE host_agent_id = ?').run(agent.id);
     db.prepare('DELETE FROM agents WHERE id = ?').run(agent.id);
     console.log(`✅ Removed agent "${name}".`);
 }
+async function cmdAgentRename() {
+    const { dbPath } = parseFlags(1);
+    const oldName = args[2];
+    const newName = args[3];
+    if (!oldName || !newName) {
+        console.log('Usage: kitty-hive agent rename <old-name> <new-name>');
+        process.exit(1);
+    }
+    const db = initDB(dbPath);
+    const matches = db.prepare('SELECT id FROM agents WHERE display_name = ? OR id = ?').all(oldName, oldName);
+    if (matches.length === 0) {
+        console.log(`Agent "${oldName}" not found.`);
+        process.exit(1);
+    }
+    if (matches.length > 1) {
+        console.log(`"${oldName}" matches ${matches.length} agents. Use agent id to disambiguate.`);
+        process.exit(1);
+    }
+    db.prepare('UPDATE agents SET display_name = ? WHERE id = ?').run(newName, matches[0].id);
+    console.log(`✅ Renamed "${oldName}" → "${newName}".`);
+}
 async function cmdAgentList() {
     const { dbPath } = parseFlags(1);
     const db = initDB(dbPath);
-    const agents = db.prepare('SELECT display_name, roles, status, last_seen FROM agents ORDER BY last_seen DESC').all();
+    const agents = db.prepare('SELECT id, display_name, tool, roles, status, last_seen FROM agents ORDER BY last_seen DESC').all();
     if (agents.length === 0) {
         console.log('No agents registered.');
         return;
     }
-    for (const a of agents) {
-        console.log(`  ${a.display_name} (${a.status}) roles=${a.roles || 'none'} last_seen=${a.last_seen}`);
-    }
+    console.log(renderTable(AGENT_HEADERS, agentRows(db, agents)));
 }
 // --- Node config ---
 function getConfigPath() {
@@ -244,7 +422,7 @@ function setNodeConfig(config) {
     writeFileSync(p, JSON.stringify({ ...existing, ...config }, null, 2) + '\n');
 }
 function getNodeName() {
-    return getNodeConfig().name || require('os').hostname().split('.')[0];
+    return getNodeConfig().name || hostname().split('.')[0];
 }
 // --- Peer commands ---
 async function cmdPeerAdd() {
@@ -292,6 +470,21 @@ async function cmdPeerAdd() {
     console.log(`   URL: ${peerUrl}`);
     console.log(`   Secret: ${secret}`);
     console.log(`   Exposed agents: ${exposed || 'none (use --expose to add)'}`);
+    // Verify reachability via /federation/ping
+    process.stdout.write(`   Pinging…`);
+    const result = await pingPeer(peerName, peerUrl, secret, 5000);
+    if (result.ok) {
+        if (result.node)
+            setPeerNodeName(peerName, result.node);
+        setPeerStatus(peerName, 'active');
+        touchPeer(peerName);
+        console.log(` ok (node="${result.node}")`);
+    }
+    else {
+        setPeerStatus(peerName, 'inactive');
+        console.log(` failed: ${result.error}`);
+        console.log(`   (peer record kept; will retry on next heartbeat once server is reachable)`);
+    }
     console.log(`\n   Give this secret to the peer so they can connect back.`);
 }
 async function cmdPeerList() {
@@ -302,11 +495,15 @@ async function cmdPeerList() {
         console.log('No peers configured.');
         return;
     }
-    for (const p of peers) {
-        console.log(`  ${p.name} (${p.status}) — ${p.url}`);
-        console.log(`    exposed: ${p.exposed || 'none'}`);
-        console.log(`    last seen: ${p.last_seen || 'never'}`);
-    }
+    const rows = peers.map(p => [
+        p.name,
+        p.node_name || '-',
+        p.status,
+        p.url,
+        p.exposed || '-',
+        relativeTime(p.last_seen),
+    ]);
+    console.log(renderTable(['NAME', 'NODE', 'STATUS', 'URL', 'EXPOSED', 'LAST SEEN'], rows));
 }
 async function cmdPeerRemove() {
     const { dbPath } = parseFlags(1);
@@ -358,6 +555,18 @@ async function cmdPeerExpose() {
     updatePeerExposed(peerName, current.join(','));
     console.log(`✅ Peer "${peerName}" exposed agents: ${current.join(', ') || 'none'}`);
 }
+async function cmdFilesClean() {
+    let maxAgeDays = 7;
+    for (let i = 2; i < args.length; i++) {
+        if ((args[i] === '--days' || args[i] === '-d') && args[i + 1]) {
+            maxAgeDays = parseInt(args[i + 1], 10) || 7;
+            i++;
+        }
+    }
+    const { cleanupOldFiles } = await import('./federation-http.js');
+    const result = cleanupOldFiles(maxAgeDays);
+    console.log(`✅ Removed ${result.removed} federation file(s) older than ${maxAgeDays} day(s); kept ${result.kept}.`);
+}
 async function cmdConfigSet() {
     // kitty-hive config set name marvin
     const key = args[2];
@@ -382,23 +591,25 @@ function getDefaultAgentName() {
         catch { /* ignore */ }
     }
     // Fallback to directory name
-    return process.cwd().split('/').pop() || 'agent';
+    return basename(process.cwd()) || 'agent';
 }
 function showHelp() {
     console.log(`🐝 kitty-hive — multi-agent collaboration server
 
 Usage:
   kitty-hive serve [--port 4123] [--db path] [-v|-q]     Start the server
-  kitty-hive init [name] [--port 4123] [--http]           Configure for this project
+  kitty-hive init <tool> [--port 4123]                    Write MCP config (claude|cursor|vscode|antigravity|all)
   kitty-hive status [--port 4123]                         Server & agent status
   kitty-hive agent list                                   List agents
+  kitty-hive agent rename <old> <new>                     Rename an agent
   kitty-hive agent remove <name>                          Remove an agent
   kitty-hive peer add <name> <url> [--expose a,b] [--secret s]  Add a peer
   kitty-hive peer list                                    List peers
   kitty-hive peer remove <name>                           Remove a peer
   kitty-hive peer expose <name> --add/--remove <agent>    Manage exposed agents
   kitty-hive config set <key> <value>                     Set config (e.g. name)
-  kitty-hive db clear [--db path]                         Clear the database`);
+  kitty-hive db clear [--db path]                         Clear the database
+  kitty-hive files clean [--days 7]                       Remove old federation transfer files`);
 }
 // --- Main ---
 switch (command) {
@@ -415,6 +626,9 @@ switch (command) {
         if (args[1] === 'remove') {
             cmdAgentRemove().catch(err => { console.error('Failed:', err); process.exit(1); });
         }
+        else if (args[1] === 'rename') {
+            cmdAgentRename().catch(err => { console.error('Failed:', err); process.exit(1); });
+        }
         else if (args[1] === 'list') {
             cmdAgentList().catch(err => { console.error('Failed:', err); process.exit(1); });
         }
@@ -455,6 +669,14 @@ switch (command) {
             showHelp();
         }
         break;
+    case 'files':
+        if (args[1] === 'clean') {
+            cmdFilesClean().catch(err => { console.error('Failed:', err); process.exit(1); });
+        }
+        else {
+            showHelp();
+        }
+        break;
     default:
         showHelp();
         break;