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

package/dist/cli/workers.serve.impl.cli.js

@@ -0,0 +1,223 @@
+import { getRuntimeSocketService } from '@vibesdotdev/kernel/socket';
+/**
+ * Workers Serve CLI Command Implementation
+ *
+ * Foreground worker runtime entrypoint used by PM.
+ */
+import { getWorkerRuntime } from "./runtime-loader.js";
+import { resolveWorkerSocketPath } from '@vibesdotdev/pm/utils/socket-paths';
+import { acquireServeSingleton, SERVE_HEARTBEAT_INTERVAL_MS } from "./serve-singleton.js";
+import { SERVE_STALL_KIND } from '@vibesdotdev/kernel/kinds/serve-stall.kind';
+import { requireWorkerAdapterForDeclaredHardware } from "../runtime/worker-runtime.js";
+import { PROCESS_IDS } from "./schemas/types.js";
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getRuntimeProcessService } from '@vibesdotdev/kernel/process';
+import { settle } from "../core/settle.js";
+import { openWorkersCommandOutput } from "./command-output.js";
+import { createCLIActionLifetime } from '@vibesdotdev/cli/providers';
+// Historically cloud-only (hence the old name): PM's `bindWorkerRuntimeProcessConfig`
+// always registers a socket-type healthCheck for BOTH hardware targets, but this
+// socket used to be created only when target === 'cloud'. A consumer worker ran
+// perfectly (processing jobs, no crash, nothing in stderr) while PM's health check
+// waited out warmup + grace period against a socket that was never going to appear,
+// then killed and auto-restarted a healthy process — 568 restarts observed in one
+// day on 2026-09-02. Every hardware target now binds this socket.
+async function createHealthSocket(runtime, socketPath, target) {
+    const sockets = await getRuntimeSocketService(runtime);
+    if (await sockets.isReachable(socketPath)) {
+        throw new Error(`A live worker already serves ${socketPath}. Use 'vibes pm restart ${PROCESS_IDS[target]}'.`);
+    }
+    await sockets.removeLocal(socketPath);
+    return sockets.listenLocal(socketPath, {
+        open(socket) { socket.end(); }, data() { }, close() { }
+    });
+}
+async function requeuePendingRecordDeliveries(runtime) {
+    const { requeuePendingDeliveries } = await import('@vibesdotdev/storage/record/delivery');
+    await requeuePendingDeliveries(runtime);
+}
+/** Re-enqueue pending record deliveries; a failure is reported and never stops the consumer from serving. */
+async function requeueRecordDeliveries(runtime, logger) {
+    const requeued = await settle(() => requeuePendingRecordDeliveries(runtime));
+    if (!requeued.ok) {
+        logger.error('pending record deliveries could not be re-enqueued', {
+            reason: 'storage-delivery-requeue-failed',
+            error: valueFreeFailure(requeued.caught)
+        });
+    }
+}
+/** Whether a registered worker carries a usable id. */
+function isText(value) {
+    return typeof value === 'string';
+}
+/** The host's stall watch, when this runtime has one. A host without the kind throws; the caller logs that and serves. */
+async function startServeStallWatch(runtime, options) {
+    const host = await runtime.query(SERVE_STALL_KIND).enabled().firstOrThrow();
+    return host.start(options);
+}
+export default {
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        // The host declared the hardware this worker serves; serve never chooses it.
+        const target = runtime.scope.hardware;
+        const logger = getLogger('worker-runtime', runtime)
+            .child('cli.serve')
+            .withContext({
+            service: 'workers-cli',
+            command: 'serve',
+            target,
+            verbose: Boolean(opts.verbose)
+        });
+        try {
+            // This runs on the serve host (surface `worker`), which has no `cli/app`
+            // keep-alive: the action itself blocks on its lifetime until shutdown.
+            // Cloud-serve refusal: a consumer build declares `consumer`, so a
+            // cloud-constrained adapter can never resolve here. Refuse a host
+            // with no adapter for its declared hardware (UNAVAILABLE, naming that
+            // hardware) before any socket, pid file or worker exists.
+            requireWorkerAdapterForDeclaredHardware(runtime);
+            const socketPath = await resolveWorkerSocketPath(undefined, {
+                runtime,
+                ensure: true,
+                hardware: target
+            });
+            logger.info('starting worker runtime', { socketPath });
+            const out = await openWorkersCommandOutput(runtime);
+            out.line(`Starting ${target} worker runtime...`);
+            out.line(`Socket: ${socketPath}`);
+            // Singleton guard: exactly ONE serve per target socket. Consumer
+            // workers bind no socket at all, so without this every spawner (PM,
+            // agent sessions, ad-hoc drains) added another immortal queue poller
+            // — 298 were culled on 2026-07-01 (work item c74e83a7). The guard
+            // also self-exits this process if a later worker takes the pid file
+            // over, so even a start race converges to one worker.
+            let shutdownRequested = false;
+            let requestShutdown;
+            const singleton = await acquireServeSingleton(runtime, socketPath, {
+                onLostOwnership: async () => {
+                    logger.warn('worker serve superseded (pid file no longer ours) — shutting down');
+                    out.warn('Worker serve superseded by another instance — shutting down.');
+                    shutdownRequested = true;
+                    if (requestShutdown)
+                        await requestShutdown('lost-ownership');
+                }
+            });
+            if (!singleton.ok || !singleton.handle) {
+                logger.error('worker serve already running', { holderPid: singleton.holderPid });
+                throw new CapabilityError(`A ${target} worker is already serving (pid ${singleton.holderPid}).`, 'CONFLICT', { recoveryHint: `Use 'vibes pm restart ${PROCESS_IDS[target]}' or stop it first.` });
+            }
+            const singletonHandle = singleton.handle;
+            if (shutdownRequested) {
+                await singletonHandle.release();
+                return;
+            }
+            // Bind the PM-visible health socket BEFORE any dependency wait
+            // (runtime discovery, adapter connect, per-worker queue connect) so
+            // PM's warmup can observe a live process immediately, for every
+            // hardware target — see createHealthSocket's comment for the defect
+            // this closes.
+            // For the consumer target the worker runtime's own IPC server listens on
+            // this very path (adapters/ipc/internal/server-runtime.ts) and IS the PM
+            // health endpoint; pre-binding it here made the runtime fail with
+            // EADDRINUSE. Only the cloud target, which has no IPC server, gets a
+            // standalone health socket.
+            const healthCheckServer = target === 'cloud' ? await createHealthSocket(runtime, socketPath, target) : null;
+            if (healthCheckServer) {
+                logger.info('health socket ready', { socketPath, target });
+                out.line(`Health check socket: ${socketPath}`);
+            }
+            // The next phase (runtime/worker discovery + adapter/queue connect)
+            // can legitimately take a while, but it must never be SILENT. Log a
+            // diagnostic if it runs past a bound instead of leaving the operator
+            // staring at an empty log while PM's health check (now satisfied by
+            // the socket above) keeps the process alive indefinitely.
+            const DEPENDENCY_WAIT_WARN_MS = 15_000;
+            const disarmDependencyWarning = runtime.lifecycle.timeout(() => {
+                logger.error('worker runtime dependency phase (discovery/adapter connect) exceeded bound — still waiting, not silently hung', { boundMs: DEPENDENCY_WAIT_WARN_MS, socketPath, target });
+            }, DEPENDENCY_WAIT_WARN_MS);
+            let workerRuntime;
+            try {
+                workerRuntime = await getWorkerRuntime(runtime);
+                const workers = workerRuntime.getWorkers();
+                out.line(`\nRegistered ${workers.length} workers:`);
+                for (const worker of workers) {
+                    const workerId = isText(worker?.id) ? worker.id : '(unknown-worker)';
+                    out.line(`  ${workerId}`);
+                }
+                await workerRuntime.start();
+                logger.info('worker runtime started', { workers: workers.length, socketPath });
+                // Durable record delivery (D-RC11): the consumer is the process that
+                // runs delivery jobs, so on start it re-enqueues every record still
+                // awaiting delivery, keyed by record id. Idempotent; a failure is
+                // reported and never stops the consumer from serving.
+                await requeueRecordDeliveries(runtime, logger);
+            }
+            finally {
+                disarmDependencyWarning();
+            }
+            let shuttingDown = false;
+            // Keep the foreground runtime alive under PM supervision. A persistent
+            // serve host, so a lifecycle interval is allowed; disposal clears it.
+            const stopKeepAlive = runtime.lifecycle.interval(() => { }, 60_000);
+            // The pid-file heartbeat and PM's socket connect both run on this
+            // thread. A sqlite JSON rewrite that never returns leaves both green
+            // while every client waits. The watch is a child: it SIGKILLs this
+            // process after three missed heartbeats, and release() removing the
+            // pid file ends it on an ordinary shutdown.
+            const servePid = (await getRuntimeProcessService(runtime)).currentPid?.();
+            const stallWatch = servePid === undefined
+                ? undefined
+                : await settle(() => startServeStallWatch(runtime, {
+                    pidFile: singletonHandle.pidFile,
+                    intervalMs: SERVE_HEARTBEAT_INTERVAL_MS,
+                    pid: servePid
+                }));
+            if (servePid === undefined || !stallWatch?.ok) {
+                logger.error('serve stall watch did not start', {
+                    pid: servePid,
+                    error: stallWatch && !stallWatch.ok ? valueFreeFailure(stallWatch.caught) : undefined
+                });
+            }
+            // The CLI owns the action lifetime on this runtime's host signals.
+            // Cleanup is bounded by the runtime's own wait: the runners drain for
+            // 30s before aborting jobs, so 45s covers a clean stop. A stop that
+            // hangs past it rejects TIMEOUT wait-timeout and ends the command
+            // instead of leaving a worker only SIGKILL can remove.
+            const lifetime = await createCLIActionLifetime(runtime, (reason) => runtime.lifecycle.wait(async () => {
+                if (shuttingDown)
+                    return;
+                shuttingDown = true;
+                stopKeepAlive();
+                out.line('\nShutting down worker runtime...');
+                logger.info('worker runtime shutting down');
+                // Release the singleton pid file (only if still ours — a
+                // superseding worker's pid file must not be deleted). Ownership
+                // also gates the socket unlink below: a superseded worker must
+                // not remove the socket its successor has since bound.
+                await singletonHandle.release();
+                await healthCheckServer?.stop();
+                await workerRuntime.stop();
+                if (stallWatch?.ok)
+                    await stallWatch.value.stop();
+                logger.info('worker runtime stopped');
+            }, { timeoutMs: 45_000, reason: `process-action-cleanup:${reason}` }));
+            requestShutdown = (reason) => lifetime.request(reason);
+            lifetime.bindProcessSignals();
+            out.line('\nWorker runtime started - listening for jobs...');
+            logger.info('worker runtime listening for jobs');
+            if (shutdownRequested) {
+                await lifetime.request('lost-ownership');
+            }
+            await lifetime.wait();
+        }
+        catch (error) {
+            if (error instanceof CapabilityError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error('workers serve failed', { error: message });
+            throw new CapabilityError(`Failed to serve workers: ${message}`, 'INTERNAL', { cause: error });
+        }
+    }
+};
+//# sourceMappingURL=workers.serve.impl.cli.js.map

package/dist/cli/workers.serve.impl.cli.js.map

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

package/dist/cli/workers.start.descriptor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Workers Start CLI Command Descriptor
+ */
+declare const _default: {
+    readonly kind: "cli/command";
+    readonly id: "workers.start";
+    readonly name: "start";
+    readonly description: "Start worker runtime in background via PM";
+    readonly group: "workers";
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer", "cloud"];
+    readonly enabled: true;
+    readonly nonTtyBehavior: "service";
+};
+export default _default;
+//# sourceMappingURL=workers.start.descriptor.d.ts.map

package/dist/cli/workers.start.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.start.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/workers.start.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;AAIH,wBAWG"}

package/dist/cli/workers.start.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * Workers Start CLI Command Descriptor
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    kind: 'cli/command',
+    id: 'workers.start',
+    name: 'start',
+    description: 'Start worker runtime in background via PM',
+    group: 'workers',
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true,
+    nonTtyBehavior: 'service'
+});
+//# sourceMappingURL=workers.start.descriptor.js.map

package/dist/cli/workers.start.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.start.descriptor.js","sourceRoot":"","sources":["../../src/cli/workers.start.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,2CAA2C;IACxD,KAAK,EAAE,SAAS;IAEhB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,SAAkB;CAClC,CAAC,CAAC"}

package/dist/cli/workers.start.impl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workers Start CLI Command Implementation
+ *
+ * Starts worker runtime in background through PM.
+ * Use `vibes workers serve` to run in the foreground.
+ */
+import type { CommandContext, CommandOptions } from '@vibesdotdev/cli';
+declare const _default: {
+    execute(_args: CommandOptions, _opts: CommandOptions, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=workers.start.impl.d.ts.map

package/dist/cli/workers.start.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.start.impl.d.ts","sourceRoot":"","sources":["../../src/cli/workers.start.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;;mBAOjD,cAAc,SAAS,cAAc,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADpG,wBAiCE"}

package/dist/cli/workers.start.impl.js

@@ -0,0 +1,43 @@
+/**
+ * Workers Start CLI Command Implementation
+ *
+ * Starts worker runtime in background through PM.
+ * Use `vibes workers serve` to run in the foreground.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { openWorkersCommandOutput } from "./command-output.js";
+export default {
+    async execute(_args, _opts, context) {
+        const target = context.runtime.scope.hardware;
+        const logger = getLogger('worker-runtime', context.runtime).child('cli.start').withContext({
+            service: 'workers-cli',
+            command: 'start',
+            target
+        });
+        const out = await openWorkersCommandOutput(context.runtime);
+        try {
+            const runtime = context.runtime;
+            const pm = await runtime.context('pm/client');
+            if (!pm?.ensureWorkerRuntime) {
+                logger.error('pm client context unavailable');
+                throw new CapabilityError('PM worker lifecycle is unavailable in this scope.', 'UNAVAILABLE', {
+                    recoveryHint: 'Use `vibes workers serve` only when a foreground runtime is intentional.'
+                });
+            }
+            out.line(`Starting ${target} workers in background via PM...`);
+            await pm.ensureWorkerRuntime(target);
+            logger.info('canonical worker runtime is ready');
+            out.line(`${target} workers are ready.`);
+            out.line(`Use "vibes workers logs ${target}" to view logs.`);
+        }
+        catch (error) {
+            if (error instanceof CapabilityError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error('workers start failed', { error: message });
+            throw new CapabilityError(`Failed to start workers: ${message}`, 'INTERNAL', { cause: error });
+        }
+    }
+};
+//# sourceMappingURL=workers.start.impl.js.map

package/dist/cli/workers.start.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.start.impl.js","sourceRoot":"","sources":["../../src/cli/workers.start.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,KAAqB,EAAE,KAAqB,EAAE,OAAuB;QAClF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC;YAC1F,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,OAAO;YAChB,MAAM;SACN,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAkB,WAAW,CAAC,CAAC;YAC/D,IAAI,CAAC,EAAE,EAAE,mBAAmB,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAC9C,MAAM,IAAI,eAAe,CAAC,mDAAmD,EAAE,aAAa,EAAE;oBAC7F,YAAY,EAAE,0EAA0E;iBACxF,CAAC,CAAC;YACJ,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,YAAY,MAAM,kCAAkC,CAAC,CAAC;YAC/D,MAAM,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,qBAAqB,CAAC,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,2BAA2B,MAAM,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,eAAe;gBAAE,MAAM,KAAK,CAAC;YAClD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,MAAM,IAAI,eAAe,CAAC,4BAA4B,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChG,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/cli/workers.status.descriptor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Workers Status CLI Command Descriptor
+ */
+declare const _default: {
+    readonly kind: "cli/command";
+    readonly id: "workers.status";
+    readonly name: "status";
+    readonly description: "Show worker runtime status";
+    readonly group: "workers";
+    readonly options: [{
+        readonly flags: "--json";
+        readonly description: "Output as JSON";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer", "cloud"];
+    readonly enabled: true;
+};
+export default _default;
+//# sourceMappingURL=workers.status.descriptor.d.ts.map

package/dist/cli/workers.status.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.status.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/workers.status.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;AAIH,wBAiBG"}

package/dist/cli/workers.status.descriptor.js

@@ -0,0 +1,21 @@
+/**
+ * Workers Status CLI Command Descriptor
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    kind: 'cli/command',
+    id: 'workers.status',
+    name: 'status',
+    description: 'Show worker runtime status',
+    group: 'workers',
+    options: [
+        {
+            flags: '--json',
+            description: 'Output as JSON'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+});
+//# sourceMappingURL=workers.status.descriptor.js.map

package/dist/cli/workers.status.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.status.descriptor.js","sourceRoot":"","sources":["../../src/cli/workers.status.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,4BAA4B;IACzC,KAAK,EAAE,SAAS;IAEhB,OAAO,EAAE;QACR;YACC,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,gBAAgB;SAC7B;KACD;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/cli/workers.status.impl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Workers Status CLI Command Implementation
+ *
+ * Wraps PM status command for worker processes.
+ */
+declare const _default: import("@vibesdotdev/cli").CommandImplementation;
+export default _default;
+//# sourceMappingURL=workers.status.impl.d.ts.map

package/dist/cli/workers.status.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.status.impl.d.ts","sourceRoot":"","sources":["../../src/cli/workers.status.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AA+BH,wBAiDG"}

package/dist/cli/workers.status.impl.js

@@ -0,0 +1,75 @@
+/**
+ * Workers Status CLI Command Implementation
+ *
+ * Wraps PM status command for worker processes.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { defineCommandImplementation } from '@vibesdotdev/cli';
+import { writeJson } from '@vibesdotdev/cli/output';
+import { CapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { settle } from "../core/settle.js";
+import { openWorkersCommandOutput } from "./command-output.js";
+import { PROCESS_IDS } from "./schemas/types.js";
+/** The options `workers status` reads (descriptor `workers.status`). */
+const StatusOptionsSchema = z.object({ json: z.boolean().optional() });
+/** The PM status facts this command shows. */
+const PmStatusSchema = z.object({
+    status: z.string(),
+    pid: z.number().optional(),
+    uptime: z.number().optional()
+});
+/** PM's status for the worker process, or null when PM reports none it can show. */
+async function readPmStatus(runtime, processId) {
+    const pm = await runtime.context('pm/client');
+    if (!pm?.getStatus)
+        return null;
+    const parsed = PmStatusSchema.safeParse(await pm.getStatus(processId));
+    return parsed.success ? parsed.data : null;
+}
+export default defineCommandImplementation({
+    options: StatusOptionsSchema,
+    async execute(_args, options, context) {
+        const target = context.runtime.scope.hardware;
+        const processId = PROCESS_IDS[target];
+        try {
+            // Try to get PM context for status
+            const runtime = context.runtime;
+            const lookup = await settle(() => readPmStatus(runtime, processId));
+            if (!lookup.ok) {
+                // PM status is optional detail: report the reason and show the status as unknown.
+                getLogger('workers-cli-status', runtime).warn('PM status unavailable', { processId, error: valueFreeFailure(lookup.caught) });
+            }
+            const pmStatus = lookup.ok ? lookup.value : null;
+            if (options.json) {
+                await writeJson(runtime, {
+                    target,
+                    processId,
+                    status: pmStatus?.status ?? 'unknown',
+                    pid: pmStatus?.pid,
+                    uptime: pmStatus?.uptime
+                });
+                return;
+            }
+            const out = await openWorkersCommandOutput(runtime);
+            out.line(`\nWorker Runtime Status (${target}):`);
+            out.line('─'.repeat(40));
+            out.line(`Process ID:  ${processId}`);
+            out.line(`Status:      ${pmStatus?.status ?? 'unknown'}`);
+            if (pmStatus?.pid) {
+                out.line(`PID:         ${pmStatus.pid}`);
+            }
+            if (pmStatus?.uptime) {
+                out.line(`Uptime:      ${Math.floor(pmStatus.uptime / 1000)}s`);
+            }
+            out.line('');
+            out.line('Use "vibes pm status" for more details.');
+        }
+        catch (error) {
+            if (error instanceof CapabilityError)
+                throw error;
+            throw new CapabilityError(`Failed to get status: ${error instanceof Error ? error.message : String(error)}`, 'INTERNAL', { cause: error });
+        }
+    }
+});
+//# sourceMappingURL=workers.status.impl.js.map

package/dist/cli/workers.status.impl.js.map

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

package/dist/cli/workers.stop.descriptor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Workers Stop CLI Command Descriptor
+ */
+declare const _default: {
+    readonly kind: "cli/command";
+    readonly id: "workers.stop";
+    readonly name: "stop";
+    readonly description: "Stop worker runtime through process manager";
+    readonly group: "workers";
+    readonly options: [{
+        readonly flags: "-f, --force";
+        readonly description: "Force kill worker process";
+    }, {
+        readonly flags: "-t, --timeout <ms>";
+        readonly description: "Shutdown timeout in milliseconds";
+        readonly default: "10000";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: ["consumer", "cloud"];
+    readonly enabled: true;
+};
+export default _default;
+//# sourceMappingURL=workers.stop.descriptor.d.ts.map

package/dist/cli/workers.stop.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.stop.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/workers.stop.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;;;;;AAIH,wBAsBG"}

package/dist/cli/workers.stop.descriptor.js

@@ -0,0 +1,26 @@
+/**
+ * Workers Stop CLI Command Descriptor
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    kind: 'cli/command',
+    id: 'workers.stop',
+    name: 'stop',
+    description: 'Stop worker runtime through process manager',
+    group: 'workers',
+    options: [
+        {
+            flags: '-f, --force',
+            description: 'Force kill worker process'
+        },
+        {
+            flags: '-t, --timeout <ms>',
+            description: 'Shutdown timeout in milliseconds',
+            default: '10000'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+});
+//# sourceMappingURL=workers.stop.descriptor.js.map

package/dist/cli/workers.stop.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.stop.descriptor.js","sourceRoot":"","sources":["../../src/cli/workers.stop.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,6CAA6C;IAC1D,KAAK,EAAE,SAAS;IAEhB,OAAO,EAAE;QACR;YACC,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,2BAA2B;SACxC;QACD;YACC,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,kCAAkC;YAC/C,OAAO,EAAE,OAAO;SAChB;KACD;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/cli/workers.stop.impl.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Workers Stop CLI Command Implementation
+ */
+declare const _default: import("@vibesdotdev/cli").CommandImplementation;
+export default _default;
+//# sourceMappingURL=workers.stop.impl.d.ts.map

package/dist/cli/workers.stop.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.stop.impl.d.ts","sourceRoot":"","sources":["../../src/cli/workers.stop.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;;AA2DH,wBA2BG"}

package/dist/cli/workers.stop.impl.js

@@ -0,0 +1,71 @@
+/**
+ * Workers Stop CLI Command Implementation
+ */
+import { defineCommandImplementation } from '@vibesdotdev/cli';
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError, isCapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { settle } from "../core/settle.js";
+import { openWorkersCommandOutput } from "./command-output.js";
+import { PROCESS_IDS } from "./schemas/types.js";
+/** The options `workers stop` reads (descriptor `workers.stop`). */
+const StopOptionsSchema = z.object({
+    force: z.boolean().optional(),
+    timeout: z.union([z.string(), z.number()]).optional()
+});
+function parseTimeout(input) {
+    const value = Number(input ?? 10000);
+    return Number.isFinite(value) && value > 0 ? value : 10000;
+}
+async function stopWorkers({ runtime, target, force, timeoutMs, logger, out }) {
+    const pm = await runtime.context('pm/client');
+    if (!pm?.stop) {
+        logger.error('pm client context unavailable');
+        throw new CapabilityError('PM client is unavailable in this scope.', 'UNAVAILABLE', {
+            recoveryHint: 'Start PM first before stopping workers.'
+        });
+    }
+    const processId = PROCESS_IDS[target];
+    if (pm.isRunning && !(await pm.isRunning(processId))) {
+        logger.info('worker runtime already stopped', { processId });
+        out.line(`${target} workers are already stopped (${processId}).`);
+        return;
+    }
+    out.line(`Stopping ${target} workers...`);
+    await pm.stop(processId, { force, timeout: timeoutMs });
+    logger.info('worker runtime stopped', {
+        processId,
+        force: force ?? false,
+        timeoutMs
+    });
+    out.line(`${target} workers stopped (${processId}).`);
+}
+export default defineCommandImplementation({
+    options: StopOptionsSchema,
+    async execute(_args, options, context) {
+        const runtime = context.runtime;
+        const target = runtime.scope.hardware;
+        const timeoutMs = parseTimeout(options.timeout);
+        const logger = getLogger('worker-runtime', runtime).child('cli.stop').withContext({
+            service: 'workers-cli',
+            command: 'stop',
+            target
+        });
+        const out = await openWorkersCommandOutput(runtime);
+        const stopped = await settle(() => stopWorkers({ runtime, target, force: options.force, timeoutMs, logger, out }));
+        if (stopped.ok)
+            return;
+        const failure = stopped.caught;
+        if (isCapabilityError(failure))
+            throw failure;
+        const message = failure instanceof Error ? failure.message : failure.description;
+        // PM reports a process that is already gone as a failure; for stop that is the goal state.
+        if (message.includes('not running') || message.includes('not found')) {
+            out.line(`${target} workers are already stopped.`);
+            return;
+        }
+        logger.error('workers stop failed', { error: valueFreeFailure(failure) });
+        throw new CapabilityError(`Failed to stop workers: ${message}`, 'INTERNAL', { cause: stopped.thrown });
+    }
+});
+//# sourceMappingURL=workers.stop.impl.js.map