@unbrained/pm-cli 2026.8.19 → 2026.8.20

package/dist/sdk/index.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 
-!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]="3236ba3b-d3ac-5760-90a4-022ff103b952")}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]="69a0f0d4-50f9-5063-9cc6-64de2abac82e")}catch(e){}}();
 export { PM_COMMAND_CAPABILITY_CONTRACTS, PM_COMMAND_VISIBILITY_CONTRACTS, PM_MCP_PROMPT_CONTRACTS, PM_MCP_RESOURCE_CONTRACTS, PM_MCP_TOOL_COMMAND_CONTRACTS, listPmCommandsForFamily, listPmCommandsForTier, listPmMcpToolsForProfile, renderPmCommandVisibilityMarkdown, resolvePmCommandCapabilityFamily, resolvePmCommandVisibilityTier, } from "./agent-capability-contracts.js";
 export * from "./cli-contracts/grammar-contracts.js";
 export * from "./agent-session-context.js";
@@ -53,7 +53,7 @@ export { PROFILE_SUBCOMMANDS, formatProfileApplyHuman, formatProfileLintHuman, f
 export * from "./extension-contracts.js";
 export { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
 export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, } from "../core/packages/manifest.js";
-export { ACTIVITY_FLAG_CONTRACTS, ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_ACTION_OPTION_KEYS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PLAN_FLAG_CONTRACTS, PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_CORE_COMMAND_NAMES, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_ACTIONS, analyzePmToolActionParity, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, PROFILE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, compactFlagAliasContracts, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, analyzeSdkCliParameterCompleteness, isPmExtensionCapabilityContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, isPmExtensionServiceNameContract, isPmToolAction, hasSubcommandFlagContractsForCommand, readFirstStringFromCommanderOptions, readFirstValueFromCommanderOptions, readStringArrayFromCommanderOptions, resolvePmPositionalActionFlagContracts, resolveSubcommandFlagContractsForCommand, resolvePmCommandOutputBudget, resolvePmToolCustomFieldCollision, toCompletionFlagString, withFlagAliasMetadata, } from "./cli-contracts.js";
+export { ACTIVITY_FLAG_CONTRACTS, ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_ACTION_OPTION_KEYS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PLAN_FLAG_CONTRACTS, PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_CORE_COMMAND_NAMES, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_ACTIONS, analyzePmToolActionParity, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, PROFILE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, compactFlagAliasContracts, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, analyzeSdkCliParameterCompleteness, isPmExtensionCapabilityContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, isPmExtensionServiceNameContract, isPmToolAction, hasSubcommandFlagContractsForCommand, readFirstStringFromCommanderOptions, readFirstValueFromCommanderOptions, readStringArrayFromCommanderOptions, resolvePmPositionalActionFlagContracts, resolveSubcommandFlagContractsForCommand, resolvePmCommandOutputBudget, resolvePmToolCustomFieldCollision, toCompletionFlagString, withFlagAliasMetadata, } from "./cli-contracts.js";
 export * from "./compose.js";
 export * from "./governance/assurance.js";
 export * from "./governance/assurance-action.js";
@@ -82,6 +82,7 @@ export * from "./context-packing.js";
 export * from "./context-usage.js";
 export * from "./dependency-provenance.js";
 export * from "./duplicates.js";
+export * from "./lifecycle/reopen.js";
 export * from "./history-compact.js";
 export * from "./history-read.js";
 export * from "./history-provenance.js";
@@ -118,6 +119,7 @@ export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./agent/refusal-reachability.js";
 export * from "./agent/refusal-closure.js";
+export * from "./agent/closed-domain-contracts.js";
 export * from "./agent/subcommand-recovery.js";
 export * from "./flag-invocation-contracts.js";
 export * from "./cli-contracts/flag-lexicon-contracts.js";
@@ -135,7 +137,7 @@ export { runLearnings } from "./learnings.js";
 export { runUpgrade } from "./governance/upgrade.js";
 export { PLAN_SHOW_DEPTH_VALUES, PLAN_SUBCOMMANDS, PLAN_TEMPLATE_NAMES, } from "./lifecycle/plan.js";
 export * from "./define.js";
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolveImplicitPmRoot, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runList, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, duplicates, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, filesLookup, focus, gc, get, graph, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, listAllComplete, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemapStatus, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, schemaRenameField, schemaRenameType, search, startTask, stats, update, upgrade, validate, } from "./runtime.js";
+export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolveImplicitPmRoot, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runList, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, reopen, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, duplicates, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, filesLookup, focus, gc, get, graph, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, listAllComplete, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemapStatus, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, schemaRenameField, schemaRenameType, search, startTask, stats, update, upgrade, validate, } from "./runtime.js";
 export { extensionMigrate, packageMigrate } from "./package-migrations.js";
 export { CONTEXT_OUTPUT_VALUES, NEXT_OUTPUT_VALUES, PM_GITIGNORE_END, PM_GITIGNORE_START, analyzeSdkActionCoverage, ensurePmGitignore, getPmGitignoreBlock, closeItem, runAggregate, runClose, runCopy, runContext, runDelete, runFocus, runGet, runNext, runRestore, runUpdate, } from "./runtime.js";
 export { runStats } from "./stats.js";
@@ -157,4 +159,4 @@ export * from "./governance.js";
 export * from "./query.js";
 export * from "./testing.js";
 //# sourceMappingURL=index.js.map
-//# debugId=3236ba3b-d3ac-5760-90a4-022ff103b952
+//# debugId=69a0f0d4-50f9-5063-9cc6-64de2abac82e

package/dist/sdk/init-agent-guidance.d.ts

@@ -89,11 +89,13 @@ declare function toPortableRelativePath(projectRoot: string, targetPath: string)
 declare function ensureTrailingNewline(value: string): string;
 declare function detectLineEnding(value: string): "\n" | "\r\n";
 declare function findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null;
-declare function buildAgentGuidanceBlock(lineEnding: "\n" | "\r\n"): string;
-declare function upsertAgentGuidanceBlock(existingContent: string): {
+declare function buildAgentGuidanceBlock(lineEnding: "\n" | "\r\n", projectTestCommand?: string): string;
+declare function upsertAgentGuidanceBlock(existingContent: string, projectTestCommand?: string): {
     next_content: string;
     changed: boolean;
 };
+/** Resolve an executable linked-test command from a target repository's own files. */
+export declare function resolveProjectTestCommand(projectRoot: string): Promise<string>;
 declare function resolveProjectRoot(pmRoot: string, cwd: string): string;
 declare function resolveTargetGuidancePath(scans: AgentGuidanceFileScan[], projectRoot: string): string;
 declare function parsePromptChoice(answer: string, currentDefault: boolean): boolean;
@@ -104,7 +106,7 @@ declare function applyAgentGuidanceState(settings: PmSettings, currentState: PmS
     changed: boolean;
     state: PmSettings["agent_guidance"];
 };
-declare function writeGuidanceFile(filePath: string): Promise<{
+declare function writeGuidanceFile(filePath: string, projectRoot?: string): Promise<{
     changed: boolean;
     warnings: string[];
 }>;

package/dist/sdk/init-agent-guidance.js

@@ -4,7 +4,7 @@
  * Implements the pm init agent guidance 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]="b7c97e30-02c8-547c-b3db-c6c59e662b54")}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]="e404796d-439b-5f4c-9330-5b12ff41d7b2")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import readline from "node:readline/promises";
@@ -91,14 +91,14 @@ function findGuidanceBlockRange(content) {
 function hasGuidanceMarker(content) {
     return findGuidanceBlockRange(content) !== null;
 }
-function buildAgentGuidanceBlock(lineEnding) {
+function buildAgentGuidanceBlock(lineEnding, projectTestCommand = "<your project test command>") {
     const lines = [
         AGENT_GUIDANCE_START_MARKER,
         "## pm Workflow (Agent Quickstart)",
         "",
         '- Orient before mutate: `pm context --limit 10`, `pm search "<keywords>" --limit 10`, `pm list --status open --limit 20`.',
         "- Claim and execute: `pm claim <id>` then `pm update <id> --status in_progress`.",
-        '- Link evidence while coding: `pm files <id> --add ...`, `pm docs <id> --add ...`, `pm test <id> --add command="node scripts/run-tests.mjs test -- ..."`.',
+        `- Link evidence while coding: \`pm files <id> --add ...\`, \`pm docs <id> --add ...\`, \`pm test <id> --add command="${projectTestCommand}"\`.`,
         '- Verify and close: `pm test <id> --run --progress`, `pm close <id> "<evidence>" --validate-close warn`, `pm release <id>`.',
         "- Author identity is automatic for supported agent harnesses; use `--author` only for an explicit override.",
         "",
@@ -107,9 +107,9 @@ function buildAgentGuidanceBlock(lineEnding) {
     ];
     return lines.join(lineEnding);
 }
-function upsertAgentGuidanceBlock(existingContent) {
+function upsertAgentGuidanceBlock(existingContent, projectTestCommand = "<your project test command>") {
     const lineEnding = detectLineEnding(existingContent);
-    const nextBlock = buildAgentGuidanceBlock(lineEnding);
+    const nextBlock = buildAgentGuidanceBlock(lineEnding, projectTestCommand);
     const existingRange = findGuidanceBlockRange(existingContent);
     if (existingRange) {
         const trailingContent = existingContent.slice(existingRange.end_index);
@@ -135,6 +135,65 @@ function upsertAgentGuidanceBlock(existingContent) {
         changed: nextContent !== existingContent,
     };
 }
+/** Resolve an executable linked-test command from a target repository's own files. */
+export async function resolveProjectTestCommand(projectRoot) {
+    if (await pathExists(path.join(projectRoot, "scripts", "run-tests.mjs"))) {
+        return "node scripts/run-tests.mjs test";
+    }
+    let packageDocument;
+    try {
+        packageDocument = JSON.parse(await fs.readFile(path.join(projectRoot, "package.json"), "utf8"));
+    }
+    catch {
+        return "<your project test command>";
+    }
+    const manifest = normalizeProjectPackageManifest(packageDocument);
+    if (manifest === undefined) {
+        return "<your project test command>";
+    }
+    const packageManager = manifest.packageManager?.split("@")[0];
+    if (packageManager === "pnpm") {
+        return "pnpm test";
+    }
+    if (packageManager === "bun") {
+        return "bun run test";
+    }
+    if (packageManager === "yarn") {
+        return "yarn test";
+    }
+    if (packageManager === "npm")
+        return "npm test";
+    if (await pathExists(path.join(projectRoot, "pnpm-lock.yaml"))) {
+        return "pnpm test";
+    }
+    if ((await pathExists(path.join(projectRoot, "bun.lock"))) ||
+        (await pathExists(path.join(projectRoot, "bun.lockb")))) {
+        return "bun run test";
+    }
+    if (await pathExists(path.join(projectRoot, "yarn.lock")))
+        return "yarn test";
+    return "npm test";
+}
+/** Validate the minimal package manifest shape needed for executable test guidance. */
+function normalizeProjectPackageManifest(value) {
+    if (typeof value !== "object" || value === null || !("scripts" in value)) {
+        return undefined;
+    }
+    const scripts = value.scripts;
+    if (typeof scripts !== "object" ||
+        scripts === null ||
+        !("test" in scripts) ||
+        typeof scripts.test !== "string" ||
+        scripts.test.trim().length === 0) {
+        return undefined;
+    }
+    return {
+        scripts: { test: scripts.test },
+        ...("packageManager" in value && typeof value.packageManager === "string"
+            ? { packageManager: value.packageManager }
+            : {}),
+    };
+}
 function resolveProjectRoot(pmRoot, cwd) {
     const parent = path.dirname(pmRoot);
     if (path.basename(pmRoot) === "pm" && path.basename(parent) === ".agents") {
@@ -240,10 +299,10 @@ function applyAgentGuidanceState(settings, currentState) {
     }
     return { changed, state: currentState };
 }
-async function writeGuidanceFile(filePath) {
+async function writeGuidanceFile(filePath, projectRoot = path.dirname(filePath)) {
     const exists = await pathExists(filePath);
     const currentContent = exists ? await fs.readFile(filePath, "utf8") : "";
-    const nextContent = upsertAgentGuidanceBlock(currentContent);
+    const nextContent = upsertAgentGuidanceBlock(currentContent, await resolveProjectTestCommand(projectRoot));
     if (!nextContent.changed) {
         return { changed: false, warnings: [] };
     }
@@ -292,7 +351,7 @@ async function addAgentGuidanceBlockIfMissing(flow, context) {
     if (context.presentBefore) {
         return;
     }
-    const writeResult = await writeGuidanceFile(context.targetPath);
+    const writeResult = await writeGuidanceFile(context.targetPath, context.projectRoot);
     flow.warnings.push(...writeResult.warnings);
     if (writeResult.changed) {
         flow.applied = true;
@@ -413,6 +472,7 @@ export async function runInitAgentGuidance(options) {
         targetRelativePath,
         checkedFiles,
         presentBefore,
+        projectRoot,
     });
     const stateUpdate = applyAgentGuidanceState(options.settings, flow.state);
     scans = await refreshGuidanceScansAfterApply(flow.applied, scans, projectRoot);
@@ -434,4 +494,4 @@ export async function runInitAgentGuidance(options) {
     };
 }
 //# sourceMappingURL=init-agent-guidance.js.map
-//# debugId=b7c97e30-02c8-547c-b3db-c6c59e662b54
+//# debugId=e404796d-439b-5f4c-9330-5b12ff41d7b2

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/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/update.d.ts

@@ -67,6 +67,35 @@ export interface UpdateResult {
     /** Value that configures or reports warnings for this contract. */
     warnings: string[];
 }
+/** Terminal evidence captured atomically before a recurrence transition. */
+export interface PreviousTerminalEvidence {
+    /** Prior close reason, when recorded. */
+    close_reason?: string;
+    /** Prior structured resolution, when recorded. */
+    resolution?: string;
+    /** Prior expected result, when recorded. */
+    expected_result?: string;
+    /** Prior actual result, when recorded. */
+    actual_result?: string;
+    /** Prior fixed version, when recorded. */
+    fixed_version?: string;
+}
+/** Internal update-path receipt consumed by the public recurrence primitive. */
+export interface ReopenUpdateReceipt {
+    /** Recurrence reason stored in immutable history context. */
+    reason: string;
+    /** Terminal status observed while holding the item lock. */
+    from_status: string;
+    /** Active status written by the update path. */
+    to_status: string;
+    /** Terminal evidence removed from active metadata but retained in history. */
+    previous_terminal: PreviousTerminalEvidence;
+}
+/** Update result carrying the recurrence receipt produced by the locked transition. */
+export interface ReopenUpdateResult extends UpdateResult {
+    /** Lifecycle-specific receipt populated by the recurrence primitive. */
+    lifecycle_transition: ReopenUpdateReceipt;
+}
 declare function normalizeLegacyNoneUpdateOptions(options: UpdateCommandOptions): UpdateCommandOptions;
 declare function parseUpdateUnsetTargets(raw: string[] | undefined, runtimeFieldRegistry?: RuntimeFieldRegistry, extensionFieldNames?: readonly string[]): {
     metadataKeys: Set<string>;
@@ -139,6 +168,8 @@ type UpdateStatusMutationContext = Pick<UpdateMutationContext, "options" | "stat
 declare function applyStatusAndCloseReasonMutations(document: ItemDocument, context: UpdateStatusMutationContext, previousStatusNormalized: string, changedFields: string[]): void;
 /** Implements run update for the public runtime surface of this module. */
 export declare function runUpdate(id: string, options: UpdateCommandOptions, global: GlobalOptions): Promise<UpdateResult>;
+/** Execute a recurrence transition through the exact atomic update pipeline. */
+export declare function runReopenUpdate(id: string, options: UpdateCommandOptions, global: GlobalOptions, recurrenceReason: string): Promise<ReopenUpdateResult>;
 /** Public contract for test only update command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyUpdateCommand: {
     applyStatusAndCloseReasonMutations: typeof applyStatusAndCloseReasonMutations;