buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

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

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

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

---- Internal helpers ----

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.

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

空侧占位（等同 /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

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.

Rebuild a ReviewInput with all inline comments folded into the summary. Used when Gerrit rejects the batch (HTTP 400, e.g. a line outside the

Render one inline comment body (same shape as gitflic's format_comment). The Severity/Category header line exists because Gerrit's CommentInput h

Render an inline discussion body.

Render a comment for the fallback (non-inline) note.