maybeRunPlan invokes PLAN_TASK on the file and returns a human-readable guidance string suitable for {{plan_guidance}} substitution. Returns "(no pre-

mustGetResult extracts the first result from a SARIF document, failing the test if the structure is wrong.

newCompressionRunner returns a Runner whose template forces runCompression to issue a request, plus the message slice to feed it.

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

The four blind spots share one shape: the observer sees HTTP 200, the failure surfaces afterwards, and nothing downstream would notice the omission —

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

reloadConfigAfterSaveFailure reloads on-disk config and refreshes derived provider TUI state so the UI matches persisted data after a failed save. Ret

reloadConfigAfterSaveFailure reloads on-disk config so in-memory state matches persisted data after a failed save. Returns false when reload could not

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.

reviseAttempt applies a client-boundary correction to the last attempt of the logical request identified by ctx. Requests without identity (scan, llm

ruleConfigSHA256 is the deterministic identity of the resolved rule configuration this run operates with: the resolver's effective rule-text layers (c

sarifInvocationFromRun builds the run.invocations entry from the manifest's terminal state and any warnings collected during the review. executionSuc

sarifResultFromComment maps a single LlmComment to a SARIF result. Field mapping follows FR-3 in the requirements spec: - Path → locations[].

sourceArtifactSHA256 is the deterministic content identity of this run's selected input: for every non-deleted diff (the same set registerCoverage sea

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

triggerAsyncCompression kicks off a background compression job for the conversation owning st. A no-op when a job is already pending — the check-and-s

valid reports whether c is one of the fixed attempt error classes.

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.

CollectPendingComments awaits any async comment-processing workers and returns the aggregated comments from the collector. Safe to call once per sessi

CompletionsWithCtx sends a Responses API request and maps the result back to the shared ChatResponse shape. The deferred finalizeRequest is this clie

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-

FinalManifest returns the frozen manifest stored for this run, or nil when the run produced none (legacy/scan, or a construction failure).

Get returns the diff text for path.

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

NewCommentWorkerPool delegates to llmloop.NewCommentWorkerPool.

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

Of returns a checkpoint with data.

ParseRetryCodes parses a comma-separated list of HTTP status codes that should trigger retry. Non-4xx codes return an error; SDK-default codes (408, 4

ParseReviewMode returns the correct ReviewMode based on provided flag values.

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

Quiet replaces stdout with io.Discard and returns a cleanup function. Usage: defer stdout.Quiet()() WARNING: Quiet must ONLY be called from the mai

RecordResumeLineage persists the run's single resume_lineage event. A nil lineage is a non-resumed run and writes nothing.

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.

ReusableItem returns the checkpoint for fingerprint only if the parent manifest also recorded that fingerprint as completed or reused. The manifest i

Session returns the session history associated with this Agent.

SessionID returns the current review's resumable session ID. It returns an empty string when the session file could not be created, so callers do not

SessionsRoot returns the root directory where session JSONL files are stored.

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.

WaitBackground blocks until every background job started by this Runner has returned. Background memory compression is the only such job, and cancelPe

Read with proactive pacing, mirroring the GitHub Action's readWithPacing. Reads are cheaper than writes but still consume the primary rate li