@unbrained/pm-cli 2026.8.19 → 2026.8.21

package/dist/sdk/lifecycle/append.js

@@ -4,8 +4,9 @@
  * Implements the pm append command surface and its agent-facing runtime behavior.
  */
 
-!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]="9e3ba7e9-8822-53ba-981e-e177be5219f3")}catch(e){}}();
-import { pathExists, EXIT_CODE, PmCliError, resolveAuthor, toItemRecord, createStdinTokenResolver, mutateItem, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
+!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]="73184370-6517-533e-90db-536893402616")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { EXIT_CODE, PmCliError, resolveAuthor, toItemRecord, createStdinTokenResolver, mutateItem, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 /** Implements run append for the public runtime surface of this module. */
 export async function runAppend(id, options, global) {
     if (options.body === undefined) {
@@ -13,9 +14,7 @@ export async function runAppend(id, options, global) {
     }
     const stdinResolver = createStdinTokenResolver();
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const author = resolveAuthor(options.author, settings.author_default);
     // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.
@@ -52,4 +51,4 @@ export async function runAppend(id, options, global) {
     };
 }
 //# sourceMappingURL=append.js.map
-//# debugId=9e3ba7e9-8822-53ba-981e-e177be5219f3
+//# debugId=73184370-6517-533e-90db-536893402616

package/dist/sdk/lifecycle/claim.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module cli/commands/claim
- *
- * Implements the pm claim command surface and its agent-facing runtime behavior.
- */
 import { type GlobalOptions } from "../runtime-primitives.js";
 import { type NextRecommendation, type NextOptions } from "../query/next.js";
 /** Stable warning/error code for an exhausted atomic next-work walk. */

package/dist/sdk/lifecycle/claim.js

@@ -4,8 +4,9 @@
  * Implements the pm claim command surface and its agent-facing runtime behavior.
  */
 
-!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]="f70f1329-4dfb-5625-ae0a-66c858d88f7b")}catch(e){}}();
-import { pathExists, resolveRuntimeStatusRegistry, statusIsTerminal, EXIT_CODE, PmCliError, toItemRecord, mutateItem, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, resolveClaimPrincipal, } from "../runtime-primitives.js";
+!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]="1a61bf25-e320-5adc-8f5a-a427bc89af1a")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { resolveRuntimeStatusRegistry, statusIsTerminal, EXIT_CODE, PmCliError, toItemRecord, mutateItem, resolvePmRoot, readSettings, resolveAuthor, resolveClaimPrincipal, } from "../runtime-primitives.js";
 import { wrapOwnershipConflict } from "../annotations.js";
 import { describeItemOwnershipConflict } from "../ownership-source.js";
 import { runNext, } from "../query/next.js";
@@ -26,9 +27,7 @@ export function isAlreadyClaimedError(error) {
 /** Implements run claim for the public runtime surface of this module. */
 export async function runClaim(id, force, global, options = {}) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const author = resolveAuthor(options.author, settings.author_default);
@@ -184,9 +183,7 @@ export async function claimNextFromRecommendations(recommendations, force, globa
 /** Implements run release for the public runtime surface of this module. */
 export async function runRelease(id, force, global, options = {}) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const author = resolveAuthor(options.author, settings.author_default);
     const claimPrincipal = resolveClaimPrincipal(author);
@@ -237,4 +234,4 @@ export async function runRelease(id, force, global, options = {}) {
     };
 }
 //# sourceMappingURL=claim.js.map
-//# debugId=f70f1329-4dfb-5625-ae0a-66c858d88f7b
+//# debugId=1a61bf25-e320-5adc-8f5a-a427bc89af1a

package/dist/sdk/lifecycle/close-many.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module cli/commands/close-many
- *
- * Implements the pm close many command surface and its agent-facing runtime behavior.
- */
 import { type GlobalOptions, readSettings } from "../runtime-primitives.js";
 import { type ListOptions } from "../query/list.js";
 import { type PmCommandEffectReceipt } from "../cli-contracts/command-exit-contracts.js";

package/dist/sdk/lifecycle/close-many.js

@@ -4,8 +4,9 @@
  * Implements the pm close many command surface and its agent-facing runtime behavior.
  */
 
-!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]="4da07a98-855e-59cf-a6a4-2f59a8b3c0bd")}catch(e){}}();
-import { pathExists, createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, resolveAuthor, nowIso, listAllItemMetadataLight, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
+!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]="a7113374-b169-5f92-9c20-075a47520440")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, resolveAuthor, nowIso, listAllItemMetadataLight, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { runClose } from "./close.js";
 import { hasListFilters } from "../query/list-filter-shared.js";
 import { runList } from "../query/list.js";
@@ -336,9 +337,7 @@ async function resolveCloseManyCheckpointInfo(params) {
 /** Implements run close many for the public runtime surface of this module. */
 export async function runCloseMany(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const dryRun = options.dryRun === true;
     const rollbackId = resolveCloseManyRollbackId(options);
@@ -428,4 +427,4 @@ export const _testOnly = {
     resolveReason,
 };
 //# sourceMappingURL=close-many.js.map
-//# debugId=4da07a98-855e-59cf-a6a4-2f59a8b3c0bd
+//# debugId=a7113374-b169-5f92-9c20-075a47520440

package/dist/sdk/lifecycle/close.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module sdk/lifecycle/close
- *
- * Implements the pm close command surface and its agent-facing runtime behavior.
- */
 import { type GlobalOptions } from "../runtime-primitives.js";
 import { collectBlockedByIds } from "../actionability.js";
 import { type CloseOperationOptions, type CloseOperationResult } from "../lifecycle-policy.js";

package/dist/sdk/lifecycle/close.js

@@ -4,8 +4,9 @@
  * Implements the pm close command surface and its agent-facing runtime behavior.
  */
 
-!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]="83affe54-a56c-5d84-b6b0-9634d4238ff5")}catch(e){}}();
-import { pathExists, toItemRecord, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, resolveIsoOrRelative, shouldCompletePlanOnClose, getActiveExtensionRegistrations, } from "../runtime-primitives.js";
+!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]="781b5118-7b07-53c7-802f-c889cb797a96")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { toItemRecord, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, mutateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, resolveIsoOrRelative, shouldCompletePlanOnClose, getActiveExtensionRegistrations, } from "../runtime-primitives.js";
 import { collectBlockedByIds, indexBlockedByIds } from "../actionability.js";
 import { applyTerminalOrderingPolicy, requireTerminalReason, } from "../lifecycle-policy.js";
 import { renderPmCommand } from "../command-line.js";
@@ -367,9 +368,7 @@ export const _testOnlyCloseCommand = {
 /** Close one item through the SDK-owned lifecycle transaction and policy. */
 export async function closeItem(id, closeReasonText, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const author = resolveAuthor(options.author, settings.author_default);
@@ -458,4 +457,4 @@ export function runClose(id, closeReasonText, options, global) {
     return closeItem(id, closeReasonText, options, global);
 }
 //# sourceMappingURL=close.js.map
-//# debugId=83affe54-a56c-5d84-b6b0-9634d4238ff5
+//# debugId=781b5118-7b07-53c7-802f-c889cb797a96

package/dist/sdk/lifecycle/copy.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module sdk/lifecycle/copy
- *
- * Implements the SDK-owned copy lifecycle operation shared by every surface.
- */
 import { type GlobalOptions } from "../runtime-primitives.js";
 import { type SimilarityAdvisory } from "../similarity.js";
 import type { ItemMetadata } from "../../types/index.js";

package/dist/sdk/lifecycle/copy.js

@@ -4,8 +4,9 @@
  * Implements the SDK-owned copy 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]="4eb2056a-4444-514a-a0db-79b8875c3d65")}catch(e){}}();
-import { pathExists, removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, canonicalDocument, serializeItemDocument, acquireLock, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveOnWriteHooks, collectRegisteredItemFieldNames, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, nowIso, PmCliError, resolveItemTypeRegistry, buildItemNotFoundError, locateItem, readLocatedItem, getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+!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]="b59e8e54-f9e0-5cdb-bc59-6dcbf67f278d")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, canonicalDocument, serializeItemDocument, acquireLock, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveOnWriteHooks, collectRegisteredItemFieldNames, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, nowIso, PmCliError, resolveItemTypeRegistry, buildItemNotFoundError, locateItem, readLocatedItem, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { evaluateSimilarityGovernance, similarityAdvisoryWarnings, } from "../similarity.js";
 import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../item-metadata-index.js";
 function buildChangedFields(itemMetadata, body) {
@@ -29,9 +30,7 @@ function buildCopyMessage(sourceId, message) {
 /** Implements run copy for the public runtime surface of this module. */
 export async function runCopy(sourceId, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const located = await locateItem(pmRoot, sourceId, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
@@ -211,4 +210,4 @@ export async function runCopy(sourceId, options, global) {
     };
 }
 //# sourceMappingURL=copy.js.map
-//# debugId=4eb2056a-4444-514a-a0db-79b8875c3d65
+//# debugId=b59e8e54-f9e0-5cdb-bc59-6dcbf67f278d

package/dist/sdk/lifecycle/create.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module sdk/lifecycle/create
- *
- * Implements the pm create command surface and its agent-facing runtime behavior.
- */
 import { type ResolvedItemTypeDefinition, type RuntimeFieldRegistry, type GlobalOptions } from "../runtime-primitives.js";
 import { type SimilarityAdvisory } from "../similarity.js";
 import { type LifecycleTransitionSuggestion } from "./lifecycle-transitions.js";

package/dist/sdk/lifecycle/create.js

@@ -4,8 +4,9 @@
  * Implements the pm create command surface and its agent-facing runtime behavior.
  */
 
-!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]="7d69bb56-9fab-5059-9357-5b6bea2078b9")}catch(e){}}();
-import { pathExists, removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, normalizeItemId, canonicalDocument, normalizeItemMetadata, serializeItemDocument, assertParentReferenceIsNotSelf, isPlaceholderReferenceToken, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, resolvePriority, getFocusedItem, normalizeStatusInput, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, acquireLock, printError, buildInvalidTypeError, resolveTypeSynonym, collectRuntimeCreateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, PmCliError, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnWriteHooks, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, listAllItemMetadataLight, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+!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]="a10348fe-746d-5dc7-8cd4-30453c602a3f")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, normalizeItemId, canonicalDocument, normalizeItemMetadata, serializeItemDocument, assertParentReferenceIsNotSelf, isPlaceholderReferenceToken, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, resolvePriority, getFocusedItem, normalizeStatusInput, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, acquireLock, printError, buildInvalidTypeError, resolveTypeSynonym, collectRuntimeCreateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, PmCliError, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnWriteHooks, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, listAllItemMetadataLight, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { requireTerminalReasonWithRecovery } from "../lifecycle-policy.js";
 import { evaluateSimilarityGovernance, similarityAdvisoryWarnings, } from "../similarity.js";
 import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../item-metadata-index.js";
@@ -837,12 +838,7 @@ async function loadCreateTemplateOptionsFromRuntime(templateName, global, pmRoot
     return readTemplateOptionsFromRuntimeResult(handlerResult.result, templateName);
 }
 function ensureInitHasRun(pmRoot) {
-    return pathExists(getSettingsPath(pmRoot)).then((exists) => {
-        /* c8 ignore next -- init guard failures are covered by top-level create command tests. */
-        if (!exists) {
-            throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-        }
-    });
+    return assertInitializedTracker(pmRoot);
 }
 /**
  * Resolve an optional string item-metadata field for {@link runCreate}: yields
@@ -1890,4 +1886,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=7d69bb56-9fab-5059-9357-5b6bea2078b9
+//# debugId=a10348fe-746d-5dc7-8cd4-30453c602a3f

package/dist/sdk/lifecycle/delete.js

@@ -4,15 +4,14 @@
  * Implements the SDK-owned delete 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]="14aa55e1-cb5f-55ea-bf4c-412217d87449")}catch(e){}}();
+!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]="7819b53c-b0e4-50b0-a670-f80b36765085")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import path from "node:path";
-import { pathExists, EXIT_CODE, PmCliError, toItemRecord, deleteItem, getHistoryPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+import { toItemRecord, deleteItem, getHistoryPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 /** Implements run delete for the public runtime surface of this module. */
 export async function runDelete(id, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const author = resolveAuthor(options.author, settings.author_default);
     const result = await deleteItem({
@@ -44,4 +43,4 @@ export async function runDelete(id, options, global) {
     };
 }
 //# sourceMappingURL=delete.js.map
-//# debugId=14aa55e1-cb5f-55ea-bf4c-412217d87449
+//# debugId=7819b53c-b0e4-50b0-a670-f80b36765085

package/dist/sdk/lifecycle/focus.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module sdk/lifecycle/focus
- *
- * Implements the SDK-owned focus lifecycle operation shared by every surface.
- */
 import { type GlobalOptions } from "../runtime-primitives.js";
 /** Documents the focus options payload exchanged by command, SDK, and package integrations. */
 export interface FocusOptions {

package/dist/sdk/lifecycle/focus.js

@@ -4,13 +4,12 @@
  * Implements the SDK-owned focus 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]="0f43df79-0b27-53b3-b8bd-9f2a35561733")}catch(e){}}();
-import { pathExists, getActiveExtensionRegistrations, normalizeItemId, resolveItemTypeRegistry, EXIT_CODE, PmCliError, clearFocusedItem, getFocusedItem, setFocusedItem, buildItemNotFoundError, locateItem, readLocatedItem, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, resolveClaimPrincipal, } from "../runtime-primitives.js";
+!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]="a5ddb139-9780-50e0-87a5-621913cb0de4")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { getActiveExtensionRegistrations, normalizeItemId, resolveItemTypeRegistry, EXIT_CODE, PmCliError, clearFocusedItem, getFocusedItem, setFocusedItem, buildItemNotFoundError, locateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, resolveClaimPrincipal, } from "../runtime-primitives.js";
 import { recordFocusSemanticAttribution } from "../context/semantic-session-attribution.js";
 async function ensureInitialized(pmRoot) {
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
 }
 /** Implements run focus for the public runtime surface of this module. */
 export async function runFocus(id, options, global) {
@@ -90,4 +89,4 @@ function nonEmptyTitleOrNull(title) {
     return title.trim().length > 0 ? title : null;
 }
 //# sourceMappingURL=focus.js.map
-//# debugId=0f43df79-0b27-53b3-b8bd-9f2a35561733
+//# debugId=a5ddb139-9780-50e0-87a5-621913cb0de4

package/dist/sdk/lifecycle/mcp-actions.d.ts

@@ -0,0 +1,18 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+/** Minimal generic dispatch context consumed by lifecycle mutation adapters. */
+export interface LifecycleMutationActionContext {
+    /** Flat MCP/action arguments. */
+    args: Record<string, unknown>;
+    /** Normalized command option bag. */
+    options: Record<string, unknown>;
+    /** Item id resolved from flat arguments, when present. */
+    id: string | undefined;
+    /** Normalized transport-level force override. */
+    force?: boolean;
+    /** Presentation-neutral global command options. */
+    global: GlobalOptions;
+}
+/** Dispatch close through the shared MCP mutation compaction contract. */
+export declare function runMcpCloseAction(context: LifecycleMutationActionContext): Promise<unknown>;
+/** Dispatch recurrence through the shared MCP mutation compaction contract. */
+export declare function runMcpReopenAction(context: LifecycleMutationActionContext): Promise<unknown>;

package/dist/sdk/lifecycle/mcp-actions.js

@@ -0,0 +1,52 @@
+/**
+ * @module sdk/runtime-mutation-actions
+ *
+ * Keeps lifecycle-specific MCP mutation adapters outside the generic runtime
+ * dispatcher while preserving the shared token-efficient result projection.
+ */
+
+!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]="55869854-565d-52d2-8dca-b66aade074bb")}catch(e){}}();
+import { projectMutationResult } from "../../core/output/mutation-projection.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { runClose } from "./close.js";
+import { runReopen } from "./reopen.js";
+import { readRuntimeString, withMutationCompaction } from "../runtime-input.js";
+function requireLifecycleItemId(context, options) {
+    const id = context.id ?? readRuntimeString(options, "id");
+    if (!id) {
+        throw new PmCliError("Missing required argument: id", 64);
+    }
+    return id;
+}
+function readLifecycleReason(context, options) {
+    return (readRuntimeString(context.args, "reason") ??
+        readRuntimeString(context.args, "text") ??
+        readRuntimeString(options, "reason") ??
+        readRuntimeString(options, "text"));
+}
+/** Dispatch close through the shared MCP mutation compaction contract. */
+export async function runMcpCloseAction(context) {
+    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(context.args, context.options);
+    return projectMutationResult(await runClose(requireLifecycleItemId(context, runnerOptions), readLifecycleReason(context, runnerOptions), {
+        ...runnerOptions,
+        force: context.force === true || runnerOptions.force === true,
+    }, context.global), {
+        changedFields,
+        compactEnvelope: changedFields === "compact" && !idOnly,
+        idOnly,
+    });
+}
+/** Dispatch recurrence through the shared MCP mutation compaction contract. */
+export async function runMcpReopenAction(context) {
+    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(context.args, context.options);
+    return projectMutationResult(await runReopen(requireLifecycleItemId(context, runnerOptions), readLifecycleReason(context, runnerOptions) ?? "", {
+        ...runnerOptions,
+        force: context.force === true || runnerOptions.force === true,
+    }, context.global), {
+        changedFields,
+        compactEnvelope: changedFields === "compact" && !idOnly,
+        idOnly,
+    });
+}
+//# sourceMappingURL=mcp-actions.js.map
+//# debugId=55869854-565d-52d2-8dca-b66aade074bb

package/dist/sdk/lifecycle/plan.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module sdk/lifecycle/plan
- *
- * Implements the pm plan command surface and its agent-facing runtime behavior.
- */
 import { type GlobalOptions } from "../runtime-primitives.js";
 import type { DependencyKind, ItemMetadata, PlanDecision, PlanDiscovery, PlanHarness, PlanMode, PlanStep, PlanStepStatus, PlanValidationCheck } from "../../types/index.js";
 import type { MutationMetadataCommandOptions, SharedLinkedResourceOptions } from "./mutation-command-options.js";

package/dist/sdk/lifecycle/plan.js

@@ -4,8 +4,9 @@
  * Implements the pm plan command surface and its agent-facing runtime behavior.
  */
 
-!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]="3d5ea029-26ef-51bc-bacc-b1d4d807a024")}catch(e){}}();
-import { pathExists, getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, resolveTypeName, EXIT_CODE, PmCliError, splitCommaList, nowIso, locateItem, mutateItem, readLocatedItem, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, isTerminalPlanMode, } from "../runtime-primitives.js";
+!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]="49fd5730-99c2-5a93-a80e-83c806a124bf")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
+import { getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, resolveTypeName, EXIT_CODE, PmCliError, splitCommaList, nowIso, locateItem, mutateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, isTerminalPlanMode, } from "../runtime-primitives.js";
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { runCreate, } from "./create.js";
 import { createUnknownSubcommandError } from "../agent/subcommand-recovery.js";
@@ -547,9 +548,7 @@ function ensurePlanItem(item) {
 }
 async function loadContext(global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     return { pmRoot, settings };
 }
@@ -1587,4 +1586,4 @@ export const _testOnlyPlanCommand = {
     changedPlanMetadataFields,
 };
 //# sourceMappingURL=plan.js.map
-//# debugId=3d5ea029-26ef-51bc-bacc-b1d4d807a024
+//# debugId=49fd5730-99c2-5a93-a80e-83c806a124bf

package/dist/sdk/lifecycle/reopen.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module sdk/lifecycle/reopen
+ *
+ * Reopens terminal work as a recurrence while preserving immutable closure
+ * evidence and delegating every state change to the canonical update pipeline.
+ */
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { type PreviousTerminalEvidence } from "./update.js";
+export type { PreviousTerminalEvidence } from "./update.js";
+/** Options accepted by the SDK and `pm item reopen` recurrence primitive. */
+export interface ReopenCommandOptions {
+    /** Active target status; only the workspace open or in-progress status is allowed. */
+    status?: string;
+    /** Explicit mutation author override. */
+    author?: string;
+    /** Optional human-readable history message in addition to structured recurrence context. */
+    message?: string;
+    /** Override an ownership or stale-lock conflict. */
+    force?: boolean;
+}
+/** Structured recurrence receipt returned by every presentation surface. */
+export interface RecurrenceReceipt {
+    /** Required reason that the terminal work became active again. */
+    reason: string;
+    /** Terminal status observed while holding the item lock. */
+    from_status: string;
+    /** Active status written through the update pipeline. */
+    to_status: string;
+    /** Prior terminal evidence retained in immutable history. */
+    previous_terminal: PreviousTerminalEvidence;
+}
+/** Result returned after a terminal item is reopened. */
+export interface ReopenResult {
+    /** Reopened item metadata. */
+    item: Record<string, unknown>;
+    /** Fields changed by the canonical update pipeline. */
+    changed_fields: string[];
+    /** Non-fatal mutation and extension warnings. */
+    warnings: string[];
+    /** Immutable recurrence transition receipt. */
+    recurrence: RecurrenceReceipt;
+}
+/** Reopen terminal work through the canonical update mutation and history path. */
+export declare function runReopen(id: string, reason: string, options: ReopenCommandOptions, global: GlobalOptions): Promise<ReopenResult>;

package/dist/sdk/lifecycle/reopen.js

@@ -0,0 +1,69 @@
+
+!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]="08dcee99-5572-5133-b76a-6a50e4e292e7")}catch(e){}}();
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { normalizeStatusInput } from "../../core/item/status.js";
+import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
+import { resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+import { resolveStartTaskInProgressStatus } from "../start-task-status.js";
+import { runReopenUpdate, } from "./update.js";
+/** Reopen terminal work through the canonical update mutation and history path. */
+export async function runReopen(id, reason, options, global) {
+    const normalizedReason = reason.trim();
+    if (normalizedReason.length === 0) {
+        throw new PmCliError("pm item reopen requires a non-empty recurrence reason.", EXIT_CODE.USAGE, {
+            code: "reopen_reason_required",
+            required: "Describe why the terminal work became active again.",
+            recovery: {
+                suggested_retry: `pm item reopen ${id} "<recurrence reason>"`,
+                suggested_retry_args: ["item", "reopen", id, "<recurrence reason>"],
+            },
+        });
+    }
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    const statusRegistry = resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);
+    const openStatus = statusRegistry.open_status;
+    const inProgressStatus = resolveStartTaskInProgressStatus(statusRegistry);
+    const requestedStatus = options.status ?? openStatus;
+    const targetStatus = normalizeStatusInput(requestedStatus, statusRegistry) ?? requestedStatus;
+    if (targetStatus !== openStatus && targetStatus !== inProgressStatus) {
+        throw new PmCliError(`Reopen target status must be ${openStatus} or ${inProgressStatus}; received ${requestedStatus}.`, EXIT_CODE.USAGE, {
+            code: "reopen_target_status_invalid",
+            required: "Choose the workspace open or in-progress lifecycle status.",
+            recovery: {
+                allowed_values: [...new Set([openStatus, inProgressStatus])],
+                suggested_retry: `pm item reopen ${id} "${normalizedReason}" --status ${openStatus}`,
+                suggested_retry_args: [
+                    "item",
+                    "reopen",
+                    id,
+                    normalizedReason,
+                    "--status",
+                    openStatus,
+                ],
+            },
+        });
+    }
+    const update = await runReopenUpdate(id, {
+        status: targetStatus,
+        unset: [
+            "close-reason",
+            "resolution",
+            "expected-result",
+            "actual-result",
+            "fixed-version",
+        ],
+        author: options.author,
+        message: options.message,
+        force: options.force,
+    }, global, normalizedReason);
+    return {
+        item: update.item,
+        changed_fields: update.changed_fields,
+        warnings: update.warnings,
+        recurrence: update.lifecycle_transition,
+    };
+}
+//# sourceMappingURL=reopen.js.map
+//# debugId=08dcee99-5572-5133-b76a-6a50e4e292e7

package/dist/sdk/lifecycle/restore.js

@@ -4,10 +4,11 @@
  * 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]="353be665-9f67-5d0e-99c9-6bbb7e927e0b")}catch(e){}}();
+!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]="db5f3a6d-9ae5-5f9b-bedf-766b2b79324c")}catch(e){}}();
+import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import jsonPatch from "fast-json-patch";
 import fs from "node:fs/promises";
-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, readLocatedItem, getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.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, readLocatedItem, 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";
 /** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
@@ -163,9 +164,7 @@ async function runRestoreWriteHooks(params) {
 /** 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);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);
@@ -317,4 +316,4 @@ export const _testOnlyRestoreCommand = {
     resolveRestoreSubject,
 };
 //# sourceMappingURL=restore.js.map
-//# debugId=353be665-9f67-5d0e-99c9-6bbb7e927e0b
+//# debugId=db5f3a6d-9ae5-5f9b-bedf-766b2b79324c

package/dist/sdk/lifecycle/update-many.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module cli/commands/update-many
- *
- * Implements the pm update many command surface and its agent-facing runtime behavior.
- */
 import { type RuntimeFieldRegistry, type RuntimeStatusRegistry, type GlobalOptions } from "../runtime-primitives.js";
 import type { ItemStatus, PmSettings } from "../../types/index.js";
 import { hasListFilters } from "../query/list-filter-shared.js";