Loading files
/**
* "Is the process that wrote this lock still the process that wrote it?" — shared by every on-disk
* lock the CLI keeps (registry.json.lock, adapter.spawn.lock).
*
* A bare pid is not enough: pids are recycled, so a crashed owner's pid can belong to an unrelated
* process by the time anyone checks. The start marker pins the process GENERATION — Linux exposes it
* in /proc/<pid>/stat (field 22, starttime in clock ticks); elsewhere `ps -o lstart` gives it to the
* second, which is coarse but has never collided in practice. A marker that cannot be read at all
* degrades to "alive if the pid exists", which is what Windows gets.
*/
import { readFileSync } from 'fs'
import { execFileSync } from 'node:child_process'
import { psEnv } from './childLocale.js'
export function processExists(pid: number): boolean {
if (!Number.isSafeInteger(pid) || pid <= 0) return false
try { process.kill(pid, 0); return true } catch (error) {
return (error as NodeJS.ErrnoException).code === 'EPERM'
}
}
export function processStartMarker(pid: number): string | null {
if (!Number.isSafeInteger(pid) || pid <= 0) return null
try {
const stat = readFileSync(`/proc/${pid}/stat`, 'utf8')
const fields = stat.slice(stat.lastIndexOf(')') + 2).trim().split(/\s+/)
if (fields[19]) return `linux:${fields[19]}`
} catch { /* non-Linux or exited process; use ps below */ }
try {
const started = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
encoding: 'utf8', timeout: 1_000, env: { ...psEnv(), TZ: 'UTC' },
}).trim()
return started ? `ps-c:${started}` : null
} catch { return null }
}
export interface LockGeneration {
startMarker?: unknown
generationMarker?: unknown
}
/** Older readers compare every nonempty marker literally. Leave their field empty for the new
* locale-pinned format so they use PID liveness during an upgrade, never steal a live new lock.
* New readers retain PID-reuse detection through the separate versioned field. */
export function processLockIdentity(pid: number): { startMarker: string; generationMarker: string } {
const generationMarker = processStartMarker(pid) ?? ''
return { startMarker: generationMarker.startsWith('ps-c:') ? '' : generationMarker, generationMarker }
}
export function lockStartMarker(owner: LockGeneration | null | undefined): string {
return typeof owner?.generationMarker === 'string' ? owner.generationMarker
: typeof owner?.startMarker === 'string' ? owner.startMarker : ''
}
export function lockOwnerAlive(pid: number, startMarker: string): boolean {
if (!processExists(pid)) return false
if (!startMarker) return true
const current = processStartMarker(pid)
// Legacy ps markers inherited the writer's locale. They cannot be compared
// safely with a new reader's timestamp; keep that live owner until it exits.
const comparable = current !== null && ['linux:', 'ps-c:'].some(
(prefix) => startMarker.startsWith(prefix) && current.startsWith(prefix),
)
return !comparable || current === startMarker
}
52864cb1cThis file is pinned to the selected release. Download the original to open it in your design tool.