CanonicalPath returns an absolute path with symlinks resolved.

CommentsForPath returns a copy of comments whose Path matches the given path.

CompletionsWithCtx sends a chat completion request with context support.

Dynamic creates a Tool with the given name for dynamically discovered tools (e.g. MCP).

Enumerate returns one ScanItem per reviewable file. Binaries are emitted with empty Content + IsBinary=true so previews can show them as excluded.

IsPathExcluded returns true when relPath matches any of the supplied gitignore-style patterns or any default excluded directory prefix (see ExcludedDi

IsUserExcluded reports whether the given path matches any user exclude pattern.

--- Factory --- NewLLMClient creates the appropriate client based on the resolved endpoint protocol. protocol dispatch (canonical names from protocol.

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

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

executeReviewFilter runs the REVIEW_FILTER_TASK to remove comments that are provably incorrect based solely on the diff. Errors are logged and silentl

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

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

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

runConfig provides test compatibility: dispatches config subcommands.

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

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

--- helpers ---

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

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

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

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

LoadDetail returns the summary plus per-file item records for one session.

LoadScanDefault parses the embedded scan_template.json.

NewCommitProvider creates a Provider for commit mode: show changes introduced by a single commit.

NewProvider creates a Provider for range mode: from..to (via merge-base).

Preview enumerates files and applies the standard reviewability filter without dispatching any LLM calls. Returns a *model.Preview ready for cmd/openc

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

RecordReviewItemFailed persists an incomplete file-level checkpoint.

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

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

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

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

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

buildAnthropicParams converts the shared ChatRequest into Anthropic SDK parameters.

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

dispatchSubtasks groups items into batches per the configured strategy, then processes batches sequentially while running files within each batch conc

ensureModelInList appends model to the end when missing; never reorders existing entries.

executeSubtask performs the Plan Phase + Main Loop for a single file.

extractFilenameFromURL returns the filename part (last path segment) of a URL pattern.

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

mergeBackground combines the inline --background value (or an auto-populated commit message) with the content read from --background-file, separated b