byterover-cli 1.0.4 → 1.0.5

package/README.md

@@ -203,11 +203,22 @@ This creates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that
 | Command | Description |
 |---------|-------------|
 | `/gen-rules` | Generate rule files for AI coding agents (Claude Code, Cursor, etc.) |
-| `/clear [-y] [directory]` | Reset context tree to default domains |
+| `/reset [-y] [directory]` | Reset context tree to default domains |
 
-**Clear options:**
+**Reset options:**
 - `-y, --yes`: Skip confirmation prompt
 
+### Session Management
+
+| Command | Description |
+|---------|-------------|
+| `/new [-y]` | Start a fresh session (ends current session, clears conversation) |
+
+**Options:**
+- `-y, --yes`: Skip confirmation prompt
+
+**Note:** This command does NOT affect the context tree—it only clears the conversation history and starts a new session.
+
 ### Project Setup
 
 | Command | Description |

package/dist/commands/curate.js

@@ -14,7 +14,7 @@ export default class Curate extends Command {
     };
     static description = `Curate context to the context tree (connects to running brv instance)
 
-Requires a running brv instance. Start one with: brv start
+Requires a running brv instance. Start one with: brv
 
 Good examples:
 - "Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts"

package/dist/commands/main.d.ts

@@ -14,4 +14,17 @@ export default class Main extends Command {
      */
     static hidden: boolean;
     run(): Promise<void>;
+    /**
+     * Resolve session ID for the agent.
+     *
+     * Strategy:
+     * 1. Check for active session in .brv/sessions/active.json
+     * 2. If active session exists and is valid (not stale), resume it
+     * 3. If stale (process crashed), mark as interrupted and create new
+     * 4. If no active session, create new session
+     * 5. Run session cleanup on startup
+     *
+     * @returns Session ID to use
+     */
+    private resolveSessionId;
 }

package/dist/commands/main.js

@@ -1,4 +1,7 @@
 import { Command } from '@oclif/core';
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_SESSION_RETENTION } from '../core/domain/cipher/session/session-metadata.js';
+import { SessionMetadataStore } from '../infra/cipher/session/session-metadata-store.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { getProcessManager } from '../infra/process/index.js';
 import { startRepl } from '../infra/repl/repl-startup.js';
@@ -6,7 +9,7 @@ import { FileGlobalConfigStore } from '../infra/storage/file-global-config-store
 import { FileOnboardingPreferenceStore } from '../infra/storage/file-onboarding-preference-store.js';
 import { createTokenStore } from '../infra/storage/token-store.js';
 import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
-import { initSessionLog } from '../utils/process-logger.js';
+import { initSessionLog, processManagerLog } from '../utils/process-logger.js';
 /**
  * Main command - Entry point for ByteRover CLI.
  *
@@ -30,9 +33,13 @@ export default class Main extends Command {
             this.log("Run 'brv --help' for available commands.");
             return;
         }
+        // Resolve session ID (auto-resume or create new)
+        const sessionId = await this.resolveSessionId();
+        processManagerLog(`Session ID resolved: ${sessionId}`);
         // Start Transport and Agent processes (v0.5.0 architecture)
+        // Pass session ID to Agent via environment variable
         const processManager = getProcessManager();
-        await processManager.start();
+        await processManager.start({ sessionId });
         const tokenStore = createTokenStore();
         const globalConfigStore = new FileGlobalConfigStore();
         const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
@@ -52,4 +59,48 @@ export default class Main extends Command {
             await processManager.stop();
         }
     }
+    /**
+     * Resolve session ID for the agent.
+     *
+     * Strategy:
+     * 1. Check for active session in .brv/sessions/active.json
+     * 2. If active session exists and is valid (not stale), resume it
+     * 3. If stale (process crashed), mark as interrupted and create new
+     * 4. If no active session, create new session
+     * 5. Run session cleanup on startup
+     *
+     * @returns Session ID to use
+     */
+    async resolveSessionId() {
+        const sessionStore = new SessionMetadataStore();
+        // Run cleanup on startup (async, don't wait)
+        sessionStore.cleanupSessions(DEFAULT_SESSION_RETENTION).catch((error) => {
+            processManagerLog(`Session cleanup failed: ${error}`);
+        });
+        // Check for active session
+        const activeSession = await sessionStore.getActiveSession();
+        if (activeSession) {
+            // Check if the active session is stale (process not running)
+            const isStale = await sessionStore.isActiveSessionStale();
+            if (isStale) {
+                // Mark the old session as interrupted
+                processManagerLog(`Active session ${activeSession.sessionId} is stale, marking as interrupted`);
+                await sessionStore.markSessionInterrupted(activeSession.sessionId);
+            }
+            else {
+                // Valid active session - resume it
+                processManagerLog(`Resuming active session: ${activeSession.sessionId}`);
+                return activeSession.sessionId;
+            }
+        }
+        // Create new session
+        const newSessionId = `agent-session-${randomUUID()}`;
+        processManagerLog(`Creating new session: ${newSessionId}`);
+        // Save session metadata
+        const metadata = sessionStore.createSessionMetadata(newSessionId);
+        await sessionStore.saveSession(metadata);
+        // Set as active session
+        await sessionStore.setActiveSession(newSessionId);
+        return newSessionId;
+    }
 }

package/dist/commands/query.js

@@ -14,7 +14,7 @@ export default class Query extends Command {
     };
     static description = `Query and retrieve information from the context tree (connects to running brv instance)
 
-Requires a running brv instance. Start one with: brv start
+Requires a running brv instance. Start one with: brv
 
 Good:
 - "How is user authentication implemented?"

package/dist/constants.d.ts

@@ -34,4 +34,4 @@ export declare const TRANSPORT_RECONNECTION_ATTEMPTS = 30;
 export declare const TRANSPORT_PING_INTERVAL_MS = 5000;
 export declare const TRANSPORT_PING_TIMEOUT_MS = 10000;
 export declare const TRANSPORT_DEFAULT_TRANSPORTS: ('polling' | 'websocket')[];
-export declare const DEFAULT_LLM_MODEL = "gemini-2.5-pro";
+export declare const DEFAULT_LLM_MODEL = "gemini-3-flash-preview";

package/dist/constants.js

@@ -43,4 +43,4 @@ export const TRANSPORT_PING_TIMEOUT_MS = 10_000; // 10s timeout - avoid false di
 // HTTP polling may be blocked by IDE sandboxes causing "xhr poll error"
 export const TRANSPORT_DEFAULT_TRANSPORTS = ['websocket'];
 // LLM Model defaults
-export const DEFAULT_LLM_MODEL = 'gemini-2.5-pro';
+export const DEFAULT_LLM_MODEL = 'gemini-3-flash-preview';

package/dist/core/domain/cipher/llm/registry.js

@@ -27,19 +27,54 @@ export const LLM_REGISTRY = {
         supportedFileTypes: [],
     },
     gemini: {
-        defaultModel: 'gemini-2.5-flash',
+        defaultModel: 'gemini-3-flash-preview',
         models: [
-            // Gemini 2.5 series
+            // Gemini 3 series (Preview)
             {
                 capabilities: {
                     supportsAudio: true,
                     supportsImages: true,
+                    supportsMultimodalFunctionResponse: true,
                     supportsPdf: true,
                     supportsStreaming: true,
                     supportsThinking: true,
                 },
                 charsPerToken: 4,
                 default: true,
+                displayName: 'Gemini 3 Flash (Preview)',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-3-flash-preview',
+                pricing: { inputPerM: 0.075, outputPerM: 0.3 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsMultimodalFunctionResponse: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
+                displayName: 'Gemini 3 Pro (Preview)',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-3-pro-preview',
+                pricing: { inputPerM: 1.25, outputPerM: 5 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
+            // Gemini 2.5 series
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
                 displayName: 'Gemini 2.5 Flash',
                 maxInputTokens: 1_000_000,
                 maxOutputTokens: 8192,
@@ -47,6 +82,22 @@ export const LLM_REGISTRY = {
                 pricing: { inputPerM: 0.075, outputPerM: 0.3 },
                 supportedFileTypes: ['image', 'pdf', 'audio'],
             },
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
+                displayName: 'Gemini 2.5 Pro',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-2.5-pro',
+                pricing: { inputPerM: 1.25, outputPerM: 5 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
             // Gemini 1.5 series
             {
                 capabilities: {

package/dist/core/domain/cipher/llm/types.d.ts

@@ -28,6 +28,8 @@ export interface ModelCapabilities {
     supportsAudio: boolean;
     /** Whether the model supports image input */
     supportsImages: boolean;
+    /** Whether the model supports multimodal data in function responses (Gemini 3+) */
+    supportsMultimodalFunctionResponse?: boolean;
     /** Whether the model supports PDF input */
     supportsPdf: boolean;
     /** Whether the model supports streaming responses */

package/dist/core/domain/cipher/process/types.d.ts

@@ -17,6 +17,13 @@ export interface ProcessConfig {
      * Custom environment variables for all commands.
      */
     environment: Record<string, string>;
+    /**
+     * Grace period in milliseconds to wait after SIGTERM before sending SIGKILL.
+     * Allows processes time to clean up gracefully.
+     *
+     * @default 5000 (5 seconds)
+     */
+    killGracePeriod: number;
     /**
      * Maximum number of concurrent background processes.
      * @default 5

package/dist/core/domain/cipher/session/session-metadata.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Session Metadata Types and Schemas
+ *
+ * Defines the data structures for persistent session management.
+ * Sessions are stored in .brv/sessions/ directory as JSON files.
+ *
+ * Design adapted from gemini-cli's ChatRecordingService pattern.
+ */
+import { z } from 'zod';
+/**
+ * Session status indicating lifecycle state.
+ */
+export type SessionStatus = 'active' | 'ended' | 'interrupted';
+/**
+ * Active session pointer stored in .brv/sessions/active.json
+ * Points to the currently active session for auto-resume.
+ */
+export interface ActiveSessionPointer {
+    /** ISO timestamp when this session became active */
+    activatedAt: string;
+    /** PID of the process that activated this session (for stale detection) */
+    pid: number;
+    /**
+     * Unique token identifying this specific process instance.
+     * Used to detect PID reuse: if the PID exists but token differs,
+     * it's a different process that got the same PID after the original crashed.
+     * Optional for backward compatibility with existing session files.
+     */
+    processToken?: string;
+    /** Session ID of the currently active session */
+    sessionId: string;
+}
+/**
+ * Session metadata stored in .brv/sessions/session-*.json
+ * Contains metadata about a session for listing and management.
+ */
+export interface SessionMetadata {
+    /** ISO timestamp when session was created */
+    createdAt: string;
+    /** ISO timestamp of last activity */
+    lastUpdated: string;
+    /** Number of messages in session (cached for quick display) */
+    messageCount: number;
+    /** Unique session identifier (UUID) */
+    sessionId: string;
+    /** Session lifecycle status */
+    status: SessionStatus;
+    /** Optional AI-generated summary */
+    summary?: string;
+    /** Session title (generated from first user message) */
+    title?: string;
+    /** Project working directory (for validation) */
+    workingDirectory: string;
+}
+/**
+ * Session info for display purposes (extends metadata with computed fields).
+ */
+export interface SessionInfo extends SessionMetadata {
+    /** Filename without extension */
+    file: string;
+    /** Full filename including .json extension */
+    fileName: string;
+    /** First user message content (cleaned) */
+    firstUserMessage?: string;
+    /** Display index in the list (1-based) */
+    index: number;
+    /** Whether this is the currently active session */
+    isCurrentSession: boolean;
+}
+/**
+ * Result of resolving a session selection.
+ */
+export interface SessionSelectionResult {
+    /** Display info string for user feedback */
+    displayInfo: string;
+    /** Loaded session metadata */
+    sessionData: SessionMetadata;
+    /** Full path to session metadata file */
+    sessionPath: string;
+}
+/**
+ * Schema for ActiveSessionPointer validation.
+ */
+export declare const ActiveSessionPointerSchema: z.ZodObject<{
+    activatedAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    pid: z.ZodNumber;
+    processToken: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    pid: number;
+    activatedAt: string;
+    processToken?: string | undefined;
+}, {
+    sessionId: string;
+    pid: number;
+    activatedAt: string;
+    processToken?: string | undefined;
+}>;
+/**
+ * Schema for SessionMetadata validation.
+ */
+export declare const SessionMetadataSchema: z.ZodObject<{
+    createdAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    lastUpdated: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    messageCount: z.ZodNumber;
+    sessionId: z.ZodString;
+    status: z.ZodEnum<["active", "ended", "interrupted"]>;
+    summary: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    workingDirectory: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "ended" | "interrupted";
+    sessionId: string;
+    createdAt: string;
+    lastUpdated: string;
+    messageCount: number;
+    workingDirectory: string;
+    summary?: string | undefined;
+    title?: string | undefined;
+}, {
+    status: "active" | "ended" | "interrupted";
+    sessionId: string;
+    createdAt: string;
+    lastUpdated: string;
+    messageCount: number;
+    workingDirectory: string;
+    summary?: string | undefined;
+    title?: string | undefined;
+}>;
+/** Prefix for session metadata files */
+export declare const SESSION_FILE_PREFIX = "session-";
+/** Directory name for session storage */
+export declare const SESSIONS_DIR = "sessions";
+/** Filename for active session pointer */
+export declare const ACTIVE_SESSION_FILE = "active.json";
+/** Default session retention config */
+export declare const DEFAULT_SESSION_RETENTION: {
+    /** Maximum age in days before auto-cleanup */
+    maxAgeDays: number;
+    /** Maximum number of sessions to keep */
+    maxCount: number;
+    /** Run cleanup on startup */
+    runOnStartup: boolean;
+};
+/**
+ * Generate a session filename from timestamp and session ID.
+ *
+ * @param sessionId - The session UUID
+ * @returns Filename in format: session-YYYY-MM-DDTHH-MM-SS-<uuid-prefix>.json
+ */
+export declare function generateSessionFilename(sessionId: string): string;
+/**
+ * Parse a session filename to extract timestamp and UUID prefix.
+ *
+ * @param filename - The session filename
+ * @returns Parsed components or null if invalid format
+ */
+export declare function parseSessionFilename(filename: string): null | {
+    timestamp: string;
+    uuidPrefix: string;
+};
+/**
+ * Format a timestamp as relative time.
+ *
+ * @param timestamp - ISO timestamp string
+ * @param style - 'long' (e.g., "2 hours ago") or 'short' (e.g., "2h")
+ * @returns Formatted relative time string
+ */
+export declare function formatRelativeTime(timestamp: string, style?: 'long' | 'short'): string;
+/**
+ * Clean and sanitize message content for display.
+ * Converts newlines to spaces, collapses whitespace, removes non-printable chars.
+ *
+ * @param message - Raw message content
+ * @returns Cleaned message suitable for display
+ */
+export declare function cleanMessageForTitle(message: string): string;

package/dist/core/domain/cipher/session/session-metadata.js

@@ -0,0 +1,147 @@
+/**
+ * Session Metadata Types and Schemas
+ *
+ * Defines the data structures for persistent session management.
+ * Sessions are stored in .brv/sessions/ directory as JSON files.
+ *
+ * Design adapted from gemini-cli's ChatRecordingService pattern.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Zod Schemas for Validation
+// ============================================================================
+/**
+ * Schema for ActiveSessionPointer validation.
+ */
+export const ActiveSessionPointerSchema = z.object({
+    activatedAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    pid: z.number().int().positive(),
+    // Optional for backward compatibility with existing session files (treated as stale if missing)
+    processToken: z.string().optional(),
+    sessionId: z.string().min(1),
+});
+/**
+ * Schema for SessionMetadata validation.
+ */
+export const SessionMetadataSchema = z.object({
+    createdAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    lastUpdated: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    messageCount: z.number().int().nonnegative(),
+    sessionId: z.string().min(1),
+    status: z.enum(['active', 'ended', 'interrupted']),
+    summary: z.string().optional(),
+    title: z.string().optional(),
+    workingDirectory: z.string().min(1),
+});
+// ============================================================================
+// Constants
+// ============================================================================
+/** Prefix for session metadata files */
+export const SESSION_FILE_PREFIX = 'session-';
+/** Directory name for session storage */
+export const SESSIONS_DIR = 'sessions';
+/** Filename for active session pointer */
+export const ACTIVE_SESSION_FILE = 'active.json';
+/** Default session retention config */
+export const DEFAULT_SESSION_RETENTION = {
+    /** Maximum age in days before auto-cleanup */
+    maxAgeDays: 30,
+    /** Maximum number of sessions to keep */
+    maxCount: 50,
+    /** Run cleanup on startup */
+    runOnStartup: true,
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Generate a session filename from timestamp and session ID.
+ *
+ * @param sessionId - The session UUID
+ * @returns Filename in format: session-YYYY-MM-DDTHH-MM-SS-<uuid-prefix>.json
+ */
+export function generateSessionFilename(sessionId) {
+    const timestamp = new Date().toISOString().slice(0, 19).replaceAll(':', '-');
+    const uuidPrefix = sessionId.slice(0, 8);
+    return `${SESSION_FILE_PREFIX}${timestamp}-${uuidPrefix}.json`;
+}
+/**
+ * Parse a session filename to extract timestamp and UUID prefix.
+ *
+ * @param filename - The session filename
+ * @returns Parsed components or null if invalid format
+ */
+export function parseSessionFilename(filename) {
+    if (!filename.startsWith(SESSION_FILE_PREFIX) || !filename.endsWith('.json')) {
+        return null;
+    }
+    // Remove prefix and .json suffix
+    const withoutPrefix = filename.slice(SESSION_FILE_PREFIX.length, -5);
+    // Format: YYYY-MM-DDTHH-MM-SS-<uuid-prefix>
+    // The UUID prefix is the last 8 characters after the last dash
+    const lastDashIndex = withoutPrefix.lastIndexOf('-');
+    if (lastDashIndex === -1) {
+        return null;
+    }
+    const timestamp = withoutPrefix.slice(0, lastDashIndex);
+    const uuidPrefix = withoutPrefix.slice(lastDashIndex + 1);
+    if (uuidPrefix.length !== 8) {
+        return null;
+    }
+    return { timestamp, uuidPrefix };
+}
+/**
+ * Format a timestamp as relative time.
+ *
+ * @param timestamp - ISO timestamp string
+ * @param style - 'long' (e.g., "2 hours ago") or 'short' (e.g., "2h")
+ * @returns Formatted relative time string
+ */
+export function formatRelativeTime(timestamp, style = 'long') {
+    const now = new Date();
+    const time = new Date(timestamp);
+    const diffMs = now.getTime() - time.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 (style === 'short') {
+        if (diffSeconds < 1)
+            return 'now';
+        if (diffSeconds < 60)
+            return `${diffSeconds}s`;
+        if (diffMinutes < 60)
+            return `${diffMinutes}m`;
+        if (diffHours < 24)
+            return `${diffHours}h`;
+        if (diffDays < 30)
+            return `${diffDays}d`;
+        const diffMonths = Math.floor(diffDays / 30);
+        return diffMonths < 12 ? `${diffMonths}mo` : `${Math.floor(diffMonths / 12)}y`;
+    }
+    if (diffDays > 0) {
+        return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+    }
+    if (diffHours > 0) {
+        return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+    }
+    if (diffMinutes > 0) {
+        return `${diffMinutes} minute${diffMinutes === 1 ? '' : 's'} ago`;
+    }
+    return 'Just now';
+}
+/**
+ * Clean and sanitize message content for display.
+ * Converts newlines to spaces, collapses whitespace, removes non-printable chars.
+ *
+ * @param message - Raw message content
+ * @returns Cleaned message suitable for display
+ */
+export function cleanMessageForTitle(message) {
+    return message
+        .replaceAll(/\n+/g, ' ')
+        .replaceAll(/\s+/g, ' ')
+        .replaceAll(/[^\u0020-\u007E]+/g, '') // Remove non-printable ASCII
+        .trim()
+        .slice(0, 100); // Limit length for title
+}

package/dist/core/domain/knowledge/markdown-writer.d.ts

@@ -1,27 +1,24 @@
-/**
- * Context data for generating context.md files.
- */
+export interface RawConcept {
+    changes?: string[];
+    files?: string[];
+    flow?: string;
+    task?: string;
+    timestamp?: string;
+}
+export interface Narrative {
+    dependencies?: string;
+    features?: string;
+    structure?: string;
+}
 export interface ContextData {
     name: string;
+    narrative?: Narrative;
+    rawConcept?: RawConcept;
     relations?: string[];
     snippets: string[];
 }
-/**
- * Generates Markdown files for knowledge context.
- */
 export declare const MarkdownWriter: {
-    /**
-     * Generate context.md content with snippets and optional relations.
-     * Used for both topics and subtopics in the knowledge hierarchy.
-     */
     generateContext(data: ContextData): string;
-    /**
-     * Merge two context.md contents into one.
-     * Combines snippets and relations, deduplicating where possible.
-     *
-     * @param sourceContent - Raw content from source context.md
-     * @param targetContent - Raw content from target context.md
-     * @returns Merged context.md content
-     */
     mergeContexts(sourceContent: string, targetContent: string): string;
+    parseContent(content: string, name?: string): ContextData;
 };