@nklisch/pi-enhanced 0.2.3 → 0.2.5

package/node_modules/@nklisch/pi-plugins/dist/application/content-index.d.ts

@@ -1,22 +0,0 @@
-import { type ContentManifest, type ContentManifestEntry } from "../domain/content-manifest.js";
-import { type Provenance } from "../domain/provenance.js";
-export type ManifestFileEntry = Extract<ContentManifestEntry, {
-    kind: "file";
-}>;
-export type ManifestDirectoryEntry = Extract<ContentManifestEntry, {
-    kind: "directory";
-}>;
-/** A finite, validated view over the supplied content manifest. */
-export interface ContentIndex {
-    readonly manifest: ContentManifest;
-    get(path: string): ContentManifestEntry | undefined;
-    requireFile(path: string, provenance: Provenance): ManifestFileEntry;
-    requireDirectory(path: string, provenance: Provenance): ManifestDirectoryEntry;
-    filesBelow(directory: string, basename?: string): readonly ManifestFileEntry[];
-}
-/**
- * Validate the manifest once, then answer all discovery questions from its
- * entries. This deliberately has no filesystem dependency and cannot discover
- * a path that was not present in the materialization handoff.
- */
-export declare function createContentIndex(manifest: ContentManifest): ContentIndex;

package/node_modules/@nklisch/pi-plugins/dist/application/content-index.js

@@ -1,87 +0,0 @@
-import { ContentManifestSchema, normalizeContentPath, } from "../domain/content-manifest.js";
-import { DomainContractError } from "../domain/domain-error.js";
-import { ErrorCodeRegistry } from "../domain/error-contract.js";
-import { ProvenanceSchema } from "../domain/provenance.js";
-function normalizeQuery(path) {
-    try {
-        // Foreign manifests spell explicit paths as `./foo`, while the verified
-        // content manifest stores canonical `foo`. Normalize that one safe prefix
-        // without admitting dot segments, traversal, or platform separators.
-        const declaredPath = path.startsWith("./") ? path.slice(2) : path;
-        return normalizeContentPath(declaredPath);
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizeDirectoryQuery(path) {
-    if (path === "")
-        return "";
-    return normalizeQuery(path);
-}
-function invalidTarget(operation, path, expected, provenance, actual) {
-    const location = ProvenanceSchema.parse(provenance).location;
-    const actualDetail = actual === undefined ? {} : { actual };
-    return new DomainContractError({
-        code: ErrorCodeRegistry.pathContainmentFailed,
-        operation,
-        message: actual === undefined
-            ? `explicit ${expected} target is not present in the content manifest: ${path}`
-            : `explicit ${expected} target has manifest kind ${actual}: ${path}`,
-        location,
-        details: { path, expected, ...actualDetail },
-    });
-}
-/**
- * Validate the manifest once, then answer all discovery questions from its
- * entries. This deliberately has no filesystem dependency and cannot discover
- * a path that was not present in the materialization handoff.
- */
-export function createContentIndex(manifest) {
-    const validated = ContentManifestSchema.parse(manifest);
-    const entries = new Map();
-    for (const entry of validated.entries) {
-        // ContentManifestSchema already enforces canonical paths and collisions.
-        entries.set(entry.path, entry);
-    }
-    const index = {
-        manifest: validated,
-        get(path) {
-            const normalized = normalizeQuery(path);
-            return normalized === undefined ? undefined : entries.get(normalized);
-        },
-        requireFile(path, provenance) {
-            const normalized = normalizeQuery(path);
-            const entry = normalized === undefined ? undefined : entries.get(normalized);
-            if (entry?.kind !== "file") {
-                throw invalidTarget("contentIndex.requireFile", path, "file", provenance, entry?.kind);
-            }
-            return entry;
-        },
-        requireDirectory(path, provenance) {
-            const normalized = normalizeQuery(path);
-            const entry = normalized === undefined ? undefined : entries.get(normalized);
-            if (entry?.kind !== "directory") {
-                throw invalidTarget("contentIndex.requireDirectory", path, "directory", provenance, entry?.kind);
-            }
-            return entry;
-        },
-        filesBelow(directory, basename) {
-            const normalizedDirectory = normalizeDirectoryQuery(directory);
-            if (normalizedDirectory === undefined)
-                return [];
-            const prefix = normalizedDirectory === "" ? "" : `${normalizedDirectory}/`;
-            return validated.entries.filter((entry) => {
-                if (entry.kind !== "file")
-                    return false;
-                if (prefix !== "" && !entry.path.startsWith(prefix))
-                    return false;
-                if (basename === undefined)
-                    return true;
-                return entry.path.slice(prefix.length).split("/").at(-1) === basename;
-            });
-        },
-    };
-    return Object.freeze(index);
-}
-//# sourceMappingURL=content-index.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/content-index.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/content-promotion.d.ts

@@ -1,24 +0,0 @@
-import { type Sha256 } from "../domain/source.js";
-import type { MaterializedMarketplace, MaterializedPlugin } from "./source-materialization.js";
-import type { StagingAllocation, VerifiedPromotionPlan } from "./ports/content-store.js";
-import { type InstalledRevisionDescriptor } from "./installed-revision-descriptor.js";
-export type PromotionPlanInput = Readonly<{
-    kind: "marketplace" | "plugin";
-    allocation: StagingAllocation;
-    /** The completed materializer handoff. `handoff` is accepted as an alias for adapters. */
-    materialized?: MaterializedMarketplace | MaterializedPlugin;
-    handoff?: MaterializedMarketplace | MaterializedPlugin;
-    /** Exact restart reconstruction evidence; only plugin plans may carry it. */
-    descriptor?: InstalledRevisionDescriptor;
-}>;
-/**
- * The only application factory for a promotion plan. Filesystem adapters must
- * still prove allocation ownership; this private membership mark merely keeps
- * structural plan objects from crossing the application boundary.
- */
-export declare function createPromotionPlan(input: PromotionPlanInput, sha256: Sha256): VerifiedPromotionPlan;
-/** Internal runtime guard used by physical adapters before mutation. */
-export declare function isVerifiedPromotionPlan(value: unknown): value is VerifiedPromotionPlan;
-/** Revalidate the plan's canonical evidence without touching the filesystem. */
-export declare function assertVerifiedPromotionPlan(value: unknown, sha256: Sha256): VerifiedPromotionPlan;
-export type { VerifiedPromotionPlan, StagingAllocation };

package/node_modules/@nklisch/pi-plugins/dist/application/content-promotion.js

@@ -1,131 +0,0 @@
-import { createMarketplaceStoreIdentity, createPluginStoreIdentity, ContentStoreIdentitySchema, } from "../domain/content-store.js";
-import { ContentDigestSchema, verifyContentManifest, } from "../domain/content-manifest.js";
-import { DomainContractError, ErrorCodeRegistry } from "../domain/errors.js";
-import { verifyResolvedMarketplaceSource, verifyResolvedPluginSource, } from "../domain/source.js";
-import { InstalledRevisionDescriptorSchemaV1, } from "./installed-revision-descriptor.js";
-const verifiedPlans = new WeakSet();
-function invalidPlan(message, cause) {
-    return new DomainContractError({
-        code: ErrorCodeRegistry.contentVerificationFailed,
-        operation: "createPromotionPlan",
-        message,
-        details: { operation: "createPromotionPlan" },
-        ...(cause === undefined ? {} : { cause }),
-    });
-}
-function checkedAllocation(input) {
-    if (input === null || typeof input !== "object")
-        throw invalidPlan("staging allocation is invalid");
-    const value = input;
-    if (value.slot === null ||
-        typeof value.slot !== "object" ||
-        typeof value.slot.root !== "string" ||
-        value.slot.root.length === 0 ||
-        typeof value.allocationId !== "string" ||
-        value.allocationId.length === 0) {
-        throw invalidPlan("staging allocation is invalid");
-    }
-    return input;
-}
-function materializedValue(input) {
-    const value = input.materialized ?? input.handoff;
-    if (value === undefined || value === null || typeof value !== "object") {
-        throw invalidPlan("materialization handoff is missing");
-    }
-    return value;
-}
-function checkedMaterialized(kind, value, sha256) {
-    if (typeof value.root !== "string" || value.root.length === 0) {
-        throw invalidPlan("materialization handoff root is invalid");
-    }
-    ContentDigestSchema.parse(value.binding);
-    const manifest = verifyContentManifest(value.content, sha256);
-    if (kind === "marketplace") {
-        const source = verifyResolvedMarketplaceSource(value.source, sha256);
-        const identity = createMarketplaceStoreIdentity(source, manifest, value.binding, sha256);
-        return { root: value.root, source, manifest, binding: value.binding, identity };
-    }
-    const source = verifyResolvedPluginSource(value.source, sha256);
-    const identity = createPluginStoreIdentity(source, manifest, value.binding, sha256);
-    return { root: value.root, source, manifest, binding: value.binding, identity };
-}
-/**
- * The only application factory for a promotion plan. Filesystem adapters must
- * still prove allocation ownership; this private membership mark merely keeps
- * structural plan objects from crossing the application boundary.
- */
-export function createPromotionPlan(input, sha256) {
-    if (input === null || typeof input !== "object")
-        throw invalidPlan("promotion plan input is invalid");
-    if (input.kind !== "marketplace" && input.kind !== "plugin")
-        throw invalidPlan("promotion store kind is invalid");
-    const allocation = checkedAllocation(input.allocation);
-    const materialized = checkedMaterialized(input.kind, materializedValue(input), sha256);
-    if (input.kind === "marketplace" && input.descriptor !== undefined) {
-        throw invalidPlan("marketplace promotion cannot carry an installed plugin descriptor");
-    }
-    let descriptor;
-    if (input.descriptor !== undefined) {
-        descriptor = InstalledRevisionDescriptorSchemaV1.parse(input.descriptor);
-        if (descriptor.loaded.binding !== materialized.binding ||
-            descriptor.loaded.content.rootDigest !== materialized.manifest.rootDigest ||
-            descriptor.loaded.plugin.source.hash !== materialized.source.hash) {
-            throw invalidPlan("installed plugin descriptor does not match materialized promotion evidence");
-        }
-    }
-    const plan = Object.freeze({
-        kind: input.kind,
-        allocation,
-        root: materialized.root,
-        source: materialized.source,
-        manifest: materialized.manifest,
-        binding: materialized.binding,
-        identity: materialized.identity,
-        ...(descriptor === undefined ? {} : { descriptor }),
-    });
-    verifiedPlans.add(plan);
-    return plan;
-}
-/** Internal runtime guard used by physical adapters before mutation. */
-export function isVerifiedPromotionPlan(value) {
-    return typeof value === "object" && value !== null && verifiedPlans.has(value);
-}
-/** Revalidate the plan's canonical evidence without touching the filesystem. */
-export function assertVerifiedPromotionPlan(value, sha256) {
-    if (!isVerifiedPromotionPlan(value)) {
-        throw new DomainContractError({
-            code: ErrorCodeRegistry.contentVerificationFailed,
-            operation: "promoteContent",
-            message: "promotion plan is not an application-issued capability",
-            details: { operation: "promoteContent" },
-        });
-    }
-    const expected = checkedMaterialized(value.kind, {
-        root: value.root,
-        source: value.source,
-        content: value.manifest,
-        binding: value.binding,
-    }, sha256);
-    const parsedIdentity = ContentStoreIdentitySchema.parse(value.identity);
-    if (JSON.stringify(parsedIdentity) !== JSON.stringify(expected.identity)) {
-        throw new DomainContractError({
-            code: ErrorCodeRegistry.contentVerificationFailed,
-            operation: "promoteContent",
-            message: "promotion plan identity is not bound to its source evidence",
-            details: { operation: "promoteContent" },
-        });
-    }
-    if (value.kind === "marketplace" && value.descriptor !== undefined) {
-        throw invalidPlan("marketplace promotion cannot carry an installed plugin descriptor");
-    }
-    if (value.descriptor !== undefined) {
-        const descriptor = InstalledRevisionDescriptorSchemaV1.parse(value.descriptor);
-        if (descriptor.loaded.binding !== value.binding ||
-            descriptor.loaded.content.rootDigest !== value.manifest.rootDigest ||
-            descriptor.loaded.plugin.source.hash !== value.source.hash) {
-            throw invalidPlan("installed plugin descriptor does not match promotion evidence");
-        }
-    }
-    return value;
-}
-//# sourceMappingURL=content-promotion.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/content-promotion.js.map

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

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

@@ -1,98 +0,0 @@
-import { z } from "zod";
-import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
-import type { LifecycleStateInventoryPort } from "./ports/lifecycle-state-inventory.js";
-import type { PersistentDataRemovalPort } from "./ports/persistent-data-removal.js";
-import type { LifecycleClock } from "./ports/lifecycle-clock.js";
-import { type PendingDeleteMarkerStore } from "./ports/pending-data-deletion.js";
-import type { ScopeContext } from "../domain/state/scope.js";
-import type { Sha256 } from "../domain/source.js";
-import type { ArtifactGc } from "./ports/artifact-gc.js";
-export declare const ConvergenceDiagnosticCodeSchema: z.ZodEnum<{
-    BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
-    INVENTORY_UNAVAILABLE: "INVENTORY_UNAVAILABLE";
-    MARKER_REPLAY_FAILED: "MARKER_REPLAY_FAILED";
-    MARKER_RETAINED: "MARKER_RETAINED";
-    MARKER_SCOPE_UNAVAILABLE: "MARKER_SCOPE_UNAVAILABLE";
-    ORPHAN_RETAINED: "ORPHAN_RETAINED";
-    PRUNE_FAILED: "PRUNE_FAILED";
-    STATE_CORRUPT: "STATE_CORRUPT";
-}>;
-export type ConvergenceDiagnosticCode = z.infer<typeof ConvergenceDiagnosticCodeSchema>;
-export declare const ConvergenceResultSchema: z.ZodReadonly<z.ZodObject<{
-    kind: z.ZodEnum<{
-        blocked: "blocked";
-        completed: "completed";
-        deferred: "deferred";
-    }>;
-    scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-        kind: z.ZodLiteral<"user">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"project">;
-        projectKey: z.ZodString;
-    }, z.core.$strict>]>>;
-    plugin: z.ZodOptional<z.ZodString>;
-    code: z.ZodEnum<{
-        BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
-        INVENTORY_UNAVAILABLE: "INVENTORY_UNAVAILABLE";
-        MARKER_REPLAY_FAILED: "MARKER_REPLAY_FAILED";
-        MARKER_RETAINED: "MARKER_RETAINED";
-        MARKER_SCOPE_UNAVAILABLE: "MARKER_SCOPE_UNAVAILABLE";
-        ORPHAN_RETAINED: "ORPHAN_RETAINED";
-        PRUNE_FAILED: "PRUNE_FAILED";
-        STATE_CORRUPT: "STATE_CORRUPT";
-    }>;
-}, z.core.$strict>>;
-export type ConvergenceResult = z.infer<typeof ConvergenceResultSchema>;
-export declare const ConvergenceReportSchema: z.ZodReadonly<z.ZodObject<{
-    results: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        kind: z.ZodEnum<{
-            blocked: "blocked";
-            completed: "completed";
-            deferred: "deferred";
-        }>;
-        scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-            kind: z.ZodLiteral<"user">;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"project">;
-            projectKey: z.ZodString;
-        }, z.core.$strict>]>>;
-        plugin: z.ZodOptional<z.ZodString>;
-        code: z.ZodEnum<{
-            BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
-            INVENTORY_UNAVAILABLE: "INVENTORY_UNAVAILABLE";
-            MARKER_REPLAY_FAILED: "MARKER_REPLAY_FAILED";
-            MARKER_RETAINED: "MARKER_RETAINED";
-            MARKER_SCOPE_UNAVAILABLE: "MARKER_SCOPE_UNAVAILABLE";
-            ORPHAN_RETAINED: "ORPHAN_RETAINED";
-            PRUNE_FAILED: "PRUNE_FAILED";
-            STATE_CORRUPT: "STATE_CORRUPT";
-        }>;
-    }, z.core.$strict>>>>;
-    deferred: z.ZodBoolean;
-    processed: z.ZodNumber;
-}, z.core.$strict>>;
-export type ConvergenceReport = z.infer<typeof ConvergenceReportSchema>;
-export declare const DefaultConvergencePolicy: Readonly<{
-    requiredBudgetMs: 2000;
-    maxItems: 128;
-    stagingGraceMs: number;
-    orphanGraceMs: number;
-}>;
-export type ConvergenceService = Readonly<{
-    sweep(request: Readonly<{
-        scopes: readonly ScopeContext[];
-        signal?: AbortSignal;
-    }>): Promise<ConvergenceReport>;
-}>;
-export type ConvergenceServiceDependencies = Readonly<{
-    state: LifecycleStateStore;
-    inventory: LifecycleStateInventoryPort;
-    dataRemoval?: PersistentDataRemovalPort;
-    pendingDeletes: PendingDeleteMarkerStore;
-    sha256: Sha256;
-    clock?: LifecycleClock;
-    policy?: Partial<typeof DefaultConvergencePolicy>;
-    artifacts?: ArtifactGc;
-    projectionReferences?: () => ReadonlySet<string> | undefined;
-}>;
-export declare function createConvergenceService(dependencies: ConvergenceServiceDependencies): ConvergenceService;

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

@@ -1,270 +0,0 @@
-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