@compilr-dev/cli 0.5.0 → 0.5.2

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

@@ -6,121 +6,269 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import pc from 'picocolors';
-// =============================================================================
-// Helper: Progress Bar
-// =============================================================================
-function renderProgressBar(ratio, width) {
-    const clamped = Math.max(0, Math.min(1, ratio));
-    const filled = Math.round(clamped * width);
-    const empty = width - filled;
-    const color = clamped > 0.9 ? pc.red : clamped > 0.7 ? pc.yellow : pc.green;
-    return color('█'.repeat(filled)) + pc.dim('░'.repeat(empty));
+import { getCompactMode } from '../../settings/index.js';
+import { renderProgressBar, formatTokens, truncate } from '../../ui/base/index.js';
+import { getStyles } from '../../themes/index.js';
+/**
+ * Print compaction results for a single agent
+ */
+function printCompactResult(ctx, result, beforeHistory, label) {
+    if (!result.success) {
+        const prefix = label ? `${label}: ` : '';
+        ctx.ui.print({ type: 'warning', message: `${prefix}Compaction not available` });
+        return;
+    }
+    const prefix = label ? `${label}: ` : '';
+    const statusParts = [];
+    // Token reduction
+    const originalTokens = result.originalTokens ?? 0;
+    const summaryTokens = result.summaryTokens ?? 0;
+    const reduction = originalTokens > 0 ? Math.round((1 - summaryTokens / originalTokens) * 100) : 0;
+    statusParts.push(`${prefix}Compacted: ${originalTokens.toLocaleString()} → ${summaryTokens.toLocaleString()} tokens (-${String(reduction)}%)`);
+    // Category actions
+    if (result.categoryStats) {
+        const actions = [];
+        if (result.categoryStats.toolResults.action === 'compacted') {
+            actions.push('tool results → files');
+        }
+        if (result.categoryStats.history.action === 'summarized') {
+            actions.push('history → summary');
+        }
+        if (actions.length > 0) {
+            statusParts.push(`${prefix}Actions: ${actions.join(', ')}`);
+        }
+    }
+    // Files created
+    if (result.filesCreated && result.filesCreated.length > 0) {
+        statusParts.push(`${prefix}Files created: ${String(result.filesCreated.length)}`);
+    }
+    // Restoration hints
+    if (result.restorationHintsInjected) {
+        statusParts.push(`${prefix}File tracking hints injected`);
+    }
+    // Tool results repaired
+    if (result.toolResultsRepaired && result.toolResultsRepaired > 0) {
+        statusParts.push(`${prefix}Orphaned tool results removed: ${String(result.toolResultsRepaired)}`);
+    }
+    for (const part of statusParts) {
+        ctx.ui.print({ type: 'success', message: part });
+    }
 }
-// =============================================================================
-// Compact Command
-// =============================================================================
 export const compactCommand = {
     name: 'compact',
     description: 'Summarize old messages to free context',
-    async execute(_args, ctx) {
-        // Check if agent is available
-        if (!ctx.agent) {
-            ctx.ui.print({ type: 'warning', message: 'Agent not available for compaction' });
-            return true;
+    details: 'When context is running low, use this to summarize older messages. Supports: /compact (default mode), /compact all, /compact auto, /compact $agentId',
+    examples: [
+        { code: '/compact', description: 'Use default compact mode from settings' },
+        { code: '/compact all', description: 'Compact all initialized agents' },
+        { code: '/compact auto', description: 'Compact agents above 70% utilization' },
+        { code: '/compact $pm', description: 'Compact a specific agent' },
+    ],
+    async execute(args, ctx) {
+        const trimmed = args.trim();
+        if (!trimmed) {
+            // Use default from settings
+            const mode = getCompactMode();
+            return compactByMode(mode, ctx);
         }
-        const contextManager = ctx.getContextManager?.();
-        if (!contextManager) {
-            ctx.ui.print({ type: 'warning', message: 'Context manager not available' });
-            return true;
+        if (trimmed === 'all') {
+            return compactByMode('all', ctx);
         }
-        const history = ctx.getHistory?.() ?? [];
-        if (history.length === 0) {
-            ctx.ui.print({ type: 'info', message: 'No conversation history to compact' });
-            return true;
+        if (trimmed === 'auto') {
+            return compactByMode('auto', ctx);
         }
-        // Show current stats
-        const stats = contextManager.getStats(history.length);
-        const pct = (stats.utilization * 100).toFixed(1);
-        ctx.ui.print({
-            type: 'info',
-            message: `Current: ${stats.currentTokens.toLocaleString()} tokens (${pct}%), ${String(history.length)} messages`,
-        });
-        // Start compaction (user explicitly requested via /compact)
-        ctx.ui.print({ type: 'info', message: 'Compacting context...' });
-        try {
-            // Use the agent's compact() method
-            const result = (await ctx.agent.compact());
-            if (!result.success) {
-                ctx.ui.print({ type: 'warning', message: 'Compaction not available' });
-                return true;
+        if (trimmed.startsWith('$')) {
+            const agentId = trimmed.slice(1);
+            return compactSpecificAgent(agentId, ctx);
+        }
+        ctx.ui.print({ type: 'error', message: 'Usage: /compact [all|auto|$agentId]' });
+        return true;
+    },
+};
+async function compactByMode(mode, ctx) {
+    const team = ctx.team;
+    switch (mode) {
+        case 'active':
+            return compactActiveAgent(ctx);
+        case 'all': {
+            if (!team || team.size <= 1) {
+                return compactActiveAgent(ctx);
             }
-            // Build status message
-            const newHistory = ctx.getHistory?.() ?? [];
-            const statusParts = [];
-            // Token reduction
-            const originalTokens = result.originalTokens ?? 0;
-            const summaryTokens = result.summaryTokens ?? 0;
-            const reduction = originalTokens > 0 ? Math.round((1 - summaryTokens / originalTokens) * 100) : 0;
-            statusParts.push(`Compacted: ${originalTokens.toLocaleString()} → ${summaryTokens.toLocaleString()} tokens (-${String(reduction)}%)`);
-            // Message count
-            statusParts.push(`Messages: ${String(history.length)} → ${String(newHistory.length)} (${String(result.messagesPreserved ?? 0)} preserved)`);
-            // Category actions
-            if (result.categoryStats) {
-                const actions = [];
-                if (result.categoryStats.toolResults.action === 'compacted') {
-                    actions.push('tool results → files');
-                }
-                if (result.categoryStats.history.action === 'summarized') {
-                    actions.push('history → summary');
+            let compacted = 0;
+            for (const teamAgent of team.getAll()) {
+                if (!teamAgent.isInitialized)
+                    continue;
+                const agent = teamAgent.agent;
+                if (!agent)
+                    continue;
+                const state = agent.serialize();
+                if (state.messages.length === 0)
+                    continue;
+                ctx.ui.print({ type: 'info', message: `Compacting $${teamAgent.id}...` });
+                try {
+                    const result = (await agent.compact());
+                    printCompactResult(ctx, result, state.messages, `$${teamAgent.id}`);
+                    if (result.success)
+                        compacted++;
                 }
-                if (actions.length > 0) {
-                    statusParts.push(`Actions: ${actions.join(', ')}`);
+                catch (error) {
+                    ctx.ui.print({ type: 'error', message: `$${teamAgent.id}: ${error.message}` });
                 }
             }
-            // Files created
-            if (result.filesCreated && result.filesCreated.length > 0) {
-                statusParts.push(`Files created: ${String(result.filesCreated.length)}`);
+            if (compacted === 0) {
+                ctx.ui.print({ type: 'info', message: 'No agents needed compaction' });
             }
-            // Restoration hints
-            if (result.restorationHintsInjected) {
-                statusParts.push('File tracking hints injected');
+            return true;
+        }
+        case 'auto': {
+            if (!team || team.size <= 1) {
+                return compactActiveAgent(ctx);
             }
-            // Tool results repaired
-            if (result.toolResultsRepaired && result.toolResultsRepaired > 0) {
-                statusParts.push(`Orphaned tool results removed: ${String(result.toolResultsRepaired)}`);
+            const provider = (ctx.provider ?? 'claude');
+            let compacted = 0;
+            for (const teamAgent of team.getAll()) {
+                if (!teamAgent.isInitialized)
+                    continue;
+                const agent = teamAgent.agent;
+                if (!agent)
+                    continue;
+                const stats = teamAgent.getContextStats(provider);
+                const utilization = stats.maxTokens > 0 ? stats.estimatedTokens / stats.maxTokens : 0;
+                if (utilization <= 0.7)
+                    continue;
+                const pct = (utilization * 100).toFixed(1);
+                ctx.ui.print({ type: 'info', message: `Compacting $${teamAgent.id} (${pct}% utilized)...` });
+                try {
+                    const state = agent.serialize();
+                    const result = (await agent.compact());
+                    printCompactResult(ctx, result, state.messages, `$${teamAgent.id}`);
+                    if (result.success)
+                        compacted++;
+                }
+                catch (error) {
+                    ctx.ui.print({ type: 'error', message: `$${teamAgent.id}: ${error.message}` });
+                }
             }
-            // Print results
-            for (const part of statusParts) {
-                ctx.ui.print({ type: 'success', message: part });
+            if (compacted === 0) {
+                ctx.ui.print({ type: 'info', message: 'No agents above 70% utilization' });
             }
+            return true;
         }
-        catch (error) {
-            ctx.ui.print({ type: 'error', message: `Compaction failed: ${error.message}` });
-        }
+    }
+}
+async function compactActiveAgent(ctx) {
+    if (!ctx.agent) {
+        ctx.ui.print({ type: 'warning', message: 'Agent not available for compaction' });
         return true;
-    },
-};
+    }
+    const contextManager = ctx.getContextManager?.();
+    if (!contextManager) {
+        ctx.ui.print({ type: 'warning', message: 'Context manager not available' });
+        return true;
+    }
+    const history = ctx.getHistory?.() ?? [];
+    if (history.length === 0) {
+        ctx.ui.print({ type: 'info', message: 'No conversation history to compact' });
+        return true;
+    }
+    // Show current stats
+    const stats = contextManager.getStats(history.length);
+    const pct = (stats.utilization * 100).toFixed(1);
+    ctx.ui.print({
+        type: 'info',
+        message: `Current: ${stats.currentTokens.toLocaleString()} tokens (${pct}%), ${String(history.length)} messages`,
+    });
+    ctx.ui.print({ type: 'info', message: 'Compacting context...' });
+    try {
+        const result = (await ctx.agent.compact());
+        printCompactResult(ctx, result, history);
+    }
+    catch (error) {
+        ctx.ui.print({ type: 'error', message: `Compaction failed: ${error.message}` });
+    }
+    return true;
+}
+async function compactSpecificAgent(agentId, ctx) {
+    const team = ctx.team;
+    if (!team) {
+        ctx.ui.print({ type: 'warning', message: 'No team available' });
+        return true;
+    }
+    const teamAgent = team.get(agentId);
+    if (!teamAgent) {
+        ctx.ui.print({ type: 'error', message: `Agent '$${agentId}' not found` });
+        return true;
+    }
+    if (!teamAgent.isInitialized || !teamAgent.agent) {
+        ctx.ui.print({ type: 'warning', message: `Agent '$${agentId}' is not initialized` });
+        return true;
+    }
+    const agent = teamAgent.agent;
+    const state = agent.serialize();
+    if (state.messages.length === 0) {
+        ctx.ui.print({ type: 'info', message: `Agent '$${agentId}' has no conversation history` });
+        return true;
+    }
+    ctx.ui.print({ type: 'info', message: `Compacting $${agentId}...` });
+    try {
+        const result = (await agent.compact());
+        printCompactResult(ctx, result, state.messages, `$${agentId}`);
+    }
+    catch (error) {
+        ctx.ui.print({ type: 'error', message: `$${agentId}: ${error.message}` });
+    }
+    return true;
+}
 // =============================================================================
 // Context Command
 // =============================================================================
 export const contextCommand = {
     name: 'context',
     description: 'Show context window usage',
+    details: 'Displays current context window utilization including token count, percentage used, and number of messages. Shows breakdown by agent when team has multiple agents.',
+    examples: [{ code: '/context' }],
     execute(_args, ctx) {
         const lines = [];
         lines.push('');
+        const s = getStyles();
         lines.push(pc.bold('Context Usage'));
         lines.push(pc.dim('─'.repeat(40)));
+        const team = ctx.team;
         const contextManager = ctx.getContextManager?.();
         const history = ctx.getHistory?.() ?? [];
         if (contextManager) {
             const stats = contextManager.getStats(history.length);
             const pct = (stats.utilization * 100).toFixed(1);
-            const bar = renderProgressBar(stats.utilization, 20);
+            const bar = renderProgressBar(stats.utilization, 20, s);
+            // Show which agent this is for (when team is active)
+            if (team) {
+                const active = team.getActive();
+                lines.push(`  Agent:    ${pc.cyan(`${active.mascot} $${active.id}`)}`);
+            }
             lines.push(`  Usage:    ${bar} ${pct}%`);
             lines.push(`  Tokens:   ${pc.cyan(stats.currentTokens.toLocaleString())} / ${pc.dim(stats.maxTokens.toLocaleString())}`);
             lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
             lines.push(`  Turns:    ${pc.cyan(String(stats.turnCount))}`);
+            // Observation masking + input compaction stats
+            const maskStats = ctx.agent?.getObservationMaskStats();
+            if (maskStats && (maskStats.maskedCount > 0 || maskStats.inputsCompacted > 0 || maskStats.activeStamps > 0)) {
+                const parts = [];
+                if (maskStats.maskedCount > 0)
+                    parts.push(`${String(maskStats.maskedCount)} observations`);
+                if (maskStats.inputsCompacted > 0)
+                    parts.push(`${String(maskStats.inputsCompacted)} inputs`);
+                lines.push(`  Masked:   ${pc.cyan(parts.join(' + '))} (${pc.green('~' + maskStats.tokensSaved.toLocaleString() + ' tokens saved')})`);
+            }
+            // Dead message pruning stats
+            const pruneStats = ctx.agent?.getDeadMessagePruneStats();
+            if (pruneStats && pruneStats.prunedCount > 0) {
+                const details = [];
+                if (pruneStats.errorsPruned > 0)
+                    details.push(`${String(pruneStats.errorsPruned)} errors`);
+                if (pruneStats.permissionsPruned > 0)
+                    details.push(`${String(pruneStats.permissionsPruned)} permissions`);
+                lines.push(`  Pruned:   ${pc.cyan(String(pruneStats.prunedCount))} dead messages [${details.join(', ')}] (${pc.green('~' + pruneStats.tokensSaved.toLocaleString() + ' tokens saved')})`);
+            }
         }
         else {
             // Fallback to session tracking
@@ -130,13 +278,38 @@ export const contextCommand = {
             const maxTokens = 200000;
             const utilization = total / maxTokens;
             const pct = (utilization * 100).toFixed(1);
-            const bar = renderProgressBar(utilization, 20);
+            const bar = renderProgressBar(utilization, 20, s);
             lines.push(`  Usage:    ${bar} ${pct}%`);
             lines.push(`  Tokens:   ${pc.cyan(total.toLocaleString())} / ${pc.dim(maxTokens.toLocaleString())}`);
             lines.push(`  Input:    ${pc.cyan(inputTokens.toLocaleString())}`);
             lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())}`);
             lines.push(`  Messages: ${pc.cyan(String(history.length))}`);
         }
+        // Show breakdown by agent if team has multiple agents
+        if (team && team.size > 1) {
+            lines.push('');
+            lines.push(pc.bold('By Agent'));
+            lines.push(pc.dim('─'.repeat(40)));
+            const agents = team.getAll();
+            const provider = (ctx.provider ?? 'claude');
+            let totalTokens = 0;
+            for (const agent of agents) {
+                const stats = agent.getContextStats(provider);
+                const isActive = agent.id === team.activeAgentId;
+                const prefix = isActive ? pc.green('●') : pc.dim('○');
+                const label = `${agent.mascot} $${agent.id}`;
+                // Use per-agent maxTokens from model-specific context window
+                const utilization = stats.maxTokens > 0 ? stats.estimatedTokens / stats.maxTokens : 0;
+                const bar = renderProgressBar(utilization, 10, s);
+                const pct = (utilization * 100).toFixed(1);
+                const maxDisplay = formatTokens(stats.maxTokens);
+                lines.push(`  ${prefix} ${label.padEnd(18)} ${bar} ${pct.padStart(5)}%  ${pc.dim(maxDisplay)}  (${String(stats.messageCount)} msgs)`);
+                totalTokens += stats.estimatedTokens;
+            }
+            // Total row
+            lines.push(pc.dim('  ' + '─'.repeat(38)));
+            lines.push(`  Total: ${pc.cyan(totalTokens.toLocaleString())} tokens across ${pc.cyan(String(agents.length))} agents`);
+        }
         lines.push('');
         ctx.ui.print({ type: 'raw-lines', lines });
         return Promise.resolve(true);
@@ -148,6 +321,8 @@ export const contextCommand = {
 export const tokensCommand = {
     name: 'tokens',
     description: 'Show token usage',
+    details: 'Displays token usage statistics for the current session including input/output tokens. Shows breakdown by agent when team has multiple agents.',
+    examples: [{ code: '/tokens' }],
     execute(_args, ctx) {
         const lines = [];
         lines.push('');
@@ -160,6 +335,26 @@ export const tokensCommand = {
         lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())} tokens`);
         lines.push(pc.dim('  ─'.repeat(20)));
         lines.push(`  Total:    ${pc.bold(pc.cyan(total.toLocaleString()))} tokens`);
+        // Show breakdown by agent if team has multiple agents
+        const team = ctx.team;
+        if (team && team.size > 1) {
+            lines.push('');
+            lines.push(pc.bold('By Agent'));
+            lines.push(pc.dim('─'.repeat(40)));
+            const agents = team.getAll();
+            for (const agent of agents) {
+                const usage = agent.tokenUsage;
+                const agentTotal = usage.input + usage.output;
+                const isActive = agent.id === team.activeAgentId;
+                const prefix = isActive ? pc.green('●') : pc.dim('○');
+                const label = `${agent.mascot} $${agent.id}`;
+                // Show all agents, display 0 for unused ones
+                const tokenDisplay = agentTotal > 0
+                    ? pc.cyan(agentTotal.toLocaleString().padStart(10))
+                    : pc.dim('0'.padStart(10));
+                lines.push(`  ${prefix} ${label.padEnd(20)} ${tokenDisplay} tokens`);
+            }
+        }
         lines.push('');
         ctx.ui.print({ type: 'raw-lines', lines });
         return Promise.resolve(true);
@@ -171,6 +366,8 @@ export const tokensCommand = {
 export const statusCommand = {
     name: 'status',
     description: 'Show session status',
+    details: 'Displays current session status including CLI version, active model, mode, and context usage.',
+    examples: [{ code: '/status' }],
     execute(_args, ctx) {
         const lines = [];
         lines.push('');
@@ -179,12 +376,13 @@ export const statusCommand = {
         lines.push(`  Version:  ${pc.cyan(ctx.version)}`);
         lines.push(`  Model:    ${pc.cyan(ctx.model ?? 'not set')}`);
         lines.push(`  Provider: ${pc.cyan(ctx.provider ?? 'not set')}`);
+        const s = getStyles();
         const contextManager = ctx.getContextManager?.();
         const history = ctx.getHistory?.() ?? [];
         if (contextManager) {
             const stats = contextManager.getStats(history.length);
             const pct = (stats.utilization * 100).toFixed(1);
-            const bar = renderProgressBar(stats.utilization, 20);
+            const bar = renderProgressBar(stats.utilization, 20, s);
             lines.push(`  Context:  ${bar} ${pct}%`);
             lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
         }
@@ -207,6 +405,8 @@ export const statusCommand = {
 export const todosCommand = {
     name: 'todos',
     description: 'Show current todo list',
+    details: 'Shows the current todo list that the agent uses to track work in progress.',
+    examples: [{ code: '/todos' }],
     execute(_args, ctx) {
         const todos = ctx.ui.getTodos();
         const lines = [];
@@ -248,6 +448,11 @@ export const todosCommand = {
 export const exportCommand = {
     name: 'export',
     description: 'Export conversation to file',
+    details: 'Export the current conversation to a markdown file for later reference. Optionally specify a filename.',
+    examples: [
+        { code: '/export', description: 'Auto-generated filename' },
+        { code: '/export notes.md', description: 'Custom filename' },
+    ],
     execute(args, ctx) {
         const history = ctx.getHistory?.() ?? [];
         if (history.length === 0) {
@@ -319,7 +524,7 @@ function formatConversationAsMarkdown(history, model) {
                         lines.push(`**Tool Result:**`);
                         if (typeof b.content === 'string') {
                             lines.push('```');
-                            lines.push(b.content.slice(0, 500) + (b.content.length > 500 ? '...' : ''));
+                            lines.push(truncate(b.content, 500));
                             lines.push('```');
                         }
                     }

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

@@ -8,6 +8,7 @@ export declare const exitCommand: CommandHandlerV2;
 export declare const clearCommand: CommandHandlerV2;
 export declare const helpCommand: CommandHandlerV2;
 export declare const tutorialCommand: CommandHandlerV2;
+export declare const changelogCommand: CommandHandlerV2;
 export declare const commandsCommand: CommandHandlerV2;
 export declare const menuCommand: CommandHandlerV2;
 export declare const coreCommands: CommandHandlerV2[];