byterover-cli 3.5.0 → 3.6.0

package/.env.production

@@ -1,8 +1,6 @@
-BRV_API_BASE_URL=https://iam.byterover.dev/api/v1
-BRV_AUTHORIZATION_URL=https://iam.byterover.dev/api/v1/oidc/authorize
-BRV_COGIT_API_BASE_URL=https://v3-cgit.byterover.dev/api/v1
+# ByteRover CLI - Production Environment Configuration
+BRV_IAM_BASE_URL=https://iam.byterover.dev
+BRV_COGIT_BASE_URL=https://v3-cgit.byterover.dev
 BRV_GIT_REMOTE_BASE_URL=https://byterover.dev
-BRV_ISSUER_URL=https://iam.byterover.dev/api/v1/oidc
-BRV_LLM_API_BASE_URL=https://llm.byterover.dev
-BRV_TOKEN_URL=https://iam.byterover.dev/api/v1/oidc/token
+BRV_LLM_BASE_URL=https://llm.byterover.dev
 BRV_WEB_APP_URL=https://app.byterover.dev

package/dist/agent/core/interfaces/i-cipher-agent.d.ts

@@ -133,6 +133,7 @@ export interface ICipherAgent {
      */
     executeOnSession(sessionId: string, input: string, options?: {
         executionContext?: ExecutionContext;
+        signal?: AbortSignal;
         taskId?: string;
     }): Promise<string>;
     /**

package/dist/agent/infra/agent/cipher-agent.d.ts

@@ -161,6 +161,7 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      */
     executeOnSession(sessionId: string, input: string, options?: {
         executionContext?: ExecutionContext;
+        signal?: AbortSignal;
         taskId?: string;
     }): Promise<string>;
     /**

package/dist/agent/infra/agent/cipher-agent.js

@@ -344,6 +344,7 @@ export class CipherAgent extends BaseAgent {
         const response = await this.generate(input, {
             executionContext: options?.executionContext,
             sessionId,
+            signal: options?.signal,
             taskId: options?.taskId,
         });
         return response.content;

package/dist/oclif/commands/curate/view.js

@@ -3,28 +3,8 @@ import { resolveProject } from '../../../server/infra/project/resolve-project.js
 import { FileCurateLogStore } from '../../../server/infra/storage/file-curate-log-store.js';
 import { CurateLogUseCase } from '../../../server/infra/usecase/curate-log-use-case.js';
 import { getProjectDataDir } from '../../../server/utils/path-utils.js';
+import { parseTimeFilter } from '../../lib/time-filter.js';
 const VALID_STATUSES = ['cancelled', 'completed', 'error', 'processing'];
-const RELATIVE_TIME_PATTERN = /^(\d+)(m|h|d|w)$/;
-/**
- * Parse a time filter value into a UTC millisecond timestamp.
- *
- * Accepts:
- *  - Relative: "30m", "1h", "24h", "7d", "2w"
- *  - Absolute: ISO date "2024-01-15" or datetime "2024-01-15T12:00:00Z"
- *
- * Returns null when the value cannot be parsed.
- */
-function parseTimeFilter(value) {
-    const relMatch = RELATIVE_TIME_PATTERN.exec(value);
-    if (relMatch) {
-        const amount = Number(relMatch[1]);
-        const unit = relMatch[2];
-        const multipliers = { d: 86_400_000, h: 3_600_000, m: 60_000, w: 604_800_000 };
-        return Date.now() - amount * multipliers[unit];
-    }
-    const ts = new Date(value).getTime();
-    return Number.isNaN(ts) ? null : ts;
-}
 export default class CurateView extends Command {
     static args = {
         id: Args.string({
@@ -47,7 +27,7 @@ export default class CurateView extends Command {
     ];
     static flags = {
         before: Flags.string({
-            description: 'Show entries started before this time (ISO date or relative: 1h, 24h, 7d, 2w)',
+            description: 'Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)',
         }),
         detail: Flags.boolean({
             default: false,
@@ -64,7 +44,7 @@ export default class CurateView extends Command {
             min: 1,
         }),
         since: Flags.string({
-            description: 'Show entries started after this time (ISO date or relative: 1h, 24h, 7d, 2w)',
+            description: 'Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)',
         }),
         status: Flags.string({
             description: `Filter by status (can be repeated). Options: ${VALID_STATUSES.join(', ')}`,
@@ -96,8 +76,8 @@ export default class CurateView extends Command {
     }
     parseTime(value, flagName) {
         const ts = parseTimeFilter(value);
-        if (ts === null) {
-            this.error(`Invalid time value for ${flagName}: "${value}". Use ISO date (2024-01-15) or relative (1h, 24h, 7d, 2w).`, { exit: 2 });
+        if (ts === undefined) {
+            this.error(`Invalid time value for ${flagName}: "${value}". Use ISO date (2024-01-15) or relative (30m, 1h, 24h, 7d, 2w).`, { exit: 2 });
         }
         return ts;
     }

package/dist/oclif/commands/dream.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { type DaemonClientOptions } from '../lib/daemon-client.js';
+export default class Dream extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        detach: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        undo: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected getDaemonClientOptions(): DaemonClientOptions;
+    run(): Promise<void>;
+    private reportError;
+    private runUndo;
+    private submitTask;
+}

package/dist/oclif/commands/dream.js

@@ -0,0 +1,230 @@
+import { Command, Flags } from '@oclif/core';
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { BRV_DIR, CONTEXT_TREE_DIR } from '../../server/constants.js';
+import { TransportStateEventNames } from '../../server/core/domain/transport/schemas.js';
+import { FileContextTreeArchiveService } from '../../server/infra/context-tree/file-context-tree-archive-service.js';
+import { FileContextTreeManifestService } from '../../server/infra/context-tree/file-context-tree-manifest-service.js';
+import { DreamLogStore } from '../../server/infra/dream/dream-log-store.js';
+import { DreamStateService } from '../../server/infra/dream/dream-state-service.js';
+import { undoLastDream } from '../../server/infra/dream/dream-undo.js';
+import { resolveProject } from '../../server/infra/project/resolve-project.js';
+import { FileCurateLogStore } from '../../server/infra/storage/file-curate-log-store.js';
+import { FileReviewBackupStore } from '../../server/infra/storage/file-review-backup-store.js';
+import { getProjectDataDir } from '../../server/utils/path-utils.js';
+import { TaskEvents } from '../../shared/transport/events/index.js';
+import { formatConnectionError, hasLeakedHandles, providerMissingMessage, withDaemonRetry, } from '../lib/daemon-client.js';
+import { writeJsonResponse } from '../lib/json-response.js';
+import { DEFAULT_TIMEOUT_SECONDS, MAX_TIMEOUT_SECONDS, MIN_TIMEOUT_SECONDS, waitForTaskCompletion } from '../lib/task-client.js';
+export default class Dream extends Command {
+    static description = 'Run background memory consolidation on the context tree';
+    static examples = [
+        '# Run dream (checks time, activity, and queue gates)',
+        '<%= config.bin %> <%= command.id %>',
+        '',
+        '# Force dream (skip time/activity/queue gates, lock still checked)',
+        '<%= config.bin %> <%= command.id %> --force',
+        '',
+        '# Revert the last dream',
+        '<%= config.bin %> <%= command.id %> --undo',
+        '',
+        '# Queue dream and exit immediately',
+        '<%= config.bin %> <%= command.id %> --detach',
+        '',
+        '# Force dream and exit immediately',
+        '<%= config.bin %> <%= command.id %> --force --detach',
+        '',
+        '# JSON output',
+        '<%= config.bin %> <%= command.id %> --format json',
+    ];
+    static flags = {
+        detach: Flags.boolean({
+            default: false,
+            description: 'Queue task and exit without waiting for completion',
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Skip time and activity gates (lock still checked)',
+        }),
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format (text or json)',
+            options: ['text', 'json'],
+        }),
+        timeout: Flags.integer({
+            default: DEFAULT_TIMEOUT_SECONDS,
+            description: 'Maximum seconds to wait for task completion',
+            max: MAX_TIMEOUT_SECONDS,
+            min: MIN_TIMEOUT_SECONDS,
+        }),
+        undo: Flags.boolean({
+            default: false,
+            description: 'Revert the last dream',
+        }),
+    };
+    getDaemonClientOptions() {
+        return {};
+    }
+    async run() {
+        const { flags: rawFlags } = await this.parse(Dream);
+        const format = rawFlags.format === 'json' ? 'json' : 'text';
+        if (rawFlags.undo) {
+            await this.runUndo(format);
+            return;
+        }
+        let providerContext;
+        try {
+            await withDaemonRetry(async (client, projectRoot, worktreeRoot) => {
+                const active = await client.requestWithAck(TransportStateEventNames.GET_PROVIDER_CONFIG);
+                providerContext = { activeModel: active.activeModel, activeProvider: active.activeProvider };
+                if (!active.activeProvider) {
+                    throw new Error('No provider connected. Run "brv providers connect byterover" to use the free built-in provider, or connect another provider.');
+                }
+                if (active.providerKeyMissing) {
+                    throw new Error(providerMissingMessage(active.activeProvider, active.authMethod));
+                }
+                await this.submitTask({
+                    client,
+                    detach: rawFlags.detach,
+                    force: rawFlags.force,
+                    format,
+                    projectRoot,
+                    timeout: rawFlags.timeout ?? DEFAULT_TIMEOUT_SECONDS,
+                    worktreeRoot,
+                });
+            }, {
+                ...this.getDaemonClientOptions(),
+                onRetry: format === 'text'
+                    ? (attempt, maxRetries) => this.log(`\nConnection lost. Restarting daemon... (attempt ${attempt}/${maxRetries})`)
+                    : undefined,
+            });
+        }
+        catch (error) {
+            this.reportError(error, format, providerContext);
+        }
+    }
+    reportError(error, format, providerContext) {
+        const errorMessage = error instanceof Error ? error.message : 'Dream failed';
+        if (format === 'json') {
+            writeJsonResponse({ command: 'dream', data: { error: errorMessage, status: 'error' }, success: false });
+        }
+        else {
+            this.log(formatConnectionError(error, providerContext));
+        }
+        if (hasLeakedHandles(error)) {
+            // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit
+            process.exit(1);
+        }
+    }
+    async runUndo(format) {
+        const projectRoot = resolveProject()?.projectRoot ?? process.cwd();
+        const brvDir = join(projectRoot, BRV_DIR);
+        const contextTreeDir = join(brvDir, CONTEXT_TREE_DIR);
+        const projectDataDir = getProjectDataDir(projectRoot);
+        try {
+            const result = await undoLastDream({
+                archiveService: new FileContextTreeArchiveService(),
+                contextTreeDir,
+                curateLogStore: new FileCurateLogStore({ baseDir: projectDataDir }),
+                dreamLogStore: new DreamLogStore({ baseDir: brvDir }),
+                dreamStateService: new DreamStateService({ baseDir: brvDir }),
+                manifestService: new FileContextTreeManifestService({ baseDirectory: projectRoot }),
+                projectRoot,
+                reviewBackupStore: new FileReviewBackupStore(brvDir),
+            });
+            if (format === 'json') {
+                writeJsonResponse({ command: 'dream', data: { ...result, status: 'undone' }, success: true });
+            }
+            else {
+                this.log(`Undone dream ${result.dreamId}`);
+                this.log(`  Restored: ${result.restoredFiles.length} files`);
+                this.log(`  Deleted: ${result.deletedFiles.length} files`);
+                this.log(`  Restored archives: ${result.restoredArchives.length} files`);
+                if (result.errors.length > 0) {
+                    this.log(`  Errors: ${result.errors.length}`);
+                    for (const e of result.errors) {
+                        this.log(`    - ${e}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Undo failed';
+            if (format === 'json') {
+                writeJsonResponse({ command: 'dream', data: { error: message, status: 'error' }, success: false });
+            }
+            else {
+                this.log(`Undo failed: ${message}`);
+            }
+        }
+    }
+    async submitTask(props) {
+        const { client, detach, force, format, projectRoot, timeout, worktreeRoot } = props;
+        const taskId = randomUUID();
+        const taskPayload = {
+            content: force ? 'Memory consolidation (force)' : 'Memory consolidation',
+            ...(force ? { force: true } : {}),
+            ...(projectRoot ? { projectPath: projectRoot } : {}),
+            taskId,
+            type: 'dream',
+            ...(worktreeRoot ? { worktreeRoot } : {}),
+        };
+        if (detach) {
+            if (timeout !== DEFAULT_TIMEOUT_SECONDS && format !== 'json') {
+                this.log('Note: --timeout has no effect with --detach');
+            }
+            const ack = await client.requestWithAck(TaskEvents.CREATE, taskPayload);
+            const { logId } = ack;
+            if (format === 'json') {
+                writeJsonResponse({
+                    command: 'dream',
+                    data: { logId, message: 'Dream queued for processing', status: 'queued', taskId },
+                    success: true,
+                });
+            }
+            else {
+                const logSuffix = logId ? ` (Log: ${logId})` : '';
+                this.log(`✓ Dream queued for processing.${logSuffix}`);
+            }
+        }
+        else {
+            const completionPromise = waitForTaskCompletion({
+                client,
+                command: 'dream',
+                format,
+                onCompleted: ({ logId, result, taskId: tid }) => {
+                    const skipped = result?.startsWith('Dream skipped:');
+                    if (format === 'json') {
+                        writeJsonResponse({
+                            command: 'dream',
+                            data: skipped
+                                ? { reason: result, status: 'skipped', taskId: tid }
+                                : { logId, result, status: 'completed', taskId: tid },
+                            success: true,
+                        });
+                    }
+                    else {
+                        this.log(result ?? '');
+                    }
+                },
+                onError: ({ error }) => {
+                    if (format === 'json') {
+                        writeJsonResponse({
+                            command: 'dream',
+                            data: { event: 'error', message: error.message, status: 'error' },
+                            success: false,
+                        });
+                    }
+                    else {
+                        this.log(`Dream failed: ${error.message}`);
+                    }
+                },
+                taskId,
+                timeoutMs: timeout * 1000,
+            }, (msg) => this.log(msg));
+            await client.requestWithAck(TaskEvents.CREATE, taskPayload);
+            await completionPromise;
+        }
+    }
+}

package/dist/oclif/commands/query-log/summary.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { QueryLogSummaryUseCase } from '../../../server/infra/usecase/query-log-summary-use-case.js';
+export default class QueryLogSummary extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        before: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        last: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected createDependencies(baseDir: string): {
+        useCase: QueryLogSummaryUseCase;
+    };
+    run(): Promise<void>;
+    private parseTime;
+    private resolveAfter;
+}

package/dist/oclif/commands/query-log/summary.js

@@ -0,0 +1,75 @@
+import { Command, Flags } from '@oclif/core';
+import { resolveProject } from '../../../server/infra/project/resolve-project.js';
+import { FileQueryLogStore } from '../../../server/infra/storage/file-query-log-store.js';
+import { QueryLogSummaryUseCase } from '../../../server/infra/usecase/query-log-summary-use-case.js';
+import { getProjectDataDir } from '../../../server/utils/path-utils.js';
+import { parseTimeFilter } from '../../lib/time-filter.js';
+const DEFAULT_WINDOW_MS = 24 * 60 * 60 * 1000; // last 24h
+const FORMAT_OPTIONS = ['text', 'json', 'narrative'];
+export default class QueryLogSummary extends Command {
+    static description = 'View aggregated query recall metrics (coverage, cache hit rate, top topics)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --last 24h',
+        '<%= config.bin %> <%= command.id %> --last 7d',
+        '<%= config.bin %> <%= command.id %> --last 30d',
+        '<%= config.bin %> <%= command.id %> --format json',
+        '<%= config.bin %> <%= command.id %> --format narrative',
+        '<%= config.bin %> <%= command.id %> --since 2026-04-01 --before 2026-04-03',
+    ];
+    static flags = {
+        before: Flags.string({
+            description: 'Entries before (ISO date or relative: 1h, 24h, 7d, 2w)',
+        }),
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format',
+            options: FORMAT_OPTIONS,
+        }),
+        last: Flags.string({
+            description: 'Relative time window (e.g., 1h, 24h, 7d, 30d). Default: 24h. Takes precedence over --since.',
+        }),
+        since: Flags.string({
+            description: 'Entries after (ISO date or relative: 1h, 24h, 7d, 2w)',
+        }),
+    };
+    createDependencies(baseDir) {
+        const store = new FileQueryLogStore({ baseDir });
+        const useCase = new QueryLogSummaryUseCase({
+            queryLogStore: store,
+            terminal: { log: (m) => this.log(m ?? '') },
+        });
+        return { useCase };
+    }
+    async run() {
+        const { flags } = await this.parse(QueryLogSummary);
+        const after = this.resolveAfter(flags);
+        const before = flags.before ? this.parseTime(flags.before, '--before') : undefined;
+        const format = flags.format === 'json' || flags.format === 'narrative' ? flags.format : 'text';
+        const projectRoot = resolveProject()?.projectRoot ?? process.cwd();
+        const baseDir = getProjectDataDir(projectRoot);
+        const { useCase } = this.createDependencies(baseDir);
+        await useCase.run({ after, before, format });
+    }
+    parseTime(value, flagName) {
+        const ts = parseTimeFilter(value);
+        if (ts === undefined) {
+            this.error(`Invalid time value for ${flagName}: "${value}". Use ISO date (2024-01-15) or relative (30m, 1h, 24h, 7d, 2w).`, { exit: 2 });
+        }
+        return ts;
+    }
+    resolveAfter(flags) {
+        if (flags.last) {
+            return this.parseTime(flags.last, '--last');
+        }
+        if (flags.since) {
+            return this.parseTime(flags.since, '--since');
+        }
+        // Default to last 24h only when NO time flag is provided at all.
+        // If only --before is given, leave after undefined (all time before X).
+        if (!flags.before) {
+            return Date.now() - DEFAULT_WINDOW_MS;
+        }
+        return undefined;
+    }
+}

package/dist/oclif/commands/query-log/view.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@oclif/core';
+import { QueryLogUseCase } from '../../../server/infra/usecase/query-log-use-case.js';
+export default class QueryLogView extends Command {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        before: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        detail: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tier: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected createDependencies(baseDir: string): {
+        useCase: QueryLogUseCase;
+    };
+    run(): Promise<void>;
+    private parseTime;
+}

package/dist/oclif/commands/query-log/view.js

@@ -0,0 +1,95 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { QUERY_LOG_STATUSES, QUERY_LOG_TIERS } from '../../../server/core/domain/entities/query-log-entry.js';
+import { resolveProject } from '../../../server/infra/project/resolve-project.js';
+import { FileQueryLogStore } from '../../../server/infra/storage/file-query-log-store.js';
+import { QueryLogUseCase } from '../../../server/infra/usecase/query-log-use-case.js';
+import { getProjectDataDir } from '../../../server/utils/path-utils.js';
+import { parseTimeFilter } from '../../lib/time-filter.js';
+export default class QueryLogView extends Command {
+    static args = {
+        id: Args.string({
+            description: 'Query log entry ID to view in detail',
+            required: false,
+        }),
+    };
+    static description = 'View query log history';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> qry-1712345678901',
+        '<%= config.bin %> <%= command.id %> --limit 20',
+        '<%= config.bin %> <%= command.id %> --status completed',
+        '<%= config.bin %> <%= command.id %> --status completed --status error',
+        '<%= config.bin %> <%= command.id %> --tier 0 --tier 1',
+        '<%= config.bin %> <%= command.id %> --since 1h',
+        '<%= config.bin %> <%= command.id %> --since 2024-01-15',
+        '<%= config.bin %> <%= command.id %> --before 2024-02-01',
+        '<%= config.bin %> <%= command.id %> --detail',
+        '<%= config.bin %> <%= command.id %> --format json',
+    ];
+    static flags = {
+        before: Flags.string({
+            description: 'Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)',
+        }),
+        detail: Flags.boolean({
+            default: false,
+            description: 'Show matched docs for each entry',
+        }),
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format',
+            options: ['text', 'json'],
+        }),
+        limit: Flags.integer({
+            default: 10,
+            description: 'Maximum number of log entries to display',
+            min: 1,
+        }),
+        since: Flags.string({
+            description: 'Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)',
+        }),
+        status: Flags.string({
+            description: `Filter by status (can be repeated). Options: ${QUERY_LOG_STATUSES.join(', ')}`,
+            multiple: true,
+            options: QUERY_LOG_STATUSES,
+        }),
+        tier: Flags.string({
+            description: `Filter by resolution tier (can be repeated). Options: ${QUERY_LOG_TIERS.join(', ')}`,
+            multiple: true,
+            options: QUERY_LOG_TIERS.map(String),
+        }),
+    };
+    createDependencies(baseDir) {
+        const store = new FileQueryLogStore({ baseDir });
+        const useCase = new QueryLogUseCase({
+            queryLogStore: store,
+            terminal: { log: (m) => this.log(m ?? '') },
+        });
+        return { useCase };
+    }
+    async run() {
+        const { args, flags } = await this.parse(QueryLogView);
+        const after = flags.since ? this.parseTime(flags.since, '--since') : undefined;
+        const before = flags.before ? this.parseTime(flags.before, '--before') : undefined;
+        const format = flags.format === 'json' ? 'json' : 'text';
+        const projectRoot = resolveProject()?.projectRoot ?? process.cwd();
+        const baseDir = getProjectDataDir(projectRoot);
+        const { useCase } = this.createDependencies(baseDir);
+        await useCase.run({
+            after,
+            before,
+            detail: flags.detail,
+            format,
+            id: args.id,
+            limit: flags.limit,
+            status: flags.status?.filter((s) => QUERY_LOG_STATUSES.includes(s)),
+            tier: flags.tier?.map(Number).filter((t) => QUERY_LOG_TIERS.includes(t)),
+        });
+    }
+    parseTime(value, flagName) {
+        const ts = parseTimeFilter(value);
+        if (ts === undefined) {
+            this.error(`Invalid time value for ${flagName}: "${value}". Use ISO date (2024-01-15) or relative (30m, 1h, 24h, 7d, 2w).`, { exit: 2 });
+        }
+        return ts;
+    }
+}

package/dist/oclif/lib/time-filter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parse a time filter value into a UTC millisecond timestamp.
+ *
+ * Accepts:
+ *  - Relative: "30m", "1h", "24h", "7d", "2w"
+ *  - Absolute: ISO date "2024-01-15" or datetime "2024-01-15T12:00:00Z"
+ *
+ * Returns undefined when the value cannot be parsed.
+ */
+export declare function parseTimeFilter(value: string): number | undefined;

package/dist/oclif/lib/time-filter.js

@@ -0,0 +1,21 @@
+const RELATIVE_TIME_PATTERN = /^(\d+)(m|h|d|w)$/;
+/**
+ * Parse a time filter value into a UTC millisecond timestamp.
+ *
+ * Accepts:
+ *  - Relative: "30m", "1h", "24h", "7d", "2w"
+ *  - Absolute: ISO date "2024-01-15" or datetime "2024-01-15T12:00:00Z"
+ *
+ * Returns undefined when the value cannot be parsed.
+ */
+export function parseTimeFilter(value) {
+    const relMatch = RELATIVE_TIME_PATTERN.exec(value);
+    if (relMatch) {
+        const amount = Number(relMatch[1]);
+        const unit = relMatch[2];
+        const multipliers = { d: 86_400_000, h: 3_600_000, m: 60_000, w: 604_800_000 };
+        return Date.now() - amount * multipliers[unit];
+    }
+    const ts = new Date(value).getTime();
+    return Number.isNaN(ts) ? undefined : ts;
+}

package/dist/server/config/environment.d.ts

@@ -5,16 +5,23 @@ type Environment = 'development' | 'production';
 export declare const ENVIRONMENT: Environment;
 /**
  * Environment-specific configuration.
+ *
+ * Base URL vars (BRV_IAM_BASE_URL, BRV_COGIT_BASE_URL, BRV_LLM_BASE_URL)
+ * store only the root domain (e.g., http://localhost:8080).
+ *
+ * NOTE: The OIDC sub-path (/api/v1/oidc) is intentionally baked into the
+ * derived OIDC URLs below because it is a fixed, auth-specific structure
+ * that does not follow the general "API version at point of use" pattern.
  */
 type EnvironmentConfig = {
-    apiBaseUrl: string;
     authorizationUrl: string;
     clientId: string;
-    cogitApiBaseUrl: string;
+    cogitBaseUrl: string;
     gitRemoteBaseUrl: string;
     hubRegistryUrl: string;
+    iamBaseUrl: string;
     issuerUrl: string;
-    llmApiBaseUrl: string;
+    llmBaseUrl: string;
     scopes: string[];
     tokenUrl: string;
     webAppUrl: string;