newJSONLWriter creates and opens a new JSONL writer for the given session.

newStdoutMetricExporter creates a console metric exporter with pretty-print output.

newStdoutTraceExporter creates a console trace exporter with pretty-print output.

parseBatchStrategy normalizes a user-supplied strategy string. Unknown or empty values fall back to BatchNone (safe v1 behavior).

parseFilterResponse extracts comment indices from the LLM filter response. Returns a set of 0-based indices. Invalid IDs or out-of-range indices are i

parseTimeoutEnv reads and validates the OCR_LLM_TIMEOUT environment variable. Returns the parsed duration and true if set, or 0 and false if unset/emp

printDiffLine renders a single diff line with colored prefix and background on content.

probePathIndex is like probePath but also returns the index of the matched path.

工作区模式仅刷新变更文件，不等待 VS Code Git 扩展，也不拉分支/提交历史。

registerReviewFlags registers all review command flags on cmd, binding to opts.

registerScanFlags registers all scan command flags on cmd, binding to opts.

renderMessages substitutes placeholders in the scan template's MainTask for a single scan item. planGuidance is the output of maybeRunPlan and gets su

通过 git rev-parse 解析仓库根，避免等待 VS Code Git 扩展初始化。

requireGitRepo validates that the given directory is part of a git repository.

resolveEnv reads environment variables to override defaults. Environment takes highest priority.

resolveFromFileContent scans the new file content line-by-line for consecutive matches of the normalized existing_code.

resolveFromHunk tries to find startLine/endLine by matching ExistingCode against hunk lines. It tries the new-side first (context + added lines → new-

resolveSystemRule returns the rule text for a given file path, matching against PathRuleMap glob patterns, falling back to DefaultRule.

resolveWorkingDirForSession accepts an explicit --repo flag value and falls back to the current working directory. Unlike resolveRepoDir it does not r

runeWrapCut returns a rune index suitable for breaking the line at ~maxW display width.

savedSecretFingerprint returns a short fingerprint for display, e.g. "sk-a1b2...wxyz" (first 6 + "..." + last 4). Returns "" when the trimmed secret i

* 选出与 workspace 匹配的仓库。嵌套仓库场景下 repositories 顺序不稳定, * 不能直接取 [0],否则会漂移到子仓库。

severityColor maps a finding severity to an ANSI color used for its badge. Unknown or empty severities fall back to dim.

* Strip YAML frontmatter from markdown content

stripMarkdownFences is the package-private workhorse used by the internal compression code paths.

summarizeArgs extracts a concise key=value summary from tool arguments for console display. It picks the most human-readable fields depending on the a

--- Validation functions ---