npm - @unbrained/pm-cli - Versions diffs - 2026.7.3 → 2026.7.5 - Mend

@unbrained/pm-cli 2026.7.3 → 2026.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (663) hide show

package/dist/types.d.ts CHANGED Viewed

@@ -737,6 +737,12 @@ export interface PmSettings {
     item_format: ItemFormat;
     locks: {
         ttl_seconds: number;
+        /**
+         * Bounded wait budget (milliseconds) for acquiring a contended item lock
+         * before surfacing lock_conflict. 0 disables waiting (fail-fast).
+         * Overridable per invocation via PM_LOCK_WAIT_MS.
+         */
+        wait_ms: number;
     };
     /**
      * Retention policy for bulk-mutation rollback checkpoints written by

package/dist/types.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.
  */
-!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]="46812059-b93e-5599-a222-4ac0de6f4911")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6e5bac32-d895-5fce-9fc0-9c0615399b61")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -133,4 +133,4 @@ export const CONTEXT_SECTION_VALUES = [
     "tests",
 ];
 //# sourceMappingURL=types.js.map
-//# debugId=46812059-b93e-5599-a222-4ac0de6f4911
+//# debugId=6e5bac32-d895-5fce-9fc0-9c0615399b61

package/dist/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module types\n \n Defines the shared project-management data model used by CLI, SDK, MCP, and packages.\n /\nexport const BUILTIN_ITEM_TYPE_VALUES = [\n \"Epic\",\n \"Feature\",\n \"Task\",\n \"Chore\",\n \"Issue\",\n \"Decision\",\n \"Event\",\n \"Reminder\",\n \"Milestone\",\n \"Meeting\",\n \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\n/\n Restricts builtin item type values accepted by command, SDK, and storage contracts.\n /\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\n/\n Restricts item type values accepted by command, SDK, and storage contracts.\n /\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n \"draft\",\n \"open\",\n \"in_progress\",\n \"blocked\",\n \"closed\",\n \"canceled\",\n] as const;\n/\n Restricts item status values accepted by command, SDK, and storage contracts.\n /\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n \"draft\",\n \"active\",\n \"blocked\",\n \"terminal\",\n \"terminal_done\",\n \"terminal_canceled\",\n \"default_open\",\n \"default_close\",\n \"default_cancel\",\n] as const;\n/\n Restricts runtime status role values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\n/\n Restricts runtime field type values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\n/\n Restricts runtime field command values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\n/\n Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n \"blocks\",\n \"parent\",\n \"child\",\n \"parent_child\",\n \"child_of\",\n \"related\",\n \"related_to\",\n \"discovered_from\",\n \"blocked_by\",\n \"incident_from\",\n \"epic\",\n \"supersedes\",\n \"task\",\n] as const;\n/\n Restricts dependency kind values accepted by command, SDK, and storage contracts.\n /\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\n/\n Restricts link scope values accepted by command, SDK, and storage contracts.\n /\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/\n Restricts risk level values accepted by command, SDK, and storage contracts.\n /\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/\n Restricts issue severity values accepted by command, SDK, and storage contracts.\n /\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\n/\n Restricts confidence text level values accepted by command, SDK, and storage contracts.\n /\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\n/\n Restricts confidence value values accepted by command, SDK, and storage contracts.\n /\nexport type ConfidenceValue = number \| ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\n/\n Restricts item format values accepted by command, SDK, and storage contracts.\n /\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/\n Restricts sprint release format policy values accepted by command, SDK, and storage contracts.\n /\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/\n Restricts parent reference policy values accepted by command, SDK, and storage contracts.\n /\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\n/\n Restricts validate metadata profile values accepted by command, SDK, and storage contracts.\n /\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\n/\n Restricts governance preset values accepted by command, SDK, and storage contracts.\n /\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\n/\n Restricts governance ownership enforcement values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\n/\n Restricts governance create mode default values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/\n Restricts governance close validation default values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/\n Restricts governance workflow enforcement values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n \"author\",\n \"acceptance_criteria\",\n \"estimated_minutes\",\n \"close_reason\",\n \"reviewer\",\n \"risk\",\n \"confidence\",\n \"sprint\",\n \"release\",\n] as const;\n/\n Restricts validate metadata required field values accepted by command, SDK, and storage contracts.\n /\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\n/\n Restricts recurrence frequency values accepted by command, SDK, and storage contracts.\n /\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\n/\n Restricts recurrence weekday values accepted by command, SDK, and storage contracts.\n /\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/\n Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n /\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\n/\n Documents the dependency payload exchanged by command, SDK, and package integrations.\n /\nexport interface Dependency {\n id: string;\n kind: DependencyKind;\n created_at: string;\n author?: string;\n source_kind?: string;\n}\n\n/\n Documents the comment payload exchanged by command, SDK, and package integrations.\n /\nexport interface Comment {\n created_at: string;\n author: string;\n text: string;\n}\n\n/\n Documents the log note payload exchanged by command, SDK, and package integrations.\n /\nexport interface LogNote {\n created_at: string;\n author: string;\n text: string;\n}\n\n/\n Documents the linked file payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedFile {\n path: string;\n scope: LinkScope;\n note?: string;\n}\n\n/\n Documents the linked test payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedTest {\n command?: string;\n path?: string;\n scope: LinkScope;\n timeout_seconds?: number;\n pm_context_mode?: \"schema\" \| \"tracker\" \| \"auto\";\n env_set?: Record<string, string>;\n env_clear?: string[];\n shared_host_safe?: boolean;\n assert_stdout_contains?: string[];\n assert_stdout_regex?: string[];\n assert_stderr_contains?: string[];\n assert_stderr_regex?: string[];\n assert_stdout_min_lines?: number;\n assert_json_field_equals?: Record<string, string>;\n assert_json_field_gte?: Record<string, number>;\n note?: string;\n}\n\n/\n Documents the linked doc payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedDoc {\n path: string;\n scope: LinkScope;\n note?: string;\n}\n\n/\n Documents the reminder payload exchanged by command, SDK, and package integrations.\n /\nexport interface Reminder {\n at: string;\n text: string;\n}\n\n/\n Documents the recurrence rule payload exchanged by command, SDK, and package integrations.\n /\nexport interface RecurrenceRule {\n freq: RecurrenceFrequency;\n interval?: number;\n count?: number;\n until?: string;\n by_weekday?: RecurrenceWeekday[];\n by_month_day?: number[];\n exdates?: string[];\n}\n\n/\n Documents the calendar event payload exchanged by command, SDK, and package integrations.\n /\nexport interface CalendarEvent {\n start_at: string;\n end_at?: string;\n title?: string;\n description?: string;\n location?: string;\n all_day?: boolean;\n timezone?: string;\n recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n \"draft\",\n \"research\",\n \"review\",\n \"approved\",\n \"executing\",\n \"paused\",\n \"completed\",\n \"superseded\",\n] as const;\n/\n Restricts plan mode values accepted by command, SDK, and storage contracts.\n /\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n \"pending\",\n \"in_progress\",\n \"completed\",\n \"blocked\",\n \"skipped\",\n \"superseded\",\n] as const;\n/\n Restricts plan step status values accepted by command, SDK, and storage contracts.\n /\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\n/\n Restricts plan harness values accepted by command, SDK, and storage contracts.\n /\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n \"related\",\n \"blocks\",\n \"blocked_by\",\n \"depends_on\",\n \"discovered_from\",\n \"implements\",\n \"verifies\",\n \"supersedes\",\n] as const;\n/\n Restricts plan step link kind values accepted by command, SDK, and storage contracts.\n /\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\n/\n Documents the plan step link payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepLink {\n id: string;\n kind: PlanStepLinkKind;\n note?: string;\n required_before_step?: boolean;\n}\n\n/\n Documents the plan step file payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepFile {\n path: string;\n scope?: LinkScope;\n note?: string;\n}\n\n/\n Documents the plan step test payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepTest {\n command?: string;\n path?: string;\n note?: string;\n}\n\n/\n Documents the plan step doc payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepDoc {\n path: string;\n scope?: LinkScope;\n note?: string;\n}\n\n/\n Documents the plan step payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStep {\n id: string;\n order: number;\n title: string;\n body?: string;\n status: PlanStepStatus;\n owner?: string;\n evidence?: string;\n blocked_reason?: string;\n superseded_by?: string;\n linked_items?: PlanStepLink[];\n files?: PlanStepFile[];\n tests?: PlanStepTest[];\n docs?: PlanStepDoc[];\n created_at: string;\n updated_at: string;\n completed_at?: string;\n}\n\n/\n Documents the plan decision payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanDecision {\n ts: string;\n author: string;\n decision: string;\n rationale?: string;\n evidence?: string;\n step_id?: string;\n}\n\n/\n Documents the plan discovery payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanDiscovery {\n ts: string;\n author: string;\n text: string;\n step_id?: string;\n}\n\n/\n Documents the plan validation check payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanValidationCheck {\n text: string;\n command?: string;\n expected?: string;\n}\n\n/\n Documents the item type option definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeOptionDefinition {\n key: string;\n values: string[];\n required?: boolean;\n aliases?: string[];\n description?: string;\n}\n\n/\n Documents the item type command option policy payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeCommandOptionPolicy {\n command: \"create\" \| \"update\";\n option: string;\n required?: boolean;\n visible?: boolean;\n enabled?: boolean;\n}\n\n/\n Documents the item type definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeDefinition {\n name: string;\n description?: string;\n /\n Status assigned to newly created items of this type when `--status` is not\n * provided. Falls back to the workflow's open status when unset or invalid.\n /\n default_status?: string;\n folder?: string;\n aliases?: string[];\n required_create_fields?: string[];\n required_create_repeatables?: string[];\n options?: ItemTypeOptionDefinition[];\n command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\n/\n Documents the runtime status definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeStatusDefinition {\n id: string;\n aliases?: string[];\n roles?: RuntimeStatusRole[];\n description?: string;\n order?: number;\n}\n\n/\n Documents the runtime field definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeFieldDefinition {\n key: string;\n metadata_key?: string;\n /\n @deprecated Use metadata_key.\n /\n front_matter_key?: string;\n cli_flag?: string;\n cli_aliases?: string[];\n description?: string;\n type?: RuntimeFieldType;\n commands?: RuntimeFieldCommand[];\n repeatable?: boolean;\n required?: boolean;\n required_on_create?: boolean;\n required_types?: string[];\n allow_unset?: boolean;\n}\n\n/\n Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeWorkflowDefinition {\n draft_status?: string;\n open_status?: string;\n in_progress_status?: string;\n blocked_status?: string;\n close_status?: string;\n canceled_status?: string;\n}\n\n/\n Documents the runtime schema file config payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeSchemaFileConfig {\n types?: string;\n statuses?: string;\n fields?: string;\n workflows?: string;\n}\n\n/\n Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n /\nexport interface TypeWorkflowDefinition {\n type: string;\n allowed_transitions: [string, string][];\n}\n\n/\n Documents the runtime schema settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeSchemaSettings {\n version: number;\n files: RuntimeSchemaFileConfig;\n statuses: RuntimeStatusDefinition[];\n fields: RuntimeFieldDefinition[];\n workflow: RuntimeWorkflowDefinition;\n type_workflows?: TypeWorkflowDefinition[];\n unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\n/\n Documents the item test run summary payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTestRunSummary {\n run_id: string;\n kind: \"test\" \| \"test-all\";\n status: \"passed\" \| \"failed\" \| \"stopped\" \| \"canceled\";\n started_at: string;\n finished_at: string;\n recorded_at: string;\n attempt?: number;\n resumed_from?: string;\n passed: number;\n failed: number;\n skipped: number;\n items?: number;\n linked_tests?: number;\n fail_on_skipped_triggered?: boolean;\n}\n\n/\n Documents the item metadata payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemMetadata {\n id: string;\n title: string;\n description: string;\n type: ItemType;\n /\n On-disk front-matter format version. Absent means the implicit baseline\n * (version 1) and is never serialized; populated only once an item advances\n * past the baseline via a future storage migration. See\n * core/item/item-format-version.\n /\n pm_format_version?: number;\n source_type?: string;\n type_options?: Record<string, string>;\n status: ItemStatus;\n priority: 0 \| 1 \| 2 \| 3 \| 4;\n tags: string[];\n created_at: string;\n updated_at: string;\n deadline?: string;\n reminders?: Reminder[];\n events?: CalendarEvent[];\n closed_at?: string;\n assignee?: string;\n source_owner?: string;\n author?: string;\n estimated_minutes?: number;\n acceptance_criteria?: string;\n design?: string;\n external_ref?: string;\n definition_of_ready?: string;\n order?: number;\n goal?: string;\n objective?: string;\n value?: string;\n impact?: string;\n outcome?: string;\n why_now?: string;\n parent?: string;\n reviewer?: string;\n risk?: RiskLevel;\n confidence?: ConfidenceValue;\n sprint?: string;\n release?: string;\n blocked_by?: string;\n blocked_reason?: string;\n unblock_note?: string;\n reporter?: string;\n severity?: IssueSeverity;\n environment?: string;\n repro_steps?: string;\n resolution?: string;\n expected_result?: string;\n actual_result?: string;\n affected_version?: string;\n fixed_version?: string;\n component?: string;\n regression?: boolean;\n customer_impact?: string;\n dependencies?: Dependency[];\n comments?: Comment[];\n notes?: LogNote[];\n learnings?: LogNote[];\n files?: LinkedFile[];\n tests?: LinkedTest[];\n test_runs?: ItemTestRunSummary[];\n docs?: LinkedDoc[];\n close_reason?: string;\n duplicate_of?: string;\n plan_mode?: PlanMode;\n plan_scope?: string;\n plan_harness?: PlanHarness;\n plan_steps?: PlanStep[];\n plan_decisions?: PlanDecision[];\n plan_discoveries?: PlanDiscovery[];\n plan_validation?: PlanValidationCheck[];\n plan_resume_context?: string;\n [key: string]: unknown;\n}\n\n/\n @deprecated Use ItemMetadata.\n /\nexport type ItemFrontMatter = ItemMetadata;\n\n/\n Documents the item document payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemDocument {\n metadata: ItemMetadata;\n body: string;\n}\n\n/\n Documents the history patch op payload exchanged by command, SDK, and package integrations.\n /\nexport interface HistoryPatchOp {\n op: \"add\" \| \"remove\" \| \"replace\" \| \"move\" \| \"copy\" \| \"test\";\n path: string;\n from?: string;\n value?: unknown;\n}\n\n/\n Documents the history entry payload exchanged by command, SDK, and package integrations.\n /\nexport interface HistoryEntry {\n ts: string;\n author: string;\n op: string;\n patch: HistoryPatchOp[];\n before_hash: string;\n after_hash: string;\n message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\", \"full\"] as const;\n/\n Restricts context depth values accepted by command, SDK, and storage contracts.\n /\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n \"hierarchy\",\n \"activity\",\n \"progress\",\n \"recently_created\",\n \"unparented\",\n \"blockers\",\n \"files\",\n \"workload\",\n \"staleness\",\n \"tests\",\n] as const;\n/\n Restricts context section name values accepted by command, SDK, and storage contracts.\n /\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\n/\n Documents the context section settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ContextSectionSettings {\n hierarchy: boolean;\n activity: boolean;\n progress: boolean;\n recently_created: boolean;\n unparented: boolean;\n blockers: boolean;\n files: boolean;\n workload: boolean;\n staleness: boolean;\n tests: boolean;\n}\n\n/\n Documents the context settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ContextSettings {\n default_depth: ContextDepth;\n activity_limit: number;\n stale_threshold_days: number;\n sections: ContextSectionSettings;\n}\n\n/\n Documents the governance settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface GovernanceSettings {\n preset: GovernancePreset;\n ownership_enforcement: GovernanceOwnershipEnforcement;\n create_mode_default: GovernanceCreateModeDefault;\n close_validation_default: GovernanceCloseValidationDefault;\n require_close_reason: boolean;\n parent_reference: ParentReferencePolicy;\n metadata_profile: ValidateMetadataProfile;\n force_required_for_stale_lock: boolean;\n create_default_type?: string;\n /\n Per-type allowed-transition enforcement mode for `pm update --status`.\n * Read raw from settings (not preset-derived) so existing projects are\n * unaffected when unset; defaults to \"off\".\n /\n workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\n/\n Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionPolicyMode = \"off\" \| \"warn\" \| \"enforce\";\n/\n Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionTrustMode = \"off\" \| \"warn\" \| \"enforce\";\n/\n Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionSandboxProfile = \"none\" \| \"restricted\" \| \"strict\";\n\n/\n Documents the extension policy override settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ExtensionPolicyOverrideSettings {\n name: string;\n disabled?: boolean;\n require_trusted?: boolean;\n require_provenance?: boolean;\n sandbox_profile?: ExtensionSandboxProfile;\n allowed_capabilities?: string[];\n blocked_capabilities?: string[];\n allowed_surfaces?: string[];\n blocked_surfaces?: string[];\n allowed_commands?: string[];\n blocked_commands?: string[];\n allowed_actions?: string[];\n blocked_actions?: string[];\n allowed_services?: string[];\n blocked_services?: string[];\n}\n\n/\n Documents the extension policy settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ExtensionPolicySettings {\n mode: ExtensionPolicyMode;\n trust_mode: ExtensionTrustMode;\n require_provenance: boolean;\n trusted_extensions: string[];\n default_sandbox_profile: ExtensionSandboxProfile;\n allowed_extensions: string[];\n blocked_extensions: string[];\n allowed_capabilities: string[];\n blocked_capabilities: string[];\n allowed_surfaces: string[];\n blocked_surfaces: string[];\n allowed_commands: string[];\n blocked_commands: string[];\n allowed_actions: string[];\n blocked_actions: string[];\n allowed_services: string[];\n blocked_services: string[];\n extension_overrides: ExtensionPolicyOverrideSettings[];\n}\n\n/\n Documents the agent guidance settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface AgentGuidanceSettings {\n prompt_completed: boolean;\n declined: boolean;\n declined_at: string;\n template_version: number;\n last_checked_files: string[];\n}\n\n/\n Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts.\n /\nexport type SearchMutationRefreshPolicy = \"cache_only\" \| \"semantic_configured\" \| \"semantic_auto\";\n\n/\n Documents the search query expansion settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface SearchQueryExpansionSettings {\n enabled: boolean;\n provider: string;\n}\n\n/\n Documents the search rerank settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface SearchRerankSettings {\n enabled: boolean;\n model: string;\n top_k: number;\n}\n\n/\n Config-driven policy for automatic history-stream compaction triage.\n \n When `enabled`, `pm health` surfaces an advisory warning for any history\n * stream whose non-empty entry count exceeds `max_entries`, and `pm\n * history-compact` bulk mode uses `max_entries` as its default `--all-over`\n * threshold so the configured policy drives corpus-wide sweeps. `trigger`\n * records operator intent — both values raise the health advisory; `auto`\n * additionally signals that scheduled/automatic sweeps are expected.\n /\nexport interface HistoryCompactPolicy {\n enabled: boolean;\n max_entries: number;\n trigger: \"health_warn\" \| \"auto\";\n}\n\n/\n Documents the pm settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface PmSettings {\n version: number;\n id_prefix: string;\n author_default: string;\n item_format: ItemFormat;\n locks: {\n ttl_seconds: number;\n };\n /\n Retention policy for bulk-mutation rollback checkpoints written by\n * `update-many`/`close-many`. `pm gc --scope checkpoints` prunes checkpoint\n * files older than `retention_days`; checkpoints with an unparseable\n * `created_at` are retained (safety-first, mirroring the stale-lock sweep).\n /\n checkpoints: {\n retention_days: number;\n };\n output: {\n default_format: \"toon\" \| \"json\";\n };\n history: {\n missing_stream: \"auto_create\" \| \"strict_error\";\n compact_policy: HistoryCompactPolicy;\n };\n validation: {\n sprint_release_format: SprintReleaseFormatPolicy;\n parent_reference: ParentReferencePolicy;\n metadata_profile: ValidateMetadataProfile;\n metadata_required_fields: ValidateMetadataRequiredField[];\n lifecycle_stale_blocker_reason_patterns: string[];\n lifecycle_closure_like_blocked_reason_patterns: string[];\n lifecycle_closure_like_resolution_patterns: string[];\n lifecycle_closure_like_actual_result_patterns: string[];\n /\n Per-type default estimates (minutes) used by `pm validate --auto-fix\n * --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212).\n * Keys are item type names (case-insensitive); values are positive minutes\n * that override the built-in defaults. Empty by default.\n /\n estimate_defaults_by_type: Record<string, number>;\n };\n governance: GovernanceSettings;\n workflow: {\n definition_of_done: string[];\n };\n testing: {\n record_results_to_items: boolean;\n };\n telemetry: {\n enabled: boolean;\n first_run_prompt_completed: boolean;\n capture_level: \"minimal\" \| \"redacted\" \| \"max\";\n endpoint: string;\n installation_id: string;\n retention_days: number;\n };\n agent_guidance: AgentGuidanceSettings;\n item_types: {\n definitions: ItemTypeDefinition[];\n };\n schema: RuntimeSchemaSettings;\n extensions: {\n enabled: string[];\n disabled: string[];\n policy: ExtensionPolicySettings;\n };\n search: {\n score_threshold: number;\n hybrid_semantic_weight: number;\n max_results: number;\n embedding_model: string;\n embedding_corpus_max_characters?: number;\n embedding_batch_size: number;\n embedding_timeout_ms: number;\n scanner_max_batch_retries: number;\n provider?: string;\n /\n Optional allow-list of corpus field names embedded for semantic search\n * (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or\n * empty, the full default field set is used (backward compatible). When set,\n * only the named fields are embedded — letting teams opt structured signals\n * (priority, assignee, risk, acceptance_criteria, etc.) in/out for token\n * efficiency. Changing this re-flags items stale on the next refresh.\n /\n corpus_fields?: string[];\n mutation_refresh_policy: SearchMutationRefreshPolicy;\n query_expansion: SearchQueryExpansionSettings;\n rerank: SearchRerankSettings;\n /\n Offline BM25 lexical-ranking parameters (pm-75k9), applied when\n * `search.provider` is `bm25` (or auto-selected as the offline fallback) for\n * semantic/hybrid queries. `k1` controls term-frequency saturation, `b`\n * controls document-length normalization. Unset → Lucene defaults (1.2/0.75).\n */\n bm25?: {\n k1?: number;\n b?: number;\n };\n tuning?: {\n title_exact_bonus?: number;\n title_weight?: number;\n description_weight?: number;\n tags_weight?: number;\n status_weight?: number;\n body_weight?: number;\n comments_weight?: number;\n notes_weight?: number;\n learnings_weight?: number;\n dependencies_weight?: number;\n linked_content_weight?: number;\n };\n };\n providers: {\n openai: {\n base_url: string;\n api_key: string;\n model: string;\n };\n ollama: {\n base_url: string;\n model: string;\n };\n };\n context: ContextSettings;\n vector_store: {\n adapter?: string;\n collection_name: string;\n qdrant: {\n url: string;\n api_key: string;\n };\n lancedb: {\n path: string;\n };\n };\n}\n"],"names":[],"mappings":"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","debugId":"46812059-b93e-5599-a222-4ac0de6f4911"}
1	+ {"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module types\n \n Defines the shared project-management data model used by CLI, SDK, MCP, and packages.\n /\nexport const BUILTIN_ITEM_TYPE_VALUES = [\n \"Epic\",\n \"Feature\",\n \"Task\",\n \"Chore\",\n \"Issue\",\n \"Decision\",\n \"Event\",\n \"Reminder\",\n \"Milestone\",\n \"Meeting\",\n \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\n/\n Restricts builtin item type values accepted by command, SDK, and storage contracts.\n /\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\n/\n Restricts item type values accepted by command, SDK, and storage contracts.\n /\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n \"draft\",\n \"open\",\n \"in_progress\",\n \"blocked\",\n \"closed\",\n \"canceled\",\n] as const;\n/\n Restricts item status values accepted by command, SDK, and storage contracts.\n /\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n \"draft\",\n \"active\",\n \"blocked\",\n \"terminal\",\n \"terminal_done\",\n \"terminal_canceled\",\n \"default_open\",\n \"default_close\",\n \"default_cancel\",\n] as const;\n/\n Restricts runtime status role values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\n/\n Restricts runtime field type values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\n/\n Restricts runtime field command values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\n/\n Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts.\n /\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n \"blocks\",\n \"parent\",\n \"child\",\n \"parent_child\",\n \"child_of\",\n \"related\",\n \"related_to\",\n \"discovered_from\",\n \"blocked_by\",\n \"incident_from\",\n \"epic\",\n \"supersedes\",\n \"task\",\n] as const;\n/\n Restricts dependency kind values accepted by command, SDK, and storage contracts.\n /\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\n/\n Restricts link scope values accepted by command, SDK, and storage contracts.\n /\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/\n Restricts risk level values accepted by command, SDK, and storage contracts.\n /\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/\n Restricts issue severity values accepted by command, SDK, and storage contracts.\n /\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\n/\n Restricts confidence text level values accepted by command, SDK, and storage contracts.\n /\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\n/\n Restricts confidence value values accepted by command, SDK, and storage contracts.\n /\nexport type ConfidenceValue = number \| ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\n/\n Restricts item format values accepted by command, SDK, and storage contracts.\n /\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/\n Restricts sprint release format policy values accepted by command, SDK, and storage contracts.\n /\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/\n Restricts parent reference policy values accepted by command, SDK, and storage contracts.\n /\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\n/\n Restricts validate metadata profile values accepted by command, SDK, and storage contracts.\n /\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\n/\n Restricts governance preset values accepted by command, SDK, and storage contracts.\n /\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\n/\n Restricts governance ownership enforcement values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\n/\n Restricts governance create mode default values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/\n Restricts governance close validation default values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/\n Restricts governance workflow enforcement values accepted by command, SDK, and storage contracts.\n /\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n \"author\",\n \"acceptance_criteria\",\n \"estimated_minutes\",\n \"close_reason\",\n \"reviewer\",\n \"risk\",\n \"confidence\",\n \"sprint\",\n \"release\",\n] as const;\n/\n Restricts validate metadata required field values accepted by command, SDK, and storage contracts.\n /\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\n/\n Restricts recurrence frequency values accepted by command, SDK, and storage contracts.\n /\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\n/\n Restricts recurrence weekday values accepted by command, SDK, and storage contracts.\n /\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/\n Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n /\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\n/\n Documents the dependency payload exchanged by command, SDK, and package integrations.\n /\nexport interface Dependency {\n id: string;\n kind: DependencyKind;\n created_at: string;\n author?: string;\n source_kind?: string;\n}\n\n/\n Documents the comment payload exchanged by command, SDK, and package integrations.\n /\nexport interface Comment {\n created_at: string;\n author: string;\n text: string;\n}\n\n/\n Documents the log note payload exchanged by command, SDK, and package integrations.\n /\nexport interface LogNote {\n created_at: string;\n author: string;\n text: string;\n}\n\n/\n Documents the linked file payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedFile {\n path: string;\n scope: LinkScope;\n note?: string;\n}\n\n/\n Documents the linked test payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedTest {\n command?: string;\n path?: string;\n scope: LinkScope;\n timeout_seconds?: number;\n pm_context_mode?: \"schema\" \| \"tracker\" \| \"auto\";\n env_set?: Record<string, string>;\n env_clear?: string[];\n shared_host_safe?: boolean;\n assert_stdout_contains?: string[];\n assert_stdout_regex?: string[];\n assert_stderr_contains?: string[];\n assert_stderr_regex?: string[];\n assert_stdout_min_lines?: number;\n assert_json_field_equals?: Record<string, string>;\n assert_json_field_gte?: Record<string, number>;\n note?: string;\n}\n\n/\n Documents the linked doc payload exchanged by command, SDK, and package integrations.\n /\nexport interface LinkedDoc {\n path: string;\n scope: LinkScope;\n note?: string;\n}\n\n/\n Documents the reminder payload exchanged by command, SDK, and package integrations.\n /\nexport interface Reminder {\n at: string;\n text: string;\n}\n\n/\n Documents the recurrence rule payload exchanged by command, SDK, and package integrations.\n /\nexport interface RecurrenceRule {\n freq: RecurrenceFrequency;\n interval?: number;\n count?: number;\n until?: string;\n by_weekday?: RecurrenceWeekday[];\n by_month_day?: number[];\n exdates?: string[];\n}\n\n/\n Documents the calendar event payload exchanged by command, SDK, and package integrations.\n /\nexport interface CalendarEvent {\n start_at: string;\n end_at?: string;\n title?: string;\n description?: string;\n location?: string;\n all_day?: boolean;\n timezone?: string;\n recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n \"draft\",\n \"research\",\n \"review\",\n \"approved\",\n \"executing\",\n \"paused\",\n \"completed\",\n \"superseded\",\n] as const;\n/\n Restricts plan mode values accepted by command, SDK, and storage contracts.\n /\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n \"pending\",\n \"in_progress\",\n \"completed\",\n \"blocked\",\n \"skipped\",\n \"superseded\",\n] as const;\n/\n Restricts plan step status values accepted by command, SDK, and storage contracts.\n /\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\n/\n Restricts plan harness values accepted by command, SDK, and storage contracts.\n /\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n \"related\",\n \"blocks\",\n \"blocked_by\",\n \"depends_on\",\n \"discovered_from\",\n \"implements\",\n \"verifies\",\n \"supersedes\",\n] as const;\n/\n Restricts plan step link kind values accepted by command, SDK, and storage contracts.\n /\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\n/\n Documents the plan step link payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepLink {\n id: string;\n kind: PlanStepLinkKind;\n note?: string;\n required_before_step?: boolean;\n}\n\n/\n Documents the plan step file payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepFile {\n path: string;\n scope?: LinkScope;\n note?: string;\n}\n\n/\n Documents the plan step test payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepTest {\n command?: string;\n path?: string;\n note?: string;\n}\n\n/\n Documents the plan step doc payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStepDoc {\n path: string;\n scope?: LinkScope;\n note?: string;\n}\n\n/\n Documents the plan step payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanStep {\n id: string;\n order: number;\n title: string;\n body?: string;\n status: PlanStepStatus;\n owner?: string;\n evidence?: string;\n blocked_reason?: string;\n superseded_by?: string;\n linked_items?: PlanStepLink[];\n files?: PlanStepFile[];\n tests?: PlanStepTest[];\n docs?: PlanStepDoc[];\n created_at: string;\n updated_at: string;\n completed_at?: string;\n}\n\n/\n Documents the plan decision payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanDecision {\n ts: string;\n author: string;\n decision: string;\n rationale?: string;\n evidence?: string;\n step_id?: string;\n}\n\n/\n Documents the plan discovery payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanDiscovery {\n ts: string;\n author: string;\n text: string;\n step_id?: string;\n}\n\n/\n Documents the plan validation check payload exchanged by command, SDK, and package integrations.\n /\nexport interface PlanValidationCheck {\n text: string;\n command?: string;\n expected?: string;\n}\n\n/\n Documents the item type option definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeOptionDefinition {\n key: string;\n values: string[];\n required?: boolean;\n aliases?: string[];\n description?: string;\n}\n\n/\n Documents the item type command option policy payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeCommandOptionPolicy {\n command: \"create\" \| \"update\";\n option: string;\n required?: boolean;\n visible?: boolean;\n enabled?: boolean;\n}\n\n/\n Documents the item type definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTypeDefinition {\n name: string;\n description?: string;\n /\n Status assigned to newly created items of this type when `--status` is not\n * provided. Falls back to the workflow's open status when unset or invalid.\n /\n default_status?: string;\n folder?: string;\n aliases?: string[];\n required_create_fields?: string[];\n required_create_repeatables?: string[];\n options?: ItemTypeOptionDefinition[];\n command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\n/\n Documents the runtime status definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeStatusDefinition {\n id: string;\n aliases?: string[];\n roles?: RuntimeStatusRole[];\n description?: string;\n order?: number;\n}\n\n/\n Documents the runtime field definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeFieldDefinition {\n key: string;\n metadata_key?: string;\n /\n @deprecated Use metadata_key.\n /\n front_matter_key?: string;\n cli_flag?: string;\n cli_aliases?: string[];\n description?: string;\n type?: RuntimeFieldType;\n commands?: RuntimeFieldCommand[];\n repeatable?: boolean;\n required?: boolean;\n required_on_create?: boolean;\n required_types?: string[];\n allow_unset?: boolean;\n}\n\n/\n Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeWorkflowDefinition {\n draft_status?: string;\n open_status?: string;\n in_progress_status?: string;\n blocked_status?: string;\n close_status?: string;\n canceled_status?: string;\n}\n\n/\n Documents the runtime schema file config payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeSchemaFileConfig {\n types?: string;\n statuses?: string;\n fields?: string;\n workflows?: string;\n}\n\n/\n Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n /\nexport interface TypeWorkflowDefinition {\n type: string;\n allowed_transitions: [string, string][];\n}\n\n/\n Documents the runtime schema settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface RuntimeSchemaSettings {\n version: number;\n files: RuntimeSchemaFileConfig;\n statuses: RuntimeStatusDefinition[];\n fields: RuntimeFieldDefinition[];\n workflow: RuntimeWorkflowDefinition;\n type_workflows?: TypeWorkflowDefinition[];\n unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\n/\n Documents the item test run summary payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemTestRunSummary {\n run_id: string;\n kind: \"test\" \| \"test-all\";\n status: \"passed\" \| \"failed\" \| \"stopped\" \| \"canceled\";\n started_at: string;\n finished_at: string;\n recorded_at: string;\n attempt?: number;\n resumed_from?: string;\n passed: number;\n failed: number;\n skipped: number;\n items?: number;\n linked_tests?: number;\n fail_on_skipped_triggered?: boolean;\n}\n\n/\n Documents the item metadata payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemMetadata {\n id: string;\n title: string;\n description: string;\n type: ItemType;\n /\n On-disk front-matter format version. Absent means the implicit baseline\n * (version 1) and is never serialized; populated only once an item advances\n * past the baseline via a future storage migration. See\n * core/item/item-format-version.\n /\n pm_format_version?: number;\n source_type?: string;\n type_options?: Record<string, string>;\n status: ItemStatus;\n priority: 0 \| 1 \| 2 \| 3 \| 4;\n tags: string[];\n created_at: string;\n updated_at: string;\n deadline?: string;\n reminders?: Reminder[];\n events?: CalendarEvent[];\n closed_at?: string;\n assignee?: string;\n source_owner?: string;\n author?: string;\n estimated_minutes?: number;\n acceptance_criteria?: string;\n design?: string;\n external_ref?: string;\n definition_of_ready?: string;\n order?: number;\n goal?: string;\n objective?: string;\n value?: string;\n impact?: string;\n outcome?: string;\n why_now?: string;\n parent?: string;\n reviewer?: string;\n risk?: RiskLevel;\n confidence?: ConfidenceValue;\n sprint?: string;\n release?: string;\n blocked_by?: string;\n blocked_reason?: string;\n unblock_note?: string;\n reporter?: string;\n severity?: IssueSeverity;\n environment?: string;\n repro_steps?: string;\n resolution?: string;\n expected_result?: string;\n actual_result?: string;\n affected_version?: string;\n fixed_version?: string;\n component?: string;\n regression?: boolean;\n customer_impact?: string;\n dependencies?: Dependency[];\n comments?: Comment[];\n notes?: LogNote[];\n learnings?: LogNote[];\n files?: LinkedFile[];\n tests?: LinkedTest[];\n test_runs?: ItemTestRunSummary[];\n docs?: LinkedDoc[];\n close_reason?: string;\n duplicate_of?: string;\n plan_mode?: PlanMode;\n plan_scope?: string;\n plan_harness?: PlanHarness;\n plan_steps?: PlanStep[];\n plan_decisions?: PlanDecision[];\n plan_discoveries?: PlanDiscovery[];\n plan_validation?: PlanValidationCheck[];\n plan_resume_context?: string;\n [key: string]: unknown;\n}\n\n/\n @deprecated Use ItemMetadata.\n /\nexport type ItemFrontMatter = ItemMetadata;\n\n/\n Documents the item document payload exchanged by command, SDK, and package integrations.\n /\nexport interface ItemDocument {\n metadata: ItemMetadata;\n body: string;\n}\n\n/\n Documents the history patch op payload exchanged by command, SDK, and package integrations.\n /\nexport interface HistoryPatchOp {\n op: \"add\" \| \"remove\" \| \"replace\" \| \"move\" \| \"copy\" \| \"test\";\n path: string;\n from?: string;\n value?: unknown;\n}\n\n/\n Documents the history entry payload exchanged by command, SDK, and package integrations.\n /\nexport interface HistoryEntry {\n ts: string;\n author: string;\n op: string;\n patch: HistoryPatchOp[];\n before_hash: string;\n after_hash: string;\n message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\", \"full\"] as const;\n/\n Restricts context depth values accepted by command, SDK, and storage contracts.\n /\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n \"hierarchy\",\n \"activity\",\n \"progress\",\n \"recently_created\",\n \"unparented\",\n \"blockers\",\n \"files\",\n \"workload\",\n \"staleness\",\n \"tests\",\n] as const;\n/\n Restricts context section name values accepted by command, SDK, and storage contracts.\n /\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\n/\n Documents the context section settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ContextSectionSettings {\n hierarchy: boolean;\n activity: boolean;\n progress: boolean;\n recently_created: boolean;\n unparented: boolean;\n blockers: boolean;\n files: boolean;\n workload: boolean;\n staleness: boolean;\n tests: boolean;\n}\n\n/\n Documents the context settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ContextSettings {\n default_depth: ContextDepth;\n activity_limit: number;\n stale_threshold_days: number;\n sections: ContextSectionSettings;\n}\n\n/\n Documents the governance settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface GovernanceSettings {\n preset: GovernancePreset;\n ownership_enforcement: GovernanceOwnershipEnforcement;\n create_mode_default: GovernanceCreateModeDefault;\n close_validation_default: GovernanceCloseValidationDefault;\n require_close_reason: boolean;\n parent_reference: ParentReferencePolicy;\n metadata_profile: ValidateMetadataProfile;\n force_required_for_stale_lock: boolean;\n create_default_type?: string;\n /\n Per-type allowed-transition enforcement mode for `pm update --status`.\n * Read raw from settings (not preset-derived) so existing projects are\n * unaffected when unset; defaults to \"off\".\n /\n workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\n/\n Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionPolicyMode = \"off\" \| \"warn\" \| \"enforce\";\n/\n Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionTrustMode = \"off\" \| \"warn\" \| \"enforce\";\n/\n Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n /\nexport type ExtensionSandboxProfile = \"none\" \| \"restricted\" \| \"strict\";\n\n/\n Documents the extension policy override settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ExtensionPolicyOverrideSettings {\n name: string;\n disabled?: boolean;\n require_trusted?: boolean;\n require_provenance?: boolean;\n sandbox_profile?: ExtensionSandboxProfile;\n allowed_capabilities?: string[];\n blocked_capabilities?: string[];\n allowed_surfaces?: string[];\n blocked_surfaces?: string[];\n allowed_commands?: string[];\n blocked_commands?: string[];\n allowed_actions?: string[];\n blocked_actions?: string[];\n allowed_services?: string[];\n blocked_services?: string[];\n}\n\n/\n Documents the extension policy settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface ExtensionPolicySettings {\n mode: ExtensionPolicyMode;\n trust_mode: ExtensionTrustMode;\n require_provenance: boolean;\n trusted_extensions: string[];\n default_sandbox_profile: ExtensionSandboxProfile;\n allowed_extensions: string[];\n blocked_extensions: string[];\n allowed_capabilities: string[];\n blocked_capabilities: string[];\n allowed_surfaces: string[];\n blocked_surfaces: string[];\n allowed_commands: string[];\n blocked_commands: string[];\n allowed_actions: string[];\n blocked_actions: string[];\n allowed_services: string[];\n blocked_services: string[];\n extension_overrides: ExtensionPolicyOverrideSettings[];\n}\n\n/\n Documents the agent guidance settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface AgentGuidanceSettings {\n prompt_completed: boolean;\n declined: boolean;\n declined_at: string;\n template_version: number;\n last_checked_files: string[];\n}\n\n/\n Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts.\n /\nexport type SearchMutationRefreshPolicy = \"cache_only\" \| \"semantic_configured\" \| \"semantic_auto\";\n\n/\n Documents the search query expansion settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface SearchQueryExpansionSettings {\n enabled: boolean;\n provider: string;\n}\n\n/\n Documents the search rerank settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface SearchRerankSettings {\n enabled: boolean;\n model: string;\n top_k: number;\n}\n\n/\n Config-driven policy for automatic history-stream compaction triage.\n \n When `enabled`, `pm health` surfaces an advisory warning for any history\n * stream whose non-empty entry count exceeds `max_entries`, and `pm\n * history-compact` bulk mode uses `max_entries` as its default `--all-over`\n * threshold so the configured policy drives corpus-wide sweeps. `trigger`\n * records operator intent — both values raise the health advisory; `auto`\n * additionally signals that scheduled/automatic sweeps are expected.\n /\nexport interface HistoryCompactPolicy {\n enabled: boolean;\n max_entries: number;\n trigger: \"health_warn\" \| \"auto\";\n}\n\n/\n Documents the pm settings payload exchanged by command, SDK, and package integrations.\n /\nexport interface PmSettings {\n version: number;\n id_prefix: string;\n author_default: string;\n item_format: ItemFormat;\n locks: {\n ttl_seconds: number;\n /\n Bounded wait budget (milliseconds) for acquiring a contended item lock\n * before surfacing lock_conflict. 0 disables waiting (fail-fast).\n * Overridable per invocation via PM_LOCK_WAIT_MS.\n /\n wait_ms: number;\n };\n /\n Retention policy for bulk-mutation rollback checkpoints written by\n * `update-many`/`close-many`. `pm gc --scope checkpoints` prunes checkpoint\n * files older than `retention_days`; checkpoints with an unparseable\n * `created_at` are retained (safety-first, mirroring the stale-lock sweep).\n /\n checkpoints: {\n retention_days: number;\n };\n output: {\n default_format: \"toon\" \| \"json\";\n };\n history: {\n missing_stream: \"auto_create\" \| \"strict_error\";\n compact_policy: HistoryCompactPolicy;\n };\n validation: {\n sprint_release_format: SprintReleaseFormatPolicy;\n parent_reference: ParentReferencePolicy;\n metadata_profile: ValidateMetadataProfile;\n metadata_required_fields: ValidateMetadataRequiredField[];\n lifecycle_stale_blocker_reason_patterns: string[];\n lifecycle_closure_like_blocked_reason_patterns: string[];\n lifecycle_closure_like_resolution_patterns: string[];\n lifecycle_closure_like_actual_result_patterns: string[];\n /\n Per-type default estimates (minutes) used by `pm validate --auto-fix\n * --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212).\n * Keys are item type names (case-insensitive); values are positive minutes\n * that override the built-in defaults. Empty by default.\n /\n estimate_defaults_by_type: Record<string, number>;\n };\n governance: GovernanceSettings;\n workflow: {\n definition_of_done: string[];\n };\n testing: {\n record_results_to_items: boolean;\n };\n telemetry: {\n enabled: boolean;\n first_run_prompt_completed: boolean;\n capture_level: \"minimal\" \| \"redacted\" \| \"max\";\n endpoint: string;\n installation_id: string;\n retention_days: number;\n };\n agent_guidance: AgentGuidanceSettings;\n item_types: {\n definitions: ItemTypeDefinition[];\n };\n schema: RuntimeSchemaSettings;\n extensions: {\n enabled: string[];\n disabled: string[];\n policy: ExtensionPolicySettings;\n };\n search: {\n score_threshold: number;\n hybrid_semantic_weight: number;\n max_results: number;\n embedding_model: string;\n embedding_corpus_max_characters?: number;\n embedding_batch_size: number;\n embedding_timeout_ms: number;\n scanner_max_batch_retries: number;\n provider?: string;\n /\n Optional allow-list of corpus field names embedded for semantic search\n * (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or\n * empty, the full default field set is used (backward compatible). When set,\n * only the named fields are embedded — letting teams opt structured signals\n * (priority, assignee, risk, acceptance_criteria, etc.) in/out for token\n * efficiency. Changing this re-flags items stale on the next refresh.\n /\n corpus_fields?: string[];\n mutation_refresh_policy: SearchMutationRefreshPolicy;\n query_expansion: SearchQueryExpansionSettings;\n rerank: SearchRerankSettings;\n /\n Offline BM25 lexical-ranking parameters (pm-75k9), applied when\n * `search.provider` is `bm25` (or auto-selected as the offline fallback) for\n * semantic/hybrid queries. `k1` controls term-frequency saturation, `b`\n * controls document-length normalization. Unset → Lucene defaults (1.2/0.75).\n */\n bm25?: {\n k1?: number;\n b?: number;\n };\n tuning?: {\n title_exact_bonus?: number;\n title_weight?: number;\n description_weight?: number;\n tags_weight?: number;\n status_weight?: number;\n body_weight?: number;\n comments_weight?: number;\n notes_weight?: number;\n learnings_weight?: number;\n dependencies_weight?: number;\n linked_content_weight?: number;\n };\n };\n providers: {\n openai: {\n base_url: string;\n api_key: string;\n model: string;\n };\n ollama: {\n base_url: string;\n model: string;\n };\n };\n context: ContextSettings;\n vector_store: {\n adapter?: string;\n collection_name: string;\n qdrant: {\n url: string;\n api_key: string;\n };\n lancedb: {\n path: string;\n };\n };\n}\n"],"names":[],"mappings":"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","debugId":"6e5bac32-d895-5fce-9fc0-9c0615399b61"}

package/docs/ARCHITECTURE.md CHANGED Viewed

@@ -264,6 +264,33 @@ applies:
 Verify the end-to-end surface with `pm contracts --command <name> --json`,
 `pm help <name> --json`, and the matching MCP tool listing.
+## SDK-First Boundary
+The target layering is: `src/core` remains private implementation detail,
+`src/sdk` is the public programmatic API, and `src/cli` plus `src/mcp` are
+presentation layers over SDK primitives. The migration is tracked under
+[pm-usfg](../.agents/pm/epics/pm-usfg.toon), with the current map in
+[SDK Primitive Inventory](SDK_PRIMITIVE_INVENTORY.md).
+Until all primitive families are promoted, the static quality gate enforces a
+ratchet instead of pretending the boundary is already complete:
+- `scripts/release/sdk-import-boundary-baseline.json` records the current
+  `src/cli`/`src/mcp` private `src/core` import edges.
+- The ratchet counts type-only imports and re-exports too. A type-only
+  `src/core` reference still couples the presentation layer to private core
+  contracts, so it must be promoted behind `src/sdk` with the rest of the
+  primitive surface.
+- `pnpm quality:static` fails when a PR adds a new private edge or uses a
+  computed dynamic `import()` from a boundary source that the ratchet cannot
+  inventory.
+- The same gate fails when the baseline still contains an edge that no longer
+  exists, forcing each promotion PR to shrink the baseline as it removes direct
+  core imports.
+Do not add new CLI/MCP behavior by deep-importing `src/core`. Add or extend an
+SDK primitive first, then consume that SDK surface from the presentation layer.
 ## Telemetry Schema Negotiation
 Telemetry preserves wire compatibility through an explicit client/server negotiation split:

package/docs/CONFIGURATION.md CHANGED Viewed

@@ -61,6 +61,7 @@ When `settings.json` cannot be loaded, `pm` falls back to built-in defaults and
 | `item_format` | item storage format (`toon` writes; legacy markdown is read/migrate only) |
 | `output.default_format` | default renderer, usually `toon` |
 | `locks.ttl_seconds` | stale lock threshold |
+| `locks.wait_ms` | bounded jittered wait budget before a contended item mutation returns `lock_conflict` (default `3000`; set `0` to fail fast) |
 | `history.missing_stream` | `auto_create` or `strict_error` |
 | `history.compact_policy.enabled` | enable the compaction advisory: `pm health` warns on over-threshold streams (default `false`); when disabled, `max_entries`/`trigger` are inert |
 | `history.compact_policy.max_entries` | when the policy is enabled, the entry count above which a stream is flagged by `pm health` and the default `pm history-compact --all-over` threshold (default `500`) |
@@ -83,6 +84,7 @@ pm config project set id_prefix task                       # (id_prefix) IDs bec
 pm config project set author_default release-bot           # (author_default) default mutation author
 pm config project set output_default_format json           # (output.default_format) toon | json
 pm config project set locks_ttl_seconds 60                 # (locks.ttl_seconds) integer >= 1
+pm config project set locks_wait_ms 3000                   # (locks.wait_ms) integer >= 0
 pm config project set checkpoints_retention_days 30        # (checkpoints.retention_days) integer >= 1; pm gc --scope checkpoints prunes checkpoints older than this many days
 pm config project set schema_unknown_field_policy reject   # (schema.unknown_field_policy) allow | warn | reject
 ```
@@ -94,6 +96,7 @@ pm config project set schema_unknown_field_policy reject   # (schema.unknown_fie
 | `PM_AUTHOR` | explicit mutation author |
 | `PM_PATH` | override project tracker root for tests or sandboxes |
 | `PM_GLOBAL_PATH` | override global profile root for tests or sandboxes |
+| `PM_LOCK_WAIT_MS` | per-process override for `locks.wait_ms`; non-negative integer milliseconds, with `0` restoring fail-fast lock conflicts |
 | `PM_OLLAMA_MODEL` | choose default Ollama embedding model |
 | `PM_DISABLE_OLLAMA_AUTO_DEFAULTS` | disable implicit Ollama search defaults |

package/docs/README.md CHANGED Viewed

@@ -37,6 +37,7 @@ pm guide release --json
 - [Configuration](CONFIGURATION.md) - settings, storage formats, output, search, validation, and environment variables.
 - [Testing](TESTING.md) - sandbox-safe local tests and linked-test orchestration.
 - [Architecture](ARCHITECTURE.md) - contributor internals: storage, mutation flow, search, extensions, and command contracts.
+- [SDK Primitive Inventory](SDK_PRIMITIVE_INVENTORY.md) - SDK-first migration map and private-import ratchet for CLI/MCP layering.
 - [Packages and Extensions](EXTENSIONS.md) - package install workflows, runtime extension lifecycle, and API reference.
 - [Extension Author Contracts](EXTENSION_AUTHOR_CONTRACTS.md) - the stability guarantees and contract surface package authors build against.
 - [SDK](SDK.md) - public import surfaces and typed authoring examples.

package/docs/SDK_PRIMITIVE_INVENTORY.md ADDED Viewed

@@ -0,0 +1,55 @@
+# SDK Primitive Inventory
+Tracked work: [pm-lodl](../.agents/pm/tasks/pm-lodl.toon), [pm-8778](../.agents/pm/tasks/pm-8778.toon), parent [pm-usfg](../.agents/pm/epics/pm-usfg.toon).
+This inventory is the current SDK-first migration map for the principle `project management = context management`.
+The exact per-source CLI/MCP module inventory is checked in at [`scripts/release/sdk-import-boundary-baseline.json`](../scripts/release/sdk-import-boundary-baseline.json): each `allowed_private_core_imports[]` entry names one command, helper, or MCP source file and the private `src/core` modules it currently imports. The static quality gate reads that file and fails when `src/cli` or `src/mcp` adds a new private `src/core` import, uses a computed dynamic `import()` that cannot be ratcheted, or leaves a stale baseline entry after an import has been removed.
+## Current Baseline
+- Boundary scope: `src/cli.ts`, `src/cli/**`, `src/mcp.ts`, and `src/mcp/**`.
+- Current scan size and private-edge counts are derived from [`scripts/release/sdk-import-boundary-baseline.json`](../scripts/release/sdk-import-boundary-baseline.json) and the `pnpm quality:static` ratchet output.
+- Type-only imports and re-exports are intentionally counted because they still expose presentation layers to private core contracts.
+- Baseline owner: [pm-8778](../.agents/pm/tasks/pm-8778.toon).
+- Ratchet rule: SDK promotion PRs must shrink the baseline when they move a primitive behind `src/sdk`; no PR may grow it.
+## Checked-In Per-Source Inventory
+Use [`scripts/release/sdk-import-boundary-baseline.json`](../scripts/release/sdk-import-boundary-baseline.json) as the detailed inventory rather than duplicating every edge in Markdown. Command handlers map directly from the `source` field, for example `src/cli/commands/update.ts` inventories the update command's private core modules and `src/mcp/server.ts` inventories MCP server private core imports. Function-level ownership stays in the source modules themselves; this document maps each command family to its SDK promotion owner so the baseline can shrink without stale prose.
+## Promotion Partition
+| Promotion item | Primitive family | Primary private domains to promote |
+| --- | --- | --- |
+| [pm-98cz](../.agents/pm/features/pm-98cz.toon) | Item lifecycle | `core/item`, `core/store`, `core/lock`, mutation checkpoints |
+| [pm-rjqr](../.agents/pm/features/pm-rjqr.toon) | Query and read | `core/search`, read projections, context/next/list/get aggregation |
+| [pm-zwpp](../.agents/pm/features/pm-zwpp.toon) | Annotations and links | comments, notes, learnings, files, docs, deps, append metadata |
+| [pm-3mna](../.agents/pm/features/pm-3mna.toon) | Workspace customization | `core/schema`, `core/config`, profiles, init presets |
+| [pm-oxrw](../.agents/pm/features/pm-oxrw.toon) | Governance and maintenance | validate, health, gc, normalize, issue-code and remediation surfaces |
+| [pm-4a7m](../.agents/pm/features/pm-4a7m.toon) | History maintenance | history read, redact, repair, compact, restore history replay |
+| [pm-je50](../.agents/pm/features/pm-je50.toon) | Plan workflow | plan steps, dependencies, decisions, discoveries, validation, materialization |
+| [pm-oslr](../.agents/pm/features/pm-oslr.toon) | Execution and diagnostics | linked-test running, test-run lifecycle, eval, telemetry stats/export |
+## Command Family Map
+| CLI/MCP source family | SDK destination | Notes |
+| --- | --- | --- |
+| `create`, `update`, `update-many`, `copy`, `delete`, `restore` | [pm-98cz](../.agents/pm/features/pm-98cz.toon) | Item CRUD and replay paths should become typed lifecycle SDK calls. |
+| `claim`, `release`, `focus`, lifecycle shortcut helpers | [pm-98cz](../.agents/pm/features/pm-98cz.toon) | Ownership and actionable-state changes belong beside lifecycle primitives. |
+| `list`, `get`, `search`, `context`, `next`, `aggregate`, `stats` | [pm-rjqr](../.agents/pm/features/pm-rjqr.toon) | Read models should be reusable by CLI, MCP, and custom agents without shelling out. |
+| `comments`, `notes`, `learnings`, `files`, `docs`, `deps`, `append` | [pm-zwpp](../.agents/pm/features/pm-zwpp.toon) | Annotation/link mutation semantics must be stable SDK primitives. |
+| `schema`, `config`, `profile`, `init`, `init-agent-guidance` | [pm-3mna](../.agents/pm/features/pm-3mna.toon) | Universal customization requires programmatic schema, profile, and config APIs. |
+| `validate`, `health`, `gc`, `normalize`, `dedupe-audit`, `comments-audit` | [pm-oxrw](../.agents/pm/features/pm-oxrw.toon) | Governance should expose structured findings, remediation hints, and dry-run plans. |
+| `history`, `activity`, `history-redact`, `history-repair`, `history-compact` | [pm-4a7m](../.agents/pm/features/pm-4a7m.toon) | Audited history read, activity, rewrite, and checkpoint operations need explicit public contracts. |
+| `plan` | [pm-je50](../.agents/pm/features/pm-je50.toon) | Plan harness operations should be usable by external orchestrators through SDK calls. |
+| `test`, `test-all`, `test-runs`, `eval`, `telemetry`, `reindex` | [pm-oslr](../.agents/pm/features/pm-oslr.toon) | Execution helpers should return typed run state and diagnostics instead of CLI-only text. |
+| `extension`, `upgrade`, package lifecycle helpers | [pm-ugqx](../.agents/pm/epics/pm-ugqx.toon) | Existing package-author SDK surfaces stay public; package lifecycle can move behind SDK runtime helpers. |
+| `src/mcp/**` | [pm-usfg](../.agents/pm/epics/pm-usfg.toon) | MCP tools should call SDK primitives directly once each family is promoted. |
+## Ratchet Workflow
+1. Promote one primitive family into `src/sdk`.
+2. Move the relevant CLI/MCP handler calls from private `src/core` imports to SDK imports.
+3. Regenerate `scripts/release/sdk-import-boundary-baseline.json` from the current tree.
+4. Run `pnpm quality:static`; the gate must show no new private imports, no unsupported dynamic imports, and no stale baseline entries.
+5. Link the changed source, docs, and tests back to the promotion item with `pm files`, `pm docs`, and `pm test`.

package/docs/TESTING.md CHANGED Viewed

@@ -37,7 +37,11 @@ repo-specific `quality:static` gate. The dedicated `quality:static` gate remains
 authoritative for source/exported docstring coverage, orphan-module checks,
 directory-load caps, and the TypeScript-aware duplicate/complexity checks that
 are tailored to pm's source layout; `pnpm lint` delegates to it instead of
-running a second threshold profile.
+running a second threshold profile. It also includes a changed-file
+CodeFactor-parity complexity scan for shipped source, package, and script files
+so PR-local CodeFactor maintainability annotations fail locally before commit or
+push. Existing legacy high-complexity test fixtures are tracked separately and
+must not be used as precedent for new changed production/script code.
 ## Focused Test Runs

package/docs/examples/ci/github-actions-pm-extension-gate.yml CHANGED Viewed

@@ -13,17 +13,17 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.10.0
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: pnpm
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

package/docs/examples/ci/gitlab-ci-pm-extension-gate.yml CHANGED Viewed

@@ -8,7 +8,7 @@ stages:
 before_script:
   - corepack enable
-  - corepack prepare pnpm@10 --activate
+  - corepack prepare pnpm@11.10.0 --activate
   - pnpm install --frozen-lockfile
 build:

package/docs/examples/ci/jenkins-pm-extension-gate.Jenkinsfile CHANGED Viewed

@@ -9,7 +9,7 @@ pipeline {
     stage("Install") {
       steps {
         sh "corepack enable"
-        sh "corepack prepare pnpm@10 --activate"
+        sh "corepack prepare pnpm@11.10.0 --activate"
         sh "pnpm install --frozen-lockfile"
       }
     }

package/package.json CHANGED Viewed

@@ -1,8 +1,9 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.7.3",
+  "version": "2026.7.5",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
+  "packageManager": "pnpm@11.10.0",
   "author": "unbrained",
   "homepage": "https://github.com/unbraind/pm-cli#readme",
   "repository": {
@@ -21,23 +22,23 @@
   "exports": {
     ".": {
       "types": "./dist/sdk/index.d.ts",
-      "import": "./dist/sdk/index.js",
-      "default": "./dist/sdk/index.js"
+      "import": "./dist/cli-bundle/sdk.js",
+      "default": "./dist/cli-bundle/sdk.js"
     },
     "./sdk": {
       "types": "./dist/sdk/index.d.ts",
-      "import": "./dist/sdk/index.js",
-      "default": "./dist/sdk/index.js"
+      "import": "./dist/cli-bundle/sdk.js",
+      "default": "./dist/cli-bundle/sdk.js"
     },
     "./sdk/runtime": {
       "types": "./dist/sdk/runtime.d.ts",
-      "import": "./dist/sdk/runtime.js",
-      "default": "./dist/sdk/runtime.js"
+      "import": "./dist/cli-bundle/sdk-runtime.js",
+      "default": "./dist/cli-bundle/sdk-runtime.js"
     },
     "./sdk/testing": {
       "types": "./dist/sdk/testing.d.ts",
-      "import": "./dist/sdk/testing.js",
-      "default": "./dist/sdk/testing.js"
+      "import": "./dist/cli-bundle/sdk-testing.js",
+      "default": "./dist/cli-bundle/sdk-testing.js"
     },
     "./cli": {
       "types": "./dist/cli/main.d.ts",
@@ -79,7 +80,7 @@
     "lint:complexity:baseline": "eslint . --suppress-rule complexity",
     "lint:duplicates": "jscpd --config .jscpd.json",
     "lint:codefactor": "pnpm quality:static",
-    "quality:static": "node scripts/release/static-quality-gate.mjs",
+    "quality:static": "node scripts/release/static-quality-gate.mjs --min-docstring-coverage 92.93 --min-exported-docstring-coverage 84.41 --min-member-docstring-coverage 13.655",
     "quality:docs-skills": "node scripts/release/docs-skills-gate.mjs",
     "quality:docs-links": "node scripts/release/docs-skills-gate.mjs --links-only",
     "contracts:update": "node scripts/contracts-snapshot.mjs --update",
@@ -140,31 +141,18 @@
     "fast-json-patch": "^3.1.1"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@sentry/cli": "^3.6.0",
     "@types/node": "^22.20.0",
     "@vitest/coverage-v8": "^4.1.9",
     "esbuild": "0.28.1",
     "eslint": "^10.6.0",
-    "eslint-plugin-unicorn": "^69.0.0",
+    "eslint-plugin-unicorn": "^70.0.0",
     "greptile": "^3.1.1",
     "jscpd": "^5.0.11",
-    "tsx": "^4.22.4",
+    "tsx": "^4.23.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.9"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "@sentry/cli",
-      "esbuild"
-    ],
-    "overrides": {
-      "rollup": ">=4.59.0",
-      "brace-expansion": ">=5.0.6",
-      "vite": "7.3.5",
-      "esbuild": "0.28.1",
-      "@opentelemetry/core": ">=2.8.0",
-      "undici": "6.27.0"
-    }
   }
 }

package/packages/pm-beads/extensions/beads/package.json ADDED Viewed

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/packages/pm-beads/extensions/beads/runtime-loader.ts CHANGED Viewed

@@ -5,16 +5,12 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 /**
  * This file is auto-generated by scripts/gen-package-runtime-loaders.mjs.
  * Do not edit directly.
- * This file is shipped with the package extension and intentionally avoids
- * static SDK imports so project-local installed extensions can load it.
  */
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
 const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
 const EXTENSION_NAME = "beads";
 const PACKAGE_NAME = "pm-beads";
 const DIAGNOSTIC_NAME = "beads";
 export type PackageRuntimeModule = Record<string, unknown>;
 function isRecord(value: unknown): value is Record<string, unknown> {
@@ -33,7 +29,7 @@ function isMissingRuntimeModuleError(error: unknown, modulePath: string): boolea
     return true;
   }
   const message = typeof error.message === "string" ? error.message : "";
-  const normalizedModulePath = modulePath.replace(/\\/g, "/");
+  const normalizedModulePath = modulePath.split("\\").join("/");
   return (
     message.startsWith(`Cannot find module '${modulePath}'`) ||
     message.startsWith(`Cannot find module '${normalizedModulePath}'`) ||
@@ -41,16 +37,34 @@ function isMissingRuntimeModuleError(error: unknown, modulePath: string): boolea
   );
 }
+// Node refuses to type-strip .ts files under node_modules
+// (ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING); fall through to the next
+// candidate (the extension's co-located runtime.ts copy) instead of aborting.
+function isUnstrippableTypeScriptError(error: unknown, modulePath: string): boolean {
+  if (!isRecord(error)) {
+    return false;
+  }
+  const message = typeof error.message === "string" ? error.message : "";
+  if (error.code !== "ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING" && !message.includes("Stripping types is currently unsupported")) {
+    return false;
+  }
+  const moduleUrl = pathToFileURL(modulePath).href;
+  const normalizedModulePath = modulePath.split("\\").join("/");
+  return (
+    error.url === moduleUrl ||
+    (typeof error.path === "string" && path.resolve(error.path) === path.resolve(modulePath)) ||
+    message.includes(modulePath) ||
+    message.includes(normalizedModulePath) ||
+    message.includes(moduleUrl)
+  );
+}
 function resolvePackageRootCandidates(): string[] {
-  const candidates: string[] = [];
   const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
-  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
-    candidates.push(path.resolve(envRoot.trim()));
-  }
+  const candidates = typeof envRoot === "string" && envRoot.trim().length > 0 ? [path.resolve(envRoot.trim())] : [];
   const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
   if (argvEntry.length > 0) {
-    const resolvedEntry = path.resolve(argvEntry);
-    const entryDir = path.dirname(resolvedEntry);
+    const entryDir = path.dirname(path.resolve(argvEntry));
     candidates.push(path.resolve(entryDir, ".."));
     candidates.push(path.resolve(entryDir, "../.."));
     candidates.push(path.resolve(entryDir, "../../.."));
@@ -58,41 +72,36 @@ function resolvePackageRootCandidates(): string[] {
   return [...new Set(candidates)];
 }
-export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule> {
-  const attempted: string[] = [];
-  for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePaths = [
-      path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.ts"),
-      path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.ts"),
-    ];
-    for (const modulePath of modulePaths) {
-      attempted.push(modulePath);
-      if (!existsSync(modulePath)) {
-        continue;
-      }
-      try {
-        return await import(pathToFileURL(modulePath).href) as PackageRuntimeModule;
-      } catch (error: unknown) {
-        if (isMissingRuntimeModuleError(error, modulePath)) {
-          continue;
-        }
-        throw error;
-      }
+function runtimePaths(packageRoot: string): string[] {
+  return [
+    path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.ts"),
+    path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.ts"),
+  ];
+}
+async function tryRuntime(modulePath: string, attempted: string[]): Promise<PackageRuntimeModule | undefined> {
+  attempted.push(modulePath);
+  if (!existsSync(modulePath)) {
+    return undefined;
+  }
+  try {
+    return await import(pathToFileURL(modulePath).href) as PackageRuntimeModule;
+  } catch (error: unknown) {
+    if (isMissingRuntimeModuleError(error, modulePath) || isUnstrippableTypeScriptError(error, modulePath)) {
+      return undefined;
     }
+    throw error;
   }
+}
-  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.ts");
-  attempted.push(localRuntimePath);
-  if (existsSync(localRuntimePath)) {
-    try {
-      return await import(pathToFileURL(localRuntimePath).href) as PackageRuntimeModule;
-    } catch (error: unknown) {
-      if (!isMissingRuntimeModuleError(error, localRuntimePath)) {
-        throw error;
-      }
+export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule> {
+  const attempted: string[] = [];
+  for (const modulePath of [...resolvePackageRootCandidates().flatMap(runtimePaths), path.join(CURRENT_EXTENSION_ROOT, "runtime.ts")]) {
+    const loaded = await tryRuntime(modulePath, attempted);
+    if (loaded) {
+      return loaded;
     }
   }
   throw new Error(
     `Unable to resolve packaged ${DIAGNOSTIC_NAME} extension runtime module. ` +
       `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.ts or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,