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

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * PM Utilities
+ */
+export { calculateProcessVersion, formatVersion } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/liveness.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Process Liveness Checking
+ * Unified strategy for determining if processes are actually alive
+ *
+ * Provides consistent liveness checking across all process types:
+ * - PID-based processes (generic processes)
+ * - Socket-based processes (workers, language servers)
+ * - Hybrid processes (both PID and socket)
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type HostServicesRuntime } from './process-tree.ts';
+import { type ProcessConfig, type ProcessState } from '../schemas/process.ts';
+/**
+ * Liveness checking strategy
+ */
+export declare enum LivenessStrategy {
+    /** Only check if PID is alive (for processes without sockets) */
+    PID_ONLY = "pid-only",
+    /** Only check if socket is connectable (for daemon processes) */
+    SOCKET_ONLY = "socket-only",
+    /** Both PID and socket must be alive (strict, default for socket processes) */
+    BOTH_REQUIRED = "both-required",
+    /** Either PID or socket being alive is sufficient (lenient) */
+    EITHER_SUFFICIENT = "either-sufficient"
+}
+/**
+ * Detailed liveness check result
+ */
+export interface LivenessResult {
+    /** Overall liveness verdict */
+    alive: boolean;
+    /** Strategy used for this check */
+    strategy: LivenessStrategy;
+    /** Detailed breakdown */
+    details: {
+        /** Process ID checked */
+        pid?: number;
+        /** Whether PID exists and is running */
+        pidAlive?: boolean;
+        /** Socket path checked */
+        socket?: string;
+        /** Whether socket file exists */
+        socketExists?: boolean;
+        /** Whether socket is connectable */
+        socketConnectable?: boolean;
+        /** Human-readable reason for the verdict */
+        reason: string;
+    };
+}
+/** Observe one PID through the supplied runtime; zero denotes no process. */
+export declare function isPIDAlive(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, pid: number): Promise<boolean>;
+/**
+ * Determine the appropriate liveness strategy for a process state
+ * Based on whether it has a socket, PID, etc.
+ *
+ * CRITICAL FIX: kubectl port-forward and similar processes have PIDs but NO active sockets
+ * even though socketPath might be set in state from config. We need to distinguish between:
+ * - Processes that SHOULD have sockets (workers, language servers)
+ * - Processes that DON'T use sockets (kubectl, generic commands)
+ *
+ * Strategy: If socketPath exists but socket doesn't exist AND never was connectable,
+ * treat it as PID_ONLY process (socket was never created, process doesn't use IPC)
+ */
+export declare function determineStrategy(runtime: HostServicesRuntime, state: ProcessState): Promise<LivenessStrategy>;
+/**
+ * Check process liveness with unified strategy
+ *
+ * This is the main entry point for all liveness checks.
+ * Provides consistent, detailed liveness checking across all process types.
+ *
+ * @param state - Process state to check
+ * @param strategy - Optional strategy override (defaults to auto-detect)
+ * @returns Detailed liveness result
+ *
+ * @example
+ * const result = await checkProcessLiveness(runtime, state);
+ * if (result.alive) {
+ *   console.log('Process is alive:', result.details.reason);
+ * } else {
+ *   console.log('Process is dead:', result.details.reason);
+ * }
+ */
+export declare function checkProcessLiveness(runtime: HostServicesRuntime, state: ProcessState, strategy?: LivenessStrategy): Promise<LivenessResult>;
+/**
+ * Simple liveness check that returns just a boolean
+ * Convenience wrapper around checkProcessLiveness
+ *
+ * @param state - Process state to check
+ * @param strategy - Optional strategy override
+ * @returns true if process is alive, false otherwise
+ */
+export declare function isProcessAlive(runtime: HostServicesRuntime, state: ProcessState, strategy?: LivenessStrategy): Promise<boolean>;
+/**
+ * Whether `state.pid` is alive and still runs this process's command (not a
+ * reused PID). A socket that refuses connections while this holds is a daemon
+ * still booting or busy, never a crash: marking it crashed makes the next
+ * start spawn a duplicate the live holder turns away.
+ */
+export declare function ownsLivePid(runtime: RuntimeRef, state: Pick<ProcessState, 'id' | 'pid'>, config: Pick<ProcessConfig, 'command' | 'args'> | undefined): Promise<boolean>;
+//# sourceMappingURL=liveness.d.ts.map

package/dist/utils/liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../src/utils/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAsB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGlG;;GAEG;AACH,oBAAY,gBAAgB;IAC3B,iEAAiE;IACjE,QAAQ,aAAa;IAErB,iEAAiE;IACjE,WAAW,gBAAgB;IAE3B,+EAA+E;IAC/E,aAAa,kBAAkB;IAE/B,+DAA+D;IAC/D,iBAAiB,sBAAsB;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;IAEf,mCAAmC;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,yBAAyB;IACzB,OAAO,EAAE;QACR,yBAAyB;QACzB,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb,wCAAwC;QACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB,0BAA0B;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,iCAAiC;QACjC,YAAY,CAAC,EAAE,OAAO,CAAC;QAEvB,oCAAoC;QACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAE5B,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED,6EAA6E;AAC7E,wBAAsB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9G;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmCpH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,CA+FzB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,KAAK,CAAC,EACvC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG,SAAS,GACzD,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/utils/liveness.js

@@ -0,0 +1,225 @@
+/**
+ * Process Liveness Checking
+ * Unified strategy for determining if processes are actually alive
+ *
+ * Provides consistent liveness checking across all process types:
+ * - PID-based processes (generic processes)
+ * - Socket-based processes (workers, language servers)
+ * - Hybrid processes (both PID and socket)
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getRuntimeProcessService } from '@vibesdotdev/kernel/process';
+import { verifyProcessOwnership } from "./process-tree.js";
+import { ProcessStateSchema } from "../schemas/process.js";
+import { getSocketInfo } from "./socket.js";
+/**
+ * Liveness checking strategy
+ */
+export var LivenessStrategy;
+(function (LivenessStrategy) {
+    /** Only check if PID is alive (for processes without sockets) */
+    LivenessStrategy["PID_ONLY"] = "pid-only";
+    /** Only check if socket is connectable (for daemon processes) */
+    LivenessStrategy["SOCKET_ONLY"] = "socket-only";
+    /** Both PID and socket must be alive (strict, default for socket processes) */
+    LivenessStrategy["BOTH_REQUIRED"] = "both-required";
+    /** Either PID or socket being alive is sufficient (lenient) */
+    LivenessStrategy["EITHER_SUFFICIENT"] = "either-sufficient";
+})(LivenessStrategy || (LivenessStrategy = {}));
+/** Observe one PID through the supplied runtime; zero denotes no process. */
+export async function isPIDAlive(runtime, pid) {
+    if (pid === 0)
+        return false;
+    const admitted = ProcessStateSchema.shape.pid.unwrap().safeParse(pid);
+    if (!admitted.success) {
+        throw new CapabilityError('Process id must be a positive safe integer or the no-process sentinel zero.', 'INVALID_INPUT', {
+            reason: 'pm-liveness-pid-invalid'
+        });
+    }
+    return (await getRuntimeProcessService(runtime)).isRunning(admitted.data);
+}
+/**
+ * Determine the appropriate liveness strategy for a process state
+ * Based on whether it has a socket, PID, etc.
+ *
+ * CRITICAL FIX: kubectl port-forward and similar processes have PIDs but NO active sockets
+ * even though socketPath might be set in state from config. We need to distinguish between:
+ * - Processes that SHOULD have sockets (workers, language servers)
+ * - Processes that DON'T use sockets (kubectl, generic commands)
+ *
+ * Strategy: If socketPath exists but socket doesn't exist AND never was connectable,
+ * treat it as PID_ONLY process (socket was never created, process doesn't use IPC)
+ */
+export async function determineStrategy(runtime, state) {
+    const hasPID = !!state.pid;
+    const hasSocketPath = !!state.socketPath;
+    // If no socket path configured, use PID-only
+    if (!hasSocketPath) {
+        return hasPID ? LivenessStrategy.PID_ONLY : LivenessStrategy.PID_ONLY;
+    }
+    // Socket path is configured - check if socket actually exists/existed
+    const socketInfo = await getSocketInfo(runtime, state.socketPath);
+    if (hasPID && hasSocketPath) {
+        // CRITICAL FIX: If socket file never existed or was never connectable,
+        // this is likely a kubectl/generic process with socketPath from config
+        // but it doesn't actually use IPC. Use PID_ONLY strategy.
+        if (!socketInfo.exists && !state.staleSocket) {
+            // Socket never existed and process never had a stale socket
+            // This means the process doesn't use IPC despite having socketPath in config
+            return LivenessStrategy.PID_ONLY;
+        }
+        // Process has both and socket exists/existed - use strict checking
+        return LivenessStrategy.BOTH_REQUIRED;
+    }
+    else if (hasSocketPath && !hasPID) {
+        // Socket-only process (like daemon)
+        return LivenessStrategy.SOCKET_ONLY;
+    }
+    else if (hasPID && !hasSocketPath) {
+        // PID-only process (generic process)
+        return LivenessStrategy.PID_ONLY;
+    }
+    else {
+        // No PID and no socket - can't check liveness
+        // Default to PID_ONLY but it will fail
+        return LivenessStrategy.PID_ONLY;
+    }
+}
+/**
+ * Check process liveness with unified strategy
+ *
+ * This is the main entry point for all liveness checks.
+ * Provides consistent, detailed liveness checking across all process types.
+ *
+ * @param state - Process state to check
+ * @param strategy - Optional strategy override (defaults to auto-detect)
+ * @returns Detailed liveness result
+ *
+ * @example
+ * const result = await checkProcessLiveness(runtime, state);
+ * if (result.alive) {
+ *   console.log('Process is alive:', result.details.reason);
+ * } else {
+ *   console.log('Process is dead:', result.details.reason);
+ * }
+ */
+export async function checkProcessLiveness(runtime, state, strategy) {
+    const selectedStrategy = strategy || (await determineStrategy(runtime, state));
+    // Check PID if needed
+    let pidAlive;
+    if (selectedStrategy === LivenessStrategy.PID_ONLY ||
+        selectedStrategy === LivenessStrategy.BOTH_REQUIRED ||
+        selectedStrategy === LivenessStrategy.EITHER_SUFFICIENT) {
+        if (state.pid) {
+            pidAlive = await isPIDAlive(runtime, state.pid);
+        }
+        else {
+            pidAlive = false;
+        }
+    }
+    // Check socket if needed
+    let socketExists;
+    let socketConnectable;
+    if (selectedStrategy === LivenessStrategy.SOCKET_ONLY ||
+        selectedStrategy === LivenessStrategy.BOTH_REQUIRED ||
+        selectedStrategy === LivenessStrategy.EITHER_SUFFICIENT) {
+        if (state.socketPath) {
+            const socketInfo = await getSocketInfo(runtime, state.socketPath);
+            socketExists = socketInfo.exists;
+            socketConnectable = socketInfo.connectable;
+        }
+        else {
+            socketExists = false;
+            socketConnectable = false;
+        }
+    }
+    // Determine overall liveness based on strategy
+    let alive = false;
+    let reason = '';
+    switch (selectedStrategy) {
+        case LivenessStrategy.PID_ONLY:
+            alive = pidAlive === true;
+            reason = alive ? `PID ${state.pid} is alive` : `PID ${state.pid || 'N/A'} is not running`;
+            break;
+        case LivenessStrategy.SOCKET_ONLY:
+            alive = socketConnectable === true;
+            if (alive) {
+                reason = `Socket is connectable at ${state.socketPath}`;
+            }
+            else if (socketExists && !socketConnectable) {
+                reason = `Socket exists but not connectable (stale)`;
+            }
+            else {
+                reason = `Socket does not exist at ${state.socketPath}`;
+            }
+            break;
+        case LivenessStrategy.BOTH_REQUIRED:
+            alive = pidAlive === true && socketConnectable === true;
+            if (alive) {
+                reason = `Both PID ${state.pid} and socket are alive`;
+            }
+            else if (!pidAlive && !socketConnectable) {
+                reason = `Both PID and socket are dead`;
+            }
+            else if (!pidAlive) {
+                reason = `PID ${state.pid} is dead (socket is alive)`;
+            }
+            else {
+                reason = `Socket is dead (PID ${state.pid} is alive)`;
+            }
+            break;
+        case LivenessStrategy.EITHER_SUFFICIENT:
+            alive = pidAlive === true || socketConnectable === true;
+            if (alive && pidAlive && socketConnectable) {
+                reason = `Both PID ${state.pid} and socket are alive`;
+            }
+            else if (alive && pidAlive) {
+                reason = `PID ${state.pid} is alive (socket is dead)`;
+            }
+            else if (alive && socketConnectable) {
+                reason = `Socket is alive (PID is dead)`;
+            }
+            else {
+                reason = `Both PID and socket are dead`;
+            }
+            break;
+    }
+    return {
+        alive,
+        strategy: selectedStrategy,
+        details: {
+            pid: state.pid,
+            pidAlive,
+            socket: state.socketPath,
+            socketExists,
+            socketConnectable,
+            reason
+        }
+    };
+}
+/**
+ * Simple liveness check that returns just a boolean
+ * Convenience wrapper around checkProcessLiveness
+ *
+ * @param state - Process state to check
+ * @param strategy - Optional strategy override
+ * @returns true if process is alive, false otherwise
+ */
+export async function isProcessAlive(runtime, state, strategy) {
+    const result = await checkProcessLiveness(runtime, state, strategy);
+    return result.alive;
+}
+/**
+ * Whether `state.pid` is alive and still runs this process's command (not a
+ * reused PID). A socket that refuses connections while this holds is a daemon
+ * still booting or busy, never a crash: marking it crashed makes the next
+ * start spawn a duplicate the live holder turns away.
+ */
+export async function ownsLivePid(runtime, state, config) {
+    if (!state.pid)
+        return false;
+    const verifyTokens = config ? [config.command, ...(config.args || [])].filter(Boolean) : [state.id];
+    const ownership = await verifyProcessOwnership(runtime, state.pid, state.id, verifyTokens);
+    return ownership.owned;
+}
+//# sourceMappingURL=liveness.js.map

package/dist/utils/liveness.js.map

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

package/dist/utils/logging.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PM logging utilities aligned with runtime logging descriptors.
+ */
+import { type RuntimeLogger } from '@vibesdotdev/logging';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import { type PMPathOptions, type PMPathRuntime, type VibesHomeResolverOptions } from './vibes-home.ts';
+export declare const PM_DAEMON_LOG_OUTPUT_ID = "pm-daemon";
+/**
+ * The declared rotation policy (logging config manifest, `logging.rotation`)
+ * for every file PM's processes and daemon append to directly: a child's
+ * `<id>.stdout|stderr` and the daemon's stdio logs. The logging owner rotates
+ * them (`rotateAppendedFile`, copy+truncate for an O_APPEND writer; L1).
+ */
+export declare const PM_CAPTURE_ROTATION_POLICY = "pm.process-capture";
+/**
+ * The PM daemon logger on `runtime`'s Logging, never an ambient default
+ * (C083a): an unprepared runtime refuses at emit with Logging's typed
+ * `logger-not-initialized`.
+ */
+export declare function getPMDaemonLogger(runtime: RuntimeRef, scope?: 'global' | 'project' | 'local'): RuntimeLogger;
+/** A PM error as the log context carries it. */
+export interface FormattedPMError {
+    error: string;
+    stack?: string;
+}
+export declare function formatPMError(error: Error | string | number | boolean | bigint | symbol | null | undefined | unknown): FormattedPMError;
+export declare function getPMDaemonLogPath(options: PMPathOptions | VibesHomeResolverOptions): string;
+/**
+ * Captures the raw stdout of one admitted workspace's detached PM daemon:
+ * `pm-daemon-<toolingId>.stdout.log`, next to `pm-daemon.log`. The PM CLI
+ * tails it during long-running RPCs (preset start/restart/teardown) so users
+ * see daemon-side progress. Named per workspace (pm.md C16): one shared file
+ * showed every workspace's daemon output in every workspace's terminal.
+ * `workspace` is the admitted root or its tooling id; there is no default.
+ */
+export declare function getPMDaemonStdoutLogPath(workspace: string, options: PMPathOptions | VibesHomeResolverOptions): string;
+/** The same daemon's raw stderr (unhandled errors during start land here). */
+export declare function getPMDaemonStderrLogPath(workspace: string, options: PMPathOptions | VibesHomeResolverOptions): string;
+/** The stdout log of the admitted workspace of `runtime`'s binding (what a CLI follows). */
+export declare function getAdmittedPMDaemonStdoutLogPath(runtime: Pick<RuntimeRef, 'context'> & PMPathRuntime): Promise<string>;
+/** What the daemon-log readers take from the runtime they are handed. */
+type PMLogRuntime = RuntimeRef & PMPathRuntime;
+/** The PM daemon log's last `lines` lines, from the handed runtime's log output, else its roots' log file. */
+export declare function readPMDaemonLogTail(runtime: PMLogRuntime, lines?: number): Promise<string[]>;
+/**
+ * The PM CLI error logger. A live logger resolves its sink on every call
+ * (`createLiveLogger`), so it holds no state worth caching: each call builds
+ * one, and nothing module-level outlives a runtime.
+ */
+export declare function getCLIErrorLogger(runtime: RuntimeRef): RuntimeLogger;
+/** Log a PM CLI error on `runtime`'s Logging and return the daemon log path (under `options.roots`) that holds it. */
+export declare function logPMError(runtime: RuntimeRef, error: Error | string | number | boolean | bigint | symbol | null | undefined | unknown, options: PMPathOptions | VibesHomeResolverOptions, context?: {
+    command?: string;
+    operation?: string;
+    processId?: string;
+    presetId?: string;
+    resourceId?: string;
+}): string;
+export {};
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEN,KAAK,aAAa,EAIlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAM9I,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAqE/D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,GAAE,QAAQ,GAAG,SAAS,GAAG,OAAkB,GAAG,aAAa,CAEtH;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GACrF,gBAAgB,CAQlB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,wBAAwB,GAAG,MAAM,CAQ5F;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,wBAAwB,GAAG,MAAM,CAErH;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,wBAAwB,GAAG,MAAM,CAErH;AAED,4FAA4F;AAC5F,wBAAsB,gCAAgC,CACrD,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,aAAa,GAClD,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,yEAAyE;AACzE,KAAK,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AA6B/C,8GAA8G;AAC9G,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM9F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAEpE;AAED,sHAAsH;AACtH,wBAAgB,UAAU,CACzB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EACvF,OAAO,EAAE,aAAa,GAAG,wBAAwB,EACjD,OAAO,CAAC,EAAE;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GACC,MAAM,CAUR"}

package/dist/utils/logging.js

@@ -0,0 +1,169 @@
+/**
+ * PM logging utilities aligned with runtime logging descriptors.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { getVibesLogDir, resolvePMPathOptions } from "./vibes-home.js";
+import { resolveWorkspaceIdentifier } from '@vibesdotdev/identity';
+import { requireAdmittedWorkspace } from "../admission.js";
+import { pmFileSystem, readTextFileIfPresent } from "../helpers/runtime-files.js";
+import { joinUnder } from "./path-under.js";
+export const PM_DAEMON_LOG_OUTPUT_ID = 'pm-daemon';
+/**
+ * The declared rotation policy (logging config manifest, `logging.rotation`)
+ * for every file PM's processes and daemon append to directly: a child's
+ * `<id>.stdout|stderr` and the daemon's stdio logs. The logging owner rotates
+ * them (`rotateAppendedFile`, copy+truncate for an O_APPEND writer; L1).
+ */
+export const PM_CAPTURE_ROTATION_POLICY = 'pm.process-capture';
+function resolveLogger(runtime, scope, operations) {
+    let logger = getLogger('pm-daemon', runtime).withContext({
+        service: 'pm-daemon',
+        scope
+    });
+    for (const operation of operations) {
+        if (operation.type === 'child') {
+            logger = logger.child(operation.value);
+        }
+        else {
+            logger = logger.withContext(operation.value);
+        }
+    }
+    return logger;
+}
+function createLiveLogger(runtime, scope, operations = []) {
+    return {
+        get namespace() {
+            return resolveLogger(runtime, scope, operations).namespace;
+        },
+        get fullNamespace() {
+            return resolveLogger(runtime, scope, operations).fullNamespace;
+        },
+        debug(message, context) {
+            resolveLogger(runtime, scope, operations).debug(message, context);
+        },
+        info(message, context) {
+            resolveLogger(runtime, scope, operations).info(message, context);
+        },
+        warn(message, context) {
+            resolveLogger(runtime, scope, operations).warn(message, context);
+        },
+        error(message, context) {
+            resolveLogger(runtime, scope, operations).error(message, context);
+        },
+        child(options) {
+            return createLiveLogger(runtime, scope, [...operations, { type: 'child', value: options }]);
+        },
+        withContext(context) {
+            return createLiveLogger(runtime, scope, [...operations, { type: 'context', value: context }]);
+        },
+        withRequestContext(context) {
+            return resolveLogger(runtime, scope, operations).withRequestContext(context);
+        },
+        withJobContext(context) {
+            return resolveLogger(runtime, scope, operations).withJobContext(context);
+        },
+        performanceTracker(params) {
+            return resolveLogger(runtime, scope, operations).performanceTracker(params);
+        }
+    };
+}
+/**
+ * The PM daemon logger on `runtime`'s Logging, never an ambient default
+ * (C083a): an unprepared runtime refuses at emit with Logging's typed
+ * `logger-not-initialized`.
+ */
+export function getPMDaemonLogger(runtime, scope = 'global') {
+    return createLiveLogger(runtime, scope);
+}
+export function formatPMError(error) {
+    if (error instanceof Error) {
+        const formatted = { error: error.message };
+        if (error.stack)
+            formatted.stack = error.stack;
+        return formatted;
+    }
+    return { error: String(error) };
+}
+export function getPMDaemonLogPath(options) {
+    // The daemon log triple (structured + stdout + stderr) lives together in the
+    // canonical Vibes log dir (VIBES_LOG_DIR override → profile-aware vibes home).
+    // The old workspace-relative resolution anchored to whatever cwd resolved —
+    // under tests/subdirs that meant pm/logs, and a GUI-spawned daemon
+    // (cwd=/) would have written to /logs. Same anchoring disease class as the
+    // vibes-context fix; finishes the stewardship branch's vibes-home seam.
+    return joinUnder(options, getVibesLogDir(options), 'pm-daemon.log');
+}
+/**
+ * Captures the raw stdout of one admitted workspace's detached PM daemon:
+ * `pm-daemon-<toolingId>.stdout.log`, next to `pm-daemon.log`. The PM CLI
+ * tails it during long-running RPCs (preset start/restart/teardown) so users
+ * see daemon-side progress. Named per workspace (pm.md C16): one shared file
+ * showed every workspace's daemon output in every workspace's terminal.
+ * `workspace` is the admitted root or its tooling id; there is no default.
+ */
+export function getPMDaemonStdoutLogPath(workspace, options) {
+    return joinUnder(options, getVibesLogDir(options), `pm-daemon-${resolveWorkspaceIdentifier(workspace)}.stdout.log`);
+}
+/** The same daemon's raw stderr (unhandled errors during start land here). */
+export function getPMDaemonStderrLogPath(workspace, options) {
+    return joinUnder(options, getVibesLogDir(options), `pm-daemon-${resolveWorkspaceIdentifier(workspace)}.stderr.log`);
+}
+/** The stdout log of the admitted workspace of `runtime`'s binding (what a CLI follows). */
+export async function getAdmittedPMDaemonStdoutLogPath(runtime) {
+    const admitted = await requireAdmittedWorkspace(runtime);
+    return getPMDaemonStdoutLogPath(admitted.root, await resolvePMPathOptions(runtime));
+}
+/**
+ * The daemon log's `logging/output` tail. A runtime that registers no output
+ * kind has none (`[]`); a registered output that fails to resolve or read
+ * propagates.
+ */
+async function readFromRuntimeOutput(runtime, lines) {
+    if (!runtime.hasKind('logging/output')) {
+        return [];
+    }
+    const output = await runtime
+        .query('logging/output')
+        .withId(PM_DAEMON_LOG_OUTPUT_ID)
+        .resolve();
+    return output.read({ lines });
+}
+/** The daemon log file's tail; a log that does not exist yet has none (`ENOENT` → `[]`). */
+async function readFromFile(runtime, lines) {
+    const content = await readTextFileIfPresent(await pmFileSystem(runtime), getPMDaemonLogPath(await resolvePMPathOptions(runtime)));
+    if (content === undefined)
+        return [];
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .slice(-lines);
+}
+/** The PM daemon log's last `lines` lines, from the handed runtime's log output, else its roots' log file. */
+export async function readPMDaemonLogTail(runtime, lines = 50) {
+    const fromOutput = await readFromRuntimeOutput(runtime, lines);
+    if (fromOutput.length > 0) {
+        return fromOutput;
+    }
+    return readFromFile(runtime, lines);
+}
+/**
+ * The PM CLI error logger. A live logger resolves its sink on every call
+ * (`createLiveLogger`), so it holds no state worth caching: each call builds
+ * one, and nothing module-level outlives a runtime.
+ */
+export function getCLIErrorLogger(runtime) {
+    return getPMDaemonLogger(runtime, 'global').child('cli').withContext({ service: 'pm-cli' });
+}
+/** Log a PM CLI error on `runtime`'s Logging and return the daemon log path (under `options.roots`) that holds it. */
+export function logPMError(runtime, error, options, context) {
+    const logger = getCLIErrorLogger(runtime);
+    const formatted = formatPMError(error);
+    const entry = { error: formatted.error };
+    if (formatted.stack)
+        entry.stack = formatted.stack;
+    Object.assign(entry, context);
+    logger.error('PM CLI error', entry);
+    return getPMDaemonLogPath(options);
+}
+//# sourceMappingURL=logging.js.map

package/dist/utils/logging.js.map

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

package/dist/utils/path-under.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Joining a path under an absolute base for the helpers that name PM files.
+ *
+ * A caller that holds the handed runtime's `RuntimePath` passes it (as
+ * `PMPathOptions`) and gets that host's mechanics. A caller that has only the
+ * roots (`VibesHomeResolverOptions`) gets `/` between segments, which every
+ * host accepts inside the absolute home its roots name. That branch is
+ * transitional: its remaining callers pass only `{ roots }`
+ * (`cli/pm.daemon.recover.impl.ts` for the pid and lock paths, and several
+ * tests); delete the branch when they pass `resolvePMPathOptions(runtime)`.
+ */
+import type { PMPathOptions, VibesHomeResolverOptions } from './vibes-home.ts';
+/** `segments` joined under the absolute directory `base`. */
+export declare function joinUnder(options: PMPathOptions | VibesHomeResolverOptions, base: string, ...segments: string[]): string;
+//# sourceMappingURL=path-under.d.ts.map

package/dist/utils/path-under.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-under.d.ts","sourceRoot":"","sources":["../../src/utils/path-under.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExH"}

package/dist/utils/path-under.js

@@ -0,0 +1,16 @@
+/**
+ * Joining a path under an absolute base for the helpers that name PM files.
+ *
+ * A caller that holds the handed runtime's `RuntimePath` passes it (as
+ * `PMPathOptions`) and gets that host's mechanics. A caller that has only the
+ * roots (`VibesHomeResolverOptions`) gets `/` between segments, which every
+ * host accepts inside the absolute home its roots name. That branch is
+ * transitional: its remaining callers pass only `{ roots }`
+ * (`cli/pm.daemon.recover.impl.ts` for the pid and lock paths, and several
+ * tests); delete the branch when they pass `resolvePMPathOptions(runtime)`.
+ */
+/** `segments` joined under the absolute directory `base`. */
+export function joinUnder(options, base, ...segments) {
+    return 'runtimePath' in options ? options.runtimePath.join(base, ...segments) : [base, ...segments].join('/');
+}
+//# sourceMappingURL=path-under.js.map

package/dist/utils/path-under.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-under.js","sourceRoot":"","sources":["../../src/utils/path-under.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,OAAiD,EAAE,IAAY,EAAE,GAAG,QAAkB;IAC/G,OAAO,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/G,CAAC"}