@superbee/core 0.2.0-pre.3 → 0.2.0-pre.31

package/dist/recipe-lifecycle/install.js

@@ -0,0 +1,594 @@
+// Recipe installation: create-only, expect-absent CAS per artifact through the shared document
+// mutation boundary, so a built-in and an external recipe install through the same function and
+// an existing document is never overwritten. Storage-neutral: no Node globals or builtins.
+import { query, readBlob, readBundleOkfVersion, readDoc, writeBlob } from "../bundle-ops.js";
+import { checkConnectorAgainstKinds, CONNECTORS_PREFIX } from "../connectors.js";
+import { resolveContentType } from "../content-type.js";
+import { mutateDocument } from "../document-mutation.js";
+import { InvalidInputError, OkfActorError } from "../errors.js";
+import { isOkfActor } from "../okf-actor.js";
+import { CONVENTION_TYPE, CONVENTIONS_PREFIX, PROGRESS_STATUS_FIELD, buildKindRegistry, progressStatusStorageField, } from "../kinds.js";
+import { okfValuesEqual } from "../okf-authored-values.js";
+import { assertAuthoredOkfStandardFields } from "../okf-standard-fields.js";
+import { PAGE_REGISTRY_PREFIX, parseRegistration, VIEW_REGISTRY_PREFIX } from "../page.js";
+import { RECIPE_PROGRESS_STATUS_TOKEN } from "../recipes.js";
+import { VersionConflict } from "../versioning.js";
+import { ConnectorTargetUnsatisfied, RecipeAssetConflict, RecipeEditionChanged, RecipeInputError } from "./errors.js";
+import { RECIPE_STAMP_KEY, normalizeDefinitionBody, recipeStampIdentity, recipeStampState, conventionStampState, withRecipeStamp, worstRecipeStampState, } from "./stamp.js";
+import { findLegacyViewConvention, governsKind, legacyEntryAlias, legacyRegistryAlias, VIEW_KIND_NAME, } from "./legacy-aliases.js";
+function materializeRecipeBody(body, storageField) {
+    return body.replaceAll(RECIPE_PROGRESS_STATUS_TOKEN, storageField);
+}
+const RECIPE_WRITE_REGISTRY = { kinds: new Map(), warnings: [] };
+function plainRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function renameLogicalFieldMap(value, storageField, recipeId, docId) {
+    const record = plainRecord(value);
+    if (!record || !Object.prototype.hasOwnProperty.call(record, PROGRESS_STATUS_FIELD))
+        return value;
+    if (storageField !== PROGRESS_STATUS_FIELD
+        && Object.prototype.hasOwnProperty.call(record, storageField)) {
+        throw new RecipeInputError(`recipe '${recipeId}' convention '${docId}' declares both logical '${PROGRESS_STATUS_FIELD}' and storage field '${storageField}'`);
+    }
+    return Object.fromEntries(Object.entries(record).map(([field, fieldValue]) => [
+        field === PROGRESS_STATUS_FIELD ? storageField : field,
+        fieldValue,
+    ]));
+}
+/** Materialize explicit logical recipe fields into the target edition's physical convention keys. */
+export function materializeRecipeForEdition(recipe, okfVersion) {
+    const storageField = progressStatusStorageField(okfVersion);
+    if (!storageField) {
+        throw new RecipeInputError(`recipe '${recipe.id}' cannot target unsupported OKF mutation version '${okfVersion}'`);
+    }
+    const docs = recipe.docs.map((doc) => {
+        const fields = plainRecord(doc.frontmatter.fields);
+        if (!fields)
+            return doc;
+        const listField = (value) => {
+            if (!Array.isArray(value) || !value.includes(PROGRESS_STATUS_FIELD))
+                return value;
+            if (value.includes(storageField)) {
+                throw new RecipeInputError(`recipe '${recipe.id}' convention '${doc.id}' declares both logical '${PROGRESS_STATUS_FIELD}' and storage field '${storageField}'`);
+            }
+            return value.map((field) => field === PROGRESS_STATUS_FIELD ? storageField : field);
+        };
+        const materializedFields = { ...fields };
+        for (const key of ["required", "optional"]) {
+            if (Object.prototype.hasOwnProperty.call(fields, key)) {
+                materializedFields[key] = listField(fields[key]);
+            }
+        }
+        for (const key of ["values", "value_descriptions", "terminal", "descriptions", "types"]) {
+            if (Object.prototype.hasOwnProperty.call(fields, key)) {
+                materializedFields[key] = renameLogicalFieldMap(fields[key], storageField, recipe.id, doc.id);
+            }
+        }
+        return {
+            ...doc,
+            frontmatter: { ...doc.frontmatter, fields: materializedFields },
+            body: materializeRecipeBody(doc.body, storageField),
+        };
+    });
+    return { ...recipe, docs };
+}
+export function recipeDocumentForApply(doc, okfVersion, now) {
+    return okfVersion === "0.1"
+        ? { ...doc, frontmatter: { ...doc.frontmatter, timestamp: now } }
+        : { ...doc, frontmatter: { ...doc.frontmatter } };
+}
+/** Parsed recipe carriers contain YAML values. Copy mappings locally so preparation neither
+ * aliases its source nor changes the record realm used by the owning OKF value comparator. */
+function cloneRecipeData(value) {
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (value instanceof Uint8Array)
+        return Uint8Array.from(value);
+    if (Array.isArray(value))
+        return value.map((item) => cloneRecipeData(item));
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, cloneRecipeData(item)]));
+    }
+    return value;
+}
+/** Prepare the same candidates installRecipe creates. The caller retains the explicit preparation
+ * time across preview/replay; source identity is calculated before edition materialization.
+ * The result shares no mutable data with the parsed source. It is proposal data, not authority. */
+export function prepareRecipeInstall(recipe, options) {
+    if (typeof options.now !== "string") {
+        throw new RecipeInputError("recipe installation preparation requires an explicit retained time");
+    }
+    const source = cloneRecipeData(recipe);
+    const materialized = materializeRecipeForEdition(source, options.okfVersion);
+    const identity = recipeStampIdentity(source, materialized);
+    const document = (doc) => recipeDocumentForApply(doc, options.okfVersion, options.now);
+    const stamped = (doc) => withRecipeStamp(document(doc), identity);
+    return {
+        okfVersion: options.okfVersion,
+        now: options.now,
+        identity,
+        docs: materialized.docs.map(stamped),
+        connectors: (materialized.connectors ?? []).map((connector) => ({ ...connector, doc: stamped(connector.doc) })),
+        pages: materialized.pages.map((page) => ({ ...page, registry: document(page.registry) })),
+        references: materialized.references.map((reference) => ({ ...reference, doc: stamped(reference.doc) })),
+    };
+}
+/** Inspect one candidate's exact target without changing content or adopting a stamp. Registry,
+ * compatibility, permission and storage admission remain the committing caller's responsibility. */
+export function inspectRecipeInstallTarget(existing, desired, prepared) {
+    if (existing === null)
+        return { exists: false, sameContent: false, stamp: "missing", stampIntegrity: "unknown" };
+    if (existing.id !== desired.id) {
+        throw new RecipeInputError(`recipe installation target '${existing.id}' does not match candidate '${desired.id}'`);
+    }
+    return {
+        exists: true,
+        sameContent: sameInstalledDoc(existing, desired, prepared.okfVersion),
+        stamp: recipeStampState(existing, prepared.identity),
+        stampIntegrity: conventionStampState(existing),
+    };
+}
+async function createRecipeDocument(bundle, doc, okfVersion, now, actor) {
+    const result = await mutateDocument({
+        bundle,
+        id: doc.id,
+        mode: "create-only",
+        registry: RECIPE_WRITE_REGISTRY,
+        strict: false,
+        actor,
+        // Installed definitions must stay byte-comparable to their recipe source (sameInstalledDoc
+        // preserves upstream generated.by). Record the installer separately as mutation attribution,
+        // without manufacturing content provenance or replacing the recipe producer.
+        seedGenerationClock: false,
+        now: () => now,
+        buildCandidate: (_existing, context) => {
+            if (context.okfVersion !== okfVersion) {
+                throw new RecipeEditionChanged(okfVersion, context.okfVersion, "installation");
+            }
+            return { frontmatter: { ...doc.frontmatter }, body: doc.body };
+        },
+    });
+    return result.doc;
+}
+/**
+ * Install `recipe` through the shared document-mutation boundary using expect-absent CAS. Recipe
+ * conventions may declare Superbee's logical `progress_status`; this installer materializes the
+ * concrete field for the bundle edition before any write. V0.1 retains the historical install-time
+ * `timestamp` (`options.now`, default the current time); v0.2 preserves explicitly supplied legacy
+ * fields but does not invent them. A `VersionConflict` remains an idempotent existing-doc result,
+ * never a clobber.
+ */
+export async function installRecipe(bundle, recipe, options = {}) {
+    const now = options.now ?? new Date().toISOString();
+    const okfVersion = await readBundleOkfVersion(bundle) ?? "0.1";
+    // Validate before any artifact write, including recipes whose first artifact is a blob.
+    if (okfVersion === "0.2" && options.actor !== undefined && !isOkfActor(options.actor)) {
+        throw new OkfActorError(options.actor, `OKF v0.2 mutation actor '${options.actor}' must be human:<id>, process:<id>, or <producer>/<version>`);
+    }
+    const prepared = prepareRecipeInstall(recipe, { okfVersion: okfVersion, now });
+    recipe = { ...recipe, docs: prepared.docs, connectors: prepared.connectors, pages: prepared.pages, references: prepared.references };
+    assertConnectorsWritable(recipe, okfVersion);
+    assertReferencesWritable(recipe, okfVersion);
+    await assertConnectorTargets(bundle, recipe, okfVersion);
+    await assertPortableTargetsCompatible(bundle, recipe, okfVersion);
+    // Legacy-alias probes (see the module comment above the alias helpers): resolved lazily, once.
+    const legacyConventionId = recipe.docs.some((d) => governsKind(d, VIEW_KIND_NAME))
+        ? await findLegacyViewConvention(bundle)
+        : null;
+    let legacyRegistryDocs = null;
+    const legacyRegistryDoc = async (id) => {
+        legacyRegistryDocs ??= new Map((await query(bundle, { prefix: PAGE_REGISTRY_PREFIX })).map((doc) => [doc.id, doc]));
+        return legacyRegistryDocs.get(id);
+    };
+    const migrationWarnings = [];
+    const migrationHelp = "run `node scripts/migrate-legacy-view-names.mjs --dir <bundle-root>` from the Superbee repository root to migrate it in place";
+    const docs = [];
+    const stamps = [];
+    const restampIds = [];
+    const foreignIds = [];
+    for (const d of recipe.docs) {
+        if (legacyConventionId !== null && governsKind(d, VIEW_KIND_NAME)) {
+            // A convention still governing the RETIRED legacy name is unmigrated state: skip creating
+            // the current-name convention (never two conventions for one kind), but as an explicit
+            // NON-SUCCESS — not a satisfied-looking skip.
+            docs.push({ id: d.id, changed: false, migration_required: legacyConventionId });
+            stamps.push("missing");
+            migrationWarnings.push({
+                code: "MIGRATION_REQUIRED",
+                message: `'${legacyConventionId}' still governs the retired legacy 'Page' kind name — ` +
+                    `'${d.id}' was not installed; ${migrationHelp}`,
+                severity: "warning",
+            });
+            continue;
+        }
+        // The stamp lands in the convention's own create: it exists exactly when the convention does.
+        let doc = d;
+        let changed = true;
+        let sourceDiffers = false;
+        try {
+            doc = await createRecipeDocument(bundle, doc, okfVersion, now, options.actor);
+            stamps.push("current");
+        }
+        catch (err) {
+            if (err instanceof VersionConflict) {
+                const existing = await readDoc(bundle, doc.id);
+                const inspection = inspectRecipeInstallTarget(existing, doc, prepared);
+                const existingStamp = inspection.stamp;
+                stamps.push(existingStamp);
+                if (existingStamp === "stale" || existingStamp === "missing")
+                    restampIds.push(doc.id);
+                else if (existingStamp === "foreign")
+                    foreignIds.push(doc.id);
+                if (!inspection.sameContent) {
+                    sourceDiffers = true;
+                    migrationWarnings.push({
+                        code: "RECIPE_SOURCE_DIFFERS",
+                        message: `recipe '${recipe.id}' source for '${doc.id}.md' differs from the existing convention; ` +
+                            "the existing bundle content was left untouched — run 'recipe evolve <same-name-or-path>' to inspect a safe additive upgrade plan",
+                        severity: "warning",
+                    });
+                }
+                changed = false;
+            }
+            else {
+                throw err;
+            }
+        }
+        docs.push({ id: doc.id, changed, ...(sourceDiffers ? { source_differs: true } : {}) });
+    }
+    // After the conventions, so a Kind the recipe declares exists before the Connector that maps onto it.
+    const connectors = [];
+    for (const { doc: authored } of recipe.connectors ?? []) {
+        const doc = authored;
+        let changed = true;
+        let sourceDiffers = false;
+        try {
+            await createRecipeDocument(bundle, doc, okfVersion, now, options.actor);
+            stamps.push("current");
+        }
+        catch (err) {
+            if (!(err instanceof VersionConflict))
+                throw err;
+            const existing = await readDoc(bundle, doc.id);
+            const inspection = inspectRecipeInstallTarget(existing, doc, prepared);
+            const existingStamp = inspection.stamp;
+            stamps.push(existingStamp);
+            if (existingStamp === "stale" || existingStamp === "missing")
+                restampIds.push(doc.id);
+            else if (existingStamp === "foreign")
+                foreignIds.push(doc.id);
+            if (!inspection.sameContent) {
+                sourceDiffers = true;
+                migrationWarnings.push({
+                    code: "RECIPE_SOURCE_DIFFERS",
+                    message: `recipe '${recipe.id}' source for '${doc.id}.md' differs from the existing Connector; ` +
+                        "the existing bundle content was left untouched; run 'recipe evolve <same-name-or-path>' to inspect the plan, which never replaces a Connector a person changed",
+                    severity: "warning",
+                });
+            }
+            changed = false;
+        }
+        connectors.push({ id: doc.id, changed, ...(sourceDiffers ? { source_differs: true } : {}) });
+    }
+    const pages = [];
+    for (const page of recipe.pages) {
+        const registryAlias = legacyRegistryAlias(page.registry.id);
+        const entryAlias = legacyEntryAlias(page.entry);
+        const aliasDoc = registryAlias !== null && entryAlias !== null ? await legacyRegistryDoc(registryAlias) : undefined;
+        if (registryAlias !== null && entryAlias !== null && aliasDoc !== undefined) {
+            // Skip ONLY on a COMPLETE legacy pair: a partial legacy leftover (registry doc without its
+            // blob) must not suppress the new install — that would leave no working card at all.
+            // Creating under the new ids is always safe (expect-absent CAS; ids never collide across
+            // prefixes), and the leftover is the audit's business, not the installer's.
+            const legacyBlob = await readBlob(bundle, entryAlias);
+            if (legacyBlob !== null) {
+                // The counterpart's KIND decides the outcome: a registering View at the
+                // legacy location genuinely satisfies the artifact; a RETIRED-name (Page-typed or
+                // otherwise non-registering) counterpart holds the slot but no longer works — an
+                // explicit non-success naming the remedy, never a satisfied-looking skip.
+                const registers = parseRegistration(aliasDoc.id, aliasDoc.frontmatter) !== null;
+                if (registers) {
+                    pages.push({
+                        registry_id: page.registry.id,
+                        entry: page.entry,
+                        registry_changed: false,
+                        entry_changed: false,
+                        changed: false,
+                        legacy_present: { registry: registryAlias, entry: entryAlias },
+                    });
+                }
+                else {
+                    pages.push({
+                        registry_id: page.registry.id,
+                        entry: page.entry,
+                        registry_changed: false,
+                        entry_changed: false,
+                        changed: false,
+                        migration_required: { registry: registryAlias, entry: entryAlias },
+                    });
+                    migrationWarnings.push({
+                        code: "MIGRATION_REQUIRED",
+                        message: `'${registryAlias}' holds this artifact's slot but still carries the retired legacy names ` +
+                            `and does not register — '${page.registry.id}' was not installed; ${migrationHelp}`,
+                        severity: "warning",
+                    });
+                }
+                continue;
+            }
+        }
+        const desiredBytes = new TextEncoder().encode(page.html);
+        let entryChanged = true;
+        try {
+            await writeBlob(bundle, page.entry, desiredBytes, undefined, { expectedVersion: null });
+        }
+        catch (err) {
+            if (!(err instanceof VersionConflict))
+                throw err;
+            const existing = await readBlob(bundle, page.entry);
+            const bytesMatch = existing !== null && sameBytes(existing.bytes, desiredBytes);
+            const sameContentType = existing?.contentType === resolveContentType(page.entry);
+            if (!bytesMatch || !sameContentType)
+                throw new RecipeAssetConflict(recipe.id, page.entry);
+            entryChanged = false;
+        }
+        let registry = page.registry;
+        let registryChanged = true;
+        try {
+            registry = await createRecipeDocument(bundle, registry, okfVersion, now, options.actor);
+        }
+        catch (err) {
+            if (!(err instanceof VersionConflict))
+                throw err;
+            const existing = await readDoc(bundle, registry.id);
+            if (!sameInstalledDoc(existing, registry, okfVersion))
+                throw new RecipeAssetConflict(recipe.id, `${registry.id}.md`);
+            registryChanged = false;
+        }
+        pages.push({
+            registry_id: registry.id,
+            entry: page.entry,
+            registry_changed: registryChanged,
+            entry_changed: entryChanged,
+            changed: registryChanged || entryChanged,
+        });
+    }
+    const references = [];
+    for (const reference of recipe.references) {
+        let desired = reference.doc;
+        let changed = true;
+        try {
+            desired = await createRecipeDocument(bundle, desired, okfVersion, now, options.actor);
+        }
+        catch (err) {
+            if (!(err instanceof VersionConflict))
+                throw err;
+            const existing = await readDoc(bundle, desired.id);
+            if (!sameInstalledDoc(existing, desired, okfVersion))
+                throw new RecipeAssetConflict(recipe.id, `${desired.id}.md`);
+            changed = false;
+        }
+        references.push({ id: desired.id, changed });
+    }
+    const artifacts = [
+        ...docs,
+        ...connectors,
+        ...pages,
+        ...references,
+    ];
+    const sourceDiffers = [...docs, ...connectors].filter((doc) => doc.source_differs).length;
+    const counts = {
+        created: artifacts.filter((a) => a.changed).length,
+        existing: artifacts.filter((a) => !a.changed && a.legacy_present === undefined && a.migration_required === undefined &&
+            !("source_differs" in a && a.source_differs === true))
+            .length,
+        legacy_present: artifacts.filter((a) => a.legacy_present !== undefined).length,
+        migration_required: artifacts.filter((a) => a.migration_required !== undefined).length,
+        ...(sourceDiffers > 0 ? { source_differs: sourceDiffers } : {}),
+    };
+    return {
+        id: recipe.id,
+        version: recipe.version,
+        source: recipe.source,
+        docs,
+        connectors,
+        pages,
+        references,
+        counts,
+        changed: docs.some((d) => d.changed) ||
+            connectors.some((connector) => connector.changed) ||
+            pages.some((page) => page.changed) ||
+            references.some((reference) => reference.changed),
+        stamp: worstRecipeStampState(stamps),
+        restamp_ids: restampIds.sort(),
+        foreign_ids: foreignIds.sort(),
+        warnings: [...recipe.warnings, ...migrationWarnings],
+    };
+}
+/**
+ * Every Connector as install will write it, against the authoring rules the engine applies on this
+ * edition. The parser tolerates unknown top-level keys, so one OKF v0.2 owns (a `tags` that is not
+ * a list, say) would otherwise be refused at the Connector's create, after the conventions.
+ */
+function assertConnectorsWritable(recipe, okfVersion) {
+    if (okfVersion !== "0.2")
+        return;
+    for (const { doc } of recipe.connectors ?? []) {
+        try {
+            assertAuthoredOkfStandardFields(doc.frontmatter, undefined, { phase: "input" });
+        }
+        catch (error) {
+            if (!(error instanceof InvalidInputError))
+                throw error;
+            throw new RecipeInputError(`recipe '${recipe.id}' cannot install Connector '${doc.id}': ${error.message}; nothing was written`);
+        }
+    }
+}
+/** References follow Views in the write order, so authoring admission must precede even a
+ * blob-only recipe's first write. Use the same edition-specific owner as document mutation. */
+function assertReferencesWritable(recipe, okfVersion) {
+    if (okfVersion !== "0.2")
+        return;
+    for (const { doc } of recipe.references) {
+        try {
+            assertAuthoredOkfStandardFields(doc.frontmatter, undefined, { phase: "input" });
+        }
+        catch (error) {
+            if (!(error instanceof InvalidInputError))
+                throw error;
+            throw new RecipeInputError(`recipe '${recipe.id}' cannot install Reference '${doc.id}': ${error.message}; nothing was written`);
+        }
+    }
+}
+/**
+ * Every Connector's sources against the Kinds the bundle will hold once this install is done: its
+ * conventions, plus the recipe's own at ids the bundle does not hold yet (install never rewrites an
+ * existing convention). Runs before the first write of any artifact.
+ */
+async function assertConnectorTargets(bundle, recipe, okfVersion) {
+    const connectors = recipe.connectors ?? [];
+    if (connectors.length === 0)
+        return;
+    const conventions = new Map((await query(bundle, { prefix: CONVENTIONS_PREFIX, type: CONVENTION_TYPE })).map((doc) => [doc.id, doc]));
+    for (const doc of recipe.docs)
+        if (!conventions.has(doc.id))
+            conventions.set(doc.id, doc);
+    const registry = buildKindRegistry([...conventions.values()], [], { okfVersion });
+    // Each refusal points at /<sources key>/<index>/target_kind or /<sources key>/<index>/fields/<field>.
+    const segments = (pointer) => pointer.split("/").slice(1).map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+    for (const { connector } of connectors) {
+        const errors = checkConnectorAgainstKinds(connector, registry);
+        if (errors.length === 0)
+            continue;
+        const index = segments(errors[0].path)[1];
+        const source = connector.sources[Number(index)];
+        const ofSource = errors.filter((error) => segments(error.path)[1] === index);
+        const fields = [...new Set(ofSource.flatMap((error) => {
+                const [, , block, field] = segments(error.path);
+                return block === "fields" && field !== undefined ? [field] : [];
+            }))];
+        throw new ConnectorTargetUnsatisfied(recipe.id, connector.id, source.name, source.target_kind, errors[0].code, fields, ofSource.map((error) => error.message).join("; "));
+    }
+}
+async function assertPortableTargetsCompatible(bundle, recipe, okfVersion) {
+    const registries = new Map();
+    if (recipe.pages.length > 0) {
+        // Both accepted registry prefixes (views-registry/ current, pages-registry/ legacy) — the
+        // query takes ONE prefix, so run it per prefix and merge (ids never collide across prefixes).
+        for (const prefix of [PAGE_REGISTRY_PREFIX, VIEW_REGISTRY_PREFIX]) {
+            const registryDocs = await query(bundle, { prefix });
+            for (const doc of registryDocs)
+                registries.set(doc.id, doc);
+        }
+    }
+    for (const page of recipe.pages) {
+        const existingBlob = await readBlob(bundle, page.entry);
+        if (existingBlob) {
+            const desiredBytes = new TextEncoder().encode(page.html);
+            const bytesMatch = sameBytes(existingBlob.bytes, desiredBytes);
+            const sameContentType = existingBlob.contentType === resolveContentType(page.entry);
+            if (!bytesMatch || !sameContentType)
+                throw new RecipeAssetConflict(recipe.id, page.entry);
+        }
+        const existingRegistry = registries.get(page.registry.id);
+        if (existingRegistry) {
+            const desiredRegistry = page.registry;
+            if (!sameInstalledDoc(existingRegistry, desiredRegistry, okfVersion)) {
+                throw new RecipeAssetConflict(recipe.id, `${page.registry.id}.md`);
+            }
+        }
+    }
+    const installedReferences = new Map();
+    if (recipe.references.length > 0) {
+        const referenceDocs = await query(bundle, { prefix: "references/" });
+        for (const doc of referenceDocs)
+            installedReferences.set(doc.id, doc);
+    }
+    for (const reference of recipe.references) {
+        if (reference.doc.frontmatter.type !== "Reference") {
+            throw new RecipeInputError(`recipe '${recipe.id}' asset '${reference.doc.id}' must have type 'Reference'`);
+        }
+        const existing = installedReferences.get(reference.doc.id);
+        if (!existing)
+            continue;
+        const desired = reference.doc;
+        if (!sameInstalledDoc(existing, desired, okfVersion)) {
+            throw new RecipeAssetConflict(recipe.id, `${reference.doc.id}.md`);
+        }
+    }
+}
+/** Byte equality of two blob payloads. */
+function sameBytes(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let index = 0; index < a.length; index += 1) {
+        if (a[index] !== b[index])
+            return false;
+    }
+    return true;
+}
+export function sameInstalledDoc(existing, desired, okfVersion) {
+    // The recipe stamp is install metadata, never definition content.
+    const { timestamp: _existingTimestamp, [RECIPE_STAMP_KEY]: _existingStamp, ...existingFrontmatter } = existing.frontmatter;
+    const { timestamp: _desiredTimestamp, [RECIPE_STAMP_KEY]: _desiredStamp, ...desiredFrontmatter } = desired.frontmatter;
+    // The installer is the latest mutation actor, not part of the upstream definition. Its
+    // edition-specific coordinate may change without changing source-authored generated.by.
+    const actorField = okfVersion === "0.2" ? "superbee_updated_by" : "actor";
+    delete existingFrontmatter[actorField];
+    delete desiredFrontmatter[actorField];
+    // A reading-order placement the bundle added to an installed convention is not drift: the
+    // recipe declares none, and evolution keeps it (BUNDLE_LOCAL_PLACEMENT in evolution.ts).
+    if (desiredFrontmatter.order === undefined)
+        delete existingFrontmatter.order;
+    if (okfVersion === "0.2") {
+        for (const frontmatter of [existingFrontmatter, desiredFrontmatter]) {
+            const generated = plainRecord(frontmatter.generated);
+            if (!generated)
+                continue;
+            const { at: _at, ...rest } = generated;
+            frontmatter.generated = rest;
+        }
+    }
+    return okfValuesEqual(existingFrontmatter, desiredFrontmatter) && normalizeDefinitionBody(existing.body) === normalizeDefinitionBody(desired.body);
+}
+/**
+ * The convention docs currently present under `conventions/`, by id — ONE round-trip
+ * (backend-agnostic, works over `--remote`), used by `recipes` to report whether a built-in is
+ * already applied to `bundle` (every one of its docs' ids present) AND whether any installed
+ * doc's content differs from the recipe source (the listing's `drift` bit). The query was always
+ * a full read; returning the docs instead of discarding their content costs zero added I/O.
+ */
+export async function installedConventionDocs(bundle) {
+    const docs = await query(bundle, { prefix: CONVENTIONS_PREFIX });
+    return new Map(docs.map((d) => [d.id, d]));
+}
+/**
+ * The documents under `connectors/`, by id: the Connector documents `installedRecipes` reads beside
+ * the conventions, in one round-trip.
+ */
+export async function installedConnectorDocs(bundle) {
+    const docs = await query(bundle, { prefix: CONNECTORS_PREFIX });
+    return new Map(docs.map((d) => [d.id, d]));
+}
+/**
+ * True when at least one of `recipe`'s installed docs differs in content from the recipe source
+ * (the same `sameInstalledDoc` comparison `installRecipe` makes; timestamp-insensitive). Honest at
+ * the literal level only: drift can be DELIBERATE — a dismissal record occupying the canonical
+ * id, or a kind legitimately evolved via `kind field add` / `recipe evolve`. The listing pairs
+ * the bit with descriptive help and NO fixing command (design appendix O2): a proactive "fix"
+ * pointer here would re-propose exactly what a `kind dismiss` recorded declining.
+ */
+export function recipeDrifts(recipe, installed, okfVersion, now) {
+    const materialized = materializeRecipeForEdition(recipe, okfVersion);
+    return materialized.docs.some((doc) => {
+        const existing = installed.get(doc.id);
+        return existing !== undefined && !sameInstalledDoc(existing, recipeDocumentForApply(doc, okfVersion, now), okfVersion);
+    });
+}
+/** True when every convention doc `recipe` installs is already present in `appliedIds`. */
+export function isRecipeApplied(recipe, appliedIds) {
+    return recipe.docs.every((doc) => appliedIds.has(doc.id));
+}
+//# sourceMappingURL=install.js.map

package/dist/recipe-lifecycle/install.js.map

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

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