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

package/dist/daemon/declared-commands.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Declared-target daemon commands (pm.md C1: "the CLI sends ids only").
+ *
+ * The daemon owns the PM graph of its admitted workspace: the kernel
+ * discovered it for the daemon's serve host and bootstrap projected its
+ * `config.plugins.pm`. A client names a preset, process or resource by id;
+ * the daemon resolves it against that graph (plus the configs it stored for
+ * ad-hoc registrations) and runs it. A CLI whose own binding differs from the
+ * daemon's can therefore never overwrite the daemon's registrations with a
+ * second graph.
+ */
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ProcessPreset } from '../schemas/process.ts';
+import type { ResourceConfig } from '../schemas/resource.ts';
+import type { CommandHandler, CommandHandlerDeps, DaemonGraph } from '../schemas/daemon-command.ts';
+/**
+ * `start-declared`. `kind: 'process'` admits only a process id: a resource id
+ * refuses `INVALID_INPUT` `pm-target-not-process` before anything is set up.
+ */
+export declare const DeclaredStartPayloadSchema: z.ZodObject<{
+    id: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        wait: z.ZodOptional<z.ZodBoolean>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    kind: z.ZodOptional<z.ZodLiteral<"process">>;
+}, z.core.$strip>;
+export declare function readDaemonGraph(runtime: VibesRuntime, deps: Pick<CommandHandlerDeps, 'pm'>): Promise<DaemonGraph>;
+/** The declared resource `id` of the daemon's graph, or `NOT_FOUND` `pm-target-not-found`. */
+export declare function requireDeclaredResource(runtime: VibesRuntime, id: string): Promise<ResourceConfig>;
+/**
+ * A direct start of one process has no preset of its own; its declared
+ * `conflicts` are the union over every preset that lists it (`conflicts` is
+ * declared only on presets).
+ */
+export declare function collectConflictsForProcess(presets: ReadonlyArray<Pick<ProcessPreset, 'processes' | 'conflicts'>>, processId: string): string[];
+export declare function registerDeclaredCommands(registry: Map<string, CommandHandler>): void;
+//# sourceMappingURL=declared-commands.d.ts.map

package/dist/daemon/declared-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-commands.d.ts","sourceRoot":"","sources":["../../src/daemon/declared-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAK7D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAuB,MAAM,8BAA8B,CAAC;AAQzH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAIrC,CAAC;AAGH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAGvH;AAED,8FAA8F;AAC9F,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAUxG;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC,EACtE,SAAS,EAAE,MAAM,GACf,MAAM,EAAE,CAOV;AAiCD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAqHpF"}

package/dist/daemon/declared-commands.js

@@ -0,0 +1,200 @@
+/**
+ * Declared-target daemon commands (pm.md C1: "the CLI sends ids only").
+ *
+ * The daemon owns the PM graph of its admitted workspace: the kernel
+ * discovered it for the daemon's serve host and bootstrap projected its
+ * `config.plugins.pm`. A client names a preset, process or resource by id;
+ * the daemon resolves it against that graph (plus the configs it stored for
+ * ad-hoc registrations) and runs it. A CLI whose own binding differs from the
+ * daemon's can therefore never overwrite the daemon's registrations with a
+ * second graph.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { readPMGraph, requirePreset } from "../graph.js";
+import { applyLivenessOverrides } from "../services/liveness-state.js";
+import { mergeProcessPool, processLaunchIdentityChanged } from "../helpers/launch-identity.js";
+import { parseCommandPayload } from "./command-payload.js";
+const ExecutionOptionsSchema = z
+    .object({ wait: z.boolean().optional(), timeout: z.number().int().positive().optional() })
+    .optional();
+const PresetPayloadSchema = z.object({ presetId: z.string().min(1), options: ExecutionOptionsSchema });
+/**
+ * `start-declared`. `kind: 'process'` admits only a process id: a resource id
+ * refuses `INVALID_INPUT` `pm-target-not-process` before anything is set up.
+ */
+export const DeclaredStartPayloadSchema = z.object({
+    id: z.string().min(1),
+    options: ExecutionOptionsSchema,
+    kind: z.literal('process').optional()
+});
+export async function readDaemonGraph(runtime, deps) {
+    const graph = await readPMGraph(runtime);
+    return { graph, processes: mergeProcessPool(await deps.pm.getAllConfigs(), graph.configs) };
+}
+/** The declared resource `id` of the daemon's graph, or `NOT_FOUND` `pm-target-not-found`. */
+export async function requireDeclaredResource(runtime, id) {
+    const resource = (await readPMGraph(runtime)).resources.find((candidate) => candidate.id === id);
+    if (!resource) {
+        throw new CapabilityError(`Resource '${id}' is not declared in this workspace.`, 'NOT_FOUND', {
+            reason: 'pm-target-not-found',
+            recoveryHint: "Run 'vibes pm resource list' to see declared resources.",
+            details: { id }
+        });
+    }
+    return resource;
+}
+/**
+ * A direct start of one process has no preset of its own; its declared
+ * `conflicts` are the union over every preset that lists it (`conflicts` is
+ * declared only on presets).
+ */
+export function collectConflictsForProcess(presets, processId) {
+    const ids = new Set();
+    for (const preset of presets) {
+        if (!preset.processes?.includes(processId))
+            continue;
+        for (const conflictId of preset.conflicts ?? [])
+            ids.add(conflictId);
+    }
+    return [...ids];
+}
+async function watchStarted(runtime, deps, processes, started) {
+    // Preset starts bypass the single-process 'start' command, so wire up PM
+    // file watchers here too, from the EFFECTIVE config (the active liveness
+    // profile may add watch config).
+    const startedIds = new Set(started);
+    for (const raw of processes) {
+        if (!startedIds.has(raw.id))
+            continue;
+        const effective = applyLivenessOverrides(runtime, raw, deps.host.getActiveLivenessProfile('local'));
+        if (effective.watch)
+            await deps.configWatcher.setupProcessWatcher(effective);
+    }
+}
+function syntheticPreset(id, kind, conflicts) {
+    const preset = {
+        id: `__start-${id}`,
+        name: id,
+        autoStart: false,
+        processes: kind === 'process' ? [id] : [],
+        resources: kind === 'resource' ? [id] : []
+    };
+    // PresetExecutor.start() stops `preset.conflicts` first for every preset.
+    if (conflicts.length > 0)
+        preset.conflicts = conflicts;
+    return preset;
+}
+export function registerDeclaredCommands(registry) {
+    registry.set('preset-start', async (message, deps, runtime) => {
+        const { presetId, options } = parseCommandPayload('preset-start', PresetPayloadSchema, message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const result = await deps.executor.start(requirePreset(graph, presetId), processes, graph.resources, options);
+        await watchStarted(runtime, deps, processes, result.processesStarted);
+        return { result };
+    });
+    registry.set('preset-stop', async (message, deps, runtime) => {
+        const { presetId } = parseCommandPayload('preset-stop', PresetPayloadSchema, message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const result = await deps.executor.stop(requirePreset(graph, presetId), processes, graph.resources);
+        return { result };
+    });
+    registry.set('preset-restart', async (message, deps, runtime) => {
+        const { presetId, options } = parseCommandPayload('preset-restart', PresetPayloadSchema, message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const result = await deps.executor.restart(requirePreset(graph, presetId), processes, graph.resources, options);
+        await watchStarted(runtime, deps, processes, result.processesStarted);
+        return { result };
+    });
+    registry.set('preset-teardown', async (message, deps, runtime) => {
+        const { presetId } = parseCommandPayload('preset-teardown', PresetPayloadSchema, message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const result = await deps.executor.teardown(requirePreset(graph, presetId), processes, graph.resources);
+        return { result };
+    });
+    /**
+     * Start every declared process and resource of the daemon's graph, in
+     * dependency order, as one synthetic preset.
+     */
+    registry.set('start-all', async (message, deps, runtime) => {
+        const { options } = parseCommandPayload('start-all', z.object({ options: ExecutionOptionsSchema }), message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const all = {
+            id: '__start-all',
+            name: 'All',
+            autoStart: false,
+            processes: graph.configs.map((config) => config.id),
+            resources: graph.resources.map((resource) => resource.id)
+        };
+        const result = await deps.executor.start(all, processes, graph.resources, options);
+        await watchStarted(runtime, deps, processes, result.processesStarted);
+        return { result, declared: { processes: all.processes?.length ?? 0, resources: all.resources?.length ?? 0 } };
+    });
+    /**
+     * Start one declared process or resource by id, with its declared
+     * dependencies and conflicts: a resource or process that declares
+     * dependencies runs through the PresetExecutor as a synthetic one-item
+     * preset (dependency order, health gating); otherwise a resource is set up
+     * and a process is started directly.
+     */
+    registry.set('start-declared', async (message, deps, runtime) => {
+        const { id, options, kind } = parseCommandPayload('start-declared', DeclaredStartPayloadSchema, message);
+        const { graph, processes } = await readDaemonGraph(runtime, deps);
+        const resource = graph.resources.find((candidate) => candidate.id === id);
+        if (resource && kind === 'process') {
+            throw new CapabilityError(`'${id}' is a declared resource, not a process.`, 'INVALID_INPUT', {
+                reason: 'pm-target-not-process',
+                details: { id }
+            });
+        }
+        if (resource) {
+            if ((resource.dependencies?.length ?? 0) > 0) {
+                const result = await deps.executor.start(syntheticPreset(id, 'resource', []), processes, graph.resources, options);
+                await watchStarted(runtime, deps, processes, result.processesStarted);
+                return { started: { kind: 'dependencies', result } };
+            }
+            const existing = await deps.rm.getState(id);
+            if (existing?.status === 'ready') {
+                const result = { state: existing, skipped: true, skipReason: 'already ready' };
+                return { started: { kind: 'resource', result } };
+            }
+            const result = await deps.rm.setup(resource);
+            return { started: { kind: 'resource', result } };
+        }
+        const config = processes.find((candidate) => candidate.id === id);
+        if (!config) {
+            throw new CapabilityError(`Process or resource '${id}' is not declared in this workspace.`, 'NOT_FOUND', {
+                reason: 'pm-target-not-found',
+                recoveryHint: "Run 'vibes pm list --all' to see declared processes and resources.",
+                details: { id }
+            });
+        }
+        const conflicts = collectConflictsForProcess(graph.presets, id);
+        if ((config.dependencies?.length ?? 0) > 0) {
+            const result = await deps.executor.start(syntheticPreset(id, 'process', conflicts), processes, graph.resources, options);
+            await watchStarted(runtime, deps, processes, result.processesStarted);
+            // The target's own state after the executor: its run (or, for a
+            // runOnce task the executor skipped as passed, its committed pass).
+            const target = await deps.pm.getStatus(id);
+            const started = target ? { kind: 'dependencies', result, target } : { kind: 'dependencies', result };
+            return { started };
+        }
+        // A running process is left alone only when it is the process this
+        // start would launch; a changed launch artifact is stopped and relaunched.
+        if (await deps.pm.isRunning(id)) {
+            const current = await deps.pm.getConfig(id);
+            const running = await deps.pm.getStatus(id);
+            if (!processLaunchIdentityChanged(current, config) && running) {
+                return { started: { kind: 'process', state: running, alreadyRunning: true } };
+            }
+            await deps.configWatcher.cleanupProcessWatcher(id);
+            await deps.pm.stop(id);
+        }
+        if (conflicts.length > 0)
+            await deps.executor.stopConflictingProcesses(conflicts);
+        const state = await deps.pm.start(config, { ...options, resetRestartCount: true });
+        await watchStarted(runtime, deps, [config], [config.id]);
+        return { started: { kind: 'process', state } };
+    });
+}
+//# sourceMappingURL=declared-commands.js.map

package/dist/daemon/declared-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-commands.js","sourceRoot":"","sources":["../../src/daemon/declared-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,sBAAsB,GAAG,CAAC;KAC9B,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;KACzF,QAAQ,EAAE,CAAC;AAEb,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;AACvG;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,sBAAsB;IAC/B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAGH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAqB,EAAE,IAAoC;IAChG,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAqB,EAAE,EAAU;IAC9E,MAAM,QAAQ,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,sCAAsC,EAAE,WAAW,EAAE;YAC7F,MAAM,EAAE,qBAAqB;YAC7B,YAAY,EAAE,yDAAyD;YACvE,OAAO,EAAE,EAAE,EAAE,EAAE;SACf,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACzC,OAAsE,EACtE,SAAiB;IAEjB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAS;QACrD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,YAAY,CAC1B,OAAqB,EACrB,IAAwB,EACxB,SAAmC,EACnC,OAA0B;IAE1B,yEAAyE;IACzE,yEAAyE;IACzE,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QACtC,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpG,IAAI,SAAS,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;AACF,CAAC;AAGD,SAAS,eAAe,CAAC,EAAU,EAAE,IAA4B,EAAE,SAAmB;IACrF,MAAM,MAAM,GAAkB;QAC7B,EAAE,EAAE,WAAW,EAAE,EAAE;QACnB,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACzC,SAAS,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KAC1C,CAAC;IACF,0EAA0E;IAC1E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;IACvD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAqC;IAC7E,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC7D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,cAAc,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAChG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9G,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QACtF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,MAAM,GAAqB,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACtH,OAAO,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC/D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAClG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAChH,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC1F,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,MAAM,GAAqB,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1H,OAAO,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7G,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,GAAG,GAAkB;YAC1B,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;SACzD,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnF,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC/D,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,OAAO,CAAC,CAAC;QACzG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1E,IAAI,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,0CAA0C,EAAE,eAAe,EAAE;gBAC5F,MAAM,EAAE,uBAAuB;gBAC/B,OAAO,EAAE,EAAE,EAAE,EAAE;aACf,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACnH,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBACtE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAgC,EAAE,CAAC;YACpF,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,QAAQ,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAwB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;gBACpG,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAgC,EAAE,CAAC;YAChF,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAgC,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,wBAAwB,EAAE,sCAAsC,EAAE,WAAW,EAAE;gBACxG,MAAM,EAAE,qBAAqB;gBAC7B,YAAY,EAAE,oEAAoE;gBAClF,OAAO,EAAE,EAAE,EAAE,EAAE;aACf,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzH,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;YACtE,gEAAgE;YAChE,oEAAoE;YACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAwB,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;YAC1H,OAAO,EAAE,OAAO,EAAE,CAAC;QACpB,CAAC;QACD,mEAAmE;QACnE,2EAA2E;QAC3E,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC/D,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAgC,EAAE,CAAC;YAC7G,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAgC,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/daemon/executable-freshness-reconciler.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Executable-freshness reconciler — the PM daemon rolls what runs a replaced binary.
+ *
+ * A managed process keeps executing the inode it was spawned from. When a
+ * release installs a new `vibes` executable by atomic rename, every managed
+ * process — and this daemon — is silently behind. Measured 2026-08-28: 7 of 9
+ * vibes daemons on one host ran a deleted inode (the PM daemon since Aug 25)
+ * while `vibes pm status` showed all green. Drew's rule: staleness is surfaced
+ * and self-repaired; never worked around.
+ *
+ * TWO PREDICATES, not one. Under the thin host the executable is recompiled
+ * VERY RARELY: almost every real change arrives as a change to the MODULE GRAPH
+ * under the resolution root R (`vibes update` → `bun install`/`bun update`, a
+ * linked provider moving, a plugin added or removed). A body that imported that
+ * graph once at boot is exactly as stale as one running a replaced inode, and
+ * the executable nerve cannot see it — the binary is byte-identical. So a child
+ * is stale when EITHER its executable was replaced OR the graph under the root
+ * it was spawned against was replaced. PM records `VIBES_HOST_ROOT` and the
+ * lock digest per child at spawn time (`services/lifecycle.ts`) precisely so
+ * the second predicate compares against what that child actually loaded rather
+ * than against a wall-clock guess.
+ *
+ * THE ONE PLACE that stamp lives is the child's persisted `config.env` — the
+ * `ProcessConfig` that `services/lifecycle.ts` hands to `registry.register`
+ * after spawn. This reconciler and `cli/pm.status.impl.ts` both read that and
+ * only that, so the daemon and the CLI can never disagree about a child.
+ *
+ * A child WITHOUT a persisted stamp is UNKNOWN, never stale. Measured
+ * 2026-09-01: this daemon substituted its own boot digest for children it could
+ * not judge and rolled four healthy services every tick for hours
+ * (`lock e5ee7529efe9 → 96fb19f6d739`, where `e5ee…` was the DAEMON's digest,
+ * not anything a child had loaded). The daemon's identity is evidence about the
+ * daemon; it is never evidence about a child.
+ *
+ * Each tick (30s):
+ *   1. Roll ONE stale first-party child (config.command is this daemon's own
+ *      executable) per tick, oldest first, once the new file has settled —
+ *      spacing restarts so a fleet never thunders. Finite tasks are skipped.
+ *      A child rolled `maxIdenticalRolls` times without its recorded digest
+ *      changing trips a circuit breaker: one warning, no further rolls, and it
+ *      stops holding the daemon back — a respawn that changes nothing is the
+ *      supervisor's defect, and repeating it is not a repair.
+ *   2. When no child is genuinely stale-and-still-rolling and this daemon
+ *      itself is stale, hand off: spawn `vibes pm daemon restart` detached
+ *      through the host's declared self-spawn argv. That argv names the
+ *      executable PATH the daemon was launched from, and an atomic-rename
+ *      release put the NEW file at that path — so the handoff runs the new
+ *      build without guessing a binary. The restart command stops this daemon
+ *      (pid exit AND socket refusal) and starts a fresh one, which then owns
+ *      the children with the new build. Unknown and breaker-tripped children
+ *      do not block the handoff.
+ *
+ * Opt out with VIBES_PM_EXECUTABLE_FRESHNESS=0 (for debugging a pinned build).
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ExecutableFreshnessReconcilerDeps, ReconcilerRuntime, ReconcileReport } from '../schemas/executable-freshness.ts';
+export type { ExecutableFreshnessReconcilerDeps, ReconcilerLogger, ReconcilerProcessManager, ReconcilerRuntime, ReconcileReport } from '../schemas/executable-freshness.ts';
+/**
+ * The handoff command line: the host's declared self-spawn argv plus
+ * `pm daemon restart`. Fails closed when no host declared re-entry — a
+ * daemon that cannot name its own CLI must not guess `process.execPath`.
+ */
+export declare function composeDaemonRestartHandoffArgv(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): Promise<[string, ...string[]]>;
+/**
+ * Default handoff: let the shipping command do the stop/start dance from the
+ * new file. It runs on the daemon's own runtime and carries only PM's base set
+ * and the host's re-entry facts and roots (C15); `VIBES_PM_HANDOFF` had no
+ * reader and is gone.
+ */
+export declare function spawnDaemonRestartHandoff(runtime: ReconcilerRuntime): Promise<void>;
+export declare class ExecutableFreshnessReconciler {
+    private readonly deps;
+    private readonly injectedLogger;
+    private readonly enabled;
+    private readonly settleMs;
+    private readonly cooldownMs;
+    private readonly maxIdenticalRolls;
+    private readonly now;
+    /** Physical launch facts survive provider replacement; probe implementations do not. */
+    private host;
+    private readonly handoff;
+    private readonly lastRolledAt;
+    private readonly rollLedger;
+    private handoffRequestedAt;
+    /** The injected logger, else the daemon runtime's Logging per entry, following hot-reload generations (C083a). */
+    private get logger();
+    constructor(deps: ExecutableFreshnessReconcilerDeps);
+    /**
+     * Pin the daemon's physical launch facts once, but resolve probe implementations
+     * through the current runtime on every tick. Test seams replace members.
+     * The daemon's own graph digest is the one its host pinned at boot
+     * (`graphFreshness().loaded`): a digest read later would already be the
+     * post-update one and the daemon would judge itself fresh forever.
+     */
+    private resolveHost;
+    private settled;
+    tick(): Promise<ReconcileReport>;
+}
+//# sourceMappingURL=executable-freshness-reconciler.d.ts.map

package/dist/daemon/executable-freshness-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable-freshness-reconciler.d.ts","sourceRoot":"","sources":["../../src/daemon/executable-freshness-reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,EAKN,KAAK,UAAU,EACf,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EAAE,iCAAiC,EAAoB,iBAAiB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAQlJ,YAAY,EAAE,iCAAiC,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAyB5K;;;;GAIG;AACH,wBAAsB,+BAA+B,CACpD,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAC5C,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAGhC;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzF;AAcD,qBAAa,6BAA6B;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,wFAAwF;IACxF,OAAO,CAAC,IAAI,CAAoF;IAChG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,kBAAkB,CAAuB;IAEjD,kHAAkH;IAClH,OAAO,KAAK,MAAM,GAEjB;gBAEW,IAAI,EAAE,iCAAiC;IAWnD;;;;;;OAMG;YACW,WAAW;IA0BzB,OAAO,CAAC,OAAO;IAIT,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;CAyNtC"}