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.

enforceGroupTokenBudget splits groups whose combined diffs exceed the token limit.

enforceMaxFilesPerGroup splits groups that exceed maxFilesPerGroup into smaller chunks.

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

freshOCRHome points the OCR home at a temp dir so a test can assert on what a command wrote there. It also neutralizes global git config: git resolves

单次提交：该 commit 相对父提交的改动文件。

groupIntoRounds parses messages[start:] into logical (assistant + tool_results) pairs.

initOTLPHTTPProviders sets up OTLP HTTP exporters for traces and metrics. Unlike the gRPC path this uses WithEndpointURL rather than WithEndpoint, so

initOTLPProviders dispatches to the gRPC or HTTP exporter based on cfg.OTLPProtocol.

isErrorStatus reports whether an observed HTTP status proves the attempt failed on its own. Status 0 means no response was received, so it proves noth

isPathExcluded returns true when the given relative file path should be skipped based on hardcoded dir rules or .gitignore patterns. Patterns are res

loadGitignorePatterns reads and parses .gitignore patterns from the repo root.

loadObjCRule reads the embedded Objective-C rule doc used by the ".m" content sniff. It is not referenced from system_rules.json's path_rule_map, so i

makeBudgetDiffs returns n small, non-deleted diffs that survive filterDiffs and filterLargeDiffs.

manifestMode maps the review to the manifest input mode. It derives purely from From/To/Commit so the value is always one of the three valid input mod

mergeBase computes the merge-base for range mode. Returns "" for other modes.

newRequestMeta builds the retry-report identity for one logical LLM request. It is the single place provider and model are read for that purpose — th

normalizePath canonicalizes a path for identity derivation: it unifies separators to forward slashes and cleans redundant "." / ".." / duplicate separ

officialAPIKeyRequiredError mirrors the wording applyOfficialProviderConfig uses for the same failure, so the interactive and non-interactive paths na

outputPreview renders a preview in the requested output format. sarif is rejected with an error because a preview contains file/rule metadata, not rev

positionalSignature extracts the positional-argument part of cmd.Use, e.g. "<key> <value>" from "set <key> <value>" and "<path...>" from "rule [flags]

preview is read-only with respect to the Agent: it does not mutate a.items. (Earlier versions did, which made a subsequent Run on the same Agent silen

printDiffLine renders a single diff line with colored prefix and background on content. With color disabled it emits "<prefix> <content>", which keeps

printWizardCancelled prints the standard Esc-cancel message for config wizards. changesDescription is a short noun phrase, e.g. "Configuration changes

readJSONLLines visits each physical JSONL record without bufio.Scanner's fixed token ceiling. session_end embeds the complete run manifest and can leg

request is a resume of parentState with the same provider and model, which is the accepted baseline every case below deviates from.

resolveAllowedHostsFromEnv reads the OCR_VIEWER_ALLOWED_HOSTS environment variable and combines it with the bind host to produce the active allowlist.

resolveConfigPath returns OCR_CONFIG_PATH when set, otherwise the default user config path. Intentionally used only by read-only commands (e.g. ocr ll

resolveIn builds a real resolver for dir/ref and resolves path.

resolveLang returns the resolved language name for the instruction.

resolveMaxTokens applies the per-run CLI override, then the saved setting, and finally the embedded task-template default.

retryAttemptChain renders one logical request as a short human-readable chain.

runIdentity reads the identity off the agent's current selection. It is only meaningful once the selection is final: sourceArtifactSHA256 hashes what

runReview provides test compatibility for the pre-cobra runReview(args) entry point: parse flags, then execute the review.