Files
orca/src/shared/terminal-scrollback-policy.ts
T
NeilandOrca 73c5009b82 chore(dead-code): drop ~2k lines of unreachable exports and orphan modules (#12077)
* chore(dead-code): drop 2k lines of unreachable exports and orphan modules

Ran knip across every build entry (main, preload, renderer, popout, web,
cli, relay, workers, forked sidecars, config scripts) and removed what no
entry graph can reach.

- 11 orphan modules nothing imported, plus one test that only covered them
- 159 unused exports/types, with their now-dead helpers, imports and tests

Each candidate was verified against dynamic references before deletion.
42 knip hits were false positives and are kept: shared modules consumed by
the mobile/ workspace, the src/shared/plugins/** public API, vendored
shadcn primitives, and relay wire-protocol constants held for compatibility.

Adds knip.json + `pnpm audit:dead-code` so this stays measurable.

Verified: pnpm typecheck, pnpm lint, and 2081 tests across the 73 affected
test files all pass.

* chore(dead-code): move knip config under config/

Root-level additions are blocked by the root directory guard.

Co-authored-by: Orca <help@stably.ai>

---------

Co-authored-by: Orca <help@stably.ai>
2026-08-02 00:33:57 -07:00

69 lines
2.6 KiB
TypeScript

export const DESKTOP_TERMINAL_SCROLLBACK_ROWS_DEFAULT = 5_000
export const DESKTOP_TERMINAL_SCROLLBACK_ROWS_MIN = 1_000
export const DESKTOP_TERMINAL_SCROLLBACK_ROWS_MAX = 50_000
export const DESKTOP_TERMINAL_SCROLLBACK_ROW_PRESETS = [5_000, 10_000, 25_000, 50_000] as const
export const LEGACY_TERMINAL_SCROLLBACK_BYTES_1_MB = 1_000_000
export const LEGACY_TERMINAL_SCROLLBACK_BUCKET_5K_MAX_BYTES = 17_500_000
export const LEGACY_TERMINAL_SCROLLBACK_BUCKET_10K_MAX_BYTES = 37_500_000
export const LEGACY_TERMINAL_SCROLLBACK_BUCKET_25K_MAX_BYTES = 75_000_000
function isFiniteNumber(value: unknown): value is number {
return typeof value === 'number' && Number.isFinite(value)
}
function clampRows(value: number, min: number): number {
return Math.min(DESKTOP_TERMINAL_SCROLLBACK_ROWS_MAX, Math.max(min, Math.floor(value)))
}
export function normalizeDesktopTerminalScrollbackRows(value: unknown): number {
if (!isFiniteNumber(value)) {
return DESKTOP_TERMINAL_SCROLLBACK_ROWS_DEFAULT
}
return clampRows(value, DESKTOP_TERMINAL_SCROLLBACK_ROWS_MIN)
}
// Why the backlog cap scales with scrollback: pending-output caps exist to
// bound memory while a starved display catches up, but a user who raised
// scrollback to 50k rows can retain more history than the flat 2 MB floor —
// dropping at the floor would discard lines their scrollback would have kept.
// 120 chars/row ≈ 80-col text plus escape-sequence overhead; the cap is a
// memory bound, not an exact retention guarantee.
export const TERMINAL_OUTPUT_BACKLOG_MIN_CAP_CHARS = 2 * 1024 * 1024
const OUTPUT_BACKLOG_CHARS_PER_SCROLLBACK_ROW = 120
export function terminalOutputBacklogCapChars(scrollbackRows: unknown): number {
const rows = normalizeDesktopTerminalScrollbackRows(scrollbackRows)
return Math.max(
TERMINAL_OUTPUT_BACKLOG_MIN_CAP_CHARS,
rows * OUTPUT_BACKLOG_CHARS_PER_SCROLLBACK_ROW
)
}
export function normalizeDesktopTerminalSnapshotRows(value: unknown): number | undefined {
if (!isFiniteNumber(value)) {
return undefined
}
return clampRows(value, 0)
}
export function legacyTerminalScrollbackBytesToRows(bytes: unknown): number {
if (!isFiniteNumber(bytes) || bytes <= 0) {
return DESKTOP_TERMINAL_SCROLLBACK_ROWS_DEFAULT
}
if (bytes <= LEGACY_TERMINAL_SCROLLBACK_BYTES_1_MB) {
return DESKTOP_TERMINAL_SCROLLBACK_ROWS_MIN
}
if (bytes < LEGACY_TERMINAL_SCROLLBACK_BUCKET_5K_MAX_BYTES) {
return DESKTOP_TERMINAL_SCROLLBACK_ROWS_DEFAULT
}
if (bytes < LEGACY_TERMINAL_SCROLLBACK_BUCKET_10K_MAX_BYTES) {
return 10_000
}
if (bytes < LEGACY_TERMINAL_SCROLLBACK_BUCKET_25K_MAX_BYTES) {
return 25_000
}
return DESKTOP_TERMINAL_SCROLLBACK_ROWS_MAX
}