@nklisch/pi-enhanced 0.1.0

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

@@ -0,0 +1,126 @@
+import { z } from "zod";
+import { PluginKeySchema } from "../domain/identity.js";
+import { PendingTransitionRefSchema } from "../domain/state/references.js";
+import { ScopeReferenceSchema } from "../domain/state/scope.js";
+import { GenerationSchema } from "../domain/state/config-state.js";
+import { InstalledPluginRecordSchema } from "../domain/state/installed-state.js";
+import { ActivationObservationSchema } from "./ports/lifecycle-reload.js";
+import { LifecycleTransitionRecordSchemaV1, } from "./ports/lifecycle-transition-store.js";
+import { ProjectionExpectationSchema } from "./ports/runtime-projection.js";
+export const RecoveryDiagnosticCodeSchema = z.enum([
+    "OWNER_LIVE",
+    "OWNER_UNKNOWN",
+    "BUDGET_EXHAUSTED",
+    "STATE_STALE",
+    "JOURNAL_MISSING",
+    "JOURNAL_CORRUPT",
+    "STATE_CORRUPT",
+    "RECOVERY_CONFLICT",
+    "PREVIOUS_UNAVAILABLE",
+    "CLEANUP_FAILED",
+]);
+export const RecoveryPolicySchema = z.object({
+    requiredBudgetMs: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+    maxTransitions: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    abandonedGraceMs: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+}).strict().readonly();
+export const DefaultLifecycleRecoveryPolicy = Object.freeze({
+    requiredBudgetMs: 2_000,
+    maxTransitions: 128,
+    abandonedGraceMs: 86_400_000,
+});
+export const TransitionRecoveryResultSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("finalized"), scope: ScopeReferenceSchema, plugin: PluginKeySchema, reference: PendingTransitionRefSchema, generation: GenerationSchema }).strict().readonly(),
+    z.object({ kind: z.literal("rolled-back"), scope: ScopeReferenceSchema, plugin: PluginKeySchema, reference: PendingTransitionRefSchema, generation: GenerationSchema }).strict().readonly(),
+    z.object({ kind: z.literal("abandoned"), scope: ScopeReferenceSchema, plugin: PluginKeySchema, reference: PendingTransitionRefSchema }).strict().readonly(),
+    z.object({ kind: z.literal("cleanup-completed"), scope: ScopeReferenceSchema, plugin: PluginKeySchema, reference: PendingTransitionRefSchema }).strict().readonly(),
+    z.object({
+        kind: z.literal("deferred"),
+        scope: ScopeReferenceSchema,
+        plugin: PluginKeySchema.optional(),
+        reference: PendingTransitionRefSchema.optional(),
+        code: z.enum(["OWNER_LIVE", "OWNER_UNKNOWN", "BUDGET_EXHAUSTED", "STATE_STALE"]),
+    }).strict().readonly(),
+    z.object({
+        kind: z.literal("blocked"),
+        scope: ScopeReferenceSchema,
+        plugin: PluginKeySchema.optional(),
+        reference: PendingTransitionRefSchema.optional(),
+        code: z.enum(["JOURNAL_MISSING", "JOURNAL_CORRUPT", "STATE_CORRUPT", "RECOVERY_CONFLICT", "PREVIOUS_UNAVAILABLE", "CLEANUP_FAILED"]),
+    }).strict().readonly(),
+]);
+export const LifecycleRecoveryResultSchema = z.object({
+    results: z.array(TransitionRecoveryResultSchema).readonly(),
+    deferred: z.boolean(),
+    processed: z.number().int().nonnegative(),
+}).strict().readonly();
+export const RecoveryEvidenceKindSchema = z.enum(["candidate-pending", "previous-pending", "final", "conflict", "missing"]);
+export const RecoveryEvidenceSchema = z.object({
+    kind: RecoveryEvidenceKindSchema,
+    scope: ScopeReferenceSchema,
+    plugin: PluginKeySchema,
+    reference: PendingTransitionRefSchema,
+    current: InstalledPluginRecordSchema.nullable(),
+    observation: ActivationObservationSchema.optional(),
+}).strict().readonly();
+export const RecoveryClassificationSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("finalize"), projection: ProjectionExpectationSchema }).strict().readonly(),
+    z.object({ kind: z.literal("compensate"), projection: ProjectionExpectationSchema }).strict().readonly(),
+    z.object({ kind: z.literal("conflict"), code: z.literal("RECOVERY_CONFLICT") }).strict().readonly(),
+    z.object({ kind: z.literal("blocked"), code: z.literal("PREVIOUS_UNAVAILABLE") }).strict().readonly(),
+]);
+function sameJson(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (left === null || right === null || typeof left !== "object" || typeof right !== "object")
+        return false;
+    if (Array.isArray(left) || Array.isArray(right))
+        return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((value, index) => sameJson(value, right[index]));
+    const leftRecord = left;
+    const rightRecord = right;
+    const keys = Object.keys(leftRecord);
+    return keys.length === Object.keys(rightRecord).length && keys.every((key) => Object.prototype.hasOwnProperty.call(rightRecord, key) && sameJson(leftRecord[key], rightRecord[key]));
+}
+export function stateWithoutPending(record) {
+    const { pendingTransition: _pending, ...value } = record;
+    return InstalledPluginRecordSchema.parse(value);
+}
+export function projectionMatchesObservation(observation, expectation, plugin) {
+    if (expectation.kind === "inactive") {
+        return observation.kind === "inactive" &&
+            sameJson(observation.scope, expectation.scope) &&
+            observation.plugin === plugin &&
+            observation.projectionDigest === expectation.digest;
+    }
+    return observation.kind === "active" &&
+        sameJson(observation.scope, expectation.projection.scope) &&
+        observation.plugin === plugin &&
+        observation.revision === expectation.projection.revision &&
+        observation.projectionDigest === expectation.projection.digest;
+}
+/** Classify only exact evidence; a reload return value is intentionally absent. */
+export function classifyInterruptedTransition(input) {
+    const record = LifecycleTransitionRecordSchemaV1.parse(input.record);
+    const current = input.current === null ? null : InstalledPluginRecordSchema.parse(input.current);
+    if (current !== null && current.plugin !== record.plugin)
+        return { kind: "conflict", code: "RECOVERY_CONFLICT" };
+    const pending = current?.pendingTransition;
+    const currentWithoutPending = current === null ? null : stateWithoutPending(current);
+    const isCandidate = currentWithoutPending !== null && sameJson(currentWithoutPending, record.candidate);
+    const isPrevious = record.previous !== null && currentWithoutPending !== null && sameJson(currentWithoutPending, record.previous);
+    if (pending === record.reference && isCandidate) {
+        if (input.observation !== undefined && projectionMatchesObservation(input.observation, record.candidateProjection, record.plugin))
+            return { kind: "finalize", projection: record.candidateProjection };
+        return record.previous === null ? { kind: "blocked", code: "PREVIOUS_UNAVAILABLE" } : { kind: "compensate", projection: record.previousProjection };
+    }
+    if (pending === record.reference && isPrevious)
+        return { kind: "compensate", projection: record.previousProjection };
+    const finalMatches = record.final === null ? current === null : currentWithoutPending !== null && sameJson(currentWithoutPending, record.final);
+    if (pending === undefined && finalMatches)
+        return { kind: "finalize", projection: record.candidateProjection };
+    return { kind: "conflict", code: "RECOVERY_CONFLICT" };
+}
+export function safeRecoveryResult(input) {
+    return TransitionRecoveryResultSchema.parse(input);
+}
+//# sourceMappingURL=recovery-contract.js.map

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

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

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

@@ -0,0 +1,39 @@
+import "zod";
+import { type ScopeContext, type ScopeReference } from "../domain/state/scope.js";
+import { type PendingTransitionRef } from "../domain/state/references.js";
+import { type LifecycleTransitionStore } from "./ports/lifecycle-transition-store.js";
+import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
+import type { LifecycleClock } from "./ports/lifecycle-clock.js";
+import type { LifecycleStateInventoryPort } from "./ports/lifecycle-state-inventory.js";
+import type { RecoveryArtifactsPort } from "./ports/recovery-artifacts.js";
+import type { LifecycleTransitionReconciler } from "./lifecycle-transition-reconciler.js";
+import { TransitionRecoveryResultSchema, type LifecycleRecoveryResult, type RecoveryPolicy } from "./recovery-contract.js";
+import type { LifecycleReloadPort } from "./ports/lifecycle-reload.js";
+import type { NativeUninstallCleanupService } from "./native-uninstall-cleanup.js";
+export type LifecycleRecoveryServiceDependencies = Readonly<{
+    state: LifecycleStateStore;
+    inventory?: LifecycleStateInventoryPort;
+    transitions: (scope: ScopeReference) => LifecycleTransitionStore;
+    reconciler: LifecycleTransitionReconciler;
+    reload: LifecycleReloadPort;
+    artifacts?: RecoveryArtifactsPort;
+    uninstallCleanup?: NativeUninstallCleanupService;
+    clock?: LifecycleClock;
+}>;
+export type LifecycleRecoveryServiceRequest = Readonly<{
+    requiredScopes: readonly ScopeContext[];
+    /**
+     * A live reload successor owns these exact transitions. Startup recovery
+     * must not race that handoff even if predecessor journal ownership has
+     * already been released during extension disposal.
+     */
+    reservedTransitions?: readonly PendingTransitionRef[];
+    policy?: Partial<RecoveryPolicy>;
+}>;
+export interface LifecycleRecoveryService {
+    recover(request: LifecycleRecoveryServiceRequest, signal: AbortSignal): Promise<LifecycleRecoveryResult>;
+}
+/** Startup reconciliation is deliberately local and bounded; collection is separate best-effort work. */
+export declare function createLifecycleRecoveryService(dependencies: LifecycleRecoveryServiceDependencies): LifecycleRecoveryService;
+export { TransitionRecoveryResultSchema };
+export type { LifecycleRecoveryResult, ScopeContext, ScopeReference };

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

@@ -0,0 +1,170 @@
+import "zod";
+import { ScopeContextSchema, toScopeReference } from "../domain/state/scope.js";
+import { PluginKeySchema } from "../domain/identity.js";
+import { PendingTransitionRefSchema } from "../domain/state/references.js";
+import {} from "./ports/lifecycle-transition-store.js";
+import { DefaultLifecycleRecoveryPolicy, LifecycleRecoveryResultSchema, RecoveryPolicySchema, TransitionRecoveryResultSchema } from "./recovery-contract.js";
+function sortScopes(scopes) { return [...scopes].sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right))); }
+function sortResult(left, right) {
+    return JSON.stringify([left.scope, left.plugin ?? "", left.reference ?? "", left.kind]).localeCompare(JSON.stringify([right.scope, right.plugin ?? "", right.reference ?? "", right.kind]));
+}
+/** Startup reconciliation is deliberately local and bounded; collection is separate best-effort work. */
+export function createLifecycleRecoveryService(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object")
+        throw new TypeError("recovery service dependencies are required");
+    const clock = dependencies.clock ?? {
+        nowEpochMilliseconds: () => Date.now(),
+        monotonicMilliseconds: () => globalThis.performance?.now() ?? Date.now(),
+    };
+    async function recover(request, signal) {
+        const policy = RecoveryPolicySchema.parse({ ...DefaultLifecycleRecoveryPolicy, ...(request.policy ?? {}) });
+        const started = clock.monotonicMilliseconds();
+        const deadline = started + policy.requiredBudgetMs;
+        let processed = 0;
+        let deferred = false;
+        const results = [];
+        const reservedTransitions = new Set((request.reservedTransitions ?? []).map((reference) => PendingTransitionRefSchema.parse(reference)));
+        let scopes = sortScopes(request.requiredScopes.map((scope) => ScopeContextSchema.parse(scope)));
+        if (scopes.length === 0 && dependencies.inventory !== undefined) {
+            const inventory = await dependencies.inventory.discover(signal);
+            scopes = sortScopes(inventory.scopes);
+            if (!inventory.complete)
+                deferred = true;
+        }
+        for (const scope of scopes) {
+            if (signal.aborted)
+                throw signal.reason;
+            if (clock.monotonicMilliseconds() >= deadline || processed >= policy.maxTransitions) {
+                deferred = true;
+                results.push({ kind: "deferred", scope: toScopeReference(scope), code: "BUDGET_EXHAUSTED" });
+                continue;
+            }
+            const scopeReference = toScopeReference(scope);
+            const loaded = await dependencies.state.read(scope, signal);
+            if (!loaded.ok) {
+                deferred = true;
+                results.push({ kind: "blocked", scope: scopeReference, code: "STATE_CORRUPT" });
+                continue;
+            }
+            const journal = dependencies.transitions(scopeReference);
+            const collection = journal.list === undefined ? undefined : await journal.list(scopeReference, signal).catch(() => undefined);
+            if (collection === undefined || !collection.complete) {
+                deferred = true;
+                results.push({ kind: "blocked", scope: scopeReference, code: "JOURNAL_CORRUPT" });
+                continue;
+            }
+            const byReference = new Map(collection.entries.map((entry) => [entry.record.reference, entry]));
+            const pending = ("installed" in loaded.snapshot ? loaded.snapshot.installed.plugins : loaded.snapshot.project.plugins)
+                .filter((record) => record.pendingTransition !== undefined)
+                .sort((left, right) => left.plugin.localeCompare(right.plugin));
+            for (const pluginRecord of pending) {
+                const reference = PendingTransitionRefSchema.parse(pluginRecord.pendingTransition);
+                if (reservedTransitions.has(reference))
+                    continue;
+                if (processed >= policy.maxTransitions || clock.monotonicMilliseconds() >= deadline) {
+                    deferred = true;
+                    results.push({ kind: "deferred", scope: scopeReference, plugin: pluginRecord.plugin, reference, code: "BUDGET_EXHAUSTED" });
+                    continue;
+                }
+                processed += 1;
+                const entry = byReference.get(reference);
+                if (entry === undefined) {
+                    deferred = true;
+                    results.push({ kind: "blocked", scope: scopeReference, plugin: pluginRecord.plugin, reference, code: "JOURNAL_MISSING" });
+                    continue;
+                }
+                if (entry.status.kind === "quarantined") {
+                    deferred = true;
+                    results.push({ kind: "blocked", scope: scopeReference, plugin: pluginRecord.plugin, reference, code: "JOURNAL_CORRUPT" });
+                    continue;
+                }
+                const owner = journal.ownerStatus === undefined ? "released" : await journal.ownerStatus(scopeReference, reference, signal).catch(() => "unknown");
+                if (owner === "live" || owner === "unknown") {
+                    deferred = true;
+                    results.push({ kind: "deferred", scope: scopeReference, plugin: pluginRecord.plugin, reference, code: owner === "live" ? "OWNER_LIVE" : "OWNER_UNKNOWN" });
+                    continue;
+                }
+                let observation;
+                if (entry.record.candidateProjection.kind === "active" && pluginRecord.activation === "enabled") {
+                    observation = await dependencies.reload.observe({ scope: scopeReference, plugin: pluginRecord.plugin }, signal).catch(() => undefined);
+                }
+                const reconciled = await dependencies.reconciler.recoverInterruptedTransition({
+                    scope,
+                    plugin: PluginKeySchema.parse(pluginRecord.plugin),
+                    record: entry.record,
+                    current: pluginRecord,
+                    ...(observation === undefined ? {} : { observation }),
+                }, signal);
+                if (reconciled.kind === "completed")
+                    results.push({ kind: "finalized", scope: scopeReference, plugin: pluginRecord.plugin, reference, generation: reconciled.snapshot.generation });
+                else if (reconciled.kind === "rolled-back")
+                    results.push({ kind: "rolled-back", scope: scopeReference, plugin: pluginRecord.plugin, reference, generation: reconciled.snapshot.generation });
+                else {
+                    deferred = true;
+                    results.push({ kind: "blocked", scope: scopeReference, plugin: pluginRecord.plugin, reference, code: "RECOVERY_CONFLICT" });
+                    await journal.markRecoveryRequired?.({ scope: scopeReference, reference, ...(reconciled.committed === undefined ? {} : { generation: reconciled.committed }), at: clock.nowEpochMilliseconds() }, signal).catch(() => undefined);
+                }
+            }
+            // Terminal uninstall deletion is durable journal work, independent of
+            // the now-absent installed record. Failure never blocks another plugin.
+            if (dependencies.uninstallCleanup !== undefined) {
+                for (const entry of collection.entries.filter((candidate) => candidate.status.kind === "completed" && (candidate.cleanup === "pending-data-delete" || candidate.cleanup === "recovery-required")).sort((left, right) => left.record.reference.localeCompare(right.record.reference))) {
+                    if (processed >= policy.maxTransitions || clock.monotonicMilliseconds() >= deadline) {
+                        deferred = true;
+                        results.push({ kind: "deferred", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference, code: "BUDGET_EXHAUSTED" });
+                        continue;
+                    }
+                    processed += 1;
+                    const cleanup = await dependencies.uninstallCleanup.recover(entry, signal);
+                    if (cleanup.kind === "deleted")
+                        results.push({ kind: "cleanup-completed", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference });
+                    else if (cleanup.kind === "recovery-required") {
+                        deferred = true;
+                        results.push({ kind: "blocked", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference, code: "CLEANUP_FAILED" });
+                    }
+                }
+            }
+            // Unreferenced prepared rows are inert. They are abandoned only after
+            // owner death and a durable wall-clock grace, never by lease expiry.
+            for (const entry of collection.entries.filter((candidate) => candidate.status.kind === "prepared").sort((left, right) => left.record.reference.localeCompare(right.record.reference))) {
+                if (pending.some((record) => record.pendingTransition === entry.record.reference))
+                    continue;
+                if (processed >= policy.maxTransitions || clock.monotonicMilliseconds() >= deadline) {
+                    deferred = true;
+                    results.push({ kind: "deferred", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference, code: "BUDGET_EXHAUSTED" });
+                    continue;
+                }
+                processed += 1;
+                const owner = journal.ownerStatus === undefined ? "released" : await journal.ownerStatus(scopeReference, entry.record.reference, signal).catch(() => "unknown");
+                if (owner === "live" || owner === "unknown") {
+                    deferred = true;
+                    results.push({ kind: "deferred", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference, code: owner === "live" ? "OWNER_LIVE" : "OWNER_UNKNOWN" });
+                    continue;
+                }
+                if (entry.preparedAt + policy.abandonedGraceMs > clock.nowEpochMilliseconds())
+                    continue;
+                await journal.settle({ reference: entry.record.reference, outcome: "abandoned", at: clock.nowEpochMilliseconds() }, signal).catch(() => undefined);
+                results.push({ kind: "abandoned", scope: scopeReference, plugin: entry.record.plugin, reference: entry.record.reference });
+            }
+        }
+        if (!deferred && dependencies.artifacts !== undefined && clock.monotonicMilliseconds() < deadline) {
+            const scan = await dependencies.artifacts.scan(signal).catch(() => ({ complete: false, candidates: [] }));
+            if (!scan.complete)
+                deferred = true;
+            else
+                for (const candidate of [...scan.candidates].sort((left, right) => left.kind.localeCompare(right.kind) || left.key.localeCompare(right.key))) {
+                    if (candidate.owner !== "dead" || candidate.createdAt + policy.abandonedGraceMs > clock.nowEpochMilliseconds())
+                        continue;
+                    if (clock.monotonicMilliseconds() >= deadline) {
+                        deferred = true;
+                        break;
+                    }
+                    await dependencies.artifacts.remove(candidate, signal).catch(() => undefined);
+                }
+        }
+        return LifecycleRecoveryResultSchema.parse({ results: results.sort(sortResult), deferred, processed });
+    }
+    return Object.freeze({ recover });
+}
+export { TransitionRecoveryResultSchema };
+//# sourceMappingURL=recovery-service.js.map

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

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

package/node_modules/@nklisch/pi-plugins/dist/application/resolved-configuration.d.ts

@@ -0,0 +1,18 @@
+import type { ConfiguredValue } from "../domain/configured-values.js";
+export interface ResolvedConfiguration {
+    has(key: string): boolean;
+    substitute(template: string): string;
+    environment(prefix?: "CLAUDE_PLUGIN_OPTION_"): Readonly<Record<string, string>>;
+    /** Replace every resolved value without exposing the backing values. */
+    redact(text: string): string;
+    dispose(): void;
+    toString(): "[REDACTED]";
+    toJSON(): "[REDACTED]";
+}
+type ResolvedEntry = Readonly<{
+    key: string;
+    value: ConfiguredValue;
+}>;
+/** Create the callback-scoped facade without exposing its backing map. */
+export declare function createResolvedConfiguration(entries: readonly ResolvedEntry[]): ResolvedConfiguration;
+export {};

package/node_modules/@nklisch/pi-plugins/dist/application/resolved-configuration.js

@@ -0,0 +1,74 @@
+function serialize(value) {
+    switch (value.kind) {
+        case "string":
+        case "directory":
+        case "file": return value.value;
+        case "number": return String(value.value);
+        case "boolean": return value.value ? "true" : "false";
+        case "strings": return JSON.stringify(value.value);
+        default: return assertNever(value);
+    }
+}
+/** Create the callback-scoped facade without exposing its backing map. */
+export function createResolvedConfiguration(entries) {
+    const values = new Map(entries.map((entry) => [entry.key, entry.value]));
+    let disposed = false;
+    const assertLive = () => {
+        if (disposed)
+            throw new Error("resolved configuration is disposed");
+    };
+    const get = (key) => {
+        assertLive();
+        const entry = values.get(key);
+        if (entry === undefined)
+            throw new Error("configuration key is unavailable");
+        return serialize(entry);
+    };
+    const redactionValues = () => [...new Set([...values.values()].map(serialize).filter((value) => value.length > 0))]
+        .sort((left, right) => right.length - left.length);
+    return {
+        has(key) {
+            assertLive();
+            return values.has(key);
+        },
+        substitute(template) {
+            assertLive();
+            if (typeof template !== "string")
+                throw new TypeError("configuration template must be a string");
+            return template.replace(/\$\{user_config\.([A-Za-z_][A-Za-z0-9_]*)\}/g, (_match, key) => get(key));
+        },
+        environment(prefix = "CLAUDE_PLUGIN_OPTION_") {
+            assertLive();
+            const result = Object.create(null);
+            for (const key of [...values.keys()].sort()) {
+                Object.defineProperty(result, `${prefix}${key}`, {
+                    value: get(key),
+                    enumerable: true,
+                    configurable: false,
+                    writable: false,
+                });
+            }
+            return Object.freeze(result);
+        },
+        redact(text) {
+            assertLive();
+            if (typeof text !== "string")
+                throw new TypeError("redaction input must be a string");
+            return redactionValues().reduce((result, value) => result.replaceAll(value, "[REDACTED]"), text);
+        },
+        dispose() {
+            disposed = true;
+            values.clear();
+        },
+        toString() {
+            return "[REDACTED]";
+        },
+        toJSON() {
+            return "[REDACTED]";
+        },
+    };
+}
+function assertNever(value) {
+    throw new Error(`unhandled resolved configuration value: ${String(value)}`);
+}
+//# sourceMappingURL=resolved-configuration.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/resolved-configuration.js.map

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

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

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { type ContentStoreKey } from "../domain/content-store.js";
+import { type ScopeContext, type ScopeReference } from "../domain/state/scope.js";
+import type { GenerationMutationCoordinator } from "./generation-mutation-coordinator.js";
+import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
+import type { LifecycleStateInventoryPort } from "./ports/lifecycle-state-inventory.js";
+import type { LifecycleTransitionStore } from "./ports/lifecycle-transition-store.js";
+import type { LifecycleClock } from "./ports/lifecycle-clock.js";
+import type { RevisionArtifactStore, RetainedArtifactRef } from "./ports/revision-artifact-store.js";
+import type { RevisionLeaseStore } from "./ports/revision-lease-store.js";
+import type { RevisionRetentionStore } from "./ports/revision-retention-store.js";
+import "./recovery-contract.js";
+import type { Sha256 } from "../domain/source.js";
+export declare const DefaultRevisionCollectionPolicy: Readonly<{
+    unreferencedGraceMs: 86400000;
+    terminalJournalRetentionMs: 604800000;
+    maxArtifactsPerRun: 256;
+}>;
+export declare const RevisionCollectionPolicySchema: z.ZodReadonly<z.ZodObject<{
+    unreferencedGraceMs: z.ZodNumber;
+    terminalJournalRetentionMs: z.ZodNumber;
+    maxArtifactsPerRun: z.ZodNumber;
+}, z.core.$strict>>;
+export type RevisionCollectionPolicy = z.infer<typeof RevisionCollectionPolicySchema>;
+export declare const RevisionCollectionResultSchema: z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodEnum<{
+        collected: "collected";
+        deferred: "deferred";
+    }>;
+    removedArtifacts: z.ZodNumber;
+    prunedRevisions: z.ZodNumber;
+    code: z.ZodOptional<z.ZodLiteral<"COLLECTION_DEFERRED">>;
+}, z.core.$strict>>;
+export type RevisionCollectionResult = z.infer<typeof RevisionCollectionResultSchema>;
+export type RevisionCollectionDependencies = Readonly<{
+    state: LifecycleStateStore;
+    inventory: LifecycleStateInventoryPort;
+    transitions: (scope: ScopeReference) => LifecycleTransitionStore;
+    leases: RevisionLeaseStore;
+    artifacts: RevisionArtifactStore;
+    retention: RevisionRetentionStore;
+    mutations: GenerationMutationCoordinator;
+    sha256: Sha256;
+    clock?: LifecycleClock;
+}>;
+/** Closed-world mark/sweep. Physical deletion is deliberately the last action. */
+export declare function createRevisionCollectionService(dependencies: RevisionCollectionDependencies): Readonly<{
+    collect: (input: Readonly<{
+        policy?: Partial<RevisionCollectionPolicy>;
+    }>, signal: AbortSignal) => Promise<RevisionCollectionResult>;
+}>;
+export type { RetainedArtifactRef, ScopeContext, ScopeReference, ContentStoreKey };