byterover-cli 2.5.2 → 3.0.0

package/dist/server/utils/gitignore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Appends ByteRover gitignore entries to the project's .gitignore.
+ *
+ * Only acts when the project is a git repo (.git/ exists).
+ * Idempotent: skips if entries are already present.
+ * Best-effort: failures are silently ignored since gitignore
+ * is a convenience feature that should never block the caller.
+ */
+export declare function ensureGitignoreEntries(directory: string): Promise<void>;

package/dist/server/utils/gitignore.js

@@ -0,0 +1,47 @@
+import { access, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const GITIGNORE_ENTRIES = `# ByteRover — .brv/context-tree/ contains a nested .git managed by brv vc.
+# Without these entries, \`git add .\` fails with "does not have a commit checked out".
+.brv/
+`;
+/**
+ * Appends ByteRover gitignore entries to the project's .gitignore.
+ *
+ * Only acts when the project is a git repo (.git/ exists).
+ * Idempotent: skips if entries are already present.
+ * Best-effort: failures are silently ignored since gitignore
+ * is a convenience feature that should never block the caller.
+ */
+export async function ensureGitignoreEntries(directory) {
+    try {
+        const dir = directory;
+        // Only add entries in git repositories
+        await access(join(dir, '.git'));
+        const gitignorePath = join(dir, '.gitignore');
+        let existing = '';
+        try {
+            existing = await readFile(gitignorePath, 'utf8');
+        }
+        catch {
+            // .gitignore doesn't exist yet — will create it
+        }
+        // Idempotent: skip if already present
+        if (existing.includes('.brv/'))
+            return;
+        // Ensure a blank line separates existing content from new entries
+        let content;
+        if (existing.length === 0) {
+            content = GITIGNORE_ENTRIES;
+        }
+        else if (existing.endsWith('\n')) {
+            content = existing + '\n' + GITIGNORE_ENTRIES;
+        }
+        else {
+            content = existing + '\n\n' + GITIGNORE_ENTRIES;
+        }
+        await writeFile(gitignorePath, content, 'utf8');
+    }
+    catch {
+        // Best-effort — gitignore failure should not block the caller
+    }
+}

package/dist/server/utils/process-logger.d.ts

@@ -8,11 +8,6 @@
  *
  * Each session creates a new log file with timestamp.
  */
-/**
- * Initialize session log - creates a new log file for this session.
- * Should be called once when the main process starts.
- */
-export declare function initSessionLog(): void;
 /**
  * Write a log entry to the log file.
  * Uses synchronous append for reliability in process shutdown scenarios.
@@ -26,18 +21,10 @@ export declare function transportLog(message: string): void;
  * Log with [Agent] prefix.
  */
 export declare function agentLog(message: string): void;
-/**
- * Log with [ProcessManager] prefix.
- */
-export declare function processManagerLog(message: string): void;
 /**
  * Log a transport event (for TUI monitoring).
  */
 export declare function eventLog(eventName: string, data?: unknown): void;
-/**
- * Log an error with full details.
- */
-export declare function errorLog(error: Error | string, context?: string): void;
 /**
  * Log a crash with full environment details.
  * Everything goes to the session log file.

package/dist/server/utils/process-logger.js

@@ -8,7 +8,7 @@
  *
  * Each session creates a new log file with timestamp.
  */
-import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { getGlobalLogsDir } from './global-logs-path.js';
 /** Current session's log file path (set on init) */
@@ -35,34 +35,6 @@ function ensureLogDir() {
         // Logging will fail gracefully later when trying to write
     }
 }
-/** Max age for log files in milliseconds (30 days) */
-const LOG_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
-/**
- * Clean up log files older than 30 days.
- * Runs silently - errors are ignored to not affect the main process.
- */
-function cleanupOldLogs() {
-    try {
-        const logsDir = getLogsDir();
-        if (!existsSync(logsDir))
-            return;
-        const now = Date.now();
-        const files = readdirSync(logsDir);
-        for (const file of files) {
-            if (!file.endsWith('.log'))
-                continue;
-            const filePath = join(logsDir, file);
-            const stats = statSync(filePath);
-            const age = now - stats.mtimeMs;
-            if (age > LOG_MAX_AGE_MS) {
-                unlinkSync(filePath);
-            }
-        }
-    }
-    catch {
-        // Silently ignore - don't crash the process
-    }
-}
 /**
  * Format timestamp for log entries.
  */
@@ -104,32 +76,6 @@ function getLogPath() {
     }
     return sessionLogPath;
 }
-/**
- * Initialize session log - creates a new log file for this session.
- * Should be called once when the main process starts.
- */
-export function initSessionLog() {
-    if (sessionLogPath)
-        return;
-    try {
-        ensureLogDir();
-        cleanupOldLogs();
-        sessionLogPath = join(getLogsDir(), generateSessionLogFilename());
-        const timestamp = formatTimestamp();
-        const header = [
-            '='.repeat(70),
-            `BRV Session Log - Started: ${timestamp}`,
-            `CWD: ${process.cwd()}`,
-            `Node: ${process.version} | Platform: ${process.platform} | PID: ${process.pid}`,
-            '='.repeat(70),
-            '',
-        ].join('\n');
-        writeFileSync(sessionLogPath, header);
-    }
-    catch {
-        // Silently ignore - don't crash the process
-    }
-}
 /**
  * Write a log entry to the log file.
  * Uses synchronous append for reliability in process shutdown scenarios.
@@ -157,12 +103,6 @@ export function transportLog(message) {
 export function agentLog(message) {
     processLog(`[Agent] ${message}`);
 }
-/**
- * Log with [ProcessManager] prefix.
- */
-export function processManagerLog(message) {
-    processLog(`[ProcessManager] ${message}`);
-}
 /**
  * Log a transport event (for TUI monitoring).
  */
@@ -170,23 +110,6 @@ export function eventLog(eventName, data) {
     const dataStr = data ? ` ${JSON.stringify(data)}` : '';
     processLog(`[Event] ${eventName}${dataStr}`);
 }
-/**
- * Log an error with full details.
- */
-export function errorLog(error, context) {
-    const errorMessage = error instanceof Error ? error.message : error;
-    const errorStack = error instanceof Error ? error.stack : undefined;
-    const contextStr = context ? ` (${context})` : '';
-    processLog(`[ERROR]${contextStr} ${errorMessage}`);
-    if (errorStack) {
-        const indentedStack = errorStack
-            .split('\n')
-            .slice(1)
-            .map((line) => `         ${line}`)
-            .join('\n');
-        processLog(indentedStack);
-    }
-}
 /**
  * Log a crash with full environment details.
  * Everything goes to the session log file.

package/dist/shared/transport/events/index.d.ts

@@ -13,6 +13,7 @@ export * from './provider-events.js';
 export * from './pull-events.js';
 export * from './push-events.js';
 export * from './reset-events.js';
+export * from './review-events.js';
 export * from './session-events.js';
 export * from './space-events.js';
 export * from './status-events.js';
@@ -64,6 +65,7 @@ export declare const AllEventGroups: readonly [{
     readonly GET_AGENTS: "init:getAgents";
     readonly GET_SPACES: "init:getSpaces";
     readonly GET_TEAMS: "init:getTeams";
+    readonly LOCAL: "init:local";
     readonly PROGRESS: "init:progress";
 }, {
     readonly CHUNK: "llmservice:chunk";
@@ -107,6 +109,10 @@ export declare const AllEventGroups: readonly [{
     readonly PROGRESS: "push:progress";
 }, {
     readonly EXECUTE: "reset:execute";
+}, {
+    readonly DECIDE_TASK: "review:decideTask";
+    readonly NOTIFY: "review:notify";
+    readonly PENDING: "review:pending";
 }, {
     readonly SWITCHED: "session:switched";
 }, {

package/dist/shared/transport/events/index.js

@@ -15,6 +15,7 @@ export * from './provider-events.js';
 export * from './pull-events.js';
 export * from './push-events.js';
 export * from './reset-events.js';
+export * from './review-events.js';
 export * from './session-events.js';
 export * from './space-events.js';
 export * from './status-events.js';
@@ -34,6 +35,7 @@ import { ProviderEvents } from './provider-events.js';
 import { PullEvents } from './pull-events.js';
 import { PushEvents } from './push-events.js';
 import { ResetEvents } from './reset-events.js';
+import { ReviewEvents } from './review-events.js';
 import { SessionEvents } from './session-events.js';
 import { SpaceEvents } from './space-events.js';
 import { StatusEvents } from './status-events.js';
@@ -56,6 +58,7 @@ export const AllEventGroups = [
     PullEvents,
     PushEvents,
     ResetEvents,
+    ReviewEvents,
     SessionEvents,
     LocationsEvents,
     SpaceEvents,

package/dist/shared/transport/events/init-events.d.ts

@@ -7,6 +7,7 @@ export declare const InitEvents: {
     readonly GET_AGENTS: "init:getAgents";
     readonly GET_SPACES: "init:getSpaces";
     readonly GET_TEAMS: "init:getTeams";
+    readonly LOCAL: "init:local";
     readonly PROGRESS: "init:progress";
 };
 export interface InitGetTeamsResponse {
@@ -31,6 +32,13 @@ export interface InitExecuteRequest {
 export interface InitExecuteResponse {
     success: boolean;
 }
+export interface InitLocalRequest {
+    force?: boolean;
+}
+export interface InitLocalResponse {
+    alreadyInitialized: boolean;
+    success: boolean;
+}
 export interface InitProgressEvent {
     message: string;
     step: string;

package/dist/shared/transport/events/init-events.js

@@ -4,5 +4,6 @@ export const InitEvents = {
     GET_AGENTS: 'init:getAgents',
     GET_SPACES: 'init:getSpaces',
     GET_TEAMS: 'init:getTeams',
+    LOCAL: 'init:local',
     PROGRESS: 'init:progress',
 };

package/dist/shared/transport/events/push-events.d.ts

@@ -7,8 +7,14 @@ export interface PushPrepareRequest {
     branch: string;
 }
 export interface PushPrepareResponse {
+    /** Number of changed files excluded from push due to pending/rejected reviews. */
+    excludedReviewCount: number;
     fileCount: number;
     hasChanges: boolean;
+    /** Number of files with pending HITL reviews (0 if none). */
+    pendingReviewCount: number;
+    /** URL to the local review UI (only set when pendingReviewCount > 0). */
+    reviewUrl?: string;
     summary: string;
 }
 export interface PushExecuteRequest {

package/dist/shared/transport/events/review-events.d.ts

@@ -0,0 +1,41 @@
+export declare const ReviewEvents: {
+    readonly DECIDE_TASK: "review:decideTask";
+    readonly NOTIFY: "review:notify";
+    readonly PENDING: "review:pending";
+};
+export interface ReviewNotifyEvent {
+    pendingCount: number;
+    reviewUrl: string;
+    taskId: string;
+}
+export interface ReviewDecideTaskRequest {
+    decision: 'approved' | 'rejected';
+    /** When provided, only operations targeting these context-tree-relative paths are affected. */
+    filePaths?: string[];
+    taskId: string;
+}
+export interface ReviewDecideTaskResponse {
+    files: Array<{
+        path: string;
+        reverted: boolean;
+    }>;
+    totalCount: number;
+}
+export interface ReviewPendingOperation {
+    /** Context-tree-relative file path (e.g. architecture/daemon/lifecycle.md). Used with --file flag. */
+    filePath?: string;
+    impact?: 'high' | 'low';
+    path: string;
+    previousSummary?: string;
+    reason?: string;
+    summary?: string;
+    type: 'ADD' | 'DELETE' | 'MERGE' | 'UPDATE' | 'UPSERT';
+}
+export interface ReviewPendingTask {
+    operations: ReviewPendingOperation[];
+    taskId: string;
+}
+export interface ReviewPendingResponse {
+    pendingCount: number;
+    tasks: ReviewPendingTask[];
+}

package/dist/shared/transport/events/review-events.js

@@ -0,0 +1,5 @@
+export const ReviewEvents = {
+    DECIDE_TASK: 'review:decideTask',
+    NOTIFY: 'review:notify',
+    PENDING: 'review:pending',
+};

package/dist/shared/transport/events/vc-events.d.ts

@@ -0,0 +1,257 @@
+export declare const VcErrorCode: {
+    readonly ALREADY_INITIALIZED: "ERR_VC_ALREADY_INITIALIZED";
+    readonly AUTH_FAILED: "ERR_VC_AUTH_FAILED";
+    readonly BRANCH_ALREADY_EXISTS: "ERR_VC_BRANCH_ALREADY_EXISTS";
+    readonly BRANCH_NOT_FOUND: "ERR_VC_BRANCH_NOT_FOUND";
+    readonly BRANCH_NOT_MERGED: "ERR_VC_BRANCH_NOT_MERGED";
+    readonly CANNOT_DELETE_CURRENT_BRANCH: "ERR_VC_CANNOT_DELETE_CURRENT_BRANCH";
+    readonly CLONE_FAILED: "ERR_VC_CLONE_FAILED";
+    readonly CONFIG_KEY_NOT_SET: "ERR_VC_CONFIG_KEY_NOT_SET";
+    readonly CONFLICT_MARKERS_PRESENT: "ERR_VC_CONFLICT_MARKERS_PRESENT";
+    readonly FETCH_FAILED: "ERR_VC_FETCH_FAILED";
+    readonly FILE_NOT_FOUND: "ERR_VC_FILE_NOT_FOUND";
+    readonly GIT_NOT_INITIALIZED: "ERR_VC_GIT_NOT_INITIALIZED";
+    readonly INVALID_ACTION: "ERR_VC_INVALID_ACTION";
+    readonly INVALID_BRANCH_NAME: "ERR_VC_INVALID_BRANCH_NAME";
+    readonly INVALID_CONFIG_KEY: "ERR_VC_INVALID_CONFIG_KEY";
+    readonly INVALID_REF: "ERR_VC_INVALID_REF";
+    readonly INVALID_REMOTE_URL: "ERR_VC_INVALID_REMOTE_URL";
+    readonly MERGE_CONFLICT: "ERR_VC_MERGE_CONFLICT";
+    readonly MERGE_IN_PROGRESS: "ERR_VC_MERGE_IN_PROGRESS";
+    readonly NETWORK_ERROR: "ERR_VC_NETWORK_ERROR";
+    readonly NO_BRANCH_RESOLVED: "ERR_VC_NO_BRANCH_RESOLVED";
+    readonly NO_COMMITS: "ERR_VC_NO_COMMITS";
+    readonly NO_MERGE_IN_PROGRESS: "ERR_VC_NO_MERGE_IN_PROGRESS";
+    readonly NO_REMOTE: "ERR_VC_NO_REMOTE";
+    readonly NO_UPSTREAM: "ERR_VC_NO_UPSTREAM";
+    readonly NON_FAST_FORWARD: "ERR_VC_NON_FAST_FORWARD";
+    readonly NOTHING_STAGED: "ERR_VC_NOTHING_STAGED";
+    readonly NOTHING_TO_PUSH: "ERR_VC_NOTHING_TO_PUSH";
+    readonly NOTHING_TO_RESET: "ERR_VC_NOTHING_TO_RESET";
+    readonly PULL_FAILED: "ERR_VC_PULL_FAILED";
+    readonly PUSH_FAILED: "ERR_VC_PUSH_FAILED";
+    readonly REMOTE_ALREADY_EXISTS: "ERR_VC_REMOTE_ALREADY_EXISTS";
+    readonly UNCOMMITTED_CHANGES: "ERR_VC_UNCOMMITTED_CHANGES";
+    readonly UNRELATED_HISTORIES: "ERR_VC_UNRELATED_HISTORIES";
+    readonly USER_NOT_CONFIGURED: "ERR_VC_USER_NOT_CONFIGURED";
+};
+export type VcErrorCodeType = (typeof VcErrorCode)[keyof typeof VcErrorCode];
+export declare const VcEvents: {
+    readonly ADD: "vc:add";
+    readonly BRANCH: "vc:branch";
+    readonly CHECKOUT: "vc:checkout";
+    readonly CLONE: "vc:clone";
+    readonly CLONE_PROGRESS: "vc:clone:progress";
+    readonly COMMIT: "vc:commit";
+    readonly CONFIG: "vc:config";
+    readonly FETCH: "vc:fetch";
+    readonly INIT: "vc:init";
+    readonly LOG: "vc:log";
+    readonly MERGE: "vc:merge";
+    readonly PULL: "vc:pull";
+    readonly PUSH: "vc:push";
+    readonly REMOTE: "vc:remote";
+    readonly RESET: "vc:reset";
+    readonly STATUS: "vc:status";
+};
+export interface IVcInitResponse {
+    gitDir: string;
+    reinitialized: boolean;
+}
+export interface IVcStatusResponse {
+    ahead?: number;
+    behind?: number;
+    branch?: string;
+    conflictMarkerFiles?: string[];
+    hasCommits?: boolean;
+    initialized: boolean;
+    mergeInProgress?: boolean;
+    staged: {
+        added: string[];
+        deleted: string[];
+        modified: string[];
+    };
+    trackingBranch?: string;
+    unmerged?: Array<{
+        path: string;
+        type: string;
+    }>;
+    unstaged: {
+        deleted: string[];
+        modified: string[];
+    };
+    untracked: string[];
+}
+export interface IVcAddRequest {
+    filePaths?: string[];
+}
+export interface IVcAddResponse {
+    count: number;
+}
+export interface IVcCommitRequest {
+    message: string;
+}
+export interface IVcCommitResponse {
+    message: string;
+    sha: string;
+}
+export type VcConfigKey = 'user.email' | 'user.name';
+export declare const VC_CONFIG_KEYS: readonly string[];
+export declare function isVcConfigKey(key: string): key is VcConfigKey;
+export interface IVcConfigRequest {
+    key: VcConfigKey;
+    value?: string;
+}
+export interface IVcConfigResponse {
+    key: string;
+    value: string;
+}
+export interface IVcPushRequest {
+    branch?: string;
+    setUpstream?: boolean;
+}
+export interface IVcPushResponse {
+    alreadyUpToDate?: boolean;
+    branch: string;
+    upstreamSet?: boolean;
+}
+export interface IVcFetchRequest {
+    ref?: string;
+    remote?: string;
+}
+export interface IVcFetchResponse {
+    remote: string;
+}
+export interface IVcPullRequest {
+    allowUnrelatedHistories?: boolean;
+    branch?: string;
+    remote?: string;
+}
+export interface IVcPullResponse {
+    alreadyUpToDate?: boolean;
+    branch: string;
+    conflicts?: Array<{
+        path: string;
+        type: string;
+    }>;
+}
+export interface IVcLogRequest {
+    all?: boolean;
+    limit?: number;
+    ref?: string;
+}
+export interface IVcLogResponse {
+    commits: Array<{
+        author: {
+            email: string;
+            name: string;
+        };
+        message: string;
+        sha: string;
+        timestamp: string;
+    }>;
+    currentBranch?: string;
+}
+export type VcRemoteSubcommand = 'add' | 'set-url' | 'show';
+export declare const VC_REMOTE_SUBCOMMANDS: readonly string[];
+export declare function isVcRemoteSubcommand(value: string): value is VcRemoteSubcommand;
+export interface IVcRemoteRequest {
+    subcommand: VcRemoteSubcommand;
+    url?: string;
+}
+export interface IVcRemoteResponse {
+    action: VcRemoteSubcommand;
+    url?: string;
+}
+export type IVcCloneRequest = {
+    spaceId: string;
+    spaceName: string;
+    teamId: string;
+    teamName: string;
+    url?: never;
+} | {
+    spaceId?: string;
+    spaceName?: string;
+    teamId?: string;
+    teamName?: string;
+    url: string;
+};
+export interface IVcCloneResponse {
+    gitDir: string;
+    spaceName?: string;
+    teamName?: string;
+}
+export interface IVcCloneProgressEvent {
+    message: string;
+    step: 'cloning' | 'saving';
+}
+export type VcBranchAction = 'create' | 'delete' | 'list' | 'set-upstream';
+export type IVcBranchRequest = {
+    action: 'create';
+    name: string;
+} | {
+    action: 'delete';
+    name: string;
+} | {
+    action: 'list';
+    all?: boolean;
+} | {
+    action: 'set-upstream';
+    upstream: string;
+};
+export type IVcBranchResponse = {
+    action: 'create';
+    created: string;
+} | {
+    action: 'delete';
+    deleted: string;
+} | {
+    action: 'list';
+    branches: Array<{
+        isCurrent: boolean;
+        isRemote: boolean;
+        name: string;
+    }>;
+} | {
+    action: 'set-upstream';
+    branch: string;
+    upstream: string;
+};
+export interface IVcCheckoutRequest {
+    branch: string;
+    create?: boolean;
+    force?: boolean;
+}
+export interface IVcCheckoutResponse {
+    branch: string;
+    created: boolean;
+    previousBranch?: string;
+}
+export type VcMergeAction = 'abort' | 'continue' | 'merge';
+export interface IVcMergeRequest {
+    action: VcMergeAction;
+    allowUnrelatedHistories?: boolean;
+    branch?: string;
+    message?: string;
+}
+export interface IVcMergeResponse {
+    action: VcMergeAction;
+    alreadyUpToDate?: boolean;
+    branch?: string;
+    conflicts?: Array<{
+        path: string;
+        type: string;
+    }>;
+    defaultMessage?: string;
+}
+export type VcResetMode = 'hard' | 'mixed' | 'soft';
+export interface IVcResetRequest {
+    filePaths?: string[];
+    mode?: VcResetMode;
+    ref?: string;
+}
+export interface IVcResetResponse {
+    filesUnstaged?: number;
+    headSha?: string;
+    mode: VcResetMode;
+}

package/dist/shared/transport/events/vc-events.js

@@ -0,0 +1,67 @@
+export const VcErrorCode = {
+    ALREADY_INITIALIZED: 'ERR_VC_ALREADY_INITIALIZED',
+    AUTH_FAILED: 'ERR_VC_AUTH_FAILED',
+    BRANCH_ALREADY_EXISTS: 'ERR_VC_BRANCH_ALREADY_EXISTS',
+    BRANCH_NOT_FOUND: 'ERR_VC_BRANCH_NOT_FOUND',
+    BRANCH_NOT_MERGED: 'ERR_VC_BRANCH_NOT_MERGED',
+    CANNOT_DELETE_CURRENT_BRANCH: 'ERR_VC_CANNOT_DELETE_CURRENT_BRANCH',
+    CLONE_FAILED: 'ERR_VC_CLONE_FAILED',
+    CONFIG_KEY_NOT_SET: 'ERR_VC_CONFIG_KEY_NOT_SET',
+    CONFLICT_MARKERS_PRESENT: 'ERR_VC_CONFLICT_MARKERS_PRESENT',
+    FETCH_FAILED: 'ERR_VC_FETCH_FAILED',
+    FILE_NOT_FOUND: 'ERR_VC_FILE_NOT_FOUND',
+    GIT_NOT_INITIALIZED: 'ERR_VC_GIT_NOT_INITIALIZED',
+    INVALID_ACTION: 'ERR_VC_INVALID_ACTION',
+    INVALID_BRANCH_NAME: 'ERR_VC_INVALID_BRANCH_NAME',
+    INVALID_CONFIG_KEY: 'ERR_VC_INVALID_CONFIG_KEY',
+    INVALID_REF: 'ERR_VC_INVALID_REF',
+    INVALID_REMOTE_URL: 'ERR_VC_INVALID_REMOTE_URL',
+    MERGE_CONFLICT: 'ERR_VC_MERGE_CONFLICT',
+    MERGE_IN_PROGRESS: 'ERR_VC_MERGE_IN_PROGRESS',
+    NETWORK_ERROR: 'ERR_VC_NETWORK_ERROR',
+    NO_BRANCH_RESOLVED: 'ERR_VC_NO_BRANCH_RESOLVED',
+    NO_COMMITS: 'ERR_VC_NO_COMMITS',
+    NO_MERGE_IN_PROGRESS: 'ERR_VC_NO_MERGE_IN_PROGRESS',
+    NO_REMOTE: 'ERR_VC_NO_REMOTE',
+    NO_UPSTREAM: 'ERR_VC_NO_UPSTREAM',
+    NON_FAST_FORWARD: 'ERR_VC_NON_FAST_FORWARD',
+    NOTHING_STAGED: 'ERR_VC_NOTHING_STAGED',
+    NOTHING_TO_PUSH: 'ERR_VC_NOTHING_TO_PUSH',
+    NOTHING_TO_RESET: 'ERR_VC_NOTHING_TO_RESET',
+    PULL_FAILED: 'ERR_VC_PULL_FAILED',
+    PUSH_FAILED: 'ERR_VC_PUSH_FAILED',
+    REMOTE_ALREADY_EXISTS: 'ERR_VC_REMOTE_ALREADY_EXISTS',
+    UNCOMMITTED_CHANGES: 'ERR_VC_UNCOMMITTED_CHANGES',
+    UNRELATED_HISTORIES: 'ERR_VC_UNRELATED_HISTORIES',
+    USER_NOT_CONFIGURED: 'ERR_VC_USER_NOT_CONFIGURED',
+};
+export const VcEvents = {
+    ADD: 'vc:add',
+    BRANCH: 'vc:branch',
+    CHECKOUT: 'vc:checkout',
+    CLONE: 'vc:clone',
+    CLONE_PROGRESS: 'vc:clone:progress',
+    COMMIT: 'vc:commit',
+    CONFIG: 'vc:config',
+    FETCH: 'vc:fetch',
+    INIT: 'vc:init',
+    LOG: 'vc:log',
+    MERGE: 'vc:merge',
+    PULL: 'vc:pull',
+    PUSH: 'vc:push',
+    REMOTE: 'vc:remote',
+    RESET: 'vc:reset',
+    STATUS: 'vc:status',
+};
+export const VC_CONFIG_KEYS = ['user.name', 'user.email'];
+export function isVcConfigKey(key) {
+    return VC_CONFIG_KEYS.includes(key);
+}
+export const VC_REMOTE_SUBCOMMANDS = [
+    'add',
+    'set-url',
+    'show',
+];
+export function isVcRemoteSubcommand(value) {
+    return VC_REMOTE_SUBCOMMANDS.includes(value);
+}

package/dist/shared/transport/types/dto.d.ts

@@ -10,6 +10,7 @@ export interface UserDTO {
     email: string;
     hasOnboardedCli: boolean;
     id: string;
+    name?: string;
 }
 export interface AuthTokenDTO {
     accessToken: string;
@@ -119,8 +120,12 @@ export interface StatusDTO {
     contextTreeDir?: string;
     /** Relative path to the context tree directory from project root (e.g., '.brv/context-tree') */
     contextTreeRelativeDir?: string;
-    contextTreeStatus: 'has_changes' | 'no_changes' | 'not_initialized' | 'unknown';
+    contextTreeStatus: 'git_vc' | 'has_changes' | 'no_changes' | 'not_initialized' | 'unknown';
     currentDirectory: string;
+    /** Number of files with pending HITL review (0 if none or unavailable). */
+    pendingReviewCount?: number;
+    /** URL to the local review UI (only set when pendingReviewCount > 0). */
+    reviewUrl?: string;
     spaceName?: string;
     teamName?: string;
     userEmail?: string;