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

package/dist/manager.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Process Manager
+ * Thin orchestrator composing lifecycle, health, cleanup, and workers services
+ */
+import { type AwaitExitOptions, type ProcessConfig, type ProcessExit, type ProcessState, type ProcessLogOptionsInput } from './schemas/process.ts';
+import type { PmTaskProcessIdentity, PmTaskSettlement } from './schemas/process.ts';
+import type { DaemonHealth } from './schemas/daemon.ts';
+import type { IProcessManager, StartOptions, StopOptions } from './interface.ts';
+import type { ResourceManager } from './managers/resource-manager.ts';
+import { type CleanupResult } from './services/cleanup.ts';
+import type { RunEndInitiator } from './store.impl.consumer.ts';
+import { type PMFileSystem } from './helpers/runtime-files.ts';
+import { type RuntimePath } from '@vibesdotdev/paths';
+import { type WorkerRuntimeRequestContext } from './helpers/worker-routing.ts';
+import type { LogStreamOffsets, ProcessManagerOptions } from './schemas/manager.ts';
+export type { LogStreamOffsets, ProcessManagerOptions } from './schemas/manager.ts';
+/**
+ * The complete lines `path` gained since `offset` and the offset after them.
+ * A log not written yet (`ENOENT`) has gained nothing; a log that shrank is
+ * read again from 0. Any other failure propagates.
+ */
+export declare function readCompleteLinesSince(files: PMFileSystem, path: string, offset: number): Promise<{
+    text: string;
+    next: number;
+}>;
+export declare function readProcessLogFile(files: PMFileSystem, path: string, lines?: number): Promise<string>;
+export declare function readProcessLogTail(files: PMFileSystem, path: string, lines: number): Promise<string>;
+/** The deadline of one serialized start or restart before it refuses `pm-start-restart-timeout`. */
+export declare const START_OR_RESTART_TIMEOUT_MS = 120000;
+export declare class ProcessManager implements IProcessManager {
+    private store;
+    private lifecycle;
+    private healthMonitor;
+    private readonly taskSupervision;
+    private cleanup;
+    private logDir;
+    private readonly startOrRestartTimeoutMs;
+    private scope;
+    private readonly workspaceIdentity;
+    private inFlightStartOrRestart;
+    /** Operator-initiated ends in flight, so the run-end archive can name them. */
+    private readonly pendingRunEndInitiators;
+    /** Path mechanics from the constructing caller's runtime (required for 'global'). */
+    private readonly runtimePath?;
+    /** The runtime the constructing caller was handed (a getter; see ProcessManagerOptions). */
+    private readonly getRuntime;
+    /** `getPathRoots(runtime)`, captured at construction. */
+    private readonly roots;
+    /** The handed runtime's Logging, read per entry so it follows hot-reload generations (C083a). */
+    private get logger();
+    /**
+     * 'global' scope joins its process log directory through a `RuntimePath`
+     * the caller resolved from its runtime, so `options.runtimePath` is required.
+     */
+    constructor(scope: 'global', resourceManager: ResourceManager | undefined, options: ProcessManagerOptions & {
+        runtimePath: RuntimePath;
+    });
+    constructor(scope: 'project' | 'local', resourceManager: ResourceManager | undefined, options: ProcessManagerOptions);
+    private getLogDir;
+    /** Directory holding this manager's `<id>.stdout` / `<id>.stderr`. */
+    get processLogDir(): string;
+    private getLogPaths;
+    private runStartOrRestartLocked;
+    /** The injected path service, or the one the handed runtime registers. Never cached here. */
+    private pathService;
+    private bindAdmittedProcessConfig;
+    /**
+     * Enforce the declared budget (H1) on a NEW start: with
+     * `maxManagedProcesses` managed processes already running or starting, a
+     * start of another is refused `RATE_LIMITED` `pm-budget-max-processes`.
+     * (Re)starting a process already counted adds nothing; nothing running is
+     * ever stopped to honour a tightened budget.
+     */
+    private admitWithinBudget;
+    start(input: ProcessConfig, options?: StartOptions): Promise<ProcessState>;
+    /**
+     * The operator command currently ending `processId`'s run, if any. The
+     * daemon's previous-run log archive (services/process-log-archive.ts) names
+     * the exit banner's initiator from it.
+     */
+    pendingRunEndInitiator(processId: string): RunEndInitiator | undefined;
+    stop(processId: string, options?: StopOptions): Promise<void>;
+    restart(processId: string, options?: StartOptions, guard?: {
+        expectedPid?: number;
+    }): Promise<ProcessState>;
+    getStatus(processId: string): Promise<ProcessState | undefined>;
+    getAllStatus(): Promise<ProcessState[]>;
+    /**
+     * Whether `processId` is running. A live child of ours whose socket does not
+     * answer yet is booting or busy: running, and its record stays as it is
+     * (getStatus already left it `running`). Only a dead or foreign pid is
+     * recorded stopped. Recording a booting child `stopped` with its pid kept
+     * made the next start kill it as an orphan (2026-10-11 workers loop).
+     */
+    isRunning(processId: string): Promise<boolean>;
+    health(): Promise<DaemonHealth | null>;
+    touch(processId: string, timestamp?: Date | number): Promise<void>;
+    cleanupIdleProcesses(_now?: number): Promise<string[]>;
+    cleanupEphemeralProcesses(_now?: number): Promise<string[]>;
+    /** Remove the process logs older than `maxAgeMs` (see `CleanupService.cleanupExpiredLogs`). */
+    cleanupExpiredLogs(maxAgeMs: number): Promise<CleanupResult>;
+    getEphemeralCleanupTimeoutMs(): number;
+    setEphemeralCleanupTimeoutMs(timeoutMs: number): void;
+    getLogs(processId: string, options?: ProcessLogOptionsInput): Promise<string>;
+    /**
+     * What each stream gained since `offsets`, redacted (RC05), for `pm logs
+     * --follow`. Only complete lines are returned, so a value never straddles
+     * two reads unredacted; the partial tail waits for its newline. A stream
+     * that shrank was rotated or truncated and is read again from 0.
+     */
+    readLogsSince(processId: string, offsets: LogStreamOffsets): Promise<{
+        stdout: string;
+        stderr: string;
+        offsets: LogStreamOffsets;
+    }>;
+    waitForHealthy(processId: string, timeout?: number): Promise<void>;
+    register(config: ProcessConfig): Promise<void>;
+    registerMany(configs: ProcessConfig[]): Promise<void>;
+    unregister(processId: string): Promise<boolean>;
+    admitSupervisedTask(identity: PmTaskProcessIdentity, config: ProcessConfig, release: boolean, launch: () => Promise<ProcessState>, signal?: AbortSignal): Promise<{
+        id: string;
+        status: "pass" | "stopping" | "stopped" | "running" | "crashed" | "starting" | "completed" | "waiting" | "fail";
+        restartCount: number;
+        consecutiveCrashRestarts: number;
+        retryCount: number;
+        pid?: number | undefined;
+        startedAt?: Date | undefined;
+        stoppedAt?: Date | undefined;
+        lastError?: string | undefined;
+        healthStatus?: "unknown" | "healthy" | "unhealthy" | undefined;
+        exitCode?: number | undefined;
+        signal?: string | undefined;
+        socketPath?: string | undefined;
+        lastActivity?: Date | undefined;
+        idleTimeoutMs?: number | undefined;
+        staleSocket?: boolean | undefined;
+        killedByDaemon?: boolean | undefined;
+        ephemeral?: boolean | undefined;
+        firstObservedAt?: Date | undefined;
+        commandSignature?: string | undefined;
+        adopted?: boolean | undefined;
+    }>;
+    supervisedAdmission(identity: PmTaskProcessIdentity): Promise<{
+        scope: {
+            workspacePath: string;
+            toolingId: string;
+        };
+        admissionId: string;
+        processId: string;
+        release: boolean;
+        startedAt?: number | undefined;
+        settlement?: {
+            scope: {
+                workspacePath: string;
+                toolingId: string;
+            };
+            admissionId: string;
+            processId: string;
+            startedAt: number;
+            status: "pass" | "stopped" | "crashed" | "completed" | "fail";
+            succeeded: boolean;
+            exitCode: number | null;
+            signal: string | null;
+            pid: number | null;
+            stoppedAt: number | null;
+        } | undefined;
+    } | null>;
+    acknowledgeSupervised(receipt: PmTaskSettlement): Promise<boolean>;
+    /**
+     * Remove a process through cleanup's one removal path (state, stored
+     * config, socket and logs). Returns whether a stored config existed.
+     */
+    private removeCompletely;
+    /** Observe this manager's committed process state writes (see ProcessStore.onStateChange). */
+    onStateChange(listener: (state: ProcessState) => void): () => void;
+    /**
+     * How `processId`'s run exits: its committed terminal record, awaited on
+     * the store's state writes (RC07; nothing polls). `run` names the run to
+     * await (absent: the run current now); a stale terminal record of an
+     * earlier run never answers it, and a later run refuses `CONFLICT`
+     * `pm-await-exit-run-superseded`. The deadline refuses `TIMEOUT`
+     * `pm-await-exit-timeout`; the caller's signal and the runtime's disposal
+     * end it with the lifecycle's `CANCELLED` `wait-aborted`. Refusals carry
+     * the process id only.
+     */
+    awaitExit(processId: string, options?: AwaitExitOptions): Promise<ProcessExit>;
+    getConfig(processId: string): Promise<ProcessConfig | undefined>;
+    getAllConfigs(): Promise<ProcessConfig[]>;
+    isRegistered(processId: string): Promise<boolean>;
+    upsert(config: ProcessConfig): Promise<void>;
+    remove(processId: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    isConfiguredProcess(processId: string): Promise<boolean>;
+    invalidateConfigCache(): void;
+    getSocketStatus(processId: string): Promise<{
+        exists: boolean;
+        connectable: boolean;
+        path?: string;
+    }>;
+    cleanupSocket(processId: string): Promise<void>;
+    private resolveWorkerWorkspaceRoot;
+    ensureWorkerRuntime(target?: 'consumer' | 'cloud', context?: WorkerRuntimeRequestContext): Promise<void>;
+    checkWorkersReady(timeout?: number, target?: 'consumer' | 'cloud', context?: WorkerRuntimeRequestContext): Promise<boolean>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

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