FormatDuration returns a human-readable duration string for console output.

GroupRules groups the given file paths by their resolved rule content. Files are placed in the same group only when their source, matched pattern, and

HomeConfigPath returns the default path to ~/.opencodereview/config.json.

initEmbeddedLoader configures tiktoken to use embedded BPE data instead of fetching from network. Call this once during application startup, before an

IsKnown reports whether the tool is not UNKNOWN.

IsTransition reports whether the resume changed provider or model, which is the condition that required an explicit flag to be accepted.

ItemID is the single, canonical derivation of a manifest item_id. It is content-independent: it is derived from the operation, the input mode and the

LLMFailures returns the total number of LLM request failures recorded during this session.

LoadDefault parses the embedded task.json and returns the TEST_TASK conversation.

LoadFromJSON merges telemetry settings from a JSON config file if present. This has lower priority than environment variables.

Name returns the tool's identifier name.

NewAnthropicBedrockClient creates a client for Anthropic models served by AWS Bedrock. The wire format is the Messages API, so this reuses AnthropicC

NewToolResultMessage creates a tool-role message with the given result. Uses the OpenAI Chat Completions format: role="tool" with tool_call_id and pla

PhaseEvent records a review phase completion with duration and optional error.

PlanRequired reports whether a group warrants the plan phase based on its churn profile. Two thresholds cooperate: PlanModeLineThreshold gates on the

Preset returns the knob set for e.

Preview loads diffs and applies the filter algorithm, returning structured preview data without dispatching any LLM calls. It builds none of the revi

PrintToolCallError prints a line when a tool fails. Example: [ocr] ✘ file_read "internal/config/rules/loader.go" failed: permission denied

PrintToolCallFinished prints a line when a tool finishes successfully. Example: [ocr] ✔ file_read "internal/config/rules/loader.go" (12ms)

ProjectSummary returns the markdown project-level summary produced after all batches finish. Empty when SkipSummary is set, PROJECT_SUMMARY_TASK is ab

ReasoningContent extracts the reasoning content of the first choice, if any.

RefValue returns the git ref that should be used for reading file contents in range or commit mode. Returns ("", false) for workspace mode.

RemoteIdentity returns a stable, credential-free identity string for the repository's "origin" remote, suitable for hashing into the run manifest's re

ReviewRounds returns the effective per-group round count, never below 1.

RuleGroupsMarkdown renders rule groups into a markdown section.

RunManifest returns the immutable coverage snapshot produced for this review, or nil when manifest construction failed. The scan path deliberately ret

Sealed reports whether the selected set has been sealed.

StartToolSpan creates a span for a tool execution with standard attributes.

Stream acquires the semaphore, starts a git command, and passes its stdout as an io.Reader to consume. The semaphore is held for the full duration. co

ToolCalls extracts tool calls from the first choice.

ToolDefsByPhase returns the parsed tool definitions filtered by phase. planOnly=true returns only tools with plan_task:true. planOnly=false returns on

Warnings returns the warnings recorded by the LLM runner.

WriteSessionStart writes the initial session_start record.

Single GitLab API attempt. Returns a rich result dict (no retry).

Make a GitLab API request with retry on rate-limit and transient errors. Used for reads and note writes (discussions go through the idempotency-a

Compute a retry delay (seconds) for a failed attempt, or None if not retryable. Order: Retry-After header -> wait-until-reset (primary limit exha

Return the first present, non-empty field among several possible key names.

Case-insensitive header lookup.

Collapse whitespace and cap length so log lines stay readable.

addColorFlags registers the color control. It is persistent on the root command so every subcommand inherits identical behavior, and so `ocr --color=n

addNextMessage extends the conversation with the assistant message and tool responses, applying three-zone compression at the soft (60%) and warning (

addOutputPathFlag registers --output/-o: write results to a UTF-8 file instead of stdout. "" or "-" keeps stdout; a real path is created lazily on the

apiKeyCmdForStep returns the api_key_cmd already configured for the provider the API-key step is editing, reading the same config entry loadExistingAP

applyLanguage appends instruction to all system-role messages in conv.

attemptCounts snapshots the per-file real HTTP attempt counts.

beginManualTokenReplace is the manual-tab equivalent of beginAPIKeyReplace.

buildBadge renders a compact "[category · severity]" tag for a finding. It returns an empty string when neither structured field is present, so text o

buildChangeFilesExceptGroup returns a formatted list of changed files excluding all group members.

buildDedupCommentsJSON renders the batch comments as a JSON list with stable c-N ids that the LLM groups by. Only fields the LLM needs to judge simila

buildGroupFilterCommentsJSON serializes comments with path info for group-level filtering.

buildMessageXML serializes msgs into the <message><content> form expected by the MEMORY_COMPRESSION_TASK prompt template.

buildSummaryCommentsList renders comments as a compact path-anchored markdown list suitable for embedding in the PROJECT_SUMMARY_TASK prompt. Format:

Build the ``[category · severity]`` badge (middot U+00B7). Byte-matches the CLI's buildBadge degeneration so review output is consistent acro

canonicalRemote reduces a git remote URL to a stable, credential-free identity string for hashing into repository.identity_sha256, so the same reposit

checkAPIKeyRequirement decides whether a provider selection may be saved with no api_key. It mirrors the resolver's precedence (static api_key -> api_

checkMetricErr intentionally ignores metric registration errors: telemetry is best-effort and must not interrupt the main flow.

classifyBoundaryError classifies an error that only surfaced after the SDK retry loop finished, and reports whether it recognized it at all. The fals

classifyItemError maps a subtask error to a stable item failure class and a safe, generic reason. It never returns the raw error text (which may embed

classifyMainLoopStop maps a non-error, non-completed main-loop stop to an item failure class and a safe reason. Only the configured max-tool-request b