byterover-cli 2.6.0 → 3.0.1

package/dist/oclif/lib/task-client.js

@@ -1,5 +1,6 @@
 import { TaskErrorCode } from '../../server/core/domain/errors/task-error.js';
 import { LlmEvents, TaskEvents } from '../../shared/transport/events/index.js';
+import { ReviewEvents } from '../../shared/transport/events/review-events.js';
 import { writeJsonResponse } from './json-response.js';
 /** Grace period before treating 'reconnecting' as daemon death (ms) */
 const DISCONNECT_GRACE_MS = 10_000;
@@ -57,6 +58,7 @@ export function waitForTaskCompletion(options, log) {
         let completed = false;
         let disconnectTimer;
         const toolCalls = [];
+        let pendingReview;
         const rejectRetryable = (message) => {
             if (completed)
                 return;
@@ -169,13 +171,24 @@ export function waitForTaskCompletion(options, log) {
                     return;
                 onResponse(data.content, data.taskId);
             }),
+            // Pending review notification — emitted by server after curate completes with review-required ops
+            client.on(ReviewEvents.NOTIFY, (data) => {
+                if (data.taskId === taskId) {
+                    pendingReview = { pendingCount: data.pendingCount, reviewUrl: data.reviewUrl };
+                }
+            }),
             // Task completed
             client.on(TaskEvents.COMPLETED, (payload) => {
                 if (payload.taskId !== taskId || completed)
                     return;
                 completed = true;
                 cleanup();
-                onCompleted({ logId: payload.logId, result: payload.result, taskId, toolCalls });
+                // Prefer pendingReviewCount embedded in payload (set synchronously by server before task:completed).
+                // Falls back to review:notify capture for backward compatibility.
+                const resolvedPendingReview = payload.pendingReviewCount !== undefined && payload.pendingReviewCount > 0
+                    ? { pendingCount: payload.pendingReviewCount, reviewUrl: pendingReview?.reviewUrl ?? '' }
+                    : pendingReview;
+                onCompleted({ logId: payload.logId, pendingReview: resolvedPendingReview, result: payload.result, taskId, toolCalls });
                 resolve();
             }),
             // Task error
@@ -186,7 +199,7 @@ export function waitForTaskCompletion(options, log) {
                 cleanup();
                 onError({ error: payload.error, logId: payload.logId, taskId, toolCalls });
                 if (isText) {
-                    reject(Object.assign(new Error(payload.error.message), { code: payload.error.code }));
+                    reject(Object.assign(new Error(payload.error.message), { code: payload.error.code ?? TaskErrorCode.TASK_EXECUTION }));
                 }
                 else {
                     resolve();

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

@@ -11,6 +11,7 @@ type EnvironmentConfig = {
     authorizationUrl: string;
     clientId: string;
     cogitApiBaseUrl: string;
+    gitRemoteBaseUrl: string;
     hubRegistryUrl: string;
     issuerUrl: string;
     llmApiBaseUrl: string;
@@ -19,5 +20,6 @@ type EnvironmentConfig = {
     webAppUrl: string;
 };
 export declare const getCurrentConfig: () => EnvironmentConfig;
+export declare const getGitRemoteBaseUrl: () => string;
 export declare const isDevelopment: () => boolean;
 export {};

package/dist/server/config/environment.js

@@ -29,6 +29,7 @@ export const getCurrentConfig = () => ({
     authorizationUrl: readRequiredEnv('BRV_AUTHORIZATION_URL'),
     clientId: DEFAULTS.clientId,
     cogitApiBaseUrl: readRequiredEnv('BRV_COGIT_API_BASE_URL'),
+    gitRemoteBaseUrl: readRequiredEnv('BRV_GIT_REMOTE_BASE_URL'),
     hubRegistryUrl: DEFAULTS.hubRegistryUrl,
     issuerUrl: readRequiredEnv('BRV_ISSUER_URL'),
     llmApiBaseUrl: readRequiredEnv('BRV_LLM_API_BASE_URL'),
@@ -36,4 +37,5 @@ export const getCurrentConfig = () => ({
     tokenUrl: readRequiredEnv('BRV_TOKEN_URL'),
     webAppUrl: readRequiredEnv('BRV_WEB_APP_URL'),
 });
+export const getGitRemoteBaseUrl = () => process.env.BRV_GIT_REMOTE_BASE_URL ?? 'https://byterover.dev';
 export const isDevelopment = () => ENVIRONMENT === 'development';

package/dist/server/constants.d.ts

@@ -50,6 +50,7 @@ export declare const AGENT_PROCESS_READY_TIMEOUT_MS = 30000;
 export declare const AGENT_PROCESS_STOP_TIMEOUT_MS = 5000;
 export declare const CURATE_LOG_DIR = "curate-log";
 export declare const CURATE_LOG_ID_PREFIX = "cur";
+export declare const REVIEW_BACKUPS_DIR = "review-backups";
 export declare const SUMMARY_INDEX_FILE = "_index.md";
 export declare const ARCHIVE_DIR = "_archived";
 export declare const STUB_EXTENSION = ".stub.md";
@@ -57,3 +58,5 @@ export declare const FULL_ARCHIVE_EXTENSION = ".full.md";
 export declare const MANIFEST_FILE = "_manifest.json";
 export declare const ARCHIVE_IMPORTANCE_THRESHOLD = 35;
 export declare const DEFAULT_GHOST_CUE_MAX_TOKENS = 220;
+/** .gitignore content for the context tree — ignore derived artifacts only */
+export declare const CONTEXT_TREE_GITIGNORE = "# Derived artifacts \u2014 do not track\n.gitignore\n.snapshot.json\n_manifest.json\n_index.md\n";

package/dist/server/constants.js

@@ -68,6 +68,8 @@ export const AGENT_PROCESS_STOP_TIMEOUT_MS = 5000; // 5s max wait for child proc
 // Curate log
 export const CURATE_LOG_DIR = 'curate-log';
 export const CURATE_LOG_ID_PREFIX = 'cur';
+// Review backups (stores pre-curate file content for local HITL review diffs)
+export const REVIEW_BACKUPS_DIR = 'review-backups';
 // === Hierarchical DAG (summary, archive, manifest) ===
 export const SUMMARY_INDEX_FILE = '_index.md';
 export const ARCHIVE_DIR = '_archived';
@@ -76,3 +78,10 @@ export const FULL_ARCHIVE_EXTENSION = '.full.md';
 export const MANIFEST_FILE = '_manifest.json';
 export const ARCHIVE_IMPORTANCE_THRESHOLD = 35;
 export const DEFAULT_GHOST_CUE_MAX_TOKENS = 220;
+/** .gitignore content for the context tree — ignore derived artifacts only */
+export const CONTEXT_TREE_GITIGNORE = `# Derived artifacts — do not track
+.gitignore
+.snapshot.json
+_manifest.json
+_index.md
+`;

package/dist/server/core/domain/entities/auth-token.d.ts

@@ -6,6 +6,7 @@ export type AuthTokenParams = {
     tokenType?: string;
     userEmail: string;
     userId: string;
+    userName?: string;
 };
 /**
  * Represents an authentication token with access and refresh tokens, expiration, and type.
@@ -18,6 +19,7 @@ export declare class AuthToken {
     readonly tokenType: string;
     readonly userEmail: string;
     readonly userId: string;
+    readonly userName?: string;
     constructor(params: AuthTokenParams);
     /**
      * Create an AuthToken instance from a JSON object.

package/dist/server/core/domain/entities/auth-token.js

@@ -9,6 +9,7 @@ export class AuthToken {
     tokenType;
     userEmail;
     userId;
+    userName;
     constructor(params) {
         this.accessToken = params.accessToken;
         this.expiresAt = params.expiresAt;
@@ -17,6 +18,7 @@ export class AuthToken {
         this.tokenType = params.tokenType ?? 'Bearer';
         this.userId = params.userId;
         this.userEmail = params.userEmail;
+        this.userName = params.userName;
     }
     /**
      * Create an AuthToken instance from a JSON object.
@@ -39,6 +41,7 @@ export class AuthToken {
             tokenType: json.tokenType,
             userEmail: json.userEmail,
             userId: json.userId,
+            userName: json.userName ?? undefined,
         });
     }
     /**
@@ -60,7 +63,7 @@ export class AuthToken {
      * @returns A JSON object representing the AuthToken
      */
     toJson() {
-        return {
+        const json = {
             accessToken: this.accessToken,
             expiresAt: this.expiresAt.toISOString(),
             refreshToken: this.refreshToken,
@@ -69,5 +72,8 @@ export class AuthToken {
             userEmail: this.userEmail,
             userId: this.userId,
         };
+        if (this.userName)
+            json.userName = this.userName;
+        return json;
     }
 }

package/dist/server/core/domain/entities/curate-log-entry.d.ts

@@ -1,8 +1,19 @@
 export type CurateLogOperation = {
+    additionalFilePaths?: string[];
+    confidence?: 'high' | 'low';
     filePath?: string;
+    impact?: 'high' | 'low';
     message?: string;
+    needsReview?: boolean;
     path: string;
+    /** Semantic summary of the file's content before this operation (for review UI). */
+    previousSummary?: string;
+    reason?: string;
+    /** Local review status. Set to 'pending' when needsReview=true; updated to 'approved'/'rejected' by the review UI. */
+    reviewStatus?: 'approved' | 'pending' | 'rejected';
     status: 'failed' | 'success';
+    /** Semantic summary of the file's content after this operation (for review UI). */
+    summary?: string;
     type: 'ADD' | 'DELETE' | 'MERGE' | 'UPDATE' | 'UPSERT';
 };
 export type CurateLogSummary = {

package/dist/server/core/domain/entities/space.d.ts

@@ -5,8 +5,10 @@ interface SpaceParams {
     id: string;
     isDefault: boolean;
     name: string;
+    slug?: string;
     teamId: string;
     teamName: string;
+    teamSlug?: string;
 }
 /**
  * Represents a ByteRover space that belongs to a team.
@@ -16,8 +18,10 @@ export declare class Space {
     readonly id: string;
     readonly isDefault: boolean;
     readonly name: string;
+    readonly slug: string;
     readonly teamId: string;
     readonly teamName: string;
+    readonly teamSlug: string;
     constructor(params: SpaceParams);
     /**
      * Deserializes a space from JSON format

package/dist/server/core/domain/entities/space.js

@@ -6,8 +6,10 @@ export class Space {
     id;
     isDefault;
     name;
+    slug;
     teamId;
     teamName;
+    teamSlug;
     constructor(params) {
         if (params.id.trim().length === 0) {
             throw new Error('Space ID cannot be empty');
@@ -24,8 +26,10 @@ export class Space {
         this.id = params.id;
         this.isDefault = params.isDefault;
         this.name = params.name;
+        this.slug = params.slug ?? params.name;
         this.teamId = params.teamId;
         this.teamName = params.teamName;
+        this.teamSlug = params.teamSlug ?? params.teamName;
     }
     /**
      * Deserializes a space from JSON format
@@ -50,8 +54,10 @@ export class Space {
             id: json.id,
             isDefault: json.is_default,
             name: json.name,
+            slug: typeof json.slug === 'string' ? json.slug : json.name,
             teamId: json.team_id,
             teamName: json.team_name,
+            teamSlug: typeof json.team_slug === 'string' ? json.team_slug : json.team_name,
         });
     }
     /**
@@ -69,8 +75,10 @@ export class Space {
             id: this.id,
             isDefault: this.isDefault,
             name: this.name,
+            slug: this.slug,
             teamId: this.teamId,
             teamName: this.teamName,
+            teamSlug: this.teamSlug,
         };
     }
 }

package/dist/server/core/domain/entities/team.d.ts

@@ -10,6 +10,7 @@ interface TeamParams {
     isActive: boolean;
     isDefault: boolean;
     name: string;
+    slug: string;
     updatedAt: Date;
 }
 /**
@@ -25,6 +26,7 @@ export declare class Team {
     readonly isActive: boolean;
     readonly isDefault: boolean;
     readonly name: string;
+    readonly slug: string;
     readonly updatedAt: Date;
     constructor(params: TeamParams);
     /**

package/dist/server/core/domain/entities/team.js

@@ -11,6 +11,7 @@ export class Team {
     isActive;
     isDefault;
     name;
+    slug;
     updatedAt;
     constructor(params) {
         if (params.id.trim().length === 0) {
@@ -30,6 +31,7 @@ export class Team {
         this.isActive = params.isActive;
         this.isDefault = params.isDefault;
         this.name = params.name;
+        this.slug = params.slug;
         this.updatedAt = params.updatedAt;
     }
     /**
@@ -67,6 +69,7 @@ export class Team {
             isActive: json.is_active,
             isDefault: json.is_default,
             name: json.name,
+            slug: typeof json.slug === 'string' ? json.slug : json.name,
             updatedAt: new Date(json.updated_at),
         });
     }
@@ -90,6 +93,7 @@ export class Team {
             isActive: this.isActive,
             isDefault: this.isDefault,
             name: this.name,
+            slug: this.slug,
             updatedAt: this.updatedAt.toISOString(),
         };
     }

package/dist/server/core/domain/errors/git-error.d.ts

@@ -0,0 +1,6 @@
+export declare class GitError extends Error {
+    constructor(message: string);
+}
+export declare class GitAuthError extends GitError {
+    constructor(message?: string);
+}

package/dist/server/core/domain/errors/git-error.js

@@ -0,0 +1,12 @@
+export class GitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GitError';
+    }
+}
+export class GitAuthError extends GitError {
+    constructor(message = 'Git authentication failed. Try /login again.') {
+        super(message);
+        this.name = 'GitAuthError';
+    }
+}

package/dist/server/core/domain/errors/task-error.d.ts

@@ -21,6 +21,7 @@ export declare const TaskErrorCode: {
     readonly TASK_EXECUTION: "ERR_TASK_EXECUTION";
     readonly TASK_TIMEOUT: "ERR_TASK_TIMEOUT";
     readonly UNKNOWN: "ERR_UNKNOWN";
+    readonly VC_GIT_INITIALIZED: "ERR_VC_GIT_INITIALIZED";
 };
 export type TaskErrorCodeType = (typeof TaskErrorCode)[keyof typeof TaskErrorCode];
 /**
@@ -75,6 +76,9 @@ export declare class LocalChangesExistError extends TaskError {
 export declare class SpaceNotConfiguredError extends TaskError {
     constructor();
 }
+export declare class GitVcInitializedError extends TaskError {
+    constructor(message: string);
+}
 export declare class SpaceNotFoundError extends TaskError {
     constructor();
 }

package/dist/server/core/domain/errors/task-error.js

@@ -28,6 +28,8 @@ export const TaskErrorCode = {
     TASK_TIMEOUT: 'ERR_TASK_TIMEOUT',
     // Unknown
     UNKNOWN: 'ERR_UNKNOWN',
+    // Version control
+    VC_GIT_INITIALIZED: 'ERR_VC_GIT_INITIALIZED',
 };
 /**
  * Base error class for task-related errors.
@@ -157,6 +159,12 @@ export class SpaceNotConfiguredError extends TaskError {
         this.name = 'SpaceNotConfiguredError';
     }
 }
+export class GitVcInitializedError extends TaskError {
+    constructor(message) {
+        super(message, TaskErrorCode.VC_GIT_INITIALIZED);
+        this.name = 'GitVcInitializedError';
+    }
+}
 export class SpaceNotFoundError extends TaskError {
     constructor() {
         super('Space not found', TaskErrorCode.SPACE_NOT_FOUND);

package/dist/server/core/domain/errors/vc-error.d.ts

@@ -0,0 +1,5 @@
+import type { VcErrorCodeType } from '../../../../shared/transport/events/vc-events.js';
+export declare class VcError extends Error {
+    readonly code: VcErrorCodeType;
+    constructor(message: string, code: VcErrorCodeType);
+}

package/dist/server/core/domain/errors/vc-error.js

@@ -0,0 +1,8 @@
+export class VcError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'VcError';
+        this.code = code;
+    }
+}

package/dist/server/core/domain/knowledge/markdown-writer.d.ts

@@ -48,9 +48,11 @@ export interface ContextData {
     name: string;
     narrative?: Narrative;
     rawConcept?: RawConcept;
+    reason?: string;
     relations?: string[];
     scoring?: FrontmatterScoring;
     snippets: string[];
+    summary?: string;
     tags: string[];
 }
 interface Frontmatter {
@@ -61,6 +63,7 @@ interface Frontmatter {
     maturity?: 'core' | 'draft' | 'validated';
     recency?: number;
     related: string[];
+    summary?: string;
     tags: string[];
     title?: string;
     updateCount?: number;
@@ -88,7 +91,7 @@ export declare function parseFrontmatterScoring(content: string): FrontmatterSco
 export declare function updateScoringInContent(content: string, scoring: FrontmatterScoring): string;
 export declare const MarkdownWriter: {
     generateContext(data: ContextData): string;
-    mergeContexts(sourceContent: string, targetContent: string): string;
+    mergeContexts(sourceContent: string, targetContent: string, reason?: string, summary?: string): string;
     parseContent(content: string, name?: string): ContextData;
 };
 export {};

package/dist/server/core/domain/knowledge/markdown-writer.js

@@ -5,12 +5,15 @@ import { normalizeRelationPath, parseRelations } from './relation-parser.js';
  * Generate YAML frontmatter block from context data.
  * Only includes fields that have values.
  */
-function generateFrontmatter(title, relations, tags = [], keywords = [], scoring) {
+function generateFrontmatter(title, relations, tags = [], keywords = [], scoring, summary) {
     const normalizedRelations = (relations || []).map(rel => normalizeRelationPath(rel));
     const fm = {};
     if (title) {
         fm.title = title;
     }
+    if (summary) {
+        fm.summary = summary;
+    }
     fm.tags = tags;
     if (normalizedRelations.length > 0) {
         fm.related = normalizedRelations;
@@ -74,6 +77,9 @@ function parseFrontmatter(content) {
         if (typeof parsed.title === 'string') {
             frontmatter.title = parsed.title;
         }
+        if (typeof parsed.summary === 'string') {
+            frontmatter.summary = parsed.summary;
+        }
         // Scoring fields (backward compatible — absent in old files)
         if (typeof parsed.importance === 'number') {
             frontmatter.importance = parsed.importance;
@@ -333,6 +339,18 @@ function parseFactsSection(content) {
     }
     return facts.length > 0 ? facts : undefined;
 }
+function generateReasonSection(reason) {
+    if (!reason)
+        return '';
+    return `\n## Reason\n${reason}\n`;
+}
+function parseReasonSection(content) {
+    const match = content.match(/##\s*Reason\s*\n([\s\S]*?)(?=\n##\s|\n---\n|$)/i);
+    if (!match)
+        return undefined;
+    const text = match[1].trim();
+    return text || undefined;
+}
 function extractSnippetsFromContent(content) {
     let snippetContent = content;
     // Forgiving regex patterns for section removal
@@ -340,6 +358,10 @@ function extractSnippetsFromContent(content) {
     if (relationsMatch) {
         snippetContent = snippetContent.replace(relationsMatch[0], '').trim();
     }
+    const reasonMatch = snippetContent.match(/##\s*Reason[\s\S]*?(?=\n##\s|\n---\n|$)/i);
+    if (reasonMatch) {
+        snippetContent = snippetContent.replace(reasonMatch[0], '').trim();
+    }
     const rawConceptMatch = snippetContent.match(/##\s*Raw Concept[\s\S]*?(?=\n##\s|\n---\n|$)/i);
     if (rawConceptMatch) {
         snippetContent = snippetContent.replace(rawConceptMatch[0], '').trim();
@@ -518,7 +540,7 @@ export function updateScoringInContent(content, scoring) {
         return content;
     }
     const { body, frontmatter } = parsed;
-    const updatedFrontmatter = generateFrontmatter(frontmatter.title ?? '', frontmatter.related, frontmatter.tags, frontmatter.keywords, scoring);
+    const updatedFrontmatter = generateFrontmatter(frontmatter.title ?? '', frontmatter.related, frontmatter.tags, frontmatter.keywords, scoring, frontmatter.summary);
     return updatedFrontmatter + body;
 }
 function parseContentWithFrontmatter(content) {
@@ -529,6 +551,7 @@ function parseContentWithFrontmatter(content) {
             keywords: parsed.frontmatter.keywords,
             relations: parsed.frontmatter.related,
             scoring: extractScoring(parsed.frontmatter),
+            summary: parsed.frontmatter.summary,
             tags: parsed.frontmatter.tags,
             title: parsed.frontmatter.title,
         };
@@ -545,15 +568,16 @@ export const MarkdownWriter = {
     generateContext(data) {
         const snippets = (data.snippets || []).filter(s => s && s.trim());
         const relations = data.relations || [];
-        const frontmatter = generateFrontmatter(data.name, relations, data.tags, data.keywords, data.scoring);
+        const frontmatter = generateFrontmatter(data.name, relations, data.tags, data.keywords, data.scoring, data.summary);
+        const reasonSection = generateReasonSection(data.reason);
         const rawConceptSection = generateRawConceptSection(data.rawConcept);
         const narrativeSection = generateNarrativeSection(data.narrative);
         const factsSection = generateFactsSection(data.facts);
         const hasSnippets = snippets.length > 0;
         // Build the content parts
         const parts = [];
-        // Add sections (rawConcept, narrative, facts) — relations are now in frontmatter
-        const sectionsContent = `${rawConceptSection}${narrativeSection}${factsSection}`.trim();
+        // Add sections — reason first (WHY), then content sections, relations in frontmatter
+        const sectionsContent = `${reasonSection}${rawConceptSection}${narrativeSection}${factsSection}`.trim();
         if (sectionsContent) {
             parts.push(sectionsContent);
         }
@@ -570,12 +594,14 @@ export const MarkdownWriter = {
         const body = parts.length > 0 ? parts.join('\n\n---\n\n') + '\n' : '';
         return `${frontmatter}${body}`;
     },
-    mergeContexts(sourceContent, targetContent) {
+    mergeContexts(sourceContent, targetContent, reason, summary) {
         const sourceParsed = parseContentWithFrontmatter(sourceContent);
         const targetParsed = parseContentWithFrontmatter(targetContent);
         const mergedRelations = [...new Set([...sourceParsed.relations, ...targetParsed.relations])];
         const mergedTags = [...new Set([...sourceParsed.tags, ...targetParsed.tags])];
         const mergedKeywords = [...new Set([...sourceParsed.keywords, ...targetParsed.keywords])];
+        // reason: explicit override wins, then source (newer), then target (older)
+        const mergedReason = reason ?? parseReasonSection(sourceParsed.body) ?? parseReasonSection(targetParsed.body);
         // Merge scoring metadata (FinMem-inspired lifecycle)
         const defaultScoring = { importance: 50, maturity: 'draft', recency: 1 };
         let mergedScoringData;
@@ -609,23 +635,27 @@ export const MarkdownWriter = {
             name: sourceParsed.title || targetParsed.title || '',
             narrative: mergedNarrative,
             rawConcept: mergedRawConcept,
+            reason: mergedReason,
             relations: mergedRelations,
             scoring: mergedScoringData,
             snippets: mergedSnippets,
+            summary: summary ?? sourceParsed.summary ?? targetParsed.summary,
             tags: mergedTags,
         });
     },
     parseContent(content, name = '') {
-        const { body, keywords, relations, scoring, tags, title } = parseContentWithFrontmatter(content);
+        const { body, keywords, relations, scoring, summary, tags, title } = parseContentWithFrontmatter(content);
         return {
             facts: parseFactsSection(body),
             keywords,
             name: title || name,
             narrative: parseNarrativeSection(body),
             rawConcept: parseRawConceptSection(body),
+            reason: parseReasonSection(body),
             relations,
             scoring,
             snippets: extractSnippetsFromContent(body),
+            summary,
             tags,
         };
     },

package/dist/server/core/domain/transport/schemas.d.ts

@@ -521,18 +521,18 @@ export declare const TaskExecuteSchema: z.ZodObject<{
     taskId: string;
     clientId: string;
     files?: string[] | undefined;
+    projectPath?: string | undefined;
     folderPath?: string | undefined;
     clientCwd?: string | undefined;
-    projectPath?: string | undefined;
 }, {
     type: "curate" | "query" | "curate-folder";
     content: string;
     taskId: string;
     clientId: string;
     files?: string[] | undefined;
+    projectPath?: string | undefined;
     folderPath?: string | undefined;
     clientCwd?: string | undefined;
-    projectPath?: string | undefined;
 }>;
 /**
  * task:cancel - Transport tells Agent to cancel a task
@@ -718,14 +718,14 @@ export declare const TaskStartedEventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     taskId: string;
     type?: string | undefined;
-    content?: string | undefined;
     files?: string[] | undefined;
+    content?: string | undefined;
     clientCwd?: string | undefined;
 }, {
     taskId: string;
     type?: string | undefined;
-    content?: string | undefined;
     files?: string[] | undefined;
+    content?: string | undefined;
     clientCwd?: string | undefined;
 }>;
 /**
@@ -965,17 +965,17 @@ export declare const TaskCreateRequestSchema: z.ZodObject<{
     content: string;
     taskId: string;
     files?: string[] | undefined;
+    projectPath?: string | undefined;
     folderPath?: string | undefined;
     clientCwd?: string | undefined;
-    projectPath?: string | undefined;
 }, {
     type: "curate" | "query" | "curate-folder";
     content: string;
     taskId: string;
     files?: string[] | undefined;
+    projectPath?: string | undefined;
     folderPath?: string | undefined;
     clientCwd?: string | undefined;
-    projectPath?: string | undefined;
 }>;
 /**
  * Response after task creation

package/dist/server/core/interfaces/context-tree/i-context-tree-service.d.ts

@@ -15,6 +15,12 @@ export interface IContextTreeService {
      * @returns True if context tree directory exists
      */
     exists(directory?: string): Promise<boolean>;
+    /**
+     * Checks if a git repository (.git directory) exists in the context tree.
+     * @param directory - Base directory
+     * @returns True if .git directory exists inside the context tree
+     */
+    hasGitRepo(directory: string): Promise<boolean>;
     /**
      * Initializes the context tree directory structure.
      * Creates .brv/context-tree/ directory with domain subdirectories and context.md files.
@@ -23,4 +29,9 @@ export interface IContextTreeService {
      * @throws Error if context tree already exists or initialization fails
      */
     initialize(directory?: string): Promise<string>;
+    /**
+     * Returns the absolute path to the context tree directory without creating it.
+     * @param directory - Base directory
+     */
+    resolvePath(directory: string): string;
 }

package/dist/server/core/interfaces/process/i-task-lifecycle-hook.d.ts

@@ -12,6 +12,12 @@ import type { TaskInfo } from '../../domain/transport/task-info.js';
 export interface ITaskLifecycleHook {
     /** Called after onTaskCompleted, onTaskError, or onTaskCancelled to release in-memory resources. */
     cleanup?(taskId: string): void;
+    /**
+     * Synchronous hook called just before task:completed is emitted.
+     * Returns extra data to merge into the task:completed payload (e.g. {pendingReviewCount: 2}).
+     * Must be synchronous and must not throw.
+     */
+    getTaskCompletionData?(taskId: string): Record<string, unknown>;
     /** Called when a task is cancelled by the user. Distinct from onTaskError. */
     onTaskCancelled?(taskId: string, task: TaskInfo): Promise<void>;
     /** Called when a task completes successfully. */