A fake Poster that records calls and simulates outcomes. - ``post_note``/``post_discussion`` pop configured outcomes; when outcomes run out

A fake urllib response object.

A single invocation owns this handle, including cancellation before process registration. */

A post() that records discussions; optionally fails the first inline.

ReasoningPayload is the openai-chat-completions NativeTurn payload. Named type so a type assertion can't accidentally match an unrelated string.

[status] 保持 String 类型：CLI 的取值域（success / completed_with_errors / completed_with_warnings / skipped）由 CLI 决定，出现新增取值不应导致解析失败。 */

* 所有子进程必经 [ShellEnv]：环境取登录 shell 的、命令名由 `resolveBin` 解析为绝对路径。 * 裸命令名加继承环境在 GUI 启动的 IDEA 中无法运行。本类方法均为阻塞调用，调用方须在后台线程执行。 */

* 装订线图标，点击展开/收起内嵌面板。 * 不跳转到该行：图标就在该行旁边，已可见无需再跳。 * 跨位置导航走侧栏卡片「查看」按钮 → jumpTo。 */

* `startLine` / `endLine` 取 0 作为哨兵值，表示 CLI 未提供可用行号。 * 评论定位逻辑（CommentAnchor）依据此约定进入 existingCode 重定位分支，不可改为 1。 */

* 一条评论在 diff 里的落点，CommentService.decorateDiff 的输入。 * startLine/endLine 均为 1-based 闭区间。 */

Effort selects a review effort preset that controls how much work the review agent performs (e.g., number of review rounds).

* 装配双向消息桥的 JCEF 页面。侧栏与配置面板共用同一实现。 * * 消息桥两个方向：页面→宿主 `window.__ocrPost(json)`；宿主→页面 `window.__ocrReceive(msg)`。 */

Stands in for make_poster(); replays canned outcomes per call.

审查完成后评论的挂载上下文，字段取自 [CliRunOptions]（对应前端的字段子集）。 */

TaskType mirrors session.TaskType.

单条 webview 通道。由 JCEF 侧实现此接口，路由层仅负责将 JSON 字符串交付其发送。 */

AttemptOutcome is the per-attempt result.

BatchStrategy enumerates the grouping policies for scan dispatch.

CLI 以非 0 退出时抛出，message 已经过 [extractCliError] 提炼，可直接展示给用户。 */

Raised when the CodeUp OpenAPI call fails.

* 评论挂载与操作。三级定位回退（行号可用 → existingCode 滑窗重定位 → 仅侧栏） * 见 [resolveCommentAnchor]。 * * workspace 模式：RangeHighlighter 本身是 RangeMarker，文档编辑后 offset 自行调整，

[sha] 采用 7 位短哈希，与前端截取规则一致。 */

* 配置面板的消息路由，按消息类型分派处理。 * * 两个关键行为，变更前需确认： * 1. 处理逻辑都包在 try/catch 里，异常统一转 `panelError` 发回前端（前端有专门错误条渲染；只写日志用户看到的是"点了保存无响应"）。 * 2. 每次写配置后 `notifyCon

* 读写 `~/.opencodereview/config.json`。分工： * 写单个键走 CLI（`ocr config set`），因 CLI 自带校验和规范化；只有"删除自定义 provider"直接改文件——CLI 无对应 unset 子命令。 */

A Poster that prints instead of touching the network.

ErrorClass is the attempt-level error classification. It is derived only from the HTTP status and the Go error type — never from error message text —

FailureClass is the typed classification attached to every failed coverage item. The set is fixed so downstream consumers can switch on it reliably. F

FailurePhase records where in the request lifecycle the failure surfaced.

A single file's section of a unified diff.

Transport object encapsulating all GitLab REST operations. Discussions are posted through :meth:`post_discussion`, which owns an idempotency-

* 直接调用命令行 git。所有 git 调用强制加 `-c core.quotepath=false`。 */

GroupingStrategy is how a change set gets partitioned into review groups.

One @@ ... @@ block of a unified diff.

* 配置面板的窗口实现，使用非模态对话框：可与编辑器并排查看、可拖动缩放、关闭即释放。 */

* 侧栏的 JCEF 宿主：创建 webview、装配消息桥、投递宿主消息。消息分发交由路由层处理。 * attach/detach 走侧栏专用入口：JCEF 回调仅提供字符串、不含来源标识， * 通道身份须由本层显式提供，否则配置面板消息会串入侧栏。 */

Raised when the ocr CLI fails to run or produce usable output.

Outcome is the request-level result of a logical request. It is decided once, at Finalize, from the whole attempt sequence plus the logical request's

* 一次审查对应一个 session，状态仅在 session 内（`cancelled` 标记）， * 不做跨 session 持久化——webview 重建后由前端重新请求。[run] 为阻塞调用，调用方须在后台线程执行。 */

RunFailureClass classifies why the whole run stopped. It is a distinct enumeration from the per-item FailureClass: a run never fails with "provider" o

* 侧栏消息路由：接收前端 webview 在工作区审查流程中发来的全部消息并分发处理。 * * 本类处理的消息类型见 [WebviewToHost]；配置面板的消息由 [ConfigPanelRouter] 处理， * 两者各自只处理归属自身通道的消息类型。 * * 线程约定：凡涉及 g

TerminalState is the single, coverage-derived outcome of a run. It is the authoritative replacement for the warning-derived "completed_with_errors" st

Agent orchestrates full-file code review. It delegates the per-file LLM tool-use loop to llmloop.Runner and owns only scan-specific concerns (file enu

Agent orchestrates the AI-powered code review. LLM tool-use loop / memory compression / token aggregation now live in internal/llmloop.Runner; this st

AgentWarning describes a non-fatal warning recorded during one subtask's review/scan. The name is kept for backwards compatibility with the previous i

--- AnthropicClient --- AnthropicClient implements the Anthropic Messages API using the official SDK.

Args bundles all dependencies needed for one scan session. Note: Template is the scan-specific template.ScanTemplate (loaded from scan_template.json)

Args holds all dependencies and configuration needed to run a review session.

AttemptRecord is one observed real HTTP attempt. Number, Outcome, DurationToHeadersMS and ObservedBackoffMS are assigned by the collector; values pas

BuiltinToolProvider implements tools that don't require external system access.

CategoryCount holds counts for each review comment category.

ChatMessage represents a single message in a conversation.

ChatMessage represents a single message in a conversation.

ChatRequest represents the payload for a chat completion call.

ChatResponse is the parsed result of a completion request.

Choice holds a single choice from the response.