@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/runtime.js

@@ -1,1929 +1,2 @@
-/**
- * @module sdk/runtime
- *
- * Defines public SDK APIs and package-author helpers for Runtime.
- */
-
-!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]="422ff60b-97b1-5477-a7b8-ed4f983155e0")}catch(e){}}();
-export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignoreBlock, } from "./workspace.js";
-export { SEARCH_EXTENSION_FLAG_DEFINITIONS } from "./extension-contracts.js";
-export * from "./cli-contracts/agent-output-contracts.js";
-import { AsyncLocalStorage } from "node:async_hooks";
-import path from "node:path";
-import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
-import { activateExtensions, deactivateExtensions, loadExtensions, runActiveCommandHandler, runWithIsolatedExtensionRuntime, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
-import { pathExists } from "../core/fs/fs-utils.js";
-import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-import { projectMutationResult } from "../core/output/mutation-projection.js";
-import { withQuerySummary } from "../core/output/query-summary.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { asRecordClone } from "../core/shared/primitives.js";
-import { createAsyncReadWriteGate } from "../core/shared/serial-queue.js";
-import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../core/schema/runtime-schema.js";
-import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
-import { readSettings } from "../core/store/settings.js";
-import { listClientItemMetadataLight } from "./query/light-metadata.js";
-import { certifyCompleteListResult, createCompleteListOptions } from "./query/complete-list.js";
-export { PmCompleteListValidationError, assertCompleteListResult, certifyCompleteListResult, createCompleteListOptions, inspectCompleteListResult } from "./query/complete-list.js";
-import { buildWorkspaceExtensionCommandContracts, buildWorkspaceFieldContracts, } from "./workspace-contracts.js";
-import { PM_TOOL_ACTIONS } from "./cli-contracts/enum-contracts.js";
-import { clearWorkspaceContractsCache, memoizeWorkspaceExtensionRegistrations, } from "./workspace-contracts-cache.js";
-import { SDK_ACTION_ALIASES } from "./runtime-action-aliases.js";
-import { createExtensionCommandSdk } from "./extension-command-context.js";
-import { createUnknownSubcommandError } from "./agent/subcommand-recovery.js";
-import { applyContextIntentProjection, attachReadOutputContracts, } from "./context-intent-contracts.js";
-import { finalizeContextUsageEgress } from "./context/usage-egress.js";
-import { runWithDiscoveredContextIntentContracts, } from "./context-intent-runtime.js";
-import { normalizeReadOutputIncludeModeOptions, validateReadOutputOptions, } from "./read-output-contracts.js";
-export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { normalizeActivityProjectionOptions, runActivity, } from "./query/activity.js";
-import { runAssuranceDispatch } from "./governance/assurance-action.js";
-import { runAggregate, } from "./query/aggregate.js";
-import { runAppend } from "./lifecycle/append.js";
-import { runClaim, runClaimNext, runRelease } from "./lifecycle/claim.js";
-import { runCloseMany } from "./lifecycle/close-many.js";
-import { normalizeAnnotationTransportOptions } from "./annotations.js";
-import { runComments } from "./comments.js";
-import { runHistory } from "./query/history.js";
-import { runLearnings } from "./learnings.js";
-import { runNotes } from "./notes.js";
-import { runUpdateMany } from "./lifecycle/update-many.js";
-import { runUpgrade, } from "./governance/upgrade.js";
-import { runCreate } from "./lifecycle/create.js";
-import { runUpdate } from "./lifecycle/update.js";
-import { runPlan, } from "./lifecycle/plan.js";
-import { runContext, } from "./query/context.js";
-import { runNext } from "./query/next.js";
-import { runClose } from "./lifecycle/close.js";
-import { runCopy } from "./lifecycle/copy.js";
-import { runDelete } from "./lifecycle/delete.js";
-import { runRestore } from "./lifecycle/restore.js";
-import { runFocus } from "./lifecycle/focus.js";
-import { runGet } from "./query/get.js";
-import { runGc, } from "./governance/gc.js";
-import { runHealth, } from "./governance/health.js";
-import { runValidate, } from "./governance/validate.js";
-import { runExtension, } from "./extension.js";
-import { runConfig } from "./config.js";
-import { INIT_INVOCATION_CWD, runInit } from "./init.js";
-import { runRuntimeEvalAction, runRuntimeEventsAction, runRuntimeMergeAction, runRuntimeSchedulingAction, runRuntimeWorkspaceAction, } from "./runtime-extended-actions.js";
-import { acknowledgeUnknownAuthorHistoryEventsFromTransport, } from "./author-attribution.js";
-import { PROFILE_SUBCOMMANDS, runProfileApply, runProfileLint, runProfileList, runProfileShow, } from "./profile.js";
-import { runHistoryRedact, } from "./history-redact.js";
-import { runMcpHistoryCompactAction, runMcpHistoryRepairAction, } from "./history-mcp.js";
-import { runMcpCloseAction, runMcpReopenAction } from "./lifecycle/mcp-actions.js";
-import { actionGlobalOptions as globalOptions, closeManyOptionsFromFlat, extensionOptionsFromArgs, graphOptionsFromFlat, mutationListOptions, mutationOptionsWithOverrides, normalizeActionName, normalizeCommandPath, normalizeMcpOptionsArrays, normalizeMcpUpdateOptions, optionsWithAuthor, parseRuntimeInteger as parseMcpInteger, readRuntimeScalarString as readScalarString, readRuntimeScalarStringAllowBlank as readScalarStringAllowBlank, readRuntimeString as readString, readRuntimeStringArray as readStringArray, resolveRuntimeLimit, shouldInvalidateWorkspaceContractsCacheAfterAction, updateManyOptionsFromFlat, withAddNoteOption, withFilesDiscoveryOptions, withMutationCompaction, } from "./runtime-input.js";
-import { runDeps } from "./dependencies.js";
-import { runDocs } from "./docs.js";
-import { runGraph, } from "./graph/run.js";
-import { runFiles, runFilesDiscover, runFilesLookup } from "./files.js";
-import { runtimeFilesLookupOptions } from "./traceability/runtime-files-lookup.js";
-import { runContracts, } from "./cli-contracts/runtime-contracts.js";
-import { runList } from "./query/list.js";
-import { runSearch, } from "./query/search.js";
-import { runStats, } from "./stats.js";
-import { statsCommandOptionsFromRuntime } from "./runtime-stats-options.js";
-import { runDuplicates, } from "./duplicates.js";
-import { runTelemetry } from "./telemetry.js";
-import { runTest } from "./test/execution.js";
-import { runTestAll } from "./test/batch.js";
-import { resolveStartTaskInProgressStatus } from "./start-task-status.js";
-import { SCHEMA_SUBCOMMANDS, runSchemaAddField, runSchemaAddStatus, runSchemaAddType, runSchemaApplyPreset, runSchemaInferTypes, runSchemaList, runSchemaListFields, runSchemaEvolutionMigration, runSchemaRemoveField, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowField, runSchemaShowStatus, } from "./schema.js";
-export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
-export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
-export { appendHistoryEntry, createHistoryEntry, } from "../core/history/history.js";
-export { classifyHistoryEvent, HISTORY_EVENT_CLASSIFICATION_VERSION, MAINTENANCE_HISTORY_OPERATIONS, SUBSTANTIVE_HISTORY_OPERATIONS } from "../core/history/event-classification.js";
-export { generateItemId, normalizeItemId, normalizeRawItemId, } from "../core/item/id.js";
-export { readBooleanOption, readCsvListOption, readStringOption, } from "./package-runtime-options.js";
-export { PM_CLI_EXPECTED_ERROR_NAME, createPmCliExpectedError, isPmCliExpectedError, } from "./errors.js";
-export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, } from "./package-import-adapters.js";
-export { canonicalDocument, normalizeItemMetadata, serializeItemDocument, splitFrontMatter, } from "../core/item/item-format.js";
-export { BASELINE_ITEM_FORMAT_VERSION, CURRENT_ITEM_FORMAT_VERSION, classifyItemFormatVersion, effectiveItemFormatVersion, normalizeItemFormatVersion, scanItemFormatVersions, } from "../core/item/item-format-version.js";
-export { parseTags } from "../core/item/parse.js";
-export { isTerminalStatus, normalizeStatusInput } from "../core/item/status.js";
-export { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-export { acquireLock } from "../core/lock/lock.js";
-export { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../core/schema/runtime-schema.js";
-export { EXIT_CODE };
-export { PmCliError } from "../core/shared/errors.js";
-export { isTimestampLiteral, nowIso } from "../core/shared/time.js";
-export { jaccardSimilarity, normalizeSimilarityText, scoreItemSimilarity, tokenizeSimilarityText, } from "./similarity-scoring.js";
-export { listAllItemMetadata, listAllItemMetadataLight, locateItem, readLocatedItem, } from "../core/store/item-store.js";
-export { getHistoryPath, getItemPath, getSettingsPath, resolveImplicitPmRoot, resolvePmRoot, } from "../core/store/paths.js";
-export { readSettings } from "../core/store/settings.js";
-export { runAggregate, } from "./query/aggregate.js";
-export { CONTEXT_OUTPUT_VALUES, runContext, } from "./query/context.js";
-export { runGet } from "./query/get.js";
-export { runList, } from "./query/list.js";
-export { closeItem, runClose, } from "./lifecycle/close.js";
-export { runCopy, } from "./lifecycle/copy.js";
-export { runDelete, } from "./lifecycle/delete.js";
-export { runFocus, } from "./lifecycle/focus.js";
-export { runRestore, } from "./lifecycle/restore.js";
-export { DEFAULT_TERMINAL_TRANSITION_POLICY, applyTerminalOrderingPolicy, requireTerminalReason, resolveTerminalReason, } from "./lifecycle-policy.js";
-export { runUpdate } from "./lifecycle/update.js";
-export { runReopen } from "./lifecycle/reopen.js";
-export { NEXT_OUTPUT_VALUES, runNext, } from "./query/next.js";
-export { runSearch, } from "./query/search.js";
-export { runStats, } from "./stats.js";
-export { runDuplicates, } from "./duplicates.js";
-export { renderCalendarMarkdown, renderCalendarToon, resolveCalendarOutputFormat, runCalendar, } from "./query/calendar.js";
-export { renderGuideMarkdown, resolveGuideOutputFormat, runGuide, } from "./guide.js";
-export { runCompletion, } from "./completion.js";
-export { runReindex, } from "./governance/reindex.js";
-export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "./templates.js";
-export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, } from "./test/runs.js";
-export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
-const ACTIVE_EXTENSION_HOST_CONTEXT = Symbol("pm.active-extension-host-context");
-function splitFullClientMutationOptions(options) {
-    return { fullChangedFields: true, options };
-}
-/**
- * Programmatic pm client for custom tools, CI jobs, bots, and embedded runtimes.
- *
- * Extension registries are request-local, so calls that resolve workspaces from
- * `pmRoot` can activate and dispatch concurrently without leaking registrations
- * across clients. Calls with an explicit `cwd` remain serialized because
- * `process.chdir` is process-global.
- *
- * Convenience methods accept command options only. Use {@link PmClient.run} for
- * per-call runtime overrides such as `cwd`, `path`, or `noExtensions`.
- */
-export class PmClient {
-    defaults;
-    /** Create a client with workspace, author, and extension-loading defaults. */
-    constructor(options = {}) {
-        this.defaults = {
-            ...(options.pmRoot === undefined ? {} : { path: options.pmRoot }),
-            ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
-            ...(options.author === undefined ? {} : { author: options.author }),
-            ...(options.noExtensions === undefined
-                ? {}
-                : { noExtensions: options.noExtensions }),
-        };
-    }
-    /** Create a native-action client that reuses an extension host's active schema context. */
-    static forActiveExtensionHost(options) {
-        const client = new PmClient({ ...options, noExtensions: true });
-        client.defaults[ACTIVE_EXTENSION_HOST_CONTEXT] = true;
-        return client;
-    }
-    /** Run any native or extension-contributed action through the SDK dispatcher. */
-    run(action, args = {}) {
-        return runAction({ ...this.defaults, ...args, action });
-    }
-    runTyped(action, args = {}) {
-        return this.run(action, args);
-    }
-    /** Return the same context snapshot produced by `pm context`. */
-    context(options = {}) {
-        return this.runTyped("context", { options });
-    }
-    /** Read every item through the scalar-only metadata cache without materializing heavy collections or bodies. */
-    listAllItemMetadataLight() {
-        return listClientItemMetadataLight(this.defaults.path, this.defaults.cwd);
-    }
-    /** List items with the MCP/agent compact defaults. */
-    list(options = {}) {
-        return this.runTyped("list", { options });
-    }
-    /** Return every status and full item row only after fail-closed corpus certification. */
-    async listAllComplete(options = {}) { return certifyCompleteListResult(await this.list(createCompleteListOptions(options))); }
-    /** Search items with the MCP/agent compact defaults. */
-    search(query, options = {}) {
-        return this.runTyped("search", { query, options });
-    }
-    /** Read one item by id. */
-    get(id, options = {}) {
-        return this.runTyped("get", { id, options });
-    }
-    /** Return the ranked next-work recommendation produced by `pm next`. */
-    next(options = {}) {
-        return this.runTyped("next", { options });
-    }
-    /** Group matching items with the same semantics as `pm aggregate`. */
-    aggregate(options = {}) {
-        return this.runTyped("aggregate", { options });
-    }
-    /** Return project tracker statistics with the same sections as `pm stats`. */
-    stats(options = {}) {
-        return this.runTyped("stats", { options });
-    }
-    /** Discover existing duplicate clusters without mutating tracker state. */
-    duplicates(options = {}) {
-        return this.runTyped("duplicates", { options });
-    }
-    /** List or mutate comments, including lock-scoped idempotent appends. */
-    comments(id, options = {}) {
-        return this.runTyped("comments", { id, options });
-    }
-    /** List or mutate private notes, including lock-scoped idempotent appends. */
-    notes(id, options = {}) {
-        return this.runTyped("notes", { id, options });
-    }
-    /** List or mutate durable learnings, including lock-scoped idempotent appends. */
-    learnings(id, options = {}) {
-        return this.runTyped("learnings", { id, options });
-    }
-    /** Add, remove, clear, or list linked project files for an item. */
-    files(id, options = {}) {
-        return this.runTyped("files", { id, options });
-    }
-    /** Discover and optionally attach changed files for an item. */
-    filesDiscover(id, options = {}) {
-        return this.runTyped("files-discover", { id, options });
-    }
-    /** Find the items that reference one or more source paths. */
-    filesLookup(options) {
-        return this.runTyped("files-lookup", { options });
-    }
-    /** Add, remove, clear, or list linked documentation for an item. */
-    docs(id, options = {}) {
-        return this.runTyped("docs", { id, options });
-    }
-    /** Inspect item dependency relationships. */
-    deps(id, options = {}) {
-        return this.runTyped("deps", { id, options });
-    }
-    /** Run bounded workspace graph traversal, analytics, or governance-audit queries. */
-    graph(subcommand, ids = {}, options = {}) {
-        return this.runTyped("graph", { subcommand, ...ids, options });
-    }
-    /** Append markdown/body text to an item through the mutation pipeline. */
-    append(id, body, options = {}) {
-        return this.runTyped("append", {
-            id,
-            ...splitFullClientMutationOptions(mutationOptionsWithOverrides(options, { body })),
-        });
-    }
-    /** Initialize a workspace with the same semantics as `pm init`. */
-    init(prefix, options = {}) {
-        return this.runTyped("init", {
-            ...(prefix === undefined ? {} : { prefix }),
-            options,
-        });
-    }
-    /** Read or update project/global configuration. */
-    config(scope, configAction, key, value, options = {}) {
-        return this.runTyped("config", {
-            scope,
-            configAction,
-            ...(key === undefined ? {} : { key }),
-            ...(value === undefined ? {} : { value }),
-            options,
-        });
-    }
-    /** Run the schema customization surface. */
-    schema(subcommand, options = {}) {
-        return this.runTyped("schema", { options: { ...options, subcommand } });
-    }
-    /** List built-in, custom, and extension-provided schema types/statuses. */
-    schemaList() {
-        return this.runTyped("schema", { options: { subcommand: "list" } });
-    }
-    /** Show a schema item type definition. */
-    schemaShow(name) {
-        return this.runTyped("schema", { name, options: { subcommand: "show" } });
-    }
-    /** Register or replace a custom item type. */
-    schemaAddType(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "add-type" },
-        });
-    }
-    /** Remove a custom item type. */
-    schemaRemoveType(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "remove-type" },
-        });
-    }
-    /** Register or replace a custom status. */
-    schemaAddStatus(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "add-status" },
-        });
-    }
-    /** Remove a custom status. */
-    schemaRemoveStatus(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "remove-status" },
-        });
-    }
-    /** Register or replace a runtime custom field. */
-    schemaAddField(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "add-field" },
-        });
-    }
-    /** Remove a runtime custom field. */
-    schemaRemoveField(name, options = {}) {
-        return this.runTyped("schema", {
-            name,
-            options: { ...options, subcommand: "remove-field" },
-        });
-    }
-    /** List runtime custom fields. */
-    schemaListFields() {
-        return this.runTyped("schema", { options: { subcommand: "list-fields" } });
-    }
-    /** Show one runtime custom field definition. */
-    schemaShowField(name) {
-        return this.runTyped("schema", {
-            name,
-            options: { subcommand: "show-field" },
-        });
-    }
-    /** Apply a built-in type preset to the workspace schema. */
-    schemaApplyPreset(typePreset, options = {}) {
-        return this.runTyped("schema", {
-            typePreset,
-            options: { ...options, subcommand: "apply-preset" },
-        });
-    }
-    /** Infer item types from the current tracker and optionally apply them. */
-    schemaInferTypes(options = {}) {
-        return this.runTyped("schema", {
-            options: { ...options, subcommand: "add-type", infer: true },
-        });
-    }
-    /** Rename a custom item type and migrate every affected item atomically. */
-    schemaRenameType(from, to, options) {
-        return this.runTyped("schema", {
-            name: from,
-            options: { ...options, subcommand: "rename-type", to },
-        });
-    }
-    /** Rename a custom metadata field and migrate every affected item atomically. */
-    schemaRenameField(from, to, options, type) {
-        return this.runTyped("schema", {
-            name: from,
-            options: {
-                ...options,
-                subcommand: "rename-field",
-                to,
-                ...(type ? { fieldTypeScope: type } : {}),
-            },
-        });
-    }
-    /** Remap a custom lifecycle status and migrate every affected item atomically. */
-    schemaRemapStatus(from, to, options) {
-        return this.runTyped("schema", {
-            name: from,
-            options: { ...options, subcommand: "remap-status", to },
-        });
-    }
-    /** Show one runtime status definition. */
-    schemaShowStatus(name) {
-        return this.runTyped("schema", {
-            name,
-            options: { subcommand: "show-status" },
-        });
-    }
-    /** Run the profile customization surface. */
-    profile(subcommand, options = {}) {
-        return this.runTyped("profile", { options: { ...options, subcommand } });
-    }
-    /** List available project profiles. */
-    profileList() {
-        return this.runTyped("profile", { options: { subcommand: "list" } });
-    }
-    /** Show a project profile. */
-    profileShow(name) {
-        return this.runTyped("profile", { name, options: { subcommand: "show" } });
-    }
-    /** Apply a project profile. */
-    profileApply(name, options = {}) {
-        return this.runTyped("profile", {
-            name,
-            options: { ...options, subcommand: "apply" },
-        });
-    }
-    /** Lint a project profile. */
-    profileLint(name) {
-        return this.runTyped("profile", { name, options: { subcommand: "lint" } });
-    }
-    /** Run project validation checks. */
-    validate(options = {}) {
-        return this.runTyped("validate", { options });
-    }
-    /** Run project health checks. */
-    health(options = {}) {
-        return this.runTyped("health", { options });
-    }
-    /** Run tracker cache/runtime garbage collection. */
-    gc(options = {}) {
-        return this.runTyped("gc", { options });
-    }
-    /** Declare, inspect, or evaluate a project assurance contract. */
-    assurance(input) {
-        return this.runTyped("assurance", { options: { ...input, subcommand: input.action } });
-    }
-    /** Redact sensitive values while preserving an audited, verified history chain. */
-    historyRedact(id, options) {
-        return this.runTyped("history-redact", { id, options });
-    }
-    /** Repair and re-anchor one drifted history stream. */
-    historyRepair(id, options = {}) {
-        return this.runTyped("history-repair", { id, options });
-    }
-    /** Scan and repair every drifted history stream in one resilient pass. */
-    historyRepairAll(options = {}) {
-        return this.runTyped("history-repair", {
-            options: { ...options, all: true },
-        });
-    }
-    /** Compact one history stream into a verified checkpoint and retained tail. */
-    historyCompact(id, options = {}) {
-        return this.runTyped("history-compact", { id, options });
-    }
-    /** Compact an explicit or policy-selected set of history streams. */
-    historyCompactBulk(options) {
-        return this.runTyped("history-compact", { options });
-    }
-    /** Disposition immutable unknown-author events through append-only audit history. */
-    historyAuthorAcknowledge(options) {
-        return this.runTyped("history-author-acknowledge", {
-            historyEvent: (options.events ?? []).map((event) => `${event.item_id}:${String(event.line)}`),
-            allActionable: options.all_actionable === true,
-            dryRun: options.dry_run === true, planFingerprint: options.plan_fingerprint, limit: options.coordinate_limit,
-            attributedAuthor: options.attributed_author,
-            reviewer: options.reviewer,
-            reason: options.reason,
-        });
-    }
-    /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
-    plan(subcommand, id, options = {}, stepRef, reorderTo) {
-        return this.runTyped("plan", {
-            ...(id === undefined ? {} : { id }),
-            ...(stepRef === undefined ? {} : { stepRef }),
-            ...(reorderTo === undefined ? {} : { reorderTo }),
-            options: mutationOptionsWithOverrides(options, { subcommand }),
-        });
-    }
-    /** Create a durable plan with optional ordered seed steps. */
-    planCreate(options) {
-        return this.plan("create", undefined, options);
-    }
-    /** Read a plan using brief, standard, deep, or field-projected output. */
-    planShow(id, options = {}) {
-        return this.plan("show", id, options);
-    }
-    /** Append an ordered step to a plan. */
-    planAddStep(id, options) {
-        return this.plan("add-step", id, options);
-    }
-    /** Update any mutable property of an existing plan step. */
-    planUpdateStep(id, stepRef, options) {
-        return this.plan("update-step", id, options, stepRef);
-    }
-    /** Complete a plan step and record its evidence. */
-    planCompleteStep(id, stepRef, options = {}) {
-        return this.plan("complete-step", id, options, stepRef);
-    }
-    /** Block a plan step with an actionable reason. */
-    planBlockStep(id, stepRef, options) {
-        return this.plan("block-step", id, options, stepRef);
-    }
-    /** Reorder a plan step while preserving stable step identifiers. */
-    planReorderStep(id, stepRef, reorderTo, options = {}) {
-        return this.plan("reorder-step", id, options, stepRef, reorderTo);
-    }
-    /** Remove a step from a plan and compact the remaining order. */
-    planRemoveStep(id, stepRef, options = {}) {
-        return this.plan("remove-step", id, options, stepRef);
-    }
-    /** Link a tracker item to a plan step. */
-    planLink(id, stepRef, options) {
-        return this.plan("link", id, options, stepRef);
-    }
-    /** Remove tracker-item links from a plan step. */
-    planUnlink(id, stepRef, options) {
-        return this.plan("unlink", id, options, stepRef);
-    }
-    /** Append a durable plan decision. */
-    planDecision(id, options) {
-        return this.plan("decision", id, options);
-    }
-    /** Append a durable plan discovery. */
-    planDiscovery(id, options) {
-        return this.plan("discovery", id, options);
-    }
-    /** Append a plan validation expectation or result. */
-    planValidation(id, options) {
-        return this.plan("validation", id, options);
-    }
-    /** Update the bounded resume context for a stateless future agent. */
-    planResume(id, options) {
-        return this.plan("resume", id, options);
-    }
-    /** Approve a plan for execution. */
-    planApprove(id, options = {}) {
-        return this.plan("approve", id, options);
-    }
-    /** Materialize selected plan steps into governed tracker items. */
-    planMaterialize(id, options) {
-        return this.plan("materialize", id, options);
-    }
-    /** Create an item using the same mutation path as `pm create`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
-    create(options = {}) {
-        return this.runTyped("create", splitFullClientMutationOptions(options));
-    }
-    /** Update an item using the same mutation path as `pm update`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
-    update(id, options = {}) {
-        return this.runTyped("update", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Reopen terminal work as a recurrence through the canonical update path. */
-    reopen(id, reason, options = {}) {
-        return this.runTyped("item-reopen", {
-            id,
-            reason,
-            fullChangedFields: true,
-            options,
-        });
-    }
-    /** Close an item using the same mutation path as `pm close`. Options are contract-typed (pm-x29o); the close reason is the positional parameter, so the option bag omits `reason`/`text`. */
-    close(id, reason, options = {}) {
-        return this.runTyped("close", {
-            id,
-            reason,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Claim an item using the same mutation path as `pm claim`. */
-    claim(id, options = {}) {
-        return this.runTyped("claim", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Atomically claim the highest-ranked available item using the public next-work filters. */
-    claimNext(options = {}) {
-        return this.runTyped("claim", {
-            next: true,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Release an item's active claim using the same mutation path as `pm release`. */
-    release(id, options = {}) {
-        return this.runTyped("release", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Copy an item using the same mutation path as `pm copy`. */
-    copy(id, options = {}) {
-        return this.runTyped("copy", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Delete an item using the same mutation path as `pm delete`. */
-    delete(id, options = {}) {
-        return this.runTyped("delete", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Restore an item to a history version or timestamp using `pm restore`. */
-    restore(id, target, options = {}) {
-        return this.runTyped("restore", {
-            fullChangedFields: true,
-            id,
-            options: { ...options, target },
-        });
-    }
-    /** Set, clear, or read workspace focus using the same path as `pm focus`. */
-    focus(id, options = {}) {
-        return this.runTyped("focus", {
-            ...(id === undefined ? {} : { id }),
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Claim an item and transition it to the workspace in-progress status. */
-    startTask(id, options = {}) {
-        return this.runTyped("start-task", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Move an item back to the workspace open status and release the claim. */
-    pauseTask(id, options = {}) {
-        return this.runTyped("pause-task", {
-            id,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Close an item and release its active assignment. */
-    closeTask(id, reason, options = {}) {
-        return this.runTyped("close-task", {
-            id,
-            reason,
-            ...splitFullClientMutationOptions(options),
-        });
-    }
-    /** Run the extension lifecycle surface with the same result shape as `pm extension`. */
-    extension(target, options = {}) {
-        return this.runTyped("extension", {
-            ...(target === undefined ? {} : { target }),
-            options,
-        });
-    }
-    /** List project or global extensions without constructing command-line argv. */
-    extensionList(options = {}) {
-        return this.extension("list", options);
-    }
-    /** Enable an installed extension using the same action as `pm extension activate`. */
-    extensionActivate(target, options = {}) {
-        return this.runTyped("extension-activate", { target, options });
-    }
-    /** Disable an installed extension using the same action as `pm extension deactivate`. */
-    extensionDeactivate(target, options = {}) {
-        return this.runTyped("extension-deactivate", { target, options });
-    }
-    /** Run the package lifecycle surface with package vocabulary preserved. */
-    package(target, options = {}) {
-        return this.runTyped("package", {
-            ...(target === undefined ? {} : { target }),
-            options: { ...options, vocabulary: "package" },
-        });
-    }
-    /** List project or global packages through the package lifecycle primitive. */
-    packageList(options = {}) {
-        return this.package("list", options);
-    }
-    /** Install a package or extension source using the same action as `pm package install`. */
-    packageInstall(target, options = {}) {
-        return this.runTyped("package-install", { target, options });
-    }
-    /** Uninstall a package or extension using the same action as `pm package uninstall`. */
-    packageUninstall(target, options = {}) {
-        return this.runTyped("package-uninstall", { target, options });
-    }
-    /** Read package lifecycle diagnostics using the same action as `pm package doctor`. */
-    packageDoctor(options = {}) {
-        return this.runTyped("package-doctor", { options });
-    }
-    /** Inspect managed package state using the same action as `pm package manage`. */
-    packageManage(target, options = {}) {
-        return this.runTyped("package-manage", {
-            ...(target === undefined ? {} : { target }),
-            options,
-        });
-    }
-    /** Describe installed package surfaces using the same action as `pm package describe`. */
-    packageDescribe(target, options = {}) {
-        return this.runTyped("package-describe", {
-            ...(target === undefined ? {} : { target }),
-            options,
-        });
-    }
-    /** Reload installed package extensions using the same action as `pm package reload`. */
-    packageReload(options = {}) {
-        return this.runTyped("package-reload", { options });
-    }
-    /** Read bundled package catalog metadata using the same action as `pm package catalog`. */
-    packageCatalog(options = {}) { return this.runTyped("package-catalog", { options }); }
-    /** Enable an installed package using the same action as `pm package activate`. */
-    packageActivate(target, options = {}) {
-        return this.runTyped("package-activate", { target, options });
-    }
-    /** Disable an installed package using the same action as `pm package deactivate`. */
-    packageDeactivate(target, options = {}) {
-        return this.runTyped("package-deactivate", { target, options });
-    }
-    /** Plan or apply active package migrations with durable workspace receipts. */
-    packageMigrate(options = {}) {
-        return this.package(undefined, { ...options, migrate: true });
-    }
-    /** Upgrade the pm CLI and/or managed packages through the public SDK dispatcher. */
-    upgrade(target, options = {}) {
-        return this.runTyped("upgrade", {
-            ...(target === undefined ? {} : { target }),
-            options,
-        });
-    }
-}
-/** Return the same context snapshot produced by `pm context` without constructing a reusable client. */
-export function context(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).context(options);
-}
-/** List items with the MCP/agent compact defaults without constructing a reusable client. */
-export function list(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).list(options);
-}
-/** Return every status and full item row with fail-closed corpus proof. */
-export function listAllComplete(options = {}, clientOptions = {}) { return new PmClient(clientOptions).listAllComplete(options); }
-/** Search items with the MCP/agent compact defaults without constructing a reusable client. */
-export function search(query, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).search(query, options);
-}
-/** Read one item by id without constructing a reusable client. */
-export function get(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).get(id, options);
-}
-/** Return the ranked next-work recommendation produced by `pm next` without constructing a reusable client. */
-export function next(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).next(options);
-}
-/** Group matching items with the same semantics as `pm aggregate` without constructing a reusable client. */
-export function aggregate(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).aggregate(options);
-}
-/** Return project tracker statistics with the same sections as `pm stats` without constructing a reusable client. */
-export function stats(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).stats(options);
-}
-/** Discover duplicate clusters without constructing a reusable client. */
-export function duplicates(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).duplicates(options);
-}
-/** List or mutate comments with optional idempotency without constructing a client. */
-export function comments(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).comments(id, options);
-}
-/** List or mutate private notes with optional idempotency without constructing a client. */
-export function notes(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).notes(id, options);
-}
-/** List or mutate durable learnings with optional idempotency without constructing a client. */
-export function learnings(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).learnings(id, options);
-}
-/** Manage linked item files without constructing a reusable client. */
-export function files(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).files(id, options);
-}
-/** Discover linked item files without constructing a reusable client. */
-export function filesDiscover(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).filesDiscover(id, options);
-}
-/** Resolve items linked to source paths without constructing a reusable client. */
-export function filesLookup(options, clientOptions = {}) {
-    return new PmClient(clientOptions).filesLookup(options);
-}
-/** Manage linked item docs without constructing a reusable client. */
-export function docs(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).docs(id, options);
-}
-/** Inspect item dependency relationships without constructing a reusable client. */
-export function deps(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).deps(id, options);
-}
-/** Run bounded workspace graph queries without constructing a reusable client. */
-export function graph(subcommand, ids = {}, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).graph(subcommand, ids, options);
-}
-/** Append markdown/body text to an item without constructing a reusable client. */
-export function append(id, body, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).append(id, body, options);
-}
-/** Initialize a workspace without constructing a reusable client. */
-export function init(prefix, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).init(prefix, options);
-}
-/** Read or update configuration without constructing a reusable client. */
-export function config(scope, configAction, key, value, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).config(scope, configAction, key, value, options);
-}
-/** Run the schema customization surface without constructing a reusable client. */
-export function schema(subcommand, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schema(subcommand, options);
-}
-/** List schema definitions without constructing a reusable client. */
-export function schemaList(clientOptions = {}) {
-    return new PmClient(clientOptions).schemaList();
-}
-/** Show a schema item type without constructing a reusable client. */
-export function schemaShow(name, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaShow(name);
-}
-/** Register a custom item type without constructing a reusable client. */
-export function schemaAddType(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaAddType(name, options);
-}
-/** Remove a custom item type without constructing a reusable client. */
-export function schemaRemoveType(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRemoveType(name, options);
-}
-/** Register a custom status without constructing a reusable client. */
-export function schemaAddStatus(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaAddStatus(name, options);
-}
-/** Remove a custom status without constructing a reusable client. */
-export function schemaRemoveStatus(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRemoveStatus(name, options);
-}
-/** Register a custom field without constructing a reusable client. */
-export function schemaAddField(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaAddField(name, options);
-}
-/** Remove a custom field without constructing a reusable client. */
-export function schemaRemoveField(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRemoveField(name, options);
-}
-/** List custom fields without constructing a reusable client. */
-export function schemaListFields(clientOptions = {}) {
-    return new PmClient(clientOptions).schemaListFields();
-}
-/** Show a custom field without constructing a reusable client. */
-export function schemaShowField(name, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaShowField(name);
-}
-/** Apply a schema preset without constructing a reusable client. */
-export function schemaApplyPreset(typePreset, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaApplyPreset(typePreset, options);
-}
-/** Infer schema types without constructing a reusable client. */
-export function schemaInferTypes(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaInferTypes(options);
-}
-/** Rename a custom item type without constructing a reusable client. */
-export function schemaRenameType(from, to, options, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRenameType(from, to, options);
-}
-/** Rename a custom field without constructing a reusable client. */
-export function schemaRenameField(from, to, options, type, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRenameField(from, to, options, type);
-}
-/** Remap a custom status without constructing a reusable client. */
-export function schemaRemapStatus(from, to, options, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaRemapStatus(from, to, options);
-}
-/** Show a custom status without constructing a reusable client. */
-export function schemaShowStatus(name, clientOptions = {}) {
-    return new PmClient(clientOptions).schemaShowStatus(name);
-}
-/** Run the profile customization surface without constructing a reusable client. */
-export function profile(subcommand, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).profile(subcommand, options);
-}
-/** List profiles without constructing a reusable client. */
-export function profileList(clientOptions = {}) {
-    return new PmClient(clientOptions).profileList();
-}
-/** Show a profile without constructing a reusable client. */
-export function profileShow(name, clientOptions = {}) {
-    return new PmClient(clientOptions).profileShow(name);
-}
-/** Apply a profile without constructing a reusable client. */
-export function profileApply(name, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).profileApply(name, options);
-}
-/** Lint a profile without constructing a reusable client. */
-export function profileLint(name, clientOptions = {}) {
-    return new PmClient(clientOptions).profileLint(name);
-}
-/** Validate a tracker without constructing a reusable client. */
-export function validate(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).validate(options);
-}
-/** Run health checks without constructing a reusable client. */
-export function health(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).health(options);
-}
-/** Run cache/runtime garbage collection without constructing a reusable client. */
-export function gc(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).gc(options);
-}
-/** Redact one history stream without constructing a reusable client. */
-export function historyRedact(id, options, clientOptions = {}) {
-    return new PmClient(clientOptions).historyRedact(id, options);
-}
-/** Repair one history stream without constructing a reusable client. */
-export function historyRepair(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).historyRepair(id, options);
-}
-/** Repair all drifted history streams without constructing a reusable client. */
-export function historyRepairAll(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).historyRepairAll(options);
-}
-/** Compact one history stream without constructing a reusable client. */
-export function historyCompact(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).historyCompact(id, options);
-}
-/** Compact selected history streams without constructing a reusable client. */
-export function historyCompactBulk(options, clientOptions = {}) {
-    return new PmClient(clientOptions).historyCompactBulk(options);
-}
-/** Create an item without constructing a reusable client. */
-export function create(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).create(options);
-}
-/** Update an item without constructing a reusable client. */
-export function update(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).update(id, options);
-}
-/** Reopen terminal work as a recurrence without constructing a reusable client. */
-export function reopen(id, reason, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).reopen(id, reason, options);
-}
-/** Close an item without constructing a reusable client. */
-export function close(id, reason, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).close(id, reason, options);
-}
-/** Claim an item without constructing a reusable client. */
-export function claim(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).claim(id, options);
-}
-/** Atomically select and claim ranked work without constructing a reusable client. */
-export function claimNext(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).claimNext(options);
-}
-/** Release an item's active claim without constructing a reusable client. */
-export function release(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).release(id, options);
-}
-/** Copy an item without constructing a reusable client. */
-export function copy(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).copy(id, options);
-}
-/** Delete an item without constructing a reusable client. */
-export function deleteItem(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).delete(id, options);
-}
-/** Restore an item without constructing a reusable client. */
-export function restore(id, target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).restore(id, target, options);
-}
-/** Set, clear, or read workspace focus without constructing a reusable client. */
-export function focus(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).focus(id, options);
-}
-/** Claim an item and transition it to in-progress without constructing a client. */
-export function startTask(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).startTask(id, options);
-}
-/** Move an item to open and release it without constructing a client. */
-export function pauseTask(id, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).pauseTask(id, options);
-}
-/** Close an item and release its active assignment without constructing a client. */
-export function closeTask(id, reason, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).closeTask(id, reason, options);
-}
-/** Run the extension lifecycle surface without constructing a reusable client. */
-export function extension(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).extension(target, options);
-}
-/** List extensions without constructing a reusable client. */
-export function extensionList(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).extensionList(options);
-}
-/** Enable an extension without constructing a reusable client. */
-export function extensionActivate(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).extensionActivate(target, options);
-}
-/** Disable an extension without constructing a reusable client. */
-export function extensionDeactivate(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).extensionDeactivate(target, options);
-}
-/** Run the package lifecycle surface without constructing a reusable client. */
-export function packageLifecycle(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).package(target, options);
-}
-/** List packages without constructing a reusable client. */
-export function packageList(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageList(options);
-}
-/** Install a package or extension source without constructing a reusable client. */
-export function packageInstall(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageInstall(target, options);
-}
-/** Uninstall a package or extension without constructing a reusable client. */
-export function packageUninstall(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageUninstall(target, options);
-}
-/** Read package lifecycle diagnostics without constructing a reusable client. */
-export function packageDoctor(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageDoctor(options);
-}
-/** Inspect managed package state without constructing a reusable client. */
-export function packageManage(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageManage(target, options);
-}
-/** Describe package surfaces without constructing a reusable client. */
-export function packageDescribe(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageDescribe(target, options);
-}
-/** Reload package extensions without constructing a reusable client. */
-export function packageReload(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageReload(options);
-}
-/** Read bundled package catalog metadata without constructing a reusable client. */
-export function packageCatalog(options = {}, clientOptions = {}) { return new PmClient(clientOptions).packageCatalog(options); }
-/** Enable a package without constructing a reusable client. */
-export function packageActivate(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageActivate(target, options);
-}
-/** Disable a package without constructing a reusable client. */
-export function packageDeactivate(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageDeactivate(target, options);
-}
-/** Upgrade the pm CLI and/or managed packages without constructing a reusable client. */
-export function upgrade(target, options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).upgrade(target, options);
-}
-/**
- * Process-lifetime memo of activated extension registrations, keyed by resolved
- * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently
- * called by importers and package runtimes that cannot thread a registry
- * through; without the memo each call re-discovers, re-imports, and re-activates
- * every extension.
- *
- * Invalidation story: entries are size-bounded and otherwise live until cleared.
- * One-shot CLI processes are trivially correct. Long-lived hosts (e.g. the MCP
- * server) must either pass `options.extensionRegistrations` (which bypasses the
- * memo) or call {@link clearWorkspaceContractsCache} after installing/removing/
- * toggling extensions or editing settings. Settings themselves are re-read on
- * every call — only the extension load+activate step is memoized.
- */
-function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd) {
-    return JSON.stringify([
-        path.resolve(pmRoot),
-        path.resolve(cwd ?? process.cwd()),
-        settings.extensions.enabled,
-        settings.extensions.disabled,
-        settings.extensions.policy,
-    ]);
-}
-async function resolveWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
-    const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);
-    return memoizeWorkspaceExtensionRegistrations(cacheKey, () => loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd));
-}
-/** Implements get workspace contracts for the public runtime surface of this module. */
-export async function getWorkspaceContracts(pmRoot, options = {}) {
-    const settings = await readSettings(pmRoot);
-    const extensionRegistrations = options.extensionRegistrations ??
-        (options.noExtensions === true
-            ? null
-            : await resolveWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
-    const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
-    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-    const fieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
-    return {
-        types: [...typeRegistry.types],
-        statuses: statusRegistry.definitions.map((definition) => definition.id),
-        openStatus: statusRegistry.open_status,
-        closeStatus: statusRegistry.close_status,
-        canceledStatus: statusRegistry.canceled_status,
-        fields: buildWorkspaceFieldContracts(fieldRegistry.definitions),
-        extensionCommands: buildWorkspaceExtensionCommandContracts(extensionRegistrations?.commands ?? []),
-    };
-}
-/** Implements get contracts for the public runtime surface of this module. */
-export async function getContracts(pmRootOrOptions, options = {}) {
-    const resolvedOptions = typeof pmRootOrOptions === "string"
-        ? { ...options, pmRoot: pmRootOrOptions }
-        : (pmRootOrOptions ?? options);
-    const global = {
-        json: true,
-        quiet: resolvedOptions.quiet ?? true,
-        noExtensions: resolvedOptions.noExtensions ?? false,
-        noPager: true,
-        profile: resolvedOptions.profile ?? false,
-        path: resolvedOptions.pmRoot,
-    };
-    return runContracts(resolvedOptions, global);
-}
-/** Read a required non-empty string from an action argument bag. */
-export function readRequiredString(args, key) {
-    const value = readString(args, key);
-    if (!value) {
-        throw new PmCliError(`Missing required argument: ${key}`, 64);
-    }
-    return value;
-}
-// pm-zpoyg9: request-local registries permit independent activation cycles to
-// overlap, but explicit cwd calls still mutate process-global state. The gate
-// retains reader concurrency while making cwd mutation exclusive against every
-// activation path, including callers that resolve paths through process.cwd().
-const extensionActivationGate = createAsyncReadWriteGate();
-const activeExtensionScope = new AsyncLocalStorage();
-/** Publishes empty active extension registries so built-in fallback actions cannot observe stale or partially published extension state from a failed activation cycle. */
-function resetActiveExtensionRegistries() {
-    setActiveExtensionHooks(createEmptyExtensionHookRegistry());
-    setActiveExtensionCommands(createEmptyExtensionCommandRegistry());
-    setActiveExtensionParsers(createEmptyExtensionParserRegistry());
-    setActiveExtensionPreflight(createEmptyExtensionPreflightRegistry());
-    setActiveExtensionServices(createEmptyExtensionServiceRegistry());
-    setActiveExtensionRenderers(createEmptyExtensionRendererRegistry());
-    setActiveExtensionRegistrations(createEmptyExtensionRegistrationRegistry());
-}
-/**
- * Run `run` with workspace extensions loaded, activated, and published to the
- * process-global active registries, then torn down afterwards. pm-zumn: built-in native
- * actions (pm_list/pm_profile/pm_schema/pm_create/...) read
- * `getActiveExtensionRegistrations()` for custom item types, fields, and profiles, so
- * they must activate extensions exactly like the CLI (main.ts activates for every
- * command). Previously only the dynamic-extension dispatch activated, leaving
- * extension-contributed schema and profiles invisible over MCP for every built-in
- * action. Activation is skipped (`run` receives `null`) when extensions are disabled or
- * no workspace exists yet (for example `init`). EVERY action — activating or not — is
- * isolated through an async-local registry context. Calls with an explicit `cwd`
- * acquire exclusive access because `process.chdir` is process-global; calls that use
- * workspace/path arguments share read access and remain concurrent when no cwd writer
- * was already scheduled.
- */
-async function withActiveExtensions(global, explicitCwd, resolutionCwd, run) {
-    return runWithIsolatedExtensionRuntime(() => explicitCwd === undefined
-        ? extensionActivationGate.read(() => withActiveExtensionsExclusively(global, resolutionCwd, run))
-        : extensionActivationGate.write(() => withCwd(explicitCwd, () => withActiveExtensionsExclusively(global, resolutionCwd, run))));
-}
-/**
- * Execute direct SDK work while workspace extensions are loaded and published
- * to request-local active registries. Use this for SDK operations that bypass
- * {@link runAction} but still create or update extension-owned item shapes.
- */
-export async function runWithActiveExtensions(options, run) {
-    const explicitCwd = options.cwd;
-    const resolutionCwd = explicitCwd ?? process.cwd();
-    return withActiveExtensions(globalOptions({ path: options.path, noExtensions: options.noExtensions }), explicitCwd, resolutionCwd, () => activeExtensionScope.run(true, run));
-}
-/**
- * Body of one activation cycle. {@link withActiveExtensions} supplies an
- * async-local registry context; explicit-cwd callers additionally hold the
- * process-wide cwd queue. Returns early with `run(null)` when extensions are
- * disabled or no workspace
- * exists yet, so those built-in actions also observe a stable (empty) registry. MCP and
- * PmClient callers reload + reactivate extensions per request, so each call is a fresh
- * cycle with teardown in a finally to release resources opened during activate() (the
- * long-running-server reload contract, pm-k1e4). Load/activate failures are swallowed and
- * `run` is invoked with `null`, mirroring the CLI's resilient snapshot loader
- * (loadRuntimeExtensionSnapshot) so a broken extension can never break a built-in action.
- */
-async function withActiveExtensionsExclusively(global, cwd, run) {
-    const pmRoot = resolvePmRoot(cwd, global.path);
-    if (global.noExtensions) {
-        resetActiveExtensionRegistries();
-        return runWithDiscoveredContextIntentContracts({ pmRoot }, () => run(null));
-    }
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        resetActiveExtensionRegistries();
-        return run(null);
-    }
-    let active = null;
-    let activated;
-    try {
-        const settings = await readSettings(pmRoot);
-        const loadResult = await loadExtensions({
-            pmRoot,
-            settings,
-            cwd,
-            noExtensions: false,
-        });
-        const activationResult = await activateExtensions({
-            ...loadResult,
-            loaded: loadResult.loaded,
-        });
-        // Record the teardown handle BEFORE publishing the registries so a throw from any
-        // setActive* setter still runs deactivateExtensions for resources opened during
-        // activate() instead of silently leaking them.
-        activated = { loadResult, activationResult };
-        setActiveExtensionHooks(activationResult.hooks);
-        setActiveExtensionCommands(activationResult.commands);
-        setActiveExtensionParsers(activationResult.parsers);
-        setActiveExtensionPreflight(activationResult.preflight);
-        setActiveExtensionServices(activationResult.services);
-        setActiveExtensionRenderers(activationResult.renderers);
-        setActiveExtensionRegistrations(activationResult.registrations);
-        active = {
-            registrations: activationResult.registrations,
-            commands: activationResult.commands,
-            pmRoot,
-            packages: loadResult.loaded,
-        };
-    }
-    catch (error) {
-        resetActiveExtensionRegistries();
-        // CLI parity (loadRuntimeExtensionSnapshot): a load/activate failure must never
-        // break a built-in action — fall back to running with no active extensions. Surface
-        // the cause on stderr so a broken extension is diagnosable instead of being silently
-        // indistinguishable from a workspace that simply has no extensions.
-        console.error("[pm-sdk] extension activation failed; continuing without active extensions:", error);
-    }
-    try {
-        return await runWithDiscoveredContextIntentContracts({ pmRoot, packages: active?.packages }, () => run(active));
-    }
-    finally {
-        // Reset the process-global active registries FIRST so a torn-down extension's
-        // overrides/hooks cannot leak into a later request in this long-running server
-        // (for example a subsequent pm_list/pm_create) even if teardown below misbehaves.
-        resetActiveExtensionRegistries();
-        // Best-effort teardown of extensions that activated successfully. Skipped when
-        // activation never completed (nothing was set up); guarded so an unexpected throw
-        // cannot escape the finally.
-        if (activated) {
-            await deactivateExtensions(activated.loadResult, activated.activationResult).catch(() => undefined);
-        }
-    }
-}
-/**
- * Resolve `action` against the active extension command registrations and dispatch it.
- * Reached by runAction's default case for dynamic (non-built-in) actions after
- * {@link withActiveExtensions} has published the active registries. `active` is `null`
- * when no extensions are active (disabled, no workspace, or activation failed), in
- * which case no extension command can match and the action is reported unsupported.
- */
-async function dispatchActiveExtensionAction(action, args, options, global, active) {
-    if (!active) {
-        throw new PmCliError(`Unsupported native pm action: ${action}`, EXIT_CODE.USAGE);
-    }
-    const normalizedAction = normalizeActionName(action);
-    const definition = active.registrations.commands.find((entry) => normalizeActionName(entry.action) === normalizedAction);
-    const command = definition?.command ??
-        active.commands.handlers.find((entry) => normalizeActionName(entry.command) === normalizedAction)?.command;
-    if (!command) {
-        throw new PmCliError(`Unsupported native pm action: ${action}`, EXIT_CODE.USAGE);
-    }
-    const handlerResult = await runActiveCommandHandler({
-        command: normalizeCommandPath(command),
-        args: readStringArray(options.args ?? args.args),
-        options: extensionOptionsFromArgs(args, options),
-        global,
-        pm_root: active.pmRoot,
-        sdk: createExtensionCommandSdk(active.pmRoot, PmClient.forActiveExtensionHost({
-            pmRoot: active.pmRoot,
-            author: typeof global.author === "string" && global.author.trim()
-                ? global.author.trim()
-                : "pm-extension",
-        })),
-    });
-    if (!handlerResult.handled) {
-        const suffix = handlerResult.warnings.length > 0
-            ? ` (${handlerResult.warnings.join(", ")})`
-            : "";
-        throw new PmCliError(`Unsupported native pm action: ${action}${suffix}`, EXIT_CODE.USAGE);
-    }
-    return handlerResult.result;
-}
-async function withCwd(cwd, run) {
-    // Only ever called with an explicit, non-empty cwd (readString filters blanks), from
-    // inside the serialized activation queue, so the chdir/restore is exclusive per request
-    // and can never be clobbered by a concurrent caller.
-    const previous = process.cwd();
-    process.chdir(cwd);
-    try {
-        return await run();
-    }
-    finally {
-        process.chdir(previous);
-    }
-}
-function resolveSdkActionInput(args) {
-    const rawAction = readRequiredString(args, "action");
-    const normalizedAction = normalizeActionName(rawAction);
-    const alias = getOwnHandler(SDK_ACTION_ALIASES, normalizedAction);
-    const action = alias?.action ?? normalizedAction;
-    const resolvedArgs = { ...args, action };
-    if (alias?.options !== undefined) {
-        resolvedArgs.options = { ...alias.options, ...asRecordClone(args.options) };
-    }
-    if (action === "package") {
-        resolvedArgs.options = {
-            ...asRecordClone(resolvedArgs.options),
-            vocabulary: "package",
-        };
-    }
-    return { action, args: resolvedArgs };
-}
-/** Execute one native or extension-contributed pm action in-process. */
-export async function runAction(args) {
-    const resolved = resolveSdkActionInput(args);
-    const global = globalOptions(resolved.args);
-    const invalidateWorkspaceContractsCache = shouldInvalidateWorkspaceContractsCacheAfterAction(resolved.action);
-    // pm-zumn: dispatch every action (built-in and dynamic) inside one extension
-    // activation cycle so built-in actions see extension-contributed item types, fields,
-    // and profiles, consistent with the CLI. Snapshot the effective resolution cwd HERE,
-    // at request entry (the explicit args.cwd, else the server's current directory), so the
-    // queued cycle resolves against the directory the request arrived in rather than a value
-    // process.cwd() might hold by the time the task runs. Only an explicit cwd additionally
-    // pins process.cwd() (inside the serialized slot) for the built-in handler.
-    const explicitCwd = readString(resolved.args, "cwd");
-    const resolutionCwd = explicitCwd ?? process.cwd();
-    if (resolved.action === "init") {
-        global[INIT_INVOCATION_CWD] = resolutionCwd;
-    }
-    if (resolved.action !== "init" ||
-        global.path !== undefined ||
-        (process.env.PM_PATH?.trim().length ?? 0) > 0) {
-        global.path = resolvePmRoot(resolutionCwd, global.path);
-    }
-    try {
-        if (args[ACTIVE_EXTENSION_HOST_CONTEXT] === true ||
-            activeExtensionScope.getStore() === true) {
-            return await dispatchAction(resolved.action, resolved.args, global, null);
-        }
-        return await withActiveExtensions(global, explicitCwd, resolutionCwd, (activeExtensions) => dispatchAction(resolved.action, resolved.args, global, activeExtensions));
-    }
-    finally {
-        if (invalidateWorkspaceContractsCache) {
-            clearWorkspaceContractsCache();
-        }
-    }
-}
-function getOwnHandler(handlers, key) {
-    return Object.prototype.hasOwnProperty.call(handlers, key)
-        ? handlers[key]
-        : undefined;
-}
-function readMcpTarget(ctx) {
-    return readString(ctx.args, "target") ?? readString(ctx.options, "target");
-}
-function requireMcpItemId(ctx, source = ctx.options) {
-    return ctx.id ?? readRequiredString(source, "id");
-}
-async function runMcpListAction(ctx) {
-    const listOptions = applyContextIntentProjection("list", ctx.options);
-    if (listOptions.compact === undefined &&
-        listOptions.brief === undefined &&
-        listOptions.full === undefined &&
-        listOptions.fields === undefined &&
-        listOptions.includeBody === undefined) {
-        listOptions.compact = true;
-    }
-    // pm-rmjy: echo applied filters + projection mode so agents get structured confirmation.
-    return withQuerySummary((await runList(readString(ctx.args, "status") ?? readString(listOptions, "status"), listOptions, ctx.global)), listOptions);
-}
-async function runMcpSearchAction(ctx) {
-    const query = readRequiredString(ctx.args, "query");
-    const searchOptions = applyContextIntentProjection("search", ctx.options, [query]);
-    if (searchOptions.compact === undefined &&
-        searchOptions.full === undefined &&
-        searchOptions.fields === undefined) {
-        searchOptions.compact = true;
-    }
-    return withQuerySummary((await runSearch(query, searchOptions, ctx.global)), searchOptions);
-}
-async function runMcpCreateAction(ctx) {
-    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    return projectMutationResult(await runCreate(runnerOptions, ctx.global), {
-        changedFields,
-        compactEnvelope: changedFields === "compact" && !idOnly,
-        idOnly,
-    });
-}
-async function runMcpCopyAction(ctx) {
-    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    const copyOptions = {
-        ...runnerOptions,
-        ...(runnerOptions.title === undefined && typeof ctx.args.title === "string"
-            ? { title: ctx.args.title }
-            : {}),
-        ...(runnerOptions.message === undefined &&
-            typeof ctx.args.message === "string"
-            ? { message: ctx.args.message }
-            : {}),
-    };
-    return projectMutationResult(await runCopy(requireMcpItemId(ctx, copyOptions), copyOptions, ctx.global), {
-        changedFields,
-        compactEnvelope: changedFields === "compact" && !idOnly,
-        idOnly,
-    });
-}
-async function runMcpUpdateAction(ctx) {
-    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    return projectMutationResult(await runUpdate(requireMcpItemId(ctx, runnerOptions), runnerOptions, ctx.global), {
-        changedFields,
-        compactEnvelope: changedFields === "compact" && !idOnly,
-        idOnly,
-    });
-}
-function runMcpCommentsAction(ctx) {
-    const commentOptions = normalizeAnnotationTransportOptions(ctx.options);
-    const isListing = commentOptions.add === undefined &&
-        commentOptions.stdin === undefined &&
-        commentOptions.file === undefined &&
-        commentOptions.edit === undefined &&
-        commentOptions.delete === undefined;
-    if (isListing) {
-        commentOptions.includeMeta = true;
-        if (commentOptions.limit === undefined &&
-            commentOptions.fullHistory !== true) {
-            commentOptions.limit = "20";
-        }
-    }
-    return runComments(requireMcpItemId(ctx), commentOptions, ctx.global);
-}
-function runMcpFilesLookupAction(ctx, paths) {
-    return runFilesLookup(runtimeFilesLookupOptions(ctx.options, paths, parseMcpInteger), ctx.global);
-}
-function runMcpFilesAction(ctx) {
-    const lookupPaths = readStringArray(ctx.options.lookupPath);
-    if (lookupPaths && lookupPaths.length > 0) {
-        return runMcpFilesLookupAction(ctx, lookupPaths);
-    }
-    const fileId = requireMcpItemId(ctx);
-    return ctx.options.discover === true
-        ? runFilesDiscover(fileId, withFilesDiscoveryOptions(ctx.options), ctx.global)
-        : runFiles(fileId, withAddNoteOption(ctx.options), ctx.global);
-}
-function runMcpTelemetryAction(ctx) {
-    return runTelemetry({
-        subcommand: readString(ctx.args, "subcommand") ??
-            readString(ctx.options, "subcommand"),
-        limit: resolveRuntimeLimit(ctx.args, ctx.options),
-    }, ctx.global);
-}
-function runMcpHealthAction(ctx) {
-    const healthOptions = { ...ctx.options };
-    if (healthOptions.brief === undefined &&
-        healthOptions.summary === undefined &&
-        healthOptions.full === undefined) {
-        healthOptions.summary = true;
-    }
-    return runHealth(ctx.global, healthOptions);
-}
-function runMcpConfigAction(ctx) {
-    const configAction = readString(ctx.args, "configAction") ??
-        readString(ctx.options, "configAction") ??
-        readString(ctx.options, "action");
-    if (configAction === undefined)
-        throw new PmCliError("Missing required argument: configAction", 64);
-    const value = readString(ctx.args, "value") ?? readString(ctx.options, "value");
-    const options = readString(ctx.options, "policy") !== undefined && value !== undefined ? { ...ctx.options, value } : ctx.options;
-    return runConfig(readString(ctx.args, "scope") ??
-        readString(ctx.options, "scope") ??
-        "project", configAction, readString(ctx.args, "key") ?? readString(ctx.options, "key"), options, ctx.global, readString(ctx.options, "policy") === undefined ? value : undefined);
-}
-function runMcpActivityAction(ctx) {
-    const options = ctx.options;
-    return runActivity(normalizeActivityProjectionOptions(options), ctx.global);
-}
-function parseMcpIntegerPrefix(value, label) {
-    if (typeof value === "number") {
-        if (!Number.isFinite(value) || !Number.isInteger(value)) {
-            throw new PmCliError(`${label} must be a finite integer.`, 64);
-        }
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const trimmed = value.trim();
-        if (!/^[+-]?\d+(?:st|nd|rd|th)?$/i.test(trimmed)) {
-            throw new PmCliError(`${label} must be a finite integer.`, 64);
-        }
-        const parsed = Number.parseInt(trimmed, 10);
-        if (!Number.isInteger(parsed)) {
-            throw new PmCliError(`${label} must be a finite integer.`, 64);
-        }
-        return parsed;
-    }
-    return undefined;
-}
-function runMcpPlanAction(ctx) {
-    const subcommand = readString(ctx.args, "subcommand") ??
-        readRequiredString(ctx.options, "subcommand");
-    const planRecord = ctx.options;
-    return runPlan({
-        subcommand: subcommand,
-        id: typeof ctx.id === "string"
-            ? ctx.id
-            : typeof planRecord.id === "string"
-                ? planRecord.id
-                : undefined,
-        stepRef: readMcpPlanStepRef(ctx),
-        reorderTo: parseMcpIntegerPrefix(planRecord.reorderTo ?? ctx.args.reorderTo, "plan reorderTo"),
-        options: ctx.options,
-        global: ctx.global,
-    });
-}
-function readMcpPlanStepRef(ctx) {
-    return typeof ctx.options.stepRef === "string"
-        ? ctx.options.stepRef
-        : typeof ctx.args.stepRef === "string"
-            ? ctx.args.stepRef
-            : undefined;
-}
-function createMcpSchemaContext(ctx) {
-    const subcommand = readString(ctx.args, "subcommand") ??
-        readRequiredString(ctx.options, "subcommand");
-    const aliasSource = ctx.args.alias ?? ctx.options.alias;
-    return {
-        ctx,
-        subcommand: subcommand.trim().toLowerCase(),
-        name: readString(ctx.args, "name") ?? readString(ctx.options, "name"),
-        author: readString(ctx.args, "author") ?? readString(ctx.options, "author"),
-        force: ctx.args.force === true || ctx.options.force === true,
-        aliases: aliasSource === undefined ? undefined : readStringArray(aliasSource),
-    };
-}
-function runMcpSchemaReadOrRemoveAction(schema) {
-    const { ctx, subcommand, name, author, force } = schema;
-    const simpleHandlers = {
-        list: () => runSchemaList(ctx.global),
-        show: () => runSchemaShow(name, ctx.global),
-        "show-status": () => runSchemaShowStatus(name, ctx.global),
-        "list-fields": () => runSchemaListFields(ctx.global),
-        "show-field": () => runSchemaShowField(name, ctx.global),
-        "remove-type": () => runSchemaRemoveType(name, { author, force }, ctx.global),
-        "remove-field": () => runSchemaRemoveField(name, { author, force }, ctx.global),
-        "remove-status": () => runSchemaRemoveStatus(name, { author, force }, ctx.global),
-        "apply-preset": () => runSchemaApplyPreset(readString(ctx.args, "typePreset") ??
-            readString(ctx.options, "typePreset"), { author, force }, ctx.global),
-    };
-    const handler = getOwnHandler(simpleHandlers, subcommand);
-    return handler ? handler() : null;
-}
-function runMcpSchemaAddFieldAction(schema) {
-    const { ctx, name, author, force, aliases } = schema;
-    const commandsSource = ctx.args.commands ?? ctx.options.commands;
-    const requiredTypesSource = ctx.args.requiredTypes ?? ctx.options.requiredTypes;
-    return runSchemaAddField(name, {
-        type: readString(ctx.args, "fieldType") ??
-            readString(ctx.options, "fieldType"),
-        commands: commandsSource === undefined
-            ? undefined
-            : readStringArray(commandsSource),
-        description: readString(ctx.args, "description") ??
-            readString(ctx.options, "description"),
-        cliFlag: readString(ctx.args, "cliFlag") ?? readString(ctx.options, "cliFlag"),
-        alias: aliases,
-        required: ctx.args.required === true || ctx.options.required === true,
-        requiredOnCreate: ctx.args.requiredOnCreate === true ||
-            ctx.options.requiredOnCreate === true,
-        allowUnset: !(ctx.args.allowUnset === false || ctx.options.allowUnset === false),
-        requiredTypes: requiredTypesSource === undefined
-            ? undefined
-            : readStringArray(requiredTypesSource),
-        author,
-        force,
-    }, ctx.global);
-}
-function runMcpSchemaAddStatusAction(schema) {
-    const { ctx, name, author, force, aliases } = schema;
-    const roleSource = ctx.args.role ?? ctx.options.role;
-    return runSchemaAddStatus(name, {
-        role: roleSource === undefined ? undefined : readStringArray(roleSource),
-        alias: aliases,
-        description: readString(ctx.args, "description") ??
-            readString(ctx.options, "description"),
-        order: parseMcpInteger(ctx.args.order ?? ctx.options.order, "schema add-status order"),
-        author,
-        force,
-    }, ctx.global);
-}
-function runMcpSchemaAddTypeAction(schema) {
-    const { ctx, name, author, force, aliases } = schema;
-    return runSchemaAddType(name, {
-        description: readString(ctx.args, "description") ??
-            readString(ctx.options, "description"),
-        defaultStatus: readString(ctx.args, "defaultStatus") ??
-            readString(ctx.args, "default_status") ??
-            readString(ctx.options, "defaultStatus") ??
-            readString(ctx.options, "default_status"),
-        folder: readString(ctx.args, "folder") ?? readString(ctx.options, "folder"),
-        alias: aliases,
-        author,
-        force,
-    }, ctx.global);
-}
-function runMcpSchemaMigrationAction(schema) {
-    const { ctx, subcommand, name, author, force } = schema;
-    const to = readString(ctx.args, "to") ?? readRequiredString(ctx.options, "to");
-    const migrationId = readString(ctx.args, "migrationId") ??
-        readString(ctx.args, "migration_id") ??
-        readString(ctx.options, "migrationId") ??
-        readString(ctx.options, "migration_id");
-    const fieldTypeScope = readString(ctx.args, "fieldTypeScope") ??
-        readString(ctx.options, "fieldTypeScope") ??
-        readString(ctx.args, "type") ??
-        readString(ctx.options, "type");
-    const request = subcommand === "rename-type"
-        ? { kind: "rename-type", from: name ?? "", to }
-        : subcommand === "rename-field"
-            ? {
-                kind: "rename-field",
-                from: name ?? "",
-                to,
-                ...(fieldTypeScope === undefined ? {} : { type: fieldTypeScope }),
-            }
-            : { kind: "remap-status", from: name ?? "", to };
-    return runSchemaEvolutionMigration(request, {
-        migrationId,
-        dryRun: ctx.args.dryRun === true || ctx.options.dryRun === true,
-        author,
-        force,
-    }, ctx.global);
-}
-function runMcpSchemaAction(ctx) {
-    const schema = createMcpSchemaContext(ctx);
-    const simpleResult = runMcpSchemaReadOrRemoveAction(schema);
-    if (simpleResult !== null) {
-        return simpleResult;
-    }
-    if (schema.subcommand === "rename-type" ||
-        schema.subcommand === "rename-field" ||
-        schema.subcommand === "remap-status") {
-        return runMcpSchemaMigrationAction(schema);
-    }
-    if (schema.subcommand === "add-field") {
-        return runMcpSchemaAddFieldAction(schema);
-    }
-    if (schema.subcommand === "add-status") {
-        return runMcpSchemaAddStatusAction(schema);
-    }
-    if (schema.subcommand === "add-type") {
-        if (ctx.args.infer === true || ctx.options.infer === true) {
-            return runSchemaInferTypes({
-                minCount: parseMcpInteger(ctx.args.minCount ?? ctx.options.minCount, "schema infer minCount"),
-                apply: ctx.args.apply === true || ctx.options.apply === true,
-                author: schema.author,
-                force: schema.force,
-            }, ctx.global);
-        }
-        return runMcpSchemaAddTypeAction(schema);
-    }
-    throw createUnknownSubcommandError({
-        command_path: "schema",
-        token: schema.subcommand,
-        allowed: SCHEMA_SUBCOMMANDS,
-        exit_code: 64,
-    });
-}
-function runMcpProfileAction(ctx) {
-    const subcommand = readString(ctx.args, "subcommand") ??
-        readRequiredString(ctx.options, "subcommand");
-    const normalizedSubcommand = subcommand.trim().toLowerCase();
-    const profileName = readString(ctx.args, "name") ?? readString(ctx.options, "name");
-    const handlers = {
-        list: () => runProfileList(),
-        show: () => runProfileShow(profileName),
-        lint: () => runProfileLint(profileName),
-        apply: () => runProfileApply(profileName, {
-            dryRun: ctx.args.dryRun === true || ctx.options.dryRun === true,
-            author: readString(ctx.args, "author") ?? readString(ctx.options, "author"),
-            force: ctx.args.force === true || ctx.options.force === true,
-        }, ctx.global),
-    };
-    const handler = getOwnHandler(handlers, normalizedSubcommand);
-    if (!handler) {
-        throw createUnknownSubcommandError({
-            command_path: "profile",
-            token: subcommand,
-            allowed: PROFILE_SUBCOMMANDS,
-            exit_code: 64,
-        });
-    }
-    return handler();
-}
-async function runMcpAppendAction(ctx) {
-    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    return projectMutationResult(await runAppend(requireMcpItemId(ctx, runnerOptions), runnerOptions, ctx.global), {
-        changedFields,
-        compactEnvelope: changedFields === "compact" && !idOnly,
-        idOnly,
-    });
-}
-async function runMcpUpdateManyAction(ctx) {
-    const { changedFields, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    return projectMutationResult(await runUpdateMany(updateManyOptionsFromFlat(runnerOptions), ctx.global), { changedFields });
-}
-async function runMcpCloseManyAction(ctx) {
-    const { changedFields, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    const topLevelReason = readString(ctx.args, "reason");
-    const closeManyRunnerOptions = topLevelReason !== undefined && runnerOptions.reason === undefined
-        ? { ...runnerOptions, reason: topLevelReason }
-        : { ...runnerOptions };
-    if (ctx.force && closeManyRunnerOptions.force === undefined) {
-        closeManyRunnerOptions.force = true;
-    }
-    return projectMutationResult(await runCloseMany(closeManyOptionsFromFlat(closeManyRunnerOptions), ctx.global), { changedFields });
-}
-async function runMcpRestoreAction(ctx) {
-    const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-    const target = readString(runnerOptions, "target") ??
-        readRequiredString(ctx.args, "target");
-    return projectMutationResult(await runRestore(requireMcpItemId(ctx, runnerOptions), target, runnerOptions, ctx.global), {
-        changedFields,
-        compactEnvelope: changedFields === "compact" && !idOnly,
-        idOnly,
-    });
-}
-async function runMcpStartTaskAction(ctx) {
-    const pmRoot = resolvePmRoot(process.cwd(), ctx.global.path);
-    const settings = await readSettings(pmRoot);
-    const inProgressStatus = resolveStartTaskInProgressStatus(resolveRuntimeStatusRegistry(settings.schema));
-    const id = requireMcpItemId(ctx);
-    const claimResult = await runClaim(id, ctx.force, ctx.global, ctx.options);
-    const updateResult = await runUpdate(id, mutationOptionsWithOverrides(ctx.options, { status: inProgressStatus, force: ctx.force }, ["assignee"]), ctx.global);
-    return { id, action: "start_task", claim: claimResult, update: updateResult };
-}
-async function runMcpPauseTaskAction(ctx) {
-    const pmRoot = resolvePmRoot(process.cwd(), ctx.global.path);
-    const settings = await readSettings(pmRoot);
-    const id = requireMcpItemId(ctx);
-    const openStatus = resolveRuntimeStatusRegistry(settings.schema).open_status;
-    const updateResult = await runUpdate(id, mutationOptionsWithOverrides(ctx.options, { status: openStatus, force: ctx.force }, ["assignee"]), ctx.global);
-    const releaseResult = await runRelease(id, ctx.force, ctx.global, ctx.options);
-    return {
-        id,
-        action: "pause_task",
-        update: updateResult,
-        release: releaseResult,
-    };
-}
-async function runMcpCloseTaskAction(ctx) {
-    const id = requireMcpItemId(ctx);
-    const closeReason = readString(ctx.args, "reason") ??
-        readString(ctx.args, "text") ??
-        readString(ctx.options, "reason") ??
-        readString(ctx.options, "text");
-    const closeResult = await runClose(id, closeReason, { ...ctx.options, force: ctx.force }, ctx.global);
-    const releaseResult = await runRelease(id, ctx.force, ctx.global, ctx.options);
-    return {
-        id,
-        action: "close_task",
-        close: closeResult,
-        release: releaseResult,
-    };
-}
-/** Dispatch the graph action merging flat MCP parameters onto runner options. */
-function runMcpGraphAction(ctx) {
-    const merged = { ...ctx.args, ...ctx.options };
-    return runGraph(readRequiredString(merged, "subcommand"), readString(merged, "id") ?? ctx.id, readString(merged, "target"), graphOptionsFromFlat(merged), ctx.global);
-}
-function runMcpHistoryAuthorAcknowledgeAction(ctx) {
-    return acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(), ctx.global.path), { ...ctx.args, ...ctx.options });
-}
-const SDK_ACTION_HANDLERS = {
-    init: (ctx) => runInit(readString(ctx.args, "prefix"), ctx.global, ctx.options),
-    context: (ctx) => runContext(applyContextIntentProjection("context", ctx.options), ctx.global),
-    next: (ctx) => runNext(applyContextIntentProjection("next", ctx.options), ctx.global),
-    eval: runRuntimeEvalAction,
-    events: runRuntimeEventsAction,
-    merge: runRuntimeMergeAction,
-    workspace: runRuntimeWorkspaceAction,
-    meet: runRuntimeSchedulingAction,
-    event: runRuntimeSchedulingAction,
-    remind: runRuntimeSchedulingAction,
-    list: runMcpListAction,
-    get: (ctx) => {
-        const id = requireMcpItemId(ctx);
-        return runGet(id, ctx.global, applyContextIntentProjection("get", ctx.options, [id]));
-    },
-    search: runMcpSearchAction,
-    /** Normalize MCP duplicate controls before delegating to the shared SDK action. */
-    duplicates: (ctx) => {
-        const status = typeof ctx.options.status === "string"
-            ? [ctx.options.status]
-            : readStringArray(ctx.options.status);
-        return runDuplicates(ctx.global, {
-            exhaustive: ctx.options.exhaustive === true,
-            ...(status.length === 0 ? {} : { status }),
-            since: readString(ctx.options, "since"),
-            threshold: typeof ctx.options.threshold === "number"
-                ? ctx.options.threshold
-                : undefined,
-            limit: ctx.options.limit === "default"
-                ? undefined
-                : parseMcpInteger(ctx.options.limit, "limit"),
-        });
-    },
-    create: runMcpCreateAction,
-    copy: runMcpCopyAction,
-    focus: (ctx) => runFocus(ctx.id, { clear: ctx.options.clear === true || ctx.args.clear === true }, ctx.global),
-    update: runMcpUpdateAction,
-    "item-reopen": runMcpReopenAction,
-    restore: runMcpRestoreAction,
-    claim: (ctx) => ctx.options.next === true || ctx.args.next === true
-        ? runClaimNext(ctx.force, ctx.global, { ...ctx.options, ...ctx.args }, { ...ctx.options, ...ctx.args })
-        : runClaim(requireMcpItemId(ctx), ctx.force, ctx.global, ctx.options),
-    release: (ctx) => runRelease(requireMcpItemId(ctx), ctx.force, ctx.global, ctx.options),
-    "start-task": runMcpStartTaskAction,
-    "pause-task": runMcpPauseTaskAction,
-    "close-task": runMcpCloseTaskAction,
-    close: runMcpCloseAction,
-    comments: runMcpCommentsAction,
-    notes: (ctx) => runNotes(requireMcpItemId(ctx), normalizeAnnotationTransportOptions(ctx.options), ctx.global),
-    learnings: (ctx) => runLearnings(requireMcpItemId(ctx), normalizeAnnotationTransportOptions(ctx.options), ctx.global),
-    files: runMcpFilesAction,
-    docs: (ctx) => runDocs(requireMcpItemId(ctx), withAddNoteOption(ctx.options), ctx.global),
-    test: (ctx) => runTest(requireMcpItemId(ctx), ctx.options, ctx.global),
-    "test-all": (ctx) => runTestAll(ctx.options, ctx.global),
-    telemetry: runMcpTelemetryAction,
-    validate: (ctx) => runValidate(ctx.options, ctx.global, {
-        runUpdate: (id, options, global) => runUpdate(id, options, global),
-    }),
-    health: runMcpHealthAction,
-    assurance: (ctx) => runAssuranceDispatch(ctx.args, ctx.options, ctx.global),
-    contracts: (ctx) => runContracts(ctx.options, ctx.global),
-    config: runMcpConfigAction,
-    activity: runMcpActivityAction,
-    aggregate: (ctx) => runAggregate(ctx.options, ctx.global),
-    extension: (ctx) => runExtension(readMcpTarget(ctx), ctx.options, ctx.global),
-    package: (ctx) => runExtension(readMcpTarget(ctx), ctx.options, ctx.global),
-    install: (ctx) => runExtension(readMcpTarget(ctx), { ...ctx.options, install: true }, ctx.global),
-    upgrade: (ctx) => runUpgrade(readMcpTarget(ctx), ctx.options, ctx.global),
-    delete: (ctx) => runDelete(requireMcpItemId(ctx), ctx.options, ctx.global),
-    deps: (ctx) => runDeps(requireMcpItemId(ctx), ctx.options, ctx.global),
-    graph: runMcpGraphAction,
-    "files-discover": (ctx) => runFilesDiscover(requireMcpItemId(ctx), ctx.options, ctx.global),
-    "files-lookup": (ctx) => runMcpFilesLookupAction(ctx, readStringArray(ctx.options.paths)),
-    history: (ctx) => runHistory(requireMcpItemId(ctx), ctx.options, ctx.global),
-    "history-redact": (ctx) => runHistoryRedact(requireMcpItemId(ctx), ctx.options, ctx.global),
-    "history-repair": runMcpHistoryRepairAction,
-    "history-compact": runMcpHistoryCompactAction,
-    "history-author-acknowledge": runMcpHistoryAuthorAcknowledgeAction,
-    plan: runMcpPlanAction,
-    schema: runMcpSchemaAction,
-    profile: runMcpProfileAction,
-    stats: (ctx) => runStats(ctx.global, statsCommandOptionsFromRuntime(ctx.options)),
-    append: runMcpAppendAction,
-    "update-many": runMcpUpdateManyAction,
-    "close-many": runMcpCloseManyAction,
-    gc: (ctx) => runGc(ctx.global, ctx.options),
-};
-/**
- * Derive the SDK dispatch coverage matrix from the live action and alias
- * registries instead of a hand-maintained test list.
- */
-export function analyzeSdkActionCoverage(actions = PM_TOOL_ACTIONS) {
-    return actions.map((action) => {
-        const normalized = normalizeActionName(action);
-        const alias = getOwnHandler(SDK_ACTION_ALIASES, normalized);
-        const resolvedAction = alias?.action ?? normalized;
-        const covered = getOwnHandler(SDK_ACTION_HANDLERS, resolvedAction) !== undefined;
-        return {
-            action,
-            resolved_action: resolvedAction,
-            covered,
-            route: covered ? (alias ? "alias" : "native") : "missing",
-        };
-    });
-}
-async function dispatchAction(action, args, global, activeExtensions) {
-    const options = optionsWithAuthor(args, action);
-    validateReadOutputOptions(action, options);
-    normalizeReadOutputIncludeModeOptions(action, options);
-    const ctx = {
-        action,
-        args,
-        options,
-        id: readString(args, "id"),
-        force: args.force === true || options.force === true,
-        global,
-        activeExtensions,
-    };
-    const handler = getOwnHandler(SDK_ACTION_HANDLERS, action);
-    const result = handler
-        ? await handler(ctx)
-        : await dispatchActiveExtensionAction(action, args, options, global, activeExtensions);
-    options.resolvedOutputFormat = "json";
-    const projected = attachReadOutputContracts(action, options, result);
-    await finalizeContextUsageEgress(resolvePmRoot(process.cwd(), global.path), projected);
-    return projected;
-}
-const actionRunnerTestHooks = {
-    closeManyOptionsFromFlat,
-    extensionOptionsFromArgs,
-    globalOptions,
-    mutationListOptions,
-    normalizeActionName,
-    normalizeCommandPath,
-    normalizeMcpUpdateOptions,
-    normalizeMcpOptionsArrays,
-    optionsWithAuthor,
-    readRequiredString,
-    readScalarString,
-    readScalarStringAllowBlank,
-    readStringArray,
-    updateManyOptionsFromFlat,
-    withAddNoteOption,
-    withFilesDiscoveryOptions,
-    withMutationCompaction,
-};
-if (process.env.NODE_ENV === "test" ||
-    process.env.VITEST !== undefined ||
-    process.env.VITEST_WORKER_ID !== undefined) {
-    globalThis.__pmCliActionRunnerTestHooks = actionRunnerTestHooks;
-}
-async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
-    const loadResult = await loadExtensions({
-        pmRoot,
-        settings,
-        cwd: cwd ?? process.cwd(),
-        noExtensions: false,
-    });
-    const activationResult = await activateExtensions(loadResult);
-    try {
-        return activationResult.registrations;
-    }
-    finally {
-        try {
-            await deactivateExtensions(loadResult, activationResult);
-        }
-        catch {
-            // Workspace contract reads should stay best-effort even if teardown itself fails.
-        }
-    }
-}
+!(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]="f977f0dd-ea74-514e-ba23-838458136332")}catch(e2){}})();import{PM_GITIGNORE_END,PM_GITIGNORE_START,ensurePmGitignore,getPmGitignoreBlock}from"./workspace.js";import{SEARCH_EXTENSION_FLAG_DEFINITIONS}from"./extension-contracts.js";export*from"./cli-contracts/agent-output-contracts.js";import{AsyncLocalStorage}from"node:async_hooks";import path from"node:path";import{createEmptyExtensionCommandRegistry,createEmptyExtensionHookRegistry,createEmptyExtensionParserRegistry,createEmptyExtensionPreflightRegistry,createEmptyExtensionRegistrationRegistry,createEmptyExtensionRendererRegistry,createEmptyExtensionServiceRegistry}from"../core/extensions/extension-registries.js";import{activateExtensions,deactivateExtensions,loadExtensions,runActiveCommandHandler,runWithIsolatedExtensionRuntime,setActiveExtensionCommands,setActiveExtensionHooks,setActiveExtensionParsers,setActiveExtensionPreflight,setActiveExtensionRegistrations,setActiveExtensionRenderers,setActiveExtensionServices}from"../core/extensions/index.js";import{pathExists}from"../core/fs/fs-utils.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{projectMutationResult}from"../core/output/mutation-projection.js";import{withQuerySummary}from"../core/output/query-summary.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{asRecordClone}from"../core/shared/primitives.js";import{createAsyncReadWriteGate}from"../core/shared/serial-queue.js";import{resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry}from"../core/schema/runtime-schema.js";import{getSettingsPath,resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{listClientItemMetadataLight}from"./query/light-metadata.js";import{certifyCompleteListResult,createCompleteListOptions}from"./query/complete-list.js";import{PmCompleteListValidationError,assertCompleteListResult,certifyCompleteListResult as certifyCompleteListResult2,createCompleteListOptions as createCompleteListOptions2,inspectCompleteListResult}from"./query/complete-list.js";import{buildWorkspaceExtensionCommandContracts,buildWorkspaceFieldContracts}from"./workspace-contracts.js";import{PM_TOOL_ACTIONS}from"./cli-contracts/enum-contracts.js";import{clearWorkspaceContractsCache,memoizeWorkspaceExtensionRegistrations}from"./workspace-contracts-cache.js";import{SDK_ACTION_ALIASES}from"./runtime-action-aliases.js";import{createExtensionCommandSdk}from"./extension-command-context.js";import{createUnknownSubcommandError}from"./agent/subcommand-recovery.js";import{applyContextIntentProjection,attachReadOutputContracts}from"./context-intent-contracts.js";import{finalizeContextUsageEgress}from"./context/usage-egress.js";import{runWithDiscoveredContextIntentContracts}from"./context-intent-runtime.js";import{normalizeReadOutputIncludeModeOptions,validateReadOutputOptions}from"./read-output-contracts.js";import{clearWorkspaceContractsCache as clearWorkspaceContractsCache2}from"./workspace-contracts-cache.js";import{normalizeActivityProjectionOptions,runActivity}from"./query/activity.js";import{runAssuranceDispatch}from"./governance/assurance-action.js";import{WORKFLOW_POLICY_ACTIONS,runWorkflowPolicyAction}from"./governance/workflow-policy.js";export*from"./governance/workflow-policy.js";import{runAggregate}from"./query/aggregate.js";import{runAppend}from"./lifecycle/append.js";import{runClaim,runRelease}from"./lifecycle/claim.js";import{runCloseMany}from"./lifecycle/close-many.js";import{normalizeAnnotationTransportOptions}from"./annotations.js";import{runComments}from"./comments.js";import{runHistory}from"./query/history.js";import{runLearnings}from"./learnings.js";import{runNotes}from"./notes.js";import{runUpdateMany}from"./lifecycle/update-many.js";import{runUpgrade}from"./governance/upgrade.js";import{runCreate}from"./lifecycle/create.js";import{runUpdate}from"./lifecycle/update.js";import{runPlan}from"./lifecycle/plan.js";import{runContext}from"./query/context.js";import{runNext}from"./query/next.js";import{runClose}from"./lifecycle/close.js";import{runCopy}from"./lifecycle/copy.js";import{runDelete}from"./lifecycle/delete.js";import{runRestore}from"./lifecycle/restore.js";import{runFocus}from"./lifecycle/focus.js";import{runGet}from"./query/get.js";import{runGc}from"./governance/gc.js";import{runHealth}from"./governance/health.js";import{runValidate}from"./governance/validate.js";import{runExtension}from"./extension.js";import{runConfig}from"./config.js";import{INIT_INVOCATION_CWD,runInit}from"./init.js";import{runRuntimeEvalAction,runRuntimeEventsAction,runRuntimeMergeAction,runRuntimeSchedulingAction,runRuntimeWorkspaceAction}from"./runtime-extended-actions.js";import{acknowledgeUnknownAuthorHistoryEventsFromTransport}from"./author-attribution.js";import{PROFILE_SUBCOMMANDS,runProfileApply,runProfileLint,runProfileList,runProfileShow}from"./profile.js";import{runHistoryRedact}from"./history-redact.js";import{runMcpHistoryCompactAction,runMcpHistoryRepairAction}from"./history-mcp.js";import{runMcpClaimAction,runMcpCloseAction,runMcpReopenAction}from"./lifecycle/mcp-actions.js";import{actionGlobalOptions as globalOptions,closeManyOptionsFromFlat,extensionOptionsFromArgs,graphOptionsFromFlat,mutationListOptions,mutationOptionsWithOverrides,normalizeActionName,normalizeCommandPath,normalizeMcpOptionsArrays,normalizeMcpUpdateOptions,optionsWithAuthor,parseRuntimeInteger as parseMcpInteger,readRuntimeScalarString as readScalarString,readRuntimeScalarStringAllowBlank as readScalarStringAllowBlank,readRuntimeString as readString,readRuntimeStringArray as readStringArray,resolveRuntimeLimit,shouldInvalidateWorkspaceContractsCacheAfterAction,updateManyOptionsFromFlat,withAddNoteOption,withFilesDiscoveryOptions,withMutationCompaction}from"./runtime-input.js";import{runDeps}from"./dependencies.js";import{runDocs}from"./docs.js";import{runGraph}from"./graph/run.js";import{runFiles,runFilesDiscover,runFilesLookup}from"./files.js";import{runtimeFilesLookupOptions}from"./traceability/runtime-files-lookup.js";import{runContracts}from"./cli-contracts/runtime-contracts.js";import{runList}from"./query/list.js";import{runSearch}from"./query/search.js";import{runStats}from"./stats.js";import{statsCommandOptionsFromRuntime}from"./runtime-stats-options.js";import{runDuplicates}from"./duplicates.js";import{runTelemetry}from"./telemetry.js";import{runTest}from"./test/execution.js";import{runTestAll}from"./test/batch.js";import{resolveStartTaskInProgressStatus}from"./start-task-status.js";import{SCHEMA_SUBCOMMANDS,runSchemaAddField,runSchemaAddStatus,runSchemaAddType,runSchemaApplyPreset,runSchemaInferTypes,runSchemaList,runSchemaListFields,runSchemaEvolutionMigration,runSchemaRemoveField,runSchemaRemoveStatus,runSchemaRemoveType,runSchemaShow,runSchemaShowField,runSchemaShowStatus}from"./schema.js";import{getActiveExtensionRegistrations,runActiveOnReadHooks,runActiveOnWriteHooks}from"../core/extensions/index.js";import{pathExists as pathExists2,readFileIfExists,removeFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{appendHistoryEntry,createHistoryEntry}from"../core/history/history.js";import{classifyHistoryEvent,HISTORY_EVENT_CLASSIFICATION_VERSION,MAINTENANCE_HISTORY_OPERATIONS,SUBSTANTIVE_HISTORY_OPERATIONS}from"../core/history/event-classification.js";import{generateItemId,normalizeItemId,normalizeRawItemId}from"../core/item/id.js";import{readBooleanOption,readCsvListOption,readStringOption}from"./package-runtime-options.js";import{PM_CLI_EXPECTED_ERROR_NAME,createPmCliExpectedError,isPmCliExpectedError}from"./errors.js";import{commitImportedItem,emptyImportedDocument,ensureTrackerInitialized,selectImportAuthor,toEstimatedMinutesValue,toImportBoolean,toImportConfidence,toImportInteger,toImportLinkedDocs,toImportLinkedFiles,toImportLinkedTests,toImportLogEntries,toImportNormalizedEnum,toImportNumberMap,toImportPriority,toImportStatus,toImportStringList,toImportStringMap,toImportTags,toNonEmptyImportString}from"./package-import-adapters.js";import{canonicalDocument,normalizeItemMetadata,serializeItemDocument,splitFrontMatter}from"../core/item/item-format.js";import{BASELINE_ITEM_FORMAT_VERSION,CURRENT_ITEM_FORMAT_VERSION,classifyItemFormatVersion,effectiveItemFormatVersion,normalizeItemFormatVersion,scanItemFormatVersions}from"../core/item/item-format-version.js";import{parseTags}from"../core/item/parse.js";import{isTerminalStatus,normalizeStatusInput}from"../core/item/status.js";import{resolveItemTypeRegistry as resolveItemTypeRegistry2}from"../core/item/type-registry.js";import{acquireLock}from"../core/lock/lock.js";import{resolveRuntimeFieldRegistry as resolveRuntimeFieldRegistry2,resolveRuntimeStatusRegistry as resolveRuntimeStatusRegistry2}from"../core/schema/runtime-schema.js";import{PmCliError as PmCliError2}from"../core/shared/errors.js";import{isTimestampLiteral,nowIso}from"../core/shared/time.js";import{jaccardSimilarity,normalizeSimilarityText,scoreItemSimilarity,tokenizeSimilarityText}from"./similarity-scoring.js";import{listAllItemMetadata,listAllItemMetadataLight,locateItem,readLocatedItem}from"../core/store/item-store.js";import{getHistoryPath,getItemPath,getSettingsPath as getSettingsPath2,resolveImplicitPmRoot,resolvePmRoot as resolvePmRoot2}from"../core/store/paths.js";import{readSettings as readSettings2}from"../core/store/settings.js";import{runAggregate as runAggregate2}from"./query/aggregate.js";import{CONTEXT_OUTPUT_VALUES,runContext as runContext2}from"./query/context.js";import{runGet as runGet2}from"./query/get.js";import{runList as runList2}from"./query/list.js";import{closeItem,runClose as runClose2}from"./lifecycle/close.js";import{runCopy as runCopy2}from"./lifecycle/copy.js";import{runDelete as runDelete2}from"./lifecycle/delete.js";import{runFocus as runFocus2}from"./lifecycle/focus.js";import{runRestore as runRestore2}from"./lifecycle/restore.js";import{DEFAULT_TERMINAL_TRANSITION_POLICY,applyTerminalOrderingPolicy,requireTerminalReason,resolveTerminalReason}from"./lifecycle-policy.js";import{runUpdate as runUpdate2}from"./lifecycle/update.js";import{runReopen}from"./lifecycle/reopen.js";import{NEXT_OUTPUT_VALUES,runNext as runNext2}from"./query/next.js";import{runSearch as runSearch2}from"./query/search.js";import{runStats as runStats2}from"./stats.js";import{runDuplicates as runDuplicates2}from"./duplicates.js";import{renderCalendarMarkdown,renderCalendarToon,resolveCalendarOutputFormat,runCalendar}from"./query/calendar.js";import{renderGuideMarkdown,resolveGuideOutputFormat,runGuide}from"./guide.js";import{runCompletion}from"./completion.js";import{runReindex}from"./governance/reindex.js";import{loadCreateTemplateOptions,runTemplatesList,runTemplatesSave,runTemplatesShow}from"./templates.js";import{runTestRunsList,runTestRunsLogs,runTestRunsResume,runTestRunsStatus,runTestRunsStop}from"./test/runs.js";import{CONFIDENCE_TEXT_VALUES,DEPENDENCY_KIND_VALUES,BUILTIN_ITEM_TYPE_VALUES,ISSUE_SEVERITY_VALUES,ITEM_TYPE_VALUES,RISK_VALUES,STATUS_VALUES}from"../types/index.js";const ACTIVE_EXTENSION_HOST_CONTEXT=Symbol("pm.active-extension-host-context");function splitFullClientMutationOptions(options){return{fullChangedFields:true,options}}class PmClient{defaults;constructor(options={}){this.defaults={...options.pmRoot===void 0?{}:{path:options.pmRoot},...options.cwd===void 0?{}:{cwd:options.cwd},...options.author===void 0?{}:{author:options.author},...options.noExtensions===void 0?{}:{noExtensions:options.noExtensions}}}static forActiveExtensionHost(options){const client=new PmClient({...options,noExtensions:true});client.defaults[ACTIVE_EXTENSION_HOST_CONTEXT]=true;return client}run(action,args={}){return runAction({...this.defaults,...args,action})}runTyped(action,args={}){return this.run(action,args)}context(options={}){return this.runTyped("context",{options})}listAllItemMetadataLight(){return listClientItemMetadataLight(this.defaults.path,this.defaults.cwd)}list(options={}){return this.runTyped("list",{options})}async listAllComplete(options={}){return certifyCompleteListResult(await this.list(createCompleteListOptions(options)))}search(query,options={}){return this.runTyped("search",{query,options})}get(id,options={}){return this.runTyped("get",{id,options})}next(options={}){return this.runTyped("next",{options})}aggregate(options={}){return this.runTyped("aggregate",{options})}stats(options={}){return this.runTyped("stats",{options})}duplicates(options={}){return this.runTyped("duplicates",{options})}comments(id,options={}){return this.runTyped("comments",{id,options})}notes(id,options={}){return this.runTyped("notes",{id,options})}learnings(id,options={}){return this.runTyped("learnings",{id,options})}files(id,options={}){return this.runTyped("files",{id,options})}filesDiscover(id,options={}){return this.runTyped("files-discover",{id,options})}filesLookup(options){return this.runTyped("files-lookup",{options})}docs(id,options={}){return this.runTyped("docs",{id,options})}deps(id,options={}){return this.runTyped("deps",{id,options})}graph(subcommand,ids={},options={}){return this.runTyped("graph",{subcommand,...ids,options})}append(id,body,options={}){return this.runTyped("append",{id,...splitFullClientMutationOptions(mutationOptionsWithOverrides(options,{body}))})}init(prefix,options={}){return this.runTyped("init",{...prefix===void 0?{}:{prefix},options})}config(scope,configAction,key,value,options={}){return this.runTyped("config",{scope,configAction,...key===void 0?{}:{key},...value===void 0?{}:{value},options})}schema(subcommand,options={}){return this.runTyped("schema",{options:{...options,subcommand}})}workflowPolicy(action,name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:action}})}schemaList(){return this.runTyped("schema",{options:{subcommand:"list"}})}schemaShow(name){return this.runTyped("schema",{name,options:{subcommand:"show"}})}schemaAddType(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"add-type"}})}schemaRemoveType(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"remove-type"}})}schemaAddStatus(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"add-status"}})}schemaRemoveStatus(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"remove-status"}})}schemaAddField(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"add-field"}})}schemaRemoveField(name,options={}){return this.runTyped("schema",{name,options:{...options,subcommand:"remove-field"}})}schemaListFields(){return this.runTyped("schema",{options:{subcommand:"list-fields"}})}schemaShowField(name){return this.runTyped("schema",{name,options:{subcommand:"show-field"}})}schemaApplyPreset(typePreset,options={}){return this.runTyped("schema",{typePreset,options:{...options,subcommand:"apply-preset"}})}schemaInferTypes(options={}){return this.runTyped("schema",{options:{...options,subcommand:"add-type",infer:true}})}schemaRenameType(from,to,options){return this.runTyped("schema",{name:from,options:{...options,subcommand:"rename-type",to}})}schemaRenameField(from,to,options,type){return this.runTyped("schema",{name:from,options:{...options,subcommand:"rename-field",to,...type?{fieldTypeScope:type}:{}}})}schemaRemapStatus(from,to,options){return this.runTyped("schema",{name:from,options:{...options,subcommand:"remap-status",to}})}schemaShowStatus(name){return this.runTyped("schema",{name,options:{subcommand:"show-status"}})}profile(subcommand,options={}){return this.runTyped("profile",{options:{...options,subcommand}})}profileList(){return this.runTyped("profile",{options:{subcommand:"list"}})}profileShow(name){return this.runTyped("profile",{name,options:{subcommand:"show"}})}profileApply(name,options={}){return this.runTyped("profile",{name,options:{...options,subcommand:"apply"}})}profileLint(name){return this.runTyped("profile",{name,options:{subcommand:"lint"}})}validate(options={}){return this.runTyped("validate",{options})}health(options={}){return this.runTyped("health",{options})}gc(options={}){return this.runTyped("gc",{options})}assurance(input){return this.runTyped("assurance",{options:{...input,subcommand:input.action}})}historyRedact(id,options){return this.runTyped("history-redact",{id,options})}historyRepair(id,options={}){return this.runTyped("history-repair",{id,options})}historyRepairAll(options={}){return this.runTyped("history-repair",{options:{...options,all:true}})}historyCompact(id,options={}){return this.runTyped("history-compact",{id,options})}historyCompactBulk(options){return this.runTyped("history-compact",{options})}historyAuthorAcknowledge(options){return this.runTyped("history-author-acknowledge",{historyEvent:(options.events??[]).map(event=>`${event.item_id}:${String(event.line)}`),allActionable:options.all_actionable===true,dryRun:options.dry_run===true,planFingerprint:options.plan_fingerprint,limit:options.coordinate_limit,attributedAuthor:options.attributed_author,reviewer:options.reviewer,reason:options.reason})}plan(subcommand,id,options={},stepRef,reorderTo){return this.runTyped("plan",{...id===void 0?{}:{id},...stepRef===void 0?{}:{stepRef},...reorderTo===void 0?{}:{reorderTo},options:mutationOptionsWithOverrides(options,{subcommand})})}planCreate(options){return this.plan("create",void 0,options)}planShow(id,options={}){return this.plan("show",id,options)}planAddStep(id,options){return this.plan("add-step",id,options)}planUpdateStep(id,stepRef,options){return this.plan("update-step",id,options,stepRef)}planCompleteStep(id,stepRef,options={}){return this.plan("complete-step",id,options,stepRef)}planBlockStep(id,stepRef,options){return this.plan("block-step",id,options,stepRef)}planReorderStep(id,stepRef,reorderTo,options={}){return this.plan("reorder-step",id,options,stepRef,reorderTo)}planRemoveStep(id,stepRef,options={}){return this.plan("remove-step",id,options,stepRef)}planLink(id,stepRef,options){return this.plan("link",id,options,stepRef)}planUnlink(id,stepRef,options){return this.plan("unlink",id,options,stepRef)}planDecision(id,options){return this.plan("decision",id,options)}planDiscovery(id,options){return this.plan("discovery",id,options)}planValidation(id,options){return this.plan("validation",id,options)}planResume(id,options){return this.plan("resume",id,options)}planApprove(id,options={}){return this.plan("approve",id,options)}planMaterialize(id,options){return this.plan("materialize",id,options)}create(options={}){return this.runTyped("create",splitFullClientMutationOptions(options))}update(id,options={}){return this.runTyped("update",{id,...splitFullClientMutationOptions(options)})}reopen(id,reason,options={}){return this.runTyped("item-reopen",{id,reason,fullChangedFields:true,options})}close(id,reason,options={}){return this.runTyped("close",{id,reason,...splitFullClientMutationOptions(options)})}claim(id,options={}){return this.runTyped("claim",{id,...splitFullClientMutationOptions(options)})}claimNext(options={}){return this.runTyped("claim",{next:true,...splitFullClientMutationOptions(options)})}release(id,options={}){return this.runTyped("release",{id,...splitFullClientMutationOptions(options)})}copy(id,options={}){return this.runTyped("copy",{id,...splitFullClientMutationOptions(options)})}delete(id,options={}){return this.runTyped("delete",{id,...splitFullClientMutationOptions(options)})}restore(id,target,options={}){return this.runTyped("restore",{fullChangedFields:true,id,options:{...options,target}})}focus(id,options={}){return this.runTyped("focus",{...id===void 0?{}:{id},...splitFullClientMutationOptions(options)})}startTask(id,options={}){return this.runTyped("start-task",{id,...splitFullClientMutationOptions(options)})}pauseTask(id,options={}){return this.runTyped("pause-task",{id,...splitFullClientMutationOptions(options)})}closeTask(id,reason,options={}){return this.runTyped("close-task",{id,reason,...splitFullClientMutationOptions(options)})}extension(target,options={}){return this.runTyped("extension",{...target===void 0?{}:{target},options})}extensionList(options={}){return this.extension("list",options)}extensionActivate(target,options={}){return this.runTyped("extension-activate",{target,options})}extensionDeactivate(target,options={}){return this.runTyped("extension-deactivate",{target,options})}package(target,options={}){return this.runTyped("package",{...target===void 0?{}:{target},options:{...options,vocabulary:"package"}})}packageList(options={}){return this.package("list",options)}packageInstall(target,options={}){return this.runTyped("package-install",{target,options})}packageUninstall(target,options={}){return this.runTyped("package-uninstall",{target,options})}packageDoctor(options={}){return this.runTyped("package-doctor",{options})}packageManage(target,options={}){return this.runTyped("package-manage",{...target===void 0?{}:{target},options})}packageDescribe(target,options={}){return this.runTyped("package-describe",{...target===void 0?{}:{target},options})}packageReload(options={}){return this.runTyped("package-reload",{options})}packageCatalog(options={}){return this.runTyped("package-catalog",{options})}packageActivate(target,options={}){return this.runTyped("package-activate",{target,options})}packageDeactivate(target,options={}){return this.runTyped("package-deactivate",{target,options})}packageMigrate(options={}){return this.package(void 0,{...options,migrate:true})}upgrade(target,options={}){return this.runTyped("upgrade",{...target===void 0?{}:{target},options})}}function context(options={},clientOptions={}){return new PmClient(clientOptions).context(options)}function list(options={},clientOptions={}){return new PmClient(clientOptions).list(options)}function listAllComplete(options={},clientOptions={}){return new PmClient(clientOptions).listAllComplete(options)}function search(query,options={},clientOptions={}){return new PmClient(clientOptions).search(query,options)}function get(id,options={},clientOptions={}){return new PmClient(clientOptions).get(id,options)}function next(options={},clientOptions={}){return new PmClient(clientOptions).next(options)}function aggregate(options={},clientOptions={}){return new PmClient(clientOptions).aggregate(options)}function stats(options={},clientOptions={}){return new PmClient(clientOptions).stats(options)}function duplicates(options={},clientOptions={}){return new PmClient(clientOptions).duplicates(options)}function comments(id,options={},clientOptions={}){return new PmClient(clientOptions).comments(id,options)}function notes(id,options={},clientOptions={}){return new PmClient(clientOptions).notes(id,options)}function learnings(id,options={},clientOptions={}){return new PmClient(clientOptions).learnings(id,options)}function files(id,options={},clientOptions={}){return new PmClient(clientOptions).files(id,options)}function filesDiscover(id,options={},clientOptions={}){return new PmClient(clientOptions).filesDiscover(id,options)}function filesLookup(options,clientOptions={}){return new PmClient(clientOptions).filesLookup(options)}function docs(id,options={},clientOptions={}){return new PmClient(clientOptions).docs(id,options)}function deps(id,options={},clientOptions={}){return new PmClient(clientOptions).deps(id,options)}function graph(subcommand,ids={},options={},clientOptions={}){return new PmClient(clientOptions).graph(subcommand,ids,options)}function append(id,body,options={},clientOptions={}){return new PmClient(clientOptions).append(id,body,options)}function init(prefix,options={},clientOptions={}){return new PmClient(clientOptions).init(prefix,options)}function config(scope,configAction,key,value,options={},clientOptions={}){return new PmClient(clientOptions).config(scope,configAction,key,value,options)}function schema(subcommand,options={},clientOptions={}){return new PmClient(clientOptions).schema(subcommand,options)}function schemaList(clientOptions={}){return new PmClient(clientOptions).schemaList()}function schemaShow(name,clientOptions={}){return new PmClient(clientOptions).schemaShow(name)}function schemaAddType(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaAddType(name,options)}function schemaRemoveType(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaRemoveType(name,options)}function schemaAddStatus(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaAddStatus(name,options)}function schemaRemoveStatus(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaRemoveStatus(name,options)}function schemaAddField(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaAddField(name,options)}function schemaRemoveField(name,options={},clientOptions={}){return new PmClient(clientOptions).schemaRemoveField(name,options)}function schemaListFields(clientOptions={}){return new PmClient(clientOptions).schemaListFields()}function schemaShowField(name,clientOptions={}){return new PmClient(clientOptions).schemaShowField(name)}function schemaApplyPreset(typePreset,options={},clientOptions={}){return new PmClient(clientOptions).schemaApplyPreset(typePreset,options)}function schemaInferTypes(options={},clientOptions={}){return new PmClient(clientOptions).schemaInferTypes(options)}function schemaRenameType(from,to,options,clientOptions={}){return new PmClient(clientOptions).schemaRenameType(from,to,options)}function schemaRenameField(from,to,options,type,clientOptions={}){return new PmClient(clientOptions).schemaRenameField(from,to,options,type)}function schemaRemapStatus(from,to,options,clientOptions={}){return new PmClient(clientOptions).schemaRemapStatus(from,to,options)}function schemaShowStatus(name,clientOptions={}){return new PmClient(clientOptions).schemaShowStatus(name)}function profile(subcommand,options={},clientOptions={}){return new PmClient(clientOptions).profile(subcommand,options)}function profileList(clientOptions={}){return new PmClient(clientOptions).profileList()}function profileShow(name,clientOptions={}){return new PmClient(clientOptions).profileShow(name)}function profileApply(name,options={},clientOptions={}){return new PmClient(clientOptions).profileApply(name,options)}function profileLint(name,clientOptions={}){return new PmClient(clientOptions).profileLint(name)}function validate(options={},clientOptions={}){return new PmClient(clientOptions).validate(options)}function health(options={},clientOptions={}){return new PmClient(clientOptions).health(options)}function gc(options={},clientOptions={}){return new PmClient(clientOptions).gc(options)}function historyRedact(id,options,clientOptions={}){return new PmClient(clientOptions).historyRedact(id,options)}function historyRepair(id,options={},clientOptions={}){return new PmClient(clientOptions).historyRepair(id,options)}function historyRepairAll(options={},clientOptions={}){return new PmClient(clientOptions).historyRepairAll(options)}function historyCompact(id,options={},clientOptions={}){return new PmClient(clientOptions).historyCompact(id,options)}function historyCompactBulk(options,clientOptions={}){return new PmClient(clientOptions).historyCompactBulk(options)}function create(options={},clientOptions={}){return new PmClient(clientOptions).create(options)}function update(id,options={},clientOptions={}){return new PmClient(clientOptions).update(id,options)}function reopen(id,reason,options={},clientOptions={}){return new PmClient(clientOptions).reopen(id,reason,options)}function close(id,reason,options={},clientOptions={}){return new PmClient(clientOptions).close(id,reason,options)}function claim(id,options={},clientOptions={}){return new PmClient(clientOptions).claim(id,options)}function claimNext(options={},clientOptions={}){return new PmClient(clientOptions).claimNext(options)}function release(id,options={},clientOptions={}){return new PmClient(clientOptions).release(id,options)}function copy(id,options={},clientOptions={}){return new PmClient(clientOptions).copy(id,options)}function deleteItem(id,options={},clientOptions={}){return new PmClient(clientOptions).delete(id,options)}function restore(id,target,options={},clientOptions={}){return new PmClient(clientOptions).restore(id,target,options)}function focus(id,options={},clientOptions={}){return new PmClient(clientOptions).focus(id,options)}function startTask(id,options={},clientOptions={}){return new PmClient(clientOptions).startTask(id,options)}function pauseTask(id,options={},clientOptions={}){return new PmClient(clientOptions).pauseTask(id,options)}function closeTask(id,reason,options={},clientOptions={}){return new PmClient(clientOptions).closeTask(id,reason,options)}function extension(target,options={},clientOptions={}){return new PmClient(clientOptions).extension(target,options)}function extensionList(options={},clientOptions={}){return new PmClient(clientOptions).extensionList(options)}function extensionActivate(target,options={},clientOptions={}){return new PmClient(clientOptions).extensionActivate(target,options)}function extensionDeactivate(target,options={},clientOptions={}){return new PmClient(clientOptions).extensionDeactivate(target,options)}function packageLifecycle(target,options={},clientOptions={}){return new PmClient(clientOptions).package(target,options)}function packageList(options={},clientOptions={}){return new PmClient(clientOptions).packageList(options)}function packageInstall(target,options={},clientOptions={}){return new PmClient(clientOptions).packageInstall(target,options)}function packageUninstall(target,options={},clientOptions={}){return new PmClient(clientOptions).packageUninstall(target,options)}function packageDoctor(options={},clientOptions={}){return new PmClient(clientOptions).packageDoctor(options)}function packageManage(target,options={},clientOptions={}){return new PmClient(clientOptions).packageManage(target,options)}function packageDescribe(target,options={},clientOptions={}){return new PmClient(clientOptions).packageDescribe(target,options)}function packageReload(options={},clientOptions={}){return new PmClient(clientOptions).packageReload(options)}function packageCatalog(options={},clientOptions={}){return new PmClient(clientOptions).packageCatalog(options)}function packageActivate(target,options={},clientOptions={}){return new PmClient(clientOptions).packageActivate(target,options)}function packageDeactivate(target,options={},clientOptions={}){return new PmClient(clientOptions).packageDeactivate(target,options)}function upgrade(target,options={},clientOptions={}){return new PmClient(clientOptions).upgrade(target,options)}function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot,settings,cwd){return JSON.stringify([path.resolve(pmRoot),path.resolve(cwd??process.cwd()),settings.extensions.enabled,settings.extensions.disabled,settings.extensions.policy])}async function resolveWorkspaceExtensionRegistrations(pmRoot,settings,cwd){const cacheKey=buildWorkspaceExtensionRegistrationsCacheKey(pmRoot,settings,cwd);return memoizeWorkspaceExtensionRegistrations(cacheKey,()=>loadWorkspaceExtensionRegistrations(pmRoot,settings,cwd))}async function getWorkspaceContracts(pmRoot,options={}){const settings=await readSettings(pmRoot);const extensionRegistrations=options.extensionRegistrations??(options.noExtensions===true?null:await resolveWorkspaceExtensionRegistrations(pmRoot,settings,options.cwd));const typeRegistry=resolveItemTypeRegistry(settings,extensionRegistrations);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const fieldRegistry=resolveRuntimeFieldRegistry(settings.schema);return{types:[...typeRegistry.types],statuses:statusRegistry.definitions.map(definition=>definition.id),openStatus:statusRegistry.open_status,closeStatus:statusRegistry.close_status,canceledStatus:statusRegistry.canceled_status,fields:buildWorkspaceFieldContracts(fieldRegistry.definitions),extensionCommands:buildWorkspaceExtensionCommandContracts(extensionRegistrations?.commands??[])}}async function getContracts(pmRootOrOptions,options={}){const resolvedOptions=typeof pmRootOrOptions==="string"?{...options,pmRoot:pmRootOrOptions}:pmRootOrOptions??options;const global2={json:true,quiet:resolvedOptions.quiet??true,noExtensions:resolvedOptions.noExtensions??false,noPager:true,profile:resolvedOptions.profile??false,path:resolvedOptions.pmRoot};return runContracts(resolvedOptions,global2)}function readRequiredString(args,key){const value=readString(args,key);if(!value){throw new PmCliError(`Missing required argument: ${key}`,64)}return value}const extensionActivationGate=createAsyncReadWriteGate();const activeExtensionScope=new AsyncLocalStorage;function resetActiveExtensionRegistries(){setActiveExtensionHooks(createEmptyExtensionHookRegistry());setActiveExtensionCommands(createEmptyExtensionCommandRegistry());setActiveExtensionParsers(createEmptyExtensionParserRegistry());setActiveExtensionPreflight(createEmptyExtensionPreflightRegistry());setActiveExtensionServices(createEmptyExtensionServiceRegistry());setActiveExtensionRenderers(createEmptyExtensionRendererRegistry());setActiveExtensionRegistrations(createEmptyExtensionRegistrationRegistry())}async function withActiveExtensions(global2,explicitCwd,resolutionCwd,run){return runWithIsolatedExtensionRuntime(()=>explicitCwd===void 0?extensionActivationGate.read(()=>withActiveExtensionsExclusively(global2,resolutionCwd,run)):extensionActivationGate.write(()=>withCwd(explicitCwd,()=>withActiveExtensionsExclusively(global2,resolutionCwd,run))))}async function runWithActiveExtensions(options,run){const explicitCwd=options.cwd;const resolutionCwd=explicitCwd??process.cwd();return withActiveExtensions(globalOptions({path:options.path,noExtensions:options.noExtensions}),explicitCwd,resolutionCwd,()=>activeExtensionScope.run(true,run))}async function withActiveExtensionsExclusively(global2,cwd,run){const pmRoot=resolvePmRoot(cwd,global2.path);if(global2.noExtensions){resetActiveExtensionRegistries();return runWithDiscoveredContextIntentContracts({pmRoot},()=>run(null))}if(!await pathExists(getSettingsPath(pmRoot))){resetActiveExtensionRegistries();return run(null)}let active=null;let activated;try{const settings=await readSettings(pmRoot);const loadResult=await loadExtensions({pmRoot,settings,cwd,noExtensions:false});const activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded});activated={loadResult,activationResult};setActiveExtensionHooks(activationResult.hooks);setActiveExtensionCommands(activationResult.commands);setActiveExtensionParsers(activationResult.parsers);setActiveExtensionPreflight(activationResult.preflight);setActiveExtensionServices(activationResult.services);setActiveExtensionRenderers(activationResult.renderers);setActiveExtensionRegistrations(activationResult.registrations);active={registrations:activationResult.registrations,commands:activationResult.commands,pmRoot,packages:loadResult.loaded}}catch(error){resetActiveExtensionRegistries();console.error("[pm-sdk] extension activation failed; continuing without active extensions:",error)}try{return await runWithDiscoveredContextIntentContracts({pmRoot,packages:active?.packages},()=>run(active))}finally{resetActiveExtensionRegistries();if(activated){await deactivateExtensions(activated.loadResult,activated.activationResult).catch(()=>void 0)}}}async function dispatchActiveExtensionAction(action,args,options,global2,active){if(!active){throw new PmCliError(`Unsupported native pm action: ${action}`,EXIT_CODE.USAGE)}const normalizedAction=normalizeActionName(action);const definition=active.registrations.commands.find(entry=>normalizeActionName(entry.action)===normalizedAction);const command=definition?.command??active.commands.handlers.find(entry=>normalizeActionName(entry.command)===normalizedAction)?.command;if(!command){throw new PmCliError(`Unsupported native pm action: ${action}`,EXIT_CODE.USAGE)}const handlerResult=await runActiveCommandHandler({command:normalizeCommandPath(command),args:readStringArray(options.args??args.args),options:extensionOptionsFromArgs(args,options),global:global2,pm_root:active.pmRoot,sdk:createExtensionCommandSdk(active.pmRoot,PmClient.forActiveExtensionHost({pmRoot:active.pmRoot,author:typeof global2.author==="string"&&global2.author.trim()?global2.author.trim():"pm-extension"}))});if(!handlerResult.handled){const suffix=handlerResult.warnings.length>0?` (${handlerResult.warnings.join(", ")})`:"";throw new PmCliError(`Unsupported native pm action: ${action}${suffix}`,EXIT_CODE.USAGE)}return handlerResult.result}async function withCwd(cwd,run){const previous=process.cwd();process.chdir(cwd);try{return await run()}finally{process.chdir(previous)}}function resolveSdkActionInput(args){const rawAction=readRequiredString(args,"action");const normalizedAction=normalizeActionName(rawAction);const alias=getOwnHandler(SDK_ACTION_ALIASES,normalizedAction);const action=alias?.action??normalizedAction;const resolvedArgs={...args,action};if(alias?.options!==void 0){resolvedArgs.options={...alias.options,...asRecordClone(args.options)}}if(action==="package"){resolvedArgs.options={...asRecordClone(resolvedArgs.options),vocabulary:"package"}}return{action,args:resolvedArgs}}async function runAction(args){const resolved=resolveSdkActionInput(args);const global2=globalOptions(resolved.args);const invalidateWorkspaceContractsCache=shouldInvalidateWorkspaceContractsCacheAfterAction(resolved.action);const explicitCwd=readString(resolved.args,"cwd");const resolutionCwd=explicitCwd??process.cwd();if(resolved.action==="init"){global2[INIT_INVOCATION_CWD]=resolutionCwd}if(resolved.action!=="init"||global2.path!==void 0||(process.env.PM_PATH?.trim().length??0)>0){global2.path=resolvePmRoot(resolutionCwd,global2.path)}try{if(args[ACTIVE_EXTENSION_HOST_CONTEXT]===true||activeExtensionScope.getStore()===true){return await dispatchAction(resolved.action,resolved.args,global2,null)}return await withActiveExtensions(global2,explicitCwd,resolutionCwd,activeExtensions=>dispatchAction(resolved.action,resolved.args,global2,activeExtensions))}finally{if(invalidateWorkspaceContractsCache){clearWorkspaceContractsCache()}}}function getOwnHandler(handlers,key){return Object.prototype.hasOwnProperty.call(handlers,key)?handlers[key]:void 0}function readMcpTarget(ctx){return readString(ctx.args,"target")??readString(ctx.options,"target")}function requireMcpItemId(ctx,source=ctx.options){return ctx.id??readRequiredString(source,"id")}async function runMcpListAction(ctx){const listOptions=applyContextIntentProjection("list",ctx.options);if(listOptions.compact===void 0&&listOptions.brief===void 0&&listOptions.full===void 0&&listOptions.fields===void 0&&listOptions.includeBody===void 0){listOptions.compact=true}return withQuerySummary(await runList(readString(ctx.args,"status")??readString(listOptions,"status"),listOptions,ctx.global),listOptions)}async function runMcpSearchAction(ctx){const query=readRequiredString(ctx.args,"query");const searchOptions=applyContextIntentProjection("search",ctx.options,[query]);if(searchOptions.compact===void 0&&searchOptions.full===void 0&&searchOptions.fields===void 0){searchOptions.compact=true}return withQuerySummary(await runSearch(query,searchOptions,ctx.global),searchOptions)}async function runMcpCreateAction(ctx){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);return projectMutationResult(await runCreate(runnerOptions,ctx.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}async function runMcpCopyAction(ctx){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);const copyOptions={...runnerOptions,...runnerOptions.title===void 0&&typeof ctx.args.title==="string"?{title:ctx.args.title}:{},...runnerOptions.message===void 0&&typeof ctx.args.message==="string"?{message:ctx.args.message}:{}};return projectMutationResult(await runCopy(requireMcpItemId(ctx,copyOptions),copyOptions,ctx.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}async function runMcpUpdateAction(ctx){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);return projectMutationResult(await runUpdate(requireMcpItemId(ctx,runnerOptions),runnerOptions,ctx.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}function runMcpCommentsAction(ctx){const commentOptions=normalizeAnnotationTransportOptions(ctx.options);const isListing=commentOptions.add===void 0&&commentOptions.stdin===void 0&&commentOptions.file===void 0&&commentOptions.edit===void 0&&commentOptions.delete===void 0;if(isListing){commentOptions.includeMeta=true;if(commentOptions.limit===void 0&&commentOptions.fullHistory!==true){commentOptions.limit="20"}}return runComments(requireMcpItemId(ctx),commentOptions,ctx.global)}function runMcpFilesLookupAction(ctx,paths){return runFilesLookup(runtimeFilesLookupOptions(ctx.options,paths,parseMcpInteger),ctx.global)}function runMcpFilesAction(ctx){const lookupPaths=readStringArray(ctx.options.lookupPath);if(lookupPaths&&lookupPaths.length>0){return runMcpFilesLookupAction(ctx,lookupPaths)}const fileId=requireMcpItemId(ctx);return ctx.options.discover===true?runFilesDiscover(fileId,withFilesDiscoveryOptions(ctx.options),ctx.global):runFiles(fileId,withAddNoteOption(ctx.options),ctx.global)}function runMcpTelemetryAction(ctx){return runTelemetry({subcommand:readString(ctx.args,"subcommand")??readString(ctx.options,"subcommand"),limit:resolveRuntimeLimit(ctx.args,ctx.options)},ctx.global)}function runMcpHealthAction(ctx){const healthOptions={...ctx.options};if(healthOptions.brief===void 0&&healthOptions.summary===void 0&&healthOptions.full===void 0){healthOptions.summary=true}return runHealth(ctx.global,healthOptions)}function runMcpConfigAction(ctx){const configAction=readString(ctx.args,"configAction")??readString(ctx.options,"configAction")??readString(ctx.options,"action");if(configAction===void 0)throw new PmCliError("Missing required argument: configAction",64);const value=readString(ctx.args,"value")??readString(ctx.options,"value");const options=readString(ctx.options,"policy")!==void 0&&value!==void 0?{...ctx.options,value}:ctx.options;return runConfig(readString(ctx.args,"scope")??readString(ctx.options,"scope")??"project",configAction,readString(ctx.args,"key")??readString(ctx.options,"key"),options,ctx.global,readString(ctx.options,"policy")===void 0?value:void 0)}function runMcpActivityAction(ctx){const options=ctx.options;return runActivity(normalizeActivityProjectionOptions(options),ctx.global)}function parseMcpIntegerPrefix(value,label){if(typeof value==="number"){if(!Number.isFinite(value)||!Number.isInteger(value)){throw new PmCliError(`${label} must be a finite integer.`,64)}return value}if(typeof value==="string"&&value.trim().length>0){const trimmed=value.trim();if(!/^[+-]?\d+(?:st|nd|rd|th)?$/i.test(trimmed)){throw new PmCliError(`${label} must be a finite integer.`,64)}const parsed=Number.parseInt(trimmed,10);if(!Number.isInteger(parsed)){throw new PmCliError(`${label} must be a finite integer.`,64)}return parsed}return void 0}function runMcpPlanAction(ctx){const subcommand=readString(ctx.args,"subcommand")??readRequiredString(ctx.options,"subcommand");const planRecord=ctx.options;return runPlan({subcommand,id:typeof ctx.id==="string"?ctx.id:typeof planRecord.id==="string"?planRecord.id:void 0,stepRef:readMcpPlanStepRef(ctx),reorderTo:parseMcpIntegerPrefix(planRecord.reorderTo??ctx.args.reorderTo,"plan reorderTo"),options:ctx.options,global:ctx.global})}function readMcpPlanStepRef(ctx){return typeof ctx.options.stepRef==="string"?ctx.options.stepRef:typeof ctx.args.stepRef==="string"?ctx.args.stepRef:void 0}function createMcpSchemaContext(ctx){const subcommand=readString(ctx.args,"subcommand")??readRequiredString(ctx.options,"subcommand");const aliasSource=ctx.args.alias??ctx.options.alias;return{ctx,subcommand:subcommand.trim().toLowerCase(),name:readString(ctx.args,"name")??readString(ctx.options,"name"),author:readString(ctx.args,"author")??readString(ctx.options,"author"),force:ctx.args.force===true||ctx.options.force===true,aliases:aliasSource===void 0?void 0:readStringArray(aliasSource)}}function runMcpSchemaReadOrRemoveAction(schema2){const{ctx,subcommand,name,author,force}=schema2;const simpleHandlers={list:()=>runSchemaList(ctx.global),show:()=>runSchemaShow(name,ctx.global),"show-status":()=>runSchemaShowStatus(name,ctx.global),"list-fields":()=>runSchemaListFields(ctx.global),"show-field":()=>runSchemaShowField(name,ctx.global),"remove-type":()=>runSchemaRemoveType(name,{author,force},ctx.global),"remove-field":()=>runSchemaRemoveField(name,{author,force},ctx.global),"remove-status":()=>runSchemaRemoveStatus(name,{author,force},ctx.global),"apply-preset":()=>runSchemaApplyPreset(readString(ctx.args,"typePreset")??readString(ctx.options,"typePreset"),{author,force},ctx.global)};const handler=getOwnHandler(simpleHandlers,subcommand);return handler?handler():null}function runMcpSchemaAddFieldAction(schema2){const{ctx,name,author,force,aliases}=schema2;const commandsSource=ctx.args.commands??ctx.options.commands;const requiredTypesSource=ctx.args.requiredTypes??ctx.options.requiredTypes;return runSchemaAddField(name,{type:readString(ctx.args,"fieldType")??readString(ctx.options,"fieldType"),commands:commandsSource===void 0?void 0:readStringArray(commandsSource),description:readString(ctx.args,"description")??readString(ctx.options,"description"),cliFlag:readString(ctx.args,"cliFlag")??readString(ctx.options,"cliFlag"),alias:aliases,required:ctx.args.required===true||ctx.options.required===true,requiredOnCreate:ctx.args.requiredOnCreate===true||ctx.options.requiredOnCreate===true,allowUnset:!(ctx.args.allowUnset===false||ctx.options.allowUnset===false),requiredTypes:requiredTypesSource===void 0?void 0:readStringArray(requiredTypesSource),author,force},ctx.global)}function runMcpSchemaAddStatusAction(schema2){const{ctx,name,author,force,aliases}=schema2;const roleSource=ctx.args.role??ctx.options.role;return runSchemaAddStatus(name,{role:roleSource===void 0?void 0:readStringArray(roleSource),alias:aliases,description:readString(ctx.args,"description")??readString(ctx.options,"description"),order:parseMcpInteger(ctx.args.order??ctx.options.order,"schema add-status order"),author,force},ctx.global)}function runMcpSchemaAddTypeAction(schema2){const{ctx,name,author,force,aliases}=schema2;return runSchemaAddType(name,{description:readString(ctx.args,"description")??readString(ctx.options,"description"),defaultStatus:readString(ctx.args,"defaultStatus")??readString(ctx.args,"default_status")??readString(ctx.options,"defaultStatus")??readString(ctx.options,"default_status"),folder:readString(ctx.args,"folder")??readString(ctx.options,"folder"),alias:aliases,author,force},ctx.global)}function runMcpSchemaMigrationAction(schema2){const{ctx,subcommand,name,author,force}=schema2;const to=readString(ctx.args,"to")??readRequiredString(ctx.options,"to");const migrationId=readString(ctx.args,"migrationId")??readString(ctx.args,"migration_id")??readString(ctx.options,"migrationId")??readString(ctx.options,"migration_id");const fieldTypeScope=readString(ctx.args,"fieldTypeScope")??readString(ctx.options,"fieldTypeScope")??readString(ctx.args,"type")??readString(ctx.options,"type");const request=subcommand==="rename-type"?{kind:"rename-type",from:name??"",to}:subcommand==="rename-field"?{kind:"rename-field",from:name??"",to,...fieldTypeScope===void 0?{}:{type:fieldTypeScope}}:{kind:"remap-status",from:name??"",to};return runSchemaEvolutionMigration(request,{migrationId,dryRun:ctx.args.dryRun===true||ctx.options.dryRun===true,author,force},ctx.global)}function runMcpSchemaAction(ctx){const schema2=createMcpSchemaContext(ctx);const policyAction=WORKFLOW_POLICY_ACTIONS.find(action=>action===schema2.subcommand);if(policyAction)return runWorkflowPolicyAction(policyAction,schema2.name,{definition:ctx.args.definition??ctx.options.definition,policy:readString(ctx.args,"policy")??readString(ctx.options,"policy"),message:readString(ctx.args,"message")??readString(ctx.options,"message"),author:schema2.author,dryRun:ctx.args.dryRun===true||ctx.options.dryRun===true},ctx.global);const simpleResult=runMcpSchemaReadOrRemoveAction(schema2);if(simpleResult!==null){return simpleResult}if(["rename-type","rename-field","remap-status"].includes(schema2.subcommand)){return runMcpSchemaMigrationAction(schema2)}if(schema2.subcommand==="add-field"){return runMcpSchemaAddFieldAction(schema2)}if(schema2.subcommand==="add-status"){return runMcpSchemaAddStatusAction(schema2)}if(schema2.subcommand==="add-type"){if(ctx.args.infer===true||ctx.options.infer===true){return runSchemaInferTypes({minCount:parseMcpInteger(ctx.args.minCount??ctx.options.minCount,"schema infer minCount"),apply:ctx.args.apply===true||ctx.options.apply===true,author:schema2.author,force:schema2.force},ctx.global)}return runMcpSchemaAddTypeAction(schema2)}throw createUnknownSubcommandError({command_path:"schema",token:schema2.subcommand,allowed:SCHEMA_SUBCOMMANDS,exit_code:64})}function runMcpProfileAction(ctx){const subcommand=readString(ctx.args,"subcommand")??readRequiredString(ctx.options,"subcommand");const normalizedSubcommand=subcommand.trim().toLowerCase();const profileName=readString(ctx.args,"name")??readString(ctx.options,"name");const handlers={list:()=>runProfileList(),show:()=>runProfileShow(profileName),lint:()=>runProfileLint(profileName),apply:()=>runProfileApply(profileName,{dryRun:ctx.args.dryRun===true||ctx.options.dryRun===true,author:readString(ctx.args,"author")??readString(ctx.options,"author"),force:ctx.args.force===true||ctx.options.force===true},ctx.global)};const handler=getOwnHandler(handlers,normalizedSubcommand);if(!handler){throw createUnknownSubcommandError({command_path:"profile",token:subcommand,allowed:PROFILE_SUBCOMMANDS,exit_code:64})}return handler()}async function runMcpAppendAction(ctx){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);return projectMutationResult(await runAppend(requireMcpItemId(ctx,runnerOptions),runnerOptions,ctx.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}async function runMcpUpdateManyAction(ctx){const{changedFields,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);return projectMutationResult(await runUpdateMany(updateManyOptionsFromFlat(runnerOptions),ctx.global),{changedFields})}async function runMcpCloseManyAction(ctx){const{changedFields,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);const topLevelReason=readString(ctx.args,"reason");const closeManyRunnerOptions=topLevelReason!==void 0&&runnerOptions.reason===void 0?{...runnerOptions,reason:topLevelReason}:{...runnerOptions};if(ctx.force&&closeManyRunnerOptions.force===void 0){closeManyRunnerOptions.force=true}return projectMutationResult(await runCloseMany(closeManyOptionsFromFlat(closeManyRunnerOptions),ctx.global),{changedFields})}async function runMcpRestoreAction(ctx){const{changedFields,idOnly,runnerOptions}=withMutationCompaction(ctx.args,ctx.options);const target=readString(runnerOptions,"target")??readRequiredString(ctx.args,"target");return projectMutationResult(await runRestore(requireMcpItemId(ctx,runnerOptions),target,runnerOptions,ctx.global),{changedFields,compactEnvelope:changedFields==="compact"&&!idOnly,idOnly})}async function runMcpStartTaskAction(ctx){const pmRoot=resolvePmRoot(process.cwd(),ctx.global.path);const settings=await readSettings(pmRoot);const inProgressStatus=resolveStartTaskInProgressStatus(resolveRuntimeStatusRegistry(settings.schema));const id=requireMcpItemId(ctx);const claimResult=await runClaim(id,ctx.force,ctx.global,ctx.options);const updateResult=await runUpdate(id,mutationOptionsWithOverrides(ctx.options,{status:inProgressStatus,force:ctx.force},["assignee"]),ctx.global);return{id,action:"start_task",claim:claimResult,update:updateResult}}async function runMcpPauseTaskAction(ctx){const pmRoot=resolvePmRoot(process.cwd(),ctx.global.path);const settings=await readSettings(pmRoot);const id=requireMcpItemId(ctx);const openStatus=resolveRuntimeStatusRegistry(settings.schema).open_status;const updateResult=await runUpdate(id,mutationOptionsWithOverrides(ctx.options,{status:openStatus,force:ctx.force},["assignee"]),ctx.global);const releaseResult=await runRelease(id,ctx.force,ctx.global,ctx.options);return{id,action:"pause_task",update:updateResult,release:releaseResult}}async function runMcpCloseTaskAction(ctx){const id=requireMcpItemId(ctx);const closeReason=readString(ctx.args,"reason")??readString(ctx.args,"text")??readString(ctx.options,"reason")??readString(ctx.options,"text");const closeResult=await runClose(id,closeReason,{...ctx.options,force:ctx.force},ctx.global);const releaseResult=await runRelease(id,ctx.force,ctx.global,ctx.options);return{id,action:"close_task",close:closeResult,release:releaseResult}}function runMcpGraphAction(ctx){const merged={...ctx.args,...ctx.options};return runGraph(readRequiredString(merged,"subcommand"),readString(merged,"id")??ctx.id,readString(merged,"target"),graphOptionsFromFlat(merged),ctx.global)}function runMcpHistoryAuthorAcknowledgeAction(ctx){return acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(),ctx.global.path),{...ctx.args,...ctx.options})}const SDK_ACTION_HANDLERS={init:ctx=>runInit(readString(ctx.args,"prefix"),ctx.global,ctx.options),context:ctx=>runContext(applyContextIntentProjection("context",ctx.options),ctx.global),next:ctx=>runNext(applyContextIntentProjection("next",ctx.options),ctx.global),eval:runRuntimeEvalAction,events:runRuntimeEventsAction,merge:runRuntimeMergeAction,workspace:runRuntimeWorkspaceAction,meet:runRuntimeSchedulingAction,event:runRuntimeSchedulingAction,remind:runRuntimeSchedulingAction,list:runMcpListAction,get:ctx=>{const id=requireMcpItemId(ctx);return runGet(id,ctx.global,applyContextIntentProjection("get",ctx.options,[id]))},search:runMcpSearchAction,duplicates:ctx=>{const status=typeof ctx.options.status==="string"?[ctx.options.status]:readStringArray(ctx.options.status);return runDuplicates(ctx.global,{exhaustive:ctx.options.exhaustive===true,...status.length===0?{}:{status},since:readString(ctx.options,"since"),threshold:typeof ctx.options.threshold==="number"?ctx.options.threshold:void 0,limit:ctx.options.limit==="default"?void 0:parseMcpInteger(ctx.options.limit,"limit")})},create:runMcpCreateAction,copy:runMcpCopyAction,focus:ctx=>runFocus(ctx.id,{clear:ctx.options.clear===true||ctx.args.clear===true},ctx.global),update:runMcpUpdateAction,"item-reopen":runMcpReopenAction,restore:runMcpRestoreAction,claim:runMcpClaimAction,release:ctx=>runRelease(requireMcpItemId(ctx),ctx.force,ctx.global,ctx.options),"start-task":runMcpStartTaskAction,"pause-task":runMcpPauseTaskAction,"close-task":runMcpCloseTaskAction,close:runMcpCloseAction,comments:runMcpCommentsAction,notes:ctx=>runNotes(requireMcpItemId(ctx),normalizeAnnotationTransportOptions(ctx.options),ctx.global),learnings:ctx=>runLearnings(requireMcpItemId(ctx),normalizeAnnotationTransportOptions(ctx.options),ctx.global),files:runMcpFilesAction,docs:ctx=>runDocs(requireMcpItemId(ctx),withAddNoteOption(ctx.options),ctx.global),test:ctx=>runTest(requireMcpItemId(ctx),ctx.options,ctx.global),"test-all":ctx=>runTestAll(ctx.options,ctx.global),telemetry:runMcpTelemetryAction,validate:ctx=>runValidate(ctx.options,ctx.global,{runUpdate:(id,options,global2)=>runUpdate(id,options,global2)}),health:runMcpHealthAction,assurance:ctx=>runAssuranceDispatch(ctx.args,ctx.options,ctx.global),contracts:ctx=>runContracts(ctx.options,ctx.global),config:runMcpConfigAction,activity:runMcpActivityAction,aggregate:ctx=>runAggregate(ctx.options,ctx.global),extension:ctx=>runExtension(readMcpTarget(ctx),ctx.options,ctx.global),package:ctx=>runExtension(readMcpTarget(ctx),ctx.options,ctx.global),install:ctx=>runExtension(readMcpTarget(ctx),{...ctx.options,install:true},ctx.global),upgrade:ctx=>runUpgrade(readMcpTarget(ctx),ctx.options,ctx.global),delete:ctx=>runDelete(requireMcpItemId(ctx),ctx.options,ctx.global),deps:ctx=>runDeps(requireMcpItemId(ctx),ctx.options,ctx.global),graph:runMcpGraphAction,"files-discover":ctx=>runFilesDiscover(requireMcpItemId(ctx),ctx.options,ctx.global),"files-lookup":ctx=>runMcpFilesLookupAction(ctx,readStringArray(ctx.options.paths)),history:ctx=>runHistory(requireMcpItemId(ctx),ctx.options,ctx.global),"history-redact":ctx=>runHistoryRedact(requireMcpItemId(ctx),ctx.options,ctx.global),"history-repair":runMcpHistoryRepairAction,"history-compact":runMcpHistoryCompactAction,"history-author-acknowledge":runMcpHistoryAuthorAcknowledgeAction,plan:runMcpPlanAction,schema:runMcpSchemaAction,profile:runMcpProfileAction,stats:ctx=>runStats(ctx.global,statsCommandOptionsFromRuntime(ctx.options)),append:runMcpAppendAction,"update-many":runMcpUpdateManyAction,"close-many":runMcpCloseManyAction,gc:ctx=>runGc(ctx.global,ctx.options)};function analyzeSdkActionCoverage(actions=PM_TOOL_ACTIONS){return actions.map(action=>{const normalized=normalizeActionName(action);const alias=getOwnHandler(SDK_ACTION_ALIASES,normalized);const resolvedAction=alias?.action??normalized;const covered=getOwnHandler(SDK_ACTION_HANDLERS,resolvedAction)!==void 0;return{action,resolved_action:resolvedAction,covered,route:covered?alias?"alias":"native":"missing"}})}async function dispatchAction(action,args,global2,activeExtensions){const options=optionsWithAuthor(args,action);validateReadOutputOptions(action,options);normalizeReadOutputIncludeModeOptions(action,options);const ctx={action,args,options,id:readString(args,"id"),force:args.force===true||options.force===true,global:global2,activeExtensions};const handler=getOwnHandler(SDK_ACTION_HANDLERS,action);const result=handler?await handler(ctx):await dispatchActiveExtensionAction(action,args,options,global2,activeExtensions);options.resolvedOutputFormat="json";const projected=attachReadOutputContracts(action,options,result);await finalizeContextUsageEgress(resolvePmRoot(process.cwd(),global2.path),projected);return projected}const actionRunnerTestHooks={closeManyOptionsFromFlat,extensionOptionsFromArgs,globalOptions,mutationListOptions,normalizeActionName,normalizeCommandPath,normalizeMcpUpdateOptions,normalizeMcpOptionsArrays,optionsWithAuthor,readRequiredString,readScalarString,readScalarStringAllowBlank,readStringArray,updateManyOptionsFromFlat,withAddNoteOption,withFilesDiscoveryOptions,withMutationCompaction};if(process.env.NODE_ENV==="test"||process.env.VITEST!==void 0||process.env.VITEST_WORKER_ID!==void 0){globalThis.__pmCliActionRunnerTestHooks=actionRunnerTestHooks}async function loadWorkspaceExtensionRegistrations(pmRoot,settings,cwd){const loadResult=await loadExtensions({pmRoot,settings,cwd:cwd??process.cwd(),noExtensions:false});const activationResult=await activateExtensions(loadResult);try{return activationResult.registrations}finally{try{await deactivateExtensions(loadResult,activationResult)}catch{}}}export{BASELINE_ITEM_FORMAT_VERSION,BUILTIN_ITEM_TYPE_VALUES,CONFIDENCE_TEXT_VALUES,CONTEXT_OUTPUT_VALUES,CURRENT_ITEM_FORMAT_VERSION,DEFAULT_TERMINAL_TRANSITION_POLICY,DEPENDENCY_KIND_VALUES,EXIT_CODE,HISTORY_EVENT_CLASSIFICATION_VERSION,ISSUE_SEVERITY_VALUES,ITEM_TYPE_VALUES,MAINTENANCE_HISTORY_OPERATIONS,NEXT_OUTPUT_VALUES,PM_CLI_EXPECTED_ERROR_NAME,PM_GITIGNORE_END,PM_GITIGNORE_START,PmCliError2 as PmCliError,PmClient,PmCompleteListValidationError,RISK_VALUES,SEARCH_EXTENSION_FLAG_DEFINITIONS,STATUS_VALUES,SUBSTANTIVE_HISTORY_OPERATIONS,acquireLock,aggregate,analyzeSdkActionCoverage,append,appendHistoryEntry,applyTerminalOrderingPolicy,assertCompleteListResult,canonicalDocument,certifyCompleteListResult2 as certifyCompleteListResult,claim,claimNext,classifyHistoryEvent,classifyItemFormatVersion,clearWorkspaceContractsCache2 as clearWorkspaceContractsCache,close,closeItem,closeTask,comments,commitImportedItem,config,context,copy,create,createCompleteListOptions2 as createCompleteListOptions,createHistoryEntry,createPmCliExpectedError,deleteItem,deps,docs,duplicates,effectiveItemFormatVersion,emptyImportedDocument,ensurePmGitignore,ensureTrackerInitialized,extension,extensionActivate,extensionDeactivate,extensionList,files,filesDiscover,filesLookup,focus,gc,generateItemId,get,getActiveExtensionRegistrations,getContracts,getHistoryPath,getItemPath,getPmGitignoreBlock,getSettingsPath2 as getSettingsPath,getWorkspaceContracts,graph,health,historyCompact,historyCompactBulk,historyRedact,historyRepair,historyRepairAll,init,inspectCompleteListResult,isPmCliExpectedError,isTerminalStatus,isTimestampLiteral,jaccardSimilarity,learnings,list,listAllComplete,listAllItemMetadata,listAllItemMetadataLight,loadCreateTemplateOptions,locateItem,next,normalizeItemFormatVersion,normalizeItemId,normalizeItemMetadata,normalizeRawItemId,normalizeSimilarityText,normalizeStatusInput,notes,nowIso,packageActivate,packageCatalog,packageDeactivate,packageDescribe,packageDoctor,packageInstall,packageLifecycle,packageList,packageManage,packageReload,packageUninstall,parseTags,pathExists2 as pathExists,pauseTask,profile,profileApply,profileLint,profileList,profileShow,readBooleanOption,readCsvListOption,readFileIfExists,readLocatedItem,readRequiredString,readSettings2 as readSettings,readStringOption,release,removeFileIfExists,renderCalendarMarkdown,renderCalendarToon,renderGuideMarkdown,reopen,requireTerminalReason,resolveCalendarOutputFormat,resolveGuideOutputFormat,resolveImplicitPmRoot,resolveItemTypeRegistry2 as resolveItemTypeRegistry,resolvePmRoot2 as resolvePmRoot,resolveRuntimeFieldRegistry2 as resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry2 as resolveRuntimeStatusRegistry,resolveTerminalReason,restore,runAction,runActiveOnReadHooks,runActiveOnWriteHooks,runAggregate2 as runAggregate,runCalendar,runClose2 as runClose,runCompletion,runContext2 as runContext,runCopy2 as runCopy,runDelete2 as runDelete,runDuplicates2 as runDuplicates,runFocus2 as runFocus,runGet2 as runGet,runGuide,runList2 as runList,runNext2 as runNext,runReindex,runReopen,runRestore2 as runRestore,runSearch2 as runSearch,runStats2 as runStats,runTemplatesList,runTemplatesSave,runTemplatesShow,runTestRunsList,runTestRunsLogs,runTestRunsResume,runTestRunsStatus,runTestRunsStop,runUpdate2 as runUpdate,runWithActiveExtensions,scanItemFormatVersions,schema,schemaAddField,schemaAddStatus,schemaAddType,schemaApplyPreset,schemaInferTypes,schemaList,schemaListFields,schemaRemapStatus,schemaRemoveField,schemaRemoveStatus,schemaRemoveType,schemaRenameField,schemaRenameType,schemaShow,schemaShowField,schemaShowStatus,scoreItemSimilarity,search,selectImportAuthor,serializeItemDocument,splitFrontMatter,startTask,stats,toEstimatedMinutesValue,toImportBoolean,toImportConfidence,toImportInteger,toImportLinkedDocs,toImportLinkedFiles,toImportLinkedTests,toImportLogEntries,toImportNormalizedEnum,toImportNumberMap,toImportPriority,toImportStatus,toImportStringList,toImportStringMap,toImportTags,toNonEmptyImportString,tokenizeSimilarityText,update,upgrade,validate,writeFileAtomic};
 //# sourceMappingURL=runtime.js.map
-//# debugId=422ff60b-97b1-5477-a7b8-ed4f983155e0