ParseComments extracts LlmComment entries from tool call arguments without writing to the Collector. Returns parsed comments and an error message (emp

ParseHunks parses raw unified diff text for a single file into a slice of Hunks. Lines before the first @@ header (file-level headers like "diff --git

PrintTraceSummary prints a one-line summary of the review to stdout. If SessionID is non-empty, an "[ocr] Session: <id>" line follows the summary.

ReLocateComment calls the LLM to regenerate a precise existing_code snippet when text-based matching fails, then retries ResolveComment with the new s

RecordReviewItemReused records that this run reused a checkpoint from another session.

ResolveComment attempts to resolve StartLine/EndLine for a single comment by matching ExistingCode against the diff. Returns true on success.

ReviseLastAttempt rewrites the last attempt of m as an error. It is the client-boundary correction for what the observer cannot see: an error surfaci

SetFinalManifest stores the frozen manifest the agent produced. It is embedded into session_end by Finalize and returned to the CLI via FinalManifest.

String renders a one-line human-readable estimate, matching scan.Estimate's format so diff and scan warnings read consistently. Money is intentionally

StripMarkdownFences removes ```json and ``` wrappers some models add around structured outputs. Exposed so callers (e.g. agent's review-filter post-st

applyCLIExcludes appends user-supplied --exclude patterns (already split into a []string) onto cc.FileFilter.Exclude. Creates the FileFilter if none w

extractSideLines extracts one side of the diff from a hunk. When newSide is true, returns context+added lines with new-file line numbers. When newSide

groupBatches partitions items according to strategy, then slices each natural group into BatchSize-sized chunks (when size > 0). Within a batch the in

initBareRepo creates an empty (unborn) git repository with identity configured but no commits, returning the repo dir.

initRepoWithChange creates a real git repository with one committed file and an uncommitted working-tree modification, returning the repo dir. There i

looksLikeFilePath returns true when s is likely a file path (not inline content). Heuristic: multi-line text is always inline; single-line text withou

metaFactory builds the same closure internal/agent injects, so these tests exercise the review wiring rather than a test-only shape.

newCustomModelTUI builds a modelTUIModel backed by a custom provider with a writable config path, so add/delete/persist operations exercise the save p

newOpenAITestServer returns an httptest server that captures each request's headers and JSON body and responds with a minimal valid chat completion.

parseBpeData parses the base64-encoded BPE data format. Each line: <base64-token> <rank>

runConfig provides test compatibility: dispatches config subcommands through a fresh cobra command tree that mirrors the production config command, so

运行任意参数，流式回调日志，结束返回 stdout 全文。退出码非 0 时 reject，并带上 CLI 报错文本。

seedParentManifest gives a hand-built ResumeState the parent manifest a real resume always has, matching the identity a already resolved. Without one

tryApplyPendingCompression checks whether a background compression has completed and swaps the rebuilt messages into place. Returns true if applied.

--- helpers ---

unwritableConfigPath returns a config path that is itself a directory, so any saveConfig / loadOrCreateConfig against it fails. This is the lever used

AsDiff returns a Diff suitable for handing to code that expects the diff-based shape (line-number resolver, file_read_diff tool). The Diff field stays

BudgetExceeded reports whether the aggregate token budget gate stopped the run before all files were reviewed. It is a diagnostic signal only — it fee

CollectToolDefs gathers tool definitions from MCP clients, filtering out tools that conflict with built-in tools or were not successfully registered.

ContextWithTraceParentFromEnv extracts W3C traceparent from the TRACEPARENT environment variable and returns a context carrying the upstream span cont

CountMessagesTokens returns the rough token count of msgs by summing the per-message text token count. Exported because both review and scan top layer

Frozen reports whether Finalize has already run.

Init initializes global TracerProvider and MeterProvider based on environment variables and optional config file. Returns true when enabled. Safe to c

ListSessions enumerates all persisted sessions for the given repository directory, sorted by StartTime descending (most recent first). Missing directo

Load parses the tools config file. When path is empty, falls back to the embedded default tools configuration.

LoadAppConfig loads config from path. Returns nil, nil if file does not exist.

NewSessionKey returns a fresh UUIDv4 session key. Clients use it as a per-client fallback for requests whose context carries no session key (e.g. `ocr

RecordWarning adds a non-fatal warning.

RelocateAcrossFiles handles the comment whose ExistingCode belongs to a different file than the one it was filed against. The reviewing Agent reads r

ReplaceSince replaces comments[start:] with the given replacements. Useful for batch-level dedup: take a Snapshot, run a batch, dedup the new comments

Run executes a git command and returns the combined stdout+stderr output.

SessionKeyFromContext returns the session key carried by ctx, or "" when none was set.

SessionsDir returns the on-disk directory that holds JSONL session files for a given repository. It does not create the directory.

SetExecution sets the non-secret execution provenance.

SetRepository sets the redacted repository identity.

StartLLMSpan creates a span for an LLM request with standard attributes.

Submit runs f in a background goroutine bounded by the semaphore. When f completes its return value is collected internally.

TotalInputTokens returns the accumulated input/prompt tokens from all LLM calls.

TraceIDFromContext returns the hex-encoded trace ID of the span carried by ctx, or "" if ctx carries no valid span (e.g. telemetry is disabled).

ValidateResume reports whether req may reuse this parent's checkpoints. A mismatch on any input field rejects the whole resume rather than degrading

WithRequestMeta attaches m to ctx so the retry observer can associate every HTTP attempt made under that context with one logical request. It is the o

applyDedupGroups parses the DEDUP_TASK output and returns the deduped comment slice. Returns (nil, false) when the response is malformed OR when the g

cancelPendingCompression aborts the conversation's in-flight background compression, if any.