@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/application/update-scheduler-lease-state.js

@@ -0,0 +1,122 @@
+import { compareUtf8 } from "../domain/canonical-json.js";
+import { deriveMarketplaceRegistrationId } from "../domain/marketplace-registration.js";
+import { HostConfigDocumentSchema } from "../domain/state/config-state.js";
+import { ProjectLocalStateDocumentSchema } from "../domain/state/project-state.js";
+import { ScopeContextSchema, toScopeReference } from "../domain/state/scope.js";
+import { UpdateSchedulerLeaseIdSchema, UpdateSchedulerLeaseSchema } from "../domain/update-policy.js";
+import { marketplaceUpdateRecords } from "./marketplace-update-state.js";
+import { parseStateMutation } from "./state-contract.js";
+import { authorizeCurrentScope } from "./current-scope-authority.js";
+export function createStateUpdateSchedulerLeasePort(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object" || typeof dependencies.sha256 !== "function")
+        throw new TypeError("scheduler lease state dependencies are required");
+    async function userCadence(signal) {
+        const loaded = await dependencies.state.read({ kind: "user" }, signal);
+        return loaded.ok && "config" in loaded.snapshot ? loaded.snapshot.config.global.cadence : "paused";
+    }
+    async function projectAuthorized(context, signal) {
+        return (await authorizeCurrentScope(context, dependencies, signal)).kind === "trusted";
+    }
+    async function inventory(signal) {
+        const discovered = await dependencies.inventory.discover(signal);
+        const cadence = await userCadence(signal);
+        const plans = [];
+        for (const contextInput of discovered.scopes) {
+            const context = ScopeContextSchema.parse(contextInput);
+            if (!await projectAuthorized(context, signal))
+                continue;
+            const loaded = await dependencies.state.read(context, signal);
+            if (!loaded.ok)
+                continue;
+            const scope = toScopeReference(context);
+            const remote = marketplaceUpdateRecords(loaded.snapshot).filter((record) => record.source.kind !== "local-git");
+            const registrationIds = remote.map((record) => deriveMarketplaceRegistrationId({ scope, source: record.source }, dependencies.sha256)).sort(compareUtf8);
+            const schedules = remote.map((record) => record.refresh.schedule);
+            const now = dependencies.clock.nowEpochMilliseconds();
+            const regressed = schedules.some((schedule) => schedule !== undefined && now < schedule.anchorAt);
+            const dueAt = schedules.length === 0 ? undefined : schedules.map((schedule) => schedule?.dueAt ?? 0).sort((a, b) => a - b)[0];
+            plans.push({ context, scope, registrationIds, enabled: cadence !== "paused" && registrationIds.length > 0, ...(dueAt === undefined ? {} : { dueAt }), clock: regressed ? "regressed" : "current" });
+        }
+        return { plans: plans.sort((left, right) => compareUtf8(JSON.stringify(left.scope), JSON.stringify(right.scope))), complete: discovered.complete };
+    }
+    function lease(snapshot) {
+        return "config" in snapshot ? snapshot.config.scope.schedulerLease : snapshot.project.scope.schedulerLease;
+    }
+    function mutation(snapshot, nextLease) {
+        if ("config" in snapshot) {
+            const { schedulerLease: _previousLease, ...scope } = snapshot.config.scope;
+            return parseStateMutation({
+                scope: snapshot.scope,
+                expectedGeneration: snapshot.generation,
+                replace: { config: HostConfigDocumentSchema.parse({ ...snapshot.config, scope: { ...scope, ...(nextLease === undefined ? {} : { schedulerLease: nextLease }) } }) },
+            }, dependencies.sha256);
+        }
+        const { schedulerLease: _previousLease, ...scope } = snapshot.project.scope;
+        return parseStateMutation({
+            scope: snapshot.scope,
+            expectedGeneration: snapshot.generation,
+            replace: { project: ProjectLocalStateDocumentSchema.parse({ ...snapshot.project, scope: { ...scope, ...(nextLease === undefined ? {} : { schedulerLease: nextLease }) } }) },
+        }, dependencies.sha256);
+    }
+    function active(value, now) {
+        return value !== undefined && value.startedAt <= now && value.renewedAt <= now && value.expiresAt > now;
+    }
+    async function replace(scope, ownerInput, now, leaseMs, mode, signal) {
+        const owner = UpdateSchedulerLeaseIdSchema.parse(ownerInput);
+        if (!await projectAuthorized(scope, signal))
+            return "unavailable";
+        for (let attempt = 0; attempt < 4; attempt += 1) {
+            const loaded = await dependencies.state.read(scope, signal);
+            if (!loaded.ok)
+                return "unavailable";
+            const current = lease(loaded.snapshot);
+            if (mode === "acquire" && active(current, now) && current?.id !== owner)
+                return "other";
+            if (mode !== "acquire" && current?.id !== owner)
+                return "other";
+            const nextLease = mode === "release" ? undefined : UpdateSchedulerLeaseSchema.parse({
+                id: owner,
+                startedAt: mode === "renew" && current?.id === owner ? current.startedAt : now,
+                renewedAt: now,
+                expiresAt: now + leaseMs,
+            });
+            const result = await dependencies.mutations.runPreparedMutation({ scope, plugins: [], expectedGeneration: loaded.snapshot.generation }, async ({ snapshot }) => {
+                const authority = lease(snapshot);
+                if (mode === "acquire" && active(authority, now) && authority?.id !== owner)
+                    throw new Error("LEASE_OWNED");
+                if (mode !== "acquire" && authority?.id !== owner)
+                    throw new Error("LEASE_LOST");
+                return {
+                    mutation: mutation(snapshot, nextLease),
+                    value: undefined,
+                    beforeCommit: async () => {
+                        if (!await projectAuthorized(scope, signal))
+                            throw new Error("PROJECT_UNTRUSTED");
+                    },
+                };
+            }, signal).catch((error) => {
+                if (signal.aborted)
+                    throw signal.reason ?? error;
+                return undefined;
+            });
+            if (result?.kind === "committed")
+                return "self";
+        }
+        return "unavailable";
+    }
+    const port = {
+        inventory,
+        acquire(scope, owner, now, leaseMs, signal) { return replace(scope, owner, now, leaseMs, "acquire", signal); },
+        async renew(scope, owner, now, leaseMs, signal) { return await replace(scope, owner, now, leaseMs, "renew", signal) === "self"; },
+        async release(scope, owner, signal) { await replace(scope, owner, dependencies.clock.nowEpochMilliseconds(), 1, "release", signal); },
+        async validate(scope, ownerInput, now, signal) {
+            const owner = UpdateSchedulerLeaseIdSchema.parse(ownerInput);
+            if (!await projectAuthorized(scope, signal))
+                return false;
+            const loaded = await dependencies.state.read(scope, signal);
+            return loaded.ok && lease(loaded.snapshot)?.id === owner && active(lease(loaded.snapshot), now);
+        },
+    };
+    return Object.freeze(port);
+}
+//# sourceMappingURL=update-scheduler-lease-state.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/update-scheduler-lease-state.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/update-scheduler-status.d.ts

@@ -0,0 +1,19 @@
+import type { ScopeReference } from "../domain/state/scope.js";
+export type UpdateSchedulerStatus = Readonly<{
+    state: "disabled" | "standby" | "running" | "clock-regressed" | "degraded" | "stopped";
+    scopes: readonly Readonly<{
+        scope: ScopeReference;
+        ownership: "self" | "other" | "none";
+        nextAt?: number;
+    }>[];
+}>;
+export interface UpdateSchedulerStatusProjection {
+    snapshot(): UpdateSchedulerStatus;
+    status(signal: AbortSignal): Promise<UpdateSchedulerStatus>;
+}
+export interface MutableUpdateSchedulerStatusProjection extends UpdateSchedulerStatusProjection {
+    publish(status: UpdateSchedulerStatus): void;
+    degrade(): void;
+}
+/** One path-free scheduler projection shared by every public observer. */
+export declare function createUpdateSchedulerStatusProjection(initial?: UpdateSchedulerStatus): MutableUpdateSchedulerStatusProjection;

package/node_modules/@nklisch/pi-plugins/dist/application/update-scheduler-status.js

@@ -0,0 +1,28 @@
+function freeze(status) {
+    return Object.freeze({
+        state: status.state,
+        scopes: Object.freeze(status.scopes.map((entry) => Object.freeze({
+            scope: entry.scope,
+            ownership: entry.ownership,
+            ...(entry.nextAt === undefined ? {} : { nextAt: entry.nextAt }),
+        }))),
+    });
+}
+/** One path-free scheduler projection shared by every public observer. */
+export function createUpdateSchedulerStatusProjection(initial = { state: "standby", scopes: [] }) {
+    let current = freeze(initial);
+    return Object.freeze({
+        snapshot: () => current,
+        async status(signal) {
+            signal.throwIfAborted();
+            return current;
+        },
+        publish(status) {
+            current = freeze(status);
+        },
+        degrade() {
+            current = freeze({ state: "degraded", scopes: current.scopes });
+        },
+    });
+}
+//# sourceMappingURL=update-scheduler-status.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/update-scheduler-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-scheduler-status.js","sourceRoot":"","sources":["../../src/application/update-scheduler-status.ts"],"names":[],"mappings":"AAiBA,SAAS,MAAM,CAAC,MAA6B;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;YAC/D,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAChE,CAAC,CAAC,CAAC;KACL,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qCAAqC,CACnD,OAAO,GAA0B,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;IAEjE,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO;QACvB,KAAK,CAAC,MAAM,CAAC,MAAmB;YAC9B,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,MAA6B;YACnC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;YACL,OAAO,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/composition/automatic-update-lifecycle-adapter.d.ts

@@ -0,0 +1,24 @@
+import { type ScopeContext } from "../domain/state/scope.js";
+import type { Sha256 } from "../domain/source.js";
+import type { MarketplaceCatalogService } from "../application/marketplace-catalog-service.js";
+import type { NativeInspectionService } from "../application/native-inspection-contract.js";
+import type { NativeInspectionEvidencePort } from "../application/ports/native-inspection-evidence.js";
+import type { LifecycleStateStore } from "../application/ports/lifecycle-state-store.js";
+import type { ProjectRootAuthorityPort } from "../application/ports/project-root-authority.js";
+import type { ProjectTrustPort } from "../application/ports/project-trust.js";
+import type { PluginLifecycleService } from "../application/plugin-lifecycle-service.js";
+import type { AutomaticUpdateLifecyclePort } from "../application/ports/automatic-update-lifecycle.js";
+export declare function createAutomaticUpdateLifecycleAdapter(dependencies: Readonly<{
+    state: LifecycleStateStore;
+    catalog: Pick<MarketplaceCatalogService, "resolve">;
+    inspection: NativeInspectionService;
+    evidence: NativeInspectionEvidencePort;
+    lifecycle: PluginLifecycleService;
+    projectTrust: ProjectTrustPort;
+    projectRoots: ProjectRootAuthorityPort;
+    currentProject?: Extract<ScopeContext, {
+        kind: "project";
+    }>;
+    userBaseDirectory: string;
+    sha256: Sha256;
+}>): AutomaticUpdateLifecyclePort;

package/node_modules/@nklisch/pi-plugins/dist/composition/automatic-update-lifecycle-adapter.js

@@ -0,0 +1,178 @@
+import { deriveMarketplaceSourceIdentity, derivePluginSourceIdentity } from "../domain/update-policy.js";
+import { MarketplaceCandidateIdSchema, MarketplaceRegistrationIdSchema, MarketplaceSnapshotTokenSchema } from "../domain/marketplace-registration.js";
+import { toScopeReference } from "../domain/state/scope.js";
+import { deriveInspectionDetailId, deriveInspectionEvidenceSnapshotId } from "../application/native-inspection-identifiers.js";
+import { deriveLifecycleTargetDigest } from "../application/native-lifecycle-target.js";
+import { LifecycleTargetExpectationSchema } from "../application/native-lifecycle-operation-contract.js";
+export function createAutomaticUpdateLifecycleAdapter(dependencies) {
+    function context(notice) {
+        return notice.scope.kind === "user" ? { kind: "user" } : dependencies.currentProject?.projectKey === notice.scope.projectKey ? dependencies.currentProject : undefined;
+    }
+    async function target(notice, signal) {
+        const scope = context(notice);
+        if (scope === undefined)
+            return undefined;
+        if (!await projectAuthorized(scope, signal))
+            return { unauthorized: true, scope };
+        const loaded = await dependencies.state.read(scope, signal);
+        if (!loaded.ok)
+            return undefined;
+        const records = "installed" in loaded.snapshot ? loaded.snapshot.installed.plugins : loaded.snapshot.project.plugins;
+        const record = records.find((candidate) => candidate.plugin === notice.plugin);
+        return record === undefined ? undefined : { scope, snapshot: loaded.snapshot, record };
+    }
+    async function resolve(notice, signal) {
+        return dependencies.catalog.resolve({
+            candidateId: MarketplaceCandidateIdSchema.parse(notice.candidateId),
+            snapshot: MarketplaceSnapshotTokenSchema.parse(notice.snapshot),
+        }, signal);
+    }
+    async function projectAuthorized(scope, signal) {
+        if (scope.kind === "user")
+            return true;
+        try {
+            if ((await dependencies.projectTrust.assess(scope.projectKey, signal)).kind !== "trusted")
+                return false;
+            const root = await dependencies.projectRoots.acquire(signal);
+            const current = dependencies.projectRoots.revalidate === undefined
+                ? dependencies.projectRoots.verify(root, scope)
+                : await dependencies.projectRoots.revalidate(root, scope, signal);
+            return current.kind === "project" && current.projectKey === scope.projectKey;
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw signal.reason ?? error;
+            return false;
+        }
+    }
+    const port = {
+        async inspect(notice, signal) {
+            const [resolved, current] = await Promise.all([resolve(notice, signal), target(notice, signal)]);
+            if (resolved.kind !== "resolved")
+                return { candidate: "stale", source: "stable", target: "current", project: "trusted", recovery: "clear", configuration: "valid", secrets: "available", capability: "available" };
+            const candidate = resolved.candidate;
+            if (current !== undefined && "unauthorized" in current) {
+                return { candidate: "current", source: "stable", target: "current", project: "untrusted", recovery: "clear", configuration: "valid", secrets: "available", capability: "available" };
+            }
+            const selected = current?.record.revisions.find((revision) => revision.revision === current.record.selectedRevision);
+            const source = deriveMarketplaceSourceIdentity(candidate.marketplace.source.declared, dependencies.sha256) === notice.available.marketplaceSourceIdentity &&
+                derivePluginSourceIdentity(candidate.entry.source.value, dependencies.sha256) === notice.available.pluginSourceIdentity &&
+                selected?.evidence.source.marketplaceSourceIdentity === notice.available.marketplaceSourceIdentity &&
+                selected.evidence.source.pluginSourceIdentity === notice.available.pluginSourceIdentity ? "stable" : "changed";
+            if (current === undefined || selected === undefined)
+                return { candidate: "current", source, target: "stale", project: "trusted", recovery: "clear", configuration: "valid", secrets: "available", capability: "available" };
+            const project = await projectAuthorized(current.scope, signal) ? "trusted" : "untrusted";
+            const recovery = current.record.pendingTransition === undefined ? "clear" : "required";
+            const detailId = deriveInspectionDetailId({
+                version: 1,
+                subject: "marketplace-candidate",
+                scope: notice.scope,
+                plugin: notice.plugin,
+                registrationId: MarketplaceRegistrationIdSchema.parse(notice.registrationId),
+                candidateId: MarketplaceCandidateIdSchema.parse(notice.candidateId),
+                catalogSnapshot: MarketplaceSnapshotTokenSchema.parse(notice.snapshot),
+            }, dependencies.sha256);
+            let detail;
+            for (let attempt = 0; attempt < 2; attempt += 1) {
+                const evidence = await dependencies.evidence.capture(signal);
+                const snapshotId = deriveInspectionEvidenceSnapshotId(evidence.binding, dependencies.sha256);
+                detail = await dependencies.inspection.detail({ snapshotId, detailId }, signal);
+                if (detail.kind !== "stale")
+                    break;
+            }
+            if (detail?.kind !== "found" || detail.detail.summary.revision.immutable !== notice.available.immutableRevision) {
+                return { candidate: "stale", source, target: "current", project, recovery, configuration: "valid", secrets: "available", capability: "available" };
+            }
+            const configuration = detail.detail.configuration.some((field) => field.required && ["missing", "invalid"].includes(field.state)) ? "required" : "valid";
+            const secrets = detail.detail.configuration.some((field) => field.required && field.sensitive && field.state === "unavailable") ? "unavailable" : "available";
+            const capability = detail.detail.compatibility.status === "incompatible" || detail.detail.compatibility.requirements.some((requirement) => requirement.status === "unavailable") ? "unavailable" : "available";
+            return { candidate: "current", source, target: "current", project, recovery, configuration, secrets, capability };
+        },
+        async apply(notice, signal) {
+            const [resolved, current] = await Promise.all([resolve(notice, signal), target(notice, signal)]);
+            if (resolved.kind !== "resolved" || current === undefined)
+                return { kind: "stale" };
+            if ("unauthorized" in current)
+                return { kind: "rejected", code: "UNTRUSTED" };
+            if (current.record.pendingTransition !== undefined)
+                return { kind: "stale" };
+            const selected = current.record.revisions.find((revision) => revision.revision === current.record.selectedRevision);
+            if (selected === undefined)
+                return { kind: "stale" };
+            const candidate = resolved.candidate;
+            if (deriveMarketplaceSourceIdentity(candidate.marketplace.source.declared, dependencies.sha256) !== notice.available.marketplaceSourceIdentity ||
+                derivePluginSourceIdentity(candidate.entry.source.value, dependencies.sha256) !== notice.available.pluginSourceIdentity ||
+                selected.evidence.source.marketplaceSourceIdentity !== notice.available.marketplaceSourceIdentity ||
+                selected.evidence.source.pluginSourceIdentity !== notice.available.pluginSourceIdentity) {
+                return { kind: "rejected", code: "UNTRUSTED" };
+            }
+            const expectedTarget = LifecycleTargetExpectationSchema.parse({
+                generation: current.snapshot.generation,
+                plugin: current.record.plugin,
+                selectedRevision: current.record.selectedRevision,
+                activation: current.record.activation,
+                targetDigest: deriveLifecycleTargetDigest(toScopeReference(current.scope), current.record, dependencies.sha256),
+                pendingTransition: "none",
+            });
+            const sourceContext = candidate.entry.source.value.kind === "marketplace-path" ? {
+                kind: "marketplace",
+                root: candidate.marketplace.root,
+                source: candidate.marketplace.source,
+                contentRootDigest: candidate.marketplace.content.rootDigest,
+                content: candidate.marketplace.content,
+                binding: candidate.marketplace.binding,
+            } : { kind: "external" };
+            let configurationPathContext;
+            if (current.scope.kind === "project") {
+                if (!await projectAuthorized(current.scope, signal))
+                    return { kind: "rejected", code: "UNTRUSTED" };
+                try {
+                    configurationPathContext = { scope: current.scope, trustedProjectRoot: await dependencies.projectRoots.acquire(signal) };
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        throw signal.reason ?? error;
+                    return { kind: "rejected", code: "UNTRUSTED" };
+                }
+            }
+            else {
+                configurationPathContext = { scope: current.scope, trustedBaseDirectory: dependencies.userBaseDirectory };
+            }
+            if (current.scope.kind === "project") {
+                const root = configurationPathContext.trustedProjectRoot;
+                const revalidated = dependencies.projectRoots.revalidate === undefined
+                    ? dependencies.projectRoots.verify(root, current.scope)
+                    : await dependencies.projectRoots.revalidate(root, current.scope, signal);
+                if (revalidated.kind !== "project" || revalidated.projectKey !== current.scope.projectKey || !await projectAuthorized(current.scope, signal)) {
+                    return { kind: "rejected", code: "UNTRUSTED" };
+                }
+            }
+            const result = await dependencies.lifecycle.update({
+                scope: current.scope,
+                plugin: notice.plugin,
+                origin: "automatic-update",
+                entry: candidate.entry,
+                marketplaceSource: candidate.marketplace.source,
+                sourceContext,
+                expectedRevision: notice.available.immutableRevision,
+                expectedTarget,
+                configurationPathContext,
+            }, signal);
+            switch (result.kind) {
+                case "changed":
+                case "unchanged":
+                case "stale":
+                case "rolled-back":
+                case "recovery-required":
+                    return { kind: result.kind };
+                case "rejected": {
+                    const code = result.code === "INCOMPATIBLE" || result.code === "UNTRUSTED" || result.code === "UNCONFIGURED" || result.code === "AVAILABLE_REVISION_CHANGED" || result.code === "CONFIGURATION_STALE" || result.code === "PROJECTION_FAILED" || result.code === "PROMOTION_FAILED" || result.code === "ABORTED"
+                        ? result.code : "UNTRUSTED";
+                    return { kind: "rejected", code };
+                }
+            }
+        },
+    };
+    return Object.freeze(port);
+}
+//# sourceMappingURL=automatic-update-lifecycle-adapter.js.map

package/node_modules/@nklisch/pi-plugins/dist/composition/automatic-update-lifecycle-adapter.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/composition/background-update-coordinator.d.ts

@@ -0,0 +1,19 @@
+import type { AutomaticUpdateCoordinator } from "../application/automatic-update-coordinator.js";
+import type { MarketplaceUpdateScheduler } from "../application/marketplace-update-scheduler.js";
+import type { UpdateNotificationService } from "../application/update-notification-service.js";
+import type { MutableUpdateSchedulerStatusProjection } from "../application/update-scheduler-status.js";
+import type { MutableHostStatus } from "./host-status-service.js";
+export interface BackgroundUpdateCoordinator {
+    /** Starts the detached owner without awaiting adapters, publishers, or network. */
+    start(): Promise<void>;
+    wake(): void;
+    close(): Promise<void>;
+}
+/** Owns the existing scheduler task; it creates no second timer or job authority. */
+export declare function createBackgroundUpdateCoordinator(dependencies: Readonly<{
+    scheduler: MarketplaceUpdateScheduler;
+    schedulerStatus?: MutableUpdateSchedulerStatusProjection;
+    notifications?: UpdateNotificationService;
+    automatic?: AutomaticUpdateCoordinator;
+    status: MutableHostStatus;
+}>): BackgroundUpdateCoordinator;

package/node_modules/@nklisch/pi-plugins/dist/composition/background-update-coordinator.js

@@ -0,0 +1,74 @@
+/** Owns the existing scheduler task; it creates no second timer or job authority. */
+export function createBackgroundUpdateCoordinator(dependencies) {
+    let controller;
+    let task;
+    let closePromise;
+    async function maintain(signal) {
+        let degraded = false;
+        // Publication follows policy/lifecycle disposition. This order prevents an
+        // initial manual-looking event when effective policy is automatic.
+        if (dependencies.notifications !== undefined) {
+            try {
+                const reconciled = await dependencies.notifications.reconcile(signal);
+                dependencies.status.update({ unreadCount: reconciled.unreadCount, unresolvedCount: reconciled.unresolvedCount });
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw signal.reason ?? error;
+                degraded = true;
+            }
+        }
+        if (dependencies.automatic !== undefined) {
+            try {
+                await dependencies.automatic.run({ limit: 20 }, signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw signal.reason ?? error;
+                degraded = true;
+            }
+        }
+        if (dependencies.notifications !== undefined) {
+            try {
+                await dependencies.notifications.dispatch({}, signal);
+                const page = await dependencies.notifications.list({ scope: "all-current", limit: 1 }, signal);
+                dependencies.status.update({ unreadCount: page.unreadCount, unresolvedCount: page.unresolvedCount });
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw signal.reason ?? error;
+                degraded = true;
+            }
+        }
+        if (degraded)
+            throw new Error("background update maintenance degraded");
+        return dependencies.automatic?.nextRetryAt === undefined ? undefined : dependencies.automatic.nextRetryAt(signal);
+    }
+    return Object.freeze({
+        async start() {
+            if (closePromise !== undefined || task !== undefined)
+                return;
+            controller = new AbortController();
+            const ownedController = controller;
+            // Deliberately do not await this task: local startup is complete before
+            // any notification publisher, marketplace adapter, or timer participates.
+            task = dependencies.scheduler.run(ownedController.signal, maintain).catch((error) => {
+                if (!ownedController.signal.aborted)
+                    dependencies.schedulerStatus?.degrade();
+                void error;
+            });
+        },
+        wake() {
+            if (closePromise === undefined)
+                dependencies.scheduler.wake();
+        },
+        close() {
+            closePromise ??= (async () => {
+                controller?.abort(new Error("background update coordinator closed"));
+                await task?.catch(() => undefined);
+            })();
+            return closePromise;
+        },
+    });
+}
+//# sourceMappingURL=background-update-coordinator.js.map

package/node_modules/@nklisch/pi-plugins/dist/composition/background-update-coordinator.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/composition/candidate-content-lease.d.ts

@@ -0,0 +1,3 @@
+import { type CandidateContentLeaseAdapterDependencies, type CandidateContentLeasePort } from "../application/ports/candidate-content-lease.js";
+/** One allocation, one materialization, and one transfer-or-discard owner. */
+export declare function createCandidateContentLeasePort(dependencies: CandidateContentLeaseAdapterDependencies): CandidateContentLeasePort;

package/node_modules/@nklisch/pi-plugins/dist/composition/candidate-content-lease.js

@@ -0,0 +1,103 @@
+import { CandidateContentCleanupError, } from "../application/ports/candidate-content-lease.js";
+function sourceContext(candidate) {
+    return candidate.entry.source.value.kind === "marketplace-path"
+        ? {
+            kind: "marketplace",
+            root: candidate.marketplace.root,
+            source: candidate.marketplace.source,
+            contentRootDigest: candidate.marketplace.content.rootDigest,
+            content: candidate.marketplace.content,
+            binding: candidate.marketplace.binding,
+        }
+        : { kind: "external" };
+}
+function createCleanupRecovery(discard) {
+    let settled = false;
+    let inFlight;
+    return Object.freeze({
+        async retry() {
+            if (settled)
+                return;
+            if (inFlight !== undefined)
+                return inFlight;
+            inFlight = discard()
+                .then(() => { settled = true; })
+                .finally(() => { inFlight = undefined; });
+            return inFlight;
+        },
+    });
+}
+/** One allocation, one materialization, and one transfer-or-discard owner. */
+export function createCandidateContentLeasePort(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object")
+        throw new TypeError("candidate lease dependencies are required");
+    const port = {
+        async acquire(candidate, signal) {
+            signal.throwIfAborted();
+            const allocation = await dependencies.content.allocateStaging(signal);
+            const cleanup = createCleanupRecovery(() => dependencies.content.discardStaging(allocation, new AbortController().signal));
+            let materialized;
+            try {
+                materialized = await dependencies.materializer.materialize(candidate.entry.source.value, sourceContext(candidate), allocation.slot, signal);
+            }
+            catch (error) {
+                try {
+                    await cleanup.retry();
+                }
+                catch (cleanupError) {
+                    throw new CandidateContentCleanupError(cleanup, {
+                        cause: new AggregateError([error, cleanupError], "candidate acquisition cleanup failed"),
+                    });
+                }
+                throw error;
+            }
+            let state = "owned";
+            let releasePromise;
+            const lease = {
+                candidate,
+                materialized,
+                async claim(claimSignal) {
+                    claimSignal.throwIfAborted();
+                    if (state !== "owned")
+                        throw new Error("candidate content lease is already settled");
+                    state = "claimed";
+                    return Object.freeze({ candidate, materialized, allocation });
+                },
+                release() {
+                    if (state === "claimed" || state === "released")
+                        return releasePromise ?? Promise.resolve();
+                    releasePromise = cleanup.retry()
+                        .then(() => { state = "released"; })
+                        .catch((error) => {
+                        releasePromise = undefined;
+                        throw new CandidateContentCleanupError(cleanup, { cause: error });
+                    });
+                    return releasePromise;
+                },
+            };
+            return Object.freeze(lease);
+        },
+        async withMaterialized(candidate, signal, use) {
+            const lease = await port.acquire(candidate, signal);
+            let value;
+            let failure;
+            try {
+                value = await use(lease.materialized);
+            }
+            catch (error) {
+                failure = error;
+            }
+            try {
+                await lease.release();
+            }
+            catch (cleanupError) {
+                failure = failure === undefined ? cleanupError : new AggregateError([failure, cleanupError], "candidate staging cleanup failed");
+            }
+            if (failure !== undefined)
+                throw failure;
+            return value;
+        },
+    };
+    return Object.freeze(port);
+}
+//# sourceMappingURL=candidate-content-lease.js.map