mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-11-10 04:27:42 +08:00
Yichen Jiang
d0fc1f6458
The forge panel opens a changes view in the right sidebar for the checkout's local changes and for the diff of each change request. - ForgePanelController reads local diffs in the branch, uncommitted, unstaged, and staged scopes through Git in the Session's read-only sandbox, change request diffs through the forge provider, and the text of a changed file to expand unchanged lines. Change request patches stay cached by head commit and base branch within maxCachedDiffBytes. A local diff over maxDiffBytes fails as forgePanel/diff-too-large, and a provider read over its output limit fails as too-large, which the view explains with a link to the code host; a gh timeout fails as unavailable. - forge adds the diff, fileText, and fileUrl provider methods and the too-large failure code, and forge-github implements them with gh. - The panel shows a local changes card that opens the view and asks the Agent for a change request. The view collapses files past a line budget, draws lines side by side or in one column with optional wrapping, expands unchanged lines on request, and collapses or expands every file from its toolbar; file headers use a bare chevron. - The checkout row copies the worktree or project directory path, the refresh glyph turns while a refresh runs, change request cards keep their actions while collapsed, and the header entry uses the shared compact button. - client-ui-forge classifies changeRequestKey and FsError as peer-required Host imports, which keeps forge and dsh-fs as its peers.
72 lines
2.9 KiB
TypeScript
72 lines
2.9 KiB
TypeScript
/** Runs the GitHub CLI on the host with a scrubbed, non-interactive environment. */
|
|
|
|
import { scrubbedParentEnv } from '@deepseek-ai/dsh-subprocess'
|
|
import { execa } from 'execa'
|
|
|
|
/** Complete output of one `gh` invocation that ran to an exit code. */
|
|
export interface GhOutput {
|
|
/** Process exit code. */
|
|
readonly exitCode: number
|
|
/** Standard output without its final newline. */
|
|
readonly stdout: string
|
|
/** Standard error without its final newline. */
|
|
readonly stderr: string
|
|
}
|
|
|
|
/** Runs `gh` with literal arguments; rejects when the process cannot run to an exit code. */
|
|
export type GhRunner = (args: readonly string[], signal: AbortSignal) => Promise<GhOutput>
|
|
|
|
/** Resolved executable and limits for `gh`. */
|
|
export interface GhConfig {
|
|
/** Executable name or absolute host path. */
|
|
readonly ghCommand: string
|
|
/** Deadline in milliseconds for one invocation. */
|
|
readonly timeoutMs: number
|
|
/** Maximum captured bytes per output stream. */
|
|
readonly maxOutputBytes: number
|
|
}
|
|
|
|
/** Thrown when the `gh` executable cannot start, for example because it is not installed. */
|
|
export class GhUnavailableError extends Error {
|
|
override name = 'GhUnavailableError'
|
|
}
|
|
|
|
/** Thrown when one invocation outlives `timeoutMs`; the process is killed. */
|
|
export class GhTimeoutError extends Error {
|
|
override name = 'GhTimeoutError'
|
|
}
|
|
|
|
/** Thrown when an output stream exceeds `maxOutputBytes`; the process is killed. */
|
|
export class GhOutputLimitError extends Error {
|
|
override name = 'GhOutputLimitError'
|
|
}
|
|
|
|
/**
|
|
* Build a runner for `gh` on the host. The child inherits the scrubbed parent
|
|
* environment, so variables whose names contain KEY, PASSWORD, SECRET, or
|
|
* TOKEN never reach it and `gh` authenticates from its own credential store.
|
|
* Prompts, update notices, pagers, and colors are disabled.
|
|
* @param config - executable and limits.
|
|
* @returns the runner.
|
|
*/
|
|
export function ghRunner(config: GhConfig): GhRunner {
|
|
return async (args, signal) => {
|
|
const result = await execa(config.ghCommand, args, {
|
|
env: { ...scrubbedParentEnv(), GH_PROMPT_DISABLED: '1', GH_NO_UPDATE_NOTIFIER: '1', GH_PAGER: '', NO_COLOR: '1', CLICOLOR: '0' },
|
|
extendEnv: false,
|
|
stdin: 'ignore',
|
|
reject: false,
|
|
timeout: config.timeoutMs,
|
|
cancelSignal: signal,
|
|
maxBuffer: config.maxOutputBytes,
|
|
})
|
|
const command = ['gh', ...args.slice(0, 1)].join(' ')
|
|
if (result.isCanceled) throw signal.reason
|
|
if (result.timedOut) throw new GhTimeoutError(`${command} timed out after ${config.timeoutMs}ms`)
|
|
if (result.isMaxBuffer) throw new GhOutputLimitError(`${command} output exceeds maxOutputBytes`)
|
|
// A result without an exit code failed before the process ran; execa then always sets shortMessage.
|
|
if (result.exitCode === undefined) throw new GhUnavailableError(`gh could not start: ${String(result.shortMessage)}`)
|
|
return { exitCode: result.exitCode, stdout: result.stdout, stderr: result.stderr }
|
|
}
|
|
}
|