@unbrained/pm-cli 2026.10.7 → 2026.10.8
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.
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +15 -0
- package/dist/cli-bundle/bundle-manifest.json +152 -152
- package/dist/cli-bundle/chunks/chunk-34L2BS2Z.js +3 -0
- package/dist/cli-bundle/chunks/chunk-FOLSEOJ2.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-A4QWRU7D.js → chunk-HFCIAXLP.js} +5 -5
- package/dist/cli-bundle/chunks/chunk-JDTBPW4Y.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-TG3IOQUG.js → chunk-K6E2FFUT.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-VU77O6HC.js → chunk-L7U5FSZ5.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-N2PFAWVV.js → chunk-MJVRF67I.js} +3 -3
- package/dist/cli-bundle/chunks/{chunk-GJ2OJKRM.js → chunk-OG66KEOF.js} +79 -79
- package/dist/cli-bundle/chunks/{chunk-MOXX7D3F.js → chunk-RCFZ6H2Y.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-TNU56MZI.js +8 -0
- package/dist/cli-bundle/chunks/chunk-UGFN5NJ2.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-TON7H63A.js → chunk-ZBVAZ7XX.js} +53 -52
- package/dist/cli-bundle/chunks/{chunk-DWH555SN.js → chunk-ZHIMZ65M.js} +16 -16
- package/dist/cli-bundle/chunks/{register-list-query-CBJELTDX.js → register-list-query-PYVSPGPV.js} +2 -2
- package/dist/cli-bundle/chunks/{register-mutation-JRH6EGSE.js → register-mutation-WXP3YLIN.js} +2 -2
- package/dist/cli-bundle/chunks/register-operations-WL25C3NP.js +2 -0
- package/dist/cli-bundle/chunks/register-setup-PFKYNEQI.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-2KSPGWLH.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-PBNQZV33.js → chunk-6TKAFFEB.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-EPOCI7ZX.js → chunk-A3W6HFFO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-2YICTWWA.js → chunk-BDT5EALU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-3BKRCR57.js → chunk-DRHJOG5X.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-XIGFEA3W.js → chunk-EOUORVJA.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-F2ME5MJY.js +3 -0
- package/dist/cli-bundle/focused-chunks/{chunk-QY4Z23QC.js → chunk-L3CZNKZE.js} +11 -11
- package/dist/cli-bundle/focused-chunks/{chunk-QEYEDXRI.js → chunk-LZQGEVKT.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-FWWFCLDM.js → chunk-MW2TQHZ3.js} +60 -59
- package/dist/cli-bundle/focused-chunks/{chunk-HMG5F5EC.js → chunk-OLCJ2PJS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-SIR5RFJX.js → chunk-OSKXYRYZ.js} +27 -27
- package/dist/cli-bundle/focused-chunks/{chunk-NRSA5ZB2.js → chunk-PBPPIGUL.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-7X3QD5V4.js → chunk-PEBOVLEG.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-4FKCHJGV.js → chunk-V3EPBB6V.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-3NSZ5C4A.js → chunk-XT7JAVHI.js} +2 -2
- package/dist/cli-bundle/main.js +2 -2
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +1 -1
- package/dist/cli-bundle/sdk-core.js +2 -2
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +51 -50
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +4 -4
- package/dist/core/extensions/item-fields.d.ts +6 -1
- package/dist/core/extensions/item-fields.js +1 -1
- package/dist/core/fs/fs-utils.d.ts +19 -4
- package/dist/core/fs/fs-utils.js +2 -2
- package/dist/core/lock/lock.d.ts +9 -2
- package/dist/core/lock/lock.js +2 -2
- package/dist/core/store/settings.js +2 -2
- package/dist/core/telemetry/runtime.d.ts +1 -1
- package/dist/core/telemetry/runtime.js +4 -4
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/governance/health.js +2 -2
- package/dist/sdk/history-repair.js +1 -1
- package/dist/sdk/item-transaction.js +1 -1
- package/dist/sdk/merge/abandoned-receipts.js +1 -1
- package/dist/sdk/merge/driver.js +1 -1
- package/dist/sdk/merge/install.js +3 -2
- package/dist/sdk/merge/receipt-operation.d.ts +5 -5
- package/dist/sdk/merge/receipt-operation.js +1 -1
- package/dist/sdk/merge/receipts.d.ts +1 -1
- package/dist/sdk/merge/receipts.js +3 -3
- package/dist/sdk/merge/worktree-config.d.ts +2 -0
- package/dist/sdk/merge/worktree-config.js +1 -1
- package/dist/sdk/public-surface.json +1 -1
- package/docs/BUILD_AND_RELEASE_ACCEPTANCE.md +36 -100
- package/docs/MERGE_SAFETY.md +61 -6
- package/docs/PACKED_FIRST_RUN.md +26 -42
- package/docs/README.md +1 -0
- package/docs/SDK_AUDITED_MUTATIONS.md +18 -0
- package/docs/SDK_STORAGE_LIFECYCLE.md +35 -0
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +2 -2
- package/package.json +1 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-claude/package.json +2 -2
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +2 -2
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +2 -2
- package/dist/cli-bundle/chunks/chunk-754AV3DC.js +0 -8
- package/dist/cli-bundle/chunks/chunk-CEM35QB2.js +0 -2
- package/dist/cli-bundle/chunks/chunk-CMIU2NDK.js +0 -20
- package/dist/cli-bundle/chunks/chunk-GSQK3VUT.js +0 -2
- package/dist/cli-bundle/chunks/chunk-WUOFG4JY.js +0 -3
- package/dist/cli-bundle/chunks/register-operations-FYV7CUBF.js +0 -2
- package/dist/cli-bundle/chunks/register-setup-M5VO6JUH.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-3RJ4VK7U.js +0 -3
- package/dist/cli-bundle/focused-chunks/chunk-H5VREEUE.js +0 -20
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{P as i}from"./chunk-
|
|
2
|
-
//# sourceMappingURL=chunk-
|
|
1
|
+
import{P as i}from"./chunk-L3CZNKZE.js";(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="19d6f507-d3b1-5ccc-aba5-594983776618")}catch{}})();var u=["id","title","status","type","priority","parent","updated_at"],E=["id","status","type","title"],p={list:"brief","list-all":"full","list-draft":"full","list-open":"brief","list-in-progress":"brief","list-blocked":"brief","list-closed":"brief","list-canceled":"full"},r=["tree_depth","tree_parent","tree_children","tree_title"];function f(t=[]){return[...new Set([...i,"body",...r,...t])].flatMap(e=>[e,`item.${e}`]).sort()}var T=["brief","standard","deep"],l=["body","linked","claim_state","children","schedule","blockers"],o=["linked.files","linked.tests","linked.docs"],a=["claim_state.claimed","claim_state.assignee","claim_state.last_claim","claim_state.last_release"],d=["schedule.deadline","schedule.start_at","schedule.end_at","schedule.location","schedule.reminders","schedule.events"];function m(t=[]){return[...[...new Set([...i,...t,"notes_count","tests_count","collection_counts"])].flatMap(e=>[e,`item.${e}`]),...l,...o,...a,...d].sort()}var I=["id","title","status","type","priority","updated_at","score","matched_fields"],_=["score","matched_fields","highlights"],n=["id","title","description","type","status","priority","tags","created_at","updated_at","deadline","assignee","author","estimated_minutes","acceptance_criteria","dependencies","comments","notes","learnings","reminders","events","files","tests","docs","close_reason","parent","reviewer","risk","confidence","sprint","release","blocked_by","blocked_reason","reporter","severity","environment","repro_steps","resolution","expected_result","actual_result","affected_version","fixed_version","component","regression","customer_impact","definition_of_ready","order","rank","goal","objective","value","impact","outcome","why_now","plan"];function S(t=[]){let e=[...new Set(t)];return[..._,...n,...n.map(s=>`item.${s}`),...e,...e.map(s=>`item.${s}`)].sort()}export{u as a,E as b,p as c,f as d,T as e,m as f,I as g,S as h};
|
|
2
|
+
//# sourceMappingURL=chunk-V3EPBB6V.js.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{f as w,i as y,j,k as B,l as U,o as f,p as X,q as W,r as Y}from"./chunk-
|
|
1
|
+
import{f as w,i as y,j,k as B,l as U,o as f,p as X,q as W,r as Y}from"./chunk-DRHJOG5X.js";import{M as H,a as $,b as D}from"./chunk-6TKAFFEB.js";import{c as u,f as M,g as z,i as q}from"./chunk-PBPPIGUL.js";import{Va as F,q as L,t as R}from"./chunk-BDT5EALU.js";import{e as g,h as K}from"./chunk-F2ME5MJY.js";import{Ia as k,a as N,e as O,f as A,g as x,h as C,o as P}from"./chunk-L3CZNKZE.js";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="3ec1f825-59d1-5ce2-ac76-c628264bd8be")}catch{}})();var Ce=N,Pe=O,$e=C,De=A,Le=x;function G(e,t,n,r){let s=e.flag.slice(2).replace(/[-_]([a-z])/gu,(a,i)=>i.toUpperCase()),o=n.has(s);return{long:t,...r?{short:r}:{},description:e.description??`Standard pm ${e.flag} option.`,...e.required===!0?{required:!0}:{},...e.list===!0?{list:!0}:{},...e.repeatable===!0?{repeatable:!0}:{},value_type:o?"string":"boolean",...o?{value_name:e.value_name??"value"}:{}}}function Q(e,t=[]){let n=new Set(t.flatMap(s=>s.keys)),r=[];for(let s of L(e.map(o=>({...o})))){r.push(G(s,s.flag,n,s.short));for(let o of s.aliases??[])r.push(G(s,o,n))}return r}var Re=Q(R,$),Fe=Q(F,D);(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="59d16a38-d6df-5695-96e3-28b6e384f76b")}catch{}})();var _=["agile","ops","research"],I={agile:{name:"agile",title:"Agile delivery",summary:"Story/Spike delivery with a review stage, story points, and acceptance ownership.",types:w.agile,statuses:[{id:"review",roles:["active"],aliases:["in-review"],description:"Work is implementation-complete and awaiting peer review."}],fields:[{key:"story_points",type:"number",commands:["create","update","list"],description:"Relative estimation size for a story or spike.",aliases:["points"]},{key:"acceptance_owner",type:"string",commands:["create","update","list"],description:"Stakeholder accountable for accepting the delivered story.",aliases:["acceptor"]}],workflows:[{type:"Story",allowed_transitions:[["open","in_progress"],["in_progress","review"],["review","in_progress"],["review","closed"],["in_progress","blocked"],["blocked","in_progress"]]}],config:[{key:"search_provider",value:"bm25",summary:"Offline BM25 lexical search works without an embedding service."},{key:"search_max_results",value:"20",summary:"Sprint-sized result cap for quick triage."}],templates:[{name:"story",options:{type:"Story",priority:"2",tags:"story",acceptanceCriteria:"Story delivers the stated user outcome with tests and docs updated.",body:`## As a
|
|
2
2
|
|
|
3
3
|
## I want
|
|
4
4
|
|
|
@@ -23,4 +23,4 @@ import{f as w,i as y,j,k as B,l as U,o as f,p as X,q as W,r as Y}from"./chunk-3B
|
|
|
23
23
|
|
|
24
24
|
## Conclusion
|
|
25
25
|
`}}],packages:[{spec:"search-advanced",reason:"Semantic retrieval over experiments and findings."},{spec:"templates",reason:"Consistent experiment and hypothesis scaffolds."},{spec:"beads",reason:"Import structured prior work into the tracker."}]}};function ne(e){if(e===void 0)return;let t=p(e);if(t.length===0)throw new Error("Profile name must not be empty.");if(_.includes(t))return t;throw new Error(`Invalid profile "${e}". Allowed: ${_.join(", ")}.`)}function qe(e){let t=ne(e);if(t===void 0)throw new Error(`Profile name is required. Allowed: ${_.join(", ")}.`);return I[t]}function je(){return _.map(e=>I[e])}function p(e){return e.trim().toLowerCase().replaceAll("-","_")}function J(e){return e.map(t=>t.definition.name).join(", ")}function re(e=[]){let t=_.map(o=>({definition:I[o],source:"builtin"})),n=new Set(_.map(o=>p(o))),r=new Set(n),s=[];for(let o of e){let a=p(o.profile.name);if(n.has(a)){s.push(`Extension "${o.name}" profile "${o.profile.name}" uses a name reserved by a built-in archetype and was ignored.`);continue}if(r.has(a)){s.push(`Profile "${o.profile.name}" from extension "${o.name}" duplicates an already-registered profile and was ignored.`);continue}r.add(a),t.push({definition:o.profile,source:"extension",package:o.name})}return{profiles:t,warnings:s}}function Be(e,t=[]){let{profiles:n,warnings:r}=re(t);if(typeof e!="string"||e.trim().length===0)throw new Error(`Profile name is required. Allowed: ${J(n)}.`);let s=p(e),o=n.find(a=>p(a.definition.name)===s);if(o===void 0)throw new Error(`Invalid profile "${e}". Allowed: ${J(n)}.`);return{resolved:o,warnings:r}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="ab26bcb3-fb2a-5f2f-96e7-7965787b924e")}catch{}})();function se(e){return{types:e.types.length,statuses:e.statuses.length,fields:e.fields.length,workflows:e.workflows.length,config:e.config.length,templates:e.templates.length,packages:e.packages.length}}function Ye(e){return{name:e.name,title:e.title,summary:e.summary,composition:se(e),types:e.types.map(t=>S(()=>u(t).name,()=>String(t.name??""))),statuses:e.statuses.map(t=>S(()=>f(t).id,()=>String(t.id??""))),fields:e.fields.map(t=>S(()=>y(t).key,()=>String(t.key??""))),workflows:e.workflows.map(t=>t.type),config:e.config.map(t=>`${t.key}=${t.value}`),templates:e.templates.map(t=>t.name),packages:e.packages.map(t=>({spec:t.spec,reason:t.reason}))}}function S(e,t){try{return e()}catch{return t()}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2ae4f6da-17c5-5024-89a2-bb0a4be9a683")}catch{}})();var oe=[{key:"search_provider",path:"search.provider",kind:"string",summary:"Search embedding provider name (e.g. openai, ollama, or an extension provider)."},{key:"search_default_mode",path:"search.default_mode",kind:"string",choices:["auto","keyword","semantic","hybrid"],summary:"Mode a bare pm search runs in: auto (hybrid when semantic search is explicitly configured and runnable, else keyword), or a pinned keyword, semantic, or hybrid."},{key:"search_mutation_refresh_policy",path:"search.mutation_refresh_policy",kind:"string",choices:["cache_only","semantic_configured","semantic_auto"],summary:"Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto."},{key:"search_query_expansion_enabled",path:"search.query_expansion.enabled",kind:"boolean",summary:"Enable or disable query expansion for semantic/hybrid search."},{key:"search_query_expansion_provider",path:"search.query_expansion.provider",kind:"string",summary:"Query expansion provider name (built-in openai/ollama or extension provider)."},{key:"search_rerank_enabled",path:"search.rerank.enabled",kind:"boolean",summary:"Enable or disable post-retrieval reranking for hybrid search."},{key:"search_rerank_model",path:"search.rerank.model",kind:"string",summary:"Rerank model name override used by built-in providers."},{key:"search_rerank_top_k",path:"search.rerank.top_k",kind:"integer",min:1,summary:"Number of top hybrid candidates to rerank when rerank is enabled."},{key:"search_embedding_model",path:"search.embedding_model",kind:"string",summary:"Default embedding model name (overrides provider-specific model when set)."},{key:"search_embedding_corpus_max_characters",path:"search.embedding_corpus_max_characters",kind:"integer",min:1,summary:"Maximum semantic corpus characters per item before truncation."},{key:"search_embedding_batch_size",path:"search.embedding_batch_size",kind:"integer",min:1,summary:"Number of items embedded per request batch."},{key:"search_embedding_timeout_ms",path:"search.embedding_timeout_ms",kind:"integer",min:1,summary:"Per-request embedding timeout in milliseconds."},{key:"search_score_threshold",path:"search.score_threshold",kind:"number",summary:"Minimum score for a hit to be returned (0 keeps all matches)."},{key:"search_hybrid_semantic_weight",path:"search.hybrid_semantic_weight",kind:"ratio",summary:"Hybrid mode semantic weight in [0, 1] (1-weight goes to keyword)."},{key:"search_max_results",path:"search.max_results",kind:"integer",min:1,summary:"Default upper bound on search hits when --limit is not supplied."},{key:"search_bm25_k1",path:"search.bm25.k1",kind:"number",min:0,summary:"Offline BM25 term-frequency saturation (k1); higher saturates repeated terms slower (default 1.2)."},{key:"search_bm25_b",path:"search.bm25.b",kind:"ratio",summary:"Offline BM25 document-length normalization (b) in [0, 1]; 0 disables, 1 fully normalizes (default 0.75)."},{key:"openai_base_url",path:"providers.openai.base_url",kind:"string",summary:"OpenAI-compatible API base URL (LM Studio/vLLM also use this)."},{key:"openai_api_key",path:"providers.openai.api_key",kind:"string",summary:"OpenAI-compatible API key."},{key:"openai_model",path:"providers.openai.model",kind:"string",summary:"OpenAI-compatible embedding model name."},{key:"ollama_base_url",path:"providers.ollama.base_url",kind:"string",summary:"Ollama API base URL (typically http://localhost:11434)."},{key:"ollama_model",path:"providers.ollama.model",kind:"string",summary:"Ollama embedding model name (e.g. nomic-embed-text)."},{key:"vector_store_adapter",path:"vector_store.adapter",kind:"string",summary:"Vector store adapter name (lancedb, qdrant, or an extension adapter)."},{key:"vector_store_collection_name",path:"vector_store.collection_name",kind:"string",non_empty:!0,summary:"Vector collection/table name shared by Qdrant and LanceDB adapters."},{key:"qdrant_url",path:"vector_store.qdrant.url",kind:"string",summary:"Qdrant HTTP API URL."},{key:"qdrant_api_key",path:"vector_store.qdrant.api_key",kind:"string",summary:"Qdrant API key (empty if running unauthenticated)."},{key:"lancedb_path",path:"vector_store.lancedb.path",kind:"string",summary:"LanceDB storage path (relative to pm root or absolute)."},{key:"id_prefix",path:"id_prefix",kind:"string",non_empty:!0,summary:'Prefix for generated item IDs (e.g. "pm" produces pm-xxxx).'},{key:"author_default",path:"author_default",kind:"string",non_empty:!0,summary:"Default author recorded on mutations when --author is not supplied."},{key:"agent_identity_probes_enabled",path:"agent_identity.probes_enabled",kind:"boolean",summary:"Allow privacy-bounded local harness provenance probes; no network or subprocess access is permitted."},{key:"mutation_guard_require_attributed_author",path:"mutation_guard.require_attributed_author",kind:"boolean",summary:"Reject mutations whose effective author resolves to unknown."},{key:"mutation_guard_secret_guard",path:"mutation_guard.secret_guard",kind:"string",choices:["off","advise","block"],summary:"Detect credential-shaped mutation content: off, advise, or block."},{key:"mutation_guard_stale_in_progress_hours",path:"mutation_guard.stale_in_progress_hours",kind:"integer",min:1,summary:"Age threshold for unclaimed in-progress work surfaced by health."},{key:"governance_duplicate_detection_mode",path:"governance.duplicate_detection_mode",kind:"string",choices:["off","advisory","strict"],summary:"Create/copy duplicate governance: off, advisory, or strict explicit-bypass enforcement."},{key:"governance_duplicate_detection_threshold",path:"governance.duplicate_detection_threshold",kind:"ratio",summary:"Minimum shared similarity score in [0, 1] for create/copy duplicate governance."},{key:"governance_duplicate_detection_limit",path:"governance.duplicate_detection_limit",kind:"integer",min:0,max:20,summary:"Maximum likely duplicates returned by create/copy governance (0-20)."},{key:"output_default_format",path:"output.default_format",kind:"string",choices:["toon","json"],summary:"Default output format for commands that support it: toon or json."},{key:"ux_deprecation_hints",path:"ux.deprecation_hints",kind:"boolean",summary:"Emit one stderr migration hint for deprecated command aliases."},{key:"locks_ttl_seconds",path:"locks.ttl_seconds",kind:"integer",min:1,summary:"Claim/lock time-to-live in seconds before a stale lock can be reclaimed."},{key:"locks_wait_ms",path:"locks.wait_ms",kind:"integer",min:0,summary:"Bounded jittered wait in milliseconds before a contended item mutation fails with lock_conflict; 0 fails fast. PM_LOCK_WAIT_MS overrides per invocation."},{key:"ids_token_length",path:"ids.token_length",kind:"integer",min:4,max:12,summary:"Random base36 token length for newly minted item ids (4-12, default 4). Raise it to shrink cross-branch id collision odds in concurrent multi-agent workflows (pm-pibw)."},{key:"checkpoints_retention_days",path:"checkpoints.retention_days",kind:"integer",min:1,summary:"Age in days above which pm gc --scope checkpoints prunes bulk-mutation rollback checkpoints."},{key:"schema_unknown_field_policy",path:"schema.unknown_field_policy",kind:"string",choices:["allow","warn","reject"],summary:"How item I/O handles metadata keys not in the field registry: allow, warn, or reject."},{key:"history_compact_policy_enabled",path:"history.compact_policy.enabled",kind:"boolean",summary:"Enable the history-compaction advisory: pm health warns on over-threshold streams."},{key:"history_compact_policy_max_entries",path:"history.compact_policy.max_entries",kind:"integer",min:1,summary:"Entry count above which a history stream is flagged (and the default pm history-compact --all-over threshold)."},{key:"history_compact_policy_trigger",path:"history.compact_policy.trigger",kind:"string",choices:["health_warn","auto"],summary:"History-compaction policy intent: health_warn (advisory only) or auto (scheduled sweeps expected)."}],ae=new Map(oe.flatMap(e=>[[e.key,e],[e.path.toLowerCase().replaceAll("-","_"),e]]));function b(e){if(typeof e!="string")return;let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length!==0)return ae.get(t)}function ie(e,t){let n=t.trim().toLowerCase();return n==="true"||n==="1"||n==="yes"||n==="on"?{ok:!0,parsed:{descriptor:e,value:!0}}:n==="false"||n==="0"||n==="no"||n==="off"?{ok:!0,parsed:{descriptor:e,value:!1}}:{ok:!1,error:{message:`Config set ${e.key} requires a boolean value (true|false), got "${t}"`}}}function le(e,t,n){return e.non_empty===!0&&n.length===0?{ok:!1,error:{message:`Config set ${e.key} requires a non-empty value`}}:e.choices&&!e.choices.includes(n)?{ok:!1,error:{message:`Config set ${e.key} must be one of ${e.choices.join("|")}, got "${t}"`}}:{ok:!0,parsed:{descriptor:e,value:n}}}function de(e,t,n){if(n.length===0)return{ok:!1,error:{message:`Config set ${e.key} requires a non-empty value`}};let r=Number(n);return Number.isFinite(r)?{ok:!0,value:r}:{ok:!1,error:{message:`Config set ${e.key} requires a finite number, got "${t}"`}}}function ce(e,t,n){return!Number.isInteger(n)||n<0?{ok:!1,error:{message:`Config set ${e.key} requires a non-negative integer, got "${t}"`}}:e.min!==void 0&&n<e.min?{ok:!1,error:{message:`Config set ${e.key} requires an integer >= ${e.min}, got "${t}" (the runtime silently ignores 0 here and falls back to the default)`}}:e.max!==void 0&&n>e.max?{ok:!1,error:{message:`Config set ${e.key} requires an integer <= ${e.max}, got "${t}"`}}:{ok:!0,parsed:{descriptor:e,value:n}}}function me(e,t,n){return n<0||n>1?{ok:!1,error:{message:`Config set ${e.key} requires a number in [0, 1], got "${t}"`}}:{ok:!0,parsed:{descriptor:e,value:n}}}function pe(e,t,n){return e.min!==void 0&&n<e.min?{ok:!1,error:{message:`Config set ${e.key} requires a number >= ${e.min}, got "${t}"`}}:{ok:!0,parsed:{descriptor:e,value:n}}}function v(e,t){if(typeof t!="string")return{ok:!1,error:{message:`Config set ${e.key} requires a string value`}};let n=t.trim();if(e.kind==="boolean")return ie(e,t);if(e.kind==="string")return le(e,t,n);let r=de(e,t,n);return r.ok?e.kind==="integer"?ce(e,t,r.value):e.kind==="ratio"?me(e,t,r.value):pe(e,t,r.value):{ok:!1,error:r.error}}function V(e,t){let n=t.path.split("."),r=e;for(let s of n){if(typeof r!="object"||r===null)return null;let o=Object.getOwnPropertyDescriptor(r,s);if(!o||!Object.hasOwn(o,"value"))return null;r=o.value}return typeof r=="string"||typeof r=="number"||typeof r=="boolean"?r:null}function Ge(e,t,n){let r=t.path.split(".");if(r.some(a=>a.length===0||["__proto__","constructor","prototype"].includes(a)))throw new Error("Unsafe settings path");let s=e;for(let a=0;a<r.length-1;a+=1){let i=r[a],d=Object.getOwnPropertyDescriptor(s,i)?.value;if(typeof d!="object"||d===null||Array.isArray(d)){let c={};Object.defineProperty(s,i,{value:c,writable:!0,enumerable:!0,configurable:!0}),s=c}else s=d}let o=r[r.length-1];return Object.getOwnPropertyDescriptor(s,o)?.value===n?!1:(Object.defineProperty(s,o,{value:n,writable:!0,enumerable:!0,configurable:!0}),!0)}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="0b04624c-2096-55dc-9dde-b8c76ead72d6")}catch{}})();var it=["profile","types","statuses","fields","workflows","config","templates","packages"],lt=["profile_name_empty","profile_name_not_normalized","profile_title_empty","profile_summary_empty","type_invalid","type_duplicate","status_invalid","status_duplicate","field_invalid","field_duplicate","field_mcp_input_collision","workflow_type_empty","workflow_type_unknown","workflow_duplicate_type","workflow_transition_malformed","workflow_status_unknown","config_key_unknown","config_value_invalid","config_duplicate","template_type_unknown","package_spec_empty"],ue=new Set(K.flatMap(e=>[g(e.id),...(e.aliases??[]).map(t=>g(t))]).filter(e=>e.length>0)),Z=new Set(P.map(e=>e.toLowerCase()));function ye(e,t){e.name.trim().length===0?t.push({severity:"error",code:"profile_name_empty",dimension:"profile",message:"Profile name must not be empty; profile resolution requires a non-blank name."}):e.name!==p(e.name)&&t.push({severity:"warning",code:"profile_name_not_normalized",dimension:"profile",target:e.name,message:`Profile name "${e.name}" is not in canonical form; resolution folds it to "${p(e.name)}" (lowercase, hyphens as underscores).`}),e.title.trim().length===0&&t.push({severity:"warning",code:"profile_title_empty",dimension:"profile",message:"Profile title is empty; list and show surfaces will render a blank title."}),e.summary.trim().length===0&&t.push({severity:"warning",code:"profile_summary_empty",dimension:"profile",message:"Profile summary is empty; list and show surfaces will render a blank archetype description."})}function fe(e,t){let n=new Set,r=new Set;for(let[s,o]of e.types.entries()){let a;try{a=u(o).name}catch(d){t.push({severity:"error",code:"type_invalid",dimension:"types",target:typeof o.name=="string"?o.name:`#${s}`,message:k(d)});continue}let i=a.toLowerCase();if(r.has(i)){t.push({severity:"error",code:"type_duplicate",dimension:"types",target:a,message:`Item type "${a}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}r.add(i),n.add(i)}return n}function he(e,t){let n=new Set,r=new Set;for(let[s,o]of e.statuses.entries()){let a;try{a=f(o)}catch(i){t.push({severity:"error",code:"status_invalid",dimension:"statuses",target:typeof o.id=="string"?o.id:`#${s}`,message:k(i)});continue}if(r.has(a.id)){t.push({severity:"error",code:"status_duplicate",dimension:"statuses",target:a.id,message:`Status "${a.id}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}r.add(a.id),n.add(a.id);for(let i of a.aliases??[])n.add(g(i))}return n}function ge(e,t){let n=new Set;for(let[r,s]of e.fields.entries()){let o;try{o=y(s).key}catch(i){t.push({severity:"error",code:"field_invalid",dimension:"fields",target:typeof s.key=="string"?s.key:`#${r}`,message:k(i)});continue}if(n.has(o)){t.push({severity:"error",code:"field_duplicate",dimension:"fields",target:o,message:`Field "${o}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}n.add(o);let a=H(o);a&&t.push({severity:"warning",code:"field_mcp_input_collision",dimension:"fields",target:o,message:`Field "${o}" collides with canonical MCP property "${a.property}" owned by ${a.owner}; callers must pass the custom value through ${a.nested_path}.`})}}function _e(e,t,n,r){let s=new Set;for(let[o,a]of e.workflows.entries()){let i=a.type.trim().toLowerCase();if(i.length===0){r.push({severity:"error",code:"workflow_type_empty",dimension:"workflows",target:`#${o}`,message:"Workflow has an empty type; the workflow resolver drops entries without a type."});continue}let d=s.has(i);s.add(i),d?r.push({severity:"warning",code:"workflow_duplicate_type",dimension:"workflows",target:a.type,message:`Workflow type "${a.type}" is declared more than once; the later transition set wins.`}):!Z.has(i)&&!t.has(i)&&r.push({severity:"warning",code:"workflow_type_unknown",dimension:"workflows",target:a.type,message:`Workflow governs type "${a.type}" which is neither a built-in type nor declared by this profile; it has no effect unless that type already exists.`});let c=new Set;for(let l of a.allowed_transitions){let m=g(l[0]),T=g(l[1]);if(m.length===0||T.length===0){r.push({severity:"error",code:"workflow_transition_malformed",dimension:"workflows",target:a.type,message:`Workflow "${a.type}" has a transition with an empty status; the workflow resolver silently drops it.`});continue}for(let h of[m,T])ue.has(h)||n.has(h)||c.has(h)||(c.add(h),r.push({severity:"warning",code:"workflow_status_unknown",dimension:"workflows",target:h,message:`Workflow "${a.type}" references status "${h}" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`}))}}}function ke(e,t){let n=new Set;for(let r of e.config){let s=b(r.key);if(s===void 0){t.push({severity:"error",code:"config_key_unknown",dimension:"config",target:r.key,message:`Config knob "${r.key}" is not a recognized setting; apply rejects it with a usage error.`});continue}n.has(s.key)?t.push({severity:"error",code:"config_duplicate",dimension:"config",target:s.key,message:`Config knob "${s.key}" is set more than once; the later value silently overwrites the earlier one.`}):n.add(s.key);let o=v(s,r.value);o.ok||t.push({severity:"error",code:"config_value_invalid",dimension:"config",target:r.key,message:o.error.message})}}function we(e,t,n){for(let r of e.templates){let s=r.options.type;if(typeof s!="string"||s.trim().length===0)continue;let o=s.trim().toLowerCase();!Z.has(o)&&!t.has(o)&&n.push({severity:"warning",code:"template_type_unknown",dimension:"templates",target:r.name,message:`Template "${r.name}" creates type "${s}" which is neither a built-in type nor declared by this profile.`})}}function be(e,t){for(let[n,r]of e.packages.entries())r.spec.trim().length===0&&t.push({severity:"warning",code:"package_spec_empty",dimension:"packages",target:`#${n}`,message:"Package recommendation has an empty spec; it cannot be surfaced as an install hint."})}function dt(e){let t=[];ye(e,t);let n=fe(e,t),r=he(e,t);ge(e,t),_e(e,n,r,t),ke(e,t),we(e,n,t),be(e,t);let s=t.filter(a=>a.severity==="error").length,o=t.length-s;return{profile:e.name,ok:s===0,findings:t,errorCount:s,warningCount:o}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="be2b507d-2797-570c-b211-46d950edcbde")}catch{}})();function E(e,t,n,r,s){let o=e,a=[];for(let i of t){let d=r(o),c=s(o,i),l=r(c.file);o=c.file;let m=d===l?"unchanged":c.replaced?"update":"add";a.push({key:n(i),status:m})}return{file:o,changes:a,changed:a.some(i=>i.status!=="unchanged")}}function ee(e){return JSON.stringify(e.map(t=>t.join("\0")).sort())}function ve(e,t){let n=e.map(s=>({...s})),r=[];for(let s of t){let o=n.findIndex(i=>i.type===s.type),a={type:s.type,allowed_transitions:s.allowed_transitions};o<0?(n.push(a),r.push({type:s.type,status:"add"})):ee(n[o].allowed_transitions)===ee(s.allowed_transitions)?r.push({type:s.type,status:"unchanged"}):(n[o]=a,r.push({type:s.type,status:"update"}))}return{changes:r,result:n,changed:r.some(s=>s.status!=="unchanged")}}function Ie(e,t){let n=[];for(let r of e.config){let s=b(r.key);if(s===void 0)throw new Error(`Profile "${e.name}" references unknown config key "${r.key}".`);let o=v(s,r.value);if(!o.ok)throw new Error(`Profile "${e.name}" config ${r.key}: ${o.error.message}`);let a=V(t,s),i=a===null?"add":a===o.parsed.value?"unchanged":"update";n.push({key:s.key,path:s.path,value:o.parsed.value,status:i})}return{changes:n,changed:n.some(r=>r.status!=="unchanged")}}function te(e){let t=Object.entries(e).sort(([n],[r])=>n.localeCompare(r));return JSON.stringify(t)}function Se(e,t){let n=[];for(let r of e.templates){let s=t.get(r.name),o;s===void 0?o="add":te(s)===te(r.options)?o="unchanged":o="update",n.push({name:r.name,options:r.options,status:o})}return{changes:n,changed:n.some(r=>r.status!=="unchanged")}}function ft(e,t){let n=E(M(t.typesRaw),e.types,l=>u(l).name,q,(l,m)=>z(l,u(m))),r=E(X(t.statusesRaw),e.statuses,l=>f(l).id,W,(l,m)=>Y(l,f(m))),s=E(j(t.fieldsRaw),e.fields,l=>y(l).key,B,(l,m)=>U(l,y(m))),o=ve(t.workflows,e.workflows),a=Ie(e,t.settings),i=Se(e,t.templates),d=e.packages.map(l=>({spec:l.spec,reason:l.reason,status:t.installedPackages.has(l.spec)?"installed":"recommended"})),c=n.changed||r.changed||s.changed||o.changed||a.changed||i.changed;return{profile:{name:e.name,title:e.title,summary:e.summary},types:n,statuses:r,fields:s,workflows:o,config:a,templates:i,packages:d,changed:c}}export{Ce as a,Pe as b,$e as c,De as d,Le as e,Q as f,Re as g,Fe as h,_ as i,I as j,ne as k,qe as l,je as m,re as n,Be as o,se as p,Ye as q,oe as r,b as s,v as t,V as u,Ge as v,it as w,lt as x,dt as y,ft as z};
|
|
26
|
-
//# sourceMappingURL=chunk-
|
|
26
|
+
//# sourceMappingURL=chunk-XT7JAVHI.js.map
|
package/dist/cli-bundle/main.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{B as ti,D as ni,E as _n,a as rn,b as de,c as sn,d as ln,e as cn,f as dn,i as U,j as D,k as S,l as me,m as x,n as Ta,s as ze,t as Ra,u as Na,y as Da,z as wn}from"./chunks/chunk-
|
|
1
|
+
import{B as ti,D as ni,E as _n,a as rn,b as de,c as sn,d as ln,e as cn,f as dn,i as U,j as D,k as S,l as me,m as x,n as Ta,s as ze,t as Ra,u as Na,y as Da,z as wn}from"./chunks/chunk-UGFN5NJ2.js";import{Ta as ei,f as va,i as Sa}from"./chunks/chunk-HFCIAXLP.js";import"./chunks/chunk-34L2BS2Z.js";import"./chunks/chunk-MJVRF67I.js";import{F as Ka,Id as Qa,Nc as Za,b as Ga,d as Ct,g as Wa,h as Va,i as Y,j as Ba}from"./chunks/chunk-ZHIMZ65M.js";import{Ga as Ja,g as Aa}from"./chunks/chunk-ZBVAZ7XX.js";import"./chunks/chunk-FOLSEOJ2.js";import"./chunks/chunk-DEZPZOQ7.js";import{$a as en,$o as q,Ac as aa,Bc as te,Bj as He,Cc as ia,Dc as ra,De as ma,Ec as se,Ee as on,Fc as sa,Gc as ut,Gn as Ve,Hb as Ko,Hc as Ce,Ic as le,Jf as ce,Jn as Ua,Kf as _a,Lc as la,Lf as xe,Mc as ft,Mn as qa,Nf as an,Of as w,Po as xt,Qb as Jo,Qo as kt,R as f,Rb as Yo,Rn as gn,Ro as hn,S as mt,Sa as Qt,Sc as nn,Sn as Ha,So as Be,T as b,Tc as gt,Tn as za,To as E,Uc as ca,Ue as pa,Uo as Ya,V as K,Va as re,Vc as da,Ve as ua,Vo as yn,We as fa,Xa as Wo,Xb as Xo,Xe as ga,Ya as pt,Ye as ha,Zb as Zo,Zi as wt,_i as Ea,ab as Vo,ah as ba,bb as T,be as Ue,bh as Ca,db as Bo,dd as k,e as I,eb as J,ed as je,fa as Ho,g as W,ga as zo,h as O,hl as Oa,il as ne,in as Ma,j as B,ja as Me,jh as ht,jn as bt,k as Xt,kc as Qo,kl as Ia,kn as pn,l as V,lc as Fe,li as yt,ll as $a,ln as un,m as qo,mj as _t,mn as Ge,na as Zt,nc as Le,ng as mn,ni as xa,nl as Pa,nn as fn,np as Xa,oc as ea,oj as qe,on as Fa,pj as vt,pn as We,qi as ke,ra as Go,ri as N,si as ka,sn as La,tf as ya,tn as ja,wb as tn,xc as ta,xf as wa,yc as na,zc as oa}from"./chunks/chunk-OG66KEOF.js";import{Command as No,CommanderError as kr}from"commander";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="50318c14-8c1c-50f3-95d0-fd9ea3f0bb69")}catch{}})();function H(e){return`--${e.replace(/^--?/,"").replace(/_/g,"-").replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase()}`}function pe(e){if(!e.startsWith("--"))return;let t=e.includes("=")?e.slice(0,e.indexOf("=")):e;return H(t)}function X(e){let t=new Set,n=[];for(let o of e){let a=pe(o);a&&(t.has(a)||n.push(a),t.add(a))}return n}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="0b95b409-ef2c-59da-a628-16a2cb4f0ea6")}catch{}})();var vn=new Set(["--fields","--output-include","--depth","--for","--token-budget"]),Et=new Set(["--full","--brief","--compact"]);function os(e,t){return!!(e.flag==="--pm-path"||e.value_name||e.list||e.value_type==="number"||e.value_type==="string"||t.has(e.flag))}function as(e){let t=ne(x([...e])),n=new Set([...Ia,...$a,...Pa].flatMap(r=>r.keys.map(s=>`--${s.replace(/[A-Z]/g,l=>`-${l.toLowerCase()}`)}`))),o=new Map([...He,...t].flatMap(r=>[r.flag,...r.aliases??[]].map(s=>[s,r.flag]))),a=new Map([...He,...t].flatMap(r=>[r.flag,...r.aliases??[]].map(s=>[s,os(r,n)])));for(let r of vn)a.set(r,!0);for(let r of Et)a.set(r,!1);let i=new Map;for(let r=0;r<e.length;r+=1){let s=e[r];if(s==="--")break;if(!s.startsWith("-"))continue;let l=s.split("=")[0];if(!a.has(l)&&!s.includes("="))return;i.set(r,o.get(l)??l),a.get(l)&&!s.includes("=")&&(r+=1)}return i}function oi(e,t,n){let o=new Set;for(let[a,i]of t)n.has(i)&&(o.add(a),vn.has(i)&&!e[a].includes("=")&&o.add(a+1));return e.filter((a,i)=>!o.has(i))}function is(e,t){let n=t.find(a=>Et.has(a));if(n===void 0)return;let o=[...new Set(e.values())].filter(a=>Et.has(a));return o.length===1?o[0]:n}function ai(e,t,n){if(!n||!["unknown_field_projection","projection_options_mutually_exclusive"].includes(t??""))return n;let o=n.suggested_retry_args,a={...n,suggested_retry:void 0,suggested_retry_args:void 0};if(!o)return a;let i=as(e);if(!i)return a;let r;if(t==="unknown_field_projection"){let s=o.indexOf("--fields");if(s<0||o[s+1]===void 0)return a;let l=[...i].find(([c,d])=>d==="--fields")?.[0]??-1;if(l<0)return a;r=oi(e,i,new Set(["--fields"])),r.splice(l,0,"--fields",o[s+1])}else{let s=is(i,o);if(s===void 0||![...i.values()].includes(s))return a;let l=new Set([...vn,...Et].filter(c=>c!==s));r=oi(e,i,l)}return{...n,suggested_retry:k(r),suggested_retry_args:r}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="afa4a7a0-d9de-529d-92dd-3e9704ea00d2")}catch{}})();async function ii(e,t){await Ha(e,{ok:t.ok,error:t.error,result:le(),exit_code:t.exit_code,error_code:t.error_code,error_category:t.error_category,command_resolution:t.command_resolution,resolution_stage:t.resolution_stage})}async function ri(e){if(process.env.PM_CONTEXT_USAGE_DISABLED==="1")return;let t;try{await ya({pmRoot:e.pmRoot,result:le()})}catch(o){t=o}let n=await N(e.pmRoot);if(await wa({pmRoot:e.pmRoot,author:ht(e.author,n.author_default),itemIds:e.itemIds,intent:e.intent}),t!==void 0)throw t}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="dacf3952-3ae1-57fa-840a-c8a43cf855a5")}catch{}})();(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="6ec548d1-a26d-5e72-9a7b-0fbd74a86601")}catch{}})();var si=new WeakMap;function St(e,t){si.set(e,t)}function ue(e){return si.get(e)}function li(e){return e.length>0?[e[0]]:[]}function rs(e){let t=["","Intent:",` ${e.why}`],n=li(e.examples);return n.length>0&&(t.push("","Example:"),t.push(` ${n[0]}`)),t.push("","Need deeper rationale and more examples?"),t.push(" Re-run with --explain."),t.join(`
|
|
2
2
|
`)}function ss(e){let t=["","Why use this command:",` ${e.why}`,"","Examples:",...e.examples.map(n=>` ${n}`)];return e.tips&&e.tips.length>0&&(t.push("","Tips:"),t.push(...e.tips.map(n=>` - ${n}`))),t.join(`
|
|
3
3
|
`)}function ci(e,t){return t==="detailed"?ss(e):rs(e)}function M(e){return e.trim().toLowerCase().split(/\s+/).filter(t=>t.length>0).join(" ")}var ls={cal:"calendar",ctx:"context"};function cs(e,t){return e.commands.find(n=>n.name()===t)??null}function ds(e,t){let n=e;for(let o of t){let a=cs(n,o);if(!a)return null;n=a}return n}function bn(e,t,n,o){let a=ds(e,t.split(" ").filter(i=>i.length>0));a&&a.addHelpText("after",ci(n,o))}function Cn(e){return e.includes("--explain")?"detailed":"compact"}function oe(e){return e.includes("--all")||e.includes("--explain")}var fe={ops:{why:"Groups workspace diagnostics, quality checks, and maintenance under one discoverable command.",examples:["pm ops health --summary","pm ops validate --check-history-drift","pm ops --help"]},init:{why:"Bootstraps tracker storage and settings so all other commands can run safely.",examples:["pm init","pm init acme","pm init ./pm-sandbox --defaults","pm init --preset minimal","pm init --agent-guidance add","pm init --defaults --with-packages"],tips:["Run this once per repository before create/list/update commands.","A path-like positional (`./dir`, `/tmp/dir`) initializes that tracker path; a plain word remains an id prefix.","Rewriting id prefix, governance preset, or default author on an existing tracker requires --force.","Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.","Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.","Use --with-packages when agents need bundled commands such as calendar and templates available immediately."]},config:{why:"Reads or updates project/global settings such as definition-of-done, item format, telemetry, and policy toggles.",examples:["pm config project get definition-of-done",'pm config project set definition-of-done --criterion "tests pass"',"pm config project set item-format --format toon","pm config project set sprint-release-format-policy --policy strict_error","pm config project set governance-preset --policy minimal","pm config project set governance-ownership-enforcement --policy none","pm config project set test-result-tracking --policy enabled","pm config global set telemetry-tracking --policy disabled"]},extension:{why:"Compatibility command for package-backed runtime extension lifecycle operations across project or global scope.",examples:["pm install ./my-package --project","pm install '*' --project","pm package doctor --project --detail summary","pm package manage --global","pm package activate sample-ext --project","pm package deactivate sample-ext --project","pm package uninstall sample-ext --global","pm extension explore --project","pm extension manage --global","pm extension describe sample-ext --project","pm extension doctor --detail deep"],tips:["Prefer pm install and pm package in new user-facing automation.","Use pm extension when maintaining existing extension-specific scripts or debugging the compatibility runtime directly.","Bundled aliases beads and todos resolve to package-shipped extension sources.","Use --gh/--github shorthand for GitHub sources and --ref to pin a branch, tag, or ref.","Install updates settings activation state automatically unless extension allowlist mode is unchanged.","Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.","Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.","Use --describe to map exactly what each loaded extension registers (commands, hooks, item types, providers, overrides) in one call.","Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads."]},package:{why:"Installs, explores, manages, diagnoses, adopts, activates, deactivates, and refreshes package-backed pm runtime extensions.",examples:["pm install npm:@scope/pm-package --project","pm package install ./my-package --project","pm package doctor --project --detail deep","pm package manage --project --runtime-probe","pm package describe --project","pm package activate sample-ext --project","pm upgrade --packages-only --dry-run"],tips:["Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.","Use pm package describe [name] to map every surface a package registers without reading its manifest or running diagnostics.","Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.","Use --dry-run before upgrade when automation needs a deterministic plan."]},"package init":{why:"Generates an installable starter pm package with package metadata and a root extension entrypoint.",examples:["pm package init ./my-package","pm package init ./my-hook-package --capability hooks","pm package init ./my-search-package --capability search","pm package init ./my-sync-package --capability importers","pm package init ./my-domain-package --capability schema","pm package init ./my-output-package --capability renderers","pm install ./my-sync-package --project","pm package doctor --project --detail summary"],tips:["Use --capability hooks for a starter after_command lifecycle reactor with runnable SDK testing coverage.","Use --capability search for a starter search provider/vector-store adapter with runnable SDK testing coverage.","Use --capability importers for paired import/export commands that move project context across systems.","Use --capability schema for a starter custom item type, field, and migration so pm models your project domain.","Use --capability renderers/parser/preflight/services for starter override surfaces (output renderer, parsed-option rewrite, pre-run gate decision, built-in service) \u2014 one runnable starter per SDK capability.","The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.","Use package doctor after changes to verify activation, policy, and collision diagnostics."]},"package install":{why:"Installs pm packages from local paths, npm sources, GitHub sources, bundled aliases, or wildcard/all aliases.",examples:["pm package install ./my-package --project","pm install npm:pm-changelog --project","pm package install --github org/repo/packages/my-pm-package --ref main"],tips:["Prefer the top-level pm install alias in scripts when only installation is needed.","Run pm package manage or pm package doctor after installing external packages."]},"package doctor":{why:"Diagnoses package activation, policy, collision, and managed-state health for project or global package scopes.",examples:["pm package doctor --project --detail summary","pm package doctor --project --detail deep --trace","pm package doctor --project --isolated --detail deep --trace"],tips:["Use --isolated (alias --ignore-global) for hermetic project smoke tests that must ignore globally installed package registrations.","Set PM_GLOBAL_PATH for a whole subprocess suite when every pm invocation must avoid machine-local global package state: PM_GLOBAL_PATH=$(mktemp -d) pm package doctor --project --detail deep --trace.","Non-isolated project diagnostics include global registrations and emit remediation when global package state can affect the result."]},"package catalog":{why:"Lists bundled first-party package catalog metadata and compact field projections.",examples:["pm package catalog --project","pm package catalog --project --fields alias,installed,install_command","pm package list --project --fields alias,package_name,category"],tips:["Use --fields for low-token package discovery in agent loops.","External npm package discovery still belongs to npm search."]},"extension init":{why:"Generates an installable starter runtime extension with manifest and entrypoint files.",examples:["pm extension init ./my-extension","pm extension init ./my-hook-extension --capability hooks","pm extension init ./my-search-extension --capability search","pm extension init ./my-sync-extension --capability importers","pm extension init ./my-domain-extension --capability schema","pm extension init ./my-output-extension --capability renderers","pm extension --install --project ./my-sync-extension","pm extension --doctor --project --detail summary"],tips:["Use --capability hooks when the extension should react to command lifecycle events.","Use --capability search when the extension should register retrieval primitives.","Use --capability importers when the extension should register project-context import/export commands.","Use --capability schema when the extension should register custom item types, fields, and migrations.","Use --capability renderers/parser/preflight/services to override pm's output rendering, parsed options, pre-run gate, or a built-in service.","Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold."]},"extension install":{why:"Installs a compatibility runtime extension from local, npm, GitHub, bundled alias, or wildcard sources.",examples:["pm extension install ./my-extension --project","pm extension --install --project ./my-extension","pm extension doctor --project --detail summary"],tips:["Prefer pm install or pm package install for new package-first automation."]},"extension doctor":{why:"Diagnoses compatibility extension activation, policy, collision, and managed-state health for project or global extension scopes.",examples:["pm extension doctor --project --detail summary","pm extension doctor --project --detail deep --trace","pm extension doctor --project --isolated --detail deep --trace"],tips:["Use --isolated (alias --ignore-global) for hermetic project smoke tests that must ignore globally installed extension registrations.","Set PM_GLOBAL_PATH for a whole subprocess suite when every pm invocation must avoid machine-local global extension state: PM_GLOBAL_PATH=$(mktemp -d) pm extension doctor --project --detail deep --trace.","Prefer pm package doctor in new package-first workflows."]},"extension catalog":{why:"Compatibility view of bundled package catalog metadata.",examples:["pm extension catalog --project","pm extension catalog --project --fields alias,installed,install_command"],tips:["Prefer pm package catalog in new user-facing workflows."]},install:{why:"Installs a pm package into project scope by default, using local, npm, GitHub, or bundled alias sources.",examples:["pm install '*' --project","pm install ./packages/pm-todos --project","pm install npm:@scope/pm-package --global","pm install --github org/repo/packages/my-pm-package --ref main"],tips:["Installed packages are recorded in managed state and can be inspected with pm package manage."]},upgrade:{why:"Updates the global pm CLI/SDK and refreshes managed pm packages from recorded install sources.",examples:["pm upgrade --dry-run","pm upgrade --packages-only --project","pm upgrade todos --dry-run","pm upgrade --cli-only --repair","pm upgrade --tag next --dry-run"],tips:["Omit target to include the CLI/SDK plus all managed packages in the selected scope.","Pass a target to refresh one managed package by name, directory, package name, or source.","Use --packages-only in repository automation when the global CLI should not be changed."]},create:{why:"Creates a new planning item with deterministic metadata and history.",examples:['pm create --title "Harden lock flow" --description "Improve stale lock handling" --type Task --status open --priority 1 --message "Create lock hardening task" --create-mode progressive','pm create --title "Weekly planning sync" --description "Recurring coordination meeting" --type Meeting --schedule-preset lightweight','pm create --title "Asset: Hero model" --description "Track playable model asset" --type Asset --status open --priority 1 --message "Create asset item" --type-option category=Character --dep "id=pm-epic01,kind=parent,created_at=now" --comment "created_at=now,text=Why this asset item exists." --note "created_at=now,text=Initial implementation note." --learning "created_at=now,text=Durable lesson placeholder." --file "path=src/assets/hero.glb,note=tracked asset" --test "command=node scripts/run-tests.mjs test,timeout_seconds=240" --doc "path=README.md,note=asset docs"'],tips:["Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.","Use --type <value> to load type-aware policy guidance in --help output."]},focus:{why:"Sets a session focused item so new pm create items default their --parent to it (project management = context management).",examples:["pm focus pm-epic1","pm focus","pm focus --clear"],tips:["Focus is session-local (stored in .agents/pm/runtime/session.json, gitignored) \u2014 it never affects teammates.",'An explicit --parent on pm create always overrides the focused item; use --parent "" to create with no parent.',"A stale focused item produces the same missing-parent validation as an explicit stale --parent."]},update:{why:"Mutates existing item fields while preserving history and lock safety.",examples:['pm update pm-a1b2 --status in_progress --message "Start implementation"','pm update pm-a1b2 --unset close-reason --message "Clear stale close reason after reopen"','pm update pm-a1b2 --unset assignee --deadline +2d --message "Replan ownership and deadline"','pm update pm-a1b2 --body "Backfilled body text for legacy item" --message "Normalize missing body"'],tips:['Use "pm close <ID> <TEXT>" to close items instead of --status closed.',"When reopening from closed to a non-terminal status, update clears stale close_reason unless explicitly set via --close-reason.",'Use "pm append <ID> --body <text>" for additive notes; use update --body to replace body content.']},"update-many":{why:"Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.",examples:["pm update-many --filter-status open --status in_progress --dry-run",'pm update-many --filter-tag wave:7 --replace-tests --test "command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,timeout_seconds=240"','pm update-many --filter-tag governance --reviewer maintainer-review --message "Normalize reviewer metadata"',"pm update-many --rollback ckpt-abc123"],tips:["Use --dry-run first to inspect proposed changes before apply mode.","Linked-array mutation flags mirror pm update semantics (for example --replace-tests, --clear-files, and repeatable --doc/--note seeds).","Checkpoints are enabled by default for apply mode and can be restored with --rollback."]},"close-many":{why:"Bulk-closes matched items with a shared reason routed through full pm close semantics (close validation, active-child orphan checks, blocked-edge cleanup) plus dry-run previews and rollback checkpoints \u2014 unlike update-many --status closed, which bypasses close validation.",examples:['pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met" --dry-run','pm close-many --filter-tag wave:7 --reason "Superseded by redesign" --validate-close warn','pm close-many --ids pm-a,pm-b,pm-c --reason "Closed in batch" --resolution "Verified by integration suite"',"pm close-many --rollback close-many-20260604-abc123"],tips:["At least one filter (--filter-* or --ids) is required so close-many never matches every item.","Already-terminal matches are skipped by default; pass --force to re-close them.","Use --dry-run to preview matches plus per-item skip reasons and active-child orphan warnings before applying.","Checkpoints are enabled by default for apply mode; restore with --rollback <checkpoint-id>."]},templates:{why:"Saves, lists, and inspects reusable create option bundles for repeatable workflows.",examples:['pm templates save triage-default --title "Triage item" --description "..." --type Task --status open --priority 2 --message "Seed triage template"',"pm templates list","pm templates show triage-default"],tips:["Template names are positional arguments (`pm templates save <name>` and `pm templates show <name>`), not --name flags.","Combine templates with explicit create flags; explicit flags always override template defaults."]},deps:{why:"Inspects an item dependency graph as a tree or graph payload to understand blockers and hierarchy links.",examples:["pm deps pm-a1b2","pm deps pm-a1b2 --format graph","pm deps pm-a1b2 --max-depth 2 --collapse repeated --summary"],tips:["Use --summary for lightweight counts when full graph payloads are unnecessary."]},list:{why:"Lists active items with deterministic filtering and ordering.",examples:["pm list --limit 20","pm list --type Task --priority 0 --tag release --status in_progress","pm list --compact --sort deadline --order asc","pm list --fields id,title,parent,type --sort parent --order asc"]},"list-all":{why:"Lists all item states (including terminal states) when you need full visibility.",examples:["pm list-all --limit 50","pm list-all --type Issue --include-body"]},"list-open":{why:"Shows work that is ready to claim and start.",examples:["pm list-open --priority 0 --limit 10"]},"list-in-progress":{why:"Tracks active execution and owner progress.",examples:["pm list-in-progress --priority 0 --limit 20"]},"list-blocked":{why:"Surfaces blocked work that needs intervention.",examples:["pm list-blocked --limit 20"]},"list-closed":{why:"Reviews completed work and closure outcomes.",examples:["pm list-closed --limit 20 --type Task"]},"list-canceled":{why:"Audits intentionally discontinued work.",examples:["pm list-canceled --limit 20"]},"list-draft":{why:"Finds incompletely defined items that need refinement before execution.",examples:["pm list-draft --limit 20"]},aggregate:{why:"Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.",examples:["pm aggregate --group-by parent,type --count","pm aggregate --group-by type,status --count","pm aggregate --group-by parent,type --count --status open --parent pm-feature01"],tips:["Current aggregate mode is grouped counts only, so pass --count explicitly."]},guide:{why:"Routes local progressive-disclosure documentation so agents can fetch only the context they need.",examples:["pm install guide-shell --project","pm guide","pm guide quickstart","pm guide commands --depth standard","pm guide skills --depth deep --format markdown","pm guide release --json"],tips:["Use brief depth for minimal token footprint, standard for excerpted docs, and deep for full local document rendering.","Use --list to force topic index output even when topic parsing is ambiguous."]},calendar:{why:"Provides deadline/reminder/event scheduling views for planning and coordination.",examples:["pm calendar","pm calendar --view agenda --from +0d --to +7d --tag release","pm calendar --view week --date 2026-04-06 --full-period --include deadlines,events","pm calendar --view month --tag release --format json"],tips:["Day/week/month views are anchored period windows; default mode clips the start to now unless --past or --full-period is set.","--full-period applies only to day/week/month views; use --from/--to to bound agenda windows."]},context:{why:"Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.",examples:["pm context","pm ctx --depth standard --limit 10","pm ctx --depth deep --tag release","pm ctx --section hierarchy --section progress --section blockers","pm context --depth standard --activity-limit 20 --stale-threshold 14d","pm context --from +0d --to +7d --format markdown --depth deep"],tips:["High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Decisions/Event/Reminder/Milestone/Meeting/Plan.","When no open or in-progress work exists, blocked items are shown as fallback context.","--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.","--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.","Configure defaults via pm config project set context --default-depth standard --activity-limit 15."]},next:{why:"Answers 'what should I work on now?' with the highest-priority ready item, rationale, and ranked ready and blocked queues.",examples:["pm next","pm next --json","pm next --limit 3 --ready-only","pm next --parent pm-mpbb","pm next --tag release --format markdown"],tips:["Ready = active status, no open blockers, and no open children (a concrete leaf); the recommendation resumes in-progress work before starting new work.","An item is blocked when its scalar blocked_by or a blocked_by dependency points at a non-terminal item; the blocked list names the blockers to clear.","Containers (Epics/Features with open children) are never recommended directly \u2014 the actionable leaf beneath them is.","Use --parent to scope to one epic's subtree, or --ready-only to drop the blocked companion list for the tightest output."]},search:{why:"Finds relevant items by keyword, semantic, or hybrid retrieval modes.",examples:['pm search "lock stale retry" --mode keyword --limit 10','pm search "extension migration blockers" --mode hybrid --type Task --priority 0','pm search "Cross-Epic Realism Dependency Council" --mode keyword --title-exact'],tips:["Use --title-exact to require exact normalized title parity, or --phrase-exact to require full-phrase matches in item text fields.","Use --include-linked when linked docs/files/tests should influence scoring."]},eval:{why:"Measures search relevance against a curated golden-query set so retrieval regressions are caught, not guessed.",examples:["pm eval --json","pm eval --mode hybrid --k 10","pm eval --fail-under 0.6 --json","pm eval --queries ./my-eval.json --mode semantic"],tips:["Curate ground truth in <pmRoot>/search/eval-queries.json as an array of {query, relevant_ids, mode?} objects.","Wire --fail-under into CI to fail the build when aggregate nDCG@k drops below your baseline."]},reindex:{why:"Rebuilds search artifacts after large changes to item corpus or provider/vector config.",examples:["pm reindex --mode keyword","pm reindex --mode hybrid --progress --json"],tips:["Use --progress for non-interactive visibility during local embedding runs.","JSON output includes semantic stale/unchanged/embed/upsert counts so agents can gate long reindex work without parsing stderr."]},get:{why:"Shows details for one item by ID, with optional lower-token projections for agent loops.",examples:["pm get pm-a1b2","pm get pm-a1b2 --depth brief --json","pm get pm-a1b2 --fields id,title,status,parent,type --json","pm get pm-a1b2 --at 7 --fields id,title,status,body --json"],tips:["Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.","Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.","Schedule metadata is normalized under schedule; request schedule.start_at or schedule.location for narrow calendar reads.","Children are type-agnostic and include bounded deterministic samples plus continuation metadata when a parent has direct children.","Use --at <version|timestamp> for a verified read-only historical projection; reconstructed/as_of fields distinguish it from current state.","JSON output shape is { item, linked, claim_state, schedule, children }; body is nested at item.body (parity with list --include-body)."]},history:{why:"Inspects item mutation timeline and audit trail.",examples:["pm history pm-a1b2 --limit 20","pm history pm-a1b2 --full --verify"]},"history-compact":{why:"Compacts long history streams into a synthetic checkpoint while preserving replay integrity. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to sweep many.",examples:["pm history-compact pm-a1b2 --dry-run",'pm history-compact pm-a1b2 --before 25 --message "Compact early history"',"pm history-compact --all-over 500 --dry-run","pm history-compact --closed","pm history-compact --ids pm-a1b2,pm-c3d4 --dry-run"]},activity:{why:"Reviews recent tracker-wide activity across items.",examples:["pm activity --limit 50","pm activity --full --id pm-a1b2 --limit 50","pm activity --id pm-a1b2 --op update --from -7d --to now","pm activity --json --stream rows --limit 200"],tips:["Use --stream with --json for line-delimited automation output; --from is inclusive and --to is exclusive."]},restore:{why:"Restores an item to a prior timestamp/version with history replay safety.",examples:['pm restore pm-a1b2 2026-04-01T00:00:00.000Z --message "Rollback to known-good state"']},close:{why:"Transitions work to terminal closed state with explicit rationale.",examples:['pm close pm-a1b2 "Done" --release-assignment --validate-close warn','pm close pm-a1b2 "Done" --validate-close','pm close pm-a1b2 "Done" --validate-close off','pm close pm-a1b2 "Done" --validate-close strict']},delete:{why:"Removes an item while preserving history evidence and lock/ownership checks.",examples:['pm delete pm-a1b2 --message "Remove duplicate item"']},append:{why:"Adds implementation notes to body without replacing existing content.",examples:['pm append pm-a1b2 --body "Implemented retry with bounded backoff." --message "Record implementation detail"']},comments:{why:"Adds or reviews lightweight status updates linked to an item.",examples:['pm comments pm-a1b2 "Verified fix on Linux and macOS"','pm comments pm-a1b2 --add "Verified fix on Linux and macOS"','printf "%s\\n" "## Verification" "- linux pass" "- mac pass" | pm comments pm-a1b2 --stdin',"pm comments pm-a1b2 --file docs/release-evidence.md",'pm comments pm-a1b2 --add "text: verification note with commas, key-like words, and parser details"','pm comments pm-a1b2 --add "Follow-up needed after review" --force',"pm comments pm-a1b2 --limit 10"],tips:["Use exactly one comment source at a time: positional [text], --add, --stdin, or --file.","Use --force when adding comments to items currently assigned to a different owner.","When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent."]},notes:{why:"Adds or reviews durable implementation notes linked to an item.",examples:['pm notes pm-a1b2 --add "Investigated parser edge case and documented fallback logic."','pm notes pm-a1b2 --add "text: parser rationale with commas, colons, and key-like wording"','pm notes pm-a1b2 --edit 1 --add "Corrected durable note"',"pm notes pm-a1b2 --delete 2","pm notes pm-a1b2 --limit 10"],tips:["CSV-like add payloads with extra key fragments are treated as plain text by design; use explicit text keys (text= or text:) when structured parsing is required."]},learnings:{why:"Adds or reviews post-implementation learnings for future work.",examples:['pm learnings pm-a1b2 --add "Avoid direct test-runner commands in linked tests; use sandbox runner."','pm learnings pm-a1b2 --add "text: lesson with commas, key-like words, and punctuation-safe context"',"pm learnings pm-a1b2 --edit 1 --file docs/corrected-learning.md","pm learnings pm-a1b2 --delete 2","pm learnings pm-a1b2 --limit 10"],tips:["If you intended structured parsing for a key-like payload, prefer explicit text=..., markdown text: ..., or stdin token -; ambiguous CSV-like forms intentionally remain plain text."]},files:{why:"Associates changed source files with tracker items for reproducibility.",examples:['pm files pm-a1b2 --add "path=src/cli/main.ts,note=help orchestration"','pm files pm-a1b2 --add src/cli/main.ts --note "help orchestration"',"pm files discover pm-a1b2",'pm files discover pm-a1b2 --apply --note "discovered from item text"']},docs:{why:"Associates relevant documentation paths with tracker items.",examples:['pm docs pm-a1b2 --add "path=README.md,note=user-facing command guidance"','pm docs pm-a1b2 --add README.md --note "user-facing command guidance"']},test:{why:"Links test commands/paths and optionally executes them for one item.",examples:['pm test pm-a1b2 --add "command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400"','pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\s+\\d+"','pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,pm_context_mode=auto"',"pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped","pm test pm-a1b2 --run --timeout 2400 --pm-context auto","pm test pm-a1b2 --run --background --timeout 2400 --progress"]},"test-all":{why:"Runs linked tests in bulk for release/readiness sweeps.",examples:["pm test-all --status in_progress --limit 5 --offset 10 --timeout 2400","pm test-all --status closed --timeout 3600 --progress --env-set PORT=0 --shared-host-safe --fail-on-skipped","pm test-all --status in_progress --pm-context tracker --fail-on-context-mismatch --require-assertions-for-pm","pm test-all --status in_progress --pm-context auto --fail-on-context-mismatch","pm test-all --status in_progress --background --timeout 3600"]},"test-runs":{why:"Manages background linked-test runs with lifecycle controls and log/status inspection.",examples:["pm test-runs list --status running --limit 20","pm test-runs status tr-abc123","pm test-runs logs tr-abc123 --stream stderr --tail 200","pm test-runs stop tr-abc123","pm test-runs resume tr-abc123"]},stats:{why:"Reports tracker-level totals and distribution by type/status.",examples:["pm stats","pm stats --json"]},telemetry:{why:"Inspects and manages local telemetry queue/runtime state for observability diagnostics.",examples:["pm telemetry status","pm telemetry stats --limit 10","pm telemetry flush","pm telemetry clear"]},health:{why:"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.",examples:["pm health","pm health --check-only --summary --json","pm health --brief --json","pm health --no-refresh","pm health --refresh-vectors"]},validate:{why:"Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.",examples:["pm validate","pm validate --check-resolution --json","pm validate --check-lifecycle --dependency-cycle-severity error","pm validate --check-lifecycle --parent-cycle-severity error","pm validate --check-files --scan-mode tracked-all","pm validate --check-files --scan-mode tracked-all-strict --include-pm-internals","pm validate --check-command-references","pm validate --check-resolution --fail-on-warn --json"],tips:["Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details."]},gc:{why:"Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.",examples:["pm gc --dry-run","pm gc"]},claim:{why:"Claims an item to signal active ownership and reduce conflicts.",examples:["pm claim pm-a1b2 --start",'pm claim pm-a1b2 --force --message "Take over terminal item"','pm claim pm-a1b2 --author "release-service" --message "Explicit non-agent identity override"'],tips:["Claim takeover for non-terminal items does not require --force; --force is reserved for terminal/lock overrides.","Harness identity is automatic; use --author only to assert an intentional external principal."]},release:{why:"Releases an active claim when paused, handed off, or completed.",examples:["pm release pm-a1b2 --pause"]},"start-task":{why:"Lifecycle alias that claims an item and sets status to in_progress.",examples:['pm start-task pm-a1b2 --message "Start implementation"']},"pause-task":{why:"Lifecycle alias that sets status to open and releases active assignment.",examples:['pm pause-task pm-a1b2 --message "Pause for dependency unblock"']},"close-task":{why:"Lifecycle alias that closes with reason text and clears assignment metadata.",examples:['pm close-task pm-a1b2 "All acceptance criteria met" --message "Close and handoff"']},meet:{why:"Shortcut to create a Meeting from friendly time flags (start/duration) without structured --event CSV.",examples:['pm meet "Sprint Planning" --start +1h --duration 1h','pm meet "1:1" --start 2026-07-01T15:00:00Z --end 2026-07-01T15:30:00Z --location "Room A"'],tips:["Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.","--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M."]},event:{why:"Shortcut to create an Event from friendly time flags (start/duration) without structured --event CSV.",examples:['pm event "Release v2" --start 2026-07-01T10:00:00Z --duration 2h','pm event "Conference" --start 2026-08-01 --all-day'],tips:["Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.","--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M."]},remind:{why:"Shortcut to create a Reminder from a single point in time without structured --reminder CSV.",examples:['pm remind "Review PR" --at +2d','pm remind "Follow up" --at 2026-07-01T09:00:00Z --text "Ping the team"'],tips:["The reminder time defaults to +1d and the reminder text defaults to the title."]},completion:{why:"Generates shell completion scripts for faster and more reliable command entry.",examples:["pm completion bash","pm completion zsh","pm completion fish","pm completion bash --eager-tags"],tips:["Default scripts resolve tag suggestions lazily at completion time; use --eager-tags to embed current tags directly."]},contracts:{why:"Exposes machine-readable CLI command and tool schema contracts for agent integrations.",examples:["pm contracts","pm contracts --command list --runtime-only","pm contracts --command update --flags-only","pm contracts --availability-only --runtime-only","pm contracts --action create","pm contracts --schema-only"],tips:["Use --command to narrow actions/schema to one CLI surface; combine with --flags-only or --availability-only for lighter payloads."]}};for(let{alias:e,canonical:t}of I){let n=fe[e];n&&(fe[t]={...n,examples:n.examples.map(o=>o.replace(`pm ${e}`,`pm ${t}`))})}var Ee={why:"Provides deterministic project management workflows for humans and coding agents.",examples:["pm init","pm install guide-shell --project","pm list-open --limit 10",'pm create --title "..." --description "..." --type Task --status open --priority 1 --message "..." --create-mode progressive'],tips:["Use <command> --help for command-specific guidance and examples.","Install guide-shell before using pm guide for local docs and skills routing.","Use --json for machine parsing and integration flows.","Use --no-pager to force direct help output in CI and other non-interactive shells."]},di=B.filter(e=>e.lifecycle==="deprecated");for(let e of di){let t=fe[e.alias];fe[e.alias]={...t,why:`Deprecated: use pm ${e.canonical_argv.join(" ")}. ${t.why}`}}for(let e of[Ee,...Object.values(fe)])e.examples=e.examples.map(t=>{for(let n of di){let o=n.alias.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");t=t.replaceAll(new RegExp(`\\bpm ${o}(?![\\w-])`,"g"),`pm ${n.canonical_argv.join(" ")}`)}return t});function ms(e){let t=M(e??"");return t?ls[t]??t:""}function xn(e){let t=ms(e);return t?fe[t]??Ee:Ee}function mi(e,t){let n=xn(e);return{intent:n.why,examples:t==="detailed"?[...n.examples]:li(n.examples),tips:t==="detailed"?[...n.tips??[]]:[],detail_mode:t}}function ps(){let e=B.filter(({lifecycle:n})=>n==="permanent"),t=B.filter(({lifecycle:n})=>n==="deprecated");return["","Command aliases:",...e.map(({alias:n,canonical_argv:o})=>` ${n} -> pm ${o.join(" ")}`),"","Deprecated aliases:",...t.map(n=>` ${n.alias} -> pm ${n.canonical_argv.join(" ")} (${qo(n)})`)].join(`
|
|
4
4
|
`)}function us(e,t,n,o){let a=new Set(Wa);e.configureHelp({visibleCommands(i){let r=t.visibleCommands(i);return n?r.filter(s=>(ue(s)??Y(s.name()))!=="internal"):i!==e?r:r.filter(s=>o.has(s))},visibleOptions(i){let r=t.visibleOptions(i);return i!==e||n?r:r.filter(s=>a.has(s.flags))}})}function fs(e,t,n,o){let a=new Set(Ba("core")),i=e.createHelp();i.prepareContext({error:!1,helpWidth:80,outputHasColors:!1});let r=()=>`${i.formatHelp(e,i)}${o}
|
|
@@ -30,7 +30,7 @@ Extension command metadata:
|
|
|
30
30
|
`)}return process.exitCode=f.SUCCESS,!0}function gc(e,t){let n=["","Type-aware option policies:"," pass --type <value> with --help to render required/disabled/hidden option policy details for that type.",` active type values: ${t.types.join("|")}`];return e==="create"&&n.push(" scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows."),n.join(`
|
|
31
31
|
`)}function hc(e,t){if(t.options.length===0){e.push(" type options: none");return}e.push(" type options:");for(let n of t.options){let o=n.required?" (required)":"",a=n.aliases??[];e.push(` - ${n.key}${o}`),e.push(` values: ${n.values.length>0?n.values.join("|"):"any non-empty string"}`),e.push(` aliases: ${a.length>0?a.join("|"):"none"}`),n.description&&n.description.trim().length>0&&e.push(` description: ${n.description.trim()}`)}}function yc(e,t){let n=e==="create"?new Set(["title","type"]):new Set,o=new Set(n);if(e==="create")for(let a of[...t.required_create_fields,...t.required_create_repeatables])o.add(a);return{progressive:n,strict:o}}function wc(e,t,n,o){let a=new Set(n),i=o.filter(l=>!a.has(l)),r=l=>l.length>0?l.map(c=>Qt("create",c)).join(", "):"none";e.push(` required in strict mode: ${r(i)}`);let s=i.map(Za).filter(l=>l!==void 0);e.push(` explicit empty assertion: ${s.length>0?s.join(", "):"none"}`),["Reminder","Meeting","Event"].includes(t.name)&&(e.push(" schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy."),e.push(" strict parity remains available via --create-mode strict."))}function _c(e,t,n){let o=Ra(n);if(!o)return gc(e,t);let a=Wo(o,t);if(!a){let h=t.types.join("|");return["",`Type-aware option policies: type "${o}" is not in the active registry.`,` active type values: ${h}`].join(`
|
|
32
32
|
`)}let i=n.indexOf("--"),r=i<0?n:n.slice(0,i),s=r.findIndex(h=>h==="--create-mode"||h.startsWith("--create-mode=")),l=s<0?void 0:r[s]?.startsWith("--create-mode=")?r[s]?.slice(14):r[s+1],c=e==="create"&&l?.toLowerCase()==="strict",d=yc(e,a),m=pt(a,e,d.progressive),p=pt(a,e,c?d.strict:d.progressive),u=h=>h.length>0?h.map(v=>Qt(e,v)).join(", "):"none",g=["",`Type-aware option policies for ${a.name}:`,` required: ${u(p.required)}`,` disabled: ${u(p.disabled)}`,` hidden: ${u(p.hidden)}`];if(e==="create"){let h=pt(a,e,d.strict);wc(g,a,m.required,h.required)}return hc(g,a),p.errors.length>0&&g.push(` config errors: ${p.errors.join("; ")}`),g.join(`
|
|
33
|
-
`)}function sr(e,t,n){let o=x(n);if(o!=="create"&&o!=="update")return;let a=Ze(e,o);a&&a.addHelpText("after",_c(o,t,n))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="714821f9-dd8f-5958-a751-29e8dfc06471")}catch{}})();function vc(e,t){return Me(e.id)||`migration-${String(t+1).padStart(3,"0")}`}function bc(e){return Me(e.status)?.toLowerCase()??"pending"}function Cc(e){return e.mandatory===!0}function xc(e,t){let n=e.layer.localeCompare(t.layer);if(n!==0)return n;let o=e.name.localeCompare(t.name);return o!==0?o:e.id.localeCompare(t.id)}function dr(e){let t=[];return e.forEach((n,o)=>{if(!Cc(n.definition))return;let a=bc(n.definition);a!=="applied"&&t.push({layer:n.layer,name:n.name,id:vc(n.definition,o),status:a})}),t.sort(xc),t}function lr(e){return Array.isArray(e)&&e.length>0}var kc=new Set(["create","beads import","todos import"]),Ec=new Set(["restore","update","close","delete","append","claim","release"]),Sc=new Set(["comments","notes","learnings"]),Ac=new Set(["files","docs","test"]),Oc=new Set(["activate","add","add-field","add-status","add-type","apply","compact","create","deactivate","delete","disable","edit","enable","import","infer","install","materialize","migrate","redact","remove","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type","repair","run","save","set","unset","update","upgrade"]);function Xn(e,t){let n=t.force===!0;return kc.has(e)?{isMutation:!0,forceCapable:!1,forceRequested:!1}:Ec.has(e)?{isMutation:!0,forceCapable:!0,forceRequested:n}:Sc.has(e)?{isMutation:typeof t.add=="string",forceCapable:!0,forceRequested:n}:Ac.has(e)?{isMutation:lr(t.add)||lr(t.remove),forceCapable:!0,forceRequested:n}:{isMutation:!1,forceCapable:!1,forceRequested:!1}}function Tc(e,t,n){if(Xn(e,n).isMutation)return!0;let o=e.trim().toLowerCase();return ja(o)?["close-many","close-task","copy","delete","discover","focus","pause-task","start-task","update-many"].includes(o)?!0:t.some(a=>Oc.has(a.trim().toLowerCase())):!1}function cr(e){return(e??"in_progress").trim().toLowerCase().replaceAll("-","_")}function Rc(e,t,n){let o=t[0]?.trim().toLowerCase()??"";if(e.trim().toLowerCase()!=="schema"||!["rename-type","rename-field","remap-status"].includes(o))return;let a=[];if(Me(t[1])||a.push("source"),Me(n.to)||a.push("--to"),a.length!==0)throw new b(`Schema migration requires ${a.join(", ")}.`,f.USAGE,{code:"schema_migration_input_required",required:a.join(","),why:"Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",recovery:{recovery_mode:"compact",missing_required_fields:a,suggested_flags:a.filter(i=>i.startsWith("--")),suggested_retry:`pm schema ${o} <source> --to <target>`}})}async function Ic(e,t,n,o,a){if(e.trim().toLowerCase()!=="update"||typeof n.status!="string"||cr(n.status)!==cr(a.schema.workflow.in_progress_status))return;let i=t[0];if(!i)return;let r=re(a,se()),s=await wt(o,i,a.id_prefix,a.item_format,r.type_to_folder);if(!s)return;let l=await Ea(s,{schema:a.schema}),c=typeof n.assignee=="string"?n.assignee.trim():void 0;(c===void 0?l.document.metadata.assignee?.trim():!["","none","null","undefined"].includes(c.toLowerCase())&&c)||w(`warning:in_progress_item_unclaimed:${s.id}:claim_with=pm claim ${s.id}`)}async function Zn(e,t,n,o,a){if(!Tc(e,t,n)||(Rc(e,t,n),!await K(J(a))))return;let i=await ke(a);o.json!==!0&&await Ic(e,t,n,a,i.settings);let r=La({author:ht(o.author,i.settings.author_default),payload:{command:e,args:t,options:n},settings:i.settings.mutation_guard,force:o.force===!0||n.force===!0});for(let s of r.warnings)w(`warning:${s}`)}function mr(e,t,n){if(n.length===0)return;let o=Xn(e,t);if(!o.isMutation||o.forceCapable&&o.forceRequested)return;let a=n.map(r=>`extension_migration_blocking:${r.layer}:${r.name}:${r.id}:${r.status}`),i=o.forceCapable?"Re-run this command with --force to bypass.":"This command path does not support --force bypass.";throw new b(`Write command "${e}" blocked by unresolved mandatory extension migrations (${a.join(",")}). ${i}`,f.CONFLICT)}async function Qn(e,t,n,o){if(!Xn(e,t).isMutation||!o.enforce_item_format_gate&&!o.run_preflight_item_format_sync||!await K(J(n)))return;let{settings:a,metadata:i,warnings:r}=await ke(n);for(let s of r)w(`warning:${s}`);if(o.enforce_item_format_gate&&!i.has_explicit_item_format&&(xa(a),await ka(n,a,"item_format:auto_select_default")),o.run_preflight_item_format_sync){let s=re(a,se());await Ua(n,a.item_format,"item_format:pre_mutation_sync",s.type_to_folder,a.schema)}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="c0826cb1-5181-51b3-9ad9-0cd7a3d2c4b3")}catch{}})();function eo(e){let t=[];for(let n of e??[]){if(n.startsWith("-"))break;let o=_(n);o.length!==0&&t.push(o)}return t}function Re(e){let t=_(e.commandPath??"");if(t.length===0)return[];let n=[t],o=t.split(" ").filter(a=>a.length>0);for(let a of eo(e.commandArgs))o.push(...a.split(" ").filter(i=>i.length>0)),n.push(o.join(" "));return[...new Set(n.flatMap(a=>[a,O(a)]))]}function to(e,t){let n=_(e);if(n.length===0)return!1;let o=Re(t);for(let a of o)if(a===n||a.startsWith(`${n} `))return!0;return t.allowCommandPrefixMatch===!0?o.some(a=>n.startsWith(`${a} `)):!1}function Ft(e){let t=e.activation?.commands;if(t)return t;let n=e.contributions;return n?[...R(n.commands),...R(n.command_handlers),...R(n.command_overrides),...R(n.flag_commands),...R(n.parser_overrides),...pr(n.preflight_ownership),...pr(n.renderer_ownership)]:[]}function R(e){return e??[]}function pr(e){return R(e).flatMap(t=>t.commands)}function tt(e){return new Set((e.capabilities??[]).map(t=>t.trim().toLowerCase()))}var ur=new Set(["hooks","parser","preflight","renderers"]),fr=new Set(["commands","schema","services","importers"]),$c=new Set(["reindex","search","search-advanced"]),Pc=new Set(["--template"]);function Te(e,t){for(let n of t)if(e.has(n))return!0;return!1}function no(e){let t=_(e??"");if(t.length===0)return!1;let[n]=t.split(" ");return $c.has(n??t)}function oo(e,t){for(let n of e.commandArgs??[]){if(!n.startsWith("--"))continue;let[o]=n.split("=",1);if(t.has(o))return!0}return!1}function Lt(e){return _(e.commandPath??"")==="create"&&oo(e,Pc)}function ao(e){return e.some(t=>{let n=_(t);return n==="templates"||n.startsWith("templates ")})}function Mt(e,t){return e.some(n=>to(n,t))||Lt(t)&&ao(e)}function io(e){return[R(e.hooks).length,(e.preflight_overrides??0)-R(e.preflight_ownership).length,R(e.item_types).length,R(e.item_fields).length,R(e.relationship_kinds).length,R(e.service_overrides).length,R(e.assurance_providers).length,R(e.renderer_overrides).length-R(e.renderer_ownership).length].some(t=>t>0)}function ro(e,t){let n=e.activation?.commands??[];if(n.length>0)return Mt(n,t);let o=Ft(e);if(Mt(o,t)||tt(e).has("search")&&no(t.commandPath))return!0;if(e.contributions)return io(e.contributions)}function jt(e,t){let n=ro(e,t);if(n!==void 0)return n;let o=tt(e);return!!(Te(o,ur)||Te(o,fr))}function nt(e,t){return e.effective.length===0?!1:ot(t)!=="all"?e.effective.some(n=>jt(n,t)):e.effective.some(n=>{let o=tt(n);return Ft(n).length>0||Te(o,ur)||Te(o,fr)||o.has("search")})}function ot(e){if(_(e.commandPath??"").split(" ")[0]==="completion")return"all";let t=Re(e).filter(o=>o.split(" ").every(a=>!a.startsWith("-"))).sort((o,a)=>a.length-o.length)[0]??_(e.commandPath??"");if(t.length===0)return"all";let n=Lt(e)?"--template":"";return`${e.allowCommandPrefixMatch===!0?"prefix":"exact"}:${t}:${n}`}function so(e){return ot(e)==="all"?void 0:t=>jt(t,e)}function Ie(e){let t=S(e);if(t.requested&&t.commandPathTokens.length>0){let[a,...i]=t.commandPathTokens;return{commandPath:a,commandArgs:i,allowCommandPrefixMatch:!0}}let n=D(e),o=n.findIndex(a=>a.trim().length>0&&!a.startsWith("-"));return o<0?{}:{commandPath:n[o],commandArgs:n.slice(o+1),allowCommandPrefixMatch:t.requested}}function lo(e){let t=e.args.map(String);if(_(E(e))==="create"){let n=e.optsWithGlobals();typeof n.template=="string"&&n.template.trim().length>0&&t.push("--template")}return t}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2fe1a4e5-3c55-5ec3-a729-2216a298c081")}catch{}})();var Ut=Symbol.for("pm.readOutputInvocationProvenance");function ie(e,t){let n=Reflect.get(e,Ut);n!==void 0&&Reflect.set(t,Ut,n)}function co(e,t,n){let o=ua(t,n);if(!o)return;let a=e;for(;a.parent;)a=a.parent;let i=a.rawArgs,r=new Set(X(i.slice(2))),s=pa.find(d=>d.command===o),l=Object.values(s.dimensions).flatMap(d=>d.legacy_aliases.flatMap(m=>r.has(m.flag)?[m.flag]:[])),c=Reflect.get(n,Ut);Reflect.set(n,Ut,{canonical_include_modes:c?.canonical_include_modes??[],explicit_legacy_aliases:l,cli_invocation_observed:!0}),ie(n,e)}function Nc(e){let t=e.optsWithGlobals(),n=E(e);if(O(n)===n)return t;let o=e.opts();for(let a=e.parent;a?.parent;a=a.parent)for(let i of a.options){let r=i.attributeName(),s=a.getOptionValueSource(r)==="cli";if(s&&!e.options.some(l=>l.long===i.long))throw new b(`Unknown option '${i.long}' for ${n}`,f.USAGE,{code:"unknown_option",flag:i.long,required:`Use options declared by pm ${n} --help.`});if(s&&e.getOptionValueSource(r)!=="cli"){let l=a.getOptionValue(r);e.setOptionValueWithSource(r,l,"cli")}r in o?t[r]=o[r]:delete t[r]}return t}function mo(e,t,n,o){co(e,t,o);let a=n.outputInclude;if(a===void 0)return;let{selectors:i,modes:r}=ha(t,a,o);if(t==="get"&&typeof o.fields=="string"&&e.setOptionValueWithSource("fields",o.fields,"cli"),r.length===0)return;ie(o,e);let s=ga(t);for(let c of r){let d=s.get(c),m=o[d];e.setOptionValueWithSource(d,m,"cli")}let l=i.length>0?i.join(","):void 0;l===void 0?delete n.outputInclude:n.outputInclude=l;for(let c=e;c;c=c.parent)c.setOptionValueWithSource("outputInclude",l,"cli");kt(e,n)}function $e(e,t,n=[]){let o={...Nc(e)};ie(e,o),delete o.json,delete o.quiet,delete o.path,delete o.pmPath,delete o.noExtensions,delete o.extensions,delete o.profile,delete o.pager,delete o.changedFields,delete o.fullChangedFields,delete o.idOnly,delete o.lean,delete o.tokenAccounting,delete o.outputInclude,delete o.outputLimit,delete o.outputBudget,delete o.outputFormat,delete o.outputSession;let a=Qi(t);for(let[i,r]of Object.entries(a))o[i]===void 0&&(o[i]=r);if(n.length>0){let i=Yi(n),r=ne(E(e)).map(c=>({long:c.flag,short:c.short,aliases:c.aliases})),s={...a};for(let c of i)o[c]!==void 0&&(s[c]=o[c]);Kn(s,[...r,...n],E(e));let l=Zi(o,n,a);return ie(o,l),l}return o}function qt(e,t){let n=_(t);return n.length===0?[]:e.flags.filter(o=>O(_(o.target_command))===O(n)).flatMap(o=>o.flags)}function at(e,t,n){let o=qt(e,t),a=[t],i=[];for(let r of n){if(r.startsWith("-"))break;a.push(r);let s=qt(e,a.join(" "));s.length>0&&(i=s)}return i.length>0?i:o}function Ht(e){return e.arguments??[]}function gr(e){let t=Ht(e).map(n=>{let o=n.variadic?`${n.name}...`:n.name;return n.required?`<${o}>`:`[${o}]`}).join(" ");return`pm ${e.command}${t?` ${t}`:""}`}function po(e,t){if(!e)return!1;let n=_(t);return e.importers.some(o=>_(`${o.importer} import`)===n)||e.exporters.some(o=>_(`${o.exporter} export`)===n)}function uo(e,t){let n=Ht(e),o=n.filter(s=>s.required).length,a=n.some(s=>s.variadic)?Number.POSITIVE_INFINITY:n.length,i=e.failure_hints??[],r=i.length>0?` ${i.join(" ")}`:"";if(t.length<o)throw new b(`Missing required argument for extension command '${e.command}'. Usage: ${gr(e)}${r}`,f.USAGE);if(t.length>a){let s=t.slice(a).join(" ");throw new b(`Too many arguments for extension command '${e.command}': ${s}. Usage: ${gr(e)}${r}`,f.USAGE)}}function Dc(e){return`--${e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/_/g,"-").toLowerCase()}`}function Mc(e,t,n){if(n.length>0){Kn(t,n,e.command);return}let o=Object.keys(t).filter(a=>t[a]!==void 0).sort();if(o.length!==0)throw new b(`Unknown option '${o.map(Dc).join(", ")}' for extension command '${e.command}'. This command does not define extension flags.`,f.USAGE)}function fo(e,t,n,o){e&&(uo(e,t),Mc(e,n,o))}import{Command as hr}from"commander";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="0503f6e5-36d9-5afb-a17f-feef2241f984")}catch{}})();var Fc=new Set(["--version","-V"]);function it(e){let t=D(e);return["package","packages","extension"].includes(t[0]??"")&&t[1]==="inventory"}function yr(e){if(D(e)[0]!=="item"||!e.includes("--dry-run"))return;let t=new hr().configureOutput({writeErr:()=>{}}).exitOverride(),n=new Set;for(let a of He)for(let i of[a.flag,a.short,...a.aliases??[]]){if(i===void 0||n.has(i))continue;n.add(i);let r=a.value_name!==void 0||a.flag==="--pm-path";t.option(`${i}${r?" <value>":""}`)}try{t.parseOptions(e)}catch{}let o=t.opts();return{path:o.pmPath??o.path}}var Lc=new Set(["config","extension","init","install","package","packages","templates","upgrade"]),go=new Set(["activity","aggregate","context","ctx","events","get","graph","history","list","list-all","list-blocked","list-canceled","list-closed","list-draft","list-in-progress","list-open","search"]),wr=new Set(["append","close","close-many","comments","delete","deps","discover","docs","files","history-repair","history-redact","history-compact","learnings","notes","plan","restore","update","update-many","create"]),jc=new Set(["claim","close-task","contracts","duplicates","gc","health","pause-task","release","start-task","stats","test","test-all","test-runs","test-runs-worker","validate"]),Uc=new Set(["claim","close-task","pause-task","release","start-task","test"]),ye={setup:!0,listQuery:!0,mutation:!0,operation:!0},qc=new Set(["create","update","update-many","list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled","search","calendar","context","templates"]);function rt(e){return e.some(t=>Fc.has(t))}function Hc(e,t){if(!I.some(o=>o.canonical_argv[0]===t))return;let n=new hr().configureOutput({writeErr:()=>{}}).exitOverride();for(let o of Ga(t,ne(t))){let a=o.takes_value?o.value_required?" <value>":" [value]":"";for(let i of[o.flag,o.short,...o.aliases??[]])i!==void 0&&n.option(`${i}${a}`)}try{let o=n.parseOptions(e.slice(1));if(o.unknown.length>0)return ye;let a=W([t,...o.operands])?.alias;if(I.some(i=>i.alias===a))return{...ye,targetCommandName:a}}catch{return ye}}function ho(e){if(rt(e))return{setup:!1,listQuery:!1,mutation:!1,operation:!1};if(e.length===0||S(e).requested)return ye;let t=x(e);if(!t)return ye;let n=t.trim().toLowerCase(),o=D(e),a=W(o)?.alias;return I.some(i=>i.alias===a)?{...ye,targetCommandName:a}:Hc(o,n==="ctx"?"context":n)||(Lc.has(n)?{setup:!0,listQuery:!1,mutation:!1,operation:!1,targetCommandName:n}:go.has(n)?{setup:!1,listQuery:!0,mutation:!1,operation:!1,targetCommandName:n}:wr.has(n)?{setup:!1,listQuery:!1,mutation:!0,operation:!1,targetCommandName:n}:jc.has(n)?{setup:!1,listQuery:!1,mutation:!1,operation:!0,targetCommandName:n}:ye)}function yo(e){return e.length===0||S(e).requested||e.includes("--explain")&&x(e)===void 0}function wo(e,t){return it(t)||rt(t)?!1:oe(t)||S(t).requested?!0:!!x(t)}function _o(e){if(rt(e))return!1;let t=x(e);return t?qc.has(t):!1}function zc(e){let t=String(e.rawFrom??""),n=t.indexOf("="),o=n>=0?t.slice(0,n):t,a=e.normalizedTokens.map(c=>{let d=c.indexOf("=");return d>=0?c.slice(0,d):c}).find(c=>c==="--literal"||c==="--regex"||c==="--replacement"),i=a?e.argv.map(c=>{let d=c.indexOf("=");return(d>=0?c.slice(0,d):c)===o?d>=0?`${a}${c.slice(d)}`:a:c}):e.argv,r=je(i),s=a&&n>=0?`${o}=[redacted]`:t,l=a&&e.normalizedDisplay.includes("=")?`${a}=[redacted]`:e.normalizedDisplay;return{argv:r,normalizedDisplay:l,sourceDisplay:s}}function vo(e){let t=e.commandName;if(!t)return;let n=e.trace.find(c=>c.reason==="flag_typo");if(!n)return;let o=Array.isArray(n.to)?n.to:[String(n.to??"")].filter(c=>c.length>0),a=o.length>0?o.join(" "):"the canonical flag",i=wr.has(t)||Uc.has(t),r=i?"mutating_flag_typo_requires_retry":"flag_typo_requires_retry",s=i?"mutating option":"option",l=zc({argv:e.argv,normalizedDisplay:a,normalizedTokens:o,rawFrom:n.from});throw new b(`Refusing to auto-correct ${s} ${l.sourceDisplay} to ${l.normalizedDisplay}. Retry with the canonical flag so the command is explicit.`,f.USAGE,{code:r,examples:[k(l.argv)],nextSteps:["Retry the command with the canonical flag shown in examples."],recovery:{normalized_args:l.argv,suggested_retry:k(l.argv)}})}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="6d83c356-db56-5116-9fe7-e0c27973b36f")}catch{}})();var Gc=new Set(["success","nonexistent_command","invalid_option","missing_required_option","missing_required_argument","invalid_usage","validation_failed","health_findings","validation_findings","conflict","runtime_failed","unknown_failed"]),Wc=new Set(["parse","preflight","execute","unknown"]),Vc=new Set(["usage","validation","conflict","runtime","unknown"]);function we(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="string"){let a=o.trim();if(a.length>0)return a}}}function bo(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="boolean")return o}}function zt(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="number"&&Number.isFinite(o))return Math.max(0,Math.trunc(o))}}function Co(e){if(!e)return;let t=e.trim().toLowerCase();if(Gc.has(t))return t}function xo(e){if(!e)return;let t=e.trim().toLowerCase();if(Wc.has(t))return t}function ko(e){if(!e)return;let t=e.trim().toLowerCase();if(Vc.has(t))return t}function Eo(e){let t=we(e,"error","message");if(t)return t;let n=e?.warnings;if(Array.isArray(n)){let i=n.find(r=>typeof r=="string"&&r.trim().length>0);if(typeof i=="string")return i.trim()}if(bo(e,"fail_on_skipped_triggered","failOnSkippedTriggered"))return"linked_test_fail_on_skipped_triggered";let o=zt(e,"failed");if(typeof o=="number"&&o>0)return`failed_runs:${o}`;let a=e?.run_results;if(Array.isArray(a)){let i=a.filter(r=>Zt(r)?.status==="failed").length;if(i>0)return`failed_runs:${i}`}}function So(e,t){if(!e)return t===f.USAGE?"invalid_command_usage":t===f.NOT_FOUND?"item_not_found":t===f.CONFLICT?"lock_conflict":t===f.DEPENDENCY_FAILED?"dependency_failed":"command_failed"}function Ao(){let e=Zt(le()),t=typeof process.exitCode=="number"&&Number.isFinite(process.exitCode)?Math.max(0,Math.trunc(process.exitCode)):void 0,n=zt(e,"exit_code","exitCode"),o=t??n??f.SUCCESS,a=Ka(o),i=we(e,"error_code","errorCode")??So(a,o),r=ko(we(e,"error_category","errorCategory"))??(a?void 0:mt(i)),s=a?void 0:Eo(e)??`command_exit_${o}`,l=Co(we(e,"command_resolution","commandResolution"))??bt({ok:a,errorCode:i,errorCategory:r}),c=xo(we(e,"resolution_stage","resolutionStage"))??"execute";return{ok:a,error:s,exit_code:o,error_code:i,error_category:r,command_resolution:l,resolution_stage:c}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2309d6a4-a061-51d8-be5e-5e1dd62e9b3e")}catch{}})();var Oo="PM_CLI_PACKAGE_ROOT",Er=Symbol("pm.deprecatedAliasInvocation"),Vt=new Map;for(let e of B){let t=e.alias.split(" ")[0],n=Vt.get(t)??[];n.push(e),Vt.set(t,n)}for(let e of Vt.values())e.sort((t,n)=>n.alias.split(" ").length-t.alias.split(" ").length);function Bc(){return Ho(import.meta.url,["../.."])}(typeof process.env[Oo]!="string"||process.env[Oo]?.trim().length===0)&&(process.env[Oo]=Bc());var Pe=null,F=null;function Kc(e){Pe=e}function Jc(e){P=e}var st=null,_e=null,P=new Map,Do=250,Yc=new Set([f.USAGE,f.NOT_FOUND,f.CONFLICT]),Xc=new Set(["1","true","yes","on"]),Zc=Ve(()=>import("./chunks/register-setup-M5VO6JUH.js")),Qc=Ve(()=>import("./chunks/register-list-query-CBJELTDX.js")),ed=Ve(()=>import("./chunks/register-mutation-JRH6EGSE.js")),td=Ve(()=>import("./chunks/register-operations-FYV7CUBF.js"));function Wt(e){return k(e)}function Sr(e){let t=e.match(/--[a-zA-Z0-9][a-zA-Z0-9_-]*/g);if(!t||t.length===0)return;let n=[...new Set(t.map(o=>pe(o)??o))];return n.length>0?n:void 0}function nd(e,t,n){if(n?.suggested_retry||e.includes("failed in extension handler (")||!/\b(?:missing|required|requires)\b/i.test(e))return;let o=X(t),a=new Set(o.map(d=>pe(d)??d)),i=Sr(e),r=t.find(d=>y.commands.some(m=>m.name()===d)),s=r?y.commands.find(d=>d.name()===r):void 0,l=new Set([...y.options,...s?.options??[]].flatMap(d=>d.flags.split(/[ ,|]+/).map(m=>pe(m)).filter(m=>m!==void 0))),c=i?.filter(d=>{let m=pe(d)??d;return a.has(m)?!1:l.has(m)||Hn(t,r,m,P)!==void 0});return c&&c.length>0?c:void 0}function od(e,t,n,o){if(o?.suggested_retry)return o.suggested_retry;let a=n?.[0],i=a?pe(a):void 0,r=e.find(p=>y.commands.some(u=>u.name()===p)),s=r?y.commands.find(p=>p.name()===r):void 0,l=i?s?.options.find(p=>p.flags.split(/[ ,|]+/).includes(i)):void 0,c=Hn(e,r,i,P),d=i?l?.isBoolean()===!0||c===!1?[i]:[i,"<value>"]:[],m=i?Wt([...e,...d]):t;return m===t?void 0:m}function ad(e){if(!e)return{};let t=["recovery_mode","missing_required_fields","suggested_flags","suggested_retry_args","allowed_values","candidate_commands","candidate_commands_total","candidate_commands_truncated","fallback_candidates","next_best_command"],n={};for(let o of t){let a=e[o];a!=null&&(n[o]=a)}return n}function id(e){let t=e.existingRecovery;return{attempted_command:t?.attempted_command??e.attemptedCommand,normalized_args:t?.normalized_args??[...e.invocationArgv],provided_fields:t?.provided_fields??(e.providedFields.length>0?e.providedFields:void 0),missing:t?.missing??e.inferredMissing,...ad(t),...e.suggestedRetry?{suggested_retry:e.suggestedRetry}:{}}}function Ar(e,t,n){let o=je(t),a=D(o),i=me(a),[r,s]=i===void 0?[]:a.slice(i,i+2),l=o.includes("--explain"),c=ai(o,e?.code,e?.recovery),d=c&&(r==="history-redact"||r==="history"&&s==="redact")?{...c,...c.attempted_command?{attempted_command:Wt(o)}:{},...c.normalized_args?{normalized_args:[...o]}:{},...c.suggested_retry?{suggested_retry:Wt(o)}:{},...c.suggested_retry_args?{suggested_retry_args:[...o]}:{}}:c;if(d?.recovery_mode==="compact"&&!l)return{...e,recovery:d};let m=Wt(o),p=X(o),u=nd(n,o,d),g=od(o,m,u,d),h=id({invocationArgv:o,attemptedCommand:m,providedFields:p,inferredMissing:u,suggestedRetry:g,existingRecovery:d});return{...e,recovery:h}}async function ct(e){let t=F;F=null,await ii(t,e);let n=Pe;if(Pe=null,!n){ft();return}let o=[],a=la();try{await ri({pmRoot:n.pmRoot,author:n.globalOptions.author,itemIds:e.ok?a?.map(i=>i.id)??[]:[],intent:n.commandName})}catch{o.push("context_usage_feedback_write_failed")}try{o.push(...await Zo(n.hooks,{command:n.commandName,args:n.commandArgs,options:{...n.commandOptions},global:{...n.globalOptions},pm_root:n.pmRoot,ok:e.ok,error:e.error,result:le(),affected:a}))}catch(i){o=[`afterCommand hooks failed: ${i instanceof Error?i.message:String(i)}`]}finally{ft()}!n.globalOptions.json&&o.length>0&&w(`[pm] warning: afterCommand hook_warnings=${q(o)}`),n.profileEnabled&&o.length>0&&w(`profile:extensions hook_warnings=${q(o)}`)}async function Or(){await Ma()}function Tr(e){return Xc.has((process.env[e]??"").trim().toLowerCase())}function Rr(e){return Tr("PM_SENTRY_CAPTURE_EXPECTED_ERRORS")?!0:!Yc.has(Math.trunc(e))}async function Bt(e){return Rr(e.exit_code)?(await Or(),Fa(e),!0):!1}async function Ir(e){let t=de(e.error),n=Ei(t);e.bootstrapGlobal.json?w(JSON.stringify(xi(t,f.GENERIC_FAILURE),null,2)):w(t),process.exitCode=f.GENERIC_FAILURE;let o="runtime",a="runtime_failed";try{await Or(),fn(e.error);let i=await e.emitTelemetryCommandError({command:e.attemptedCommand,errorCode:n.code,errorMessage:n.detail,exitCode:f.GENERIC_FAILURE,options:{bootstrap_global_options:e.bootstrapGlobal},resolutionStage:"execute"});o=i.errorCategory,a=i.commandResolution,Ge(!1,t,{error_code:n.code,error_category:o,exit_code:f.GENERIC_FAILURE,command_resolution:a,resolution_stage:"execute"})}catch(i){e.bootstrapGlobal.json||w(`Failed to report error: ${de(i)}`)}try{await ct({ok:!1,error:t,exit_code:f.GENERIC_FAILURE,error_code:n.code,error_category:o,command_resolution:a,resolution_stage:"execute"})}catch(i){e.bootstrapGlobal.json||w(`Failed to run error hooks: ${de(i)}`)}try{await We()}catch(i){e.bootstrapGlobal.json||w(`Failed to flush error reporting: ${de(i)}`)}}var rd={create:"create",update:"update","update-many":"update_many",list:"list","list-all":"list","list-draft":"list","list-open":"list","list-in-progress":"list","list-blocked":"list","list-closed":"list","list-canceled":"list",search:"search",calendar:"calendar",context:"context","templates save":"create"},To=new Map;function Ro(e){return e==="number"?"number":e==="boolean"?"boolean":"string"}function $r(e,t){return e.options.some(n=>n.long===t)}function Pr(e,t){return e.options.some(n=>n.short===t)}function Io(e,t,n,o){let a=t.trim();if(!a)return;let i=n.length>0?n:`Runtime schema field (${t})`;if(a.startsWith("-")&&!a.startsWith("--")){if(Pr(e,a))return;if(o){e.option(`${a} <value>`,`${i} (repeatable)`,yn);return}e.option(`${a} <value>`,i);return}let r=a.startsWith("--")?a:`--${a}`;if(!$r(e,r)){if(o){e.option(`${r} <value>`,`${i} (repeatable)`,yn);return}e.option(`${r} <value>`,i)}}async function Nr(e,t){let n=rd[e];if(!n)return[];let o=`${t}:${n}`,a=To.get(o);if(a)return a;if(!await K(J(t)))return To.set(o,[]),[];let i=await N(t),r=(mn(i.schema).command_to_fields.get(n)??[]).flatMap(s=>[s.cli_flag,...s.cli_aliases].map(l=>({long:`--${l}`,type:Ro(s.type),value_type:Ro(s.type)})));return To.set(o,r),r}async function Dr(e,t){let n=U(t),o=T(process.cwd(),n.path);if(!await K(J(o)))return;let a=_e?.key===Lo(o)?_e.snapshot:null,i=a===null?await N(o):a.settings,r=mn(i.schema),s=[{path:"create",command:"create"},{path:"update",command:"update"},{path:"update-many",command:"update_many"},{path:"list",command:"list"},{path:"list-all",command:"list"},{path:"list-draft",command:"list"},{path:"list-open",command:"list"},{path:"list-in-progress",command:"list"},{path:"list-blocked",command:"list"},{path:"list-closed",command:"list"},{path:"list-canceled",command:"list"},{path:"search",command:"search"},{path:"calendar",command:"calendar"},{path:"context",command:"context"},{path:"templates save",command:"create"}];for(let l of s){let c=ee(e,l.path.split(" "));if(c)for(let d of r.command_to_fields.get(l.command)??[]){let m=d.description??"";Io(c,d.cli_flag,m,d.repeatable);for(let p of d.cli_aliases)Io(c,p,`Alias for --${d.cli_flag}`,d.repeatable)}}}async function Mo(e,t,n,o,a){let i=x(n);if(!(i!=="create"&&i!=="update"))try{let r=a??await N(t),s=re(r,o);sr(e,s,n)}catch{}}function $o(){return{enforce_item_format_gate:!0,run_preflight_item_format_sync:!0,run_extension_migrations:!0,enforce_mandatory_migration_gate:!0}}function Mr(e,t="all"){return t==="all"?`pm-root:${e}`:`pm-root:${e}:activation:${t}`}function Fo(e){return e.some(t=>t==="--profile")}function Lo(e){return`pm-root:${e}`}function Po(e){for(let t of e)t.startsWith("settings_read_")&&w(`[pm] warning: ${t} \u2014 settings.json could not be loaded and pm fell back to defaults; run pm health for remediation.`)}function Fr(e,t){e.profile&&(w(`profile:extensions loaded=${t.loadedCount} failed=${t.loadFailedCount} warnings=${t.loadWarnings.length} activation_failed=${t.activationFailedCount} hook_counts=before:${t.hooks.beforeCommand.length}|after:${t.hooks.afterCommand.length}|write:${t.hooks.onWrite.length}|read:${t.hooks.onRead.length}|index:${t.hooks.onIndex.length} command_overrides=${t.commands.overrides.length} command_handlers=${t.commands.handlers.length} parser_overrides=${t.parsers.overrides.length} preflight_overrides=${t.preflight.overrides.length} service_overrides=${t.services.overrides.length} renderer_overrides=${t.renderers.overrides.length}`),t.activationWarnings.length>0&&w(`profile:extensions activation_warnings=${q(t.activationWarnings)}`))}function Kt(e,t,n){if(!e)return;let o=_(n.commandPath??"")||"<none>";w(`profile:extensions activation=skipped command=${o} effective=${t.discovery.effective.length} warnings=${t.discovery.warnings.length} discovery_ms=${t.discoveryMs}`)}async function Jt(e,t=ke){let n=Lo(e);if(_e?.key===n)return _e.snapshot;try{let o=Date.now(),{settings:a,warnings:i}=await t(e),r=await Qo({pmRoot:e,settings:a,cwd:process.cwd(),noExtensions:!1}),s={pmRoot:e,settings:a,discovery:r,discoveryMs:Date.now()-o,settingsReadWarnings:[...i]};return _e={key:n,snapshot:s},s}catch{return _e={key:n,snapshot:null},null}}async function Ne(e,t,n=N){let o=t?ot(t):"all",a=Mr(e,o);if(st?.key===a)return st.snapshot;try{let i=await n(e),r=await Fe({pmRoot:e,settings:i,cwd:process.cwd(),noExtensions:!1,extensionFilter:t?so(t):void 0}),s=await Le({...r,loaded:r.loaded}),l=[...new Set(s.commands.handlers.map(u=>_(u.command)))].filter(u=>u.length>0).sort((u,g)=>u.localeCompare(g)),c=Di(s.registrations.flags),d=Pi(s.commands.handlers,s.registrations.commands),m=Fi(l,s.registrations.commands,s.registrations.flags,d),p={hooks:s.hooks,commands:s.commands,parsers:s.parsers,preflight:s.preflight,services:s.services,renderers:s.renderers,registrations:s.registrations,pmRoot:e,settings:i,commandHandlers:l,commandFlagHelp:c,commandDescriptors:m,commandAliases:d,loadWarnings:[...r.warnings],activationWarnings:[...s.warnings],loadedCount:r.loaded.length,loadFailedCount:r.failed.length,activationFailedCount:s.failed.length,contextIntentPackages:r.loaded.map(({name:u,module:g})=>({name:u,module:g}))};return st={key:a,snapshot:p},p}catch{return st={key:a,snapshot:null},null}}async function Lr(e){let t=Be(e);if(t.noExtensions){let r=T(process.cwd(),t.path);return await K(J(r))&&Po((await ke(r)).warnings),null}let n=T(process.cwd(),t.path),o=await Jt(n);if(!o)return null;Po(o.settingsReadWarnings);let a={commandPath:E(e),commandArgs:lo(e)};if(!nt(o.discovery,a))return Kt(t.profile,o,a),null;let i=await Ne(n,a);return i?(Fr(t,i),{hooks:i.hooks,commands:i.commands,parsers:i.parsers,preflight:i.preflight,services:i.services,renderers:i.renderers,registrations:i.registrations,pmRoot:n}):null}async function jr(e){let t=await Ne(e);return t?new Map(t.commandDescriptors):P}async function Ur(e,t){return(await Aa({pmRoot:t,migrations:e,author:"pm-extension-migration"})).migrations.filter(n=>n.outcome==="failed").map(n=>`extension_migration_failed:${n.layer}:${n.extension}:${n.id}`)}function qr(e,t,n){let o=typeof t.author=="string"&&t.author.trim()?t.author.trim():"pm-extension";return Sa(e,ei.forActiveExtensionHost({pmRoot:e,author:o}),o,_(n))}async function Hr(e,t,n,o=[]){let a=E(e),i=Jn(e.args.map(String),o),r={...t},s={...n},l=T(process.cwd(),n.path),c=await gt({command:a,args:i,options:r,global:s,pm_root:l});n.profile&&c.warnings.length>0&&w(`profile:extensions parser_warnings=${q(c.warnings)}`),i=c.context.args,r=c.context.options,s=c.context.global,fo(P.get(_(a)),i,r,o),Ce(void 0),ut({command:a,args:i,options:{...r},global:{...s},pm_root:l});let d=await nn({command:a,args:i,options:r,global:s,pm_root:l,sdk:qr(l,s,a)});if(s.profile&&d.warnings.length>0&&w(`profile:extensions command_handler_warnings=${q(d.warnings)}`),!d.handled){if(d.warnings.length>0){let m=d.warnings[0],p=d.errorMessage?.trim(),u=p?` ${p}`:"";throw new b(`Command "${a}" failed in extension handler (${m}).${u}`,f.GENERIC_FAILURE,{code:d.errorCode??"command_failed",nextSteps:d.remediation?[d.remediation]:void 0})}throw new b(`Command "${a}" is provided by extensions and is not currently available.`,f.NOT_FOUND)}return d.exitCode!==void 0&&(process.exitCode=d.exitCode),Ce(d.result),d.result}var _r=Symbol("pm.wrappedActionHandler");function sd(e,t){let n=e[e.length-1];return n instanceof No?n:t}function vr(e,t,n){e&&n.length>0&&w(`profile:extensions ${t}=${q(n)}`)}function ld(e){let t=P.get(_(e.commandPath));if(!t||!po(e.activeRegistrations,e.commandPath))return;let n=Ht(t).length===0?er(e.commandArgs):Jn(e.commandArgs,e.extensionFlagDefinitions);uo(t,n)}function cd(e,t,n){e.args=[...n],"_processArguments"in e&&typeof e._processArguments=="function"&&e._processArguments(),t.length>0&&Array.isArray(t[0])&&(t[0]=[...e.processedArgs])}function zr(e){let t=n=>{let o=n;if(typeof o._actionHandler=="function"&&o[_r]!==!0){let a=o._actionHandler;o._actionHandler=async function(...i){let r=sd(i,n),s=Date.now();hn(r);let l=Be(r),c=O(E(r));if(["package inventory","packages inventory","extension inventory"].includes(c))return await a.apply(this,i);let d=T(process.cwd(),l.path),m=r.args.map(String),p=se(),u=p?at(p,c,m):[],g=await Nr(c,d),h=$e(r,m,[...u,...g]),v=await gt({command:c,args:m,options:h,global:l,pm_root:d});vr(l.profile,"parser_warnings",v.warnings),m=v.context.args,h=v.context.options,ie(r,h),l=v.context.global,ld({activeRegistrations:p,commandPath:c,commandArgs:m,extensionFlagDefinitions:u}),l=await Ya(l),kt(r,l),cd(r,i,m),xt(r,h),Ce(void 0),ut({command:c,args:m,options:{...h},global:{...l},pm_root:d});let A=await nn({command:c,args:m,options:h,global:l,pm_root:d,sdk:qr(d,l,c)});if(vr(l.profile,"command_handler_warnings",A.warnings),A.handled){Ce(A.result),an(A.result,{...l,command:c,commandArgs:m,commandOptions:h,pmRoot:d}),l.profile&&w(`profile:command=${c} took_ms=${Date.now()-s}`);return}return await a.apply(this,i)},o[_r]=!0}for(let a of n.commands)t(a)};t(e)}async function Gt(e){P=new Map,te({overrides:[]}),e&&await Mo(e.rootProgram,e.pmRoot,e.invocationArgv,Ko(),e.settings)}function dd(e,t,n,o){if(t?.flags&&t.flags.length>0){zn(e,t.flags);let a=Gn(e,t.flags);a&&e.addHelpText("after",a)}else n&&e.addHelpText("after",n);o&&e.addHelpText("after",o)}function Gr(e,t,n){let o={core:0,standard:1,full:2,internal:3},a=(i,r)=>{let s=r.join(" "),l=[...n.entries()].filter(([d])=>d===s||d.startsWith(`${s} `)).map(([,d])=>d),c=l.length===0?"standard":l.reduce((d,m)=>o[m.tier]<o[d]?m.tier:d,"internal");St(i,c);for(let d of i.commands)a(d,[...r,d.name()])};for(let i of e.commands)t.has(i.name())||a(i,[i.name()])}async function Wr(e,t){let n=U(t),o=T(process.cwd(),n.path);if(n.noExtensions){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t});return}let a=await Jt(o),i=Ie(t);if(!a){await Gt();return}if(!nt(a.discovery,i)){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t,settings:a.settings}),Kt(Fo(t),a,i);return}let r=await Ne(o,i);if(!r){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t,settings:a.settings});return}te(r.services),P=new Map(r.commandDescriptors),await Mo(e,o,t,r.registrations,r.settings);let s=Vi(e,r.commandHandlers,r.commandDescriptors,r.commandAliases,d=>Bi(r.activationWarnings,w,d)),l=new Set(e.commands.map(d=>d.name())),c=d=>{let m=d.split(" ").filter(L=>L.length>0),p=r.commandDescriptors.get(d),u=ee(e,m),g=r.commandFlagHelp.get(d),h=p?Gi(p):null;if(u){dd(u,p,g,h);return}let v=Wi(e,m);p?.description&&v.description(p.description);let A=g;p&&(Li(v,p),p.flags.length>0&&(zn(v,p.flags),A=Gn(v,p.flags)??void 0)),A&&v.addHelpText("after",A),h&&v.addHelpText("after",h),v.allowUnknownOption(!0).allowExcessArguments(!0).action(async(...L)=>{let G=L[L.length-1],j=G instanceof No?G:v,ve=Be(j),Yt=Date.now(),dt=at(r.registrations,d,j.args.map(String)),De=$e(j,j.args.map(String),dt),be=await Hr(j,De,ve,dt);await Xa(ve,be),an(be,{...ve,command:d,commandArgs:j.args.map(String),commandOptions:De,pmRoot:o}),ve.profile&&w(`profile:command=${d} took_ms=${Date.now()-Yt}`)})};for(let d of s)c(d);Gr(e,l,r.commandDescriptors)}var lt=zo(import.meta.url,["../.."])??"0.0.0",y=rn(lt);async function br(e){if(!F)return;let t=Reflect.get(e,Er);typeof t=="string"&&await Qa(t)}async function Cr(e,t,n){let o=E(e);return["item mutate","item complete"].includes(o)&&e.optsWithGlobals().dryRun===!0?t:n()}function Vr(e,t){t&&it(t)||(e.hook("preAction",async(n,o)=>{Pe=null,F=null,ft(),hn(o);let a=o.optsWithGlobals(),i=Be(o),r=O(E(o)),s=o.args.map(String),l=$e(o,s),c={...i};fa(r,{...l,outputInclude:a.outputInclude,outputLimit:a.outputLimit,outputBudget:a.outputBudget,outputFormat:a.outputFormat,outputSession:a.outputSession,outputCursor:a.outputCursor}),mo(o,r,c,l),await Cr(o,void 0,()=>qa(r,c));let d=T(process.cwd(),i.path),m=await Lr(o);if(!m){Pe=ea({commandName:r,commandArgs:s,commandOptions:l,globalOptions:c,pmRoot:d}),F=await gn({command:r,pm_version:lt,args:s,options:l,global:c,pm_root:d}),await br(e),pn(r,s,l,{source_context:F?.source_context,source_context_source:F?.source_context_source}),un(r),await Qn(r,l,d,$o()),await Zn(r,s,l,c,d);return}ta(m.hooks),na(m.commands),oa(m.parsers),aa(m.preflight),te(m.services),ia(m.renderers),ra(m.registrations);let p=at(m.registrations,r,s);l=$e(o,s,p),mo(o,r,c,l);let u=await gt({command:r,args:s,options:l,global:c,pm_root:m.pmRoot});c.profile&&u.warnings.length>0&&w(`profile:extensions parser_warnings=${q(u.warnings)}`),s=u.context.args,l=u.context.options,ie(o,l),c=u.context.global,xt(o,l);let g=await ca({command:r,args:s,options:l,global:c,pm_root:m.pmRoot,decision:$o()});c.profile&&g.warnings.length>0&&w(`profile:extensions preflight_warnings=${q(g.warnings)}`),s=g.context.args,l=g.context.options,ie(o,l),c=g.context.global,xt(o,l);let h=g.decision;await Qn(r,l,m.pmRoot,h),await Zn(r,s,l,c,m.pmRoot);let v=h.run_extension_migrations?await Cr(o,[],()=>Ur(m.registrations.migrations,m.pmRoot)):[];c.profile&&v.length>0&&w(`profile:extensions migration_warnings=${q(v)}`);let A=dr(m.registrations.migrations);Pe={hooks:m.hooks,commandName:r,commandArgs:s,commandOptions:{...l},globalOptions:{...c},pmRoot:m.pmRoot,profileEnabled:!!c.profile,migrationBlockers:A},Ce(void 0),ut({command:r,args:s,options:{...l},global:{...c},pm_root:m.pmRoot}),F=await gn({command:r,pm_version:lt,args:s,options:l,global:c,pm_root:m.pmRoot}),await br(e),pn(r,s,l,{source_context:F?.source_context,source_context_source:F?.source_context_source}),un(r);let L=await Xo(m.hooks,{command:r,args:s,options:{...l},global:{...c},pm_root:m.pmRoot});c.profile&&L.length>0&&w(`profile:extensions hook_warnings=${q(L)}`),h.enforce_mandatory_migration_gate&&mr(r,l,A)}),e.hook("postAction",async()=>{let n=Ao();Ge(n.ok,n.error,{error_code:n.error_code,error_category:n.error_category,exit_code:n.exit_code,command_resolution:n.command_resolution,resolution_stage:n.resolution_stage}),await ct(n)}))}Vr(y);var xr=Symbol("pmCliIdempotentTopLevelRegistration");function Br(e){let t=e;if(t[xr])return;t[xr]=!0;let n=e.command.bind(e);e.command=((o,...a)=>{let i=o.split(/\s+/u)[0];return e.commands.some(r=>r.name()===i||r.aliases().includes(i))?new No(i):n(o,...a)})}async function md(e,t){if(Br(e),t.setup){let{registerSetupCommands:n}=await Zc();n(e)}if(t.listQuery){let{registerListQueryCommands:n}=await Qc(),o=typeof t.targetCommandName=="string"&&go.has(t.targetCommandName)?new Set([t.targetCommandName]):void 0;n(e,o?{commandFilter:o}:void 0)}if(t.mutation){let{registerMutationCommands:n}=await ed();n(e,{targetCommandName:t.targetCommandName})}if(t.operation){let{registerOperationCommands:n}=await td();n(e)}}function pd(e){return async t=>{let n=mt(t.errorCode),o=bt({ok:!1,errorCode:t.errorCode,errorCategory:n});return await za({command:t.command,args:e.invocationArgv,options:t.options,global:e.bootstrapGlobal,pm_version:lt,pm_root:e.bootstrapPmRoot,error_code:t.errorCode,error_message:t.errorMessage,exit_code:t.exitCode,error_category:n,command_resolution:o,resolution_stage:t.resolutionStage}),{errorCategory:n,commandResolution:o}}}async function Kr(e){if(e.bootstrapGlobal.noExtensions||it(e.invocationArgv))return;let t=Ie(e.invocationArgv),n=await Jt(e.bootstrapPmRoot);if(n&&nt(n.discovery,t)){let o=await Ne(e.bootstrapPmRoot,t);Jr(o);return}n&&Kt(Fo(e.invocationArgv),n,t),te({overrides:[]})}function Jr(e){if(!e){te({overrides:[]});return}te(e.services)}async function jo(e){Ge(!1,e.errorMessage,{error_code:e.classificationCode,error_category:e.errorCategory,exit_code:e.exitCode,command_resolution:e.commandResolution,resolution_stage:e.resolutionStage}),await ct({ok:!1,error:e.errorMessage,exit_code:e.exitCode,error_code:e.classificationCode,error_category:e.errorCategory,command_resolution:e.commandResolution,resolution_stage:e.resolutionStage})}async function Yr(){Ge(!0,void 0,{exit_code:f.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),await ct({ok:!0,exit_code:f.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),process.exitCode=f.SUCCESS}async function Xr(e,t){let n=typeof t=="number"&&Number.isFinite(t);if(!(e.error instanceof b)&&(cn(e.error)||!n))return!1;let o=de(e.error),a=e.error instanceof b?e.error.exitCode:ln(t),i=e.error instanceof b?e.error.context:void 0,r=Ar(i,e.invocationArgv,o),s=bi(o,r),l=e.bootstrapGlobal.lean?Tt(Nn(o,a,r)):Nn(o,a,r),c=e.jsonErrors?JSON.stringify(e.bootstrapGlobal.tokenAccounting?ce(l,u=>`${JSON.stringify(u,null,2)}
|
|
33
|
+
`)}function sr(e,t,n){let o=x(n);if(o!=="create"&&o!=="update")return;let a=Ze(e,o);a&&a.addHelpText("after",_c(o,t,n))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="714821f9-dd8f-5958-a751-29e8dfc06471")}catch{}})();function vc(e,t){return Me(e.id)||`migration-${String(t+1).padStart(3,"0")}`}function bc(e){return Me(e.status)?.toLowerCase()??"pending"}function Cc(e){return e.mandatory===!0}function xc(e,t){let n=e.layer.localeCompare(t.layer);if(n!==0)return n;let o=e.name.localeCompare(t.name);return o!==0?o:e.id.localeCompare(t.id)}function dr(e){let t=[];return e.forEach((n,o)=>{if(!Cc(n.definition))return;let a=bc(n.definition);a!=="applied"&&t.push({layer:n.layer,name:n.name,id:vc(n.definition,o),status:a})}),t.sort(xc),t}function lr(e){return Array.isArray(e)&&e.length>0}var kc=new Set(["create","beads import","todos import"]),Ec=new Set(["restore","update","close","delete","append","claim","release"]),Sc=new Set(["comments","notes","learnings"]),Ac=new Set(["files","docs","test"]),Oc=new Set(["activate","add","add-field","add-status","add-type","apply","compact","create","deactivate","delete","disable","edit","enable","import","infer","install","materialize","migrate","redact","remove","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type","repair","run","save","set","unset","update","upgrade"]);function Xn(e,t){let n=t.force===!0;return kc.has(e)?{isMutation:!0,forceCapable:!1,forceRequested:!1}:Ec.has(e)?{isMutation:!0,forceCapable:!0,forceRequested:n}:Sc.has(e)?{isMutation:typeof t.add=="string",forceCapable:!0,forceRequested:n}:Ac.has(e)?{isMutation:lr(t.add)||lr(t.remove),forceCapable:!0,forceRequested:n}:{isMutation:!1,forceCapable:!1,forceRequested:!1}}function Tc(e,t,n){if(Xn(e,n).isMutation)return!0;let o=e.trim().toLowerCase();return ja(o)?["close-many","close-task","copy","delete","discover","focus","pause-task","start-task","update-many"].includes(o)?!0:t.some(a=>Oc.has(a.trim().toLowerCase())):!1}function cr(e){return(e??"in_progress").trim().toLowerCase().replaceAll("-","_")}function Rc(e,t,n){let o=t[0]?.trim().toLowerCase()??"";if(e.trim().toLowerCase()!=="schema"||!["rename-type","rename-field","remap-status"].includes(o))return;let a=[];if(Me(t[1])||a.push("source"),Me(n.to)||a.push("--to"),a.length!==0)throw new b(`Schema migration requires ${a.join(", ")}.`,f.USAGE,{code:"schema_migration_input_required",required:a.join(","),why:"Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",recovery:{recovery_mode:"compact",missing_required_fields:a,suggested_flags:a.filter(i=>i.startsWith("--")),suggested_retry:`pm schema ${o} <source> --to <target>`}})}async function Ic(e,t,n,o,a){if(e.trim().toLowerCase()!=="update"||typeof n.status!="string"||cr(n.status)!==cr(a.schema.workflow.in_progress_status))return;let i=t[0];if(!i)return;let r=re(a,se()),s=await wt(o,i,a.id_prefix,a.item_format,r.type_to_folder);if(!s)return;let l=await Ea(s,{schema:a.schema}),c=typeof n.assignee=="string"?n.assignee.trim():void 0;(c===void 0?l.document.metadata.assignee?.trim():!["","none","null","undefined"].includes(c.toLowerCase())&&c)||w(`warning:in_progress_item_unclaimed:${s.id}:claim_with=pm claim ${s.id}`)}async function Zn(e,t,n,o,a){if(!Tc(e,t,n)||(Rc(e,t,n),!await K(J(a))))return;let i=await ke(a);o.json!==!0&&await Ic(e,t,n,a,i.settings);let r=La({author:ht(o.author,i.settings.author_default),payload:{command:e,args:t,options:n},settings:i.settings.mutation_guard,force:o.force===!0||n.force===!0});for(let s of r.warnings)w(`warning:${s}`)}function mr(e,t,n){if(n.length===0)return;let o=Xn(e,t);if(!o.isMutation||o.forceCapable&&o.forceRequested)return;let a=n.map(r=>`extension_migration_blocking:${r.layer}:${r.name}:${r.id}:${r.status}`),i=o.forceCapable?"Re-run this command with --force to bypass.":"This command path does not support --force bypass.";throw new b(`Write command "${e}" blocked by unresolved mandatory extension migrations (${a.join(",")}). ${i}`,f.CONFLICT)}async function Qn(e,t,n,o){if(!Xn(e,t).isMutation||!o.enforce_item_format_gate&&!o.run_preflight_item_format_sync||!await K(J(n)))return;let{settings:a,metadata:i,warnings:r}=await ke(n);for(let s of r)w(`warning:${s}`);if(o.enforce_item_format_gate&&!i.has_explicit_item_format&&(xa(a),await ka(n,a,"item_format:auto_select_default")),o.run_preflight_item_format_sync){let s=re(a,se());await Ua(n,a.item_format,"item_format:pre_mutation_sync",s.type_to_folder,a.schema)}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="c0826cb1-5181-51b3-9ad9-0cd7a3d2c4b3")}catch{}})();function eo(e){let t=[];for(let n of e??[]){if(n.startsWith("-"))break;let o=_(n);o.length!==0&&t.push(o)}return t}function Re(e){let t=_(e.commandPath??"");if(t.length===0)return[];let n=[t],o=t.split(" ").filter(a=>a.length>0);for(let a of eo(e.commandArgs))o.push(...a.split(" ").filter(i=>i.length>0)),n.push(o.join(" "));return[...new Set(n.flatMap(a=>[a,O(a)]))]}function to(e,t){let n=_(e);if(n.length===0)return!1;let o=Re(t);for(let a of o)if(a===n||a.startsWith(`${n} `))return!0;return t.allowCommandPrefixMatch===!0?o.some(a=>n.startsWith(`${a} `)):!1}function Ft(e){let t=e.activation?.commands;if(t)return t;let n=e.contributions;return n?[...R(n.commands),...R(n.command_handlers),...R(n.command_overrides),...R(n.flag_commands),...R(n.parser_overrides),...pr(n.preflight_ownership),...pr(n.renderer_ownership)]:[]}function R(e){return e??[]}function pr(e){return R(e).flatMap(t=>t.commands)}function tt(e){return new Set((e.capabilities??[]).map(t=>t.trim().toLowerCase()))}var ur=new Set(["hooks","parser","preflight","renderers"]),fr=new Set(["commands","schema","services","importers"]),$c=new Set(["reindex","search","search-advanced"]),Pc=new Set(["--template"]);function Te(e,t){for(let n of t)if(e.has(n))return!0;return!1}function no(e){let t=_(e??"");if(t.length===0)return!1;let[n]=t.split(" ");return $c.has(n??t)}function oo(e,t){for(let n of e.commandArgs??[]){if(!n.startsWith("--"))continue;let[o]=n.split("=",1);if(t.has(o))return!0}return!1}function Lt(e){return _(e.commandPath??"")==="create"&&oo(e,Pc)}function ao(e){return e.some(t=>{let n=_(t);return n==="templates"||n.startsWith("templates ")})}function Mt(e,t){return e.some(n=>to(n,t))||Lt(t)&&ao(e)}function io(e){return[R(e.hooks).length,(e.preflight_overrides??0)-R(e.preflight_ownership).length,R(e.item_types).length,R(e.item_fields).length,R(e.relationship_kinds).length,R(e.service_overrides).length,R(e.assurance_providers).length,R(e.renderer_overrides).length-R(e.renderer_ownership).length].some(t=>t>0)}function ro(e,t){let n=e.activation?.commands??[];if(n.length>0)return Mt(n,t);let o=Ft(e);if(Mt(o,t)||tt(e).has("search")&&no(t.commandPath))return!0;if(e.contributions)return io(e.contributions)}function jt(e,t){let n=ro(e,t);if(n!==void 0)return n;let o=tt(e);return!!(Te(o,ur)||Te(o,fr))}function nt(e,t){return e.effective.length===0?!1:ot(t)!=="all"?e.effective.some(n=>jt(n,t)):e.effective.some(n=>{let o=tt(n);return Ft(n).length>0||Te(o,ur)||Te(o,fr)||o.has("search")})}function ot(e){if(_(e.commandPath??"").split(" ")[0]==="completion")return"all";let t=Re(e).filter(o=>o.split(" ").every(a=>!a.startsWith("-"))).sort((o,a)=>a.length-o.length)[0]??_(e.commandPath??"");if(t.length===0)return"all";let n=Lt(e)?"--template":"";return`${e.allowCommandPrefixMatch===!0?"prefix":"exact"}:${t}:${n}`}function so(e){return ot(e)==="all"?void 0:t=>jt(t,e)}function Ie(e){let t=S(e);if(t.requested&&t.commandPathTokens.length>0){let[a,...i]=t.commandPathTokens;return{commandPath:a,commandArgs:i,allowCommandPrefixMatch:!0}}let n=D(e),o=n.findIndex(a=>a.trim().length>0&&!a.startsWith("-"));return o<0?{}:{commandPath:n[o],commandArgs:n.slice(o+1),allowCommandPrefixMatch:t.requested}}function lo(e){let t=e.args.map(String);if(_(E(e))==="create"){let n=e.optsWithGlobals();typeof n.template=="string"&&n.template.trim().length>0&&t.push("--template")}return t}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2fe1a4e5-3c55-5ec3-a729-2216a298c081")}catch{}})();var Ut=Symbol.for("pm.readOutputInvocationProvenance");function ie(e,t){let n=Reflect.get(e,Ut);n!==void 0&&Reflect.set(t,Ut,n)}function co(e,t,n){let o=ua(t,n);if(!o)return;let a=e;for(;a.parent;)a=a.parent;let i=a.rawArgs,r=new Set(X(i.slice(2))),s=pa.find(d=>d.command===o),l=Object.values(s.dimensions).flatMap(d=>d.legacy_aliases.flatMap(m=>r.has(m.flag)?[m.flag]:[])),c=Reflect.get(n,Ut);Reflect.set(n,Ut,{canonical_include_modes:c?.canonical_include_modes??[],explicit_legacy_aliases:l,cli_invocation_observed:!0}),ie(n,e)}function Nc(e){let t=e.optsWithGlobals(),n=E(e);if(O(n)===n)return t;let o=e.opts();for(let a=e.parent;a?.parent;a=a.parent)for(let i of a.options){let r=i.attributeName(),s=a.getOptionValueSource(r)==="cli";if(s&&!e.options.some(l=>l.long===i.long))throw new b(`Unknown option '${i.long}' for ${n}`,f.USAGE,{code:"unknown_option",flag:i.long,required:`Use options declared by pm ${n} --help.`});if(s&&e.getOptionValueSource(r)!=="cli"){let l=a.getOptionValue(r);e.setOptionValueWithSource(r,l,"cli")}r in o?t[r]=o[r]:delete t[r]}return t}function mo(e,t,n,o){co(e,t,o);let a=n.outputInclude;if(a===void 0)return;let{selectors:i,modes:r}=ha(t,a,o);if(t==="get"&&typeof o.fields=="string"&&e.setOptionValueWithSource("fields",o.fields,"cli"),r.length===0)return;ie(o,e);let s=ga(t);for(let c of r){let d=s.get(c),m=o[d];e.setOptionValueWithSource(d,m,"cli")}let l=i.length>0?i.join(","):void 0;l===void 0?delete n.outputInclude:n.outputInclude=l;for(let c=e;c;c=c.parent)c.setOptionValueWithSource("outputInclude",l,"cli");kt(e,n)}function $e(e,t,n=[]){let o={...Nc(e)};ie(e,o),delete o.json,delete o.quiet,delete o.path,delete o.pmPath,delete o.noExtensions,delete o.extensions,delete o.profile,delete o.pager,delete o.changedFields,delete o.fullChangedFields,delete o.idOnly,delete o.lean,delete o.tokenAccounting,delete o.outputInclude,delete o.outputLimit,delete o.outputBudget,delete o.outputFormat,delete o.outputSession;let a=Qi(t);for(let[i,r]of Object.entries(a))o[i]===void 0&&(o[i]=r);if(n.length>0){let i=Yi(n),r=ne(E(e)).map(c=>({long:c.flag,short:c.short,aliases:c.aliases})),s={...a};for(let c of i)o[c]!==void 0&&(s[c]=o[c]);Kn(s,[...r,...n],E(e));let l=Zi(o,n,a);return ie(o,l),l}return o}function qt(e,t){let n=_(t);return n.length===0?[]:e.flags.filter(o=>O(_(o.target_command))===O(n)).flatMap(o=>o.flags)}function at(e,t,n){let o=qt(e,t),a=[t],i=[];for(let r of n){if(r.startsWith("-"))break;a.push(r);let s=qt(e,a.join(" "));s.length>0&&(i=s)}return i.length>0?i:o}function Ht(e){return e.arguments??[]}function gr(e){let t=Ht(e).map(n=>{let o=n.variadic?`${n.name}...`:n.name;return n.required?`<${o}>`:`[${o}]`}).join(" ");return`pm ${e.command}${t?` ${t}`:""}`}function po(e,t){if(!e)return!1;let n=_(t);return e.importers.some(o=>_(`${o.importer} import`)===n)||e.exporters.some(o=>_(`${o.exporter} export`)===n)}function uo(e,t){let n=Ht(e),o=n.filter(s=>s.required).length,a=n.some(s=>s.variadic)?Number.POSITIVE_INFINITY:n.length,i=e.failure_hints??[],r=i.length>0?` ${i.join(" ")}`:"";if(t.length<o)throw new b(`Missing required argument for extension command '${e.command}'. Usage: ${gr(e)}${r}`,f.USAGE);if(t.length>a){let s=t.slice(a).join(" ");throw new b(`Too many arguments for extension command '${e.command}': ${s}. Usage: ${gr(e)}${r}`,f.USAGE)}}function Dc(e){return`--${e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/_/g,"-").toLowerCase()}`}function Mc(e,t,n){if(n.length>0){Kn(t,n,e.command);return}let o=Object.keys(t).filter(a=>t[a]!==void 0).sort();if(o.length!==0)throw new b(`Unknown option '${o.map(Dc).join(", ")}' for extension command '${e.command}'. This command does not define extension flags.`,f.USAGE)}function fo(e,t,n,o){e&&(uo(e,t),Mc(e,n,o))}import{Command as hr}from"commander";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="0503f6e5-36d9-5afb-a17f-feef2241f984")}catch{}})();var Fc=new Set(["--version","-V"]);function it(e){let t=D(e);return["package","packages","extension"].includes(t[0]??"")&&t[1]==="inventory"}function yr(e){if(D(e)[0]!=="item"||!e.includes("--dry-run"))return;let t=new hr().configureOutput({writeErr:()=>{}}).exitOverride(),n=new Set;for(let a of He)for(let i of[a.flag,a.short,...a.aliases??[]]){if(i===void 0||n.has(i))continue;n.add(i);let r=a.value_name!==void 0||a.flag==="--pm-path";t.option(`${i}${r?" <value>":""}`)}try{t.parseOptions(e)}catch{}let o=t.opts();return{path:o.pmPath??o.path}}var Lc=new Set(["config","extension","init","install","package","packages","templates","upgrade"]),go=new Set(["activity","aggregate","context","ctx","events","get","graph","history","list","list-all","list-blocked","list-canceled","list-closed","list-draft","list-in-progress","list-open","search"]),wr=new Set(["append","close","close-many","comments","delete","deps","discover","docs","files","history-repair","history-redact","history-compact","learnings","notes","plan","restore","update","update-many","create"]),jc=new Set(["claim","close-task","contracts","duplicates","gc","health","pause-task","release","start-task","stats","test","test-all","test-runs","test-runs-worker","validate"]),Uc=new Set(["claim","close-task","pause-task","release","start-task","test"]),ye={setup:!0,listQuery:!0,mutation:!0,operation:!0},qc=new Set(["create","update","update-many","list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled","search","calendar","context","templates"]);function rt(e){return e.some(t=>Fc.has(t))}function Hc(e,t){if(!I.some(o=>o.canonical_argv[0]===t))return;let n=new hr().configureOutput({writeErr:()=>{}}).exitOverride();for(let o of Ga(t,ne(t))){let a=o.takes_value?o.value_required?" <value>":" [value]":"";for(let i of[o.flag,o.short,...o.aliases??[]])i!==void 0&&n.option(`${i}${a}`)}try{let o=n.parseOptions(e.slice(1));if(o.unknown.length>0)return ye;let a=W([t,...o.operands])?.alias;if(I.some(i=>i.alias===a))return{...ye,targetCommandName:a}}catch{return ye}}function ho(e){if(rt(e))return{setup:!1,listQuery:!1,mutation:!1,operation:!1};if(e.length===0||S(e).requested)return ye;let t=x(e);if(!t)return ye;let n=t.trim().toLowerCase(),o=D(e),a=W(o)?.alias;return I.some(i=>i.alias===a)?{...ye,targetCommandName:a}:Hc(o,n==="ctx"?"context":n)||(Lc.has(n)?{setup:!0,listQuery:!1,mutation:!1,operation:!1,targetCommandName:n}:go.has(n)?{setup:!1,listQuery:!0,mutation:!1,operation:!1,targetCommandName:n}:wr.has(n)?{setup:!1,listQuery:!1,mutation:!0,operation:!1,targetCommandName:n}:jc.has(n)?{setup:!1,listQuery:!1,mutation:!1,operation:!0,targetCommandName:n}:ye)}function yo(e){return e.length===0||S(e).requested||e.includes("--explain")&&x(e)===void 0}function wo(e,t){return it(t)||rt(t)?!1:oe(t)||S(t).requested?!0:!!x(t)}function _o(e){if(rt(e))return!1;let t=x(e);return t?qc.has(t):!1}function zc(e){let t=String(e.rawFrom??""),n=t.indexOf("="),o=n>=0?t.slice(0,n):t,a=e.normalizedTokens.map(c=>{let d=c.indexOf("=");return d>=0?c.slice(0,d):c}).find(c=>c==="--literal"||c==="--regex"||c==="--replacement"),i=a?e.argv.map(c=>{let d=c.indexOf("=");return(d>=0?c.slice(0,d):c)===o?d>=0?`${a}${c.slice(d)}`:a:c}):e.argv,r=je(i),s=a&&n>=0?`${o}=[redacted]`:t,l=a&&e.normalizedDisplay.includes("=")?`${a}=[redacted]`:e.normalizedDisplay;return{argv:r,normalizedDisplay:l,sourceDisplay:s}}function vo(e){let t=e.commandName;if(!t)return;let n=e.trace.find(c=>c.reason==="flag_typo");if(!n)return;let o=Array.isArray(n.to)?n.to:[String(n.to??"")].filter(c=>c.length>0),a=o.length>0?o.join(" "):"the canonical flag",i=wr.has(t)||Uc.has(t),r=i?"mutating_flag_typo_requires_retry":"flag_typo_requires_retry",s=i?"mutating option":"option",l=zc({argv:e.argv,normalizedDisplay:a,normalizedTokens:o,rawFrom:n.from});throw new b(`Refusing to auto-correct ${s} ${l.sourceDisplay} to ${l.normalizedDisplay}. Retry with the canonical flag so the command is explicit.`,f.USAGE,{code:r,examples:[k(l.argv)],nextSteps:["Retry the command with the canonical flag shown in examples."],recovery:{normalized_args:l.argv,suggested_retry:k(l.argv)}})}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="6d83c356-db56-5116-9fe7-e0c27973b36f")}catch{}})();var Gc=new Set(["success","nonexistent_command","invalid_option","missing_required_option","missing_required_argument","invalid_usage","validation_failed","health_findings","validation_findings","conflict","runtime_failed","unknown_failed"]),Wc=new Set(["parse","preflight","execute","unknown"]),Vc=new Set(["usage","validation","conflict","runtime","unknown"]);function we(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="string"){let a=o.trim();if(a.length>0)return a}}}function bo(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="boolean")return o}}function zt(e,...t){if(e)for(let n of t){let o=e[n];if(typeof o=="number"&&Number.isFinite(o))return Math.max(0,Math.trunc(o))}}function Co(e){if(!e)return;let t=e.trim().toLowerCase();if(Gc.has(t))return t}function xo(e){if(!e)return;let t=e.trim().toLowerCase();if(Wc.has(t))return t}function ko(e){if(!e)return;let t=e.trim().toLowerCase();if(Vc.has(t))return t}function Eo(e){let t=we(e,"error","message");if(t)return t;let n=e?.warnings;if(Array.isArray(n)){let i=n.find(r=>typeof r=="string"&&r.trim().length>0);if(typeof i=="string")return i.trim()}if(bo(e,"fail_on_skipped_triggered","failOnSkippedTriggered"))return"linked_test_fail_on_skipped_triggered";let o=zt(e,"failed");if(typeof o=="number"&&o>0)return`failed_runs:${o}`;let a=e?.run_results;if(Array.isArray(a)){let i=a.filter(r=>Zt(r)?.status==="failed").length;if(i>0)return`failed_runs:${i}`}}function So(e,t){if(!e)return t===f.USAGE?"invalid_command_usage":t===f.NOT_FOUND?"item_not_found":t===f.CONFLICT?"lock_conflict":t===f.DEPENDENCY_FAILED?"dependency_failed":"command_failed"}function Ao(){let e=Zt(le()),t=typeof process.exitCode=="number"&&Number.isFinite(process.exitCode)?Math.max(0,Math.trunc(process.exitCode)):void 0,n=zt(e,"exit_code","exitCode"),o=t??n??f.SUCCESS,a=Ka(o),i=we(e,"error_code","errorCode")??So(a,o),r=ko(we(e,"error_category","errorCategory"))??(a?void 0:mt(i)),s=a?void 0:Eo(e)??`command_exit_${o}`,l=Co(we(e,"command_resolution","commandResolution"))??bt({ok:a,errorCode:i,errorCategory:r}),c=xo(we(e,"resolution_stage","resolutionStage"))??"execute";return{ok:a,error:s,exit_code:o,error_code:i,error_category:r,command_resolution:l,resolution_stage:c}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2309d6a4-a061-51d8-be5e-5e1dd62e9b3e")}catch{}})();var Oo="PM_CLI_PACKAGE_ROOT",Er=Symbol("pm.deprecatedAliasInvocation"),Vt=new Map;for(let e of B){let t=e.alias.split(" ")[0],n=Vt.get(t)??[];n.push(e),Vt.set(t,n)}for(let e of Vt.values())e.sort((t,n)=>n.alias.split(" ").length-t.alias.split(" ").length);function Bc(){return Ho(import.meta.url,["../.."])}(typeof process.env[Oo]!="string"||process.env[Oo]?.trim().length===0)&&(process.env[Oo]=Bc());var Pe=null,F=null;function Kc(e){Pe=e}function Jc(e){P=e}var st=null,_e=null,P=new Map,Do=250,Yc=new Set([f.USAGE,f.NOT_FOUND,f.CONFLICT]),Xc=new Set(["1","true","yes","on"]),Zc=Ve(()=>import("./chunks/register-setup-PFKYNEQI.js")),Qc=Ve(()=>import("./chunks/register-list-query-PYVSPGPV.js")),ed=Ve(()=>import("./chunks/register-mutation-WXP3YLIN.js")),td=Ve(()=>import("./chunks/register-operations-WL25C3NP.js"));function Wt(e){return k(e)}function Sr(e){let t=e.match(/--[a-zA-Z0-9][a-zA-Z0-9_-]*/g);if(!t||t.length===0)return;let n=[...new Set(t.map(o=>pe(o)??o))];return n.length>0?n:void 0}function nd(e,t,n){if(n?.suggested_retry||e.includes("failed in extension handler (")||!/\b(?:missing|required|requires)\b/i.test(e))return;let o=X(t),a=new Set(o.map(d=>pe(d)??d)),i=Sr(e),r=t.find(d=>y.commands.some(m=>m.name()===d)),s=r?y.commands.find(d=>d.name()===r):void 0,l=new Set([...y.options,...s?.options??[]].flatMap(d=>d.flags.split(/[ ,|]+/).map(m=>pe(m)).filter(m=>m!==void 0))),c=i?.filter(d=>{let m=pe(d)??d;return a.has(m)?!1:l.has(m)||Hn(t,r,m,P)!==void 0});return c&&c.length>0?c:void 0}function od(e,t,n,o){if(o?.suggested_retry)return o.suggested_retry;let a=n?.[0],i=a?pe(a):void 0,r=e.find(p=>y.commands.some(u=>u.name()===p)),s=r?y.commands.find(p=>p.name()===r):void 0,l=i?s?.options.find(p=>p.flags.split(/[ ,|]+/).includes(i)):void 0,c=Hn(e,r,i,P),d=i?l?.isBoolean()===!0||c===!1?[i]:[i,"<value>"]:[],m=i?Wt([...e,...d]):t;return m===t?void 0:m}function ad(e){if(!e)return{};let t=["recovery_mode","missing_required_fields","suggested_flags","suggested_retry_args","allowed_values","candidate_commands","candidate_commands_total","candidate_commands_truncated","fallback_candidates","next_best_command"],n={};for(let o of t){let a=e[o];a!=null&&(n[o]=a)}return n}function id(e){let t=e.existingRecovery;return{attempted_command:t?.attempted_command??e.attemptedCommand,normalized_args:t?.normalized_args??[...e.invocationArgv],provided_fields:t?.provided_fields??(e.providedFields.length>0?e.providedFields:void 0),missing:t?.missing??e.inferredMissing,...ad(t),...e.suggestedRetry?{suggested_retry:e.suggestedRetry}:{}}}function Ar(e,t,n){let o=je(t),a=D(o),i=me(a),[r,s]=i===void 0?[]:a.slice(i,i+2),l=o.includes("--explain"),c=ai(o,e?.code,e?.recovery),d=c&&(r==="history-redact"||r==="history"&&s==="redact")?{...c,...c.attempted_command?{attempted_command:Wt(o)}:{},...c.normalized_args?{normalized_args:[...o]}:{},...c.suggested_retry?{suggested_retry:Wt(o)}:{},...c.suggested_retry_args?{suggested_retry_args:[...o]}:{}}:c;if(d?.recovery_mode==="compact"&&!l)return{...e,recovery:d};let m=Wt(o),p=X(o),u=nd(n,o,d),g=od(o,m,u,d),h=id({invocationArgv:o,attemptedCommand:m,providedFields:p,inferredMissing:u,suggestedRetry:g,existingRecovery:d});return{...e,recovery:h}}async function ct(e){let t=F;F=null,await ii(t,e);let n=Pe;if(Pe=null,!n){ft();return}let o=[],a=la();try{await ri({pmRoot:n.pmRoot,author:n.globalOptions.author,itemIds:e.ok?a?.map(i=>i.id)??[]:[],intent:n.commandName})}catch{o.push("context_usage_feedback_write_failed")}try{o.push(...await Zo(n.hooks,{command:n.commandName,args:n.commandArgs,options:{...n.commandOptions},global:{...n.globalOptions},pm_root:n.pmRoot,ok:e.ok,error:e.error,result:le(),affected:a}))}catch(i){o=[`afterCommand hooks failed: ${i instanceof Error?i.message:String(i)}`]}finally{ft()}!n.globalOptions.json&&o.length>0&&w(`[pm] warning: afterCommand hook_warnings=${q(o)}`),n.profileEnabled&&o.length>0&&w(`profile:extensions hook_warnings=${q(o)}`)}async function Or(){await Ma()}function Tr(e){return Xc.has((process.env[e]??"").trim().toLowerCase())}function Rr(e){return Tr("PM_SENTRY_CAPTURE_EXPECTED_ERRORS")?!0:!Yc.has(Math.trunc(e))}async function Bt(e){return Rr(e.exit_code)?(await Or(),Fa(e),!0):!1}async function Ir(e){let t=de(e.error),n=Ei(t);e.bootstrapGlobal.json?w(JSON.stringify(xi(t,f.GENERIC_FAILURE),null,2)):w(t),process.exitCode=f.GENERIC_FAILURE;let o="runtime",a="runtime_failed";try{await Or(),fn(e.error);let i=await e.emitTelemetryCommandError({command:e.attemptedCommand,errorCode:n.code,errorMessage:n.detail,exitCode:f.GENERIC_FAILURE,options:{bootstrap_global_options:e.bootstrapGlobal},resolutionStage:"execute"});o=i.errorCategory,a=i.commandResolution,Ge(!1,t,{error_code:n.code,error_category:o,exit_code:f.GENERIC_FAILURE,command_resolution:a,resolution_stage:"execute"})}catch(i){e.bootstrapGlobal.json||w(`Failed to report error: ${de(i)}`)}try{await ct({ok:!1,error:t,exit_code:f.GENERIC_FAILURE,error_code:n.code,error_category:o,command_resolution:a,resolution_stage:"execute"})}catch(i){e.bootstrapGlobal.json||w(`Failed to run error hooks: ${de(i)}`)}try{await We()}catch(i){e.bootstrapGlobal.json||w(`Failed to flush error reporting: ${de(i)}`)}}var rd={create:"create",update:"update","update-many":"update_many",list:"list","list-all":"list","list-draft":"list","list-open":"list","list-in-progress":"list","list-blocked":"list","list-closed":"list","list-canceled":"list",search:"search",calendar:"calendar",context:"context","templates save":"create"},To=new Map;function Ro(e){return e==="number"?"number":e==="boolean"?"boolean":"string"}function $r(e,t){return e.options.some(n=>n.long===t)}function Pr(e,t){return e.options.some(n=>n.short===t)}function Io(e,t,n,o){let a=t.trim();if(!a)return;let i=n.length>0?n:`Runtime schema field (${t})`;if(a.startsWith("-")&&!a.startsWith("--")){if(Pr(e,a))return;if(o){e.option(`${a} <value>`,`${i} (repeatable)`,yn);return}e.option(`${a} <value>`,i);return}let r=a.startsWith("--")?a:`--${a}`;if(!$r(e,r)){if(o){e.option(`${r} <value>`,`${i} (repeatable)`,yn);return}e.option(`${r} <value>`,i)}}async function Nr(e,t){let n=rd[e];if(!n)return[];let o=`${t}:${n}`,a=To.get(o);if(a)return a;if(!await K(J(t)))return To.set(o,[]),[];let i=await N(t),r=(mn(i.schema).command_to_fields.get(n)??[]).flatMap(s=>[s.cli_flag,...s.cli_aliases].map(l=>({long:`--${l}`,type:Ro(s.type),value_type:Ro(s.type)})));return To.set(o,r),r}async function Dr(e,t){let n=U(t),o=T(process.cwd(),n.path);if(!await K(J(o)))return;let a=_e?.key===Lo(o)?_e.snapshot:null,i=a===null?await N(o):a.settings,r=mn(i.schema),s=[{path:"create",command:"create"},{path:"update",command:"update"},{path:"update-many",command:"update_many"},{path:"list",command:"list"},{path:"list-all",command:"list"},{path:"list-draft",command:"list"},{path:"list-open",command:"list"},{path:"list-in-progress",command:"list"},{path:"list-blocked",command:"list"},{path:"list-closed",command:"list"},{path:"list-canceled",command:"list"},{path:"search",command:"search"},{path:"calendar",command:"calendar"},{path:"context",command:"context"},{path:"templates save",command:"create"}];for(let l of s){let c=ee(e,l.path.split(" "));if(c)for(let d of r.command_to_fields.get(l.command)??[]){let m=d.description??"";Io(c,d.cli_flag,m,d.repeatable);for(let p of d.cli_aliases)Io(c,p,`Alias for --${d.cli_flag}`,d.repeatable)}}}async function Mo(e,t,n,o,a){let i=x(n);if(!(i!=="create"&&i!=="update"))try{let r=a??await N(t),s=re(r,o);sr(e,s,n)}catch{}}function $o(){return{enforce_item_format_gate:!0,run_preflight_item_format_sync:!0,run_extension_migrations:!0,enforce_mandatory_migration_gate:!0}}function Mr(e,t="all"){return t==="all"?`pm-root:${e}`:`pm-root:${e}:activation:${t}`}function Fo(e){return e.some(t=>t==="--profile")}function Lo(e){return`pm-root:${e}`}function Po(e){for(let t of e)t.startsWith("settings_read_")&&w(`[pm] warning: ${t} \u2014 settings.json could not be loaded and pm fell back to defaults; run pm health for remediation.`)}function Fr(e,t){e.profile&&(w(`profile:extensions loaded=${t.loadedCount} failed=${t.loadFailedCount} warnings=${t.loadWarnings.length} activation_failed=${t.activationFailedCount} hook_counts=before:${t.hooks.beforeCommand.length}|after:${t.hooks.afterCommand.length}|write:${t.hooks.onWrite.length}|read:${t.hooks.onRead.length}|index:${t.hooks.onIndex.length} command_overrides=${t.commands.overrides.length} command_handlers=${t.commands.handlers.length} parser_overrides=${t.parsers.overrides.length} preflight_overrides=${t.preflight.overrides.length} service_overrides=${t.services.overrides.length} renderer_overrides=${t.renderers.overrides.length}`),t.activationWarnings.length>0&&w(`profile:extensions activation_warnings=${q(t.activationWarnings)}`))}function Kt(e,t,n){if(!e)return;let o=_(n.commandPath??"")||"<none>";w(`profile:extensions activation=skipped command=${o} effective=${t.discovery.effective.length} warnings=${t.discovery.warnings.length} discovery_ms=${t.discoveryMs}`)}async function Jt(e,t=ke){let n=Lo(e);if(_e?.key===n)return _e.snapshot;try{let o=Date.now(),{settings:a,warnings:i}=await t(e),r=await Qo({pmRoot:e,settings:a,cwd:process.cwd(),noExtensions:!1}),s={pmRoot:e,settings:a,discovery:r,discoveryMs:Date.now()-o,settingsReadWarnings:[...i]};return _e={key:n,snapshot:s},s}catch{return _e={key:n,snapshot:null},null}}async function Ne(e,t,n=N){let o=t?ot(t):"all",a=Mr(e,o);if(st?.key===a)return st.snapshot;try{let i=await n(e),r=await Fe({pmRoot:e,settings:i,cwd:process.cwd(),noExtensions:!1,extensionFilter:t?so(t):void 0}),s=await Le({...r,loaded:r.loaded}),l=[...new Set(s.commands.handlers.map(u=>_(u.command)))].filter(u=>u.length>0).sort((u,g)=>u.localeCompare(g)),c=Di(s.registrations.flags),d=Pi(s.commands.handlers,s.registrations.commands),m=Fi(l,s.registrations.commands,s.registrations.flags,d),p={hooks:s.hooks,commands:s.commands,parsers:s.parsers,preflight:s.preflight,services:s.services,renderers:s.renderers,registrations:s.registrations,pmRoot:e,settings:i,commandHandlers:l,commandFlagHelp:c,commandDescriptors:m,commandAliases:d,loadWarnings:[...r.warnings],activationWarnings:[...s.warnings],loadedCount:r.loaded.length,loadFailedCount:r.failed.length,activationFailedCount:s.failed.length,contextIntentPackages:r.loaded.map(({name:u,module:g})=>({name:u,module:g}))};return st={key:a,snapshot:p},p}catch{return st={key:a,snapshot:null},null}}async function Lr(e){let t=Be(e);if(t.noExtensions){let r=T(process.cwd(),t.path);return await K(J(r))&&Po((await ke(r)).warnings),null}let n=T(process.cwd(),t.path),o=await Jt(n);if(!o)return null;Po(o.settingsReadWarnings);let a={commandPath:E(e),commandArgs:lo(e)};if(!nt(o.discovery,a))return Kt(t.profile,o,a),null;let i=await Ne(n,a);return i?(Fr(t,i),{hooks:i.hooks,commands:i.commands,parsers:i.parsers,preflight:i.preflight,services:i.services,renderers:i.renderers,registrations:i.registrations,pmRoot:n}):null}async function jr(e){let t=await Ne(e);return t?new Map(t.commandDescriptors):P}async function Ur(e,t){return(await Aa({pmRoot:t,migrations:e,author:"pm-extension-migration"})).migrations.filter(n=>n.outcome==="failed").map(n=>`extension_migration_failed:${n.layer}:${n.extension}:${n.id}`)}function qr(e,t,n){let o=typeof t.author=="string"&&t.author.trim()?t.author.trim():"pm-extension";return Sa(e,ei.forActiveExtensionHost({pmRoot:e,author:o}),o,_(n))}async function Hr(e,t,n,o=[]){let a=E(e),i=Jn(e.args.map(String),o),r={...t},s={...n},l=T(process.cwd(),n.path),c=await gt({command:a,args:i,options:r,global:s,pm_root:l});n.profile&&c.warnings.length>0&&w(`profile:extensions parser_warnings=${q(c.warnings)}`),i=c.context.args,r=c.context.options,s=c.context.global,fo(P.get(_(a)),i,r,o),Ce(void 0),ut({command:a,args:i,options:{...r},global:{...s},pm_root:l});let d=await nn({command:a,args:i,options:r,global:s,pm_root:l,sdk:qr(l,s,a)});if(s.profile&&d.warnings.length>0&&w(`profile:extensions command_handler_warnings=${q(d.warnings)}`),!d.handled){if(d.warnings.length>0){let m=d.warnings[0],p=d.errorMessage?.trim(),u=p?` ${p}`:"";throw new b(`Command "${a}" failed in extension handler (${m}).${u}`,f.GENERIC_FAILURE,{code:d.errorCode??"command_failed",nextSteps:d.remediation?[d.remediation]:void 0})}throw new b(`Command "${a}" is provided by extensions and is not currently available.`,f.NOT_FOUND)}return d.exitCode!==void 0&&(process.exitCode=d.exitCode),Ce(d.result),d.result}var _r=Symbol("pm.wrappedActionHandler");function sd(e,t){let n=e[e.length-1];return n instanceof No?n:t}function vr(e,t,n){e&&n.length>0&&w(`profile:extensions ${t}=${q(n)}`)}function ld(e){let t=P.get(_(e.commandPath));if(!t||!po(e.activeRegistrations,e.commandPath))return;let n=Ht(t).length===0?er(e.commandArgs):Jn(e.commandArgs,e.extensionFlagDefinitions);uo(t,n)}function cd(e,t,n){e.args=[...n],"_processArguments"in e&&typeof e._processArguments=="function"&&e._processArguments(),t.length>0&&Array.isArray(t[0])&&(t[0]=[...e.processedArgs])}function zr(e){let t=n=>{let o=n;if(typeof o._actionHandler=="function"&&o[_r]!==!0){let a=o._actionHandler;o._actionHandler=async function(...i){let r=sd(i,n),s=Date.now();hn(r);let l=Be(r),c=O(E(r));if(["package inventory","packages inventory","extension inventory"].includes(c))return await a.apply(this,i);let d=T(process.cwd(),l.path),m=r.args.map(String),p=se(),u=p?at(p,c,m):[],g=await Nr(c,d),h=$e(r,m,[...u,...g]),v=await gt({command:c,args:m,options:h,global:l,pm_root:d});vr(l.profile,"parser_warnings",v.warnings),m=v.context.args,h=v.context.options,ie(r,h),l=v.context.global,ld({activeRegistrations:p,commandPath:c,commandArgs:m,extensionFlagDefinitions:u}),l=await Ya(l),kt(r,l),cd(r,i,m),xt(r,h),Ce(void 0),ut({command:c,args:m,options:{...h},global:{...l},pm_root:d});let A=await nn({command:c,args:m,options:h,global:l,pm_root:d,sdk:qr(d,l,c)});if(vr(l.profile,"command_handler_warnings",A.warnings),A.handled){Ce(A.result),an(A.result,{...l,command:c,commandArgs:m,commandOptions:h,pmRoot:d}),l.profile&&w(`profile:command=${c} took_ms=${Date.now()-s}`);return}return await a.apply(this,i)},o[_r]=!0}for(let a of n.commands)t(a)};t(e)}async function Gt(e){P=new Map,te({overrides:[]}),e&&await Mo(e.rootProgram,e.pmRoot,e.invocationArgv,Ko(),e.settings)}function dd(e,t,n,o){if(t?.flags&&t.flags.length>0){zn(e,t.flags);let a=Gn(e,t.flags);a&&e.addHelpText("after",a)}else n&&e.addHelpText("after",n);o&&e.addHelpText("after",o)}function Gr(e,t,n){let o={core:0,standard:1,full:2,internal:3},a=(i,r)=>{let s=r.join(" "),l=[...n.entries()].filter(([d])=>d===s||d.startsWith(`${s} `)).map(([,d])=>d),c=l.length===0?"standard":l.reduce((d,m)=>o[m.tier]<o[d]?m.tier:d,"internal");St(i,c);for(let d of i.commands)a(d,[...r,d.name()])};for(let i of e.commands)t.has(i.name())||a(i,[i.name()])}async function Wr(e,t){let n=U(t),o=T(process.cwd(),n.path);if(n.noExtensions){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t});return}let a=await Jt(o),i=Ie(t);if(!a){await Gt();return}if(!nt(a.discovery,i)){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t,settings:a.settings}),Kt(Fo(t),a,i);return}let r=await Ne(o,i);if(!r){await Gt({rootProgram:e,pmRoot:o,invocationArgv:t,settings:a.settings});return}te(r.services),P=new Map(r.commandDescriptors),await Mo(e,o,t,r.registrations,r.settings);let s=Vi(e,r.commandHandlers,r.commandDescriptors,r.commandAliases,d=>Bi(r.activationWarnings,w,d)),l=new Set(e.commands.map(d=>d.name())),c=d=>{let m=d.split(" ").filter(L=>L.length>0),p=r.commandDescriptors.get(d),u=ee(e,m),g=r.commandFlagHelp.get(d),h=p?Gi(p):null;if(u){dd(u,p,g,h);return}let v=Wi(e,m);p?.description&&v.description(p.description);let A=g;p&&(Li(v,p),p.flags.length>0&&(zn(v,p.flags),A=Gn(v,p.flags)??void 0)),A&&v.addHelpText("after",A),h&&v.addHelpText("after",h),v.allowUnknownOption(!0).allowExcessArguments(!0).action(async(...L)=>{let G=L[L.length-1],j=G instanceof No?G:v,ve=Be(j),Yt=Date.now(),dt=at(r.registrations,d,j.args.map(String)),De=$e(j,j.args.map(String),dt),be=await Hr(j,De,ve,dt);await Xa(ve,be),an(be,{...ve,command:d,commandArgs:j.args.map(String),commandOptions:De,pmRoot:o}),ve.profile&&w(`profile:command=${d} took_ms=${Date.now()-Yt}`)})};for(let d of s)c(d);Gr(e,l,r.commandDescriptors)}var lt=zo(import.meta.url,["../.."])??"0.0.0",y=rn(lt);async function br(e){if(!F)return;let t=Reflect.get(e,Er);typeof t=="string"&&await Qa(t)}async function Cr(e,t,n){let o=E(e);return["item mutate","item complete"].includes(o)&&e.optsWithGlobals().dryRun===!0?t:n()}function Vr(e,t){t&&it(t)||(e.hook("preAction",async(n,o)=>{Pe=null,F=null,ft(),hn(o);let a=o.optsWithGlobals(),i=Be(o),r=O(E(o)),s=o.args.map(String),l=$e(o,s),c={...i};fa(r,{...l,outputInclude:a.outputInclude,outputLimit:a.outputLimit,outputBudget:a.outputBudget,outputFormat:a.outputFormat,outputSession:a.outputSession,outputCursor:a.outputCursor}),mo(o,r,c,l),await Cr(o,void 0,()=>qa(r,c));let d=T(process.cwd(),i.path),m=await Lr(o);if(!m){Pe=ea({commandName:r,commandArgs:s,commandOptions:l,globalOptions:c,pmRoot:d}),F=await gn({command:r,pm_version:lt,args:s,options:l,global:c,pm_root:d}),await br(e),pn(r,s,l,{source_context:F?.source_context,source_context_source:F?.source_context_source}),un(r),await Qn(r,l,d,$o()),await Zn(r,s,l,c,d);return}ta(m.hooks),na(m.commands),oa(m.parsers),aa(m.preflight),te(m.services),ia(m.renderers),ra(m.registrations);let p=at(m.registrations,r,s);l=$e(o,s,p),mo(o,r,c,l);let u=await gt({command:r,args:s,options:l,global:c,pm_root:m.pmRoot});c.profile&&u.warnings.length>0&&w(`profile:extensions parser_warnings=${q(u.warnings)}`),s=u.context.args,l=u.context.options,ie(o,l),c=u.context.global,xt(o,l);let g=await ca({command:r,args:s,options:l,global:c,pm_root:m.pmRoot,decision:$o()});c.profile&&g.warnings.length>0&&w(`profile:extensions preflight_warnings=${q(g.warnings)}`),s=g.context.args,l=g.context.options,ie(o,l),c=g.context.global,xt(o,l);let h=g.decision;await Qn(r,l,m.pmRoot,h),await Zn(r,s,l,c,m.pmRoot);let v=h.run_extension_migrations?await Cr(o,[],()=>Ur(m.registrations.migrations,m.pmRoot)):[];c.profile&&v.length>0&&w(`profile:extensions migration_warnings=${q(v)}`);let A=dr(m.registrations.migrations);Pe={hooks:m.hooks,commandName:r,commandArgs:s,commandOptions:{...l},globalOptions:{...c},pmRoot:m.pmRoot,profileEnabled:!!c.profile,migrationBlockers:A},Ce(void 0),ut({command:r,args:s,options:{...l},global:{...c},pm_root:m.pmRoot}),F=await gn({command:r,pm_version:lt,args:s,options:l,global:c,pm_root:m.pmRoot}),await br(e),pn(r,s,l,{source_context:F?.source_context,source_context_source:F?.source_context_source}),un(r);let L=await Xo(m.hooks,{command:r,args:s,options:{...l},global:{...c},pm_root:m.pmRoot});c.profile&&L.length>0&&w(`profile:extensions hook_warnings=${q(L)}`),h.enforce_mandatory_migration_gate&&mr(r,l,A)}),e.hook("postAction",async()=>{let n=Ao();Ge(n.ok,n.error,{error_code:n.error_code,error_category:n.error_category,exit_code:n.exit_code,command_resolution:n.command_resolution,resolution_stage:n.resolution_stage}),await ct(n)}))}Vr(y);var xr=Symbol("pmCliIdempotentTopLevelRegistration");function Br(e){let t=e;if(t[xr])return;t[xr]=!0;let n=e.command.bind(e);e.command=((o,...a)=>{let i=o.split(/\s+/u)[0];return e.commands.some(r=>r.name()===i||r.aliases().includes(i))?new No(i):n(o,...a)})}async function md(e,t){if(Br(e),t.setup){let{registerSetupCommands:n}=await Zc();n(e)}if(t.listQuery){let{registerListQueryCommands:n}=await Qc(),o=typeof t.targetCommandName=="string"&&go.has(t.targetCommandName)?new Set([t.targetCommandName]):void 0;n(e,o?{commandFilter:o}:void 0)}if(t.mutation){let{registerMutationCommands:n}=await ed();n(e,{targetCommandName:t.targetCommandName})}if(t.operation){let{registerOperationCommands:n}=await td();n(e)}}function pd(e){return async t=>{let n=mt(t.errorCode),o=bt({ok:!1,errorCode:t.errorCode,errorCategory:n});return await za({command:t.command,args:e.invocationArgv,options:t.options,global:e.bootstrapGlobal,pm_version:lt,pm_root:e.bootstrapPmRoot,error_code:t.errorCode,error_message:t.errorMessage,exit_code:t.exitCode,error_category:n,command_resolution:o,resolution_stage:t.resolutionStage}),{errorCategory:n,commandResolution:o}}}async function Kr(e){if(e.bootstrapGlobal.noExtensions||it(e.invocationArgv))return;let t=Ie(e.invocationArgv),n=await Jt(e.bootstrapPmRoot);if(n&&nt(n.discovery,t)){let o=await Ne(e.bootstrapPmRoot,t);Jr(o);return}n&&Kt(Fo(e.invocationArgv),n,t),te({overrides:[]})}function Jr(e){if(!e){te({overrides:[]});return}te(e.services)}async function jo(e){Ge(!1,e.errorMessage,{error_code:e.classificationCode,error_category:e.errorCategory,exit_code:e.exitCode,command_resolution:e.commandResolution,resolution_stage:e.resolutionStage}),await ct({ok:!1,error:e.errorMessage,exit_code:e.exitCode,error_code:e.classificationCode,error_category:e.errorCategory,command_resolution:e.commandResolution,resolution_stage:e.resolutionStage})}async function Yr(){Ge(!0,void 0,{exit_code:f.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),await ct({ok:!0,exit_code:f.SUCCESS,command_resolution:"success",resolution_stage:"parse"}),process.exitCode=f.SUCCESS}async function Xr(e,t){let n=typeof t=="number"&&Number.isFinite(t);if(!(e.error instanceof b)&&(cn(e.error)||!n))return!1;let o=de(e.error),a=e.error instanceof b?e.error.exitCode:ln(t),i=e.error instanceof b?e.error.context:void 0,r=Ar(i,e.invocationArgv,o),s=bi(o,r),l=e.bootstrapGlobal.lean?Tt(Nn(o,a,r)):Nn(o,a,r),c=e.jsonErrors?JSON.stringify(e.bootstrapGlobal.tokenAccounting?ce(l,u=>`${JSON.stringify(u,null,2)}
|
|
34
34
|
`):l,null,2):vi(o,r);e.jsonErrors?xe(`${c}
|
|
35
35
|
`):w(c);let{errorCategory:d,commandResolution:m}=await e.emitTelemetryCommandError({command:e.attemptedCommand,errorCode:s.code,errorMessage:s.detail,exitCode:a,options:{bootstrap_global_options:e.bootstrapGlobal},resolutionStage:"execute"}),p=await Bt({command:e.attemptedCommand,error_code:s.code,error_category:d,exit_code:a,error_message:s.detail,command_resolution:m,resolution_stage:"execute",source_context:F?.source_context});return await jo({errorMessage:o,exitCode:a,classificationCode:s.code,errorCategory:d,commandResolution:m,resolutionStage:"execute"}),p&&(fn(dn(e.error,o)),await We(Do)),process.exitCode=a,!0}async function Zr(e,t){let n=O(S(e.invocationArgv).commandPathTokens.join(" "))||Fn(e.invocationArgv),o=`unknown command '${n}'`,a=T(process.cwd(),e.bootstrapGlobal.path),i=await jr(a),r=Ie(e.invocationArgv),s=await Yn(a,{},Re(r)),l=await Xe({message:o},y,i,{failedExtensions:s}),c=Dn(l.message,l.commandName,l.allowedTypes,{unknownCommandExamples:l.unknownCommandExamples,unknownCommandNextSteps:l.unknownCommandNextSteps,attemptedCommand:l.attemptedCommand,normalizedInvocationArgs:l.normalizedInvocationArgs,providedOptionFlags:l.providedOptionFlags,unknownOptionSuggestions:l.unknownOptionSuggestions,suggestedRetryCommand:l.suggestedRetryCommand,failedExtensions:s}),{errorCategory:d,commandResolution:m}=await e.emitTelemetryCommandError({command:n,errorCode:c.code,errorMessage:c.detail,exitCode:f.USAGE,options:{bootstrap_global_options:e.bootstrapGlobal,commander_code:t??"commander.helpDisplayed"},resolutionStage:"parse"}),p=await Bt({command:n,error_code:c.code,error_category:d,exit_code:f.USAGE,error_message:c.detail,command_resolution:m,resolution_stage:"parse"}),u=e.jsonErrors?await qn({message:o},y,i,e.bootstrapGlobal.lean===!0,{failedExtensions:s}):await Un({message:o},y,i,{failedExtensions:s}),g=Mn(u,e.jsonErrors,s);await jo({errorMessage:o,exitCode:f.USAGE,classificationCode:c.code,errorCategory:d,commandResolution:m,resolutionStage:"parse"}),e.jsonErrors?xe(`${g}
|
|
36
36
|
`):w(g),p&&await We(Do),process.exitCode=f.USAGE}async function Qr(e,t,n){if(!(t==="commander.helpDisplayed"||t==="commander.help"||t==="commander.helpCommand")&&!n.includes("(outputHelp)"))return!1;let o=S(e.invocationArgv);return o.requested&&!Ye(y,o.commandPathTokens)?(await Zr(e,t),!0):(await Yr(),!0)}async function es(e,t){let n=await Xe(e.error,y,P),o=Dn(n.message,n.commandName,n.allowedTypes,{unknownCommandExamples:n.unknownCommandExamples,unknownCommandNextSteps:n.unknownCommandNextSteps,attemptedCommand:n.attemptedCommand,normalizedInvocationArgs:n.normalizedInvocationArgs,providedOptionFlags:n.providedOptionFlags,unknownOptionSuggestions:n.unknownOptionSuggestions,suggestedRetryCommand:n.suggestedRetryCommand}),{errorCategory:a,commandResolution:i}=await e.emitTelemetryCommandError({command:e.attemptedCommand,errorCode:o.code,errorMessage:o.detail,exitCode:f.USAGE,options:{bootstrap_global_options:e.bootstrapGlobal,commander_code:t},resolutionStage:"parse"}),r=await Bt({command:e.attemptedCommand,error_code:o.code,error_category:a,exit_code:f.USAGE,error_message:o.detail,command_resolution:i,resolution_stage:"parse",source_context:F?.source_context}),s=e.jsonErrors?await qn(e.error,y,P,e.bootstrapGlobal.lean===!0):await Un(e.error,y,P),l=await tr(o.code,e.bootstrapPmRoot,{},Re(Ie(e.invocationArgv))),c=Mn(s,e.jsonErrors,l);await jo({errorMessage:n.message,exitCode:f.USAGE,classificationCode:o.code,errorCategory:a,commandResolution:i,resolutionStage:"parse"}),e.jsonErrors?xe(`${c}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{a as be,b as Oe,c as Ae,d as Fe,e as Re,f as Te,g as Me,h as Be,i as $,j as D,k as j,l as K,m as H,p as U,q,w as G,x as Y,y as X,z as J}from"./focused-chunks/chunk-3NSZ5C4A.js";import{a as M,b as B,c as N,d as L,u as Q}from"./focused-chunks/chunk-3BKRCR57.js";import"./focused-chunks/chunk-PBNQZV33.js";import"./focused-chunks/chunk-NRSA5ZB2.js";import"./focused-chunks/chunk-2YICTWWA.js";import{a as g}from"./focused-chunks/chunk-3RJ4VK7U.js";import{Ac as z,Bc as W,b as we,c as Se,ca as x,d as Pe,da as k,ea as C,fa as I,ga as F,ha as w,hb as R,ib as T,j as y,k as E,n as m,yc as V}from"./focused-chunks/chunk-QY4Z23QC.js";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="52f6eff3-e226-56d9-893a-f16997d11c50")}catch{}})();function He(e){return e}function Ue(e){return e}function Z(e,o){for(let r of o.commands??[])e.registerCommand(r);for(let[r,t]of Object.entries(o.commandOverrides??{}))e.registerCommand(r,t);for(let[r,t]of Object.entries(o.flags??{}))e.registerFlags(r,t);for(let[r,t]of Object.entries(o.parsers??{}))e.registerParser(r,t);for(let[r,t]of Object.entries(o.renderers??{}))if(typeof t=="function")e.registerRenderer(r,t);else{let{run:i,...s}=t;e.registerRenderer(r,i,s)}for(let[r,t]of Object.entries(o.services??{}))e.registerService(r,t)}function ee(e,o){for(let s of o.preflights??[])e.registerPreflight(s);let r=o.itemTypes??[];r.length>0&&e.registerItemTypes(r);let t=o.itemFields??[];t.length>0&&e.registerItemFields(t);let i=o.relationshipKinds??[];i.length>0&&e.registerRelationshipKinds(i);for(let s of o.migrations??[])e.registerMigration(s);for(let s of o.profiles??[])e.registerProfile(s)}function re(e,o){for(let r of o.searchProviders??[])e.registerSearchProvider(r);for(let r of o.vectorStoreAdapters??[])e.registerVectorStoreAdapter(r);for(let r of o.assuranceProviders??[])e.registerAssuranceMeasurementProvider(r);for(let r of o.importers??[])e.registerImporter(r.name,r.importer,r.options);for(let r of o.exporters??[])e.registerExporter(r.name,r.exporter,r.options)}function oe(e,o){for(let r of o.beforeCommand??[])e.hooks.beforeCommand(r);for(let r of o.beforeMutation??[])e.hooks.beforeMutation(r);for(let r of o.afterCommand??[])e.hooks.afterCommand(r);for(let r of o.onWrite??[])e.hooks.onWrite(r);for(let r of o.onRead??[])e.hooks.onRead(r);for(let r of o.onIndex??[])e.hooks.onIndex(r)}function te(e){let o={activate:async r=>{Z(r,e),ee(r,e),re(r,e),oe(r,e.hooks??{}),await e.activate?.(r)}};return e.manifest&&(o.manifest=e.manifest),e.deactivate&&(o.deactivate=e.deactivate),o}function d(e){let o=e.flatMap(r=>r??[]);return o.length>0?o:void 0}function p(e){let o=Object.assign({},...e.map(r=>r??{}));return Object.keys(o).length>0?o:void 0}function ne(e){let o={};for(let r of e)for(let[t,i]of Object.entries(r??{}))o[t]=[...o[t]??[],...i];return Object.keys(o).length>0?o:void 0}var ie=["beforeCommand","beforeMutation","afterCommand","onWrite","onRead","onIndex"];function se(e,o,r){let t=o.map(s=>s?.[r]),i=d(t);if(i!==void 0){let s=e;s[r]=i}}function ae(e){let o={};for(let r of ie)se(o,e,r);return Object.keys(o).length>0?o:void 0}function qe(...e){let o={},r=(n,c)=>{c!==void 0&&(o[n]=c)};r("commands",d(e.map(n=>n.commands))),r("commandOverrides",p(e.map(n=>n.commandOverrides))),r("flags",ne(e.map(n=>n.flags))),r("parsers",p(e.map(n=>n.parsers))),r("renderers",p(e.map(n=>n.renderers))),r("services",p(e.map(n=>n.services))),r("preflights",d(e.map(n=>n.preflights))),r("itemTypes",d(e.map(n=>n.itemTypes))),r("itemFields",d(e.map(n=>n.itemFields))),r("relationshipKinds",d(e.map(n=>n.relationshipKinds))),r("migrations",d(e.map(n=>n.migrations))),r("profiles",d(e.map(n=>n.profiles))),r("searchProviders",d(e.map(n=>n.searchProviders))),r("vectorStoreAdapters",d(e.map(n=>n.vectorStoreAdapters))),r("assuranceProviders",d(e.map(n=>n.assuranceProviders))),r("importers",d(e.map(n=>n.importers))),r("exporters",d(e.map(n=>n.exporters))),r("hooks",ae(e.map(n=>n.hooks)));let t;for(let n of e)n.manifest&&(t=n.manifest);r("manifest",t);let i=e.some(n=>n.activate);r("activate",i?async n=>{for(let c of e)c.activate&&await c.activate(n)}:void 0);let s=e.some(n=>n.deactivate);return r("deactivate",s?async()=>{let n=[];for(let c of[...e].reverse())if(c.deactivate)try{await c.deactivate()}catch(f){n.push(f)}if(n.length>0)throw n.length>1?new AggregateError(n,"Multiple extension blueprint deactivate hooks failed."):n[0]}:void 0),o}var ce=[["commands","commands"],["commandOverrides","commands"],["flags","schema"],["itemTypes","schema"],["itemFields","schema"],["relationshipKinds","schema"],["migrations","schema"],["profiles","schema"],["parsers","parser"],["renderers","renderers"],["services","services"],["preflights","preflight"],["searchProviders","search"],["vectorStoreAdapters","search"],["assuranceProviders","services"],["importers","importers"],["exporters","importers"]];function u(e){return e?Array.isArray(e)?e.length>0:Object.keys(e).length>0:!1}function h(e){let o=new Set;for(let[i,s]of ce)u(e[i])&&o.add(s);(e.commands??[]).filter(l).some(i=>i.flags!==void 0)&&o.add("schema");let r=[...e.importers??[],...e.exporters??[]].filter(l);r.some(i=>i?.options?.flags!==void 0)&&o.add("schema"),r.some(i=>typeof i=="object")&&o.add("commands");let t=e.hooks??{};return[t.beforeCommand,t.beforeMutation,t.afterCommand,t.onWrite,t.onRead,t.onIndex].some(u)&&o.add("hooks"),[...o].sort((i,s)=>i.localeCompare(s))}var me=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function a(e){return[...new Set(e)].sort((o,r)=>o.localeCompare(r))}function l(e){return e!=null}function v(e){return m(`${e.name} import`)}function _(e){return m(`${e.name} export`)}function de(e,o,r){return[...e.map(t=>m(t.name)),...o.filter(t=>t.options!==void 0).map(v),...r.filter(t=>t.options!==void 0).map(_)]}function fe(e,o,r,t){return[...Object.keys(e.flags??{}).map(i=>m(i)),...o.filter(i=>i.flags!==void 0).map(i=>m(i.name)),...r.filter(i=>i.options?.flags!==void 0).map(v),...t.filter(i=>i.options?.flags!==void 0).map(_)]}function le(e){return me.filter(([o])=>(e[o]?.length??0)>0).map(([,o])=>o)}function pe(e){let o=Object.entries(e??{}).filter(([,r])=>typeof r!="function"&&((r.commands?.length??0)>0||r.resultDiscriminator!==void 0)).map(([r,t])=>{let i=t;return{format:r,commands:a((i.commands??[]).map(s=>m(s))),result_discriminator:i.resultDiscriminator!==void 0}}).sort((r,t)=>r.format.localeCompare(t.format));return o.length>0?{renderer_ownership:o}:{}}function ue(e){return!e||e.length===0?{}:{assurance_providers:a(e.map(o=>o.id))}}function ge(e,o,r){return{item_types:a((e.itemTypes??[]).map(t=>t.name)),item_fields:a((e.itemFields??[]).map(t=>t.name)),...(e.relationshipKinds?.length??0)>0?{relationship_kinds:a(e.relationshipKinds.map(t=>t.kind))}:{},migrations:a((e.migrations??[]).flatMap(t=>typeof t.id=="string"?[t.id]:[])),profiles:a((e.profiles??[]).map(t=>t.name)),importers:a(o.map(t=>m(t.name))),exporters:a(r.map(t=>m(t.name))),search_providers:a((e.searchProviders??[]).map(t=>t.name)),vector_store_adapters:a((e.vectorStoreAdapters??[]).map(t=>t.name)),...ue(e.assuranceProviders),parser_overrides:a(Object.keys(e.parsers??{}).map(t=>m(t))),service_overrides:a(Object.keys(e.services??{}).map(t=>String(t).trim().toLowerCase())),renderer_overrides:a(Object.keys(e.renderers??{}).map(t=>String(t).trim().toLowerCase())),...pe(e.renderers),preflight_overrides:(e.preflights??[]).length,preflight_ownership:(e.preflights??[]).map(t=>({commands:[...t.commands??[]]}))}}function Ve(e){let o=(e.commands??[]).filter(l),r=(e.importers??[]).filter(l),t=(e.exporters??[]).filter(l),i=r.map(v),s=t.map(_),n=de(o,r,t),c=fe(e,o,r,t),f=e.hooks??{},O=ge(e,r,t);return{capabilities:h(e),commands:a(n),command_overrides:a(Object.keys(e.commandOverrides??{}).map(A=>m(A))),command_handlers:a([...n,...i,...s]),hooks:le(f),flag_commands:a(c),...O}}var he=["commands","commandOverrides","flags","parsers","renderers","services","preflights","itemTypes","itemFields","relationshipKinds","migrations","profiles","searchProviders","vectorStoreAdapters","assuranceProviders","importers","exporters"];function ve(e){return(e.itemFields??[]).filter(o=>typeof o?.name=="string"&&g.has(o.name.trim())).map(o=>({code:"reserved_item_field",severity:"error",message:`Item field "${o.name}" collides with reserved item metadata; rename it with an extension-specific prefix before publishing.`,field:o.name}))}function _e(e){return[...Object.values(e.flags??{}).flat(),...(e.commands??[]).flatMap(o=>o.flags??[]),...(e.importers??[]).flatMap(o=>o.options?.flags??[]),...(e.exporters??[]).flatMap(o=>o.options?.flags??[])].flatMap(o=>{if(typeof o?.long!="string"&&typeof o?.short!="string")return[];let r=x(o.long,o.short);if(r===null)return[];let{token:t,failure:i}=r;return[{code:i,severity:"error",message:`Flag "${t}" ${k(t,i)}.`,field:t}]})}function P(e){let o=new Set;for(let r of e){let t=E(r)??y(r);t!==null&&o.add(t)}return[...o].sort((r,t)=>r.localeCompare(t))}function ye(e,o){let r=[];if(o===null)return e.length>0&&r.push({code:"manifest_capabilities_absent",severity:"warning",message:`Blueprint exercises ${e.length===1?"capability":"capabilities"} [${e.join(", ")}] but declares none; set capabilities to deriveExtensionCapabilities(blueprint) so the manifest grant matches.`}),r;let t=new Set(o),i=new Set(e);for(let s of e)t.has(s)||r.push({code:"capability_undeclared",severity:"error",message:`Blueprint exercises capability "${s}" but it is absent from the declared capabilities; activation throws extension_capability_missing \u2014 add "${s}" to the manifest capabilities.`,capability:s});for(let s of o)i.has(s)||r.push({code:"capability_unused",severity:"warning",message:`Capability "${s}" is declared but no blueprint surface exercises it; drop it to keep the manifest least-privilege (pm package doctor reports this as extension_capability_unused).`,capability:s});return r}function Ee(e){let o=[],r=new Map;for(let i of e.commands??[]){let s=m(i.name);r.set(s,(r.get(s)??0)+1)}for(let[i,s]of r)s>1&&o.push({code:"duplicate_command",severity:"warning",message:`Command "${i}" is declared ${s} times in commands; the later registration shadows the earlier one at dispatch.`,command:i});let t=new Set(Object.keys(e.commandOverrides??{}).map(i=>m(i)));for(let i of r.keys())t.has(i)&&o.push({code:"command_override_conflict",severity:"warning",message:`Command "${i}" is declared both as a new command definition and as a command override; register one or the other.`,command:i});return o}function xe(e){let o=[];for(let r of he)r in e&&!u(e[r])&&o.push({code:"empty_surface",severity:"warning",message:`Blueprint field "${r}" is present but empty; remove it or populate it.`,field:r});if("hooks"in e){let r=e.hooks??{};[r.beforeCommand,r.beforeMutation,r.afterCommand,r.onWrite,r.onRead,r.onIndex].some(u)||o.push({code:"empty_surface",severity:"warning",message:'Blueprint field "hooks" is present but registers no lifecycle hooks; remove it or populate it.',field:"hooks"})}return o}function ke(e,o={}){let r=h(e),t=o.declaredCapabilities??e.manifest?.capabilities,i=Array.isArray(t)?P(t):null,s=[...ye(r,i),...Ee(e),..._e(e),...ve(e),...xe(e)];return{ok:s.every(n=>n.severity!=="error"),findings:s,used:r,declared:i}}function b(e,o){let{additionalCapabilities:r,...t}=o,i=Array.isArray(r)?P(r):[],s=[...new Set([...h(e),...i])].sort((n,c)=>n.localeCompare(c));return{...t,capabilities:s}}function ze(e,o){let r=b(e,o);return{module:te({...e,manifest:r}),manifest:r}}function S(e,o){if(e.status==="absent"||e.status==="ok")return null;let r=`${e.kind}_${e.status}`,t="";switch(r){case"pm_min_version_invalid":t=`pm_min_version "${e.required}" is not a valid version; the extension is treated as incompatible and the loader skips it.`;break;case"pm_min_version_unchecked":t=`pm_min_version "${e.required}" could not be compared against pm ${o}; compatibility is unverified.`;break;case"pm_min_version_unmet":t=`Requires pm >= ${e.required} but the target is pm ${o}; the loader skips the extension.`;break;case"pm_max_version_invalid":t=`pm_max_version "${e.required}" is not a valid inclusive upper bound (version ranges are not allowed); the extension is treated as incompatible and the loader skips it.`;break;case"pm_max_version_unchecked":t=`pm_max_version "${e.required}" could not be compared against pm ${o}; compatibility is unverified.`;break;case"pm_max_version_exceeded":t=`Allows pm <= ${e.required} but the target is pm ${o}; the loader skips the extension.`;break;case"pm_max_version_exceeded_warn":t=`Target pm ${o} is newer than pm_max_version ${e.required}, but the "warn" exceeded mode lets it load with a warning.`;break}return{code:r,severity:e.allowed?"warning":"error",constraint:e.kind,required:e.required,current:o,message:t}}function Ce(e,o){let r=C(e.pm_min_version,o.pmVersion),t=I(e.pm_max_version,o.pmVersion,o.pmMaxVersionExceededMode??"block"),i=w(e).findings.map(f=>({code:f.code,severity:"warning",constraint:"manifest",required:f.code==="manifest_unknown_key"?f.path:"pm_min_version",current:o.pmVersion,path:f.path,...f.suggested_key?{suggested_key:f.suggested_key}:{},message:f.message})),s=[],n=S(r,o.pmVersion);n!==null&&s.push(n);let c=S(t,o.pmVersion);return c!==null&&s.push(c),{compatible:r.allowed&&t.allowed,findings:[...i,...s],pmVersion:o.pmVersion}}var Ie=new Set(["capability_undeclared","capability_unused","manifest_capabilities_absent"]);function We(e,o={}){let r=ke(e,{declaredCapabilities:o.declaredCapabilities}),t=o.identity?b(e,o.identity):null,i=o.target?Ce(t??e.manifest??{},o.target):null,s=[...(t!==null&&o.declaredCapabilities===void 0?r.findings.filter(n=>!Ie.has(n.code)):r.findings).map(n=>({source:"blueprint",severity:n.severity,code:n.code,message:n.message})),...(i?.findings??[]).map(n=>({source:"compatibility",severity:n.severity,code:n.code,message:n.message}))];return{ok:s.every(n=>n.severity!=="error"),capabilities:r.used,blueprint:r,manifest:t,compatibility:i,findings:s}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="4e72da21-425b-568d-9174-bc5021e1d4f4")}catch{}})();function Ye(e){return e}function Xe(e){return e}function Je(e){return e}function Qe(e){return e}function Ze(e){return e}function er(e){return e}function rr(e){return e}function or(e){return e}function tr(e){return e}function nr(e){return e}function ir(e){return e}function sr(e){return e}function ar(e){return e}function cr(e){return{handled:!0,result:e}}function mr(){return{handled:!1}}function dr(e){return e}function fr(e){return e}function lr(e){return e}function pr(e){return e}function ur(e){return e}function gr(e){return e}function hr(e){return e}function vr(e){return e}function _r(e){return e}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="af4da99c-f557-5bf7-a439-c14878e4970d")}catch{}})();export{D as BUILTIN_PROFILES,be as EXTENSION_CAPABILITIES,Pe as EXTENSION_CAPABILITY_CONTRACT,we as EXTENSION_CAPABILITY_CONTRACT_VERSION,Se as EXTENSION_CAPABILITY_LEGACY_ALIASES,V as EXTENSION_CAPABILITY_REGISTRATION_SURFACES,Oe as EXTENSION_POLICY_MODES,Ae as EXTENSION_POLICY_SURFACES,Re as EXTENSION_SANDBOX_PROFILES,Fe as EXTENSION_TRUST_MODES,Me as LIST_FILTER_EXTENSION_FLAG_DEFINITIONS,B as PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,M as PM_PACKAGE_RESOURCE_KINDS,Y as PROFILE_LINT_CODES,G as PROFILE_LINT_DIMENSIONS,$ as PROFILE_NAMES,g as RESERVED_ITEM_FIELD_NAMES,Be as SEARCH_EXTENSION_FLAG_DEFINITIONS,Ce as checkExtensionManifestCompatibility,L as collectPackageExtensionDirectories,z as collectUsedExtensionCapabilities,te as composeExtension,ze as composeExtensionPackage,T as createExtensionContributionInventory,mr as declineServiceOverride,gr as defineAfterCommandHook,pr as defineBeforeCommandHook,ur as defineBeforeMutationHook,Je as defineCommand,nr as defineCommandOverride,lr as defineExporter,He as defineExtension,Ue as defineExtensionBlueprint,Ye as defineExtensionManifest,Qe as defineFlag,fr as defineImporter,er as defineItemField,Ze as defineItemType,rr as defineMigration,_r as defineOnIndexHook,vr as defineOnReadHook,hr as defineOnWriteHook,ir as defineParserOverride,sr as definePreflightOverride,Xe as defineProjectProfile,dr as defineRendererOverride,or as defineSearchProvider,ar as defineServiceOverride,tr as defineVectorStoreAdapter,h as deriveExtensionCapabilities,Ve as describeExtensionBlueprint,U as describeProfileComposition,q as describeProjectProfile,cr as handleServiceOverride,F as inspectExtensionManifestSchema,ke as lintExtensionBlueprint,w as lintExtensionManifestSchema,X as lintProjectProfile,H as listProfiles,qe as mergeExtensionBlueprints,R as normalizeExtensionContributionInventory,j as normalizeProfileName,J as planProfileApplication,We as preflightExtension,N as readPmPackageManifest,W as reconcileExtensionCapabilityUsage,Q as renderExtensionSurfaceMarkdown,K as resolveProfile,b as synthesizeExtensionManifest,Te as toExtensionFlagDefinitions};
|
|
1
|
+
import{a as be,b as Oe,c as Ae,d as Fe,e as Re,f as Te,g as Me,h as Be,i as $,j as D,k as j,l as K,m as H,p as U,q,w as G,x as Y,y as X,z as J}from"./focused-chunks/chunk-XT7JAVHI.js";import{a as M,b as B,c as N,d as L,u as Q}from"./focused-chunks/chunk-DRHJOG5X.js";import"./focused-chunks/chunk-6TKAFFEB.js";import"./focused-chunks/chunk-PBPPIGUL.js";import"./focused-chunks/chunk-BDT5EALU.js";import{a as g}from"./focused-chunks/chunk-F2ME5MJY.js";import{Bc as z,Cc as W,b as we,c as Se,ca as x,d as Pe,da as k,ea as C,fa as I,ga as F,ha as w,ib as R,j as y,jb as T,k as E,n as m,zc as V}from"./focused-chunks/chunk-L3CZNKZE.js";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="52f6eff3-e226-56d9-893a-f16997d11c50")}catch{}})();function He(e){return e}function Ue(e){return e}function Z(e,o){for(let r of o.commands??[])e.registerCommand(r);for(let[r,t]of Object.entries(o.commandOverrides??{}))e.registerCommand(r,t);for(let[r,t]of Object.entries(o.flags??{}))e.registerFlags(r,t);for(let[r,t]of Object.entries(o.parsers??{}))e.registerParser(r,t);for(let[r,t]of Object.entries(o.renderers??{}))if(typeof t=="function")e.registerRenderer(r,t);else{let{run:i,...s}=t;e.registerRenderer(r,i,s)}for(let[r,t]of Object.entries(o.services??{}))e.registerService(r,t)}function ee(e,o){for(let s of o.preflights??[])e.registerPreflight(s);let r=o.itemTypes??[];r.length>0&&e.registerItemTypes(r);let t=o.itemFields??[];t.length>0&&e.registerItemFields(t);let i=o.relationshipKinds??[];i.length>0&&e.registerRelationshipKinds(i);for(let s of o.migrations??[])e.registerMigration(s);for(let s of o.profiles??[])e.registerProfile(s)}function re(e,o){for(let r of o.searchProviders??[])e.registerSearchProvider(r);for(let r of o.vectorStoreAdapters??[])e.registerVectorStoreAdapter(r);for(let r of o.assuranceProviders??[])e.registerAssuranceMeasurementProvider(r);for(let r of o.importers??[])e.registerImporter(r.name,r.importer,r.options);for(let r of o.exporters??[])e.registerExporter(r.name,r.exporter,r.options)}function oe(e,o){for(let r of o.beforeCommand??[])e.hooks.beforeCommand(r);for(let r of o.beforeMutation??[])e.hooks.beforeMutation(r);for(let r of o.afterCommand??[])e.hooks.afterCommand(r);for(let r of o.onWrite??[])e.hooks.onWrite(r);for(let r of o.onRead??[])e.hooks.onRead(r);for(let r of o.onIndex??[])e.hooks.onIndex(r)}function te(e){let o={activate:async r=>{Z(r,e),ee(r,e),re(r,e),oe(r,e.hooks??{}),await e.activate?.(r)}};return e.manifest&&(o.manifest=e.manifest),e.deactivate&&(o.deactivate=e.deactivate),o}function d(e){let o=e.flatMap(r=>r??[]);return o.length>0?o:void 0}function p(e){let o=Object.assign({},...e.map(r=>r??{}));return Object.keys(o).length>0?o:void 0}function ne(e){let o={};for(let r of e)for(let[t,i]of Object.entries(r??{}))o[t]=[...o[t]??[],...i];return Object.keys(o).length>0?o:void 0}var ie=["beforeCommand","beforeMutation","afterCommand","onWrite","onRead","onIndex"];function se(e,o,r){let t=o.map(s=>s?.[r]),i=d(t);if(i!==void 0){let s=e;s[r]=i}}function ae(e){let o={};for(let r of ie)se(o,e,r);return Object.keys(o).length>0?o:void 0}function qe(...e){let o={},r=(n,c)=>{c!==void 0&&(o[n]=c)};r("commands",d(e.map(n=>n.commands))),r("commandOverrides",p(e.map(n=>n.commandOverrides))),r("flags",ne(e.map(n=>n.flags))),r("parsers",p(e.map(n=>n.parsers))),r("renderers",p(e.map(n=>n.renderers))),r("services",p(e.map(n=>n.services))),r("preflights",d(e.map(n=>n.preflights))),r("itemTypes",d(e.map(n=>n.itemTypes))),r("itemFields",d(e.map(n=>n.itemFields))),r("relationshipKinds",d(e.map(n=>n.relationshipKinds))),r("migrations",d(e.map(n=>n.migrations))),r("profiles",d(e.map(n=>n.profiles))),r("searchProviders",d(e.map(n=>n.searchProviders))),r("vectorStoreAdapters",d(e.map(n=>n.vectorStoreAdapters))),r("assuranceProviders",d(e.map(n=>n.assuranceProviders))),r("importers",d(e.map(n=>n.importers))),r("exporters",d(e.map(n=>n.exporters))),r("hooks",ae(e.map(n=>n.hooks)));let t;for(let n of e)n.manifest&&(t=n.manifest);r("manifest",t);let i=e.some(n=>n.activate);r("activate",i?async n=>{for(let c of e)c.activate&&await c.activate(n)}:void 0);let s=e.some(n=>n.deactivate);return r("deactivate",s?async()=>{let n=[];for(let c of[...e].reverse())if(c.deactivate)try{await c.deactivate()}catch(f){n.push(f)}if(n.length>0)throw n.length>1?new AggregateError(n,"Multiple extension blueprint deactivate hooks failed."):n[0]}:void 0),o}var ce=[["commands","commands"],["commandOverrides","commands"],["flags","schema"],["itemTypes","schema"],["itemFields","schema"],["relationshipKinds","schema"],["migrations","schema"],["profiles","schema"],["parsers","parser"],["renderers","renderers"],["services","services"],["preflights","preflight"],["searchProviders","search"],["vectorStoreAdapters","search"],["assuranceProviders","services"],["importers","importers"],["exporters","importers"]];function u(e){return e?Array.isArray(e)?e.length>0:Object.keys(e).length>0:!1}function h(e){let o=new Set;for(let[i,s]of ce)u(e[i])&&o.add(s);(e.commands??[]).filter(l).some(i=>i.flags!==void 0)&&o.add("schema");let r=[...e.importers??[],...e.exporters??[]].filter(l);r.some(i=>i?.options?.flags!==void 0)&&o.add("schema"),r.some(i=>typeof i=="object")&&o.add("commands");let t=e.hooks??{};return[t.beforeCommand,t.beforeMutation,t.afterCommand,t.onWrite,t.onRead,t.onIndex].some(u)&&o.add("hooks"),[...o].sort((i,s)=>i.localeCompare(s))}var me=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function a(e){return[...new Set(e)].sort((o,r)=>o.localeCompare(r))}function l(e){return e!=null}function v(e){return m(`${e.name} import`)}function _(e){return m(`${e.name} export`)}function de(e,o,r){return[...e.map(t=>m(t.name)),...o.filter(t=>t.options!==void 0).map(v),...r.filter(t=>t.options!==void 0).map(_)]}function fe(e,o,r,t){return[...Object.keys(e.flags??{}).map(i=>m(i)),...o.filter(i=>i.flags!==void 0).map(i=>m(i.name)),...r.filter(i=>i.options?.flags!==void 0).map(v),...t.filter(i=>i.options?.flags!==void 0).map(_)]}function le(e){return me.filter(([o])=>(e[o]?.length??0)>0).map(([,o])=>o)}function pe(e){let o=Object.entries(e??{}).filter(([,r])=>typeof r!="function"&&((r.commands?.length??0)>0||r.resultDiscriminator!==void 0)).map(([r,t])=>{let i=t;return{format:r,commands:a((i.commands??[]).map(s=>m(s))),result_discriminator:i.resultDiscriminator!==void 0}}).sort((r,t)=>r.format.localeCompare(t.format));return o.length>0?{renderer_ownership:o}:{}}function ue(e){return!e||e.length===0?{}:{assurance_providers:a(e.map(o=>o.id))}}function ge(e,o,r){return{item_types:a((e.itemTypes??[]).map(t=>t.name)),item_fields:a((e.itemFields??[]).map(t=>t.name)),...(e.relationshipKinds?.length??0)>0?{relationship_kinds:a(e.relationshipKinds.map(t=>t.kind))}:{},migrations:a((e.migrations??[]).flatMap(t=>typeof t.id=="string"?[t.id]:[])),profiles:a((e.profiles??[]).map(t=>t.name)),importers:a(o.map(t=>m(t.name))),exporters:a(r.map(t=>m(t.name))),search_providers:a((e.searchProviders??[]).map(t=>t.name)),vector_store_adapters:a((e.vectorStoreAdapters??[]).map(t=>t.name)),...ue(e.assuranceProviders),parser_overrides:a(Object.keys(e.parsers??{}).map(t=>m(t))),service_overrides:a(Object.keys(e.services??{}).map(t=>String(t).trim().toLowerCase())),renderer_overrides:a(Object.keys(e.renderers??{}).map(t=>String(t).trim().toLowerCase())),...pe(e.renderers),preflight_overrides:(e.preflights??[]).length,preflight_ownership:(e.preflights??[]).map(t=>({commands:[...t.commands??[]]}))}}function Ve(e){let o=(e.commands??[]).filter(l),r=(e.importers??[]).filter(l),t=(e.exporters??[]).filter(l),i=r.map(v),s=t.map(_),n=de(o,r,t),c=fe(e,o,r,t),f=e.hooks??{},O=ge(e,r,t);return{capabilities:h(e),commands:a(n),command_overrides:a(Object.keys(e.commandOverrides??{}).map(A=>m(A))),command_handlers:a([...n,...i,...s]),hooks:le(f),flag_commands:a(c),...O}}var he=["commands","commandOverrides","flags","parsers","renderers","services","preflights","itemTypes","itemFields","relationshipKinds","migrations","profiles","searchProviders","vectorStoreAdapters","assuranceProviders","importers","exporters"];function ve(e){return(e.itemFields??[]).filter(o=>typeof o?.name=="string"&&g.has(o.name.trim())).map(o=>({code:"reserved_item_field",severity:"error",message:`Item field "${o.name}" collides with reserved item metadata; rename it with an extension-specific prefix before publishing.`,field:o.name}))}function _e(e){return[...Object.values(e.flags??{}).flat(),...(e.commands??[]).flatMap(o=>o.flags??[]),...(e.importers??[]).flatMap(o=>o.options?.flags??[]),...(e.exporters??[]).flatMap(o=>o.options?.flags??[])].flatMap(o=>{if(typeof o?.long!="string"&&typeof o?.short!="string")return[];let r=x(o.long,o.short);if(r===null)return[];let{token:t,failure:i}=r;return[{code:i,severity:"error",message:`Flag "${t}" ${k(t,i)}.`,field:t}]})}function P(e){let o=new Set;for(let r of e){let t=E(r)??y(r);t!==null&&o.add(t)}return[...o].sort((r,t)=>r.localeCompare(t))}function ye(e,o){let r=[];if(o===null)return e.length>0&&r.push({code:"manifest_capabilities_absent",severity:"warning",message:`Blueprint exercises ${e.length===1?"capability":"capabilities"} [${e.join(", ")}] but declares none; set capabilities to deriveExtensionCapabilities(blueprint) so the manifest grant matches.`}),r;let t=new Set(o),i=new Set(e);for(let s of e)t.has(s)||r.push({code:"capability_undeclared",severity:"error",message:`Blueprint exercises capability "${s}" but it is absent from the declared capabilities; activation throws extension_capability_missing \u2014 add "${s}" to the manifest capabilities.`,capability:s});for(let s of o)i.has(s)||r.push({code:"capability_unused",severity:"warning",message:`Capability "${s}" is declared but no blueprint surface exercises it; drop it to keep the manifest least-privilege (pm package doctor reports this as extension_capability_unused).`,capability:s});return r}function Ee(e){let o=[],r=new Map;for(let i of e.commands??[]){let s=m(i.name);r.set(s,(r.get(s)??0)+1)}for(let[i,s]of r)s>1&&o.push({code:"duplicate_command",severity:"warning",message:`Command "${i}" is declared ${s} times in commands; the later registration shadows the earlier one at dispatch.`,command:i});let t=new Set(Object.keys(e.commandOverrides??{}).map(i=>m(i)));for(let i of r.keys())t.has(i)&&o.push({code:"command_override_conflict",severity:"warning",message:`Command "${i}" is declared both as a new command definition and as a command override; register one or the other.`,command:i});return o}function xe(e){let o=[];for(let r of he)r in e&&!u(e[r])&&o.push({code:"empty_surface",severity:"warning",message:`Blueprint field "${r}" is present but empty; remove it or populate it.`,field:r});if("hooks"in e){let r=e.hooks??{};[r.beforeCommand,r.beforeMutation,r.afterCommand,r.onWrite,r.onRead,r.onIndex].some(u)||o.push({code:"empty_surface",severity:"warning",message:'Blueprint field "hooks" is present but registers no lifecycle hooks; remove it or populate it.',field:"hooks"})}return o}function ke(e,o={}){let r=h(e),t=o.declaredCapabilities??e.manifest?.capabilities,i=Array.isArray(t)?P(t):null,s=[...ye(r,i),...Ee(e),..._e(e),...ve(e),...xe(e)];return{ok:s.every(n=>n.severity!=="error"),findings:s,used:r,declared:i}}function b(e,o){let{additionalCapabilities:r,...t}=o,i=Array.isArray(r)?P(r):[],s=[...new Set([...h(e),...i])].sort((n,c)=>n.localeCompare(c));return{...t,capabilities:s}}function ze(e,o){let r=b(e,o);return{module:te({...e,manifest:r}),manifest:r}}function S(e,o){if(e.status==="absent"||e.status==="ok")return null;let r=`${e.kind}_${e.status}`,t="";switch(r){case"pm_min_version_invalid":t=`pm_min_version "${e.required}" is not a valid version; the extension is treated as incompatible and the loader skips it.`;break;case"pm_min_version_unchecked":t=`pm_min_version "${e.required}" could not be compared against pm ${o}; compatibility is unverified.`;break;case"pm_min_version_unmet":t=`Requires pm >= ${e.required} but the target is pm ${o}; the loader skips the extension.`;break;case"pm_max_version_invalid":t=`pm_max_version "${e.required}" is not a valid inclusive upper bound (version ranges are not allowed); the extension is treated as incompatible and the loader skips it.`;break;case"pm_max_version_unchecked":t=`pm_max_version "${e.required}" could not be compared against pm ${o}; compatibility is unverified.`;break;case"pm_max_version_exceeded":t=`Allows pm <= ${e.required} but the target is pm ${o}; the loader skips the extension.`;break;case"pm_max_version_exceeded_warn":t=`Target pm ${o} is newer than pm_max_version ${e.required}, but the "warn" exceeded mode lets it load with a warning.`;break}return{code:r,severity:e.allowed?"warning":"error",constraint:e.kind,required:e.required,current:o,message:t}}function Ce(e,o){let r=C(e.pm_min_version,o.pmVersion),t=I(e.pm_max_version,o.pmVersion,o.pmMaxVersionExceededMode??"block"),i=w(e).findings.map(f=>({code:f.code,severity:"warning",constraint:"manifest",required:f.code==="manifest_unknown_key"?f.path:"pm_min_version",current:o.pmVersion,path:f.path,...f.suggested_key?{suggested_key:f.suggested_key}:{},message:f.message})),s=[],n=S(r,o.pmVersion);n!==null&&s.push(n);let c=S(t,o.pmVersion);return c!==null&&s.push(c),{compatible:r.allowed&&t.allowed,findings:[...i,...s],pmVersion:o.pmVersion}}var Ie=new Set(["capability_undeclared","capability_unused","manifest_capabilities_absent"]);function We(e,o={}){let r=ke(e,{declaredCapabilities:o.declaredCapabilities}),t=o.identity?b(e,o.identity):null,i=o.target?Ce(t??e.manifest??{},o.target):null,s=[...(t!==null&&o.declaredCapabilities===void 0?r.findings.filter(n=>!Ie.has(n.code)):r.findings).map(n=>({source:"blueprint",severity:n.severity,code:n.code,message:n.message})),...(i?.findings??[]).map(n=>({source:"compatibility",severity:n.severity,code:n.code,message:n.message}))];return{ok:s.every(n=>n.severity!=="error"),capabilities:r.used,blueprint:r,manifest:t,compatibility:i,findings:s}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="4e72da21-425b-568d-9174-bc5021e1d4f4")}catch{}})();function Ye(e){return e}function Xe(e){return e}function Je(e){return e}function Qe(e){return e}function Ze(e){return e}function er(e){return e}function rr(e){return e}function or(e){return e}function tr(e){return e}function nr(e){return e}function ir(e){return e}function sr(e){return e}function ar(e){return e}function cr(e){return{handled:!0,result:e}}function mr(){return{handled:!1}}function dr(e){return e}function fr(e){return e}function lr(e){return e}function pr(e){return e}function ur(e){return e}function gr(e){return e}function hr(e){return e}function vr(e){return e}function _r(e){return e}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},o=new e.Error().stack;o&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[o]="af4da99c-f557-5bf7-a439-c14878e4970d")}catch{}})();export{D as BUILTIN_PROFILES,be as EXTENSION_CAPABILITIES,Pe as EXTENSION_CAPABILITY_CONTRACT,we as EXTENSION_CAPABILITY_CONTRACT_VERSION,Se as EXTENSION_CAPABILITY_LEGACY_ALIASES,V as EXTENSION_CAPABILITY_REGISTRATION_SURFACES,Oe as EXTENSION_POLICY_MODES,Ae as EXTENSION_POLICY_SURFACES,Re as EXTENSION_SANDBOX_PROFILES,Fe as EXTENSION_TRUST_MODES,Me as LIST_FILTER_EXTENSION_FLAG_DEFINITIONS,B as PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,M as PM_PACKAGE_RESOURCE_KINDS,Y as PROFILE_LINT_CODES,G as PROFILE_LINT_DIMENSIONS,$ as PROFILE_NAMES,g as RESERVED_ITEM_FIELD_NAMES,Be as SEARCH_EXTENSION_FLAG_DEFINITIONS,Ce as checkExtensionManifestCompatibility,L as collectPackageExtensionDirectories,z as collectUsedExtensionCapabilities,te as composeExtension,ze as composeExtensionPackage,T as createExtensionContributionInventory,mr as declineServiceOverride,gr as defineAfterCommandHook,pr as defineBeforeCommandHook,ur as defineBeforeMutationHook,Je as defineCommand,nr as defineCommandOverride,lr as defineExporter,He as defineExtension,Ue as defineExtensionBlueprint,Ye as defineExtensionManifest,Qe as defineFlag,fr as defineImporter,er as defineItemField,Ze as defineItemType,rr as defineMigration,_r as defineOnIndexHook,vr as defineOnReadHook,hr as defineOnWriteHook,ir as defineParserOverride,sr as definePreflightOverride,Xe as defineProjectProfile,dr as defineRendererOverride,or as defineSearchProvider,ar as defineServiceOverride,tr as defineVectorStoreAdapter,h as deriveExtensionCapabilities,Ve as describeExtensionBlueprint,U as describeProfileComposition,q as describeProjectProfile,cr as handleServiceOverride,F as inspectExtensionManifestSchema,ke as lintExtensionBlueprint,w as lintExtensionManifestSchema,X as lintProjectProfile,H as listProfiles,qe as mergeExtensionBlueprints,R as normalizeExtensionContributionInventory,j as normalizeProfileName,J as planProfileApplication,We as preflightExtension,N as readPmPackageManifest,W as reconcileExtensionCapabilityUsage,Q as renderExtensionSurfaceMarkdown,K as resolveProfile,b as synthesizeExtensionManifest,Te as toExtensionFlagDefinitions};
|
|
2
2
|
//# sourceMappingURL=sdk-authoring.js.map
|