Build an `origin/<branch>` ref from a CODEUP_*_BRANCH env var, if set.

Normalize the top-level shape of ocr's JSON output to a list of comments.

Walk a hunk's lines tracking both counters until reaching new_line.

Safely parse a rate-limit response header as an int.

applyInputIdentity fills the manifest's frozen input identity and repository identity, then hands them to the builder through its single setters. It i

batchKeyFunc returns the grouping key extractor for a strategy.

构造评论挂载用的 diff 两侧 URI 与挂载 ref。

buildCoverageLocked assembles the five sorted, non-nil coverage sets from the current item map. Caller must hold b.mu.

buildFileFilter picks the highest-priority layer that has any include/exclude configured. Priority order: custom (--rule) > project > global.

buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

Build the config dict from environment variables (with defaults). ``env`` is typically ``os.environ``; tests pass a plain dict.

Join base URL (context path kept, trailing slash tolerated) and route.

Map `ocr review --format json` output to one Gerrit ReviewInput dict.

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

commitParents returns the parent commit SHAs of ref: zero for a root commit, one for an ordinary commit, and 2+ for a merge. It uses `rev-list --paren

computeActiveZoneSize returns how many trailing rounds fit within the remaining token budget after accounting for the frozen zone and the compressed s

---- Internal helpers ----

computeTerminal derives the terminal state from coverage plus run_failure. A run_failure forces failed while leaving the recorded outcomes intact. Aft

copyMessages returns a deep copy of a messages slice so that future mutations don't corrupt stored records.

copyMessagesForJSON produces a JSON-friendly slice for persistence.

coverageItem builds the selected-set entry for a diff: the content-independent item_id, the display path, the old path only on a rename, and the raw d

Derive the Gerrit base URL from a change URL. Modern URLs ({base}/c/{project}/+/{number}) split at "/c/", which keeps any context path; legac

detectGitBranch returns the current git branch name for the given repo, or empty string on failure.

dispatchBatch fans out the files of a single batch concurrently and blocks until they all finish (or ctx is cancelled). Returns the number of files di

emptyManifest is the well-formed, empty skipped manifest returned alongside an error from a nil-builder Finalize, so a mistaken nil receiver never pan

空侧占位（等同 /dev/null），用于新增/删除文件的单侧 diff。

ensureResponsesEndpoint normalizes cfg.URL to end with /responses. The trailing /responses is kept on cfg.URL (so tests and logs see the full endpoint

exactNTokens builds a string that llm.CountTokens reports as exactly n tokens, failing loudly if the tokenizer disagrees so fixture drift cannot silen

exactNTokens builds a string that llm.CountTokens reports as exactly n tokens, failing loudly if the tokenizer disagrees so fixture drift cannot silen

Fetch MR diff refs from the ``/versions`` endpoint. Returns a dict with ``base_sha``/``start_sha``/``head_sha`` on success, or ``None`` on fa

filterDiffs removes diffs whose file paths are excluded.

finalizeDiff reads the new file content. When ref is non-empty it uses git show to read the file at that ref; otherwise it reads from disk.

findDiff returns the Diff for the given file path, or nil if not found.