LoadSummary loads a single session's Summary. Errors when the session file is missing or unreadable.

MatchGitignorePattern reports whether relPath matches a single gitignore-style pattern, using the simplified semantics that diff.Provider already impl

Session returns the session history associated with this Agent.

Session returns the session history associated with this Agent.

SessionID returns the current scan's session id, or "" when no session has been created.

SessionsDir returns the on-disk directory that holds JSONL session files for a given repository. It does not create the directory.

ToolCalls returns a snapshot of the per-tool call counts.

TotalCacheReadTokens returns the accumulated cache read tokens.

TotalCacheWriteTokens returns the accumulated cache write tokens.

TotalTokensUsed returns input + output.

Validate checks that a ScanTemplate has the minimum fields populated.

Warnings returns the warnings recorded by the LLM runner.

Warnings returns a copy of the accumulated warnings.

WriteLLMError writes an llm_error entry recording a failed LLM request.

WriteLLMRequest writes a request entry with the resolved messages.

WriteLLMResponse writes a response entry with model, content, tool calls, usage.

WriteReviewItemDone writes a file-level resume checkpoint for a completed diff.

WriteReviewItemFailed writes a file-level checkpoint for a failed diff.

WriteReviewItemReused writes a checkpoint reused from a previous session.

WriteSessionEnd writes the final session_end summary record and closes the file.

WriteToolCall writes a tool call result entry.

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.

batchKeyFunc returns the grouping key extractor for a strategy.

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

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.

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