byterover-cli 2.6.0 → 3.0.0

package/dist/oclif/commands/review/pending.js

@@ -0,0 +1,94 @@
+import { Command, Flags } from '@oclif/core';
+import { ReviewEvents, } from '../../../shared/transport/events/review-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+import { writeJsonResponse } from '../../lib/json-response.js';
+export default class ReviewPending extends Command {
+    static description = 'List all pending review operations for the current project';
+    static examples = [
+        '# Show all pending reviews',
+        '<%= config.bin %> review pending',
+        '',
+        '# Get structured output for agent-driven workflows',
+        '<%= config.bin %> review pending --format json',
+    ];
+    static flags = {
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format (text or json)',
+            options: ['text', 'json'],
+        }),
+    };
+    getDaemonClientOptions() {
+        return {};
+    }
+    async run() {
+        const { flags } = await this.parse(ReviewPending);
+        const format = flags.format === 'json' ? 'json' : 'text';
+        try {
+            const response = await withDaemonRetry((client) => client.requestWithAck(ReviewEvents.PENDING, {}), this.getDaemonClientOptions());
+            if (format === 'json') {
+                writeJsonResponse({
+                    command: 'review',
+                    data: {
+                        pendingCount: response.pendingCount,
+                        status: 'success',
+                        tasks: response.tasks,
+                    },
+                    success: true,
+                });
+            }
+            else {
+                this.printText(response);
+            }
+        }
+        catch (error) {
+            if (format === 'json') {
+                writeJsonResponse({
+                    command: 'review',
+                    data: { error: error instanceof Error ? error.message : 'Review failed', status: 'error' },
+                    success: false,
+                });
+            }
+            else {
+                this.log(formatConnectionError(error));
+            }
+        }
+    }
+    printTask(task) {
+        this.log(`  Task: ${task.taskId}`);
+        for (const [i, op] of task.operations.entries()) {
+            const impact = op.impact === 'high' ? ' · HIGH IMPACT' : '';
+            const displayPath = op.filePath ?? op.path;
+            if (i > 0)
+                this.log('');
+            this.log(`  [${op.type}${impact}] - path: ${displayPath}`);
+            if (op.reason)
+                this.log(`  Why:    ${op.reason}`);
+            if (op.previousSummary)
+                this.log(`  Before: ${op.previousSummary.replaceAll('\n', '\n          ')}`);
+            if (op.summary)
+                this.log(`  After:  ${op.summary.replaceAll('\n', '\n          ')}`);
+        }
+        this.log('');
+        this.log(`  To approve all:  ${this.config.bin} review approve ${task.taskId}`);
+        this.log(`  To reject all:   ${this.config.bin} review reject ${task.taskId}`);
+        this.log(`  Per file:        ${this.config.bin} review approve/reject ${task.taskId} --file <path> [--file <path>]`);
+    }
+    printText(response) {
+        if (response.pendingCount === 0) {
+            this.log('No pending reviews.');
+            return;
+        }
+        const { pendingCount } = response;
+        this.log(`${pendingCount} operation${pendingCount === 1 ? '' : 's'} pending review`);
+        this.log('');
+        for (const [i, task] of response.tasks.entries()) {
+            if (i > 0) {
+                this.log('');
+                this.log('---');
+                this.log('');
+            }
+            this.printTask(task);
+        }
+    }
+}

package/dist/oclif/commands/review/reject.d.ts

@@ -0,0 +1,17 @@
+import type { ReviewDecideTaskResponse } from '../../../shared/transport/events/review-events.js';
+import { ReviewDecisionCommand } from './base-review-decision.js';
+type ReviewFile = ReviewDecideTaskResponse['files'][number];
+export default class ReviewReject extends ReviewDecisionCommand {
+    static args: {
+        taskId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected readonly decision: "rejected";
+    protected formatFileLine(file: ReviewFile): string;
+}
+export {};

package/dist/oclif/commands/review/reject.js

@@ -0,0 +1,38 @@
+import { Args, Flags } from '@oclif/core';
+import { ReviewDecisionCommand } from './base-review-decision.js';
+export default class ReviewReject extends ReviewDecisionCommand {
+    static args = {
+        taskId: Args.string({
+            description: 'Task ID shown in the curate output (e.g. "brv review reject abc-123")',
+            required: true,
+        }),
+    };
+    static description = 'Reject pending review operations for a curate task (restores files from backup)';
+    static examples = [
+        '# Reject all pending changes from a curate task',
+        '<%= config.bin %> review reject abc-123',
+        '',
+        '# Reject specific files',
+        '<%= config.bin %> review reject abc-123 --file architecture/security/audit.md',
+        '<%= config.bin %> review reject abc-123 --file auth/jwt.md --file auth/oauth.md',
+        '',
+        '# Reject and get structured output (useful for coding agents)',
+        '<%= config.bin %> review reject abc-123 --format json',
+    ];
+    static flags = {
+        file: Flags.string({
+            description: 'Reject only the specified file path(s) (relative to context tree)',
+            multiple: true,
+        }),
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format (text or json)',
+            options: ['text', 'json'],
+        }),
+    };
+    decision = 'rejected';
+    formatFileLine(file) {
+        const suffix = file.reverted ? ' (restored from backup)' : '';
+        return `✓ Rejected ${file.path}${suffix}`;
+    }
+}

package/dist/oclif/commands/space/list.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { type SpaceListResponse } from '../../../shared/transport/events/space-events.js';
+import type { StatusGetResponse } from '../../../shared/transport/events/status-events.js';
 import { type DaemonClientOptions } from '../../lib/daemon-client.js';
 export default class SpaceList extends Command {
     static description: string;
@@ -7,6 +7,6 @@ export default class SpaceList extends Command {
     static flags: {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    protected fetchSpaces(options?: DaemonClientOptions): Promise<SpaceListResponse>;
+    protected checkDeprecation(options?: DaemonClientOptions): Promise<StatusGetResponse>;
     run(): Promise<void>;
 }

package/dist/oclif/commands/space/list.js

@@ -1,10 +1,10 @@
 import { Command, Flags } from '@oclif/core';
-import { SpaceEvents } from '../../../shared/transport/events/space-events.js';
+import { StatusEvents } from '../../../shared/transport/events/status-events.js';
 import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
 import { writeJsonResponse } from '../../lib/json-response.js';
 export default class SpaceList extends Command {
-    static description = 'List all teams and spaces';
-    static examples = ['<%= config.bin %> space list', '<%= config.bin %> space list --format json'];
+    static description = 'List all teams and spaces (deprecated)';
+    static examples = ['<%= config.bin %> space list'];
     static flags = {
         format: Flags.string({
             char: 'f',
@@ -13,45 +13,23 @@ export default class SpaceList extends Command {
             options: ['text', 'json'],
         }),
     };
-    async fetchSpaces(options) {
-        return withDaemonRetry(async (client) => client.requestWithAck(SpaceEvents.LIST), options);
+    async checkDeprecation(options) {
+        return withDaemonRetry(async (client) => client.requestWithAck(StatusEvents.GET), options);
     }
     async run() {
         const { flags } = await this.parse(SpaceList);
         const format = flags.format;
         try {
-            const { teams } = await this.fetchSpaces();
+            const { status } = await this.checkDeprecation();
+            const isVc = status.contextTreeStatus === 'git_vc';
+            const message = isVc
+                ? 'The space list command has been deprecated. Visit the ByteRover web dashboard to view your spaces.'
+                : 'The space list command has been deprecated. Visit the ByteRover web dashboard to view your spaces and follow the migration guide to version control.';
             if (format === 'json') {
-                const data = {
-                    teams: teams.map((t) => ({
-                        teamId: t.teamId,
-                        teamName: t.teamName,
-                        // eslint-disable-next-line perfectionist/sort-objects
-                        spaces: t.spaces.map((s) => ({
-                            isDefault: s.isDefault,
-                            spaceId: s.id,
-                            spaceName: s.name,
-                        })),
-                    })),
-                };
-                writeJsonResponse({ command: 'space list', data, success: true });
-                return;
+                writeJsonResponse({ command: 'space list', data: { message }, success: true });
             }
-            if (teams.length === 0) {
-                this.log('No teams found.');
-                return;
-            }
-            for (const [index, team] of teams.entries()) {
-                this.log(`${index + 1}. ${team.teamName} (team)`);
-                if (team.spaces.length === 0) {
-                    this.log('   No spaces');
-                }
-                else {
-                    for (const space of team.spaces) {
-                        const defaultMarker = space.isDefault ? ' (default)' : '';
-                        this.log(`   - ${space.name}${defaultMarker} (space)`);
-                    }
-                }
+            else {
+                this.log(message);
             }
         }
         catch (error) {

package/dist/oclif/commands/space/switch.d.ts

@@ -1,17 +1,12 @@
 import { Command } from '@oclif/core';
-import { type SpaceSwitchResponse } from '../../../shared/transport/events/space-events.js';
+import type { StatusGetResponse } from '../../../shared/transport/events/status-events.js';
 import { type DaemonClientOptions } from '../../lib/daemon-client.js';
 export default class SpaceSwitch extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        team: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    protected executeSwitch(params: {
-        spaceName: string;
-        teamName: string;
-    }, options?: DaemonClientOptions): Promise<SpaceSwitchResponse>;
+    protected checkDeprecation(options?: DaemonClientOptions): Promise<StatusGetResponse>;
     run(): Promise<void>;
 }

package/dist/oclif/commands/space/switch.js

@@ -1,14 +1,10 @@
 import { Command, Flags } from '@oclif/core';
-import { TRANSPORT_SPACE_SWITCH_TIMEOUT_MS } from '../../../server/constants.js';
-import { SpaceEvents, } from '../../../shared/transport/events/space-events.js';
+import { StatusEvents } from '../../../shared/transport/events/status-events.js';
 import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
 import { writeJsonResponse } from '../../lib/json-response.js';
 export default class SpaceSwitch extends Command {
-    static description = 'Switch to a different space';
-    static examples = [
-        '<%= config.bin %> space switch --team acme --name my-space',
-        '<%= config.bin %> space switch --team acme --name my-space --format json',
-    ];
+    static description = 'Switch to a different space (deprecated)';
+    static examples = ['<%= config.bin %> space switch'];
     static flags = {
         format: Flags.string({
             char: 'f',
@@ -16,68 +12,29 @@ export default class SpaceSwitch extends Command {
             description: 'Output format',
             options: ['text', 'json'],
         }),
-        name: Flags.string({
-            char: 'n',
-            description: 'Name of the space to switch to',
-            required: true,
-        }),
-        team: Flags.string({
-            char: 't',
-            description: 'Team name',
-            required: true,
-        }),
     };
-    async executeSwitch(params, options) {
-        return withDaemonRetry(async (client) => {
-            const { teams } = await client.requestWithAck(SpaceEvents.LIST);
-            const team = teams.find((t) => t.teamName === params.teamName);
-            if (!team) {
-                const available = teams.map((t) => t.teamName).join(', ');
-                throw new Error(teams.length > 0
-                    ? `Team "${params.teamName}" not found. Available teams: ${available}`
-                    : `Team "${params.teamName}" not found. No teams available.`);
-            }
-            const targetSpace = team.spaces.find((s) => s.name === params.spaceName);
-            if (!targetSpace) {
-                const available = team.spaces.map((s) => s.name).join(', ');
-                throw new Error(team.spaces.length > 0
-                    ? `Space "${params.spaceName}" not found in team "${params.teamName}". Available spaces: ${available}`
-                    : `Space "${params.spaceName}" not found in team "${params.teamName}". No spaces available.`);
-            }
-            return client.requestWithAck(SpaceEvents.SWITCH, { spaceId: targetSpace.id }, { timeout: TRANSPORT_SPACE_SWITCH_TIMEOUT_MS });
-        }, options);
+    async checkDeprecation(options) {
+        return withDaemonRetry(async (client) => client.requestWithAck(StatusEvents.GET), options);
     }
     async run() {
         const { flags } = await this.parse(SpaceSwitch);
         const format = flags.format;
-        const spaceName = flags.name;
-        const teamName = flags.team;
         try {
-            const result = await this.executeSwitch({ spaceName, teamName });
+            const { status } = await this.checkDeprecation();
+            const isVc = status.contextTreeStatus === 'git_vc';
+            const message = isVc
+                ? 'The space switch command has been deprecated. To work with a different space, use: brv vc clone <url>'
+                : 'The space switch command has been deprecated. Visit the ByteRover web dashboard to follow the migration guide from snapshot to version control.';
             if (format === 'json') {
-                writeJsonResponse({ command: 'space switch', data: result, success: result.success });
-            }
-            else if (result.success) {
-                this.log(`Successfully switched to space: ${result.config.spaceName}`);
-                if (result.pullResult) {
-                    const { added, conflicted, deleted, edited, restoredFromRemote } = result.pullResult;
-                    const parts = [`+${added}`, `~${edited}`, `-${deleted}`];
-                    if (conflicted)
-                        parts.push(`!${conflicted} conflicted`);
-                    if (restoredFromRemote)
-                        parts.push(`^${restoredFromRemote} restored`);
-                    this.log(`Pulled: ${parts.join(' ')}`);
-                }
-                this.log('Configuration updated in: .brv/config.json');
+                writeJsonResponse({ command: 'space switch', data: { message }, success: true });
             }
             else {
-                this.log(`Failed to switch space: ${result.pullError}`);
+                this.log(message);
             }
         }
         catch (error) {
             if (format === 'json') {
-                const errorMessage = error instanceof Error ? error.message : 'Switch failed';
-                writeJsonResponse({ command: 'space switch', data: { error: errorMessage }, success: false });
+                writeJsonResponse({ command: 'space switch', data: { error: formatConnectionError(error) }, success: false });
             }
             else {
                 this.log(formatConnectionError(error));

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

@@ -10,4 +10,5 @@ export default class Status extends Command {
     protected fetchStatus(options?: DaemonClientOptions): Promise<StatusDTO>;
     run(): Promise<void>;
     private formatTextOutput;
+    private logVcHint;
 }

package/dist/oclif/commands/status.js

@@ -24,7 +24,7 @@ export default class Status extends Command {
         const { flags } = await this.parse(Status);
         const isJson = flags.format === 'json';
         try {
-            const status = await this.fetchStatus();
+            const status = await this.fetchStatus({ projectPath: process.cwd() });
             if (isJson) {
                 writeJsonResponse({
                     command: 'status',
@@ -34,6 +34,7 @@ export default class Status extends Command {
             }
             else {
                 this.formatTextOutput(status);
+                this.logVcHint();
             }
         }
         catch (error) {
@@ -46,6 +47,7 @@ export default class Status extends Command {
             }
             else {
                 this.log(formatConnectionError(error));
+                this.logVcHint();
             }
         }
     }
@@ -79,6 +81,10 @@ export default class Status extends Command {
         }
         // Context tree status
         switch (status.contextTreeStatus) {
+            case 'git_vc': {
+                this.log('Context Tree: Managed by Byterover version control (use brv vc commands)');
+                break;
+            }
             case 'has_changes': {
                 if (status.contextTreeChanges && status.contextTreeRelativeDir) {
                     const formatPath = (file) => `${status.contextTreeRelativeDir}/${file}`;
@@ -107,4 +113,8 @@ export default class Status extends Command {
             }
         }
     }
+    logVcHint() {
+        this.log('\nTip: Version control is now available for your context tree.');
+        this.log('Learn more: https://docs.byterover.dev/git-semantic/overview');
+    }
 }

package/dist/oclif/commands/vc/add.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class VcAdd extends Command {
+    static description: string;
+    static examples: string[];
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/oclif/commands/vc/add.js

@@ -0,0 +1,29 @@
+import { Command } from '@oclif/core';
+import { VcEvents } from '../../../shared/transport/events/vc-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class VcAdd extends Command {
+    static description = 'Stage files for the next commit';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> .',
+        '<%= config.bin %> <%= command.id %> notes.md',
+        '<%= config.bin %> <%= command.id %> design/architecture.md',
+        '<%= config.bin %> <%= command.id %> docs/',
+    ];
+    static strict = false;
+    async run() {
+        const { argv } = await this.parse(VcAdd);
+        const filePaths = argv.length > 0 ? argv.filter((a) => typeof a === 'string') : ['.'];
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(VcEvents.ADD, { filePaths }));
+            if (result.count === 0) {
+                this.log('Nothing to stage.');
+            }
+            else {
+                this.log(`Staged ${result.count} file(s).`);
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error));
+        }
+    }
+}

package/dist/oclif/commands/vc/branch.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class VcBranch extends Command {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        delete: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'set-upstream-to': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private requestBranch;
+}

package/dist/oclif/commands/vc/branch.js

@@ -0,0 +1,70 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { VcEvents } from '../../../shared/transport/events/vc-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class VcBranch extends Command {
+    static args = {
+        name: Args.string({ description: 'Branch name to create' }),
+    };
+    static description = 'List, create, or delete local branches';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> feature/new-context',
+        '<%= config.bin %> <%= command.id %> -d feature/new-context',
+        '<%= config.bin %> <%= command.id %> -a',
+        '<%= config.bin %> <%= command.id %> --set-upstream-to origin/main',
+    ];
+    static flags = {
+        all: Flags.boolean({
+            char: 'a',
+            default: false,
+            description: 'List all branches including remote-tracking',
+        }),
+        delete: Flags.string({
+            char: 'd',
+            description: 'Delete a branch by name',
+        }),
+        'set-upstream-to': Flags.string({
+            description: 'Set upstream tracking (e.g. origin/main)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VcBranch);
+        try {
+            if (flags['set-upstream-to']) {
+                const result = await this.requestBranch({ action: 'set-upstream', upstream: flags['set-upstream-to'] });
+                if (result.action === 'set-upstream') {
+                    this.log(`Branch '${result.branch}' set up to track '${result.upstream}'.`);
+                }
+                return;
+            }
+            if (flags.delete) {
+                const result = await this.requestBranch({ action: 'delete', name: flags.delete });
+                if (result.action === 'delete')
+                    this.log(`Deleted branch '${result.deleted}'.`);
+                return;
+            }
+            if (args.name) {
+                const result = await this.requestBranch({ action: 'create', name: args.name });
+                if (result.action === 'create')
+                    this.log(`Created branch '${result.created}'.`);
+                return;
+            }
+            const result = await this.requestBranch({ action: 'list', all: flags.all });
+            if (result.action !== 'list' || result.branches.length === 0) {
+                this.log('No branches found.');
+                return;
+            }
+            for (const b of result.branches) {
+                const prefix = b.isCurrent ? '* ' : '  ';
+                const name = b.isRemote ? `remotes/${b.name}` : b.name;
+                this.log(`${prefix}${name}`);
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error));
+        }
+    }
+    requestBranch(req) {
+        return withDaemonRetry((client) => client.requestWithAck(VcEvents.BRANCH, req));
+    }
+}

package/dist/oclif/commands/vc/checkout.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class VcCheckout extends Command {
+    static args: {
+        branch: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        create: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private requestCheckout;
+}

package/dist/oclif/commands/vc/checkout.js

@@ -0,0 +1,47 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { VcEvents, } from '../../../shared/transport/events/vc-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class VcCheckout extends Command {
+    static args = {
+        branch: Args.string({ description: 'Branch to switch to', required: true }),
+    };
+    static description = 'Switch to an existing branch, or create and switch with -b';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> feature/my-branch',
+        '<%= config.bin %> <%= command.id %> -b feature/new-branch',
+        '<%= config.bin %> <%= command.id %> --force feature/my-branch',
+    ];
+    static flags = {
+        create: Flags.boolean({
+            char: 'b',
+            default: false,
+            description: 'Create a new branch and switch to it',
+        }),
+        force: Flags.boolean({
+            default: false,
+            description: 'Discard local changes and switch',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VcCheckout);
+        try {
+            const result = await this.requestCheckout({
+                branch: args.branch,
+                create: flags.create,
+                force: flags.force,
+            });
+            if (result.created) {
+                this.log(`Switched to a new branch '${result.branch}'`);
+            }
+            else {
+                this.log(`Switched to branch '${result.branch}'`);
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error));
+        }
+    }
+    requestCheckout(req) {
+        return withDaemonRetry((client) => client.requestWithAck(VcEvents.CHECKOUT, req));
+    }
+}

package/dist/oclif/commands/vc/clone.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class VcClone extends Command {
+    static args: {
+        url: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}