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

package/dist/store/process-state.impl.consumer.js.map

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

package/dist/store/resource-state.impl.consumer.d.ts

@@ -0,0 +1,9 @@
+import type { SqliteConnection } from '@vibesdotdev/localdb';
+import { type ResourceState } from '../schemas/resource.ts';
+export declare function getResourceState(sqlite: SqliteConnection, resourceId: string): ResourceState | undefined;
+export declare function getAllResourceStates(sqlite: SqliteConnection): ResourceState[];
+export declare function getResourceStatesByStatus(sqlite: SqliteConnection, status: ResourceState['status']): ResourceState[];
+export declare function setResourceState(sqlite: SqliteConnection, state: ResourceState): void;
+export declare function deleteResourceState(sqlite: SqliteConnection, resourceId: string): void;
+export declare function clearResourceStates(sqlite: SqliteConnection): void;
+//# sourceMappingURL=resource-state.impl.consumer.d.ts.map

package/dist/store/resource-state.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-state.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/store/resource-state.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAMxG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAG9E;AAED,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC7B,aAAa,EAAE,CAKjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAuBrF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAElE"}

package/dist/store/resource-state.impl.consumer.js

@@ -0,0 +1,48 @@
+import { ResourceStateSchema } from "../schemas/resource.js";
+export function getResourceState(sqlite, resourceId) {
+    const row = sqlite
+        .prepare('SELECT * FROM resource_states WHERE id = ?')
+        .get(resourceId);
+    return row ? rowToResourceState(row) : undefined;
+}
+export function getAllResourceStates(sqlite) {
+    const rows = sqlite.prepare('SELECT * FROM resource_states').all();
+    return rows.map((row) => rowToResourceState(row));
+}
+export function getResourceStatesByStatus(sqlite, status) {
+    const rows = sqlite
+        .prepare('SELECT * FROM resource_states WHERE status = ?')
+        .all(status);
+    return rows.map((row) => rowToResourceState(row));
+}
+export function setResourceState(sqlite, state) {
+    const validated = ResourceStateSchema.parse(state);
+    sqlite
+        .prepare(`INSERT OR REPLACE INTO resource_states (
+				id, type, status, created_at, updated_at, last_checked,
+				metadata, config, error, last_error, progress
+			) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(validated.id, validated.type, validated.status, validated.createdAt?.toISOString() ?? null, validated.updatedAt?.toISOString() ?? null, validated.lastChecked.toISOString(), validated.metadata ? JSON.stringify(validated.metadata) : null, validated.config ? JSON.stringify(validated.config) : null, validated.error ?? null, validated.lastError ?? null, validated.progress ?? null);
+}
+export function deleteResourceState(sqlite, resourceId) {
+    sqlite.prepare('DELETE FROM resource_states WHERE id = ?').run(resourceId);
+}
+export function clearResourceStates(sqlite) {
+    sqlite.prepare('DELETE FROM resource_states').run();
+}
+function rowToResourceState(row) {
+    return ResourceStateSchema.parse({
+        id: row.id,
+        type: row.type,
+        status: row.status,
+        createdAt: row.created_at ? new Date(row.created_at) : undefined,
+        updatedAt: row.updated_at ? new Date(row.updated_at) : undefined,
+        lastChecked: new Date(row.last_checked),
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        config: row.config ? JSON.parse(row.config) : undefined,
+        error: row.error ?? undefined,
+        lastError: row.last_error ?? undefined,
+        progress: row.progress ?? undefined
+    });
+}
+//# sourceMappingURL=resource-state.impl.consumer.js.map

package/dist/store/resource-state.impl.consumer.js.map

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

package/dist/store.impl.consumer.d.ts

@@ -0,0 +1,121 @@
+/** PM state store backed by LocalDB. */
+import type { ProcessConfig, ProcessState } from './schemas/process.ts';
+import type { TaskObligation } from './schemas/task-supervision.ts';
+import type { ResourceState } from './schemas/resource.ts';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ProcessRunEndListener, ProcessStateListener, ProcessStateUpsert, ProcessStoreOptions } from './schemas/store.ts';
+export type { ProcessRunEnd, ProcessRunEndListener, ProcessStateListener, ProcessStateUpsert, RunEndInitiator } from './schemas/store.ts';
+export declare function isProcessRunEnd(existing: ProcessState, updates: Partial<ProcessState>): boolean;
+export declare class ProcessStore {
+    private readonly host;
+    private readonly processAdmission;
+    private localDatabase;
+    private scope;
+    private initialized;
+    /** Where this store lives (see ProcessStoreOptions). */
+    private readonly location;
+    private readonly runEndListeners;
+    /** Each process's run-end listeners still at work (the log archive), so a removal can wait them out. */
+    private readonly runEndsInFlight;
+    private readonly stateListeners;
+    /**
+     * @param host the runtime PM was handed: its host identity decides whether
+     *   the migration SQL is read from disk or from the embedded copies, and a
+     *   failed state listener is reported on its Logging (C083a).
+     */
+    constructor(options: ProcessStoreOptions, host: RuntimeRef);
+    /** The handed runtime's Logging, read per entry (C083a). */
+    private get log();
+    private getDbPath;
+    private getBasePath;
+    /**
+     * Initialize database schema
+     */
+    private ensureInitialized;
+    private getSqlite;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    get(processId: string): Promise<ProcessState | undefined>;
+    getAll(): Promise<ProcessState[]>;
+    set(state: ProcessState): Promise<void>;
+    withProcessAdmission<Value>(processId: string, operation: () => Promise<Value>, admissionId?: string): Promise<Value>;
+    currentTaskAdmission(processId: string): Promise<string | undefined>;
+    insideProcessAdmission(): Promise<boolean>;
+    taskObligations(processId: string): Promise<TaskObligation[]>;
+    setTaskObligations(processId: string, entries: readonly TaskObligation[]): Promise<void>;
+    bindTaskObligations(processId: string, admissionId: string, startedAt: number): Promise<void>;
+    assertTaskReleaseAvailable(processId: string): Promise<void>;
+    assertTaskLaunchAvailable(processId: string): Promise<void>;
+    /**
+     * Observe committed process state writes: the event PM's own waits
+     * (readiness, health, task outcome) await instead of polling (RC07).
+     * Returns the unsubscriber.
+     */
+    onStateChange(listener: ProcessStateListener): () => void;
+    private emitState;
+    update(processId: string, updates: Partial<ProcessState>): Promise<void>;
+    /**
+     * `update`, guarded: `when` sees the row as it stands at the write (read and
+     * write span no await, so no concurrent writer lands between them), and a
+     * false verdict writes nothing. Resolves whether the write landed.
+     */
+    updateWhen(processId: string, updates: Partial<ProcessState>, when: (existing: ProcessState) => boolean): Promise<boolean>;
+    private existingState;
+    /**
+     * Write `updates` onto the process's state row, creating the row when none
+     * exists. For writers that can run before PM ever recorded a run — adopting
+     * a live holder whose row stale cleanup removed, a pre-spawn hook failure on
+     * a first start — where `update` would throw `Process state not found`. An
+     * existing row takes exactly `update`'s path (single-statement write, run-end
+     * listeners); a new row starts from the schema's zero counters.
+     */
+    upsert(processId: string, updates: ProcessStateUpsert): Promise<void>;
+    private applyUpdate;
+    private notifyRunEnd;
+    /**
+     * Resolves once `processId`'s run-end listeners are done with it. A removal
+     * awaits this first, so the archive cannot write a log after the removal.
+     */
+    runEndSettled(processId: string): Promise<void>;
+    /** Observe run-ending writes (see ProcessRunEnd). Returns the unsubscriber. */
+    onRunEnd(listener: ProcessRunEndListener): () => void;
+    delete(processId: string): Promise<void>;
+    /**
+     * Internal bookkeeping values (e.g. the last store-cleanup timestamp)
+     * that are not process state. Kept in the dedicated `pm_kv` table so
+     * they never appear as fake process rows consumers must filter.
+     */
+    getMeta(key: string): Promise<string | undefined>;
+    setMeta(key: string, value: string): Promise<void>;
+    has(processId: string): Promise<boolean>;
+    getConfig(processId: string): Promise<ProcessConfig | undefined>;
+    getAllConfigs(): Promise<ProcessConfig[]>;
+    hasConfig(processId: string): Promise<boolean>;
+    /** Validate and upsert; several configs land in one transaction. */
+    setConfigs(configs: readonly ProcessConfig[]): Promise<void>;
+    setConfig(config: ProcessConfig): Promise<void>;
+    /** Whether a stored config existed and was removed. */
+    deleteConfig(processId: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getRunning(): Promise<ProcessState[]>;
+    getByStatus(status: ProcessState['status']): Promise<ProcessState[]>;
+    getResource(resourceId: string): Promise<ResourceState | undefined>;
+    getAllResources(): Promise<ResourceState[]>;
+    setResource(state: ResourceState): Promise<void>;
+    updateResource(resourceId: string, updates: Partial<ResourceState>): Promise<void>;
+    deleteResource(resourceId: string): Promise<void>;
+    hasResource(resourceId: string): Promise<boolean>;
+    getResourcesByStatus(status: ResourceState['status']): Promise<ResourceState[]>;
+    /**
+     * Clean up old process and resource states
+     * CRITICAL FIX (Issue 3.2): Remove entries older than the retention period
+     *
+     * @param retentionDays - Number of days to retain stopped/crashed entries (default: 30)
+     * @returns Number of entries cleaned up
+     */
+    cleanupOldEntries(retentionDays?: number): Promise<{
+        processes: number;
+        resources: number;
+    }>;
+}
+//# sourceMappingURL=store.impl.consumer.d.ts.map

package/dist/store.impl.consumer.d.ts.map

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

package/dist/store.impl.consumer.js

@@ -0,0 +1,436 @@
+/** PM state store backed by LocalDB. */
+import { getRuntimePath } from '@vibesdotdev/paths';
+import { localdb } from '@vibesdotdev/localdb';
+import { ProcessAdmission } from "./store/process-admission.js";
+import { registerPMStateMigrations } from "./register-migrations.impl.consumer.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { attempt, attemptSync, failureLabel } from "./utils/attempt.js";
+import { chmodChecked } from '@vibesdotdev/filesystem/core';
+import { pmFileSystem } from "./helpers/runtime-files.js";
+import { clearProcessStates, deleteProcessState, getAllProcessStates, getProcessState, getProcessStatesByStatus, hasProcessStateColumns, setProcessState, updateProcessState } from "./store/process-state.impl.consumer.js";
+import { deleteProcessConfig, bindTaskObligations, getTaskObligations, setTaskObligations, getAllProcessConfigs, getProcessConfig, setProcessConfigs } from "./store/process-config.impl.consumer.js";
+import { clearResourceStates, deleteResourceState, getAllResourceStates, getResourceState, getResourceStatesByStatus, setResourceState } from "./store/resource-state.impl.consumer.js";
+import { getVibesDir } from "./utils/vibes-home.js";
+import { getLogger } from '@vibesdotdev/logging';
+const LIVE_STATUSES = new Set([
+    'running',
+    'starting',
+    'stopping',
+    'waiting'
+]);
+export function isProcessRunEnd(existing, updates) {
+    if (!Number.isInteger(existing.pid))
+        return false;
+    if ('pid' in updates && updates.pid === undefined)
+        return true;
+    return Number.isInteger(updates.exitCode) && LIVE_STATUSES.has(existing.status);
+}
+/**
+ * Pin `path`'s POSIX mode through the filesystem kind's `chmod` capability. A
+ * path removed since it was checked (a WAL checkpoint) has nothing to tighten;
+ * a host without POSIX modes (Windows) has none to pin; a failure on a path
+ * that is still there is the typed `pm-store-mode-failed`, carrying only the
+ * failure's value-free facts. An adapter without the capability refuses typed.
+ */
+async function tightenMode(host, files, path, mode) {
+    if (host.localEnvironment.getPlatform?.() === 'win32')
+        return;
+    const outcome = await attempt(() => chmodChecked(files, path, mode));
+    if (outcome.ok)
+        return;
+    if (!(await files.exists(path)))
+        return;
+    throw new CapabilityError(`The mode of ${path} could not be tightened to ${mode.toString(8)} (${failureLabel(outcome.failure)}).`, 'PERMISSION_DENIED', {
+        reason: 'pm-store-mode-failed',
+        retryable: false,
+        details: { path, mode: mode.toString(8), failure: failureLabel(outcome.failure) },
+        recoveryHint: 'Check that the PM state directory belongs to the user running PM.'
+    });
+}
+/**
+ * The state database's directory must exist (owner-only) and accept a new file;
+ * the database and its WAL are owner-only. One that is not fails here, typed,
+ * instead of as SQLite's bare read-only error on first write.
+ */
+async function ensureWritableSQLiteFile(host, path) {
+    const files = await pmFileSystem(host);
+    const dir = files.dirname(path);
+    await files.mkdir(dir, { recursive: true, mode: 0o700 });
+    await tightenMode(host, files, dir, 0o700);
+    for (const p of [path, `${path}-wal`, `${path}-shm`]) {
+        if (await files.exists(p))
+            await tightenMode(host, files, p, 0o600);
+    }
+    // The directory accepts a new file: a probe published and removed again.
+    const probe = files.join(dir, `.pm-write-probe-${crypto.randomUUID()}`);
+    await files.writeFile(probe, '');
+    await files.remove(probe);
+}
+export class ProcessStore {
+    host;
+    processAdmission;
+    localDatabase = null;
+    scope;
+    initialized = false;
+    /** Where this store lives (see ProcessStoreOptions). */
+    location;
+    runEndListeners = new Set();
+    /** Each process's run-end listeners still at work (the log archive), so a removal can wait them out. */
+    runEndsInFlight = new Map();
+    stateListeners = new Set();
+    /**
+     * @param host the runtime PM was handed: its host identity decides whether
+     *   the migration SQL is read from disk or from the embedded copies, and a
+     *   failed state listener is reported on its Logging (C083a).
+     */
+    constructor(options, host) {
+        this.host = host;
+        this.processAdmission = new ProcessAdmission(host);
+        this.scope = options.scope ?? 'global';
+        this.location = options;
+    }
+    /** The handed runtime's Logging, read per entry (C083a). */
+    get log() {
+        return getLogger('pm:store', this.host);
+    }
+    async getDbPath() {
+        const path = await getRuntimePath(this.host);
+        return path.join(this.getBasePath(path, this.scope), 'pm-state.db');
+    }
+    getBasePath(path, _scope) {
+        const location = this.location;
+        if ('workspaceRoot' in location) {
+            return location.scope === 'local' ? path.join(location.workspaceRoot, '.vibes') : location.workspaceRoot;
+        }
+        // The caller's admitted identity names the partition (see ProcessStoreOptions).
+        return path.join(getVibesDir({ roots: location.roots }), 'pm', 'workspaces', location.workspaceToolingId);
+    }
+    /**
+     * Initialize database schema
+     */
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        const dbPath = await this.getDbPath();
+        await ensureWritableSQLiteFile(this.host, dbPath);
+        await registerPMStateMigrations(this.host);
+        // localdb applies the pm-state migrations, the only schema source
+        // (004 brings process_configs and pm_kv into the chain).
+        this.localDatabase = await localdb.getDatabase(this.host, 'pm-state', dbPath, 'pm-store');
+        this.initialized = true;
+    }
+    async getSqlite() {
+        await this.ensureInitialized();
+        return this.localDatabase.getDatabase();
+    }
+    async load() {
+        await this.ensureInitialized();
+    }
+    async save() {
+        // No-op: All changes are persisted immediately to SQLite
+    }
+    async get(processId) {
+        const sqlite = await this.getSqlite();
+        return getProcessState(sqlite, processId);
+    }
+    async getAll() {
+        const sqlite = await this.getSqlite();
+        return getAllProcessStates(sqlite);
+    }
+    async set(state) {
+        const admissionId = await this.processAdmission.currentTask(state.id);
+        const sqlite = await this.getSqlite();
+        sqlite.transaction(() => {
+            setProcessState(sqlite, state);
+            if (state.startedAt && admissionId)
+                bindTaskObligations(sqlite, state.id, admissionId, state.startedAt.getTime());
+        });
+        this.emitState(state);
+    }
+    withProcessAdmission(processId, operation, admissionId) {
+        return this.processAdmission.run(processId, operation, admissionId);
+    }
+    currentTaskAdmission(processId) {
+        return this.processAdmission.currentTask(processId);
+    }
+    insideProcessAdmission() {
+        return this.processAdmission.active();
+    }
+    async taskObligations(processId) {
+        return getTaskObligations(await this.getSqlite(), processId);
+    }
+    async setTaskObligations(processId, entries) {
+        setTaskObligations(await this.getSqlite(), processId, entries);
+    }
+    async bindTaskObligations(processId, admissionId, startedAt) {
+        bindTaskObligations(await this.getSqlite(), processId, admissionId, startedAt);
+    }
+    async assertTaskReleaseAvailable(processId) {
+        if ((await this.taskObligations(processId)).length > 0)
+            throw new CapabilityError('The PM run still owes a supervised terminal acknowledgement.', 'CONFLICT', { reason: 'pm-task-settlement-pending', details: { processId }, retryable: true });
+    }
+    async assertTaskLaunchAvailable(processId) {
+        const current = await this.processAdmission.currentTask(processId);
+        if ((await this.taskObligations(processId)).some(entry => entry.admissionId !== current || entry.startedAt !== undefined)) {
+            throw new CapabilityError('A previous supervised run still owns its terminal evidence.', 'CONFLICT', {
+                reason: 'pm-task-settlement-pending', details: { processId }, retryable: true
+            });
+        }
+    }
+    /**
+     * Observe committed process state writes: the event PM's own waits
+     * (readiness, health, task outcome) await instead of polling (RC07).
+     * Returns the unsubscriber.
+     */
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    }
+    emitState(state) {
+        for (const listener of this.stateListeners) {
+            const notified = attemptSync(() => listener(state));
+            // A listener failing never fails the write that already landed; the failure is reported, not dropped.
+            if (!notified.ok) {
+                this.log.warn('process state listener failed', { processId: state.id, failure: failureLabel(notified.failure) });
+            }
+        }
+    }
+    async update(processId, updates) {
+        const sqlite = await this.getSqlite();
+        await this.applyUpdate(sqlite, this.existingState(sqlite, processId), updates);
+    }
+    /**
+     * `update`, guarded: `when` sees the row as it stands at the write (read and
+     * write span no await, so no concurrent writer lands between them), and a
+     * false verdict writes nothing. Resolves whether the write landed.
+     */
+    async updateWhen(processId, updates, when) {
+        const sqlite = await this.getSqlite();
+        const existing = this.existingState(sqlite, processId);
+        if (!when(existing))
+            return false;
+        await this.applyUpdate(sqlite, existing, updates);
+        return true;
+    }
+    existingState(sqlite, processId) {
+        const existing = getProcessState(sqlite, processId);
+        if (!existing) {
+            throw new CapabilityError(`Process state not found: ${processId}`, 'NOT_FOUND', {
+                reason: 'pm-process-state-not-found',
+                details: { processId }
+            });
+        }
+        return existing;
+    }
+    /**
+     * Write `updates` onto the process's state row, creating the row when none
+     * exists. For writers that can run before PM ever recorded a run — adopting
+     * a live holder whose row stale cleanup removed, a pre-spawn hook failure on
+     * a first start — where `update` would throw `Process state not found`. An
+     * existing row takes exactly `update`'s path (single-statement write, run-end
+     * listeners); a new row starts from the schema's zero counters.
+     */
+    async upsert(processId, updates) {
+        const sqlite = await this.getSqlite();
+        const existing = getProcessState(sqlite, processId);
+        if (existing) {
+            await this.applyUpdate(sqlite, existing, updates);
+            return;
+        }
+        const created = {
+            restartCount: 0,
+            consecutiveCrashRestarts: 0,
+            retryCount: 0,
+            ...updates,
+            id: processId
+        };
+        setProcessState(sqlite, created);
+        this.emitState(created);
+    }
+    async applyUpdate(sqlite, existing, updates) {
+        const processId = existing.id;
+        // Single-statement UPDATE per field set rather than a read-modify-write
+        // over awaits: the daemon deliberately runs concurrent writers to the
+        // same row (health monitor, exit handler, settle timer, liveness
+        // checker), and last-writer-wins on the whole row persisted stale
+        // pids/healthStatus. A field set with an unmapped field takes the
+        // full-row write, which is safe because get + set span no await. A
+        // write failure propagates either way.
+        if (hasProcessStateColumns(updates)) {
+            updateProcessState(sqlite, processId, updates);
+        }
+        else {
+            setProcessState(sqlite, { ...existing, ...updates });
+        }
+        // Recorded before the state is announced: a waiter it wakes (`awaitExit`)
+        // that removes the process finds this run's end still at work.
+        const runEnd = this.runEndListeners.size > 0 && isProcessRunEnd(existing, updates) ? Promise.withResolvers() : undefined;
+        if (runEnd)
+            this.runEndsInFlight.set(processId, runEnd.promise);
+        this.emitState({ ...existing, ...updates });
+        if (runEnd) {
+            try {
+                await this.notifyRunEnd({ existing, updates });
+            }
+            finally {
+                runEnd.resolve();
+                if (this.runEndsInFlight.get(processId) === runEnd.promise)
+                    this.runEndsInFlight.delete(processId);
+            }
+        }
+    }
+    async notifyRunEnd(event) {
+        for (const listener of this.runEndListeners) {
+            const notified = await attempt(async () => listener(event));
+            // A listener (the log archive) failing never fails the state write
+            // that already landed; the failure is reported, not dropped.
+            if (!notified.ok) {
+                this.log.warn('process run-end listener failed', { processId: event.existing.id, failure: failureLabel(notified.failure) });
+            }
+        }
+    }
+    /**
+     * Resolves once `processId`'s run-end listeners are done with it. A removal
+     * awaits this first, so the archive cannot write a log after the removal.
+     */
+    async runEndSettled(processId) {
+        await this.runEndsInFlight.get(processId);
+    }
+    /** Observe run-ending writes (see ProcessRunEnd). Returns the unsubscriber. */
+    onRunEnd(listener) {
+        this.runEndListeners.add(listener);
+        return () => {
+            this.runEndListeners.delete(listener);
+        };
+    }
+    async delete(processId) {
+        const sqlite = await this.getSqlite();
+        deleteProcessState(sqlite, processId);
+    }
+    /**
+     * Internal bookkeeping values (e.g. the last store-cleanup timestamp)
+     * that are not process state. Kept in the dedicated `pm_kv` table so
+     * they never appear as fake process rows consumers must filter.
+     */
+    async getMeta(key) {
+        const sqlite = await this.getSqlite();
+        const row = sqlite
+            .prepare('SELECT value FROM pm_kv WHERE key = ?')
+            .get(key);
+        return row?.value;
+    }
+    async setMeta(key, value) {
+        const sqlite = await this.getSqlite();
+        sqlite.prepare('INSERT OR REPLACE INTO pm_kv (key, value) VALUES (?, ?)').run(key, value);
+    }
+    async has(processId) {
+        const state = await this.get(processId);
+        return state !== undefined;
+    }
+    // Process configs: what each process was registered or last launched with
+    // (migration 004, replacing pm-registry.json; pm.md K8).
+    async getConfig(processId) {
+        return getProcessConfig(await this.getSqlite(), processId);
+    }
+    async getAllConfigs() {
+        return getAllProcessConfigs(await this.getSqlite());
+    }
+    async hasConfig(processId) {
+        return (await this.getConfig(processId)) !== undefined;
+    }
+    /** Validate and upsert; several configs land in one transaction. */
+    async setConfigs(configs) {
+        setProcessConfigs(await this.getSqlite(), configs);
+    }
+    async setConfig(config) {
+        await this.setConfigs([config]);
+    }
+    /** Whether a stored config existed and was removed. */
+    async deleteConfig(processId) {
+        return deleteProcessConfig(await this.getSqlite(), processId);
+    }
+    async clear() {
+        const sqlite = await this.getSqlite();
+        clearProcessStates(sqlite);
+        clearResourceStates(sqlite);
+    }
+    getRunning() {
+        return this.getByStatus('running');
+    }
+    async getByStatus(status) {
+        const sqlite = await this.getSqlite();
+        return getProcessStatesByStatus(sqlite, status);
+    }
+    async getResource(resourceId) {
+        const sqlite = await this.getSqlite();
+        return getResourceState(sqlite, resourceId);
+    }
+    async getAllResources() {
+        const sqlite = await this.getSqlite();
+        return getAllResourceStates(sqlite);
+    }
+    async setResource(state) {
+        const sqlite = await this.getSqlite();
+        setResourceState(sqlite, state);
+    }
+    async updateResource(resourceId, updates) {
+        const existing = await this.getResource(resourceId);
+        if (!existing) {
+            throw new CapabilityError(`Resource state not found: ${resourceId}`, 'NOT_FOUND', {
+                reason: 'pm-resource-state-not-found',
+                details: { resourceId }
+            });
+        }
+        const updated = { ...existing, ...updates };
+        await this.setResource(updated);
+    }
+    async deleteResource(resourceId) {
+        const sqlite = await this.getSqlite();
+        deleteResourceState(sqlite, resourceId);
+    }
+    async hasResource(resourceId) {
+        const state = await this.getResource(resourceId);
+        return state !== undefined;
+    }
+    async getResourcesByStatus(status) {
+        const sqlite = await this.getSqlite();
+        return getResourceStatesByStatus(sqlite, status);
+    }
+    /**
+     * Clean up old process and resource states
+     * CRITICAL FIX (Issue 3.2): Remove entries older than the retention period
+     *
+     * @param retentionDays - Number of days to retain stopped/crashed entries (default: 30)
+     * @returns Number of entries cleaned up
+     */
+    async cleanupOldEntries(retentionDays = 30) {
+        const sqlite = await this.getSqlite();
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - retentionDays);
+        const cutoffIso = cutoff.toISOString();
+        // Clean up old stopped/crashed/completed process states
+        const processResult = sqlite
+            .prepare(`
+				DELETE FROM process_states
+				WHERE status IN ('stopped', 'crashed', 'completed', 'fail')
+				AND stopped_at IS NOT NULL
+				AND stopped_at < ?;
+			`)
+            .run(cutoffIso);
+        // Clean up old error/missing resource states
+        const resourceResult = sqlite
+            .prepare(`
+				DELETE FROM resource_states
+				WHERE status IN ('error', 'missing')
+				AND last_checked < ?;
+			`)
+            .run(cutoffIso);
+        return {
+            processes: processResult.changes || 0,
+            resources: resourceResult.changes || 0
+        };
+    }
+}
+//# sourceMappingURL=store.impl.consumer.js.map