@shepai/cli 1.51.2 → 1.52.0

package/dist/src/presentation/cli/commands/session/ls.command.js

@@ -0,0 +1,186 @@
+/**
+ * Session List Command
+ *
+ * List agent provider CLI sessions for the configured or specified provider.
+ * Sessions are grouped by project path and sorted by last activity within each group.
+ *
+ * Usage:
+ *   shep session ls
+ *   shep session ls --claude-code
+ *   shep session ls --cursor-cli
+ *   shep session ls --gemini-cli
+ *   shep session ls --limit 10
+ *   shep session ls --flat
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ListAgentSessionsUseCase } from '../../../../../packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.js';
+import { colors, messages } from '../../ui/index.js';
+import { fmt } from '../../ui/formatters.js';
+import { AgentType } from '../../../../../packages/core/src/domain/generated/output.js';
+export function createLsCommand() {
+    return new Command('ls')
+        .description('List agent provider CLI sessions')
+        .option('--claude-code', 'List sessions for Claude Code')
+        .option('--cursor-cli', 'List sessions for Cursor CLI')
+        .option('--gemini-cli', 'List sessions for Gemini CLI')
+        .option('-n, --limit <n>', 'Maximum number of sessions to show (0 = all)', '20')
+        .option('--flat', 'Show flat list without grouping')
+        .action(async (opts) => {
+        try {
+            // Validate mutual exclusivity of provider flags
+            const providerFlags = [opts.claudeCode, opts.cursorCli, opts.geminiCli].filter(Boolean);
+            if (providerFlags.length > 1) {
+                messages.error('Only one provider flag may be specified at a time');
+                process.exitCode = 1;
+                return;
+            }
+            const agentType = resolveAgentType(opts);
+            const limit = parseInt(opts.limit, 10);
+            const useCase = container.resolve(ListAgentSessionsUseCase);
+            const sessions = await useCase.execute({ agentType, limit });
+            if (sessions.length === 0) {
+                messages.newline();
+                messages.info('No sessions found');
+                messages.newline();
+                return;
+            }
+            const providerLabel = sessions[0]?.agentType ?? 'agent';
+            if (opts.flat) {
+                renderFlat(sessions, providerLabel);
+            }
+            else {
+                renderGrouped(sessions, providerLabel);
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to list sessions', err);
+            process.exitCode = 1;
+        }
+    });
+}
+function renderGrouped(sessions, provider) {
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${fmt.heading(`${provider} Sessions (${sessions.length})`)}`);
+    // Group by project path
+    const groups = new Map();
+    for (const session of sessions) {
+        const key = session.projectPath;
+        const group = groups.get(key);
+        if (group) {
+            group.push(session);
+        }
+        else {
+            groups.set(key, [session]);
+        }
+    }
+    // Sort groups by most recent session activity
+    const sortedGroups = [...groups.entries()].sort((a, b) => {
+        const aTime = getLatestTime(a[1]);
+        const bTime = getLatestTime(b[1]);
+        return bTime - aTime;
+    });
+    for (const [projectPath, groupSessions] of sortedGroups) {
+        lines.push('');
+        lines.push(`  📂 ${colors.brand(projectPath)}`);
+        // Column header
+        const header = `    ${pad('ID', 10)}  ${pad('Messages', 10)}  ${pad('Last Active', 14)}  Preview`;
+        lines.push(`  ${colors.muted(header.trimStart())}`);
+        for (const session of groupSessions) {
+            const active = isRecentlyActive(session.lastMessageAt ?? session.updatedAt);
+            const id = active ? colors.success(session.id.substring(0, 8)) : session.id.substring(0, 8);
+            const indicator = active ? colors.success('●') : ' ';
+            const msgCount = String(session.messageCount);
+            const lastActive = formatRelativeTime(session.lastMessageAt ?? session.updatedAt);
+            const preview = session.preview ? truncate(session.preview, 50) : colors.muted('-');
+            lines.push(`   ${indicator} ${pad(id, 10)}  ${pad(msgCount, 10)}  ${pad(lastActive, 14)}  ${preview}`);
+        }
+    }
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+function renderFlat(sessions, provider) {
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${fmt.heading(`${provider} Sessions (${sessions.length})`)}`);
+    lines.push('');
+    const header = `${pad('ID', 10)}  ${pad('Path', 40)}  ${pad('Msgs', 6)}  ${pad('Last Active', 14)}  Preview`;
+    lines.push(`  ${colors.muted(header)}`);
+    for (const session of sessions) {
+        const active = isRecentlyActive(session.lastMessageAt ?? session.updatedAt);
+        const id = active ? colors.success(session.id.substring(0, 8)) : session.id.substring(0, 8);
+        const indicator = active ? colors.success('●') : ' ';
+        const path = truncate(session.projectPath, 40);
+        const msgCount = String(session.messageCount);
+        const lastActive = formatRelativeTime(session.lastMessageAt ?? session.updatedAt);
+        const preview = session.preview ? truncate(session.preview, 50) : colors.muted('-');
+        lines.push(`  ${indicator} ${pad(id, 10)}  ${pad(path, 40)}  ${pad(msgCount, 6)}  ${pad(lastActive, 14)}  ${preview}`);
+    }
+    lines.push('');
+    console.log(lines.join('\n'));
+}
+/** Sessions active within the last 2 minutes are considered "probably active" */
+function isRecentlyActive(date) {
+    const ts = toTimestamp(date);
+    if (ts === 0)
+        return false;
+    return Date.now() - ts < 2 * 60 * 1000;
+}
+function getLatestTime(sessions) {
+    let latest = 0;
+    for (const s of sessions) {
+        const t = toTimestamp(s.lastMessageAt ?? s.updatedAt);
+        if (t > latest)
+            latest = t;
+    }
+    return latest;
+}
+function toTimestamp(date) {
+    if (!date)
+        return 0;
+    const d = date instanceof Date ? date : new Date(date);
+    return isNaN(d.getTime()) ? 0 : d.getTime();
+}
+function pad(text, width) {
+    // Strip ANSI for measurement
+    // eslint-disable-next-line no-control-regex
+    const visible = text.replace(/\x1B\[[0-9;]*m/g, '').length;
+    if (visible >= width)
+        return text;
+    return text + ' '.repeat(width - visible);
+}
+function resolveAgentType(opts) {
+    if (opts.claudeCode)
+        return AgentType.ClaudeCode;
+    if (opts.cursorCli)
+        return AgentType.Cursor;
+    if (opts.geminiCli)
+        return AgentType.GeminiCli;
+    return undefined;
+}
+export function formatRelativeTime(date) {
+    if (!date)
+        return colors.muted('-');
+    const d = date instanceof Date ? date : new Date(date);
+    if (isNaN(d.getTime()))
+        return colors.muted('-');
+    const diffMs = Date.now() - d.getTime();
+    const diffSeconds = Math.floor(diffMs / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    const diffHours = Math.floor(diffMinutes / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffDays > 0)
+        return `${diffDays}d ago`;
+    if (diffHours > 0)
+        return `${diffHours}h ago`;
+    if (diffMinutes > 0)
+        return `${diffMinutes}m ago`;
+    return 'just now';
+}
+function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.substring(0, maxLength - 1)}…`;
+}

package/dist/src/presentation/cli/commands/session/show.command.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session Show Command
+ *
+ * Display details of a specific agent provider CLI session including metadata,
+ * tool usage stats, and conversation messages.
+ *
+ * Usage:
+ *   shep session show <id>
+ *   shep session show <id> --messages 50
+ *   shep session show <id> --claude-code
+ */
+import { Command } from 'commander';
+export declare function createShowCommand(): Command;
+//# sourceMappingURL=show.command.d.ts.map

package/dist/src/presentation/cli/commands/session/show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/session/show.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,iBAAiB,IAAI,OAAO,CAqC3C"}

package/dist/src/presentation/cli/commands/session/show.command.js

@@ -0,0 +1,213 @@
+/**
+ * Session Show Command
+ *
+ * Display details of a specific agent provider CLI session including metadata,
+ * tool usage stats, and conversation messages.
+ *
+ * Usage:
+ *   shep session show <id>
+ *   shep session show <id> --messages 50
+ *   shep session show <id> --claude-code
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { GetAgentSessionUseCase } from '../../../../../packages/core/src/application/use-cases/agents/get-agent-session.use-case.js';
+import { SessionNotFoundError } from '../../../../../packages/core/src/domain/errors/session-not-found.error.js';
+import { colors, messages } from '../../ui/index.js';
+import { fmt } from '../../ui/formatters.js';
+import { AgentType } from '../../../../../packages/core/src/domain/generated/output.js';
+import { formatRelativeTime } from './ls.command.js';
+export function createShowCommand() {
+    return new Command('show')
+        .description('Display details of an agent provider session')
+        .argument('<id>', 'Session ID')
+        .option('--claude-code', 'Query Claude Code sessions')
+        .option('--cursor-cli', 'Query Cursor CLI sessions')
+        .option('--gemini-cli', 'Query Gemini CLI sessions')
+        .option('-m, --messages <n>', 'Number of messages to display (0 = all)', '20')
+        .action(async (id, opts) => {
+        try {
+            // Validate mutual exclusivity of provider flags
+            const providerFlags = [opts.claudeCode, opts.cursorCli, opts.geminiCli].filter(Boolean);
+            if (providerFlags.length > 1) {
+                messages.error('Only one provider flag may be specified at a time');
+                process.exitCode = 1;
+                return;
+            }
+            const agentType = resolveAgentType(opts);
+            const messageLimit = parseInt(opts.messages, 10);
+            const useCase = container.resolve(GetAgentSessionUseCase);
+            // Fetch all messages so we can show first N + last N
+            const session = await useCase.execute({ id, agentType, messageLimit: 0 });
+            renderSessionDetail(session, messageLimit);
+        }
+        catch (error) {
+            if (error instanceof SessionNotFoundError) {
+                messages.error(`Session not found: ${error.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to show session', err);
+            process.exitCode = 1;
+        }
+    });
+}
+function resolveAgentType(opts) {
+    if (opts.claudeCode)
+        return AgentType.ClaudeCode;
+    if (opts.cursorCli)
+        return AgentType.Cursor;
+    if (opts.geminiCli)
+        return AgentType.GeminiCli;
+    return undefined;
+}
+function renderSessionDetail(session, _messageLimit) {
+    const sessionMessages = session.messages ?? [];
+    const totalCount = session.messageCount;
+    const meta = session.metadata;
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${fmt.heading('Session')}`);
+    lines.push('');
+    // Row 1: ID + Provider
+    lines.push(`  ${field('ID', session.id)}    ${field('Provider', session.agentType)}`);
+    // Row 2: Project path (full width — it's long)
+    lines.push(`  ${field('Path', session.projectPath)}`);
+    // Row 3: Git branch + CLI version + Permission mode
+    if (meta) {
+        const parts = [];
+        if (meta.gitBranch)
+            parts.push(field('Branch', colors.brand(meta.gitBranch)));
+        if (meta.cliVersion)
+            parts.push(field('CLI', `v${meta.cliVersion}`));
+        if (meta.permissionMode)
+            parts.push(field('Mode', meta.permissionMode));
+        if (parts.length > 0) {
+            lines.push(`  ${parts.join('    ')}`);
+        }
+    }
+    // Row 4: Message counts + timing
+    const msgParts = [];
+    if (meta) {
+        msgParts.push(field('Messages', `${totalCount} total (${colors.info(String(meta.userMessageCount))} user, ${colors.success(String(meta.assistantMessageCount))} assistant)`));
+    }
+    else {
+        msgParts.push(field('Messages', String(totalCount)));
+    }
+    lines.push(`  ${msgParts.join('    ')}`);
+    // Row 5: Timing
+    const timeParts = [];
+    const firstActive = session.firstMessageAt ? formatDate(session.firstMessageAt) : null;
+    if (firstActive)
+        timeParts.push(field('First Active', firstActive));
+    timeParts.push(field('Last Active', formatRelativeTime(session.lastMessageAt ?? session.updatedAt)));
+    if (firstActive && session.firstMessageAt && session.lastMessageAt) {
+        const duration = computeDuration(session.firstMessageAt, session.lastMessageAt);
+        if (duration)
+            timeParts.push(field('Duration', duration));
+    }
+    lines.push(`  ${timeParts.join('    ')}`);
+    // Tool usage section
+    if (meta && Object.keys(meta.toolUsage).length > 0) {
+        lines.push('');
+        lines.push(`  ${colors.muted('Tool Usage')}`);
+        const sorted = Object.entries(meta.toolUsage).sort((a, b) => b[1] - a[1]);
+        const totalTools = sorted.reduce((sum, [, count]) => sum + count, 0);
+        // Render tools in 3-column rows
+        const toolEntries = sorted.map(([name, count]) => {
+            const pct = Math.round((count / totalTools) * 100);
+            return `${colors.muted(name)} ${count}${colors.muted(`(${pct}%)`)}`;
+        });
+        for (let i = 0; i < toolEntries.length; i += 3) {
+            const row = toolEntries.slice(i, i + 3);
+            lines.push(`  ${row.map((e) => pad(e, 26)).join('')}`);
+        }
+    }
+    lines.push('');
+    console.log(lines.join('\n'));
+    // Messages
+    if (sessionMessages.length === 0) {
+        messages.info('No messages in this session');
+        return;
+    }
+    // Filter out empty messages for display
+    const meaningful = sessionMessages.filter((m) => m.content.trim().length > 0);
+    if (meaningful.length === 0) {
+        messages.info('No displayable messages in this session');
+        return;
+    }
+    const half = Math.max(1, Math.floor(_messageLimit / 2));
+    if (meaningful.length <= _messageLimit || _messageLimit === 0) {
+        // Show all
+        messages.info(`${meaningful.length} messages`);
+        renderMessages(meaningful);
+    }
+    else {
+        // Show first half + gap + last half
+        const first = meaningful.slice(0, half);
+        const last = meaningful.slice(-half);
+        const skipped = meaningful.length - first.length - last.length;
+        messages.info(`Showing first ${first.length} and last ${last.length} of ${meaningful.length} messages`);
+        renderMessages(first);
+        console.log(`  ${colors.muted(`  ··· ${skipped} messages skipped ···`)}\n`);
+        renderMessages(last);
+    }
+}
+/** Render a label: value pair */
+function field(label, value) {
+    return `${colors.muted(label)}  ${value}`;
+}
+/** Pad a string (ANSI-aware) to a minimum visible width */
+function pad(text, width) {
+    // eslint-disable-next-line no-control-regex
+    const visible = text.replace(/\x1B\[[0-9;]*m/g, '').length;
+    if (visible >= width)
+        return text;
+    return text + ' '.repeat(width - visible);
+}
+function computeDuration(start, end) {
+    const s = start instanceof Date ? start : new Date(start);
+    const e = end instanceof Date ? end : new Date(end);
+    const diffMs = e.getTime() - s.getTime();
+    if (isNaN(diffMs) || diffMs < 0)
+        return null;
+    const diffMinutes = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMinutes / 60);
+    const mins = diffMinutes % 60;
+    if (diffHours > 0)
+        return `${diffHours}h ${mins}m`;
+    if (diffMinutes > 0)
+        return `${diffMinutes}m`;
+    return '<1m';
+}
+function renderMessages(msgs) {
+    const lines = [''];
+    for (const msg of msgs) {
+        const content = msg.content.trim();
+        const timestamp = formatDate(msg.timestamp);
+        const timeStr = timestamp ? colors.muted(` (${timestamp})`) : '';
+        if (msg.role === 'user') {
+            lines.push(`  ${colors.info('You')}${timeStr}`);
+        }
+        else {
+            lines.push(`  ${colors.success('Assistant')}${timeStr}`);
+        }
+        for (const line of content.split('\n')) {
+            lines.push(`  ${line}`);
+        }
+        lines.push('');
+    }
+    console.log(lines.join('\n'));
+}
+function formatDate(date) {
+    if (!date)
+        return null;
+    try {
+        const d = date instanceof Date ? date : new Date(date);
+        return d.toLocaleString();
+    }
+    catch {
+        return String(date);
+    }
+}

package/dist/src/presentation/cli/index.js

@@ -33,6 +33,7 @@ import { createRunCommand } from './commands/run.command.js';
 import { createAgentCommand } from './commands/agent/index.js';
 import { createFeatCommand } from './commands/feat/index.js';
 import { createRepoCommand } from './commands/repo/index.js';
+import { createSessionCommand } from './commands/session/index.js';
 import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
 import { createUpgradeCommand } from './commands/upgrade.command.js';
@@ -98,6 +99,7 @@ async function bootstrap() {
         program.addCommand(createAgentCommand());
         program.addCommand(createFeatCommand());
         program.addCommand(createRepoCommand());
+        program.addCommand(createSessionCommand());
         program.addCommand(createIdeOpenCommand());
         program.addCommand(createInstallCommand());
         program.addCommand(createUpgradeCommand());