@superbee/core 0.2.0-pre.4 → 0.2.0-pre.41

package/dist/recipe-lifecycle/legacy-aliases.d.ts

@@ -0,0 +1,16 @@
+import type { Bundle, ConceptId, OkfDocument } from "../types.js";
+/**
+ * The retired legacy kind name, frozen as a historical fact. Internal to the recipe lifecycle and
+ * not part of its public API; the CLI's diagnostics keep their own frozen copy, and
+ * `legacy-constants-tripwire.test.ts` pins the two equal.
+ */
+export declare const RETIRED_PAGE_TYPE_NAME = "Page";
+/** Core's one accepted kind name (`View`). */
+export declare const VIEW_KIND_NAME: "View";
+export declare function legacyRegistryAlias(id: ConceptId): ConceptId | null;
+export declare function legacyEntryAlias(key: string): string | null;
+export declare function governsKind(doc: OkfDocument, kindName: string): boolean;
+/** The id of an existing convention doc governing the LEGACY kind name, or null. Called at most
+ * once per apply, and only when the recipe carries a convention governing the current name. */
+export declare function findLegacyViewConvention(bundle: Bundle): Promise<ConceptId | null>;
+//# sourceMappingURL=legacy-aliases.d.ts.map

package/dist/recipe-lifecycle/legacy-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-aliases.d.ts","sourceRoot":"","sources":["../../src/recipe-lifecycle/legacy-aliases.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAE7C,8CAA8C;AAC9C,eAAO,MAAO,cAAc,QAAmB,CAAC;AAEhD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAInE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED;+FAC+F;AAC/F,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAMxF"}

package/dist/recipe-lifecycle/legacy-aliases.js

@@ -0,0 +1,51 @@
+// ── Legacy-alias awareness (plans/rename-page-kind-to-view, Option C+) ────────────────────────
+// A renamed recipe keeps its id/version but renames its artifact ids (views-registry//views/ over
+// the legacy pages-registry//pages/). Idempotency here is per-artifact expect-absent CAS, so
+// REAPPLYING the renamed recipe onto a bundle that installed the legacy edition would otherwise
+// create a complete SECOND set — two identical launcher cards once that bundle is migrated in
+// place (migration keeps legacy LOCATIONS; only names change). The legacy install SATISFIES the
+// requirement: before creating an artifact, probe its legacy-alias counterpart — the location
+// half derived from CORE's legacy prefix constants, the retired kind name from the frozen literal
+// below (post-removal it is deliberately absent from the live grammar) — and skip
+// creation when the counterpart exists, reporting `legacy_present` in the receipt. An UNMIGRATED
+// legacy install also satisfies the probe: its docs no longer register, but the remedy is the
+// migration script (which fixes them in place, flagged loudly by `status`), never a duplicate
+// install. General by construction: any recipe whose artifacts ride the renamed prefixes or
+// govern the View kind benefits; for every other recipe each probe derives null and nothing
+// changes.
+import { query } from "../bundle-ops.js";
+import { CONVENTIONS_PREFIX } from "../kinds.js";
+import { PAGE_ENTRY_PREFIX, PAGE_REGISTRY_PREFIX, PAGE_TYPE_NAMES, VIEW_ENTRY_PREFIX, VIEW_REGISTRY_PREFIX, } from "../page.js";
+/**
+ * The retired legacy kind name, frozen as a historical fact. Internal to the recipe lifecycle and
+ * not part of its public API; the CLI's diagnostics keep their own frozen copy, and
+ * `legacy-constants-tripwire.test.ts` pins the two equal.
+ */
+export const RETIRED_PAGE_TYPE_NAME = "Page";
+/** Core's one accepted kind name (`View`). */
+export const [VIEW_KIND_NAME] = PAGE_TYPE_NAMES;
+export function legacyRegistryAlias(id) {
+    return id.startsWith(VIEW_REGISTRY_PREFIX)
+        ? `${PAGE_REGISTRY_PREFIX}${id.slice(VIEW_REGISTRY_PREFIX.length)}`
+        : null;
+}
+export function legacyEntryAlias(key) {
+    return key.startsWith(VIEW_ENTRY_PREFIX)
+        ? `${PAGE_ENTRY_PREFIX}${key.slice(VIEW_ENTRY_PREFIX.length)}`
+        : null;
+}
+export function governsKind(doc, kindName) {
+    const governs = doc.frontmatter["governs"];
+    return typeof governs === "string" && governs.trim() === kindName;
+}
+/** The id of an existing convention doc governing the LEGACY kind name, or null. Called at most
+ * once per apply, and only when the recipe carries a convention governing the current name. */
+export async function findLegacyViewConvention(bundle) {
+    const conventions = await query(bundle, { prefix: CONVENTIONS_PREFIX, type: "Convention" });
+    for (const doc of conventions) {
+        if (governsKind(doc, RETIRED_PAGE_TYPE_NAME))
+            return doc.id;
+    }
+    return null;
+}
+//# sourceMappingURL=legacy-aliases.js.map

package/dist/recipe-lifecycle/legacy-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-aliases.js","sourceRoot":"","sources":["../../src/recipe-lifecycle/legacy-aliases.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,kGAAkG;AAClG,6FAA6F;AAC7F,gGAAgG;AAChG,8FAA8F;AAC9F,gGAAgG;AAChG,8FAA8F;AAC9F,kGAAkG;AAClG,kFAAkF;AAClF,iGAAiG;AACjG,8FAA8F;AAC9F,8FAA8F;AAC9F,4FAA4F;AAC5F,4FAA4F;AAC5F,WAAW;AACX,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,EAAa;IAC/C,OAAO,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC;QACxC,CAAC,CAAC,GAAG,oBAAoB,GAAG,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE;QACnE,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACtC,CAAC,CAAC,GAAG,iBAAiB,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAC9D,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,QAAgB;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC3C,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC;AACpE,CAAC;AAED;+FAC+F;AAC/F,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAAc;IAC3D,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5F,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,WAAW,CAAC,GAAG,EAAE,sBAAsB,CAAC;YAAE,OAAO,GAAG,CAAC,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/recipe-lifecycle/retirement-apply.d.ts

@@ -0,0 +1,59 @@
+import { INVENTORY_GUARD_DOMAIN, type InventoryGuardTarget } from "../inventory-guard.js";
+import type { LoadedRecipe } from "../recipes.js";
+import type { Bundle } from "../types.js";
+import { type RecipeDeclarationRetirementPlan, type RetirementDeclaration, type RetirementIssue } from "./retirement.js";
+export interface RecipeRetirementApplyOptions {
+    scope?: typeof INVENTORY_GUARD_DOMAIN;
+    definitionId?: string;
+    consumerEvidence?: unknown;
+}
+export interface RecipeDeclarationRetirementApplyPlan {
+    recipe: "declaration retirement apply";
+    id: string;
+    version: string;
+    source: string;
+    source_digest: string;
+    scope: typeof INVENTORY_GUARD_DOMAIN;
+    ready_for_next_stage: boolean;
+    next_definition: string | null;
+    pending_definitions: string[];
+    declarations: RetirementDeclaration[];
+    blockers: RetirementIssue[];
+    target?: InventoryGuardTarget;
+    plan_token?: string;
+    consumers: RecipeDeclarationRetirementPlan["consumers"];
+    external_consumers: RecipeDeclarationRetirementPlan["external_consumers"];
+}
+export interface RecipeDeclarationRetirementApplyResult {
+    recipe: "declaration retirement apply";
+    id: string;
+    version: string;
+    scope: typeof INVENTORY_GUARD_DOMAIN;
+    completed: Array<{
+        id: string;
+        version: string;
+        changed: boolean;
+        stamped: boolean;
+    }>;
+    pending_definitions: string[];
+    complete: boolean;
+    refresh_needed: boolean;
+    consumers: RecipeDeclarationRetirementPlan["consumers"];
+    external_consumers: RecipeDeclarationRetirementPlan["external_consumers"];
+}
+export declare class RecipeRetirementApplyError extends Error {
+    readonly reason: "plan_changed" | "blocked" | "interrupted" | "outcome_unknown";
+    readonly plan: RecipeDeclarationRetirementApplyPlan;
+    readonly completed: [];
+    readonly failed: {
+        id: string | null;
+        reason: string;
+    };
+    readonly pending_definitions: string[];
+    constructor(reason: RecipeRetirementApplyError["reason"], plan: RecipeDeclarationRetirementApplyPlan, cause?: unknown);
+}
+export declare function planRecipeDeclarationRetirementApply(bundle: Bundle, source: LoadedRecipe, options?: RecipeRetirementApplyOptions): Promise<RecipeDeclarationRetirementApplyPlan>;
+export declare function applyRecipeDeclarationRetirement(bundle: Bundle, source: LoadedRecipe, expectedApplyToken: string, options?: RecipeRetirementApplyOptions & {
+    actor?: string;
+}): Promise<RecipeDeclarationRetirementApplyResult>;
+//# sourceMappingURL=retirement-apply.d.ts.map

package/dist/recipe-lifecycle/retirement-apply.d.ts.map

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

package/dist/recipe-lifecycle/retirement-apply.js

@@ -0,0 +1,165 @@
+/** One explicitly selected actual-source retirement stage; storage remains the commit authority. */
+import { InvalidInputError } from "../errors.js";
+import { compareStorageKeys } from "../paths.js";
+import { VersionConflict } from "../versioning.js";
+import { backendFor } from "../bundle-ops.js";
+import { DocumentNotFoundError, mutateDocument } from "../document-mutation.js";
+import { captureInventoryGuardRequest, INVENTORY_GUARD_DOMAIN, InventoryGuardConflict, InventoryGuardUnsupported, inventoryGuardFor } from "../inventory-guard.js";
+import { buildKindRegistry } from "../kinds.js";
+import { recipePreflightDigest } from "../recipe-set-preflight.js";
+import { prepareRecipeRetirementStage } from "./evolution.js";
+import { inspectRecipeInstallTarget, recipeDocumentForApply } from "./install.js";
+import { definitionDigest } from "./stamp.js";
+import { prepareRecipeDeclarationRetirement } from "./retirement.js";
+export class RecipeRetirementApplyError extends Error {
+    reason;
+    plan;
+    completed = [];
+    failed;
+    pending_definitions;
+    constructor(reason, plan, cause) {
+        super(`Recipe retirement ${reason}; inspect a fresh stage plan before continuing.`, cause === undefined ? undefined : { cause });
+        this.name = "RecipeRetirementApplyError";
+        this.reason = reason;
+        this.plan = plan;
+        this.failed = { id: plan.next_definition, reason };
+        this.pending_definitions = [...(plan.next_definition ? [plan.next_definition] : []), ...plan.pending_definitions];
+    }
+}
+const compare = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+async function prepareStage(bundle, source, options) {
+    source = structuredClone(source);
+    options = { ...options };
+    if (Object.hasOwn(options, "consumerEvidence")) {
+        try {
+            options.consumerEvidence = structuredClone(options.consumerEvidence);
+        }
+        catch { /* The owning preflight returns unsupported input as a refusal. */ }
+    }
+    const bound = { root: bundle.root, backend: backendFor(bundle) };
+    let target, guardIssue;
+    try {
+        target = await inventoryGuardFor(bound.backend).observeTarget();
+    }
+    catch (error) {
+        guardIssue = error instanceof Error ? error.message : String(error);
+    }
+    const prepared = await prepareRecipeDeclarationRetirement(bound, source, options);
+    const report = prepared.report;
+    const ids = [...new Set(report.declarations.map(row => row.definition))].sort(compareStorageKeys);
+    const next = options.definitionId ?? ids[0] ?? null;
+    const selected = report.declarations.filter(row => row.definition === next);
+    const blockers = [...report.blockers];
+    const block = (code, message) => blockers.push({ code, id: next ?? report.id, message });
+    if (options.scope !== INVENTORY_GUARD_DOMAIN)
+        block("RETIREMENT_SCOPE_REQUIRED", "Explicit exact-root cooperating-local-writers-v1, local-only and consumer-unassessed limits are required.");
+    if (!next || !selected.length)
+        block("RETIREMENT_NO_ELIGIBLE_STAGE", "No eligible deprecated omission exists in the selected definition.");
+    if (!report.local.complete || report.local.issues.length)
+        block("RETIREMENT_LOCAL_UNKNOWN", "Complete readable stable local inventory is required.");
+    if (selected.some(row => row.usage.some(usage => usage.unknown || usage.count > 0)))
+        block("RETIREMENT_DECLARATION_USED_OR_UNKNOWN", "The selected definition has used or unknown retired coordinates.");
+    if (guardIssue || !target)
+        block("RETIREMENT_GUARD_UNAVAILABLE", guardIssue ?? "The actual backend has no supported guard.");
+    if (target && (target.edition !== report.local.okf_version || target.root_version !== report.local.root_index_version))
+        block("RETIREMENT_TARGET_CHANGED", "Guard target metadata differs from the inspected local scope.");
+    const inventory = report.local.inventory.filter((row) => row.version !== null).sort((a, b) => compareStorageKeys(a.id, b.id));
+    let candidate;
+    if (next && selected.length && report.local.complete) {
+        try {
+            const stage = await prepareRecipeRetirementStage(bound, prepared.source, next, selected);
+            blockers.push(...stage.plan.blockers);
+            candidate = stage.writes.get(next);
+            if (!candidate)
+                block("RETIREMENT_STAGE_UNCHANGED", "No actual-source retirement write was prepared.");
+            if (stage.plan.definitions.some(row => row.id === next && row.expected_version !== prepared.snapshots.get(next)?.version))
+                block("RETIREMENT_TARGET_CHANGED", "The stage target changed after the scan.");
+        }
+        catch (error) {
+            block("RETIREMENT_STAGE_UNAVAILABLE", error instanceof Error ? error.message : String(error));
+        }
+    }
+    if (Object.hasOwn(options, "consumerEvidence")) {
+        if (report.consumers.status === "partial" || report.consumers.status === "refused" || report.consumers.binding_issues.length || report.consumers.result?.verdict !== "valid")
+            block("RETIREMENT_CONSUMER_EVIDENCE_UNSUPPORTED", "Supplied consumer evidence must be valid and exactly bound; it cannot be downgraded to unassessed.");
+        // B assessed the final source. It certifies this stage only when all other owned concepts
+        // already match, and this actual evolution-owned candidate matches its assessed projection.
+        const owned = prepared.installation ? [...prepared.installation.docs, ...prepared.installation.connectors.map(row => row.doc), ...prepared.installation.references.map(row => row.doc), ...prepared.installation.pages.map(row => row.registry)] : [];
+        if (!candidate || !owned.length || owned.some(wanted => {
+            const actual = wanted.id === next ? candidate : prepared.snapshots.get(wanted.id)?.doc;
+            if (!actual || !prepared.installation)
+                return true;
+            const inspection = inspectRecipeInstallTarget(actual, wanted, prepared.installation);
+            return !inspection.sameContent || inspection.stamp !== "current" || inspection.stampIntegrity !== "current";
+        }))
+            block("RETIREMENT_STAGE_CONSUMER_UNREPRESENTABLE", "Final-source evidence does not represent this concrete intermediate stage; supply an actual staged source/evidence or inspect a later stage.");
+    }
+    if (target) {
+        try {
+            if (recipePreflightDigest(await inventoryGuardFor(bound.backend).observeTarget()) !== recipePreflightDigest(target))
+                block("RETIREMENT_TARGET_CHANGED", "Guard target changed while planning.");
+        }
+        catch (error) {
+            block("RETIREMENT_GUARD_UNAVAILABLE", error instanceof Error ? error.message : String(error));
+        }
+    }
+    if (target && candidate && next) {
+        try {
+            captureInventoryGuardRequest({ target, domain: INVENTORY_GUARD_DOMAIN, inventory, id: next,
+                expectedVersion: prepared.snapshots.get(next).version, doc: candidate });
+        }
+        catch (error) {
+            block("RETIREMENT_GUARD_UNAVAILABLE", error instanceof Error ? error.message : String(error));
+        }
+    }
+    blockers.sort((a, b) => compare(JSON.stringify(a), JSON.stringify(b)));
+    const plan = {
+        recipe: "declaration retirement apply", id: report.id, version: report.version, source: report.source, source_digest: report.source_digest,
+        scope: INVENTORY_GUARD_DOMAIN, ready_for_next_stage: blockers.length === 0,
+        next_definition: next, pending_definitions: ids.filter(id => id !== next), declarations: selected, blockers,
+        ...(target ? { target } : {}), consumers: report.consumers, external_consumers: report.external_consumers,
+    };
+    if (plan.ready_for_next_stage && candidate) {
+        plan.plan_token = `retirement-apply/v1:${recipePreflightDigest({ plan, inventory, observation_digest: report.local.observation_digest,
+            candidate: definitionDigest(candidate), stamp: candidate.frontmatter.x_recipe })}`;
+    }
+    return { plan, bundle: bound, candidate, inventory, expectedVersion: next ? prepared.snapshots.get(next)?.version : undefined };
+}
+export async function planRecipeDeclarationRetirementApply(bundle, source, options = {}) {
+    return (await prepareStage(bundle, source, options)).plan;
+}
+export async function applyRecipeDeclarationRetirement(bundle, source, expectedApplyToken, options = {}) {
+    options = { ...options };
+    const stage = await prepareStage(bundle, source, options);
+    const { plan } = stage;
+    if (!plan.ready_for_next_stage)
+        throw new RecipeRetirementApplyError("blocked", plan);
+    if (!/^retirement-apply\/v1:sha256:[0-9a-f]{64}$/.test(expectedApplyToken) || expectedApplyToken !== plan.plan_token)
+        throw new RecipeRetirementApplyError("plan_changed", plan);
+    const now = new Date().toISOString();
+    const desired = recipeDocumentForApply(stage.candidate, plan.target.edition, now);
+    try {
+        const result = await mutateDocument({ bundle: stage.bundle, id: plan.next_definition, mode: "replace-document", onAbsent: "fail",
+            expectedVersion: stage.expectedVersion, maxAttempts: 1, registry: buildKindRegistry([], [], { okfVersion: plan.target.edition }), strict: false,
+            seedGenerationClock: false, persistActor: false, actor: options.actor, now: () => now,
+            inventoryGuard: { target: plan.target, domain: plan.scope, inventory: stage.inventory },
+            buildCandidate: (_existing, context) => {
+                if (context.okfVersion !== plan.target.edition)
+                    throw new InventoryGuardConflict("edition");
+                return { frontmatter: desired.frontmatter, body: desired.body };
+            },
+        });
+        return { recipe: "declaration retirement apply", id: plan.id, version: plan.version, scope: plan.scope,
+            completed: [{ id: plan.next_definition, version: result.version, changed: result.changed, stamped: true }],
+            pending_definitions: plan.pending_definitions, complete: plan.pending_definitions.length === 0, refresh_needed: plan.pending_definitions.length > 0,
+            consumers: plan.consumers, external_consumers: plan.external_consumers };
+    }
+    catch (error) {
+        // These owning typed refusals establish that publication did not occur. Keep their
+        // authority; only an unclassified persistence failure has an uncertain outcome.
+        if (error instanceof InventoryGuardUnsupported || error instanceof InvalidInputError || error instanceof VersionConflict || error instanceof DocumentNotFoundError)
+            throw error;
+        throw new RecipeRetirementApplyError(error instanceof InventoryGuardConflict ? "interrupted" : "outcome_unknown", plan, error);
+    }
+}
+//# sourceMappingURL=retirement-apply.js.map

package/dist/recipe-lifecycle/retirement-apply.js.map

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

package/dist/recipe-lifecycle/retirement.d.ts

@@ -0,0 +1,89 @@
+import { type LoadedRecipe } from "../recipes.js";
+import { type PreflightResult } from "../recipe-set-preflight.js";
+import type { Bundle, ReadResult } from "../types.js";
+import { type PreparedRecipeInstall } from "./install.js";
+export interface RetirementIssue {
+    code: string;
+    id: string;
+    message: string;
+    field?: string;
+}
+export interface RetirementDeclaration {
+    definition: string;
+    kind: string;
+    coordinate: "field" | "value" | "link";
+    name: string;
+    value?: string;
+    installed_version: string;
+    proposed_definition_digest: string;
+    usage: Array<{
+        id: string;
+        count: number;
+        unknown?: true;
+    }>;
+}
+export interface RecipeDeclarationRetirementPlan {
+    recipe: "declaration retirement inspection";
+    id: string;
+    version: string;
+    source: string;
+    source_digest: string;
+    scope: "observed-local-concepts-and-supplied-structural-consumers";
+    can_apply: false;
+    apply_blocker: "RETIREMENT_APPLY_NOT_IMPLEMENTED";
+    analysis: "complete" | "partial" | "refused";
+    declarations: RetirementDeclaration[];
+    blockers: RetirementIssue[];
+    local: {
+        verdict: "complete-clean" | "used" | "unknown";
+        complete: boolean;
+        consistency: "observed-stable-reads-not-an-atomic-snapshot";
+        target_root: string;
+        bundle_id?: string;
+        okf_version: string;
+        root_index_version: string | null;
+        initial_ids: string[];
+        final_ids: string[];
+        inventory: Array<{
+            id: string;
+            version: string | null;
+        }>;
+        observation_digest: string;
+        issues: RetirementIssue[];
+    };
+    consumers: {
+        status: "unassessed" | "valid" | "partial" | "refused";
+        scope: "supplied-declared-structural-only";
+        model: "final-selected-source-hypothesis";
+        evidence_digest?: string;
+        binding_issues: Array<{
+            level: "partial" | "refused";
+            code: string;
+            at: string;
+        }>;
+        result?: PreflightResult;
+        unsupported_semantics: readonly ["enum-value-compatibility", "type-compatibility", "write-intent-compatibility"];
+    };
+    external_consumers: "unknown-unenumerated-offline-and-arbitrary-code";
+    proposed_definitions: Array<{
+        id: string;
+        definition_digest: string;
+        hypothetical_content_version: string;
+    }>;
+}
+/** Internal reusable preparation for future guarded lifecycle application. The report alone
+ * remains non-authoritative; this data carries no permission or committing operation. */
+export interface PreparedRecipeDeclarationRetirement {
+    report: RecipeDeclarationRetirementPlan;
+    source: LoadedRecipe;
+    installation?: PreparedRecipeInstall;
+    snapshots: ReadonlyMap<string, ReadResult>;
+    bundle: Bundle;
+}
+export declare function prepareRecipeDeclarationRetirement(bundle: Bundle, recipe: LoadedRecipe, options?: {
+    consumerEvidence?: unknown;
+}): Promise<PreparedRecipeDeclarationRetirement>;
+export declare function planRecipeDeclarationRetirement(bundle: Bundle, source: LoadedRecipe, options?: {
+    consumerEvidence?: unknown;
+}): Promise<RecipeDeclarationRetirementPlan>;
+//# sourceMappingURL=retirement.d.ts.map

package/dist/recipe-lifecycle/retirement.d.ts.map

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