spidersan 0.2.2

package/dist/commands/wake.js

@@ -0,0 +1,188 @@
+/**
+ * spidersan wake
+ *
+ * Start a session with branch context.
+ * "Weaving into the Web" - the spider feels its threads.
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { execa } from 'execa';
+import { getStorage } from '../storage/index.js';
+function getCurrentBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function getGitBranches() {
+    try {
+        const output = execSync('git branch --format="%(refname:short)"', { encoding: 'utf-8' });
+        return output.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function hasMycmail() {
+    try {
+        execSync('which mycmail', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function getInboxCount() {
+    try {
+        const result = await execa('mycmail', ['inbox', '--count'], {
+            timeout: 10000, // 10 second timeout
+            reject: false,
+        });
+        const match = result.stdout?.match(/(\d+)/);
+        return match ? parseInt(match[1], 10) : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export const wakeCommand = new Command('wake')
+    .description('Start a session - weave into the web, feel the threads')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output')
+    .option('--skip-mail', 'Skip mycmail integration')
+    .action(async (options) => {
+    const storage = await getStorage();
+    const currentBranch = getCurrentBranch();
+    const result = {
+        synced: 0,
+        branches: [],
+        conflicts: [],
+        inboxCount: 0,
+        mycmailCalled: false,
+    };
+    // Step 1: Sync registry with git (remove orphaned branches)
+    if (await storage.isInitialized()) {
+        const gitBranches = new Set(getGitBranches());
+        const registeredBranches = await storage.list();
+        for (const branch of registeredBranches) {
+            if (!gitBranches.has(branch.name) && branch.status === 'active') {
+                await storage.unregister(branch.name);
+                result.synced++;
+            }
+        }
+        // Get current branches after sync
+        const branches = await storage.list();
+        result.branches = branches
+            .filter(b => b.status === 'active')
+            .map(b => ({ name: b.name, files: b.files, status: b.status, agent: b.agent }));
+        // Step 2: Check conflicts for current branch
+        if (currentBranch) {
+            const target = await storage.get(currentBranch);
+            if (target) {
+                for (const branch of branches) {
+                    if (branch.name === currentBranch || branch.status !== 'active')
+                        continue;
+                    const overlappingFiles = branch.files.filter(f => target.files.includes(f));
+                    if (overlappingFiles.length > 0) {
+                        result.conflicts.push({ branch: branch.name, files: overlappingFiles, agent: branch.agent });
+                    }
+                }
+            }
+        }
+    }
+    // Step 3: Call mycmail wake (with timeout protection!)
+    if (!options.skipMail && hasMycmail()) {
+        try {
+            await execa('mycmail', ['wake', '--quiet'], {
+                timeout: 30000, // 30 second timeout - prevents hanging!
+                reject: false, // Don't throw on non-zero exit
+            });
+            result.mycmailCalled = true;
+            result.inboxCount = await getInboxCount();
+        }
+        catch {
+            // Ignore mycmail errors - but we won't hang!
+        }
+    }
+    // JSON output
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    // Quiet output
+    if (options.quiet) {
+        console.log(`🕷️ Wake: ${result.branches.length} threads, ${result.conflicts.length} tensions`);
+        return;
+    }
+    // ═══════════════════════════════════════════════════════════
+    // CEREMONIAL OUTPUT: "Weaving into the Web"
+    // ═══════════════════════════════════════════════════════════
+    console.log('');
+    console.log('🕷️  Spidersan Awakens...');
+    console.log('');
+    console.log('   ╭─────────────────────────────────────╮');
+    console.log('   │  Feeling the threads...             │');
+    console.log('   ╰─────────────────────────────────────╯');
+    console.log('');
+    // Web status
+    const agentCount = new Set(result.branches.map(b => b.agent).filter(Boolean)).size;
+    console.log('   📡 Web Status:');
+    console.log(`      • ${result.branches.length} thread${result.branches.length !== 1 ? 's' : ''} active`);
+    if (agentCount > 0) {
+        console.log(`      • ${agentCount} agent${agentCount !== 1 ? 's' : ''} weaving`);
+    }
+    if (result.synced > 0) {
+        console.log(`      • ${result.synced} broken thread${result.synced !== 1 ? 's' : ''} cleared`);
+    }
+    // Tensions (conflicts)
+    if (result.conflicts.length > 0) {
+        console.log('');
+        console.log(`   ⚠️  Tension${result.conflicts.length !== 1 ? 's' : ''} detected:`);
+        for (const conflict of result.conflicts) {
+            const agentInfo = conflict.agent ? ` (${conflict.agent})` : '';
+            console.log(`      └─ ${conflict.files[0]}${agentInfo}`);
+            if (conflict.files.length > 1) {
+                console.log(`         +${conflict.files.length - 1} more file${conflict.files.length > 2 ? 's' : ''}`);
+            }
+        }
+    }
+    // Active threads
+    if (result.branches.length > 0) {
+        console.log('');
+        console.log('   🕸️  Active Threads:');
+        for (const branch of result.branches.slice(0, 4)) {
+            const isCurrent = branch.name === currentBranch ? ' ← you' : '';
+            const agentInfo = branch.agent && branch.name !== currentBranch ? ` (${branch.agent})` : '';
+            console.log(`      • ${branch.name}${agentInfo}${isCurrent}`);
+        }
+        if (result.branches.length > 4) {
+            console.log(`      • ...and ${result.branches.length - 4} more`);
+        }
+    }
+    // Messages
+    if (result.mycmailCalled) {
+        console.log('');
+        if (result.inboxCount > 0) {
+            console.log(`   📬 ${result.inboxCount} message${result.inboxCount !== 1 ? 's' : ''} waiting`);
+        }
+        else {
+            console.log('   📭 No new messages');
+        }
+    }
+    // Closing
+    console.log('');
+    if (result.conflicts.length === 0) {
+        console.log('   ╭─────────────────────────────────────╮');
+        console.log('   │  The web is calm. Ready to hunt. 🎯 │');
+        console.log('   ╰─────────────────────────────────────╯');
+    }
+    else {
+        console.log('   ╭─────────────────────────────────────╮');
+        console.log('   │  Tensions on the web. Tread softly. │');
+        console.log('   ╰─────────────────────────────────────╯');
+    }
+    console.log('');
+});
+//# sourceMappingURL=wake.js.map

package/dist/commands/wake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake.js","sourceRoot":"","sources":["../../src/commands/wake.ts"],"names":[],"mappings":"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"}

package/dist/commands/watch.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const watchCommand: Command;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqEpC,eAAO,MAAM,YAAY,SAuNnB,CAAC"}

package/dist/commands/watch.js

@@ -0,0 +1,245 @@
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { getStorage } from '../storage/index.js';
+import * as chokidar from 'chokidar';
+import * as path from 'path';
+import { io } from 'socket.io-client';
+// Config
+const HUB_URL = process.env.HUB_URL || 'https://hub.treebird.uk';
+const DEBOUNCE_MS = 1000; // Debounce file changes
+function getCurrentBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        throw new Error('Not in a git repository');
+    }
+}
+function getRepoRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+// Post conflict warning to Hub chat API
+async function postConflictToChat(branch, agent, conflicts) {
+    const conflictDetails = conflicts
+        .map(c => `• **${c.branch}**: ${c.files.join(', ')}`)
+        .join('\n');
+    const message = `🕷️⚠️ **CONFLICT DETECTED** on branch \`${branch}\`\n\n${conflictDetails}`;
+    try {
+        const response = await fetch(`${HUB_URL}/api/chat`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                agent: 'ssan',
+                name: 'Spidersan',
+                message,
+                glyph: '🕷️'
+            })
+        });
+        if (!response.ok) {
+            console.log(`⚠️ Failed to post to Hub chat: ${response.status}`);
+        }
+    }
+    catch (err) {
+        // Silently fail - Hub might not be running
+    }
+}
+export const watchCommand = new Command('watch')
+    .description('🕷️ Watch files and auto-register changes (daemon mode)')
+    .argument('[directory]', 'Directory to watch (default: current repo)')
+    .option('-d, --dir <directory>', 'Directory to watch (alias for positional arg)')
+    .option('-a, --agent <agent>', 'Agent identifier for registration')
+    .option('--hub', 'Connect to Hub and emit real-time conflict warnings')
+    .option('--hub-sync', 'Post conflicts to Hub chat via REST API')
+    .option('-q, --quiet', 'Only log conflicts, not file changes')
+    .option('--legacy', 'Legacy mode: use old watcher settings (more file descriptors)')
+    .action(async (directory, options) => {
+    const storage = await getStorage();
+    if (!await storage.isInitialized()) {
+        console.error('❌ Spidersan not initialized. Run: spidersan init');
+        process.exit(1);
+    }
+    const branch = getCurrentBranch();
+    const repoRoot = directory || options.dir || getRepoRoot();
+    const agent = options.agent || process.env.SPIDERSAN_AGENT || 'unknown';
+    console.log(`
+🕷️ SPIDERSAN WATCH MODE
+━━━━━━━━━━━━━━━━━━━━━━━
+Branch:    ${branch}
+Agent:     ${agent}
+Watching:  ${repoRoot}
+Hub:       ${options.hub ? HUB_URL : 'disabled'}
+Hub Sync:  ${options.hubSync ? 'enabled (posts to chat)' : 'disabled'}
+━━━━━━━━━━━━━━━━━━━━━━━
+Press Ctrl+C to stop.
+        `);
+    // Hub socket connection (optional)
+    let hubSocket = null;
+    if (options.hub) {
+        try {
+            hubSocket = io(HUB_URL, {
+                reconnection: true,
+                reconnectionAttempts: 5,
+                timeout: 5000
+            });
+            hubSocket.on('connect', () => {
+                console.log('🔌 Connected to Hub');
+            });
+            hubSocket.on('disconnect', () => {
+                console.log('🔌 Disconnected from Hub');
+            });
+            hubSocket.on('connect_error', (err) => {
+                if (!options.quiet) {
+                    console.log(`⚠️ Hub connection failed: ${err.message}`);
+                }
+            });
+        }
+        catch (e) {
+            console.log('⚠️ Could not connect to Hub');
+        }
+    }
+    // Track recently changed files for debouncing
+    const pendingFiles = new Set();
+    let debounceTimer = null;
+    // Process accumulated file changes
+    async function processChanges() {
+        if (pendingFiles.size === 0)
+            return;
+        const files = Array.from(pendingFiles);
+        pendingFiles.clear();
+        // Register files
+        const existing = await storage.get(branch);
+        const allFiles = existing
+            ? [...new Set([...existing.files, ...files])]
+            : files;
+        if (existing) {
+            await storage.update(branch, { files: allFiles, agent });
+        }
+        else {
+            await storage.register({
+                name: branch,
+                files: allFiles,
+                status: 'active',
+                agent,
+            });
+        }
+        if (!options.quiet) {
+            console.log(`📝 Registered: ${files.join(', ')}`);
+        }
+        // Check for conflicts
+        const allBranches = await storage.list();
+        const conflicts = [];
+        for (const otherBranch of allBranches) {
+            if (otherBranch.name === branch || otherBranch.status !== 'active')
+                continue;
+            const overlapping = files.filter(f => otherBranch.files.includes(f));
+            if (overlapping.length > 0) {
+                conflicts.push({ branch: otherBranch.name, files: overlapping });
+            }
+        }
+        if (conflicts.length > 0) {
+            console.log(`\n⚠️ CONFLICT DETECTED!`);
+            conflicts.forEach(c => {
+                console.log(`   🔴 ${c.branch}: ${c.files.join(', ')}`);
+            });
+            console.log('');
+            // Emit to Hub via socket if connected
+            if (hubSocket?.connected) {
+                hubSocket.emit('conflicts:warning', {
+                    branch,
+                    agent,
+                    files,
+                    conflicts,
+                    timestamp: new Date().toISOString()
+                });
+            }
+            // Post to Hub chat if --hub-sync enabled
+            if (options.hubSync) {
+                await postConflictToChat(branch, agent, conflicts);
+                console.log('📤 Posted conflict to Hub chat');
+            }
+        }
+    }
+    // Build extended ignore patterns for smart mode
+    const smartIgnores = [
+        '**/.next/**', '**/build/**', '**/out/**', '**/coverage/**',
+        '**/.cache/**', '**/__pycache__/**', '**/target/**',
+        '**/vendor/**', '**/bower_components/**', '**/.pnpm/**',
+        '**/.idea/**', '**/.vscode/**', '**/*.swp', '**/*.swo',
+        '**/.DS_Store', '**/Thumbs.db',
+        '**/package-lock.json', '**/yarn.lock', '**/pnpm-lock.yaml',
+        '**/*.png', '**/*.jpg', '**/*.jpeg', '**/*.gif', '**/*.ico',
+        '**/*.woff', '**/*.woff2', '**/*.ttf', '**/*.pdf',
+    ];
+    if (options.legacy) {
+        console.log('⚠️ Legacy mode: Using old watcher settings (more file descriptors)');
+    }
+    // Start watching
+    // SECURITY FIX: Always limit depth to prevent EMFILE errors (Sherlocksan 2026-01-02)
+    const watcher = chokidar.watch(repoRoot, {
+        ignored: !options.legacy ? [
+            ...smartIgnores,
+            /(^|[/\\])\../, // dotfiles
+            '**/node_modules/**',
+            '**/dist/**',
+            '**/*.log',
+            '**/.git/**', // ALWAYS ignore .git
+        ] : [
+            /(^|[/\\])\../, // dotfiles (ALWAYS ignore)
+            '**/node_modules/**',
+            '**/dist/**',
+            '**/*.log',
+            '**/.git/**', // ALWAYS ignore .git
+        ],
+        persistent: true,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 500,
+            pollInterval: 100
+        },
+        // ALWAYS limit depth to prevent EMFILE (default: 5, legacy: 10)
+        depth: !options.legacy ? 5 : 10,
+        // Smart mode (default): use polling to reduce file descriptor usage
+        ...(!options.legacy && {
+            usePolling: true,
+            interval: 1000, // Check every 1 second
+            binaryInterval: 3000,
+        })
+    });
+    watcher.on('change', (filePath) => {
+        const relativePath = path.relative(repoRoot, filePath);
+        pendingFiles.add(relativePath);
+        // Debounce: wait for more changes before processing
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(processChanges, DEBOUNCE_MS);
+    });
+    watcher.on('add', (filePath) => {
+        const relativePath = path.relative(repoRoot, filePath);
+        pendingFiles.add(relativePath);
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(processChanges, DEBOUNCE_MS);
+    });
+    watcher.on('error', (err) => {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        console.error(`❌ Watcher error: ${errorMsg}`);
+    });
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        console.log('\n🕷️ Watch mode stopped.');
+        watcher.close();
+        hubSocket?.disconnect();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        watcher.close();
+        hubSocket?.disconnect();
+        process.exit(0);
+    });
+});
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"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"}

package/dist/commands/who-touched.d.ts

@@ -0,0 +1,9 @@
+/**
+ * spidersan who-touched <file>
+ *
+ * Show git history of who touched a file, enriched with agent info.
+ * Quick forensics for multi-agent coordination.
+ */
+import { Command } from 'commander';
+export declare const whoTouchedCommand: Command;
+//# sourceMappingURL=who-touched.d.ts.map

package/dist/commands/who-touched.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-touched.d.ts","sourceRoot":"","sources":["../../src/commands/who-touched.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+HpC,eAAO,MAAM,iBAAiB,SAyFxB,CAAC"}

package/dist/commands/who-touched.js

@@ -0,0 +1,186 @@
+/**
+ * spidersan who-touched <file>
+ *
+ * Show git history of who touched a file, enriched with agent info.
+ * Quick forensics for multi-agent coordination.
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+// Security: Input validation
+const VALID_FILE_PATH = /^[./a-zA-Z0-9][a-zA-Z0-9/_.@-]{0,200}$/;
+function validateFilePath(path) {
+    if (!VALID_FILE_PATH.test(path)) {
+        throw new Error(`Invalid file path: "${path.slice(0, 50)}..."`);
+    }
+    return path;
+}
+/**
+ * Extract agent ID from commit message or author
+ * Looks for patterns like:
+ *   - 🕷️ Spidersan: ...
+ *   - [mappersan] ...
+ *   - Author email containing agent name
+ */
+function extractAgentFromCommit(entry) {
+    const message = entry.subject.toLowerCase();
+    const author = entry.author.toLowerCase();
+    const email = entry.email.toLowerCase();
+    // Known agent patterns in commit messages
+    const agentPatterns = [
+        /🕷️\s*(\w+san)/i,
+        /🕵️\s*(\w+san)/i,
+        /🗺️\s*(\w+san)/i,
+        /🌊\s*(\w+san)/i,
+        /🐦\s*(\w+san)/i,
+        /🎨\s*(\w+san)/i,
+        /📣\s*(\w+san)/i,
+        /📿\s*(\w+san)/i,
+        /🍄\s*(\w+san)/i,
+        /🌳\s*(\w+san)/i,
+        /🥷\s*(\w+san)/i,
+        /\[(\w+san)\]/i,
+        /^(\w+san):/i,
+    ];
+    for (const pattern of agentPatterns) {
+        const match = message.match(pattern);
+        if (match)
+            return match[1].toLowerCase();
+    }
+    // Check author/email for agent names
+    const knownAgents = [
+        'spidersan', 'sherlocksan', 'mappersan', 'watsan', 'birdsan',
+        'artisan', 'marksan', 'yosef', 'myceliumail', 'sasusan', 'treesan'
+    ];
+    for (const agent of knownAgents) {
+        if (author.includes(agent) || email.includes(agent)) {
+            return agent;
+        }
+    }
+    return undefined;
+}
+function getAgentGlyph(agent) {
+    const glyphs = {
+        'spidersan': '🕷️',
+        'sherlocksan': '🕵️',
+        'mappersan': '🗺️',
+        'watsan': '🌊',
+        'birdsan': '🐦',
+        'artisan': '🎨',
+        'marksan': '📣',
+        'yosef': '📿',
+        'myceliumail': '🍄',
+        'sasusan': '🥷',
+        'treesan': '🌳',
+        'treebird': '🌳',
+    };
+    return glyphs[agent.toLowerCase()] || '👤';
+}
+function getFileHistory(filePath, limit) {
+    try {
+        // Use %x00 as delimiter for safety
+        const format = '%H%x00%h%x00%an%x00%ae%x00%ai%x00%ar%x00%s';
+        const output = execSync(`git log -n ${limit} --follow --format="${format}" -- "${filePath}"`, { encoding: 'utf-8', maxBuffer: 1024 * 1024 });
+        const entries = [];
+        const lines = output.trim().split('\n').filter(l => l);
+        for (const line of lines) {
+            const parts = line.split('\0');
+            if (parts.length >= 7) {
+                const entry = {
+                    hash: parts[0],
+                    shortHash: parts[1],
+                    author: parts[2],
+                    email: parts[3],
+                    date: parts[4],
+                    relativeDate: parts[5],
+                    subject: parts[6],
+                };
+                entry.agent = extractAgentFromCommit(entry);
+                entries.push(entry);
+            }
+        }
+        return entries;
+    }
+    catch (error) {
+        throw new Error(`Failed to get git history for "${filePath}"`);
+    }
+}
+export const whoTouchedCommand = new Command('who-touched')
+    .description('Show who touched a file (git history with agent detection)')
+    .argument('<file>', 'File path to check history for')
+    .option('-n, --limit <count>', 'Number of commits to show', '10')
+    .option('--json', 'Output as JSON')
+    .option('--agents-only', 'Only show commits from detected agents')
+    .option('--since <date>', 'Show commits since date (e.g., "2 days ago")')
+    .action(async (file, options) => {
+    // Validate input
+    const safePath = validateFilePath(file);
+    const limit = parseInt(options.limit, 10) || 10;
+    // Check if file exists or is tracked
+    if (!existsSync(safePath)) {
+        try {
+            execSync(`git ls-files --error-unmatch "${safePath}"`, {
+                encoding: 'utf-8',
+                stdio: 'pipe'
+            });
+        }
+        catch {
+            console.error(`❌ File not found: ${safePath}`);
+            process.exit(1);
+        }
+    }
+    let entries = getFileHistory(safePath, limit * 2); // Get extra to filter
+    // Filter by --agents-only
+    if (options.agentsOnly) {
+        entries = entries.filter(e => e.agent);
+    }
+    // Filter by --since
+    if (options.since) {
+        try {
+            const sinceDate = execSync(`date -d "${options.since}" +%s 2>/dev/null || date -j -f "%Y-%m-%d" "${options.since}" +%s`, { encoding: 'utf-8' }).trim();
+            const sinceTimestamp = parseInt(sinceDate, 10);
+            entries = entries.filter(e => {
+                const commitDate = new Date(e.date).getTime() / 1000;
+                return commitDate >= sinceTimestamp;
+            });
+        }
+        catch {
+            // If date parsing fails, skip the filter
+        }
+    }
+    // Limit results
+    entries = entries.slice(0, limit);
+    if (entries.length === 0) {
+        console.log(`🕷️ No history found for "${safePath}"`);
+        return;
+    }
+    if (options.json) {
+        console.log(JSON.stringify({ file: safePath, history: entries }, null, 2));
+        return;
+    }
+    // Count unique authors/agents
+    const authors = new Set(entries.map(e => e.author));
+    const agents = new Set(entries.filter(e => e.agent).map(e => e.agent));
+    console.log(`
+🕷️ WHO TOUCHED: ${safePath}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+    for (const entry of entries) {
+        const glyph = entry.agent ? getAgentGlyph(entry.agent) : '👤';
+        const agentTag = entry.agent ? ` (${entry.agent})` : '';
+        const subject = entry.subject.length > 50
+            ? entry.subject.slice(0, 47) + '...'
+            : entry.subject;
+        console.log(`${glyph} ${entry.shortHash} | ${entry.relativeDate.padEnd(15)} | ${entry.author}${agentTag}`);
+        console.log(`   └─ ${subject}`);
+    }
+    console.log(`
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 ${entries.length} commits | ${authors.size} authors | ${agents.size} agents detected
+`);
+    if (agents.size > 0) {
+        const agentList = Array.from(agents).map(a => `${getAgentGlyph(a)} ${a}`).join(' ');
+        console.log(`🤖 Agents: ${agentList}`);
+    }
+});
+//# sourceMappingURL=who-touched.js.map