Files
orca/src/main/ipc/readdir-error-diagnostics.ts
T
OrcaWinandOrcaWin 3286f3b259 [comment audit] Clean up IPC, host lifecycle and native-chat comments (#32966)
* [comment audit] Tighten watcher lifetime and file-write constraints [skip ci]

* [comment audit] Clarify IPC routing and notification comments [skip ci]

* [comment audit] Shorten watcher, preflight and PTY comments [skip ci]

* [comment audit] Clarify PTY delivery and restore ownership [skip ci]

* [comment audit] Tighten PTY environment and flow-control rationale [skip ci]

* [comment audit] Clarify IPC spawn and stable-pane guarantees [skip ci]

* [comment audit] Tighten PTY provider and filesystem ownership rationale [skip ci]

* [comment audit] Clarify clone ownership and remote runtime recovery [skip ci]

* [comment audit] Condense upload, settings and SSH lifecycle comments [skip ci]

* [comment audit] Shorten shutdown, preview and worktree watcher rationale [skip ci]

* [comment audit] Clarify worktree identity, remote ownership and copy limits [skip ci]

* [comment audit] Shorten worktree catalog, removal and WSL routing rationale [skip ci]

* [comment audit] Tighten Linear credential, pagination and export comments [skip ci]

* [comment audit] Condense managed-server activation, snapshot and launch rationale [skip ci]

* [comment audit] Trim runtime installation and managed-server lifecycle comments [skip ci]

* [comment audit] Simplify managed tunnel, memory and menu comments [skip ci]

* [comment audit] Condense integration, model catalog and attachment rationale [skip ci]

* [comment audit] Shorten journal persistence, replay and queue rationale [skip ci]

* [comment audit] Condense journal ordering and timeline lifecycle comments [skip ci]

* [comment audit] Trim timeline and subscriber delivery explanations [skip ci]

* [comment audit] Shorten Stop, child-exit and recovery contracts [skip ci]

* [comment audit] Simplify handover and host recovery comments [skip ci]

* [comment audit] Trim queue delivery and provider startup commentary [skip ci]

* [comment audit] Clarify restart and rewind safety comments [skip ci]

* [comment audit] Trim status, Stop and completion commentary [skip ci]

* [comment audit] Simplify transcript lookup and visual containment comments [skip ci]

* [comment audit] Trim transcript reader, watcher and WSL transport commentary [skip ci]

---------

Co-authored-by: OrcaWin <293788423+OrcaWin@users.noreply.github.com>
2026-10-23 19:07:32 -07:00

47 lines
1.6 KiB
TypeScript

import type { CrashReportBreadcrumbData } from '../../shared/crash-reporting'
export type ReadDirThrowSite = 'ssh-provider' | 'authorize' | 'readdir'
/** Classify failed directory paths without collecting raw paths in crash diagnostics. */
export function classifyReadDirPath(
dirPath: string,
connectionId: string | undefined
): CrashReportBreadcrumbData {
const isUNC = /^[\\/]{2}/.test(dirPath)
const lower = dirPath.toLowerCase()
// \\wsl$\ and \\wsl.localhost\ (either slash direction) are WSL UNC roots.
const isWsl = isUNC && (lower.includes('wsl$') || lower.includes('wsl.localhost'))
const driveLetterMatch = /^([a-zA-Z]):[\\/]/.exec(dirPath)
return {
hasConnectionId: Boolean(connectionId),
isUNC,
isWsl,
...(driveLetterMatch ? { driveLetter: driveLetterMatch[1].toUpperCase() } : {})
}
}
function errorCode(error: unknown): string | undefined {
if (error && typeof error === 'object' && 'code' in error) {
const code = (error as { code?: unknown }).code
if (typeof code === 'string') {
return code
}
}
return undefined
}
/** Report throw site, error code/name and path shape without raw paths. */
export function buildReadDirErrorBreadcrumb(args: {
dirPath: string
connectionId: string | undefined
throwSite: ReadDirThrowSite
error: unknown
}): CrashReportBreadcrumbData {
return {
throwSite: args.throwSite,
errorName: args.error instanceof Error ? args.error.name : typeof args.error,
...(errorCode(args.error) ? { errorCode: errorCode(args.error)! } : {}),
...classifyReadDirPath(args.dirPath, args.connectionId)
}
}