maybeRunProjectSummary runs the post-batch PROJECT_SUMMARY_TASK over the union of all collected comments. Best-effort: any error / empty input no-temp

normalizeLine removes leading/trailing whitespace and strips any leading '+' or '-' diff marker.

partitionMessages divides messages into frozen, compress, and active zones. Frozen zone is always messages[0:2]. Active zone preserves the K most rece

resolveRepoDir resolves the repo dir for `ocr rules check`. It delegates to resolveWorkingDir(requireGit=true) so it anchors at the git top-level just

resolveWorkingDirForSession accepts an explicit --repo flag value and falls back to the current working directory. Unlike resolveRepoDir it does not r

resolvedModel returns the model to persist, falling back to the in-session pick for the provider being finalized when result.model is empty.

transition moves a selected item to a terminal state through the single coverage entry point. Unknown item_id, an invalid failed classification, an em

valid reports whether c is one of the fixed item failure classes.

validateTimeoutSec converts a config-file timeout (in seconds) to time.Duration. Returns 0 for zero input (use default). Rejects negative values and o

writeCommit writes content to name, stages it, and commits with msg.

CallTool invokes a tool on the MCP server and returns the text result.

CompletionsWithCtx sends a Responses API request and maps the result back to the shared ChatResponse shape.

ComputeLineDiff returns a line-level diff between oldLines and newLines. Uses Myers-style LCS to find common subsequences, then emits context/added/de

ContentLogging returns true when content logging is enabled via OCR_CONTENT_LOGGING.

DisplayAddr rewrites a wildcard listen address (empty host, 0.0.0.0, or ::) to a localhost form so printed URLs are always openable in a browser. Non-

Frozen reports whether Finalize has already run.

Get returns the diff text for path.

HasPersistence reports whether this session has a JSONL writer. A false value means no resumable session file exists, even though the run still has it

ListSessions returns lightweight summaries for all sessions in a repo subdir.

MergeBase returns the computed merge-base commit hash for range mode.

NewClient starts an MCP server subprocess (stdio transport), initializes the connection, and caches the list of available tools. The context governs t

NewRemoteClient connects to a remote MCP server via Streamable HTTP transport. Header values may contain $ENV_VAR references which are expanded at run

NewToolCallMessage creates an assistant message with text content and tool invocations.

Of returns a checkpoint with data.

PrintToolCallStarted prints a line when a tool begins execution. Args are summarized as key-value pairs (path, search terms, etc.). Example: [ocr] ▶

RemoveByPathAndIndices removes comments for a given path whose per-path index (0-based position among all comments with that path) is in the indices s

Resolve returns the rule text for a given file path. Patterns with brace expansion like "*.{go,py}" are expanded into "*.go", "*.py". The first match

ResolveConfig builds the final Config by merging defaults, JSON config, and env vars. Precedence: defaults < config.json < environment variables.

ResumeInfo returns resume metadata for output. Nil means this was not a resume run.

SessionID returns the persisted session identifier so callers can show it in JSON output or failure diagnostics. Returns "" when no session was create

SetDiffMap replaces the diff snapshot. Must be called before concurrent access begins.

ShutdownWithTimeout creates a timeout context and calls Shutdown.

Snapshot returns the current count of stored comments. Pair with Since / ReplaceSince to operate on the comments added between two points in time (e.g

SubmitFor is Submit plus registration under key, so AwaitKey can wait for exactly the units submitted under that key instead of the whole pool. Calle

TotalOutputTokens returns the accumulated completion tokens from all LLM calls.

TotalTokensUsed / TotalInputTokens / ... delegate to the underlying runner.

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).

budgetAgentTestTemplate returns a minimal template sufficient to drive dispatchSubtasks without plan/dedup/summary phases.

captureStderr captures everything written to os.Stderr during fn. Mirrors captureStdout; used to assert structured usage emitted on the failure path.

cloned returns a copy of the manifest whose coverage slices are owned copies, so every Finalize caller gets an independent, non-aliased snapshot. The

cpProtocolIndex maps a protocol string (canonical name or legacy alias) to its index in cpProtocols. Unknown / empty values default to the OpenAI Chat

deleteCustomProvider removes a custom provider from cfg in memory. Returns true if the deleted provider was the active one.

emptySHA256 is the canonical digest of an empty input, which hashFields must return for an empty field sequence.

excludeToolDef returns a copy of defs with any entries whose function name matches name removed. Used by `ocr scan` to hide tools that don't make sens

executePlanPhase runs the plan task for a single file, sending template messages with resolved placeholders and collecting the LLM response as plan gu

executeToolCall dispatches a single tool call from the LLM response and records the result in session history. code_comment handling includes optional

firstLine returns the first non-empty trimmed line of git output, so a stray trailing newline or an unexpected second line never pollutes a resolved S