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

package/dist/services/state-wait.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Waits on PM's own process state (RC07): each awaits the owner's event —
+ * a committed state write (`ProcessStore.onStateChange`) — inside one
+ * `runtime.lifecycle.wait`, so it ends on the matching state, its deadline,
+ * the caller's signal or the runtime's disposal. Nothing polls.
+ */
+import type { ProcessState } from '../schemas/process.ts';
+import { type LifecycleRuntime } from '../utils/bounded-wait.ts';
+/** Where a wait reads and observes process state: the ProcessManager (or its store). */
+export interface ProcessStateSource {
+    getStatus(processId: string): Promise<ProcessState | undefined>;
+    onStateChange(listener: (state: ProcessState) => void): () => void;
+}
+export interface ProcessStateWaitOptions {
+    timeoutMs: number;
+    reason: string;
+    signal?: AbortSignal;
+}
+/**
+ * The first state of `processId` that `done` accepts: the current state, or
+ * the next committed write. Resolves undefined at the deadline; a read
+ * failure, a caller abort and the runtime's disposal reject.
+ *
+ * `done` sees every state the wait observes, in order, so a caller can report
+ * progress from it.
+ */
+export declare function waitForProcessState(runtime: LifecycleRuntime, source: ProcessStateSource, processId: string, done: (state: ProcessState) => boolean, options: ProcessStateWaitOptions): Promise<ProcessState | undefined>;
+//# sourceMappingURL=state-wait.d.ts.map

package/dist/services/state-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-wait.d.ts","sourceRoot":"","sources":["../../src/services/state-wait.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAChE,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,uBAAuB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,EACtC,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAuCnC"}

package/dist/services/state-wait.js

@@ -0,0 +1,57 @@
+/**
+ * Waits on PM's own process state (RC07): each awaits the owner's event —
+ * a committed state write (`ProcessStore.onStateChange`) — inside one
+ * `runtime.lifecycle.wait`, so it ends on the matching state, its deadline,
+ * the caller's signal or the runtime's disposal. Nothing polls.
+ */
+import { attempt } from "../utils/attempt.js";
+import { isWaitTimeout } from "../utils/bounded-wait.js";
+/**
+ * The first state of `processId` that `done` accepts: the current state, or
+ * the next committed write. Resolves undefined at the deadline; a read
+ * failure, a caller abort and the runtime's disposal reject.
+ *
+ * `done` sees every state the wait observes, in order, so a caller can report
+ * progress from it.
+ */
+export async function waitForProcessState(runtime, source, processId, done, options) {
+    const waited = await attempt(() => runtime.lifecycle.wait((signal) => new Promise((resolve, reject) => {
+        let settled = false;
+        const release = () => {
+            if (settled)
+                return false;
+            settled = true;
+            unsubscribe();
+            signal.removeEventListener('abort', onAbort);
+            return true;
+        };
+        const finish = (settle) => {
+            if (release())
+                settle();
+        };
+        const unsubscribe = source.onStateChange((state) => {
+            if (state.id === processId && done(state))
+                finish(() => resolve(state));
+        });
+        const onAbort = () => finish(() => reject(signal.reason));
+        signal.addEventListener('abort', onAbort, { once: true });
+        // The state may already satisfy the wait; subscribe first so no
+        // write between the read and the subscription is missed.
+        source
+            .getStatus(processId)
+            .then((state) => {
+            if (state && done(state))
+                finish(() => resolve(state));
+        })
+            .catch((error) => {
+            release();
+            reject(error);
+        });
+    }), options));
+    if (waited.ok)
+        return waited.value;
+    if (isWaitTimeout(waited.failure))
+        return undefined;
+    throw waited.failure;
+}
+//# sourceMappingURL=state-wait.js.map

package/dist/services/state-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-wait.js","sourceRoot":"","sources":["../../src/services/state-wait.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAyB,MAAM,0BAA0B,CAAC;AAchF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAyB,EACzB,MAA0B,EAC1B,SAAiB,EACjB,IAAsC,EACtC,OAAgC;IAEhC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CACjC,OAAO,CAAC,SAAS,CAAC,IAAI,CACrB,CAAC,MAAM,EAAE,EAAE,CACV,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,IAAI,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QACb,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAE;YACrC,IAAI,OAAO,EAAE;gBAAE,MAAM,EAAE,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE;YAClD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,gEAAgE;QAChE,yDAAyD;QACzD,MAAM;aACJ,SAAS,CAAC,SAAS,CAAC;aACpB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAoB,EAAE,EAAE;YAC/B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,EACH,OAAO,CACP,CACD,CAAC;IACF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACnC,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,MAAM,CAAC,OAAO,CAAC;AACtB,CAAC"}

package/dist/services/supervision-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The daemon's supervision policy, resolved (RC11 class: supervision, not
+ * delivery). PM restarts only what it owns (its managed children and its
+ * required daemon modules) on the lifecycle timers of the runtime it was
+ * handed; how often and how many times is `config.plugins.pm.supervision`,
+ * over these defaults, never a literal at the restart site.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+export interface RestartPolicy {
+    baseDelayMs: number;
+    factor: number;
+    maxDelayMs: number;
+    /** Consecutive failures before the supervisor gives up; `undefined` never does. */
+    maxConsecutive: number | undefined;
+}
+export interface ResolvedSupervision {
+    process: RestartPolicy;
+    portForward: RestartPolicy;
+    daemonModule: RestartPolicy;
+    maxSpawnsPerMinute: number;
+}
+/** The defaults a workspace that declares nothing is supervised by. */
+export declare const DEFAULT_SUPERVISION: ResolvedSupervision;
+/** `config.plugins.pm.supervision` over {@link DEFAULT_SUPERVISION}. An undeclared key fails the read. */
+export declare function readSupervision(runtime: Pick<RuntimeRef, 'hasContext' | 'context'>): Promise<ResolvedSupervision>;
+/**
+ * The policy a managed process restarts on: its kind's policy, with the
+ * process's own declared `restartDelay` (a non-zero base) and `maxRestarts`
+ * (its budget) winning.
+ */
+export declare function processRestartPolicy(supervision: ResolvedSupervision, config: {
+    restartDelay?: number;
+    maxRestarts?: number;
+    tags?: string[];
+}): RestartPolicy;
+/** The wait before restart attempt `attempt` (1-based). */
+export declare function restartDelayMs(policy: RestartPolicy, attempt: number): number;
+/** Whether attempt `attempt` (1-based) is within the policy's budget. */
+export declare function mayRestart(policy: RestartPolicy, attempt: number): boolean;
+//# sourceMappingURL=supervision-policy.d.ts.map

package/dist/services/supervision-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision-policy.d.ts","sourceRoot":"","sources":["../../src/services/supervision-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,aAAa,CAAC;IAC3B,YAAY,EAAE,aAAa,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAED,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,EAAE,mBAKhC,CAAC;AAWH,0GAA0G;AAC1G,wBAAsB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAQvH;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACtE,aAAa,CAOf;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/services/supervision-policy.js

@@ -0,0 +1,48 @@
+import { readPMSupervision } from "../graph.js";
+/** The defaults a workspace that declares nothing is supervised by. */
+export const DEFAULT_SUPERVISION = Object.freeze({
+    process: { baseDelayMs: 1_000, factor: 2, maxDelayMs: 30_000, maxConsecutive: 10 },
+    portForward: { baseDelayMs: 3_000, factor: 2, maxDelayMs: 30_000, maxConsecutive: 10 },
+    daemonModule: { baseDelayMs: 15_000, factor: 2, maxDelayMs: 300_000, maxConsecutive: undefined },
+    maxSpawnsPerMinute: 50
+});
+function resolvePolicy(declared, fallback) {
+    return {
+        baseDelayMs: declared?.baseDelayMs ?? fallback.baseDelayMs,
+        factor: declared?.factor ?? fallback.factor,
+        maxDelayMs: declared?.maxDelayMs ?? fallback.maxDelayMs,
+        maxConsecutive: declared?.maxConsecutive ?? fallback.maxConsecutive
+    };
+}
+/** `config.plugins.pm.supervision` over {@link DEFAULT_SUPERVISION}. An undeclared key fails the read. */
+export async function readSupervision(runtime) {
+    const declared = await readPMSupervision(runtime);
+    return {
+        process: resolvePolicy(declared.process, DEFAULT_SUPERVISION.process),
+        portForward: resolvePolicy(declared.portForward, DEFAULT_SUPERVISION.portForward),
+        daemonModule: resolvePolicy(declared.daemonModule, DEFAULT_SUPERVISION.daemonModule),
+        maxSpawnsPerMinute: declared.maxSpawnsPerMinute ?? DEFAULT_SUPERVISION.maxSpawnsPerMinute
+    };
+}
+/**
+ * The policy a managed process restarts on: its kind's policy, with the
+ * process's own declared `restartDelay` (a non-zero base) and `maxRestarts`
+ * (its budget) winning.
+ */
+export function processRestartPolicy(supervision, config) {
+    const kind = config.tags?.includes('port-forward') ? supervision.portForward : supervision.process;
+    return {
+        ...kind,
+        baseDelayMs: config.restartDelay || kind.baseDelayMs,
+        maxConsecutive: config.maxRestarts ?? kind.maxConsecutive
+    };
+}
+/** The wait before restart attempt `attempt` (1-based). */
+export function restartDelayMs(policy, attempt) {
+    return Math.min(policy.baseDelayMs * Math.pow(policy.factor, Math.max(0, attempt - 1)), policy.maxDelayMs);
+}
+/** Whether attempt `attempt` (1-based) is within the policy's budget. */
+export function mayRestart(policy, attempt) {
+    return policy.maxConsecutive === undefined || attempt <= policy.maxConsecutive;
+}
+//# sourceMappingURL=supervision-policy.js.map

package/dist/services/supervision-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision-policy.js","sourceRoot":"","sources":["../../src/services/supervision-policy.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAiBtE,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAwB,MAAM,CAAC,MAAM,CAAC;IACrE,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;IAClF,WAAW,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;IACtF,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE;IAChG,kBAAkB,EAAE,EAAE;CACtB,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,QAAqC,EAAE,QAAuB;IACpF,OAAO;QACN,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,QAAQ,CAAC,WAAW;QAC1D,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM;QAC3C,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,QAAQ,CAAC,UAAU;QACvD,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,QAAQ,CAAC,cAAc;KACnE,CAAC;AACH,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAmD;IACxF,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO;QACN,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACrE,WAAW,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,WAAW,CAAC;QACjF,YAAY,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC;QACpF,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,IAAI,mBAAmB,CAAC,kBAAkB;KACzF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,WAAgC,EAChC,MAAwE;IAExE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;IACnG,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW;QACpD,cAAc,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc;KACzD,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,MAAqB,EAAE,OAAe;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5G,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,OAAe;IAChE,OAAO,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC;AAChF,CAAC"}

package/dist/services/task-supervision.d.ts

@@ -0,0 +1,14 @@
+import { type PmTaskAdmission, type PmTaskProcessIdentity, type PmTaskSettlement, type PmTaskScope, type ProcessConfig, type ProcessState } from '../schemas/process.ts';
+import type { ProcessStore } from '../store.impl.consumer.ts';
+export declare class TaskSupervision {
+    private readonly store;
+    private readonly scope;
+    constructor(store: ProcessStore, scope: PmTaskScope);
+    private authorize;
+    admit(identity: PmTaskProcessIdentity, config: ProcessConfig, release: boolean, launch: () => Promise<ProcessState>, signal?: AbortSignal): Promise<ProcessState>;
+    private admitCurrent;
+    private requireActiveRequest;
+    lookup(identity: PmTaskProcessIdentity): Promise<PmTaskAdmission | null>;
+    acknowledge(receipt: PmTaskSettlement, forget: () => Promise<boolean>): Promise<boolean>;
+}
+//# sourceMappingURL=task-supervision.d.ts.map

package/dist/services/task-supervision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-supervision.d.ts","sourceRoot":"","sources":["../../src/services/task-supervision.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EACvE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EACvD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAS9D,qBAAa,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAgB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAA3C,KAAK,EAAE,YAAY,EAAmB,KAAK,EAAE,WAAW;IAErF,OAAO,CAAC,SAAS;IAQX,KAAK,CACV,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EACxE,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GACvD,OAAO,CAAC,YAAY,CAAC;IASxB,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,oBAAoB;IAMtB,MAAM,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAiBxE,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAiB9F"}

package/dist/services/task-supervision.js

@@ -0,0 +1,112 @@
+/** Live supervised-task obligations belong to PM's existing process config and run state. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { PmTaskAdmissionSchema, PmTaskSettlementSchema, pmTaskProcessIdentityOf, processExitOf } from "../schemas/process.js";
+import { processLaunchIdentity, processLaunchIdentityChanged } from "../helpers/launch-identity.js";
+async function launchDigest(config) {
+    const bytes = new TextEncoder().encode(processLaunchIdentity(config));
+    const digest = await crypto.subtle.digest('SHA-256', bytes);
+    return Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join('');
+}
+export class TaskSupervision {
+    store;
+    scope;
+    constructor(store, scope) {
+        this.store = store;
+        this.scope = scope;
+    }
+    authorize(identity) {
+        if (identity.scope.workspacePath !== this.scope.workspacePath || identity.scope.toolingId !== this.scope.toolingId) {
+            throw new CapabilityError('The PM admission belongs to a different daemon scope.', 'PERMISSION_DENIED', {
+                reason: 'pm-task-supervision-scope-mismatch', retryable: false
+            });
+        }
+    }
+    async admit(identity, config, release, launch, signal) {
+        this.authorize(identity);
+        if (config.id !== identity.processId)
+            throw new CapabilityError('The task does not match its PM admission.', 'INVALID_INPUT', {
+                reason: 'pm-task-supervision-identity-mismatch', retryable: false
+            });
+        const digest = await launchDigest(config);
+        return this.admitCurrent(identity, config, digest, release, launch, signal);
+    }
+    admitCurrent(identity, config, digest, release, launch, signal) {
+        return this.store.withProcessAdmission(identity.processId, async () => {
+            this.requireActiveRequest(signal);
+            const entries = await this.store.taskObligations(identity.processId);
+            const current = await this.store.get(identity.processId);
+            const retained = entries.find(entry => entry.admissionId === identity.admissionId);
+            if (retained) {
+                if (retained.launchDigest !== digest || retained.release !== release)
+                    throw new CapabilityError('The retained PM admission names different launch inputs.', 'CONFLICT', { reason: 'pm-task-supervision-identity-mismatch', details: { processId: identity.processId }, retryable: false });
+                const state = await this.store.get(identity.processId);
+                if (!state?.startedAt || retained.startedAt !== state.startedAt.getTime() || retained.release !== release) {
+                    throw new CapabilityError('The retained admission has no matching admitted PM run.', 'CONFLICT', {
+                        reason: 'pm-task-supervision-admission-unresolved', details: { processId: identity.processId }
+                    });
+                }
+                return state;
+            }
+            if (entries.length > 0 && (!current || processExitOf(current) ||
+                processLaunchIdentityChanged(await this.store.getConfig(identity.processId), config)))
+                throw new CapabilityError('A previous supervised task still owns this PM generation.', 'CONFLICT', { reason: 'pm-task-settlement-pending', details: { processId: identity.processId }, retryable: true });
+            if (!(await this.store.hasConfig(identity.processId)))
+                await this.store.setConfig(config);
+            this.requireActiveRequest(signal);
+            await this.store.setTaskObligations(identity.processId, [...entries, { admissionId: identity.admissionId, release, launchDigest: digest }]);
+            // The obligation is durable before the existing start/attach implementation runs.
+            // A failed launch remains held; absence must never be guessed into terminal proof.
+            this.requireActiveRequest(signal);
+            const state = await launch();
+            if (!state.startedAt)
+                throw new CapabilityError('The supervised task has no actual PM run generation.', 'UNAVAILABLE', {
+                    reason: 'pm-task-supervision-run-unavailable', details: { processId: identity.processId }
+                });
+            await this.store.bindTaskObligations(identity.processId, identity.admissionId, state.startedAt.getTime());
+            return state;
+        }, identity.admissionId);
+    }
+    requireActiveRequest(signal) {
+        if (signal?.aborted)
+            throw new CapabilityError('The PM task admission request was cancelled.', 'CANCELLED', {
+                reason: 'pm-task-admission-cancelled', retryable: false
+            });
+    }
+    async lookup(identity) {
+        identity = pmTaskProcessIdentityOf(identity);
+        this.authorize(identity);
+        return this.store.withProcessAdmission(identity.processId, async () => {
+            const entry = (await this.store.taskObligations(identity.processId)).find(item => item.admissionId === identity.admissionId);
+            if (!entry)
+                return null;
+            const state = await this.store.get(identity.processId);
+            const exit = state ? processExitOf(state) : undefined;
+            const settlement = exit?.startedAt && exit.startedAt.getTime() === entry.startedAt
+                ? PmTaskSettlementSchema.parse({
+                    ...identity, startedAt: entry.startedAt, stoppedAt: exit.stoppedAt?.getTime() ?? null,
+                    status: exit.status, succeeded: exit.succeeded, exitCode: exit.exitCode, signal: exit.signal, pid: exit.pid
+                }) : undefined;
+            return PmTaskAdmissionSchema.parse({ ...identity, release: entry.release, startedAt: entry.startedAt, settlement });
+        });
+    }
+    async acknowledge(receipt, forget) {
+        this.authorize(receipt);
+        return this.store.withProcessAdmission(receipt.processId, async () => {
+            const admission = await this.lookup(receipt);
+            // Idempotent no-op does not certify a missing admission or manufacture evidence.
+            if (!admission)
+                return false;
+            if (!admission.settlement || JSON.stringify(admission.settlement) !== JSON.stringify(PmTaskSettlementSchema.parse(receipt))) {
+                throw new CapabilityError('The acknowledgement does not match PM terminal evidence.', 'CONFLICT', {
+                    reason: 'pm-task-supervision-settlement-mismatch', details: { processId: receipt.processId }, retryable: false
+                });
+            }
+            const remaining = (await this.store.taskObligations(receipt.processId)).filter(entry => entry.admissionId !== receipt.admissionId);
+            await this.store.setTaskObligations(receipt.processId, remaining);
+            if (admission.release && remaining.length === 0)
+                await forget();
+            return true;
+        });
+    }
+}
+//# sourceMappingURL=task-supervision.js.map

package/dist/services/task-supervision.js.map

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

package/dist/services/types/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Service-layer contracts.
+ *
+ * Shapes the PM services exchange, kept apart from their implementations so the
+ * service modules hold behaviour and this module holds declarations. These are
+ * internal plumbing, not validated boundaries: a shape that crosses a boundary
+ * belongs to its owner's zod schema and is exported as `z.infer`, not declared
+ * here.
+ */
+import type { CaughtFailure, RuntimeRef } from '@vibesdotdev/kernel';
+import type { ProcessStore, RunEndInitiator } from '../../store.impl.consumer.ts';
+/** What `formatRunEndBanner` renders: when the run ended, how, and why it was told to end. */
+export interface RunEndBannerInput {
+    at: Date;
+    exitCode: number | undefined;
+    signal: string | undefined;
+    initiator: RunEndInitiator;
+    reason?: string;
+}
+/** Options for archiving one process's previous-run logs. */
+export interface ArchiveRunLogsOptions {
+    /** Directory holding `<id>.stdout` / `<id>.stderr` (ProcessManager's logDir). */
+    logDir: string;
+    processId: string;
+    /** Appended to each current log before it is copied. */
+    banner: string;
+    maxBytes?: number;
+}
+/** What an archive pass did, per process: the files it wrote and the ones it could not. */
+export interface ArchiveRunLogsResult {
+    archived: string[];
+    failed: Array<{
+        path: string;
+        failure: CaughtFailure;
+    }>;
+}
+/** How the process-run archiver is built. */
+export interface ProcessRunArchiverOptions {
+    /** The daemon's runtime, as a getter so the archive follows hot-reload generations: its filesystem writes the logs. */
+    getRuntime: () => RuntimeRef;
+    logDir: string;
+    /** Operator-initiated ends the manager knows about (`restart-rpc`, `stop-rpc`). */
+    pendingInitiator?: (processId: string) => RunEndInitiator | undefined;
+    maxBytes?: number;
+    now?: () => Date;
+    onArchived?: (info: {
+        processId: string;
+        initiator: RunEndInitiator;
+        archived: string[];
+    }) => void;
+    onFailed?: (info: {
+        processId: string;
+        failed: ArchiveRunLogsResult['failed'];
+    }) => void;
+}
+/** The cleanup service's limits: how long a stopped or idle ephemeral process stays, and how often each sweep runs. */
+export interface CleanupConfig {
+    staleMaxAgeMs: number;
+    staleThrottleMs: number;
+    ephemeralTimeoutMs: number;
+    ephemeralThrottleMs: number;
+    idleThrottleMs: number;
+}
+/** What one sweep removed, and each removal that failed. */
+export interface CleanupResult {
+    cleaned: string[];
+    errors: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/** The store reads and writes the cleanup service makes. */
+export type CleanupStore = Pick<ProcessStore, 'getAll' | 'getRunning' | 'getConfig' | 'update' | 'delete' | 'deleteConfig' | 'runEndSettled'>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAElF,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACrC,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACzC,uHAAuH;IACvH,UAAU,EAAE,MAAM,UAAU,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACnG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CACzF;AAED,uHAAuH;AACvH,MAAM,WAAW,aAAa;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AAED,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,CAAC,CAAC"}

package/dist/services/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * Service-layer contracts.
+ *
+ * Shapes the PM services exchange, kept apart from their implementations so the
+ * service modules hold behaviour and this module holds declarations. These are
+ * internal plumbing, not validated boundaries: a shape that crosses a boundary
+ * belongs to its owner's zod schema and is exported as `z.infer`, not declared
+ * here.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/services/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/services/workers.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Workers API Service
+ * Background job queue management via IPC
+ */
+import { type ResolveSocketOptions } from '../utils/socket-paths.ts';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type PMPathOptions } from '../utils/vibes-home.ts';
+import type { WorkerManager } from '../schemas/worker-manager.ts';
+import { type ProcessConfig, type ProcessConfigInput, type ProcessState } from '../schemas/process.ts';
+export interface WorkerRuntimeCliInvocation {
+    command: string;
+    args: string[];
+}
+/**
+ * Materialize a declarative Workers process against PM's admitted workspace.
+ * Descriptor discovery stays metadata-only; filesystem/socket identity is
+ * resolved exactly once at the PM registration/start boundary.
+ */
+export declare function bindWorkerRuntimeProcessConfig(input: ProcessConfig, workspaceRoot: string, pathOptions: PMPathOptions): ProcessConfig;
+/**
+ * Extend the active CLI's declared self-spawn shape with a worker command.
+ * `workers serve` takes no target: the spawned host serves the hardware it
+ * declares (RC01 minor 8). `target` only names the PM process and its socket.
+ * The child binds PM's admitted workspace through argv (`--workspace-root`),
+ * never an env var (rc02-rc03 §2.2).
+ *
+ * Packaged consumers declare `[.../Resources/bin/vibes]`; source runs declare
+ * `[bun, run, --bun, .../vibes.ts]`. PM must preserve that host-owned shape
+ * instead of rediscovering source files from the user's workspace.
+ */
+export declare function createWorkerRuntimeCliInvocation(selfSpawnArgv: string[], workspaceRoot: string): WorkerRuntimeCliInvocation;
+export declare function createWorkerRuntimeProcessConfig(input: {
+    target: 'consumer' | 'cloud';
+    workspaceRoot: string;
+    cliInvocation: WorkerRuntimeCliInvocation;
+    pathOptions: PMPathOptions;
+}): ProcessConfigInput;
+export type RunningWorkerVerdict = {
+    action: 'keep';
+} | {
+    action: 'restart';
+    reason: 'socket-identity-changed' | 'readiness-deadline-missed';
+    deadlineMs?: number;
+} | {
+    action: 'wait';
+    reason: 'live-child-not-ready';
+    deadlineMs: number;
+};
+/**
+ * What to do with a worker whose pid PM reports alive. A live pid that misses
+ * one readiness probe is warming up or busy, not stale: it is probed again
+ * until a declared deadline, the later of its boot deadline (start + the
+ * health check's `warmupMs`) and one health-check `timeout` from now. Only a
+ * record whose socket identity changed, or a worker still not ready past that
+ * deadline, is restarted. A dead pid never reaches here: it starts fresh.
+ */
+export declare function settleRunningWorker(input: {
+    state: Pick<ProcessState, 'socketPath' | 'startedAt'> | undefined;
+    canonicalSocketPath: string;
+    warmupMs: number;
+    probeTimeoutMs: number;
+    probe: (socketPath: string) => Promise<boolean>;
+    /** Whether the recorded pid is alive and runs this process's command (PM's ownership check). */
+    ownsLiveChild: () => Promise<boolean>;
+    /** Wall-clock milliseconds (comparable with `startedAt`). */
+    now: () => number;
+    delay: (ms: number) => Promise<void>;
+}): Promise<RunningWorkerVerdict>;
+/**
+ * Ensure worker runtime is running
+ */
+export declare function ensureWorkerRuntime(manager: WorkerManager, target: 'consumer' | 'cloud' | undefined, workspaceRoot: string, 
+/** The runtime the manager was handed: its scope, host command, roots and path mechanics. */
+runtime: ResolveSocketOptions['runtime'] & RuntimeRef): Promise<void>;
+//# sourceMappingURL=workers.d.ts.map

package/dist/services/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/services/workers.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAAgD,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnH,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,aAAa,GACxB,aAAa,CAyBf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC/C,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACnB,0BAA0B,CAe5B;AAWD,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACvD,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,WAAW,EAAE,aAAa,CAAC;CAC3B,GAAG,kBAAkB,CA+BrB;AASD,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,yBAAyB,GAAG,2BAA2B,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3G;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC;IAClE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,gGAAgG;IAChG,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,6DAA6D;IAC7D,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM;AACrB,6FAA6F;AAC7F,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,UAAU,GACnD,OAAO,CAAC,IAAI,CAAC,CA+Df"}