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

package/dist/tasks/run-task.js

@@ -0,0 +1,144 @@
+/**
+ * Run one task through the selected PM owner. Supervised runs require the
+ * owner's acknowledgement capability; ordinary tasks retain their existing
+ * start/await/stop/release behavior.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, isCapabilityError, settle } from '@vibesdotdev/kernel';
+import { PmTaskProcessIdentitySchema, PmTaskRunIdentitySchema } from "../schemas/process.js";
+import { inlineTaskConfig } from "./launch.js";
+import { completeRun } from "./completion.js";
+import { PmTaskInputSchema } from "./schemas.js";
+async function pmClient(runtime) {
+    if (!runtime.hasContext('pm/client'))
+        throw new CapabilityError('PM tasks run under PM, but this host composes no PM client.', 'UNAVAILABLE', { reason: 'pm-client-unavailable', details: { context: 'pm/client' } });
+    return runtime.context('pm/client');
+}
+function cancelled() {
+    return new CapabilityError('The PM task was cancelled.', 'CANCELLED', { reason: 'pm-task-cancelled' });
+}
+function declaredState(started) {
+    return started.kind === 'process' ? started.state : started.kind === 'dependencies' ? started.target : undefined;
+}
+const RUN_ENDED_REFUSALS = new Set(['pm-task-failed', 'pm-task-cancelled', 'pm-task-timeout']);
+function refusedAfterRunEnded(cause) {
+    return isCapabilityError(cause) && RUN_ENDED_REFUSALS.has(cause.reason);
+}
+/** Ordinary tasks preserve the identity-only beforeStart callback and default PM retention. */
+export async function runPmTask(runtime, task, options) {
+    if (options.signal?.aborted)
+        throw cancelled();
+    return runPmTaskOnClient(await pmClient(runtime), task, options);
+}
+/** An older retained PM client must refuse before any supervision write or launch. */
+export async function runSupervisedPmTask(runtime, task, options) {
+    if (options.signal?.aborted)
+        throw cancelled();
+    const pm = await pmClient(runtime);
+    if (!z.function().safeParse(pm.runSupervisedTask).success)
+        throw new CapabilityError('The selected PM owner cannot acknowledge supervised task settlement.', 'UNAVAILABLE', { reason: 'pm-task-supervision-unavailable', retryable: false });
+    return pm.runSupervisedTask(task, options);
+}
+/** Internal owner join: PMClient hands its exact selected daemon and admitted scope here. */
+export async function runPmTaskOnClient(pm, task, options, supervision) {
+    if (options.signal?.aborted)
+        throw cancelled();
+    const parsed = PmTaskInputSchema.parse(task);
+    let processId;
+    let started;
+    const beforeStart = async (id) => {
+        if (supervision)
+            await supervision.callbacks.beforeStart({
+                scope: supervision.scope, admissionId: supervision.admissionId, processId: id
+            });
+        await options.beforeStart?.(id);
+    };
+    if (supervision) {
+        processId = 'processId' in parsed ? parsed.processId : `pm-task-${crypto.randomUUID()}`;
+        const identity = PmTaskProcessIdentitySchema.parse({
+            scope: supervision.scope, admissionId: supervision.admissionId, processId
+        });
+        await beforeStart(processId);
+        started = await pm.admitSupervisedTask(identity, parsed, options);
+    }
+    else if ('processId' in parsed) {
+        processId = parsed.processId;
+        await beforeStart(processId);
+        const declared = await settle(() => pm.startDeclared(processId, undefined, { kind: 'process' }));
+        const notProcess = !declared.ok && isCapabilityError(declared.cause) && declared.cause.reason === 'pm-target-not-process';
+        if (!declared.ok && !notProcess)
+            throw declared.cause;
+        started = declared.ok ? declaredState(declared.value) : undefined;
+        if (!started?.startedAt) {
+            const message = `PM task target "${processId}" is not a process PM started.`;
+            const failureOptions = {
+                reason: 'pm-target-not-process', details: { processId }
+            };
+            if (!declared.ok)
+                failureOptions.cause = declared.cause;
+            throw new CapabilityError(message, 'INVALID_INPUT', failureOptions);
+        }
+    }
+    else {
+        processId = `pm-task-${crypto.randomUUID()}`;
+        const config = inlineTaskConfig(processId, parsed, options);
+        await beforeStart(processId);
+        started = await pm.start(config);
+    }
+    if (supervision) {
+        const admitted = PmTaskRunIdentitySchema.safeParse({
+            scope: supervision.scope, admissionId: supervision.admissionId, processId, startedAt: started?.startedAt?.getTime()
+        });
+        if (!admitted.success)
+            throw new CapabilityError('PM did not retain the admitted run generation.', 'UNAVAILABLE', {
+                reason: 'pm-task-supervision-run-unavailable', retryable: false, details: { processId }
+            });
+        const acknowledged = await settle(() => supervision.callbacks.started(admitted.data));
+        if (!acknowledged.ok) {
+            const failure = new CapabilityError('The supervisor could not persist the PM run admission.', 'UNAVAILABLE', {
+                reason: 'pm-task-supervision-ack-failed', cause: acknowledged.cause, details: { processId, phase: 'started' }
+            });
+            const stopped = await settle(async () => {
+                const run = { startedAt: new Date(admitted.data.startedAt) };
+                const stopping = await settle(() => pm.stop(processId, { run }));
+                if (!stopping.ok && !(isCapabilityError(stopping.cause) && stopping.cause.reason === 'process-not-running')) {
+                    throw stopping.cause;
+                }
+                await pm.awaitExit(processId, { run });
+            });
+            if (!stopped.ok)
+                throw new AggregateError([failure, stopped.cause], 'A supervised PM admission could not be acknowledged or stopped.');
+            throw failure;
+        }
+    }
+    if (supervision) {
+        const completed = await settle(() => completeRun(pm, processId, started, parsed, options, supervision));
+        if (supervision.receipt) {
+            const receipt = supervision.receipt;
+            const acknowledged = await settle(() => pm.acknowledgeSupervised(receipt));
+            if (!acknowledged.ok) {
+                if (!completed.ok)
+                    throw new AggregateError([completed.cause, acknowledged.cause], 'The supervised task failed and its PM acknowledgement could not be released.');
+                throw acknowledged.cause;
+            }
+        }
+        if (!completed.ok)
+            throw completed.cause;
+        return completed.value;
+    }
+    if (!('command' in parsed) || parsed.retain !== false)
+        return completeRun(pm, processId, started, parsed, options, supervision);
+    const completed = await settle(() => completeRun(pm, processId, started, parsed, options, supervision));
+    if (!completed.ok && !refusedAfterRunEnded(completed.cause))
+        throw completed.cause;
+    const released = await settle(() => pm.unregister(processId));
+    if (!completed.ok) {
+        if (!released.ok)
+            throw new AggregateError([completed.cause, released.cause], `PM task "${processId}" could not be released.`);
+        throw completed.cause;
+    }
+    if (!released.ok)
+        throw released.cause;
+    return completed.value;
+}
+//# sourceMappingURL=run-task.js.map

package/dist/tasks/run-task.js.map

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

package/dist/tasks/schemas.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The task a caller hands PM, and what PM reports back.
+ *
+ * A task is either a command to run to completion or a process PM already
+ * started that the caller wants to wait on. PM owns this shape because PM owns
+ * the process: the id, the deadline, and the output are PM facts, and a caller
+ * that redeclares them has to keep them in step with PM's own record.
+ */
+import { z } from 'zod/v4';
+import type { PmTaskScope, PmTaskProcessIdentity, PmTaskRunIdentity, PmTaskSettlement } from '../schemas/process.ts';
+/** Native acknowledgement ports; callbacks resolve only after the supervising owner persisted the fact. */
+export interface PmTaskSupervision {
+    beforeStart(identity: PmTaskProcessIdentity): Promise<void>;
+    started(identity: PmTaskRunIdentity): Promise<void>;
+    settled(receipt: PmTaskSettlement): Promise<void>;
+}
+/** Internal live acknowledgement state shared by PM's task owner and completion lifetime. */
+export interface TaskSupervision {
+    scope: PmTaskScope;
+    admissionId: string;
+    callbacks: PmTaskSupervision;
+    receipt?: PmTaskSettlement;
+}
+export interface PmTaskOptions {
+    runId: string;
+    signal?: AbortSignal;
+    tags?: string[];
+    returnInterrupted?: boolean;
+    captureInvocation?: boolean;
+    beforeStart?: (processId: string) => void | Promise<void>;
+}
+export type PmSupervisedTaskOptions = PmTaskOptions & {
+    supervision: PmTaskSupervision;
+};
+/** How the task names what it runs: an inline command, or a process PM started. */
+export declare const PmTaskInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    processId: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    allowFailure: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    inheritEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    allowFailure: z.ZodDefault<z.ZodBoolean>;
+    retain: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>]>;
+export type PmTaskInput = z.input<typeof PmTaskInputSchema>;
+/** Why a task stopped short of a clean exit. */
+export declare const PmTaskTerminationSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    timeout: "timeout";
+}>;
+export type PmTaskTermination = z.output<typeof PmTaskTerminationSchema>;
+/**
+ * What the task did. `exitCode` is PM's record and nothing else: a run PM saw
+ * end without an exit code (a signal, or a stop whose exit it did not observe)
+ * reports `null`, which is not the same as exit `0`.
+ */
+export declare const PmTaskResultSchema: z.ZodObject<{
+    processId: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    invocation: z.ZodOptional<z.ZodObject<{
+        cwd: z.ZodString;
+        run: z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    termination: z.ZodOptional<z.ZodEnum<{
+        cancelled: "cancelled";
+        timeout: "timeout";
+    }>>;
+    pid: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PmTaskResult = z.output<typeof PmTaskResultSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tasks/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tasks/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAErH,2GAA2G;AAC3G,MAAM,WAAW,iBAAiB;IACjC,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG;IAAE,WAAW,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEzF,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;mBAgC5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,uBAAuB;;;EAAmC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;iBAe7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/tasks/schemas.js

@@ -0,0 +1,67 @@
+/**
+ * The task a caller hands PM, and what PM reports back.
+ *
+ * A task is either a command to run to completion or a process PM already
+ * started that the caller wants to wait on. PM owns this shape because PM owns
+ * the process: the id, the deadline, and the output are PM facts, and a caller
+ * that redeclares them has to keep them in step with PM's own record.
+ */
+import { z } from 'zod/v4';
+/** How the task names what it runs: an inline command, or a process PM started. */
+export const PmTaskInputSchema = z.union([
+    z.object({
+        /** A process PM already started. PM asserts it is a process before waiting on it. */
+        processId: z.string().min(1),
+        /** Deadline for the PM run; reaching it stops the process before returning. */
+        timeoutMs: z.number().int().positive().optional(),
+        /** Report a nonzero exit as a result with its output, instead of refusing. */
+        allowFailure: z.boolean().default(false),
+    }),
+    z.object({
+        command: z.string().min(1),
+        args: z.array(z.string()).default([]),
+        cwd: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        /** Variables the command receives beyond PM's base environment. */
+        env: z.record(z.string(), z.string()).optional(),
+        /** Host variable names the command inherits (PM passes only names it is given). */
+        inheritEnv: z.array(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/)).optional(),
+        /** Deadline for the PM run; reaching it stops the process before returning. */
+        timeoutMs: z.number().int().positive().optional(),
+        /** Report a nonzero exit as a result with its output, instead of refusing. */
+        allowFailure: z.boolean().default(false),
+        /**
+         * Keep PM's record of the run (state, config, logs) after it ends, for the
+         * PM dashboard and `pm logs` until PM's ephemeral sweep; absent, it is kept.
+         * `false` releases it once the run is over and its output read, for a
+         * caller that keeps nothing PM holds. A process PM already started is never
+         * released. Optional rather than defaulted, so a task's parsed form (a
+         * runbook graph node's input) carries only what its caller declared.
+         */
+        retain: z.boolean().optional(),
+    }),
+]);
+/** Why a task stopped short of a clean exit. */
+export const PmTaskTerminationSchema = z.enum(['cancelled', 'timeout']);
+/**
+ * What the task did. `exitCode` is PM's record and nothing else: a run PM saw
+ * end without an exit code (a signal, or a stop whose exit it did not observe)
+ * reports `null`, which is not the same as exit `0`.
+ */
+export const PmTaskResultSchema = z.object({
+    processId: z.string().min(1),
+    /** The admitted PM run generation; pins evidence across restarts of one process id. */
+    startedAt: z.number().optional(),
+    /** Observed launch identity, captured on request for durable independent evidence. No env values. */
+    invocation: z.object({
+        cwd: z.string().min(1),
+        run: z.object({ command: z.string().min(1), args: z.array(z.string()) })
+    }).optional(),
+    exitCode: z.number().int().nullable(),
+    stdout: z.string(),
+    stderr: z.string(),
+    /** Present when the task was cancelled or ran out of time rather than exiting. */
+    termination: PmTaskTerminationSchema.optional(),
+    pid: z.number().int().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tasks/schemas.js.map

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

package/dist/testing/daemon.d.ts

@@ -0,0 +1,64 @@
+/**
+ * `@vibesdotdev/pm/testing` — a REAL PM daemon for a consumer's tests (the
+ * declared testing subpath). A consumer whose code reaches PM through the
+ * runtime's `pm/client` (runbooks, knowledge) proves it against the daemon
+ * PM ships, never a fake: this boots the daemon's own serve host over the
+ * caller's environment, admits the scratch workspace, declares the graph the
+ * test names, and serves `PMDaemon` on its socket.
+ *
+ * The caller supplies the environment plugin (its host's environment package,
+ * a dev dependency of the test) with {@link pmDaemonServeScope} as its scope,
+ * so this module's closure is PM's own dependencies only.
+ */
+import { type RuntimePlugin, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ProcessConfigInput } from '../schemas/process.ts';
+import type { ResourceConfig } from '../schemas/resource.ts';
+/**
+ * The PM daemon's serve host scope for `workspace`: the scope the CLI's serve
+ * transition declares for `pm daemon serve`, so `pm/role` answers 'daemon'.
+ */
+export declare function pmDaemonServeScope(workspace: string): {
+    surface: "worker";
+    hardware: "consumer";
+    purpose: "worker";
+    lifecycle: "persistent";
+    hosting: {
+        mode: "local";
+        owner: "consumer";
+        venue: "ipc-worker";
+    };
+    capabilities: {
+        requestPrincipals: boolean;
+        sharedHost: boolean;
+    };
+    qualifiers: {
+        dev: boolean;
+        serve: string;
+    };
+    workspace: {
+        root: string;
+    };
+};
+export interface ServePMTestDaemonOptions {
+    /** The daemon host's environment plugin, built by the caller with {@link pmDaemonServeScope} as its scope. */
+    environment: RuntimePlugin;
+    /** The scratch workspace the daemon supervises (the scope's workspace root). */
+    workspace: string;
+    /** The graph the daemon resolves declared ids against (`config.plugins.pm`). */
+    graph?: {
+        processes?: ProcessConfigInput[];
+        resources?: ResourceConfig[];
+    };
+}
+export interface ServedPMTestDaemon {
+    /** The daemon's socket: hand it to a `PMClient` on the consumer's own runtime. */
+    readonly socketPath: string;
+    readonly workspace: string;
+    /** The daemon's own host. */
+    readonly runtime: VibesRuntime;
+    /** Stop the daemon (draining its children) and dispose its host. */
+    stop(): Promise<void>;
+}
+/** Serve a real PM daemon for a test; resolves once its socket answers. */
+export declare function servePMTestDaemon(options: ServePMTestDaemonOptions): Promise<ServedPMTestDaemon>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/testing/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/testing/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA8C,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAwBxH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;EAWnD;AAwBD,MAAM,WAAW,wBAAwB;IACxC,8GAA8G;IAC9G,WAAW,EAAE,aAAa,CAAC;IAC3B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;CAC3E;AAED,MAAM,WAAW,kBAAkB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+CtG"}

package/dist/testing/daemon.js

@@ -0,0 +1,125 @@
+/**
+ * `@vibesdotdev/pm/testing` — a REAL PM daemon for a consumer's tests (the
+ * declared testing subpath). A consumer whose code reaches PM through the
+ * runtime's `pm/client` (runbooks, knowledge) proves it against the daemon
+ * PM ships, never a fake: this boots the daemon's own serve host over the
+ * caller's environment, admits the scratch workspace, declares the graph the
+ * test names, and serves `PMDaemon` on its socket.
+ *
+ * The caller supplies the environment plugin (its host's environment package,
+ * a dev dependency of the test) with {@link pmDaemonServeScope} as its scope,
+ * so this module's closure is PM's own dependencies only.
+ */
+import { bootstrapVibesRuntime, createRuntimePlugin } from '@vibesdotdev/kernel';
+import { runtimeAuthzPlugin } from '@vibesdotdev/kernel/authz';
+import { runtimeClientPlugin } from '@vibesdotdev/kernel/client';
+import configPlugin from '@vibesdotdev/config/plugin';
+import loggingPlugin from '@vibesdotdev/logging/plugin';
+import { registerAppConfigContexts } from '@vibesdotdev/kernel/bootstrap/app-config-contexts';
+import { loggingBootstrapPlugin } from '@vibesdotdev/logging/contexts';
+import { getPathRoots, getRuntimePath } from '@vibesdotdev/paths';
+import storagePlugin from '@vibesdotdev/storage/storage.plugin';
+import { storageAdapterJsonPlugin } from '@vibesdotdev/storage/adapters/json/plugin';
+import { pmRuntimeDescriptors, pmRuntimeLoaders } from "../pm.assets.runtime.js";
+import { PM_ROLE_CONTEXT_ID } from "../daemon/role.js";
+import commandsPlugin from "../daemon/commands.plugin.js";
+import { PM_ADMITTED_WORKSPACE_CONTEXT_ID, PM_WORKSPACES_MANIFEST_ID } from "../admission.js";
+import { admitWorkspace } from "../admission-store.js";
+import processKind from "../kinds/process.kind.js";
+import resourceKind from "../kinds/resource.kind.js";
+import presetKind from "../kinds/preset.kind.js";
+import { PMDaemon } from "../daemon.js";
+import { getDaemonPidPath } from "../utils/daemon-pid.js";
+import { getPMSocketPath } from "../utils/socket-paths.js";
+import { pollUntil } from "../utils/bounded-wait.js";
+import { pmFileSystem } from "../helpers/runtime-files.js";
+import { PMClient } from "../client.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+/**
+ * The PM daemon's serve host scope for `workspace`: the scope the CLI's serve
+ * transition declares for `pm daemon serve`, so `pm/role` answers 'daemon'.
+ */
+export function pmDaemonServeScope(workspace) {
+    return {
+        surface: 'worker',
+        hardware: 'consumer',
+        purpose: 'worker',
+        lifecycle: 'persistent',
+        hosting: { mode: 'local', owner: 'consumer', venue: 'ipc-worker' },
+        capabilities: { requestPrincipals: true, sharedHost: true },
+        qualifiers: { dev: true, serve: 'pm.daemon.serve' },
+        workspace: { root: workspace }
+    };
+}
+/** The pm plugin's admission, role and client registrations, and its three kinds, without the whole plugin. */
+function pmDaemonHostPlugins() {
+    const ids = new Set([PM_ADMITTED_WORKSPACE_CONTEXT_ID, PM_WORKSPACES_MANIFEST_ID, PM_ROLE_CONTEXT_ID, 'pm/client', 'pm']);
+    return [
+        loggingBootstrapPlugin,
+        runtimeAuthzPlugin,
+        runtimeClientPlugin,
+        storagePlugin,
+        configPlugin,
+        loggingPlugin,
+        storageAdapterJsonPlugin,
+        commandsPlugin,
+        createRuntimePlugin({
+            id: 'pm.testing.daemon-host',
+            dependencies: ['storage'],
+            kinds: [processKind, resourceKind, presetKind],
+            descriptors: pmRuntimeDescriptors.filter((descriptor) => ids.has(descriptor.id)),
+            loaders: pmRuntimeLoaders.filter((entry) => ids.has(entry.id))
+        })
+    ];
+}
+/** Serve a real PM daemon for a test; resolves once its socket answers. */
+export async function servePMTestDaemon(options) {
+    const runtime = await bootstrapVibesRuntime({
+        environment: options.environment,
+        composition: {
+            kind: 'literal',
+            config: { 'config.storage': { storedLayer: 'none' } },
+            plugins: pmDaemonHostPlugins().map((plugin) => async () => plugin)
+        },
+        binding: 'owned'
+    });
+    await admitWorkspace(runtime, 'user');
+    registerAppConfigContexts(runtime, {
+        config: { plugins: { pm: { processes: options.graph?.processes ?? [], resources: options.graph?.resources ?? [] } } }
+    });
+    const roots = getPathRoots(runtime);
+    const runtimePath = await getRuntimePath(runtime);
+    const socketPath = getPMSocketPath(options.workspace, { roots, runtimePath });
+    await (await pmFileSystem(runtime)).mkdir(runtimePath.join(roots.activeHome, 'pm', 'sock'), { recursive: true });
+    const daemon = new PMDaemon({
+        runtime,
+        runtimePath,
+        workspaceRoot: options.workspace,
+        socketPath,
+        pidFile: getDaemonPidPath(options.workspace, { roots })
+    });
+    const served = Promise.allSettled([daemon.start()]);
+    const stop = async () => {
+        const stopped = await Promise.allSettled([daemon.stop()]);
+        const outcomes = [...stopped, ...(await served)];
+        await runtime.dispose();
+        const failures = outcomes.flatMap((outcome) => (outcome.status === 'rejected' ? [outcome.reason] : []));
+        if (failures.length > 0)
+            throw new AggregateError(failures, 'The PM test daemon did not stop cleanly.');
+    };
+    const probe = new PMClient(socketPath, { runtime, roots, runtimePath, workspaceRoot: options.workspace, autoStartDaemon: false });
+    const listening = await pollUntil(runtime, () => probe.isDaemonRunning(200), {
+        timeoutMs: 20_000,
+        intervalMs: 50,
+        reason: 'pm-test-daemon-listening'
+    });
+    if (!listening) {
+        await stop();
+        throw new CapabilityError('The PM test daemon did not start listening.', 'UNAVAILABLE', {
+            reason: 'pm-test-daemon-unreachable',
+            details: { workspace: options.workspace }
+        });
+    }
+    return { socketPath, workspace: options.workspace, runtime, stop };
+}
+//# sourceMappingURL=daemon.js.map

package/dist/testing/daemon.js.map

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

package/dist/tui/components/DaemonHealthCard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Daemon Health Card
+ *
+ * Single tile showing the health of one daemon/service (DB, cache, AI,
+ * worker, etc). Shape is intentionally generic so callers wire up whatever
+ * services they care about per page.
+ */
+import type { ReactNode } from 'react';
+export type DaemonHealthStatus = 'healthy' | 'degraded' | 'down' | 'unknown';
+export interface DaemonHealthCardProps {
+    name: string;
+    status: DaemonHealthStatus;
+    icon?: string;
+    subtitle?: string;
+    lastError?: string;
+    metrics?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+export declare function DaemonHealthCard({ name, status, icon, subtitle, lastError, metrics }: DaemonHealthCardProps): ReactNode;
+//# sourceMappingURL=DaemonHealthCard.d.ts.map

package/dist/tui/components/DaemonHealthCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonHealthCard.d.ts","sourceRoot":"","sources":["../../../src/tui/components/DaemonHealthCard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AASD,wBAAgB,gBAAgB,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,OAAY,EACZ,EAAE,qBAAqB,GAAG,SAAS,CA8CnC"}

package/dist/tui/components/DaemonHealthCard.js

@@ -0,0 +1,30 @@
+import { jsxs as _jsxs, jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { useTheme } from '@vibesdotdev/tui';
+import { VStack, HStack } from '@vibesdotdev/tui/components/layout';
+const statusIcon = {
+    healthy: '●',
+    degraded: '◐',
+    down: '✗',
+    unknown: '○'
+};
+export function DaemonHealthCard({ name, status, icon, subtitle, lastError, metrics = [] }) {
+    const { base: dsBase, colors: dsColors } = useTheme();
+    const statusColor = {
+        healthy: dsColors.success.solid,
+        degraded: dsColors.warning.solid,
+        down: dsColors.danger.solid,
+        unknown: dsBase.mutedForeground
+    };
+    return (_jsxs(VStack, { style: {
+            border: true,
+            borderColor: status === 'down' ? dsColors.danger.solid : dsBase.border,
+            padding: 1,
+            marginRight: 1,
+            width: 28,
+            backgroundColor: dsBase.card
+        }, children: [_jsxs(HStack, { style: {
+                    justifyContent: 'space-between',
+                    marginBottom: 1
+                }, children: [_jsxs(HStack, { children: [icon && _jsxs("text", { style: { fg: dsBase.foreground }, children: [icon, " "] }), _jsx("text", { style: { fg: dsBase.foreground }, children: _jsx("strong", { children: name }) })] }), _jsxs("text", { style: { fg: statusColor[status] }, children: [statusIcon[status], " ", status] })] }), subtitle && _jsx("text", { style: { fg: dsBase.mutedForeground }, children: subtitle }), metrics.map((metric) => (_jsxs(HStack, { children: [_jsxs("text", { style: { fg: dsBase.mutedForeground }, children: [metric.label, ": "] }), _jsx("text", { style: { fg: dsBase.foreground }, children: metric.value })] }, metric.label))), lastError && _jsxs("text", { style: { fg: dsColors.danger.solid }, children: ["error: ", lastError] })] }));
+}
+//# sourceMappingURL=DaemonHealthCard.js.map

package/dist/tui/components/DaemonHealthCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonHealthCard.js","sourceRoot":"","sources":["../../../src/tui/components/DaemonHealthCard.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAapE,MAAM,UAAU,GAAG;IAClB,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,GAAG;CACiC,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,OAAO,GAAG,EAAE,EACW;IACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtD,MAAM,WAAW,GAAG;QACpB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;QAC/B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;QAChC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;QAC3B,OAAO,EAAE,MAAM,CAAC,eAAe;KACc,CAAC;IAE9C,OAAO,CACN,MAAC,MAAM,IACN,KAAK,EAAE;YACN,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;YACtE,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,CAAC;YACd,KAAK,EAAE,EAAE;YACT,eAAe,EAAE,MAAM,CAAC,IAAI;SAC5B,aAED,MAAC,MAAM,IACN,KAAK,EAAE;oBACN,cAAc,EAAE,eAAe;oBAC/B,YAAY,EAAE,CAAC;iBACf,aAED,MAAC,MAAM,eACL,IAAI,IAAI,gBAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,aAAG,IAAI,SAAS,EAC/D,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,YACrC,2BAAS,IAAI,GAAU,GACjB,IACC,EACT,gBAAM,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,aACtC,UAAU,CAAC,MAAM,CAAC,OAAG,MAAM,IACtB,IACC,EACR,QAAQ,IAAI,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,YAAG,QAAQ,GAAQ,EAC1E,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,MAAC,MAAM,eACN,gBAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,aAAG,MAAM,CAAC,KAAK,UAAU,EACpE,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,YAAG,MAAM,CAAC,KAAK,GAAQ,KAFjD,MAAM,CAAC,KAAK,CAGhB,CACT,CAAC,EACD,SAAS,IAAI,gBAAM,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,wBAAU,SAAS,IAAQ,IAC3E,CACT,CAAC;AACH,CAAC"}

package/dist/tui/components/ErrorDetailsPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error Details Panel
+ *
+ * Surfaces a process/resource error inline — message, optional code, and
+ * recovery hints. Subdued visual until the user expands it.
+ */
+import { type ReactNode } from 'react';
+export interface ErrorDetailsPanelProps {
+    title?: string;
+    message: string;
+    code?: string;
+    hint?: string;
+    defaultExpanded?: boolean;
+}
+export declare function ErrorDetailsPanel({ title, message, code, hint, defaultExpanded }: ErrorDetailsPanelProps): ReactNode;
+//# sourceMappingURL=ErrorDetailsPanel.d.ts.map

package/dist/tui/components/ErrorDetailsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorDetailsPanel.d.ts","sourceRoot":"","sources":["../../../src/tui/components/ErrorDetailsPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIjD,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,EACjC,KAAe,EACf,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,eAAuB,EACvB,EAAE,sBAAsB,GAAG,SAAS,CAiCpC"}

package/dist/tui/components/ErrorDetailsPanel.js

@@ -0,0 +1,22 @@
+import { jsxs as _jsxs, jsx as _jsx } from "@opentui/react/jsx-runtime";
+/**
+ * Error Details Panel
+ *
+ * Surfaces a process/resource error inline — message, optional code, and
+ * recovery hints. Subdued visual until the user expands it.
+ */
+import { useState } from 'react';
+import { useTheme, DSButton } from '@vibesdotdev/tui';
+import { VStack, HStack } from '@vibesdotdev/tui/components/layout';
+export function ErrorDetailsPanel({ title = 'Error', message, code, hint, defaultExpanded = false }) {
+    const { base: dsBase, colors: dsColors } = useTheme();
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    return (_jsxs(VStack, { style: {
+            border: true,
+            borderColor: dsColors.danger.solid,
+            padding: 1,
+            marginTop: 1,
+            backgroundColor: dsBase.card
+        }, children: [_jsxs(HStack, { style: { justifyContent: 'space-between' }, children: [_jsx("text", { style: { fg: dsColors.danger.solid }, children: _jsxs("strong", { children: ["\u2717 ", title, code ? ` (${code})` : ''] }) }), _jsx(DSButton, { id: "error-details-toggle", label: expanded ? 'collapse' : 'expand', size: "sm", variant: "ghost", color: "danger", onClick: () => setExpanded((value) => !value) })] }), _jsx("text", { style: { fg: dsBase.foreground }, children: message }), expanded && hint && _jsx("text", { style: { fg: dsBase.mutedForeground, marginTop: 1 }, children: hint })] }));
+}
+//# sourceMappingURL=ErrorDetailsPanel.js.map