byterover-cli 2.6.0 → 3.0.1

package/dist/server/infra/transport/socket-io-transport-server.d.ts

@@ -1,3 +1,4 @@
+import { type RequestListener } from 'node:http';
 import type { TransportServerConfig } from '../../core/domain/transport/types.js';
 import type { ConnectionHandler, ITransportServer, RequestHandler } from '../../core/interfaces/transport/index.js';
 /**
@@ -12,6 +13,7 @@ export declare class SocketIOTransportServer implements ITransportServer {
     private readonly config;
     private connectionHandlers;
     private disconnectionHandlers;
+    private httpRequestHandler?;
     private httpServer;
     private io;
     private port;
@@ -34,6 +36,11 @@ export declare class SocketIOTransportServer implements ITransportServer {
     onRequest<TRequest = unknown, TResponse = unknown>(event: string, handler: RequestHandler<TRequest, TResponse>): void;
     removeFromRoom(clientId: string, room: string): void;
     sendTo<T = unknown>(clientId: string, event: string, data: T): void;
+    /**
+     * Sets an HTTP request handler (e.g., Express app) to handle non-Socket.IO HTTP requests.
+     * Must be called before start().
+     */
+    setHttpRequestHandler(handler: RequestListener): void;
     start(port: number): Promise<void>;
     stop(): Promise<void>;
     private registerEventHandler;

package/dist/server/infra/transport/socket-io-transport-server.js

@@ -22,6 +22,7 @@ export class SocketIOTransportServer {
     config;
     connectionHandlers = [];
     disconnectionHandlers = [];
+    httpRequestHandler;
     httpServer;
     io;
     port;
@@ -104,12 +105,22 @@ export class SocketIOTransportServer {
             socket.emit(event, data);
         }
     }
+    /**
+     * Sets an HTTP request handler (e.g., Express app) to handle non-Socket.IO HTTP requests.
+     * Must be called before start().
+     */
+    setHttpRequestHandler(handler) {
+        if (this.running) {
+            throw new TransportServerAlreadyRunningError(this.port ?? 0);
+        }
+        this.httpRequestHandler = handler;
+    }
     async start(port) {
         if (this.running) {
             throw new TransportServerAlreadyRunningError(this.port ?? port);
         }
         return new Promise((resolve, reject) => {
-            this.httpServer = createServer();
+            this.httpServer = this.httpRequestHandler ? createServer(this.httpRequestHandler) : createServer();
             // In development mode, allow admin.socket.io for debugging
             const corsOrigin = isDevelopment() ? [this.config.corsOrigin, 'https://admin.socket.io'] : this.config.corsOrigin;
             this.io = new Server(this.httpServer, {

package/dist/server/infra/transport/transport-connector.d.ts

@@ -10,4 +10,4 @@ export type TransportConnector = (fromDir?: string) => Promise<ConnectionResult>
  * projectPath is auto-filled by the transport library from the discovered
  * project root (walks up from fromDir to find .brv/).
  */
-export declare function createDaemonAwareConnector(): TransportConnector;
+export declare function createDaemonAwareConnector(projectPath?: string): TransportConnector;

package/dist/server/infra/transport/transport-connector.js

@@ -9,10 +9,11 @@ import { resolveLocalServerMainPath } from '../../utils/server-main-resolver.js'
  * projectPath is auto-filled by the transport library from the discovered
  * project root (walks up from fromDir to find .brv/).
  */
-export function createDaemonAwareConnector() {
+export function createDaemonAwareConnector(projectPath) {
     return (fromDir) => connectToDaemon({
         clientType: 'cli',
         fromDir,
+        projectPath,
         serverPath: resolveLocalServerMainPath(),
     });
 }

package/dist/server/infra/vc/file-vc-git-config-store.d.ts

@@ -0,0 +1,11 @@
+import type { IVcGitConfig, IVcGitConfigStore } from '../../core/interfaces/vc/i-vc-git-config-store.js';
+export interface IFileVcGitConfigStoreDeps {
+    readonly getDataDir: () => string;
+}
+export declare class FileVcGitConfigStore implements IVcGitConfigStore {
+    private readonly deps;
+    constructor(deps?: IFileVcGitConfigStoreDeps);
+    get(projectPath: string): Promise<IVcGitConfig | undefined>;
+    set(projectPath: string, config: IVcGitConfig): Promise<void>;
+    private configPath;
+}

package/dist/server/infra/vc/file-vc-git-config-store.js

@@ -0,0 +1,43 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getGlobalDataDir } from '../../utils/global-data-path.js';
+const defaultDeps = {
+    getDataDir: getGlobalDataDir,
+};
+function projectKey(projectPath) {
+    return createHash('sha1').update(projectPath).digest('hex').slice(0, 16);
+}
+function isIVcGitConfig(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (v.name === undefined || typeof v.name === 'string') && (v.email === undefined || typeof v.email === 'string');
+}
+export class FileVcGitConfigStore {
+    deps;
+    constructor(deps = defaultDeps) {
+        this.deps = deps;
+    }
+    async get(projectPath) {
+        const configPath = this.configPath(projectPath);
+        try {
+            const content = await readFile(configPath, 'utf8');
+            const parsed = JSON.parse(content);
+            if (!isIVcGitConfig(parsed))
+                return undefined;
+            return parsed;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async set(projectPath, config) {
+        const projectDir = join(this.deps.getDataDir(), 'projects', projectKey(projectPath));
+        await mkdir(projectDir, { recursive: true });
+        await writeFile(join(projectDir, 'vc-git-config.json'), JSON.stringify(config, null, 2), 'utf8');
+    }
+    configPath(projectPath) {
+        return join(this.deps.getDataDir(), 'projects', projectKey(projectPath), 'vc-git-config.json');
+    }
+}

package/dist/server/templates/skill/SKILL.md

@@ -9,7 +9,7 @@ Use the `brv` CLI to manage your project's long-term memory.
 Install: `npm install -g byterover-cli`
 Knowledge is stored in `.brv/context-tree/` as human-readable Markdown files.
 
-**No authentication needed.** `brv query` and `brv curate` work out of the box. Login is only required for cloud sync (`push`/`pull`/`space`) — ignore those if you don't need cloud features.
+**No authentication needed.** `brv query`, `brv curate`, and `brv vc` (local version control) work out of the box. Login is only required for remote sync (`brv vc push`/`brv vc pull`).
 
 ## Workflow
 1.  **Before Thinking:** Run `brv query` to understand existing patterns.
@@ -35,7 +35,7 @@ brv query "How is authentication implemented?"
 ```
 
 ### 2. Curate Context
-**Overview**: Analyze and save knowledge to the local knowledge base. Uses a configured LLM provider to categorize and structure the context you provide.
+**Overview:** Analyze and save knowledge to the local knowledge base. Uses a configured LLM provider to categorize and structure the context you provide.
 
 **Use this skill when:**
 - The user wants you to remember something
@@ -79,7 +79,70 @@ brv curate view --since 1h --status completed
 brv curate view --help
 ```
 
-### 3. LLM Provider Setup
+### 3. Review Pending Changes
+**Overview:** After a curate operation, some changes may require human review before being applied. Use `brv review` to list, approve, or reject pending operations.
+
+**Use this when:**
+- A curate operation reports pending reviews (shown in curate output)
+- The user wants to check, approve, or reject pending changes
+
+**Do NOT use this skill when:**
+- There are no pending reviews (check with `brv review pending` first)
+
+**Commands:**
+
+List all pending reviews for the current project:
+```bash
+brv review pending
+```
+
+Sample output:
+```
+2 operations pending review
+
+  Task: ddcb3dc6-d957-4a56-b9c3-d0bdc04317f3
+  [UPSERT · HIGH IMPACT] - path: architecture/context/context_compression_pipeline.md
+  Why:    Documenting switch to token-budget sliding window
+  After:  Context compression pipeline switching from reactive-overflow to token-budget sliding window in src/agent/infra/llm/context/compression/
+
+  [UPSERT · HIGH IMPACT] - path: architecture/tools/agent_tool_registry.md
+  Why:    Documenting tool registry rewrite with capability-based permissions
+  After:  Agent tool registry rewrite in src/agent/infra/tools/tool-registry.ts using capability-based permissions
+
+  To approve all:  brv review approve ddcb3dc6-d957-4a56-b9c3-d0bdc04317f3
+  To reject all:   brv review reject ddcb3dc6-d957-4a56-b9c3-d0bdc04317f3
+  Per file:        brv review <approve|reject> ddcb3dc6-d957-4a56-b9c3-d0bdc04317f3 --file <path> [--file <path>]
+```
+
+Each pending task shows: operation type (ADD/UPDATE/DELETE/MERGE/UPSERT), file path, reason, and before/after summaries. High-impact operations are flagged.
+
+Approve all operations for a task (applies the changes):
+```bash
+brv review approve <taskId>
+```
+
+Reject all operations for a task (discards pending changes; restores backup for UPDATE/DELETE operations):
+```bash
+brv review reject <taskId>
+```
+
+Approve or reject specific files within a task:
+```bash
+brv review approve <taskId> --file <path> --file <path>
+brv review reject <taskId> --file <path>
+```
+File paths are relative to context tree (as shown in `brv review pending` output).
+
+**Note**: Always ask the user before approving or rejecting critical changes.
+
+**JSON output** (useful for agent-driven workflows):
+```bash
+brv review pending --format json
+brv review approve <taskId> --format json
+brv review reject <taskId> --format json
+```
+
+### 4. LLM Provider Setup
 `brv query` and `brv curate` require a configured LLM provider. Connect the default ByteRover provider (no API key needed):
 
 ```bash
@@ -93,7 +156,7 @@ brv providers list
 brv providers connect openai --api-key sk-xxx --model gpt-4.1
 ```
 
-### 4. Project Locations
+### 5. Project Locations
 **Overview:** List registered projects and their context tree paths. Returns project metadata including initialization status and active state. Use `-f json` for machine-readable output.
 
 **Use this when:**
@@ -111,50 +174,121 @@ brv locations -f json
 
 JSON fields: `projectPath`, `contextTreePath`, `isCurrent`, `isActive`, `isInitialized`.
 
-### 5. Cloud Sync (Optional)
-**Overview:** Sync your local knowledge with a team via ByteRover's cloud service. Requires ByteRover authentication.
+### 6. Version Control
+**Overview:** `brv vc` provides git-based version control for your context tree. It uses standard git semantics — branching, committing, merging, history, and conflict resolution — all working locally with no authentication required. Remote sync with a team is optional. The legacy `brv push`, `brv pull`, and `brv space` commands are deprecated — use `brv vc push`, `brv vc pull`, and `brv vc clone`/`brv vc remote add` instead.
+
+**Use this when:**
+- The user wants to track, commit, or inspect changes to the knowledge base
+- The user wants to branch, merge, or undo knowledge changes
+- The user wants to sync knowledge with a team (push/pull)
+- The user wants to connect to or clone a team space
+- The user asks about knowledge history or diffs
+
+**Do NOT use this when:**
+- The user wants to query or curate knowledge — use `brv query`/`brv curate` instead
+- The user wants to review pending curate operations — use `brv review` instead
+- Version control is not initialized and the user didn't ask to set it up
+
+**Commands:**
+
+Available commands: `init`, `status`, `add`, `commit`, `reset`, `log`, `branch`, `checkout`, `merge`, `config`, `clone`, `remote`, `fetch`, `push`, `pull`.
 
-**Setup steps:**
-1. Log in: Get an API key from your ByteRover account and authenticate:
+#### First-Time Setup
+
+**Setup — local (no auth needed):**
+```bash
+brv vc init
+brv vc config user.name "Your Name"
+brv vc config user.email "you@example.com"
+```
+
+**Setup — clone a team space (requires `brv login`):**
 ```bash
 brv login --api-key sample-key-string
+brv vc clone https://byterover.dev/<team>/<space>.git
 ```
-2. List available spaces:
+
+**Setup — connect existing project to a remote (requires `brv login`):**
 ```bash
-brv space list
+brv login --api-key sample-key-string
+brv vc remote add origin https://byterover.dev/<team>/<space>.git
 ```
-Sample output:
+
+#### Local Workflow
+
+**Check status:**
+```bash
+brv vc status
 ```
-brv space list
-1. human-resources-team (team)
-   - a-department (space)
-   - b-department (space)
-2. marketing-team (team)
-   - c-department (space)
-   - d-department (space)
+
+**Stage and commit:**
+```bash
+brv vc add .                     # stage all
+brv vc add notes.md docs/        # stage specific files
+brv vc commit -m "add authentication patterns"
 ```
-3. Connect to a space:
+
+**View history:**
 ```bash
-brv space switch --team human-resources-team --name a-department
+brv vc log
+brv vc log --limit 20
+brv vc log --all
 ```
 
-**Cloud sync commands:**
-Once connected, `brv push` and `brv pull` sync with that space.
+**Unstage or undo:**
 ```bash
-# Pull team updates
-brv pull
+brv vc reset                     # unstage all files
+brv vc reset <file>              # unstage a specific file
+brv vc reset --soft HEAD~1       # undo last commit, keep changes staged
+brv vc reset --hard HEAD~1       # discard last commit and changes
+```
 
-# Push local changes
-brv push
+#### Branch Management
+
+```bash
+brv vc branch                    # list branches
+brv vc branch feature/auth       # create a branch
+brv vc branch -a                 # list all (including remote-tracking)
+brv vc branch -d feature/auth    # delete a branch
+brv vc checkout feature/auth     # switch branch
+brv vc checkout -b feature/new   # create and switch
+```
+
+**Merge:**
+```bash
+brv vc merge feature/auth        # merge into current branch
+brv vc merge --continue          # continue after resolving conflicts
+brv vc merge --abort             # abort a conflicted merge
+```
+
+**Set upstream tracking:**
+```bash
+brv vc branch --set-upstream-to origin/main
+```
+
+#### Cloud Sync (Remote Operations)
+
+Requires ByteRover authentication (`brv login`) and a configured remote.
+
+**Manage remotes:**
+```bash
+brv vc remote                    # show current remote
+brv vc remote add origin <url>   # add a remote
+brv vc remote set-url origin <url>  # update remote URL
+```
+
+**Fetch, pull, and push:**
+```bash
+brv vc fetch                     # fetch remote refs
+brv vc pull                      # fetch + merge remote commits
+brv vc push                      # push commits to cloud
+brv vc push -u origin main       # push and set upstream tracking
 ```
 
-**Switching spaces:**
-- Push local changes first (`brv push`) — switching is blocked if unsaved changes exist.
-- Then switch:
+**Clone a space:**
 ```bash
-brv space switch --team marketing-team --name d-department
+brv vc clone https://byterover.dev/<team>/<space>.git
 ```
-- The switch automatically pulls context from the new space.
 
 ## Data Handling
 
@@ -162,9 +296,9 @@ brv space switch --team marketing-team --name d-department
 
 **File access**: The `-f` flag on `brv curate` reads files from the current project directory only. Paths outside the project root are rejected. Maximum 5 files per command, text and document formats only.
 
-**LLM usage**: `brv query` and `brv curate` send context to a configured LLM provider for processing. The LLM sees the query or curate text and any included file contents. No data is sent to ByteRover servers unless you explicitly run `brv push`.
+**LLM usage**: `brv query` and `brv curate` send context to a configured LLM provider for processing. The LLM sees the query or curate text and any included file contents. No data is sent to ByteRover servers unless you explicitly run `brv vc push`.
 
-**Cloud sync**: `brv push` and `brv pull` require authentication (`brv login`) and send knowledge to ByteRover's cloud service. All other commands operate without ByteRover authentication.
+**Cloud sync**: `brv vc push` and `brv vc pull` require authentication (`brv login`) and sync knowledge with ByteRover's cloud service via git. All other commands operate without ByteRover authentication.
 
 ## Error Handling
 **User Action Required:**

package/dist/server/utils/curate-result-parser.d.ts

@@ -2,43 +2,91 @@ import { z } from 'zod';
 import type { CurateLogOperation } from '../core/domain/entities/curate-log-entry.js';
 import type { LlmToolResultEvent } from '../core/domain/transport/schemas.js';
 export declare const CurateOperationSchema: z.ZodObject<{
+    additionalFilePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    confidence: z.ZodOptional<z.ZodEnum<["high", "low"]>>;
     filePath: z.ZodOptional<z.ZodString>;
+    impact: z.ZodOptional<z.ZodEnum<["high", "low"]>>;
     message: z.ZodOptional<z.ZodString>;
+    needsReview: z.ZodOptional<z.ZodBoolean>;
     path: z.ZodString;
+    previousSummary: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    reviewStatus: z.ZodOptional<z.ZodEnum<["approved", "pending", "rejected"]>>;
     status: z.ZodEnum<["failed", "success"]>;
+    summary: z.ZodOptional<z.ZodString>;
     type: z.ZodEnum<["ADD", "DELETE", "MERGE", "UPDATE", "UPSERT"]>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
     status: "failed" | "success";
     message?: string | undefined;
+    summary?: string | undefined;
+    reason?: string | undefined;
     filePath?: string | undefined;
+    confidence?: "high" | "low" | undefined;
+    impact?: "high" | "low" | undefined;
+    additionalFilePaths?: string[] | undefined;
+    needsReview?: boolean | undefined;
+    previousSummary?: string | undefined;
+    reviewStatus?: "pending" | "rejected" | "approved" | undefined;
 }, {
     path: string;
     type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
     status: "failed" | "success";
     message?: string | undefined;
+    summary?: string | undefined;
+    reason?: string | undefined;
     filePath?: string | undefined;
+    confidence?: "high" | "low" | undefined;
+    impact?: "high" | "low" | undefined;
+    additionalFilePaths?: string[] | undefined;
+    needsReview?: boolean | undefined;
+    previousSummary?: string | undefined;
+    reviewStatus?: "pending" | "rejected" | "approved" | undefined;
 }>;
 export declare const CurateResultSchema: z.ZodObject<{
     applied: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        additionalFilePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "low"]>>;
         filePath: z.ZodOptional<z.ZodString>;
+        impact: z.ZodOptional<z.ZodEnum<["high", "low"]>>;
         message: z.ZodOptional<z.ZodString>;
+        needsReview: z.ZodOptional<z.ZodBoolean>;
         path: z.ZodString;
+        previousSummary: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        reviewStatus: z.ZodOptional<z.ZodEnum<["approved", "pending", "rejected"]>>;
         status: z.ZodEnum<["failed", "success"]>;
+        summary: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<["ADD", "DELETE", "MERGE", "UPDATE", "UPSERT"]>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
         status: "failed" | "success";
         message?: string | undefined;
+        summary?: string | undefined;
+        reason?: string | undefined;
         filePath?: string | undefined;
+        confidence?: "high" | "low" | undefined;
+        impact?: "high" | "low" | undefined;
+        additionalFilePaths?: string[] | undefined;
+        needsReview?: boolean | undefined;
+        previousSummary?: string | undefined;
+        reviewStatus?: "pending" | "rejected" | "approved" | undefined;
     }, {
         path: string;
         type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
         status: "failed" | "success";
         message?: string | undefined;
+        summary?: string | undefined;
+        reason?: string | undefined;
         filePath?: string | undefined;
+        confidence?: "high" | "low" | undefined;
+        impact?: "high" | "low" | undefined;
+        additionalFilePaths?: string[] | undefined;
+        needsReview?: boolean | undefined;
+        previousSummary?: string | undefined;
+        reviewStatus?: "pending" | "rejected" | "approved" | undefined;
     }>, "many">>;
     summary: z.ZodOptional<z.ZodObject<{
         added: z.ZodOptional<z.ZodNumber>;
@@ -72,7 +120,15 @@ export declare const CurateResultSchema: z.ZodObject<{
         type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
         status: "failed" | "success";
         message?: string | undefined;
+        summary?: string | undefined;
+        reason?: string | undefined;
         filePath?: string | undefined;
+        confidence?: "high" | "low" | undefined;
+        impact?: "high" | "low" | undefined;
+        additionalFilePaths?: string[] | undefined;
+        needsReview?: boolean | undefined;
+        previousSummary?: string | undefined;
+        reviewStatus?: "pending" | "rejected" | "approved" | undefined;
     }[] | undefined;
 }, {
     summary?: {
@@ -87,7 +143,15 @@ export declare const CurateResultSchema: z.ZodObject<{
         type: "ADD" | "DELETE" | "MERGE" | "UPDATE" | "UPSERT";
         status: "failed" | "success";
         message?: string | undefined;
+        summary?: string | undefined;
+        reason?: string | undefined;
         filePath?: string | undefined;
+        confidence?: "high" | "low" | undefined;
+        impact?: "high" | "low" | undefined;
+        additionalFilePaths?: string[] | undefined;
+        needsReview?: boolean | undefined;
+        previousSummary?: string | undefined;
+        reviewStatus?: "pending" | "rejected" | "approved" | undefined;
     }[] | undefined;
 }>;
 /**

package/dist/server/utils/curate-result-parser.js

@@ -1,10 +1,18 @@
 import { z } from 'zod';
 // ── Zod schemas ──────────────────────────────────────────────────────────────
 export const CurateOperationSchema = z.object({
+    additionalFilePaths: z.array(z.string()).optional(),
+    confidence: z.enum(['high', 'low']).optional(),
     filePath: z.string().optional(),
+    impact: z.enum(['high', 'low']).optional(),
     message: z.string().optional(),
+    needsReview: z.boolean().optional(),
     path: z.string(),
+    previousSummary: z.string().optional(),
+    reason: z.string().optional(),
+    reviewStatus: z.enum(['approved', 'pending', 'rejected']).optional(),
     status: z.enum(['failed', 'success']),
+    summary: z.string().optional(),
     type: z.enum(['ADD', 'DELETE', 'MERGE', 'UPDATE', 'UPSERT']),
 });
 export const CurateResultSchema = z.object({

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/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;