@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/commands-v2/handlers/files.js

@@ -0,0 +1,162 @@
+/**
+ * Files Command for REPL V2
+ *
+ * Shows files tracked during the session (read, modified, referenced).
+ * Supports multi-agent teams: shows files per agent.
+ */
+import pc from 'picocolors';
+// =============================================================================
+// Helpers
+// =============================================================================
+const TYPE_LABELS = {
+    read: pc.cyan('read'),
+    modified: pc.yellow('modified'),
+    referenced: pc.dim('referenced'),
+};
+const TYPE_ICONS = {
+    read: pc.cyan('R'),
+    modified: pc.yellow('M'),
+    referenced: pc.dim('~'),
+};
+function formatPath(filePath) {
+    const cwd = process.cwd();
+    if (filePath.startsWith(cwd + '/')) {
+        return filePath.slice(cwd.length + 1);
+    }
+    return filePath;
+}
+function formatFileEntry(access) {
+    const icon = TYPE_ICONS[access.type];
+    const displayPath = formatPath(access.path);
+    const parts = [`  [${icon}] ${displayPath}`];
+    if (access.lineCount !== undefined) {
+        parts.push(pc.dim(` (${String(access.lineCount)} lines)`));
+    }
+    if ('content' in access && access.content !== undefined) {
+        parts.push(pc.dim(' [cached]'));
+    }
+    return parts.join('');
+}
+function printFilesForAgent(ctx, agent, label, typeFilter) {
+    const tracker = agent.getFileTracker();
+    if (!tracker || tracker.size === 0) {
+        ctx.ui.print({ type: 'info', message: `${label}: No tracked files` });
+        return;
+    }
+    const filterOpts = typeFilter ? { type: typeFilter } : undefined;
+    const accesses = tracker.getAccesses(filterOpts);
+    if (accesses.length === 0) {
+        ctx.ui.print({
+            type: 'info',
+            message: `${label}: No ${typeFilter ?? ''} files`,
+        });
+        return;
+    }
+    const stats = tracker.getStats();
+    const lines = [];
+    lines.push('');
+    lines.push(pc.bold(label));
+    lines.push(pc.dim(`  ${String(stats.read)} read, ${String(stats.modified)} modified, ${String(stats.referenced)} referenced`));
+    lines.push('');
+    if (typeFilter) {
+        lines.push(`  ${TYPE_LABELS[typeFilter]} files:`);
+        for (const access of accesses) {
+            lines.push(formatFileEntry(access));
+        }
+    }
+    else {
+        // Group by type: modified first, then read, then referenced
+        const modified = accesses.filter((a) => a.type === 'modified');
+        const read = accesses.filter((a) => a.type === 'read');
+        const referenced = accesses.filter((a) => a.type === 'referenced');
+        if (modified.length > 0) {
+            lines.push(`  ${TYPE_LABELS.modified} (${String(modified.length)}):`);
+            for (const access of modified) {
+                lines.push(formatFileEntry(access));
+            }
+            lines.push('');
+        }
+        if (read.length > 0) {
+            lines.push(`  ${TYPE_LABELS.read} (${String(read.length)}):`);
+            for (const access of read) {
+                lines.push(formatFileEntry(access));
+            }
+            lines.push('');
+        }
+        if (referenced.length > 0) {
+            lines.push(`  ${TYPE_LABELS.referenced} (${String(referenced.length)}):`);
+            for (const access of referenced) {
+                lines.push(formatFileEntry(access));
+            }
+        }
+    }
+    ctx.ui.print({ type: 'raw-lines', lines });
+}
+// =============================================================================
+// /files Command
+// =============================================================================
+const filesCommand = {
+    name: 'files',
+    description: 'Show tracked file accesses',
+    details: 'Display files read, modified, or referenced during this session. ' +
+        'In multi-agent teams, shows files per agent.',
+    examples: [
+        { code: '/files', description: 'Show all tracked files' },
+        { code: '/files read', description: 'Show only files that were read' },
+        { code: '/files modified', description: 'Show only modified files' },
+        { code: '/files referenced', description: 'Show only referenced files' },
+    ],
+    execute(args, ctx) {
+        // Parse optional type filter
+        const trimmed = args.trim().toLowerCase();
+        let typeFilter;
+        if (trimmed === 'read' || trimmed === 'modified' || trimmed === 'referenced') {
+            typeFilter = trimmed;
+        }
+        else if (trimmed && trimmed !== '') {
+            ctx.ui.print({
+                type: 'warning',
+                message: `Unknown filter: "${trimmed}". Use: read, modified, referenced`,
+            });
+            return Promise.resolve(true);
+        }
+        // Collect all unique Agent instances (dedup by object identity)
+        const agentEntries = [];
+        const seen = new Set();
+        // Multi-agent: iterate all team agents
+        if (ctx.team) {
+            for (const teamAgent of ctx.team.getAll()) {
+                if (!teamAgent.agent)
+                    continue;
+                seen.add(teamAgent.agent);
+                const label = teamAgent.id === 'default'
+                    ? 'Lead Agent'
+                    : `$${teamAgent.id} (${teamAgent.displayName})`;
+                agentEntries.push({ label, agent: teamAgent.agent });
+            }
+        }
+        // Always check ctx.agent too — it may differ from team entries
+        // (e.g., REPL's active agent reference diverged after reinitialization)
+        if (ctx.agent && !seen.has(ctx.agent)) {
+            const label = ctx.team ? 'Active Agent' : 'Tracked Files';
+            agentEntries.push({ label, agent: ctx.agent });
+        }
+        if (agentEntries.length === 0) {
+            ctx.ui.print({ type: 'warning', message: 'Agent not available' });
+            return Promise.resolve(true);
+        }
+        let anyTracked = false;
+        for (const entry of agentEntries) {
+            const tracker = entry.agent.getFileTracker();
+            if (!tracker || tracker.size === 0)
+                continue;
+            anyTracked = true;
+            printFilesForAgent(ctx, entry.agent, entry.label, typeFilter);
+        }
+        if (!anyTracked) {
+            ctx.ui.print({ type: 'info', message: 'No tracked files' });
+        }
+        return Promise.resolve(true);
+    },
+};
+export const filesCommands = [filesCommand];

package/dist/commands-v2/handlers/filter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Conversation Filter Command Handler
+ *
+ * Filters the conversation display to show only specific agents.
+ * The filter is display-only - full history is preserved.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const filterCommand: CommandHandlerV2;
+export declare const filterCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/filter.js

@@ -0,0 +1,130 @@
+/**
+ * Conversation Filter Command Handler
+ *
+ * Filters the conversation display to show only specific agents.
+ * The filter is display-only - full history is preserved.
+ */
+import { FilterOverlayV2 } from '../../ui/overlay/impl/filter-overlay-v2.js';
+// =============================================================================
+// Filter Command
+// =============================================================================
+export const filterCommand = {
+    name: 'filter',
+    aliases: ['f'],
+    description: 'Filter conversation to show only specific agents',
+    details: 'Shows only messages from selected agents. The filter is display-only - full history is preserved. Use /filter --clear or /f to show all messages again.',
+    examples: [
+        { code: '/filter', description: 'Open filter overlay' },
+        { code: '/f', description: 'Open filter overlay (alias)' },
+        { code: '/filter $arch', description: 'Show only $arch messages' },
+        { code: '/filter $arch $dev', description: 'Show $arch and $dev messages' },
+        { code: '/filter --clear', description: 'Clear filter, show all messages' },
+    ],
+    interactions: [
+        'Space to toggle agent selection',
+        'a to select all agents',
+        'n to deselect all agents',
+        'Enter to apply filter',
+        'Esc to cancel',
+    ],
+    async execute(args, ctx) {
+        // Handle --clear flag
+        if (args.trim() === '--clear') {
+            ctx.ui.clearConversationFilter();
+            ctx.ui.print({
+                type: 'info',
+                message: 'Conversation filter cleared - showing all messages',
+            });
+            return true;
+        }
+        // Handle quick filter with agent names: /filter $arch $dev
+        const agentArgs = args.trim();
+        if (agentArgs) {
+            // Parse agent IDs from args (e.g., "$arch $dev" or "arch dev")
+            const agentIds = agentArgs
+                .split(/\s+/)
+                .map(arg => arg.replace(/^\$/, '').toLowerCase())
+                .filter(id => id.length > 0);
+            if (agentIds.length > 0) {
+                // Validate agent IDs exist in team
+                if (ctx.team) {
+                    const validIds = agentIds.filter(id => ctx.team?.has(id));
+                    const invalidIds = agentIds.filter(id => !ctx.team?.has(id));
+                    if (invalidIds.length > 0) {
+                        ctx.ui.print({
+                            type: 'warning',
+                            message: `Unknown agents: ${invalidIds.map(id => `$${id}`).join(', ')}`,
+                        });
+                    }
+                    if (validIds.length > 0) {
+                        ctx.ui.setConversationFilter(validIds);
+                        ctx.ui.print({
+                            type: 'info',
+                            message: `Filtering to: ${validIds.map(id => `$${id}`).join(', ')}`,
+                        });
+                        return true;
+                    }
+                }
+                else {
+                    // No team, just apply filter
+                    ctx.ui.setConversationFilter(agentIds);
+                    ctx.ui.print({
+                        type: 'info',
+                        message: `Filtering to: ${agentIds.map(id => `$${id}`).join(', ')}`,
+                    });
+                    return true;
+                }
+            }
+        }
+        // No args - show overlay
+        if (!ctx.team) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'No team agents available. Use /filter $agent to filter manually.',
+            });
+            return true;
+        }
+        // Get current filter state
+        const currentFilter = ctx.ui.getConversationFilter();
+        // Get all agent IDs from team
+        const allAgents = ctx.team.getAgentIds().map(id => {
+            const agent = ctx.team?.get(id);
+            return {
+                id,
+                displayName: agent?.displayName ?? id,
+                mascot: agent?.mascot ?? '[•_•]',
+                selected: currentFilter.isActive ? currentFilter.agentIds.includes(id) : true,
+            };
+        });
+        // Show overlay
+        const overlay = new FilterOverlayV2({
+            agents: allAgents,
+            currentFilter: currentFilter.agentIds,
+        });
+        const result = await ctx.ui.showOverlay(overlay);
+        if (result && result.type === 'apply') {
+            if (result.agentIds.length === 0 || result.agentIds.length === allAgents.length) {
+                // All or none selected = clear filter
+                ctx.ui.clearConversationFilter();
+                ctx.ui.print({
+                    type: 'info',
+                    message: 'Conversation filter cleared - showing all messages',
+                });
+            }
+            else {
+                ctx.ui.setConversationFilter(result.agentIds);
+                ctx.ui.print({
+                    type: 'info',
+                    message: `Filtering to: ${result.agentIds.map(id => `$${id}`).join(', ')}`,
+                });
+            }
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Export
+// =============================================================================
+export const filterCommands = [
+    filterCommand,
+];

package/dist/commands-v2/handlers/games.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Games Command Handler
+ *
+ * Hidden easter egg - terminal arcade games!
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const gamesCommand: CommandHandlerV2;

package/dist/commands-v2/handlers/games.js

@@ -0,0 +1,57 @@
+/**
+ * Games Command Handler
+ *
+ * Hidden easter egg - terminal arcade games!
+ */
+import { GamesOverlayV2 } from '../../ui/overlay/index.js';
+import { checkDailyBonus } from '../../games/index.js';
+// =============================================================================
+// Games Command
+// =============================================================================
+export const gamesCommand = {
+    name: 'games',
+    aliases: ['arcade', 'play'],
+    description: 'Open the arcade',
+    details: 'Hidden easter egg! Play classic arcade games. Earn coins by being productive with the CLI.',
+    examples: [
+        { code: '/games', description: 'Open the arcade menu' },
+        { code: '/arcade', description: 'Alias' },
+    ],
+    interactions: [
+        '↑/↓ to select a game',
+        'Enter to play (costs 1 coin)',
+        'Q to exit',
+    ],
+    // Note: Easter egg - could add hidden flag to CommandHandlerV2 if needed
+    async execute(_args, ctx) {
+        // Check for daily bonus (only on first open)
+        let gotDailyBonus = checkDailyBonus();
+        let keepPlaying = true;
+        // Loop: show arcade, play game, return to arcade
+        while (keepPlaying) {
+            // Show overlay (displays coins, bonus notification, and game selection)
+            const overlay = new GamesOverlayV2({ gotDailyBonus });
+            const result = await ctx.ui.showOverlay(overlay);
+            // Clear daily bonus notification after first display
+            gotDailyBonus = false;
+            if (result?.action === 'play' && result.game) {
+                // Pause the UI completely - game will take over stdin
+                ctx.ui.pauseAnimation();
+                try {
+                    // Play the game (runs in alternate screen with its own input handling)
+                    await result.game.play();
+                }
+                finally {
+                    // Resume UI input handling
+                    ctx.ui.resumeAnimation();
+                }
+                // After game ends, loop back to show arcade again
+            }
+            else {
+                // User closed arcade (pressed Q or Escape)
+                keepPlaying = false;
+            }
+        }
+        return true;
+    },
+};

package/dist/commands-v2/handlers/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Command Handlers Index for REPL V2
+ *
+ * Re-exports all handler modules and provides allCommands array.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export * from './core.js';
+export * from './settings.js';
+export * from './context.js';
+export * from './project.js';
+export * from './debug.js';
+export * from './session.js';
+export * from './reset.js';
+export * from './team.js';
+export * from './games.js';
+export * from './tasks.js';
+export * from './background.js';
+export * from './filter.js';
+export * from './auth.js';
+export * from './files.js';
+export * from './terminals.js';
+export * from './notifications.js';
+export * from './mcp.js';
+export * from './delegations.js';
+export declare const allCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/index.js

@@ -0,0 +1,63 @@
+/**
+ * Command Handlers Index for REPL V2
+ *
+ * Re-exports all handler modules and provides allCommands array.
+ */
+import { coreCommands } from './core.js';
+import { settingsCommands } from './settings.js';
+import { contextCommands } from './context.js';
+import { projectCommands } from './project.js';
+import { debugCommands } from './debug.js';
+import { sessionCommands } from './session.js';
+import { resetCommands } from './reset.js';
+import { teamCommands } from './team.js';
+import { gamesCommand } from './games.js';
+import { tasksCommand } from './tasks.js';
+import { backgroundCommands } from './background.js';
+import { filterCommands } from './filter.js';
+import { authCommands } from './auth.js';
+import { filesCommands } from './files.js';
+import { terminalsCommands } from './terminals.js';
+import { notificationsCommands } from './notifications.js';
+import { mcpCommands } from './mcp.js';
+import { delegationsCommands } from './delegations.js';
+// Re-export individual modules
+export * from './core.js';
+export * from './settings.js';
+export * from './context.js';
+export * from './project.js';
+export * from './debug.js';
+export * from './session.js';
+export * from './reset.js';
+export * from './team.js';
+export * from './games.js';
+export * from './tasks.js';
+export * from './background.js';
+export * from './filter.js';
+export * from './auth.js';
+export * from './files.js';
+export * from './terminals.js';
+export * from './notifications.js';
+export * from './mcp.js';
+export * from './delegations.js';
+// All commands combined
+export const allCommands = [
+    ...coreCommands,
+    ...settingsCommands,
+    ...contextCommands,
+    ...projectCommands,
+    ...debugCommands,
+    ...sessionCommands,
+    ...resetCommands,
+    ...teamCommands,
+    gamesCommand,
+    tasksCommand,
+    ...backgroundCommands,
+    ...filterCommands,
+    ...authCommands,
+    ...filesCommands,
+    ...terminalsCommands,
+    ...notificationsCommands,
+    ...mcpCommands,
+    ...delegationsCommands,
+];

package/dist/commands-v2/handlers/mcp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Command for REPL V2
+ *
+ * Shows the MCP servers overlay for viewing connected servers,
+ * their tools, and managing connections.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const mcpCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/mcp.js

@@ -0,0 +1,39 @@
+/**
+ * MCP Command for REPL V2
+ *
+ * Shows the MCP servers overlay for viewing connected servers,
+ * their tools, and managing connections.
+ */
+import { MCPOverlayV2 } from '../../ui/overlay/impl/mcp-overlay-v2.js';
+import { getMCPManager, ensureMCPManager } from '../../index.js';
+import { getMCPConfigPath } from '../../settings/mcp-config.js';
+import { getActiveProject } from '../../tools/project-db.js';
+// =============================================================================
+// /mcp Command
+// =============================================================================
+const mcpCommand = {
+    name: 'mcp',
+    description: 'View MCP servers and tools',
+    details: 'Opens the MCP (Model Context Protocol) servers overlay. ' +
+        'View connected servers, their discovered tools, and manage connections. ' +
+        `Configure servers in ${getMCPConfigPath()}.`,
+    examples: [
+        { code: '/mcp', description: 'Show MCP servers dashboard' },
+    ],
+    interactions: [
+        'Enter to view server details and tools',
+        'a to add a new server',
+        'r to restart a server',
+        'd to disconnect a server',
+        '/ to search',
+        'Esc to close',
+    ],
+    async execute(_args, ctx) {
+        const manager = getMCPManager();
+        const project = getActiveProject();
+        const overlay = new MCPOverlayV2(manager, ctx.agent ?? null, ensureMCPManager, project?.path);
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+export const mcpCommands = [mcpCommand];

package/dist/commands-v2/handlers/notifications.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Notifications Command Handler
+ *
+ * Shows cross-session notifications from other terminals.
+ * Opens an interactive overlay when unread notifications exist.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const notificationsCommand: CommandHandlerV2;
+export declare const notificationsCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/notifications.js

@@ -0,0 +1,34 @@
+/**
+ * Notifications Command Handler
+ *
+ * Shows cross-session notifications from other terminals.
+ * Opens an interactive overlay when unread notifications exist.
+ */
+import { getNotificationManager } from '../../multi-agent/notification-manager.js';
+import { NotificationsOverlayV2 } from '../../ui/overlay/impl/notifications-overlay-v2.js';
+export const notificationsCommand = {
+    name: 'notifications',
+    aliases: ['notif'],
+    description: 'Show cross-session notifications',
+    details: 'Lists unread notifications from other terminal sessions (e.g. background agent completions, pending approval requests).',
+    examples: [
+        { code: '/notifications', description: 'View unread notifications' },
+        { code: '/notif', description: 'Alias for /notifications' },
+    ],
+    async execute(_args, ctx) {
+        const manager = getNotificationManager();
+        if (!manager) {
+            ctx.ui.print({ type: 'info', message: 'Notification manager not available.' });
+            return true;
+        }
+        const count = manager.getUnreadCount();
+        if (count === 0) {
+            ctx.ui.print({ type: 'info', message: 'No unread notifications.' });
+            return true;
+        }
+        const overlay = new NotificationsOverlayV2();
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+export const notificationsCommands = [notificationsCommand];

package/dist/commands-v2/handlers/project.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Project Commands for REPL V2
+ *
+ * Commands for project management: init, backlog, workflow, anchors, design, sketch, refine
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const newCommand: CommandHandlerV2;
+export declare const initCommand: CommandHandlerV2;
+export declare const backlogCommand: CommandHandlerV2;
+export declare const workflowCommand: CommandHandlerV2;
+export declare const anchorsCommand: CommandHandlerV2;
+export declare const designCommand: CommandHandlerV2;
+export declare const sketchCommand: CommandHandlerV2;
+export declare const refineCommand: CommandHandlerV2;
+export declare const buildCommand: CommandHandlerV2;
+export declare const noteCommand: CommandHandlerV2;
+export declare const prdCommand: CommandHandlerV2;
+export declare const scaffoldCommand: CommandHandlerV2;
+export declare const archCommand: CommandHandlerV2;
+export declare const docsCommand: CommandHandlerV2;
+export declare const projectsCommand: CommandHandlerV2;
+export declare const projectCommands: CommandHandlerV2[];