@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/lifecycle/restore.js

@@ -1,331 +1,2 @@
-/**
- * @module sdk/lifecycle/restore
- *
- * Implements the SDK-owned restore lifecycle operation shared by every surface.
- */
-
-!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]="7a3effef-6ba8-51ba-ae99-436d4ef69813")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import jsonPatch from "fast-json-patch";
-import fs from "node:fs/promises";
-import { readLocatedItemSnapshot } from "../../core/store/item-store.js";
-import { historyVersionOffset } from "../../core/history/version-address.js";
-import { pathExists, readFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, replayToCanonicalItemDocument, replayToItemDocument, toReplayDocument, enforceHistoryStreamPolicyForItem, normalizeItemId, normalizeRawItemId, canonicalDocument, serializeItemDocument, resolveItemTypeRegistry, acquireLock, EXIT_CODE, PmCliError, nowIso, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveOnWriteHooks, runActiveBeforeMutationHooks, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
-import { applyHistoryPatch, ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget, extractPatchFailureContext, readHistoryEntries, replayHistoryToTarget as replayToTarget, resolveHistoryTarget, } from "../history-read.js";
-import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../item-metadata-index.js";
-/** Read a restore input without discarding unreadable bytes needed for rollback. */
-async function readRestoreItem(located, settings, history) {
-    const snapshot = await readLocatedItemSnapshot(located, { schema: settings.schema });
-    return snapshot.error === null
-        ? { raw: snapshot.raw, document: snapshot.document }
-        : { raw: snapshot.raw, document: replayCurrentDocument(history), recovered: true };
-}
-/** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
-function ensureReplayTarget(target, history) {
-    return resolveHistoryTarget(target, history, {
-        errorSubject: "restore",
-        allowFutureTimestamp: true,
-    });
-}
-function replayCurrentDocument(history) {
-    const currentReplay = replayToTarget(history, history.length - 1);
-    if (Object.keys(currentReplay.metadata).length === 0) {
-        return {
-            metadata: {},
-            body: currentReplay.body,
-        };
-    }
-    return canonicalDocument(replayToItemDocument(currentReplay));
-}
-async function resolveRestoreSubject(pmRoot, id, settings, typeToFolder) {
-    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);
-    if (located) {
-        const historyPath = getHistoryPath(pmRoot, located.id);
-        const historyPolicy = await enforceHistoryStreamPolicyForItem({
-            pmRoot,
-            settings,
-            itemId: located.id,
-            commandLabel: "restore",
-        });
-        return {
-            id: located.id,
-            historyPath,
-            located,
-            historyPolicyWarnings: historyPolicy.warnings,
-        };
-    }
-    const normalizedId = normalizeItemId(id, settings.id_prefix);
-    const rawNormalizedId = normalizeRawItemId(id);
-    /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */
-    const candidateIds = normalizedId === rawNormalizedId
-        ? [normalizedId]
-        : [normalizedId, rawNormalizedId];
-    /* c8 ignore stop */
-    for (const candidateId of candidateIds) {
-        const historyPath = getHistoryPath(pmRoot, candidateId);
-        if (await pathExists(historyPath)) {
-            return {
-                id: candidateId,
-                historyPath,
-                located: null,
-                historyPolicyWarnings: [],
-            };
-        }
-    }
-    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
-}
-function changedFields(beforeDocument, afterDocument) {
-    const beforeReplay = toReplayDocument(beforeDocument);
-    const afterReplay = toReplayDocument(afterDocument);
-    const patch = jsonPatch.compare(beforeReplay, afterReplay);
-    const fields = new Set();
-    for (const op of patch) {
-        if (op.path === "/body" || op.path.startsWith("/body/")) {
-            fields.add("body");
-            continue;
-        }
-        const segment = op.path
-            .replace(/^\/(?:metadata|front_matter)\/?/, "")
-            .split("/")[0];
-        fields.add(segment.replaceAll("~1", "/").replaceAll("~0", "~"));
-    }
-    return Array.from(fields).sort((a, b) => a.localeCompare(b));
-}
-/** Reload item and history under the caller's lock, refusing changes since the recovery snapshot. */
-async function loadRestoreStateUnderLock(params) {
-    const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);
-    if (historyRawUnderLock !== params.historyRawBeforeLock) {
-        throw new PmCliError(`History for ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);
-    }
-    const locatedUnderLock = await locateItem(params.pmRoot, params.resolvedId, params.settings.id_prefix, params.settings.item_format, params.typeToFolder);
-    const loadedItemUnderLock = locatedUnderLock
-        ? await readRestoreItem(locatedUnderLock, params.settings, params.history)
-        : null;
-    if ((loadedItemUnderLock?.raw ?? null) !== params.currentItemRawBeforeLock) {
-        throw new PmCliError(`Item ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);
-    }
-    return {
-        loadedItemUnderLock,
-        existingItemPath: locatedUnderLock?.itemPath ?? null,
-    };
-}
-function resolveRestoreCurrentState(loadedItemUnderLock, history) {
-    if (loadedItemUnderLock) {
-        return {
-            document: loadedItemUnderLock.document,
-            originalRaw: loadedItemUnderLock.raw,
-        };
-    }
-    return { document: replayCurrentDocument(history), originalRaw: null };
-}
-function collectRestoreOwnershipWarnings(params) {
-    const assigned = params.document.metadata.assignee?.trim();
-    const hasOwnershipConflict = assigned && assigned !== params.author && !params.force;
-    if (!hasOwnershipConflict) {
-        return [];
-    }
-    if (params.enforcement === "strict") {
-        throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
-    }
-    return params.enforcement === "warn"
-        ? [`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]
-        : [];
-}
-async function restorePreviousItemAfterHistoryFailure(params) {
-    if (params.existingItemPath &&
-        params.resolvedOriginalRaw !== null &&
-        params.restoredItemPath !== params.existingItemPath) {
-        await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);
-        await fs.rm(params.restoredItemPath, { force: true });
-        return;
-    }
-    if (params.existingItemPath && params.resolvedOriginalRaw !== null) {
-        await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);
-        return;
-    }
-    await fs.rm(params.restoredItemPath, { force: true });
-}
-async function runRestoreWriteHooks(params) {
-    return [
-        ...(await runActiveOnWriteHooks({
-            path: params.restoredItemPath,
-            scope: "project",
-            op: "restore",
-            item_id: params.after.metadata.id,
-            item_type: params.after.metadata.type,
-            before: params.before,
-            after: params.after,
-            changed_fields: ["restored"],
-        })),
-        ...(await runActiveOnWriteHooks({
-            path: params.historyPath,
-            scope: "project",
-            op: "restore:history",
-            item_id: params.after.metadata.id,
-            item_type: params.after.metadata.type,
-            before: params.before,
-            after: params.after,
-            changed_fields: ["restored"],
-        })),
-    ];
-}
-/** Implements run restore for the public runtime surface of this module. */
-export async function runRestore(id, target, options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);
-    const resolvedId = subject.id;
-    const historyRawBeforeLock = await readFileIfExists(subject.historyPath);
-    const history = await readHistoryEntries(subject.historyPath, resolvedId);
-    if (history.length === 0) {
-        throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);
-    }
-    const resolvedTarget = ensureReplayTarget(target, history);
-    const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);
-    const restoredDocument = replayToCanonicalItemDocument(replayDocument, {
-        schema: settings.schema,
-    });
-    if (restoredDocument.metadata.id !== resolvedId) {
-        throw new PmCliError(`Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`, EXIT_CODE.GENERIC_FAILURE);
-    }
-    const loadedItemBeforeLock = subject.located
-        ? await readRestoreItem(subject.located, settings, history)
-        : null;
-    const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;
-    const author = resolveAuthor(options.author, settings.author_default);
-    const releaseLock = await acquireLock(pmRoot, resolvedId, settings.locks.ttl_seconds, author, Boolean(options.force), settings.governance.force_required_for_stale_lock, settings.locks.wait_ms);
-    try {
-        const { loadedItemUnderLock, existingItemPath } = await loadRestoreStateUnderLock({
-            pmRoot,
-            resolvedId,
-            subject,
-            settings,
-            typeToFolder: typeRegistry.type_to_folder,
-            historyRawBeforeLock,
-            currentItemRawBeforeLock,
-            history,
-        });
-        const itemFormat = "toon";
-        const currentState = resolveRestoreCurrentState(loadedItemUnderLock, history);
-        const ownershipWarnings = collectRestoreOwnershipWarnings({
-            document: currentState.document,
-            author,
-            force: options.force,
-            enforcement: settings.governance.ownership_enforcement,
-            resolvedId,
-        });
-        const restoreChangedFields = changedFields(currentState.document, restoredDocument);
-        await runActiveBeforeMutationHooks({
-            pm_root: pmRoot,
-            operation: "restore",
-            before: currentState.document,
-            after: restoredDocument,
-            changed_fields: restoreChangedFields,
-            sdk: createMutationGuardSdk({
-                pmRoot,
-                settings,
-                typeToFolder: typeRegistry.type_to_folder,
-            }),
-        });
-        const serializedRestore = serializeItemDocument(restoredDocument, {
-            format: itemFormat,
-            schema: settings.schema,
-        });
-        /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */
-        const restoredItemPath = getItemPath(pmRoot, restoredDocument.metadata.type, resolvedId, itemFormat, typeRegistry.type_to_folder);
-        const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(pmRoot, author);
-        let derivedIndexWarnings = [];
-        try {
-            await writeFileAtomic(restoredItemPath, serializedRestore);
-            if (existingItemPath && restoredItemPath !== existingItemPath) {
-                await fs.rm(existingItemPath);
-            }
-            const historyEntry = createHistoryEntry({
-                nowIso: nowIso(),
-                author,
-                op: "restore",
-                before: currentState.document,
-                after: restoredDocument,
-                message: options.message,
-            });
-            try {
-                await appendHistoryEntry(subject.historyPath, historyEntry);
-            }
-            catch (error) {
-                await restorePreviousItemAfterHistoryFailure({
-                    existingItemPath,
-                    resolvedOriginalRaw: currentState.originalRaw,
-                    restoredItemPath,
-                });
-                throw error;
-            }
-            derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
-                pmRoot,
-                preferredFormat: settings.item_format,
-                typeToFolder: typeRegistry.type_to_folder,
-                schema: settings.schema,
-                itemPath: restoredItemPath,
-                previousItemPath: existingItemPath ?? undefined,
-                document: restoredDocument,
-            });
-        }
-        finally {
-            await releaseDerivedIndexLock();
-        }
-        const hookWarnings = await runRestoreWriteHooks({
-            restoredItemPath,
-            historyPath: subject.historyPath,
-            before: currentState.document,
-            after: restoredDocument,
-        });
-        recordAfterCommandAffectedItem({
-            id: restoredDocument.metadata.id,
-            op: "restore",
-            item_type: restoredDocument.metadata.type,
-            previous_status: currentState.document.metadata.status,
-            status: restoredDocument.metadata.status,
-            previous: projectAfterCommandItemSnapshot(currentState.document.metadata, restoreChangedFields),
-            current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),
-            changed_fields: restoreChangedFields,
-        });
-        const targetEntry = history[resolvedTarget.historyIndex];
-        const offset = historyVersionOffset(history, true);
-        return {
-            item: restoredDocument.metadata,
-            restored_from: {
-                kind: resolvedTarget.kind,
-                target: resolvedTarget.raw,
-                history_index: resolvedTarget.historyIndex + 1,
-                version: offset === null ? null : offset + resolvedTarget.historyIndex + 1,
-                entry_ts: targetEntry.ts,
-                entry_op: targetEntry.op,
-            },
-            changed_fields: restoreChangedFields,
-            warnings: [
-                ...(loadedItemUnderLock?.recovered ? ["restore_unreadable_item_recovered"] : []),
-                ...subject.historyPolicyWarnings,
-                ...ownershipWarnings,
-                ...derivedIndexWarnings,
-                ...hookWarnings,
-            ],
-        };
-    }
-    finally {
-        await releaseLock();
-    }
-}
-/** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */
-export const _testOnlyRestoreCommand = {
-    applyHistoryPatch,
-    changedFields,
-    ensureMaterializedRestoreTarget,
-    ensureReplayTarget,
-    extractPatchFailureContext,
-    replayCurrentDocument,
-    replayToTarget,
-    resolveRestoreSubject,
-};
+!(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]="0f22715f-cfb9-5c75-b4c5-e9719416c2b9")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import jsonPatch from"fast-json-patch";import fs from"node:fs/promises";import{readLocatedItemSnapshot}from"../../core/store/item-store.js";import{readHistorySnapshot}from"../../core/history/read.js";import{verifyHistoryRewriteNoDrift}from"../../core/history/history-rewrite.js";import{resolveHistorySubject}from"../history/subject.js";import{historyVersionOffset}from"../../core/history/version-address.js";import{writeFileAtomic,appendHistoryEntry,createHistoryEntry,replayToCanonicalItemDocument,replayToItemDocument,toReplayDocument,enforceHistoryStreamPolicyForItem,canonicalDocument,serializeItemDocument,resolveItemTypeRegistry,acquireLock,EXIT_CODE,PmCliError,nowIso,getActiveExtensionRegistrations,projectAfterCommandItemSnapshot,recordAfterCommandAffectedItem,runActiveOnWriteHooks,runActiveBeforeMutationHooks,createMutationGuardSdk,getItemPath,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{applyHistoryPatch,ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,extractPatchFailureContext,replayHistoryToTarget as replayToTarget,resolveHistoryTarget}from"../history-read.js";import{acquireItemMetadataDerivedIndexLock,refreshItemMetadataDerivedIndex}from"../item-metadata-index.js";async function readRestoreItem(located,settings,history){const snapshot=await readLocatedItemSnapshot(located,{schema:settings.schema});return snapshot.error===null?{raw:snapshot.raw,document:snapshot.document}:{raw:snapshot.raw,document:replayCurrentDocument(history),recovered:true}}function ensureReplayTarget(target,history){return resolveHistoryTarget(target,history,{errorSubject:"restore",allowFutureTimestamp:true})}function replayCurrentDocument(history){const currentReplay=replayToTarget(history,history.length-1);if(Object.keys(currentReplay.metadata).length===0){return{metadata:{},body:currentReplay.body}}return canonicalDocument(replayToItemDocument(currentReplay))}async function resolveRestoreSubject(pmRoot,id,settings,typeToFolder){const subject=await resolveHistorySubject(pmRoot,id,settings,typeToFolder);const historyPolicy=subject.located?await enforceHistoryStreamPolicyForItem({pmRoot,settings,itemId:subject.id,commandLabel:"restore"}):{warnings:[]};return{...subject,historyPolicyWarnings:historyPolicy.warnings}}function changedFields(beforeDocument,afterDocument){const beforeReplay=toReplayDocument(beforeDocument);const afterReplay=toReplayDocument(afterDocument);const patch=jsonPatch.compare(beforeReplay,afterReplay);const fields=new Set;for(const op of patch){if(op.path==="/body"||op.path.startsWith("/body/")){fields.add("body");continue}const segment=op.path.replace(/^\/(?:metadata|front_matter)\/?/,"").split("/")[0];fields.add(segment.replaceAll("~1","/").replaceAll("~0","~"))}return Array.from(fields).sort((a,b)=>a.localeCompare(b))}async function loadRestoreStateUnderLock(params){const verified=await verifyHistoryRewriteNoDrift({pmRoot:params.pmRoot,subject:params.subject,settings:params.settings,typeRegistry:params.typeRegistry,historyRawBeforeLock:params.historyRawBeforeLock,currentItemRawBeforeLock:params.currentItemRawBeforeLock,operation:"restore",readItem:located=>readRestoreItem(located,params.settings,params.history)});return{loadedItemUnderLock:verified.loadedItemUnderLock,existingItemPath:verified.locatedUnderLock?.itemPath??null}}function resolveRestoreCurrentState(loadedItemUnderLock,history){if(loadedItemUnderLock){return{document:loadedItemUnderLock.document,originalRaw:loadedItemUnderLock.raw}}return{document:replayCurrentDocument(history),originalRaw:null}}function collectRestoreOwnershipWarnings(params){const assigned=params.document.metadata.assignee?.trim();const hasOwnershipConflict=assigned&&assigned!==params.author&&!params.force;if(!hasOwnershipConflict){return[]}if(params.enforcement==="strict"){throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`,EXIT_CODE.CONFLICT)}return params.enforcement==="warn"?[`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]:[]}async function restorePreviousItemAfterHistoryFailure(params){if(params.existingItemPath&&params.resolvedOriginalRaw!==null&&params.restoredItemPath!==params.existingItemPath){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);await fs.rm(params.restoredItemPath,{force:true});return}if(params.existingItemPath&&params.resolvedOriginalRaw!==null){await writeFileAtomic(params.existingItemPath,params.resolvedOriginalRaw);return}await fs.rm(params.restoredItemPath,{force:true})}async function runRestoreWriteHooks(params){return[...await runActiveOnWriteHooks({path:params.restoredItemPath,scope:"project",op:"restore",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]}),...await runActiveOnWriteHooks({path:params.historyPath,scope:"project",op:"restore:history",item_id:params.after.metadata.id,item_type:params.after.metadata.type,before:params.before,after:params.after,changed_fields:["restored"]})]}async function runRestore(id,target,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const subject=await resolveRestoreSubject(pmRoot,id,settings,typeRegistry.type_to_folder);const resolvedId=subject.id;const{raw:historyRawBeforeLock,entries:history}=await readHistorySnapshot(subject.historyPath,resolvedId);if(history.length===0){throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`,EXIT_CODE.NOT_FOUND)}const resolvedTarget=ensureReplayTarget(target,history);const replayDocument=ensureMaterializedRestoreTarget(replayToTarget(history,resolvedTarget.historyIndex),resolvedTarget);const restoredDocument=replayToCanonicalItemDocument(replayDocument,{schema:settings.schema});if(restoredDocument.metadata.id!==resolvedId){throw new PmCliError(`Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,EXIT_CODE.GENERIC_FAILURE)}const loadedItemBeforeLock=subject.located?await readRestoreItem(subject.located,settings,history):null;const currentItemRawBeforeLock=loadedItemBeforeLock?.raw??null;const author=resolveAuthor(options.author,settings.author_default);const releaseLock=await acquireLock(pmRoot,resolvedId,settings.locks.ttl_seconds,author,Boolean(options.force),settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{const{loadedItemUnderLock,existingItemPath}=await loadRestoreStateUnderLock({pmRoot,subject,settings,typeRegistry,historyRawBeforeLock,currentItemRawBeforeLock,history});const itemFormat="toon";const currentState=resolveRestoreCurrentState(loadedItemUnderLock,history);const ownershipWarnings=collectRestoreOwnershipWarnings({document:currentState.document,author,force:options.force,enforcement:settings.governance.ownership_enforcement,resolvedId});const restoreChangedFields=changedFields(currentState.document,restoredDocument);await runActiveBeforeMutationHooks({pm_root:pmRoot,operation:"restore",before:currentState.document,after:restoredDocument,changed_fields:restoreChangedFields,sdk:createMutationGuardSdk({pmRoot,settings,typeToFolder:typeRegistry.type_to_folder})});const serializedRestore=serializeItemDocument(restoredDocument,{format:itemFormat,schema:settings.schema});const restoredItemPath=getItemPath(pmRoot,restoredDocument.metadata.type,resolvedId,itemFormat,typeRegistry.type_to_folder);const releaseDerivedIndexLock=await acquireItemMetadataDerivedIndexLock(pmRoot,author);let derivedIndexWarnings=[];try{await writeFileAtomic(restoredItemPath,serializedRestore);if(existingItemPath&&restoredItemPath!==existingItemPath){await fs.rm(existingItemPath)}const historyEntry=createHistoryEntry({nowIso:nowIso(),author,op:"restore",before:currentState.document,after:restoredDocument,message:options.message});try{await appendHistoryEntry(subject.historyPath,historyEntry)}catch(error){await restorePreviousItemAfterHistoryFailure({existingItemPath,resolvedOriginalRaw:currentState.originalRaw,restoredItemPath});throw error}derivedIndexWarnings=await refreshItemMetadataDerivedIndex({pmRoot,preferredFormat:settings.item_format,typeToFolder:typeRegistry.type_to_folder,schema:settings.schema,itemPath:restoredItemPath,previousItemPath:existingItemPath??void 0,document:restoredDocument})}finally{await releaseDerivedIndexLock()}const hookWarnings=await runRestoreWriteHooks({restoredItemPath,historyPath:subject.historyPath,before:currentState.document,after:restoredDocument});recordAfterCommandAffectedItem({id:restoredDocument.metadata.id,op:"restore",item_type:restoredDocument.metadata.type,previous_status:currentState.document.metadata.status,status:restoredDocument.metadata.status,previous:projectAfterCommandItemSnapshot(currentState.document.metadata,restoreChangedFields),current:projectAfterCommandItemSnapshot(restoredDocument.metadata,restoreChangedFields),changed_fields:restoreChangedFields});const targetEntry=history[resolvedTarget.historyIndex];const offset=historyVersionOffset(history,true);return{item:restoredDocument.metadata,restored_from:{kind:resolvedTarget.kind,target:resolvedTarget.raw,history_index:resolvedTarget.historyIndex+1,version:offset===null?null:offset+resolvedTarget.historyIndex+1,entry_ts:targetEntry.ts,entry_op:targetEntry.op},changed_fields:restoreChangedFields,warnings:[...loadedItemUnderLock?.recovered?["restore_unreadable_item_recovered"]:[],...subject.historyPolicyWarnings,...ownershipWarnings,...derivedIndexWarnings,...hookWarnings]}}finally{await releaseLock()}}const _testOnlyRestoreCommand={applyHistoryPatch,changedFields,ensureMaterializedRestoreTarget,ensureReplayTarget,extractPatchFailureContext,replayCurrentDocument,replayToTarget,resolveRestoreSubject};export{_testOnlyRestoreCommand,runRestore};
 //# sourceMappingURL=restore.js.map
-//# debugId=7a3effef-6ba8-51ba-ae99-436d4ef69813

package/dist/sdk/lifecycle/shared-unset-fields.js

@@ -1,296 +1,2 @@
-/**
- * @module sdk/lifecycle/shared-unset-fields
- *
- * Single-sources unset-field metadata shared by create and update command handlers.
- */
-
-!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]="0062e981-158a-5e6a-b028-6c7cef0f59ba")}catch(e){}}();
-import { EXIT_CODE, PmCliError, } from "../runtime-primitives.js";
-import { isLegacyNoneToken } from "./legacy-none-tokens.js";
-/** Public contract for common unset field definitions before close reason, shared by SDK and presentation-layer consumers. */
-export const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON = [
-    {
-        canonical: "tags",
-        aliases: ["tags"],
-        optionKey: "tags",
-        metadataKey: "tags",
-    },
-];
-/** Public contract for common unset field definitions after close reason before author, shared by SDK and presentation-layer consumers. */
-export const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR = [
-    {
-        canonical: "deadline",
-        aliases: ["deadline"],
-        optionKey: "deadline",
-        metadataKey: "deadline",
-    },
-    {
-        canonical: "estimate",
-        aliases: ["estimate", "estimated_minutes", "estimated-minutes"],
-        optionKey: "estimatedMinutes",
-        metadataKey: "estimated_minutes",
-    },
-    {
-        canonical: "acceptance-criteria",
-        aliases: ["acceptance_criteria", "acceptance-criteria", "ac"],
-        optionKey: "acceptanceCriteria",
-        metadataKey: "acceptance_criteria",
-    },
-    {
-        canonical: "definition-of-ready",
-        aliases: ["definition_of_ready", "definition-of-ready"],
-        optionKey: "definitionOfReady",
-        metadataKey: "definition_of_ready",
-    },
-    {
-        canonical: "order",
-        aliases: ["order", "rank"],
-        optionKey: "order",
-        metadataKey: "order",
-    },
-    {
-        canonical: "goal",
-        aliases: ["goal"],
-        optionKey: "goal",
-        metadataKey: "goal",
-    },
-    {
-        canonical: "objective",
-        aliases: ["objective"],
-        optionKey: "objective",
-        metadataKey: "objective",
-    },
-    {
-        canonical: "value",
-        aliases: ["value"],
-        optionKey: "value",
-        metadataKey: "value",
-    },
-    {
-        canonical: "impact",
-        aliases: ["impact"],
-        optionKey: "impact",
-        metadataKey: "impact",
-    },
-    {
-        canonical: "outcome",
-        aliases: ["outcome"],
-        optionKey: "outcome",
-        metadataKey: "outcome",
-    },
-    {
-        canonical: "why-now",
-        aliases: ["why_now", "why-now"],
-        optionKey: "whyNow",
-        metadataKey: "why_now",
-    },
-];
-/** Public contract for common unset field definitions before author, shared by SDK and presentation-layer consumers. */
-export const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR = [
-    ...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,
-    ...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,
-];
-/** Public contract for common unset field definitions after author, shared by SDK and presentation-layer consumers. */
-export const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR = [
-    {
-        canonical: "assignee",
-        aliases: ["assignee"],
-        optionKey: "assignee",
-        metadataKey: "assignee",
-    },
-    {
-        canonical: "parent",
-        aliases: ["parent"],
-        optionKey: "parent",
-        metadataKey: "parent",
-    },
-    {
-        canonical: "reviewer",
-        aliases: ["reviewer"],
-        optionKey: "reviewer",
-        metadataKey: "reviewer",
-    },
-    {
-        canonical: "risk",
-        aliases: ["risk"],
-        optionKey: "risk",
-        metadataKey: "risk",
-    },
-    {
-        canonical: "confidence",
-        aliases: ["confidence"],
-        optionKey: "confidence",
-        metadataKey: "confidence",
-    },
-    {
-        canonical: "sprint",
-        aliases: ["sprint"],
-        optionKey: "sprint",
-        metadataKey: "sprint",
-    },
-    {
-        canonical: "release",
-        aliases: ["release"],
-        optionKey: "release",
-        metadataKey: "release",
-    },
-    {
-        canonical: "blocked-by",
-        aliases: ["blocked_by", "blocked-by"],
-        optionKey: "blockedBy",
-        metadataKey: "blocked_by",
-    },
-    {
-        canonical: "blocked-reason",
-        aliases: ["blocked_reason", "blocked-reason"],
-        optionKey: "blockedReason",
-        metadataKey: "blocked_reason",
-    },
-    {
-        canonical: "unblock-note",
-        aliases: ["unblock_note", "unblock-note"],
-        optionKey: "unblockNote",
-        metadataKey: "unblock_note",
-    },
-    {
-        canonical: "reporter",
-        aliases: ["reporter"],
-        optionKey: "reporter",
-        metadataKey: "reporter",
-    },
-    {
-        canonical: "severity",
-        aliases: ["severity"],
-        optionKey: "severity",
-        metadataKey: "severity",
-    },
-    {
-        canonical: "environment",
-        aliases: ["environment"],
-        optionKey: "environment",
-        metadataKey: "environment",
-    },
-    {
-        canonical: "repro-steps",
-        aliases: ["repro_steps", "repro-steps"],
-        optionKey: "reproSteps",
-        metadataKey: "repro_steps",
-    },
-    {
-        canonical: "resolution",
-        aliases: ["resolution"],
-        optionKey: "resolution",
-        metadataKey: "resolution",
-    },
-    {
-        canonical: "expected-result",
-        aliases: ["expected_result", "expected-result"],
-        optionKey: "expectedResult",
-        metadataKey: "expected_result",
-    },
-    {
-        canonical: "actual-result",
-        aliases: ["actual_result", "actual-result"],
-        optionKey: "actualResult",
-        metadataKey: "actual_result",
-    },
-    {
-        canonical: "affected-version",
-        aliases: ["affected_version", "affected-version"],
-        optionKey: "affectedVersion",
-        metadataKey: "affected_version",
-    },
-    {
-        canonical: "fixed-version",
-        aliases: ["fixed_version", "fixed-version"],
-        optionKey: "fixedVersion",
-        metadataKey: "fixed_version",
-    },
-    {
-        canonical: "component",
-        aliases: ["component"],
-        optionKey: "component",
-        metadataKey: "component",
-    },
-    {
-        canonical: "regression",
-        aliases: ["regression"],
-        optionKey: "regression",
-        metadataKey: "regression",
-    },
-    {
-        canonical: "customer-impact",
-        aliases: ["customer_impact", "customer-impact"],
-        optionKey: "customerImpact",
-        metadataKey: "customer_impact",
-    },
-];
-/** Parse and validate common command `--unset` tokens while preserving command-specific field resolution. */
-export function parseCommandUnsetTargets(options) {
-    const metadataKeys = new Set();
-    const optionKeys = new Set();
-    if (!options.raw || options.raw.length === 0) {
-        return { metadataKeys, optionKeys };
-    }
-    for (const entry of options.raw) {
-        const trimmed = entry.trim().toLowerCase();
-        if (!trimmed) {
-            throw new PmCliError("--unset values must not be empty", EXIT_CODE.USAGE);
-        }
-        if (isLegacyNoneToken(trimmed)) {
-            throw new PmCliError('--unset no longer accepts "none" or "null". Specify concrete field names such as --unset deadline', EXIT_CODE.USAGE);
-        }
-        const definition = options.resolveDefinition(trimmed);
-        if (!definition) {
-            throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${options.supportedFields}`, EXIT_CODE.USAGE);
-        }
-        metadataKeys.add(definition.metadataKey);
-        optionKeys.add(definition.optionKey);
-    }
-    return { metadataKeys, optionKeys };
-}
-/** Resolve a runtime-schema field definition from a command `--unset` token. */
-export function resolveRuntimeUnsetFieldDefinition(token, command, runtimeFieldRegistry) {
-    const normalizedToken = token.trim().toLowerCase();
-    if (!runtimeFieldRegistry) {
-        return undefined;
-    }
-    const definitions = runtimeFieldRegistry.command_to_fields?.get(command) ?? [];
-    for (const definition of definitions) {
-        if (definition.allow_unset === false) {
-            continue;
-        }
-        const candidates = new Set();
-        if (typeof definition.key === "string" && definition.key.length > 0) {
-            candidates.add(definition.key.toLowerCase());
-        }
-        if (typeof definition.metadata_key === "string" &&
-            definition.metadata_key.length > 0) {
-            candidates.add(definition.metadata_key.toLowerCase());
-        }
-        if (typeof definition.cli_flag === "string" &&
-            definition.cli_flag.length > 0) {
-            candidates.add(definition.cli_flag.replaceAll("-", "_").toLowerCase());
-            candidates.add(definition.cli_flag.toLowerCase());
-        }
-        if (Array.isArray(definition.cli_aliases)) {
-            for (const alias of definition.cli_aliases) {
-                if (typeof alias !== "string" || alias.length === 0) {
-                    continue;
-                }
-                candidates.add(alias.replaceAll("-", "_").toLowerCase());
-                candidates.add(alias.toLowerCase());
-            }
-        }
-        if (!candidates.has(normalizedToken)) {
-            continue;
-        }
-        return {
-            optionKey: definition.key,
-            metadataKey: definition.metadata_key,
-        };
-    }
-    return undefined;
-}
+!(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]="0562fd00-217b-5e1f-8004-df4574f8b796")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"../runtime-primitives.js";import{isLegacyNoneToken}from"./legacy-none-tokens.js";const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON=[{canonical:"tags",aliases:["tags"],optionKey:"tags",metadataKey:"tags"}];const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR=[{canonical:"deadline",aliases:["deadline"],optionKey:"deadline",metadataKey:"deadline"},{canonical:"estimate",aliases:["estimate","estimated_minutes","estimated-minutes"],optionKey:"estimatedMinutes",metadataKey:"estimated_minutes"},{canonical:"acceptance-criteria",aliases:["acceptance_criteria","acceptance-criteria","ac"],optionKey:"acceptanceCriteria",metadataKey:"acceptance_criteria"},{canonical:"definition-of-ready",aliases:["definition_of_ready","definition-of-ready"],optionKey:"definitionOfReady",metadataKey:"definition_of_ready"},{canonical:"order",aliases:["order","rank"],optionKey:"order",metadataKey:"order"},{canonical:"goal",aliases:["goal"],optionKey:"goal",metadataKey:"goal"},{canonical:"objective",aliases:["objective"],optionKey:"objective",metadataKey:"objective"},{canonical:"value",aliases:["value"],optionKey:"value",metadataKey:"value"},{canonical:"impact",aliases:["impact"],optionKey:"impact",metadataKey:"impact"},{canonical:"outcome",aliases:["outcome"],optionKey:"outcome",metadataKey:"outcome"},{canonical:"why-now",aliases:["why_now","why-now"],optionKey:"whyNow",metadataKey:"why_now"}];const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR];const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR=[{canonical:"assignee",aliases:["assignee"],optionKey:"assignee",metadataKey:"assignee"},{canonical:"parent",aliases:["parent"],optionKey:"parent",metadataKey:"parent"},{canonical:"reviewer",aliases:["reviewer"],optionKey:"reviewer",metadataKey:"reviewer"},{canonical:"risk",aliases:["risk"],optionKey:"risk",metadataKey:"risk"},{canonical:"confidence",aliases:["confidence"],optionKey:"confidence",metadataKey:"confidence"},{canonical:"sprint",aliases:["sprint"],optionKey:"sprint",metadataKey:"sprint"},{canonical:"release",aliases:["release"],optionKey:"release",metadataKey:"release"},{canonical:"blocked-by",aliases:["blocked_by","blocked-by"],optionKey:"blockedBy",metadataKey:"blocked_by"},{canonical:"blocked-reason",aliases:["blocked_reason","blocked-reason"],optionKey:"blockedReason",metadataKey:"blocked_reason"},{canonical:"unblock-note",aliases:["unblock_note","unblock-note"],optionKey:"unblockNote",metadataKey:"unblock_note"},{canonical:"reporter",aliases:["reporter"],optionKey:"reporter",metadataKey:"reporter"},{canonical:"severity",aliases:["severity"],optionKey:"severity",metadataKey:"severity"},{canonical:"environment",aliases:["environment"],optionKey:"environment",metadataKey:"environment"},{canonical:"repro-steps",aliases:["repro_steps","repro-steps"],optionKey:"reproSteps",metadataKey:"repro_steps"},{canonical:"resolution",aliases:["resolution"],optionKey:"resolution",metadataKey:"resolution"},{canonical:"expected-result",aliases:["expected_result","expected-result"],optionKey:"expectedResult",metadataKey:"expected_result"},{canonical:"actual-result",aliases:["actual_result","actual-result"],optionKey:"actualResult",metadataKey:"actual_result"},{canonical:"affected-version",aliases:["affected_version","affected-version"],optionKey:"affectedVersion",metadataKey:"affected_version"},{canonical:"fixed-version",aliases:["fixed_version","fixed-version"],optionKey:"fixedVersion",metadataKey:"fixed_version"},{canonical:"component",aliases:["component"],optionKey:"component",metadataKey:"component"},{canonical:"regression",aliases:["regression"],optionKey:"regression",metadataKey:"regression"},{canonical:"customer-impact",aliases:["customer_impact","customer-impact"],optionKey:"customerImpact",metadataKey:"customer_impact"}];function parseCommandUnsetTargets(options){const metadataKeys=new Set;const optionKeys=new Set;if(!options.raw||options.raw.length===0){return{metadataKeys,optionKeys}}for(const entry of options.raw){const trimmed=entry.trim().toLowerCase();if(!trimmed){throw new PmCliError("--unset values must not be empty",EXIT_CODE.USAGE)}if(isLegacyNoneToken(trimmed)){throw new PmCliError('--unset no longer accepts "none" or "null". Specify concrete field names such as --unset deadline',EXIT_CODE.USAGE)}const definition=options.resolveDefinition(trimmed);if(!definition){throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${options.supportedFields}`,EXIT_CODE.USAGE)}metadataKeys.add(definition.metadataKey);optionKeys.add(definition.optionKey)}return{metadataKeys,optionKeys}}function resolveRuntimeUnsetFieldDefinition(token,command,runtimeFieldRegistry){const normalizedToken=token.trim().toLowerCase();if(!runtimeFieldRegistry){return void 0}const definitions=runtimeFieldRegistry.command_to_fields?.get(command)??[];for(const definition of definitions){if(definition.allow_unset===false){continue}const candidates=new Set;if(typeof definition.key==="string"&&definition.key.length>0){candidates.add(definition.key.toLowerCase())}if(typeof definition.metadata_key==="string"&&definition.metadata_key.length>0){candidates.add(definition.metadata_key.toLowerCase())}if(typeof definition.cli_flag==="string"&&definition.cli_flag.length>0){candidates.add(definition.cli_flag.replaceAll("-","_").toLowerCase());candidates.add(definition.cli_flag.toLowerCase())}if(Array.isArray(definition.cli_aliases)){for(const alias of definition.cli_aliases){if(typeof alias!=="string"||alias.length===0){continue}candidates.add(alias.replaceAll("-","_").toLowerCase());candidates.add(alias.toLowerCase())}}if(!candidates.has(normalizedToken)){continue}return{optionKey:definition.key,metadataKey:definition.metadata_key}}return void 0}export{COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,parseCommandUnsetTargets,resolveRuntimeUnsetFieldDefinition};
 //# sourceMappingURL=shared-unset-fields.js.map
-//# debugId=0062e981-158a-5e6a-b028-6c7cef0f59ba