byterover-cli 3.8.3 → 3.9.0

package/dist/agent/infra/llm/providers/google.js

@@ -15,7 +15,7 @@ export const googleProvider = {
             model: provider(config.model),
         });
     },
-    defaultModel: 'gemini-2.5-flash',
+    defaultModel: 'gemini-3-flash-preview',
     description: 'Gemini models by Google',
     envVars: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
     id: 'google',

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

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

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

@@ -0,0 +1,40 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { VcEvents, } from '../../../shared/transport/events/vc-events.js';
+import { formatDiff } from '../../../tui/features/vc/diff/utils/format-diff.js';
+import { parseMode } from '../../../tui/features/vc/diff/utils/parse-mode.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class VcDiff extends Command {
+    static args = {
+        ref: Args.string({ description: 'commit, branch, or <ref1>..<ref2> range' }),
+    };
+    static description = 'Show changes between commits, the index, or the working tree';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --staged',
+        '<%= config.bin %> <%= command.id %> HEAD~1',
+        '<%= config.bin %> <%= command.id %> main..feature/x',
+        '<%= config.bin %> <%= command.id %> main',
+    ];
+    static flags = {
+        staged: Flags.boolean({ description: 'Show staged changes (HEAD vs index)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VcDiff);
+        let request;
+        try {
+            request = { mode: parseMode(args.ref, flags.staged) };
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+        try {
+            const response = await withDaemonRetry((client) => client.requestWithAck(VcEvents.DIFFS, request));
+            const text = formatDiff(response);
+            if (text.length > 0)
+                process.stdout.write(text);
+        }
+        catch (error) {
+            this.error(formatConnectionError(error));
+        }
+    }
+}

package/dist/oclif/commands/vc/remote/remove.d.ts

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

package/dist/oclif/commands/vc/remote/remove.js

@@ -0,0 +1,23 @@
+import { Args, Command } from '@oclif/core';
+import { VcEvents } from '../../../../shared/transport/events/vc-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../../lib/daemon-client.js';
+export default class VcRemoteRemove extends Command {
+    static args = {
+        name: Args.string({ description: 'Remote name', required: true }),
+    };
+    static description = 'Remove a named remote';
+    static examples = [`<%= config.bin %> <%= command.id %> origin`];
+    async run() {
+        const { args } = await this.parse(VcRemoteRemove);
+        if (args.name !== 'origin') {
+            this.error(`Only 'origin' remote is currently supported.`);
+        }
+        try {
+            await withDaemonRetry(async (client) => client.requestWithAck(VcEvents.REMOTE, { subcommand: 'remove' }));
+            this.log(`Remote 'origin' removed.`);
+        }
+        catch (error) {
+            this.error(formatConnectionError(error));
+        }
+    }
+}

package/dist/server/core/domain/entities/brv-config.d.ts

@@ -85,6 +85,10 @@ export declare class BrvConfig {
      * Serializes the config to JSON format
      */
     toJson(): Record<string, unknown>;
+    /**
+     * Creates a new BrvConfig with space fields cleared, preserving all other fields.
+     */
+    withoutSpace(): BrvConfig;
     /**
      * Creates a new BrvConfig with space fields replaced, preserving all other fields.
      */

package/dist/server/core/domain/entities/brv-config.js

@@ -170,6 +170,18 @@ export class BrvConfig {
             version: this.version,
         };
     }
+    /**
+     * Creates a new BrvConfig with space fields cleared, preserving all other fields.
+     */
+    withoutSpace() {
+        return new BrvConfig({
+            ...this,
+            spaceId: undefined,
+            spaceName: undefined,
+            teamId: undefined,
+            teamName: undefined,
+        });
+    }
     /**
      * Creates a new BrvConfig with space fields replaced, preserving all other fields.
      */

package/dist/server/core/domain/entities/provider-registry.js

@@ -89,7 +89,7 @@ export const PROVIDER_REGISTRY = {
         apiKeyUrl: 'https://aistudio.google.com/apikey',
         baseUrl: '',
         category: 'popular',
-        defaultModel: 'gemini-2.5-flash',
+        defaultModel: 'gemini-3-flash-preview',
         description: 'Gemini models by Google',
         envVars: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
         headers: {},

package/dist/server/core/interfaces/services/i-git-service.d.ts

@@ -166,10 +166,12 @@ export type CloneGitParams = BaseGitParams & {
 };
 /**
  * Source of the blob content.
- * - `'HEAD'` → blob at the HEAD commit
  * - `'STAGE'` → blob in the git index (staging area)
+ * - `{commitish: string}` → blob at the resolved commit (branch name, tag, SHA, or `'HEAD'`)
  */
-export type GitBlobRef = 'HEAD' | 'STAGE';
+export type GitBlobRef = 'STAGE' | {
+    commitish: string;
+};
 export type GetBlobContentParams = BaseGitParams & {
     path: string;
     ref: GitBlobRef;
@@ -180,6 +182,30 @@ export type GetBlobContentsParams = BaseGitParams & {
 };
 /** Map of path → blob content (utf8). Missing entries indicate the blob is absent at that ref. */
 export type BlobContents = Record<string, string | undefined>;
+/**
+ * Source of the side being diffed. Beyond `GitBlobRef`, also supports `'WORKDIR'`
+ * (the working tree, used for unstaged and ref-vs-worktree comparisons).
+ */
+export type GitDiffSide = 'STAGE' | 'WORKDIR' | {
+    commitish: string;
+};
+export type ListChangedFilesParams = BaseGitParams & {
+    from: GitDiffSide;
+    to: GitDiffSide;
+};
+export type ChangedFile = {
+    path: string;
+    status: 'added' | 'deleted' | 'modified';
+};
+/** Content + short oid pair returned by {@link IGitService.getTextBlob}. */
+export type TextBlob = {
+    /** True when the blob contains a NUL byte; `content` is then empty. */
+    binary?: boolean;
+    /** UTF-8 decoded blob content (empty string when binary). */
+    content: string;
+    /** 7-char short oid. */
+    oid: string;
+};
 export interface IGitService {
     abortMerge(params: AbortMergeGitParams): Promise<void>;
     add(params: AddGitParams): Promise<void>;
@@ -194,11 +220,11 @@ export interface IGitService {
     getAheadBehind(params: GetAheadBehindParams): Promise<AheadBehind>;
     /**
      * Reads the content of a file blob at a given git ref.
-     * - `ref: 'HEAD'` → resolves HEAD commit, then reads the blob at `path`
      * - `ref: 'STAGE'` → reads the blob staged in the index at `path`
+     * - `ref: {commitish}` → resolves the commit-ish ref (branch name, tag, SHA, or `'HEAD'`), then reads the blob at `path`
      *
      * Returns `undefined` when no blob exists at that ref (e.g. file not yet committed,
-     * or file not yet staged), or when HEAD has no commits.
+     * or file not yet staged), or when the ref has no commits.
      */
     getBlobContent(params: GetBlobContentParams): Promise<string | undefined>;
     /**
@@ -227,8 +253,21 @@ export interface IGitService {
      */
     getFilesWithConflictMarkers(params: BaseGitParams): Promise<string[]>;
     getRemoteUrl(params: GetRemoteUrlGitParams): Promise<string | undefined>;
+    /**
+     * Reads a UTF-8 text blob together with its short oid in a single pass.
+     * Returns `undefined` when the blob is absent or detected as binary (contains a NUL byte).
+     * Used by diff producers to avoid the double-read pattern of calling `getBlobContent`
+     * and `git.hashBlob` separately.
+     */
+    getTextBlob(params: GetBlobContentParams): Promise<TextBlob | undefined>;
     /** Returns the upstream tracking branch config, or `undefined` if not configured. */
     getTrackingBranch(params: GetTrackingBranchParams): Promise<TrackingBranch | undefined>;
+    /**
+     * Returns the 7-character short oid that git would assign to the given content,
+     * computed via `git.hashBlob`. Used to render the working-tree side of a
+     * `git diff`-style `index <oid>..<oid>` header (the working tree has no stored oid).
+     */
+    hashBlob(content: Buffer): Promise<string>;
     init(params: InitGitParams): Promise<void>;
     /** Returns true if `ancestor` commit is reachable from `commit`. */
     isAncestor(params: BaseGitParams & {
@@ -241,6 +280,18 @@ export interface IGitService {
     isInitialized(params: BaseGitParams): Promise<boolean>;
     /** Lists local branches. When `remote` is specified, also includes remote-tracking branches. */
     listBranches(params: ListBranchesGitParams): Promise<GitBranch[]>;
+    /**
+     * Returns the set of files that differ between two diff sides, with their change status.
+     *
+     * Status mirrors `git diff` semantics:
+     * - `'added'`   → present on `to` side, absent on `from` side
+     * - `'deleted'` → present on `from` side, absent on `to` side
+     * - `'modified'` → present on both, differs
+     *
+     * Untracked files (absent from both HEAD and STAGE) are excluded from the
+     * unstaged case (`from='STAGE', to='WORKDIR'`) to match `git diff` no-args behavior.
+     */
+    listChangedFiles(params: ListChangedFilesParams): Promise<ChangedFile[]>;
     listRemotes(params: BaseGitParams): Promise<GitRemote[]>;
     log(params: LogGitParams): Promise<GitCommit[]>;
     merge(params: MergeGitParams): Promise<MergeResult>;

package/dist/server/infra/context-tree/summary-frontmatter.js

@@ -44,7 +44,7 @@ export function generateSummaryContent(frontmatter, body) {
         token_count: frontmatter.token_count,
         type: 'summary',
     };
-    const yamlContent = yamlDump(fm, { flowLevel: 1, lineWidth: -1, sortKeys: true }).trimEnd();
+    const yamlContent = yamlDump(fm, { flowLevel: 1, lineWidth: -1, sortKeys: false }).trimEnd();
     return `---\n${yamlContent}\n---\n${body}`;
 }
 // ---------------------------------------------------------------------------
@@ -79,7 +79,7 @@ export function generateArchiveStubContent(frontmatter, ghostCue) {
         points_to: frontmatter.points_to,
         type: 'archive_stub',
     };
-    const yamlContent = yamlDump(fm, { flowLevel: 1, lineWidth: -1, sortKeys: true }).trimEnd();
+    const yamlContent = yamlDump(fm, { flowLevel: 1, lineWidth: -1, sortKeys: false }).trimEnd();
     return `---\n${yamlContent}\n---\n${ghostCue}`;
 }
 // ---------------------------------------------------------------------------

package/dist/server/infra/dream/operations/consolidate.js

@@ -224,8 +224,9 @@ function addFrontmatterFields(content, fields) {
             try {
                 const parsed = yamlLoad(yamlBlock);
                 if (parsed && typeof parsed === 'object') {
+                    // Spread preserves existing key order; new fields are appended at end.
                     const merged = { ...parsed, ...fields };
-                    const newYaml = yamlDump(merged, { flowLevel: 2, lineWidth: -1, sortKeys: true }).trimEnd();
+                    const newYaml = yamlDump(merged, { flowLevel: 2, lineWidth: -1, sortKeys: false }).trimEnd();
                     return `---\n${newYaml}\n---\n${body}`;
                 }
             }
@@ -235,7 +236,7 @@ function addFrontmatterFields(content, fields) {
         }
     }
     // No valid frontmatter — prepend
-    const yaml = yamlDump(fields, { flowLevel: 2, lineWidth: -1, sortKeys: true }).trimEnd();
+    const yaml = yamlDump(fields, { flowLevel: 2, lineWidth: -1, sortKeys: false }).trimEnd();
     return `---\n${yaml}\n---\n${content}`;
 }
 // ── Helpers ──────────────────────────────────────────────────────────────────
@@ -492,7 +493,7 @@ async function addRelatedLinks(filePath, relatedPaths) {
                 if (parsed && typeof parsed === 'object') {
                     const existing = Array.isArray(parsed.related) ? parsed.related : [];
                     parsed.related = [...new Set([...existing, ...relatedPaths])];
-                    const newYaml = yamlDump(parsed, { flowLevel: 1, lineWidth: -1, sortKeys: true }).trimEnd();
+                    const newYaml = yamlDump(parsed, { flowLevel: 1, lineWidth: -1, sortKeys: false }).trimEnd();
                     await atomicWrite(filePath, `---\n${newYaml}\n---\n${body}`);
                     return;
                 }
@@ -503,7 +504,7 @@ async function addRelatedLinks(filePath, relatedPaths) {
         }
     }
     // No existing frontmatter — add one with related field
-    const yaml = yamlDump({ related: relatedPaths }, { flowLevel: 1, lineWidth: -1, sortKeys: true }).trimEnd();
+    const yaml = yamlDump({ related: relatedPaths }, { flowLevel: 1, lineWidth: -1, sortKeys: false }).trimEnd();
     await atomicWrite(filePath, `---\n${yaml}\n---\n${content}`);
 }
 async function determineNeedsReview(actionType, files, opts) {

package/dist/server/infra/dream/operations/synthesize.js

@@ -208,7 +208,7 @@ async function writeSynthesisFile(candidate, contextTreeDir, runtimeSignalStore,
         type: 'synthesis',
     };
     /* eslint-enable camelcase */
-    const yaml = yamlDump(frontmatter, { lineWidth: -1, sortKeys: true }).trimEnd();
+    const yaml = yamlDump(frontmatter, { lineWidth: -1, sortKeys: false }).trimEnd();
     const body = [
         `# ${candidate.title}`,
         '',

package/dist/server/infra/git/isomorphic-git-service.d.ts

@@ -1,4 +1,4 @@
-import type { AbortMergeGitParams, AddGitParams, AddRemoteGitParams, AheadBehind, BaseGitParams, BlobContents, CheckoutGitParams, CloneGitParams, CommitGitParams, CreateBranchGitParams, DeleteBranchGitParams, FetchGitParams, GetAheadBehindParams, GetBlobContentParams, GetBlobContentsParams, GetRemoteUrlGitParams, GetTrackingBranchParams, GitBranch, GitCommit, GitConflict, GitRemote, GitStatus, IGitService, InitGitParams, ListBranchesGitParams, LogGitParams, MergeGitParams, MergeResult, PullGitParams, PullResult, PushGitParams, PushResult, RemoveRemoteGitParams, ResetGitParams, ResetResult, SetTrackingBranchParams, TrackingBranch } from '../../core/interfaces/services/i-git-service.js';
+import type { AbortMergeGitParams, AddGitParams, AddRemoteGitParams, AheadBehind, BaseGitParams, BlobContents, ChangedFile, CheckoutGitParams, CloneGitParams, CommitGitParams, CreateBranchGitParams, DeleteBranchGitParams, FetchGitParams, GetAheadBehindParams, GetBlobContentParams, GetBlobContentsParams, GetRemoteUrlGitParams, GetTrackingBranchParams, GitBranch, GitCommit, GitConflict, GitRemote, GitStatus, IGitService, InitGitParams, ListBranchesGitParams, ListChangedFilesParams, LogGitParams, MergeGitParams, MergeResult, PullGitParams, PullResult, PushGitParams, PushResult, RemoveRemoteGitParams, ResetGitParams, ResetResult, SetTrackingBranchParams, TextBlob, TrackingBranch } from '../../core/interfaces/services/i-git-service.js';
 import type { IAuthStateStore } from '../../core/interfaces/state/i-auth-state-store.js';
 export declare class IsomorphicGitService implements IGitService {
     private readonly authStateStore;
@@ -21,7 +21,9 @@ export declare class IsomorphicGitService implements IGitService {
     getCurrentBranch(params: BaseGitParams): Promise<string | undefined>;
     getFilesWithConflictMarkers(params: BaseGitParams): Promise<string[]>;
     getRemoteUrl(params: GetRemoteUrlGitParams): Promise<string | undefined>;
+    getTextBlob(params: GetBlobContentParams): Promise<TextBlob | undefined>;
     getTrackingBranch(params: GetTrackingBranchParams): Promise<TrackingBranch | undefined>;
+    hashBlob(content: Buffer): Promise<string>;
     init(params: InitGitParams): Promise<void>;
     isAncestor(params: BaseGitParams & {
         ancestor: string;
@@ -30,6 +32,7 @@ export declare class IsomorphicGitService implements IGitService {
     isEmptyRepository(params: BaseGitParams): Promise<boolean>;
     isInitialized(params: BaseGitParams): Promise<boolean>;
     listBranches(params: ListBranchesGitParams): Promise<GitBranch[]>;
+    listChangedFiles(params: ListChangedFilesParams): Promise<ChangedFile[]>;
     listRemotes(params: BaseGitParams): Promise<GitRemote[]>;
     log(params: LogGitParams): Promise<GitCommit[]>;
     merge(params: MergeGitParams): Promise<MergeResult>;
@@ -40,7 +43,11 @@ export declare class IsomorphicGitService implements IGitService {
     setTrackingBranch(params: SetTrackingBranchParams): Promise<void>;
     status(params: BaseGitParams): Promise<GitStatus>;
     private buildBasicAuthHeaders;
+    private classifyRefVsWorkdir;
+    private classifyStagedRow;
+    private classifyUnstagedRow;
     private conflictsFromError;
+    private describeSide;
     private getAuthor;
     private getOnAuth;
     private getOnAuthFailure;
@@ -51,6 +58,10 @@ export declare class IsomorphicGitService implements IGitService {
      * to match native git behavior.
      */
     private guardStagedConflicts;
+    private hashWorkdirFile;
+    private isCommitishSide;
+    private listChangedBetweenCommits;
+    private listChangedFromMatrix;
     /**
      * Manual merge for unrelated histories (no common ancestor).
      * isomorphic-git throws MergeNotSupportedError because it can't handle
@@ -59,6 +70,12 @@ export declare class IsomorphicGitService implements IGitService {
     private mergeUnrelatedHistories;
     private parseMatrix;
     private readBlobOid;
+    /**
+     * Reads the raw blob bytes + full oid at the given ref in a single pass.
+     * Returns `undefined` when the blob is absent (path missing, ref unresolved, etc.).
+     * Used by {@link getTextBlob}; callers downstream decide binary vs text.
+     */
+    private readRawBlob;
     private requireDirectory;
     private requireToken;
     /**
@@ -71,6 +88,12 @@ export declare class IsomorphicGitService implements IGitService {
      * Falls back to git.resolveRef for plain refs.
      */
     private resolveRefExpression;
+    /**
+     * Resolve a single ref (branch name, tag, full SHA, or short SHA).
+     * Falls back to `git.expandOid` for short SHAs since `git.resolveRef`
+     * only accepts full OIDs and symbolic refs.
+     */
+    private resolveSingleRef;
     /**
      * Fixes conflict markers written by isomorphic-git to match native git:
      * 1. Replaces `<<<<<<< <branchName>` with `<<<<<<< HEAD`