@vibesdotdev/pm 0.0.0-stage → 1.0.0-rc.2

package/dist/services/orphans.js

@@ -0,0 +1,185 @@
+/**
+ * Orphan Process Scanner
+ * Detects and handles orphaned processes on ports
+ *
+ * A conflicting holder is only ever signalled when `utils/port-ownership.ts`
+ * can prove PM started it. A look-alike command line is NOT proof — see that
+ * module's header for the three foreign MCP hosts this killed.
+ */
+import { CapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { attempt, failureLabel } from "../utils/attempt.js";
+import {} from "../schemas/process.js";
+import { getLogger } from '@vibesdotdev/logging';
+import { killProcessTree, isProcessRunning } from "../utils/process-tree.js";
+import { formatForeignHolderRefusal, provePortOwnership } from "../utils/port-ownership.js";
+import { findPortConflicts, isCommandLineMatch, matchesCommandSignature } from "../utils/ports.js";
+export function selectMatchingCommandRoots(processes, config, knownPids = new Set()) {
+    const byPid = new Map(processes.map((process) => [process.pid, process]));
+    const matchingPids = new Set(processes
+        .filter((process) => !knownPids.has(process.pid))
+        .filter((process) => isCommandLineMatch(process.command, config))
+        .map((process) => process.pid));
+    return processes.filter((process) => {
+        if (!matchingPids.has(process.pid))
+            return false;
+        let current = process;
+        while (current.ppid && byPid.has(current.ppid)) {
+            current = byPid.get(current.ppid);
+            if (matchingPids.has(current.pid))
+                return false;
+        }
+        return true;
+    });
+}
+/**
+ * Does the holder's command line look like the config we are starting?
+ *
+ * SIGNATURE ONLY. This answers "could this plausibly be an instance of this
+ * config", never "is this ours" — a peer lane's identical `vibes dev mcp serve
+ * --mode http --port 3000` matches every token here. Ownership is decided by
+ * `provePortOwnership`, which additionally demands scope.
+ */
+export async function conflictSignatureMatches(runtime, conflict, config) {
+    return matchesCommandSignature(runtime, conflict.command, config, conflict.port);
+}
+/**
+ * Check if we may signal a conflicting process.
+ *
+ * Returns `canKill: true` ONLY with a named ownership basis. Everything else is
+ * a refusal that names the holder pid and a remedy, because the alternative —
+ * killing a stranger who happens to hold a machine-global port — is the defect
+ * this function exists to prevent.
+ */
+export async function canKillConflict(runtime, conflict, config, _existingPid, seams) {
+    const ownership = await provePortOwnership({
+        runtime,
+        pid: conflict.pid,
+        isOurs: conflict.isOurs,
+        signatureMatches: await conflictSignatureMatches(runtime, conflict, config),
+        configCwd: config.cwd,
+        daemonScope: seams?.daemonScope,
+        daemonPid: seams?.daemonPid,
+        resolveCwd: seams?.resolveCwd,
+        resolveScopeEnv: seams?.resolveScopeEnv,
+        isDescendant: seams?.isDescendant
+    });
+    if (ownership.owned)
+        return { canKill: true, ownership };
+    return {
+        canKill: false,
+        reason: formatForeignHolderRefusal({
+            port: conflict.port,
+            pid: conflict.pid,
+            command: conflict.command,
+            holderCwd: ownership.holderCwd,
+            ourCwd: config.cwd,
+            mismatch: ownership.mismatch,
+            reason: ownership.reason
+        }),
+        ownership
+    };
+}
+/**
+ * Scan for and optionally kill orphaned processes on ports used by a config
+ * This prevents "address already in use" errors
+ */
+export async function scanAndKillOrphans(runtime, config, existingState, daemonScope) {
+    const log = getLogger('pm:orphans', runtime);
+    const result = {
+        foundOrphans: false,
+        killedPids: [],
+        errors: []
+    };
+    const existingPid = existingState?.pid ?? null;
+    const conflicts = await findPortConflicts(runtime, config, existingPid);
+    for (const conflict of conflicts) {
+        const { canKill, reason, ownership } = await canKillConflict(runtime, conflict, config, existingPid, {
+            daemonScope
+        });
+        if (!canKill) {
+            // Rule 13: a stranger on our port is reported LOUDLY, not routed around
+            // and certainly not killed.
+            log.warn('Refusing to signal a port holder this daemon does not own', {
+                processId: config.id,
+                port: conflict.port,
+                holderPid: conflict.pid,
+                holderCommand: conflict.command?.slice(0, 200) ?? null,
+                holderCwd: ownership.holderCwd,
+                ourCwd: config.cwd ?? null,
+                refusalReason: ownership.owned ? 'owned' : ownership.reason,
+                scopeFact: ownership.owned ? null : (ownership.mismatch ?? null)
+            });
+            result.errors.push({
+                port: conflict.port,
+                pid: conflict.pid,
+                error: reason || 'Unknown reason'
+            });
+            continue;
+        }
+        // Log and kill the orphan
+        log.warn('Found orphaned process on port', {
+            processId: config.id,
+            port: conflict.port,
+            orphanedPid: conflict.pid,
+            killPid: conflict.killPid,
+            type: conflict.type,
+            ownershipBasis: ownership.owned ? ownership.basis : 'unknown',
+            willKill: true
+        });
+        const killed = await attempt(() => killProcessTree(runtime, conflict.killPid, `${config.id}-orphan-${conflict.type}`));
+        if (!killed.ok) {
+            const failure = valueFreeFailure(killed.failure);
+            log.error('Failed to kill orphaned process', {
+                processId: config.id,
+                port: conflict.port,
+                orphanedPid: conflict.pid,
+                killPid: conflict.killPid,
+                failure,
+                manualKillCommand: `kill -9 ${conflict.killPid}`
+            });
+            result.errors.push({
+                port: conflict.port,
+                pid: conflict.pid,
+                error: `Failed to kill (${failureLabel(killed.failure)}). Manual: kill -9 ${conflict.killPid}`
+            });
+            continue;
+        }
+        result.foundOrphans = true;
+        result.killedPids.push(conflict.killPid);
+        log.info('Killed orphaned process', {
+            processId: config.id,
+            port: conflict.port,
+            orphanedPid: conflict.pid,
+            killPid: conflict.killPid
+        });
+    }
+    // If we have errors that prevent starting, throw
+    if (result.errors.length > 0 && result.killedPids.length === 0) {
+        const firstError = result.errors[0];
+        throw new CapabilityError(firstError.error, 'CONFLICT', {
+            reason: 'pm-port-conflict-unresolved',
+            details: { processId: config.id, port: firstError.port, pid: firstError.pid }
+        });
+    }
+    return result;
+}
+/**
+ * Check for orphaned process by PID (when state says running but process is dead)
+ * Returns the PID if it should be killed, null otherwise
+ */
+export async function checkOrphanedByState(runtime, _config, state) {
+    if (!state.pid) {
+        return { shouldKill: false, pid: null };
+    }
+    // Check if process is actually running
+    const running = await isProcessRunning(runtime, state.pid);
+    if (!running) {
+        return { shouldKill: false, pid: null };
+    }
+    // Process is running but state says not running - it's orphaned
+    if (state.status !== 'running') {
+        return { shouldKill: true, pid: state.pid };
+    }
+    return { shouldKill: false, pid: null };
+}
+//# sourceMappingURL=orphans.js.map

package/dist/services/orphans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphans.js","sourceRoot":"","sources":["../../src/services/orphans.ts"],"names":[],"mappings":"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"}

package/dist/services/process-command.d.ts

@@ -0,0 +1,25 @@
+import type { RuntimeHostCommandImplementation } from '@vibesdotdev/kernel';
+import type { ProcessConfig } from '../schemas/process.ts';
+import type { LifecycleHook } from '../schemas/common.ts';
+export interface ResolvedProcessCommand {
+    command: string;
+    args: string[];
+}
+export type ResolvedHookCommand = ResolvedProcessCommand;
+/**
+ * Resolve a process command at activation, never descriptor registration.
+ *
+ * A `selfSpawn` process re-enters the running host: its argv is the host
+ * command's self-spawn argv, followed by the descriptor's `args` (S15). The
+ * caller passes the selected host's commands; a self-spawn process without
+ * them, or on a host that declares no re-entry, fails closed.
+ */
+export declare function resolveProcessCommand(config: Pick<ProcessConfig, 'id' | 'command' | 'args' | 'selfSpawn'>, hostCommands?: Pick<RuntimeHostCommandImplementation, 'selfSpawnArgv'>): ResolvedProcessCommand;
+/**
+ * Resolve a lifecycle hook command at execution.
+ *
+ * A `selfSpawn` hook re-enters the running host: its argv is the host command's
+ * self-spawn argv, followed by the hook's `args`.
+ */
+export declare function resolveHookCommand(hook: Pick<LifecycleHook, 'command' | 'args' | 'selfSpawn'>, hostCommands?: Pick<RuntimeHostCommandImplementation, 'selfSpawnArgv'>, label?: string): ResolvedHookCommand;
+//# sourceMappingURL=process-command.d.ts.map

package/dist/services/process-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-command.d.ts","sourceRoot":"","sources":["../../src/services/process-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,IAAI,CACX,aAAa,EACb,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CACvC,EACD,YAAY,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,eAAe,CAAC,GACpE,sBAAsB,CAUxB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC,EAC3D,YAAY,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,eAAe,CAAC,EACtE,KAAK,CAAC,EAAE,MAAM,GACZ,mBAAmB,CAWrB"}

package/dist/services/process-command.js

@@ -0,0 +1,36 @@
+/**
+ * Resolve a process command at activation, never descriptor registration.
+ *
+ * A `selfSpawn` process re-enters the running host: its argv is the host
+ * command's self-spawn argv, followed by the descriptor's `args` (S15). The
+ * caller passes the selected host's commands; a self-spawn process without
+ * them, or on a host that declares no re-entry, fails closed.
+ */
+export function resolveProcessCommand(config, hostCommands) {
+    if (config.selfSpawn) {
+        if (!hostCommands) {
+            throw new Error(`Process '${config.id}' re-enters the Vibes host, but no host commands were provided`);
+        }
+        const [command, ...prefixArgs] = hostCommands.selfSpawnArgv(`PM process '${config.id}'`);
+        return { command, args: [...prefixArgs, ...(config.args ?? [])] };
+    }
+    return { command: config.command, args: [...(config.args ?? [])] };
+}
+/**
+ * Resolve a lifecycle hook command at execution.
+ *
+ * A `selfSpawn` hook re-enters the running host: its argv is the host command's
+ * self-spawn argv, followed by the hook's `args`.
+ */
+export function resolveHookCommand(hook, hostCommands, label) {
+    if (hook.selfSpawn) {
+        const hookLabel = label ?? `Lifecycle hook '${hook.command}'`;
+        if (!hostCommands) {
+            throw new Error(`${hookLabel} re-enters the Vibes host, but no host commands were provided`);
+        }
+        const [command, ...prefixArgs] = hostCommands.selfSpawnArgv(hookLabel);
+        return { command, args: [...prefixArgs, ...(hook.args ?? [])] };
+    }
+    return { command: hook.command, args: [...(hook.args ?? [])] };
+}
+//# sourceMappingURL=process-command.js.map

package/dist/services/process-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-command.js","sourceRoot":"","sources":["../../src/services/process-command.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACpC,MAGC,EACD,YAAsE;IAEtE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,CAAC,EAAE,gEAAgE,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC,eAAe,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACzF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CACjC,IAA2D,EAC3D,YAAsE,EACtE,KAAc;IAEd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,KAAK,IAAI,mBAAmB,IAAI,CAAC,OAAO,GAAG,CAAC;QAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,+DAA+D,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/services/process-log-archive.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Previous-run log archive.
+ *
+ * `LifecycleService.truncateLogs` rewrites `<id>.stdout` / `<id>.stderr` with
+ * a "Process started at" marker on EVERY start, so the crash reason of the
+ * run that just ended is gone by the time anyone looks (measured 2026-09-06:
+ * mcp-server-dev at 882 lifetime restarts, its stdout holding the 207-byte
+ * marker and nothing else). Its own size-based rotation fires only past 100MB.
+ *
+ * The end of a run is observable at the store: every writer that retires a
+ * pid — lifecycle's exit handler, `stop`, the daemon health monitor's kill,
+ * the liveness checker — does so through `ProcessStore.update`. This module
+ * listens there (`ProcessStore.onRunEnd`), stamps an exit banner onto the
+ * current logs so `pm logs` shows it until the next start, and copies one
+ * size-capped generation to `<id>.stdout.previous` / `<id>.stderr.previous`,
+ * where the next start cannot reach it.
+ *
+ * One generation, under its own name (pm.md U3): size rotation
+ * (the logging owner's `rotateAppendedFile`) owns `.1`..`.N`, and the archive once wrote `.1`
+ * too, so each overwrote the other's evidence.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { ProcessState } from '../schemas/process.ts';
+import type { ProcessRunEnd, RunEndInitiator } from '../store.impl.consumer.ts';
+import type { ArchiveRunLogsOptions, ArchiveRunLogsResult, ProcessRunArchiverOptions } from './types/index.ts';
+export type { ArchiveRunLogsOptions, ArchiveRunLogsResult, ProcessRunArchiverOptions } from './types/index.ts';
+export type { RunEndInitiator };
+export type { RunEndBannerInput } from './run-log-frames.ts';
+export { describeExitCode, formatRunEndBanner, formatRunStartMarker, runOutputOf } from './run-log-frames.ts';
+/** The previous-run archive's suffix: distinct from size rotation's `.1`..`.N`. */
+export declare const PREVIOUS_RUN_SUFFIX = ".previous";
+/** Tail kept per stream for the previous run. */
+export declare const PREVIOUS_RUN_LOG_MAX_BYTES: number;
+/**
+ * Previous runs kept per stream: `.previous` is the newest, then `.previous.2`
+ * and `.previous.3`. One generation was not enough: when a service crashed
+ * three times in a row and a later restart failed under ENFILE, the failed
+ * archive copy left only the last run. The older runs shift up first, so a
+ * failed copy loses nothing already archived. Distinct from size rotation's
+ * `.1`..`.N` (pm.md U3).
+ */
+export declare const PREVIOUS_RUN_GENERATIONS = 3;
+export declare function resolveRunEndInitiator(existing: ProcessState, updates: Partial<ProcessState>, pending?: RunEndInitiator): RunEndInitiator;
+/**
+ * Append `banner` to the current logs and copy their (capped) tail to
+ * `.previous`, through the handed runtime's filesystem.
+ * The current file is copied, never renamed: until the next start truncates
+ * it, `pm logs <id>` must keep reading the run that just ended.
+ *
+ * The banner is appended through the filesystem kind's `append` and the capped
+ * tail is read with its ranged read, so a stream is never read whole or rewritten.
+ */
+export declare function archiveRunLogs(runtime: RuntimeRef, options: ArchiveRunLogsOptions): Promise<ArchiveRunLogsResult>;
+/** Every previous-run archive of the stream log at `logPath`: `.previous`, then `.previous.2` … `.previous.N`. */
+export declare function previousRunLogPaths(logPath: string): string[];
+/**
+ * A `ProcessStore.onRunEnd` listener. Archives once per (processId, pid): a
+ * health-kill retires the same pid twice — the monitor's write, then
+ * lifecycle's exit handler — and must not double-stamp the log.
+ */
+export declare function createProcessRunArchiver(options: ProcessRunArchiverOptions): (event: ProcessRunEnd) => Promise<void>;
+//# sourceMappingURL=process-log-archive.d.ts.map

package/dist/services/process-log-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-log-archive.d.ts","sourceRoot":"","sources":["../../src/services/process-log-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/G,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE/G,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE9G,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,QAAc,CAAC;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,OAAO,CAAC,EAAE,eAAe,GACvB,eAAe,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAavH;AA0BD,kHAAkH;AAClH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAG7D;AAwBD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,yBAAyB,GAChC,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAiCzC"}

package/dist/services/process-log-archive.js

@@ -0,0 +1,150 @@
+/**
+ * Previous-run log archive.
+ *
+ * `LifecycleService.truncateLogs` rewrites `<id>.stdout` / `<id>.stderr` with
+ * a "Process started at" marker on EVERY start, so the crash reason of the
+ * run that just ended is gone by the time anyone looks (measured 2026-09-06:
+ * mcp-server-dev at 882 lifetime restarts, its stdout holding the 207-byte
+ * marker and nothing else). Its own size-based rotation fires only past 100MB.
+ *
+ * The end of a run is observable at the store: every writer that retires a
+ * pid — lifecycle's exit handler, `stop`, the daemon health monitor's kill,
+ * the liveness checker — does so through `ProcessStore.update`. This module
+ * listens there (`ProcessStore.onRunEnd`), stamps an exit banner onto the
+ * current logs so `pm logs` shows it until the next start, and copies one
+ * size-capped generation to `<id>.stdout.previous` / `<id>.stderr.previous`,
+ * where the next start cannot reach it.
+ *
+ * One generation, under its own name (pm.md U3): size rotation
+ * (the logging owner's `rotateAppendedFile`) owns `.1`..`.N`, and the archive once wrote `.1`
+ * too, so each overwrote the other's evidence.
+ */
+import { getRuntimePath } from '@vibesdotdev/paths';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { appendFileChecked, readFileRangeChecked } from '@vibesdotdev/filesystem/core';
+import { attempt } from "../utils/attempt.js";
+import { formatRunEndBanner } from "./run-log-frames.js";
+export { describeExitCode, formatRunEndBanner, formatRunStartMarker, runOutputOf } from "./run-log-frames.js";
+/** The previous-run archive's suffix: distinct from size rotation's `.1`..`.N`. */
+export const PREVIOUS_RUN_SUFFIX = '.previous';
+/** Tail kept per stream for the previous run. */
+export const PREVIOUS_RUN_LOG_MAX_BYTES = 1024 * 1024;
+/**
+ * Previous runs kept per stream: `.previous` is the newest, then `.previous.2`
+ * and `.previous.3`. One generation was not enough: when a service crashed
+ * three times in a row and a later restart failed under ENFILE, the failed
+ * archive copy left only the last run. The older runs shift up first, so a
+ * failed copy loses nothing already archived. Distinct from size rotation's
+ * `.1`..`.N` (pm.md U3).
+ */
+export const PREVIOUS_RUN_GENERATIONS = 3;
+export function resolveRunEndInitiator(existing, updates, pending) {
+    if (updates.killedByDaemon === true || existing.killedByDaemon === true)
+        return 'health-kill';
+    return pending ?? 'exit';
+}
+/**
+ * Append `banner` to the current logs and copy their (capped) tail to
+ * `.previous`, through the handed runtime's filesystem.
+ * The current file is copied, never renamed: until the next start truncates
+ * it, `pm logs <id>` must keep reading the run that just ended.
+ *
+ * The banner is appended through the filesystem kind's `append` and the capped
+ * tail is read with its ranged read, so a stream is never read whole or rewritten.
+ */
+export async function archiveRunLogs(runtime, options) {
+    const maxBytes = options.maxBytes ?? PREVIOUS_RUN_LOG_MAX_BYTES;
+    const files = await resolveFileSystemAdapter(runtime, { binding: false });
+    const path = await getRuntimePath(runtime);
+    const result = { archived: [], failed: [] };
+    for (const stream of ['stdout', 'stderr']) {
+        const logPath = path.join(options.logDir, `${options.processId}.${stream}`);
+        const previousPath = `${logPath}${PREVIOUS_RUN_SUFFIX}`;
+        const archived = await attempt(() => archiveStream(files, logPath, previousPath, options.banner, maxBytes));
+        if (!archived.ok)
+            result.failed.push({ path: logPath, failure: archived.failure });
+        else if (archived.value)
+            result.archived.push(previousPath);
+    }
+    return result;
+}
+/** Stamp one stream's banner and write its capped tail to `previousPath`; false when the stream has no log. */
+async function archiveStream(files, logPath, previousPath, banner, maxBytes) {
+    if (!(await files.exists(logPath)))
+        return false;
+    await appendFileChecked(files, logPath, banner);
+    // Only the capped tail is read: a ranged read from `offset`, never the whole log.
+    const { size } = await files.stat(logPath);
+    const offset = Math.max(0, size - maxBytes);
+    const kept = await readFileRangeChecked(files, logPath, { offset, length: size - offset });
+    await shiftPreviousRuns(files, previousPath);
+    await files.writeFile(previousPath, previousRunTail(kept, offset));
+    return true;
+}
+/** The archive of previous run `generation` (1 is `.previous` itself). */
+function previousRunPath(previousPath, generation) {
+    return generation === 1 ? previousPath : `${previousPath}.${generation}`;
+}
+/** Every previous-run archive of the stream log at `logPath`: `.previous`, then `.previous.2` … `.previous.N`. */
+export function previousRunLogPaths(logPath) {
+    const previousPath = `${logPath}${PREVIOUS_RUN_SUFFIX}`;
+    return Array.from({ length: PREVIOUS_RUN_GENERATIONS }, (_, index) => previousRunPath(previousPath, index + 1));
+}
+/** `.previous.(N-1)` becomes `.previous.N` down to `.previous` becoming `.previous.2`, dropping the oldest; a missing generation is skipped. */
+async function shiftPreviousRuns(files, previousPath) {
+    const oldest = previousRunPath(previousPath, PREVIOUS_RUN_GENERATIONS);
+    if (await files.exists(oldest))
+        await files.remove(oldest);
+    for (let generation = PREVIOUS_RUN_GENERATIONS - 1; generation >= 1; generation--) {
+        const from = previousRunPath(previousPath, generation);
+        if (await files.exists(from))
+            await files.rename(from, previousRunPath(previousPath, generation + 1));
+    }
+}
+/** The previous run as `.previous` holds it: all of the log, or its last bytes (`kept`) under a header that says how many earlier bytes (`dropped`) were left out. */
+function previousRunTail(kept, dropped) {
+    if (dropped === 0)
+        return kept;
+    const header = new TextEncoder().encode(`[pm] previous run: ${dropped} earlier bytes dropped, last ${kept.length} kept\n`);
+    const tail = new Uint8Array(header.length + kept.length);
+    tail.set(header);
+    tail.set(kept, header.length);
+    return tail;
+}
+/**
+ * A `ProcessStore.onRunEnd` listener. Archives once per (processId, pid): a
+ * health-kill retires the same pid twice — the monitor's write, then
+ * lifecycle's exit handler — and must not double-stamp the log.
+ */
+export function createProcessRunArchiver(options) {
+    const archivedPids = new Map();
+    return async ({ existing, updates }) => {
+        const pid = existing.pid;
+        if (pid === undefined)
+            return;
+        if (archivedPids.get(existing.id) === pid)
+            return;
+        archivedPids.set(existing.id, pid);
+        const initiator = resolveRunEndInitiator(existing, updates, options.pendingInitiator?.(existing.id));
+        const banner = formatRunEndBanner({
+            at: options.now?.() ?? new Date(),
+            exitCode: updates.exitCode ?? existing.exitCode,
+            signal: updates.signal ?? existing.signal,
+            initiator,
+            reason: updates.lastError ?? existing.lastError
+        });
+        const result = await archiveRunLogs(options.getRuntime(), {
+            logDir: options.logDir,
+            processId: existing.id,
+            banner,
+            maxBytes: options.maxBytes
+        });
+        if (result.archived.length > 0) {
+            options.onArchived?.({ processId: existing.id, initiator, archived: result.archived });
+        }
+        if (result.failed.length > 0) {
+            options.onFailed?.({ processId: existing.id, failed: result.failed });
+        }
+    };
+}
+//# sourceMappingURL=process-log-archive.js.map

package/dist/services/process-log-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-log-archive.js","sourceRoot":"","sources":["../../src/services/process-log-archive.ts"],"names":[],"mappings":"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"}

package/dist/services/run-log-frames.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The frames PM writes around a run's log.
+ *
+ * Host-free by construction: pure string and `Date` work, no runtime, no
+ * filesystem, no paths. `LifecycleService` writes the frames with these
+ * functions, and a consumer that only wants what the process wrote strips them
+ * with `runOutputOf` — including `@vibesdotdev/pm/tasks`, which must stay
+ * host-free so the cloud graph can run it.
+ *
+ * PM owns both frames, so only PM parses them. The previous-run archive
+ * (host-bound) imports the writers from here; `./run-output` exports the reader.
+ */
+import type { RunEndBannerInput } from './types/index.ts';
+export type { RunEndBannerInput } from './types/index.ts';
+/** Honest wording: lifecycle maps a signal death to -1 and drops the name. */
+export declare function describeExitCode(exitCode: number | undefined, signal: string | undefined): string;
+/** The marker `LifecycleService` writes at the head of each log when a run starts. */
+export declare function formatRunStartMarker(timestamp: string): string;
+export declare function formatRunEndBanner(input: RunEndBannerInput): string;
+/**
+ * What one run of a process wrote, without the start marker and exit banner
+ * PM frames its logs with: the current log of a finished run, as
+ * `readLogsSince(id, { stdout: 0, stderr: 0 })` returns it.
+ */
+export declare function runOutputOf(log: string): string;
+//# sourceMappingURL=run-log-frames.d.ts.map

package/dist/services/run-log-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-frames.d.ts","sourceRoot":"","sources":["../../src/services/run-log-frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKjG;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAQnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/services/run-log-frames.js

@@ -0,0 +1,45 @@
+/**
+ * The frames PM writes around a run's log.
+ *
+ * Host-free by construction: pure string and `Date` work, no runtime, no
+ * filesystem, no paths. `LifecycleService` writes the frames with these
+ * functions, and a consumer that only wants what the process wrote strips them
+ * with `runOutputOf` — including `@vibesdotdev/pm/tasks`, which must stay
+ * host-free so the cloud graph can run it.
+ *
+ * PM owns both frames, so only PM parses them. The previous-run archive
+ * (host-bound) imports the writers from here; `./run-output` exports the reader.
+ */
+const RULE = '='.repeat(80);
+/** Honest wording: lifecycle maps a signal death to -1 and drops the name. */
+export function describeExitCode(exitCode, signal) {
+    if (signal)
+        return `signal ${signal}`;
+    if (exitCode === undefined)
+        return 'exit code not recorded';
+    if (exitCode === -1)
+        return 'exit code -1 (signal-terminated or unknown; PM records no signal name)';
+    return `exit code ${exitCode}`;
+}
+/** The marker `LifecycleService` writes at the head of each log when a run starts. */
+export function formatRunStartMarker(timestamp) {
+    return `\n${RULE}\nProcess started at ${timestamp}\n${RULE}\n`;
+}
+const RUN_START_MARKER = new RegExp(`^\\n${RULE}\\nProcess started at [^\\n]*\\n${RULE}\\n`);
+const RUN_END_BANNER = new RegExp(`\\n${RULE}\\nProcess exited at [^\\n]*\\n${RULE}\\n$`);
+export function formatRunEndBanner(input) {
+    const reason = input.reason ? ` — ${input.reason.replace(/\s+/g, ' ').trim().slice(0, 400)}` : '';
+    return (`\n${RULE}\n` +
+        `Process exited at ${input.at.toISOString()} — ${describeExitCode(input.exitCode, input.signal)}` +
+        ` — initiator: ${input.initiator}${reason}\n` +
+        `${RULE}\n`);
+}
+/**
+ * What one run of a process wrote, without the start marker and exit banner
+ * PM frames its logs with: the current log of a finished run, as
+ * `readLogsSince(id, { stdout: 0, stderr: 0 })` returns it.
+ */
+export function runOutputOf(log) {
+    return log.replace(RUN_START_MARKER, '').replace(RUN_END_BANNER, '');
+}
+//# sourceMappingURL=run-log-frames.js.map

package/dist/services/run-log-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-frames.js","sourceRoot":"","sources":["../../src/services/run-log-frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5B,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,QAA4B,EAAE,MAA0B;IACxF,IAAI,MAAM;QAAE,OAAO,UAAU,MAAM,EAAE,CAAC;IACtC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,wBAAwB,CAAC;IAC5D,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,wEAAwE,CAAC;IACrG,OAAO,aAAa,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACrD,OAAO,KAAK,IAAI,wBAAwB,SAAS,KAAK,IAAI,IAAI,CAAC;AAChE,CAAC;AAED,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,OAAO,IAAI,mCAAmC,IAAI,KAAK,CAAC,CAAC;AAC7F,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,kCAAkC,IAAI,MAAM,CAAC,CAAC;AAE1F,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,OAAO,CACN,KAAK,IAAI,IAAI;QACb,qBAAqB,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QACjG,iBAAiB,KAAK,CAAC,SAAS,GAAG,MAAM,IAAI;QAC7C,GAAG,IAAI,IAAI,CACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/services/startup-warmup.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Is a tracked process still inside its declared health warmup?
+ *
+ * A live pid that has not bound its port yet is BOOTING, not "PID reuse".
+ * Measured 2026-09-05: the shared MCP host takes 32-43 s from spawn to bind on
+ * the developer tree; `start()` saw the pid alive but not on port 39277, logged
+ * "will restart", and the orphan scan then killed the daemon's own child the
+ * moment it bound (48 orphan kills that day). The health check already knows
+ * how long boot is allowed to take — `healthCheck.warmupMs` — so the start
+ * path honours the same window.
+ */
+export interface StartupWarmupInput {
+    /** When the tracked process was spawned (Date, ISO string, or epoch ms). */
+    startedAt: Date | string | number | null | undefined;
+    /** Declared health warmup; undefined → 30 s, the health monitor's default. */
+    warmupMs: number | null | undefined;
+    /** Current time in epoch ms. */
+    now: number;
+}
+export declare const DEFAULT_STARTUP_WARMUP_MS = 30000;
+export declare function toEpochMs(value: StartupWarmupInput['startedAt']): number | undefined;
+export declare function isWithinStartupWarmup(input: StartupWarmupInput): boolean;
+//# sourceMappingURL=startup-warmup.d.ts.map

package/dist/services/startup-warmup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-warmup.d.ts","sourceRoot":"","sources":["../../src/services/startup-warmup.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAClC,4EAA4E;IAC5E,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrD,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAUhD,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAMxE"}

package/dist/services/startup-warmup.js

@@ -0,0 +1,21 @@
+import * as z from 'zod/v4';
+export const DEFAULT_STARTUP_WARMUP_MS = 30_000;
+/** A start time as epoch ms: a finite number, a valid Date, or a parseable date string; anything else (null, undefined, NaN, an invalid Date) is none. */
+const EpochMsSchema = z
+    .union([z.number(), z.date().transform((date) => date.getTime()), z.string().transform((text) => Date.parse(text))])
+    .pipe(z.number());
+/** A declared warmup window: zero or more milliseconds, unbounded included. */
+const WarmupMsSchema = z.union([z.number().nonnegative(), z.literal(Number.POSITIVE_INFINITY)]);
+export function toEpochMs(value) {
+    const parsed = EpochMsSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+export function isWithinStartupWarmup(input) {
+    const startedAt = toEpochMs(input.startedAt);
+    if (startedAt === undefined)
+        return false;
+    const declared = WarmupMsSchema.safeParse(input.warmupMs);
+    const warmupMs = declared.success ? declared.data : DEFAULT_STARTUP_WARMUP_MS;
+    return input.now - startedAt < warmupMs;
+}
+//# sourceMappingURL=startup-warmup.js.map

package/dist/services/startup-warmup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-warmup.js","sourceRoot":"","sources":["../../src/services/startup-warmup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAsB5B,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,0JAA0J;AAC1J,MAAM,aAAa,GAAG,CAAC;KACrB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACnH,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEnB,+EAA+E;AAC/E,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,UAAU,SAAS,CAAC,KAAsC;IAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC9D,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC;IAC9E,OAAO,KAAK,CAAC,GAAG,GAAG,SAAS,GAAG,QAAQ,CAAC;AACzC,CAAC"}