Tianyi Cui
ee7458b2df
Purge the residual task/phase ordinals review caught ((T2), (queue cut 1) ×3, T6, P-I, 'this cut' ×6 including battery-expansion finds in two untouched notes and a workflow JSDoc); drop the 'externally logged as Decision 21' parenthetical and rename the remaining bare decision-21 mentions; mark the gui-layering IPC bridge row as a hypothetical example; restore the GATE_NOTICE doc-typecheck clause and the py-types 'measured' provenance; say subprocess-backed in filesystem.md; add the picker note path. Amend the citations note: merged-PR evidence anchors in Agent Notes are sanctioned, and the candidate gate patterns gain the four shapes the sweep missed. All nine touched pairs re-recorded.
108 lines
4.0 KiB
TypeScript
108 lines
4.0 KiB
TypeScript
/** Cross-platform native single-directory chooser behind the native backend's capability. */
|
|
|
|
import { runNativeCommand, type NativeCommandRunner } from '@deepseek-ai/dsh-native-command'
|
|
import { pickWin32Directory } from './win32-dialog.ts'
|
|
|
|
/** Testable command boundary; native implementations never invoke a shell. */
|
|
export type DirectoryPickerRunner = NativeCommandRunner
|
|
|
|
/** Injectable platform facts for deterministic adapter tests. */
|
|
export interface DirectoryPickerInternals {
|
|
platform?: NodeJS.Platform
|
|
run?: DirectoryPickerRunner
|
|
/** Replaces the in-process Win32 dialog (`pickWin32Directory`) for deterministic tests. */
|
|
pickWin32Dialog?: (signal: AbortSignal) => Promise<string | null>
|
|
}
|
|
|
|
function outputPath(stdout: string): string | null {
|
|
const path = stdout.replace(/[\r\n]+$/, '')
|
|
return path === '' ? null : path
|
|
}
|
|
|
|
function errorCode(error: unknown): string | number | undefined {
|
|
if (typeof error !== 'object' || error === null || !('code' in error)) return undefined
|
|
const code = (error as { code?: unknown }).code
|
|
return typeof code === 'string' || typeof code === 'number' ? code : undefined
|
|
}
|
|
|
|
function errorStderr(error: unknown): string {
|
|
if (typeof error !== 'object' || error === null || !('stderr' in error)) return ''
|
|
const stderr = (error as { stderr?: unknown }).stderr
|
|
return typeof stderr === 'string' ? stderr : ''
|
|
}
|
|
|
|
function isMissingCommand(error: unknown): boolean {
|
|
return errorCode(error) === 'ENOENT'
|
|
}
|
|
|
|
function rethrowIfAborted(signal: AbortSignal, error: unknown): void {
|
|
if (signal.aborted) throw error
|
|
}
|
|
|
|
/**
|
|
* Open the platform directory picker.
|
|
* @param signal - caller/connection lifetime; abort terminates the native command.
|
|
* @param internals - Platform and runner hooks for deterministic tests.
|
|
* @returns the selected path, or null when the user cancels.
|
|
*/
|
|
export async function pickNativeDirectory(
|
|
signal: AbortSignal,
|
|
internals: DirectoryPickerInternals = {},
|
|
): Promise<string | null> {
|
|
const platform = internals.platform ?? process.platform
|
|
const run = internals.run ?? runNativeCommand
|
|
|
|
if (platform === 'darwin') {
|
|
try {
|
|
const result = await run('osascript', [
|
|
'-e', 'set selectedFolder to choose folder with prompt "Select Workspace Directory"',
|
|
'-e', 'POSIX path of selectedFolder',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
if (!signal.aborted && errorCode(error) === 1
|
|
&& /(?:User canceled|-128)/i.test(errorStderr(error))) return null
|
|
throw error
|
|
}
|
|
}
|
|
|
|
if (platform === 'win32') {
|
|
// The koffi-backed IFileOpenDialog child process — the modern picker with
|
|
// per-monitor-v2 DPI and abort support. koffi is a packaged dependency
|
|
// whose availability the install guarantees, so there is no fallback
|
|
// tier: any failure surfaces as-is (no PowerShell fallback tier; see
|
|
// .agents/notes/implemented/simplification/2026-08-04-drop-windows-powershell-picker-fallback.md).
|
|
const pickDialog = internals.pickWin32Dialog ?? pickWin32Directory
|
|
return await pickDialog(signal)
|
|
}
|
|
|
|
if (platform === 'linux') {
|
|
try {
|
|
const result = await run('zenity', [
|
|
'--file-selection', '--directory', '--title=Select Workspace Directory',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
rethrowIfAborted(signal, error)
|
|
if (errorCode(error) === 1) return null
|
|
if (!isMissingCommand(error)) throw error
|
|
}
|
|
|
|
try {
|
|
const result = await run('kdialog', [
|
|
'--getexistingdirectory', '.', '--title', 'Select Workspace Directory',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
rethrowIfAborted(signal, error)
|
|
if (errorCode(error) === 1) return null
|
|
if (isMissingCommand(error)) {
|
|
throw new Error('no supported native directory picker found (install zenity or kdialog)')
|
|
}
|
|
throw error
|
|
}
|
|
}
|
|
|
|
throw new Error(`native directory picker is unsupported on ${platform}`)
|
|
}
|