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

package/dist/dev/sveltekit.js

@@ -0,0 +1,93 @@
+import { createRuntimeAsset } from "@vibesdotdev/kernel";
+import { ProcessConfigSchema, } from "../schemas/process.js";
+import { secretRequirementCredentials } from "./command.js";
+import { buildWorkspaceCredentials, buildWorkspaceEnv, mergeProcessCredentials } from "./env.js";
+import { defaultDevLifecycle, defaultSvelteKitDevHealthCheck, defaultDevTcpHealthCheck, } from "./defaults.js";
+/**
+ * Build a fully-validated `pm/process` descriptor for a SvelteKit app
+ * dev server, wrapped in `createRuntimeAsset` so runtime discovery picks
+ * it up.
+ *
+ * Liveness profiles (pm-infra-liveness-fleet): pass `livenessProfiles: ['local-hmr', 'fleet-mutable', ...]`
+ * (and optional livenessConfig) to declare multi-presence support in *one* call site.
+ * This is the key enabler for dramatically less code in consumer descriptors vs. pre-milestone duplication
+ * (separate ids, duplicated metadata, separate files for local vs remote/cloud/fleet targets).
+ * Per product debate: breaking change to options shape is accepted because it reduces lines for framework consumers
+ * while increasing effectiveness (unified mental model + first-class remote HMR targets).
+ *
+ * @example
+ * ```ts
+ * // auth.pm.process.ts
+ * import { defineSvelteKitDev } from '@vibesdotdev/pm/dev';
+ *
+ * export default defineSvelteKitDev({
+ *   id: 'auth-dev',
+ *   name: 'Auth Dev',
+ *   description: 'Auth app — session management, OAuth, gateway.',
+ *   // appDir defaults to this file's directory; the dev server runs there.
+ *   port: 8420,
+ *   env: {
+ *     AUTH_STORAGE_MODE: 'internal-drizzle',
+ *     // Relative to the process cwd, the app directory.
+ *     AUTH_DATABASE_URL: 'file:.vibes/data/auth.sqlite'
+ *   },
+ *   presets: ['dev', 'core'],
+ *   tags: ['core', 'app'],
+ *   // NEW (Phase 1): declare supported liveness/presence modes in one place.
+ *   // Old local-only descriptors (no field) continue to work unchanged.
+ *   livenessProfiles: ['local-hmr', 'fleet-mutable'],
+ * });
+ * ```
+ */
+export function defineSvelteKitDev(options) {
+    const env = options.workspace
+        ? buildWorkspaceEnv(options.workspace, options.env ?? {})
+        : { ...options.env };
+    const devCommand = buildViteDevCommand(options.port, options.host);
+    const appDir = options.appDir ?? ".";
+    const preBuild = {
+        command: "bun",
+        args: ["--bun", "svelte-kit", "sync"],
+        cwd: appDir,
+        ignoreFailure: false,
+        timeout: 600_000,
+    };
+    env.NODE_ENV ??= "development";
+    env.VIBES_ENV ??= "development";
+    env.OTEL_ENABLED ??= "false";
+    const config = ProcessConfigSchema.parse({
+        id: options.id,
+        name: options.name,
+        description: options.description,
+        command: devCommand.command,
+        args: devCommand.args,
+        cwd: appDir,
+        env,
+        // The workspace's shared credential references, then the app's own
+        // secret requirements (an app's declaration of a name wins).
+        credentials: mergeProcessCredentials(options.workspace ? buildWorkspaceCredentials(options.workspace) : undefined, secretRequirementCredentials(options.secretRequirements)),
+        preBuild,
+        healthCheck: options.healthCheck ??
+            (options.healthPath === false
+                ? defaultDevTcpHealthCheck(options.port)
+                : defaultSvelteKitDevHealthCheck(options.port, options.healthPath ?? "/api/health", options.warmupPaths)),
+        autoRestart: defaultDevLifecycle.autoRestart,
+        restartDelay: options.restartDelay ?? defaultDevLifecycle.restartDelay,
+        maxRestarts: options.maxRestarts ?? defaultDevLifecycle.maxRestarts,
+        tags: options.tags,
+        dependencies: options.dependencies,
+        requiresPass: options.requiresPass,
+        presets: options.presets,
+        livenessProfiles: options.livenessProfiles,
+        livenessConfig: options.livenessConfig,
+    });
+    return createRuntimeAsset({
+        ...config,
+        kind: "pm/process",
+    });
+}
+function buildViteDevCommand(port, host = "0.0.0.0") {
+    const viteArgs = ["dev", "--host", host, "--port", String(port)];
+    return { command: "bun", args: ["--bun", "vite", ...viteArgs] };
+}
+//# sourceMappingURL=sveltekit.js.map

package/dist/dev/sveltekit.js.map

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

package/dist/dev/workspace-shape.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Dev Workspace Shape
+ *
+ * Contract between the PM dev builders (engine) and the per-workspace
+ * dev environment data (e.g. `pm/dev.workspace.ts` in this repo).
+ *
+ * The workspace is the single source of truth for:
+ * - the local dev base domain (e.g. `vibes.local`)
+ * - per-app sibling origins (used to fan-out PUBLIC_VIBES_<APP>_ORIGIN env)
+ * - per-app dev ports
+ * - references to the shared local credentials (admin, internal service,
+ *   auth internal) — never their values (D-RC05)
+ *
+ * Apps consume this through `defineSvelteKitDev({ workspace, ... })` so
+ * an individual app descriptor stays declarative and never re-spells the
+ * shared origin map.
+ */
+import type { CredentialReference } from '@vibesdotdev/kernel/credentials';
+/**
+ * The workspace's shared local credentials, as references only (D-RC05). PM
+ * resolves each through `resolveCredentialEnv` at spawn (the process's
+ * declared `credentials`), so a value never sits in the workspace data, a
+ * descriptor, argv or the stored config.
+ */
+export type DevWorkspaceCredentials = {
+    /**
+     * The local admin token. Not injected by the builders: an app that needs
+     * machine-to-machine admin access declares it in its own `credentials`
+     * (e.g. `{ VIBES_SYSTEM_ADMIN_TOKEN: devWorkspace.credentials.admin }`).
+     */
+    readonly admin?: CredentialReference;
+    /**
+     * The internal service token for local service-to-service calls; builders
+     * declare it as `VIBES_INTERNAL_SERVICE_TOKEN`.
+     */
+    readonly internalService?: CredentialReference;
+    /**
+     * The auth internal token for local app-to-auth calls; builders declare it
+     * under both the namespaced and the legacy name, `VIBES_AUTH_INTERNAL_TOKEN`
+     * and `AUTH_INTERNAL_TOKEN`.
+     */
+    readonly authInternal?: CredentialReference;
+};
+/** Pure topology plus credential references: no values, no filesystem root. */
+export type DevWorkspace = {
+    /** Local dev base domain (e.g. `vibes.local`). Used for cookie scoping and origin defaults. */
+    readonly baseDomain: string;
+    /**
+     * Sibling origins keyed by app id (lower-case, no `-web` suffix).
+     * Builder fans these out as `PUBLIC_VIBES_<KEY_UPPER>_ORIGIN` env vars
+     * on every dev process so apps can resolve cross-app URLs without
+     * hardcoding them. Matching entries in `ports` also produce private
+     * `VIBES_<KEY_UPPER>_API_URL` loopback origins for server-to-server calls.
+     */
+    readonly origins: Readonly<Record<string, string>>;
+    /**
+     * Per-app dev ports keyed by the same id used in `origins`. SvelteKit
+     * dev processes bind those ports through the shared PM builder.
+     */
+    readonly ports: Readonly<Record<string, number>>;
+    /** References to the shared local credentials (never values). */
+    readonly credentials?: DevWorkspaceCredentials;
+};
+//# sourceMappingURL=workspace-shape.d.ts.map

package/dist/dev/workspace-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-shape.d.ts","sourceRoot":"","sources":["../../src/dev/workspace-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CAC5C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG;IAC1B,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjD,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;CAC/C,CAAC"}

package/dist/dev/workspace-shape.js

@@ -0,0 +1,19 @@
+/**
+ * Dev Workspace Shape
+ *
+ * Contract between the PM dev builders (engine) and the per-workspace
+ * dev environment data (e.g. `pm/dev.workspace.ts` in this repo).
+ *
+ * The workspace is the single source of truth for:
+ * - the local dev base domain (e.g. `vibes.local`)
+ * - per-app sibling origins (used to fan-out PUBLIC_VIBES_<APP>_ORIGIN env)
+ * - per-app dev ports
+ * - references to the shared local credentials (admin, internal service,
+ *   auth internal) — never their values (D-RC05)
+ *
+ * Apps consume this through `defineSvelteKitDev({ workspace, ... })` so
+ * an individual app descriptor stays declarative and never re-spells the
+ * shared origin map.
+ */
+export {};
+//# sourceMappingURL=workspace-shape.js.map

package/dist/dev/workspace-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-shape.js","sourceRoot":"","sources":["../../src/dev/workspace-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/docs/pm.daemon.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.daemon.docs.descriptor.d.ts.map

package/dist/docs/pm.daemon.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.daemon.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.daemon.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBA6CjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.daemon.docs.descriptor.js

@@ -0,0 +1,48 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'pm.daemon',
+    parent: 'pm',
+    order: 4,
+    title: 'PM Daemon',
+    summary: 'Controlling the Process Manager daemon itself (start, status, logs, serve)',
+    tags: ['pm', 'daemon', 'process-manager', 'lifecycle'],
+    surfaces: ['cli'],
+    enabled: true,
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: PM Daemon
+summary: Controlling the Process Manager daemon itself
+tags: [pm, daemon, process-manager, lifecycle]
+parent: pm
+order: 2
+---
+
+# PM Daemon
+
+The PM daemon is the long-lived server that actually manages all processes.
+
+## Commands
+
+- \`vibes pm daemon status\`
+- \`vibes pm daemon start | stop | restart\`
+- \`vibes pm daemon recover\` (clear an orphaned launch guard; launches also self-heal)
+- \`vibes pm daemon logs\`
+- \`vibes pm daemon serve\` (foreground mode, used internally by the launcher)
+
+## Architecture Note
+
+The daemon runs over a Unix socket. Most \`vibes pm\` commands talk to it via the \`PMClient\`.
+
+See also the \`pm/client\` runtime context and the daemon launch lock logic.
+
+When working on daemon code, remember:
+- One daemon per workspace tooling ID
+- Must stop all managed processes on shutdown
+- Uses launch lock to prevent recursive starts
+`
+    }
+};
+export default descriptor;
+//# sourceMappingURL=pm.daemon.docs.descriptor.js.map

package/dist/docs/pm.daemon.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.daemon.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/pm.daemon.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,4EAA4E;IACrF,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC;IACtD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BT;KACC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.docs.descriptor.d.ts.map

package/dist/docs/pm.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA8BvE,QAAA,MAAM,UAAU,EAAE,mBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.docs.descriptor.js

@@ -0,0 +1,45 @@
+const pmMarkdown = `---
+title: PM
+summary: The process manager behind \`vibes pm\`: tasks, workers, queues, daemon, presets, and resources.
+parent: 
+order: 9
+---
+
+# PM
+
+The process manager behind \`vibes pm\`: tasks, workers, queues, daemon, presets, and resources. Every dev server in the suite runs through it.
+
+## When to use
+
+Reach for PM whenever you need to run, supervise, or inspect long-lived local processes — dev servers, workers, queue consumers — instead of launching them ad hoc. It is the single front door for starting the suite during development and keeping those processes reconciled.
+
+## How it works
+
+PM exposes CLI commands and a runtime-owned semantic client. Compose \`@vibesdotdev/pm/consumer.plugin\` for local supervision and resolve \`getVibesClient<PMClient>('pm', runtime)\` for programmatic use. CLI commands live at \`./cli/plugin\`; cloud hosts use the host-free \`./cloud.plugin\`. Supervised processes register as \`pm/process\` descriptors that the daemon reconciles.
+
+The synchronous port-forward builders retain validated requests and supervision settings, returning a deferred command preview without starting processes. PM resolves the open \`pm/launch-preparation\` kind at execution. Hosts explicitly compose their provider; PM imports and automatically composes no integration. The provider owns executable argv and legacy declaration interpretation. Missing or malformed providers refuse before spawn. See the package's \`docs/launch-preparation.md\` for the Kubernetes host bridge and persisted declaration compatibility.
+
+:::card{title="In this section"}
+- [\`pm.workers\`](pm.workers) — PM Workers
+- [\`pm.tasks\`](pm.tasks) — PM Tasks
+- [\`pm.queues\`](pm.queues) — PM Queues
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'pm',
+    title: 'PM',
+    summary: "The process manager behind `vibes pm`: tasks, workers, queues, daemon, presets, and resources.",
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: pmMarkdown
+    },
+    order: 9,
+    tags: ['pm', 'overview'],
+    surfaces: ['web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=pm.docs.descriptor.js.map

package/dist/docs/pm.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/pm.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BlB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,gGAAgG;IACzG,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,UAAU;KAClB;IACD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.preset.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.preset.docs.descriptor.d.ts.map

package/dist/docs/pm.preset.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.preset.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.preset.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBAkCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.preset.docs.descriptor.js

@@ -0,0 +1,37 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'pm.preset',
+    parent: 'pm',
+    order: 5,
+    title: 'PM Presets',
+    summary: 'Managing groups of processes with presets',
+    tags: ['pm', 'preset', 'process-manager'],
+    surfaces: ['cli'],
+    enabled: true,
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: PM Presets
+summary: Managing groups of processes (dev stacks, etc.)
+tags: [pm, preset, process-manager]
+parent: pm
+order: 3
+---
+
+# PM Presets
+
+Presets let you start/stop/restart logical groups of processes together (e.g. the full "dev" stack).
+
+## Commands
+
+- \`vibes pm preset list\`
+- \`vibes pm preset start|stop|restart <name>\`
+- \`vibes pm preset status <name>\`
+
+Presets are defined in workspace \`pm/\` directories and discovered via the runtime.
+`
+    }
+};
+export default descriptor;
+//# sourceMappingURL=pm.preset.docs.descriptor.js.map

package/dist/docs/pm.preset.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.preset.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/pm.preset.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,2CAA2C;IACpD,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC;IACzC,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;CAmBT;KACC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.queues.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.queues.docs.descriptor.d.ts.map

package/dist/docs/pm.queues.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.queues.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.queues.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBA0JjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.queues.docs.descriptor.js

@@ -0,0 +1,157 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'pm.queues',
+    title: 'PM Queues',
+    summary: 'How PM relates to background job queues, and where the queue API actually lives',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: PM Queues
+summary: How PM relates to background job queues, and where the queue API actually lives
+tags: [pm, queues, workers, jobs, background-jobs]
+parent: pm
+order: 3
+surfaces: [cli, web, in-app]
+hardware: [consumer]
+---
+
+The Process Manager (\`@vibesdotdev/pm\`) does **not** own a job-queue API. It manages OS process lifecycles only — start, stop, restart, health, and config (\`IProcessManager\`). Background job queues — enqueue, poll, stream, job status — live in \`@vibesdotdev/workers\` and are driven through \`WorkersClient\`.
+
+PM's only involvement with queues is **runtime lifecycle**: it owns the long-lived worker-runtime processes (\`vibes-workers-consumer\` / \`vibes-workers-cloud\`) that host the IPC queue adapters on the consumer scope. The \`enqueue\` / \`getStatus\` / streaming flows that historically lived on \`pm.workers.*\` have all moved to \`WorkersClient\` — PM keeps only the lifecycle primitives the IPC adapter's \`LocalWorkerManager\` needs.
+
+:::card{title="Looking for the queue API?"}
+Enqueueing jobs, polling status, streaming worker events, and queue adapters are documented under the workers module.
+- [\`workers.queues\`](workers.queues) — queue adapters and job lifecycle
+- [\`workers.kinds\`](workers.kinds) — \`workers/job\` and \`workers/adapter\` kinds
+:::
+
+## What PM actually exposes
+
+PM's shared interface (\`IProcessManager\`, implemented by both the direct \`ProcessManager\` and the daemon-backed \`PMClient\`) is process-centric:
+
+\`\`\`ts
+// pm/src/interface.ts
+export interface IProcessManager {
+  // Optional daemon-lifecycle methods (primarily implemented by the
+  // daemon-backed PMClient; ProcessManager may stub these as no-ops)
+  health?(): Promise<DaemonHealth | null>;
+  isDaemonRunning?(): Promise<boolean>;
+  attemptStartDaemon?(): Promise<boolean>;
+  ensureDaemonRunning?(): Promise<void>;
+
+  // Process lifecycle
+  start(config: ProcessConfigInput, options?: StartOptions): Promise<ProcessState>;
+  stop(processId: string, options?: StopOptions): Promise<void>;
+  restart(processId: string, options?: StartOptions): Promise<ProcessState>;
+  getStatus(processId: string): Promise<ProcessState | undefined>;
+  getAllStatus(): Promise<ProcessState[]>;
+  isRunning(processId: string): Promise<boolean>;
+  getLogs(processId: string, options?: ProcessLogOptionsInput): Promise<string>;
+  register(config: ProcessConfigInput): Promise<void>;
+  unregister(processId: string): Promise<boolean>;
+  getConfig(processId: string): Promise<ProcessConfig | undefined>;
+  getAllConfigs(): Promise<ProcessConfig[]>;
+  touch(processId: string, timestamp?: Date | number): Promise<void>;
+}
+\`\`\`
+
+There is no \`enqueue\`, \`dequeue\`, \`getQueueDepth\`, \`registerWorker\`, priority enum, load balancer, or dead-letter queue on PM. Those concepts belong to the workers module.
+
+### Worker-runtime lifecycle helpers
+
+Beyond \`IProcessManager\`, the PM \`ProcessManager\`/\`PMClient\` add two helpers used to bring up the worker runtime that hosts the IPC queue adapter:
+
+\`\`\`ts
+// pm/src/manager.ts / client.ts
+async ensureWorkerRuntime(target?: 'consumer' | 'cloud'): Promise<void>;
+async checkWorkersReady(timeout: number = 5000, target?: 'consumer' | 'cloud'): Promise<boolean>;
+\`\`\`
+
+\`ensureWorkerRuntime\` starts (or restarts) the \`vibes-workers-consumer\` / \`vibes-workers-cloud\` process if it isn't already serving a healthy socket. App code rarely calls these directly — they fire transparently when you resolve \`WorkersClient\` on the consumer-IPC path.
+
+## Enqueueing jobs (the real API)
+
+Resolve \`WorkersClient\` via \`getVibesClient\` and call \`enqueue\`. The client resolves the right \`workers/adapter\` for the current runtime scope (IPC on consumer, Kafka / CF Queues on cloud) and, on consumer, autostarts the PM-managed worker runtime for you.
+
+\`\`\`ts
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import type { WorkersClient } from '@vibesdotdev/workers/client';
+
+const workers = await getVibesClient<WorkersClient>('workers');
+
+// Enqueue and wait for the result (default 45m timeout)
+const result = await workers.enqueue<{ text: string }>('bridge-stt-jobs', {
+  audio: audioBuffer
+});
+\`\`\`
+
+### Enqueue without blocking
+
+Use \`enqueueWithTimeout\` to bound the wait. With \`timeoutMs <= 0\` it returns immediately with \`{ jobId, status: 'pending' }\`.
+
+\`\`\`ts
+const outcome = await workers.enqueueWithTimeout<{ text: string }>(
+  'bridge-stt-jobs',
+  { audio: audioBuffer },
+  { timeoutMs: 0 } // fire-and-forget
+);
+// { jobId: '...', status: 'pending' }
+\`\`\`
+
+### Stream worker events
+
+\`enqueueStreaming\` yields \`{ type, data }\` events as the job runs and honors an \`AbortSignal\`.
+
+\`\`\`ts
+for await (const event of workers.enqueueStreaming('agent-run-jobs', { prompt }, {
+  signal: controller.signal
+})) {
+  console.log(event.type, event.data);
+}
+\`\`\`
+
+### Inspect queues and sockets
+
+\`\`\`ts
+// Resolve a queue adapter directly for lower-level operations
+const queue = await workers.getQueue('bridge-stt-jobs');
+const job = await queue.getJob(jobId);
+
+// Is the worker runtime connected?
+const running = await workers.isRunning();
+
+// Consumer-scope IPC socket path PM reports for the worker process
+const socketPath = await workers.getSocketPath();
+\`\`\`
+
+## CLI
+
+PM's CLI manages processes, not queues. There is no \`vibes pm queues\` or \`vibes pm jobs\` command group.
+
+\`\`\`bash
+# Start / stop / inspect the worker-runtime process PM owns
+vibes pm start vibes-workers-consumer
+vibes pm status vibes-workers-consumer
+vibes pm logs vibes-workers-consumer --follow
+vibes pm list
+\`\`\`
+
+Job submission and queue inspection happen through the workers surface, not the PM CLI.
+
+:::card{title="See also"}
+- [\`pm.workers\`](pm.workers) — PM worker-runtime lifecycle and health
+- [\`pm.tasks\`](pm.tasks) — scheduled / recurring tasks
+- [\`workers.queues\`](workers.queues) — the queue + job API (\`WorkersClient\`)
+:::
+`
+    },
+    parent: 'pm',
+    order: 3,
+    tags: ['pm', 'queues', 'workers', 'jobs', 'background-jobs'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=pm.queues.docs.descriptor.js.map

package/dist/docs/pm.queues.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.queues.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/pm.queues.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,iFAAiF;IAC1F,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0IT;KACC;IACD,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.resource.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.resource.docs.descriptor.d.ts.map

package/dist/docs/pm.resource.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.resource.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.resource.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBAmCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.resource.docs.descriptor.js

@@ -0,0 +1,38 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'pm.resource',
+    parent: 'pm',
+    order: 6,
+    title: 'PM Resources',
+    summary: 'Managing infrastructure resources (k8s, certs, clusters, etc.)',
+    tags: ['pm', 'resource', 'k8s', 'kind', 'certs'],
+    surfaces: ['cli'],
+    enabled: true,
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: PM Resources
+summary: Declarative management of supporting infrastructure
+tags: [pm, resource, k8s, kind, certs]
+parent: pm
+order: 4
+---
+
+# PM Resources
+
+Resources are idempotent setup/teardown actions for things the processes depend on (namespaces, secrets, certs, local clusters, etc.).
+
+## Commands
+
+- \`vibes pm resource list\`
+- \`vibes pm resource apply\`
+- \`vibes pm resource status\`
+- \`vibes pm resource recreate\`
+
+Resource providers are registered in the PM resource registry and described in the PM SPEC.
+`
+    }
+};
+export default descriptor;
+//# sourceMappingURL=pm.resource.docs.descriptor.js.map

package/dist/docs/pm.resource.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.resource.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/pm.resource.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,gEAAgE;IACzE,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;IAChD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;CAoBT;KACC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/pm.tasks.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=pm.tasks.docs.descriptor.d.ts.map

package/dist/docs/pm.tasks.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.tasks.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/pm.tasks.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBA+OjB,CAAC;AAEF,eAAe,UAAU,CAAC"}