@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/schema-migration.js

@@ -1,857 +1,4 @@
-/**
- * @module sdk/schema-migration
- *
- * Plans deterministic, resumable schema evolution over item metadata. Storage
- * execution is layered on the item mutation and workspace transaction
- * primitives so every applied item keeps its normal lock, history, and index
- * guarantees.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="60738c1f-3b44-5f8a-82c9-99d2b2de1e51")}catch(e){}}();
-import { assertInitializedTracker } from "./environment/tracker-preflight.js";
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { isFileMissingError, readFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
-import { appendWorkspaceHistoryChange } from "../core/history/workspace-history.js";
-import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-import { parseFieldsFile, serializeFieldsFile, } from "../core/schema/fields-file.js";
-import { parseItemTypesFile, serializeItemTypesFile, } from "../core/schema/item-types-file.js";
-import { DEFAULT_RUNTIME_SCHEMA_FILE_PATHS, filePathForSchemaSection, normalizeRuntimeSchemaSettings, } from "../core/schema/runtime-schema.js";
-import { parseStatusDefsFile, serializeStatusDefsFile, } from "../core/schema/status-defs-file.js";
-import { normalizeStatusToken } from "../core/schema/status-token.js";
-import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
-import { listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
-import { resolvePmRoot } from "../core/store/paths.js";
-import { readSettings } from "../core/store/settings.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { resolveAuthor } from "../core/shared/author.js";
-import { toErrorMessage } from "../core/shared/primitives.js";
-import { readItemMetadataDerivedIndexState, queryItemMetadataIndex, } from "./item-metadata-index.js";
-import { commitWorkspaceTransaction, } from "./workspace-transaction.js";
-function requiredText(value, field) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new TypeError(`Schema migration ${field} must be non-empty`);
-    }
-    return value.trim();
-}
-function requiredMigrationId(value) {
-    const migrationId = requiredText(value, "migrationId");
-    if (!/^[a-zA-Z0-9._-]+$/.test(migrationId)) {
-        throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");
-    }
-    return migrationId;
-}
-/**
- * Derive a compact idempotency key from the normalized request and workspace
- * scope. The workspace scope prevents unrelated trackers with the same schema
- * change from sharing recovery identity in orchestration systems.
- */
-export function deriveSchemaEvolutionMigrationId(requestInput, migrationScope) {
-    const request = normalizedRequest(requestInput);
-    const scope = requiredText(migrationScope, "migrationScope");
-    return `auto-${createHash("sha256")
-        .update(JSON.stringify({ scope, request }))
-        .digest("hex")
-        .slice(0, 20)}`;
-}
-function normalizedRequest(request) {
-    const normalized = request.kind === "rename-type"
-        ? {
-            kind: request.kind,
-            from: requiredText(request.from, "source"),
-            to: requiredText(request.to, "target"),
-        }
-        : request.kind === "rename-field"
-            ? {
-                kind: request.kind,
-                from: normalizeStatusToken(requiredText(request.from, "source")),
-                to: normalizeStatusToken(requiredText(request.to, "target")),
-                ...(request.type === undefined
-                    ? {}
-                    : { type: requiredText(request.type, "type") }),
-            }
-            : {
-                kind: request.kind,
-                from: normalizeStatusToken(requiredText(request.from, "source")),
-                to: normalizeStatusToken(requiredText(request.to, "target")),
-            };
-    if (normalized.from.toLowerCase() === normalized.to.toLowerCase()) {
-        throw new TypeError("Schema migration source and target must differ");
-    }
-    return normalized;
-}
-function schemaSectionFor(request) {
-    return request.kind === "rename-type"
-        ? "types"
-        : request.kind === "rename-field"
-            ? "fields"
-            : "statuses";
-}
-function schemaPathFor(pmRoot, settings, request) {
-    const schema = normalizeRuntimeSchemaSettings(settings.schema);
-    const section = schemaSectionFor(request);
-    return filePathForSchemaSection(pmRoot, schema.files[section], DEFAULT_RUNTIME_SCHEMA_FILE_PATHS[section]);
-}
-function planStoragePath(pmRoot, migrationId) {
-    return path.join(pmRoot, "transactions", "schema", `${migrationId}-plan.json`);
-}
-function parseSchemaAuditValue(raw) {
-    return raw.length === 0 ? null : JSON.parse(raw);
-}
-async function readSchemaFileSnapshot(filePath) {
-    const raw = await readFileIfExists(filePath);
-    return { exists: raw !== null, raw: raw ?? "" };
-}
-async function restoreSchemaFileSnapshot(filePath, snapshot) {
-    if (snapshot.exists) {
-        await writeFileAtomic(filePath, snapshot.raw);
-    }
-    else {
-        await fs.rm(filePath, { force: true });
-    }
-}
-function mutateTypeDefinition(raw, request, phase) {
-    const file = parseItemTypesFile(raw);
-    const sourceIndex = file.definitions.findIndex((definition) => definition.name.trim().toLowerCase() === request.from.toLowerCase());
-    const targetIndex = file.definitions.findIndex((definition) => definition.name.trim().toLowerCase() === request.to.toLowerCase());
-    if (phase === "stage") {
-        if (targetIndex >= 0)
-            return serializeItemTypesFile(file);
-        if (sourceIndex < 0)
-            throw new TypeError(`Unknown custom type "${request.from}".`);
-        file.definitions.push({
-            ...file.definitions[sourceIndex],
-            name: request.to,
-        });
-    }
-    else if (sourceIndex >= 0) {
-        file.definitions.splice(sourceIndex, 1);
-    }
-    return serializeItemTypesFile(file);
-}
-function mutateFieldDefinition(raw, request, phase) {
-    const file = parseFieldsFile(raw);
-    const sourceIndex = file.fields.findIndex((definition) => definition.key === request.from);
-    const targetIndex = file.fields.findIndex((definition) => definition.key === request.to);
-    if (phase === "stage") {
-        if (targetIndex >= 0)
-            return serializeFieldsFile(file);
-        if (sourceIndex < 0)
-            throw new TypeError(`Unknown custom field "${request.from}".`);
-        const source = file.fields[sourceIndex];
-        file.fields.push({
-            ...source,
-            key: request.to,
-            metadata_key: request.to,
-            front_matter_key: request.to,
-            cli_flag: request.to.replaceAll("_", "-"),
-        });
-    }
-    else if (sourceIndex >= 0) {
-        file.fields.splice(sourceIndex, 1);
-    }
-    return serializeFieldsFile(file);
-}
-function mutateStatusDefinition(raw, request, phase) {
-    const file = parseStatusDefsFile(raw);
-    const sourceIndex = file.statuses.findIndex((definition) => definition.id === request.from);
-    const targetIndex = file.statuses.findIndex((definition) => definition.id === request.to);
-    if (phase === "stage") {
-        if (targetIndex >= 0)
-            return serializeStatusDefsFile(file);
-        if (sourceIndex < 0)
-            throw new TypeError(`Unknown custom status "${request.from}".`);
-        file.statuses.push({ ...file.statuses[sourceIndex], id: request.to });
-    }
-    else if (sourceIndex >= 0) {
-        file.statuses.splice(sourceIndex, 1);
-    }
-    return serializeStatusDefsFile(file);
-}
-function mutateSchemaDefinition(raw, request, phase) {
-    return request.kind === "rename-type"
-        ? mutateTypeDefinition(raw, request, phase)
-        : request.kind === "rename-field"
-            ? mutateFieldDefinition(raw, request, phase)
-            : mutateStatusDefinition(raw, request, phase);
-}
-function replaceMatchingToken(value, request) {
-    return typeof value === "string" &&
-        value.trim().toLowerCase() === request.from.toLowerCase()
-        ? request.to
-        : value;
-}
-function objectRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function objectRecordList(value) {
-    return Array.isArray(value)
-        ? value
-            .map((candidate) => objectRecord(candidate))
-            .filter((candidate) => candidate !== undefined)
-        : [];
-}
-function mutateTypeReferences(parsed, request) {
-    for (const field of objectRecordList(parsed.fields)) {
-        if (Array.isArray(field.required_types)) {
-            field.required_types = field.required_types.map((value) => replaceMatchingToken(value, request));
-        }
-    }
-    for (const workflow of objectRecordList(parsed.type_workflows)) {
-        workflow.type = replaceMatchingToken(workflow.type, request);
-    }
-}
-function mutateStatusReferences(parsed, request) {
-    for (const definition of objectRecordList(parsed.definitions)) {
-        definition.default_status = replaceMatchingToken(definition.default_status, request);
-    }
-    const workflow = objectRecord(parsed.workflow);
-    if (workflow) {
-        for (const [key, value] of Object.entries(workflow)) {
-            workflow[key] = replaceMatchingToken(value, request);
-        }
-    }
-    for (const typeWorkflow of objectRecordList(parsed.type_workflows)) {
-        if (Array.isArray(typeWorkflow.allowed_transitions)) {
-            typeWorkflow.allowed_transitions = typeWorkflow.allowed_transitions.map((pair) => Array.isArray(pair)
-                ? pair.map((value) => replaceMatchingToken(value, request))
-                : pair);
-        }
-    }
-}
-function mutateFieldReferences(parsed, request) {
-    for (const definition of objectRecordList(parsed.definitions)) {
-        for (const key of [
-            "required_create_fields",
-            "required_create_repeatables",
-        ]) {
-            if (Array.isArray(definition[key])) {
-                definition[key] = definition[key].map((value) => replaceMatchingToken(value, request));
-            }
-        }
-        for (const key of ["options", "command_option_policies"]) {
-            for (const option of objectRecordList(definition[key])) {
-                const fieldKey = key === "options" ? "key" : "option";
-                option[fieldKey] = replaceMatchingToken(option[fieldKey], request);
-            }
-        }
-    }
-}
-function mutateTemplateReferences(parsed, request) {
-    const options = objectRecord(parsed.options);
-    if (!options)
-        return;
-    if (request.kind === "rename-field") {
-        if (!Object.prototype.hasOwnProperty.call(options, request.from))
-            return;
-        if (Object.prototype.hasOwnProperty.call(options, request.to)) {
-            throw new TypeError(`Schema migration collision in saved template "${String(parsed.name ?? "unknown")}": target field "${request.to}" already exists.`);
-        }
-        options[request.to] = options[request.from];
-        delete options[request.from];
-        return;
-    }
-    const key = request.kind === "rename-type" ? "type" : "status";
-    options[key] = replaceMatchingToken(options[key], request);
-}
-function mutateSchemaReferences(raw, request) {
-    const parsed = JSON.parse(raw);
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        return raw;
-    }
-    const record = parsed;
-    if (request.kind === "rename-type") {
-        mutateTypeReferences(record, request);
-    }
-    else if (request.kind === "rename-field") {
-        mutateFieldReferences(record, request);
-    }
-    else {
-        mutateStatusReferences(record, request);
-    }
-    mutateTemplateReferences(record, request);
-    return `${JSON.stringify(record, null, 2)}\n`;
-}
-function schemaDefinitionState(raw, request) {
-    if (request.kind === "rename-type") {
-        const definitions = parseItemTypesFile(raw).definitions;
-        return {
-            source: definitions.some((entry) => entry.name.trim().toLowerCase() === request.from.toLowerCase()),
-            target: definitions.some((entry) => entry.name.trim().toLowerCase() === request.to.toLowerCase()),
-        };
-    }
-    if (request.kind === "rename-field") {
-        const definitions = parseFieldsFile(raw).fields;
-        return {
-            source: definitions.some((entry) => entry.key === request.from),
-            target: definitions.some((entry) => entry.key === request.to),
-        };
-    }
-    const definitions = parseStatusDefsFile(raw).statuses;
-    return {
-        source: definitions.some((entry) => entry.id === request.from),
-        target: definitions.some((entry) => entry.id === request.to),
-    };
-}
-function changedFieldsForItem(item, request) {
-    const record = item;
-    if (request.kind === "rename-type") {
-        return item.type.toLowerCase() === request.to.toLowerCase() ? [] : ["type"];
-    }
-    if (request.kind === "remap-status") {
-        return item.status.toLowerCase() === request.to.toLowerCase()
-            ? []
-            : ["status"];
-    }
-    return Object.prototype.hasOwnProperty.call(record, request.to) &&
-        !Object.prototype.hasOwnProperty.call(record, request.from)
-        ? []
-        : [request.from, request.to];
-}
-function planItem(item, request) {
-    if (request.kind === "rename-type") {
-        return item.type.toLowerCase() === request.from.toLowerCase()
-            ? {
-                id: item.id,
-                changes: [{ field: "type", before: item.type, after: request.to }],
-            }
-            : null;
-    }
-    if (request.kind === "remap-status") {
-        return item.status.toLowerCase() === request.from.toLowerCase()
-            ? {
-                id: item.id,
-                changes: [
-                    { field: "status", before: item.status, after: request.to },
-                ],
-            }
-            : null;
-    }
-    if (request.type !== undefined &&
-        item.type.toLowerCase() !== request.type.toLowerCase()) {
-        return null;
-    }
-    const record = item;
-    if (!Object.prototype.hasOwnProperty.call(record, request.from)) {
-        return null;
-    }
-    if (Object.prototype.hasOwnProperty.call(record, request.to)) {
-        throw new TypeError(`Schema migration collision on item "${item.id}": target field "${request.to}" already exists.`);
-    }
-    return {
-        id: item.id,
-        changes: [
-            { field: request.from, before: record[request.from], after: undefined },
-            { field: request.to, before: undefined, after: record[request.from] },
-        ],
-    };
-}
-/**
- * Build a deterministic schema evolution plan without touching storage. Input
- * order never affects the fingerprint or item order. Completed ids filter only
- * the pending window, leaving complete-plan identity stable across retries.
- */
-export function planSchemaEvolutionMigration(items, options) {
-    const request = normalizedRequest(options.request);
-    const migrationId = options.migrationId === undefined
-        ? deriveSchemaEvolutionMigrationId(request, options.migrationScope ?? "plan")
-        : requiredMigrationId(options.migrationId);
-    const completeItems = items
-        .map((item) => planItem(item, request))
-        .filter((entry) => entry !== null)
-        .sort((left, right) => left.id.localeCompare(right.id));
-    const fingerprint = createHash("sha256")
-        .update(JSON.stringify({ migrationId, request, items: completeItems }))
-        .digest("hex");
-    const completed = new Set([...(options.completedItemIds ?? [])]
-        .map((id) => id.trim())
-        .filter((id) => id.length > 0));
-    const pendingItems = completeItems.filter((entry) => !completed.has(entry.id));
-    return Object.freeze({
-        migration_id: migrationId,
-        request,
-        fingerprint,
-        affected_item_count: completeItems.length,
-        pending_item_count: pendingItems.length,
-        skipped_completed_count: completeItems.length - pendingItems.length,
-        items: Object.freeze(pendingItems),
-    });
-}
-async function candidateItems(params) {
-    const typeRegistry = resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations());
-    const folders = [...new Set(Object.values(typeRegistry.type_to_folder))];
-    const indexState = await readItemMetadataDerivedIndexState(params.pmRoot, folders);
-    const query = params.request.kind === "rename-type"
-        ? { types: [params.request.from] }
-        : params.request.kind === "remap-status"
-            ? { statuses: [params.request.from] }
-            : {
-                metadataKeys: [params.request.from],
-                ...(params.request.type === undefined
-                    ? {}
-                    : { types: [params.request.type] }),
-            };
-    const indexed = indexState
-        ? await queryItemMetadataIndex({
-            pmRoot: params.pmRoot,
-            expectedSourceCursor: indexState.source_cursor,
-            query,
-        })
-        : null;
-    if (indexed) {
-        return {
-            items: indexed.items,
-            selectionSource: "derived_index",
-            typeToFolder: typeRegistry.type_to_folder,
-        };
-    }
-    return {
-        items: await listAllItemMetadataLight(params.pmRoot, params.settings.item_format, typeRegistry.type_to_folder, [], params.settings.schema),
-        selectionSource: "scan",
-        typeToFolder: typeRegistry.type_to_folder,
-    };
-}
-async function readStoredPlan(pmRoot, migrationId) {
-    const raw = await readFileIfExists(planStoragePath(pmRoot, migrationId));
-    if (raw === null)
-        return null;
-    try {
-        const stored = JSON.parse(raw);
-        if (stored.schema_version !== 1 ||
-            stored.plan.migration_id !== migrationId ||
-            !Array.isArray(stored.plan.items)) {
-            throw new TypeError("invalid plan envelope");
-        }
-        return stored.plan;
-    }
-    catch (error) {
-        throw new PmCliError(`Stored schema migration plan "${migrationId}" is invalid: ${toErrorMessage(error)}`, EXIT_CODE.GENERIC_FAILURE);
-    }
-}
-async function writeStoredPlan(pmRoot, plan) {
-    const target = planStoragePath(pmRoot, plan.migration_id);
-    await fs.mkdir(path.dirname(target), { recursive: true });
-    const stored = {
-        schema_version: 1,
-        plan,
-        created_at: new Date().toISOString(),
-    };
-    await writeFileAtomic(target, `${JSON.stringify(stored, null, 2)}\n`);
-}
-function requestsEqual(left, right) {
-    return JSON.stringify(left) === JSON.stringify(right);
-}
-async function readCurrentItem(params) {
-    const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix, params.settings.item_format, params.typeToFolder);
-    if (!located) {
-        throw new PmCliError(`Schema migration item "${params.id}" no longer exists.`, EXIT_CODE.NOT_FOUND);
-    }
-    return (await readLocatedItem(located, { schema: params.settings.schema }))
-        .document.metadata;
-}
-function applyItemRequest(document, request, direction) {
-    const source = direction === "forward" ? request.from : request.to;
-    const target = direction === "forward" ? request.to : request.from;
-    if (request.kind === "rename-type") {
-        if (document.metadata.type.toLowerCase() === target.toLowerCase())
-            return [];
-        if (document.metadata.type.toLowerCase() !== source.toLowerCase()) {
-            throw new TypeError(`Schema migration expected type "${source}" on item "${document.metadata.id}".`);
-        }
-        document.metadata.type = target;
-        return ["type"];
-    }
-    if (request.kind === "remap-status") {
-        if (document.metadata.status.toLowerCase() === target.toLowerCase())
-            return [];
-        if (document.metadata.status.toLowerCase() !== source.toLowerCase()) {
-            throw new TypeError(`Schema migration expected status "${source}" on item "${document.metadata.id}".`);
-        }
-        document.metadata.status = target;
-        return ["status"];
-    }
-    const record = document.metadata;
-    if (Object.prototype.hasOwnProperty.call(record, target) &&
-        !Object.prototype.hasOwnProperty.call(record, source)) {
-        return [];
-    }
-    if (!Object.prototype.hasOwnProperty.call(record, source) ||
-        Object.prototype.hasOwnProperty.call(record, target)) {
-        throw new TypeError(`Schema migration field state changed concurrently on item "${document.metadata.id}".`);
-    }
-    record[target] = record[source];
-    delete record[source];
-    return [source, target];
-}
-function schemaStep(params) {
-    return {
-        id: params.id,
-        inspect: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            const state = schemaDefinitionState(snapshot.raw, params.request);
-            const applied = params.phase === "stage"
-                ? state.source && state.target
-                : !state.source && state.target;
-            return {
-                state: applied ? "applied" : "pending",
-                ...(applied ? { result: { phase: params.phase } } : {}),
-            };
-        },
-        prepareCompensation: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            return { exists: snapshot.exists, raw: snapshot.raw };
-        },
-        apply: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            await writeFileAtomic(params.filePath, mutateSchemaDefinition(snapshot.raw, params.request, params.phase));
-            return { phase: params.phase };
-        },
-        compensate: async (data) => {
-            if (typeof data !== "object" ||
-                data === null ||
-                Array.isArray(data) ||
-                typeof data.exists !== "boolean" ||
-                typeof data.raw !== "string") {
-                throw new TypeError(`Missing schema snapshot for ${params.id} compensation.`);
-            }
-            await restoreSchemaFileSnapshot(params.filePath, {
-                exists: data.exists,
-                raw: data.raw,
-            });
-        },
-    };
-}
-function schemaReferenceStep(params) {
-    return {
-        id: params.stepId,
-        inspect: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            return {
-                state: mutateSchemaReferences(snapshot.raw, params.request) === snapshot.raw
-                    ? "applied"
-                    : "pending",
-            };
-        },
-        prepareCompensation: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            return { exists: snapshot.exists, raw: snapshot.raw };
-        },
-        apply: async () => {
-            const snapshot = await readSchemaFileSnapshot(params.filePath);
-            await writeFileAtomic(params.filePath, mutateSchemaReferences(snapshot.raw, params.request));
-            return { file: params.filePath };
-        },
-        compensate: async (data) => {
-            if (typeof data !== "object" ||
-                data === null ||
-                Array.isArray(data) ||
-                typeof data.exists !== "boolean" ||
-                typeof data.raw !== "string") {
-                throw new TypeError(`Missing schema reference snapshot for ${params.stepId} compensation.`);
-            }
-            await restoreSchemaFileSnapshot(params.filePath, {
-                exists: data.exists,
-                raw: data.raw,
-            });
-        },
-    };
-}
-function itemStep(params) {
-    return {
-        id: `item-${params.id}`,
-        inspect: async () => {
-            const settings = await readSettings(params.pmRoot);
-            const typeToFolder = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations()).type_to_folder;
-            const item = await readCurrentItem({
-                pmRoot: params.pmRoot,
-                settings,
-                typeToFolder,
-                id: params.id,
-            });
-            const applied = changedFieldsForItem(item, params.request).length === 0;
-            return {
-                state: applied ? "applied" : "pending",
-                ...(applied ? { result: { item_id: params.id } } : {}),
-            };
-        },
-        apply: async () => {
-            const settings = await readSettings(params.pmRoot);
-            const typeToFolder = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations()).type_to_folder;
-            const result = await mutateItem({
-                pmRoot: params.pmRoot,
-                settings,
-                typeToFolder,
-                id: params.id,
-                op: `schema_${params.request.kind.replaceAll("-", "_")}`,
-                author: params.author,
-                message: `Schema migration ${params.request.kind}: ${params.request.from} -> ${params.request.to}`,
-                force: params.force,
-                skipNoop: true,
-                mutate(document) {
-                    return {
-                        changedFields: applyItemRequest(document, params.request, "forward"),
-                    };
-                },
-            });
-            return {
-                item_id: params.id,
-                changed_fields: result.changedFields,
-            };
-        },
-        compensate: async () => {
-            const settings = await readSettings(params.pmRoot);
-            const typeToFolder = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations()).type_to_folder;
-            await mutateItem({
-                pmRoot: params.pmRoot,
-                settings,
-                typeToFolder,
-                id: params.id,
-                op: `schema_${params.request.kind.replaceAll("-", "_")}_compensate`,
-                author: params.author,
-                message: `Compensate schema migration ${params.request.kind}: ${params.request.to} -> ${params.request.from}`,
-                force: true,
-                skipNoop: true,
-                mutate(document) {
-                    return {
-                        changedFields: applyItemRequest(document, params.request, "reverse"),
-                    };
-                },
-            });
-        },
-    };
-}
-async function resolveMigrationPlan(params) {
-    const storedPlan = await readStoredPlan(params.pmRoot, params.migrationId);
-    if (storedPlan) {
-        if (!requestsEqual(storedPlan.request, params.request)) {
-            throw new PmCliError(`Schema migration id "${params.migrationId}" already belongs to a different request.`, EXIT_CODE.CONFLICT);
-        }
-        return { plan: storedPlan, stored: true };
-    }
-    const candidates = await candidateItems({
-        pmRoot: params.pmRoot,
-        settings: params.settings,
-        request: params.request,
-    });
-    return {
-        plan: {
-            ...planSchemaEvolutionMigration(candidates.items, {
-                migrationId: params.migrationId,
-                request: params.request,
-            }),
-            selection_source: candidates.selectionSource,
-        },
-        stored: false,
-    };
-}
-async function validateAndStoreMigrationPlan(params) {
-    const definitionState = schemaDefinitionState((await readFileIfExists(params.schemaPath)) ?? "", params.request);
-    if (!definitionState.source) {
-        throw new PmCliError(`Schema migration source "${params.request.from}" is not a custom definition.`, EXIT_CODE.NOT_FOUND);
-    }
-    if (definitionState.target) {
-        throw new PmCliError(`Schema migration target "${params.request.to}" already exists.`, EXIT_CODE.CONFLICT);
-    }
-    await writeStoredPlan(params.pmRoot, params.plan);
-}
-async function collectSchemaReferenceState(params) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(params.settings.schema);
-    const paths = [
-        ...new Set([
-            ["types", DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types],
-            ["fields", DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields],
-            ["workflows", DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows],
-        ]
-            .map(([section, fallback]) => filePathForSchemaSection(params.pmRoot, normalizedSchema.files[section], fallback))
-            .filter((filePath) => filePath !== params.schemaPath)),
-    ];
-    try {
-        const templatesPath = path.join(params.pmRoot, "templates");
-        const templateEntries = await fs.readdir(templatesPath, {
-            withFileTypes: true,
-        });
-        paths.push(...templateEntries
-            .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".json"))
-            .map((entry) => path.join(templatesPath, entry.name)));
-    }
-    catch (error) {
-        if (typeof error !== "object" ||
-            error === null ||
-            !("code" in error) ||
-            !isFileMissingError(error)) {
-            throw error;
-        }
-    }
-    paths.sort((left, right) => left.localeCompare(right));
-    const snapshots = [];
-    for (const filePath of paths) {
-        const beforeRaw = await readFileIfExists(filePath);
-        if (beforeRaw !== null &&
-            mutateSchemaReferences(beforeRaw, params.request) !== beforeRaw) {
-            snapshots.push({ filePath, beforeRaw });
-        }
-    }
-    return { paths, snapshots };
-}
-async function appendSchemaReferenceHistory(params) {
-    for (const reference of params.snapshots) {
-        const afterRaw = await fs.readFile(reference.filePath, "utf8");
-        const relativePath = path
-            .relative(params.pmRoot, reference.filePath)
-            .replaceAll("\\", "/");
-        await appendWorkspaceHistoryChange({
-            pmRoot: params.pmRoot,
-            author: params.author,
-            documentPath: relativePath,
-            before: parseSchemaAuditValue(reference.beforeRaw),
-            after: parseSchemaAuditValue(afterRaw),
-            op: "schema_migration_reference",
-            idempotencyKey: `${params.plan.migration_id}:${params.plan.fingerprint}:${relativePath}`,
-            message: `${params.request.kind}: ${params.request.from} -> ${params.request.to}`,
-            lockTtlSeconds: params.settings.locks.ttl_seconds,
-            lockWaitMs: params.settings.locks.wait_ms,
-        });
-    }
-}
-/**
- * Plan or execute one lossless schema evolution. The complete plan is persisted
- * before writes and reused verbatim after interruptions. Execution stages the
- * target definition, mutates each item through the canonical item store, then
- * retires the source definition in one crash-recoverable transaction.
- */
-export async function runSchemaEvolutionMigration(requestInput, options, global) {
-    const request = normalizedRequest(requestInput);
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const migrationId = options.migrationId === undefined
-        ? deriveSchemaEvolutionMigrationId(request, await fs.realpath(pmRoot))
-        : requiredMigrationId(options.migrationId);
-    const settings = await readSettings(pmRoot);
-    const author = resolveAuthor(options.author, settings.author_default);
-    const resolvedPlan = await resolveMigrationPlan({
-        pmRoot,
-        settings,
-        migrationId,
-        request,
-    });
-    const plan = resolvedPlan.plan;
-    if (options.dryRun === true) {
-        return {
-            ...plan,
-            action: request.kind,
-            applied: false,
-            recovered: false,
-            migrated_item_count: 0,
-        };
-    }
-    const schemaPath = schemaPathFor(pmRoot, settings, request);
-    const schemaBefore = await fs.readFile(schemaPath, "utf8");
-    if (!resolvedPlan.stored) {
-        await validateAndStoreMigrationPlan({
-            pmRoot,
-            schemaPath,
-            request,
-            plan,
-        });
-    }
-    const references = await collectSchemaReferenceState({
-        pmRoot,
-        schemaPath,
-        settings,
-        request,
-    });
-    const steps = [
-        schemaStep({
-            id: "stage-schema",
-            filePath: schemaPath,
-            request,
-            phase: "stage",
-        }),
-        ...references.paths.map((filePath, index) => schemaReferenceStep({
-            filePath,
-            request,
-            stepId: `reference-${String(index + 1).padStart(4, "0")}`,
-        })),
-        ...plan.items.map((entry) => itemStep({
-            pmRoot,
-            id: entry.id,
-            request,
-            author,
-            force: options.force === true,
-        })),
-        schemaStep({
-            id: "retire-source",
-            filePath: schemaPath,
-            request,
-            phase: "retire",
-        }),
-    ];
-    const committed = await commitWorkspaceTransaction({
-        pmRoot,
-        transactionId: `schema-${migrationId}`,
-        author,
-        steps,
-        lockTtlSeconds: Math.max(settings.locks.ttl_seconds, 300),
-        lockWaitMs: settings.locks.wait_ms,
-    });
-    const schemaAfter = await fs.readFile(schemaPath, "utf8");
-    const { historyPath } = await appendWorkspaceHistoryChange({
-        pmRoot,
-        author,
-        documentPath: path.relative(pmRoot, schemaPath).replaceAll("\\", "/"),
-        before: parseSchemaAuditValue(schemaBefore),
-        after: parseSchemaAuditValue(schemaAfter),
-        op: "schema_migration",
-        idempotencyKey: `${plan.migration_id}:${plan.fingerprint}`,
-        message: `${request.kind}: ${request.from} -> ${request.to}; affected=${plan.affected_item_count}`,
-        lockTtlSeconds: settings.locks.ttl_seconds,
-        lockWaitMs: settings.locks.wait_ms,
-    });
-    await appendSchemaReferenceHistory({
-        pmRoot,
-        author,
-        settings,
-        request,
-        plan,
-        snapshots: references.snapshots,
-    });
-    return {
-        ...plan,
-        action: request.kind,
-        applied: true,
-        recovered: committed.recovered,
-        migrated_item_count: plan.affected_item_count,
-        workspace_history_path: historyPath,
-    };
-}
-/** Render a compact human summary for a schema migration plan or execution. */
-export function formatSchemaEvolutionMigrationHuman(result) {
-    const mode = result.applied ? "applied" : "dry-run";
-    const recovery = result.recovered ? " (recovered)" : "";
-    return [
-        `${result.action}: ${result.request.from} -> ${result.request.to} [${mode}${recovery}]`,
-        `migration_id: ${result.migration_id}`,
-        `affected: ${result.affected_item_count}`,
-        `pending: ${result.pending_item_count}`,
-        `fingerprint: ${result.fingerprint}`,
-    ].join("\n");
-}
-/** Internal pure helpers exposed only for exhaustive behavioral unit tests. */
-export const schemaMigrationTestOnly = {
-    normalizedRequest,
-    parseSchemaAuditValue,
-    readSchemaFileSnapshot,
-    mutateSchemaDefinition,
-    mutateSchemaReferences,
-    changedFieldsForItem,
-    applyItemRequest,
-    schemaStep,
-    schemaReferenceStep,
-    validateAndStoreMigrationPlan,
-};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9052af10-ff8c-55db-8a35-b45e1e23a901")}catch(e2){}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import{createHash}from"node:crypto";import fs from"node:fs/promises";import path from"node:path";import{isFileMissingError,readFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{appendWorkspaceHistoryChange}from"../core/history/workspace-history.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{parseFieldsFile,serializeFieldsFile}from"../core/schema/fields-file.js";import{parseItemTypesFile,serializeItemTypesFile}from"../core/schema/item-types-file.js";import{DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,filePathForSchemaSection,normalizeRuntimeSchemaSettings}from"../core/schema/runtime-schema.js";import{parseStatusDefsFile,serializeStatusDefsFile}from"../core/schema/status-defs-file.js";import{normalizeStatusToken}from"../core/schema/status-token.js";import{getActiveExtensionRegistrations}from"../core/extensions/index.js";import{listAllItemMetadataLight,locateItem,mutateItem,readLocatedItem}from"../core/store/item-store.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveAuthor}from"../core/shared/author.js";import{toErrorMessage}from"../core/shared/primitives.js";import{readItemMetadataDerivedIndexState,queryItemMetadataIndex}from"./item-metadata-index.js";import{commitWorkspaceTransaction}from"./workspace-transaction.js";function requiredText(value,field){if(typeof value!=="string"||value.trim().length===0){throw new TypeError(`Schema migration ${field} must be non-empty`)}return value.trim()}function requiredMigrationId(value){const migrationId=requiredText(value,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(migrationId)){throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+")}return migrationId}function deriveSchemaEvolutionMigrationId(requestInput,migrationScope){const request=normalizedRequest(requestInput);const scope=requiredText(migrationScope,"migrationScope");return`auto-${createHash("sha256").update(JSON.stringify({scope,request})).digest("hex").slice(0,20)}`}function normalizedRequest(request){const normalized=request.kind==="rename-type"?{kind:request.kind,from:requiredText(request.from,"source"),to:requiredText(request.to,"target")}:request.kind==="rename-field"?{kind:request.kind,from:normalizeStatusToken(requiredText(request.from,"source")),to:normalizeStatusToken(requiredText(request.to,"target")),...request.type===void 0?{}:{type:requiredText(request.type,"type")}}:{kind:request.kind,from:normalizeStatusToken(requiredText(request.from,"source")),to:normalizeStatusToken(requiredText(request.to,"target"))};if(normalized.from.toLowerCase()===normalized.to.toLowerCase()){throw new TypeError("Schema migration source and target must differ")}return normalized}function schemaSectionFor(request){return request.kind==="rename-type"?"types":request.kind==="rename-field"?"fields":"statuses"}function schemaPathFor(pmRoot,settings,request){const schema=normalizeRuntimeSchemaSettings(settings.schema);const section=schemaSectionFor(request);return filePathForSchemaSection(pmRoot,schema.files[section],DEFAULT_RUNTIME_SCHEMA_FILE_PATHS[section])}function planStoragePath(pmRoot,migrationId){return path.join(pmRoot,"transactions","schema",`${migrationId}-plan.json`)}function parseSchemaAuditValue(raw){return raw.length===0?null:JSON.parse(raw)}async function readSchemaFileSnapshot(filePath){const raw=await readFileIfExists(filePath);return{exists:raw!==null,raw:raw??""}}async function restoreSchemaFileSnapshot(filePath,snapshot){if(snapshot.exists){await writeFileAtomic(filePath,snapshot.raw)}else{await fs.rm(filePath,{force:true})}}function mutateTypeDefinition(raw,request,phase){const file=parseItemTypesFile(raw);const sourceIndex=file.definitions.findIndex(definition=>definition.name.trim().toLowerCase()===request.from.toLowerCase());const targetIndex=file.definitions.findIndex(definition=>definition.name.trim().toLowerCase()===request.to.toLowerCase());if(phase==="stage"){if(targetIndex>=0)return serializeItemTypesFile(file);if(sourceIndex<0)throw new TypeError(`Unknown custom type "${request.from}".`);file.definitions.push({...file.definitions[sourceIndex],name:request.to})}else if(sourceIndex>=0){file.definitions.splice(sourceIndex,1)}return serializeItemTypesFile(file)}function mutateFieldDefinition(raw,request,phase){const file=parseFieldsFile(raw);const sourceIndex=file.fields.findIndex(definition=>definition.key===request.from);const targetIndex=file.fields.findIndex(definition=>definition.key===request.to);if(phase==="stage"){if(targetIndex>=0)return serializeFieldsFile(file);if(sourceIndex<0)throw new TypeError(`Unknown custom field "${request.from}".`);const source=file.fields[sourceIndex];file.fields.push({...source,key:request.to,metadata_key:request.to,front_matter_key:request.to,cli_flag:request.to.replaceAll("_","-")})}else if(sourceIndex>=0){file.fields.splice(sourceIndex,1)}return serializeFieldsFile(file)}function mutateStatusDefinition(raw,request,phase){const file=parseStatusDefsFile(raw);const sourceIndex=file.statuses.findIndex(definition=>definition.id===request.from);const targetIndex=file.statuses.findIndex(definition=>definition.id===request.to);if(phase==="stage"){if(targetIndex>=0)return serializeStatusDefsFile(file);if(sourceIndex<0)throw new TypeError(`Unknown custom status "${request.from}".`);file.statuses.push({...file.statuses[sourceIndex],id:request.to})}else if(sourceIndex>=0){file.statuses.splice(sourceIndex,1)}return serializeStatusDefsFile(file)}function mutateSchemaDefinition(raw,request,phase){return request.kind==="rename-type"?mutateTypeDefinition(raw,request,phase):request.kind==="rename-field"?mutateFieldDefinition(raw,request,phase):mutateStatusDefinition(raw,request,phase)}function replaceMatchingToken(value,request){return typeof value==="string"&&value.trim().toLowerCase()===request.from.toLowerCase()?request.to:value}function objectRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)?value:void 0}function objectRecordList(value){return Array.isArray(value)?value.map(candidate=>objectRecord(candidate)).filter(candidate=>candidate!==void 0):[]}function mutateTypeReferences(parsed,request){for(const field of objectRecordList(parsed.fields)){if(Array.isArray(field.required_types)){field.required_types=field.required_types.map(value=>replaceMatchingToken(value,request))}}for(const workflow of objectRecordList(parsed.type_workflows)){workflow.type=replaceMatchingToken(workflow.type,request)}}function mutateStatusReferences(parsed,request){for(const definition of objectRecordList(parsed.definitions)){definition.default_status=replaceMatchingToken(definition.default_status,request)}const workflow=objectRecord(parsed.workflow);if(workflow){for(const[key,value]of Object.entries(workflow)){workflow[key]=replaceMatchingToken(value,request)}}for(const typeWorkflow of objectRecordList(parsed.type_workflows)){if(Array.isArray(typeWorkflow.allowed_transitions)){typeWorkflow.allowed_transitions=typeWorkflow.allowed_transitions.map(pair=>Array.isArray(pair)?pair.map(value=>replaceMatchingToken(value,request)):pair)}}}function mutateFieldReferences(parsed,request){for(const definition of objectRecordList(parsed.definitions)){for(const key of["required_create_fields","required_create_repeatables"]){if(Array.isArray(definition[key])){definition[key]=definition[key].map(value=>replaceMatchingToken(value,request))}}for(const key of["options","command_option_policies"]){for(const option of objectRecordList(definition[key])){const fieldKey=key==="options"?"key":"option";option[fieldKey]=replaceMatchingToken(option[fieldKey],request)}}}}function mutateTemplateReferences(parsed,request){const options=objectRecord(parsed.options);if(!options)return;if(request.kind==="rename-field"){if(!Object.prototype.hasOwnProperty.call(options,request.from))return;if(Object.prototype.hasOwnProperty.call(options,request.to)){throw new TypeError(`Schema migration collision in saved template "${String(parsed.name??"unknown")}": target field "${request.to}" already exists.`)}options[request.to]=options[request.from];delete options[request.from];return}const key=request.kind==="rename-type"?"type":"status";options[key]=replaceMatchingToken(options[key],request)}function mutateSchemaReferences(raw,request){const parsed=JSON.parse(raw);if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return raw}const record=parsed;if(request.kind==="rename-type"){mutateTypeReferences(record,request)}else if(request.kind==="rename-field"){mutateFieldReferences(record,request)}else{mutateStatusReferences(record,request)}mutateTemplateReferences(record,request);return`${JSON.stringify(record,null,2)}
+`}function schemaDefinitionState(raw,request){if(request.kind==="rename-type"){const definitions2=parseItemTypesFile(raw).definitions;return{source:definitions2.some(entry=>entry.name.trim().toLowerCase()===request.from.toLowerCase()),target:definitions2.some(entry=>entry.name.trim().toLowerCase()===request.to.toLowerCase())}}if(request.kind==="rename-field"){const definitions2=parseFieldsFile(raw).fields;return{source:definitions2.some(entry=>entry.key===request.from),target:definitions2.some(entry=>entry.key===request.to)}}const definitions=parseStatusDefsFile(raw).statuses;return{source:definitions.some(entry=>entry.id===request.from),target:definitions.some(entry=>entry.id===request.to)}}function changedFieldsForItem(item,request){const record=item;if(request.kind==="rename-type"){return item.type.toLowerCase()===request.to.toLowerCase()?[]:["type"]}if(request.kind==="remap-status"){return item.status.toLowerCase()===request.to.toLowerCase()?[]:["status"]}return Object.prototype.hasOwnProperty.call(record,request.to)&&!Object.prototype.hasOwnProperty.call(record,request.from)?[]:[request.from,request.to]}function planItem(item,request){if(request.kind==="rename-type"){return item.type.toLowerCase()===request.from.toLowerCase()?{id:item.id,changes:[{field:"type",before:item.type,after:request.to}]}:null}if(request.kind==="remap-status"){return item.status.toLowerCase()===request.from.toLowerCase()?{id:item.id,changes:[{field:"status",before:item.status,after:request.to}]}:null}if(request.type!==void 0&&item.type.toLowerCase()!==request.type.toLowerCase()){return null}const record=item;if(!Object.prototype.hasOwnProperty.call(record,request.from)){return null}if(Object.prototype.hasOwnProperty.call(record,request.to)){throw new TypeError(`Schema migration collision on item "${item.id}": target field "${request.to}" already exists.`)}return{id:item.id,changes:[{field:request.from,before:record[request.from],after:void 0},{field:request.to,before:void 0,after:record[request.from]}]}}function planSchemaEvolutionMigration(items,options){const request=normalizedRequest(options.request);const migrationId=options.migrationId===void 0?deriveSchemaEvolutionMigrationId(request,options.migrationScope??"plan"):requiredMigrationId(options.migrationId);const completeItems=items.map(item=>planItem(item,request)).filter(entry=>entry!==null).sort((left,right)=>left.id.localeCompare(right.id));const fingerprint=createHash("sha256").update(JSON.stringify({migrationId,request,items:completeItems})).digest("hex");const completed=new Set([...options.completedItemIds??[]].map(id=>id.trim()).filter(id=>id.length>0));const pendingItems=completeItems.filter(entry=>!completed.has(entry.id));return Object.freeze({migration_id:migrationId,request,fingerprint,affected_item_count:completeItems.length,pending_item_count:pendingItems.length,skipped_completed_count:completeItems.length-pendingItems.length,items:Object.freeze(pendingItems)})}async function candidateItems(params){const typeRegistry=resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations());const folders=[...new Set(Object.values(typeRegistry.type_to_folder))];const indexState=await readItemMetadataDerivedIndexState(params.pmRoot,folders);const query=params.request.kind==="rename-type"?{types:[params.request.from]}:params.request.kind==="remap-status"?{statuses:[params.request.from]}:{metadataKeys:[params.request.from],...params.request.type===void 0?{}:{types:[params.request.type]}};const indexed=indexState?await queryItemMetadataIndex({pmRoot:params.pmRoot,expectedSourceCursor:indexState.source_cursor,query}):null;if(indexed){return{items:indexed.items,selectionSource:"derived_index",typeToFolder:typeRegistry.type_to_folder}}return{items:await listAllItemMetadataLight(params.pmRoot,params.settings.item_format,typeRegistry.type_to_folder,[],params.settings.schema),selectionSource:"scan",typeToFolder:typeRegistry.type_to_folder}}async function readStoredPlan(pmRoot,migrationId){const raw=await readFileIfExists(planStoragePath(pmRoot,migrationId));if(raw===null)return null;try{const stored=JSON.parse(raw);if(stored.schema_version!==1||stored.plan.migration_id!==migrationId||!Array.isArray(stored.plan.items)){throw new TypeError("invalid plan envelope")}return stored.plan}catch(error){throw new PmCliError(`Stored schema migration plan "${migrationId}" is invalid: ${toErrorMessage(error)}`,EXIT_CODE.GENERIC_FAILURE)}}async function writeStoredPlan(pmRoot,plan){const target=planStoragePath(pmRoot,plan.migration_id);await fs.mkdir(path.dirname(target),{recursive:true});const stored={schema_version:1,plan,created_at:new Date().toISOString()};await writeFileAtomic(target,`${JSON.stringify(stored,null,2)}
+`)}function requestsEqual(left,right){return JSON.stringify(left)===JSON.stringify(right)}async function readCurrentItem(params){const located=await locateItem(params.pmRoot,params.id,params.settings.id_prefix,params.settings.item_format,params.typeToFolder);if(!located){throw new PmCliError(`Schema migration item "${params.id}" no longer exists.`,EXIT_CODE.NOT_FOUND)}return(await readLocatedItem(located,{schema:params.settings.schema})).document.metadata}function applyItemRequest(document,request,direction){const source=direction==="forward"?request.from:request.to;const target=direction==="forward"?request.to:request.from;if(request.kind==="rename-type"){if(document.metadata.type.toLowerCase()===target.toLowerCase())return[];if(document.metadata.type.toLowerCase()!==source.toLowerCase()){throw new TypeError(`Schema migration expected type "${source}" on item "${document.metadata.id}".`)}document.metadata.type=target;return["type"]}if(request.kind==="remap-status"){if(document.metadata.status.toLowerCase()===target.toLowerCase())return[];if(document.metadata.status.toLowerCase()!==source.toLowerCase()){throw new TypeError(`Schema migration expected status "${source}" on item "${document.metadata.id}".`)}document.metadata.status=target;return["status"]}const record=document.metadata;if(Object.prototype.hasOwnProperty.call(record,target)&&!Object.prototype.hasOwnProperty.call(record,source)){return[]}if(!Object.prototype.hasOwnProperty.call(record,source)||Object.prototype.hasOwnProperty.call(record,target)){throw new TypeError(`Schema migration field state changed concurrently on item "${document.metadata.id}".`)}record[target]=record[source];delete record[source];return[source,target]}function schemaStep(params){return{id:params.id,inspect:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);const state=schemaDefinitionState(snapshot.raw,params.request);const applied=params.phase==="stage"?state.source&&state.target:!state.source&&state.target;return{state:applied?"applied":"pending",...applied?{result:{phase:params.phase}}:{}}},prepareCompensation:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);return{exists:snapshot.exists,raw:snapshot.raw}},apply:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);await writeFileAtomic(params.filePath,mutateSchemaDefinition(snapshot.raw,params.request,params.phase));return{phase:params.phase}},compensate:async data=>{if(typeof data!=="object"||data===null||Array.isArray(data)||typeof data.exists!=="boolean"||typeof data.raw!=="string"){throw new TypeError(`Missing schema snapshot for ${params.id} compensation.`)}await restoreSchemaFileSnapshot(params.filePath,{exists:data.exists,raw:data.raw})}}}function schemaReferenceStep(params){return{id:params.stepId,inspect:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);return{state:mutateSchemaReferences(snapshot.raw,params.request)===snapshot.raw?"applied":"pending"}},prepareCompensation:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);return{exists:snapshot.exists,raw:snapshot.raw}},apply:async()=>{const snapshot=await readSchemaFileSnapshot(params.filePath);await writeFileAtomic(params.filePath,mutateSchemaReferences(snapshot.raw,params.request));return{file:params.filePath}},compensate:async data=>{if(typeof data!=="object"||data===null||Array.isArray(data)||typeof data.exists!=="boolean"||typeof data.raw!=="string"){throw new TypeError(`Missing schema reference snapshot for ${params.stepId} compensation.`)}await restoreSchemaFileSnapshot(params.filePath,{exists:data.exists,raw:data.raw})}}}function itemStep(params){return{id:`item-${params.id}`,inspect:async()=>{const settings=await readSettings(params.pmRoot);const typeToFolder=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()).type_to_folder;const item=await readCurrentItem({pmRoot:params.pmRoot,settings,typeToFolder,id:params.id});const applied=changedFieldsForItem(item,params.request).length===0;return{state:applied?"applied":"pending",...applied?{result:{item_id:params.id}}:{}}},apply:async()=>{const settings=await readSettings(params.pmRoot);const typeToFolder=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()).type_to_folder;const result=await mutateItem({pmRoot:params.pmRoot,settings,typeToFolder,id:params.id,op:`schema_${params.request.kind.replaceAll("-","_")}`,author:params.author,message:`Schema migration ${params.request.kind}: ${params.request.from} -> ${params.request.to}`,force:params.force,skipNoop:true,mutate(document){return{changedFields:applyItemRequest(document,params.request,"forward")}}});return{item_id:params.id,changed_fields:result.changedFields}},compensate:async()=>{const settings=await readSettings(params.pmRoot);const typeToFolder=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()).type_to_folder;await mutateItem({pmRoot:params.pmRoot,settings,typeToFolder,id:params.id,op:`schema_${params.request.kind.replaceAll("-","_")}_compensate`,author:params.author,message:`Compensate schema migration ${params.request.kind}: ${params.request.to} -> ${params.request.from}`,force:true,skipNoop:true,mutate(document){return{changedFields:applyItemRequest(document,params.request,"reverse")}}})}}}async function resolveMigrationPlan(params){const storedPlan=await readStoredPlan(params.pmRoot,params.migrationId);if(storedPlan){if(!requestsEqual(storedPlan.request,params.request)){throw new PmCliError(`Schema migration id "${params.migrationId}" already belongs to a different request.`,EXIT_CODE.CONFLICT)}return{plan:storedPlan,stored:true}}const candidates=await candidateItems({pmRoot:params.pmRoot,settings:params.settings,request:params.request});return{plan:{...planSchemaEvolutionMigration(candidates.items,{migrationId:params.migrationId,request:params.request}),selection_source:candidates.selectionSource},stored:false}}async function validateAndStoreMigrationPlan(params){const definitionState=schemaDefinitionState(await readFileIfExists(params.schemaPath)??"",params.request);if(!definitionState.source){throw new PmCliError(`Schema migration source "${params.request.from}" is not a custom definition.`,EXIT_CODE.NOT_FOUND)}if(definitionState.target){throw new PmCliError(`Schema migration target "${params.request.to}" already exists.`,EXIT_CODE.CONFLICT)}await writeStoredPlan(params.pmRoot,params.plan)}async function collectSchemaReferenceState(params){const normalizedSchema=normalizeRuntimeSchemaSettings(params.settings.schema);const paths=[...new Set([["types",DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types],["fields",DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields],["workflows",DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows]].map(([section,fallback])=>filePathForSchemaSection(params.pmRoot,normalizedSchema.files[section],fallback)).filter(filePath=>filePath!==params.schemaPath))];try{const templatesPath=path.join(params.pmRoot,"templates");const templateEntries=await fs.readdir(templatesPath,{withFileTypes:true});paths.push(...templateEntries.filter(entry=>entry.isFile()&&entry.name.toLowerCase().endsWith(".json")).map(entry=>path.join(templatesPath,entry.name)))}catch(error){if(typeof error!=="object"||error===null||!("code"in error)||!isFileMissingError(error)){throw error}}paths.sort((left,right)=>left.localeCompare(right));const snapshots=[];for(const filePath of paths){const beforeRaw=await readFileIfExists(filePath);if(beforeRaw!==null&&mutateSchemaReferences(beforeRaw,params.request)!==beforeRaw){snapshots.push({filePath,beforeRaw})}}return{paths,snapshots}}async function appendSchemaReferenceHistory(params){for(const reference of params.snapshots){const afterRaw=await fs.readFile(reference.filePath,"utf8");const relativePath=path.relative(params.pmRoot,reference.filePath).replaceAll("\\","/");await appendWorkspaceHistoryChange({pmRoot:params.pmRoot,author:params.author,documentPath:relativePath,before:parseSchemaAuditValue(reference.beforeRaw),after:parseSchemaAuditValue(afterRaw),op:"schema_migration_reference",idempotencyKey:`${params.plan.migration_id}:${params.plan.fingerprint}:${relativePath}`,message:`${params.request.kind}: ${params.request.from} -> ${params.request.to}`,lockTtlSeconds:params.settings.locks.ttl_seconds,lockWaitMs:params.settings.locks.wait_ms})}}async function runSchemaEvolutionMigration(requestInput,options,global2){const request=normalizedRequest(requestInput);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const migrationId=options.migrationId===void 0?deriveSchemaEvolutionMigrationId(request,await fs.realpath(pmRoot)):requiredMigrationId(options.migrationId);const settings=await readSettings(pmRoot);const author=resolveAuthor(options.author,settings.author_default);const resolvedPlan=await resolveMigrationPlan({pmRoot,settings,migrationId,request});const plan=resolvedPlan.plan;if(options.dryRun===true){return{...plan,action:request.kind,applied:false,recovered:false,migrated_item_count:0}}const schemaPath=schemaPathFor(pmRoot,settings,request);const schemaBefore=await fs.readFile(schemaPath,"utf8");if(!resolvedPlan.stored){await validateAndStoreMigrationPlan({pmRoot,schemaPath,request,plan})}const references=await collectSchemaReferenceState({pmRoot,schemaPath,settings,request});const steps=[schemaStep({id:"stage-schema",filePath:schemaPath,request,phase:"stage"}),...references.paths.map((filePath,index)=>schemaReferenceStep({filePath,request,stepId:`reference-${String(index+1).padStart(4,"0")}`})),...plan.items.map(entry=>itemStep({pmRoot,id:entry.id,request,author,force:options.force===true})),schemaStep({id:"retire-source",filePath:schemaPath,request,phase:"retire"})];const committed=await commitWorkspaceTransaction({pmRoot,transactionId:`schema-${migrationId}`,author,steps,lockTtlSeconds:Math.max(settings.locks.ttl_seconds,300),lockWaitMs:settings.locks.wait_ms});const schemaAfter=await fs.readFile(schemaPath,"utf8");const{historyPath}=await appendWorkspaceHistoryChange({pmRoot,author,documentPath:path.relative(pmRoot,schemaPath).replaceAll("\\","/"),before:parseSchemaAuditValue(schemaBefore),after:parseSchemaAuditValue(schemaAfter),op:"schema_migration",idempotencyKey:`${plan.migration_id}:${plan.fingerprint}`,message:`${request.kind}: ${request.from} -> ${request.to}; affected=${plan.affected_item_count}`,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});await appendSchemaReferenceHistory({pmRoot,author,settings,request,plan,snapshots:references.snapshots});return{...plan,action:request.kind,applied:true,recovered:committed.recovered,migrated_item_count:plan.affected_item_count,workspace_history_path:historyPath}}function formatSchemaEvolutionMigrationHuman(result){const mode=result.applied?"applied":"dry-run";const recovery=result.recovered?" (recovered)":"";return[`${result.action}: ${result.request.from} -> ${result.request.to} [${mode}${recovery}]`,`migration_id: ${result.migration_id}`,`affected: ${result.affected_item_count}`,`pending: ${result.pending_item_count}`,`fingerprint: ${result.fingerprint}`].join("\n")}const schemaMigrationTestOnly={normalizedRequest,parseSchemaAuditValue,readSchemaFileSnapshot,mutateSchemaDefinition,mutateSchemaReferences,changedFieldsForItem,applyItemRequest,schemaStep,schemaReferenceStep,validateAndStoreMigrationPlan};export{deriveSchemaEvolutionMigrationId,formatSchemaEvolutionMigrationHuman,planSchemaEvolutionMigration,runSchemaEvolutionMigration,schemaMigrationTestOnly};
 //# sourceMappingURL=schema-migration.js.map
-//# debugId=60738c1f-3b44-5f8a-82c9-99d2b2de1e51