byterover-cli 0.3.4 → 0.4.0

package/dist/infra/repl/commands/logout-command.js

@@ -0,0 +1,48 @@
+import { CommandKind } from '../../../tui/types.js';
+import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { FileOnboardingPreferenceStore } from '../../storage/file-onboarding-preference-store.js';
+import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../terminal/repl-terminal.js';
+import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
+import { LogoutUseCase } from '../../usecase/logout-use-case.js';
+import { Flags, parseReplArgs, toCommandFlags } from './arg-parser.js';
+// Flags - defined once, used for both parsing and help display
+const logoutFlags = {
+    yes: Flags.boolean({
+        char: 'y',
+        default: false,
+        description: 'Skip confirmation prompt',
+    }),
+};
+/**
+ * Logout command
+ */
+export const logoutCommand = {
+    action(_context, args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const parsed = await parseReplArgs(args, {
+                    flags: logoutFlags,
+                    strict: false,
+                });
+                const tokenStore = new KeychainTokenStore();
+                const globalConfigStore = new FileGlobalConfigStore();
+                const useCase = new LogoutUseCase({
+                    onboardingPreferenceStore: new FileOnboardingPreferenceStore(),
+                    terminal,
+                    tokenStore,
+                    trackingService: new MixpanelTrackingService({ globalConfigStore, tokenStore }),
+                });
+                await useCase.run({ skipConfirmation: parsed.flags.yes ?? false });
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'Log out of ByteRover CLI and clear authentication',
+    flags: toCommandFlags(logoutFlags),
+    kind: CommandKind.BUILT_IN,
+    name: 'logout',
+};

package/dist/infra/repl/commands/pull-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../tui/types.js';
+/**
+ * Pull command
+ */
+export declare const pullCommand: SlashCommand;

package/dist/infra/repl/commands/pull-command.js

@@ -0,0 +1,61 @@
+import { getCurrentConfig } from '../../../config/environment.js';
+import { DEFAULT_BRANCH } from '../../../constants.js';
+import { CommandKind } from '../../../tui/types.js';
+import { HttpCogitPullService } from '../../cogit/http-cogit-pull-service.js';
+import { ProjectConfigStore } from '../../config/file-config-store.js';
+import { FileContextTreeSnapshotService } from '../../context-tree/file-context-tree-snapshot-service.js';
+import { FileContextTreeWriterService } from '../../context-tree/file-context-tree-writer-service.js';
+import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../terminal/repl-terminal.js';
+import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
+import { PullUseCase } from '../../usecase/pull-use-case.js';
+import { Flags, parseReplArgs, toCommandFlags } from './arg-parser.js';
+const pullFlags = {
+    branch: Flags.string({
+        char: 'b',
+        default: DEFAULT_BRANCH,
+        description: 'ByteRover branch name (not Git branch)',
+    }),
+};
+/**
+ * Pull command
+ */
+export const pullCommand = {
+    action(_context, args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const parsed = await parseReplArgs(args, { flags: pullFlags, strict: false });
+                const envConfig = getCurrentConfig();
+                const tokenStore = new KeychainTokenStore();
+                const globalConfigStore = new FileGlobalConfigStore();
+                const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
+                const contextTreeSnapshotService = new FileContextTreeSnapshotService();
+                const useCase = new PullUseCase({
+                    cogitPullService: new HttpCogitPullService({
+                        apiBaseUrl: envConfig.cogitApiBaseUrl,
+                    }),
+                    contextTreeSnapshotService,
+                    contextTreeWriterService: new FileContextTreeWriterService({
+                        snapshotService: contextTreeSnapshotService,
+                    }),
+                    projectConfigStore: new ProjectConfigStore(),
+                    terminal,
+                    tokenStore,
+                    trackingService,
+                });
+                await useCase.run({
+                    branch: parsed.flags.branch ?? DEFAULT_BRANCH,
+                });
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'Pull context tree from ByteRover memory storage',
+    flags: toCommandFlags(pullFlags),
+    kind: CommandKind.BUILT_IN,
+    name: 'pull',
+};

package/dist/infra/repl/commands/push-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../tui/types.js';
+/**
+ * Push command
+ */
+export declare const pushCommand: SlashCommand;

package/dist/infra/repl/commands/push-command.js

@@ -0,0 +1,66 @@
+import { getCurrentConfig } from '../../../config/environment.js';
+import { DEFAULT_BRANCH } from '../../../constants.js';
+import { CommandKind } from '../../../tui/types.js';
+import { HttpCogitPushService } from '../../cogit/http-cogit-push-service.js';
+import { ProjectConfigStore } from '../../config/file-config-store.js';
+import { FileContextFileReader } from '../../context-tree/file-context-file-reader.js';
+import { FileContextTreeSnapshotService } from '../../context-tree/file-context-tree-snapshot-service.js';
+import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../terminal/repl-terminal.js';
+import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
+import { PushUseCase } from '../../usecase/push-use-case.js';
+import { Flags, parseReplArgs, toCommandFlags } from './arg-parser.js';
+// Flags - defined once, used for both parsing and help display
+const pushFlags = {
+    branch: Flags.string({
+        char: 'b',
+        default: DEFAULT_BRANCH,
+        description: 'ByteRover branch name (not Git branch)',
+    }),
+    yes: Flags.boolean({
+        char: 'y',
+        default: false,
+        description: 'Skip confirmation prompt',
+    }),
+};
+/**
+ * Push command
+ */
+export const pushCommand = {
+    action(_context, args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const parsed = await parseReplArgs(args, { flags: pushFlags, strict: false });
+                const envConfig = getCurrentConfig();
+                const tokenStore = new KeychainTokenStore();
+                const globalConfigStore = new FileGlobalConfigStore();
+                const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
+                const useCase = new PushUseCase({
+                    cogitPushService: new HttpCogitPushService({
+                        apiBaseUrl: envConfig.cogitApiBaseUrl,
+                    }),
+                    contextFileReader: new FileContextFileReader(),
+                    contextTreeSnapshotService: new FileContextTreeSnapshotService(),
+                    projectConfigStore: new ProjectConfigStore(),
+                    terminal,
+                    tokenStore,
+                    trackingService,
+                    webAppUrl: envConfig.webAppUrl,
+                });
+                await useCase.run({
+                    branch: parsed.flags.branch ?? DEFAULT_BRANCH,
+                    skipConfirmation: parsed.flags.yes ?? false,
+                });
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'Push context tree to ByteRover memory storage',
+    flags: toCommandFlags(pushFlags),
+    kind: CommandKind.BUILT_IN,
+    name: 'push',
+};

package/dist/infra/repl/commands/query-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../tui/types.js';
+/**
+ * Query command - Query and retrieve information from the context tree
+ */
+export declare const queryCommand: SlashCommand;

package/dist/infra/repl/commands/query-command.js

@@ -0,0 +1,66 @@
+import { isDevelopment } from '../../../config/environment.js';
+import { CommandKind } from '../../../tui/types.js';
+import { ProjectConfigStore } from '../../config/file-config-store.js';
+import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../terminal/repl-terminal.js';
+import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
+import { QueryUseCase } from '../../usecase/query-use-case.js';
+import { Flags, parseReplArgs, toCommandFlags } from './arg-parser.js';
+// Dev-only flags - defined once, used for both parsing and help display
+const devFlags = {
+    apiKey: Flags.string({ char: 'k', description: 'OpenRouter API key [Dev only]' }),
+    model: Flags.string({ char: 'm', description: 'Model to use [Dev only]' }),
+    verbose: Flags.boolean({ char: 'v', description: 'Enable verbose debug output [Dev only]' }),
+};
+/**
+ * Query command - Query and retrieve information from the context tree
+ */
+export const queryCommand = {
+    action(_context, args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                // Parse flags only in dev mode, otherwise use args directly as query
+                let query;
+                let flags = {};
+                if (isDevelopment()) {
+                    const parsed = await parseReplArgs(args, { flags: devFlags, strict: false });
+                    query = parsed.argv.join(' ');
+                    flags = parsed.flags;
+                }
+                else {
+                    query = args;
+                }
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const tokenStore = new KeychainTokenStore();
+                const globalConfigStore = new FileGlobalConfigStore();
+                const useCase = new QueryUseCase({
+                    projectConfigStore: new ProjectConfigStore(),
+                    terminal,
+                    tokenStore,
+                    trackingService: new MixpanelTrackingService({ globalConfigStore, tokenStore }),
+                });
+                await useCase.run({
+                    apiKey: flags.apiKey,
+                    model: flags.model,
+                    query,
+                    verbose: Boolean(flags.verbose),
+                });
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: ['q'],
+    args: [
+        {
+            description: 'Natural language question about your codebase',
+            name: 'query',
+            required: true,
+        },
+    ],
+    autoExecute: false,
+    description: 'Query and retrieve information from the context tree',
+    flags: isDevelopment() ? toCommandFlags(devFlags) : [],
+    kind: CommandKind.BUILT_IN,
+    name: 'query',
+};

package/dist/infra/repl/commands/space/index.d.ts

@@ -0,0 +1,5 @@
+import { SlashCommand } from '../../../../tui/types.js';
+/**
+ * Space command - manages ByteRover spaces
+ */
+export declare const spaceCommand: SlashCommand;

package/dist/infra/repl/commands/space/index.js

@@ -0,0 +1,14 @@
+import { CommandKind } from '../../../../tui/types.js';
+import { listCommand } from './list-command.js';
+import { switchCommand } from './switch-command.js';
+/**
+ * Space command - manages ByteRover spaces
+ */
+export const spaceCommand = {
+    aliases: [],
+    autoExecute: true,
+    description: 'Manage ByteRover spaces',
+    kind: CommandKind.BUILT_IN,
+    name: 'space',
+    subCommands: [listCommand, switchCommand],
+};

package/dist/infra/repl/commands/space/list-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../../tui/types.js';
+/**
+ * List spaces command
+ */
+export declare const listCommand: SlashCommand;

package/dist/infra/repl/commands/space/list-command.js

@@ -0,0 +1,70 @@
+import { getCurrentConfig } from '../../../../config/environment.js';
+import { CommandKind } from '../../../../tui/types.js';
+import { ProjectConfigStore } from '../../../config/file-config-store.js';
+import { HttpSpaceService } from '../../../space/http-space-service.js';
+import { KeychainTokenStore } from '../../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../../terminal/repl-terminal.js';
+import { SpaceListUseCase } from '../../../usecase/space-list-use-case.js';
+import { Flags, parseReplArgs, toCommandFlags } from '../arg-parser.js';
+const DEFAULT_LIMIT = 50;
+const DEFAULT_OFFSET = 0;
+// Flags - defined once, used for both parsing and help display
+const listFlags = {
+    all: Flags.boolean({
+        char: 'a',
+        default: false,
+        description: 'Fetch all spaces (may be slow for large teams)',
+    }),
+    json: Flags.boolean({
+        char: 'j',
+        default: false,
+        description: 'Output in JSON format',
+    }),
+    limit: Flags.integer({
+        char: 'l',
+        default: DEFAULT_LIMIT,
+        description: 'Maximum number of spaces to fetch',
+    }),
+    offset: Flags.integer({
+        char: 'o',
+        default: DEFAULT_OFFSET,
+        description: 'Number of spaces to skip',
+    }),
+};
+/**
+ * List spaces command
+ */
+export const listCommand = {
+    action(_context, args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const parsed = await parseReplArgs(args, {
+                    flags: listFlags,
+                    strict: false,
+                });
+                const envConfig = getCurrentConfig();
+                const useCase = new SpaceListUseCase({
+                    flags: {
+                        all: parsed.flags.all ?? false,
+                        json: parsed.flags.json ?? false,
+                        limit: Number(parsed.flags.limit ?? DEFAULT_LIMIT),
+                        offset: Number(parsed.flags.offset ?? DEFAULT_OFFSET),
+                    },
+                    projectConfigStore: new ProjectConfigStore(),
+                    spaceService: new HttpSpaceService({ apiBaseUrl: envConfig.apiBaseUrl }),
+                    terminal,
+                    tokenStore: new KeychainTokenStore(),
+                });
+                await useCase.run();
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'List all spaces for the current team',
+    flags: toCommandFlags(listFlags),
+    kind: CommandKind.BUILT_IN,
+    name: 'list',
+};

package/dist/infra/repl/commands/space/switch-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../../tui/types.js';
+/**
+ * Switch space command
+ */
+export declare const switchCommand: SlashCommand;

package/dist/infra/repl/commands/space/switch-command.js

@@ -0,0 +1,37 @@
+import { getCurrentConfig } from '../../../../config/environment.js';
+import { CommandKind } from '../../../../tui/types.js';
+import { ProjectConfigStore } from '../../../config/file-config-store.js';
+import { HttpSpaceService } from '../../../space/http-space-service.js';
+import { KeychainTokenStore } from '../../../storage/keychain-token-store.js';
+import { HttpTeamService } from '../../../team/http-team-service.js';
+import { ReplTerminal } from '../../../terminal/repl-terminal.js';
+import { SpaceSwitchUseCase } from '../../../usecase/space-switch-use-case.js';
+import { WorkspaceDetectorService } from '../../../workspace/workspace-detector-service.js';
+/**
+ * Switch space command
+ */
+export const switchCommand = {
+    action(_context, _args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const envConfig = getCurrentConfig();
+                const useCase = new SpaceSwitchUseCase({
+                    projectConfigStore: new ProjectConfigStore(),
+                    spaceService: new HttpSpaceService({ apiBaseUrl: envConfig.apiBaseUrl }),
+                    teamService: new HttpTeamService({ apiBaseUrl: envConfig.apiBaseUrl }),
+                    terminal,
+                    tokenStore: new KeychainTokenStore(),
+                    workspaceDetector: new WorkspaceDetectorService(),
+                });
+                await useCase.run();
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'Switch to a different space',
+    kind: CommandKind.BUILT_IN,
+    name: 'switch',
+};

package/dist/infra/repl/commands/status-command.d.ts

@@ -0,0 +1,5 @@
+import { type SlashCommand } from '../../../tui/types.js';
+/**
+ * Status command
+ */
+export declare const statusCommand: SlashCommand;

package/dist/infra/repl/commands/status-command.js

@@ -0,0 +1,39 @@
+import { CommandKind } from '../../../tui/types.js';
+import { ProjectConfigStore } from '../../config/file-config-store.js';
+import { FileContextTreeService } from '../../context-tree/file-context-tree-service.js';
+import { FileContextTreeSnapshotService } from '../../context-tree/file-context-tree-snapshot-service.js';
+import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
+import { ReplTerminal } from '../../terminal/repl-terminal.js';
+import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
+import { StatusUseCase } from '../../usecase/status-use-case.js';
+/**
+ * Status command
+ */
+export const statusCommand = {
+    action(context, _args) {
+        return {
+            async execute(onMessage, onPrompt) {
+                const terminal = new ReplTerminal({ onMessage, onPrompt });
+                const tokenStore = new KeychainTokenStore();
+                const globalConfigStore = new FileGlobalConfigStore();
+                const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
+                const useCase = new StatusUseCase({
+                    contextTreeService: new FileContextTreeService(),
+                    contextTreeSnapshotService: new FileContextTreeSnapshotService(),
+                    projectConfigStore: new ProjectConfigStore(),
+                    terminal,
+                    tokenStore,
+                    trackingService,
+                });
+                await useCase.run({ cliVersion: context.version ?? '' });
+            },
+            type: 'streaming',
+        };
+    },
+    aliases: [],
+    autoExecute: true,
+    description: 'Show CLI status and project information',
+    kind: CommandKind.BUILT_IN,
+    name: 'status',
+};

package/dist/infra/repl/repl-startup.d.ts

@@ -0,0 +1,18 @@
+import type { IOnboardingPreferenceStore } from '../../core/interfaces/i-onboarding-preference-store.js';
+import type { IProjectConfigStore } from '../../core/interfaces/i-project-config-store.js';
+import type { ITokenStore } from '../../core/interfaces/i-token-store.js';
+import type { ITrackingService } from '../../core/interfaces/i-tracking-service.js';
+/**
+ * Options for starting the REPL
+ */
+export interface ReplOptions {
+    onboardingPreferenceStore: IOnboardingPreferenceStore;
+    projectConfigStore: IProjectConfigStore;
+    tokenStore: ITokenStore;
+    trackingService: ITrackingService;
+    version: string;
+}
+/**
+ * Start the ByteRover REPL
+ */
+export declare function startRepl(options: ReplOptions): Promise<void>;

package/dist/infra/repl/repl-startup.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { App } from '../../tui/app.js';
+import { AppProviders } from '../../tui/providers/app-providers.js';
+import { stopQueuePollingService } from '../cipher/consumer/queue-polling-service.js';
+/**
+ * Start the ByteRover REPL
+ */
+export async function startRepl(options) {
+    const { onboardingPreferenceStore, projectConfigStore, tokenStore, trackingService, version } = options;
+    // Check initial auth state
+    const authToken = await tokenStore.load();
+    const isAuthorized = authToken !== undefined && authToken.isValid();
+    // Load project config if authorized
+    let brvConfig;
+    if (isAuthorized) {
+        const configExists = await projectConfigStore.exists();
+        if (configExists) {
+            brvConfig = await projectConfigStore.read();
+        }
+    }
+    // Render the App with providers
+    const { waitUntilExit } = render(_jsx(AppProviders, { initialAuthToken: isAuthorized ? authToken : undefined, initialBrvConfig: brvConfig, onboardingPreferenceStore: onboardingPreferenceStore, projectConfigStore: projectConfigStore, tokenStore: tokenStore, trackingService: trackingService, version: version, children: _jsx(App, {}) }));
+    await waitUntilExit();
+    stopQueuePollingService();
+}

package/dist/infra/storage/file-global-config-store.d.ts

@@ -0,0 +1,22 @@
+import type { IGlobalConfigStore } from '../../core/interfaces/i-global-config-store.js';
+import { GlobalConfig } from '../../core/domain/entities/global-config.js';
+/**
+ * Dependencies for FileGlobalConfigStore.
+ * Allows injection for testing.
+ */
+export interface FileGlobalConfigStoreDeps {
+    readonly getConfigDir: () => string;
+    readonly getConfigPath: () => string;
+}
+/**
+ * File-based implementation of IGlobalConfigStore.
+ * Stores global configuration in the user's config directory.
+ */
+export declare class FileGlobalConfigStore implements IGlobalConfigStore {
+    private readonly deps;
+    constructor(deps?: FileGlobalConfigStoreDeps);
+    getOrCreateDeviceId(): Promise<string>;
+    read(): Promise<GlobalConfig | undefined>;
+    regenerateDeviceId(): Promise<string>;
+    write(config: GlobalConfig): Promise<void>;
+}

package/dist/infra/storage/file-global-config-store.js

@@ -0,0 +1,65 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { GlobalConfig } from '../../core/domain/entities/global-config.js';
+import { getGlobalConfigDir, getGlobalConfigPath } from '../../utils/global-config-path.js';
+/**
+ * Default dependencies using the real path functions.
+ */
+const defaultDeps = {
+    getConfigDir: getGlobalConfigDir,
+    getConfigPath: getGlobalConfigPath,
+};
+/**
+ * File-based implementation of IGlobalConfigStore.
+ * Stores global configuration in the user's config directory.
+ */
+export class FileGlobalConfigStore {
+    deps;
+    constructor(deps = defaultDeps) {
+        this.deps = deps;
+    }
+    async getOrCreateDeviceId() {
+        // Try to read existing config
+        const existingConfig = await this.read();
+        if (existingConfig !== undefined) {
+            return existingConfig.deviceId;
+        }
+        // Generate new device ID and persist
+        const deviceId = randomUUID();
+        const newConfig = GlobalConfig.create(deviceId);
+        await this.write(newConfig);
+        return deviceId;
+    }
+    async read() {
+        const configPath = this.deps.getConfigPath();
+        if (!existsSync(configPath)) {
+            return undefined;
+        }
+        try {
+            const content = await readFile(configPath, 'utf8');
+            const json = JSON.parse(content);
+            return GlobalConfig.fromJson(json);
+        }
+        catch {
+            // Return undefined for any error (corrupted file, permission issues, etc.)
+            // The caller can regenerate the config if needed
+            return undefined;
+        }
+    }
+    async regenerateDeviceId() {
+        const newDeviceId = randomUUID();
+        const newConfig = GlobalConfig.create(newDeviceId);
+        await this.write(newConfig);
+        return newDeviceId;
+    }
+    async write(config) {
+        const configDir = this.deps.getConfigDir();
+        const configPath = this.deps.getConfigPath();
+        // Create config directory if it doesn't exist
+        await mkdir(configDir, { recursive: true });
+        // Write config.json
+        const content = JSON.stringify(config.toJson(), null, 2);
+        await writeFile(configPath, content, 'utf8');
+    }
+}

package/dist/infra/storage/file-onboarding-preference-store.d.ts

@@ -0,0 +1,10 @@
+import type { IOnboardingPreferenceStore } from '../../core/interfaces/i-onboarding-preference-store.js';
+/**
+ * Onboarding preference store implementation using a lock file.
+ * Stores last dismissed timestamp in ~/.brv/.onboarding-dismissed
+ */
+export declare class FileOnboardingPreferenceStore implements IOnboardingPreferenceStore {
+    clear(): Promise<void>;
+    getLastDismissedAt(): Promise<number | undefined>;
+    setLastDismissedAt(timestamp: number): Promise<void>;
+}

package/dist/infra/storage/file-onboarding-preference-store.js

@@ -0,0 +1,46 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const BRV_HOME_DIR = join(homedir(), '.brv');
+const ONBOARDING_LOCK_FILE = join(BRV_HOME_DIR, '.onboarding-dismissed');
+/**
+ * Onboarding preference store implementation using a lock file.
+ * Stores last dismissed timestamp in ~/.brv/.onboarding-dismissed
+ */
+export class FileOnboardingPreferenceStore {
+    async clear() {
+        try {
+            if (existsSync(ONBOARDING_LOCK_FILE)) {
+                rmSync(ONBOARDING_LOCK_FILE);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    async getLastDismissedAt() {
+        try {
+            if (!existsSync(ONBOARDING_LOCK_FILE)) {
+                return undefined;
+            }
+            const content = readFileSync(ONBOARDING_LOCK_FILE, 'utf8').trim();
+            const timestamp = Number.parseInt(content, 10);
+            return Number.isNaN(timestamp) ? undefined : timestamp;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async setLastDismissedAt(timestamp) {
+        try {
+            // Ensure ~/.brv directory exists
+            if (!existsSync(BRV_HOME_DIR)) {
+                mkdirSync(BRV_HOME_DIR, { recursive: true });
+            }
+            writeFileSync(ONBOARDING_LOCK_FILE, String(timestamp), 'utf8');
+        }
+        catch {
+            // Silently ignore errors - onboarding preference is non-critical
+        }
+    }
+}