@nklisch/pi-enhanced 0.1.11 → 0.2.0

package/node_modules/@nklisch/pi-plugins/dist/application/convergence-service.js

@@ -0,0 +1,270 @@
+import { z } from "zod";
+import { runScopedMutation } from "./state-transaction.js";
+import { PENDING_DELETE_GRACE_MS } from "./ports/pending-data-deletion.js";
+import { createInstalledUserStateDocument } from "../domain/state/installed-state.js";
+import { createProjectLocalStateDocument } from "../domain/state/project-state.js";
+import { parseStateMutation } from "./state-contract.js";
+import { contentStoreKeyDigest, createPluginStoreIdentityFromEvidence, createMarketplaceStoreIdentityFromEvidence } from "../domain/content-store.js";
+export const ConvergenceDiagnosticCodeSchema = z.enum([
+    "MARKER_REPLAY_FAILED",
+    "MARKER_RETAINED",
+    "MARKER_SCOPE_UNAVAILABLE",
+    "INVENTORY_UNAVAILABLE",
+    "STATE_CORRUPT",
+    "BUDGET_EXHAUSTED",
+    "ORPHAN_RETAINED",
+    "PRUNE_FAILED",
+]);
+export const ConvergenceResultSchema = z.object({
+    kind: z.enum(["completed", "deferred", "blocked"]),
+    scope: z.union([z.object({ kind: z.literal("user") }).strict(), z.object({ kind: z.literal("project"), projectKey: z.string() }).strict()]).optional(),
+    plugin: z.string().optional(),
+    code: ConvergenceDiagnosticCodeSchema,
+}).strict().readonly();
+export const ConvergenceReportSchema = z.object({ results: z.array(ConvergenceResultSchema).readonly(), deferred: z.boolean(), processed: z.number().int().nonnegative() }).strict().readonly();
+export const DefaultConvergencePolicy = Object.freeze({ requiredBudgetMs: 2_000, maxItems: 128, stagingGraceMs: 7 * 86_400_000, orphanGraceMs: 7 * 86_400_000 });
+function records(snapshot) { return "installed" in snapshot ? snapshot.installed.plugins : snapshot.project.plugins; }
+function replaceRecords(snapshot, next, sha256) {
+    if ("installed" in snapshot) {
+        const installed = createInstalledUserStateDocument({ ...snapshot.installed, generation: snapshot.generation, plugins: next }, sha256);
+        return parseStateMutation({ scope: snapshot.scope, expectedGeneration: snapshot.generation, replace: { installed } }, sha256);
+    }
+    const project = createProjectLocalStateDocument({ ...snapshot.project, generation: snapshot.generation, plugins: next }, snapshot.scope, sha256);
+    return parseStateMutation({ scope: snapshot.scope, expectedGeneration: snapshot.generation, replace: { project } }, sha256);
+}
+function scopeRef(scope) { return scope.kind === "user" ? { kind: "user" } : { kind: "project", projectKey: scope.projectKey }; }
+function sameScope(left, right) {
+    return left.kind === right.kind && (left.kind === "user" || (right.kind === "project" && left.projectKey === right.projectKey));
+}
+function contextForMarker(marker, inventory) {
+    return inventory?.scopes.find((candidate) => sameScope(scopeRef(candidate), marker.scope));
+}
+function prunedRecords(snapshot) {
+    const current = records(snapshot);
+    const next = current.map((record) => {
+        const keep = new Set([record.selectedRevision, ...(record.previousRevision === undefined ? [] : [record.previousRevision])]);
+        const revisions = record.revisions.filter((revision) => keep.has(revision.revision));
+        return revisions.length === record.revisions.length ? record : { ...record, revisions };
+    });
+    return { records: next, changed: next.some((record, index) => JSON.stringify(record) !== JSON.stringify(current[index])) };
+}
+async function replayMarkers(input) {
+    const now = input.now ?? Date.now();
+    const results = [];
+    const record = (entry) => { results.push(entry); input.onProcessed?.(); };
+    for (const marker of await input.markers.list(input.signal)) {
+        if (input.shouldStop())
+            return { entries: results, exhausted: true };
+        input.signal.throwIfAborted();
+        const evidence = await input.scopeEvidence(marker);
+        if (evidence === "unavailable") {
+            record({ marker, outcome: "retained-scope" });
+            continue;
+        }
+        if (evidence === "installed") {
+            if (now - marker.requestedAt < PENDING_DELETE_GRACE_MS) {
+                record({ marker, outcome: "retained-age" });
+                continue;
+            }
+            try {
+                await input.markers.remove(marker);
+                record({ marker, outcome: "discarded-installed" });
+            }
+            catch {
+                record({ marker, outcome: "retained-failure" });
+            }
+            continue;
+        }
+        try {
+            await input.data.remove({ scope: marker.scope, plugin: marker.plugin, dataRef: marker.dataRef, confirmation: "delete-confirmed", capability: {} }, input.signal);
+            await input.markers.remove(marker);
+            record({ marker, outcome: "deleted" });
+        }
+        catch {
+            record({ marker, outcome: "retained-failure" });
+        }
+    }
+    return { entries: results, exhausted: false };
+}
+export function createConvergenceService(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object" || typeof dependencies.state?.read !== "function" || typeof dependencies.state?.commit !== "function" || typeof dependencies.inventory?.discover !== "function" || typeof dependencies.sha256 !== "function")
+        throw new TypeError("convergence dependencies are required");
+    const policy = { ...DefaultConvergencePolicy, ...(dependencies.policy ?? {}) };
+    async function sweep(request) {
+        const signal = request.signal ?? new AbortController().signal;
+        signal.throwIfAborted();
+        const monotonicNow = () => dependencies.clock?.monotonicMilliseconds() ?? Date.now();
+        const started = monotonicNow();
+        const now = dependencies.clock?.nowEpochMilliseconds() ?? Date.now();
+        let processed = 0;
+        let deferred = false;
+        const results = [];
+        const shouldStop = () => processed >= policy.maxItems || monotonicNow() - started >= policy.requiredBudgetMs;
+        let inventory;
+        try {
+            inventory = await dependencies.inventory.discover(signal);
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error;
+            deferred = true;
+            results.push({ kind: "deferred", code: "INVENTORY_UNAVAILABLE" });
+        }
+        const discoveredScopes = inventory?.scopes ?? request.scopes;
+        if (dependencies.dataRemoval !== undefined) {
+            let replayed = 0;
+            try {
+                const markerResults = await replayMarkers({
+                    markers: dependencies.pendingDeletes,
+                    scopeEvidence: async (marker) => {
+                        const context = contextForMarker(marker, inventory);
+                        if (context === undefined)
+                            return "unavailable";
+                        try {
+                            const loaded = await dependencies.state.read(context, signal);
+                            if (!loaded.ok || (loaded.snapshot.corruptions?.length ?? 0) > 0)
+                                return "unavailable";
+                            return records(loaded.snapshot).some((record) => record.plugin === marker.plugin) ? "installed" : "absent";
+                        }
+                        catch (error) {
+                            if (signal.aborted)
+                                throw error;
+                            return "unavailable";
+                        }
+                    },
+                    data: dependencies.dataRemoval,
+                    signal,
+                    now,
+                    shouldStop: () => processed + replayed >= policy.maxItems || monotonicNow() - started >= policy.requiredBudgetMs,
+                    onProcessed: () => { replayed += 1; },
+                });
+                for (const entry of markerResults.entries) {
+                    processed += 1;
+                    if (entry.outcome === "retained-age") {
+                        deferred = true;
+                        results.push({ kind: "deferred", scope: entry.marker.scope, plugin: entry.marker.plugin, code: "MARKER_RETAINED" });
+                    }
+                    else if (entry.outcome === "retained-scope") {
+                        deferred = true;
+                        results.push({ kind: "deferred", scope: entry.marker.scope, plugin: entry.marker.plugin, code: "MARKER_SCOPE_UNAVAILABLE" });
+                    }
+                    else if (entry.outcome === "retained-failure") {
+                        deferred = true;
+                        results.push({ kind: "deferred", scope: entry.marker.scope, plugin: entry.marker.plugin, code: "MARKER_REPLAY_FAILED" });
+                    }
+                }
+                if (markerResults.exhausted) {
+                    deferred = true;
+                    results.push({ kind: "deferred", code: "BUDGET_EXHAUSTED" });
+                }
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw error;
+                deferred = true;
+                results.push({ kind: "deferred", code: "MARKER_REPLAY_FAILED" });
+            }
+        }
+        for (const scope of request.scopes) {
+            signal.throwIfAborted();
+            if (shouldStop()) {
+                deferred = true;
+                results.push({ kind: "deferred", scope: scopeRef(scope), code: "BUDGET_EXHAUSTED" });
+                break;
+            }
+            try {
+                const mutation = await runScopedMutation(dependencies.state, scope, (snapshot) => {
+                    const pruned = prunedRecords(snapshot);
+                    if (!pruned.changed)
+                        return { kind: "no-op", value: undefined };
+                    return { kind: "commit", mutation: replaceRecords(snapshot, pruned.records, dependencies.sha256), value: undefined };
+                }, signal);
+                if (mutation.kind !== "committed" && mutation.kind !== "no-op") {
+                    deferred = true;
+                    results.push({ kind: "deferred", scope: scopeRef(scope), code: "PRUNE_FAILED" });
+                }
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw error;
+                deferred = true;
+                results.push({ kind: "deferred", scope: scopeRef(scope), code: "PRUNE_FAILED" });
+            }
+            processed += 1;
+        }
+        if (dependencies.artifacts !== undefined && !shouldStop()) {
+            const referenced = new Set();
+            let referenceEvidenceComplete = inventory !== undefined && inventory.complete;
+            for (const scope of discoveredScopes) {
+                try {
+                    const loaded = await dependencies.state.read(scope, signal);
+                    if (!loaded.ok) {
+                        referenceEvidenceComplete = false;
+                        continue;
+                    }
+                    if ((loaded.snapshot.corruptions?.length ?? 0) > 0)
+                        referenceEvidenceComplete = false;
+                    for (const record of records(loaded.snapshot)) {
+                        for (const revision of record.revisions) {
+                            const identity = createPluginStoreIdentityFromEvidence({ sourceHash: revision.evidence.source.sourceHash, binding: revision.revision }, dependencies.sha256);
+                            referenced.add(`revision:${contentStoreKeyDigest(identity)}`);
+                        }
+                    }
+                    const marketplaces = "installed" in loaded.snapshot ? loaded.snapshot.installed.marketplaces : loaded.snapshot.project.marketplaces;
+                    for (const marketplace of marketplaces) {
+                        const identity = createMarketplaceStoreIdentityFromEvidence({ sourceHash: marketplace.source.sourceHash, revision: marketplace.source.revision, binding: marketplace.binding }, dependencies.sha256);
+                        referenced.add(`marketplace:${contentStoreKeyDigest(identity)}`);
+                    }
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        throw error;
+                    referenceEvidenceComplete = false;
+                }
+            }
+            const retainKinds = new Set();
+            if (!referenceEvidenceComplete) {
+                // Missing a scope or an unreadable scope can hide a live reference in
+                // each state-backed category. Staging remains independently safe to
+                // collect because it is protected by its own grace period.
+                retainKinds.add("revision");
+                retainKinds.add("marketplace");
+                retainKinds.add("projection");
+                deferred = true;
+                results.push({ kind: "deferred", code: "ORPHAN_RETAINED" });
+            }
+            let projectionReferences;
+            try {
+                projectionReferences = dependencies.projectionReferences?.();
+            }
+            catch {
+                projectionReferences = undefined;
+                deferred = true;
+                results.push({ kind: "deferred", code: "ORPHAN_RETAINED" });
+            }
+            if (projectionReferences === undefined)
+                retainKinds.add("projection");
+            else
+                for (const key of projectionReferences)
+                    referenced.add(`projection:${key}`);
+            try {
+                const gc = await dependencies.artifacts.sweep({ referenced, ...(retainKinds.size === 0 ? {} : { retainKinds: [...retainKinds] }), signal });
+                if (gc.deferred || gc.incompleteEvidence)
+                    deferred = true;
+                if (gc.incompleteEvidence && referenceEvidenceComplete)
+                    results.push({ kind: "deferred", code: "ORPHAN_RETAINED" });
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw error;
+                deferred = true;
+                results.push({ kind: "deferred", code: "ORPHAN_RETAINED" });
+            }
+        }
+        if (shouldStop())
+            deferred = true;
+        return ConvergenceReportSchema.parse({ results, deferred, processed });
+    }
+    return Object.freeze({ sweep });
+}
+//# sourceMappingURL=convergence-service.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/convergence-service.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/exact-trust-grant-service.d.ts

@@ -1,11 +1,10 @@
 import { type ScopeContext } from "../domain/state/scope.js";
 import { type TrustCandidate } from "../domain/trust-policy.js";
-import type { GenerationMutationCoordinator } from "./generation-mutation-coordinator.js";
 import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
 import type { ProjectRootAuthorityPort, TrustedProjectRoot } from "./ports/project-root-authority.js";
 import { type ProjectTrustPort } from "./ports/project-trust.js";
 import type { Sha256 } from "../domain/source.js";
-import type { Generation } from "../domain/state/config-state.js";
+import { type Generation } from "../domain/state/config-state.js";
 import type { TrustSubjectRef } from "../domain/state/references.js";
 export type ExactTrustGrantResult = Readonly<{
     kind: "recorded" | "already-recorded";
@@ -20,9 +19,8 @@ export type ExactTrustGrantResult = Readonly<{
     recorded?: true;
     generation?: Generation;
 }> | Readonly<{
-    kind: "recovery-required";
+    kind: "unavailable";
     subject: TrustSubjectRef;
-    committed?: Generation;
 }>;
 export interface ExactTrustGrantService {
     grant(request: Readonly<{
@@ -33,7 +31,7 @@ export interface ExactTrustGrantService {
 }
 export type ExactTrustGrantDependencies = Readonly<{
     state: LifecycleStateStore;
-    mutations: GenerationMutationCoordinator;
+    mutations: LifecycleStateStore;
     projectTrust: ProjectTrustPort;
     projectRoots: ProjectRootAuthorityPort;
     sha256: Sha256;

package/node_modules/@nklisch/pi-plugins/dist/application/exact-trust-grant-service.js

@@ -4,8 +4,9 @@ import { createTrustStateDocument } from "../domain/state/trust-state.js";
 import { createScopeContext, toScopeReference } from "../domain/state/scope.js";
 import { grantTrust, verifyTrustCandidate } from "../domain/trust-policy.js";
 import { parseStateMutation } from "./state-contract.js";
-import { CommittedMutationCleanupError } from "./generation-mutation-coordinator.js";
+import { runScopedMutation } from "./state-transaction.js";
 import { ProjectTrustAssessmentSchema } from "./ports/project-trust.js";
+import { GenerationSchema } from "../domain/state/config-state.js";
 class AlreadyRecorded extends Error {
     generation;
     constructor(generation) {
@@ -61,7 +62,7 @@ export function createExactTrustGrantService(dependencies) {
                     return { kind: "project-stale" };
             }
             catch {
-                return { kind: "recovery-required", subject: request.candidate.subject };
+                return { kind: "unavailable", subject: request.candidate.subject };
             }
             const status = await projectStatus(candidate, scope, request.projectRoot, dependencies, signal);
             if (status !== "trusted")
@@ -73,39 +74,40 @@ export function createExactTrustGrantService(dependencies) {
             catch (error) {
                 if (signal.aborted)
                     throw signal.reason ?? error;
-                return { kind: "recovery-required", subject: candidate.subject };
+                return { kind: "unavailable", subject: candidate.subject };
             }
             if (!loaded.ok || !("trust" in loaded.snapshot))
-                return { kind: "recovery-required", subject: candidate.subject };
+                return { kind: "unavailable", subject: candidate.subject };
             if (exactGranted(loaded.snapshot.trust.records, candidate)) {
                 return { kind: "already-recorded", subject: candidate.subject, generation: loaded.snapshot.generation };
             }
             const expected = loaded.snapshot.generation;
             try {
-                const result = await dependencies.mutations.runPreparedMutation({ scope: { kind: "user" }, plugins: [candidate.evidence.plugin], expectedGeneration: expected }, async (context) => {
-                    if (!("trust" in context.snapshot))
+                const result = await runScopedMutation(dependencies.mutations, { kind: "user" }, (snapshot) => {
+                    if (!("trust" in snapshot))
                         throw new Error("trust authority is not user state");
-                    if (exactGranted(context.snapshot.trust.records, candidate))
-                        throw new AlreadyRecorded(context.snapshot.generation);
+                    if (exactGranted(snapshot.trust.records, candidate))
+                        throw new AlreadyRecorded(snapshot.generation);
                     const record = grantTrust(candidate, dependencies.sha256);
                     const records = [
-                        ...context.snapshot.trust.records.filter((entry) => entry.subject !== candidate.subject),
+                        ...snapshot.trust.records.filter((entry) => entry.subject !== candidate.subject),
                         record,
                     ].sort((left, right) => compareUtf8(left.subject, right.subject));
                     const trust = createTrustStateDocument({
                         schemaVersion: 1,
-                        generation: context.snapshot.generation,
+                        generation: snapshot.generation,
                         records,
                     }, dependencies.sha256);
                     return {
+                        kind: "commit",
                         mutation: parseStateMutation({
                             scope: { kind: "user" },
-                            expectedGeneration: context.snapshot.generation,
+                            expectedGeneration: snapshot.generation,
                             replace: { trust },
                         }, dependencies.sha256),
                         value: candidate.subject,
                         ...(scope.kind === "project" ? {
-                            beforeCommit: async () => {
+                            recheckAuthority: async () => {
                                 const current = await projectStatus(candidate, scope, request.projectRoot, dependencies, signal);
                                 if (current !== "trusted")
                                     throw Object.assign(new Error(current), { code: current });
@@ -119,17 +121,13 @@ export function createExactTrustGrantService(dependencies) {
                         return { kind: finalStatus, recorded: true, generation: result.snapshot.generation };
                     return { kind: "recorded", subject: candidate.subject, generation: result.snapshot.generation };
                 }
-                if (result.kind === "stale-generation" || result.kind === "commit-failed") {
-                    return { kind: "stale", expected: result.expected, actual: result.actual };
-                }
-                return { kind: "recovery-required", subject: candidate.subject, ...(result.actual === undefined ? {} : { committed: result.actual }) };
+                if (result.kind === "stale")
+                    return { kind: "stale", expected, actual: GenerationSchema.parse(result.actual ?? expected) };
+                return { kind: "unavailable", subject: candidate.subject };
             }
             catch (error) {
                 if (error instanceof AlreadyRecorded)
                     return { kind: "already-recorded", subject: candidate.subject, generation: error.generation };
-                if (error instanceof CommittedMutationCleanupError) {
-                    return { kind: "recovery-required", subject: candidate.subject, committed: error.committed.snapshot.generation };
-                }
                 if (signal.aborted)
                     throw signal.reason ?? error;
                 if (error !== null && typeof error === "object" && "code" in error) {
@@ -137,7 +135,7 @@ export function createExactTrustGrantService(dependencies) {
                     if (code === "project-untrusted" || code === "project-stale")
                         return { kind: code };
                 }
-                return { kind: "recovery-required", subject: candidate.subject };
+                return { kind: "unavailable", subject: candidate.subject };
             }
         },
     };

package/node_modules/@nklisch/pi-plugins/dist/application/exact-trust-grant-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"exact-trust-grant-service.js","sourceRoot":"","sources":["../../src/application/exact-trust-grant-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exact-trust-grant-service.js","sourceRoot":"","sources":["../../src/application/exact-trust-grant-service.ts"],"names":[],"mappings":"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"}

package/node_modules/@nklisch/pi-plugins/dist/application/hook-visibility-service.d.ts

@@ -1,6 +1,5 @@
 import { type HookContextVisibility } from "../domain/hook-visibility.js";
 import type { Sha256 } from "../domain/source.js";
-import type { GenerationMutationCoordinator } from "./generation-mutation-coordinator.js";
 import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
 import { type NativeHookVisibilityRequest, type NativeHookVisibilityResult } from "./hook-visibility-contract.js";
 export interface HookVisibilityService {
@@ -11,7 +10,7 @@ export interface HookVisibilityService {
 }
 export type HookVisibilityServiceDependencies = Readonly<{
     state: LifecycleStateStore;
-    mutations: GenerationMutationCoordinator;
+    mutations: LifecycleStateStore;
     sha256: Sha256;
 }>;
 /**

package/node_modules/@nklisch/pi-plugins/dist/application/hook-visibility-service.js

@@ -1,5 +1,6 @@
 import { HostConfigDocumentSchema } from "../domain/state/config-state.js";
 import { DefaultHookContextVisibility, HookContextVisibilitySchema } from "../domain/hook-visibility.js";
+import { runScopedMutation } from "./state-transaction.js";
 import { parseStateMutation } from "./state-contract.js";
 import { NativeHookVisibilityRequestSchema, NativeHookVisibilityResultSchema, } from "./hook-visibility-contract.js";
 /**
@@ -35,7 +36,7 @@ export function createHookVisibilityService(dependencies) {
             return NativeHookVisibilityResultSchema.parse({ kind: "rejected", code: "STATE_UNAVAILABLE" });
         }
         const before = loaded.snapshot.config.hooks.contextVisibility;
-        const result = await dependencies.mutations.runPreparedMutation({ scope: { kind: "user" }, plugins: [], expectedGeneration: loaded.snapshot.generation }, async ({ snapshot }) => {
+        const result = await runScopedMutation(dependencies.mutations, { kind: "user" }, (snapshot) => {
             if (!("config" in snapshot))
                 throw new Error("hook visibility requires user scope");
             // Same replace pattern as the host precedence service: rebuild the
@@ -47,6 +48,7 @@ export function createHookVisibilityService(dependencies) {
                 hooks: { contextVisibility: visibility },
             });
             return {
+                kind: "commit",
                 mutation: parseStateMutation({
                     scope: snapshot.scope,
                     expectedGeneration: snapshot.generation,

package/node_modules/@nklisch/pi-plugins/dist/application/hook-visibility-service.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/host-observation-contract.d.ts

@@ -41,6 +41,14 @@ export declare const HostCapabilitiesSchema: z.ZodReadonly<z.ZodObject<{
 export type HostCapabilities = z.infer<typeof HostCapabilitiesSchema>;
 export declare const HostBlockedPluginSchema: z.ZodReadonly<z.ZodObject<{
     plugin: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "PluginKey", "out">, z.ZodString]>;
+    scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"project">;
+        projectKey: z.core.$ZodBranded<z.ZodString, "ProjectKey", "out">;
+    }, z.core.$strict>>], "kind">>;
+    selectedRevision: z.ZodOptional<z.ZodString>;
+    runningRevision: z.ZodOptional<z.ZodString>;
     code: z.ZodString;
     explanation: z.ZodString;
 }, z.core.$strict>>;
@@ -59,6 +67,14 @@ export declare const HostStartupResultSchema: z.ZodReadonly<z.ZodObject<{
     }>;
     blocked: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
         plugin: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "PluginKey", "out">, z.ZodString]>;
+        scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"user">;
+        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            projectKey: z.core.$ZodBranded<z.ZodString, "ProjectKey", "out">;
+        }, z.core.$strict>>], "kind">>;
+        selectedRevision: z.ZodOptional<z.ZodString>;
+        runningRevision: z.ZodOptional<z.ZodString>;
         code: z.ZodString;
         explanation: z.ZodString;
     }, z.core.$strict>>>>;
@@ -101,7 +117,7 @@ export declare const HostStatusSnapshotSchema: z.ZodReadonly<z.ZodObject<{
         ready: "ready";
     }>;
     local: z.ZodReadonly<z.ZodObject<{
-        recovery: z.ZodEnum<{
+        convergence: z.ZodEnum<{
             blocked: "blocked";
             degraded: "degraded";
             settled: "settled";
@@ -140,6 +156,14 @@ export declare const HostStatusSnapshotSchema: z.ZodReadonly<z.ZodObject<{
     }, z.core.$strict>>;
     blocked: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
         plugin: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "PluginKey", "out">, z.ZodString]>;
+        scope: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"user">;
+        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            projectKey: z.core.$ZodBranded<z.ZodString, "ProjectKey", "out">;
+        }, z.core.$strict>>], "kind">>;
+        selectedRevision: z.ZodOptional<z.ZodString>;
+        runningRevision: z.ZodOptional<z.ZodString>;
         code: z.ZodString;
         explanation: z.ZodString;
     }, z.core.$strict>>>>;

package/node_modules/@nklisch/pi-plugins/dist/application/host-observation-contract.js

@@ -14,6 +14,10 @@ export const HostCapabilitiesSchema = z.object({
 }).strict().readonly();
 export const HostBlockedPluginSchema = z.object({
     plugin: z.union([PluginKeySchema, z.string().min(1)]),
+    /** Scope/revision evidence is present for plugin-local degradation. */
+    scope: ScopeReferenceSchema.optional(),
+    selectedRevision: z.string().regex(/^sha256:[0-9a-f]{64}$/).optional(),
+    runningRevision: z.string().regex(/^sha256:[0-9a-f]{64}$/).optional(),
     code: z.string().min(1),
     explanation: z.string().min(1),
 }).strict().readonly();
@@ -26,7 +30,7 @@ export const HostStartupResultSchema = z.object({
 export const HostStatusSnapshotSchema = z.object({
     status: HostReadinessStatusSchema,
     local: z.object({
-        recovery: z.enum(["settled", "degraded", "blocked"]),
+        convergence: z.enum(["settled", "degraded", "blocked"]),
         runtime: z.enum(["reconciled", "degraded", "blocked"]),
     }).strict().readonly(),
     update: z.object({

package/node_modules/@nklisch/pi-plugins/dist/application/host-observation-contract.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/host-precedence-service.d.ts

@@ -1,6 +1,5 @@
 import { type HostPrecedence } from "../domain/host-precedence.js";
 import type { Sha256 } from "../domain/source.js";
-import type { GenerationMutationCoordinator } from "./generation-mutation-coordinator.js";
 import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
 import { type NativeHostPrecedenceRequest, type NativeHostPrecedenceResult } from "./host-precedence-contract.js";
 export interface HostPrecedenceService {
@@ -16,7 +15,7 @@ export interface HostPrecedenceService {
 }
 export type HostPrecedenceServiceDependencies = Readonly<{
     state: LifecycleStateStore;
-    mutations: GenerationMutationCoordinator;
+    mutations: LifecycleStateStore;
     sha256: Sha256;
 }>;
 /**