@deepseek-ai/dsh-experimental-client-ui-forge 0.2.2-alpha.2 → 0.2.2-alpha.3

package/lib/types/client/ReviewComposer.d.ts

@@ -0,0 +1,40 @@
+/** Plain-text comment editor for a frozen selection in either review tab. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ReviewQueue } from './review-queue.ts';
+import type { ReviewSelection, ReviewSource } from './review.ts';
+import type { NS } from './locales.ts';
+/** Actions supplied by the owning changes tab. */
+export interface ReviewActions {
+    /** The source currently displayed; selecting a range freezes it. */
+    readonly source: ReviewSource;
+    /** Browser records shared by the changes tab. */
+    readonly records?: ReviewQueue;
+    /** Whether another comment already started a pending review. */
+    readonly reviewStarted?: boolean;
+    /** Open the confirmed publication URL. */
+    readonly openLink?: (url: string) => void;
+    /** A write is running or its outcome still needs confirmation. */
+    readonly publishingBlocked?: boolean;
+    /** Append an atomic quote without sending the Agent a message. */
+    readonly addToInput: (selection: ReviewSelection) => boolean;
+    /** Retain a new comment after its quote was accepted. */
+    readonly onQuoted?: (selection: ReviewSelection) => void;
+    /** Publish one comment; an error string preserves the editor. */
+    readonly publish?: (selection: ReviewSelection) => Promise<string | undefined>;
+    /** Keep one comment for the final review; false preserves the editor. */
+    readonly queue?: (selection: ReviewSelection) => boolean;
+}
+/**
+ * Render the line range, plain-text editor, and explicitly named destinations.
+ * @param props - frozen selection, actions, cancellation, and localized copy.
+ * @returns the inline comment form.
+ */
+export declare function ReviewComposer({ selection, actions, close, visible, split, t }: PropsLocale<typeof NS> & {
+    readonly visible?: boolean;
+    readonly split?: boolean;
+    readonly selection: ReviewSelection;
+    readonly actions: ReviewActions;
+    readonly close: () => void;
+}): ReactNode;
+//# sourceMappingURL=ReviewComposer.d.ts.map

package/lib/types/client/ReviewThread.d.ts

@@ -0,0 +1,26 @@
+/** Inline comment records and editing of a pending review at its captured code location. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ReviewActions } from './ReviewComposer.tsx';
+import { type FileReviewState, type ReviewThread as Thread } from './review-queue.ts';
+import type { NS } from './locales.ts';
+/**
+ * Subscribe only to comments that belong to the displayed file and source.
+ * @param actions - review actions and their browser store.
+ * @param path - displayed file path.
+ * @returns stable file-scoped comments and write availability.
+ */
+export declare function useFileReview(actions: ReviewActions | undefined, path: string): FileReviewState;
+/**
+ * Render a saved comment at its line, with pending edits kept in the browser queue.
+ * @param props - record, edit availability, source actions, and localized copy.
+ * @returns one compact inline comment card.
+ */
+export declare function ReviewThread({ thread, actions, locked, outdated, split, t }: PropsLocale<typeof NS> & {
+    readonly thread: Thread;
+    readonly actions: ReviewActions;
+    readonly locked: boolean;
+    readonly outdated: boolean;
+    readonly split: boolean;
+}): ReactNode;
+//# sourceMappingURL=ReviewThread.d.ts.map

package/lib/types/client/SubmitReview.d.ts

@@ -0,0 +1,22 @@
+/** Centered review submission with a summary, decision, and pending-comment count. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ReviewQueue } from './review-queue.ts';
+import type { NS } from './locales.ts';
+/**
+ * Submit a review independently of the diff scroll position; comments remain at their code locations.
+ * @param props - durable queue, current head, submission outcome, and modal actions.
+ * @returns a portalled modal with keyboard focus ownership.
+ */
+export declare function SubmitReview({ queue, url, headSha, busy, error, submit, close, check, reconcile, t }: PropsLocale<typeof NS> & {
+    readonly queue: ReviewQueue;
+    readonly url: string;
+    readonly headSha: string;
+    readonly busy: boolean;
+    readonly error: string | null;
+    readonly submit: () => void;
+    readonly close: () => void;
+    readonly check: () => void;
+    readonly reconcile: () => void;
+}): ReactNode;
+//# sourceMappingURL=SubmitReview.d.ts.map

package/lib/types/client/WorktreeToggle.d.ts

@@ -31,12 +31,13 @@ export interface WorktreeToggleInjected {
 export type WorktreeToggleProps = InjectFace<WorktreeToggleInjected> & PropsLocale<typeof NS>;
 /**
  * Render the worktree option while the Session can still start in a worktree:
- * the base branch menu once requested, then the checkbox. When the checkout
- * cannot host a worktree, the tooltip gives the reason and the checkbox only
- * withdraws an open request. Both stay fixed while the worktree is being
- * created.
+ * the current branch, or the base branch menu once requested, then the checkbox.
+ * A blocked request keeps its selected base visible without a menu; the checkbox
+ * only withdraws it. Branch details support pointer, touch, and keyboard access.
+ * The request stays fixed while the worktree is being created.
  * @param props - panel snapshot hook, request actions, and copy.
- * @returns the option, or nothing once a turn started, the request settled, or no worktree service is mounted.
+ * @returns the option, or nothing outside a known Git checkout, once a turn started,
+ * the request settled, or no worktree service is mounted.
  */
 export declare function WorktreeToggle({ usePanel, request, cancel, branches, t }: WorktreeToggleProps): ReactNode;
 //# sourceMappingURL=WorktreeToggle.d.ts.map

package/lib/types/client/changes-address.d.ts

@@ -55,7 +55,7 @@ export declare function changesAddress(target: ChangesTarget): string;
  */
 export declare function parseChangesAddress(address: string): ChangesTarget | undefined;
 /**
- * Name a changes view: 变更 for the local changes, #N 的变更 for a change request with a number.
+ * Name a changes view: 本地变更 for the local changes, #N 的变更 for a change request with a number.
  * @param source - what the view shows.
  * @param t - forge panel copy.
  * @returns the title in the current language.

package/lib/types/client/code-selection.d.ts

@@ -0,0 +1,23 @@
+/** Read browser text selections from one diff side without including the interleaved opposite column. */
+/** Selected displayed lines and the exact selected text on their side. */
+export interface CodeSelection {
+    readonly side: 'L' | 'R';
+    readonly from: number;
+    readonly to: number;
+    readonly text: string;
+}
+/**
+ * Find the side where a text selection begins; unified context belongs to the new side.
+ * @param root - this file's diff element.
+ * @param node - pointer or selection anchor.
+ * @returns the available side, or undefined outside code text.
+ */
+export declare function codeSideAt(root: HTMLElement, node: Node | null): 'L' | 'R' | undefined;
+/**
+ * Read only code fragments from the selected side, retaining partial first and last lines for copy.
+ * @param root - this file's diff element.
+ * @param side - side captured when the gesture began.
+ * @returns the selected range and text, or undefined for collapsed or cross-file selections.
+ */
+export declare function readCodeSelection(root: HTMLElement, side: 'L' | 'R'): CodeSelection | undefined;
+//# sourceMappingURL=code-selection.d.ts.map

package/lib/types/client/file-tree.d.ts

@@ -0,0 +1,33 @@
+import type { ForgeDiffFile } from '../types.ts';
+/** A changed file or a compacted chain of directories containing changed files. */
+export type ChangedFileNode = {
+    readonly kind: 'file';
+    readonly path: string;
+    readonly name: string;
+    readonly file: ForgeDiffFile;
+} | {
+    readonly kind: 'directory';
+    readonly path: string;
+    readonly name: string;
+    readonly children: readonly ChangedFileNode[];
+};
+/**
+ * Build a directory-first tree, compacting directories with a single directory child.
+ * @param files - changed files; Git paths use forward slashes, including on Windows.
+ * @returns the root's children in stable name order.
+ */
+export declare function changedFileTree(files: readonly ForgeDiffFile[]): readonly ChangedFileNode[];
+/**
+ * Read every file in the tree's depth-first display order, independent of navigation folds and filtering.
+ * @param nodes - the complete directory-first tree.
+ * @returns the original file objects in display order.
+ */
+export declare function filesInTreeOrder(nodes: readonly ChangedFileNode[]): readonly ForgeDiffFile[];
+/**
+ * Keep matching files and their ancestors without changing directory identities.
+ * @param nodes - the complete compacted tree.
+ * @param query - case-insensitive text matched against current and previous paths.
+ * @returns matching branches, or the original tree for an empty query.
+ */
+export declare function filterFileTree(nodes: readonly ChangedFileNode[], query: string): readonly ChangedFileNode[];
+//# sourceMappingURL=file-tree.d.ts.map

package/lib/types/client/locales.d.ts

@@ -3,6 +3,51 @@
 export declare const NS = "forgePanel";
 /** Chinese copy; its keys define {@link ForgePanelKey}. */
 export declare const zh: {
+    readonly 'review.startReview': "开始评审";
+    readonly 'review.githubActions': "GitHub 评论选项";
+    readonly 'review.publishing': "发布中…";
+    readonly 'review.submitting': "提交中…";
+    readonly 'review.close': "关闭";
+    readonly 'review.pending': "待提交";
+    readonly 'review.quoted': "已添加到输入框";
+    readonly 'review.yourComment': "你的评论";
+    readonly 'review.outdated': "代码已更新";
+    readonly 'review.done': "完成";
+    readonly 'review.addComment': "添加评论";
+    readonly 'diff.resizeFileTree': "调整文件树宽度";
+    readonly 'diff.fileTree': "文件树";
+    readonly 'diff.showFileTreeLeft': "在左侧显示文件树";
+    readonly 'diff.moveFileTreeRight': "将文件树移到右侧";
+    readonly 'guide.title': "代码审查和变更";
+    readonly 'guide.description': "查看代码变更与本会话的变更请求";
+    readonly 'diff.hideFileTree': "隐藏文件树";
+    readonly 'review.range': "评论 {range}";
+    readonly 'review.comment': "留下评论…";
+    readonly 'review.cancel': "取消";
+    readonly 'review.addToInput': "添加到输入框";
+    readonly 'review.publish': "发布单条评论";
+    readonly 'review.queue': "加入评审";
+    readonly 'review.selectLine': "选择第 {line} 行";
+    readonly 'review.inputFailed': "输入框暂时无法添加引用，请稍后重试";
+    readonly 'review.saveFailed': "无法保存评审草稿，请检查浏览器存储后重试";
+    readonly 'review.unknown': "无法确认提交结果。请先在 GitHub 核对，避免重复发布";
+    readonly 'review.submit': "提交评审";
+    readonly 'review.summary': "评审总结…";
+    readonly 'review.approve': "批准";
+    readonly 'review.requestChanges': "请求更改";
+    readonly 'review.summaryRequired': "请求更改时，请填写评审总结";
+    readonly 'review.commentOnly': "评论";
+    readonly 'review.drafts': "待提交评论（{count}）";
+    readonly 'review.edit': "编辑";
+    readonly 'review.remove': "删除";
+    readonly 'review.stale': "PR 已有新提交，请刷新并重新选择评论行";
+    readonly 'review.published': "已发布到 GitHub";
+    readonly 'review.submitted': "已提交评审";
+    readonly 'review.failed': "提交失败：{message}";
+    readonly 'review.unsupported': "此代码托管服务不支持提交评审";
+    readonly 'review.loadFailed': "无法读取评审草稿，请检查浏览器存储";
+    readonly 'review.recheck': "在 GitHub 查看";
+    readonly 'review.confirmRetry': "已核对，允许重新提交";
     readonly 'tab.title': "变更请求";
     readonly 'header.label': "本会话的变更请求";
     readonly 'header.attention': "本会话的变更请求需要处理";
@@ -18,7 +63,7 @@ export declare const zh: {
     readonly 'changes.title': "本会话的变更请求 · {count}";
     readonly 'changes.empty': "本会话还没有变更请求";
     readonly 'changes.emptyHint': "本会话关联的变更请求（创建、查看、编辑或检出的，以及所在分支或推送分支上的）会显示在这里";
-    readonly 'changes.local.title': "变更";
+    readonly 'changes.local.title': "本地变更";
     readonly 'changes.local.refs': "{head} → {base}";
     readonly 'changes.local.files': "{count} 个文件";
     readonly 'changes.local.viewAria': "查看本会话的变更：{count} 个文件，新增 {added} 行，删除 {deleted} 行";
@@ -47,12 +92,17 @@ export declare const zh: {
     readonly 'change.ci.running': "检查中";
     readonly 'change.ci.passed': "检查通过";
     readonly 'change.ci.failed': "{count} 项检查失败";
+    readonly 'change.ci.cancelled': "已取消 {count} 项检查";
     readonly 'change.ci.failedUnlisted': "检查失败";
     readonly 'change.checks.failed': "{count} 项失败";
     readonly 'change.checks.running': "{count} 项进行中";
     readonly 'change.checks.passed': "{count} 项通过";
+    readonly 'change.checks.cancelled': "{count} 项已取消";
     readonly 'change.checks.other': "其他 {count} 项";
-    readonly 'change.checks.truncated': "只列出前 {count} 项";
+    readonly 'change.checks.truncated': "已加载 {count} 项检查，仍有更多";
+    readonly 'change.checks.loading': "正在加载更多检查";
+    readonly 'change.checks.loadFailed': "更多检查加载失败：{message}";
+    readonly 'change.checks.retry': "重试加载检查";
     readonly 'change.check.running': "进行中";
     readonly 'change.check.queued': "排队中";
     readonly 'change.flag.changesRequested': "要求修改";
@@ -102,6 +152,8 @@ export declare const zh: {
     readonly 'diff.scopeNote.unstaged': "与暂存区比较，包含未跟踪的文件";
     readonly 'diff.scopeNote.staged': "暂存区与 HEAD 比较";
     readonly 'diff.allFiles': "全部 {count} 个文件";
+    readonly 'diff.filterFiles': "筛选文件…";
+    readonly 'diff.noMatchingFiles': "没有匹配的文件";
     readonly 'diff.refresh': "刷新变更";
     readonly 'diff.expandAll': "全部展开";
     readonly 'diff.collapseAll': "全部折叠";
@@ -124,6 +176,7 @@ export declare const zh: {
     readonly 'diff.fileTooLarge': "文件太大，无法显示变更";
     readonly 'diff.error': "无法读取变更";
     readonly 'diff.tooLarge': "变更太大，无法在这里显示";
+    readonly 'diff.filterConfigFailed': "无法完整读取 Git 过滤器配置，尚未执行比较。请检查 Git 配置和读取上限后重试";
     readonly 'diff.viewInBrowser': "在浏览器中查看";
     readonly 'diff.noForkPoint': "找不到本分支的分叉点，请选择其他范围";
     readonly 'diff.empty': "没有变更";
@@ -143,15 +196,16 @@ export declare const zh: {
     readonly 'duration.seconds': "{seconds} 秒";
     readonly 'duration.minutes': "{minutes} 分 {seconds} 秒";
     readonly 'duration.hours': "{hours} 小时 {minutes} 分";
-    readonly 'worktree.label': "工作树";
+    readonly 'worktree.label': "新建工作树";
     readonly 'worktree.hint': "在独立的工作树中运行本会话：发送后基于所选分支新建分支，修改和提交不影响项目目录";
-    readonly 'worktree.blocked.not-git': "工作区不是 Git 仓库，无法使用工作树";
     readonly 'worktree.blocked.outside-writable-root': "这个工作区的 Git 数据不在可写目录中（例如工作区本身就是工作树），暂不支持使用工作树";
     readonly 'worktree.blocked.read-only': "只读模式下无法使用工作树";
     readonly 'worktree.base': "基于 {branch}";
     readonly 'worktree.baseHead': "基于当前 HEAD";
     readonly 'worktree.baseMenu': "选择基准分支";
     readonly 'worktree.currentBranch': "当前分支";
+    readonly 'worktree.currentBranchTip': "当前分支：{branch}";
+    readonly 'worktree.detachedTip': "未在分支上 · {commit}";
     readonly 'creation.title': "正在创建工作树";
     readonly 'creation.failed': "创建工作树失败";
     readonly 'creation.prepare': "创建分支";

package/lib/types/client/review-queue.d.ts

@@ -0,0 +1,136 @@
+/** Browser-persisted review drafts and the write whose outcome still needs confirmation. */
+import type { ForgeReviewRequest } from '@deepseek-ai/dsh-experimental-forge/types';
+import type { ReviewSelection, ReviewSource } from './review.ts';
+/** A comment retained after adding its reference or receiving a publication receipt. */
+export type ReviewRecord = {
+    readonly kind: 'agent';
+    readonly selection: ReviewSelection;
+} | {
+    readonly kind: 'published';
+    readonly selection: ReviewSelection;
+    readonly url: string;
+};
+/** One inline record; its numeric key belongs only to the retained browser store. */
+export type ReviewThread = {
+    readonly key: number;
+} & (ReviewRecord | {
+    readonly kind: 'pending';
+    readonly selection: ReviewSelection;
+});
+/** File-scoped snapshot that does not change while unrelated comments or the summary are edited. */
+export interface FileReviewState {
+    readonly threads: readonly ReviewThread[];
+    readonly locked: boolean;
+    readonly error: ReviewQueueState['error'];
+}
+/** Stable snapshot for a file without a comment store. */
+export declare const EMPTY_FILE_REVIEW: FileReviewState;
+/** Immutable queue snapshot; errors leave the original stored bytes untouched. */
+export interface ReviewQueueState {
+    readonly comments: readonly ReviewSelection[];
+    readonly records: readonly ReviewRecord[];
+    readonly body: string;
+    readonly event: 'comment' | 'approve' | 'request-changes';
+    readonly uncertain: ForgeReviewRequest | null;
+    readonly error: 'load' | 'save' | null;
+}
+/** Initial state of a newly opened review tab. */
+export declare const EMPTY_REVIEW: ReviewQueueState;
+/** One review tab's drafts and records, retained until its occurrence closes. */
+export declare class ReviewQueue {
+    private readonly key;
+    private closed;
+    private state;
+    private readonly listeners;
+    private readonly keys;
+    private nextKey;
+    private readonly files;
+    /** @param key - browser storage key including Session and tab identity. */
+    constructor(key: string);
+    /** Current queue snapshot, stable between edits and storage failures. */
+    readonly getSnapshot: () => ReviewQueueState;
+    /**
+     * Clear this tab's records and refuse later completions from its outgoing requests.
+     * @returns whether its browser storage was cleared; the in-memory state always closes.
+     */
+    close(): boolean;
+    /** Summary subscribed by the surrounding diff; editing draft text does not invalidate its file rows. */
+    readonly getStatus: () => string;
+    /**
+     * Read stable inline records for one path and review source.
+     * @param path - repository-relative file path.
+     * @param source - PR or local scope; older head commits remain available as outdated comments.
+     * @returns records and edit availability, reusing the snapshot when these values are unchanged.
+     */
+    fileComments(path: string, source: ReviewSource): FileReviewState;
+    /**
+     * Retain an Agent reference at its original code location.
+     * @param selection - reference already accepted by the main composer.
+     * @returns whether the record was saved.
+     */
+    recordAgent(selection: ReviewSelection): boolean;
+    /**
+     * Retain a published comment and settle its outgoing write atomically in browser storage.
+     * @param selection - published comment's frozen code location.
+     * @param url - confirmed publication URL.
+     * @returns whether the receipt and comment were saved.
+     */
+    published(selection: ReviewSelection, url: string): boolean;
+    /**
+     * Observe queue edits and storage failures.
+     * @param listener - snapshot invalidation.
+     * @returns unsubscribe.
+     */
+    readonly subscribe: (listener: () => void) => (() => void);
+    /**
+     * Save a frozen PR comment unless a write needs reconciliation.
+     * @param selection - frozen PR comment.
+     * @returns whether it was saved.
+     */
+    add(selection: ReviewSelection): boolean;
+    /**
+     * Edit or remove a pending comment without changing its captured lines.
+     * @param index - comment position.
+     * @param body - replacement text, or null to remove.
+     * @returns whether saved.
+     */
+    edit(index: number, body: string | null): boolean;
+    /**
+     * Edit the currently pending occurrence addressed by an inline record.
+     * @param key - browser-store identity from fileComments.
+     * @param body - replacement text, or null to remove.
+     * @returns whether the occurrence still exists and the edit was saved.
+     */
+    editThread(key: number, body: string | null): boolean;
+    /**
+     * Save the summary and decision for the pending review.
+     * @param body - review summary.
+     * @param event - review decision.
+     * @returns whether saved.
+     */
+    summarize(body: string, event: ReviewQueueState['event']): boolean;
+    /**
+     * Persist the outgoing request before network dispatch.
+     * @param request - exact write.
+     * @returns whether dispatch may start.
+     */
+    begin(request: ForgeReviewRequest): boolean;
+    /**
+     * Clear the write after a known result or explicit reconciliation.
+     * @param submitted - whether a batch review was published.
+     * @param url - confirmed publication URL when retaining submitted comments.
+     * @returns whether saved.
+     */
+    finish(submitted: boolean, url?: string): boolean;
+    private keyOf;
+    private save;
+    private emit;
+}
+/**
+ * Compare review identity while allowing records from an older PR head to remain visible.
+ * @param left - recorded source.
+ * @param right - displayed source.
+ * @returns whether the sources name the same PR or local scope.
+ */
+export declare function sameReviewSource(left: ReviewSource, right: ReviewSource): boolean;
+//# sourceMappingURL=review-queue.d.ts.map

package/lib/types/client/review.d.ts

@@ -0,0 +1,56 @@
+/** Frozen line selections shared by the diff UI, composer references, and review submission. */
+import type { ForgeDiffFile } from '../types.ts';
+/** A comment on consecutive lines of one side of one displayed hunk. */
+export interface ReviewComment {
+    /** Repository-relative destination path, including for renamed files. */
+    readonly path: string;
+    /** Old or new side of the displayed diff. */
+    readonly side: 'L' | 'R';
+    /** First selected line, inclusive. */
+    readonly startLine: number;
+    /** Last selected line, inclusive. */
+    readonly endLine: number;
+    /** Complete displayed hunk captured before subsequent file changes. */
+    readonly hunk: string;
+    /** User's plain-text comment. */
+    readonly body: string;
+}
+/** The immutable source from which a comment was selected. */
+export type ReviewSource = {
+    readonly kind: 'local';
+    readonly scope: string;
+} | {
+    readonly kind: 'change';
+    readonly url: string;
+    readonly headSha: string;
+};
+/** One selected range and the source the user saw. */
+export interface ReviewSelection {
+    readonly source: ReviewSource;
+    readonly comment: ReviewComment;
+}
+/**
+ * Capture a range only when both endpoints belong to the same displayed hunk.
+ * @param file - loaded diff file.
+ * @param side - selected side.
+ * @param from - first gesture endpoint.
+ * @param to - current gesture endpoint.
+ * @returns a frozen selection, or undefined for unchanged gaps or cross-hunk ranges.
+ */
+export declare function selectReviewLines(file: ForgeDiffFile, side: 'L' | 'R', from: number, to: number): ReviewComment | undefined;
+/**
+ * Format a frozen reference for the ordinary, logged user message.
+ * @param selection - source, range, displayed patch, and user comment.
+ * @param index - one-based reference number in the composer.
+ * @returns Markdown content for an atomic composer quote.
+ */
+export declare function formatReviewComment(selection: ReviewSelection, index: number): string;
+/**
+ * Check whether the current diff still contains the captured range and hunk.
+ * @param selection - saved comment source and patch.
+ * @param source - currently displayed review source.
+ * @param file - current diff file.
+ * @returns whether an inline record can retain its original line placement.
+ */
+export declare function reviewMatches(selection: ReviewSelection, source: ReviewSource, file: ForgeDiffFile): boolean;
+//# sourceMappingURL=review.d.ts.map

package/lib/types/client/status.d.ts

@@ -21,12 +21,16 @@ export type CiSummary = {
  | {
     readonly kind: 'failed';
     readonly count: number;
+} | {
+    readonly kind: 'cancelled';
+    readonly count: number;
 };
-/** Checks grouped by outcome; `other` holds neutral, skipped, and cancelled checks. */
+/** Checks grouped by outcome; `other` holds neutral and skipped checks. */
 export interface CheckCounts {
     readonly failed: number;
     readonly running: number;
     readonly passed: number;
+    readonly cancelled: number;
     readonly other: number;
 }
 /** The most urgent fact of an open change request that the collapsed card names. */
@@ -51,7 +55,7 @@ export declare function checkCounts(checks: readonly ChangeRequestCheck[]): Chec
 /**
  * Summarize the checks of a change request from the host's combined outcome.
  * @param snapshot - change request status.
- * @returns the combined outcome with the failed count.
+ * @returns the combined outcome with its failure or cancellation count.
  */
 export declare function ciSummary(snapshot: ChangeRequestSnapshot): CiSummary;
 /**

package/lib/types/git.d.ts

@@ -1,4 +1,4 @@
-/** Read-only Git inspection of a Session's current directory in the Session's execution world. */
+/** Git queries in a Session's current directory, using its permissions and execution world. */
 import type { Context } from '@deepseek-ai/cordis';
 import type { Session } from '@deepseek-ai/dsh-session';
 import type { GitRemote } from './parse.ts';
@@ -31,17 +31,17 @@ export interface GitOutput {
     readonly stderr: string;
     readonly exitCode: number;
 }
-/** Runs one Git subcommand in a fixed directory; output with an exit code outside `allowedExitCodes` throws. */
-export type Git = (name: string, args: readonly string[], allowedExitCodes?: readonly number[]) => Promise<GitOutput>;
+/** Runs one Git subcommand with optional command-local configuration; output with an exit code outside `allowedExitCodes` throws. */
+export type Git = (name: string, args: readonly string[], allowedExitCodes?: readonly number[], configOverrides?: Readonly<Record<string, string>>) => Promise<GitOutput>;
 /** Thrown when a Git command prints more than `maxOutputBytes` on standard output. */
 export declare class GitOutputTooLarge extends Error {
     name: string;
 }
 /**
  * Inspect the checkout containing `directory`. Every command runs through the
- * mounted subprocess provider under a read-only confinement of the Session's
- * sandbox policy and reads refs and configuration only, never the working
- * tree. The top-level and shared Git directories Git prints are resolved
+ * mounted subprocess provider under the Session's sandbox policy and reads
+ * refs and configuration only, never the working tree.
+ * The top-level and shared Git directories Git prints are resolved
  * through `ctx.fs` into canonical process paths, the form the
  * working-directory service records.
  * @param ctx - context that provides `fs`, `subprocess`, `sandbox`, and `sandboxPolicy`.
@@ -55,7 +55,7 @@ export declare class GitOutputTooLarge extends Error {
 export declare function inspectCheckout(ctx: Context, config: GitConfig, session: Session, directory: string, signal: AbortSignal): Promise<Inspection | undefined>;
 /**
  * List the local branches that can start a worktree of the checkout containing
- * `directory`, under the same confinement as {@link inspectCheckout}.
+ * `directory`, using the Session's permissions as in {@link inspectCheckout}.
  * @param ctx - context that provides `subprocess`, `sandbox`, and `sandboxPolicy`.
  * @param config - executable and process limits.
  * @param session - Session whose sandbox policy and execution world apply.
@@ -67,7 +67,7 @@ export declare function inspectCheckout(ctx: Context, config: GitConfig, session
  */
 export declare function listBranches(ctx: Context, config: GitConfig, session: Session, directory: string, limit: number, signal: AbortSignal): Promise<ForgeBranches>;
 /**
- * Report whether a local branch exists, under the same confinement as {@link inspectCheckout}.
+ * Report whether a local branch exists, using the Session's permissions as in {@link inspectCheckout}.
  * @param ctx - context that provides `subprocess`, `sandbox`, and `sandboxPolicy`.
  * @param config - executable and process limits.
  * @param session - Session whose sandbox policy and execution world apply.
@@ -79,8 +79,8 @@ export declare function listBranches(ctx: Context, config: GitConfig, session: S
  */
 export declare function hasBranch(ctx: Context, config: GitConfig, session: Session, repositoryRoot: string, branch: string, signal: AbortSignal): Promise<boolean>;
 /**
- * Bind the confined Git runner to one Session and directory: every command
- * runs under a read-only confinement of the Session's sandbox policy with the
+ * Bind the Git runner to one Session and directory: every command
+ * runs under the Session's sandbox policy with the
  * scrubbed environment, the fixed command prefix, and `config`'s limits.
  * @param ctx - context that provides `subprocess`, `sandbox`, and `sandboxPolicy`.
  * @param config - executable and process limits.

package/lib/types/index.d.ts

@@ -1,7 +1,7 @@
 /** Host Remote of the forge panel: checkout, code host, sign-in, change request, and worktree state per Session. */
 import { Context, Service } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import type { MergeMethod } from '@deepseek-ai/dsh-experimental-forge';
+import type { ChangeRequestSnapshot, ForgeReviewRequest, ForgeReviewResult, MergeMethod } from '@deepseek-ai/dsh-experimental-forge';
 import type { Session } from '@deepseek-ai/dsh-session';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { Config, ForgeBranches, ForgeChangeRequestDiff, ForgeChangeRequestStatesFrame, ForgeLocalDiff, ForgeLocalScope, ForgePanelState } from './types.ts';
@@ -14,7 +14,7 @@ declare module '@deepseek-ai/cordis' {
 }
 /**
  * Serves the forge panel. Following a Session inspects the checkout of its
- * current directory read-only in the Session's execution world, recognizes the
+ * current directory using the Session's permissions and execution world, recognizes the
  * code host of the upstream remote or `origin`, probes sign-in for that host,
  * and polls the Session's bound change requests through `ctx.forge` until the
  * last follower of that Session leaves. A worktree request makes the panel
@@ -96,13 +96,14 @@ export declare class ForgePanelController extends TypertRemoteService {
     refresh(session: Session, signal: AbortSignal): Promise<void>;
     /**
      * Read the changes one scope covers in the checkout of the Session's
-     * current directory, with Git confined to the Session's read-only sandbox.
+     * current directory, with Git using the Session's sandbox policy.
      * @param session - Session whose checkout is read.
      * @param scope - which changes to read.
      * @param signal - request cancellation.
      * @returns the files, the base of the `branch` scope, and the untracked files left out.
      * @throws `forgePanel/not-a-checkout` outside a checkout; `forgePanel/no-fork-point` for the `branch`
-     * scope of a checkout without one; `forgePanel/diff-too-large` over `maxDiffBytes`; the Git error when Git fails.
+     * scope of a checkout without one; `forgePanel/filter-config-failed` when filter configuration cannot be read
+     * completely, before any comparison; `forgePanel/diff-too-large` over `maxDiffBytes`; the Git error when Git fails.
      */
     localDiff(session: Session, scope: ForgeLocalScope, signal: AbortSignal): Promise<ForgeLocalDiff>;
     /**
@@ -117,6 +118,17 @@ export declare class ForgePanelController extends TypertRemoteService {
      * an error for a path outside the checkout, binary content, or a failed read.
      */
     localText(session: Session, scope: ForgeLocalScope, path: string, signal: AbortSignal): Promise<string>;
+    /**
+     * Load complete checks for the change request whose list the user opened.
+     * @param session - Session retaining the visible binding.
+     * @param url - binding URL.
+     * @param headSha - commit displayed by the card; a different head rejects the result.
+     * @param signal - cancellation when the list closes.
+     * @returns the complete snapshot at the displayed head.
+     * @throws `forgePanel/not-bound` for an invisible binding, `forgePanel/stale-head` for a moved head,
+     * or `forgePanel/checks-failed` when the provider cannot complete the read.
+     */
+    changeRequestChecks(session: Session, url: string, headSha: string, signal: AbortSignal): Promise<ChangeRequestSnapshot>;
     /**
      * Read the changes of a change request of a Session as its code host
      * computes them, at the head commit of its latest status. A patch already
@@ -145,6 +157,15 @@ export declare class ForgePanelController extends TypertRemoteService {
      * `forgePanel/diff-failed` when the host does not provide the file otherwise.
      */
     changeRequestText(session: Session, url: string, commit: string, path: string, signal: AbortSignal): Promise<string>;
+    /**
+     * Publish a line comment or completed review for a visible Session binding.
+     * @param session - Session retaining the change request.
+     * @param url - visible binding URL.
+     * @param request - reviewed head, ranges, plain text, and explicit review decision.
+     * @param signal - request cancellation.
+     * @returns confirmed publication or a typed failure; unknown outcomes require reconciliation on the host.
+     */
+    submitReview(session: Session, url: string, request: ForgeReviewRequest, signal: AbortSignal): Promise<ForgeReviewResult>;
     /**
      * Mark a draft change request of a Session ready for review; the change
      * request is polled again once the host answers.