byterover-cli 2.5.2 → 3.0.0

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/file-content-reader.d.ts

@@ -26,7 +26,7 @@ export interface FileReadResult {
 /**
  * Configuration options for file reading.
  */
-export interface FileContentReaderConfig {
+interface FileContentReaderConfig {
     /** Maximum content length per file in characters (default: 40000) */
     maxContentLength?: number;
     /** Maximum lines to read for text files (default: 2000) */
@@ -79,3 +79,4 @@ export declare class FileContentReader {
  * Factory function to create a FileContentReader instance.
  */
 export declare function createFileContentReader(documentParser?: IDocumentParserService): FileContentReader;
+export {};

package/dist/server/utils/file-helpers.d.ts

@@ -1,18 +1,3 @@
-/**
- * Finds the most recent file in a directory by modification time.
- * @param directory - Absolute path to directory to search
- * @returns Absolute path to the most recent file
- * @throws Error if directory is empty or doesn't exist
- */
-export declare function findLatestFile(directory: string): Promise<string>;
-/**
- * Removes all files from a directory while preserving the directory itself.
- * Returns the number of files removed.
- * Silently succeeds if directory doesn't exist.
- * @param dirPath - Absolute path to directory to clear
- * @returns Number of files removed
- */
-export declare function clearDirectory(dirPath: string): Promise<number>;
 /**
  * Sanitizes a folder path by replacing all special characters with a hyphen.
  * @param folderName - The folder path need to sanitize
@@ -33,12 +18,3 @@ export declare function sanitizeFolderName(folderName: string): string;
  * ```
  */
 export declare function toSnakeCase(name: string): string;
-/**
- * Lists all immediate children (files and directories) of the given directory,
- * and, for each child folder, shows its own immediate children.
- * @param dirPath The directory path whose children to list.
- * @returns An object where keys are child names, and values are:
- *   - for files: undefined
- *   - for directories: an array of their immediate children
- */
-export declare function listDirectoryChildren(dirPath?: string): Record<string, string[] | undefined>;

package/dist/server/utils/file-helpers.js

@@ -1,49 +1,3 @@
-import fs from 'node:fs';
-import { readdir, unlink } from 'node:fs/promises';
-import { join } from 'node:path';
-/**
- * Finds the most recent file in a directory by modification time.
- * @param directory - Absolute path to directory to search
- * @returns Absolute path to the most recent file
- * @throws Error if directory is empty or doesn't exist
- */
-export async function findLatestFile(directory) {
-    const files = await readdir(directory, { withFileTypes: true });
-    const fileNames = files.filter((f) => f.isFile()).map((f) => f.name);
-    if (fileNames.length === 0) {
-        throw new Error(`No files found in directory: ${directory}`);
-    }
-    // Sort files by name (timestamp-based naming ensures latest is last)
-    // Assuming filenames follow pattern: prefix-{timestamp}.json
-    fileNames.sort();
-    const latestFile = fileNames.at(-1);
-    return join(directory, latestFile);
-}
-/**
- * Removes all files from a directory while preserving the directory itself.
- * Returns the number of files removed.
- * Silently succeeds if directory doesn't exist.
- * @param dirPath - Absolute path to directory to clear
- * @returns Number of files removed
- */
-export async function clearDirectory(dirPath) {
-    try {
-        const entries = await readdir(dirPath, { withFileTypes: true });
-        // Filter to only get files (not subdirectories)
-        const files = entries.filter((entry) => entry.isFile());
-        // Remove each file
-        await Promise.all(files.map((file) => unlink(join(dirPath, file.name))));
-        return files.length;
-    }
-    catch (error) {
-        // If directory doesn't exist (ENOENT), return 0
-        if (error.code === 'ENOENT') {
-            return 0;
-        }
-        // Re-throw other errors
-        throw error;
-    }
-}
 /**
  * Sanitizes a folder path by replacing all special characters with a hyphen.
  * @param folderName - The folder path need to sanitize
@@ -73,38 +27,3 @@ export function toSnakeCase(name) {
         .replaceAll(/_{2,}/g, '_')
         .replaceAll(/^_|_$/g, '');
 }
-/**
- * Lists all immediate children (files and directories) of the given directory,
- * and, for each child folder, shows its own immediate children.
- * @param dirPath The directory path whose children to list.
- * @returns An object where keys are child names, and values are:
- *   - for files: undefined
- *   - for directories: an array of their immediate children
- */
-export function listDirectoryChildren(dirPath = '.brv/context-tree') {
-    const result = {};
-    const children = fs.readdirSync(dirPath);
-    for (const child of children) {
-        const childPath = `${dirPath}/${child}`;
-        let stat;
-        try {
-            stat = fs.statSync(childPath);
-        }
-        catch {
-            result[child] = undefined;
-            continue;
-        }
-        if (stat.isDirectory()) {
-            try {
-                result[child] = fs.readdirSync(childPath);
-            }
-            catch {
-                result[child] = undefined;
-            }
-        }
-        else {
-            result[child] = undefined;
-        }
-    }
-    return result;
-}