@unbrained/pm-cli 2026.8.15 → 2026.8.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +56 -12
  3. package/README.md +13 -13
  4. package/dist/cli/error-guidance.d.ts +5 -0
  5. package/dist/cli/error-guidance.js +15 -2
  6. package/dist/cli/public.d.ts +2 -0
  7. package/dist/cli/public.js +21 -0
  8. package/dist/cli/register-history-author.js +16 -11
  9. package/dist/cli/register-mutation.js +4 -4
  10. package/dist/cli-bundle/bundle-manifest.json +143 -143
  11. package/dist/cli-bundle/chunks/{chunk-J42EGKDK.js → chunk-2QLOXC3V.js} +2 -2
  12. package/dist/cli-bundle/chunks/{chunk-LJHOAVGI.js → chunk-3UEGXBMR.js} +49 -43
  13. package/dist/cli-bundle/chunks/chunk-4JPYF536.js +35 -0
  14. package/dist/cli-bundle/chunks/chunk-6VDLG2FC.js +13 -0
  15. package/dist/cli-bundle/chunks/chunk-7IBRGCHX.js +2 -0
  16. package/dist/cli-bundle/chunks/chunk-HBJAS566.js +8 -0
  17. package/dist/cli-bundle/chunks/chunk-ION3E43Q.js +197 -0
  18. package/dist/cli-bundle/chunks/{chunk-WLPDLNEZ.js → chunk-JOKATURE.js} +4 -4
  19. package/dist/cli-bundle/chunks/{chunk-MEM2ZS3O.js → chunk-TPXZIBIV.js} +5 -5
  20. package/dist/cli-bundle/chunks/chunk-YM2YAMF7.js +2 -0
  21. package/dist/cli-bundle/chunks/{register-list-query-CT3LFDDN.js → register-list-query-Q7KII4G5.js} +2 -2
  22. package/dist/cli-bundle/chunks/{register-mutation-NWEVA5YS.js → register-mutation-4WBRPXLV.js} +3 -3
  23. package/dist/cli-bundle/chunks/{register-operations-AHIAG5KM.js → register-operations-SSENDH5B.js} +2 -2
  24. package/dist/cli-bundle/chunks/{register-setup-ZJZFVAKE.js → register-setup-DOSFBGKE.js} +2 -2
  25. package/dist/cli-bundle/focused-chunks/{chunk-WTSER4WJ.js → chunk-267MUUS6.js} +11 -11
  26. package/dist/cli-bundle/focused-chunks/chunk-2NNFLLNG.js +2 -0
  27. package/dist/cli-bundle/focused-chunks/chunk-2QSAKMIH.js +2 -0
  28. package/dist/cli-bundle/focused-chunks/{chunk-ZMFXQ7VF.js → chunk-ATEY76SX.js} +2 -2
  29. package/dist/cli-bundle/focused-chunks/chunk-BUCG4ZI2.js +2 -0
  30. package/dist/cli-bundle/focused-chunks/{chunk-M67F5AIN.js → chunk-CYFK5UPB.js} +2 -2
  31. package/dist/cli-bundle/focused-chunks/chunk-EHXIKD6K.js +2 -0
  32. package/dist/cli-bundle/focused-chunks/{chunk-EXZA4257.js → chunk-KGEXTMPG.js} +2 -2
  33. package/dist/cli-bundle/focused-chunks/chunk-KP2VQQVQ.js +2 -0
  34. package/dist/cli-bundle/focused-chunks/chunk-MHPIL773.js +2 -0
  35. package/dist/cli-bundle/focused-chunks/chunk-POEEAD2V.js +4 -0
  36. package/dist/cli-bundle/focused-chunks/{chunk-ITAUHSO6.js → chunk-SALH6B6K.js} +47 -47
  37. package/dist/cli-bundle/focused-chunks/{chunk-KLVUMNXJ.js → chunk-SYZENPIT.js} +3 -3
  38. package/dist/cli-bundle/focused-chunks/{chunk-KTKH4IMG.js → chunk-XKAMP5OU.js} +2 -2
  39. package/dist/cli-bundle/focused-chunks/{chunk-NSPYTG6G.js → chunk-XPIC53VA.js} +2 -2
  40. package/dist/cli-bundle/focused-chunks/{chunk-6XKF3PGV.js → chunk-ZQPGZZWQ.js} +2 -2
  41. package/dist/cli-bundle/focused-chunks/chunk-ZT2DJS27.js +155 -0
  42. package/dist/cli-bundle/main.js +10 -10
  43. package/dist/cli-bundle/sdk-authoring.js +1 -1
  44. package/dist/cli-bundle/sdk-contracts.js +1 -1
  45. package/dist/cli-bundle/sdk-core.js +31 -31
  46. package/dist/cli-bundle/sdk-governance.js +1 -1
  47. package/dist/cli-bundle/sdk-graph.js +1 -1
  48. package/dist/cli-bundle/sdk-merge.js +32 -32
  49. package/dist/cli-bundle/sdk-query.js +1 -1
  50. package/dist/cli-bundle/sdk-runtime.js +1 -1
  51. package/dist/cli-bundle/sdk-testing.js +1 -1
  52. package/dist/cli-bundle/sdk.js +4 -2
  53. package/dist/core/extensions/loader.js +10 -6
  54. package/dist/core/extensions/manifest-schema.d.ts +20 -0
  55. package/dist/core/extensions/manifest-schema.js +52 -0
  56. package/dist/core/history/replay.js +32 -14
  57. package/dist/core/history/workspace-history.js +32 -10
  58. package/dist/core/output/output.js +6 -3
  59. package/dist/core/schema/fields-file.d.ts +1 -1
  60. package/dist/core/schema/fields-file.js +2 -2
  61. package/dist/core/schema/runtime-field-values.js +115 -9
  62. package/dist/core/schema/runtime-schema.d.ts +3 -1
  63. package/dist/core/schema/runtime-schema.js +124 -3
  64. package/dist/core/shared/errors.d.ts +12 -0
  65. package/dist/core/shared/errors.js +2 -2
  66. package/dist/core/shared/time.d.ts +2 -0
  67. package/dist/core/shared/time.js +27 -2
  68. package/dist/core/store/item-store.js +28 -2
  69. package/dist/sdk/agent/refusal-reachability.d.ts +56 -8
  70. package/dist/sdk/agent/refusal-reachability.js +414 -4
  71. package/dist/sdk/author-attribution.d.ts +56 -11
  72. package/dist/sdk/author-attribution.js +174 -50
  73. package/dist/sdk/cli-contracts/flag-contracts.js +5 -2
  74. package/dist/sdk/cli-contracts/tool-parameter-tables.js +12 -4
  75. package/dist/sdk/cli-contracts/tool-schema.js +12 -4
  76. package/dist/sdk/completion.js +11 -4
  77. package/dist/sdk/compose.d.ts +6 -2
  78. package/dist/sdk/compose.js +33 -3
  79. package/dist/sdk/context-intent-contracts.d.ts +8 -4
  80. package/dist/sdk/context-intent-contracts.js +76 -31
  81. package/dist/sdk/dependency-flag-validation.d.ts +9 -2
  82. package/dist/sdk/dependency-flag-validation.js +101 -35
  83. package/dist/sdk/environment/host-environment-errors.js +25 -7
  84. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +62 -14
  85. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +50 -2
  86. package/dist/sdk/governance/assurance-action.d.ts +3 -7
  87. package/dist/sdk/governance/assurance-action.js +97 -2
  88. package/dist/sdk/governance/boundary-fixtures.d.ts +86 -0
  89. package/dist/sdk/governance/boundary-fixtures.js +201 -0
  90. package/dist/sdk/governance/coverage-assurance.d.ts +24 -0
  91. package/dist/sdk/governance/coverage-assurance.js +61 -0
  92. package/dist/sdk/governance/defect-recurrence-signals.d.ts +10 -0
  93. package/dist/sdk/governance/defect-recurrence-signals.js +25 -0
  94. package/dist/sdk/governance/defect-recurrence.d.ts +242 -0
  95. package/dist/sdk/governance/defect-recurrence.js +523 -0
  96. package/dist/sdk/governance/extension-host-version.js +20 -9
  97. package/dist/sdk/governance.d.ts +2 -0
  98. package/dist/sdk/governance.js +4 -2
  99. package/dist/sdk/graph/governance.js +3 -2
  100. package/dist/sdk/guide-topics.js +191 -2
  101. package/dist/sdk/index.d.ts +5 -1
  102. package/dist/sdk/index.js +6 -3
  103. package/dist/sdk/lifecycle/create.js +4 -2
  104. package/dist/sdk/lifecycle/update-many.js +15 -2
  105. package/dist/sdk/lifecycle/update.js +5 -2
  106. package/dist/sdk/linked-artifacts.js +63 -14
  107. package/dist/sdk/query/get.d.ts +2 -0
  108. package/dist/sdk/query/get.js +32 -7
  109. package/dist/sdk/read-output-contracts.js +5 -3
  110. package/dist/sdk/relationship-analytics.js +90 -14
  111. package/dist/sdk/relationship-kinds/contract.d.ts +4 -0
  112. package/dist/sdk/relationship-kinds/contract.js +3 -2
  113. package/dist/sdk/relationships.d.ts +1 -1
  114. package/dist/sdk/relationships.js +11 -2
  115. package/dist/sdk/runtime.d.ts +2 -5
  116. package/dist/sdk/runtime.js +3 -2
  117. package/dist/sdk/schema.d.ts +1 -0
  118. package/dist/sdk/schema.js +2 -2
  119. package/dist/sdk/test/execution.d.ts +6 -2
  120. package/dist/sdk/test/execution.js +39 -13
  121. package/dist/types.d.ts +29 -2
  122. package/dist/types.js +4 -2
  123. package/docs/CONFIGURATION.md +58 -1
  124. package/docs/CONTEXT_INTEGRITY_CONTRACTS.md +58 -0
  125. package/docs/DEFECT_RECURRENCE.md +134 -0
  126. package/docs/DEPENDENCY_KIND_CONTRACT.md +12 -2
  127. package/docs/README.md +2 -0
  128. package/docs/READ_OUTPUT_CONTRACTS.md +7 -1
  129. package/docs/RELATIONSHIP_GRAPH.md +16 -2
  130. package/docs/RELEASING.md +13 -7
  131. package/docs/SDK.md +38 -5
  132. package/docs/SDK_CONTEXT_INTEGRITY.md +33 -5
  133. package/docs/SDK_CONTEXT_TRUTH_CONTRACTS.md +13 -5
  134. package/docs/SDK_RUNTIME_BOUNDARIES.md +9 -1
  135. package/docs/TESTING.md +18 -1
  136. package/docs/TRUSTWORTHY_CONTEXT_EVIDENCE.md +1 -1
  137. package/marketplace.json +2 -2
  138. package/package.json +6 -4
  139. package/packages/pm-beads/package.json +1 -1
  140. package/packages/pm-calendar/package.json +1 -1
  141. package/packages/pm-command-kit/package.json +1 -1
  142. package/packages/pm-digital-twin/package.json +1 -1
  143. package/packages/pm-governance-audit/package.json +1 -1
  144. package/packages/pm-guide-shell/package.json +1 -1
  145. package/packages/pm-kanban/package.json +1 -1
  146. package/packages/pm-lifecycle-hooks/package.json +1 -1
  147. package/packages/pm-linked-test-adapters/package.json +1 -1
  148. package/packages/pm-search-advanced/package.json +1 -1
  149. package/packages/pm-templates/package.json +1 -1
  150. package/packages/pm-todos/package.json +1 -1
  151. package/packages/pm-vcs/package.json +1 -1
  152. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  153. package/plugins/pm-claude/skills/pm-audit/SKILL.md +26 -0
  154. package/plugins/pm-claude/skills/pm-developer/SKILL.md +26 -0
  155. package/plugins/pm-claude/skills/pm-planner/SKILL.md +26 -0
  156. package/plugins/pm-claude/skills/pm-release/SKILL.md +26 -0
  157. package/plugins/pm-claude/skills/pm-workflow/SKILL.md +26 -0
  158. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  159. package/plugins/pm-codex/skills/pm-auditor/SKILL.md +26 -0
  160. package/plugins/pm-codex/skills/pm-native/SKILL.md +26 -0
  161. package/plugins/pm-codex/skills/pm-release/SKILL.md +26 -0
  162. package/sdk/public-surface.json +716 -33
  163. package/dist/cli-bundle/chunks/chunk-24GAV7XL.js +0 -8
  164. package/dist/cli-bundle/chunks/chunk-AIM6VT2N.js +0 -13
  165. package/dist/cli-bundle/chunks/chunk-DSWDLTDR.js +0 -197
  166. package/dist/cli-bundle/chunks/chunk-KIEGUBYQ.js +0 -2
  167. package/dist/cli-bundle/chunks/chunk-KLKYLSDX.js +0 -2
  168. package/dist/cli-bundle/chunks/chunk-QHPCJWEJ.js +0 -35
  169. package/dist/cli-bundle/focused-chunks/chunk-4X57RE4U.js +0 -2
  170. package/dist/cli-bundle/focused-chunks/chunk-7NJ4QYQ2.js +0 -2
  171. package/dist/cli-bundle/focused-chunks/chunk-KT5XMYSX.js +0 -4
  172. package/dist/cli-bundle/focused-chunks/chunk-OKA6ELTL.js +0 -2
  173. package/dist/cli-bundle/focused-chunks/chunk-PUISBOPP.js +0 -2
  174. package/dist/cli-bundle/focused-chunks/chunk-QLNMCESQ.js +0 -155
  175. package/dist/cli-bundle/focused-chunks/chunk-SLKC6QLJ.js +0 -2
  176. package/dist/cli-bundle/focused-chunks/chunk-U65UC4G3.js +0 -2
@@ -1,50 +1,50 @@
1
- import{a as hi,c as Ln,d as Fn,e as jo,g as Uo,h as _i,i as zo,j as Et,k as At,l as Go,m as qo,n as yi,o as Wo,p as Rt,q as It,r as Bo,s as Ho,t as wi}from"./chunk-KLVUMNXJ.js";import{a as Yo,f as Wn,g as vi}from"./chunk-EXZA4257.js";import{B as Gn,a as Do,g as fi,i as Po}from"./chunk-4X57RE4U.js";import{Z as Ms,l as Ps,n as Ns}from"./chunk-7NJ4QYQ2.js";import{$ as As,Aa as Os,Ba as Ds,Da as Ai,I as nr,J as ys,K as xi,L as nn,N as Si,R as ws,S as vs,T as bs,U as ks,V as rr,X as xs,Y as Ss,Z as Es,_ as ft,aa as Pt,ba as Rs,ca as Ei,da as Nt,e as ps,ea as Is,f as fs,fa as Cs,g as hs,t as en,u as gs,ua as $s,v as tn,va as ir,w as _s,za as Ts}from"./chunk-6XKF3PGV.js";import{a as No,b as jn,c as gi,d as Mo,e as Lo,f as Ge,g as Un,h as Fo,i as rt}from"./chunk-KTKH4IMG.js";import{$a as Qn,La as is,Qa as de,Ra as Kn,Sa as as,Ta as ki,U as Y,Ua as Yn,V as $,Va as Xn,Wa as Zn,Xa as os,Ya as Ce,Z as le,Za as ss,_a as I,b as Zo,bb as cs,d as Qo,da as ts,ea as Hn,gb as ls,ha as Jn,hb as ds,ia as ns,l as z,la as Ct,mb as er,na as $t,o as re,ob as us,pb as Tt,q as We,qa as Vn,qb as Ot,r as es,rb as Dt,s as Bn,sb as Be,tb as tr,wb as pt,xa as bi,yb as ms,za as rs}from"./chunk-QLNMCESQ.js";import{Aa as pi,Ba as To,Ca as Oo,D as xo,Da as St,E as So,F as G,Fa as De,Ha as Pe,Ja as oe,K as Qt,Ka as Ee,L,M as mt,Ma as we,N as Nn,Na as Ne,O as K,Q as Eo,R as Mn,Ra as qe,Ta as zn,V as Z,Xa as qn,Y as Ao,Ya as Vo,Za as Ko,a as ho,aa as Ro,d as go,da as di,e as _o,fa as ui,h as xt,o as li,p as A,q as Pn,r as j,ra as Io,s as X,sa as Co,t as ce,w as _e,x as Se,y as ko}from"./chunk-KT5XMYSX.js";import{b as Xo}from"./chunk-PUISBOPP.js";import{N as yo,P as wo,R as vo,U as bo,V as Dn,Y as y,Z as _,a as Tn,aa as ye,ba as $o,ca as mi,d as On,ka as Jo,t as ci}from"./chunk-OKA6ELTL.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]="d2d5135a-8110-527e-8530-653b25b792a4")}catch{}})();var N=class extends TypeError{constructor(t){super(t),this.name="AssuranceMutationRefusalError"}},ve=class extends TypeError{context;constructor(t,n={}){super(t),this.name="AssuranceEvaluationRefusalError",this.context=n}},Me=class extends TypeError{measurement_id;source_kind;field;check;constructor(t,n){super(t),this.name="AssuranceSourceResolutionError",this.measurement_id=n.measurement_id,this.source_kind=n.source_kind,this.field=n.field,this.check=n.check}};async function Mt(e){try{return await e()}catch(t){throw t instanceof N?new _(t.message,y.USAGE,{code:"invalid_argument_value",reason:"assurance_mutation_refused"}):t}}async function Ls(e){try{return await e()}catch(t){throw t instanceof ve?new _(t.message,y.USAGE,{code:"invalid_argument_value",reason:"assurance_evaluation_refused",...t.context}):t}}import{createHash as Xm}from"node:crypto";import Zm from"node:path";(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]="b911b43d-d14d-5e4f-a35e-5020b1a84542")}catch{}})();var Lt=1e3;(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]="2bf52d6d-7e4f-5ec5-86bd-3e817ef521bb")}catch{}})();var js=1,ht=["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"],Ri=["items","dependency_kind","graph","validate","health","history","links","provider","derived"],Qm=["ceiling","floor","equals","zero","monotone_nondecreasing","monotone_nonincreasing","subset_of"],ep=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/,ar=30,or=5e3,Us=4,tp=50;function He(e,t){if(!ep.test(e))throw new N(`${t} must be a stable lowercase id`)}function np(e,t){if(!Number.isFinite(e)||e<0)throw new N(`${t} must be a finite non-negative number`)}function rn(e){let t=Qm.filter(i=>e[i]!==void 0);if(t.length!==1)throw new N(`assertion ${e.id} must declare exactly one polarity`);let n=t[0],r=e[n];return{polarity:n,value:n==="zero"?0:r}}function Ii(e,t){return ye(e)===ye(t)}function zs(e,t){if(t.polarity==="equals")return Ii(e,t.value);if(t.polarity==="subset_of"){if(!Array.isArray(e)||!Array.isArray(t.value))return!1;let r=t.value;return e.every(i=>r.includes(i))}if(typeof e!="number")return!1;let n=t.value;return t.polarity==="ceiling"||t.polarity==="monotone_nonincreasing"?e<=n:t.polarity==="floor"||t.polarity==="monotone_nondecreasing"?e>=n:e===0}function Gs(e){let t=rn(e),n=e.negative_control.cases;return n.some(r=>r.expected==="pass")&&n.some(r=>r.expected==="fail")&&n.every(r=>zs(r.observed,t)===(r.expected==="pass"))}function rp(e,t){if(e.polarity!==t.polarity)return!0;if(typeof e.value=="number"&&typeof t.value=="number")return e.polarity==="ceiling"||e.polarity==="monotone_nonincreasing"?t.value>e.value:e.polarity==="floor"||e.polarity==="monotone_nondecreasing"?t.value<e.value:t.value!==e.value;if(e.polarity==="subset_of"){let n=e.value,r=t.value;return!Array.isArray(n)||!Array.isArray(r)||r.some(i=>!n.includes(i))}return!Ii(e.value,t.value)}function ip(e,t){if(e.measurement_id!==t.measurement_id||e.owner_item_id!==t.owner_item_id||ye(e.scope)!==ye(t.scope))return!0;let n={observe:0,warn:1,block:2},r=(e.lifetime??"hold")==="hold"&&(t.lifetime??"hold")==="retire";return rp(rn(e),rn(t))||n[t.enforcement]<n[e.enforcement]||r}function ap(e){if(e.state!==void 0&&!(e.state==="present"||e.state==="missing"))throw new N("items source state must be present or missing");let t=Object.hasOwn(e,"equals"),n=e.state!==void 0,r=Number(t)+Number(n);if(e.field!==void 0&&r!==1)throw new N("items source with field requires exactly one of equals or state");if(e.field===void 0&&r!==0)throw new N("items source equals/state requires field")}function Ci(e){He(e.id,"measurement.id"),e.max_cost!==void 0&&np(e.max_cost,"measurement.max_cost");let t=e.source;if(Object.prototype.toString.call(t)!=="[object Object]")throw new N(`measurement.source.kind must be one of ${Ri.join(", ")}`);let n=Reflect.get(t,"kind");if(!Ri.includes(n))throw new N(`measurement.source.kind must be one of ${Ri.join(", ")}`);let r=t;if(r.kind==="items"&&ap(r),r.kind==="dependency_kind"&&(typeof r.dependency_kind!="string"||r.dependency_kind.trim().length===0))throw new N("dependency_kind source requires dependency_kind");if((r.kind==="graph"||r.kind==="validate"||r.kind==="health")&&(typeof r.field!="string"||r.field.trim().length===0))throw new N(`${r.kind} source requires field`);return r.kind==="provider"&&(He(r.provider,"provider source provider"),He(r.key,"provider source key")),e}function $i(e){if(He(e.id,"assertion.id"),He(e.measurement_id,"assertion.measurement_id"),typeof e.owner_item_id!="string"||e.owner_item_id.trim().length===0)throw new N("assertion.owner_item_id is required");let t=rn(e);if(typeof t.value=="number"&&!Number.isFinite(t.value))throw new N(`assertion.${t.polarity} must be a finite number`);if(e.lifetime==="retire"&&(typeof e.retire_reason!="string"||e.retire_reason.trim().length===0))throw new N("retired assertion requires retire_reason");e.scope.kind==="filter"&&He(e.scope.measurement_id,"assertion.scope.measurement_id");let n=e.negative_control?.cases;if(!Array.isArray(n)||!n.some(r=>r.expected==="pass")||!n.some(r=>r.expected==="fail"))throw new N("assertion negative control requires pass and fail cases");if(!Gs(e))throw new N(`assertion ${e.id} negative control does not prove its bound`);return e}function op(e){if(!Array.isArray(e.allowed_providers))throw new N("gate provider_policy.allowed_providers must be an array");for(let t of e.allowed_providers)He(t,"gate.provider_policy.allowed_provider");if(typeof e.triggers!="object"||e.triggers===null||Array.isArray(e.triggers))throw new N("gate provider_policy.triggers must be an object");for(let[t,n]of Object.entries(e.triggers)){if(!ht.includes(t))throw new N(`gate provider policy has unknown trigger ${t}`);if(typeof n!="object"||n===null||!["low","medium","high"].includes(n.max_cost_class)||typeof n.allow_network!="boolean")throw new N(`gate provider policy trigger ${t} is invalid`)}}function qs(e){if(He(e.id,"gate.id"),!Array.isArray(e.assertion_ids))throw new N("gate.assertion_ids is required and must be an array");if(e.assertion_ids.length===0)throw new N("gate requires at least one assertion");for(let t of e.assertion_ids)He(t,"gate.assertion_id");if(!Array.isArray(e.triggers))throw new N(`gate.triggers is required and must be an array of ${ht.join(", ")}`);if(e.triggers.length===0)throw new N("gate requires at least one trigger");for(let t of e.triggers)if(!ht.includes(t))throw new N(`gate trigger must be one of ${ht.join(", ")}`);return e.provider_policy&&op(e.provider_policy),e}function Ft(e){if(e.version!==js)throw new N(`unsupported assurance document version ${String(e.version)}`);let t=new Set;for(let r of e.measurements){if(Ci(r),t.has(`measurement:${r.id}`))throw new N(`duplicate measurement ${r.id}`);t.add(`measurement:${r.id}`)}for(let r of e.assertions){if($i(r),t.has(`assertion:${r.id}`))throw new N(`duplicate assertion ${r.id}`);t.add(`assertion:${r.id}`)}for(let r of e.gates){qs(r);let i=r.assertion_ids.filter(a=>!e.assertions.some(o=>o.id===a));if(i.length>0)throw new N(`gate ${r.id} references missing assertions: ${i.join(", ")}`);if(t.has(`gate:${r.id}`))throw new N(`duplicate gate ${r.id}`);t.add(`gate:${r.id}`)}let n=new Set(e.measurements.map(r=>r.id));for(let[r,i]of Ws(e))if(!n.has(r))throw new N(`${i.join(", ")} references missing measurement ${r}`);return e}function Ti(e,t){if("measurement"in e){t.push(e.measurement);return}if("operator"in e)for(let n of e.operands)Ti(n,t)}function Ws(e){let t=new Map,n=(r,i)=>{let a=t.get(r)??[];a.push(i),t.set(r,a)};for(let r of e.assertions)n(r.measurement_id,`assertion ${r.id}`),r.scope.kind==="filter"&&n(r.scope.measurement_id,`assertion ${r.id} scope`);for(let r of e.measurements){if(r.source.kind!=="derived")continue;let i=[];Ti(r.source.expression,i);for(let a of i)n(a,`derived measurement ${r.id}`)}return t}function sp(e,t){let n=e.assertion_ids.flatMap(a=>{let o=t.assertions.find(s=>s.id===a);return[o.measurement_id,...o.scope.kind==="filter"?[o.scope.measurement_id]:[]]}),r=new Set,i=new Set;for(;n.length>0;){let a=n.pop();if(r.has(a))continue;r.add(a);let o=t.measurements.find(s=>s.id===a);o.source.kind==="provider"?i.add(o.source.provider):o.source.kind==="derived"&&Ti(o.source.expression,n)}return i}function an(){return{version:js,measurements:[],assertions:[],gates:[]}}function cp(e,t){let n=t.items.filter(r=>(e.statuses===void 0||e.statuses.includes(r.status))&&(e.types===void 0||e.types.includes(r.type))&&(e.tags===void 0||e.tags.every(i=>r.tags?.includes(i)))&&(e.field===void 0||(()=>{let i=r[e.field];if(e.state!==void 0){let a=i==null||i===""||Array.isArray(i)&&i.length===0;return e.state==="missing"?a:!a}return Ii(i,e.equals)})()));return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n.map(r=>r.id)}}function lp(e,t){let n=[],r=ui(e.dependency_kind)??e.dependency_kind.trim().toLowerCase();for(let i of t.items)for(let a of i.dependencies??[])(ui(a.kind)??a.kind.trim().toLowerCase())===r&&n.push(`${i.id}->${a.id}`);return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n}}function dp(e,t){return{value:t.history.filter(r=>(e.op===void 0||r.op===e.op)&&(e.author===void 0||r.author===e.author)&&(e.harness===void 0||r.agent_harness===e.harness)&&(e.model===void 0||r.agent_model===e.model)).length,population_size:t.history.length,cost:t.history.length}}function up(e,t){let n=t.items.filter(r=>{let i=r[e.link],a=Array.isArray(i)&&i.length>0;return e.state==="present"?a:!a});return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n.map(r=>r.id)}}function mp(e,t){let n=e.source;return n.kind==="items"?cp(n,t):n.kind==="dependency_kind"?lp(n,t):n.kind==="history"?dp(n,t):n.kind==="links"?up(n,t):null}function Bs(e,t){return e.reduce((n,r)=>({units:n.units+r.units,items_scanned:n.items_scanned+r.items_scanned,history_entries:n.history_entries+r.history_entries,provider_calls:n.provider_calls+r.provider_calls,duration_ms:t}),{units:0,items_scanned:0,history_entries:0,provider_calls:0,duration_ms:t})}function pp(e,t){if(t.length===0)throw new TypeError(`derived ${e} requires operands`);if(e==="add")return t.reduce((n,r)=>n+r,0);if(e==="subtract")return t.slice(1).reduce((n,r)=>n-r,t[0]);if(e==="multiply")return t.reduce((n,r)=>n*r,1);if(e==="divide"){if(t.slice(1).includes(0))throw new TypeError("derived divide cannot divide by zero");return t.slice(1).reduce((n,r)=>n/r,t[0])}return e==="min"?Math.min(...t):Math.max(...t)}async function Hs(e,t,n){let r=new Array(e.length),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,r[o]=await n(e[o],o)}});return await Promise.all(a),r}async function Js(e,t,n,r,i){if("literal"in e)return{value:e.literal,costs:[],population_size:0,contributors:[]};if("measurement"in e){let o=n.find(l=>l.id===e.measurement);if(!o)throw new TypeError(`derived measurement references missing ${e.measurement}`);let s=await Vs(o,t,n,r,i);if(typeof s.value!="number")throw new TypeError(`derived measurement ${o.id} is not numeric`);let c=i.charged.has(o.id)?[]:[s.cost];return i.charged.add(o.id),{value:s.value,costs:c,population_size:s.population_size,contributors:s.contributors}}let a=await Hs(e.operands,Us,o=>Js(o,t,n,r,i));return{value:pp(e.operator,a.map(o=>o.value)),costs:a.flatMap(o=>o.costs),population_size:Math.max(0,...a.map(o=>o.population_size)),contributors:[...new Set(a.flatMap(o=>o.contributors))]}}async function fp(e,t,n,r,i){Ci(e);let a=Date.now(),o,s=[],c=0;if(e.source.kind==="derived"){let u=await Js(e.source.expression,t,n,[...r,e.id],i);o={value:u.value,population_size:u.population_size,cost:0,contributors:u.contributors},s=u.costs}else{let u=mp(e,t);u!==null?o=u:(o=await t.external(e.source),c=1)}let l={units:o.cost,items_scanned:e.source.kind==="items"||e.source.kind==="dependency_kind"||e.source.kind==="links"?t.items.length:0,history_entries:e.source.kind==="history"?t.history.length:0,provider_calls:c,duration_ms:Date.now()-a},d=Bs([...s,l],Date.now()-a);if(e.max_cost!==void 0&&d.units>e.max_cost)throw new ve(`measurement ${e.id} exceeded cost ceiling ${e.max_cost} with ${d.units}`);return{id:e.id,definition_fingerprint:`sha256:${Xm("sha256").update(ye(e)).digest("hex")}`,value:o.value,population_size:o.population_size,cost:d,contributors:o.contributors??[]}}function Vs(e,t,n,r,i){if(r.includes(e.id))throw new TypeError(`derived measurement cycle: ${[...r,e.id].join(" -> ")}`);let a=i.cache.get(e.id);if(a)return a;let o=fp(e,t,n,r,i).catch(s=>{if(s instanceof Me&&s.measurement_id===void 0){let c={measurement_id:e.id,source_kind:s.source_kind,field:s.field,...s.check?{check:s.check}:{}},l=new Me(s.message,c);throw l.cause=s,l}throw s});return i.cache.set(e.id,o),o}async function Oi(e,t,n=[e]){return Vs(e,t,n,[],{cache:new Map,charged:new Set})}function hp(e,t){return typeof e!="number"||typeof t.value!="number"?null:t.polarity==="ceiling"||t.polarity==="monotone_nonincreasing"?t.value-e:(t.polarity==="floor"||t.polarity==="monotone_nondecreasing",e-t.value)}function gp(e,t,n={}){$i(e);let r=rn(e),i=e.lifetime==="retire"&&n.owner_terminal===!0;return{assertion_id:e.id,measurement_id:e.measurement_id,measurement_definition_fingerprint:t.definition_fingerprint,scope:e.scope,population_size:t.population_size,observed:t.value,bound:r,distance:hp(t.value,r),verdict:i?"retired":zs(t.value,r)?"pass":"fail",enforcement:e.enforcement,negative_control_proven:Gs(e),cost:t.cost,contributors:t.contributors}}function _p(e,t,n,r){let i=sp(e,t);if(i.size===0)return;let a=e.provider_policy,o=a?.triggers[r];if(!a||!o)throw new ve(`assurance gate ${e.id} refuses provider execution at trigger ${r} without an explicit provider policy`);let s=new Set(a.allowed_providers),c={low:0,medium:1,high:2};for(let l of i){if(!s.has(l))throw new ve(`assurance gate ${e.id} refuses provider ${l}`);let d=n.provider_capabilities?.[l];if(!d)throw new ve(`assurance provider ${l} has no declared capabilities`);if(c[d.cost_class]>c[o.max_cost_class])throw new ve(`assurance gate ${e.id} refuses ${d.cost_class}-cost provider ${l} at trigger ${r}`);if(d.network&&!o.allow_network)throw new ve(`assurance gate ${e.id} refuses network provider ${l} at trigger ${r}`)}}async function Fs(e,t,n,r,i){try{return await Oi(n,r,i)}catch(a){if(a instanceof Me){let o=a.check?` check ${a.check}`:"",s=a.measurement_id??n.id,c=new ve(`assurance gate ${e} assertion ${t} measurement ${s} source ${a.source_kind}${o} field ${a.field} could not resolve: ${a.message}`,{gate_id:e,assertion_id:t,measurement_id:s,source_kind:a.source_kind,field:a.field,...a.check?{check:a.check}:{}});throw c.cause=a,c}throw a}}async function Ks(e,t,n,r){Ft(t);let i=t.gates.find(c=>c.id===e);if(!i)throw new ve(`assurance gate ${e} not found`);if(!i.triggers.includes(r.trigger))throw new ve(`assurance gate ${e} does not declare trigger ${r.trigger}`);_p(i,t,n,r.trigger);let a=await Hs(i.assertion_ids,Us,async c=>{let l=t.assertions.find(f=>f.id===c),d=t.measurements.find(f=>f.id===l.measurement_id),u=n;if(l.scope.kind==="active"){let f=new Set(n.terminal_statuses??["closed","canceled"]);u={...n,items:n.items.filter(g=>!f.has(g.status))}}else if(l.scope.kind==="filter"){let f=l.scope.measurement_id,g=t.measurements.find(v=>v.id===f),h=await Fs(i.id,l.id,g,n,t.measurements),w=new Set(h.contributors);u={...n,items:n.items.filter(v=>w.has(v.id))}}let m=n.items.find(f=>f.id===l.owner_item_id),p=m!==void 0&&new Set(n.terminal_statuses??["closed","canceled"]).has(m.status);return gp(l,await Fs(i.id,l.id,d,u,t.measurements),{owner_terminal:p})}),o=a.some(c=>c.verdict==="fail"&&c.enforcement==="block"),s=a.some(c=>c.verdict==="fail"&&c.enforcement==="warn");return{gate_id:i.id,tree_id:n.tree_id,trigger:r.trigger,dry_run:r.dry_run===!0,evaluated_at:new Date().toISOString(),verdict:o?"block":s?"warn":"pass",exit_code:o?1:0,assertions:a,assertions_total:a.length,row_contract:{row_keys:["assertions"],jq_selector:".assertions[]"},cost:Bs(a.map(c=>c.cost),Math.max(0,...a.map(c=>c.cost.duration_ms)))}}function sr(e){return Zm.join(e,"assurance.json")}async function Ys(e){let t=await X(sr(e));return t===null?an():cr(t)}function cr(e){try{return Ft(JSON.parse(e))}catch(t){throw new _("The assurance registry is invalid. Repair or restore .agents/pm/assurance.json and retry.",y.GENERIC_FAILURE,{code:"assurance_registry_invalid",reason:String(t),nextSteps:["Restore a valid assurance.json from version control or repair its declaration references.","Run pm assurance list measurement after the repair."]})}}function lr(e,t){return t==="measurement"?e.measurements:t==="assertion"?e.assertions:e.gates}function yp(e,t){e==="measurement"?Ci(t):e==="assertion"?$i(t):qs(t)}async function on(e,t){let n=structuredClone(lr(await Ys(e),t));return{items:n,count:n.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function Di(e,t,n){let r=lr(await Ys(e),t).find(i=>i.id===n);if(!r)throw new TypeError(`assurance ${t} ${n} not found`);return structuredClone(r)}async function dr(e,t,n,r={}){yp(t,n);let i=await I(e),a=Y(r.author,i.author_default),o=await Xn({pmRoot:e,filePath:sr(e),op:`assurance:${t}:put`,author:a,message:r.message,lockTtlSeconds:ar,lockWaitMs:or,mutate:s=>{let c=s===null?an():cr(s),l=lr(c,t),d=l.findIndex(m=>m.id===n.id),u=d<0?"created":"updated";if(t==="assertion"&&d>=0&&ip(l[d],n)){let m=n.authorization_decision;if(!m||!r.authorized_decision_ids?.includes(m))throw new N(`loosening assertion ${n.id} requires a verified authorization_decision`)}return d<0?l.push(structuredClone(n)):l[d]=structuredClone(n),Ft(c),{raw:`${JSON.stringify(c,null,2)}
2
- `,result:{changed:!0,action:u,kind:t,id:n.id}}}});return{...o.result,changed:o.changed}}async function Pi(e,t,n={}){let r=an();r.measurements=structuredClone(t.measurements),r.assertions=structuredClone(t.assertions),r.gates=structuredClone(t.gates),Ft(r);let i=await I(e),a=Y(n.author,i.author_default),o=await Xn({pmRoot:e,filePath:sr(e),op:"assurance:bundle:apply",author:a,message:n.message,lockTtlSeconds:ar,lockWaitMs:or,mutate:s=>{let c=s===null?an():cr(s),l=[],d=[],u=(m,p,f)=>{for(let g of p){let h=m.find(w=>w.id===g.id);if(!h){m.push(structuredClone(g)),l.push(`${f}:${g.id}`);continue}if(ye(h)!==ye(g))throw new N(`assurance bundle refuses to replace divergent ${f} ${g.id}`);d.push(`${f}:${g.id}`)}};return u(c.measurements,r.measurements,"measurement"),u(c.assertions,r.assertions,"assertion"),u(c.gates,r.gates,"gate"),Ft(c),{raw:`${JSON.stringify(c,null,2)}
3
- `,result:{changed:l.length>0,created_ids:l,unchanged_ids:d}}}});return{...o.result,changed:o.changed}}async function Xs(e,t,n,r={}){let i=await I(e),a=Y(r.author,i.author_default),o=await Xn({pmRoot:e,filePath:sr(e),op:`assurance:${t}:remove`,author:a,message:r.message,lockTtlSeconds:ar,lockWaitMs:or,mutate:s=>{let c=s===null?an():cr(s);if(t==="measurement"){let u=Ws(c).get(n);if(u&&u.length>0)throw new N(`assurance measurement ${n} is referenced by ${u.join(", ")}`)}if(t==="assertion"&&c.gates.some(u=>u.assertion_ids.includes(n)))throw new N(`assurance assertion ${n} is referenced by gate`);let l=lr(c,t),d=l.findIndex(u=>u.id===n);if(d<0)throw new N(`assurance ${t} ${n} not found`);return l.splice(d,1),Ft(c),{raw:`${JSON.stringify(c,null,2)}
4
- `,result:{changed:!0,action:"removed",kind:t,id:n}}}});return{...o.result,changed:o.changed}}async function Zs(e,t,n={}){if(t.dry_run)throw new TypeError("dry-run assurance verdicts are not persisted");let r=await I(e);await Yn({pmRoot:e,op:"assurance:gate:verdict",author:Y(n.author,r.author_default),context:{assurance_verdict:t},message:n.message??`Assurance gate ${t.gate_id} returned ${t.verdict}`,lockTtlSeconds:ar,lockWaitMs:or})}async function Qs(e,t={}){let n=t.limit??tp;if(!Number.isInteger(n)||n<1||n>Lt)throw new TypeError(`assurance verdict limit must be an integer from 1 through ${Lt}`);return(await Vn(Kn(e),de)).reverse().filter(i=>i.op==="assurance:gate:verdict").map(i=>i.context?.assurance_verdict).filter(i=>typeof i=="object"&&i!==null&&"gate_id"in i).filter(i=>t.gate_id===void 0||i.gate_id===t.gate_id).slice(0,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]="05c29627-6763-5aee-8579-71e563a98780")}catch{}})();var mr=["software-delivery","research","agent-evaluation","operations"];function ec(e,t,n,r,i){return{id:e,measurement_id:t,owner_item_id:n,scope:{kind:"active"},ceiling:r,lifetime:"hold",enforcement:i,negative_control:{cases:[{observed:r,expected:"pass"},{observed:r+1,expected:"fail"}]}}}function ur(e,t,n,r,i){let a=`preset-${e}`,o=i.map(c=>({id:`${a}-missing-${c}`,description:`Active items missing ${c} evidence.`,source:{kind:"links",link:c,state:"missing"}})),s=o.map(c=>ec(`${c.id}-zero`,c.id,r,0,"warn"));return{id:e,title:t,description:n,declarations:{measurements:o,assertions:s,gates:[{id:`${a}-readiness`,description:n,assertion_ids:s.map(c=>c.id),triggers:["ci","scheduled"]}]}}}function pr(e,t){return e==="software-delivery"?ur(e,"Software delivery","Warn when active delivery work lacks executable tests or documentation.",t,["tests","docs"]):e==="research"?ur(e,"Research","Warn when active research work lacks reproducibility files or documentation.",t,["files","docs"]):e==="agent-evaluation"?ur(e,"Agent evaluation","Warn when active evaluation work lacks executable scenarios or recorded artifacts.",t,["tests","files"]):ur(e,"Operations","Warn when active operational work lacks runbook documentation or repair evidence.",t,["docs","files"])}function tc(e,t,n,r={}){return Pi(e,pr(t,n).declarations,r)}async function nc(e,t){let n=new Set(e.terminal_statuses??["closed","canceled"]),r={...e,items:e.items.filter(a=>!n.has(a.status))};return await Promise.all(["files","tests","docs"].map(async a=>{let o={id:`derived-active-missing-${a}`,description:`Observed active items missing ${a} evidence.`,source:{kind:"links",link:a,state:"missing"}},c=(await Oi(o,r)).value,l=ec(`${o.id}-ceiling`,o.id,t,c,"observe"),d=`active-missing-${a}`;return{id:d,population_size:r.items.length,scope:{kind:"active"},observed:c,declarations:{measurements:[o],assertions:[l],gates:[{id:`derived-${d}`,description:`Observe the accepted ${a} evidence baseline.`,assertion_ids:[l.id],triggers:["ci","scheduled"]}]}}}))}function rc(e,t,n={}){return Pi(e,{measurements:t.flatMap(r=>r.declarations.measurements),assertions:t.flatMap(r=>r.declarations.assertions),gates:t.flatMap(r=>r.declarations.gates)},n)}async function ic(e,t,n,r={}){let i=t.enforcement==="observe"?"warn":"block";if(t.enforcement==="block"||n!==i)throw new TypeError(`assurance assertion ${t.id} promotion must be ${t.enforcement} -> ${i}`);return dr(e,"assertion",{...t,enforcement:n},{...r,message:r.message??`Promote assurance assertion ${t.id} from ${t.enforcement} to ${n}`})}import wp from"node:fs/promises";import{createRequire as vp}from"node:module";import me from"node:path";(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]="b55cafdc-9a3b-5386-bd85-cbd2311a5933")}catch{}})();function ac(e,t){let n=me.relative(t,e);if(n.length>0&&n!==".."&&!n.startsWith(`..${me.sep}`)&&!me.isAbsolute(n))return n.split(me.sep).join("/");let r=me.resolve(e),i=0xcbf29ce484222325n;for(let o=0;o<r.length;o+=1)i^=BigInt(r.charCodeAt(o)),i=BigInt.asUintN(64,i*0x100000001b3n);return`<external>/${i.toString(16).padStart(16,"0")}/${me.basename(me.dirname(e))}/package.json`}function bp(e){return e.includes(`${me.sep}.pnpm${me.sep}`)?"pnpm":e.includes(`${me.sep}node_modules${me.sep}`)?"npm":"other"}async function oc(e){try{let t=JSON.parse(await wp.readFile(e,"utf8"));return t.name==="@unbrained/pm-cli"&&typeof t.version=="string"&&t.version.trim().length>0?t.version.trim():void 0}catch{return}}async function sc(e,t,n=Se(import.meta.url,["../../.."])){let r=me.join(n,"package.json"),i=await oc(r),a=new Map;i!==void 0&&a.set(me.resolve(r),{version:i,path:ac(r,t),layout:"host",consumers:["pm-cli-host"]});for(let c of e)try{let l=vp(c.entry_path).resolve("@unbrained/pm-cli/package.json"),d=await oc(l);if(d===void 0)continue;let u=me.resolve(l),m=a.get(u);if(m){m.consumers.includes(c.name)||(m.consumers.push(c.name),m.consumers.sort((p,f)=>p.localeCompare(f)));continue}a.set(u,{version:d,path:ac(l,t),layout:bp(l),consumers:[c.name]})}catch{}let o=[...a.values()].sort((c,l)=>c.path.localeCompare(l.path)),s=i===void 0?[]:o.filter(c=>c.version!==i);return{host_version:i??null,copies:o,mismatches:s,warnings:s.map(c=>`extension_host_pm_cli_version_skew:${i}:${c.version}:${c.consumers.join("+")}`)}}import gr from"node:fs/promises";import _r from"node:path";import{Option as yS}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]="8d60b13c-c58a-506f-adc9-2414dd69edef")}catch{}})();function kp(e,t){let n=[],r=new Set;for(let i of t.keys){if(!Object.hasOwn(e,i))continue;let a=e[i];if(a!=null){if(typeof a=="string"){n.push(a);continue}if(!Array.isArray(a)||!a.every(o=>typeof o=="string"))return;r.has(a)||(r.add(a),n.push(...a))}}return n.length>0?n.join("; "):void 0}function fr(e,t){return e.find(r=>r.target===t)??{target:t,keys:[t]}}function P(e,t){return e[t]===!0?!0:void 0}function Je(e,t){return e[t]===!1?!0:void 0}function cc(e,t){return t.some(n=>e[n]===!0)?!0:void 0}function lc(e,t){for(let[n,r]of Object.entries(t))n==="__proto__"||n==="constructor"||n==="prototype"||Object.hasOwn(e,n)||(e[n]=r)}function dc(e){let t=i=>fi(e,fr(Wn,i)),n=i=>Po(e,fr(vi,i)),r={title:t("title"),description:t("description"),body:t("body"),status:t("status"),closeReason:t("closeReason"),priority:t("priority"),type:t("type"),tags:t("tags"),addTags:n("addTags"),removeTags:n("removeTags"),deadline:t("deadline"),estimatedMinutes:t("estimatedMinutes"),acceptanceCriteria:kp(e,fr(vi,"acceptanceCriteria")),addAc:n("addAc"),removeAc:n("removeAc"),definitionOfReady:t("definitionOfReady"),order:t("order"),rank:t("rank"),goal:t("goal"),objective:t("objective"),value:t("value"),impact:t("impact"),outcome:t("outcome"),whyNow:t("whyNow"),author:t("author"),message:t("message"),force:!!e.force,ownershipMetadataBypass:e.ownershipMetadataBypass===!0?!0:void 0,ownershipDependencyBypass:e.ownershipDependencyBypass===!0?!0:void 0,assignee:t("assignee"),parent:t("parent"),allowUnresolvedDeps:cc(e,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,reviewer:t("reviewer"),risk:t("risk"),confidence:t("confidence"),sprint:t("sprint"),release:t("release"),blockedBy:t("blockedBy"),blockedReason:t("blockedReason"),unblockNote:t("unblockNote"),reporter:t("reporter"),severity:t("severity"),environment:t("environment"),reproSteps:t("reproSteps"),resolution:t("resolution"),expectedResult:t("expectedResult"),actualResult:t("actualResult"),affectedVersion:t("affectedVersion"),fixedVersion:t("fixedVersion"),component:t("component"),regression:e.regression===!0?"true":t("regression"),customerImpact:t("customerImpact"),dep:n("dep"),depRemove:n("depRemove"),replaceDeps:P(e,"replaceDeps"),replaceTests:P(e,"replaceTests"),replaceFiles:P(e,"replaceFiles"),replaceDocs:P(e,"replaceDocs"),comment:n("comment"),note:n("note"),learning:n("learning"),file:n("file"),test:n("test"),doc:n("doc"),reminder:n("reminder"),event:n("event"),typeOption:n("typeOption"),field:n("field"),unset:n("unset"),clearDeps:P(e,"clearDeps"),clearComments:P(e,"clearComments"),clearNotes:P(e,"clearNotes"),clearLearnings:P(e,"clearLearnings"),clearFiles:P(e,"clearFiles"),clearTests:P(e,"clearTests"),clearDocs:P(e,"clearDocs"),clearReminders:P(e,"clearReminders"),clearEvents:P(e,"clearEvents"),clearTypeOptions:P(e,"clearTypeOptions")};return lc(r,e),r}function Q(e,t){let n=fr(Do,t),r=fi(e,n);if(r!==void 0)return r;for(let i of n.keys){let a=e[i];if(Array.isArray(a)){let o=a.filter(s=>typeof s=="string");if(o.length>0)return o.join(",")}if(t==="ids"&&typeof a=="string")return a;if(typeof a=="number"&&Number.isFinite(a))return String(a)}}function xp(e){let t=P(e,"filterFilesMissing"),n=P(e,"filterDocsMissing");return{filterReviewerMissing:P(e,"filterReviewerMissing"),filterRiskMissing:P(e,"filterRiskMissing"),filterConfidenceMissing:P(e,"filterConfidenceMissing"),filterSprintMissing:P(e,"filterSprintMissing"),filterReleaseMissing:P(e,"filterReleaseMissing"),hasNotes:P(e,"hasNotes"),hasLearnings:P(e,"hasLearnings"),hasFiles:P(e,"hasFiles"),hasDocs:P(e,"hasDocs"),hasTests:P(e,"hasTests"),hasComments:P(e,"hasComments"),hasDeps:P(e,"hasDeps"),hasBody:P(e,"hasBody"),hasLinkedCommand:P(e,"hasLinkedCommand"),noNotes:Je(e,"notes"),noLearnings:Je(e,"learnings"),noFiles:Je(e,"files")??t,filterFilesMissing:t,noDocs:Je(e,"docs")??n,filterDocsMissing:n,noTests:Je(e,"tests"),noComments:Je(e,"comments"),noDeps:Je(e,"deps"),emptyBody:P(e,"emptyBody"),noLinkedCommand:Je(e,"linkedCommand")}}function Ni(e){let t={status:Q(e,"status"),type:Q(e,"type"),tag:Q(e,"tag"),priority:Q(e,"priority"),deadlineBefore:Q(e,"deadlineBefore"),deadlineAfter:Q(e,"deadlineAfter"),updatedAfter:Q(e,"updatedAfter"),updatedBefore:Q(e,"updatedBefore"),createdAfter:Q(e,"createdAfter"),createdBefore:Q(e,"createdBefore"),today:P(e,"today"),recent:P(e,"recent"),ids:Q(e,"ids"),assignee:Q(e,"assignee"),assigneeFilter:Q(e,"assigneeFilter"),parent:Q(e,"parent"),sprint:Q(e,"sprint"),release:Q(e,"release"),limit:Q(e,"limit"),offset:Q(e,"offset"),noTruncate:Je(e,"truncate"),includeBody:P(e,"includeBody"),strictRead:P(e,"strictRead"),compact:P(e,"compact"),brief:P(e,"brief"),full:P(e,"full"),fields:Q(e,"fields"),sort:Q(e,"sort"),order:Q(e,"order"),tree:P(e,"tree"),treeDepth:Q(e,"treeDepth"),filterAcMissing:P(e,"filterAcMissing"),filterEstimatesMissing:cc(e,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:P(e,"filterResolutionMissing"),filterMetadataMissing:P(e,"filterMetadataMissing"),...xp(e)};return lc(t,e),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]="0e153ece-4fc0-5134-97f0-c2315aff0031")}catch{}})();function C(e,t){let n=e[t];return typeof n=="string"&&n.trim().length>0?n:void 0}function ee(e,t){let n=e[t];return typeof n=="string"?n.trim().length>0?n:void 0:typeof n=="number"&&Number.isFinite(n)?String(n):void 0}function Sp(e,t){let n=e[t];return typeof n=="string"?n:typeof n=="number"&&Number.isFinite(n)?String(n):void 0}function sn(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function Fi(e,t){if(typeof e=="number"){if(!Number.isInteger(e))throw new _(`${t} must be a finite integer.`,y.USAGE);return e}if(typeof e=="string"&&e.trim().length>0){let n=Number(e);if(!Number.isInteger(n))throw new _(`${t} must be a finite integer.`,y.USAGE);return n}}function RS(e,t){return typeof e.limit=="number"&&Number.isFinite(e.limit)?e.limit:typeof t.limit=="number"&&Number.isFinite(t.limit)?t.limit:C(e,"limit")??C(t,"limit")}function IS(e){let t=C(e,"outputFormat");return{json:!0,quiet:!0,author:C(e,"author"),path:C(e,"path"),noExtensions:e.noExtensions===!0||e.no_extensions===!0,noPager:!0,outputInclude:C(e,"outputInclude"),outputLimit:ee(e,"outputLimit"),outputBudget:ee(e,"outputBudget"),outputSession:C(e,"outputSession"),outputCursor:C(e,"outputCursor"),outputFormat:t==="json"||t==="toon"?t:void 0}}var Ep=new Set(["tags","blockedBy","blocked_by","skills","fields"]),Ap=new Set(["comment","note","learning","reminder","event","dep","depRemove","dep_remove","file","doc","test","unset","addGlob","add_glob","migrate","envSet","env_set","envClear","env_clear"]),Rp=new Set(["files","files-discover","docs","test","test-all"]),Ip=new Set(["claim","release","start-task","pause-task","close-task"]),Cp={list:["status","type","tag","priority","limit","offset"],search:["mode","status","type","tag","priority","limit"],create:["title","type","status","description","body","priority","tags","parent","createMode","create_mode","allowMissingParent","allowDuplicate"],update:["parent","allowMissingParent","completedAt"],copy:["allowDuplicate"],close:["duplicateOf","completedAt"],append:["body"]},$p=["outputInclude","outputLimit","outputBudget","outputFormat","outputSession","outputCursor"];function mc(e,t){let n={},r=t!==void 0&&Rp.has(t),i=t==="files"||t==="files-discover"||t==="docs";for(let[a,o]of Object.entries(e)){if(Array.isArray(o)&&Ep.has(a)){n[a]=o.join(",");continue}if(a==="note"&&i){n[a]=o;continue}if(typeof o=="string"&&Ap.has(a)){n[a]=[o];continue}if(typeof o=="string"&&r&&(a==="add"||a==="remove")){n[a]=[o];continue}n[a]=o}return n}function CS(e,t){let n=Ro(e.options),r={},i=c=>{n[c]!==void 0||e[c]===void 0||(r[c]=e[c])};for(let c of Cp[t??""]??[])i(c);for(let c of $p)i(c);let a=mc({...r,...n},t),o=C(e,"author"),s=t!==void 0&&Ip.has(t)?C(e,"assignee")??C(a,"assignee"):void 0;return o&&a.author===void 0?{...a,author:o}:s&&a.author===void 0?{...a,author:s}:a}function $S(e){if(e.addNote===void 0)return e;let t={...e};return t.note===void 0&&typeof t.addNote=="string"&&(t.note=t.addNote),delete t.addNote,t}function TS(e){let t={...e};return t.discoveryNote!==void 0&&t.note===void 0&&typeof t.discoveryNote=="string"&&(t.note=t.discoveryNote),delete t.discover,delete t.discoveryNote,t}function OS(e){let t=[],n=!0;for(let r of e.trim().toLowerCase()){if(r>="a"&&r<="z"||r>="0"&&r<="9"){t.push(r),n=!1;continue}n||(t.push("-"),n=!0)}return t.at(-1)==="-"&&t.pop(),t.join("")}function DS(e){return e.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ")}function ji(e){return Array.isArray(e)?e.map(t=>String(t)).filter(t=>t.length>0):[]}function PS(e,t){let n=new Set(["action","args","author","cwd","fullChangedFields","id","options","path","query","reason","target"]),r={};for(let[a,o]of Object.entries(e))n.has(a)||(r[a]=o);let i={...r,...t};return delete i.args,i}function NS(e,t){return{changedFields:e.fullChangedFields===!0?"full":"compact",idOnly:e.idOnly===!0,runnerOptions:{...t}}}function Li(e){return{type:ee(e,"filterType"),tag:ee(e,"filterTag"),priority:ee(e,"filterPriority"),deadlineBefore:ee(e,"filterDeadlineBefore"),deadlineAfter:ee(e,"filterDeadlineAfter"),updatedAfter:ee(e,"filterUpdatedAfter"),updatedBefore:ee(e,"filterUpdatedBefore"),createdAfter:ee(e,"filterCreatedAfter"),createdBefore:ee(e,"filterCreatedBefore"),ids:Sp(e,"ids"),assignee:ee(e,"filterAssignee"),assigneeFilter:ee(e,"filterAssigneeFilter")??ee(e,"filterAssignee_filter"),parent:ee(e,"filterParent"),sprint:ee(e,"filterSprint"),release:ee(e,"filterRelease"),limit:ee(e,"limit"),offset:ee(e,"offset")}}function Mi(e){if(typeof e=="string"&&e.trim().length>0)return e;if(Array.isArray(e))return ji(e)}function hr(e){if(typeof e=="number"&&Number.isFinite(e)||typeof e=="string"&&e.trim().length>0)return e}function MS(e){let t=Mi(e.kind),n=Mi(e.exemptIsolate),r=Mi(e.exemptIsolateType);return{...t===void 0?{}:{kind:t},maxDepth:hr(e.maxDepth),limit:hr(e.limit),after:C(e,"after"),direction:C(e,"direction"),maxPaths:hr(e.maxPaths),sample:hr(e.sample),...n===void 0?{}:{exemptIsolate:n},...r===void 0?{}:{exemptIsolateType:r},saveBaseline:e.saveBaseline===!0,rebuild:e.rebuild===!0,clear:e.clear===!0,summary:e.summary===!0,...e.full===!0?{full:!0}:{}}}function LS(e){return{status:C(e,"filterStatus"),list:sn(e.list)?Ni(e.list):Li(e),reason:C(e,"reason"),resolution:C(e,"resolution"),expectedResult:C(e,"expectedResult")??C(e,"expected_result")??C(e,"expected"),actualResult:C(e,"actualResult")??C(e,"actual_result")??C(e,"actual"),validateClose:C(e,"validateClose")??C(e,"validate_close"),author:C(e,"author"),message:C(e,"message"),force:e.force===!0?!0:void 0,dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 0}}var Tp=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","ids","list","update","limit","offset","dryRun","dry_run","rollback","checkpoint","noCheckpoint","no_checkpoint"]);function uc(e){let t={};for(let[n,r]of Object.entries(e))Tp.has(n)||(t[n]=r);return pc(t)}function pc(e){let t=mc(e,"update-many");for(let n of Wn)for(let r of n.keys){let i=t[r];typeof i=="number"&&Number.isFinite(i)&&(t[r]=String(i))}return dc(t)}function FS(e){if(sn(e.list)||sn(e.update)){let t=sn(e.update)?e.update:uc(e);return{status:ee(e,"filterStatus"),list:sn(e.list)?Ni(e.list):Li(e),update:pc(t),dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 0}}return{status:ee(e,"filterStatus"),list:Li(e),update:uc(e),dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 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]="4fd16197-979e-5269-bed7-f2fb0e2038c2")}catch{}})();function Ve(e,t){throw new _(e,y.USAGE,t)}var Op="2026-07-15T06:22:12.276Z",Dp=Date.parse(Op),Pp=[["attributed","attributed"],["legacy_unknown","actionable_unknown"]],fc=e=>typeof e=="string"?e:"",hc=e=>{let t=e??{},n=fc(t.author).trim().toLowerCase(),r=Number(["","unknown"].includes(n)),i=+(Date.parse(fc(t.ts))>=Dp);return Pp[r][i]};function gc(e,t,n=20,r=new Set,i=!1){let a=[],o=[],s={legacy_unknown:0,actionable_unknown:0},c=Math.max(0,n),l=0,d=0,u=0;for(let[m,p]of t.split(/\r?\n/).entries()){let f;try{f=JSON.parse(p)}catch{continue}l+=1;let g=hc(f);if(g!=="attributed"){if(d+=1,g==="actionable_unknown"&&r.has(`${e}:${m+1}`)){u+=1;continue}s[g]+=1,i&&g==="actionable_unknown"&&o.push({item_id:e,line:m+1}),a.length<c&&a.push({item_id:e,line:m+1})}}return{checked_events:l,unknown_event_count:d,legacy_unknown_event_count:s.legacy_unknown,actionable_unknown_event_count:s.actionable_unknown,acknowledged_actionable_event_count:u,samples:a,samples_truncated:s.legacy_unknown+s.actionable_unknown>a.length,actionable_events:o}}var JS=(e,t,n=20,r=new Set)=>gc(e,t,n,r);function Np(e){let t=new Set;for(let n of e.split(/\r?\n/)){let r;try{r=JSON.parse(n)}catch{continue}let a=(typeof r=="object"&&r!==null&&typeof r.context=="object"&&r.context!==null?r.context:{}).author_acknowledgment;if(!(typeof a!="object"||a===null||!Array.isArray(a.events)))for(let o of a.events)typeof o=="object"&&o!==null&&typeof o.item_id=="string"&&Number.isSafeInteger(o.line)&&t.add(`${o.item_id}:${String(o.line)}`)}return t}var cn=async(e,t=20,n=!1)=>{let r=_r.join(e,"history"),i;try{i=(await gr.readdir(r)).filter(w=>w.endsWith(".jsonl")).sort((w,v)=>w.localeCompare(v))}catch{i=[]}let a=new Set,o=[],s=[],c=0,l=0,d=0,u=0,m=0,p=0,f="_workspace.jsonl",g=new Set;if(i.includes(f))try{g=Np(await gr.readFile(_r.join(r,f),"utf8"))}catch{g=new Set}for(let w of i){let v;try{v=await gr.readFile(_r.join(r,w),"utf8")}catch{continue}let b=w.slice(0,-6),x=gc(b,v,t-o.length,g,n);c+=1,l+=x.checked_events,d+=x.unknown_event_count,u+=x.legacy_unknown_event_count,m+=x.actionable_unknown_event_count,p+=x.acknowledged_actionable_event_count,x.unknown_event_count>0&&a.add(b),o.push(...x.samples),n&&s.push(...x.actionable_events)}let h=u+m;return{checked_streams:c,checked_events:l,unknown_event_count:d,legacy_unknown_event_count:u,actionable_unknown_event_count:m,acknowledged_actionable_event_count:p,affected_item_ids:[...a].sort((w,v)=>w.localeCompare(v)),samples:o,samples_truncated:h>o.length,...n?{actionable_events:s}:{}}};function Mp(e,t){let n=e.length>0;return n&&t&&Ve("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_conflict",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']}),!n&&!t&&Ve("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_required",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']}),{events:Lp(e),all_actionable:t}}function Lp(e){return e.map(t=>{let n=t.lastIndexOf(":"),r=t.slice(0,n).trim(),i=Number(t.slice(n+1)),a=r===de||/^[a-z0-9][a-z0-9-]*$/iu.test(r);return(n<1||!a||!Number.isSafeInteger(i)||i<1)&&Ve(`history-author-acknowledge --event expects <item-id>:<one-based-line>, received "${t}".`,{code:"history_author_acknowledge_target_unreadable"}),{item_id:r,line:i}})}function VS(e,t){let n=Mp(ji(t.historyEvent),t.allActionable===!0||t.all_actionable===!0);return Fp(e,{events:n.events,all_actionable:n.all_actionable,attributed_author:C(t,"attributedAuthor")??C(t,"attributed_author")??"",reviewer:C(t,"reviewer")??"",reason:C(t,"reason")??""})}async function Fp(e,t){let n=t.reviewer.trim(),r=t.attributed_author.trim(),i=t.reason.trim(),a=t.events??[],o=+(t.all_actionable===!0)+ +(a.length>0);o===0&&Ve("Specify exactly one selector: events or all_actionable.",{code:"history_author_acknowledge_selector_required"}),o>1&&Ve("Author acknowledgment accepts either explicit events or all_actionable, not both.",{code:"history_author_acknowledge_selector_conflict"});let s=t.all_actionable===!0?(await cn(e,0,!0)).actionable_events:a;[s.length>0,n.length>0,n.toLowerCase()!=="unknown",r.length>0,r.toLowerCase()!=="unknown",i.length>0].includes(!1)&&Ve("Author acknowledgment requires events, reviewer, attributed_author, and reason.",{code:"history_author_acknowledge_required_values_missing"});let l=[...new Map(s.map(m=>[`${m.item_id}:${m.line}`,{item_id:m.item_id,line:m.line}])).values()].sort((m,p)=>m.item_id.localeCompare(p.item_id)||m.line-p.line);for(let m of l){[m.item_id===de||/^[a-z0-9][a-z0-9-]*$/i.test(m.item_id),Number.isSafeInteger(m.line),m.line>=1].includes(!1)&&Ve(`Unknown-author acknowledgment target ${m.item_id}:${m.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"});let f;try{let h=(await gr.readFile(_r.join(e,"history",`${m.item_id}.jsonl`),"utf8")).split(/\r?\n/)[m.line-1];f=JSON.parse(h??"")}catch{Ve(`Unknown-author acknowledgment target ${m.item_id}:${m.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}hc(f)!=="actionable_unknown"&&Ve(`Author acknowledgment target ${m.item_id}:${m.line} is not an actionable unknown-author event.`,{code:"history_author_acknowledge_target_not_actionable"})}let d=await I(e),u=await Yn({pmRoot:e,op:"history:author-acknowledge",author:n,context:{author_acknowledgment:{events:l,attributed_author:r}},message:i,lockTtlSeconds:d.locks.ttl_seconds,lockWaitMs:d.locks.wait_ms});return{acknowledged:l.length,history_path:u.historyPath}}import Ui from"node:fs/promises";import zi from"node:path";(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]="6efed404-acd2-5c3a-a008-856df67c8b77")}catch{}})();var jp=8388608,Up=new Set(["resolved","failed"]),zp=[{kind:"boolean",matches:e=>typeof e=="boolean"||typeof e=="string"&&/^(?:true|false)$/iu.test(e.trim())},{kind:"single_digit",matches:e=>typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=9||typeof e=="string"&&/^\d$/u.test(e.trim())}];function Le(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Gi(e){return zp.find(t=>t.matches(e))?.kind}function ZS(e){let t=new Map,n=0,r=0;return{entries:e.map(a=>{let o=Le(a.agent_provenance)?a.agent_provenance:void 0;if(o===void 0)return a;let s={},c=!1;for(let[d,u]of Object.entries(o)){let m=Le(u)?Gi(u.value):void 0;if(m===void 0){s[d]=u;continue}c=!0,r+=1;let p=a.agent_harness??"unknown",f=`${p}\0${d}\0${m}`,g=t.get(f)??{harness:p,dimension:d,kind:m,count:0};g.count+=1,t.set(f,g)}if(!c)return a;n+=1;let l={...a};return Object.keys(s).length===0?delete l.agent_provenance:l.agent_provenance=s,l}),receipt:{changed:n>0,events_changed:n,observations_removed:r,invalid_values:[...t.values()].sort((a,o)=>a.harness.localeCompare(o.harness)||a.dimension.localeCompare(o.dimension)||a.kind.localeCompare(o.kind))}}}async function QS(e){let t=[];for(let n of await _c(e))try{let r=await Ui.readFile(zi.join(e,"history",n),"utf8");for(let i of r.split(`
5
- `)){if(i.trim().length===0)continue;let a=yc(i);if(a===null||!Le(a.agent_provenance))continue;if(Object.values(a.agent_provenance).some(s=>Le(s)&&Gi(s.value)!==void 0)){t.push(n.slice(0,-6));break}}}catch{}return t}async function _c(e){try{return(await Ui.readdir(zi.join(e,"history"))).filter(t=>t.endsWith(".jsonl")).sort()}catch{return[]}}async function Gp(e,t,n){let r;try{r=await Ui.open(zi.join(e,"history",t),"r");let i=(await r.stat()).size,a=Math.min(i,Math.max(0,n)),o=Buffer.alloc(a),{bytesRead:s}=await r.read(o,0,a,0),c=o.subarray(0,s).toString("utf8"),l=s>=i,d=c.lastIndexOf(`
6
- `),u=c;return l||(u=d===-1?"":c.slice(0,d+1)),{content:u,bytesRead:s,complete:l}}catch{return null}finally{await r?.close()}}function yc(e){try{let t=JSON.parse(e);return Le(t)?t:null}catch{return null}}function qp(e,t,n){let r=typeof e.agent_harness=="string"?e.agent_harness:void 0;if(r===void 0)return;let i=Le(e.agent_provenance)?e.agent_provenance:{};if(Object.entries(i).forEach(([o,s])=>{if(!Le(s))return;let c=Gi(s.value);if(!c)return;let l=`${r}\0${o}\0${c}`,d=n.get(l)??{harness:r,dimension:o,kind:c,count:0};d.count+=1,n.set(l,d)}),!Le(e.context))return;let a=e.context.agent_provenance_outcomes;Le(a)&&Object.entries(a).forEach(([o,s])=>{if(!Le(s)||typeof s.resolver!="string"||!Up.has(String(s.status)))return;let c=`${r}\0${o}\0${s.resolver}`,l=t.get(c)??{harness:r,dimension:o,resolver:s.resolver,attempts:0,successes:0};l.attempts+=1,s.status==="resolved"&&(l.successes+=1),t.set(c,l)})}function Wp(e,t,n,r,i){let a=i;for(let o of e.split(`
7
- `)){if(o.trim().length===0)continue;if(a>=r)return{eventsRead:a,truncated:!0};a+=1;let s=yc(o);s&&qp(s,t,n)}return{eventsRead:a,truncated:!1}}async function wc(e,t=1e4){let n=new Map,r=new Map,i=0,a=0,o=!1;for(let l of await _c(e)){let d=await Gp(e,l,Math.max(0,jp-a));if(d===null)continue;a+=d.bytesRead;let u=Wp(d.content,n,r,t,i);if(i=u.eventsRead,u.truncated){o=!0;break}if(!d.complete){o=!0;break}}let s=[...n.values()].sort((l,d)=>l.harness.localeCompare(d.harness)||l.dimension.localeCompare(d.dimension)||l.resolver.localeCompare(d.resolver)),c=[...r.values()].sort((l,d)=>l.harness.localeCompare(d.harness)||l.dimension.localeCompare(d.dimension)||l.kind.localeCompare(d.kind));return{outcomes:s,invalid_values:c,warnings:o?[]:[...s.filter(l=>l.attempts>0&&l.successes===0).map(l=>`provenance_resolver_zero_success:${l.harness}:${l.dimension}:${l.resolver}:${String(l.attempts)}`),...c.map(l=>`provenance_value_domain_invalid:${l.harness}:${l.dimension}:${l.kind}:${String(l.count)}`)],events_read:i,truncated:o}}import et from"node:fs/promises";import fe from"node:path";import jt from"node:fs/promises";import{createHash as Bp}from"node:crypto";import bc from"node:path";(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]="32538934-2cbb-50fe-b721-ad9197cef7d8")}catch{}})();var kc=4,Hp="history-drift-cache.json";function xc(e){return bc.join(e,"runtime",Hp)}async function Jp(e){try{let t=await jt.readFile(xc(e),"utf8"),n=JSON.parse(t);return n.version!==kc||typeof n.entries!="object"||n.entries===null?null:n}catch{return null}}async function Vp(e,t,n,r,i){let a=Kn(e),o;try{o=await jt.stat(a)}catch(l){return j(l)||i.unreadableStreams.push(de),!1}let s=i.missingStreams.length,c=await Ec({itemId:de,historyPath:a,stat:o,cached:t[de],verifyCacheHitByContent:r,accumulator:i});return c.verification?(c.verification.chainOk||i.chainMismatches.push(de),n[de]={mtime_ms:o.mtimeMs,ctime_ms:o.ctimeMs,size:o.size,content_hash:c.verification.contentHash,latest_after_hash:c.verification.latestAfterHash,chain_ok:c.verification.chainOk,item_hash_version:c.verification.itemHashVersion},c.cacheDirty):(i.missingStreams.splice(s),c.cacheDirty)}function Sc(e){return Bp("sha256").update(e).digest("hex")}async function Kp(e){let t=await jt.readFile(e,"utf8");return Sc(t)}async function Yp(e){let t=await jt.readFile(e,"utf8"),n=Sc(t);if(t.trim().length===0)return null;let r=[],i=null;for(let o of t.split(/\r?\n/)){let s=o.trim();if(s.length===0)continue;let c=JSON.parse(s);if(typeof c.after_hash!="string"||c.after_hash.trim().length===0)throw new Error("missing after_hash");r.push(c),i=c.after_hash}if(!i)return null;let a=is(r);return{latestAfterHash:i,chainOk:a.ok,contentHash:n,itemHashVersion:a.item_hash_version??bi}}function Xp(e,t){return e!==void 0&&e.mtime_ms===t.mtimeMs&&e.ctime_ms===t.ctimeMs&&e.size===t.size}async function vc(e,t,n){try{let r=await Yp(t);return r||(n.missingStreams.push(e),null)}catch{return n.unreadableStreams.push(e),null}}async function Ec(e){let t=typeof e.cached?.content_hash=="string"&&e.cached.content_hash.length>0?e.cached.content_hash:void 0;if(!(Xp(e.cached,e.stat)&&t!==void 0&&e.cached!==void 0)||!e.cached)return{verification:await vc(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0};let r;if(e.verifyCacheHitByContent)try{r=await Kp(e.historyPath)}catch{return e.accumulator.unreadableStreams.push(e.itemId),{verification:null,cacheDirty:!1}}else r=t;return!e.verifyCacheHitByContent||r===t?{verification:{latestAfterHash:e.cached.latest_after_hash,chainOk:e.cached.chain_ok,contentHash:r,itemHashVersion:e.cached.item_hash_version??bi},cacheDirty:!1}:{verification:await vc(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0}}async function Zp(e,t,n,r){let i=Mn(e,t.id),a;try{a=await jt.stat(i)}catch(d){return(j(d)?r.missingStreams:r.unreadableStreams).push(t.id),!1}let o=await Ec({itemId:t.id,historyPath:i,stat:a,cached:n.previousEntries[t.id],verifyCacheHitByContent:n.verifyCacheHitByContent,accumulator:r});if(!o.verification)return o.cacheDirty;o.verification.chainOk||r.chainMismatches.push(t.id),n.nextEntries[t.id]={mtime_ms:a.mtimeMs,ctime_ms:a.ctimeMs,size:a.size,content_hash:o.verification.contentHash,latest_after_hash:o.verification.latestAfterHash,chain_ok:o.verification.chainOk,item_hash_version:o.verification.itemHashVersion};let{body:s,...c}=t;return rs({metadata:c,body:s},o.verification.itemHashVersion)!==o.verification.latestAfterHash&&r.hashMismatches.push(t.id),o.cacheDirty}async function Qp(e,t){if(!(t.unreadableStreams.includes(de)||t.chainMismatches.includes(de)))try{let n=await as(e);t.workspaceStateMismatches.push(...n.mismatched_documents),t.workspaceStateMissing.push(...n.missing_documents),t.workspaceStateUnreadable.push(...n.unreadable_documents)}catch{t.unreadableStreams.push(de)}}async function yr(e,t,n={}){let r={missingStreams:[],unreadableStreams:[],hashMismatches:[],chainMismatches:[],workspaceStateMismatches:[],workspaceStateMissing:[],workspaceStateUnreadable:[]},a=(await Jp(e))?.entries??{},o={},s=!1,c=n.cacheHitVerification!=="metadata",l={previousEntries:a,nextEntries:o,verifyCacheHitByContent:c};for(let m of t)await Zp(e,m,l,r)&&(s=!0);let d=await Vp(e,a,o,c,r);if(s||=d,await Qp(e,r),s||Object.keys(a).length!==Object.keys(o).length){let m=xc(e);try{await jt.mkdir(bc.dirname(m),{recursive:!0}),await ce(m,JSON.stringify({version:kc,entries:o}))}catch{}}let u=[...new Set([...r.missingStreams,...r.unreadableStreams,...r.hashMismatches,...r.chainMismatches,...r.workspaceStateMismatches.length>0||r.workspaceStateMissing.length>0||r.workspaceStateUnreadable.length>0?[de]:[]])].sort((m,p)=>m.localeCompare(p));return{...r,driftedItems:u}}import ln from"node:fs/promises";import wr from"node:path";(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]="79f9ccbd-48d1-5eb3-82ae-3dd62427041c")}catch{}})();function ef(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!="object"||t===null||Array.isArray(t))return null;let n=t,{id:r,owner:i,created_at:a,ttl_seconds:o}=n;return typeof r!="string"||typeof i!="string"||typeof a!="string"||typeof o!="number"||!Number.isFinite(o)?null:{id:r,owner:i,created_at:a,ttl_seconds:o}}function Ac(e,t,n){let r=ef(t);if(r===null)return{detail:"unparseable_json",entry:{file:e,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:!1,reason:"unparseable"}};let i=Date.parse(r.created_at);if(!Number.isFinite(i))return{detail:"invalid_timestamp",entry:{file:e,id:r.id,owner:r.owner,created_at:r.created_at,ttl_seconds:r.ttl_seconds,age_seconds:null,stale:!1,reason:"unparseable"}};let a=n-i,o=Math.floor(a/1e3),s=a>r.ttl_seconds*1e3;return{detail:s?"expired":"active",entry:{file:e,id:r.id,owner:r.owner,created_at:r.created_at,ttl_seconds:r.ttl_seconds,age_seconds:o,stale:s,reason:s?"expired":"active"}}}async function Rc(e,t){let n=t??Date.now(),r=wr.join(e,"locks"),i={scanned:0,active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0},a;try{a=(await ln.readdir(r)).filter(s=>s.endsWith(".lock")).sort()}catch(o){if(j(o))return i;throw o}for(let o of a){let s;try{s=await ln.readFile(wr.join(r,o),"utf8")}catch(l){if(j(l))continue;i.scanned+=1,i.unreadable_lock_count+=1;continue}i.scanned+=1;let{detail:c}=Ac(o,s,n);c==="active"?i.active_lock_count+=1:c==="expired"?i.stale_lock_count+=1:i.unparseable_lock_count+=1}return i}async function Ic(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=wr.join(e,"locks"),o={scanned:0,removed:[],retained:[],warnings:[],entries:[]},s;try{s=(await ln.readdir(a)).filter(l=>l.endsWith(".lock")).sort()}catch(c){if(j(c))return o;throw c}for(let c of s){o.scanned+=1;let l=wr.join(a,c),d=`locks/${c}`;if(r?.onRead){let p=await r.onRead(l);o.warnings.push(...p)}let u;try{u=await ln.readFile(l,"utf8")}catch(p){if(j(p)){o.scanned-=1;continue}o.warnings.push(`lock_unreadable:${c}`),o.retained.push(d),o.entries.push({file:c,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:!1,reason:"unparseable"});continue}let m=Ac(c,u,i);if(m.detail==="unparseable_json"){o.warnings.push(`lock_unparseable:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}if(m.detail==="invalid_timestamp"){o.warnings.push(`lock_invalid_timestamp:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}if(m.detail==="active"){o.retained.push(d),o.entries.push(m.entry);continue}if(!n){try{await ln.unlink(l)}catch(p){if(!j(p)){o.warnings.push(`lock_remove_failed:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}}if(r?.onWrite){let p=await r.onWrite(l);o.warnings.push(...p)}}o.removed.push(d),o.entries.push(m.entry)}return 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]="bc9e5edf-c275-5172-8900-fafee9b4a2db")}catch{}})();var tf=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts, re-apply any intended discarded values, then run pm merge reconcile; lossy receipts require explicit --force acceptance."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function qi(e){if(typeof e!="string")return;let t=e.trim();for(let n of tf)if(t===n.code||t.startsWith(`${n.code}:`))return n}function Wi(e){let t={};for(let n of e){let r=qi(n);r!==void 0&&!Object.prototype.hasOwnProperty.call(t,r.code)&&(t[r.code]=r.command)}return t}function Cc(e){return Object.values(Wi(e))}import ct from"node:fs/promises";import Ae from"node:path";(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]="2c514907-377f-59f9-bfdd-a184abf7ffb7")}catch{}})();var nf=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function Ut(e,t={}){let n=new Set;t.extensionName!==void 0&&n.add(qn(t.extensionName));for(let h of t.extensionNames??[])n.add(qn(h));let r=h=>n.size===0||n.has(qn(h)),i=(h,w)=>$c(h.filter(v=>r(v.name)).map(w)),a=(h,w)=>$c(h.filter(v=>r(v.name)).flatMap(w)),{registrations:o,commands:s,parsers:c,preflight:l,services:d,renderers:u,hooks:m}=e,p=a(o.relationship_kinds??[],h=>h.definitions.map(w=>w.kind)),f=u.overrides.filter(h=>r(h.name)&&((h.commands?.length??0)>0||h.resultDiscriminator!==void 0)).map(h=>({format:h.format,commands:[...h.commands??[]],result_discriminator:h.resultDiscriminator!==void 0})).sort((h,w)=>h.format.localeCompare(w.format)),g=i(o.assurance_providers??[],h=>h.definition.id);return{capabilities:Vo(e,t),commands:i(o.commands,h=>h.command),command_overrides:i(s.overrides,h=>h.command),command_handlers:i(s.handlers,h=>h.command),hooks:nf.filter(([h])=>m[h].some(w=>r(w.name))).map(([,h])=>h),flag_commands:i(o.flags,h=>h.target_command),item_types:a(o.item_types,h=>h.types.map(w=>w.name)),item_fields:a(o.item_fields,h=>h.fields.map(w=>w.name)),...p.length>0?{relationship_kinds:p}:{},migrations:a(o.migrations,h=>typeof h.definition.id=="string"?[h.definition.id]:[]),profiles:i(o.profiles,h=>h.profile.name),importers:i(o.importers,h=>h.importer),exporters:i(o.exporters,h=>h.exporter),search_providers:i(o.search_providers,h=>h.definition.name),vector_store_adapters:i(o.vector_store_adapters,h=>h.definition.name),...g.length>0?{assurance_providers:g}:{},parser_overrides:i(c.overrides,h=>h.command),service_overrides:i(d.overrides,h=>h.service),renderer_overrides:i(u.overrides,h=>h.format),...f.length>0?{renderer_ownership:f}:{},preflight_overrides:l.overrides.filter(h=>r(h.name)).length,preflight_ownership:l.overrides.filter(h=>r(h.name)).map(h=>({commands:[...h.commands??[]]}))}}function $c(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(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]="288a7da9-888b-527d-88fb-4711917cec5b")}catch{}})();var rf=e=>{let t='"',n=0;for(let r of e){if(r==="\\"){n+=1;continue}t+="\\".repeat(r==='"'?n*2+1:n),t+=r,n=0}return`${t}${"\\".repeat(n*2)}"`},Bi=(e,t=process.platform)=>(t==="win32"?/^[A-Za-z0-9._:/\\@=-]+$/:/^[A-Za-z0-9._:/@=-]+$/).test(e)?e:t==="win32"?rf(e):`"${e.replace(/(["\\$`])/g,"\\$1")}"`,Tc=(e,t=process.platform)=>{let n=e.map(r=>Bi(r,t)).join(" ");return n.length>0?`pm ${n}`:"pm"};import ah from"node:path";import{mkdir as oh}from"node:fs/promises";import{readFile as br,realpath as Ki,writeFile as uf}from"node:fs/promises";import{execFile as mf}from"node:child_process";import te from"node:path";import{promisify as pf}from"node:util";import{readFile as af,writeFile as of}from"node:fs/promises";import dn from"node:path";(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]="89261a49-97e5-5ffc-a81c-2409f0b529cf")}catch{}})();var Dc="# pm-cli:runtime-cache:start",Hi="# pm-cli:runtime-cache:end",Pc=".agents/pm",Ji=["runtime/","search/","locks/","transactions/","checkpoints/"],sf=["search/eval-queries.json"];async function Oc(e){try{return await e()}catch(t){throw t instanceof Error&&"code"in t&&typeof t.code=="string"&&["EACCES","EPERM","EROFS"].includes(t.code)?new _("The workspace .gitignore is not writable.",y.GENERIC_FAILURE,{code:"init_gitignore_unwritable",reason:t.code.toLowerCase(),required:"Grant the current user read and write access to the workspace .gitignore before initialization.",why:"pm init must publish its managed runtime-cache ignore fence without replacing unrelated entries.",nextSteps:["Grant read and write access to the workspace .gitignore and rerun pm init.","If the workspace is intentionally read-only, initialize pm in a writable workspace or clone."]}):t}}function Nc(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/\/+$/,"")}function Vi(e){let t=e.replaceAll("\\","/");return dn.isAbsolute(e)||t===".."||t.startsWith("../")}function cf(e=Pc){let t=Nc(e);return[Dc,...Ji.map(n=>n==="search/"?`${t}/${n}*`:`${t}/${n}`),...sf.map(n=>`!${t}/${n}`),Hi].join(`
8
- `)}async function xE(e,t={}){let n=dn.join(e,".gitignore"),r=Pc;if(t.pmRoot!==void 0){let d=Nc(dn.relative(dn.resolve(e),dn.resolve(t.pmRoot)));if(Vi(d))return{path:n,changed:!1};d.length>0&&(r=d)}let i="";try{i=await Oc(()=>af(n,"utf8"))}catch(d){if(!(d instanceof Error&&"code"in d&&j(d)))throw d}let a=i.indexOf(Dc),o=i.indexOf(Hi),c=(a>=0&&o>=a?`${i.slice(0,a)}${i.slice(o+Hi.length)}`:i).trimEnd(),l=`${c.length>0?`${c}
1
+ import{a as ki,c as Wn,d as Bn,e as Qo,g as es,h as Si,i as ts,j as At,k as Rt,l as ns,m as rs,n as Ei,o as is,p as It,q as Ct,r as as,s as os,t as Ai}from"./chunk-SYZENPIT.js";import{a as ds,f as Xn,g as Ri}from"./chunk-KGEXTMPG.js";import{B as Kn,a as Jo,g as bi,i as Vo}from"./chunk-2NNFLLNG.js";import{Z as Ys,l as Vs,n as Ks}from"./chunk-MHPIL773.js";import{$ as Us,Aa as Hs,Ba as Js,Da as Di,I as lr,J as Os,K as $i,L as an,N as Ti,R as Ds,S as Ps,T as Ns,U as Ms,V as dr,X as Ls,Y as Fs,Z as js,_ as ht,aa as Nt,ba as zs,ca as Oi,da as Mt,e as Rs,ea as qs,f as Is,fa as Gs,g as Cs,t as nn,u as $s,ua as Ws,v as rn,va as ur,w as Ts,za as Bs}from"./chunk-ZQPGZZWQ.js";import{a as Ko,b as Hn,c as xi,d as Yo,e as Xo,f as We,g as Jn,h as Zo,i as it}from"./chunk-XKAMP5OU.js";import{$a as I,Aa as _s,Ma as ys,Ra as ue,Sa as nr,Ta as ws,U as Y,Ua as Ci,V as $,Va as rr,Wa as ir,Xa as ar,Ya as vs,Za as Te,_ as de,_a as bs,ab as or,b as ms,cb as ks,d as ps,ea as hs,fa as Qn,hb as xs,ia as er,ib as Ss,ja as gs,l as z,ma as $t,nb as sr,o as re,oa as Tt,pb as Es,q as He,qb as Ot,r as fs,ra as tr,rb as Dt,s as Zn,sb as Pt,tb as Je,ub as cr,xb as ft,ya as Ii,zb as As}from"./chunk-ZT2DJS27.js";import{Ba as vi,Ca as Bo,Da as Ho,E as Lo,Ea as Et,F as Fo,G as q,Ga as Ne,Ia as Me,Ka as se,L as tn,La as Ae,M as L,N as pt,Na as we,O as qn,Oa as Le,P as K,R as jo,S as Gn,Sa as Be,Ua as Vn,W as Z,Ya as Yn,Z as Uo,Za as cs,_a as ls,a as Co,ba as zo,d as $o,e as To,ea as _i,ga as yi,h as St,p as gi,q as A,r as zn,s as j,sa as qo,t as X,ta as Go,u as le,x as ye,y as Ee,z as Mo}from"./chunk-POEEAD2V.js";import{b as us}from"./chunk-KP2VQQVQ.js";import{N as Oo,P as Do,R as Po,U as No,V as Un,Y as _,Z as y,a as Fn,aa as oe,ba as Wo,ca as wi,d as jn,ka as ss,t as hi}from"./chunk-EHXIKD6K.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]="d2d5135a-8110-527e-8530-653b25b792a4")}catch{}})();var N=class extends TypeError{constructor(t){super(t),this.name="AssuranceMutationRefusalError"}},ve=class extends TypeError{context;constructor(t,n={}){super(t),this.name="AssuranceEvaluationRefusalError",this.context=n}},Fe=class extends TypeError{measurement_id;source_kind;field;check;constructor(t,n){super(t),this.name="AssuranceSourceResolutionError",this.measurement_id=n.measurement_id,this.source_kind=n.source_kind,this.field=n.field,this.check=n.check}};async function Lt(e){try{return await e()}catch(t){throw t instanceof N?new y(t.message,_.USAGE,{code:"invalid_argument_value",reason:"assurance_mutation_refused"}):t}}async function Xs(e){try{return await e()}catch(t){throw t instanceof ve?new y(t.message,_.USAGE,{code:"invalid_argument_value",reason:"assurance_evaluation_refused",...t.context}):t}}import{createHash as kp}from"node:crypto";import xp from"node:path";(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]="b911b43d-d14d-5e4f-a35e-5020b1a84542")}catch{}})();var Ft=1e3;(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]="2bf52d6d-7e4f-5ec5-86bd-3e817ef521bb")}catch{}})();var Qs=1,gt=["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"],Pi=["items","dependency_kind","graph","validate","health","history","links","provider","derived"],Sp=["ceiling","floor","equals","zero","monotone_nondecreasing","monotone_nonincreasing","subset_of"],Ep=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/,mr=30,pr=5e3,ec=4,Ap=50;function Ve(e,t){if(!Ep.test(e))throw new N(`${t} must be a stable lowercase id`)}function Rp(e,t){if(!Number.isFinite(e)||e<0)throw new N(`${t} must be a finite non-negative number`)}function on(e){let t=Sp.filter(i=>e[i]!==void 0);if(t.length!==1)throw new N(`assertion ${e.id} must declare exactly one polarity`);let n=t[0],r=e[n];return{polarity:n,value:n==="zero"?0:r}}function Ni(e,t){return oe(e)===oe(t)}function tc(e,t){if(t.polarity==="equals")return Ni(e,t.value);if(t.polarity==="subset_of"){if(!Array.isArray(e)||!Array.isArray(t.value))return!1;let r=t.value;return e.every(i=>r.includes(i))}if(typeof e!="number")return!1;let n=t.value;return t.polarity==="ceiling"||t.polarity==="monotone_nonincreasing"?e<=n:t.polarity==="floor"||t.polarity==="monotone_nondecreasing"?e>=n:e===0}function nc(e){let t=on(e),n=e.negative_control.cases;return n.some(r=>r.expected==="pass")&&n.some(r=>r.expected==="fail")&&n.every(r=>tc(r.observed,t)===(r.expected==="pass"))}function Ip(e,t){if(e.polarity!==t.polarity)return!0;if(typeof e.value=="number"&&typeof t.value=="number")return e.polarity==="ceiling"||e.polarity==="monotone_nonincreasing"?t.value>e.value:e.polarity==="floor"||e.polarity==="monotone_nondecreasing"?t.value<e.value:t.value!==e.value;if(e.polarity==="subset_of"){let n=e.value,r=t.value;return!Array.isArray(n)||!Array.isArray(r)||r.some(i=>!n.includes(i))}return!Ni(e.value,t.value)}function Cp(e,t){if(e.measurement_id!==t.measurement_id||e.owner_item_id!==t.owner_item_id||oe(e.scope)!==oe(t.scope))return!0;let n={observe:0,warn:1,block:2},r=(e.lifetime??"hold")==="hold"&&(t.lifetime??"hold")==="retire";return Ip(on(e),on(t))||n[t.enforcement]<n[e.enforcement]||r}function $p(e){if(e.state!==void 0&&!(e.state==="present"||e.state==="missing"))throw new N("items source state must be present or missing");let t=Object.hasOwn(e,"equals"),n=e.state!==void 0,r=Number(t)+Number(n);if(e.field!==void 0&&r!==1)throw new N("items source with field requires exactly one of equals or state");if(e.field===void 0&&r!==0)throw new N("items source equals/state requires field")}function Mi(e){Ve(e.id,"measurement.id"),e.max_cost!==void 0&&Rp(e.max_cost,"measurement.max_cost");let t=e.source;if(Object.prototype.toString.call(t)!=="[object Object]")throw new N(`measurement.source.kind must be one of ${Pi.join(", ")}`);let n=Reflect.get(t,"kind");if(!Pi.includes(n))throw new N(`measurement.source.kind must be one of ${Pi.join(", ")}`);let r=t;if(r.kind==="items"&&$p(r),r.kind==="dependency_kind"&&(typeof r.dependency_kind!="string"||r.dependency_kind.trim().length===0))throw new N("dependency_kind source requires dependency_kind");if((r.kind==="graph"||r.kind==="validate"||r.kind==="health")&&(typeof r.field!="string"||r.field.trim().length===0))throw new N(`${r.kind} source requires field`);return r.kind==="provider"&&(Ve(r.provider,"provider source provider"),Ve(r.key,"provider source key")),e}function Li(e){if(Ve(e.id,"assertion.id"),Ve(e.measurement_id,"assertion.measurement_id"),typeof e.owner_item_id!="string"||e.owner_item_id.trim().length===0)throw new N("assertion.owner_item_id is required");let t=on(e);if(typeof t.value=="number"&&!Number.isFinite(t.value))throw new N(`assertion.${t.polarity} must be a finite number`);if(e.lifetime==="retire"&&(typeof e.retire_reason!="string"||e.retire_reason.trim().length===0))throw new N("retired assertion requires retire_reason");e.scope.kind==="filter"&&Ve(e.scope.measurement_id,"assertion.scope.measurement_id");let n=e.negative_control?.cases;if(!Array.isArray(n)||!n.some(r=>r.expected==="pass")||!n.some(r=>r.expected==="fail"))throw new N("assertion negative control requires pass and fail cases");if(!nc(e))throw new N(`assertion ${e.id} negative control does not prove its bound`);return e}function Tp(e){if(!Array.isArray(e.allowed_providers))throw new N("gate provider_policy.allowed_providers must be an array");for(let t of e.allowed_providers)Ve(t,"gate.provider_policy.allowed_provider");if(typeof e.triggers!="object"||e.triggers===null||Array.isArray(e.triggers))throw new N("gate provider_policy.triggers must be an object");for(let[t,n]of Object.entries(e.triggers)){if(!gt.includes(t))throw new N(`gate provider policy has unknown trigger ${t}`);if(typeof n!="object"||n===null||!["low","medium","high"].includes(n.max_cost_class)||typeof n.allow_network!="boolean")throw new N(`gate provider policy trigger ${t} is invalid`)}}function rc(e){if(Ve(e.id,"gate.id"),!Array.isArray(e.assertion_ids))throw new N("gate.assertion_ids is required and must be an array");if(e.assertion_ids.length===0)throw new N("gate requires at least one assertion");for(let t of e.assertion_ids)Ve(t,"gate.assertion_id");if(!Array.isArray(e.triggers))throw new N(`gate.triggers is required and must be an array of ${gt.join(", ")}`);if(e.triggers.length===0)throw new N("gate requires at least one trigger");for(let t of e.triggers)if(!gt.includes(t))throw new N(`gate trigger must be one of ${gt.join(", ")}`);return e.provider_policy&&Tp(e.provider_policy),e}function jt(e){if(e.version!==Qs)throw new N(`unsupported assurance document version ${String(e.version)}`);let t=new Set;for(let r of e.measurements){if(Mi(r),t.has(`measurement:${r.id}`))throw new N(`duplicate measurement ${r.id}`);t.add(`measurement:${r.id}`)}for(let r of e.assertions){if(Li(r),t.has(`assertion:${r.id}`))throw new N(`duplicate assertion ${r.id}`);t.add(`assertion:${r.id}`)}for(let r of e.gates){rc(r);let i=r.assertion_ids.filter(a=>!e.assertions.some(o=>o.id===a));if(i.length>0)throw new N(`gate ${r.id} references missing assertions: ${i.join(", ")}`);if(t.has(`gate:${r.id}`))throw new N(`duplicate gate ${r.id}`);t.add(`gate:${r.id}`)}let n=new Set(e.measurements.map(r=>r.id));for(let[r,i]of ic(e))if(!n.has(r))throw new N(`${i.join(", ")} references missing measurement ${r}`);return e}function Fi(e,t){if("measurement"in e){t.push(e.measurement);return}if("operator"in e)for(let n of e.operands)Fi(n,t)}function ic(e){let t=new Map,n=(r,i)=>{let a=t.get(r)??[];a.push(i),t.set(r,a)};for(let r of e.assertions)n(r.measurement_id,`assertion ${r.id}`),r.scope.kind==="filter"&&n(r.scope.measurement_id,`assertion ${r.id} scope`);for(let r of e.measurements){if(r.source.kind!=="derived")continue;let i=[];Fi(r.source.expression,i);for(let a of i)n(a,`derived measurement ${r.id}`)}return t}function Op(e,t){let n=e.assertion_ids.flatMap(a=>{let o=t.assertions.find(s=>s.id===a);return[o.measurement_id,...o.scope.kind==="filter"?[o.scope.measurement_id]:[]]}),r=new Set,i=new Set;for(;n.length>0;){let a=n.pop();if(r.has(a))continue;r.add(a);let o=t.measurements.find(s=>s.id===a);o.source.kind==="provider"?i.add(o.source.provider):o.source.kind==="derived"&&Fi(o.source.expression,n)}return i}function sn(){return{version:Qs,measurements:[],assertions:[],gates:[]}}function Dp(e,t){let n=t.items.filter(r=>(e.statuses===void 0||e.statuses.includes(r.status))&&(e.types===void 0||e.types.includes(r.type))&&(e.tags===void 0||e.tags.every(i=>r.tags?.includes(i)))&&(e.field===void 0||(()=>{let i=r[e.field];if(e.state!==void 0){let a=i==null||i===""||Array.isArray(i)&&i.length===0;return e.state==="missing"?a:!a}return Ni(i,e.equals)})()));return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n.map(r=>r.id)}}function Pp(e,t){let n=[],r=yi(e.dependency_kind)??e.dependency_kind.trim().toLowerCase();for(let i of t.items)for(let a of i.dependencies??[])(yi(a.kind)??a.kind.trim().toLowerCase())===r&&n.push(`${i.id}->${a.id}`);return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n}}function Np(e,t){return{value:t.history.filter(r=>(e.op===void 0||r.op===e.op)&&(e.author===void 0||r.author===e.author)&&(e.harness===void 0||r.agent_harness===e.harness)&&(e.model===void 0||r.agent_model===e.model)).length,population_size:t.history.length,cost:t.history.length}}function Mp(e,t){let n=t.items.filter(r=>{let i=r[e.link],a=Array.isArray(i)&&i.length>0;return e.state==="present"?a:!a});return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n.map(r=>r.id)}}function Lp(e,t){let n=e.source;return n.kind==="items"?Dp(n,t):n.kind==="dependency_kind"?Pp(n,t):n.kind==="history"?Np(n,t):n.kind==="links"?Mp(n,t):null}function ac(e,t){return e.reduce((n,r)=>({units:n.units+r.units,items_scanned:n.items_scanned+r.items_scanned,history_entries:n.history_entries+r.history_entries,provider_calls:n.provider_calls+r.provider_calls,duration_ms:t}),{units:0,items_scanned:0,history_entries:0,provider_calls:0,duration_ms:t})}function Fp(e,t){if(t.length===0)throw new TypeError(`derived ${e} requires operands`);if(e==="add")return t.reduce((n,r)=>n+r,0);if(e==="subtract")return t.slice(1).reduce((n,r)=>n-r,t[0]);if(e==="multiply")return t.reduce((n,r)=>n*r,1);if(e==="divide"){if(t.slice(1).includes(0))throw new TypeError("derived divide cannot divide by zero");return t.slice(1).reduce((n,r)=>n/r,t[0])}return e==="min"?Math.min(...t):Math.max(...t)}async function oc(e,t,n){let r=new Array(e.length),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,r[o]=await n(e[o],o)}});return await Promise.all(a),r}async function sc(e,t,n,r,i){if("literal"in e)return{value:e.literal,costs:[],population_size:0,contributors:[]};if("measurement"in e){let o=n.find(l=>l.id===e.measurement);if(!o)throw new TypeError(`derived measurement references missing ${e.measurement}`);let s=await cc(o,t,n,r,i);if(typeof s.value!="number")throw new TypeError(`derived measurement ${o.id} is not numeric`);let c=i.charged.has(o.id)?[]:[s.cost];return i.charged.add(o.id),{value:s.value,costs:c,population_size:s.population_size,contributors:s.contributors}}let a=await oc(e.operands,ec,o=>sc(o,t,n,r,i));return{value:Fp(e.operator,a.map(o=>o.value)),costs:a.flatMap(o=>o.costs),population_size:Math.max(0,...a.map(o=>o.population_size)),contributors:[...new Set(a.flatMap(o=>o.contributors))]}}async function jp(e,t,n,r,i){Mi(e);let a=Date.now(),o,s=[],c=0;if(e.source.kind==="derived"){let u=await sc(e.source.expression,t,n,[...r,e.id],i);o={value:u.value,population_size:u.population_size,cost:0,contributors:u.contributors},s=u.costs}else{let u=Lp(e,t);u!==null?o=u:(o=await t.external(e.source),c=1)}let l={units:o.cost,items_scanned:e.source.kind==="items"||e.source.kind==="dependency_kind"||e.source.kind==="links"?t.items.length:0,history_entries:e.source.kind==="history"?t.history.length:0,provider_calls:c,duration_ms:Date.now()-a},d=ac([...s,l],Date.now()-a);if(e.max_cost!==void 0&&d.units>e.max_cost)throw new ve(`measurement ${e.id} exceeded cost ceiling ${e.max_cost} with ${d.units}`);return{id:e.id,definition_fingerprint:`sha256:${kp("sha256").update(oe(e)).digest("hex")}`,value:o.value,population_size:o.population_size,cost:d,contributors:o.contributors??[]}}function cc(e,t,n,r,i){if(r.includes(e.id))throw new TypeError(`derived measurement cycle: ${[...r,e.id].join(" -> ")}`);let a=i.cache.get(e.id);if(a)return a;let o=jp(e,t,n,r,i).catch(s=>{if(s instanceof Fe&&s.measurement_id===void 0){let c={measurement_id:e.id,source_kind:s.source_kind,field:s.field,...s.check?{check:s.check}:{}},l=new Fe(s.message,c);throw l.cause=s,l}throw s});return i.cache.set(e.id,o),o}async function ji(e,t,n=[e]){return cc(e,t,n,[],{cache:new Map,charged:new Set})}function Up(e,t){return typeof e!="number"||typeof t.value!="number"?null:t.polarity==="ceiling"||t.polarity==="monotone_nonincreasing"?t.value-e:(t.polarity==="floor"||t.polarity==="monotone_nondecreasing",e-t.value)}function zp(e,t,n={}){Li(e);let r=on(e),i=e.lifetime==="retire"&&n.owner_terminal===!0;return{assertion_id:e.id,measurement_id:e.measurement_id,measurement_definition_fingerprint:t.definition_fingerprint,scope:e.scope,population_size:t.population_size,observed:t.value,bound:r,distance:Up(t.value,r),verdict:i?"retired":tc(t.value,r)?"pass":"fail",enforcement:e.enforcement,negative_control_proven:nc(e),cost:t.cost,contributors:t.contributors}}function qp(e,t,n,r){let i=Op(e,t);if(i.size===0)return;let a=e.provider_policy,o=a?.triggers[r];if(!a||!o)throw new ve(`assurance gate ${e.id} refuses provider execution at trigger ${r} without an explicit provider policy`);let s=new Set(a.allowed_providers),c={low:0,medium:1,high:2};for(let l of i){if(!s.has(l))throw new ve(`assurance gate ${e.id} refuses provider ${l}`);let d=n.provider_capabilities?.[l];if(!d)throw new ve(`assurance provider ${l} has no declared capabilities`);if(c[d.cost_class]>c[o.max_cost_class])throw new ve(`assurance gate ${e.id} refuses ${d.cost_class}-cost provider ${l} at trigger ${r}`);if(d.network&&!o.allow_network)throw new ve(`assurance gate ${e.id} refuses network provider ${l} at trigger ${r}`)}}async function Zs(e,t,n,r,i){try{return await ji(n,r,i)}catch(a){if(a instanceof Fe){let o=a.check?` check ${a.check}`:"",s=a.measurement_id??n.id,c=new ve(`assurance gate ${e} assertion ${t} measurement ${s} source ${a.source_kind}${o} field ${a.field} could not resolve: ${a.message}`,{gate_id:e,assertion_id:t,measurement_id:s,source_kind:a.source_kind,field:a.field,...a.check?{check:a.check}:{}});throw c.cause=a,c}throw a}}async function lc(e,t,n,r){jt(t);let i=t.gates.find(c=>c.id===e);if(!i)throw new ve(`assurance gate ${e} not found`);if(!i.triggers.includes(r.trigger))throw new ve(`assurance gate ${e} does not declare trigger ${r.trigger}`);qp(i,t,n,r.trigger);let a=await oc(i.assertion_ids,ec,async c=>{let l=t.assertions.find(f=>f.id===c),d=t.measurements.find(f=>f.id===l.measurement_id),u=n;if(l.scope.kind==="active"){let f=new Set(n.terminal_statuses??["closed","canceled"]);u={...n,items:n.items.filter(g=>!f.has(g.status))}}else if(l.scope.kind==="filter"){let f=l.scope.measurement_id,g=t.measurements.find(v=>v.id===f),h=await Zs(i.id,l.id,g,n,t.measurements),w=new Set(h.contributors);u={...n,items:n.items.filter(v=>w.has(v.id))}}let m=n.items.find(f=>f.id===l.owner_item_id),p=m!==void 0&&new Set(n.terminal_statuses??["closed","canceled"]).has(m.status);return zp(l,await Zs(i.id,l.id,d,u,t.measurements),{owner_terminal:p})}),o=a.some(c=>c.verdict==="fail"&&c.enforcement==="block"),s=a.some(c=>c.verdict==="fail"&&c.enforcement==="warn");return{gate_id:i.id,tree_id:n.tree_id,trigger:r.trigger,dry_run:r.dry_run===!0,evaluated_at:new Date().toISOString(),verdict:o?"block":s?"warn":"pass",exit_code:o?1:0,assertions:a,assertions_total:a.length,row_contract:{row_keys:["assertions"],jq_selector:".assertions[]"},cost:ac(a.map(c=>c.cost),Math.max(0,...a.map(c=>c.cost.duration_ms)))}}function fr(e){return xp.join(e,"assurance.json")}async function dc(e){let t=await X(fr(e));return t===null?sn():hr(t)}function hr(e){try{return jt(JSON.parse(e))}catch(t){throw new y("The assurance registry is invalid. Repair or restore .agents/pm/assurance.json and retry.",_.GENERIC_FAILURE,{code:"assurance_registry_invalid",reason:String(t),nextSteps:["Restore a valid assurance.json from version control or repair its declaration references.","Run pm assurance list measurement after the repair."]})}}function gr(e,t){return t==="measurement"?e.measurements:t==="assertion"?e.assertions:e.gates}function Gp(e,t){e==="measurement"?Mi(t):e==="assertion"?Li(t):rc(t)}async function cn(e,t){let n=structuredClone(gr(await dc(e),t));return{items:n,count:n.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function Ui(e,t,n){let r=gr(await dc(e),t).find(i=>i.id===n);if(!r)throw new TypeError(`assurance ${t} ${n} not found`);return structuredClone(r)}async function _r(e,t,n,r={}){Gp(t,n);let i=await I(e),a=Y(r.author,i.author_default),o=await ir({pmRoot:e,filePath:fr(e),op:`assurance:${t}:put`,author:a,message:r.message,lockTtlSeconds:mr,lockWaitMs:pr,mutate:s=>{let c=s===null?sn():hr(s),l=gr(c,t),d=l.findIndex(m=>m.id===n.id),u=d<0?"created":"updated";if(t==="assertion"&&d>=0&&Cp(l[d],n)){let m=n.authorization_decision;if(!m||!r.authorized_decision_ids?.includes(m))throw new N(`loosening assertion ${n.id} requires a verified authorization_decision`)}return d<0?l.push(structuredClone(n)):l[d]=structuredClone(n),jt(c),{raw:`${JSON.stringify(c,null,2)}
2
+ `,result:{changed:!0,action:u,kind:t,id:n.id}}}});return{...o.result,changed:o.changed}}async function zi(e,t,n={}){let r=sn();r.measurements=structuredClone(t.measurements),r.assertions=structuredClone(t.assertions),r.gates=structuredClone(t.gates),jt(r);let i=await I(e),a=Y(n.author,i.author_default),o=await ir({pmRoot:e,filePath:fr(e),op:"assurance:bundle:apply",author:a,message:n.message,lockTtlSeconds:mr,lockWaitMs:pr,mutate:s=>{let c=s===null?sn():hr(s),l=[],d=[],u=(m,p,f)=>{for(let g of p){let h=m.find(w=>w.id===g.id);if(!h){m.push(structuredClone(g)),l.push(`${f}:${g.id}`);continue}if(oe(h)!==oe(g))throw new N(`assurance bundle refuses to replace divergent ${f} ${g.id}`);d.push(`${f}:${g.id}`)}};return u(c.measurements,r.measurements,"measurement"),u(c.assertions,r.assertions,"assertion"),u(c.gates,r.gates,"gate"),jt(c),{raw:`${JSON.stringify(c,null,2)}
3
+ `,result:{changed:l.length>0,created_ids:l,unchanged_ids:d}}}});return{...o.result,changed:o.changed}}async function uc(e,t,n,r={}){let i=await I(e),a=Y(r.author,i.author_default),o=await ir({pmRoot:e,filePath:fr(e),op:`assurance:${t}:remove`,author:a,message:r.message,lockTtlSeconds:mr,lockWaitMs:pr,mutate:s=>{let c=s===null?sn():hr(s);if(t==="measurement"){let u=ic(c).get(n);if(u&&u.length>0)throw new N(`assurance measurement ${n} is referenced by ${u.join(", ")}`)}if(t==="assertion"&&c.gates.some(u=>u.assertion_ids.includes(n)))throw new N(`assurance assertion ${n} is referenced by gate`);let l=gr(c,t),d=l.findIndex(u=>u.id===n);if(d<0)throw new N(`assurance ${t} ${n} not found`);return l.splice(d,1),jt(c),{raw:`${JSON.stringify(c,null,2)}
4
+ `,result:{changed:!0,action:"removed",kind:t,id:n}}}});return{...o.result,changed:o.changed}}async function mc(e,t,n={}){if(t.dry_run)throw new TypeError("dry-run assurance verdicts are not persisted");let r=await I(e);await rr({pmRoot:e,op:"assurance:gate:verdict",author:Y(n.author,r.author_default),context:{assurance_verdict:t},message:n.message??`Assurance gate ${t.gate_id} returned ${t.verdict}`,lockTtlSeconds:mr,lockWaitMs:pr})}async function pc(e,t={}){let n=t.limit??Ap;if(!Number.isInteger(n)||n<1||n>Ft)throw new TypeError(`assurance verdict limit must be an integer from 1 through ${Ft}`);return(await tr(nr(e),ue)).reverse().filter(i=>i.op==="assurance:gate:verdict").map(i=>i.context?.assurance_verdict).filter(i=>typeof i=="object"&&i!==null&&"gate_id"in i).filter(i=>t.gate_id===void 0||i.gate_id===t.gate_id).slice(0,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]="05c29627-6763-5aee-8579-71e563a98780")}catch{}})();var wr=["software-delivery","research","agent-evaluation","operations"];function fc(e,t,n,r,i){return{id:e,measurement_id:t,owner_item_id:n,scope:{kind:"active"},ceiling:r,lifetime:"hold",enforcement:i,negative_control:{cases:[{observed:r,expected:"pass"},{observed:r+1,expected:"fail"}]}}}function yr(e,t,n,r,i){let a=`preset-${e}`,o=i.map(c=>({id:`${a}-missing-${c}`,description:`Active items missing ${c} evidence.`,source:{kind:"links",link:c,state:"missing"}})),s=o.map(c=>fc(`${c.id}-zero`,c.id,r,0,"warn"));return{id:e,title:t,description:n,declarations:{measurements:o,assertions:s,gates:[{id:`${a}-readiness`,description:n,assertion_ids:s.map(c=>c.id),triggers:["ci","scheduled"]}]}}}function vr(e,t){return e==="software-delivery"?yr(e,"Software delivery","Warn when active delivery work lacks executable tests or documentation.",t,["tests","docs"]):e==="research"?yr(e,"Research","Warn when active research work lacks reproducibility files or documentation.",t,["files","docs"]):e==="agent-evaluation"?yr(e,"Agent evaluation","Warn when active evaluation work lacks executable scenarios or recorded artifacts.",t,["tests","files"]):yr(e,"Operations","Warn when active operational work lacks runbook documentation or repair evidence.",t,["docs","files"])}function hc(e,t,n,r={}){return zi(e,vr(t,n).declarations,r)}async function gc(e,t){let n=new Set(e.terminal_statuses??["closed","canceled"]),r={...e,items:e.items.filter(a=>!n.has(a.status))};return await Promise.all(["files","tests","docs"].map(async a=>{let o={id:`derived-active-missing-${a}`,description:`Observed active items missing ${a} evidence.`,source:{kind:"links",link:a,state:"missing"}},c=(await ji(o,r)).value,l=fc(`${o.id}-ceiling`,o.id,t,c,"observe"),d=`active-missing-${a}`;return{id:d,population_size:r.items.length,scope:{kind:"active"},observed:c,declarations:{measurements:[o],assertions:[l],gates:[{id:`derived-${d}`,description:`Observe the accepted ${a} evidence baseline.`,assertion_ids:[l.id],triggers:["ci","scheduled"]}]}}}))}function _c(e,t,n={}){return zi(e,{measurements:t.flatMap(r=>r.declarations.measurements),assertions:t.flatMap(r=>r.declarations.assertions),gates:t.flatMap(r=>r.declarations.gates)},n)}async function yc(e,t,n,r={}){let i=t.enforcement==="observe"?"warn":"block";if(t.enforcement==="block"||n!==i)throw new TypeError(`assurance assertion ${t.id} promotion must be ${t.enforcement} -> ${i}`);return _r(e,"assertion",{...t,enforcement:n},{...r,message:r.message??`Promote assurance assertion ${t.id} from ${t.enforcement} to ${n}`})}import bc from"node:fs/promises";import{createRequire as Wp}from"node:module";import be from"node:path";(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]="c21b1a94-1d80-57c0-b090-c4831fc505a2")}catch{}})();function wc(e,t){let n=be.relative(t,e);if(n.length>0&&n!==".."&&!n.startsWith(`..${be.sep}`)&&!be.isAbsolute(n))return n.split(be.sep).join("/");let r=be.resolve(e),i=0xcbf29ce484222325n;for(let o=0;o<r.length;o+=1)i^=BigInt(r.charCodeAt(o)),i=BigInt.asUintN(64,i*0x100000001b3n);return`<external>/${i.toString(16).padStart(16,"0")}/${be.basename(be.dirname(e))}/package.json`}function Bp(e){return e.includes(`${be.sep}.pnpm${be.sep}`)?"pnpm":e.includes(`${be.sep}node_modules${be.sep}`)?"npm":"other"}async function vc(e){try{let t=JSON.parse(await bc.readFile(e,"utf8"));return t.name==="@unbrained/pm-cli"&&typeof t.version=="string"&&t.version.trim().length>0?t.version.trim():void 0}catch{return}}async function qi(e){try{return await bc.realpath(e)}catch{return be.resolve(e)}}async function kc(e,t,n=Ee(import.meta.url,["../../.."])){let r=await qi(t),i=await qi(be.join(n,"package.json")),a=await vc(i),o=new Map;a!==void 0&&o.set(i,{version:a,path:wc(i,r),layout:"host",consumers:["pm-cli-host"]});for(let l of e)try{let d=Wp(l.entry_path).resolve("@unbrained/pm-cli/package.json"),u=await qi(d),m=await vc(u);if(m===void 0)continue;let p=u,f=o.get(p);if(f){f.consumers.includes(l.name)||(f.consumers.push(l.name),f.consumers.sort((g,h)=>g.localeCompare(h)));continue}o.set(p,{version:m,path:wc(u,r),layout:Bp(u),consumers:[l.name]})}catch{}let s=[...o.values()].sort((l,d)=>l.path.localeCompare(d.path)),c=a===void 0?[]:s.filter(l=>l.version!==a);return{host_version:a??null,copies:s,mismatches:c,warnings:c.map(l=>`extension_host_pm_cli_version_skew:${a}:${l.version}:${l.consumers.join("+")}`)}}import{createHash as $c}from"node:crypto";import dn from"node:fs/promises";import un from"node:path";import{Option as gE}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]="8d60b13c-c58a-506f-adc9-2414dd69edef")}catch{}})();function Hp(e,t){let n=[],r=new Set;for(let i of t.keys){if(!Object.hasOwn(e,i))continue;let a=e[i];if(a!=null){if(typeof a=="string"){n.push(a);continue}if(!Array.isArray(a)||!a.every(o=>typeof o=="string"))return;r.has(a)||(r.add(a),n.push(...a))}}return n.length>0?n.join("; "):void 0}function br(e,t){return e.find(r=>r.target===t)??{target:t,keys:[t]}}function P(e,t){return e[t]===!0?!0:void 0}function Ke(e,t){return e[t]===!1?!0:void 0}function xc(e,t){return t.some(n=>e[n]===!0)?!0:void 0}function Sc(e,t){for(let[n,r]of Object.entries(t))n==="__proto__"||n==="constructor"||n==="prototype"||Object.hasOwn(e,n)||(e[n]=r)}function Ec(e){let t=i=>bi(e,br(Xn,i)),n=i=>Vo(e,br(Ri,i)),r={title:t("title"),description:t("description"),body:t("body"),status:t("status"),closeReason:t("closeReason"),priority:t("priority"),type:t("type"),tags:t("tags"),addTags:n("addTags"),removeTags:n("removeTags"),deadline:t("deadline"),estimatedMinutes:t("estimatedMinutes"),acceptanceCriteria:Hp(e,br(Ri,"acceptanceCriteria")),addAc:n("addAc"),removeAc:n("removeAc"),definitionOfReady:t("definitionOfReady"),order:t("order"),rank:t("rank"),goal:t("goal"),objective:t("objective"),value:t("value"),impact:t("impact"),outcome:t("outcome"),whyNow:t("whyNow"),author:t("author"),message:t("message"),force:!!e.force,ownershipMetadataBypass:e.ownershipMetadataBypass===!0?!0:void 0,ownershipDependencyBypass:e.ownershipDependencyBypass===!0?!0:void 0,assignee:t("assignee"),parent:t("parent"),allowUnresolvedDeps:xc(e,["allowUnresolvedDeps","allow_unresolved_deps"])===!0,reviewer:t("reviewer"),risk:t("risk"),confidence:t("confidence"),sprint:t("sprint"),release:t("release"),blockedBy:t("blockedBy"),blockedReason:t("blockedReason"),unblockNote:t("unblockNote"),reporter:t("reporter"),severity:t("severity"),environment:t("environment"),reproSteps:t("reproSteps"),resolution:t("resolution"),expectedResult:t("expectedResult"),actualResult:t("actualResult"),affectedVersion:t("affectedVersion"),fixedVersion:t("fixedVersion"),component:t("component"),regression:e.regression===!0?"true":t("regression"),customerImpact:t("customerImpact"),dep:n("dep"),depRemove:n("depRemove"),replaceDeps:P(e,"replaceDeps"),replaceTests:P(e,"replaceTests"),replaceFiles:P(e,"replaceFiles"),replaceDocs:P(e,"replaceDocs"),comment:n("comment"),note:n("note"),learning:n("learning"),file:n("file"),test:n("test"),doc:n("doc"),reminder:n("reminder"),event:n("event"),typeOption:n("typeOption"),field:n("field"),unset:n("unset"),clearDeps:P(e,"clearDeps"),clearComments:P(e,"clearComments"),clearNotes:P(e,"clearNotes"),clearLearnings:P(e,"clearLearnings"),clearFiles:P(e,"clearFiles"),clearTests:P(e,"clearTests"),clearDocs:P(e,"clearDocs"),clearReminders:P(e,"clearReminders"),clearEvents:P(e,"clearEvents"),clearTypeOptions:P(e,"clearTypeOptions")};return Sc(r,e),r}function Q(e,t){let n=br(Jo,t),r=bi(e,n);if(r!==void 0)return r;for(let i of n.keys){let a=e[i];if(Array.isArray(a)){let o=a.filter(s=>typeof s=="string");if(o.length>0)return o.join(",")}if(t==="ids"&&typeof a=="string")return a;if(typeof a=="number"&&Number.isFinite(a))return String(a)}}function Jp(e){let t=P(e,"filterFilesMissing"),n=P(e,"filterDocsMissing");return{filterReviewerMissing:P(e,"filterReviewerMissing"),filterRiskMissing:P(e,"filterRiskMissing"),filterConfidenceMissing:P(e,"filterConfidenceMissing"),filterSprintMissing:P(e,"filterSprintMissing"),filterReleaseMissing:P(e,"filterReleaseMissing"),hasNotes:P(e,"hasNotes"),hasLearnings:P(e,"hasLearnings"),hasFiles:P(e,"hasFiles"),hasDocs:P(e,"hasDocs"),hasTests:P(e,"hasTests"),hasComments:P(e,"hasComments"),hasDeps:P(e,"hasDeps"),hasBody:P(e,"hasBody"),hasLinkedCommand:P(e,"hasLinkedCommand"),noNotes:Ke(e,"notes"),noLearnings:Ke(e,"learnings"),noFiles:Ke(e,"files")??t,filterFilesMissing:t,noDocs:Ke(e,"docs")??n,filterDocsMissing:n,noTests:Ke(e,"tests"),noComments:Ke(e,"comments"),noDeps:Ke(e,"deps"),emptyBody:P(e,"emptyBody"),noLinkedCommand:Ke(e,"linkedCommand")}}function Gi(e){let t={status:Q(e,"status"),type:Q(e,"type"),tag:Q(e,"tag"),priority:Q(e,"priority"),deadlineBefore:Q(e,"deadlineBefore"),deadlineAfter:Q(e,"deadlineAfter"),updatedAfter:Q(e,"updatedAfter"),updatedBefore:Q(e,"updatedBefore"),createdAfter:Q(e,"createdAfter"),createdBefore:Q(e,"createdBefore"),today:P(e,"today"),recent:P(e,"recent"),ids:Q(e,"ids"),assignee:Q(e,"assignee"),assigneeFilter:Q(e,"assigneeFilter"),parent:Q(e,"parent"),sprint:Q(e,"sprint"),release:Q(e,"release"),limit:Q(e,"limit"),offset:Q(e,"offset"),noTruncate:Ke(e,"truncate"),includeBody:P(e,"includeBody"),strictRead:P(e,"strictRead"),compact:P(e,"compact"),brief:P(e,"brief"),full:P(e,"full"),fields:Q(e,"fields"),sort:Q(e,"sort"),order:Q(e,"order"),tree:P(e,"tree"),treeDepth:Q(e,"treeDepth"),filterAcMissing:P(e,"filterAcMissing"),filterEstimatesMissing:xc(e,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:P(e,"filterResolutionMissing"),filterMetadataMissing:P(e,"filterMetadataMissing"),...Jp(e)};return Sc(t,e),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]="0e153ece-4fc0-5134-97f0-c2315aff0031")}catch{}})();function C(e,t){let n=e[t];return typeof n=="string"&&n.trim().length>0?n:void 0}function ee(e,t){let n=e[t];return typeof n=="string"?n.trim().length>0?n:void 0:typeof n=="number"&&Number.isFinite(n)?String(n):void 0}function Vp(e,t){let n=e[t];return typeof n=="string"?n:typeof n=="number"&&Number.isFinite(n)?String(n):void 0}function ln(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function Hi(e,t){if(typeof e=="number"){if(!Number.isInteger(e))throw new y(`${t} must be a finite integer.`,_.USAGE);return e}if(typeof e=="string"&&e.trim().length>0){let n=Number(e);if(!Number.isInteger(n))throw new y(`${t} must be a finite integer.`,_.USAGE);return n}}function EE(e,t){return typeof e.limit=="number"&&Number.isFinite(e.limit)?e.limit:typeof t.limit=="number"&&Number.isFinite(t.limit)?t.limit:C(e,"limit")??C(t,"limit")}function AE(e){let t=C(e,"outputFormat");return{json:!0,quiet:!0,author:C(e,"author"),path:C(e,"path"),noExtensions:e.noExtensions===!0||e.no_extensions===!0,noPager:!0,outputInclude:C(e,"outputInclude"),outputLimit:ee(e,"outputLimit"),outputBudget:ee(e,"outputBudget"),outputSession:C(e,"outputSession"),outputCursor:C(e,"outputCursor"),outputFormat:t==="json"||t==="toon"?t:void 0}}var Kp=new Set(["tags","blockedBy","blocked_by","skills","fields"]),Yp=new Set(["comment","note","learning","reminder","event","dep","depRemove","dep_remove","file","doc","test","unset","addGlob","add_glob","migrate","envSet","env_set","envClear","env_clear"]),Xp=new Set(["files","files-discover","docs","test","test-all"]),Zp=new Set(["claim","release","start-task","pause-task","close-task"]),Qp={list:["status","type","tag","priority","limit","offset"],search:["mode","status","type","tag","priority","limit"],create:["title","type","status","description","body","priority","tags","parent","createMode","create_mode","allowMissingParent","allowDuplicate"],update:["parent","allowMissingParent","completedAt"],copy:["allowDuplicate"],close:["duplicateOf","completedAt"],append:["body"]},ef=["outputInclude","outputLimit","outputBudget","outputFormat","outputSession","outputCursor"];function Rc(e,t){let n={},r=t!==void 0&&Xp.has(t),i=t==="files"||t==="files-discover"||t==="docs";for(let[a,o]of Object.entries(e)){if(Array.isArray(o)&&Kp.has(a)){n[a]=o.join(",");continue}if(a==="note"&&i){n[a]=o;continue}if(typeof o=="string"&&Yp.has(a)){n[a]=[o];continue}if(typeof o=="string"&&r&&(a==="add"||a==="remove")){n[a]=[o];continue}n[a]=o}return n}function RE(e,t){let n=zo(e.options),r={},i=c=>{n[c]!==void 0||e[c]===void 0||(r[c]=e[c])};for(let c of Qp[t??""]??[])i(c);for(let c of ef)i(c);let a=Rc({...r,...n},t),o=C(e,"author"),s=t!==void 0&&Zp.has(t)?C(e,"assignee")??C(a,"assignee"):void 0;return o&&a.author===void 0?{...a,author:o}:s&&a.author===void 0?{...a,author:s}:a}function IE(e){if(e.addNote===void 0)return e;let t={...e};return t.note===void 0&&typeof t.addNote=="string"&&(t.note=t.addNote),delete t.addNote,t}function CE(e){let t={...e};return t.discoveryNote!==void 0&&t.note===void 0&&typeof t.discoveryNote=="string"&&(t.note=t.discoveryNote),delete t.discover,delete t.discoveryNote,t}function $E(e){let t=[],n=!0;for(let r of e.trim().toLowerCase()){if(r>="a"&&r<="z"||r>="0"&&r<="9"){t.push(r),n=!1;continue}n||(t.push("-"),n=!0)}return t.at(-1)==="-"&&t.pop(),t.join("")}function TE(e){return e.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ")}function Ji(e){return Array.isArray(e)?e.map(t=>String(t)).filter(t=>t.length>0):[]}function OE(e,t){let n=new Set(["action","args","author","cwd","fullChangedFields","id","options","path","query","reason","target"]),r={};for(let[a,o]of Object.entries(e))n.has(a)||(r[a]=o);let i={...r,...t};return delete i.args,i}function DE(e,t){return{changedFields:e.fullChangedFields===!0?"full":"compact",idOnly:e.idOnly===!0,runnerOptions:{...t}}}function Bi(e){return{type:ee(e,"filterType"),tag:ee(e,"filterTag"),priority:ee(e,"filterPriority"),deadlineBefore:ee(e,"filterDeadlineBefore"),deadlineAfter:ee(e,"filterDeadlineAfter"),updatedAfter:ee(e,"filterUpdatedAfter"),updatedBefore:ee(e,"filterUpdatedBefore"),createdAfter:ee(e,"filterCreatedAfter"),createdBefore:ee(e,"filterCreatedBefore"),ids:Vp(e,"ids"),assignee:ee(e,"filterAssignee"),assigneeFilter:ee(e,"filterAssigneeFilter")??ee(e,"filterAssignee_filter"),parent:ee(e,"filterParent"),sprint:ee(e,"filterSprint"),release:ee(e,"filterRelease"),limit:ee(e,"limit"),offset:ee(e,"offset")}}function Wi(e){if(typeof e=="string"&&e.trim().length>0)return e;if(Array.isArray(e))return Ji(e)}function kr(e){if(typeof e=="number"&&Number.isFinite(e)||typeof e=="string"&&e.trim().length>0)return e}function PE(e){let t=Wi(e.kind),n=Wi(e.exemptIsolate),r=Wi(e.exemptIsolateType);return{...t===void 0?{}:{kind:t},maxDepth:kr(e.maxDepth),limit:kr(e.limit),after:C(e,"after"),direction:C(e,"direction"),maxPaths:kr(e.maxPaths),sample:kr(e.sample),...n===void 0?{}:{exemptIsolate:n},...r===void 0?{}:{exemptIsolateType:r},saveBaseline:e.saveBaseline===!0,rebuild:e.rebuild===!0,clear:e.clear===!0,summary:e.summary===!0,...e.full===!0?{full:!0}:{}}}function NE(e){return{status:C(e,"filterStatus"),list:ln(e.list)?Gi(e.list):Bi(e),reason:C(e,"reason"),resolution:C(e,"resolution"),expectedResult:C(e,"expectedResult")??C(e,"expected_result")??C(e,"expected"),actualResult:C(e,"actualResult")??C(e,"actual_result")??C(e,"actual"),validateClose:C(e,"validateClose")??C(e,"validate_close"),author:C(e,"author"),message:C(e,"message"),force:e.force===!0?!0:void 0,dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 0}}var tf=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","ids","list","update","limit","offset","dryRun","dry_run","rollback","checkpoint","noCheckpoint","no_checkpoint"]);function Ac(e){let t={};for(let[n,r]of Object.entries(e))tf.has(n)||(t[n]=r);return Ic(t)}function Ic(e){let t=Rc(e,"update-many");for(let n of Xn)for(let r of n.keys){let i=t[r];typeof i=="number"&&Number.isFinite(i)&&(t[r]=String(i))}return Ec(t)}function ME(e){if(ln(e.list)||ln(e.update)){let t=ln(e.update)?e.update:Ac(e);return{status:ee(e,"filterStatus"),list:ln(e.list)?Gi(e.list):Bi(e),update:Ic(t),dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 0}}return{status:ee(e,"filterStatus"),list:Bi(e),update:Ac(e),dryRun:e.dryRun===!0||e.dry_run===!0?!0:void 0,rollback:C(e,"rollback"),checkpoint:e.checkpoint===!1||e.noCheckpoint===!0||e.no_checkpoint===!0?!1:void 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]="b389e521-f689-5895-a5f4-08c3866b3ea3")}catch{}})();function Re(e,t){throw new y(e,_.USAGE,t)}var nf="2026-07-15T06:22:12.276Z",rf=Date.parse(nf),af=[["attributed","attributed"],["legacy_unknown","actionable_unknown"]],Cc=e=>typeof e=="string"?e:"",Tc=e=>{let t=e??{},n=Cc(t.author).trim().toLowerCase(),r=Number(["","unknown"].includes(n)),i=+(Date.parse(Cc(t.ts))>=rf);return af[r][i]};function Oc(e,t,n=20,r=new Set,i=!1){let a=[],o=[],s={legacy_unknown:0,actionable_unknown:0},c=Math.max(0,n),l=0,d=0,u=0;for(let[m,p]of t.split(/\r?\n/).entries()){let f;try{f=JSON.parse(p)}catch{continue}l+=1;let g=Tc(f);if(g!=="attributed"){if(d+=1,g==="actionable_unknown"&&r.has(`${e}:${m+1}`)){u+=1;continue}s[g]+=1,i&&g==="actionable_unknown"&&o.push({item_id:e,line:m+1}),a.length<c&&a.push({item_id:e,line:m+1})}}return{checked_events:l,unknown_event_count:d,legacy_unknown_event_count:s.legacy_unknown,actionable_unknown_event_count:s.actionable_unknown,acknowledged_actionable_event_count:u,samples:a,samples_truncated:s.legacy_unknown+s.actionable_unknown>a.length,actionable_events:o}}var HE=(e,t,n=20,r=new Set)=>Oc(e,t,n,r);function Dc(e){let t=new Set;for(let n of e.split(/\r?\n/)){let r;try{r=JSON.parse(n)}catch{continue}let a=(typeof r=="object"&&r!==null&&typeof r.context=="object"&&r.context!==null?r.context:{}).author_acknowledgment;if(!(typeof a!="object"||a===null||!Array.isArray(a.events)))for(let o of a.events)typeof o=="object"&&o!==null&&typeof o.item_id=="string"&&Number.isSafeInteger(o.line)&&t.add(`${o.item_id}:${String(o.line)}`)}return t}var mn=async(e,t=20,n=!1)=>{let r=un.join(e,"history"),i;try{i=(await dn.readdir(r)).filter(w=>w.endsWith(".jsonl")).sort((w,v)=>w.localeCompare(v))}catch{i=[]}let a=new Set,o=[],s=[],c=0,l=0,d=0,u=0,m=0,p=0,f="_workspace.jsonl",g=new Set;if(i.includes(f))try{g=Dc(await dn.readFile(un.join(r,f),"utf8"))}catch{g=new Set}for(let w of i){let v;try{v=await dn.readFile(un.join(r,w),"utf8")}catch{continue}let b=w.slice(0,-6),x=Oc(b,v,t-o.length,g,n);c+=1,l+=x.checked_events,d+=x.unknown_event_count,u+=x.legacy_unknown_event_count,m+=x.actionable_unknown_event_count,p+=x.acknowledged_actionable_event_count,x.unknown_event_count>0&&a.add(b),o.push(...x.samples),n&&s.push(...x.actionable_events)}let h=u+m;return{checked_streams:c,checked_events:l,unknown_event_count:d,legacy_unknown_event_count:u,actionable_unknown_event_count:m,acknowledged_actionable_event_count:p,affected_item_ids:[...a].sort((w,v)=>w.localeCompare(v)),samples:o,samples_truncated:h>o.length,...n?{actionable_events:s}:{}}};function of(e){return[...new Map(e.map(t=>[`${t.item_id}:${t.line}`,{item_id:t.item_id,line:t.line}])).values()].sort((t,n)=>t.item_id.localeCompare(n.item_id)||t.line-n.line)}async function sf(e){try{return Dc(await dn.readFile(un.join(e,"history","_workspace.jsonl"),"utf8"))}catch{return new Set}}function cf(e){return(e.item_id===ue||/^[a-z0-9][a-z0-9-]*$/iu.test(e.item_id))&&Number.isSafeInteger(e.line)&&e.line>=1}function lf(e,t,n){let r=n[e.line-1]??"",i;try{i=JSON.parse(r)}catch{Re(`Unknown-author acknowledgment target ${e.item_id}:${e.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}return Tc(i)!=="actionable_unknown"&&Re(`Author acknowledgment target ${e.item_id}:${e.line} is not an actionable unknown-author event.`,{code:"history_author_acknowledge_target_not_actionable"}),{...e,source_event_hash:$c("sha256").update(r).digest("hex"),disposition:t.has(`${e.item_id}:${e.line}`)?"already_acknowledged":"actionable"}}async function Pc(e,t,n){let r=t.events??[],i=+(t.all_actionable===!0)+ +(r.length>0);i===0&&Re("Specify exactly one selector: events or all_actionable.",{code:"history_author_acknowledge_selector_required"}),i>1&&Re("Author acknowledgment accepts either explicit events or all_actionable, not both.",{code:"history_author_acknowledge_selector_conflict"}),(!Number.isSafeInteger(n)||n<0)&&Re("Author acknowledgment coordinate_limit must be a non-negative integer.",{code:"history_author_acknowledge_preview_limit_invalid"});let a=of(t.all_actionable===!0?(await mn(e,0,!0)).actionable_events:r),o=await sf(e),s=new Map;for(let m of a)if(cf(m)||Re(`Unknown-author acknowledgment target ${m.item_id}:${m.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"}),!s.has(m.item_id))try{s.set(m.item_id,(await dn.readFile(un.join(e,"history",`${m.item_id}.jsonl`),"utf8")).split(/\r?\n/u))}catch{Re(`Unknown-author acknowledgment target ${m.item_id}:${m.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}let c=a.map(m=>lf(m,o,s.get(m.item_id))),l=t.all_actionable===!0?"all_actionable":"events",d=$c("sha256").update(JSON.stringify({version:1,selection:l,coordinates:c})).digest("hex"),u=c.filter(({disposition:m})=>m==="actionable").length;return{plan:{selection:{kind:l},selected_count:c.length,actionable_count:u,already_acknowledged_count:c.length-u,omitted_count:Math.max(0,c.length-n),coordinates:c.slice(0,n),plan_fingerprint:d},completeCoordinates:c}}async function JE(e,t,n=50){return(await Pc(e,t,n)).plan}function df(e,t){let n=e.length>0;return n&&t&&Re("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_conflict",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']}),!n&&!t&&Re("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_required",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']}),{events:uf(e),all_actionable:t}}function uf(e){return e.map(t=>{let n=t.lastIndexOf(":"),r=t.slice(0,n).trim(),i=Number(t.slice(n+1)),a=r===ue||/^[a-z0-9][a-z0-9-]*$/iu.test(r);return(n<1||!a||!Number.isSafeInteger(i)||i<1)&&Re(`history-author-acknowledge --event expects <item-id>:<one-based-line>, received "${t}".`,{code:"history_author_acknowledge_target_unreadable"}),{item_id:r,line:i}})}function VE(e,t){let n=df(Ji(t.historyEvent),t.allActionable===!0||t.all_actionable===!0);return mf(e,{events:n.events,all_actionable:n.all_actionable,dry_run:t.dryRun===!0||t.dry_run===!0,plan_fingerprint:C(t,"planFingerprint")??C(t,"plan_fingerprint"),coordinate_limit:typeof t.limit=="number"?t.limit:typeof t.limit=="string"?Number(t.limit):void 0,attributed_author:C(t,"attributedAuthor")??C(t,"attributed_author")??void 0,reviewer:C(t,"reviewer"),reason:C(t,"reason")})}async function mf(e,t){let n=t.reviewer?.trim()??"",r=t.attributed_author?.trim()??"",i=t.reason?.trim()??"",a=await Pc(e,t,t.coordinate_limit??50);if(t.dry_run===!0)return{dry_run:!0,mutated:!1,acknowledged:0,outcome:"preview",exit_code:_.SUCCESS,plan:a.plan};if([n.length>0,n.toLowerCase()!=="unknown",r.length>0,r.toLowerCase()!=="unknown",i.length>0].includes(!1)&&Re("Author acknowledgment requires events, reviewer, attributed_author, and reason.",{code:"history_author_acknowledge_required_values_missing"}),t.plan_fingerprint?.trim()||Re("Author acknowledgment apply requires plan_fingerprint from a fresh dry-run preview.",{code:"history_author_acknowledge_plan_fingerprint_required",recovery:{suggested_retry:"Rerun history-author-acknowledge with --dry-run, then pass --plan-fingerprint <value>."}}),t.plan_fingerprint.trim()!==a.plan.plan_fingerprint)throw new y("Author acknowledgment selection changed after preview; no history was mutated.",_.CONFLICT,{code:"history_author_acknowledge_plan_conflict",recovery:{suggested_retry:"Rerun history-author-acknowledge with --dry-run and apply the fresh plan_fingerprint."}});let s=a.completeCoordinates.filter(({disposition:u})=>a.plan.selection.kind==="events"||u==="actionable").map(({item_id:u,line:m})=>({item_id:u,line:m}));if(s.length===0)return{dry_run:!1,mutated:!1,acknowledged:0,outcome:"no_effect",exit_code:_.NO_EFFECT,plan:a.plan};let c=await I(e),l=await rr({pmRoot:e,op:"history:author-acknowledge",author:n,context:{author_acknowledgment:{events:s,attributed_author:r}},message:i,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),d=a.plan.actionable_count>0&&a.plan.already_acknowledged_count>0?{outcome:"partial_effect",exit_code:_.PARTIAL_EFFECT}:{outcome:"effect",exit_code:_.SUCCESS};return{dry_run:!1,mutated:!0,acknowledged:s.length,...d,plan:a.plan,history_path:l.historyPath}}import Vi from"node:fs/promises";import Ki from"node:path";(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]="6efed404-acd2-5c3a-a008-856df67c8b77")}catch{}})();var pf=8388608,ff=new Set(["resolved","failed"]),hf=[{kind:"boolean",matches:e=>typeof e=="boolean"||typeof e=="string"&&/^(?:true|false)$/iu.test(e.trim())},{kind:"single_digit",matches:e=>typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=9||typeof e=="string"&&/^\d$/u.test(e.trim())}];function je(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Yi(e){return hf.find(t=>t.matches(e))?.kind}function ZE(e){let t=new Map,n=0,r=0;return{entries:e.map(a=>{let o=je(a.agent_provenance)?a.agent_provenance:void 0;if(o===void 0)return a;let s={},c=!1;for(let[d,u]of Object.entries(o)){let m=je(u)?Yi(u.value):void 0;if(m===void 0){s[d]=u;continue}c=!0,r+=1;let p=a.agent_harness??"unknown",f=`${p}\0${d}\0${m}`,g=t.get(f)??{harness:p,dimension:d,kind:m,count:0};g.count+=1,t.set(f,g)}if(!c)return a;n+=1;let l={...a};return Object.keys(s).length===0?delete l.agent_provenance:l.agent_provenance=s,l}),receipt:{changed:n>0,events_changed:n,observations_removed:r,invalid_values:[...t.values()].sort((a,o)=>a.harness.localeCompare(o.harness)||a.dimension.localeCompare(o.dimension)||a.kind.localeCompare(o.kind))}}}async function QE(e){let t=[];for(let n of await Nc(e))try{let r=await Vi.readFile(Ki.join(e,"history",n),"utf8");for(let i of r.split(`
5
+ `)){if(i.trim().length===0)continue;let a=Mc(i);if(a===null||!je(a.agent_provenance))continue;if(Object.values(a.agent_provenance).some(s=>je(s)&&Yi(s.value)!==void 0)){t.push(n.slice(0,-6));break}}}catch{}return t}async function Nc(e){try{return(await Vi.readdir(Ki.join(e,"history"))).filter(t=>t.endsWith(".jsonl")).sort()}catch{return[]}}async function gf(e,t,n){let r;try{r=await Vi.open(Ki.join(e,"history",t),"r");let i=(await r.stat()).size,a=Math.min(i,Math.max(0,n)),o=Buffer.alloc(a),{bytesRead:s}=await r.read(o,0,a,0),c=o.subarray(0,s).toString("utf8"),l=s>=i,d=c.lastIndexOf(`
6
+ `),u=c;return l||(u=d===-1?"":c.slice(0,d+1)),{content:u,bytesRead:s,complete:l}}catch{return null}finally{await r?.close()}}function Mc(e){try{let t=JSON.parse(e);return je(t)?t:null}catch{return null}}function _f(e,t,n){let r=typeof e.agent_harness=="string"?e.agent_harness:void 0;if(r===void 0)return;let i=je(e.agent_provenance)?e.agent_provenance:{};if(Object.entries(i).forEach(([o,s])=>{if(!je(s))return;let c=Yi(s.value);if(!c)return;let l=`${r}\0${o}\0${c}`,d=n.get(l)??{harness:r,dimension:o,kind:c,count:0};d.count+=1,n.set(l,d)}),!je(e.context))return;let a=e.context.agent_provenance_outcomes;je(a)&&Object.entries(a).forEach(([o,s])=>{if(!je(s)||typeof s.resolver!="string"||!ff.has(String(s.status)))return;let c=`${r}\0${o}\0${s.resolver}`,l=t.get(c)??{harness:r,dimension:o,resolver:s.resolver,attempts:0,successes:0};l.attempts+=1,s.status==="resolved"&&(l.successes+=1),t.set(c,l)})}function yf(e,t,n,r,i){let a=i;for(let o of e.split(`
7
+ `)){if(o.trim().length===0)continue;if(a>=r)return{eventsRead:a,truncated:!0};a+=1;let s=Mc(o);s&&_f(s,t,n)}return{eventsRead:a,truncated:!1}}async function Lc(e,t=1e4){let n=new Map,r=new Map,i=0,a=0,o=!1;for(let l of await Nc(e)){let d=await gf(e,l,Math.max(0,pf-a));if(d===null)continue;a+=d.bytesRead;let u=yf(d.content,n,r,t,i);if(i=u.eventsRead,u.truncated){o=!0;break}if(!d.complete){o=!0;break}}let s=[...n.values()].sort((l,d)=>l.harness.localeCompare(d.harness)||l.dimension.localeCompare(d.dimension)||l.resolver.localeCompare(d.resolver)),c=[...r.values()].sort((l,d)=>l.harness.localeCompare(d.harness)||l.dimension.localeCompare(d.dimension)||l.kind.localeCompare(d.kind));return{outcomes:s,invalid_values:c,warnings:o?[]:[...s.filter(l=>l.attempts>0&&l.successes===0).map(l=>`provenance_resolver_zero_success:${l.harness}:${l.dimension}:${l.resolver}:${String(l.attempts)}`),...c.map(l=>`provenance_value_domain_invalid:${l.harness}:${l.dimension}:${l.kind}:${String(l.count)}`)],events_read:i,truncated:o}}import tt from"node:fs/promises";import fe from"node:path";import Ut from"node:fs/promises";import{createHash as wf}from"node:crypto";import jc from"node:path";(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]="32538934-2cbb-50fe-b721-ad9197cef7d8")}catch{}})();var Uc=4,vf="history-drift-cache.json";function zc(e){return jc.join(e,"runtime",vf)}async function bf(e){try{let t=await Ut.readFile(zc(e),"utf8"),n=JSON.parse(t);return n.version!==Uc||typeof n.entries!="object"||n.entries===null?null:n}catch{return null}}async function kf(e,t,n,r,i){let a=nr(e),o;try{o=await Ut.stat(a)}catch(l){return j(l)||i.unreadableStreams.push(ue),!1}let s=i.missingStreams.length,c=await Gc({itemId:ue,historyPath:a,stat:o,cached:t[ue],verifyCacheHitByContent:r,accumulator:i});return c.verification?(c.verification.chainOk||i.chainMismatches.push(ue),n[ue]={mtime_ms:o.mtimeMs,ctime_ms:o.ctimeMs,size:o.size,content_hash:c.verification.contentHash,latest_after_hash:c.verification.latestAfterHash,chain_ok:c.verification.chainOk,item_hash_version:c.verification.itemHashVersion},c.cacheDirty):(i.missingStreams.splice(s),c.cacheDirty)}function qc(e){return wf("sha256").update(e).digest("hex")}async function xf(e){let t=await Ut.readFile(e,"utf8");return qc(t)}async function Sf(e){let t=await Ut.readFile(e,"utf8"),n=qc(t);if(t.trim().length===0)return null;let r=[],i=null;for(let o of t.split(/\r?\n/)){let s=o.trim();if(s.length===0)continue;let c=JSON.parse(s);if(typeof c.after_hash!="string"||c.after_hash.trim().length===0)throw new Error("missing after_hash");r.push(c),i=c.after_hash}if(!i)return null;let a=ys(r);return{latestAfterHash:i,chainOk:a.ok,contentHash:n,itemHashVersion:a.item_hash_version??Ii}}function Ef(e,t){return e!==void 0&&e.mtime_ms===t.mtimeMs&&e.ctime_ms===t.ctimeMs&&e.size===t.size}async function Fc(e,t,n){try{let r=await Sf(t);return r||(n.missingStreams.push(e),null)}catch{return n.unreadableStreams.push(e),null}}async function Gc(e){let t=typeof e.cached?.content_hash=="string"&&e.cached.content_hash.length>0?e.cached.content_hash:void 0;if(!(Ef(e.cached,e.stat)&&t!==void 0&&e.cached!==void 0)||!e.cached)return{verification:await Fc(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0};let r;if(e.verifyCacheHitByContent)try{r=await xf(e.historyPath)}catch{return e.accumulator.unreadableStreams.push(e.itemId),{verification:null,cacheDirty:!1}}else r=t;return!e.verifyCacheHitByContent||r===t?{verification:{latestAfterHash:e.cached.latest_after_hash,chainOk:e.cached.chain_ok,contentHash:r,itemHashVersion:e.cached.item_hash_version??Ii},cacheDirty:!1}:{verification:await Fc(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0}}async function Af(e,t,n,r){let i=Gn(e,t.id),a;try{a=await Ut.stat(i)}catch(d){return(j(d)?r.missingStreams:r.unreadableStreams).push(t.id),!1}let o=await Gc({itemId:t.id,historyPath:i,stat:a,cached:n.previousEntries[t.id],verifyCacheHitByContent:n.verifyCacheHitByContent,accumulator:r});if(!o.verification)return o.cacheDirty;o.verification.chainOk||r.chainMismatches.push(t.id),n.nextEntries[t.id]={mtime_ms:a.mtimeMs,ctime_ms:a.ctimeMs,size:a.size,content_hash:o.verification.contentHash,latest_after_hash:o.verification.latestAfterHash,chain_ok:o.verification.chainOk,item_hash_version:o.verification.itemHashVersion};let{body:s,...c}=t;return _s({metadata:c,body:s},o.verification.itemHashVersion)!==o.verification.latestAfterHash&&r.hashMismatches.push(t.id),o.cacheDirty}async function Rf(e,t){if(!(t.unreadableStreams.includes(ue)||t.chainMismatches.includes(ue)))try{let n=await ws(e);t.workspaceStateMismatches.push(...n.mismatched_documents),t.workspaceStateMissing.push(...n.missing_documents),t.workspaceStateUnreadable.push(...n.unreadable_documents)}catch{t.unreadableStreams.push(ue)}}async function xr(e,t,n={}){let r={missingStreams:[],unreadableStreams:[],hashMismatches:[],chainMismatches:[],workspaceStateMismatches:[],workspaceStateMissing:[],workspaceStateUnreadable:[]},a=(await bf(e))?.entries??{},o={},s=!1,c=n.cacheHitVerification!=="metadata",l={previousEntries:a,nextEntries:o,verifyCacheHitByContent:c};for(let m of t)await Af(e,m,l,r)&&(s=!0);let d=await kf(e,a,o,c,r);if(s||=d,await Rf(e,r),s||Object.keys(a).length!==Object.keys(o).length){let m=zc(e);try{await Ut.mkdir(jc.dirname(m),{recursive:!0}),await le(m,JSON.stringify({version:Uc,entries:o}))}catch{}}let u=[...new Set([...r.missingStreams,...r.unreadableStreams,...r.hashMismatches,...r.chainMismatches,...r.workspaceStateMismatches.length>0||r.workspaceStateMissing.length>0||r.workspaceStateUnreadable.length>0?[ue]:[]])].sort((m,p)=>m.localeCompare(p));return{...r,driftedItems:u}}import pn from"node:fs/promises";import Sr from"node:path";(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]="79f9ccbd-48d1-5eb3-82ae-3dd62427041c")}catch{}})();function If(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!="object"||t===null||Array.isArray(t))return null;let n=t,{id:r,owner:i,created_at:a,ttl_seconds:o}=n;return typeof r!="string"||typeof i!="string"||typeof a!="string"||typeof o!="number"||!Number.isFinite(o)?null:{id:r,owner:i,created_at:a,ttl_seconds:o}}function Wc(e,t,n){let r=If(t);if(r===null)return{detail:"unparseable_json",entry:{file:e,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:!1,reason:"unparseable"}};let i=Date.parse(r.created_at);if(!Number.isFinite(i))return{detail:"invalid_timestamp",entry:{file:e,id:r.id,owner:r.owner,created_at:r.created_at,ttl_seconds:r.ttl_seconds,age_seconds:null,stale:!1,reason:"unparseable"}};let a=n-i,o=Math.floor(a/1e3),s=a>r.ttl_seconds*1e3;return{detail:s?"expired":"active",entry:{file:e,id:r.id,owner:r.owner,created_at:r.created_at,ttl_seconds:r.ttl_seconds,age_seconds:o,stale:s,reason:s?"expired":"active"}}}async function Bc(e,t){let n=t??Date.now(),r=Sr.join(e,"locks"),i={scanned:0,active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0},a;try{a=(await pn.readdir(r)).filter(s=>s.endsWith(".lock")).sort()}catch(o){if(j(o))return i;throw o}for(let o of a){let s;try{s=await pn.readFile(Sr.join(r,o),"utf8")}catch(l){if(j(l))continue;i.scanned+=1,i.unreadable_lock_count+=1;continue}i.scanned+=1;let{detail:c}=Wc(o,s,n);c==="active"?i.active_lock_count+=1:c==="expired"?i.stale_lock_count+=1:i.unparseable_lock_count+=1}return i}async function Hc(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Sr.join(e,"locks"),o={scanned:0,removed:[],retained:[],warnings:[],entries:[]},s;try{s=(await pn.readdir(a)).filter(l=>l.endsWith(".lock")).sort()}catch(c){if(j(c))return o;throw c}for(let c of s){o.scanned+=1;let l=Sr.join(a,c),d=`locks/${c}`;if(r?.onRead){let p=await r.onRead(l);o.warnings.push(...p)}let u;try{u=await pn.readFile(l,"utf8")}catch(p){if(j(p)){o.scanned-=1;continue}o.warnings.push(`lock_unreadable:${c}`),o.retained.push(d),o.entries.push({file:c,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:!1,reason:"unparseable"});continue}let m=Wc(c,u,i);if(m.detail==="unparseable_json"){o.warnings.push(`lock_unparseable:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}if(m.detail==="invalid_timestamp"){o.warnings.push(`lock_invalid_timestamp:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}if(m.detail==="active"){o.retained.push(d),o.entries.push(m.entry);continue}if(!n){try{await pn.unlink(l)}catch(p){if(!j(p)){o.warnings.push(`lock_remove_failed:${c}`),o.retained.push(d),o.entries.push(m.entry);continue}}if(r?.onWrite){let p=await r.onWrite(l);o.warnings.push(...p)}}o.removed.push(d),o.entries.push(m.entry)}return 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]="bc9e5edf-c275-5172-8900-fafee9b4a2db")}catch{}})();var Cf=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts, re-apply any intended discarded values, then run pm merge reconcile; lossy receipts require explicit --force acceptance."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function Xi(e){if(typeof e!="string")return;let t=e.trim();for(let n of Cf)if(t===n.code||t.startsWith(`${n.code}:`))return n}function Zi(e){let t={};for(let n of e){let r=Xi(n);r!==void 0&&!Object.prototype.hasOwnProperty.call(t,r.code)&&(t[r.code]=r.command)}return t}function Jc(e){return Object.values(Zi(e))}import lt from"node:fs/promises";import Ie from"node:path";(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]="2c514907-377f-59f9-bfdd-a184abf7ffb7")}catch{}})();var $f=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function zt(e,t={}){let n=new Set;t.extensionName!==void 0&&n.add(Yn(t.extensionName));for(let h of t.extensionNames??[])n.add(Yn(h));let r=h=>n.size===0||n.has(Yn(h)),i=(h,w)=>Vc(h.filter(v=>r(v.name)).map(w)),a=(h,w)=>Vc(h.filter(v=>r(v.name)).flatMap(w)),{registrations:o,commands:s,parsers:c,preflight:l,services:d,renderers:u,hooks:m}=e,p=a(o.relationship_kinds??[],h=>h.definitions.map(w=>w.kind)),f=u.overrides.filter(h=>r(h.name)&&((h.commands?.length??0)>0||h.resultDiscriminator!==void 0)).map(h=>({format:h.format,commands:[...h.commands??[]],result_discriminator:h.resultDiscriminator!==void 0})).sort((h,w)=>h.format.localeCompare(w.format)),g=i(o.assurance_providers??[],h=>h.definition.id);return{capabilities:cs(e,t),commands:i(o.commands,h=>h.command),command_overrides:i(s.overrides,h=>h.command),command_handlers:i(s.handlers,h=>h.command),hooks:$f.filter(([h])=>m[h].some(w=>r(w.name))).map(([,h])=>h),flag_commands:i(o.flags,h=>h.target_command),item_types:a(o.item_types,h=>h.types.map(w=>w.name)),item_fields:a(o.item_fields,h=>h.fields.map(w=>w.name)),...p.length>0?{relationship_kinds:p}:{},migrations:a(o.migrations,h=>typeof h.definition.id=="string"?[h.definition.id]:[]),profiles:i(o.profiles,h=>h.profile.name),importers:i(o.importers,h=>h.importer),exporters:i(o.exporters,h=>h.exporter),search_providers:i(o.search_providers,h=>h.definition.name),vector_store_adapters:i(o.vector_store_adapters,h=>h.definition.name),...g.length>0?{assurance_providers:g}:{},parser_overrides:i(c.overrides,h=>h.command),service_overrides:i(d.overrides,h=>h.service),renderer_overrides:i(u.overrides,h=>h.format),...f.length>0?{renderer_ownership:f}:{},preflight_overrides:l.overrides.filter(h=>r(h.name)).length,preflight_ownership:l.overrides.filter(h=>r(h.name)).map(h=>({commands:[...h.commands??[]]}))}}function Vc(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(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]="288a7da9-888b-527d-88fb-4711917cec5b")}catch{}})();var Tf=e=>{let t='"',n=0;for(let r of e){if(r==="\\"){n+=1;continue}t+="\\".repeat(r==='"'?n*2+1:n),t+=r,n=0}return`${t}${"\\".repeat(n*2)}"`},Qi=(e,t=process.platform)=>(t==="win32"?/^[A-Za-z0-9._:/\\@=-]+$/:/^[A-Za-z0-9._:/@=-]+$/).test(e)?e:t==="win32"?Tf(e):`"${e.replace(/(["\\$`])/g,"\\$1")}"`,Kc=(e,t=process.platform)=>{let n=e.map(r=>Qi(r,t)).join(" ");return n.length>0?`pm ${n}`:"pm"};import Oh from"node:path";import{mkdir as Dh}from"node:fs/promises";import{readFile as Ar,realpath as ra,writeFile as Ff}from"node:fs/promises";import{execFile as jf}from"node:child_process";import te from"node:path";import{promisify as Uf}from"node:util";import{readFile as Of,writeFile as Df}from"node:fs/promises";import fn from"node:path";(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]="89261a49-97e5-5ffc-a81c-2409f0b529cf")}catch{}})();var Xc="# pm-cli:runtime-cache:start",ea="# pm-cli:runtime-cache:end",Zc=".agents/pm",ta=["runtime/","search/","locks/","transactions/","checkpoints/"],Pf=["search/eval-queries.json"];async function Yc(e){try{return await e()}catch(t){throw t instanceof Error&&"code"in t&&typeof t.code=="string"&&["EACCES","EPERM","EROFS"].includes(t.code)?new y("The workspace .gitignore is not writable.",_.GENERIC_FAILURE,{code:"init_gitignore_unwritable",reason:t.code.toLowerCase(),required:"Grant the current user read and write access to the workspace .gitignore before initialization.",why:"pm init must publish its managed runtime-cache ignore fence without replacing unrelated entries.",nextSteps:["Grant read and write access to the workspace .gitignore and rerun pm init.","If the workspace is intentionally read-only, initialize pm in a writable workspace or clone."]}):t}}function Qc(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/\/+$/,"")}function na(e){let t=e.replaceAll("\\","/");return fn.isAbsolute(e)||t===".."||t.startsWith("../")}function Nf(e=Zc){let t=Qc(e);return[Xc,...ta.map(n=>n==="search/"?`${t}/${n}*`:`${t}/${n}`),...Pf.map(n=>`!${t}/${n}`),ea].join(`
8
+ `)}async function xA(e,t={}){let n=fn.join(e,".gitignore"),r=Zc;if(t.pmRoot!==void 0){let d=Qc(fn.relative(fn.resolve(e),fn.resolve(t.pmRoot)));if(na(d))return{path:n,changed:!1};d.length>0&&(r=d)}let i="";try{i=await Yc(()=>Of(n,"utf8"))}catch(d){if(!(d instanceof Error&&"code"in d&&j(d)))throw d}let a=i.indexOf(Xc),o=i.indexOf(ea),c=(a>=0&&o>=a?`${i.slice(0,a)}${i.slice(o+ea.length)}`:i).trimEnd(),l=`${c.length>0?`${c}
9
9
 
10
- `:""}${cf(r)}
11
- `;return l===i?{path:n,changed:!1}:(await Oc(()=>of(n,l,"utf8")),{path:n,changed:!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]="f97516b2-f75c-5ce0-82dc-f850466284c7")}catch{}})();var lf="PM_SOURCE_CONTEXT_ACCESS",df="PM_ALLOW_SOURCE_CONTEXT_WRITES";function Mc(e){let t=e[lf],n=t===void 0||t.trim().toLowerCase()==="write"?"write":"read_only",r=n==="read_only"&&e[df]?.trim()==="1";return{access:n,write_override_applied:r,source_writes_allowed:n==="write"||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]="5e1810a5-04b8-5929-8eee-7a63f1684860")}catch{}})();var Xi=pf(mf),vr="# pm-cli:merge-drivers:start",Uc="# pm-cli:merge-drivers:end",zt="# pm-cli:merge-drivers:v2:start",Yi="# pm-cli:merge-drivers:v2:end",ff="merge-fence";function Lc(e){return`'${e.replaceAll("'",`'"'"'`)}'`}function zc(){let e=Se(import.meta.url,["../../.."]);return`${Lc(process.execPath)} ${Lc(te.join(e,"dist","cli.js"))}`}var Gc=[{key:"pm-item-toon",name:"pm field-aware TOON item document merge",artifact:"item",itemPath:"%P"},{key:"pm-item-markdown",name:"pm field-aware JSON-markdown item document merge",artifact:"item",itemPath:"%P"},{key:"pm-history",name:"pm append-only history stream merge",artifact:"history",itemPath:void 0},{key:"pm-relationship",name:"pm append-only relationship event store merge",artifact:"relationship",itemPath:void 0},{key:"pm-json",name:"pm key-level JSON config merge",artifact:"json",itemPath:void 0}];function hf(e){let t=e.explicitPath?.trim(),n=e.environment.PM_SOURCE_WORKSPACE_ROOT?.trim(),r=e.environment.PM_SOURCE_PM_PATH?.trim(),i=Mc(e.environment),a=!!(n&&r),o=t===void 0&&a&&(e.dryRun||i.source_writes_allowed);if(t!==void 0){let s=L(e.cwd,t);return{pm_root:s,workspace_start:s,source_coordinates_available:a,source_context_selected:!1,source_policy:i}}return o?{pm_root:te.resolve(r),workspace_start:te.resolve(n),source_coordinates_available:!0,source_context_selected:!0,source_policy:i}:{pm_root:a?L(e.cwd,".agents/pm"):L(e.cwd),workspace_start:e.cwd,source_coordinates_available:a,source_context_selected:!1,source_policy:i}}async function gt(e){try{let{stdout:t}=await Xi("git",["rev-parse","--show-toplevel"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4});return await Ki(t.trim())}catch{return null}}async function qc(e){let t=await gt(e);if(t===null)throw new _("pm merge install requires a git repository (merge drivers are git configuration).",y.USAGE);return t}function Zi(e,t){return te.relative(e,t).replaceAll("\\","/")}function Fe(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function Fc(e,t){if(e[t]!=="'")return null;let n="";for(let r=t+1;r<e.length;r+=1){if(e.startsWith(`'"'"'`,r)){n+="'",r+=4;continue}if(e[r]==="'")return{value:n,nextOffset:r+1};n+=e[r]}return null}async function gf(e,t){let n=Fc(e,0);if(n===null||e[n.nextOffset]!==" ")return!1;let r=Fc(e,n.nextOffset+1);if(r===null||e.slice(r.nextOffset)!==t||!/^node(?:\.exe)?$/iu.test(te.basename(n.value))||te.basename(r.value)!=="cli.js"||te.basename(te.dirname(r.value))!=="dist"||!await A(n.value)||!await A(r.value))return!1;try{let i=te.dirname(te.dirname(r.value)),a=JSON.parse(await br(te.join(i,"package.json"),"utf8")),o=typeof a.bin=="object"&&a.bin!==null&&"pm"in a.bin?a.bin.pm:void 0;return a.name==="@unbrained/pm-cli"&&(a.bin==="dist/cli.js"||o==="dist/cli.js")}catch{return!1}}function Qi(e,t){let n=e.length>0?`${e}/`:"",r=[`${Fe(`${n}**/*.toon`)} merge=pm-item-toon`,`${Fe(`${n}**/*.md`)} merge=pm-item-markdown`];for(let i of t)r.push(`${Fe(`${n}${i}/*.toon`)} merge=pm-item-toon`),r.push(`${Fe(`${n}${i}/*.md`)} merge=pm-item-markdown`);return r.push(`${Fe(`${n}**/*.jsonl`)} merge=pm-relationship`),r.push(`${Fe(`${n}history/*.jsonl`)} merge=pm-history`),r.push(`${Fe(`${n}settings.json`)} merge=pm-json`),r.push(`${Fe(`${n}**/*.json`)} merge=pm-json`),r.push(`${Fe(`${n}extensions/**`)} -merge`),r.push(`${Fe(`${n}extensions/.managed-extensions.json`)} merge=pm-json`),r}function jc(e,t,n){let r=e.indexOf(t),i=e.indexOf(n);return r>=0&&i>r?`${e.slice(0,r)}${e.slice(i+n.length)}`:e.replace(t,"").replace(n,"")}async function Wc(e,t,n){let r=te.join(e,".gitattributes"),i="";try{i=await br(r,"utf8")}catch(l){if(!(l instanceof Error&&"code"in l&&j(l)))throw l}let a=[zt,...t,Yi].join(`
12
- `),s=jc(jc(i,zt,Yi),vr,Uc).trimEnd(),c=`${s.length>0?`${s}
10
+ `:""}${Nf(r)}
11
+ `;return l===i?{path:n,changed:!1}:(await Yc(()=>Df(n,l,"utf8")),{path:n,changed:!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]="f97516b2-f75c-5ce0-82dc-f850466284c7")}catch{}})();var Mf="PM_SOURCE_CONTEXT_ACCESS",Lf="PM_ALLOW_SOURCE_CONTEXT_WRITES";function el(e){let t=e[Mf],n=t===void 0||t.trim().toLowerCase()==="write"?"write":"read_only",r=n==="read_only"&&e[Lf]?.trim()==="1";return{access:n,write_override_applied:r,source_writes_allowed:n==="write"||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]="5e1810a5-04b8-5929-8eee-7a63f1684860")}catch{}})();var aa=Uf(jf),Er="# pm-cli:merge-drivers:start",il="# pm-cli:merge-drivers:end",qt="# pm-cli:merge-drivers:v2:start",ia="# pm-cli:merge-drivers:v2:end",zf="merge-fence";function tl(e){return`'${e.replaceAll("'",`'"'"'`)}'`}function al(){let e=Ee(import.meta.url,["../../.."]);return`${tl(process.execPath)} ${tl(te.join(e,"dist","cli.js"))}`}var ol=[{key:"pm-item-toon",name:"pm field-aware TOON item document merge",artifact:"item",itemPath:"%P"},{key:"pm-item-markdown",name:"pm field-aware JSON-markdown item document merge",artifact:"item",itemPath:"%P"},{key:"pm-history",name:"pm append-only history stream merge",artifact:"history",itemPath:void 0},{key:"pm-relationship",name:"pm append-only relationship event store merge",artifact:"relationship",itemPath:void 0},{key:"pm-json",name:"pm key-level JSON config merge",artifact:"json",itemPath:void 0}];function qf(e){let t=e.explicitPath?.trim(),n=e.environment.PM_SOURCE_WORKSPACE_ROOT?.trim(),r=e.environment.PM_SOURCE_PM_PATH?.trim(),i=el(e.environment),a=!!(n&&r),o=t===void 0&&a&&(e.dryRun||i.source_writes_allowed);if(t!==void 0){let s=L(e.cwd,t);return{pm_root:s,workspace_start:s,source_coordinates_available:a,source_context_selected:!1,source_policy:i}}return o?{pm_root:te.resolve(r),workspace_start:te.resolve(n),source_coordinates_available:!0,source_context_selected:!0,source_policy:i}:{pm_root:a?L(e.cwd,".agents/pm"):L(e.cwd),workspace_start:e.cwd,source_coordinates_available:a,source_context_selected:!1,source_policy:i}}async function _t(e){try{let{stdout:t}=await aa("git",["rev-parse","--show-toplevel"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4});return await ra(t.trim())}catch{return null}}async function sl(e){let t=await _t(e);if(t===null)throw new y("pm merge install requires a git repository (merge drivers are git configuration).",_.USAGE);return t}function oa(e,t){return te.relative(e,t).replaceAll("\\","/")}function Ue(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function nl(e,t){if(e[t]!=="'")return null;let n="";for(let r=t+1;r<e.length;r+=1){if(e.startsWith(`'"'"'`,r)){n+="'",r+=4;continue}if(e[r]==="'")return{value:n,nextOffset:r+1};n+=e[r]}return null}async function Gf(e,t){let n=nl(e,0);if(n===null||e[n.nextOffset]!==" ")return!1;let r=nl(e,n.nextOffset+1);if(r===null||e.slice(r.nextOffset)!==t||!/^node(?:\.exe)?$/iu.test(te.basename(n.value))||te.basename(r.value)!=="cli.js"||te.basename(te.dirname(r.value))!=="dist"||!await A(n.value)||!await A(r.value))return!1;try{let i=te.dirname(te.dirname(r.value)),a=JSON.parse(await Ar(te.join(i,"package.json"),"utf8")),o=typeof a.bin=="object"&&a.bin!==null&&"pm"in a.bin?a.bin.pm:void 0;return a.name==="@unbrained/pm-cli"&&(a.bin==="dist/cli.js"||o==="dist/cli.js")}catch{return!1}}function sa(e,t){let n=e.length>0?`${e}/`:"",r=[`${Ue(`${n}**/*.toon`)} merge=pm-item-toon`,`${Ue(`${n}**/*.md`)} merge=pm-item-markdown`];for(let i of t)r.push(`${Ue(`${n}${i}/*.toon`)} merge=pm-item-toon`),r.push(`${Ue(`${n}${i}/*.md`)} merge=pm-item-markdown`);return r.push(`${Ue(`${n}**/*.jsonl`)} merge=pm-relationship`),r.push(`${Ue(`${n}history/*.jsonl`)} merge=pm-history`),r.push(`${Ue(`${n}settings.json`)} merge=pm-json`),r.push(`${Ue(`${n}**/*.json`)} merge=pm-json`),r.push(`${Ue(`${n}extensions/**`)} -merge`),r.push(`${Ue(`${n}extensions/.managed-extensions.json`)} merge=pm-json`),r}function rl(e,t,n){let r=e.indexOf(t),i=e.indexOf(n);return r>=0&&i>r?`${e.slice(0,r)}${e.slice(i+n.length)}`:e.replace(t,"").replace(n,"")}async function cl(e,t,n){let r=te.join(e,".gitattributes"),i="";try{i=await Ar(r,"utf8")}catch(l){if(!(l instanceof Error&&"code"in l&&j(l)))throw l}let a=[qt,...t,ia].join(`
12
+ `),s=rl(rl(i,qt,ia),Er,il).trimEnd(),c=`${s.length>0?`${s}
13
13
 
14
14
  `:""}${a}
15
- `;return c===i?{path:r,changed:!1}:(n||await uf(r,c,"utf8"),{path:r,changed:!0})}function kr(e){let t=G(e,null);return[...new Set(Object.values(t.type_to_folder))].sort((n,r)=>n.localeCompare(r))}async function Bc(e,t){let n=te.resolve(e),r=null,i="",a=n;for(let v=0;v<8;v+=1){let b=te.join(a,".gitattributes");try{let R=await br(b,"utf8");if(R.includes(zt)||R.includes(vr)){r=a,i=R;break}}catch{}let x=te.dirname(a);if(x===a)break;a=x}if(r===null)return{status:"not_installed",missing_patterns:[],stale_patterns:[],schema_scope:"project"};let o=te.join(r,".gitattributes"),s=i.includes(zt),c=s?zt:vr,l=s?Yi:Uc,d=i.indexOf(c),u=i.indexOf(l),m=u>d?i.slice(d+c.length,u).split(`
16
- `).map(v=>v.trim()).filter(v=>v.length>0):[],p=Qi(Zi(r,n),t),f=new Set(m),g=new Set(p),h=p.filter(v=>!f.has(v)),w=m.filter(v=>!g.has(v));return{status:h.length>0||w.length>0?"drift":"ok",path:o,missing_patterns:h,stale_patterns:w,schema_scope:"project"}}async function xr(e){let t=zc(),n=[],r=[];for(let i of Gc){let a=`merge.${i.key}.driver`,o=` merge driver ${i.artifact} "%O" "%A" "%B"${i.itemPath===void 0?"":` --item-path ${i.itemPath}`}`,s=`${t}${o}`;try{let{stdout:c}=await Xi("git",["config","--local","--get",a],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4}),l=c.trim();l!==s&&!await gf(l,o)&&r.push(a)}catch{n.push(a)}}return{status:n.length>0?"missing":r.length>0?"drift":"ok",missing_keys:n,drifted_keys:r}}async function Hc(e){let t;try{t=await qc(te.resolve(e))}catch{return{status:"no_git"}}let n=Zi(t,te.resolve(e)),r=await I(e),i=Y(void 0,r.author_default),a=await le(e,ff,r.locks.ttl_seconds,i,!1,Ce(r).force_required_for_stale_lock,r.locks.wait_ms);try{let o=te.join(t,".gitattributes"),s;try{s=await br(o,"utf8")}catch(u){if(u instanceof Error&&"code"in u&&j(u))return{status:"not_installed",path:o};throw u}if(!s.includes(zt)&&!s.includes(vr))return{status:"not_installed",path:o};let c=await I(e),l=kr(c),d=await Wc(t,Qi(n,l),!1);return{status:d.changed?"refreshed":"unchanged",path:d.path}}finally{await a()}}async function qE(e,t){let n=hf({cwd:process.cwd(),explicitPath:t.path,dryRun:e.dryRun===!0,environment:process.env}),r=n.pm_root;if(!await A(K(r)))throw new _(`Tracker is not initialized at ${r}. Run pm init first.`,y.NOT_FOUND);let i=await qc(n.workspace_start);return _f({pmRoot:r,workspaceRoot:i,dryRun:e.dryRun===!0})}async function _f(e){let t=te.resolve(e.pmRoot),n=te.resolve(e.workspaceRoot),r=e.dryRun===!0,i,a;try{[i,a]=await Promise.all([Ki(t),Ki(n)])}catch(p){throw new _(`Cannot resolve tracker root ${t} or workspace root ${n}: ${String(p)}`,y.NOT_FOUND,{code:"merge_root_not_found",nextSteps:["Initialize the tracker and ensure both paths are accessible.",'Retry "pm merge install" from the repository workspace.']})}let o=Zi(a,i);if(Vi(o))throw new _(`Tracker root ${t} is outside the git repository ${n}; there is nothing to configure for this repository.`,y.USAGE);let s=await I(i),c=kr(s),l=Qi(o,c),d=[],u=zc();for(let p of Gc)d.push({key:`merge.${p.key}.name`,value:p.name}),d.push({key:`merge.${p.key}.driver`,value:`${u} merge driver ${p.artifact} "%O" "%A" "%B"${p.itemPath===void 0?"":` --item-path ${p.itemPath}`}`});if(!r)try{for(let p of d)await Xi("git",["config","--local",p.key,p.value],{cwd:a,encoding:"utf8",windowsHide:!0,timeout:1e4})}catch{throw new _(`Cannot install repository-local merge drivers in ${a}. Ensure the repository Git config is writable and no other Git process holds its lock, then retry.`,y.DEPENDENCY_FAILED,{code:"merge_git_config_unwritable",why:"pm merge install must persist clone-local driver commands before publishing their shared .gitattributes mappings.",nextSteps:["Make the repository Git config writable or wait for the process holding its lock to finish.",'Retry "pm merge install"; the operation is idempotent.','Use "pm merge install --dry-run --json" when the workspace is intentionally read-only.']})}let m=await Wc(a,l,r);return{ok:!0,dry_run:r,workspace_root:a,pm_root:i,gitattributes:{path:m.path,changed:m.changed,patterns:l,schema_scope:"project"},git_config:d,guidance:["Commit .gitattributes so every branch and collaborator shares the merge mapping.",'git config is per-clone: each collaborator (and each fresh worktree/clone) runs "pm merge install" once.','After merging branches, run "pm merge reconcile --dry-run" to inspect the complete receipt and history repair, then apply "pm merge reconcile"; use --force only after explicitly accepting any discarded values.',"Custom item types registered later refresh this fence automatically (pm schema add-type/remove-type); rerun pm merge install only after out-of-band type-folder edits."],generated_at:$()}}(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]="3d53ef97-6dd5-5dea-a5c2-9bc9e62d881c")}catch{}})();var yf=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function wf(e){let t=yf.exec(e.trim());if(!t)return;let n=t[1];if(!(n.length<2)&&!/^[A-Za-z]\d+$/.test(n))return n.toLowerCase()}function vf(e){return e.split(/[-_]+/).filter(t=>t.length>0).map(t=>`${t.slice(0,1).toUpperCase()}${t.slice(1).toLowerCase()}`).join("")}function Jc(e,t={}){let n=typeof t.minCount=="number"&&t.minCount>0?Math.trunc(t.minCount):10,r=typeof t.maxExamples=="number"&&t.maxExamples>0?Math.trunc(t.maxExamples):3,i=new Map;for(let o of e){let s=typeof o=="string"?o.trim():"";if(s.length===0)continue;let c=wf(s);if(c===void 0)continue;let l=i.get(c)??{count:0,examples:[]};l.count+=1,l.examples.length<r&&l.examples.push(s),i.set(c,l)}let a=[];for(let[o,s]of i.entries()){if(s.count<n)continue;let c=vf(o);a.push({name:c,prefix:o,count:s.count,examples:s.examples,shadows_builtin:No(c)!==void 0})}return a.sort((o,s)=>s.count-o.count||o.name.localeCompare(s.name)),a}import{createHash as al}from"node:crypto";import yt from"node:fs/promises";import qt from"node:path";import{mkdir as bf,readFile as kf}from"node:fs/promises";import Qc from"node:path";(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]="6ed4a26f-2ae2-556a-87db-56844108757f")}catch{}})();var ea=class extends Error{constructor(t="Workspace transaction interrupted"){super(t),this.name="WorkspaceTransactionInterruptedError"}},xf="sdk-workspace-transaction",Sf=/^[a-zA-Z0-9._-]+$/,Ef=30,Af=3e3;function Vc(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n||!Sf.test(n))throw new TypeError(`${t} must match [a-zA-Z0-9._-]+`);return n}function Kc(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n)throw new TypeError(`${t} must be non-empty`);return n}function Yc(e,t,n){let r=e??t;if(!Number.isInteger(r)||r<=0)throw new TypeError(`${n} must be a positive integer`);return r}function el(e,t){return Qc.join(e,"transactions","sdk",`${t}.json`)}async function it(e,t){t.updatedAt=$();let n=el(e,t.transactionId);await bf(Qc.dirname(n),{recursive:!0}),await ce(n,`${JSON.stringify(t,null,2)}
17
- `)}function Rf(e){return Number.isInteger(e.attempt)&&typeof e.author=="string"&&typeof e.createdAt=="string"&&typeof e.updatedAt=="string"}function _t(e){return Object.assign(Object.create(null),e)}function If(e,t){try{let n=JSON.stringify(e,(r,i)=>{if(typeof i=="number"&&!Number.isFinite(i))throw new TypeError(`${t} contains a non-finite number`);if(i===void 0||typeof i=="function"||typeof i=="symbol")throw new TypeError(`${t} contains a non-JSON value`);return i});return JSON.parse(n)}catch(n){throw new TypeError(`${t} must be JSON serializable`,{cause:n})}}function ta(e,t){return e===void 0?void 0:If(e,t)}function na(e,t,n,r){let i=ta(n,r);i===void 0?delete e[t]:e[t]=i}function Xc(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function Zc(e,t){return Array.isArray(e)&&new Set(e).size===e.length&&e.every(n=>typeof n=="string"&&t.includes(n))}function Cf(e,t){if(!Zc(e.startedStepIds,t)||!Zc(e.completedStepIds,t)||!Xc(e.results)||!Xc(e.compensationData))return!1;let n=e.startedStepIds,r=new Set(n),i=e.completedStepIds,a=new Set(i);return Object.keys(e.compensationData).some(o=>!r.has(o))||Object.keys(e.results).some(o=>!a.has(o))?!1:e.status==="committed"?t.every(o=>a.has(o)):e.status!=="compensated"||a.size===0&&r.size===0}function $f(e,t,n){let r;try{r=JSON.parse(e)}catch{throw new TypeError(`Workspace transaction ${t} journal is invalid JSON`)}if(!r||typeof r!="object"||Array.isArray(r))throw new TypeError(`Workspace transaction ${t} journal is invalid`);let i=r,a=i.schemaVersion===1&&i.transactionId===t,o=Array.isArray(i.stepIds)&&i.stepIds.length===n.length&&i.stepIds.every((d,u)=>d===n[u]),s=Cf(i,n),c=Rf(i),l=["applying","compensating","compensated","committed"].includes(String(i.status));if(!a||!o||!s||!c||!l)throw new TypeError(`Workspace transaction ${t} journal does not match the supplied plan`);return{...i,results:_t(i.results),compensationData:_t(i.compensationData)}}async function Tf(e,t,n,r,i){let a=i,o=a!==void 0;if(a?.status==="compensating"&&await tl(e,a),a===void 0||a.status==="compensated"){let s=$();a={schemaVersion:1,transactionId:t,author:n,status:"applying",attempt:(a?.attempt??0)+1,createdAt:a?.createdAt??s,updatedAt:s,stepIds:r,startedStepIds:[],completedStepIds:[],results:_t(),compensationData:_t()},await it(e.pmRoot,a),await Ke(e,a,"prepared")}return{journal:a,recovered:o}}async function Of(e,t,n){try{await Pf(t,e.steps),await it(e.pmRoot,t);let r=new Set(t.completedStepIds),i=new Set(t.startedStepIds);for(let a of e.steps){if(r.has(a.id))continue;let o=await a.inspect(),s=ta(o.result,`Step ${a.id} result`);if(o.state!=="applied"){let c=await a.prepareCompensation?.();na(t.compensationData,a.id,c,`Step ${a.id} compensation data`),i.add(a.id),t.startedStepIds=e.steps.map(d=>d.id).filter(d=>i.has(d)),await it(e.pmRoot,t);let l=await a.apply();s=ta(l,`Step ${a.id} result`)}await Ke(e,t,"step_applied",a.id),r.add(a.id),t.completedStepIds=e.steps.map(c=>c.id).filter(c=>r.has(c)),na(t.results,a.id,s,`Step ${a.id} result`),await it(e.pmRoot,t),await Ke(e,t,"step_recorded",a.id)}return await Ke(e,t,"committing"),t.status="committed",await it(e.pmRoot,t),await Ke(e,t,"committed"),{transactionId:t.transactionId,status:"committed",recovered:n,results:_t(t.results)}}catch(r){if(r instanceof ea||t.status==="committed")throw r;try{await tl(e,t)}catch(i){throw new AggregateError([r,i],`Workspace transaction failed and compensation failed: ${String(i)}`,{cause:i})}throw r}}async function Df(e,t,n){try{return $f(await kf(el(e,t),"utf8"),t,n)}catch(r){if(r!==null&&typeof r=="object"&&"code"in r&&j(r))return;throw r}}async function Ke(e,t,n,r){await e.onTransition?.({transactionId:t.transactionId,attempt:t.attempt,transition:n,...r===void 0?{}:{stepId:r}})}async function Pf(e,t){let n=new Set,r=_t();for(let i of t){let a=await i.inspect();a.state==="applied"&&(n.add(i.id),na(r,i.id,a.result,`Step ${i.id} result`))}e.results=r,e.completedStepIds=t.map(i=>i.id).filter(i=>n.has(i))}async function tl(e,t){t.status="compensating",await it(e.pmRoot,t),await Ke(e,t,"compensating");let n=new Set(t.completedStepIds),r=new Set(t.startedStepIds);for(let i of[...e.steps].reverse()){if(!r.has(i.id)&&!n.has(i.id))continue;let a;try{a=r.has(i.id)&&(await i.inspect()).state==="applied"}catch{a=r.has(i.id)}a&&(await Ke(e,t,"step_compensating",i.id),await i.compensate(t.compensationData[i.id])),n.delete(i.id),r.delete(i.id),t.completedStepIds=e.steps.map(o=>o.id).filter(o=>n.has(o)),t.startedStepIds=e.steps.map(o=>o.id).filter(o=>r.has(o)),delete t.results[i.id],delete t.compensationData[i.id],await it(e.pmRoot,t),await Ke(e,t,"step_compensated",i.id)}t.status="compensated",await it(e.pmRoot,t),await Ke(e,t,"compensated")}async function nl(e){let t=Kc(e.pmRoot,"Transaction pmRoot"),n=Vc(e.transactionId,"Transaction id"),r=Kc(e.author,"Transaction author"),i=Yc(e.lockTtlSeconds,Ef,"Transaction lock TTL"),a=Yc(e.lockWaitMs,Af,"Transaction lock wait"),o=[...e.steps];if(o.length===0)throw new TypeError("Workspace transaction requires at least one step");let s=o.map(d=>{let u=Vc(d.id,"Transaction step id");if(u!==d.id)throw new TypeError("Transaction step id must not contain surrounding whitespace");return u});if(new Set(s).size!==s.length)throw new TypeError("Workspace transaction step ids must be unique");let c={...e,pmRoot:t,transactionId:n,author:r,steps:o,lockTtlSeconds:i,lockWaitMs:a},l=await le(t,xf,i,r,!1,!1,a);try{let d=await Df(t,n,s),u=d!==void 0;if(d?.status==="committed")return{transactionId:n,status:"committed",recovered:!0,results:_t(d.results)};let m=await Tf(c,n,r,s,d);return await Of(c,m.journal,u||m.recovered)}finally{await l()}}(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]="cd777de3-665f-5e01-ac98-8986f2a5a4c2")}catch{}})();function Ye(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Schema migration ${t} must be non-empty`);return e.trim()}function ol(e){let t=Ye(e,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(t))throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");return t}function sl(e,t){let n=ia(e),r=Ye(t,"migrationScope");return`auto-${al("sha256").update(JSON.stringify({scope:r,request:n})).digest("hex").slice(0,20)}`}function ia(e){let t=e.kind==="rename-type"?{kind:e.kind,from:Ye(e.from,"source"),to:Ye(e.to,"target")}:e.kind==="rename-field"?{kind:e.kind,from:oe(Ye(e.from,"source")),to:oe(Ye(e.to,"target")),...e.type===void 0?{}:{type:Ye(e.type,"type")}}:{kind:e.kind,from:oe(Ye(e.from,"source")),to:oe(Ye(e.to,"target"))};if(t.from.toLowerCase()===t.to.toLowerCase())throw new TypeError("Schema migration source and target must differ");return t}function Nf(e){return e.kind==="rename-type"?"types":e.kind==="rename-field"?"fields":"statuses"}function Mf(e,t,n){let r=we(t.schema),i=Nf(n);return Ne(e,r.files[i],Ee[i])}function cl(e,t){return qt.join(e,"transactions","schema",`${t}-plan.json`)}function Sr(e){return e.length===0?null:JSON.parse(e)}async function Gt(e){let t=await X(e);return{exists:t!==null,raw:t??""}}async function ll(e,t){t.exists?await ce(e,t.raw):await yt.rm(e,{force:!0})}function Lf(e,t,n){let r=Ge(e),i=r.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.from.toLowerCase()),a=r.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.to.toLowerCase());if(n==="stage"){if(a>=0)return rt(r);if(i<0)throw new TypeError(`Unknown custom type "${t.from}".`);r.definitions.push({...r.definitions[i],name:t.to})}else i>=0&&r.definitions.splice(i,1);return rt(r)}function Ff(e,t,n){let r=Et(e),i=r.fields.findIndex(o=>o.key===t.from),a=r.fields.findIndex(o=>o.key===t.to);if(n==="stage"){if(a>=0)return At(r);if(i<0)throw new TypeError(`Unknown custom field "${t.from}".`);let o=r.fields[i];r.fields.push({...o,key:t.to,metadata_key:t.to,front_matter_key:t.to,cli_flag:t.to.replaceAll("_","-")})}else i>=0&&r.fields.splice(i,1);return At(r)}function jf(e,t,n){let r=Rt(e),i=r.statuses.findIndex(o=>o.id===t.from),a=r.statuses.findIndex(o=>o.id===t.to);if(n==="stage"){if(a>=0)return It(r);if(i<0)throw new TypeError(`Unknown custom status "${t.from}".`);r.statuses.push({...r.statuses[i],id:t.to})}else i>=0&&r.statuses.splice(i,1);return It(r)}function Uf(e,t,n){return t.kind==="rename-type"?Lf(e,t,n):t.kind==="rename-field"?Ff(e,t,n):jf(e,t,n)}function at(e,t){return typeof e=="string"&&e.trim().toLowerCase()===t.from.toLowerCase()?t.to:e}function aa(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function Wt(e){return Array.isArray(e)?e.map(t=>aa(t)).filter(t=>t!==void 0):[]}function zf(e,t){for(let n of Wt(e.fields))Array.isArray(n.required_types)&&(n.required_types=n.required_types.map(r=>at(r,t)));for(let n of Wt(e.type_workflows))n.type=at(n.type,t)}function Gf(e,t){for(let r of Wt(e.definitions))r.default_status=at(r.default_status,t);let n=aa(e.workflow);if(n)for(let[r,i]of Object.entries(n))n[r]=at(i,t);for(let r of Wt(e.type_workflows))Array.isArray(r.allowed_transitions)&&(r.allowed_transitions=r.allowed_transitions.map(i=>Array.isArray(i)?i.map(a=>at(a,t)):i))}function qf(e,t){for(let n of Wt(e.definitions)){for(let r of["required_create_fields","required_create_repeatables"])Array.isArray(n[r])&&(n[r]=n[r].map(i=>at(i,t)));for(let r of["options","command_option_policies"])for(let i of Wt(n[r])){let a=r==="options"?"key":"option";i[a]=at(i[a],t)}}}function Wf(e,t){let n=aa(e.options);if(!n)return;if(t.kind==="rename-field"){if(!Object.prototype.hasOwnProperty.call(n,t.from))return;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision in saved template "${String(e.name??"unknown")}": target field "${t.to}" already exists.`);n[t.to]=n[t.from],delete n[t.from];return}let r=t.kind==="rename-type"?"type":"status";n[r]=at(n[r],t)}function ra(e,t){let n=JSON.parse(e);if(typeof n!="object"||n===null||Array.isArray(n))return e;let r=n;return t.kind==="rename-type"?zf(r,t):t.kind==="rename-field"?qf(r,t):Gf(r,t),Wf(r,t),`${JSON.stringify(r,null,2)}
18
- `}function dl(e,t){if(t.kind==="rename-type"){let r=Ge(e).definitions;return{source:r.some(i=>i.name.trim().toLowerCase()===t.from.toLowerCase()),target:r.some(i=>i.name.trim().toLowerCase()===t.to.toLowerCase())}}if(t.kind==="rename-field"){let r=Et(e).fields;return{source:r.some(i=>i.key===t.from),target:r.some(i=>i.key===t.to)}}let n=Rt(e).statuses;return{source:n.some(r=>r.id===t.from),target:n.some(r=>r.id===t.to)}}function Bf(e,t){let n=e;return t.kind==="rename-type"?e.type.toLowerCase()===t.to.toLowerCase()?[]:["type"]:t.kind==="remap-status"?e.status.toLowerCase()===t.to.toLowerCase()?[]:["status"]:Object.prototype.hasOwnProperty.call(n,t.to)&&!Object.prototype.hasOwnProperty.call(n,t.from)?[]:[t.from,t.to]}function Hf(e,t){if(t.kind==="rename-type")return e.type.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"type",before:e.type,after:t.to}]}:null;if(t.kind==="remap-status")return e.status.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"status",before:e.status,after:t.to}]}:null;if(t.type!==void 0&&e.type.toLowerCase()!==t.type.toLowerCase())return null;let n=e;if(!Object.prototype.hasOwnProperty.call(n,t.from))return null;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision on item "${e.id}": target field "${t.to}" already exists.`);return{id:e.id,changes:[{field:t.from,before:n[t.from],after:void 0},{field:t.to,before:void 0,after:n[t.from]}]}}function ul(e,t){let n=ia(t.request),r=t.migrationId===void 0?sl(n,t.migrationScope??"plan"):ol(t.migrationId),i=e.map(c=>Hf(c,n)).filter(c=>c!==null).sort((c,l)=>c.id.localeCompare(l.id)),a=al("sha256").update(JSON.stringify({migrationId:r,request:n,items:i})).digest("hex"),o=new Set([...t.completedItemIds??[]].map(c=>c.trim()).filter(c=>c.length>0)),s=i.filter(c=>!o.has(c.id));return Object.freeze({migration_id:r,request:n,fingerprint:a,affected_item_count:i.length,pending_item_count:s.length,skipped_completed_count:i.length-s.length,items:Object.freeze(s)})}async function Jf(e){let t=G(e.settings,z()),n=[...new Set(Object.values(t.type_to_folder))],r=await er(e.pmRoot,n),i=e.request.kind==="rename-type"?{types:[e.request.from]}:e.request.kind==="remap-status"?{statuses:[e.request.from]}:{metadataKeys:[e.request.from],...e.request.type===void 0?{}:{types:[e.request.type]}},a=r?await ls({pmRoot:e.pmRoot,expectedSourceCursor:r.source_cursor,query:i}):null;return a?{items:a.items,selectionSource:"derived_index",typeToFolder:t.type_to_folder}:{items:await Be(e.pmRoot,e.settings.item_format,t.type_to_folder,[],e.settings.schema),selectionSource:"scan",typeToFolder:t.type_to_folder}}async function Vf(e,t){let n=await X(cl(e,t));if(n===null)return null;try{let r=JSON.parse(n);if(r.schema_version!==1||r.plan.migration_id!==t||!Array.isArray(r.plan.items))throw new TypeError("invalid plan envelope");return r.plan}catch(r){throw new _(`Stored schema migration plan "${t}" is invalid: ${Ao(r)}`,y.GENERIC_FAILURE)}}async function Kf(e,t){let n=cl(e,t.migration_id);await yt.mkdir(qt.dirname(n),{recursive:!0});let r={schema_version:1,plan:t,created_at:new Date().toISOString()};await ce(n,`${JSON.stringify(r,null,2)}
19
- `)}function Yf(e,t){return JSON.stringify(e)===JSON.stringify(t)}async function Xf(e){let t=await Tt(e.pmRoot,e.id,e.settings.id_prefix,e.settings.item_format,e.typeToFolder);if(!t)throw new _(`Schema migration item "${e.id}" no longer exists.`,y.NOT_FOUND);return(await Ot(t,{schema:e.settings.schema})).document.metadata}function rl(e,t,n){let r=n==="forward"?t.from:t.to,i=n==="forward"?t.to:t.from;if(t.kind==="rename-type"){if(e.metadata.type.toLowerCase()===i.toLowerCase())return[];if(e.metadata.type.toLowerCase()!==r.toLowerCase())throw new TypeError(`Schema migration expected type "${r}" on item "${e.metadata.id}".`);return e.metadata.type=i,["type"]}if(t.kind==="remap-status"){if(e.metadata.status.toLowerCase()===i.toLowerCase())return[];if(e.metadata.status.toLowerCase()!==r.toLowerCase())throw new TypeError(`Schema migration expected status "${r}" on item "${e.metadata.id}".`);return e.metadata.status=i,["status"]}let a=e.metadata;if(Object.prototype.hasOwnProperty.call(a,i)&&!Object.prototype.hasOwnProperty.call(a,r))return[];if(!Object.prototype.hasOwnProperty.call(a,r)||Object.prototype.hasOwnProperty.call(a,i))throw new TypeError(`Schema migration field state changed concurrently on item "${e.metadata.id}".`);return a[i]=a[r],delete a[r],[r,i]}function il(e){return{id:e.id,inspect:async()=>{let t=await Gt(e.filePath),n=dl(t.raw,e.request),r=e.phase==="stage"?n.source&&n.target:!n.source&&n.target;return{state:r?"applied":"pending",...r?{result:{phase:e.phase}}:{}}},prepareCompensation:async()=>{let t=await Gt(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await Gt(e.filePath);return await ce(e.filePath,Uf(t.raw,e.request,e.phase)),{phase:e.phase}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema snapshot for ${e.id} compensation.`);await ll(e.filePath,{exists:t.exists,raw:t.raw})}}}function Zf(e){return{id:e.stepId,inspect:async()=>{let t=await Gt(e.filePath);return{state:ra(t.raw,e.request)===t.raw?"applied":"pending"}},prepareCompensation:async()=>{let t=await Gt(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await Gt(e.filePath);return await ce(e.filePath,ra(t.raw,e.request)),{file:e.filePath}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema reference snapshot for ${e.stepId} compensation.`);await ll(e.filePath,{exists:t.exists,raw:t.raw})}}}function Qf(e){return{id:`item-${e.id}`,inspect:async()=>{let t=await I(e.pmRoot),n=G(t,z()).type_to_folder,r=await Xf({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id}),i=Bf(r,e.request).length===0;return{state:i?"applied":"pending",...i?{result:{item_id:e.id}}:{}}},apply:async()=>{let t=await I(e.pmRoot),n=G(t,z()).type_to_folder,r=await pt({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}`,author:e.author,message:`Schema migration ${e.request.kind}: ${e.request.from} -> ${e.request.to}`,force:e.force,skipNoop:!0,mutate(i){return{changedFields:rl(i,e.request,"forward")}}});return{item_id:e.id,changed_fields:r.changedFields}},compensate:async()=>{let t=await I(e.pmRoot),n=G(t,z()).type_to_folder;await pt({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}_compensate`,author:e.author,message:`Compensate schema migration ${e.request.kind}: ${e.request.to} -> ${e.request.from}`,force:!0,skipNoop:!0,mutate(r){return{changedFields:rl(r,e.request,"reverse")}}})}}}async function eh(e){let t=await Vf(e.pmRoot,e.migrationId);if(t){if(!Yf(t.request,e.request))throw new _(`Schema migration id "${e.migrationId}" already belongs to a different request.`,y.CONFLICT);return{plan:t,stored:!0}}let n=await Jf({pmRoot:e.pmRoot,settings:e.settings,request:e.request});return{plan:{...ul(n.items,{migrationId:e.migrationId,request:e.request}),selection_source:n.selectionSource},stored:!1}}async function th(e){let t=dl(await X(e.schemaPath)??"",e.request);if(!t.source)throw new _(`Schema migration source "${e.request.from}" is not a custom definition.`,y.NOT_FOUND);if(t.target)throw new _(`Schema migration target "${e.request.to}" already exists.`,y.CONFLICT);await Kf(e.pmRoot,e.plan)}async function nh(e){let t=we(e.settings.schema),n=[...new Set([["types",Ee.types],["fields",Ee.fields],["workflows",Ee.workflows]].map(([i,a])=>Ne(e.pmRoot,t.files[i],a)).filter(i=>i!==e.schemaPath))];try{let i=qt.join(e.pmRoot,"templates"),a=await yt.readdir(i,{withFileTypes:!0});n.push(...a.filter(o=>o.isFile()&&o.name.toLowerCase().endsWith(".json")).map(o=>qt.join(i,o.name)))}catch(i){if(typeof i!="object"||i===null||!("code"in i)||!j(i))throw i}n.sort((i,a)=>i.localeCompare(a));let r=[];for(let i of n){let a=await X(i);a!==null&&ra(a,e.request)!==a&&r.push({filePath:i,beforeRaw:a})}return{paths:n,snapshots:r}}async function rh(e){for(let t of e.snapshots){let n=await yt.readFile(t.filePath,"utf8"),r=qt.relative(e.pmRoot,t.filePath).replaceAll("\\","/");await ki({pmRoot:e.pmRoot,author:e.author,documentPath:r,before:Sr(t.beforeRaw),after:Sr(n),op:"schema_migration_reference",idempotencyKey:`${e.plan.migration_id}:${e.plan.fingerprint}:${r}`,message:`${e.request.kind}: ${e.request.from} -> ${e.request.to}`,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}}async function ih(e,t,n){let r=ia(e),i=L(process.cwd(),n.path);if(!await A(K(i)))throw new _(`Tracker is not initialized at ${i}. Run pm init first.`,y.NOT_FOUND);let a=t.migrationId===void 0?sl(r,await yt.realpath(i)):ol(t.migrationId),o=await I(i),s=Y(t.author,o.author_default),c=await eh({pmRoot:i,settings:o,migrationId:a,request:r}),l=c.plan;if(t.dryRun===!0)return{...l,action:r.kind,applied:!1,recovered:!1,migrated_item_count:0};let d=Mf(i,o,r),u=await yt.readFile(d,"utf8");c.stored||await th({pmRoot:i,schemaPath:d,request:r,plan:l});let m=await nh({pmRoot:i,schemaPath:d,settings:o,request:r}),p=[il({id:"stage-schema",filePath:d,request:r,phase:"stage"}),...m.paths.map((w,v)=>Zf({filePath:w,request:r,stepId:`reference-${String(v+1).padStart(4,"0")}`})),...l.items.map(w=>Qf({pmRoot:i,id:w.id,request:r,author:s,force:t.force===!0})),il({id:"retire-source",filePath:d,request:r,phase:"retire"})],f=await nl({pmRoot:i,transactionId:`schema-${a}`,author:s,steps:p,lockTtlSeconds:Math.max(o.locks.ttl_seconds,300),lockWaitMs:o.locks.wait_ms}),g=await yt.readFile(d,"utf8"),{historyPath:h}=await ki({pmRoot:i,author:s,documentPath:qt.relative(i,d).replaceAll("\\","/"),before:Sr(u),after:Sr(g),op:"schema_migration",idempotencyKey:`${l.migration_id}:${l.fingerprint}`,message:`${r.kind}: ${r.from} -> ${r.to}; affected=${l.affected_item_count}`,lockTtlSeconds:o.locks.ttl_seconds,lockWaitMs:o.locks.wait_ms});return await rh({pmRoot:i,author:s,settings:o,request:r,plan:l,snapshots:m.snapshots}),{...l,action:r.kind,applied:!0,recovered:f.recovered,migrated_item_count:l.affected_item_count,workspace_history_path:h}}(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]="1a035e10-b8fe-52cd-a9c7-0762dd0ab160")}catch{}})();var BA=["add-type","remove-type","add-status","remove-status","add-field","remove-field","list-fields","show-field","apply-preset","list","show","show-status","rename-type","rename-field","remap-status"],Er="schema-types",ml="schema-statuses",pl="schema-fields";function ot(e){return Zn({pmRoot:e.pmRoot,filePath:e.filePath,raw:e.raw,op:e.op,author:e.author,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}async function HA(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i;try{i=gi({name:e,description:t.description,defaultStatus:t.defaultStatus,folder:t.folder,aliases:t.alias})}catch(p){throw new _(p instanceof Error?p.message:String(p),y.USAGE)}let a=await I(r),o=we(a.schema),s=Ne(r,o.files.types,Ee.types),c=[],l=Y(t.author,a.author_default),d=Ce(a),u=await le(r,Er,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms),m;try{let p=await X(s),f;try{f=Ge(p)}catch(g){throw new _(g instanceof Error?g.message:String(g),y.GENERIC_FAILURE)}try{Mo(i,f);let g=new Map,h=G(a,z());for(let[w,v]of Object.entries(h.type_to_folder)){let b=v.trim().toLowerCase();b.length>0&&!g.has(b)&&g.set(b,w)}Lo(i,f,g)}catch(g){throw new _(g instanceof Error?g.message:String(g),y.USAGE)}m=Un(f,i),m.replaced&&m.previousName!==void 0&&m.previousName!==m.definition.name&&c.push(`type_recased:${m.previousName}->${m.definition.name}`),await ot({pmRoot:r,filePath:s,raw:rt(m.file),op:"schema:add-type",author:l,settings:a}),await un(r,[m.definition],c,"schema:add-type-folder"),c.push(...await re({path:s,scope:"project",op:"schema:add-type"}))}finally{await u()}return await fl(r,c),{action:"add-type",registered:!0,replaced:m.replaced,type:m.definition,file:{path:s,definitions:m.file.definitions.length},warnings:st(c),generated_at:$()}}async function Xe(e){if(!await A(K(e)))throw new _(`Tracker is not initialized at ${e}. Run pm init first.`,y.NOT_FOUND)}async function fl(e,t){try{let n=await Hc(e);n.status==="refreshed"?t.push("merge_fence_refreshed"):n.status==="not_installed"&&t.push('merge_fence_not_installed:type folders lack git merge drivers; run "pm merge install"')}catch{t.push('merge_fence_refresh_failed:run "pm merge install" to reconcile')}}function st(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}async function sh(e,t,n,r){let i=G(t,z()),a=r.trim().toLowerCase();return(await Be(e,t.item_format,i.type_to_folder,[],n)).filter(s=>typeof s.type=="string"&&s.type.toLowerCase()===a).length}async function ch(e,t,n,r){let i=G(t,z()),a=qe(n),o=oe(r);return(await Be(e,t.item_format,i.type_to_folder,[],n)).filter(c=>{let l=typeof c.status=="string"?c.status:"";return(a.alias_to_id.get(oe(l))??oe(l))===o}).length}async function lh(e,t,n,r,i){if(i.length===0||yi.has(i))return;let a=await ch(t,n,r,i);a>0&&e.push(`items_using_status:${a}`);let o=dh(r.workflow,i);o.length>0&&e.push(`status_referenced_by_workflow:${o.join(",")}`)}function dh(e,t){return[["draft_status",e.draft_status],["open_status",e.open_status],["in_progress_status",e.in_progress_status],["blocked_status",e.blocked_status],["close_status",e.close_status],["canceled_status",e.canceled_status]].filter(([,r])=>r!==void 0&&oe(r)===t).map(([r])=>r)}async function JA(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i=await I(r),a=we(i.schema),o=Ne(r,a.files.types,Ee.types),s=[],c=Y(t.author,i.author_default),l=Ce(i),d=await le(r,Er,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=Ge(m)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.GENERIC_FAILURE)}try{u=Fo(p,e)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.USAGE)}if(u.removed){let f=(u.definition?.name??e??"").trim();if(f.length>0){let g=await sh(r,i,a,f);g>0&&s.push(`items_using_type:${g}`)}await ot({pmRoot:r,filePath:o,raw:rt(u.file),op:"schema:remove-type",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-type"}))}}finally{await d()}return u.removed&&await fl(r,s),{action:"remove-type",removed:u.removed,...u.definition?{type:u.definition}:{},file:{path:o,definitions:u.file.definitions.length},warnings:st(s),generated_at:$()}}function oa(e,t){return Ne(e,t.files.statuses,Ee.statuses)}function Ar(e,t){return Ne(e,t.files.fields,Ee.fields)}function hl(e,t){return Ne(e,t.files.types,Ee.types)}async function un(e,t,n,r){for(let i of t){let a=So(i.folder??xo(i.name)),o=ah.join(e,a);await A(o)||(await oh(o,{recursive:!0}),n.push(...await re({path:o,scope:"project",op:r})))}}function sa(e){return{key:e.key,type:e.type,commands:[...e.commands],cli_flag:`--${e.cli_flag}`,cli_aliases:e.cli_aliases.map(t=>`--${t}`),...e.description?{description:e.description}:{},required:e.required,required_on_create:e.required_on_create,allow_unset:e.allow_unset,required_types:[...e.required_types]}}function uh(e){if(e)return{id:e.id,...e.roles.length>0?{roles:[...e.roles]}:{},...e.aliases.length>0?{aliases:[...e.aliases]}:{},...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function mh(e){let t=new Map;for(let n of e){let r=oe(n.id);if(r.length!==0){t.set(r,r);for(let i of Array.isArray(n.aliases)?n.aliases:[]){let a=oe(i);a.length>0&&!t.has(a)&&t.set(a,r)}}}return t}async function VA(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i;try{i=Wo({id:e,roles:t.role,aliases:t.alias,description:t.description,order:t.order})}catch(g){throw new _(g instanceof Error?g.message:String(g),y.USAGE)}let a=await I(r),o=we(a.schema),s=oa(r,o),c=qe(o);try{wi(i,c.alias_to_id)}catch(g){throw new _(g instanceof Error?g.message:String(g),y.USAGE)}let l=uh(c.by_id.get(i.id)),d=[],u=Y(t.author,a.author_default),m=Ce(a),p=await le(r,ml,a.locks.ttl_seconds,u,!!t.force,m.force_required_for_stale_lock,a.locks.wait_ms),f;try{let g=await X(s),h;try{h=Rt(g)}catch(v){throw new _(v instanceof Error?v.message:String(v),y.GENERIC_FAILURE)}let w=mh(h.statuses);try{wi(i,w)}catch(v){throw new _(v instanceof Error?v.message:String(v),y.USAGE)}f=Bo(h,i,l),await ot({pmRoot:r,filePath:s,raw:It(f.file),op:"schema:add-status",author:u,settings:a}),d.push(...await re({path:s,scope:"project",op:"schema:add-status"}))}finally{await p()}return{action:"add-status",registered:!0,replaced:f.replaced,status:f.definition,file:{path:s,statuses:f.file.statuses.length},warnings:st(d),generated_at:$()}}async function KA(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i=await I(r),a=we(i.schema),o=oa(r,a),s=[],c=Y(t.author,i.author_default),l=Ce(i),d=await le(r,ml,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=Rt(m)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.GENERIC_FAILURE)}try{u=Ho(p,e)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.USAGE)}if(u.removed){let f=oe(u.definition?.id??e);await lh(s,r,i,a,f),await ot({pmRoot:r,filePath:o,raw:It(u.file),op:"schema:remove-status",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-status"}))}}finally{await d()}return{action:"remove-status",removed:u.removed,...u.definition?{status:u.definition}:{},file:{path:o,statuses:u.file.statuses.length},warnings:st(s),generated_at:$()}}function gl(e){return{name:e.name,folder:e.folder,aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.default_status?{default_status:e.default_status}:{},...e.description?{description:e.description}:{}}}function ph(e,t,n){return{...gl(e),source:t,...n?{extension:n}:{},required_create_fields:[...e.required_create_fields],required_create_repeatables:[...e.required_create_repeatables],options:structuredClone(e.options),command_option_policies:structuredClone(e.command_option_policies)}}function _l(e){return{id:e.id,source:yi.has(e.id)?"builtin":"custom",roles:Array.isArray(e.roles)?[...e.roles]:[],aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function yl(e,t,n){let r=e.toLowerCase();return n.has(r)?"extension":t.has(r)?"custom":"builtin"}function fh(){let e=new Map,t=z();for(let n of t?.item_types??[]){let r=n.types;if(Array.isArray(r))for(let i of r){if(typeof i!="object"||i===null||Array.isArray(i))continue;let a=i.name;typeof a=="string"&&a.trim().length>0&&e.set(a.trim().toLowerCase(),{layer:n.layer,name:n.name})}}return e}function hh(e){let t=qe(e),n=[],r=[];for(let i of t.definitions){let a=_l(i);a.source==="builtin"?n.push(a):r.push(a)}return{builtin:n,custom:r}}async function mn(e){let t=L(process.cwd(),e.path);await Xe(t);let n=await I(t),r=we(n.schema),i=Ne(t,r.files.types,Ee.types),a=oa(t,r),o=G(n,z()),s=fh(),c=new Set((n.item_types?.definitions??[]).map(l=>l.name.trim().toLowerCase()).filter(l=>l.length>0&&!s.has(l)));return{pmRoot:t,typesPath:i,statusesPath:a,byType:o.by_type,customNames:c,extensionProvenance:s,schema:r}}async function YA(e){let t=await mn(e),n=[],r=[],i=[];for(let s of Object.values(t.byType).sort((c,l)=>c.name.localeCompare(l.name))){let c=yl(s.name,t.customNames,new Set(t.extensionProvenance.keys())),l=gl(s);c==="extension"?i.push(l):c==="custom"?r.push(l):n.push(l)}let a=hh(t.schema),o=zn(t.schema).definitions.map(sa);return{action:"list",builtin:n,custom:r,extension:i,counts:{builtin:n.length,custom:r.length,extension:i.length,total:n.length+r.length+i.length},statuses:{builtin:a.builtin,custom:a.custom,counts:{builtin:a.builtin.length,custom:a.custom.length,total:a.builtin.length+a.custom.length}},fields:{custom:o,counts:{total:o.length}},file:{path:t.typesPath},generated_at:$()}}async function XA(e,t){let n=(e??"").trim();if(n.length===0)throw new _("Type name must not be empty.",y.USAGE);let r=await mn(t),i=Object.values(r.byType).find(a=>a.name.toLowerCase()===n.toLowerCase()||a.aliases.some(o=>o.toLowerCase()===n.toLowerCase()));if(!i)throw new _(`Unknown item type "${n}". Run pm schema list to inspect registered types, or pm schema add-type "${jn(n)}" to register it.`,y.NOT_FOUND,{code:"unknown_item_type"});return{action:"show",type:ph(i,yl(i.name,r.customNames,new Set(r.extensionProvenance.keys())),r.extensionProvenance.get(i.name.toLowerCase())),file:{path:r.typesPath},generated_at:$()}}async function ZA(e,t){let n=oe(e);if(n.length===0)throw new _("Status id must not be empty.",y.USAGE);let r=await mn(t),i=qe(r.schema),a=i.alias_to_id.get(n)??n,o=i.by_id.get(a);if(!o)throw new _(`Unknown status "${e}". Run pm schema list to inspect registered statuses, or pm schema add-status "${jn(e??"")}" to register it.`,y.NOT_FOUND,{code:"unknown_status"});return{action:"show-status",status:_l(o),file:{path:r.statusesPath},generated_at:$()}}async function QA(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i;try{i=zo({key:e,type:t.type,commands:t.commands,description:t.description,cliFlag:t.cliFlag,aliases:t.alias,required:t.required,requiredOnCreate:t.requiredOnCreate,allowUnset:t.allowUnset,requiredTypes:t.requiredTypes})}catch(f){throw new _(f instanceof Error?f.message:String(f),y.USAGE)}let a=await I(r),o=we(a.schema),s=Ar(r,o),c=[],l=Gn(i.key);l&&c.push(`custom_field_mcp_input_collision:${l.field}:${l.property}:${l.owner}:use=${l.nested_path}`);let d=Y(t.author,a.author_default),u=Ce(a),m=await le(r,pl,a.locks.ttl_seconds,d,!!t.force,u.force_required_for_stale_lock,a.locks.wait_ms),p;try{let f=await X(s),g;try{g=Et(f)}catch(h){throw new _(h instanceof Error?h.message:String(h),y.GENERIC_FAILURE)}p=Go(g,i),await ot({pmRoot:r,filePath:s,raw:At(p.file),op:"schema:add-field",author:d,settings:a}),c.push(...await re({path:s,scope:"project",op:"schema:add-field"}))}finally{await m()}return{action:"add-field",registered:!0,replaced:p.replaced,field:p.definition,file:{path:s,fields:p.file.fields.length},warnings:st(c),generated_at:$()}}async function gh(e,t,n,r){let i=G(t,z());return(await Be(e,t.item_format,i.type_to_folder,[],n)).filter(o=>{let s=o[r];return s==null?!1:Array.isArray(s)?s.length>0:typeof s=="string"?s.trim().length>0:!0}).length}async function eR(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i=await I(r),a=we(i.schema),o=Ar(r,a),s=[],c=Y(t.author,i.author_default),l=Ce(i),d=await le(r,pl,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=Et(m)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.GENERIC_FAILURE)}try{u=qo(p,e)}catch(f){throw new _(f instanceof Error?f.message:String(f),y.USAGE)}if(u.removed){let f=oe(u.definition?.key??e),g=oe(u.definition?.metadata_key??u.definition?.front_matter_key??f);if(g.length>0){let h=await gh(r,i,a,g);h>0&&s.push(`items_using_field:${h}`)}await ot({pmRoot:r,filePath:o,raw:At(u.file),op:"schema:remove-field",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-field"}))}}finally{await d()}return{action:"remove-field",removed:u.removed,...u.definition?{field:u.definition}:{},file:{path:o,fields:u.file.fields.length},warnings:st(s),generated_at:$()}}async function tR(e){let t=await mn(e),n=zn(t.schema).definitions.map(sa);return{action:"list-fields",fields:n,counts:{total:n.length},file:{path:Ar(t.pmRoot,t.schema)},generated_at:$()}}async function nR(e,t){let n=oe(e);if(n.length===0)throw new _("Field key must not be empty.",y.USAGE);let r=await mn(t),i=zn(r.schema).by_key.get(n);if(!i)throw new _(`Unknown custom field "${e}". Run pm schema list-fields to inspect registered fields, or pm schema add-field "${jn(e??"")}" to register it.`,y.NOT_FOUND,{code:"unknown_field"});return{action:"show-field",field:sa(i),file:{path:Ar(r.pmRoot,r.schema)},generated_at:$()}}async function rR(e,t,n){let r=L(process.cwd(),n.path);await Xe(r);let i;try{let g=Uo(e);if(g===void 0)throw new Error(`Type preset name is required. Allowed: ${jo.join(", ")}.`);i=g}catch(g){throw new _(g instanceof Error?g.message:String(g),y.USAGE)}let a=await I(r),o=we(a.schema),s=hl(r,o),c=[],l=Y(t.author,a.author_default),d=Ce(a),u=[],m=[],p,f=await le(r,Er,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms);try{let g=await X(s),h;try{h=Ge(g)}catch(v){throw new _(v instanceof Error?v.message:String(v),y.GENERIC_FAILURE)}let w=h;for(let v of _i(i)){let b=Un(w,v);w=b.file,(b.replaced?m:u).push(b.definition.name)}p=w.definitions.length,await ot({pmRoot:r,filePath:s,raw:rt(w),op:"schema:apply-preset",author:l,settings:a}),await un(r,_i(i),c,"schema:apply-preset-folder"),c.push(...await re({path:s,scope:"project",op:"schema:apply-preset"}))}finally{await f()}return{action:"apply-preset",preset:i,registered:u,replaced:m,file:{path:s,definitions:p},warnings:st(c),generated_at:$()}}function _h(e){if(e===void 0)return 10;if(!Number.isInteger(e)||e<1)throw new _("--min-count must be a positive integer (>= 1).",y.USAGE);return e}async function iR(e,t){let n=L(process.cwd(),t.path);await Xe(n);let r=await I(n),i=we(r.schema),a=hl(n,i),o=_h(e.minCount),s=G(r,z()),l=(await Be(n,r.item_format,s.type_to_folder,[],i)).map(b=>typeof b.title=="string"?b.title:""),d=Jc(l,{minCount:o}),u=[],m=[],p=[],f=[],g;if(!e.apply){let b;try{b=Ge(await X(a))}catch(x){throw new _(x instanceof Error?x.message:String(x),y.GENERIC_FAILURE)}return g=b.definitions.length,{action:"infer-types",applied:!1,min_count:o,candidates:d,registered:m,replaced:p,skipped:f,file:{path:a,definitions:g},warnings:u,generated_at:$()}}let h=Y(e.author,r.author_default),w=Ce(r),v=await le(n,Er,r.locks.ttl_seconds,h,!!e.force,w.force_required_for_stale_lock,r.locks.wait_ms);try{let b=await X(a),x;try{x=Ge(b)}catch(k){throw new _(k instanceof Error?k.message:String(k),y.GENERIC_FAILURE)}let R=x;for(let k of d){if(k.shadows_builtin){f.push({name:k.name,reason:"shadows_builtin"});continue}let F;try{F=gi({name:k.name})}catch{f.push({name:k.name,reason:"invalid_type_token"});continue}let T=Un(R,F);R=T.file,(T.replaced?p:m).push(T.definition.name)}g=R.definitions.length,await ot({pmRoot:n,filePath:a,raw:rt(R),op:"schema:infer-types",author:h,settings:r}),await un(n,R.definitions.filter(k=>m.includes(k.name)||p.includes(k.name)),u,"schema:infer-types-folder"),u.push(...await re({path:a,scope:"project",op:"schema:infer-types"}))}finally{await v()}return{action:"infer-types",applied:!0,min_count:o,candidates:d,registered:m,replaced:p,skipped:f,file:{path:a,definitions:g},warnings:st(u),generated_at:$()}}import wl from"node:fs/promises";import ca from"node:path";(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]="af718efb-d1cf-5adc-9518-c858627e1b54")}catch{}})();function be(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function S(e){return e.trim().toLowerCase()}function Rr(e){let t=e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-"),n=0;for(;t[n]==="-";)n+=1;let r=t.length;for(;r>n&&t[r-1]==="-";)r-=1;let i=t.slice(n,r);if(i.length===0)throw new _("Extension manifest name must resolve to a non-empty directory name.",y.USAGE);if(i==="."||i==="..")throw new _('Extension manifest name must not resolve to "." or "..".',y.USAGE);return i}function la(e){return To(e)}async function yh(e){try{let t=JSON.parse(await wl.readFile(ca.join(e,"package.json"),"utf8")),n=typeof t.name=="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(t.name)?t.name:void 0;return{...n?{package_name:n}:{},has_build_script:["build","prepare","prepack"].some(r=>typeof t.scripts?.[r]=="string")}}catch{return{has_build_script:!1}}}async function wh(e,t,n){if(n.source_kind!=="github"||typeof n.source_root!="string")return new _(`Extension entry file is missing at "${t}".`,y.USAGE);let r=await yh(n.source_root),i=r.package_name?`pm install npm:${r.package_name}`:void 0,a=n.source_input??n.source_root;return new _(`Extension entry "${e.entry}" is absent from GitHub source "${a}". pm install copies GitHub repositories without running package scripts${r.has_build_script?", and this package declares a build or publish script":""}. ${i?`Try "${i}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,y.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:i?[i,`pm install ${n.source_root}`]:[`pm install ${n.source_root}`],nextSteps:i?[`Retry with ${i}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm install npm:<package-name>."],recovery:{attempted_command:`pm install ${a}`,normalized_args:["install",a],...i?{next_best_command:i}:{}}})}async function Bt(e,t={}){let n=ca.join(e,"manifest.json");if(!await A(n))throw new _(`Extension manifest is missing at "${n}".`,y.USAGE);let r;try{r=JSON.parse(await wl.readFile(n,"utf8"))}catch(o){throw new _(`Failed to parse extension manifest at "${n}": ${vh(o)}`,y.USAGE)}let i=la(r);if(!i)throw new _(`Extension manifest at "${n}" is invalid.`,y.USAGE);let a=ca.resolve(e,i.entry);if(!_e(e,a))throw new _(`Extension entry "${i.entry}" resolves outside extension directory "${e}".`,y.USAGE);if(!await A(a))throw await wh(i,a,t);if(!await Oo(e,a))throw new _(`Extension entry "${i.entry}" resolves outside extension directory after symlink resolution.`,y.USAGE);return{directory:e,manifest_path:n,entry_path:a,manifest:i}}function vh(e){return e instanceof Error?e.message:String(e)}import da from"node:fs/promises";import bh from"node:path";(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]="159d7bbd-1d2a-503d-b3ce-f32dcc6f6547")}catch{}})();var kh=".managed-extensions.json",Ir=1;function pn(e){return bh.join(e,kh)}function xh(){return{version:Ir,updated_at:$(),entries:[]}}function fn(e){return[...e].sort((t,n)=>{let r=t.scope.localeCompare(n.scope);if(r!==0)return r;let i=t.name.localeCompare(n.name);return i!==0?i:t.directory.localeCompare(n.directory)})}function vl(e,t){return e.kind!==t.kind||e.input!==t.input||e.location!==t.location?!1:e.kind==="npm"&&t.kind==="npm"?e.package===t.package&&e.version===t.version:e.kind==="github"&&t.kind==="github"?e.repository===t.repository&&e.ref===t.ref&&e.subpath===t.subpath&&e.commit===t.commit:e.kind==="builtin"&&t.kind==="builtin"?e.name===t.name:!0}function ke(e){return typeof e=="string"?e:void 0}function Sh(e){return typeof e.name=="string"&&e.name.trim().length>0&&typeof e.directory=="string"&&e.directory.trim().length>0&&(e.scope==="project"||e.scope==="global")&&typeof e.manifest_version=="string"&&typeof e.manifest_entry=="string"&&Array.isArray(e.capabilities)&&e.capabilities.every(t=>typeof t=="string")&&typeof e.installed_at=="string"&&typeof e.updated_at=="string"}function Eh(e){if(typeof e!="object"||e===null)return null;let t=e;return t.kind!=="local"&&t.kind!=="github"&&t.kind!=="npm"&&t.kind!=="builtin"||typeof t.input!="string"||typeof t.location!="string"?null:{kind:t.kind,input:t.input,location:t.location,name:ke(t.name),package:ke(t.package),version:ke(t.version),repository:ke(t.repository),owner:ke(t.owner),repo:ke(t.repo),ref:ke(t.ref),subpath:ke(t.subpath),commit:ke(t.commit)}}function Ah(e){if(typeof e!="object"||e===null)return null;let t=e;if(!Sh(t))return null;let n=Eh(t.source);if(!n)return null;let r=Io(t.contributions);return r===null?null:{name:t.name.trim(),directory:t.directory.trim(),scope:t.scope,manifest_version:t.manifest_version,manifest_entry:t.manifest_entry,capabilities:be(t.capabilities),contributions:r,installed_at:t.installed_at,updated_at:t.updated_at,source:n,last_update_check_at:ke(t.last_update_check_at),last_update_remote_commit:ke(t.last_update_remote_commit),update_available:typeof t.update_available=="boolean"||t.update_available===null?t.update_available:void 0,update_error:ke(t.update_error)}}function Rh(e){if(typeof e!="object"||e===null)return null;let t=e;if(t.version!==Ir||!Array.isArray(t.entries))return null;let n=[];for(let r of t.entries){let i=Ah(r);i&&n.push(i)}return{version:Ir,updated_at:ke(t.updated_at)??$(),entries:fn(n)}}async function pe(e){let t=pn(e),n=xh();try{let r=await da.readFile(t,"utf8"),i=JSON.parse(r),a=Rh(i);if(!a)throw new _(`Managed extension state file "${t}" has an invalid schema. Repair or remove it before mutating extension state.`,y.GENERIC_FAILURE);return{path:t,state:a,warnings:[]}}catch(r){if(r instanceof _)throw r;if(typeof r=="object"&&r!==null&&"code"in r&&j(r))return{path:t,state:n,warnings:[]};throw new _(`Managed extension state file "${t}" could not be read. Repair or remove it before mutating extension state.`,y.GENERIC_FAILURE)}}async function wt(e,t){let n=pn(e),r={version:Ir,updated_at:$(),entries:fn(t.entries)};await da.mkdir(e,{recursive:!0}),await da.writeFile(n,`${JSON.stringify(r,null,2)}
20
- `,"utf8")}function hn(e,t){let n=e.entries.filter(r=>S(r.name)!==S(t.name)&&S(r.directory)!==S(t.directory));return n.push(t),{...e,updated_at:$(),entries:fn(n)}}async function bl(e,t,n,r){let i=t.entries.find(o=>S(o.name)===S(n));if(!i)return t;let a=hn(t,{...i,contributions:r});return await wt(e,a),a}import{execFile as Fh}from"node:child_process";import q from"node:fs/promises";import ha from"node:os";import O from"node:path";import{fileURLToPath as jh}from"node:url";import{promisify as Uh}from"node:util";import zh from"npm-package-arg";import{extract as Gh,list as qh}from"tar";import Ih from"node:fs/promises";import $e from"node:path";(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]="259656b0-09b7-52c5-8f54-52ac29eec607")}catch{}})();var Ch="PM_CLI_PACKAGE_ROOT",kl={beads:{package_directory:"pm-beads",legacy_extension_directory:"beads"},todos:{package_directory:"pm-todos",legacy_extension_directory:"todos"}},$h=new Set(["*","all"]);function ua(){let e=[],t=process.env[Ch];return typeof t=="string"&&t.trim().length>0&&e.push($e.resolve(t.trim())),e.push(Se(import.meta.url,["../../.."])),[...new Set(e)]}async function gn(e){let t=e.trim().toLowerCase(),n=await Sl(t);if(n)return n;let r=kl[t];if(!r)return null;for(let i of ua()){let a=$e.join(i,".agents","pm","extensions",r.legacy_extension_directory);if(await A($e.join(a,"manifest.json")))return a}return null}function xl(e){return $h.has(e.trim().toLowerCase())}function Th(e){return e.replace(/^pm-/i,"").trim().toLowerCase()}async function Oh(e,t){let n=await Ih.readdir(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||!r.name.startsWith("pm-"))continue;let i=$e.join(e,r.name);if(!await A($e.join(i,"package.json")))continue;let a=await Ln(i),o=a.aliases&&a.aliases.length>0?a.aliases:[Th(r.name)];for(let s of o){let c=s.trim().toLowerCase();c.length===0||t.has(c)||t.set(c,{alias:c,package_directory:r.name,package_root:i,package_name:a.package_name??null})}}}async function ma(){let e=new Map;for(let t of ua()){let n=$e.join(t,"packages");await A(n)&&await Oh(n,e)}for(let[t,n]of Object.entries(kl))if(!e.has(t))for(let r of ua()){let i=$e.join(r,"packages",n.package_directory);if(await A($e.join(i,"package.json"))){e.set(t,{alias:t,package_directory:n.package_directory,package_root:i,package_name:null});break}}return[...e.values()].sort((t,n)=>t.alias.localeCompare(n.alias))}async function Cr(){return(await ma()).map(e=>e.alias)}async function Sl(e){let t=e.trim().toLowerCase();return(await ma()).find(r=>r.alias===t||r.package_directory.toLowerCase()===t||r.package_name?.toLowerCase()===t)?.package_root??null}async function El(e){let t=await Sl(e);return t?(await Ln(t)).package_name??null:null}async function Al(e){let t=await gn(e);if(!t)return null;try{let n=await Fn(t);return n.length!==1?null:(await Bt(n[0])).manifest.name}catch{return null}}function Dh(e){return{docs:e.catalog?.links?.docs??e.package_homepage,npm:e.catalog?.links?.npm??(e.package_name&&e.package_private!==!0?`https://www.npmjs.com/package/${encodeURIComponent(e.package_name)}`:void 0),repository:e.catalog?.links?.repository??e.package_repository_url,report:e.catalog?.links?.report??e.package_bugs_url}}function Ph(e,t,n,r,i,a){let o=r==="global"?"--global":"--project",s=Object.fromEntries(hi.filter(c=>c!=="extensions").map(c=>[c,e.resources[c]??[]]).filter(([,c])=>Array.isArray(c)&&c.length>0));return{alias:t.alias,aliases:n,bundled:!0,available:!0,installed:n.some(c=>i.has(c))||a.has($e.resolve(t.package_root)),install_target:t.alias,install_command:`pm install ${t.alias} ${o}`,package_name:e.package_name,package_version:e.package_version,description:e.catalog?.summary??e.package_description,keywords:e.package_keywords??[],resources:e.resources,installable_resources:{extensions:e.resources.extensions??[]},metadata_only_resources:s,catalog:{display_name:e.catalog?.display_name,category:e.catalog?.category,tags:e.catalog?.tags??e.package_keywords??[],links:Dh(e),media:e.catalog?.media}}}async function Rl(e,t,n={}){let r=St(L(process.cwd(),t.path),process.cwd()),i=e==="global"?r.global:r.project,a=await pe(i),o=new Set(a.state.entries.filter(m=>m.scope===e).filter(m=>m.source.kind!=="builtin").map(m=>$e.resolve(m.source.location))),s=new Set(a.state.entries.filter(m=>m.scope===e&&m.source.kind==="builtin").flatMap(m=>[m.source.name,m.source.input,m.source.location]).filter(m=>typeof m=="string"&&m.trim().length>0).map(m=>m.trim().toLowerCase())),c=[],l=new Map;for(let m of await ma()){let p=$e.resolve(m.package_root),f=l.get(p)??[];f.push(m),l.set(p,f)}for(let m of l.values()){let p=m[0],f=m.map(h=>h.alias).sort((h,w)=>h.localeCompare(w)),g=await Ln(p.package_root);c.push(Ph(g,p,f,e,s,o))}let d=Mh(n.fields),u=d?c.map(m=>Lh(m,d)):c;return{total:u.length,scope:e,installable_resource_kinds:["extensions"],metadata_only_resource_kinds:hi.filter(m=>m!=="extensions"),packages:u}}var Nh=new Set(["alias","aliases","bundled","available","installed","install_target","install_command","package_name","package_version","description","keywords","resources","installable_resources","metadata_only_resources","catalog","category","display_name"]);function Mh(e){if(e===void 0)return;let t=ir(e);if(t.length===0)throw new _("Package catalog --fields requires a comma-separated list of field names",y.USAGE);let n=t.filter(r=>!Nh.has(r));if(n.length>0)throw new _(`Unknown package catalog --fields value(s): ${n.join(", ")}`,y.USAGE,{examples:["pm package list --project --fields alias,installed,install_command","pm package catalog --project --fields alias,package_name,category"]});return t}function Lh(e,t){let n={};for(let r of t)r==="category"?n[r]=e.catalog?.category??null:r==="display_name"?n[r]=e.catalog?.display_name??null:n[r]=e[r]??null;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]="8994c8e2-8e3a-5e00-a3ca-7bd553c045d7")}catch{}})();var ga=Uh(Fh),Tr="@unbrained/pm-cli",Wh={maxArchiveBytes:64*1024*1024,maxEntries:4096,maxExpandedBytes:256*1024*1024,maxEntryBytes:64*1024*1024},pa;async function Il(e,t=process.cwd()){let n=e.trim();if(!/^(@[^/\\\s]+\/[^/\\\s]+|[^@/\\\s][^/\\\s]*)$/u.test(n))return null;let r=O.resolve(t);for(;;){let i=O.join(r,"node_modules",...n.split("/")),a=O.join(i,"package.json");if(await A(a))try{let s=JSON.parse(await q.readFile(a,"utf8"));if(s.name===n)return{package:n,...typeof s.version=="string"?{version:s.version}:{},directory:i}}catch{return null}let o=O.dirname(r);if(o===r)return null;r=o}}function fa(e,t,n){let r=e.split("/").map(l=>l.trim()).filter(l=>l.length>0);if(r.length<2)return null;let i=r[0],a=r[1].replace(/\.git$/i,"");if(i.length===0||a.length===0)return null;let o=r.slice(2),s,c;return o[0]==="tree"&&o.length>=2?(s=o[1],c=o.slice(2).join("/")):o.length>0&&(c=o.join("/")),typeof n=="string"&&n.trim().length>0&&(s=n.trim()),{kind:"github",input:t,owner:i,repo:a,repository:`https://github.com/${i}/${a}.git`,ref:s,subpath:c&&c.length>0?c:void 0}}function Bh(e,t,n){let r=e.slice(4).trim();if(r.length===0)throw new _('npm package source must include a package spec after "npm:".',y.USAGE);if(t)throw new _('Options "--gh/--github" cannot be combined with npm: package sources.',y.USAGE);if(n)throw new _('Option "--ref" cannot be combined with npm: package sources.',y.USAGE);return{kind:"npm",input:e,spec:r}}function Or(e,t={}){let n=e.trim();if(n.length===0)throw new _("Extension source is required for --install.",y.USAGE);let r=typeof t.ref=="string"&&t.ref.trim().length>0?t.ref.trim():void 0;if(n.startsWith("npm:"))return Bh(n,t.forceGithub===!0,r);let i=(()=>{try{let o=new URL(n);if(o.hostname!=="github.com")return null;let s=o.pathname.replace(/^\/+/,"");return fa(s,n,r)}catch{return null}})();if(i)return i;let a=n.startsWith("github.com/")?n.slice(11):null;if(a){let o=fa(a,n,r);if(!o)throw new _(`Invalid GitHub source "${n}".`,y.USAGE);return o}if(t.forceGithub){let o=fa(n,n,r);if(!o)throw new _(`Invalid GitHub shorthand "${n}".`,y.USAGE);return o}if(/^https?:\/\//i.test(n))throw new _(`Unsupported extension source URL "${n}". Supported remote source host: github.com.`,y.USAGE);return{kind:"local",input:n,absolute_path:O.resolve(process.cwd(),n)}}async function $r(e,t=ga,n){try{return((await t("git",e,{encoding:"utf8",timeout:n})).stdout??"").trim()}catch(r){let i=typeof r=="object"&&r!==null&&"stderr"in r?String(r.stderr):"",a=i.trim().length>0?i.trim():r instanceof Error?r.message:String(r);throw new _(`Git command failed: git ${e.join(" ")}
21
- ${a}`,y.GENERIC_FAILURE)}}function Hh(e=process.platform){return e==="win32"?"npm.cmd":"npm"}function Jh(e=process.platform){return e==="win32"}async function Cl(e,t,n=ga,r=process.platform){let i=Hh(r);try{return((await n(i,e,{cwd:t,encoding:"utf8",shell:Jh(r)})).stdout??"").trim()}catch(a){let o=typeof a=="object"&&a!==null&&"stderr"in a?String(a.stderr):"",s=o.trim().length>0?o.trim():a instanceof Error?a.message:String(a);throw new _(`npm command failed: ${i} ${e.join(" ")}
22
- ${s}`,y.GENERIC_FAILURE)}}function Vh(e){let t=e.trim(),n=t.includes("@file:")?t.slice(0,t.lastIndexOf("@file:")):t;return n.startsWith("@")?n.match(/^(@[^/@\s]+\/[^/@\s]+)/)?.[1]??n:n.match(/^([^/@\s]+)/)?.[1]??n}function Kh(e){let n=(e instanceof Error?e.message:String(e)).toLowerCase();return n.includes("npm err! code e404")||n.includes("404 not found")||n.includes("is not in this registry")}function Yh(e){let n=(e instanceof Error?e.message:String(e)).toLowerCase();return Kh(e)||n.includes("not found")}function Xh(e){let t=e.trim().toLowerCase();return t.startsWith("@unbrained/pm-")||t.startsWith("pm-")}function Zh(e){let t=Vh(e),n=Xh(t),r=t.replace(/^.*\//,""),i=n?`github.com/unbraind/${r}`:void 0,a=i?`pm install --project ${i}`:void 0;return{message:n?`npm package "${e}" was not found in the registry. If this is an unpublished first-party pm package, install its GitHub repository instead.`:`npm package "${e}" was not found in the registry.`,context:{code:"npm_package_not_found",required:"Use an install source that exists, or publish the npm package before installing it with npm:<name>.",why:"Classifying npm 404s avoids repeated registry retries and gives agents a deterministic fallback path.",examples:a?[a,"pm package catalog --project --json"]:[`npm view ${t}`,"pm package catalog --project --json"],nextSteps:a?[`Try ${a} if the repository exists.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."]:[`Verify ${t} exists in the npm registry and that you have access to it.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."],recovery:{attempted_command:`pm install --project npm:${e}`,normalized_args:["install","--project",`npm:${e}`],...i&&a?{fallback_candidates:[{source:i,command:a,reason:"canonical first-party GitHub repository fallback for unpublished pm packages"}],next_best_command:a}:{}}}}}function Qh(e,t){if(!Yh(t))return null;let n=Zh(e);return new _(n.message,y.NOT_FOUND,n.context)}async function $l(e){if(O.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")){let t=O.resolve(process.cwd(),e);return await A(t)?t:null}try{let t=new URL(e);if(t.protocol==="file:"){let n=jh(t);return await A(n)?n:null}}catch{}if(!/^[a-z][a-z0-9+.-]*:/i.test(e)){let t=O.resolve(process.cwd(),e);if(await A(t))return t}return null}async function eg(e){let t=await $l(e);if(t)return t;let n=tg(e);return n!==e?n:(/^[a-z][a-z0-9+.-]*:/i.test(e),e)}function tg(e,t=process.cwd()){let n="@file:",r=e.lastIndexOf(n);if(r<=0)return e;let i=e.slice(0,r),a=e.slice(r+n.length);if(i.trim().length===0||a.trim().length===0||a.startsWith("//")&&!a.startsWith("///"))return e;if(!a.startsWith("/"))return`${i}@${O.resolve(t,a)}`;let o;try{o=decodeURIComponent(new URL(`file:${a}`).pathname)}catch{return e}let s=/^\/[A-Za-z]:/.test(o)?o.slice(1):o;return`${i}@${s}`}function ng(e,t){try{let r=JSON.parse(e),i=Array.isArray(r)?r[0]:void 0;if(i&&typeof i.filename=="string"&&i.filename.trim().length>0)return{tarball:O.resolve(t,i.filename),package:typeof i.name=="string"?i.name:void 0,version:typeof i.version=="string"?i.version:void 0}}catch{}let n=e.split(/\r?\n/).map(r=>r.trim()).filter(r=>r.length>0).at(-1);if(!n)throw new _("npm pack did not report a tarball filename.",y.GENERIC_FAILURE);return{tarball:O.resolve(t,n)}}async function rg(e){return ig(e,Cl)}async function ig(e,t){let n=await $l(e.spec);if(n){if((await q.stat(n)).isFile()&&Tl(n))return Ol(n);let s=O.join(n,"package.json"),c=await A(s)?JSON.parse(await q.readFile(s,"utf8")):{};return{directory:await _n(n,e.input),package:typeof c.name=="string"?c.name:void 0,version:typeof c.version=="string"?c.version:void 0,cleanup:async()=>{}}}let r=await q.mkdtemp(O.join(ha.tmpdir(),"pm-npm-package-source-")),i=O.join(r,"pack"),a=O.join(r,"extract");await q.mkdir(i,{recursive:!0}),await q.mkdir(a,{recursive:!0});try{let o=await eg(e.spec),s=await t(["pack",o,"--json","--pack-destination",i]),c=ng(s,i);await ga("tar",["-xzf",c.tarball,"-C",a],{encoding:"utf8"});let l=O.join(a,"package");return await Dl(l),{directory:await _n(l,e.input),package:c.package,version:c.version,cleanup:async()=>{await q.rm(r,{recursive:!0,force:!0})}}}catch(o){await q.rm(r,{recursive:!0,force:!0});let s=Qh(e.spec,o);throw s||o}}function Tl(e){let t=e.toLowerCase();return t.endsWith(".tgz")||t.endsWith(".tar.gz")}function Ze(e){throw new _(e,y.USAGE,{code:"local_package_archive_unsafe",required:"Use a bounded npm .tgz or .tar.gz archive with one package/ root and no links or escaping paths.",why:"Package archives are untrusted input and must be validated before any entry reaches the filesystem."})}function ag(e,t,n){if(e.meta)return;n.entries+=1,n.entries>t.maxEntries&&Ze(`Local package archive exceeds the ${t.maxEntries} entry limit.`);let r=e.path,i=r.split("/");(r.includes("\\")||r.startsWith("/")||/^[A-Za-z]:/u.test(r)||i.some(a=>a===".."))&&Ze(`Local package archive contains an escaping path: "${r}".`),i[0]!=="package"&&Ze(`Local package archive entry "${r}" is outside the required package/ root.`),(e.type==="SymbolicLink"||e.type==="Link")&&Ze(`Local package archive link "${r}" is not supported.`),e.type!=="File"&&e.type!=="OldFile"&&e.type!=="Directory"&&Ze(`Local package archive entry "${r}" uses unsupported type "${e.type}".`),e.size>t.maxEntryBytes&&Ze(`Local package archive entry "${r}" exceeds the ${t.maxEntryBytes} byte entry limit.`),n.expandedBytes+=e.size,n.expandedBytes>t.maxExpandedBytes&&Ze(`Local package archive exceeds the ${t.maxExpandedBytes} expanded byte limit.`),r==="package/package.json"&&(n.packageJsonEntries+=1)}async function Ol(e,t=Wh){(await q.stat(e)).size>t.maxArchiveBytes&&Ze(`Local package archive exceeds the ${t.maxArchiveBytes} archive byte limit.`);let r=await q.mkdtemp(O.join(ha.tmpdir(),"pm-local-package-archive-")),i=O.join(r,"extract");await q.mkdir(i,{recursive:!0});let a={entries:0,expandedBytes:0,packageJsonEntries:0},o;try{if(await qh({file:e,strict:!0,maxDecompressionRatio:100,onReadEntry:d=>{if(o===void 0)try{ag(d,t,a)}catch(u){o=u}}}),o!==void 0)throw o;a.packageJsonEntries!==1&&Ze(`Local package archive must contain exactly one package/package.json entry; found ${a.packageJsonEntries}.`),await Gh({file:e,cwd:i,strict:!0,preservePaths:!1,preserveOwner:!1,noMtime:!0,unlink:!0,maxDepth:64,maxDecompressionRatio:100});let s=O.join(i,"package"),c=O.join(s,"package.json"),l=JSON.parse(await q.readFile(c,"utf8"));return await Dl(s),{directory:await _n(s,e),package:typeof l.name=="string"?l.name:void 0,version:typeof l.version=="string"?l.version:void 0,cleanup:async()=>{await q.rm(r,{recursive:!0,force:!0})}}}catch(s){throw await q.rm(r,{recursive:!0,force:!0}),s}}async function Dl(e,t=Cl){let n=O.join(e,"package.json");if(!await A(n))return;let r;try{r=JSON.parse(await q.readFile(n,"utf8"))}catch{return}if(typeof r!="object"||r===null)return;let i=r,a=ug(i),o=og(i);if(a.length===0&&!o)return;let s={...r};delete s.devDependencies;let c={...s};sg(c),await q.writeFile(n,`${JSON.stringify(c,null,2)}
23
- `,"utf8");try{await Promise.all([q.rm(O.join(e,"package-lock.json"),{force:!0}),q.rm(O.join(e,"npm-shrinkwrap.json"),{force:!0})]),a.length>0&&await t(["install","--ignore-scripts","--no-audit","--fund=false","--package-lock=false","--no-save","--omit=peer","--"],e),o&&await cg(e)}finally{await q.writeFile(n,`${JSON.stringify(s,null,2)}
24
- `,"utf8")}}function og(e){for(let t of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(typeof t=="object"&&t!==null&&Tr in t)return!0;return!1}function sg(e){for(let t of["dependencies","optionalDependencies","peerDependencies"]){let n=e[t];if(typeof n!="object"||n===null)continue;let r={...n};delete r[Tr],Object.keys(r).length===0?delete e[t]:e[t]=r}}async function cg(e){let t=Se(import.meta.url,["../../.."]),[n,r]=Tr.split("/"),i=O.join(e,"node_modules",n),a=O.join(i,r);await q.mkdir(i,{recursive:!0}),await q.rm(a,{recursive:!0,force:!0}),await q.symlink(t,a,lg(process.platform))}function lg(e){return e==="win32"?"junction":"dir"}function dg(e,t){if(e.startsWith("-"))throw new _(`Extension runtime dependency name "${e}" is unsafe because npm could interpret it as a command-line option.`,y.USAGE,{code:"extension_dependency_name_unsafe",required:"Use a valid npm package name that does not begin with a dash.",why:"Extension manifests are untrusted input and dependency names must never become npm options."});if([...t].some(r=>{let i=r.charCodeAt(0);return i<=31||i===127||"&|;()`\"'".includes(r)}))throw new _(`Extension runtime dependency "${e}" has an unsafe version specifier.`,y.USAGE,{code:"extension_dependency_version_unsafe",required:"Use an npm version, range, dist-tag, URL, or file specifier without shell metacharacters.",why:"npm.cmd requires a command shell on Windows, so untrusted shell metacharacters cannot be forwarded."});try{zh.resolve(e,t)}catch{throw new _(`Extension runtime dependency "${e}@${t}" is not a valid npm dependency specifier.`,y.USAGE,{code:"extension_dependency_spec_invalid",required:"Use a valid npm package name and npm-supported version, range, dist-tag, URL, or file specifier.",why:"Only grammar-validated dependency specs may be written to the isolated runtime install manifest."})}return`${e}@${t}`}function ug(e){let t=new Map;for(let n of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(!(typeof n!="object"||n===null))for(let[r,i]of Object.entries(n)){if(r===Tr||typeof i!="string"||i.trim().length===0||t.has(r))continue;let a=i.trim();t.set(r,dg(r,a))}return[...t.values()]}async function _n(e,t){let n=await Fn(e);if(n.length===1)return n[0];if(n.length>1){let r=n.map(i=>O.relative(e,i).replaceAll(O.sep,"/")).sort((i,a)=>i.localeCompare(a));throw new _(`Package source "${t}" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${r.join(", ")}`,y.USAGE)}throw new _(`Unable to locate a pm extension manifest in package source "${t}". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,y.USAGE)}async function mg(e,t){let n=[];t.subpath&&(n.push(t.subpath),n.push(O.posix.join(".agents/pm/extensions",t.subpath)),n.push(O.posix.join(".custom/pm-extensions",t.subpath)),n.push(O.posix.join(".custom/pm-extension",t.subpath)));for(let i of n){let a=O.resolve(e,i);if(_e(e,a)&&await A(O.join(a,"manifest.json")))return{directory:a,resolved_subpath:i}}if(await A(O.join(e,"manifest.json")))return{directory:e,resolved_subpath:"."};let r=await _n(e,t.input);return{directory:r,resolved_subpath:O.relative(e,r).replaceAll(O.sep,"/")}}function pg(e){let t=e.trim();return t.length===0||t.startsWith(".")||t.startsWith("~")?!1:t.startsWith("@")?t.split("/").length===2:!t.includes("/")&&!t.includes("\\")}async function fg(e){let t=`Local extension source does not exist: "${e.absolute_path}".`,n=e.input.trim();if(!pg(n))return new _(t,y.NOT_FOUND);let r=[];try{let a=process.env.PM_CLI_PACKAGE_ROOT,o=typeof a=="string"&&a.trim().length>0?O.resolve(a.trim()):"";pa?.key!==o&&(pa={key:o,aliases:await Cr()}),r=pa.aliases}catch{}let i=[`Retry with pm install npm:${n} if the package is published to npm.`,`Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${r.join(", ")}`];return new _(`${t} "${n}" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as "npm:${n}".`,y.NOT_FOUND,{code:"local_source_not_found_bare_name",required:`Use "npm:${n}" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,why:"Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.",examples:[`pm install npm:${n}`,"pm package catalog --project --json"],nextSteps:i,recovery:{attempted_command:`pm install ${n}`,normalized_args:["install",n],next_best_command:`pm install npm:${n}`}})}async function Pl(e){if(e.kind==="local"){let r;try{r=await q.stat(e.absolute_path)}catch{throw await fg(e)}if(r.isFile()&&Tl(e.absolute_path)){let a=await Ol(e.absolute_path);return{source:e,directory:a.directory,source_root:O.dirname(a.directory),resolved_subpath:O.relative(O.dirname(a.directory),a.directory).replaceAll(O.sep,"/"),npm_package:a.package,npm_version:a.version,cleanup:a.cleanup}}if(!r.isDirectory())throw new _(`Local extension source must be a directory or npm .tgz/.tar.gz archive: "${e.absolute_path}".`,y.USAGE);let i=await _n(e.absolute_path,e.input);return{source:e,directory:i,source_root:e.absolute_path}}if(e.kind==="npm"){let r=await rg(e);return{source:e,directory:r.directory,source_root:O.dirname(r.directory),cleanup:r.cleanup,resolved_subpath:O.relative(O.dirname(r.directory),r.directory).replaceAll(O.sep,"/"),npm_package:r.package,npm_version:r.version}}let t=await q.mkdtemp(O.join(ha.tmpdir(),"pm-extension-source-")),n=["clone","--depth","1"];e.ref&&n.push("--branch",e.ref),n.push(e.repository,t);try{await $r(n);let r=await $r(["-C",t,"rev-parse","HEAD"]),i=await mg(t,e);return{source:e,directory:i.directory,source_root:t,resolved_subpath:i.resolved_subpath,commit:r,cleanup:async()=>{await q.rm(t,{recursive:!0,force:!0})}}}catch(r){throw await q.rm(t,{recursive:!0,force:!0}),r}}async function Nl(e,t){if(!await A(e)||!await A(t))return!1;let[n,r]=await Promise.all([q.realpath(e),q.realpath(t)]);return n===r}import yn from"node:fs/promises";import wn from"node:path";(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]="30dfc6e4-27c5-56c0-981b-94e85b780f1f")}catch{}})();var _a=1,vt="2026.6.24",hg=">=22.18.0",gg={fs_read:!1,fs_write:!1,network:!1,env_read:!1,env_write:!1,process_spawn:!1},Ml=new Set([...Jo.map(e=>e.split("-")[0].toLowerCase()),...Object.keys(Yo).map(e=>e.toLowerCase()),"scaffold"]),_g="^6.0.0",yg="^22.0.0",jl=["type StarterHarness = Awaited<ReturnType<typeof createExtensionTestHarness>>;","","async function deactivateIfNeeded(ext: StarterHarness, deactivated: boolean): Promise<void> {"," if (!deactivated) {"," try {"," await ext.deactivate();"," } catch {"," // Preserve the original assertion error; cleanup is best effort."," }"," }","}",""],je=[" } finally {"," await deactivateIfNeeded(ext, deactivated);"," }"];function Ll(e,t){return e.map(n=>n===""?n:`${t}${n}`)}function Ul(e){let t=e.includeMigrationReplacementHint===!0?[" // as your migration grows."]:[];return[" // assertItemType/Field/Migration throw unless the registration is present, so"," // reaching each next line already proves the wiring; assert on the returned"," // definitions to demonstrate inspecting registered metadata.",` const itemType = ext.assertItemType({ name: ${JSON.stringify(e.itemTypeName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,` assert.equal(itemType.itemType.folder, ${JSON.stringify(e.itemTypeFolder)});`,` const itemField = ext.assertItemField({ name: ${JSON.stringify(e.fieldName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,' assert.equal(itemField.field.type, "string");',` ext.assertMigration({ name: ${JSON.stringify(e.migrationId)}, extensionName: ${JSON.stringify(e.extensionName)}, mandatory: false });`,""," // runMigration invokes the migration through pm's real runner with a synthetic"," // context and returns its result.",...t,` const migrated = await ext.runMigration({ migration: ${JSON.stringify(e.migrationId)} });`,` assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(e.migrationId)} });`]}function zl(e){return[" // assertProfile throws unless the profile is registered, so reaching the next"," // line already proves the wiring; assert on the returned definition to inspect"," // the bundled archetype dimensions.",` const { profile } = ext.assertProfile({ name: ${JSON.stringify(e)}, extensionName: ${JSON.stringify(e)} });`,` assert.equal(profile.title, ${JSON.stringify(`${e} archetype`)});`," assert.equal(profile.types.length, 1);"," assert.equal(profile.workflows.length, 1);"]}var wg={compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",strict:!0,esModuleInterop:!0,skipLibCheck:!0,noEmit:!0,allowImportingTsExtensions:!0,resolveJsonModule:!0,types:["node"]},include:["**/*.ts"]},Fl=["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"],Gl={commands:["commands"],hooks:["commands","hooks"],search:["commands","search"],importers:["commands","schema","importers"],schema:["commands","schema"],profile:["commands","schema"],renderers:["commands","renderers"],parser:["commands","parser","schema"],preflight:["commands","preflight"],services:["commands","services"]},vg={commands:'["commands"]',hooks:'["commands", "hooks"]',search:'["commands", "search"]',importers:'["commands", "schema", "importers"]',schema:'["commands", "schema"]',profile:'["commands", "schema"]',renderers:'["commands", "renderers"]',parser:'["commands", "parser", "schema"]',preflight:'["commands", "preflight"]',services:'["commands", "services"]'},bg={commands:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration plus a `deactivate` teardown stub.",hooks:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub.",search:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub.",importers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub.",schema:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a custom item type, a custom item field, a schema migration, and a `deactivate` teardown stub.",profile:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a project profile (item types, statuses, fields, a workflow, config, a template, and package recommendations) registered via `api.registerProfile`, and a `deactivate` teardown stub.",renderers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a `toon` output renderer override, and a `deactivate` teardown stub.",parser:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a parser override that rewrites the command's parsed options, and a `deactivate` teardown stub.",preflight:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a preflight override over pm's pre-run gate decision, and a `deactivate` teardown stub.",services:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `output_format` service override, and a `deactivate` teardown stub."},kg={commands:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.",hooks:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.",search:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.",importers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers.",schema:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, item type/field/migration registration, migration invocation, and teardown via the SDK testing helpers.",profile:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, project-profile registration (asserting the bundled archetype dimensions), and teardown via the SDK testing helpers.",renderers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, renderer override registration and invocation (including format pass-through), and teardown via the SDK testing helpers.",parser:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, parser override registration and the option rewrite it produces, and teardown via the SDK testing helpers.",preflight:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, preflight override registration and the gate decision it returns, and teardown via the SDK testing helpers.",services:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, service override registration and invocation (including command pass-through), and teardown via the SDK testing helpers."},ql="- `tsconfig.json`: strict type-check-only TypeScript config (`noEmit`) for the `.ts` source the loader runs directly.",xg={commands:[],hooks:["","## Lifecycle Hook","`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.","pm fires it once a command finishes, passing the command outcome and the","items it mutated (`context.affected`). React there to keep external context","in sync - sync records, emit telemetry, or refresh derived state. The","`hooks` capability in `manifest.json` is what grants the hook registration;","remove it (and the hook) if your package only needs commands."],search:["","## Search Provider","`index.ts` registers a deterministic in-memory search provider and","vector-store adapter through `api.registerSearchProvider` and","`api.registerVectorStoreAdapter`. Replace the sample scoring,","embedding, and storage behavior with your project-specific retrieval","logic. The `search` capability in `manifest.json` grants both","registrations."],importers:["","## Importer and Exporter","`index.ts` registers paired project-context import/export commands through","`api.registerImporter` and `api.registerExporter`. Replace the starter","payloads with your domain adapter: GitHub issues, CSV rows, documents,","tickets, or another project-management source of truth. The `importers`","capability grants both registrations, and `schema` grants the example","command flag metadata."],schema:["","## Custom Schema","`index.ts` models a project domain by registering a custom item type, a","custom item field, and a schema migration through `api.registerItemTypes`,","`api.registerItemFields`, and `api.registerMigration`. This is how a package","turns pm into a domain-specific tracker \u2014 `project management = context","management`. Replace the sample type/field/migration with your own domain","model; the `schema` capability in `manifest.json` grants all three","registrations. Once installed, the custom type is usable everywhere, e.g.",'`pm create <type> "<title>"` and `pm list --type <type>`.'],profile:["","## Project Profile","`index.ts` registers a complete project-profile archetype through","`api.registerProfile`. A profile is the broadest customization primitive pm","has \u2014 one declarative bundle of item types, custom statuses, fields, a per-type","workflow, config knobs, create templates, and package recommendations. Once the","package is installed the profile resolves by name through `pm profile list`,","`pm profile show <name>`, and `pm profile apply <name>`, which stages every","dimension idempotently \u2014 exactly like a core archetype (agile/ops/research),","with no consumer code required. Replace the sample archetype with your own","domain; the `schema` capability in `manifest.json` grants the registration (a","profile is a schema+config bundle, so it needs no separate capability)."],renderers:["","## Output Renderer","`index.ts` registers a `toon` output renderer override through","`api.registerRenderer`. Renderer overrides run for every command's output in","that format, so this starter scopes itself to THIS package's own command and","returns `null` (pass-through to pm's default renderer) for everything else.","Return a string to take over rendering. Replace the sample serialization with","your own; the `renderers` capability in `manifest.json` grants the","registration."],parser:["","## Parser Override","`index.ts` registers a parser override for the starter command through","`api.registerParser`. pm runs it on the command's parsed options BEFORE the","handler, merging the delta you return. This starter rewrites a deprecated","`--shout` alias to the canonical `--upper` flag; replace it with your","command's real normalization. The `parser` capability in `manifest.json`","grants the registration."],preflight:["","## Preflight Override","`index.ts` registers a preflight override through `api.registerPreflight`. pm","calls it only for its declared command ownership to compute the migration/format","gate decision. Overlapping or legacy global ownership is diagnosed. Return only","the decision keys you want to","change; this starter echoes the current decision unchanged (a safe no-op) so","installing the package does not alter gate behavior. The `preflight`","capability in `manifest.json` grants the registration."],services:["","## Service Override","`index.ts` overrides the built-in `output_format` service through","`api.registerService`. The service renders a command's structured result;","returning the payload unchanged passes through to pm's default formatting.","This starter scopes itself to THIS package's own command and passes every","other command through, so it never disrupts unrelated output. The `services`","capability in `manifest.json` grants the registration."]},Sg={package:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","package's `activate` registers. pm imports and activates the package lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands (`pm list`, `pm search`, ...) never pay to load it. Keep this list in","sync with the registrations in `index.ts`: add an entry when you register a new","command, importer, or exporter, and remove one you drop. An omitted or stale","entry means the matching command will not dispatch from the CLI. Globally-scoped","surfaces (hooks, parser/preflight/renderer overrides, and search providers for","built-in search commands) still activate regardless of this list."],extension:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","extension's `activate` registers. pm imports and activates the extension lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands never pay to load it. Keep this list in sync with the registrations in","`index.ts`: an omitted or stale entry means the matching command will not dispatch","from the CLI. Globally-scoped surfaces (hooks, parser/preflight/renderer overrides,","and search providers for built-in search commands) still activate regardless."]},Eg={package:["","## Activation","This package contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the package","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`. If you","drop the schema registrations and keep only command/hook/search/importer surfaces,","add `activation.commands` back so pm can load the package lazily."],extension:["","## Activation","This extension contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the extension","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`."]},Ag={package:["","## Activation","This package contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands \u2014 commands the package does not own \u2014 so `manifest.json` intentionally","declares no `activation.commands`. pm activates the package conservatively (for","every command, granted by the `schema` capability) so the profile is present","whenever `pm profile` runs. Declaring narrow `activation.commands` here would","gate activation to only the listed commands and silently leave the profile","unregistered for `pm profile`."],extension:["","## Activation","This extension contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands, so `manifest.json` intentionally declares no `activation.commands`. pm","activates the extension conservatively (for every command, granted by the","`schema` capability) so the profile is present whenever `pm profile` runs.","Declaring narrow `activation.commands` here would silently leave the profile","unregistered for `pm profile`."]};function Wl(e,t){return e==="schema"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the custom item type activates for every command).`:e==="profile"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the contributed profile resolves through \`pm profile\` for every command).`:`- \`manifest.json\`: ${t} metadata, capabilities, and \`activation.commands\` (the command paths that lazily activate this ${t}).`}function Bl(e,t){return e==="schema"?Eg[t]:e==="profile"?Ag[t]:Sg[t]}function Rg(e){let t=e.replace(/-/g," ").trim().split(/\s+/).filter(c=>c.length>0);if(t.length===0)return"starter ping";let n=t[0].toLowerCase(),r=0;for(;t[r]?.toLowerCase()==="starter";)r+=1;let i=t[r]?.toLowerCase(),a=r>0&&(r===t.length||i!==void 0&&Ml.has(i));return`${(Ml.has(n)||a?["starter",...t]:t).join(" ")} ping`}function Hl(e){let t=e,n=`${e}s`,r=e.replace(/-/g,""),i=r===t?[]:[r],a=`${e.replace(/-/g,"_")}_owner`,o="reviewing";return[` name: ${JSON.stringify(e)},`,` title: ${JSON.stringify(`${e} archetype`)},`,' summary: "Starter project profile. Replace these dimensions with your own archetype.",'," // Item types the profile upserts into the project schema when applied."," types: ["," {",` name: ${JSON.stringify(t)},`,` folder: ${JSON.stringify(n)},`,` aliases: ${JSON.stringify(i)},`,` description: ${JSON.stringify(`A ${e} work item that flows to done.`)},`," },"," ],"," // Custom statuses upserted into the project status set."," statuses: ["," {",` id: ${JSON.stringify(o)},`,' roles: ["active"],',' aliases: ["in-review"],',' description: "Work is implementation-complete and awaiting review.",'," },"," ],"," // Custom item-metadata fields the archetype tracks."," fields: ["," {",` key: ${JSON.stringify(a)},`,' type: "string",',' commands: ["create", "update", "list"],',' description: "Stakeholder accountable for the item.",'," },"," ],"," // Per-type workflow transition allow-list staged into settings."," workflows: ["," {",` type: ${JSON.stringify(t)},`," allowed_transitions: [",' ["open", "in_progress"],',` ["in_progress", ${JSON.stringify(o)}],`,` [${JSON.stringify(o)}, "in_progress"],`,` [${JSON.stringify(o)}, "closed"],`,' ["in_progress", "blocked"],',' ["blocked", "in_progress"],'," ],"," },"," ],"," // Nested-settings knobs staged when the profile is applied."," config: [",' { key: "search_provider", value: "bm25", summary: "Offline BM25 lexical search needs no embedding service." },',' { key: "search_max_results", value: "20", summary: "Result cap tuned for quick triage." },'," ],"," // Create templates staged into <pmRoot>/templates."," templates: ["," {",` name: ${JSON.stringify(e)},`," options: {",` type: ${JSON.stringify(t)},`,' priority: "2",',` tags: ${JSON.stringify(e)},`,' acceptanceCriteria: "Item delivers the stated outcome with tests and docs updated.",',' body: "## Context\\n\\n## Acceptance\\n- [ ] \\n",'," },"," },"," ],"," // Advisory package recommendations (never auto-installed)."," packages: [",' { spec: "templates", reason: "Reusable create templates for recurring item shapes." },'," ],"]}function Ig(e,t,n){let r=`${e}-search`,i=`${e}-vector`,a=`${e.replace(/-/g," ")} items`,o=[" api.registerCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",'," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,",' message: "Starter extension scaffold is active.",'," }),"," });"];if(n==="commands")return o;if(n==="search")return[...o,""," // Search providers let packages customize how pm ranks and retrieves"," // project context. This starter is deterministic and dependency-free:"," // replace the scoring with your domain retrieval, embedding, or rerank"," // logic as the package grows."," api.registerSearchProvider({",` name: ${JSON.stringify(r)},`," query: async (context) => {"," const needle = context.query.toLowerCase();"," const hits = context.documents"," .filter((document) => {",' const title = String(document.metadata.title ?? "").toLowerCase();'," return title.includes(needle);"," })"," .map((document) => ({"," id: document.metadata.id,"," score: 1,",' matched_fields: ["title"],'," }));"," return { hits };"," },"," embed: async (context) => [context.input.length],"," });",""," // Vector-store adapters let packages own semantic index storage. This"," // starter returns a stable in-memory hit so generated tests can exercise"," // the adapter without external services."," api.registerVectorStoreAdapter({",` name: ${JSON.stringify(i)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),"," });"];if(n==="schema"){let s=e,c=`${e}s`,l=e.replace(/-/g,""),d=l===s?[]:[l],u=`${e.replace(/-/g,"_")}_note`,m=`${e}-0001-init`;return[...o,""," // Schema registrations let a package model its own project domain \u2014 the",' // heart of "project management = context management". Item types and fields'," // are GLOBAL contributions: built-in commands like `pm create <type>` and"," // `pm list --type <type>` must see them, so this package declares no"," // `activation.commands` and pm activates it conservatively for every command."," // The `schema` capability in manifest.json grants all three registrations."," api.registerItemFields(["," {",` name: ${JSON.stringify(u)},`,' type: "string",'," optional: true,"," },"," ]);",""," api.registerItemTypes(["," {",` name: ${JSON.stringify(s)},`," // Replace with your domain's canonical plural folder name.",` folder: ${JSON.stringify(c)},`,` aliases: ${JSON.stringify(d)},`," // Add field names here to force them at `pm create` time."," required_create_fields: [],"," },"," ]);",""," // Migrations let a package evolve stored items as its schema changes. pm"," // runs each migration ONCE through the preflight gate (not once per item),"," // passing a context that identifies the migration itself: `context.id` is"," // the migration id (not an item id), alongside `context.pm_root` \u2014 iterate"," // the corpus yourself from there. This starter is a deterministic no-op so"," // package tests can invoke it without touching the corpus; replace the body"," // with your real rewrite."," api.registerMigration({",` id: ${JSON.stringify(m)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),"," });"]}return n==="profile"?[...o,""," // A project profile is the broadest customization primitive pm has: one"," // declarative bundle of item types, custom statuses, fields, a per-type"," // workflow, config knobs, create templates, and package recommendations. Once"," // this package is installed the profile resolves by name through `pm profile"," // list`, `pm profile show`, and `pm profile apply`, which stages every dimension"," // idempotently like a core archetype. A profile registration is a schema+config"," // bundle, so the `schema` capability in manifest.json grants it."," api.registerProfile({",...Hl(e).map(s=>` ${s}`)," });"]:n==="importers"?[...o,""," // Importers/exporters are the bridge between pm's context graph and"," // another project-management system. Keep the starter deterministic so"," // package tests can run without touching the network or filesystem; replace"," // these payloads with your adapter's real mapping as the package grows."," api.registerImporter(",` ${JSON.stringify(a)},`," async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,"," }),"," {",` action: ${JSON.stringify(`${a} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," },"," );",""," api.registerExporter(",` ${JSON.stringify(a)},`," async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,"," }),"," {",` action: ${JSON.stringify(`${a} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," },"," );"]:n==="renderers"?[...o,""," // Renderer overrides customize how pm serializes a command's structured",' // result for an output format ("toon" or "json"). Host-enforced ownership'," // prevents unrelated commands from reaching this callback."," // The `renderers` capability in manifest.json grants the registration.",' api.registerRenderer("toon", (context) => {',` return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,` }, { commands: [${JSON.stringify(t)}] });`]:n==="parser"?[" api.registerCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",'," flags: ["," {",' long: "--shout",',' value_type: "boolean",',' description: "Deprecated alias for --upper; the parser override rewrites it.",'," },"," {",' long: "--upper",',' value_type: "boolean",',' description: "Echo the canonical flag the parser override produces.",'," },"," ],"," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,"," // Surfaces the normalized option so `--shout`/`--upper` is observable."," upper: context.options.upper === true,",' message: "Starter extension scaffold is active.",'," }),"," });",""," // Parser overrides preprocess a command's parsed options BEFORE its handler"," // runs, returning a delta \u2014 only the keys you set are merged over the parsed"," // input. This override is scoped to THIS package's own command. Here it"," // rewrites the deprecated `--shout` boolean alias to the canonical `--upper`"," // flag; replace it with your command's real normalization. The `parser`"," // capability in manifest.json grants the registration.",` api.registerParser(${JSON.stringify(t)}, (context) => {`," const options = { ...context.options };"," if (options.shout === true) {"," options.upper = true;"," }"," delete options.shout;"," return { options };"," });"]:n==="preflight"?[...o,""," // Preflight overrides adjust pm's pre-run gate decision (extension"," // migrations + item-format checks) for the commands it owns. Disjoint"," // packages compose; overlapping or legacy global ownership is diagnosed."," // Return a delta of the keys you want to change"," // (enforce_item_format_gate, run_preflight_item_format_sync,"," // run_extension_migrations, enforce_mandatory_migration_gate); returning"," // context.decision unchanged is a safe no-op so installing the package does"," // not alter gate behavior \u2014 replace it with your policy, e.g."," // `{ run_extension_migrations: false }`. The `preflight` capability in"," // manifest.json grants the registration."," api.registerPreflight({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,"," });"]:n==="services"?[...o,""," // Service overrides replace a built-in pm service. The `output_format`"," // service renders a command's structured result; returning the payload"," // unchanged passes through to pm's default formatting. This override scopes"," // itself to THIS package's own command and passes every other command"," // through, so it never disrupts unrelated output. The `services` capability"," // in manifest.json grants the registration.",' api.registerService("output_format", (context) => {',` if (context.command !== ${JSON.stringify(t)}) {`," return { handled: false };"," }",` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`," });"]:[...o,""," // after_command hooks fire once pm finishes a command, receiving the items"," // it mutated. This is the natural place to react to every change - sync to"," // an external system, emit telemetry, or refresh derived context",' // ("project management = context management"). This starter is a documented'," // no-op on the success path; replace the body with your own reaction."," api.hooks.afterCommand((context) => {"," if (!context.ok) {"," return;"," }"," // `context.affected` lists the items pm mutated (id, status,"," // changed_fields). React here, e.g.:"," // for (const item of context.affected ?? []) { /* ...item.id... */ }"," });"]}function Cg(e,t,n){let r=n==="hooks",i=n==="search",a=n==="importers",o=n==="schema",s=n==="profile",c=n==="renderers",l=n==="parser",d=n==="preflight",u=n==="services",m=vg[n],p=e,f=`${e}s`,g=`${e.replace(/-/g,"_")}_note`,h=`${e}-0001-init`,w=[" assertExtensionDeactivated,"," createExtensionTestHarness,"],v=r?[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertHook throws unless an after_command hook is registered, so"," // reaching the next line already proves the hook is wired."," ext.assertHook({",' kind: "after_command",',` extensionName: ${JSON.stringify(e)},`," });"," // runHook fires the hook through pm's real runner with a synthetic"," // context and returns the warnings it produced; a clean hook returns none."," // Replace the context/assertions as your hook grows."," const warnings = await ext.runHook({",' kind: "after_command",'," context: {",` command: ${JSON.stringify(t)},`," args: [],",' pm_root: "",'," ok: true,"," affected: [],"," },"," });"," assert.deepEqual(warnings, []);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],b=i?ya(e,t,"search",m):[],x=a?ya(e,t,"importers",m):[],R=o?[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {",...Ll(Ul({extensionName:e,itemTypeName:p,itemTypeFolder:f,fieldName:g,migrationId:h,includeMigrationReplacementHint:!0})," ")," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],k=s?[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {",...Ll(zl(e)," ")," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],F=c?[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertRendererOverride throws unless a renderer is registered for the"," // format, so reaching the next line already proves the wiring.",` const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,' assert.equal(override.format, "toon");',""," // runRendererOverride renders through pm's real runner. The override"," // customizes only THIS package's command output and returns a string the"," // host uses verbatim. Replace the assertions as it grows."," const rendered = await ext.runRendererOverride({",' format: "toon",',` command: ${JSON.stringify(t)},`," result: { ok: true },"," });"," assert.equal(rendered.overridden, true);",` assert.equal(rendered.rendered, ${JSON.stringify(`${e}: `)} + JSON.stringify({ ok: true }));`,""," // Output for any other command passes through to pm's default renderer."," const passthrough = await ext.runRendererOverride({",' format: "toon",',' command: "list",'," result: { ok: true },"," });"," assert.equal(passthrough.overridden, false);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],T=l?[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertParserOverride throws unless a parser is registered for the"," // command, so reaching the next line already proves the wiring.",` ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,""," // runParserOverride runs the override through pm's real parser runner and"," // returns the rewritten context. The starter rewrites the deprecated"," // `shout` alias to the canonical `upper` flag."," const result = await ext.runParserOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: { shout: true },"," global: {},",' pm_root: "",'," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.context.options, { upper: true });",""," // End to end: feed the rewritten options into the command handler to"," // prove `pm <command> --shout` surfaces the normalized `upper` flag in"," // the result.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`," upper: true,",' message: "Starter extension scaffold is active.",'," });"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],E=d?[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertPreflightOverride throws unless a preflight override is"," // registered, so reaching the next line already proves the wiring.",` ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,""," // runPreflightOverride runs the override through pm's real runner with a"," // synthetic gate decision. The starter echoes the decision unchanged;"," // replace the values/assertions with your real policy."," const decision = {"," enforce_item_format_gate: true,"," run_preflight_item_format_sync: false,"," run_extension_migrations: true,"," enforce_mandatory_migration_gate: false,"," };"," const result = await ext.runPreflightOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: {},"," global: {},",' pm_root: "",'," decision,"," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.decision, decision);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[],U=u?[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertServiceOverride throws unless a service override is registered"," // for the service, so reaching the next line proves the wiring.",` ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,""," // runServiceOverride runs the override through pm's real service runner."," // The override customizes only THIS package's command output (handled),"," // passing every other command through (not handled)."," const handled = await ext.runServiceOverride({",' service: "output_format",',` command: ${JSON.stringify(t)},`," payload: { ok: true },"," });"," assert.equal(handled.handled, true);",` assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,""," // Output for any other command passes through to pm's default formatter."," const passthrough = await ext.runServiceOverride({",' service: "output_format",',' command: "list",'," payload: { ok: true },"," });"," assert.equal(passthrough.handled, false);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});",""]:[];return['import assert from "node:assert/strict";','import { test } from "node:test";',"import {",...w,'} from "@unbrained/pm-cli/sdk/testing";',...i?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension from "./index.ts";',"",...jl,`test(${JSON.stringify(`${e} registers its starter command`)}, async () => {`," // `capabilities` mirrors manifest.json so the in-memory activation grants"," // the capabilities the entrypoint relies on."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertCommandContract is bound to the right activation registry and throws"," // if the command is not registered, so reaching here already proves the"," // wiring; assert on the returned definition to inspect metadata."," const registered = ext.assertCommandContract({",` name: ${JSON.stringify(t)},`,` extensionName: ${JSON.stringify(e)},`," });",' assert.equal(typeof registered.command.description, "string");',""," // runCommand invokes the handler through pm's real dispatch engine, so this"," // asserts behavior - not just that the command is wired. Replace these"," // assertions as you flesh out your command."," const invocation = await ext.runCommand({",` command: ${JSON.stringify(t)},`," });"," assert.equal(invocation.handled, true);"," // The handler result is typed `unknown`, so deep-equality on the whole"," // structured payload keeps the assertion type-safe without a cast."," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`,...l?[" upper: false,"]:[],' message: "Starter extension scaffold is active.",'," });"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});","",...v,...b,...x,...R,...k,...F,...T,...E,...U,`test(${JSON.stringify(`${e} tears down cleanly via deactivate`)}, async () => {`," // createExtensionTestHarness binds teardown to the same name/layer used for"," // activation, so this proves your `deactivate` hook runs without throwing."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," const teardown = await ext.deactivate();"," // assertExtensionDeactivated throws unless exactly one extension tore down"," // with no failures, so reaching the next line already proves teardown ran."," assertExtensionDeactivated(teardown);"," assert.equal(teardown.deactivated, 1);","});",""].join(`
25
- `)}function $g(e,t,n){if(n==="schema"||n==="profile")return[];if(n==="importers"){let r=`${e.replace(/-/g," ")} items`;return[t,`${r} import`,`${r} export`]}return[t]}var Tg={commands:"starter command",hooks:"starter command and after_command hook",search:"starter command, search provider, and vector-store adapter",importers:"starter command, importer, and exporter",schema:"starter command, custom item type, item field, and migration",profile:"starter command and project profile",renderers:"starter command and toon renderer override",parser:"starter command and parser override",preflight:"starter command and preflight override",services:"starter command and output_format service override"},Og={commands:"`commands`",hooks:"`commands` and `hooks.afterCommand`",search:"`commands`, `searchProviders`, and `vectorStoreAdapters`",importers:"`commands`, `importers`, and `exporters`",schema:"`commands`, `itemTypes`, `itemFields`, and `migrations`",profile:"`commands` and `profiles`",renderers:"`commands` and `renderers`",parser:"`commands` and `parsers`",preflight:"`commands` and `preflights`",services:"`commands` and `services`"};function Dg(e,t,n){let r=n==="parser";return["// The starter command, authored with the `defineCommand` builder so its literal","// name is preserved and the handler `context` is inferred. Exporting it lets you","// unit-test the definition in isolation, apart from the blueprint.","export const pingCommand = defineCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",',...r?[" flags: ["," {",' long: "--shout",',' value_type: "boolean",',' description: "Deprecated alias for --upper; the parser override rewrites it.",'," },"," {",' long: "--upper",',' value_type: "boolean",',' description: "Echo the canonical flag the parser override produces.",'," },"," ],"]:[]," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,",...r?[" upper: context.options.upper === true,"]:[],' message: "Starter extension scaffold is active.",'," }),","});"]}function Pg(e,t,n){let r=[],i=[...Dg(e,t,n)],a=[" commands: [pingCommand],"],o=`${e}-search`,s=`${e}-vector`,c=`${e.replace(/-/g," ")} items`,l=e,d=`${e}s`,u=e.replace(/-/g,""),m=u===l?[]:[u],p=`${e.replace(/-/g,"_")}_note`,f=`${e}-0001-init`;switch(n){case"commands":break;case"hooks":r.push("defineAfterCommandHook"),i.push("","// after_command hooks fire once pm finishes a command, receiving the items it","// mutated. React here - sync to an external system, emit telemetry, or refresh",'// derived context ("project management = context management"). This starter is a',"// documented no-op on the success path; replace the body with your own reaction.","export const afterCommandHook = defineAfterCommandHook((context) => {"," if (!context.ok) {"," return;"," }"," // `context.affected` lists the items pm mutated (id, status, changed_fields):"," // for (const item of context.affected ?? []) { /* ...item.id... */ }","});"),a.push(" hooks: { afterCommand: [afterCommandHook] },");break;case"search":r.push("defineSearchProvider","defineVectorStoreAdapter"),i.push("","// Search providers let packages customize how pm ranks and retrieves project","// context. This starter is deterministic and dependency-free: replace the scoring","// with your domain retrieval, embedding, or rerank logic as the package grows.","export const searchProvider = defineSearchProvider({",` name: ${JSON.stringify(o)},`," query: async (context) => {"," const needle = context.query.toLowerCase();"," const hits = context.documents"," .filter((document) => {",' const title = String(document.metadata.title ?? "").toLowerCase();'," return title.includes(needle);"," })"," .map((document) => ({"," id: document.metadata.id,"," score: 1,",' matched_fields: ["title"],'," }));"," return { hits };"," },"," embed: async (context) => [context.input.length],","});","","// Vector-store adapters let packages own semantic index storage. This starter","// returns a stable in-memory hit so generated tests can exercise the adapter","// without external services.","export const vectorStoreAdapter = defineVectorStoreAdapter({",` name: ${JSON.stringify(s)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),","});"),a.push(" searchProviders: [searchProvider],"," vectorStoreAdapters: [vectorStoreAdapter],");break;case"importers":r.push("defineExporter","defineImporter"),i.push("","// Importers/exporters are the bridge between pm's context graph and another","// project-management system. Keep the starter deterministic so package tests can","// run without touching the network or filesystem; replace these payloads with","// your adapter's real mapping as the package grows.","export const importer = defineImporter(async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,","}));"),a.push(" importers: ["," {",` name: ${JSON.stringify(c)},`," importer,"," options: {",` action: ${JSON.stringify(`${c} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," },"," },"," ],"," exporters: ["," {",` name: ${JSON.stringify(c)},`," exporter,"," options: {",` action: ${JSON.stringify(`${c} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," },"," },"," ],");break;case"schema":r.push("defineItemField","defineItemType","defineMigration"),i.push("","// Schema registrations let a package model its own project domain - the heart of",'// "project management = context management". Item types and fields are GLOBAL',"// contributions, so this package declares no `activation.commands` and pm","// activates it conservatively for every command.","export const noteField = defineItemField({",` name: ${JSON.stringify(p)},`,' type: "string",'," optional: true,","});","","export const itemType = defineItemType({",` name: ${JSON.stringify(l)},`," // Replace with your domain's canonical plural folder name.",` folder: ${JSON.stringify(d)},`,` aliases: ${JSON.stringify(m)},`," // Add field names here to force them at `pm create` time."," required_create_fields: [],","});","","// Migrations let a package evolve stored items as its schema changes. pm runs each","// migration ONCE through the preflight gate (not once per item), passing a context","// that identifies the migration itself: `context.id` is the migration id (not an","// item id), alongside `context.pm_root`. This starter is a deterministic no-op so","// package tests can invoke it without touching the corpus; replace the body with","// your real rewrite.","export const initMigration = defineMigration({",` id: ${JSON.stringify(f)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),","});"),a.push(" itemTypes: [itemType],"," itemFields: [noteField],"," migrations: [initMigration],");break;case"profile":r.push("defineProjectProfile"),i.push("","// A project profile is the broadest customization primitive pm has: one","// declarative bundle of item types, custom statuses, fields, a per-type workflow,","// config knobs, create templates, and package recommendations. Once installed it","// resolves by name through `pm profile list/show/apply`, which stages every","// dimension idempotently like a core archetype. A profile registration is a","// schema+config bundle, so the `schema` capability grants it.","export const starterProfile = defineProjectProfile({",...Hl(e),"});"),a.push(" profiles: [starterProfile],");break;case"renderers":r.push("defineRendererOverride"),i.push("","// Host-enforced command ownership prevents unrelated output from reaching","// this renderer callback; return a string to take over serialization.","export const toonRenderer = defineRendererOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => {",` return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`," },","});"),a.push(" renderers: { toon: toonRenderer },");break;case"parser":r.push("defineParserOverride"),i.push("","// Parser overrides preprocess a command's parsed options BEFORE its handler runs,","// returning a delta - only the keys you set are merged over the parsed input. This","// override is scoped to THIS package's own command; here it rewrites the deprecated","// `--shout` boolean alias to the canonical `--upper` flag.","export const pingParser = defineParserOverride((context) => {"," const options = { ...context.options };"," if (options.shout === true) {"," options.upper = true;"," }"," delete options.shout;"," return { options };","});"),a.push(` parsers: { ${JSON.stringify(t)}: pingParser },`);break;case"preflight":r.push("definePreflightOverride"),i.push("","// Preflight overrides adjust pm's pre-run gate decision (extension migrations +","// item-format checks) for the commands it owns. Scoped ownership composes with","// other packages; overlapping or legacy global ownership is diagnosed.","// Return a delta of the keys you want to change (enforce_item_format_gate,","// run_preflight_item_format_sync, run_extension_migrations,","// enforce_mandatory_migration_gate); returning context.decision unchanged is a","// safe no-op - replace it with your policy, e.g. { run_extension_migrations: false }.","export const preflightOverride = definePreflightOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,","});"),a.push(" preflights: [preflightOverride],");break;case"services":r.push("defineServiceOverride"),i.push("","// Service overrides replace a built-in pm service. The `output_format` service","// renders a command's structured result; returning the payload unchanged passes","// through to pm's default formatting. This override scopes itself to THIS","// package's own command and passes every other command through.","export const outputService = defineServiceOverride((context) => {",` if (context.command !== ${JSON.stringify(t)}) {`," return { handled: false };"," }",` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),a.push(" services: { output_format: outputService },");break}return{builderImports:r,definitions:i,blueprintFields:a}}function Ng(e,t,n){let r=Pg(e,t,n);return[`import { ${["composeExtension","defineCommand","defineExtensionBlueprint",...r.builderImports].sort((a,o)=>a.localeCompare(o)).join(", ")} } from "@unbrained/pm-cli/sdk";`,"",...r.definitions,"","// Declarative authoring: describe WHAT the package registers as a blueprint and","// let `composeExtension` generate the `activate` that wires every surface in order,","// instead of hand-writing each `api.register*` call. `defineExtensionBlueprint`","// contract-checks the blueprint where it is authored. Keep `manifest.json`'s","// `capabilities` equal to the set this blueprint derives.","export const blueprint = defineExtensionBlueprint({",...r.blueprintFields," // `deactivate` is the teardown counterpart to the generated `activate`: pm runs"," // it on host shutdown/reload to release anything the package opened (timers,"," // connections, caches). This starter holds none, so it stays a no-op."," deactivate: () => {},","});","","// `composeExtension(blueprint)` is the package's default export \u2014 the runtime","// `ExtensionModule` pm loads. Guard the blueprint with `assertExtensionPreflight`","// in index.test.ts before publishing.","export default composeExtension(blueprint);",""].join(`
26
- `)}function ya(e,t,n,r){if(n==="commands")return[];let i=`${e}-search`,a=`${e}-vector`,o=`${e.replace(/-/g," ")} items`,s=e,c=`${e}s`,l=`${e.replace(/-/g,"_")}_note`,d=`${e}-0001-init`,u=[" const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${r},`," });"],m=p=>[...u," let deactivated = false;"," try {",...p.map(f=>f===""?f:` ${f}`)," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je];switch(n){case"hooks":return[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,...m([" // assertHook throws unless an after_command hook is registered, so reaching the"," // next line already proves the hook is wired.",` ext.assertHook({ kind: "after_command", extensionName: ${JSON.stringify(e)} });`," // runHook fires the hook through pm's real runner with a synthetic context and"," // returns the warnings it produced; a clean hook returns none."," const warnings = await ext.runHook({",' kind: "after_command",'," context: {",` command: ${JSON.stringify(t)},`," args: [],",' pm_root: "",'," ok: true,"," affected: [],"," },"," });"," assert.deepEqual(warnings, []);"]),"});",""];case"search":return[`test(${JSON.stringify(`${e} registers and invokes search primitives`)}, async () => {`,...m([` ext.assertSearchProvider({ name: ${JSON.stringify(i)}, extensionName: ${JSON.stringify(e)} });`,` ext.assertVectorStoreAdapter({ name: ${JSON.stringify(a)}, extensionName: ${JSON.stringify(e)} });`,""," // The starter provider reads only document title/id, so `settings` is a minimal"," // typed stub and `documents` carry just the fields it inspects."," const query = await ext.runSearchProvider({",` provider: ${JSON.stringify(i)},`,' operation: "query",'," context: {",' query: "sync",',' mode: "semantic",',' tokens: ["sync"],'," options: {},"," settings: {} as PmSettings,"," documents: [",' { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',' { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },'," ] as ItemDocument[],"," },"," });",' assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',""," const embedding = await ext.runSearchProvider({",` provider: ${JSON.stringify(i)},`,' operation: "embed",',' context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },'," });"," assert.deepEqual(embedding, [3]);",""," const vectorHits = await ext.runVectorStoreAdapter({",` adapter: ${JSON.stringify(a)},`,' operation: "query",'," context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },"," });",' assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);']),"});",""];case"importers":return[`test(${JSON.stringify(`${e} registers and invokes import/export primitives`)}, async () => {`,...m([` ext.assertImporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,` ext.assertExporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,""," const imported = await ext.runImporter({",` importer: ${JSON.stringify(o)},`,' options: { source: "tickets" },',' args: ["batch-1"],'," });"," assert.equal(imported.handled, true);",' assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',""," const exported = await ext.runExporter({",` exporter: ${JSON.stringify(o)},`,' options: { destination: "archive" },',' args: ["done"],'," });"," assert.equal(exported.handled, true);",' assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });']),"});",""];case"schema":return[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,...m(Ul({extensionName:e,itemTypeName:s,itemTypeFolder:c,fieldName:l,migrationId:d})),"});",""];case"profile":return[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,...m(zl(e)),"});",""];case"renderers":return[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,...m([" // assertRendererOverride throws unless a renderer is registered for the format,"," // so reaching the next line already proves the wiring.",` const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,' assert.equal(override.format, "toon");',""," // runRendererOverride renders through pm's real runner. The override customizes"," // only THIS package's command output and returns a string the host uses verbatim."," const rendered = await ext.runRendererOverride({",' format: "toon",',` command: ${JSON.stringify(t)},`," result: { ok: true },"," });"," assert.equal(rendered.overridden, true);"," assert.equal(rendered.rendered, JSON.stringify({ ok: true }));",""," // Output for any other command passes through to pm's default renderer."," const passthrough = await ext.runRendererOverride({",' format: "toon",',' command: "list",'," result: { ok: true },"," });"," assert.equal(passthrough.overridden, false);"]),"});",""];case"parser":return[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,...m([" // assertParserOverride throws unless a parser is registered for the command, so"," // reaching the next line already proves the wiring.",` ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,""," // runParserOverride runs the override through pm's real parser runner and returns"," // the rewritten context. The starter rewrites the deprecated `shout` alias to the"," // canonical `upper` flag."," const result = await ext.runParserOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: { shout: true },"," global: {},",' pm_root: "",'," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.context.options, { upper: true });",""," // End to end: feed the rewritten options into the command handler to prove"," // `pm <command> --shout` surfaces the normalized `upper` flag in the result.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`," upper: true,",' message: "Starter extension scaffold is active.",'," });"]),"});",""];case"preflight":return[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,...m([" // assertPreflightOverride throws unless a preflight override is registered, so"," // reaching the next line already proves the wiring.",` ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,""," // runPreflightOverride runs the override through pm's real runner with a synthetic"," // gate decision. The starter echoes the decision unchanged; replace the"," // values/assertions with your real policy."," const decision = {"," enforce_item_format_gate: true,"," run_preflight_item_format_sync: false,"," run_extension_migrations: true,"," enforce_mandatory_migration_gate: false,"," };"," const result = await ext.runPreflightOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: {},"," global: {},",' pm_root: "",'," decision,"," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.decision, decision);"]),"});",""];case"services":return[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,...m([" // assertServiceOverride throws unless a service override is registered for the"," // service, so reaching the next line proves the wiring.",` ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,""," // runServiceOverride runs the override through pm's real service runner. The"," // override customizes only THIS package's command output (handled), passing every"," // other command through (not handled)."," const handled = await ext.runServiceOverride({",' service: "output_format",',` command: ${JSON.stringify(t)},`," payload: { ok: true },"," });"," assert.equal(handled.handled, true);",` assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,""," // Output for any other command passes through to pm's default formatter."," const passthrough = await ext.runServiceOverride({",' service: "output_format",',' command: "list",'," payload: { ok: true },"," });"," assert.equal(passthrough.handled, false);"]),"});",""]}}function Mg(e,t,n){let r=n==="parser",i=JSON.stringify([...Gl[n]].sort());return['import assert from "node:assert/strict";','import { test } from "node:test";','import { assertExtensionDeactivated, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, createExtensionTestHarness } from "@unbrained/pm-cli/sdk/testing";',...n==="search"?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension, { blueprint } from "./index.ts";','import manifest from "./manifest.json" with { type: "json" };',"",...jl,`test(${JSON.stringify(`${e} passes author-time preflight`)}, () => {`," // assertExtensionPreflight is the author-time capstone: it lints the blueprint,"," // synthesizes the least-privilege manifest from `identity`, and checks the version"," // bounds against `target` in one call, throwing on any blocking finding. It returns"," // the full report so you can inspect the derived data."," const report = assertExtensionPreflight(blueprint, {"," identity: {",` name: ${JSON.stringify(e)},`,' version: "0.1.0",',' entry: "./index.ts",'," priority: 0,",` pm_min_version: ${JSON.stringify(vt)},`," },",` target: { pmVersion: ${JSON.stringify(vt)} },`," });"," // Fail the starter suite whenever the checked-in manifest drifts from the"," // capabilities derived from the blueprint."," assertExtensionManifestMatchesBlueprint(manifest, blueprint);"," // The capability set is DERIVED from the blueprint, never hand-synced. Keep"," // manifest.json's `capabilities` equal to this list (set match, sorted).",` assert.deepEqual(report.capabilities, ${i});`,` assert.deepEqual(report.manifest?.capabilities, ${i});`,"});","",`test(${JSON.stringify(`${e} registers and runs its starter command`)}, async () => {`," // createExtensionTestHarness activates the composed module once and binds the"," // assert*/run*/deactivate helpers to the right activation sub-registry, so you"," // never thread activation.registrations vs activation.commands by hand."," // `capabilities` mirrors manifest.json so the in-memory activation grants what the"," // blueprint needs."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${i},`," });"," let deactivated = false;"," try {"," // assertCommandContract throws unless the command is registered, so reaching"," // the next line already proves the wiring; assert on the returned definition"," // to demonstrate inspecting registered metadata.",` const registered = ext.assertCommandContract({ name: ${JSON.stringify(t)} });`,' assert.equal(typeof registered.command.description, "string");',""," // runCommand invokes the handler through pm's real dispatch engine, so this"," // asserts behavior - not just that the command is wired. Replace these"," // assertions as you flesh out your command.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)} });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`,...r?[" upper: false,"]:[],' message: "Starter extension scaffold is active.",'," });"," // deactivate runs pm's real teardown engine over the module; exactly one"," // extension tears down with no failures."," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...je,"});","",...ya(e,t,n,i)].join(`
27
- `)}function Lg(e,t,n){let r=Wl(n,"package"),i=Bl(n,"package");return[`# ${e}`,"","Generated by `pm package init --declarative`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",r,`- \`index.ts\`: the TypeScript manifest entry \u2014 a \`defineExtensionBlueprint\` blueprint (${Tg[n]}) composed into the runtime module by \`composeExtension\`, plus a \`deactivate\` teardown stub.`,"- `index.test.ts`: sample `node:test` suite covering author-time preflight (`assertExtensionPreflight`) and runtime surface invocation/teardown via `createExtensionTestHarness`.",ql,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Declarative Authoring","`index.ts` uses the SDK's declarative authoring loop instead of an imperative","`activate` body. You describe WHAT the package registers as an","`ExtensionBlueprint` and `composeExtension` generates the `activate` that wires","every surface in order:","- The `define*` builders author each surface with literal-type preservation and"," contextual handler inference (`defineCommand`, `defineSearchProvider`,"," `defineItemType`, `defineParserOverride`, ...).","- `defineExtensionBlueprint({ ... })` collects the definitions into the blueprint;",` this starter populates ${Og[n]}. Add more`," fields as the package grows.","- `composeExtension(blueprint)` is the default export \u2014 the runtime module pm"," loads. Its generated `activate` requires exactly the capabilities the blueprint"," derives, so `manifest.json`'s `capabilities` never drift.","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`index.test.ts` exercises both authoring capstones: `assertExtensionPreflight`","(the author-time lint + manifest synthesis + version-compatibility check over the","exported `blueprint`) and `createExtensionTestHarness` (the runtime fixture whose","`assert*`/`run*`/`deactivate` methods bind to the right activation sub-registry).","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.",...i,"","## Compatibility Bounds","`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${_a}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${vt}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
28
- `)}function Fg(e){let t=e,n=e.replace(/-/g,"");return{searchProviderName:`${e}-search`,vectorAdapterName:`${e}-vector`,adapterName:`${e.replace(/-/g," ")} items`,itemTypeName:t,itemTypeFolder:`${e}s`,itemTypeAliases:n===t?[]:[n],fieldName:`${e.replace(/-/g,"_")}_note`,migrationId:`${e}-0001-init`}}function jg(e){return["defineCommand",...e==="hooks"?["defineAfterCommandHook"]:[],...e==="search"?["defineSearchProvider","defineVectorStoreAdapter"]:[],...e==="importers"?["defineImporter","defineExporter"]:[],...e==="schema"?["defineItemType","defineItemField","defineMigration"]:[],...e==="profile"?["defineProjectProfile"]:[],...e==="renderers"?["defineRendererOverride"]:[],...e==="parser"?["defineParserOverride"]:[],...e==="preflight"?["definePreflightOverride"]:[],...e==="services"?["defineServiceOverride"]:[]].join(", ")}function Ug(e,t,n,r){let i=["export const pingCommand = defineCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",',...n==="parser"?[" flags: [",' { long: "--shout", value_type: "boolean", description: "Deprecated alias for --upper." },',' { long: "--upper", value_type: "boolean", description: "Canonical flag the parser produces." },'," ],"," run: (context) => ({ ok: true, command: context.command, upper: context.options.upper === true }),"]:[" run: (context) => ({ ok: true, command: context.command }),"],"});"];return n==="hooks"&&i.push("","export const afterCommandHook = defineAfterCommandHook((context) => {"," if (!context.ok) return;"," // React to context.affected here as your package grows.","});"),n==="search"&&i.push("","export const searchProvider = defineSearchProvider({",` name: ${JSON.stringify(r.searchProviderName)},`," query: async (context) => ({"," hits: context.documents",' .filter((document) => String(document.metadata.title ?? "").toLowerCase().includes(context.query.toLowerCase()))',' .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: ["title"] })),'," }),"," embed: async (context) => [context.input.length],","});","","export const vectorStoreAdapter = defineVectorStoreAdapter({",` name: ${JSON.stringify(r.vectorAdapterName)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),","});"),n==="importers"&&i.push("","export const importer = defineImporter(async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,","}));"),n==="schema"&&i.push("",`export const noteField = defineItemField({ name: ${JSON.stringify(r.fieldName)}, type: "string", optional: true });`,"","export const itemType = defineItemType({",` name: ${JSON.stringify(r.itemTypeName)},`,` folder: ${JSON.stringify(r.itemTypeFolder)},`,` aliases: ${JSON.stringify(r.itemTypeAliases)},`," required_create_fields: [],","});","","export const initMigration = defineMigration({",` id: ${JSON.stringify(r.migrationId)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),","});"),n==="profile"&&i.push("","export const starterProfile = defineProjectProfile({",` name: ${JSON.stringify(e)},`,` title: ${JSON.stringify(`${e} archetype`)},`,' summary: "Starter project profile. Replace these dimensions with your own archetype.",'," types: [",` { name: ${JSON.stringify(r.itemTypeName)}, folder: ${JSON.stringify(r.itemTypeFolder)} },`," ],"," // ...plus statuses, fields, workflows, config, templates, and packages.","});"),n==="renderers"&&i.push("","export const toonRenderer = defineRendererOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => JSON.stringify(context.result),","});"),n==="parser"&&i.push("","export const pingParser = defineParserOverride((context) => {"," const options = { ...context.options };"," if (options.shout === true) options.upper = true;"," delete options.shout;"," return { options };","});"),n==="preflight"&&i.push("","// Return a delta of the gate-decision keys you want to change; returning","// context.decision unchanged is a safe no-op (e.g. { run_extension_migrations: false }).","export const preflightOverride = definePreflightOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,","});"),n==="services"&&i.push("","export const outputService = defineServiceOverride((context) => {",` if (context.command !== ${JSON.stringify(t)}) return { handled: false };`,` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),i}function zg(e,t,n){let r=[];return t==="renderers"&&r.push(' api.registerRenderer("toon", toonRenderer.run, toonRenderer);'),t==="parser"&&r.push(` api.registerParser(${JSON.stringify(e)}, pingParser);`),t==="preflight"&&r.push(" api.registerPreflight(preflightOverride);"),t==="services"&&r.push(' api.registerService("output_format", outputService);'),t==="hooks"&&r.push(" api.hooks.afterCommand(afterCommandHook);"),t==="search"&&r.push(" api.registerSearchProvider(searchProvider);"," api.registerVectorStoreAdapter(vectorStoreAdapter);"),t==="schema"&&r.push(" api.registerItemFields([noteField]);"," api.registerItemTypes([itemType]);"," api.registerMigration(initMigration);"),t==="profile"&&r.push(" api.registerProfile(starterProfile);"),t==="importers"&&r.push(` api.registerImporter(${JSON.stringify(n.adapterName)}, importer, {`,` action: ${JSON.stringify(`${n.adapterName} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," });",` api.registerExporter(${JSON.stringify(n.adapterName)}, exporter, {`,` action: ${JSON.stringify(`${n.adapterName} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," });"),r}function Gg(e,t,n,r="commands",i=!1){let a=`pm-${e}`,o=Gl[r],s=$g(e,t,r),c=`${JSON.stringify({name:e,version:"0.1.0",entry:"./index.ts",manifest_version:_a,pm_min_version:vt,trusted:!0,sandbox_profile:"strict",permissions:{...gg},capabilities:o,...s.length>0?{activation:{commands:s}}:{}},null,2)}
29
- `,l=['import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"","export function activate(api: ExtensionApi): void {",...Ig(e,t,r),"}","","// `deactivate` is the teardown counterpart to `activate`: pm runs it on host","// shutdown/reload (e.g. the MCP server between requests) to release anything","// `activate` opened - timers, connections, caches. This starter holds no such","// resources, so it stays a documented no-op; add cleanup here as you grow.","export function deactivate(): void {}","","export default {"," activate,"," deactivate,","};",""].join(`
30
- `),d=`${JSON.stringify(wg,null,2)}
31
- `,u=bg[r],m=Wl(r,"package"),p=`${JSON.stringify({name:a,version:"0.1.0",private:!0,type:"module",keywords:["pm-package"],engines:{node:hg},scripts:{typecheck:"tsc --noEmit","test:runtime":"node --test",test:"npm run typecheck && npm run test:runtime"},peerDependencies:{"@unbrained/pm-cli":`>=${vt}`},devDependencies:{"@types/node":yg,typescript:_g},pm:{aliases:[e],extensions:["."],docs:["README.md"],examples:["README.md"],catalog:{display_name:e,category:"workflow",summary:"Starter pm package scaffold.",tags:["starter"]}}},null,2)}
32
- `,f=Cg(e,t,r),g=kg[r],h=["node_modules/","*.log","*.tsbuildinfo",""].join(`
33
- `),w=Fg(e),b=["```ts",`import { ${jg(r)} } from "@unbrained/pm-cli/sdk";`,'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"",...Ug(e,t,r,w),"","export function activate(api: ExtensionApi): void {"," api.registerCommand(pingCommand);",...zg(t,r,w),"}","","export function deactivate(): void {}","","export default { activate, deactivate };","```"],x=[`# ${a}`,"","Generated by `pm package init` or `pm extension init`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",m,u,g,ql,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.","","## Authoring With define* Builders","`index.ts` is authored fully in TypeScript so every registration is checked","against the SDK contracts at author time. Use the public SDK authoring","builders for exported definitions you want literal-type preservation,","contextual handler inference, and direct unit tests for:",...b,"The builders return their argument unchanged; runtime validation still lives","in `api.register*`, and behavior validation lives in `sdk/testing`.",...xg[r],...Bl(r,"package"),"","## Compatibility Bounds",`- \`peerDependencies["@unbrained/pm-cli"]\` uses the stable range \`>=${vt}\`. Keep a normal stable range instead of pinning a date ordinal: SemVer excludes prerelease ordinals such as \`2026.7.24-3\`, while daily stable releases continue to satisfy the range.`,"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${_a}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${vt}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
34
- `);return{"package.json":p,"manifest.json":c,"index.ts":i?Ng(e,t,r):l,"index.test.ts":i?Mg(e,t,r):f,"tsconfig.json":d,".gitignore":h,"README.md":i?Lg(a,t,r):x}}async function Jl(e,t="extension",n="commands",r=!1){let i=n.trim().toLowerCase();if(!Fl.includes(i))throw new _(`Unknown scaffold capability "${n}". Supported capabilities: ${Fl.join(", ")}.`,y.USAGE);let a=i;if(r&&t!=="package")throw new _("--declarative scaffolds a package-mode blueprint starter (composeExtension is a runtime SDK import). Use `pm package init`, not `pm extension init`.",y.USAGE);let o=r?"declarative":"imperative",s=e.trim(),c=wn.resolve(process.cwd(),s),l=Rr(wn.basename(c)).replace(/^(?:pm-)+/u,""),d=Rg(l),u=Gg(l,d,t,a,r),m=!1;if(await A(c)){if(!(await yn.stat(c)).isDirectory())throw new _(`Scaffold target "${c}" exists and is not a directory.`,y.CONFLICT)}else await yn.mkdir(c,{recursive:!0}),m=!0;for(let[f,g]of Object.entries(u)){let h=wn.join(c,f);if(!await A(h))continue;if(await yn.readFile(h,"utf8")!==g)throw new _(`Scaffold file "${f}" already exists with different content in "${c}". Choose a new target path or remove conflicting files.`,y.CONFLICT)}let p=[];for(let[f,g]of Object.entries(u)){let h=wn.join(c,f);if(await A(h)){p.push({path:f,status:"unchanged"});continue}await yn.mkdir(wn.dirname(h),{recursive:!0}),await yn.writeFile(h,g,"utf8"),p.push({path:f,status:"created"})}return{extension_name:l,package_name:`pm-${l}`,command_name:d,invocation_command:`pm ${d}`,capability:a,style:o,target_path:c,created_directory:m,files:p}}(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]="536ed530-7726-50ab-bb2d-ace030818f1d")}catch{}})();function Vl(e,t){return`${e}:${S(t)}`}function qg(e,t){let n=[];for(let[r,i]of[["handler",e.commands.handlers],["override",e.commands.overrides]]){let a=new Map;for(let o of i){let s=a.get(o.command)??[];a.set(o.command,[...s,o])}for(let[o,s]of a){if(t!==null&&!s.some(l=>t.has(S(l.name))))continue;let c=s.at(-1);n.push({command:o,surface:r,policy:"last_activated_wins",collision:s.length>1,claimants:s.map(l=>({name:l.name,layer:l.layer,winner:l===c}))})}}return n.sort((r,i)=>r.command.localeCompare(i.command)||r.surface.localeCompare(i.surface))}function Kl(e,t,n){let r=new Set(n.failed.map(l=>Vl(l.layer,l.name))),i=[...t.loaded.map(l=>({name:l.name,layer:l.layer,version:l.version,activation_status:r.has(Vl(l.layer,l.name))?"failed":"ok",surfaces:Ut(n,{extensionName:l.name})})),...t.failed.map(l=>({name:l.name,layer:l.layer,version:"unknown",activation_status:"not_loaded",surfaces:Ut(n,{extensionName:l.name})}))].sort((l,d)=>l.name.localeCompare(d.name)||l.layer.localeCompare(d.layer)),a=typeof e=="string"?S(e):null,o=a===null?null:new Set(t.loaded.filter(l=>S(l.name)===a||typeof l.source_package=="string"&&S(l.source_package)===a||(l.source_aliases??[]).some(d=>S(d)===a)).map(l=>S(l.name)).concat(a)),s=o===null?i:i.filter(l=>o.has(S(l.name))),c=o===null?{}:{extensionNames:[...o]};return{target:typeof e=="string"?e.trim():null,total:s.length,extensions:s,union:Ut(n,c),command_ownership:qg(n,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]="54ce5bae-db04-5c19-81df-093802bf41c7")}catch{}})();function wa(e){return e.map(({layer:t,name:n,error:r})=>({layer:t,name:n,error:r}))}function Dr(e,t,n){let r=S(t),i=n.trim();if(r.length===0||i.length===0)return;let a=e.get(r)??new Set;a.add(i),e.set(r,a)}function Wg(e){let t=new Map,n=new Map;for(let r of e.registrations.commands)Dr(t,r.name,r.command),Dr(n,r.name,r.action);for(let r of e.commands.handlers)Dr(t,r.name,r.command);for(let r of e.commands.overrides)Dr(t,r.name,r.command);return{commandPathsByExtension:t,actionPathsByExtension:n}}function Yl(e){if(!(!e||e.size===0))return[...e].sort((t,n)=>t.localeCompare(n))}function Bg(e){let{enabled:t,normalizedName:n,loadedNames:r,loadFailedNames:i,activationFailedNames:a}=e;return t?i.has(n)||a.has(n)?{runtime_active:!1,activation_status:"failed"}:r.has(n)?{runtime_active:!0,activation_status:"ok"}:{runtime_active:!1,activation_status:"not_loaded"}:{runtime_active:!1,activation_status:"not_loaded"}}function Pr(e,t,n){let r=new Set(t.loaded.map(c=>S(c.name))),i=new Set(t.failed.map(c=>S(c.name))),a=new Set(n.failed.map(c=>S(c.name))),{commandPathsByExtension:o,actionPathsByExtension:s}=Wg(n);return e.map(c=>{let l=S(c.name),d=Yl(o.get(l)),u=Yl(s.get(l)),m={...d?{command_paths:d}:{},...u?{action_paths:u}:{}},p=Bg({enabled:c.enabled,normalizedName:l,loadedNames:r,loadFailedNames:i,activationFailedNames:a});return{...c,...p,...m}})}function Hg(e){let t=0,n=0,r=0;for(let i of e)if(i.startsWith("extension_policy_")){if(t+=1,i.startsWith("extension_policy_violation_")){n+=1;continue}i.startsWith("extension_policy_blocked_")&&(r+=1)}return{warning_count:t,violation_count:n,blocked_count:r}}function se(e,t){return e.vocabulary==="package"?`pm package --${t}`:`pm extension --${t}`}var Ql=new Set(["extension_command_handler_collision","extension_command_override_collision","extension_command_override_handler_overlap","extension_parser_override_collision","extension_preflight_override_collision","extension_renderer_collision","extension_service_override_collision"]);function Jg(e){return Ql.has(ad(e))}function Xl(e){return e==="project"||e==="global"}function ed(e){let t=e.split(":"),n=t[0];if(!n||!Ql.has(n))return null;let r=t.at(-4),i=t.at(-3)?.trim(),a=t.at(-2),o=t.at(-1)?.trim();return!Xl(r)||!Xl(a)||!i||!o?null:{code:n,surface:t.slice(1,-4).join(":")||"global",winner:{layer:r,name:i},displaced:{layer:a,name:o}}}function Vg(e){let t=new Set;for(let n of e){let r=ed(n);r&&(t.add(r.winner.name),t.add(r.displaced.name))}return[...t].sort((n,r)=>n.localeCompare(r))}function va(e,t){let n=e.filter(Jg);if(n.length===0)return null;let r=Vg(n);return`Extension registration collisions or handler/override overlaps detected.${r.length>0?` Conflicting extensions: ${r.join(", ")}.`:""} Single-winner surfaces can hide earlier package behavior. Deactivate one conflicting package with ${t.deactivate}, or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${t.doctor}.`}function Kg(e,t,n,r){let i=t.map(u=>ed(u)).filter(u=>u!==null).sort((u,m)=>`${u.code}:${u.surface}:${u.winner.name}:${u.displaced.name}`.localeCompare(`${m.code}:${m.surface}:${m.winner.name}:${m.displaced.name}`));if(i.length===0)return;let a=e==="global"?"--global":"--project",o=se(r,"deactivate"),s=`${se(r,"doctor")} ${a} --detail deep --trace`,c=new Map(n.map(u=>[S(u.name),u])),l=new Map;for(let u of i)for(let m of[u.winner.name,u.displaced.name]){let p=S(m);l.set(p,(l.get(p)??0)+1)}let d=[...l.entries()].map(([u,m])=>{let p=c.get(u),f=p?.name??u,g=p?.command_paths??[],h=p?.action_paths??[];return{action:"deactivate",extension:f,command:`${o} ${f} ${a}`,affected_collisions:m,feature_loss:{command_paths:[...g].sort((w,v)=>w.localeCompare(v)),action_paths:[...h].sort((w,v)=>w.localeCompare(v))}}}).sort((u,m)=>{let p=m.affected_collisions-u.affected_collisions;if(p!==0)return p;let f=u.feature_loss.command_paths.length+u.feature_loss.action_paths.length,g=m.feature_loss.command_paths.length+m.feature_loss.action_paths.length;return f!==g?f-g:u.extension.localeCompare(m.extension)});return{status:"conflicts_detected",collision_count:i.length,extension_count:l.size,next_best_command:s,collisions:i,remediation_candidates:d}}function td(e){let t=[];for(let n of e){let r=n.error.toLowerCase();(r.includes("cannot find package '@unbrained/pm-cli'")||r.includes('cannot find module "@unbrained/pm-cli"')||r.includes("cannot find module '@unbrained/pm-cli'"))&&t.push(`extension_load_failed_sdk_dependency_missing:${n.name}`),(r.includes("cannot use import statement outside a module")||r.includes("to load an es module")||r.includes("must use import to load es module"))&&t.push(`extension_load_failed_module_mode_mismatch:${n.name}`)}return[...new Set(t)].sort((n,r)=>n.localeCompare(r))}function nd(e=[]){let t=Array.isArray(e)?e:[],n=[];for(let r of t){if(!r||typeof r.name!="string")continue;let i=r.trace?.missing_capability??r.trace?.capability;typeof i=="string"&&i.trim().length>0&&n.push(`extension_capability_missing:${r.name}:${i.trim().toLowerCase()}`)}return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}function rd(e,t){let n=[];for(let r of Ko(e.loaded,t))for(let i of r.unused)n.push(`extension_capability_unused:${r.layer}:${r.name}:${i}`);return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}var Yg=[{matches:e=>e.some(t=>t.startsWith("extension_manifest_")),build:e=>`Run ${se(e.options,"explore")} ${e.scopeFlag} to inspect discovered manifests and directories.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unknown:")),build:()=>`Unknown extension capabilities detected. Allowed capabilities: ${Tn.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_legacy_alias:")),build:()=>"Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."},{matches:e=>e.some(t=>t.startsWith("extension_capability_missing:")),build:e=>`Extension activation failed because code registered a surface missing from manifest capabilities. Run ${se(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unused:")),build:e=>`Extension manifests declare capabilities that are never registered against. Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${se(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace for per-extension registration counts.`},{matches:e=>e.some(t=>t.startsWith("extension_command_definition_legacy_handler_alias:")),build:()=>"Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."},{matches:e=>e.some(t=>t.startsWith("extension_output_service_override_global:")||t.startsWith("extension_output_renderer_override_global:")),build:()=>"Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering."},{matches:e=>e.some(t=>t.startsWith("extension_schema_narrow_activation:")),build:()=>"A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or \u2014 if the schema is intentionally command-scoped \u2014 knowingly ignore this advisory."},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_sdk_dependency_missing:")),build:e=>`Detected extension load failures caused by missing SDK dependency resolution. Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${se(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_module_mode_mismatch:")),build:e=>`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" or use an explicit .mjs entry and rerun ${se(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_pm_min_version_")||t.startsWith("extension_pm_max_version_")),build:e=>`Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${se(e.options,"doctor")} ${e.scopeFlag}.`},{matches:(e,t)=>t.updateCheckFailedTotal>0,build:e=>`Run ${se(e.options,"manage")} ${e.scopeFlag} after validating network and repository access.`},{matches:e=>e.some(t=>t.startsWith("extension_manager_state_")),build:e=>`Review and repair ${e.scope} managed extension state file if schema/read warnings persist.`},{matches:(e,t)=>t.policyWarningCount>0,build:()=>"Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces."}];function Xg(e){let{normalizedWarnings:t,options:n,scope:r,scopeFlag:i,updateCheckFailedTotal:a,policyWarningCount:o,updateHealthPartial:s,skippedUnmanagedTotal:c,skippedNonGithubTotal:l,updateAvailableTotal:d}=e,u=[],m={options:n,scope:r,scopeFlag:i,updateCheckFailedTotal:a,policyWarningCount:o};if(t.length>0){let p=va(t,{deactivate:`${se(n,"deactivate")} <name> ${i}`,doctor:`${se(n,"doctor")} ${i} --detail deep --trace`});p&&u.push(p);for(let f of Yg)f.matches(t,m)&&u.push(f.build(m))}return s?u.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${se(n,"manage")} ${i} --fix-managed-state (or ${se(n,"adopt-all")} ${i}, ${se(n,"adopt")} <name> ${i}, or reinstall via ${se(n,"install")} ${i} <source>).`):c>0&&u.push(`Loaded unmanaged extensions are currently treated as informational. Use ${se(n,"manage")} ${i} --fix-managed-state to adopt them for update checks.`),l>0&&u.push("Non-GitHub managed extensions are skipped by update checks. Use doctor output for non-update diagnostics."),d>0&&u.push(`Update available managed extensions via ${se(n,"install")} ${i} <source>.`),u.length===0&&u.push(`No immediate action required. Re-run ${se(n,"manage")} ${i} after extension changes.`),u}function Nr(e,t,n,r={}){let i=[...new Set(t)].sort((E,U)=>E.localeCompare(U)),a=n.filter(E=>E.managed).length,o=n.filter(E=>E.enabled).length,s=n.filter(E=>E.active).length,c=n.filter(E=>E.update_available===!0).length,l=n.filter(E=>E.managed===!1),d=l.filter(E=>Zl(E)).map(E=>E.name).sort((E,U)=>E.localeCompare(U)),u=l.filter(E=>!Zl(E)).map(E=>E.name).sort((E,U)=>E.localeCompare(U)),m={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(let E of n)m[E.update_check_status]+=1;let p=m.failed,f=m.skipped_unmanaged,g=m.skipped_non_github,h=u.length>0,w=h?"partial":"full",v=h?[`extension_update_health_partial_coverage:skipped_unmanaged:${u.length}`]:[],b=[...new Set([...i,...v])].sort((E,U)=>E.localeCompare(U)),x=[...new Set(b.map(E=>ad(E)))].sort((E,U)=>E.localeCompare(U)),R=Hg(b),k=e==="global"?"--global":"--project",F=Kg(e,i,n,r),T=Xg({normalizedWarnings:i,options:r,scope:e,scopeFlag:k,updateCheckFailedTotal:p,policyWarningCount:R.warning_count,updateHealthPartial:h,skippedUnmanagedTotal:f,skippedNonGithubTotal:g,updateAvailableTotal:c});return{status:b.length===0?"ok":"warn",warning_count:b.length,warning_codes:x,warnings:b,policy_warning_count:R.warning_count,policy_violation_count:R.violation_count,policy_blocked_count:R.blocked_count,total_extensions:n.length,managed_total:a,enabled_total:o,active_total:s,update_available_total:c,update_health_coverage:w,update_health_partial:h,unmanaged_loaded_extension_count:l.length,unmanaged_loaded_extensions:l.map(E=>E.name).sort((E,U)=>E.localeCompare(U)),unmanaged_expected_extension_count:d.length,unmanaged_expected_extensions:d,unmanaged_action_required_extension_count:u.length,unmanaged_action_required_extensions:u,update_check_status_totals:m,update_check_failed_total:p,top_warnings:b.slice(0,8),remediation:T,...F?{collision_plan:F}:{}}}function id(e){if(!e||e.trim().length===0)return"summary";let t=e.trim().toLowerCase();if(t==="summary"||t==="deep")return t;throw new _(`Invalid --detail value "${e}". Expected summary or deep.`,y.USAGE)}function ad(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function vn(e){let t=new Set,n=[];for(let r of e){let i=(()=>{let a=go(r);return a?[a]:_o(r)})();for(let a of i){let o=`${a.layer}:${a.name}:${a.capability}`;t.has(o)||(t.add(o),n.push(a))}}return n}function bn(){return{version:On.version,capabilities:[...On.capabilities],legacy_aliases:{...On.legacy_aliases}}}function Zl(e){let t=S(e.name),n=S(e.directory);return t.startsWith("builtin-")?!0:n==="beads"||n==="todos"}function od(e,t,n,r,i){if(e!=="project"||i)return{warnings:[],summary:{active_project_count:0,loaded_project_count:0,active_project_names:[],loaded_project_names:[],missing_active_project_names:[]}};let a=[...new Set(t.filter(d=>d.active).map(d=>S(d.name)))].sort((d,u)=>d.localeCompare(u)),o=[...new Set(n.filter(d=>d.layer==="project").map(d=>S(d.name)))].sort((d,u)=>d.localeCompare(u)),s=new Set(r.map(d=>S(d.name))),c=a.filter(d=>!o.includes(d)&&!s.has(d)).sort((d,u)=>d.localeCompare(u));return{warnings:c.length>0?[`extension_doctor_consistency_active_not_loaded:${c.join(",")}`]:[],summary:{active_project_count:a.length,loaded_project_count:o.length,active_project_names:a,loaded_project_names:o,missing_active_project_names:c}}}import{randomUUID as Zg}from"node:crypto";import ne from"node:fs/promises";import Qg from"node:os";import J from"node:path";(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]="263602a2-c000-5df7-80d2-6f095985496f")}catch{}})();var sd=3,e_=120,cd=250,t_=12e4,n_=new Set(["EEXIST","ENOTEMPTY","ENOENT"]),ld=e=>typeof e=="object"&&e!==null&&"code"in e?e.code:void 0,dd=e=>n_.has(String(ld(e))),Mr=(e,t)=>ld(e)===t,ud=e=>new Promise(t=>{setTimeout(t,e)}),md=async e=>{let t=J.join(e,"package.json");await A(t)||await ne.writeFile(t,`${JSON.stringify({type:"module"},null,2)}
35
- `,"utf8")},pd=async e=>{let t=Se(import.meta.url,["../../.."]),n=J.join(e,"node_modules","@unbrained"),r=J.join(n,"pm-cli");await ne.mkdir(n,{recursive:!0}),await ne.rm(r,{recursive:!0,force:!0}),await ne.symlink(t,r,process.platform==="win32"?"junction":"dir")},ba=async e=>{let t=J.resolve(e),n=J.dirname(t),r=J.parse(n).root,i=await ne.realpath(r).catch(()=>r),a=J.relative(r,n),o=a===""?[]:a.split(J.sep);for(let[s,c]of o.entries()){let l=J.join(i,c);try{i=await ne.realpath(l)}catch{i=J.join(i,...o.slice(s));break}}return J.join(i,J.basename(t))},fd=async(e,t,n,r=Qg.tmpdir())=>{let i=J.resolve(e),a=await ne.realpath(i).catch(()=>i),o=await ba(t);if(a===o)return;if(!_e(a,o)){await n(e,t,{recursive:!0,force:!0});return}let s=m=>{let p=J.resolve(m);if(p!==i&&!_e(i,p))return!1;let f=J.resolve(a,J.relative(i,p));if(f===o||_e(o,f))return!1;let h=J.relative(a,f).split(J.sep);return h.some(w=>w==="node_modules"||w.startsWith(".pm-extension-install-backup-"))?!1:h[0]!==".agents"},c=await ne.realpath(J.resolve(r)).catch(()=>ba(r)),l=_e(a,c)?J.dirname(a):c;if(_e(a,l))throw new _(`Extension source "${e}" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,y.USAGE,{code:"extension_install_source_contains_destination"});let d=await ne.mkdtemp(J.join(l,"pm-extension-copy-")),u=J.join(d,"extension");try{await n(e,u,{recursive:!0,force:!0,filter:s}),await n(u,t,{recursive:!0,force:!0})}finally{await ne.rm(d,{recursive:!0,force:!0})}},hd=async(e,t,n=ne.cp)=>{for(let r=1;r<=sd;r+=1)try{await ne.rm(t,{recursive:!0,force:!0}),await fd(e,t,n);return}catch(i){if(!dd(i)||r===sd)throw i;await ud(cd)}},ka=async e=>{let t;try{t=await ne.readFile(J.join(e,"owner.json"),"utf8")}catch(i){if(!Pn(i))throw i;return null}let n;try{n=JSON.parse(t)}catch{return null}if(typeof n!="object"||n===null||!("token"in n))return null;let r=n.token;return typeof r=="string"&&r.length>0?r:null},gd=async(e,t)=>await ka(e)!==t?!1:(await ne.rm(e,{recursive:!0,force:!0}),!0),r_=async(e,t)=>{let n;try{n=await ne.stat(e)}catch{return!1}if(Date.now()-n.mtimeMs<=t)return!1;let r=await ka(e);return r===null?(await ne.rm(e,{recursive:!0,force:!0}),!0):gd(e,r)},i_=(e,t,n)=>{let r=Promise.resolve(),i=setInterval(()=>{r=r.then(async()=>{if(await ka(e)!==t)return;let a=new Date;await ne.utimes(e,a,a)}).catch(()=>{})},n);return i.unref(),async()=>{clearInterval(i),await r}},a_=async(e,t)=>{await ne.mkdir(e);try{await ne.writeFile(J.join(e,"owner.json"),`${JSON.stringify(t,null,2)}
36
- `,"utf8")}catch(n){throw await ne.rm(e,{recursive:!0,force:!0}).catch(()=>{}),n}},o_=async(e,t,n,r,i)=>{for(let a=1;a<=n;a+=1)try{return await a_(e,t),!0}catch(o){if(!Mr(o,"EEXIST"))throw o;await r_(e,i)?a-=1:await ud(r)}return!1},xa=async(e,t,n,r)=>{let i=J.join(e,"runtime","extension-install-locks"),a=J.join(i,"scope.lock");await ne.mkdir(i,{recursive:!0});let{attempts:o=e_,delay_ms:s=cd,stale_ms:c=t_,heartbeat_ms:l}=r??{};if(![o,s,c,l].filter(w=>w!==void 0).every(Number.isFinite))throw new _("Extension install lock timings must be finite numbers.",y.USAGE);let d=Math.max(1,Math.floor(o)),u=Math.max(0,Math.floor(s)),m=Math.floor(c),p=Math.floor(l??m/3);if(m<=0||p<=0||p>=m)throw new _("Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.",y.USAGE);let f={pid:process.pid,token:Zg(),created_at:$(),destination:t};if(!await o_(a,f,d,u,m))throw new _(`Timed out waiting for extension install lock for "${t}".`,y.CONFLICT);let h=i_(a,f.token,p);try{return await n()}finally{await h(),await gd(a,f.token).catch(()=>!1)}};(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]="4d3c62e9-9116-5cdc-bbda-48bbd2e39476")}catch{}})();var _d=async(e,t,n)=>{if(!Number.isInteger(t)||t<1)throw new RangeError("concurrency must be a positive integer");let r=new Array(e.length),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,r[o]=await n(e[o])}});return await Promise.all(a),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]="b17dfc10-9e07-5912-b294-c5663133f192")}catch{}})();function yd(e,t){let n=S(e),r=t.find(i=>S(i.name)===n);return{command_paths:[...r?.command_paths??[]].sort((i,a)=>i.localeCompare(a)),action_paths:[...r?.action_paths??[]].sort((i,a)=>i.localeCompare(a))}}(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]="0dc7b063-dc72-595f-8e40-8a06f9db69e1")}catch{}})();function wd(e,t){let n=new Set((t?.loaded??[]).flatMap(a=>(a.activation?.commands?.length??0)>0?[`${a.layer}:${S(a.name)}`]:[])),r=e.services.overrides.filter(a=>a.service==="output_format").filter(a=>!n.has(`${a.layer}:${S(a.name)}`)).map(a=>`extension_output_service_override_global:${a.service}:${a.layer}:${a.name}`),i=e.renderers.overrides.filter(a=>(a.commands?.length??0)===0&&a.resultDiscriminator===void 0).map(a=>`extension_output_renderer_override_global:${a.format}:${a.layer}:${a.name}`);return[...new Set([...r,...i])].sort((a,o)=>a.localeCompare(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]="17145dd7-3938-5f20-b5b5-49f8d38d3d8d")}catch{}})();var vd=e=>[...e.registrations.item_fields.flatMap(t=>t.fields.map(n=>({layer:t.layer,extension:t.name,field:n.name}))),...e.registrations.profiles.flatMap(t=>t.profile.fields.map(n=>({layer:t.layer,extension:t.name,field:n.key??""})))].flatMap(t=>{let n=Gn(t.field);return n?[`extension_custom_field_mcp_input_collision:${t.layer}:${t.extension}:${n.field}:${n.property}:${n.owner}:use=${n.nested_path}`]:[]}).filter((t,n,r)=>r.indexOf(t)===n).sort((t,n)=>t.localeCompare(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]="ccb857a5-045d-57a7-91d2-b761225fe53a")}catch{}})();var s_=1e4,c_=(e,t,n)=>{let r=e.split(/\r?\n/).map(o=>o.trim()).filter(Boolean).map(o=>{let[s,c=""]=o.split(/\s+/);return{commit:s,ref:c}}),i=r.find(o=>o.ref.endsWith("^{}"))??r[0];if(!i)return{checked_at:n,available:null,error:"no_remote_reference_found"};let a=t?.trim();return a?{checked_at:n,remote_commit:i.commit,available:i.commit!==a}:{checked_at:n,remote_commit:i.commit,available:null,error:"missing_installed_commit"}},bd=async(e,t=$r)=>{let n=$();if(e.kind!=="github"||!e.repository)return{checked_at:n,available:null,error:"not_a_github_managed_source"};try{let r=[e.ref?.trim(),"HEAD"].find(Boolean),i=await t(["ls-remote",e.repository,r,`${r}^{}`],void 0,s_);return c_(i,e.commit,n)}catch(r){return{checked_at:n,available:null,error:r instanceof Error?r.message:String(r)}}};import l_ from"node:fs/promises";import d_ from"node:path";(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]="56290db9-933c-590d-8b9f-df62ff45e515")}catch{}})();function Sa(e){return d_.join(e,"extension-migrations.json")}function kd(e,t){let n=e.definition.id;return typeof n=="string"&&n.trim().length>0?n.trim():`migration-${String(t+1).padStart(3,"0")}`}function xd(e,t){return`${e.layer}:${e.name}:${t}`}async function u_(e){let t=Sa(e);if(!await A(t))return{version:1,updated_at:"",entries:[]};let n=JSON.parse(await l_.readFile(t,"utf8"));return{version:1,updated_at:typeof n.updated_at=="string"?n.updated_at:"",entries:Array.isArray(n.entries)?n.entries.filter(r=>typeof r?.key=="string"&&(r.status==="applied"||r.status==="failed")):[]}}async function Ea(e,t){let n=await u_(e),r=new Map(n.entries.map(i=>[i.key,i]));return t.forEach((i,a)=>{let o=kd(i,a),s=r.get(xd(i,o));s&&(i.definition.status=s.status,s.status==="failed"?i.definition.reason=s.error:(delete i.definition.reason,delete i.definition.error,delete i.definition.message))}),n}async function m_(e){let t=await Ea(e.pmRoot,e.migrations),n=new Map(t.entries.map(d=>[d.key,d])),r=[],i=!1,a=e.migrations.map((d,u)=>({migration:d,index:u})).filter(({migration:d})=>e.scope===void 0||d.layer===e.scope);for(let{migration:d,index:u}of a){let m=kd(d,u),p=xd(d,m),f=n.get(p),g=String(d.definition.status??"pending").toLowerCase(),h=f?.status??(g==="applied"||g==="failed"?g:"pending");if(h==="applied"){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"skipped"});continue}if(e.dryRun===!0){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"pending"});continue}let w=d.runtime_definition?.run??d.definition.run;if(typeof w!="function"){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"pending"});continue}let v=new Date().toISOString();try{await Promise.resolve(w({id:m,command:"migration",layer:d.layer,extension:d.name,pm_root:e.pmRoot,status:h}));let b={key:p,layer:d.layer,extension:d.name,id:m,status:"applied",attempted_at:v};n.set(p,b),d.definition.status="applied",delete d.definition.reason,delete d.definition.error,delete d.definition.message,r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"applied"}),i=!0}catch(b){let x=b instanceof Error?b.message:String(b),R={key:p,layer:d.layer,extension:d.name,id:m,status:"failed",attempted_at:v,error:x};n.set(p,R),d.definition.status="failed",d.definition.reason=x,r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"failed",error:x}),i=!0}}if(i){let d=await I(e.pmRoot),u={version:1,updated_at:new Date().toISOString(),entries:[...n.values()].sort((m,p)=>m.key.localeCompare(p.key))};await Zn({pmRoot:e.pmRoot,filePath:Sa(e.pmRoot),raw:`${JSON.stringify(u,null,2)}
37
- `,op:"extension_migrations_apply",author:e.author,lockTtlSeconds:d.locks.ttl_seconds,lockWaitMs:d.locks.wait_ms})}let o=r.filter(d=>d.outcome==="pending").length,s=r.filter(d=>d.outcome==="applied").length,c=r.filter(d=>d.outcome==="skipped").length,l=r.filter(d=>d.outcome==="failed").length;return{ok:l===0,dry_run:e.dryRun===!0,state_path:Sa(e.pmRoot),total:r.length,pending_count:o,applied_count:s,skipped_count:c,failed_count:l,migrations:r}}async function Sd(e){let t=await I(e.resolvedRoots.settings_root),n=await De({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),r=await Pe(n);e.warnings.push(...n.warnings,...r.warnings);let i=await m_({pmRoot:e.resolvedRoots.pm_root,migrations:r.registrations.migrations,author:typeof e.global.author=="string"&&e.global.author.trim().length>0?e.global.author.trim():"pm-extension-migration",dryRun:e.options.dryRun===!0,...e.scope==="global"?{scope:"global"}:{}});return e.withResult({migration:i,load_failure_count:n.failed.length,activation_failure_count:r.failed.length},i.ok)}(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]="39bc7f14-2d32-5b58-97ab-647f9f238273")}catch{}})();async function Ed(e,t,n){let r=typeof t=="string"?null:await gn(e),i=r===null?null:e.trim().toLowerCase(),a=i===null?null:await El(i),o=Or(r??e,{forceGithub:typeof t=="string",ref:n}),s=i===null?null:await Il(e);return{bundledAliasName:i,bundledPackageName:a,installSource:o,sourceResolution:{requested:e,selected:{kind:i===null?o.kind:"builtin",input:i??o.input,...a===null?{}:{package:a}},ambiguous:s!==null,precedence:"bundled_alias_before_installed_npm",candidates:[...i===null?[]:[{kind:"builtin",input:i,...a===null?{}:{package:a},command:`pm install ${i}`}],...s===null?[]:[{kind:"npm",input:`npm:${s.package}`,package:s.package,...s.version===void 0?{}:{version:s.version},directory:s.directory,command:`pm install npm:${s.package}`}]]}}}import bt from"node:fs/promises";import p_ from"node:path";(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]="98b47a2f-d48a-5c90-8b88-3f33bdd1c826")}catch{}})();var Aa=async e=>bt.readFile(e).catch(t=>{if(Mr(t,"ENOENT"))return null;throw t}),Ad=async(e,t,n,r,i)=>{let a=pn(e),o=K(t),[s,c]=await Promise.all([Aa(a),Aa(o)]);return r&&await bt.cp(n,i,{recursive:!0,force:!0}),{backupDirectory:i,destinationDirectory:n,destinationExists:r,managedStatePath:a,managedStateContents:s,settingsPath:o,settingsContents:c}},Rd=async e=>{await bt.rm(e.destinationDirectory,{recursive:!0,force:!0}),e.destinationExists&&await bt.cp(e.backupDirectory,e.destinationDirectory,{recursive:!0,force:!0});for(let[t,n]of[[e.managedStatePath,e.managedStateContents],[e.settingsPath,e.settingsContents]])n===null?await bt.rm(t,{force:!0}):(await bt.mkdir(p_.dirname(t),{recursive:!0}),await bt.writeFile(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]="8b0fbe09-2221-5b8e-8712-90a83df19306")}catch{}})();var f_=4,Td=[["install","install","--install"],["uninstall","uninstall","--uninstall"],["explore","explore","--explore"],["list","explore","--explore"],["manage","manage","--manage"],["describe","describe","--describe"],["reload","reload","--reload"],["doctor","doctor","--doctor"],["catalog","catalog","--catalog"],["init","init","--init"],["scaffold","init","--scaffold"],["adopt","adopt","--adopt"],["adopt-all","adopt-all","--adopt-all"],["activate","activate","--activate"],["deactivate","deactivate","--deactivate"],["migrate","migrate","--migrate"]],h_=Td.map(([,,e])=>e).filter((e,t,n)=>n.indexOf(e)===t).join(", "),g_={install:"--install",uninstall:"--uninstall",explore:"--explore",manage:"--manage",describe:"--describe",reload:"--reload",doctor:"--doctor",catalog:"--catalog",adopt:"--adopt","adopt-all":"--adopt-all",activate:"--activate",deactivate:"--deactivate",migrate:"--migrate",init:"--init"},__="__pm_native_output",y_=["trusted_extensions","allowed_extensions","blocked_extensions","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],Od=["allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],w_=["disabled","require_trusted","require_provenance"],Dd={mode:"off",trust_mode:"off",require_provenance:!1,trusted_extensions:[],default_sandbox_profile:"none",allowed_extensions:[],blocked_extensions:[],allowed_capabilities:[],blocked_capabilities:[],allowed_surfaces:[],blocked_surfaces:[],allowed_commands:[],blocked_commands:[],allowed_actions:[],blocked_actions:[],allowed_services:[],blocked_services:[],extension_overrides:[]},v_=e=>{let t=e??Dd,n={};for(let r of y_)n[r]=be(t[r]??[]);return n},b_=(e,t)=>{for(let n of Od)t[n].length>0&&(e[n]=t[n]);return e},k_=(e,t)=>{for(let n of w_)t[n]===!0&&(e[n]=!0);return t.sandbox_profile&&(e.sandbox_profile=t.sandbox_profile),e},x_=e=>{let t={};for(let n of Od)t[n]=be(e[n]??[]);return t},S_=e=>{let t=typeof e.name=="string"?e.name.trim():"";return t.length===0?null:b_(k_({name:t},e),x_(e))},E_=e=>(e??[]).map(t=>S_(t)).filter(t=>t!==null).sort((t,n)=>t.name.localeCompare(n.name)),A_=e=>{let t=Object.assign({},Dd,e??{}),n=v_(e),r=E_(t.extension_overrides);return{mode:t.mode,trust_mode:t.trust_mode,require_provenance:t.require_provenance===!0,trusted_extensions:n.trusted_extensions,default_sandbox_profile:t.default_sandbox_profile,allowed_extensions:n.allowed_extensions,blocked_extensions:n.blocked_extensions,allowed_capabilities:n.allowed_capabilities,blocked_capabilities:n.blocked_capabilities,allowed_surfaces:n.allowed_surfaces,blocked_surfaces:n.blocked_surfaces,allowed_commands:n.allowed_commands,blocked_commands:n.blocked_commands,allowed_actions:n.allowed_actions,blocked_actions:n.blocked_actions,allowed_services:n.allowed_services,blocked_services:n.blocked_services,extension_overrides:r}},Pd=async(e,t)=>{let n=[t],r=await Al(t);r&&n.push(r);let i=[...new Set(n.map(a=>S(a)).filter(a=>a.length>0))];for(let a of i){let o=e.find(c=>S(c.name)===a);if(o)return o;let s=e.find(c=>S(c.directory)===a);if(s)return s}},Nd=(e,t)=>{let n=t.trim(),r=new Set(be(e.extensions.enabled));return new Set(be(e.extensions.disabled)).has(n)?!1:r.size===0?!0:r.has(n)},Md=(e,t)=>{let n=t.trim(),r=new Set(be(e.extensions.enabled)),i=new Set(be(e.extensions.disabled)),a=[...r],o=[...i];return i.delete(n),r.size>0&&r.add(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},R_=(e,t)=>{let n=t.trim(),r=new Set(be(e.extensions.enabled)),i=new Set(be(e.extensions.disabled)),a=[...r],o=[...i];return r.delete(n),i.add(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},I_=(e,t)=>{let n=t.trim(),r=new Set(be(e.extensions.enabled)),i=new Set(be(e.extensions.disabled)),a=[...r],o=[...i];return r.delete(n),i.delete(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},C_=e=>{let t=e.trim().toLowerCase(),n=Math.min(2,Math.max(1,Math.ceil(t.length/4))),r=Td.map(([i,a,o])=>({action:a,flag:o,distance:ho(t,i,n)})).filter(i=>i.distance!==null).sort((i,a)=>i.distance-a.distance)[0];return r?{action:r.action,flag:r.flag}:null},$_=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=C_(e);if(!r)return new _(`One action flag is required. Use one of: ${h_}. Bare \`pm package\` and \`pm extension\` default to --explore.`,y.USAGE);let i=`pm ${n} ${r.flag}`;return ms({command_path:n,display_name:`${n} lifecycle`,token_kind:"action",token:e,allowed:Object.keys(Ld),retry_command:i,message_suffix:`. Did you mean "${r.flag}"?`,fallback_candidates:[{source:"lifecycle_action",command:i,reason:`nearest lifecycle action for "${e}"`}]})},T_=[["install","install"],["uninstall","uninstall"],["explore","explore"],["manage","manage"],["describe","describe"],["reload","reload"],["doctor","doctor"],["catalog","catalog"],["init","init"],["scaffold","init"],["adopt","adopt"],["adoptAll","adopt-all"],["activate","activate"],["deactivate","deactivate"],["migrate","migrate"]],Ld={doctor:"doctor",reload:"reload",catalog:"catalog",init:"init",scaffold:"init",explore:"explore",manage:"manage",migrate:"migrate",list:"explore","":"explore"},O_=e=>Ld[e]??null,D_=(e,t)=>{let n=[...new Set(T_.filter(([r])=>t[r]===!0).map(([,r])=>r))];if(n.length===0){if(e===void 0)return"explore";let r=O_(e.trim().toLowerCase());if(r)return r;throw $_(e,t)}if(n.length>1)throw new _("Extension action flags are mutually exclusive.",y.USAGE);return n[0]},P_=e=>{let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new _('Options "--project/--local" and "--global" are mutually exclusive.',y.USAGE);return n?"global":"project"},N_=[e=>e?null:{status:"skipped_unmanaged",reason:"extension_not_managed"},e=>e&&e.source.kind!=="github"?{status:"skipped_non_github",reason:`managed_source_kind_${e.source.kind}`}:null,e=>{let t=typeof e?.update_error=="string"?e.update_error.trim():"";return t.length>0?{status:"failed",reason:t}:null},e=>{let t=e;return(typeof t.last_update_check_at=="string"?t.last_update_check_at.trim():"").length===0?null:{status:"checked",reason:{true:"update_available",false:"up_to_date"}[String(t.update_available)]??"checked_without_commit_baseline"}}],Fd=e=>{for(let t of N_){let n=t(e);if(n)return n}return{status:"not_checked",reason:"no_update_check_recorded"}},jd=(e,t,n,r)=>{let i=n??{};return{name:e.name,directory:e.directory,version:e.version,entry:e.entry,scope:t,active:e.enabled,enabled:e.enabled,runtime_active:null,activation_status:"unknown",contributions:i.contributions,managed:!!n,source:i.source,update_available:i.update_available,last_update_check_at:i.last_update_check_at,last_update_remote_commit:i.last_update_remote_commit,update_error:i.update_error,update_check_status:r.status,update_check_reason:r.reason}},M_=(e,t,n,r)=>{let i=Object.assign({name:e,manifest_version:"unknown",manifest_entry:"unknown"},r),a=r?Nd(n,r.name):!1;return{warning:`extension_manifest_missing:${t}:${e}`,summary:jd({name:i.name,directory:e,version:i.manifest_version,entry:i.manifest_entry,enabled:a},t,r,Fd(r))}},L_=async(e,t,n,r,i,a)=>{let o=Ae.join(e,t),s=Ae.join(o,"manifest.json"),c=a.get(S(t));if(!await A(s))return M_(t,n,r,c);let l=Symbol("invalid-extension-manifest-json"),d=await ct.readFile(s,"utf8").then(p=>JSON.parse(p)).catch(()=>l);if(d===l)return{warning:`extension_manifest_invalid_json:${n}:${t}`};let u=la(d);if(!u)return{warning:`extension_manifest_invalid:${n}:${t}`};let m=i.get(S(u.name))??a.get(S(t));return{summary:jd({name:u.name,directory:t,version:u.version,entry:u.entry,enabled:Nd(r,u.name)},n,m,Fd(m))}},Ue=async(e,t,n,r)=>{if(!await A(e))return{extensions:[],warnings:[]};let a=(await ct.readdir(e,{withFileTypes:!0})).filter(d=>d.isDirectory()).map(d=>d.name).sort((d,u)=>d.localeCompare(u)),o=new Map(r.entries.map(d=>[S(d.name),d])),s=new Map(r.entries.map(d=>[S(d.directory),d])),c=[],l=[];for(let d of a){let u=await L_(e,d,t,n,o,s);u.warning&&c.push(u.warning),u.summary&&l.push(u.summary)}return{extensions:l.sort((d,u)=>d.name.localeCompare(u.name)),warnings:c.sort((d,u)=>d.localeCompare(u))}},F_=Zo(),j_=(e,t)=>[t.package,t.kind==="builtin"?t.name:void 0].find(n=>n?.trim())?.trim()??e,U_=(e,t,n,r)=>{let i=n.command_paths.map(s=>`pm ${s} --help`),a=r?.error.toLowerCase().includes("@unbrained/pm-cli")===!0,o=n.command_paths.length>0?[...i]:["Run pm package doctor --project --detail deep if expected package commands are missing."];return a&&o.unshift("Install @unbrained/pm-cli in the target workspace so declarative package runtime imports resolve, then reinstall the package."),{package_name:j_(e,t),extension_name:e,command_paths:n.command_paths,action_paths:n.action_paths,help_commands:i,next_steps:o,...a?{sdk_dependency_status:"missing"}:{}}},z_=e=>{let t=e.trace,n={layer:e.layer,name:e.name,entry_path:e.entry_path,error:e.error};return t&&(n.trace=Object.fromEntries(Object.entries(t).filter(([,r])=>r!==void 0)),t.missing_capability&&(n.missing_capability=t.missing_capability),t.hint&&(n.hint=t.hint)),n},Ud=e=>e.map(t=>z_(t)).sort((t,n)=>`${t.layer}:${t.name}`.localeCompare(`${n.layer}:${n.name}`)),zd=(e,t,n)=>{let r=S(e);return t.find(i=>(n===void 0||i.layer===n)&&S(i.name)===r)},G_=(e,t,n,r)=>n.find(a=>a.scope===t&&S(a.name)===S(e))?.activation_status??(r?"failed":"unknown"),Gd=(e,t,n,r,i)=>F_.enqueue(async()=>{let a=process.env.PM_CLI_PACKAGE_ROOT,o=await ct.mkdtemp(Ae.join(t,".pm-module-graph-"));process.env.PM_CLI_PACKAGE_ROOT=Se(import.meta.url,["../.."]);try{let s=await De({pmRoot:e,settings:n,cwd:process.cwd(),noExtensions:i.noExtensions===!0,reload_token:pi(),cache_bust:!0,module_graph_snapshot_root:o}),c=await Pe({...s}),l=[...s.failed.map(u=>({layer:u.layer,name:u.name,entry_path:u.entry_path,error:u.error})),...Ud(c.failed)],d=Object.fromEntries(s.loaded.map(u=>[S(u.name),Co(Ut(c,{extensionName:u.name}))]));return{installed:Pr(r,s,c),warnings:[...s.warnings,...c.warnings],activation_failures:l,extensions_disabled:s.disabled_by_flag,item_type_registrations:c.registrations.item_types,contribution_inventories:d}}finally{await ct.rm(o,{recursive:!0,force:!0}),a===void 0?delete process.env.PM_CLI_PACKAGE_ROOT:process.env.PM_CLI_PACKAGE_ROOT=a}}),Ia=async(e,t,n,r)=>{let i=n.filter(c=>!c.managed),a=[...i].sort((c,l)=>{let d=c.name.localeCompare(l.name);return d!==0?d:c.directory.localeCompare(l.directory)}),o=r,s=[];for(let c of a){let l=Ae.join(e,c.directory),d=await Bt(l),u=$(),m={kind:"local",input:c.name,location:l};o=hn(o,{name:d.manifest.name,directory:c.directory,scope:t,manifest_version:d.manifest.version,manifest_entry:d.manifest.entry,capabilities:[...d.manifest.capabilities],contributions:d.manifest.contributions,installed_at:u,updated_at:u,source:m}),s.push({name:d.manifest.name,directory:c.directory,version:d.manifest.version,entry:d.manifest.entry,source:m})}return s.length>0&&await wt(e,o),{state:o,adopted_entries:s,unmanaged_candidates:a,already_managed_count:n.length-i.length}},q_=(e,t)=>{let n=L(process.cwd(),t.path),r=St(n,process.cwd()),i=e==="global"?Nn(process.cwd()):n,a=e==="global"?r.global:r.project;return{pm_root:n,scope:e,settings_root:i,selected_root:a,roots:r}},Lr=e=>{let t=[e.gh,e.github].filter(r=>typeof r=="string").map(r=>r.trim()).filter(Boolean),n=[...new Set(t)];if(n.length>1)throw new _('Options "--gh" and "--github" must match when both are provided.',y.USAGE);return n[0]},W_=e=>g_[e],B_=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=e==="install"?"source":"name",i=`${n} ${r}`,a=W_(e),o=`<${r}>`,s=`pm ${n} ${a} ${o}`;throw new _(`Action "${e}" requires ${i} input.`,y.USAGE,{code:"missing_lifecycle_target",required:`Provide a ${r} target for ${e}.`,examples:[`pm ${n} ${e} ${o}`,s,`pm ${n} --help`],recovery:{attempted_command:`pm ${n} ${e}`,suggested_retry:s,fallback_candidates:[{source:"lifecycle_action",command:s,reason:`flag-form ${e} command with required ${r} target`}]}})},Fr=(e,t,n={})=>{let r=e?.trim();if(r)return r;if(t==="init")throw new _('Action "init" requires a scaffold target path (for example: pm package init ./my-package or pm extension init ./my-extension).',y.USAGE);return B_(t,n)},H_=(e,t)=>{let n=new Set([...t.registrations.item_types.map(r=>({entry:r,count:r.types.length})),...t.registrations.item_fields.map(r=>({entry:r,count:r.fields.length}))].filter(({count:r})=>r>0).map(({entry:r})=>`${r.layer}:${S(r.name)}`));return e.loaded.filter(r=>(r.activation?.commands??[]).length>0).filter(r=>n.has(`${r.layer}:${S(r.name)}`)).map(r=>`extension_schema_narrow_activation:${r.layer}:${r.name}`).filter((r,i,a)=>a.indexOf(r)===i).sort((r,i)=>r.localeCompare(i))},J_=(e,t)=>{let r=[{triggered:t.strictExit===!0||t.failOnWarn===!0,allowed:e==="doctor",message:"--strict-exit and --fail-on-warn are only valid with --doctor."},{triggered:t.trace===!0,allowed:e==="doctor",message:"--trace is only valid with --doctor."},{triggered:t.watch===!0,allowed:e==="reload",message:"--watch is only valid with --reload."},{triggered:t.runtimeProbe===!0,allowed:e==="manage",message:"--runtime-probe is only valid with --manage."},{triggered:t.fixManagedState===!0,allowed:e==="manage"||e==="doctor",message:"--fix-managed-state is only valid with --manage or --doctor."},{triggered:t.isolated===!0||t.ignoreGlobal===!0,allowed:e==="doctor",message:"--isolated and --ignore-global are only valid with --doctor."},{triggered:t.capability!==void 0,allowed:e==="init",message:"--capability is only valid with --init/--scaffold."},{triggered:t.declarative===!0,allowed:e==="init",message:"--declarative is only valid with --init/--scaffold."},{triggered:t.dryRun===!0,allowed:e==="migrate",message:"--dry-run is only valid with --migrate."}].find(i=>i.triggered&&!i.allowed);if(r)throw new _(r.message,y.USAGE)},V_=(e,t,n)=>{let r=String(e??"").trim().toLowerCase(),i=[n.init,n.scaffold].includes(!0);return({doctor:["doctor"],reload:["reload"],catalog:["catalog"],init:i?[]:["init","scaffold"]}[t]??[]).includes(r)?void 0:e},K_=e=>[e.action==="catalog",typeof e.options.fields=="string",String(e.options.fields).trim().length>0].every(Boolean)?{project:"project",global:"global",selected:e.scope,settings_root:"project"}:{project:e.resolvedRoots.roots.project,global:e.resolvedRoots.roots.global,selected:e.resolvedRoots.selected_root,settings_root:e.resolvedRoots.settings_root},Y_=(e,t,n)=>{let r={ok:n,action:e.action,scope:e.scope,roots:K_(e),warnings:[...new Set(e.warnings)].sort((i,a)=>i.localeCompare(a)),details:t};return e.action==="doctor"&&Object.defineProperty(r,__,{value:!0,enumerable:!1,configurable:!1}),r},Ca=async(e,t,n)=>{let r=D_(e,t);J_(r,t);let i=V_(e,r,t),a=P_(t),o=q_(a,n),c={action:r,normalizedTarget:i,scope:a,resolvedRoots:o,warnings:[],options:t,global:n},d={...c,withResult:(u,m=!0)=>Y_(c,u,m)};return await Cy(d)},X_=(e,t)=>{let n=t.vocabulary??"extension",r=e.target_path.replace(/\\/g,"/"),i=Bi(r),a={package:`Install dependencies: cd ${i}, then run "npm install"`,extension:`Install type-check dependencies: cd ${i}, then run "npm install -D typescript @types/node @unbrained/pm-cli"`},o={package:`Validate the package: cd ${i}, then run "npm run typecheck" and "npm test"`,extension:`Type-check the source (optional): cd ${i}, then run "npx tsc --noEmit"`},s=[];return[n==="package",t.declarative===!0].every(Boolean)&&s.push("Ensure the target workspace can resolve @unbrained/pm-cli before installing this declarative package."),[a[n],...s,`Install the scaffold: ${Tc(n==="package"?["install","--project",r]:["extension","--install","--project",r])}`,`Smoke-test command path: pm ${e.command_name}`,o[n],`Run diagnostics: ${n==="package"?"pm package doctor":"pm extension --doctor"} --project --detail summary`]},Z_=async e=>{let{action:t,normalizedTarget:n,options:r,withResult:i}=e;if([Lr(r),r.ref].filter(l=>typeof l=="string").map(l=>l.trim()).filter(Boolean).length>0)throw new _('Action "init" does not accept --gh/--github/--ref options.',y.USAGE);let s=Fr(n,t,r),c=await Jl(s,r.vocabulary??"extension",r.capability,r.declarative===!0);return i({scaffolded:c.created_directory||c.files.some(l=>l.status==="created"),extension:{name:c.extension_name,command:c.command_name},capability:c.capability,style:c.style,target_path:c.target_path,created_directory:c.created_directory,files:c.files,next_steps:X_(c,r)})},Q_=async e=>{let{normalizedTarget:t,resolvedRoots:n,warnings:r,options:i,global:a,withResult:o}=e;if(t!==void 0)throw new _('Action "reload" does not accept a target argument.',y.USAGE);let s=await I(n.settings_root),c=pi(),l=await De({pmRoot:n.settings_root,settings:s,cwd:process.cwd(),noExtensions:a.noExtensions,reload_token:c,cache_bust:!0});r.push(...l.warnings);let d=await Pe(l);r.push(...d.warnings);let u={reload:{token:c,cache_bust:!0,watch:i.watch===!0},loaded_count:l.loaded.length,failed_count:l.failed.length,activated_count:Math.max(0,l.loaded.length-d.failed.length),activation_failed_count:d.failed.length,loaded_extensions:l.loaded.map(m=>({name:m.name,layer:m.layer,version:m.version})),failed_extensions:l.failed.map(m=>({name:m.name,layer:m.layer,error:m.error})),activation_failures:d.failed.map(m=>({name:m.name,layer:m.layer,error:m.error}))};return i.watch===!0&&r.push("extension_reload_watch_hint:watch_mode_requested_non_interactive_single_pass_only"),o(u)},ey=async e=>{let{normalizedTarget:t,scope:n,options:r,global:i,withResult:a}=e;if(typeof t=="string"&&t.length>0&&t!=="catalog")throw new _('Action "catalog" does not accept a package target.',y.USAGE);return a(await Rl(n,i,r))},ty=(e,t)=>({kind:"builtin",input:e,location:e,name:e,...t===null?{}:{package:t}}),ny=e=>({kind:"local",input:e.input,location:e.absolute_path}),ry=(e,t)=>({kind:"npm",input:e.input,location:t.resolved_subpath??".",package:t.npm_package,version:t.npm_version}),iy=(e,t)=>({kind:"github",input:e.input,location:t.resolved_subpath??e.subpath??".",repository:e.repository,owner:e.owner,repo:e.repo,ref:e.ref,subpath:t.resolved_subpath??e.subpath,commit:t.commit}),ay=(e,t,n,r)=>e?ty(e,t):n.kind==="local"?ny(n):n.kind==="npm"?ry(n,r):iy(n,r),oy=(e,t,n,r)=>e?e.manifest_version!==t?{installed_at:e.installed_at,updated_at:r}:vl(e.source,n)?{installed_at:e.installed_at,updated_at:e.updated_at}:{installed_at:e.installed_at,updated_at:r}:{installed_at:r,updated_at:r},sy=async(e,t)=>{let{scope:n,resolvedRoots:r,warnings:i}=e,{validated:a,destinationDirectoryName:o}=t,s=await I(r.settings_root),c=await pe(r.selected_root);i.push(...c.warnings);let l=Ae.join(r.selected_root,o),d=await A(l),u=await Nl(a.directory,l);await ct.mkdir(r.selected_root,{recursive:!0});let m=await ct.mkdtemp(Ae.join(r.selected_root,".pm-extension-install-backup-")),p=Ae.join(m,"destination");try{let f=await Ad(r.selected_root,r.settings_root,l,d,p),g=ay(t.bundledAliasName,t.bundledPackageName,t.installSource,t.resolvedSource),h=c.state.entries.find(x=>S(x.name)===S(a.manifest.name)),w=oy(h,a.manifest.version,g,$()),v=hn(c.state,{name:a.manifest.name,directory:o,scope:n,manifest_version:a.manifest.version,manifest_entry:a.manifest.entry,capabilities:[...a.manifest.capabilities],contributions:a.manifest.contributions,...w,source:g}),b=Md(s,a.manifest.name);try{u||await hd(a.directory,l),await md(l),await pd(l),await wt(r.selected_root,v),b&&await Qn(r.settings_root,s,"settings:write")}catch(x){try{await Rd(f)}catch(R){throw new AggregateError([x,R],`Extension install failed: ${String(x)}; rollback failed: ${String(R)}`,{cause:R})}throw x}return{settings:s,managedState:v,sourceRecord:g,destinationDirectory:l,destinationExists:d,installInPlace:u,activationChanged:b}}finally{await ct.rm(m,{recursive:!0,force:!0}).catch(()=>{})}},cy=async(e,t,n)=>{let r=n.filter(i=>S(i.name)===S(t)).flatMap(i=>i.types.map(a=>({name:a.name,folder:a.folder})));return e.scope==="project"&&r.length>0&&await un(e.resolvedRoots.pm_root,r,e.warnings,"install:type-folder"),r},ly=(e,t,n,r,i)=>{let a=zd(t,n.activation_failures,e.scope),o=G_(t,e.scope,n.installed,a),s=[!n.extensions_disabled,o==="ok"].every(Boolean);s||e.warnings.push(`extension_install_activation_failed:${e.scope}:${t}:${o}`);let c={true:{status:"ok",blocking_failure_count:0},false:{status:"degraded",blocking_failure_count:1}};return{activated:s,status:o,failure:a,verification:{status:c[String(s)].status,target_pm_root:e.resolvedRoots.pm_root,activation_status:o,activated:s,registered_commands:r.command_paths,registered_actions:r.action_paths,registered_item_types:i,module_graph_verification:"fresh_in_topology_snapshot",health:c[String(s)]}}},dy=async(e,t)=>{let{scope:n,resolvedRoots:r,warnings:i,global:a,withResult:o}=e,{validated:s,destinationDirectoryName:c}=t,l=await sy(e,t),d=await Ue(r.selected_root,n,l.settings,l.managedState);i.push(...d.warnings);let u=await Gd(r.pm_root,Ae.dirname(r.selected_root),l.settings,d.extensions,a);i.push(...u.warnings);let m=await cy(e,s.manifest.name,u.item_type_registrations),p=yd(s.manifest.name,u.installed),f=ly(e,s.manifest.name,u,p,m),g=u.contribution_inventories[S(s.manifest.name)];return g&&(l.managedState=await bl(r.selected_root,l.managedState,s.manifest.name,g)),o({extension:{name:s.manifest.name,version:s.manifest.version,entry:s.manifest.entry,capabilities:s.manifest.capabilities,directory:c},source:l.sourceRecord,source_resolution:t.sourceResolution,destination_path:l.destinationDirectory,overwritten:[l.destinationExists,!l.installInPlace].every(Boolean),installed_in_place:l.installInPlace,activated:f.activated,settings_changed:l.activationChanged,runtime_activation_status:f.status,command_paths:p.command_paths,action_paths:p.action_paths,contributions:g,command_discovery:U_(s.manifest.name,l.sourceRecord,p,f.failure),verification:f.verification,activation_diagnostics:{failed_count:u.activation_failures.length,failed:u.activation_failures,installed_extension_failed:f.failure??null}},f.activated)},uy=async e=>{let{options:t,global:n,warnings:r,withResult:i}=e;if(typeof t.ref=="string"&&t.ref.trim().length>0)throw new _('Action "install all" does not accept --ref.',y.USAGE);let a=[],o=new Map;for(let c of await Cr()){let l=await gn(c),d=Ae.resolve(l),u=o.get(d);u===void 0&&(u=await Ca(c,{...t,install:!0},n),o.set(d,u)),a.push({alias:c,result:u})}r.push(...a.flatMap(c=>c.result.warnings));let s=a.every(c=>c.result.ok);return i({installed_all:s,installed_count:a.filter(c=>c.result.ok).length,failed_count:a.filter(c=>!c.result.ok).length,packages:a.map(c=>{let l=c.result.details;return{alias:c.alias,ok:c.result.ok,extension:l.extension,source:l.source,source_resolution:l.source_resolution,destination_path:l.destination_path,activated:l.activated,settings_changed:l.settings_changed,command_paths:l.command_paths,action_paths:l.action_paths,command_discovery:l.command_discovery,verification:l.verification,runtime_activation_status:l.runtime_activation_status,activation_diagnostics:l.activation_diagnostics,warnings:c.result.warnings}})},s)},my=async(e,t,n)=>{let{resolvedRoots:r}=e,{bundledAliasName:i,bundledPackageName:a,installSource:o,sourceResolution:s}=await Ed(t,n,e.options.ref);if(s.ambiguous){let l=s.candidates.find(d=>d.kind==="npm");e.warnings.push(`extension_install_source_ambiguous:${t}:builtin:${i}:npm:${l.package}`)}let c=await Pl(o);try{let l=await Bt(c.directory,{source_kind:o.kind,source_input:o.input,source_root:c.source_root}),d=Rr(l.manifest.name);return await xa(r.settings_root,d,()=>dy(e,{validated:l,destinationDirectoryName:d,bundledAliasName:i,bundledPackageName:a,sourceResolution:s,installSource:o,resolvedSource:c}))}finally{c.cleanup&&await c.cleanup()}},py=async e=>{let t=Lr(e.options),n=t??Fr(e.normalizedTarget,e.action,e.options);return[t===void 0,xl(n)].every(Boolean)?uy(e):my(e,n,t)},fy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,withResult:o}=e;if(t!==void 0)throw new _('Action "adopt-all" does not accept a target argument.',y.USAGE);if(Lr(a)!==void 0||typeof a.ref=="string"&&a.ref.trim().length>0)throw new _('Action "adopt-all" does not accept --gh/--github/--ref options.',y.USAGE);let c=await I(r.settings_root),l=await pe(r.selected_root);i.push(...l.warnings);let d=await Ue(r.selected_root,n,c,l.state);i.push(...d.warnings);let u=await Ia(r.selected_root,n,d.extensions,l.state),m=await Ue(r.selected_root,n,c,u.state);i.push(...m.warnings);let p=Nr(n,i,m.extensions,a);i.push(...p.warnings);let f=new Map(m.extensions.map(w=>[`${S(w.name)}:${S(w.directory)}`,w])),g=new Map(m.extensions.map(w=>[S(w.directory),w])),h=u.adopted_entries.map(w=>{let v=S(w.directory),b=f.get(`${S(w.name)}:${v}`)??g.get(v);return{...w,...qd(b)}});return o({adopted_all:h.length>0,adopted_count:h.length,already_managed_count:u.already_managed_count,extensions:h,triage:p,warning_codes:p.warning_codes,update_health_partial:p.update_health_partial,update_health_coverage:p.update_health_coverage})},qd=e=>({update_check_status:e?.update_check_status??null,update_check_reason:e?.update_check_reason??null}),hy=(e,t,n,r)=>{if(e===void 0)return{kind:"local",input:t,location:n};let i=Or(e,{forceGithub:!0,ref:r});if(i.kind!=="github")throw new _(`Invalid GitHub shorthand "${e}".`,y.USAGE);return{kind:"github",input:i.input,location:i.subpath??".",repository:i.repository,owner:i.owner,repo:i.repo,ref:i.ref,subpath:i.subpath}},gy=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o,withResult:s}=e,c=Fr(n,t,o),l=Lr(o),d=await I(i.settings_root),u=await pe(i.selected_root);a.push(...u.warnings);let m=await Ue(i.selected_root,r,d,u.state);a.push(...m.warnings);let p=await Pd(m.extensions,c);if(!p)throw new _(`Installed extension "${c}" was not found in ${r} scope.`,y.NOT_FOUND);if(p.managed)return s({adopted:!1,already_managed:!0,extension:{name:p.name,directory:p.directory}});let f=Ae.join(i.selected_root,p.directory),g=await Bt(f),h=$(),w=hy(l,c,f,o.ref),v=hn(u.state,{name:g.manifest.name,directory:p.directory,scope:r,manifest_version:g.manifest.version,manifest_entry:g.manifest.entry,capabilities:[...g.manifest.capabilities],contributions:g.manifest.contributions,installed_at:h,updated_at:h,source:w});await wt(i.selected_root,v);let b=await Ue(i.selected_root,r,d,v);a.push(...b.warnings);let x=b.extensions.find(R=>S(R.name)===S(g.manifest.name))??b.extensions.find(R=>S(R.directory)===S(p.directory));return s({adopted:!0,extension:{name:g.manifest.name,directory:p.directory,version:g.manifest.version,entry:g.manifest.entry},source:w,...qd(x)})},Wd=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o}=e,s=Fr(n,t,o),c=await I(i.settings_root),l=await pe(i.selected_root);a.push(...l.warnings);let d=await Ue(i.selected_root,r,c,l.state);a.push(...d.warnings);let u=await Pd(d.extensions,s);if(!u)throw new _(`Installed extension "${s}" was not found in ${r} scope.`,y.NOT_FOUND);return{settings:c,managedStateRead:l,candidate:u}},_y=async e=>{let{resolvedRoots:t,withResult:n}=e,{settings:r,managedStateRead:i,candidate:a}=await Wd(e),o=Ae.join(t.selected_root,a.directory);await ct.rm(o,{recursive:!0,force:!0});let s={...i.state,updated_at:$(),entries:i.state.entries.filter(l=>S(l.name)!==S(a.name)&&S(l.directory)!==S(a.directory))};await wt(t.selected_root,s);let c=I_(r,a.name);return c&&await Qn(t.settings_root,r,"settings:write"),n({removed:!0,extension:{name:a.name,directory:a.directory},destination_path:o,settings_changed:c})},Id=async e=>{let{action:t,resolvedRoots:n,warnings:r,global:i,withResult:a}=e,{settings:o,candidate:s}=await Wd(e),c=t==="activate"?Md(o,s.name):R_(o,s.name);c&&await Qn(n.settings_root,o,"settings:write");let l=t==="activate"?await Gd(n.pm_root,Ae.dirname(n.selected_root),o,[s],i).then(d=>(r.push(...d.warnings),zd(s.name,d.activation_failures,e.scope))):void 0;return l&&r.push(`extension_activate_failed:${e.scope}:${s.name}`),a({extension:{name:s.name,directory:s.directory},active:t==="activate"&&l===void 0,runtime_active:t==="activate"&&l===void 0,activation_failure:l??null,settings_changed:c,settings:{enabled:[...o.extensions.enabled],disabled:[...o.extensions.disabled]}},l===void 0)},yy=(e,t,n,r,i,a)=>{let o=r==="package"?"package":"extension",s={package:"doctor",extension:"--doctor"}[o],c=i?.adopted_entries.length??0,l=[[a!==null,a??""],[t>0,`Run pm ${o} explore --project and pm ${o} explore --global to inspect load failures.`],[n>0,`Review activation failures in pm ${o} ${s} --detail deep output.`],[c>0,`Managed-state fix adopted ${c} extension(s).`]];return[...new Set([...e,...l.filter(([d])=>d).map(([,d])=>d)].map(d=>d.trim()).filter(d=>d.length>0))]},Ra=e=>e.loaded.some(t=>t.layer==="global")||e.failed.some(t=>t.layer==="global")||e.warnings.some(t=>t.includes(":global:")),wy=(e,t,n,r)=>{if(e!=="project"||t||!Ra(r))return null;let i=n==="package"?"package":"extension";return`Global ${i} registrations are included in project diagnostics. For hermetic ${i} smoke tests, rerun pm ${i} doctor --project --isolated --detail deep --trace, or set PM_GLOBAL_PATH to a temporary directory for the whole test process.`},vy=(e,t,n)=>{if(String(e??"").trim().length>0)throw new _('Action "doctor" does not accept a target argument.',y.USAGE);let r=[n.isolated,n.ignoreGlobal].includes(!0);if([r,t==="global"].every(Boolean))throw new _("--isolated and --ignore-global are only valid with project-scope doctor diagnostics.",y.USAGE);let i=id(n.detail),a=n.trace===!0;if([a,i!=="deep"].every(Boolean))throw new _("--trace requires --detail deep with --doctor.",y.USAGE);return{isolated:r,detailMode:i,includeTrace:a}},by=async(e,t,n)=>{if(e.options.fixManagedState!==!0)return{state:n,fix:null};let r=await Ia(e.resolvedRoots.selected_root,e.scope,t,n);return{state:r.state,fix:r}},ky=(e,t,n,r)=>{let i=n==="package"?"package":"extension";if(e!=="project")return{isolated:t,global_extensions_included:!1,global_diagnostics_present:Ra(r),rerun_command:null,pm_global_path_recipe:null};let a=`pm ${i} doctor --project --isolated --detail deep --trace`;return{isolated:t,global_extensions_included:!t,global_diagnostics_present:Ra(r),rerun_command:t?null:a,pm_global_path_recipe:`PM_GLOBAL_PATH=$(mktemp -d) pm ${i} doctor --project --detail deep --trace`}},xy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,global:o,withResult:s}=e,{isolated:c,detailMode:l,includeTrace:d}=vy(t,n,a),u=await I(r.settings_root),m=await pe(r.selected_root);i.push(...m.warnings);let p=await Ue(r.selected_root,n,u,m.state);i.push(...p.warnings);let{state:f,fix:g}=await by(e,p.extensions,m.state),h=await Ue(r.selected_root,n,u,f);i.push(...h.warnings);let w=await De({pmRoot:r.pm_root,settings:u,cwd:process.cwd(),noExtensions:o.noExtensions===!0,ignoreGlobalExtensions:c}),v=await Pe({...w,loaded:w.loaded});i.push(...w.warnings),i.push(...td(w.failed)),i.push(...v.warnings),i.push(...nd(v.failed)),i.push(...rd(w,v)),i.push(...wd(v,w)),i.push(...H_(w,v)),i.push(...vd(v));let b=Pr(h.extensions,w,v),x=od(n,b,w.loaded.map(M=>({layer:M.layer,name:M.name})),w.failed.map(M=>({name:M.name})),w.disabled_by_flag);i.push(...x.warnings);let R=b.filter(M=>M.update_check_status==="failed").map(M=>`extension_update_check_failed:${M.name}`);i.push(...R);let k=Nr(n,i,b,a);i.push(...k.warnings);let F=[...k.warnings],T={mode:w.policy.mode,trust_mode:w.policy.trust_mode,require_provenance:w.policy.require_provenance,default_sandbox_profile:w.policy.default_sandbox_profile,sandbox_enforcement:"advisory: sandbox_profile/permissions are declaration-based load gates, not runtime isolation (ADR pm-6ef3)",trusted_extensions_count:w.policy.trusted_extensions.length,allowed_extensions_count:w.policy.allowed_extensions.length,blocked_extensions_count:w.policy.blocked_extensions.length,allowed_capabilities_count:w.policy.allowed_capabilities.length,blocked_capabilities_count:w.policy.blocked_capabilities.length,allowed_surfaces_count:w.policy.allowed_surfaces.length,blocked_surfaces_count:w.policy.blocked_surfaces.length,allowed_commands_count:w.policy.allowed_commands.length,blocked_commands_count:w.policy.blocked_commands.length,allowed_actions_count:w.policy.allowed_actions.length,blocked_actions_count:w.policy.blocked_actions.length,allowed_services_count:w.policy.allowed_services.length,blocked_services_count:w.policy.blocked_services.length,extension_override_count:w.policy.extension_overrides.length},E=vn(F),U=bn(),B=k.warning_codes,D=wy(n,c,a.vocabulary,w),W=yy(k.remediation,w.failed.length,v.failed.length,a.vocabulary,g,D),ge=ky(n,c,a.vocabulary,w),ue={status:k.status,scope:n,warning_count:k.warning_count,warning_codes:B,total_extensions:b.length,managed_total:b.filter(M=>M.managed).length,enabled_total:b.filter(M=>M.enabled).length,active_total:b.filter(M=>M.active).length,unmanaged_loaded_extension_count:k.unmanaged_loaded_extension_count,unmanaged_action_required_extension_count:k.unmanaged_action_required_extension_count,unmanaged_expected_extension_count:k.unmanaged_expected_extension_count,runtime_active_total:b.filter(M=>M.runtime_active===!0).length,activation_status_totals:{ok:b.filter(M=>M.activation_status==="ok").length,failed:b.filter(M=>M.activation_status==="failed").length,not_loaded:b.filter(M=>M.activation_status==="not_loaded").length,unknown:b.filter(M=>M.activation_status==="unknown").length},unknown_capability_count:E.length,capability_contract_version:U.version,update_available_total:b.filter(M=>M.update_available===!0).length,update_health_coverage:k.update_health_coverage,update_health_partial:k.update_health_partial,update_check_failed_total:b.filter(M=>M.update_check_status==="failed").length,load_failure_count:w.failed.length,activation_failure_count:v.failed.length,load_failures:wa(w.failed),activation_failures:wa(v.failed),blocking_failure_count:w.failed.length+v.failed.length,has_blocking_failures:w.failed.length+v.failed.length>0,consistency_warning_count:x.warnings.length,trace_enabled:d,isolation:ge,policy:T,remediation:W},ze=g?{requested:!0,applied:g.adopted_entries.length>0,adopted_count:g.adopted_entries.length,already_managed_count:g.already_managed_count,adopted_extensions:g.adopted_entries.map(M=>M.name)}:{requested:!1,applied:!1,adopted_count:0,already_managed_count:h.extensions.filter(M=>M.managed).length,adopted_extensions:[]},Oe={mode:l,summary:ue,triage:k,trace_enabled:d,capability_contract:U,capability_guidance:E,managed_state_fix:ze,isolation:ge,policy:w.policy};if(l==="deep"){let M=d?v.failed:v.failed.map(H=>{let{trace:ai,...oi}=H;return oi});Oe.deep={warnings:F,warning_codes:B,capability_contract:U,capability_guidance:E,trace_enabled:d,managed_state:{path:m.path,count:f.entries.length,entries:f.entries},installed_extensions:b,load:{roots:w.roots,policy:w.policy,warnings:w.warnings,failed:w.failed,loaded:w.loaded.map(H=>({layer:H.layer,directory:H.directory,name:H.name,version:H.version,entry:H.entry,priority:H.priority}))},activation:{failed:M,warnings:v.warnings,hook_counts:v.hook_counts,registration_counts:v.registration_counts,parser_override_count:v.parser_override_count,preflight_override_count:v.preflight_override_count,service_override_count:v.service_override_count,renderer_override_count:v.renderer_override_count},consistency:x.summary},d&&(Oe.deep.trace={activation_failures:v.failed.filter(H=>H.trace!==void 0).map(H=>({layer:H.layer,name:H.name,entry_path:H.entry_path,error:H.error,method:H.trace.method,command:H.trace.command,capability:H.trace.capability,missing_capability:H.trace.missing_capability,registration_index:H.trace.registration_index,expected_schema:H.trace.expected_schema,hint:H.trace.hint,received:H.trace.received}))})}return s(Oe)},Sy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,global:o,withResult:s}=e,c=await I(r.settings_root),l=await De({pmRoot:r.pm_root,settings:c,cwd:process.cwd(),noExtensions:o.noExtensions===!0}),d=await Pe(l);i.push(...l.warnings),i.push(...d.warnings);let u=Kl(t,l,d);if(t!==void 0&&u.extensions.length===0){let m=a.vocabulary==="package"?"package":"extension",p=[...new Set(l.loaded.map(g=>a.vocabulary==="package"&&typeof g.source_package=="string"&&g.source_package.trim().length>0?g.source_package.trim():g.name))].sort((g,h)=>g.localeCompare(h)),f=p.length>0?` Loaded ${m} names: ${p.join(", ")}.`:"";throw new _(`No loaded ${m} named "${t}" was found in ${n} scope.${f} Run pm ${m} explore to list discovered ${m}s.`,y.NOT_FOUND)}return s({target:u.target,total:u.total,extensions:u.extensions,union:u.union,command_ownership:u.command_ownership})},Ey=async(e,t,n)=>{let r=n,i=null;if([e.action==="manage",e.options.fixManagedState===!0].every(Boolean)&&(i=await Ia(e.resolvedRoots.selected_root,e.scope,t,n),r=i.state),e.action==="manage"){let a=await _d(r.entries,f_,async o=>{if(o.source.kind!=="github")return o;let s=await bd(o.source);return{...o,last_update_check_at:s.checked_at,last_update_remote_commit:s.remote_commit,update_available:s.available,update_error:s.error}});r={...r,updated_at:$(),entries:fn(a)},await wt(e.resolvedRoots.selected_root,r)}return{state:r,fix:i}},Ay=async(e,t,n)=>{let r=await De({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),i=await Pe({...r,loaded:r.loaded});return e.warnings.push(...r.warnings,...i.warnings),{installed:Pr(n,r,i),failures:Ud(i.failed),summary:{requested:!0,executed:!0,reason:e.action==="explore"?"explore_defaults_to_runtime_probe":e.options.runtimeProbe===!0?"runtime_probe_requested":"manage_defaults_to_runtime_probe",load_failure_count:r.failed.length,activation_failure_count:i.failed.length,warning_count:[...new Set([...r.warnings,...i.warnings])].length,policy:r.policy}}},Ry=(e,t)=>e?{requested:!0,applied:e.adopted_entries.length>0,adopted_count:e.adopted_entries.length,adopted_extensions:e.adopted_entries.map(n=>n.name),already_managed_count:e.already_managed_count}:{requested:!1,applied:!1,adopted_count:0,adopted_extensions:[],already_managed_count:t.filter(n=>n.managed).length},Cd=async e=>{let{action:t,scope:n,resolvedRoots:r,warnings:i,options:a,withResult:o}=e,s=await I(r.settings_root),c=A_(s.extensions.policy),l=await pe(r.selected_root);i.push(...l.warnings);let d=await Ue(r.selected_root,n,s,l.state);i.push(...d.warnings);let{state:u,fix:m}=await Ey(e,d.extensions,l.state),p=await Ue(r.selected_root,n,s,u);if(i.push(...p.warnings),t==="manage"){let v=p.extensions.filter(b=>b.update_check_status==="failed").map(b=>`extension_update_check_failed:${b.name}`);i.push(...v)}let f=await Ay(e,s,p.extensions),g=f.installed,h=Nr(n,i,g,a);i.push(...h.warnings);let w={total:g.length,managed_total:g.filter(v=>v.managed).length,enabled_total:g.filter(v=>v.enabled).length,active_total:g.filter(v=>v.active).length,extensions:g,triage:h,policy:c};return f.failures!==void 0&&(w.activation_diagnostics={failed_count:f.failures.length,failed:f.failures}),t==="explore"&&(w.runtime_probe=f.summary),t==="manage"&&(w.runtime_probe=f.summary,w.managed_state_fix=Ry(m,g)),o(w)},$d={init:Z_,install:py,uninstall:_y,explore:Cd,manage:Cd,describe:Sy,reload:Q_,doctor:xy,catalog:ey,adopt:gy,"adopt-all":fy,activate:Id,deactivate:Id,migrate:Sd},Iy=e=>[e.action==="uninstall",e.action==="manage",e.action==="adopt",e.action==="adopt-all",e.action==="activate",e.action==="deactivate",e.action==="migrate",[e.action==="doctor",e.options.fixManagedState===!0].every(Boolean)].some(Boolean),Cy=e=>Iy(e)?xa(e.resolvedRoots.settings_root,`${e.action}-state`,()=>$d[e.action](e)):$d[e.action](e);import{execFile as $y}from"node:child_process";import{realpath as Ty}from"node:fs/promises";import Bd from"node:path";import{promisify as Oy}from"node:util";(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]="d18b51d7-294a-52da-b1cf-a10f24aefbc9")}catch{}})();var Dy=Oy($y),Py=32*1024*1024,Ny=1e4,My=["search/eval-queries.json"];function $a(e){return e.replaceAll("\\","/").replace(/\/+$/,"")}function Ly(e){return`'${e.replaceAll("'","'\\''")}'`}async function Fy(e,t=Ty){return t(e).catch(()=>Bd.resolve(e))}async function jr(e){let t=await gt(e);if(t===null)return{git_workspace_root:null,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null};let n=await Fy(e),r=$a(Bd.relative(t,n));if(r.length===0)return{git_workspace_root:t,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null};let i=Ji.map(a=>`${r}/${$a(a)}`);try{let{stdout:a}=await Dy("git",["ls-files","-z","--",...i.map(l=>`:(literal)${l}`)],{cwd:t,encoding:"utf8",maxBuffer:Py,windowsHide:!0,timeout:Ny}),o=new Set(My.map(l=>`${r}/${l}`)),s=[...new Set(a.split("\0").filter(l=>l.length>0&&!o.has($a(l))))].sort((l,d)=>l.localeCompare(d)),c=i.filter(l=>s.some(d=>d===l||d.startsWith(`${l}/`)));return{git_workspace_root:t,tracker_relative_root:r,tracked_paths:s,tracked_path_count:s.length,remediation_command:s.length===0?null:`git rm --cached -r -- ${c.map(l=>Ly(`:(literal)${l}`)).join(" ")}`}}catch{return{git_workspace_root:t,tracker_relative_root:r,tracked_paths:[],tracked_path_count:0,remediation_command:null}}}import{execFile as jy}from"node:child_process";import{randomUUID as Uy}from"node:crypto";import{readdir as zy,readFile as Vd}from"node:fs/promises";import xe from"node:path";import{promisify as Gy}from"node:util";(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]="7b87b458-164a-5332-8803-6b0695481644")}catch{}})();var qy=Gy(jy);async function Ta(e){try{let{stdout:t}=await qy("git",["rev-parse","--path-format=absolute","--git-path","pm-merge-receipts"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4});return t.trim()}catch{return null}}async function Kd(e,t){let n=xe.dirname(xe.resolve(e,t));for(let r=0;r<12;r+=1){if(await A(xe.join(n,"settings.json")))return n;let i=xe.dirname(n);if(i===n)break;n=i}return null}function Oa(e){return xe.join(e,"merge-receipts")}function Ur(e){return`${e}.json`}function Wy(e){return{receipt_id:e.id,item_id:e.item_id,item_path:e.item_path,conflict_fields:e.decisions.map(t=>t.field),fields_from_theirs:e.fields_from_theirs,union_fields:e.union_fields,requested_preference:e.requested_preference??e.preferred??"ours",conflict_resolution:e.conflict_resolution,decisions:e.decisions.map(t=>({field:t.field,retained_hash:Hd(t.retained)??mi(ye(t.retained)),discarded_hash:Hd(t.discarded)??mi(ye(t.discarded))}))}}function Hd(e){if(typeof e!="object"||e===null||Array.isArray(e)||!("pm_value_hash"in e))return;let t=e.pm_value_hash;return typeof t=="string"&&/^[a-f0-9]{64}$/u.test(t)?t:void 0}async function XC(e){let t=await Ta(e.cwd);if(t===null)return null;let n=e.itemPath.trim(),r=n.length>=2&&(n.startsWith("'")&&n.endsWith("'")||n.startsWith('"')&&n.endsWith('"'))?n.slice(1,-1):n,i=xe.basename(r,xe.extname(r)),a={version:1,id:Uy(),item_path:r.replaceAll("\\","/"),item_id:i,requested_preference:e.preferred,conflict_resolution:e.conflictResolution??"preferred_side",fields_from_theirs:[...e.fieldsFromTheirs],union_fields:[...e.unionFields],decisions:structuredClone(e.decisions),state:"pending",created_at:$(),value_availability:"clone_local"};await li(t),await ce(xe.join(t,Ur(a.id)),`${JSON.stringify(a,null,2)}
38
- `);let o=await Kd(e.cwd,a.item_path);if(o!==null){let s=Oa(o),c=Wy(a),l={...a,decisions:c.decisions.map(d=>({field:d.field,base:null,ours:null,theirs:null,retained:{pm_value_hash:d.retained_hash},discarded:{pm_value_hash:d.discarded_hash}})),value_availability:"hash_only"};await li(s),await ce(xe.join(s,Ur(a.id)),`${JSON.stringify(l,null,2)}
39
- `)}return a}async function Jd(e,t){if(!await A(e))return[];let n;try{n=await zy(e)}catch{return[]}let r=[];for(let i of n.sort((a,o)=>a.localeCompare(o)))if(i.endsWith(".json"))try{let a=JSON.parse(await Vd(xe.join(e,i),"utf8")),{preferred:o,...s}=a,c={...s,requested_preference:a.requested_preference??o??"ours",conflict_resolution:a.conflict_resolution??"preferred_side"};c.version===1&&(t.includeReconciled||c.state==="pending")&&(t.includeLossless!==!1||c.decisions.length>0)&&r.push(c)}catch{}return r}async function kn(e,t={}){let n=await Ta(e),r=n===null?[]:await Jd(n,t),i=t.pmRoot??xe.join(e,".agents","pm"),a=await Jd(Oa(i),t),o=new Map(a.map(s=>[s.id,s]));for(let s of r)o.set(s.id,s);return[...o.values()].sort((s,c)=>s.created_at.localeCompare(c.created_at))}function zr(e){let t=[],n=[];for(let r of e)(Array.isArray(r.decisions)&&r.decisions.length>0?t:n).push(r);return{pendingDecisions:t,lossless:n}}async function ZC(e,t){let n=await Ta(e);if(n===null)return;await ce(xe.join(n,Ur(t.id)),`${JSON.stringify({...t,state:"reconciled",reconciled_at:$()},null,2)}
40
- `);let r=await Kd(e,t.item_path);if(r!==null){let i=xe.join(Oa(r),Ur(t.id));if(await A(i)){let a=JSON.parse(await Vd(i,"utf8"));await ce(i,`${JSON.stringify({...a,state:"reconciled",reconciled_at:$()},null,2)}
41
- `)}}}async function QC(e){let t=await kn(e.cwd??process.cwd(),{...e,includeLossless:!0});return{ok:!0,count:t.length,receipts:t,generated_at:$()}}(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]="e7be701e-085c-5903-96da-61149452c673")}catch{}})();var By=new Set(Ds),Xd=25,Sn=8,xn=100,Hy=fe.join("runtime","telemetry","events.jsonl"),Jy=fe.join("runtime","telemetry","state.json"),Vy=2500,Ky=500,Zd=Os-3,Yy=["x-pm-telemetry-max-schema-version","x-pm-telemetry-max-version"];function Fa(e,t=!1){return e.startsWith("telemetry_")||e.startsWith("history_stream_over_compact_threshold:")||e.startsWith("stale_in_progress_items:")||e.startsWith("provenance_resolver_zero_success:")||e.startsWith("provenance_value_domain_invalid:")||!t&&e.startsWith("merge_driver_configuration_missing:")}function ja(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function Jt(e){return e.trim().toLowerCase()}function Na(e,t){let n=Jt(e),r=Jt(t);return n.startsWith("builtin-")?!0:r==="beads"||r==="todos"}async function Ua(e){try{return(await et.stat(e)).isDirectory()}catch{return!1}}async function Xy(e){let t=(await et.readdir(e,{withFileTypes:!0})).filter(r=>r.isDirectory()),n=await Promise.all(t.map(r=>et.readdir(fe.join(e,r.name),{withFileTypes:!0})));return new Set(n.flatMap(r=>r.filter(i=>i.isFile()).filter(i=>Qt.some(a=>i.name.endsWith(a))).map(i=>fe.parse(i.name).name)))}async function Zy(e,t,n,r){let i=await We({path:e,scope:"project"}),a=t!=="_workspace"&&!r.has(t);if(!n.enabled&&!a)return{warnings:i,overThreshold:!1,classification:"live"};let o;try{o=await et.readFile(e,"utf8")}catch{return{warnings:i,overThreshold:!1,classification:"unreadable"}}let s="live";if(a){let l=o.split(/\r?\n/).map(d=>d.trim()).filter(Boolean).at(-1);try{s=JSON.parse(l??"{}").op==="delete"?"tombstone":"orphaned"}catch{s="orphaned"}}let c=n.enabled?o.split(/\r?\n/).filter(l=>l.trim().length>0).length:0;return{warnings:i,overThreshold:n.enabled&&c>n.max_entries,classification:s}}async function Qy(e,t,n){let r=fe.join(e,"history");if(!await Ua(r))return{count:0,warnings:[],over_threshold:[],max_entries:null,tombstones:[],orphaned:[]};let i=(await et.readdir(r)).filter(u=>u.endsWith(".jsonl")).sort((u,m)=>u.localeCompare(m)),o=t.enabled?t.max_entries:null,s=[],c=[],l=[],d=[];for(let u of i){let m=fe.join(r,u),p=u.slice(0,-6),f=await Zy(m,p,t,n);s.push(...f.warnings),f.classification==="tombstone"&&l.push(p),f.classification==="orphaned"&&d.push(p),f.overThreshold&&c.push(p)}return{count:i.length,warnings:[...s,...c.map(u=>`history_stream_over_compact_threshold:${u}`),...d.map(u=>`history_orphaned_stream:${u}`)],over_threshold:c,max_entries:o,tombstones:l,orphaned:d}}function Ma(e,t){return fe.relative(e,t).replaceAll("\\","/")}async function Qd(e,t){let n=[...new Set(Object.values(t))].sort((i,a)=>i.localeCompare(a)),r=[];for(let i of n){let a=fe.join(e,i),o=[];try{o=await et.readdir(a)}catch(s){if(typeof s=="object"&&s!==null&&"code"in s&&j(s))continue;continue}for(let s of o)Qt.some(c=>s.toLowerCase().endsWith(c))&&r.push(fe.join(a,s))}return r.sort((i,a)=>Ma(e,i).localeCompare(Ma(e,a))),r}function ew(e){return!(typeof e=="object"&&e!==null&&"code"in e&&j(e))}async function tw(e,t,n){let r=await Qd(e,t),i=[],a=[],o=[],s=[],c=xt(z());for(let l of r){let d=Ma(e,l),u;try{u=await et.readFile(l,"utf8")}catch{i.push(d);continue}let m=Ct(u);if(m){a.push({path:d,...m});continue}try{let p=$t(u,{format:Eo(l),schema:n,extensionFieldNames:c});s.push({ref:d,version:Hn(p.metadata)})}catch{o.push(d)}}return{paths:r,unreadable:i,conflictMarkers:a,parseFailures:o,formatVersions:s}}async function nw(e){let t=fe.join(e,"history"),n=[],r=[],i=[],a=[];try{a=(await et.readdir(t)).filter(o=>o.endsWith(".jsonl")).sort((o,s)=>o.localeCompare(s))}catch(o){ew(o)&&n.push("history")}for(let o of a){let s=o.slice(0,-6),c;try{c=await et.readFile(fe.join(t,o),"utf8")}catch{n.push(s);continue}let l=Ct(c);if(l){r.push({id:s,...l});continue}c.split(/\r?\n/).forEach((d,u)=>{if(d.trim())try{JSON.parse(d)}catch{i.push({id:s,line:u+1})}})}return{files:a,unreadable:n,conflictMarkers:r,invalidJson:i}}async function rw(e,t,n,r){let i=await tw(e,t,n),a=await nw(e),o=Jn(i.formatVersions),s=await jr(e),c=await gt(e),l=c===null?null:await xr(c),d=c===null?[]:await kn(c,{includeLossless:!0,pmRoot:e}),{pendingDecisions:u,lossless:m}=zr(d),p=l?.status==="missing"&&l.missing_keys.length===5&&l.drifted_keys.length===0,f=[...i.unreadable.map(h=>`integrity_item_unreadable:${h}`),...i.conflictMarkers.map(h=>`integrity_item_conflict_marker:${h.path}:L${h.line}`),...i.parseFailures.map(h=>`integrity_item_parse_failed:${h}`),...a.unreadable.map(h=>`integrity_history_unreadable:${h}`),...a.conflictMarkers.map(h=>`integrity_history_conflict_marker:${h.id}:L${h.line}`),...a.invalidJson.map(h=>`integrity_history_invalid_json:${h.id}:L${h.line}`),...o.outdated.map(h=>`integrity_item_outdated_format_version:${h}`),...o.ahead.map(h=>`integrity_item_ahead_format_version:${h}`),...s.tracked_path_count>0?[`tracked_runtime_cache_files:${s.tracked_path_count}`]:[],...l!==null&&l.status!=="ok"?[`merge_driver_configuration_${p?"missing":"drift"}:${l.missing_keys.length+l.drifted_keys.length}`]:[],...u.length>0?[`merge_decisions_unreviewed:${u.length}`]:[]],g=[...new Set(f)].sort((h,w)=>h.localeCompare(w));return{check:{name:"integrity",status:g.length===0?"ok":"warn",ok:g.length===0,details:{checked_item_files:i.paths.length,checked_history_streams:a.files.length,counts:{item_unreadable:i.unreadable.length,item_conflict_markers:i.conflictMarkers.length,item_parse_failures:i.parseFailures.length,history_unreadable:a.unreadable.length,history_conflict_markers:a.conflictMarkers.length,history_invalid_json:a.invalidJson.length,item_outdated_format_version:o.outdated.length,item_ahead_format_version:o.ahead.length,tracked_runtime_cache_files:s.tracked_path_count,merge_driver_configuration:l===null||l.status==="ok"?0:l.missing_keys.length+l.drifted_keys.length,pending_merge_decisions:u.length,lossless_merge_receipts:m.length},item_unreadable:i.unreadable,item_conflict_markers:i.conflictMarkers,item_parse_failures:i.parseFailures,item_outdated_format_version:o.outdated,item_ahead_format_version:o.ahead,history_unreadable:a.unreadable,history_conflict_markers:a.conflictMarkers,history_invalid_json:a.invalidJson,tracked_runtime_cache:{tracker_relative_root:s.tracker_relative_root,tracked_paths:s.tracked_paths,tracked_path_count:s.tracked_path_count,remediation_command:s.remediation_command},merge_driver_configuration:l===null?null:{...l,required:r},pending_merge_decision_items:[...new Set(u.map(h=>h.item_id))].sort((h,w)=>h.localeCompare(w)),lossless_merge_receipt_items:[...new Set(m.map(h=>h.item_id))].sort((h,w)=>h.localeCompare(w))}},warnings:g}}function iw(e){if(typeof e.activate=="function")return!0;let t=e.default;return typeof t!="object"||t===null?!1:typeof t.activate=="function"}function aw(e){let t={layer:e.layer,directory:e.directory,manifest_path:e.manifest_path,name:e.name,version:e.version,entry:e.entry,priority:e.priority,entry_path:e.entry_path,has_activate:iw(e.module)};return Array.isArray(e.capabilities)&&(t.capabilities=[...e.capabilities]),t}function ow(e,t){let n=Z(e.id);return n||`migration-${String(t+1).padStart(3,"0")}`}function sw(e){let n=Z(e.status)?.toLowerCase();return n==="failed"?"failed":n==="applied"?"applied":"pending"}function cw(e){return Z(e.reason)??Z(e.error)??Z(e.message)}function Da(e,t){let n=(e.layer??"").localeCompare(t.layer??"");if(n!==0)return n;let r=(e.name??"").localeCompare(t.name??"");return r!==0?r:(e.id??"").localeCompare(t.id??"")}function lw(e){let t=[],n=[],r=[];e.forEach((a,o)=>{let s=ow(a.definition,o),c=sw(a.definition);if(c==="applied"){t.push({layer:a.layer,name:a.name,id:s,status:c});return}if(c==="failed"){r.push({layer:a.layer,name:a.name,id:s,status:c,reason:cw(a.definition)});return}n.push({layer:a.layer,name:a.name,id:s,status:c})}),t.sort(Da),n.sort(Da),r.sort(Da);let i=[...r.map(a=>`extension_migration_failed:${a.layer}:${a.name}:${a.id}`),...n.map(a=>`extension_migration_pending:${a.layer}:${a.name}:${a.id}`)];return{summary:{applied:t,pending:n,failed:r,applied_count:t.length,pending_count:n.length,failed_count:r.length},warnings:i}}function eu(e,t,n,r,i,a,o,s,c){let l=[...new Set(e)].sort((h,w)=>h.localeCompare(w)),d=[...new Set(l.map(h=>ja(h)))].sort((h,w)=>h.localeCompare(w)),u=l.filter(h=>h.startsWith("extension_capability_unknown:")).length,m=c.length>0,p=m?"partial":"full",f=[],g=va(l,{deactivate:"pm extension --deactivate <name> --project/--global",doctor:"pm extension --doctor --project/--global --detail deep --trace"});return g&&f.push(g),t>0&&f.push("Run pm extension --explore --project and pm extension --explore --global to inspect load failures."),n>0&&f.push("Review checks[name=extensions].details.activation.failed in pm health --json for activation error details."),(r.failed_count>0||r.pending_count>0)&&f.push("Resolve pending/failed extension migrations before write commands; use --force only when policy allows."),i>0&&f.push("Run pm extension --manage --project and pm extension --manage --global to refresh managed-state diagnostics."),u>0&&f.push(`Unknown extension capabilities detected. Allowed capabilities: ${Tn.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`),l.some(h=>h.startsWith("extension_capability_legacy_alias:"))&&f.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."),l.some(h=>h.startsWith("extension_command_definition_legacy_handler_alias:"))&&f.push("Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."),m?f.push("Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via pm extension --manage --project/--global --fix-managed-state, pm extension --adopt-all --project/--global, or pm extension --adopt <name>."):o.length>0&&f.push("Loaded unmanaged extensions are currently treated as informational. Use pm extension --manage --project/--global --fix-managed-state to adopt them for update checks."),f.length===0&&f.push("No immediate action required. Re-run pm health after extension configuration changes."),{status:l.length===0?"ok":"warn",warning_count:l.length,warning_codes:d,load_failure_count:t,activation_failure_count:n,migration_failed_count:r.failed_count,migration_pending_count:r.pending_count,managed_state_warning_count:i,managed_extension_entries_count:a,unmanaged_loaded_extension_count:o.length,unmanaged_loaded_extensions:o,unmanaged_expected_extension_count:s.length,unmanaged_expected_extensions:s,unmanaged_action_required_extension_count:c.length,unmanaged_action_required_extensions:c,update_health_coverage:p,update_health_partial:m,unknown_capability_count:u,top_warnings:l.slice(0,8),remediation:f}}async function dw(e,t,n){let r=await De({pmRoot:e,settings:t,cwd:process.cwd(),noExtensions:n}),i=r.loaded.map(k=>aw(k)),a=await sc(r.loaded,mt(e)),o=await Pe({...r,loaded:r.loaded}),[s,c]=await Promise.all([pe(r.roots.project),pe(r.roots.global)]);await Ea(e,o.registrations.migrations);let l=lw(o.registrations.migrations),d={failed:o.failed,warnings:o.warnings,hook_counts:o.hook_counts,command_override_count:o.command_override_count,command_handler_count:o.command_handler_count,parser_override_count:o.parser_override_count,preflight_override_count:o.preflight_override_count,service_override_count:o.service_override_count,renderer_override_count:o.renderer_override_count,registration_counts:o.registration_counts,registrations:o.registrations,migration_status:l.summary,managed_extensions:{project:{path:s.path,count:s.state.entries.length,entries:s.state.entries},global:{path:c.path,count:c.state.entries.length,entries:c.state.entries}}},u=new Set(s.state.entries.map(k=>Jt(k.name))),m=new Set(c.state.entries.map(k=>Jt(k.name))),p=[...new Map(r.loaded.filter(k=>!(k.layer==="project"?u:m).has(Jt(k.name))).map(k=>[`${k.layer}:${k.name}`,{layer:k.layer,name:k.name,directory:k.directory}])).values()].sort((k,F)=>{let T=`${k.layer}:${k.name}`,E=`${F.layer}:${F.name}`;return T.localeCompare(E)}),f=p.map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),g=p.filter(k=>Na(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),h=p.filter(k=>!Na(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),w=h.length>0?[`extension_update_health_partial_coverage:skipped_unmanaged:${h.length}`]:[],v=[...r.warnings,...d.warnings,...l.warnings,...s.warnings,...c.warnings,...w,...a.warnings],b=vn(v),x=bn(),R=eu(v,r.failed.length,o.failed.length,l.summary,s.warnings.length+c.warnings.length,s.state.entries.length+c.state.entries.length,f,g,h);return{check:{name:"extensions",status:v.length===0?"ok":"warn",ok:v.length===0,details:{...r,loaded:i,warnings:v,activation:d,triage:R,...l.summary.pending_count>0?{remediation_map:{extension_migration_pending:"pm extension migrate --project"}}:{},capability_contract:x,capability_guidance:b,host_version_census:a}},warnings:v}}function uw(e,t){return e.length<=t?{values:e,truncated:!1}:{values:e.slice(0,t),truncated:!0}}function Qe(e,t){return Array.isArray(e)?{count:e.length,sample:e.slice(0,t),truncated:e.length>t}:{count:0,sample:[],truncated:!1}}function mw(e){if(typeof e!="object"||e===null||Array.isArray(e))return{};let t=e;return{layer:t.layer,directory:t.directory,name:t.name,version:t.version,enabled:t.enabled,status:t.status,has_activate:t.has_activate,capabilities:t.capabilities}}function Gr(e,t){let n=Qe(e,t);return{...n,sample:n.sample.map(r=>mw(r))}}function V(e,t){if(!Array.isArray(e))return{count:0,sample:[],truncated:!1};let n=e.filter(r=>typeof r=="string");return{count:n.length,sample:n.slice(0,t),truncated:n.length>t}}function pw(e){if(typeof e!="object"||e===null)return null;let t=e;return{applied_count:t.applied_count,pending_count:t.pending_count,failed_count:t.failed_count}}var fw={settings:(e,t)=>({version:e.version,id_prefix:e.id_prefix,locks_ttl_seconds:e.locks_ttl_seconds,warnings:V(e.warnings,t)}),directories:(e,t)=>({required_count:Array.isArray(e.required)?e.required.length:0,optional_count:Array.isArray(e.optional)?e.optional.length:0,missing_required:V(e.missing_required,t),missing_optional:V(e.missing_optional,t),missing:V(e.missing,t),strict_directories:e.strict_directories}),settings_values:(e,t)=>({warnings:V(e.warnings,t)}),telemetry:e=>({enabled:e.enabled,capture_level:e.capture_level,endpoint:e.endpoint,queue_exists:e.queue_exists,queue_entries:e.queue_entries,queue_draining:e.queue_draining,queue_invalid_rows:e.queue_invalid_rows,queue_rows_total:e.queue_rows_total,last_successful_flush_at:e.last_successful_flush_at,last_failed_flush_at:e.last_failed_flush_at,endpoint_probe:e.endpoint_probe,env_overrides:e.env_overrides}),extensions:(e,t)=>{let n=typeof e.activation=="object"&&e.activation!==null?e.activation:{};return{disabled_by_flag:e.disabled_by_flag,discovered:Gr(e.discovered,t),effective:Gr(e.effective,t),loaded:Gr(e.loaded,t),failed:Qe(e.failed,t),warnings:V(e.warnings,t),activation:{failed:Qe(n.failed,t),warnings:V(n.warnings,t),hook_counts:n.hook_counts,command_handler_count:n.command_handler_count,service_override_count:n.service_override_count,renderer_override_count:n.renderer_override_count,registration_counts:n.registration_counts,migration_status:pw(n.migration_status)},triage:e.triage,capability_contract:e.capability_contract,capability_guidance:Qe(e.capability_guidance,t),host_version_census:e.host_version_census}},storage:(e,t)=>{let n=typeof e.author_attribution=="object"&&e.author_attribution!==null?e.author_attribution:void 0;return{...e,...n?{author_attribution:{...n,affected_item_ids:V(n.affected_item_ids,t),samples:Qe(n.samples,t)}}:{}}},locks:e=>({active_lock_count:e.active_lock_count,stale_lock_count:e.stale_lock_count,unreadable_lock_count:e.unreadable_lock_count,unparseable_lock_count:e.unparseable_lock_count}),integrity:(e,t)=>{let n=typeof e.tracked_runtime_cache=="object"&&e.tracked_runtime_cache!==null?e.tracked_runtime_cache:void 0;return{checked_item_files:e.checked_item_files,checked_history_streams:e.checked_history_streams,counts:e.counts,item_unreadable:V(e.item_unreadable,t),item_conflict_markers:Qe(e.item_conflict_markers,t),item_parse_failures:V(e.item_parse_failures,t),tracked_runtime_cache:n===void 0?e.tracked_runtime_cache:{...n,tracked_paths:V(n.tracked_paths,t)},history_unreadable:V(e.history_unreadable,t),history_conflict_markers:Qe(e.history_conflict_markers,t),history_invalid_json:Qe(e.history_invalid_json,t),skipped:e.skipped}},history_drift:(e,t)=>({checked_items:e.checked_items,counts:e.counts,drifted_items:V(e.drifted_items,t),missing_streams:V(e.missing_streams,t),unreadable_streams:V(e.unreadable_streams,t),hash_mismatches:V(e.hash_mismatches,t),chain_mismatches:V(e.chain_mismatches,t),workspace_state_mismatches:V(e.workspace_state_mismatches,t),workspace_state_missing:V(e.workspace_state_missing,t),workspace_state_unreadable:V(e.workspace_state_unreadable,t),skipped:e.skipped}),vectorization:(e,t)=>({semantic_runtime_available:e.semantic_runtime_available,compatibility_mode_auto_defaults:e.compatibility_mode_auto_defaults,auto_ollama_defaults_applied:e.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:e.auto_ollama_defaults_skipped_reason,auto_ollama_defaults_remediation:e.auto_ollama_defaults_remediation,refresh_policy:e.refresh_policy,provider_active:e.provider_active,vector_store_active:e.vector_store_active,items:e.items,ledger_entries_before:e.ledger_entries_before,stale_items_before_total:e.stale_items_before_total,stale_items_before:V(e.stale_items_before,t),refresh_attempted:e.refresh_attempted,refresh_skipped_reason:e.refresh_skipped_reason,refresh_result:e.refresh_result,ledger_entries_after:e.ledger_entries_after,stale_items_after_total:e.stale_items_after_total,stale_items_after:V(e.stale_items_after,t),skipped:e.skipped})};function tu(e,t){let n=fw[e.name];return n?n(e.details,t):e.details}function hw(e){let t=V(e.warnings,Sn);return{ok:e.ok,checks:e.checks.map(n=>({name:n.name,status:n.status,ok:n.ok,details:tu(n,Sn)})),warnings:t.sample,findings:e.findings.filter(n=>t.sample.includes(n.warning)||e.failed_because.includes(n.warning)),failed_because:e.failed_because,projection:{mode:"brief",warning_count:t.count,warnings_truncated:t.truncated,detail_limit:Sn},generated_at:e.generated_at}}function Yd(e){return e.details.skipped===!0}function gw(e){let t=V(e.warnings,Sn),n=e.checks.filter(Yd).map(r=>r.name);return{ok:e.ok,checks:e.checks.filter(r=>!Yd(r)).map(r=>({name:r.name,status:r.status,ok:r.ok,details:{}})),warning_count:t.count,warnings:t.sample,findings:e.findings.filter(r=>t.sample.includes(r.warning)||e.failed_because.includes(r.warning)),failed_because:e.failed_because,projection:{mode:"summary",warning_count:t.count,warnings_truncated:t.truncated,detail_limit:Sn,omitted_checks:n},generated_at:e.generated_at}}function La(e,t){if(t)return{values:e,truncated:!1,total:e.length};let n=uw(e,Xd);return{values:n.values,truncated:n.truncated,total:e.length}}function Ht(e){let t=(process.env[e]??"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}function _w(){let e=(process.env.PM_TELEMETRY_SOURCE_CONTEXT??"").trim().toLowerCase();return By.has(e)?e:null}function qr(e){let t=e.trim();if(t.length===0)return"";try{let n=new URL(t);return n.username="",n.password="",n.search="",n.hash="",n.toString()}catch{return t}}function nu(e){let t=0,n=0,r=0,i=0,a=0;for(let o of e.split(`
42
- `)){let s=o.trim();if(s.length!==0){r+=1;try{let c=JSON.parse(s);if(typeof c=="object"&&c!==null&&typeof c.attempts=="number"&&Number.isFinite(c.attempts)){let l=Math.max(0,Math.trunc(c.attempts));t+=1,a=Math.max(a,l),l>=Zd&&(i+=1)}else n+=1}catch{n+=1}}}return{validEntries:t,invalidRows:n,totalRows:r,highRetryEntries:i,maxAttempts:a}}function yw(){return{validEntries:0,invalidRows:0,totalRows:0,highRetryEntries:0,maxAttempts:0}}function ww(e){if(!e||e.trim().length===0)return{runtimeState:{},stateParseFailed:!1};try{let t=JSON.parse(e);return typeof t=="object"&&t!==null&&!Array.isArray(t)?{runtimeState:t,stateParseFailed:!1}:{runtimeState:{},stateParseFailed:!0}}catch{return{runtimeState:{},stateParseFailed:!0}}}async function vw(e,t){let n=e.telemetry.endpoint.trim();return!t||!e.telemetry.enabled||n.length===0?void 0:{attempted:!0,...await ru(n)}}function bw(e,t,n){let r=[];if(t.invalidRows>0&&r.push(`telemetry_queue_invalid_rows:${t.invalidRows}`),!e.telemetry.enabled||t.validEntries===0)return r;let i=n.last_successful_flush_at,a=n.last_failed_flush_at,o=a&&(!i||a>i),s=!i,c=t.validEntries>=Ky;return(o||s||c)&&r.push(`telemetry_queue_pending:${t.validEntries}`),t.highRetryEntries>0&&r.push(`telemetry_queue_high_retries:${t.highRetryEntries}`),r}function kw(e){return!e||e.ok!==!1?[]:typeof e.status=="number"?[`telemetry_endpoint_probe_http_status:${e.status}`]:["telemetry_endpoint_probe_failed"]}function xw(e){let t=Number.parseInt(e?.max_schema_version??"",10);return e?.ok===!0&&Number.isInteger(t)&&t>Ts?[`telemetry_schema_version_behind:${t}`]:[]}function Sw(e,t){let n=typeof t.pending_otel_spans=="number"?t.pending_otel_spans:0,r=t.last_otel_success_at,i=t.last_otel_failure_at;return e.telemetry.enabled&&n>0&&!!i&&(!r||i>=r)?[`telemetry_otel_export_failing:${n}`]:[]}function Ew(){return{telemetry_disabled:Ht("PM_TELEMETRY_DISABLED")||Ht("PM_NO_TELEMETRY"),pm_no_telemetry:Ht("PM_NO_TELEMETRY"),telemetry_otel_disabled:Ht("PM_TELEMETRY_OTEL_DISABLED"),telemetry_inline_flush:Ht("PM_TELEMETRY_INLINE_FLUSH"),telemetry_source_context:_w()}}function Aw(e,t){return e.telemetry.enabled&&t.validEntries>0}function Rw(e,t){return e&&t.every(n=>!n.startsWith("telemetry_queue_pending:")&&!n.startsWith("telemetry_queue_high_retries:"))}async function ru(e){let t=e;try{let n=new URL(e);n.pathname="/healthz",n.search="",n.hash="",t=n.toString()}catch{}try{let n=await fetch(t,{method:"GET",signal:AbortSignal.timeout(Vy)});return{probe_url:qr(t),ok:n.ok,status:n.status,max_schema_version:(()=>{for(let r of Yy){let i=n.headers.get(r)?.trim();if(i&&i.length>0)return i}})()}}catch(n){return{probe_url:qr(t),ok:!1,error:n instanceof Error?n.message:"probe_failed"}}}async function Iw(e,t){let n=Nn(process.cwd()),r=fe.join(n,Hy),i=fe.join(n,Jy),a=await X(r),o=a!==null,s=a?Buffer.byteLength(a,"utf8"):0,c=a?nu(a):yw(),l=await X(i),{runtimeState:d,stateParseFailed:u}=ww(l),m=e.telemetry.endpoint.trim(),p=qr(m),f=await vw(e,t.checkTelemetry),g=[];u&&g.push("telemetry_state_invalid_json"),g.push(...bw(e,c,d),...kw(f),...xw(f),...Sw(e,d));let h=Aw(e,c),w=typeof d.pending_otel_spans=="number"?d.pending_otel_spans:0;return{check:{name:"telemetry",status:g.length===0?"ok":"warn",ok:g.length===0,details:{enabled:e.telemetry.enabled,capture_level:e.telemetry.capture_level,endpoint:p,global_pm_root:n,queue_path:r,queue_exists:o,queue_entries:c.validEntries,queue_draining:Rw(h,g),queue_invalid_rows:c.invalidRows,queue_rows_total:c.totalRows,queue_size_bytes:s,queue_high_retry_entries:c.highRetryEntries,queue_high_retry_threshold:Zd,queue_max_attempts:c.maxAttempts,runtime_state_path:i,last_attempted_flush_at:d.last_attempted_flush_at??null,last_successful_flush_at:d.last_successful_flush_at??null,last_failed_flush_at:d.last_failed_flush_at??null,last_failed_flush_error:d.last_failed_flush_error??null,pending_otel_spans:w,last_otel_attempt_at:d.last_otel_attempt_at??null,last_otel_success_at:d.last_otel_success_at??null,last_otel_failure_at:d.last_otel_failure_at??null,last_otel_failure_error:d.last_otel_failure_error??null,endpoint_probe:f??{attempted:!1},env_overrides:Ew()}},warnings:g}}async function Cw(e){let t;try{t=await Rc(e)}catch(r){let i=r instanceof Error?r.message:String(r);return{check:{name:"locks",status:"warn",ok:!1,details:{active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0,scan_failed:!0,error:i,pm_root:e}},warnings:[`locks_scan_failed:${i}`]}}let n=[];return t.stale_lock_count>0&&n.push(`locks_stale_count:${t.stale_lock_count}`),t.unreadable_lock_count>0&&n.push(`locks_unreadable:${t.unreadable_lock_count}`),{check:{name:"locks",status:n.length===0?"ok":"warn",ok:n.length===0,details:{active_lock_count:t.active_lock_count,stale_lock_count:t.stale_lock_count,unreadable_lock_count:t.unreadable_lock_count,unparseable_lock_count:t.unparseable_lock_count}},warnings:n}}async function $w(e,t){let n="metadata",{missingStreams:r,unreadableStreams:i,hashMismatches:a,chainMismatches:o,driftedItems:s,workspaceStateMismatches:c,workspaceStateMissing:l,workspaceStateUnreadable:d}=await yr(e,t,{cacheHitVerification:n}),u=[...r.map(m=>`history_drift_missing_stream:${m}`),...i.map(m=>`history_drift_unreadable_stream:${m}`),...a.map(m=>`history_drift_hash_mismatch:${m}`),...o.map(m=>`history_drift_chain_mismatch:${m}`),...c.map(m=>`history_drift_workspace_state_mismatch:${m}`),...l.map(m=>`history_drift_workspace_state_missing:${m}`),...d.map(m=>`history_drift_workspace_state_unreadable:${m}`)];return{check:{name:"history_drift",status:u.length===0?"ok":"warn",ok:u.length===0,details:{checked_items:t.length,cache_hit_verification:n,drifted_items:s,counts:{drifted:s.length,missing_streams:r.length,unreadable_streams:i.length,hash_mismatches:a.length,chain_mismatches:o.length,workspace_state_mismatches:c.length,workspace_state_missing:l.length,workspace_state_unreadable:d.length},missing_streams:r,unreadable_streams:i,hash_mismatches:a,chain_mismatches:o,workspace_state_mismatches:c,workspace_state_missing:l,workspace_state_unreadable:d}},warnings:u}}function Tw(e,t){let n=nr(e),r=nn(n.settings),i=rr(n.settings,t),a=r.active?ft(r.active.name,r.active.model):null;return{runtimeDefaults:n,providerResolution:r,vectorStoreResolution:i,runtimeEmbeddingIdentity:a,semanticRuntimeAvailable:!!(r.active&&i.active)}}function Ow(){return{refreshed:[],skipped:[],warnings:[]}}async function Dw(e){return!e.refreshPolicy.enabled||!e.snapshot.semanticRuntimeAvailable||e.staleBefore.length===0?Ow():Cs(e.pmRoot,e.staleBefore,{settings:e.snapshot.runtimeDefaults.settings,apply_runtime_defaults:!1})}function Pw(e){return e.strictVectorizationWarnings&&e.semanticRuntimeAvailable&&!!(e.ledgerBefore.embedding&&e.runtimeEmbeddingIdentity&&Pt(e.ledgerBefore.embedding,e.runtimeEmbeddingIdentity))}function Nw(e){let t=new Set([...e.ledgerBefore.warnings,...e.ledgerAfter.warnings]);if(e.strictVectorizationWarnings)for(let n of e.refreshResult.warnings)t.add(n);return e.embeddingIdentityChanged&&t.add("vectorization_embedding_identity_changed"),e.strictVectorizationWarnings&&e.semanticRuntimeAvailable&&e.staleAfter.length>0&&t.add(`vectorization_stale_items_remaining:${e.staleAfter.length}`),[...t].sort((n,r)=>n.localeCompare(r))}function Mw(e,t,n){return e.enabled&&t&&n.length>0?null:e.enabled?t?"no_stale_items":"semantic_runtime_unavailable":"refresh_disabled"}function iu(e,t){let n=t.providerResolution.active?.name??null,r=t.vectorStoreResolution.active?.name??null;return{provider_active:n,provider_configured:typeof e.search?.provider=="string"?e.search.provider:null,provider_source:xi(n,e.search?.provider??null),vector_store_active:r,vector_store_configured:typeof e.vector_store?.adapter=="string"?e.vector_store.adapter:null,vector_store_source:xi(r,e.vector_store?.adapter??null)}}function Lw(e){return{enabled:e.enabled,check_only:e.checkOnly,no_refresh:e.noRefresh,refresh_vectors:e.refreshVectors}}function Fw(e,t,n){return e.enabled&&n.length>0&&t}async function jw(e,t,n,r,i){let a=Tw(t,e),o=await Nt(e),s=a.semanticRuntimeAvailable?Ai(n,o.entries):[],c=await Dw({pmRoot:e,snapshot:a,refreshPolicy:r,staleBefore:s}),l=await Nt(e),d=a.semanticRuntimeAvailable?Ai(n,l.entries):[],u=!a.runtimeDefaults.auto_ollama_defaults_applied,m=Pw({strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,ledgerBefore:o,runtimeEmbeddingIdentity:a.runtimeEmbeddingIdentity}),p=Nw({ledgerBefore:o,ledgerAfter:l,refreshResult:c,strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,embeddingIdentityChanged:m,staleAfter:d}),f=La(s,i),g=La(d,i),h=Fw(r,a.semanticRuntimeAvailable,s);return{check:{name:"vectorization",status:p.length===0?"ok":"warn",ok:p.length===0,details:{semantic_runtime_available:a.semanticRuntimeAvailable,compatibility_mode_auto_defaults:a.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_applied:a.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:a.runtimeDefaults.auto_ollama_defaults_skipped_reason??null,auto_ollama_defaults_remediation:a.runtimeDefaults.auto_ollama_defaults_remediation??null,refresh_policy:Lw(r),...iu(t,a),embedding_identity_changed:m,embedding_identity_before:o.embedding??null,embedding_identity_runtime:a.runtimeEmbeddingIdentity??null,items:n.length,ledger_entries_before:Object.keys(o.entries).length,stale_items_detail_mode:i?"full":"summary",stale_items_summary_limit:Xd,stale_items_before_total:f.total,stale_items_before:f.values,stale_items_before_truncated:f.truncated,refresh_attempted:h,refresh_skipped_reason:Mw(r,a.semanticRuntimeAvailable,s),refresh_result:c,ledger_entries_after:Object.keys(l.entries).length,stale_items_after_total:g.total,stale_items_after:g.values,stale_items_after_truncated:g.truncated}},warnings:p}}function Uw(e){let t=[];return e.id_prefix.trim().length===0&&t.push("settings:id_prefix_empty"),e.locks.ttl_seconds<=0&&t.push("settings:locks_ttl_non_positive"),t}function au(e){let t=e.checkOnly===!0,n=e.refreshVectors===!0;if(n&&t)throw new _("--check-only cannot be combined with --refresh-vectors",y.USAGE);if(n&&e.noRefresh===!0)throw new _("--no-refresh cannot be combined with --refresh-vectors",y.USAGE);return{enabled:n,checkOnly:t,noRefresh:!n,refreshVectors:n}}var zw=new Set(["extensions","locks","search"]);function Gw(e){let t=new Set(wo.filter(i=>i.length>0)),n=new Set,r=new Set(Object.values(vo));for(let i of e.folders)t.has(i)&&!r.has(i)||(t.delete(i),n.add(i));for(let i of zw)t.delete(i),n.add(i);return{requiredDirs:[...t].sort((i,a)=>i.localeCompare(a)),optionalDirs:[...n].sort((i,a)=>i.localeCompare(a)),optionalDirSet:n}}async function qw(e,t,n){let{requiredDirs:r,optionalDirs:i,optionalDirSet:a}=Gw(t),o=[],s=[],c=[];for(let l of[...r,...i]){let d=fe.join(e,l);c.push(...await We({path:d,scope:"project"})),!await Ua(d)&&(a.has(l)?s.push(l):o.push(l))}return{requiredDirs:r,optionalDirs:i,missingRequiredDirs:o,missingOptionalDirs:s,missingDirs:n?[...o,...s]:[...o],hookWarnings:c}}function ou(e){let t=e.checkOnly===!0&&e.brief!==!0&&e.summary!==!0&&e.full!==!0,n=(e.summary===!0||t)&&e.full!==!0,r=e.checkOnly===!0&&(e.brief===!0||e.summary===!0)&&e.full!==!0;return{summaryMode:n,skipIntegrity:(e.skipIntegrity===!0||r)&&e.full!==!0,skipDrift:(e.skipDrift===!0||r)&&e.full!==!0,skipVectors:(e.skipVectors===!0||r)&&e.full!==!0}}async function Ww(e){return e.skipPolicy.skipDrift&&e.skipPolicy.skipVectors?Be(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema):tr(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema)}function Pa(e){return{check:{name:e,status:"ok",ok:!0,details:{skipped:!0}},warnings:[]}}function Bw(e,t,n){return{name:"settings",status:n.length===0?"ok":"warn",ok:n.length===0,details:{path:e,version:t.version,id_prefix:t.id_prefix,locks_ttl_seconds:t.locks.ttl_seconds,warnings:n}}}function Hw(e,t){return{name:"directories",status:e.missingDirs.length===0?"ok":"warn",ok:e.missingDirs.length===0,details:{required:e.requiredDirs,optional:e.optionalDirs,missing_required:e.missingRequiredDirs,missing_optional:e.missingOptionalDirs,missing:e.missingDirs,strict_directories:t}}}function Jw(e){return{name:"settings_values",status:e.length===0?"ok":"warn",ok:e.length===0,details:{warnings:e}}}var za=e=>e.unknown_event_count??0,Ga=e=>e.actionable_unknown_event_count??za(e);function Vw(e,t,n,r,i,a,o){let s=za(r),c=Ga(r),l=s>0,d=c>0,u=i.count>0;return{name:"storage",status:n.over_threshold.length===0&&n.orphaned.length===0&&!d&&!u?"ok":"warn",ok:n.over_threshold.length===0&&n.orphaned.length===0&&!d&&!u,details:{items:e.length,history_streams:n.count,tombstones:{retention_policy:"retain_append_only",gc_enabled:!1,count:n.tombstones.length,ids:n.tombstones.slice(0,25),truncated:n.tombstones.length>25},orphaned_history_streams:{count:n.orphaned.length,ids:n.orphaned.slice(0,25),truncated:n.orphaned.length>25},...l?{author_attribution:r}:{},...u?{stale_in_progress:i}:{},...a.length>0?{provenance_resolver_outcomes:a}:{},...o.length>0?{provenance_invalid_values:o}:{},...n.max_entries!==null?{compact_policy:{enabled:t.history.compact_policy.enabled,max_entries:n.max_entries,trigger:t.history.compact_policy.trigger,over_threshold_count:n.over_threshold.length,over_threshold:n.over_threshold}}:{}}}}function su(e){let t=e.count===0?[]:[`stale_in_progress_items:${e.count}`];return{scan:e,warnings:t}}function Kw(e){let t=[...e.directoryState.missingDirs.map(n=>`missing_directory:${n}`),...e.normalizedSettingsReadWarnings,...e.settingWarnings,...e.normalizedItemReadWarnings,...e.telemetryCheck.warnings,...e.extensionCheck.warnings,...e.historyPolicyWarnings,...e.historySummary.warnings,...e.authorAttributionWarnings,...e.staleInProgressWarnings,...e.provenanceWarnings,...e.locksCheck.warnings,...e.integrityCheck.warnings,...e.historyDriftCheck.warnings,...e.vectorizationCheck.warnings,...e.directoryState.hookWarnings];return[...new Set(t)]}function Yw(e){let t=e.check.details.counts;return typeof t?.drifted=="number"?t.drifted:0}function Xw(e){return{settings:e.normalizedSettingsReadWarnings,directories:e.directoryState.missingDirs.map(t=>`missing_directory:${t}`).concat(e.directoryState.hookWarnings),settings_values:e.settingWarnings,telemetry:e.telemetryCheck.warnings,extensions:e.extensionCheck.warnings,storage:[...e.historyPolicyWarnings,...e.historySummary.over_threshold.map(t=>`history_stream_over_compact_threshold:${t}`),...e.authorAttributionWarnings,...e.staleInProgressWarnings,...e.provenanceWarnings],locks:e.locksCheck.warnings,integrity:[...e.normalizedItemReadWarnings,...e.integrityCheck.warnings],history_drift:e.historyDriftCheck.warnings,vectorization:e.vectorizationCheck.warnings}}function cu(e){let t=new Map;for(let[i,a]of Object.entries(e.remediationSources))for(let o of a)t.has(o)||t.set(o,i);let n=new Map(e.checks.map(i=>[i.name,i]));return e.warnings.map(i=>{let a=t.get(i)??"integrity",o=qi(i)?.code??ja(i),s=n.get(a)?.details,l=(typeof s?.remediation_map=="object"&&s.remediation_map!==null?s.remediation_map:{})[o],d=Fa(i,e.requireMergeDrivers)?"advisory":"gate_failing";return{warning:i,code:o,check:a,severity:d,...typeof l=="string"?{remediation:l}:d==="gate_failing"?{disposition:"no_safe_automatic_remediation"}:{}}})}function Zw(e){if(e.check.name==="history_drift"&&e.historyDriftedCount>1)for(let t of Object.keys(e.remediationMap))e.remediationMap[t]="pm history-repair --all";if(e.check.name==="storage"&&e.overThresholdCount>1)for(let t of Object.keys(e.remediationMap))e.remediationMap[t]="pm history-compact --all-streams"}function Qw(e){for(let t of e.checks){let n=Wi(e.remediationSources[t.name]);Zw({check:t,remediationMap:n,historyDriftedCount:e.historyDriftedCount,overThresholdCount:e.overThresholdCount}),Object.keys(n).length>0&&(t.details={...t.details,remediation_map:n})}}function lu(e,t,n){let r=e.warning_count??e.warnings.length,i={...e,warning_count:r,warning_limit:xn,warnings_truncated:r>xn,warnings:e.warnings.slice(0,xn),findings:(e.findings??[]).filter(o=>e.warnings.slice(0,xn).includes(o.warning)||e.failed_because.includes(o.warning))},a=n?gw(i):t.brief===!0?hw(i):i;return{...a,warning_count:r,warning_limit:xn,warnings_truncated:r>a.warnings.length,...a.projection?{projection:{...a.projection,warning_count:r,warnings_truncated:r>a.warnings.length}}:{}}}async function du(e,t={}){let n=L(process.cwd(),e.path),r=K(n);if(!await A(r))throw new _(`Tracker is not initialized at ${n}. Run pm init first.`,y.NOT_FOUND);let{settings:i,warnings:a}=await ss(n),o=[...new Set(a)],s=G(i,z()),c=t.strictDirectories===!0,l=au(t),d=await qw(n,s,c),u=Uw(i),m=await Iw(i,{checkTelemetry:t.checkTelemetry===!0}),p=await dw(n,i,!!e.noExtensions),f=ou(t),g=[],h=await Ww({pmRoot:n,settings:i,typeRegistry:s,skipPolicy:f,itemReadWarnings:g}),w=h,v=[...new Set(g)],b=f.skipDrift?{warnings:[]}:await cs({pmRoot:n,settings:i,itemIds:h.map(si=>si.id),commandLabel:"health"}),x=await Qy(n,i.history.compact_policy,await Xy(n)),R=await cn(n,20,t.verboseAuthorEvents===!0),k=Ga(R),F=k>0?[`history_unknown_author_events:${k}`]:[],T=su(await $s(n,h,{in_progress_status:i.schema.workflow.in_progress_status,threshold_hours:i.mutation_guard.stale_in_progress_hours})),E=await wc(n),U=E.outcomes,B=E.invalid_values,D=E.warnings,W=await Cw(n),ge=f.skipIntegrity?Pa("integrity"):await rw(n,s.type_to_folder,i.schema,t.requireMergeDrivers===!0),ue=f.skipDrift?Pa("history_drift"):await $w(n,w),ze=f.skipVectors?Pa("vectorization"):await jw(n,i,w,l,t.verboseStaleItems===!0),Oe=[Bw(r,i,o),Hw(d,c),Jw(u),m.check,p.check,Vw(h,i,x,R,T.scan,U,B),W.check,ge.check,ue.check,ze.check],M=Kw({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:b.warnings,historySummary:x,authorAttributionWarnings:F,staleInProgressWarnings:T.warnings,provenanceWarnings:D,locksCheck:W,integrityCheck:ge,historyDriftCheck:ue,vectorizationCheck:ze}),H=Xw({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:b.warnings,historySummary:x,authorAttributionWarnings:F,staleInProgressWarnings:T.warnings,provenanceWarnings:D,locksCheck:W,integrityCheck:ge,historyDriftCheck:ue,vectorizationCheck:ze});Qw({checks:Oe,remediationSources:H,historyDriftedCount:Yw(ue),overThresholdCount:x.over_threshold.length});let ai=M.filter(si=>!Fa(si,t.requireMergeDrivers===!0)),oi=cu({warnings:M,checks:Oe,remediationSources:H,requireMergeDrivers:t.requireMergeDrivers===!0}),Ym={ok:ai.length===0,checks:Oe,warnings:M,findings:oi,failed_because:ai,generated_at:$()};return lu(Ym,t,f.summaryMode)}var j$={buildExtensionHealthTriageSummary:eu,buildHealthFindings:cu,buildCapabilityContractMetadata:bn,buildStaleInProgressHealthSummary:su,buildVectorizationProviderDetails:iu,collectUnknownCapabilityGuidance:vn,isAdvisoryHealthWarning:Fa,isDirectory:Ua,isExpectedUnmanagedExtension:Na,listItemDocumentPaths:Qd,normalizeEndpointForDisplay:qr,normalizeExtensionNameForMatch:Jt,parseTelemetryQueue:nu,probeTelemetryEndpointHealth:ru,projectHealthResult:lu,resolveActionableUnknownAuthorEventCount:Ga,resolveHealthSkipPolicy:ou,resolveUnknownAuthorEventCount:za,resolveVectorRefreshPolicy:au,selectStaleItemDetail:La,summarizeHealthCheckDetails:tu,summarizeExtensionList:Gr,summarizeRecordList:Qe,summarizeStringList:V,telemetryEnvFlagEnabled:Ht,warningCode:ja};import Vt from"node:fs/promises";import Kt from"node:path";(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]="59b566d5-1d4f-500b-98e3-004e6f57d2b4")}catch{}})();async function ev(e,t){let n=[...new Set(Object.values(t))],r=[];return await Promise.all(n.map(async i=>{let a;try{a=await Vt.readdir(Kt.join(e,i))}catch{return}for(let o of a)for(let s of Qt)if(o.toLowerCase().endsWith(s)){r.push({relativePath:`${i}/${o}`,id:o.slice(0,-s.length)});break}})),r.sort((i,a)=>i.relativePath.localeCompare(a.relativePath))}function tv(e,t){let{id:n,relativePath:r,liveItemIds:i,out:a}=e,o=Ct(t);if(o){a.conflictMarkers.push({id:n,path:r,line:o.line,detail:`unresolved merge conflict marker ${o.marker}`});return}let s=null,c=t.split(/\r?\n/).map((l,d)=>({content:l.trim(),number:d+1})).filter(l=>l.content.length>0);for(let l of c)try{let d=JSON.parse(l.content);if(typeof d!="object"||d===null||Array.isArray(d))throw new TypeError("history entry must be an object");s=d}catch{a.unparseable.push({id:n,path:r,line:l.number,detail:"history line is not a valid JSON object"});return}s!==null&&(s.op==="delete"&&i.has(n)&&a.resurrected.push({id:n,deleted_at:typeof s.ts=="string"?s.ts:"",deleted_by:typeof s.author=="string"?s.author:""}),s.op==="history_repair"&&Array.isArray(s.patch)&&s.patch.length>0&&(a.repairReconciliations+=1))}function qa(e,t){let n=typeof t=="object"&&t!==null&&"code"in t&&typeof t.code=="string"?t.code:"UNKNOWN";return`${e} could not be read (error code: ${n})`}async function nv(e,t){let n={conflictMarkers:[],unparseable:[],resurrected:[],repairReconciliations:0,scanned:0},r;try{r=await Vt.readdir(Kt.join(e,"history"))}catch{return n}for(let i of r.sort((a,o)=>a.localeCompare(o))){if(!i.endsWith(".jsonl"))continue;n.scanned+=1;let a;try{a=await Vt.readFile(Kt.join(e,"history",i),"utf8")}catch(o){n.unparseable.push({id:i.slice(0,-6),path:`history/${i}`,detail:qa("history stream",o)});continue}tv({id:i.slice(0,-6),relativePath:`history/${i}`,liveItemIds:t,out:n},a)}return n}function uu(e){let t=Ct(e);if(t)return`unresolved merge conflict marker ${t.marker} at line ${t.line}`;try{return JSON.parse(e),null}catch(n){return`invalid JSON (${String(n)})`}}async function rv(e){let t=[],n=0,r=null;try{r=await X(K(e))}catch(a){n+=1,t.push({path:"settings.json",detail:qa("configuration file",a)})}if(r!==null){n+=1;let a=uu(r);a!==null&&t.push({path:"settings.json",detail:a})}let i;try{i=await Vt.readdir(Kt.join(e,"schema"))}catch{return{scanned:n,unparseable:t}}for(let a of i.sort((o,s)=>o.localeCompare(s))){if(!a.endsWith(".json"))continue;n+=1;let o;try{o=await Vt.readFile(Kt.join(e,"schema",a),"utf8")}catch(c){t.push({path:`schema/${a}`,detail:qa("configuration file",c)});continue}let s=uu(o);s!==null&&t.push({path:`schema/${a}`,detail:s})}return{scanned:n,unparseable:t}}async function mu(e,t,n,r={}){let i=await ev(e,n),a=new Set(i.map(u=>u.id)),o=new Map;for(let u of i){let m=o.get(u.id);m===void 0?o.set(u.id,[u.relativePath]):m.push(u.relativePath)}let s=[...o.entries()].filter(([,u])=>u.length>1).map(([u,m])=>({id:u,paths:[...m].sort((p,f)=>p.localeCompare(f))})).sort((u,m)=>u.id.localeCompare(m.id)),c=(await Promise.all(i.map(async u=>{if(!t.has(u.id))return{path:u.relativePath,id:u.id};try{let m=Kt.join(e,u.relativePath);return $t(await Vt.readFile(m,"utf8"),{format:m.toLowerCase().endsWith(".md")?"json_markdown":"toon",schema:r.schema,extensionFieldNames:r.extensionFieldNames}),null}catch{return{path:u.relativePath,id:u.id}}}))).filter(u=>u!==null),l=await nv(e,a),d=await rv(e);return{item_files_on_disk:i.length,item_ids_on_disk:a.size,parsed_items:t.size,unreadable_item_files:c,duplicate_item_ids:s,history_streams_scanned:l.scanned,history_conflict_marker_streams:l.conflictMarkers,history_unparseable_streams:l.unparseable,resurrected_items:l.resurrected,history_repair_reconciliations:l.repairReconciliations,config_files_scanned:d.scanned,unparseable_config_files:d.unparseable}}import{execFile as iv}from"node:child_process";import pu from"node:path";(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]="b8b3f729-be32-5a77-b08f-f616ee068e0f")}catch{}})();function fu(e,t){return new Promise((n,r)=>{iv("git",[...t],{cwd:e,encoding:"utf8",maxBuffer:4*1024*1024},(i,a)=>{i?r(i):n(a)})})}function hu(e){if(e&&(!Number.isSafeInteger(e.start)||!Number.isSafeInteger(e.end)||e.start<1||e.end<e.start))throw new RangeError("Source line range must be inclusive positive integers with end >= start.")}function X$(e){let t=/^(\d+):(\d+)$/u.exec(e.trim()),n=t?{start:Number(t[1]),end:Number(t[2])}:void 0;if(hu(n),!n)throw new RangeError("Source line range must use start:end.");return n}function av(e){let t=new Map;for(let n of e.split(`
43
- `)){let r=/^([0-9a-f^]{40,64}) \d+ \d+(?: \d+)?$/u.exec(n)?.[1];r&&t.set(r,(t.get(r)??0)+1)}return t}function ov(e){let t=e.split("\0"),n=new Map;for(let r=0;r+1<t.length;r+=2){let i=t[r]?.trim();if(!i)continue;let a=[...new Set(t[r+1]?.match(/\bpm-[a-z0-9][a-z0-9-]{2,63}\b/gu)??[])].sort((o,s)=>o.localeCompare(s));n.set(i,a)}return n}async function sv(e){let t=pu.relative(e.workspaceRoot,pu.resolve(e.workspaceRoot,e.sourcePath)),n=await fu(e.workspaceRoot,["blame","--line-porcelain","-L",`${e.lineRange.start},${e.lineRange.end}`,"--",t]),r=await fu(e.workspaceRoot,["log","-n","256","--format=%H%x00%B%x00","--",t]);return{commitLines:av(n),commitItems:ov(r),available:!0}}function cv(e){let t=e.current.nodes.at(-1),n=e.current.kinds.length+1,r;for(let i of e.graph.incidentEdges(t)){let a=i.source===t,o=a?i.target:i.source;if((e.visitedDepth.get(o)??Number.POSITIVE_INFINITY)<n)continue;e.visitedDepth.set(o,n);let s=e.graph.registry().require(i.kind),c={nodes:[...e.current.nodes,o],kinds:[...e.current.kinds,a?i.kind:s.inverse??i.kind]};e.details.get(o)?.type?.toLowerCase()==="decision"?(r=n,e.found.push(c)):e.queue.push(c)}return r}function lv(e){let t=[{nodes:[e.itemId],kinds:[]}],n=new Map([[e.itemId,0]]),r=[],i;for(;t.length>0;){let a=t.shift(),o=a.kinds.length;i!==void 0&&o>=i||o>=e.maxDepth||(i=cv({current:a,graph:e.graph,details:e.details,visitedDepth:n,queue:t,found:r})??i)}return r.sort((a,o)=>a.nodes.join("\0").localeCompare(o.nodes.join("\0"))),r}function dv(e,t,n){let r=Ns(t);if(!r.graph.hasNode(e))return{status:"not_found",nodes:[],kinds:[],alternative_decision_ids:[]};let i=lv({itemId:e,maxDepth:n,graph:r.graph,details:new Map(r.details.map(s=>[s.id,s]))}),a=i[0];if(!a)return{status:"not_found",nodes:[],kinds:[],alternative_decision_ids:[]};let o=[...new Set(i.map(s=>s.nodes.at(-1)))];return{status:o.length===1?"found":"ambiguous",nodes:a.nodes,kinds:a.kinds,alternative_decision_ids:o.slice(1)}}async function uv(e){if(!e.lineRange)return{commitLines:new Map,commitItems:new Map,available:!0};try{return await sv({workspaceRoot:e.workspaceRoot,sourcePath:e.paths[0],lineRange:e.lineRange})}catch{return{commitLines:new Map,commitItems:new Map,available:!1}}}function mv(e){let t=[];return e.hasLineRange&&!e.attributionAvailable&&t.push("git_attribution_unavailable"),e.hasLineRange&&e.contributionLines===0&&t.push("line_attribution_unmapped"),e.decisionStatus==="ambiguous"&&t.push("multiple_governing_decisions"),e.decisionStatus==="not_found"&&t.push("governing_decision_not_found"),t}function pv(e){return[...e.commitLines.keys()].filter(t=>(e.commitItems.get(t)?.length??0)>0)}async function gu(e){hu(e.lineRange);let t=e.decisionDepth??8;if(!Number.isSafeInteger(t)||t<1||t>32)throw new RangeError("Decision path depth must be an integer from 1 to 32.");let n=await uv(e),r=pv(n),i=new Map;for(let a of e.candidates){let o=[...n.commitLines.entries()].filter(([d])=>n.commitItems.get(d)?.includes(a.item.id)),s=o.reduce((d,[,u])=>d+u,0),c=dv(a.item.id,e.corpus,t),l=mv({hasLineRange:e.lineRange!==void 0,attributionAvailable:n.available,contributionLines:s,decisionStatus:c.status});i.set(a.item.id,{score:s*100+a.files.length*10+Math.max(0,9-Math.floor((Date.now()-Date.parse(a.item.updated_at))/(720*60*60*1e3))),contribution_lines:s,evidence:[...a.files.map(d=>({kind:"linked_file",reference:d.path})),...o.map(([d,u])=>({kind:"git_commit",reference:d.slice(0,12),contribution_lines:u}))],rationale:{value:a.item.value?.trim()||null,why_now:a.item.why_now?.trim()||null,outcome:a.item.outcome?.trim()||null,objective:a.item.objective?.trim()||null},decision_path:c,ambiguities:l})}return{explanations:i,receipt:{line_range:e.lineRange??null,blamed_commit_count:n.commitLines.size,mapped_commit_count:r.length,unmapped_commit_count:n.commitLines.size-r.length,decision_depth:t}}}import no from"node:fs/promises";import{realpathSync as gb}from"node:fs";import{execFile as _b}from"node:child_process";import he from"node:path";import{promisify as yb}from"node:util";(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]="ab236f47-a866-5236-b8da-f7f23140b978")}catch{}})();var fv=["metadata","resolution"],Wa=["metadata","resolution","estimates","lifecycle"],hv="completed";function Ba(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function _u(e){let t=e?.trim();return t!==void 0&&t.length>0?t:void 0}function yu(e){let t=[];for(let n of e){if(!n.missing_fields.includes("resolution"))continue;let r=_u(n.close_reason)??hv;t.push({item_id:n.id,check:"resolution",field:"resolution",kind:"set_resolution",value:r,command:`pm update ${n.id} --resolution ${Ba(r)}`,gate:"resolution"})}return t}function wu(e){let t=[];for(let n of e){let r=_u(n.resolution);r!==void 0&&t.push({item_id:n.id,check:"metadata",field:"close_reason",kind:"set_close_reason",value:r,command:`pm update ${n.id} --close-reason ${Ba(r)}`,gate:"metadata"})}return t}function vu(e,t){return e.map(n=>{let r=os(n.type,t);return{item_id:n.id,check:"metadata",field:"estimated_minutes",kind:"set_estimate",value:String(r),command:`pm update ${n.id} --estimate ${r}`,gate:"estimates"}})}function bu(e){return e.map(t=>t.grandparent_id!==void 0&&t.grandparent_active===!0?{item_id:t.id,check:"lifecycle",field:"parent",kind:"reparent",parent_id:t.grandparent_id,command:`pm update ${t.id} --parent ${t.grandparent_id}`,gate:"lifecycle"}:{item_id:t.id,check:"lifecycle",field:"parent",kind:"unset_parent",command:`pm update ${t.id} --unset parent`,gate:"lifecycle"})}function ku(e){let t=[];for(let n of e){if(n.classification!=="deleted")continue;let r=n.link_kind==="files"?"files":"docs";t.push({item_id:n.item_id,check:"files",field:n.link_kind,kind:n.link_kind==="files"?"prune_file_link":"prune_doc_link",path:n.path,command:`pm ${r} ${n.item_id} --remove ${Ba(n.path)}`})}return t}function xu(e){let t=(e??[]).flatMap(r=>r.split(",")).map(r=>r.trim()).filter(r=>r.length>0);if(t.length===0){if(e!==void 0&&e.length>0)throw new _(`--fix-scope values must not be empty. Supported values: ${Wa.join(", ")}.`,y.USAGE);return new Set(fv)}let n=new Set;for(let r of t){let i=r.toLowerCase().replaceAll("-","_");if(Wa.includes(i)){n.add(i);continue}throw new _(`Unknown --fix-scope value "${r}". Supported values: ${Wa.join(", ")}.`,y.USAGE)}return n}function Su(e,t){let n=[],r=[];for(let i of e)i.gate!==void 0&&!t.has(i.gate)?r.push(i):n.push(i);return{applicable:n,gated:r}}function En(e){return{item_id:e.item_id,check:e.check,field:e.field,command:e.command,...e.gate!==void 0?{gate:e.gate}:{}}}(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]="087bac58-e32d-5cb8-8fda-0e09075c3f35")}catch{}})();var gv=/^([A-Z][A-Z0-9]*-\d+)\b/;function _v(e){if(typeof e!="string")return null;let t=e.trim().toUpperCase();if(t.length===0)return null;let n=gv.exec(t);return n?n[1]:null}function Eu(e){return typeof e=="string"&&e.trim().length>0}function Au(e){let t=new Map;for(let r of e){if(typeof r.title!="string"||Eu(r.duplicate_of))continue;let i=_v(r.title);if(i===null)continue;let a=t.get(i);a||(a=[],t.set(i,a)),a.some(o=>o.id===r.id)||a.push({id:r.id,title:r.title,parent:Eu(r.parent)?r.parent.trim():null})}let n=[];for(let[r,i]of t){if(i.length<2)continue;let a=new Set(i.map(c=>c.id.toLowerCase())),o=i.filter(c=>c.parent===null||!a.has(c.parent.toLowerCase()));if(o.length<2)continue;let s=[...o].sort((c,l)=>c.id.localeCompare(l.id));n.push({code:r,count:s.length,ids:s.map(c=>c.id),titles:s.map(c=>c.title)})}return n.sort((r,i)=>r.code.localeCompare(i.code))}(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]="1951b0f1-11fa-5728-b516-7458a55b1e29")}catch{}})();function Ru(e){let t=new Map;for(let r of e){let i=t.get(r.item_type);i||(i=new Map,t.set(r.item_type,i)),i.set(r.field,(i.get(r.field)??0)+1)}let n={};for(let r of[...t.keys()].sort((i,a)=>i.localeCompare(a))){let i=t.get(r),a={};for(let o of[...i.keys()].sort((s,c)=>s.localeCompare(c)))a[o]=i.get(o);n[r]=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]="5a5b0bd8-d99b-52fb-82ae-52ba48c54c30")}catch{}})();var Iu=3;function Cu(e){let t=Math.max(e.lastIndexOf("/"),e.lastIndexOf("\\"));return t===-1?e:e.slice(t+1)}function $u(e,t,n=Iu){let r=Number.isFinite(n)&&n>=1?Math.floor(n):Iu,i=new Map;for(let a of t){let o=Cu(a);if(o.length===0)continue;let s=i.get(o);s?s.push(a):i.set(o,[a])}return e.map(a=>{let o=(i.get(Cu(a))??[]).filter(s=>s!==a).sort((s,c)=>s.localeCompare(c));return o.length===0?{path:a,classification:"deleted",candidates:[],candidates_truncated:!1}:{path:a,classification:"moved",candidates:o.slice(0,r),candidates_truncated:o.length>r}})}function Tu(e){return e.map(t=>t.classification==="moved"?`${t.path}:moved:${t.candidates[0]}`:`${t.path}:deleted`)}(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]="2b9ba0a4-396f-5870-bc89-e7fc789bb49d")}catch{}})();var yv=/^[a-z][a-z0-9+.-]+:\/\//i;function An(e){return yv.test(e.trim())}(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]="e063d634-4306-5725-927a-5f2af1722458")}catch{}})();function wv(e,t){return e==="moved"||t==="moved"?"moved":"deleted"}function Ou(e){return`${e.item_id} ${e.link_kind}`}function Du(e,t){let n=new Map;for(let r of e){let i=n.get(r.path);i?(i.classification=wv(i.classification,r.classification),i.owners.set(Ou(r),r)):n.set(r.path,{classification:r.classification,owners:new Map([[Ou(r),r]])})}return[...n.entries()].sort(([r],[i])=>r.localeCompare(i)).map(([r,i])=>({path:r,classification:i.classification,items:[...i.owners.values()].map(a=>{let o=t(a.item_id);return{id:a.item_id,type:o?.type??"Unknown",title:o?.title??"",status:o?.status??"",field:a.link_kind}}).sort((a,o)=>{let s=a.id.localeCompare(o.id);return s!==0?s:a.field.localeCompare(o.field)})}))}function vv(e){return e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}function Pu(e){let t=[];for(let n of e)for(let r of n.items)t.push(`${n.path}:${n.classification} owner=${r.id} status=${r.status} field=${r.field} title="${vv(r.title)}"`);return t}import bv from"node:fs/promises";import Re from"node:path";import kv from"fast-glob";(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]="256b39b7-882e-553c-9dea-813bfd363dd7")}catch{}})();var xv=["path","scope","note"],Sv=["pattern","glob","path","scope","note"],Ev=["path"],Av=["from","to"],Rv=new Set(["note","scope"]);function Mu(e){let t=e??"project";if(!ci.includes(t))throw new _(`Invalid scope "${e}". Valid scopes: ${ci.join(", ")} (default: project).`,y.USAGE);return t}function Lu(e){if(e.startsWith("```")||e.includes(`
44
- `)||/^(?:[-*+]\s+)?(?:path|scope|note)\s*[:=]/i.test(e))return!0;let t=e.indexOf("=");return t>=0&&!/\s/u.test(e)&&(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(e)||/^(?:[A-Za-z]:[\\/]|[\\/]{1,2}|\.\.?(?:[\\/]))/u.test(e)||[e.indexOf("/"),e.indexOf("\\")].some(n=>n>=0&&n<t))?!1:e.includes("=")||gs(e)}function Iv(e){return e.flatMap(t=>{let n=t.trim();return n.length===0||Lu(n)||!n.includes(",")?[t]:ir(n)})}function Cv(e,t){return e?Iv(e).map(n=>{let r=n.trim(),i=Lu(r)?en(n,"--add"):{path:r};if(tn(i,"--add",xv),!i.path)throw new _(`--add requires path=<value> or a bare ${t} path`,y.USAGE);return{path:i.path,scope:Mu(i.scope),note:i.note?.trim()||void 0}}):[]}function $v(e){return e?e.map(t=>{let n=t.trim();if(!n)throw new _("--add-glob requires a glob pattern value",y.USAGE);if(n.includes("=")||/^(?:[-*+]\s+)?(?:pattern|glob|path)\s*[:=]/i.test(n)||n.startsWith("```")){let r=en(n,"--add-glob");tn(r,"--add-glob",Sv);let i=r.pattern?.trim()||r.glob?.trim()||r.path?.trim();if(!i)throw new _("--add-glob key/value form requires pattern=<glob>",y.USAGE);return{pattern:i,scope:Mu(r.scope),note:r.note?.trim()||void 0}}return{pattern:n,scope:"project"}}):[]}function Tv(e){return e?e.map(t=>{let n=t.trim();if(!n)throw new _("--remove requires a path value",y.USAGE);if(n.includes("=")||/^(?:[-*+]\s+)?path\s*[:=]/i.test(n)||n.startsWith("```")){let r=en(n,"--remove"),i=Object.keys(r).filter(a=>Rv.has(a.toLowerCase()));if(i.length>0)throw new _(`--remove identifies a linked artifact by path only and does not accept ${i.map(a=>`"${a}"`).join(", ")}. Pass just the path (path=<value>, path:<value>, or a bare path); record removal context with --message "<why removed>".`,y.USAGE);if(tn(r,"--remove",Ev),!r.path)throw new _("--remove key/value form requires path=<value>",y.USAGE);return r.path}return n}):[]}function Ov(e){return e?e.map(t=>{let n=en(t,"--migrate");tn(n,"--migrate",Av);let r=n.from?.trim(),i=n.to?.trim();if(!r||!i)throw new _("--migrate requires from=<value> and to=<value>",y.USAGE);return{from:r,to:i}}):[]}function Rn(e,t){let n=e;for(let r of t)n.startsWith(r.from)&&(n=`${r.to}${n.slice(r.from.length)}`);return n}function Dv(e,t,n=[]){if(e.length===0||t.length===0)return;let r=new Set(e.map(a=>Rn(a.path,n))),i=[...new Set(t.map(a=>Rn(a,n)).filter(a=>r.has(a)))].sort((a,o)=>a.localeCompare(o));if(i.length!==0)throw new _(`Linked artifact mutation cannot add and remove the same normalized path in one transaction: ${i.join(", ")}. Split the replacement into separate commands so each history event has one unambiguous intent.`,y.USAGE,{code:"linked_artifact_mutation_conflict",reason:"same_path_added_and_removed",required:"Use distinct normalized paths for --add and --remove in one invocation.",why:"Conflicting batch intent cannot be applied deterministically without silently discarding metadata or a removal.",nextSteps:["Run the removal and addition as separate commands with a --message describing each intent."]})}function tt(e){return e.split(Re.sep).join("/")}function Ha(e,t,n=process.cwd()){let r=e.trim();if(An(r))return r;if(Re.isAbsolute(r)||/^[A-Za-z]:[\\/]/.test(r))return tt(r.replaceAll("\\",Re.sep));let i=Re.relative(t,n);return i.startsWith(`..${Re.sep}`)||i===".."||Re.isAbsolute(i)?tt(Re.normalize(r)):tt(Re.relative(t,Re.resolve(n,r)))}async function Pv(e,t=process.cwd(),n=process.cwd()){let r=[];for(let i of e){let a=Re.isAbsolute(i.pattern),o=await kv(i.pattern,{cwd:n,absolute:a,onlyFiles:!0,dot:!0,unique:!0,followSymbolicLinks:!0}),s=[...new Set(o.map(c=>Ha(c,t,n)))].sort((c,l)=>c.localeCompare(l));for(let c of s)r.push({path:c,scope:i.scope,note:i.note})}return r}function Nv(e,t,n){if(t===void 0)return e;if(!n)throw new _("--note requires --add or --add-glob in the same invocation (the note annotates the links being added)",y.USAGE);let r=t.trim();return r.length===0?e:e.map(i=>i.note===void 0?{...i,note:r}:i)}function Mv(e){return`${e.path}::${e.scope}`}function Ja(e){return[...e].sort((t,n)=>{let r=t.path.localeCompare(n.path);return r!==0?r:t.scope.localeCompare(n.scope)})}function Va(e){return[...new Map(e.map(t=>[Mv(t),t])).values()].map(t=>({...t,note:t.note?.trim()||void 0}))}async function Lv(e,t=process.cwd()){let n=[...new Set(e)].sort((s,c)=>s.localeCompare(c)),r=[],i=[],a=[],o=[];for(let s of n){if(An(s)){o.push(s.trim());continue}let c=Re.isAbsolute(s)?s:Re.resolve(t,s);try{(await bv.stat(c)).isFile()?r.push(s):a.push(s)}catch(l){if(typeof l=="object"&&l!==null&&"code"in l&&Pn(l)){i.push(s);continue}a.push(s)}}return{checked:n.length,existing_files:r,missing_paths:i,non_file_paths:a,remote_references:o}}function Fv(e,t,n,r){let i=0;for(let o=0;o<e.length;o+=1){let s=Rn(e[o].path,r);s!==e[o].path&&(e[o]={...e[o],path:s},i+=1)}return{adds:t.map(o=>{let s=Rn(o.path,r);return s!==o.path&&(i+=1),{...o,path:s}}),removes:n.map(o=>Rn(o,r)),count:i}}function jv(e,t,n,r){for(let a of t)e.some(o=>o.path===a.path&&o.scope===a.scope)||e.push(a);if(n.length>0)for(let a=e.length-1;a>=0;a-=1)n.includes(e[a].path)&&e.splice(a,1);let i=Va(e);return r?i:Ja(i)}async function Nu(e){let t=e.artifacts.map(n=>n.path);return{id:e.id,artifacts:e.artifacts,changed:e.changed,count:e.artifacts.length,migrations_applied:e.migrationsApplied&&e.migrationsApplied>0?e.migrationsApplied:void 0,validation:e.options.validatePaths?await Lv(t,e.workspaceRoot):void 0}}async function Wr(e,t,n,r){let{metadataKey:i}=r,a=_s(),o=L(process.cwd(),n.path),s=mt(o),c=process.cwd();if(!await A(K(o)))throw new _(`Tracker is not initialized at ${o}. Run pm init first.`,y.NOT_FOUND);let l=await I(o),d=G(l,z()),u=await a.resolveList(t.add,"--add"),m=await a.resolveList(t.addGlob,"--add-glob"),p=await a.resolveList(t.remove,"--remove"),f=await a.resolveList(t.migrate,"--migrate"),g=Cv(u,r.bareNoun).map(B=>({...B,path:Ha(B.path,s,c)})),h=$v(m),w=await Pv(h,s,c),v=Nv([...g,...w],t.note,g.length>0||h.length>0),b=Tv(p).map(B=>Ha(B,s,c)),x=Ov(f);if(Dv(v,b,x),!(v.length>0||b.length>0||x.length>0)){let B=await Tt(o,e,l.id_prefix,l.item_format,d.type_to_folder);if(!B)throw new _(`Item ${e} not found`,y.NOT_FOUND);let W=(await Ot(B,{schema:l.schema})).document.metadata[i]??[];return Nu({id:B.id,artifacts:W,changed:!1,options:t,workspaceRoot:s})}let k=Y(t.author,l.author_default),F=await pt({pmRoot:o,settings:l,id:e,op:r.op,author:k,message:t.message,force:t.force,skipNoop:!0,mutate(B){let D=B.metadata,W=D[i]??[],ge=[...W],ue=Fv(ge,v,b,x),ze=jv(ge,ue.adds,ue.removes,r.supportsAppendStable&&t.appendStable===!0);ze.length>0?D[i]=ze:delete D[i];let Oe=!$o(W,ze);return{changedFields:Oe?[i]:[],warnings:Oe&&ue.count>0?[`path_migrations_applied:${ue.count}`]:[]}}}),T=F.item[i]??[],E=F.warnings.find(B=>B.startsWith("path_migrations_applied:")),U=E?Number(E.slice(24)):0;return Nu({id:F.item.id,artifacts:T,changed:F.changedFields.includes(i),migrationsApplied:U,options:t,workspaceRoot:s})}function Br(e,t){let n={};for(let[r,i]of Object.entries(e))n[r==="artifacts"?t:r]=i;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]="c4c82f8f-7890-5ed2-8f0f-a82ba42cf807")}catch{}})();async function Fu(e,t,n){let r=await Wr(e,t,n,{metadataKey:"docs",op:"docs_add",bareNoun:"doc",supportsAppendStable:!1});return Br(r,"docs")}import ju from"node:fs/promises";import Ie from"node:path";(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]="515cd35c-8e0e-51d4-8ad9-1cea5be8a572")}catch{}})();var Uv=32768;function Ka(e){return tt(Ie.normalize(e))}async function Hr(e){try{return await ju.realpath(e)}catch{return Ie.resolve(e)}}function Yt(e,t){let n=Ie.isAbsolute(e.path)?Ie.resolve(e.path):Ie.resolve(t,e.path);return`${Ka(n)}::${e.scope}`}function Jr(e,t,n){if(typeof e=="string"){let r=e.trim();r.length>0&&n.push({field:t,value:r});return}if(Array.isArray(e)){e.forEach((r,i)=>Jr(r,`${t}[${i}]`,n));return}if(typeof e=="object"&&e!==null)for(let[r,i]of Object.entries(e))Jr(i,t?`${t}.${r}`:r,n)}function zv(e){let t=[];return Jr(e.metadata,"metadata",t),Jr(e.body,"body",t),t}function Gv(e){let t=e.trim();return t=t.replace(/^[`"'<([{]+/u,""),t=t.replace(/[`"'>)\]},;!?]+$/u,""),t=t.replace(/[.]+$/u,""),t=t.replace(/:(?:\d+)(?::\d+)?$/u,""),t=t.replace(/[.]+$/u,""),t}function qv(e){let t=[],n=/(?:[A-Za-z]:[\\/]|\/)[^\s"'`<>()[\]{},;]+/gu,r=/(?:\.{1,2}[\\/])?(?:(?:[A-Za-z0-9_.@-]+[\\/])+[A-Za-z0-9_.@-]+|[A-Za-z0-9_.@-]+\.[A-Za-z0-9][A-Za-z0-9._-]*)/gu;for(let i of e){let a=new Set,o=i.value.slice(0,Uv);for(let[s,c]of[[n,i.value],[r,o]]){s.lastIndex=0;for(let l of c.matchAll(s)){let d=Gv(l[0]);!d||a.has(d)||(a.add(d),t.push({field:i.field,value:d}))}}}return t}async function Wv(e,t,n=t){let r=Ie.isAbsolute(e)?Ie.resolve(e):Ie.resolve(n,e),i;try{i=await ju.stat(r)}catch{return}if(!i.isFile())return;let[a,o]=await Promise.all([Hr(t),Hr(r)]);if(_e(a,o)){let s=Ie.relative(a,o);return!s||s.startsWith("..")||Ie.isAbsolute(s)?void 0:{path:Ka(s),scope:"project"}}return{path:Ka(r),scope:"global"}}async function Bv(e,t,n=t){let r=new Set((e.metadata.files??[]).map(c=>Yt(c,t))),i=new Map,a=qv(zv(e)),o=new Map;await Promise.all([...new Set(a.map(c=>c.value))].map(async c=>{o.set(c,await Wv(c,t,n))}));let s=a.map(c=>({reference:c,resolved:o.get(c.value)}));for(let{reference:c,resolved:l}of s){if(!l)continue;let d=Yt(l,t),u=i.get(d)??{path:l.path,scope:l.scope,sourceFields:new Set,originalPaths:new Set,sourceCount:0};u.sourceFields.add(c.field),u.originalPaths.add(c.value),u.sourceCount+=1,i.set(d,u)}return[...i.entries()].map(([c,l])=>({path:l.path,scope:l.scope,status:r.has(c)?"already_linked":"addable",source_count:l.sourceCount,source_fields:[...l.sourceFields].sort((d,u)=>d.localeCompare(u)),original_paths:[...l.originalPaths].sort((d,u)=>d.localeCompare(u))})).sort((c,l)=>{let d=c.status.localeCompare(l.status);if(d!==0)return d;let u=c.path.localeCompare(l.path);return u!==0?u:c.scope.localeCompare(l.scope)})}async function Uu(e,t,n){let r=await Wr(e,t,n,{metadataKey:"files",op:"files_add",bareNoun:"file",supportsAppendStable:!0});return Br(r,"files")}async function Hv(e,t){let n=await Hr(t),r=await Promise.all(e.map(async a=>{let o=a.trim();if(!o)throw new _("Files lookup paths must not be empty.",y.USAGE);if(!Ie.isAbsolute(o))return tt(o);let s=await Hr(o);return _e(n,s)?tt(Ie.relative(n,s)):tt(s)})),i=[...new Set(r)].sort((a,o)=>a.localeCompare(o));if(i.length===0)throw new _("Files lookup requires at least one path.",y.USAGE);return i}function Jv(e){for(let[r,i]of[["limit",e.limit],["offset",e.offset]])if(i!==void 0&&(!Number.isInteger(i)||i<0))throw new _(`Files lookup ${r} must be a non-negative integer.`,y.USAGE);let{offset:t=0,limit:n=50}=e;return{offset:Math.max(0,Math.floor(t)),limit:e.noTruncate?void 0:Math.max(0,Math.floor(n))}}function zu(e){return{id:e.id,title:e.title,type:e.type,status:e.status,priority:e.priority,updated_at:e.updated_at}}function Gu(e,t){let n=e.item.priority-t.item.priority;if(n!==0)return n;let r=t.item.updated_at.localeCompare(e.item.updated_at);return r===0?e.item.id.localeCompare(t.item.id):r}function Vv(e){return e.metadata.map(t=>({item:t,files:(t.files??[]).filter(n=>e.paths.includes(tt(n.path))&&(e.scope===void 0||n.scope===e.scope)).sort((n,r)=>{let i=n.path.localeCompare(r.path);return i===0?n.scope.localeCompare(r.scope):i})})).filter(t=>t.files.length>0).sort(Gu)}async function Kv(e){if(e.explain)return gu({workspaceRoot:e.workspaceRoot,paths:e.paths,candidates:e.matching,corpus:e.metadata,...e.lineRange?{lineRange:e.lineRange}:{},...e.decisionDepth===void 0?{}:{decisionDepth:e.decisionDepth}})}async function Yv(e){if([e.strictRead,e.noTruncate,e.explain,es()].includes(!0))return null;let t=await er(e.pmRoot,[...new Set(Object.values(e.typeToFolder))]);return t?ds({pmRoot:e.pmRoot,expectedSourceCursor:t.source_cursor,paths:e.paths,scope:e.scope,limit:e.limit,offset:e.offset}):null}async function Xv(e){let t=[],n=await Dt(e.pmRoot,e.settings.item_format,e.typeToFolder,t,e.settings.schema),r=Vv({metadata:n,paths:e.paths,scope:e.scope}),i=t.filter(c=>/^item_list_(?:item|directory)_read_failed:/u.test(c));if(e.strictRead&&i.length>0)throw new _(`Files lookup could not read every item: ${i.join("; ")}`,y.GENERIC_FAILURE);let a=await Kv({explain:e.explain,workspaceRoot:e.workspaceRoot,paths:e.paths,matching:r,metadata:n,lineRange:e.lineRange,decisionDepth:e.decisionDepth}),s=(a?[...r].sort((c,l)=>{let d=a.explanations.get(l.item.id).score-a.explanations.get(c.item.id).score;return d!==0?d:Gu(c,l)}):r).slice(e.offset,e.limit===void 0?void 0:e.offset+e.limit);return{paths:e.paths,total:r.length,count:s.length,offset:e.offset,limit:e.limit??null,has_more:e.offset+s.length<r.length,truncated:e.offset+s.length<r.length,completeness:{status:i.length===0?"complete":"partial",source:"source_scan"},warnings:t,matches:s.map(c=>({item:zu(c.item),files:c.files,...a?{traceability:a.explanations.get(c.item.id)}:{}})),...a?{traceability_receipt:a.receipt}:{}}}async function WT(e,t){let n=L(process.cwd(),t.path),r=mt(n);if(!await A(K(n)))throw new _(`Tracker is not initialized at ${n}. Run pm init first.`,y.NOT_FOUND);let i=await Hv(e.paths,r);if(e.lineRange&&i.length!==1)throw new _("Files lookup line attribution requires exactly one source path.",y.USAGE);let a=await I(n),o=G(a,z()),{offset:s,limit:c}=Jv(e),l=await Yv({pmRoot:n,typeToFolder:o.type_to_folder,paths:i,scope:e.scope,limit:c,offset:s,strictRead:e.strictRead===!0,noTruncate:e.noTruncate===!0,explain:e.explain===!0||e.lineRange!==void 0});return l?{paths:i,total:l.total,count:l.matches.length,offset:s,limit:c,has_more:s+l.matches.length<l.total,truncated:s+l.matches.length<l.total,completeness:{status:"unchecked",source:"index"},warnings:[],matches:l.matches.map(d=>({item:zu(d.item),files:d.files}))}:Xv({pmRoot:n,settings:a,typeToFolder:o.type_to_folder,paths:i,scope:e.scope,limit:c,offset:s,strictRead:e.strictRead===!0,workspaceRoot:r,explain:e.explain===!0||e.lineRange!==void 0,lineRange:e.lineRange,decisionDepth:e.decisionDepth})}async function BT(e,t,n){let r=L(process.cwd(),n.path),i=mt(r);if(!await A(K(r)))throw new _(`Tracker is not initialized at ${r}. Run pm init first.`,y.NOT_FOUND);let a=await I(r),o=G(a,z()),s=await Tt(r,e,a.id_prefix,a.item_format,o.type_to_folder);if(!s)throw new _(`Item ${e} not found`,y.NOT_FOUND);let c=await Ot(s,{schema:a.schema}),l=await Bv(c.document,i,process.cwd()),d=l.filter(T=>T.status==="addable"),u=l.filter(T=>T.status==="already_linked"),m=t.apply===!0,p=t.note?.trim()||"discovered from item text";if(!m||d.length===0){let T=c.document.metadata.files??[];return{id:s.id,files:T,changed:!1,apply:m,count:T.length,candidate_count:l.length,addable_count:d.length,added_count:0,skipped_existing_count:u.length,candidates:l,added:[],skipped_existing:u}}let f=Y(t.author,a.author_default),g=d.map(T=>({path:T.path,scope:T.scope,note:p})),h=[],w=new Set,v=await pt({pmRoot:r,settings:a,id:e,op:"files_discover",author:f,message:t.message??"Discover referenced file links",force:t.force,mutate(T){let E=[...T.metadata.files??[]],U=new Set(E.map(W=>Yt(W,i)));h=[],w.clear();for(let[W,ge]of g.entries()){let ue=Yt(ge,i);U.has(ue)||(E.push(ge),U.add(ue),h.push(ge),w.add(W))}let B=Va(E),D=t.appendStable?B:Ja(B);return D.length>0?T.metadata.files=D:delete T.metadata.files,{changedFields:h.length>0?["files"]:[],warnings:h.length!==g.length?[`files_discover_skipped_existing:${g.length-h.length}`]:[]}}}),b=v.item.files??[],x=new Set(h.map(T=>Yt(T,i))),R=b.filter(T=>x.has(Yt(T,i))),k=d.filter((T,E)=>!w.has(E)),F=[...u,...k];return{id:v.item.id,files:b,changed:R.length>0,apply:!0,count:b.length,candidate_count:l.length,addable_count:d.length,added_count:R.length,skipped_existing_count:F.length,candidates:l,added:R,skipped_existing:F}}import{readFileSync as Zv}from"node:fs";import Vr from"node:path";(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]="673a5a26-6214-58d6-af19-baee5a8359f0")}catch{}})();var Qv=new Set(["get","history","restore","update","close","delete","append","claim","release","comments","notes","learnings","files","docs","deps","test"]),Ya=new Set(["--pm-path","--path","--author"]),eb={get:new Set(["--depth","--fields","--tree-depth","--tree_depth","--at","--format"]),history:new Set(["--limit","--field","--format"]),restore:new Set(["--message"]),update:new Set(["--title","-t","--description","-d","--body","-b","--status","-s","--close-reason","--close_reason","--priority","-p","--type","--tags","--add-tags","--add_tags","--remove-tags","--remove_tags","--deadline","--estimated-minutes","--estimate","--estimated_minutes","--acceptance-criteria","--ac","--acceptance_criteria","--definition-of-ready","--definition_of_ready","--order","--rank","--goal","--objective","--value","--impact","--outcome","--why-now","--why_now","--message","--assignee","--parent","--reviewer","--risk","--confidence","--sprint","--release","--blocked-by","--blocked_by","--blocked-reason","--blocked_reason","--unblock-note","--unblock_note","--reporter","--severity","--environment","--repro-steps","--repro_steps","--resolution","--expected-result","--expected_result","--expected","--actual-result","--actual_result","--actual","--affected-version","--affected_version","--fixed-version","--fixed_version","--component","--regression","--customer-impact","--customer_impact","--dep","--dep-remove","--dep_remove","--comment","--note","--learning","--file","--test","--doc","--reminder","--event","--type-option","--type_option","--field","--unset","--body-file"]),close:new Set(["--reason","-r","--close-reason","--duplicate-of","-d","--message","-m","--validate-close","--resolution","--expected-result","--expected_result","--expected","--actual-result","--actual_result","--actual"]),delete:new Set(["--message"]),append:new Set(["--body","--text","--message"]),claim:new Set(["--assignee","--message","--type","--tag","--priority","--assignee-filter","--parent","--sprint","--release","--max-attempts"]),release:new Set(["--assignee","--message"]),comments:new Set(["--add","--body","--comment","--file","--edit","--delete","--limit","--message"]),notes:new Set(["--add","--file","--edit","--delete","--limit","--message"]),learnings:new Set(["--add","--file","--edit","--delete","--limit","--message"]),files:new Set(["--add","--add-glob","--remove","--migrate","--note","--message"]),docs:new Set(["--add","--add-glob","--remove","--migrate","--note","--message"]),deps:new Set(["--format","--max-depth","--collapse","--node-limit","--edge-limit","--token-budget","--cursor","--direction","--kind"]),test:new Set(["--add","--add-json","--remove","--match","--only-index","--timeout","--env-set","--env-clear","--pm-context","--message"])},tb=new Set(["-p","--package"]),nb=new Set(["-c","--call"]),rb=new Set(["-c","-C","--config","--dir","--filter","--workspace-dir"]),ib=new Set(["-C","--prefix","--userconfig","--cache"]),KT=new Set(["--cwd"]),YT=new Set(["--cwd"]),ab=new Set(["exec","x"]),XT=new Set(["run","run-script"]),ZT=new Set(["-C","--dir","--cwd","-w","--workspace","--filter"]);function ob(e){return e.split(/&&|\|\||\||;/).map(t=>t.trim()).filter(t=>t.length>0)}function sb(e,t=process.cwd()){let n=cb(e.split(" ").filter(o=>o.length>0));if(n.length===0)return null;let[r,...i]=n;if(qu(r)||Wu(r,t))return i;if(r==="node"&&i[0]&&Wu(i[0],t))return i.slice(1);let a=r==="npx"||r==="bunx"?Xa(i):r==="pnpm"?ub(i):r==="npm"?mb(i):null;return a&&(qu(a.command)||db(a.command))?a.args:null}var Bu=(e,t="pm")=>{let n=t.trim().toLowerCase(),r=n.length;for(;r>0&&n[r-1]==="-";)r-=1;let i=n.slice(0,r);if(i.length===0)return[];let a=e.trim().replaceAll("\\","/").replaceAll('"',"").replaceAll("'","").replaceAll(/\s+/g," ").toLowerCase(),o=new Set;for(let s of ob(a)){let c=sb(s),l=c?pb(c):null,d=l&&Qv.has(l.subcommand)?fb(l.remaining,eb[l.subcommand]):void 0,u=d?.trim().toLowerCase();u?.startsWith(`${i}-`)===!0&&u.length>i.length+1&&o.add(d)}return[...o].sort((s,c)=>s.localeCompare(c))};function cb(e){let t=0;for(e[t]==="env"&&(t+=1);t<e.length;){let n=e[t];if(/^(?:[a-z_][a-z0-9_]*|\$env:[a-z_][a-z0-9_]*)=.*/.test(n)){t+=1;continue}break}return e.slice(t)}function QT(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(Ya.has(n)){t+=2;continue}t+=1;continue}return n}}function qu(e){return e==="pm"||e==="pm.cmd"||e==="pm.exe"||e.endsWith("/pm")||e.endsWith("/pm.cmd")||e.endsWith("/pm.exe")}function lb(e){let t=e.trim();if(!t.startsWith("@")){let i=t.indexOf("@");return i===-1?t:t.slice(0,i)}let n=t.indexOf("/");if(n===-1)return t;let r=t.indexOf("@",n+1);return r===-1?t:t.slice(0,r)}function db(e){let t=lb(e);return t==="pm-cli"||t.endsWith("/pm-cli")||e==="pm-cli"||e.endsWith("/pm-cli")}function Wu(e,t=process.cwd()){let n=e.replaceAll("\\","/");if(n!=="dist/cli.js"&&n!=="./dist/cli.js"&&!n.endsWith("/dist/cli.js"))return!1;let r=Vr.resolve(t,e);try{return JSON.parse(Zv(Vr.join(Vr.dirname(Vr.dirname(r)),"package.json"),"utf8")).name==="@unbrained/pm-cli"}catch{return!1}}function Xa(e){let t=0;for(;t<e.length;){let r=e[t];if(r==="--"){t+=1;break}if(!r.startsWith("-"))break;let i=/^(?:-c|--call)=(.*)$/.exec(r);if(i){let a=i[1];return a?{command:a,args:e.slice(t+1)}:null}if(nb.has(r)){t+=1;break}t+=tb.has(r)&&!r.includes("=")?2:1}let n=e[t];return n?{command:n,args:e.slice(t+1)}:null}function Hu(e,t){let n=0;for(;n<e.length;){let r=e[n];if(r==="--"){n+=1;continue}if(r.startsWith("-")){if(r.includes("=")){n+=1;continue}if(t.has(r)){n+=2;continue}n+=1;continue}return{subcommand:r,args:e.slice(n+1)}}return null}function ub(e){let t=Hu(e,rb);return t?.subcommand!=="dlx"?null:Xa(t.args)}function mb(e){let t=Hu(e,ib);return!t||!ab.has(t.subcommand)?null:Xa(t.args)}function pb(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(Ya.has(n)){t+=2;continue}t+=1;continue}return{subcommand:n,remaining:e.slice(t+1)}}return null}function fb(e,t=new Set){for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="--")return e[n+1];if(!r.startsWith("-"))return r;!r.includes("=")&&(Ya.has(r)||t.has(r))&&(n+=1)}}(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]="01f042d0-7f02-59f5-8894-cf48eb936d99")}catch{}})();async function Ju(e){return e.includeBody?tr(e.pmRoot,e.settings.item_format,e.typeToFolder,e.warnings,e.settings.schema,{forceSourceScan:!0}):Dt(e.pmRoot,e.settings.item_format,e.typeToFolder,e.warnings,e.settings.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]="a1261d65-222c-5c6c-8634-a4413a91aba9")}catch{}})();var hb=5;async function Vu(e,t,n){let r=await yr(e,t),a=[["validate_history_drift_missing_streams",r.missingStreams.length],["validate_history_drift_unreadable_streams",r.unreadableStreams.length],["validate_history_drift_hash_mismatches",r.hashMismatches.length],["validate_history_drift_chain_mismatches",r.chainMismatches.length],["validate_history_drift_workspace_state_mismatches",r.workspaceStateMismatches.length],["validate_history_drift_workspace_state_missing",r.workspaceStateMissing.length],["validate_history_drift_workspace_state_unreadable",r.workspaceStateUnreadable.length]].filter(([,c])=>c>0).map(([c,l])=>`${c}:${l}`),o=n?Number.POSITIVE_INFINITY:hb,s=r.driftedItems.slice(0,o);return{check:{name:"history_drift",status:a.length===0?"ok":"warn",ok:a.length===0,details:{checked_items:t.length,drifted_items_count:r.driftedItems.length,drifted_items:s,drifted_items_truncated:s.length<r.driftedItems.length,counts:{missing_streams:r.missingStreams.length,unreadable_streams:r.unreadableStreams.length,hash_mismatches:r.hashMismatches.length,chain_mismatches:r.chainMismatches.length,workspace_state_mismatches:r.workspaceStateMismatches.length,workspace_state_missing:r.workspaceStateMissing.length,workspace_state_unreadable:r.workspaceStateUnreadable.length},workspace_state_mismatches:r.workspaceStateMismatches,workspace_state_missing:r.workspaceStateMissing,workspace_state_unreadable:r.workspaceStateUnreadable}},warnings:a}}(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]="b8c4707f-5445-5079-96e5-dc0dbd649b34")}catch{}})();var wb=["src","tests","docs"],vb=["README.md","PRD.md","CHANGELOG.md","AGENTS.md","CONTRIBUTING.md","SECURITY.md","CODE_OF_CONDUCT.md","LICENSE"],bb=new Set(["node_modules",".git",".cursor",".agents","dist","coverage"]),kb=["resolution","expected_result","actual_result"],xb=["default","tracked-all","tracked-all-strict"],Ku=["core","strict","custom"],Yr=["off","warn","error"];var Qa=["author","acceptance_criteria","estimated_minutes","close_reason"],em=[...Qa,"reviewer","risk","confidence","sprint","release"],ro=Array.from(new Set(em)),Sb={author:"author",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",estimate:"estimated_minutes",close_reason:"close_reason","close-reason":"close_reason",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release"},Eb={author:"validate_metadata_missing_author",acceptance_criteria:"validate_metadata_missing_acceptance_criteria",estimated_minutes:"validate_metadata_missing_estimate",close_reason:"validate_metadata_missing_close_reason",reviewer:"validate_metadata_missing_reviewer",risk:"validate_metadata_missing_risk",confidence:"validate_metadata_missing_confidence",sprint:"validate_metadata_missing_sprint",release:"validate_metadata_missing_release"},Ab={author:"missing_author",acceptance_criteria:"missing_acceptance_criteria",estimated_minutes:"missing_estimated_minutes",close_reason:"closed_missing_close_reason",reviewer:"missing_reviewer",risk:"missing_risk",confidence:"missing_confidence",sprint:"missing_sprint",release:"missing_release"},Rb={author:"missing_author_item_ids",acceptance_criteria:"missing_acceptance_criteria_item_ids",estimated_minutes:"missing_estimated_minutes_item_ids",close_reason:"closed_missing_close_reason_item_ids",reviewer:"missing_reviewer_item_ids",risk:"missing_risk_item_ids",confidence:"missing_confidence_item_ids",sprint:"missing_sprint_item_ids",release:"missing_release_item_ids"},Ib={author:"missing_author_truncated",acceptance_criteria:"missing_acceptance_criteria_truncated",estimated_minutes:"missing_estimated_minutes_truncated",close_reason:"closed_missing_close_reason_truncated",reviewer:"missing_reviewer_truncated",risk:"missing_risk_truncated",confidence:"missing_confidence_truncated",sprint:"missing_sprint_truncated",release:"missing_release_truncated"},Cb=32*1024*1024,$b=1e4,tm=40,ut=5,Tb=4096,Ob=255,Db=yb(_b);function nm(e){let t={};for(let[n,r]of Object.entries(e))Array.isArray(r)||(t[n]=typeof r=="object"&&r!==null?nm(r):r);return t}function Pb(e){return{...e,checks:e.checks.map(t=>({...t,details:nm(t.details)})),...e.fixes?{fixes:{mode:e.fixes.mode,auto_fix:e.fixes.auto_fix,prune_missing:e.fixes.prune_missing,planned_count:e.fixes.planned_count,applied_count:e.fixes.applied_count,gated_count:e.fixes.gated_count,failed_count:e.fixes.failed_count}}:{}}}function kt(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/^\/+/,"")}function Yu(e){return kt(e).replace(/\/+$/,"")}function Te(e){let t=Z(e);if(!t)return;let n=t.toLowerCase();if(!(n==="none"||n==="null"||n==="n/a"||n==="na"))return t}function Zr(e,t){return ns(e,t)??e}function In(e,t){return t.terminal_statuses.has(Zr(e,t))}function lt(e){return[...new Set((e??[]).map(t=>t.trim().toLowerCase()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function Kr(e,t){return e.length!==t.length?!1:e.every((n,r)=>n===t[r])}function Nb(e){let t=lt(bo),n={blocked_reason:lt(Dn.blocked_reason),resolution:lt(Dn.resolution),actual_result:lt(Dn.actual_result)},r=lt(e.validation.lifecycle_stale_blocker_reason_patterns),i={blocked_reason:lt(e.validation.lifecycle_closure_like_blocked_reason_patterns),resolution:lt(e.validation.lifecycle_closure_like_resolution_patterns),actual_result:lt(e.validation.lifecycle_closure_like_actual_result_patterns)};return{stale_blocker_reason_patterns:r,stale_blocker_reason_pattern_source:Kr(r,t)?"default":"settings",closure_like_metadata_field_patterns:i,closure_like_metadata_field_pattern_sources:{blocked_reason:Kr(i.blocked_reason,n.blocked_reason)?"default":"settings",resolution:Kr(i.resolution,n.resolution)?"default":"settings",actual_result:Kr(i.actual_result,n.actual_result)?"default":"settings"}}}function rm(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"core";if(Ku.includes(t))return t;throw new _(`Unknown --metadata-profile value "${e}". Supported values: ${Ku.join(", ")}.`,y.USAGE)}function im(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"warn";if(Yr.includes(t))return t;throw new _(`Unknown --dependency-cycle-severity value "${e}". Supported values: ${Yr.join(", ")}.`,y.USAGE)}function am(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"warn";if(Yr.includes(t))return t;throw new _(`Unknown --parent-cycle-severity value "${e}". Supported values: ${Yr.join(", ")}.`,y.USAGE)}function Mb(e){return[...new Set((e??[]).map(n=>n.trim().toLowerCase().replaceAll("-","_")))].map(n=>Sb[n]).filter(n=>n!==void 0).sort((n,r)=>n.localeCompare(r))}function Lb(e,t,n){let r=Mb(n);return e==="core"?{profile:e,profile_source:t,required_fields:[...Qa],configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:e==="strict"?{profile:e,profile_source:t,required_fields:[...em],configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:r.length>0?{profile:e,profile_source:t,required_fields:r,configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:{profile:e,profile_source:t,required_fields:[...Qa],configured_custom_fields:r,fallback_to_core:!0,warnings:["validate_metadata_custom_profile_missing_required_fields:0"]}}var Fb=new Set(["acceptance_criteria","estimated_minutes"]);function om(e,t,n,r){return!r&&Fb.has(t)&&In(e.status,n)?!1:t==="author"?!Z(e.author):t==="acceptance_criteria"?!Z(e.acceptance_criteria):t==="estimated_minutes"?!Number.isFinite(e.estimated_minutes):t==="close_reason"?Zr(e.status,n)===n.close_status&&!Z(e.close_reason):t==="reviewer"?!Z(e.reviewer):t==="risk"?!Z(e.risk):t==="confidence"?typeof e.confidence=="number"?!Number.isFinite(e.confidence):!Z(e.confidence):t==="sprint"?!Z(e.sprint):!Z(e.release)}function sm(e){if(e===void 0)return"default";let t=e.trim().toLowerCase();if(t.length===0||t==="default")return"default";if(t==="tracked-all"||t==="tracked_all")return"tracked-all";if(t==="tracked-all-strict"||t==="tracked_all_strict")return"tracked-all-strict";throw new _(`Unknown --scan-mode value "${e}". Supported values: ${xb.join(", ")}.`,y.USAGE)}function cm(e){let t=process.env.PM_SOURCE_WORKSPACE_ROOT?.trim();if(t)return he.resolve(t);let n=he.resolve(e);if(n.replaceAll("\\","/").endsWith("/.agents/pm"))return he.dirname(he.dirname(n));let i=he.resolve(process.cwd()),a=Xu(n),o=Xu(i),s=he.relative(a,o);return s.length===0||!s.startsWith("..")&&!he.isAbsolute(s)?n:i}function Xu(e){try{return gb.native(e)}catch{return he.resolve(e)}}function jb(e,t){return typeof e=="object"&&e!==null&&"code"in e&&typeof e.code=="string"&&t.includes(e.code)}async function io(e,t,n){let r=t.length>0?he.join(e,t):e,i;try{i=await no.readdir(r,{withFileTypes:!0})}catch(a){if(j(a))return;throw a}for(let a of i){if(a.name.startsWith("."))continue;let o=t.length>0?he.join(t,a.name):a.name;if(a.isDirectory()){if(bb.has(a.name))continue;await io(e,o,n);continue}a.isFile()&&n.push(kt(o))}}async function eo(e){let t=[];for(let n of wb)await io(e,n,t);for(let n of vb){let r=he.join(e,n);try{(await no.stat(r)).isFile()&&t.push(kt(n))}catch{}}return[...new Set(t)].sort((n,r)=>n.localeCompare(r))}async function lm(e){try{let{stdout:t}=await Db("git",["ls-files","-z"],{cwd:e,encoding:"utf8",maxBuffer:Cb,windowsHide:!0,timeout:$b}),n=t.split("\0").map(r=>kt(r)).filter(r=>r.length>0);return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}catch{return null}}function Ub(e,t){let n=new Set,r=Yu(yo);r.length>0&&n.add(r);let i=Yu(he.relative(t,e));return i.length>0&&!i.startsWith("..")&&n.add(i),[...n].sort((a,o)=>a.localeCompare(o))}function Zu(e,t){for(let n of t)if(e===n||e.startsWith(`${n}/`))return!0;return!1}async function zb(e,t){if(t==="tracked-all"||t==="tracked-all-strict"){let r=await lm(e);if(r)return{requestedMode:t,appliedMode:t,source:"tracked-git",candidateFiles:r,candidateTotal:r.length,candidateScanned:r.length};let i=await eo(e);return{requestedMode:t,appliedMode:"default",source:"tracked-all-fallback-default",candidateFiles:i,candidateTotal:i.length,candidateScanned:i.length}}let n=await eo(e);return{requestedMode:t,appliedMode:"default",source:"default-curated",candidateFiles:n,candidateTotal:n.length,candidateScanned:n.length}}function ie(e,t=ut){return e.length<=t?{values:e,truncated:!1}:{values:e.slice(0,t),truncated:!0}}function dt(e,t){if(t)return{values:e,truncated:!1,total:e.length};let n=ie(e,tm);return{values:n.values,truncated:n.truncated,total:e.length}}var Gb={resolution:"--resolution",expected_result:"--expected-result",actual_result:"--actual-result"},qb={resolution:"Describe how this item was resolved",expected_result:"Describe the expected result",actual_result:"Describe the actual result"};function Wb(e){let t=e.missing_fields.map(n=>`${Gb[n]} "${qb[n]}"`).join(" ");return`pm update ${e.id} ${t} --message "Backfill resolution metadata"`}function dm(e,t){let n=e.details?.missing_resolution_remediation_hints,r=Array.isArray(n)&&n.length>0,i=r?n.filter(o=>typeof o=="string"):Cc(t);if(i.length===0)return;let a=r&&e.details?.missing_resolution_remediation_hints_truncated===!0;e.details={...e.details,fix_hints:i,...a?{fix_hints_truncated:!0}:{}}}function um(e){let t=new Set;return e.checkMetadata&&t.add("metadata"),e.checkResolution&&t.add("resolution"),(e.checkLifecycle||e.checkStaleBlockers)&&t.add("lifecycle"),e.checkFiles&&t.add("files"),e.checkHistoryDrift&&t.add("history_drift"),e.checkCommandReferences&&t.add("command_references"),e.checkStorageIntegrity&&t.add("storage_integrity"),t.size===0?(e.autoFix&&(t.add("metadata"),t.add("resolution"),t.add("lifecycle")),e.pruneMissing&&t.add("files"),t.size===0&&(t.add("metadata"),t.add("resolution"),t.add("lifecycle"),t.add("files"),t.add("command_references"),t.add("history_drift"),t.add("format_version"),t.add("storage_integrity")),t):(e.pruneMissing&&t.add("files"),t)}var Bb="validate_metadata_duplicate_issue_codes";function mm(e,t){if(e.length===0)return{rows:[],truncated:!1,warnings:[]};let n=t?e.length:ut,r=e.slice(0,n);return{rows:r.map(a=>({code:a.code,count:a.count,ids:a.ids,titles:a.titles,remediation_hint:`Items ${a.ids.join(", ")} share issue code "${a.code}"; rename or merge so each logical code maps to one item.`})),truncated:r.length<e.length,warnings:[`${Bb}:${e.length}`]}}function Hb(){return Object.fromEntries(ro.map(e=>[e,[]]))}function Jb(e,t,n){let r=Hb();for(let i of e)for(let a of ro)om(i,a,t,n)&&r[a].push(i.id);return r}function Vb(e,t,n){let r=[...e.warnings];for(let i of e.required_fields){let a=t[i];a.length>0&&r.push(`${Eb[i]}:${a.length}`)}return r.push(...n),r}function pm(e,t){let n={};for(let r of e.required_fields){let i=t[r],a=i?i.length:0,o=Ab[r];n[o]=a}return n}function fm(e,t,n){let r=[];for(let i of e.required_fields){let a=t[i];if(a)for(let o of a){let s=n.get(o)?.type,c=typeof s=="string"&&s.length>0?s:"Unknown";r.push({item_type:c,field:i})}}return r}function Kb(e,t,n,r){for(let i of t.required_fields){let a=n[i];if(!a||a.length===0)continue;let o=Rb[i],s=Ib[i];if(!o||!s)continue;let c=ie(a,r?a.length:ut);e[o]=c.values,e[s]=c.truncated}}function hm(e,t,n){if(!e.required_fields.includes("close_reason"))return[];let r=t.close_reason;return r?r.map(i=>({id:i,resolution:Z(n.get(i)?.resolution)})):[]}function gm(e,t,n){if(!e.required_fields.includes("estimated_minutes"))return[];let r=t.estimated_minutes;return r?r.map(i=>({id:i,type:Z(n.get(i)?.type)})):[]}function Yb(e,t,n,r){let i=new Map(e.map(h=>[h.id,h])),a=t.profile==="strict",o=Jb(e,n,a),s=Au(e),c=mm(s,r),l=Vb(t,o,c.warnings),d=pm(t,o),u=fm(t,o,i),m=Ru(u),p={checked_items:e.length,metadata_profile:t.profile,metadata_profile_source:t.profile_source,metadata_profile_fallback_to_core:t.fallback_to_core,required_fields:[...t.required_fields],supported_required_fields:[...ro],counts:d,missing_by_type:m,duplicate_issue_codes_count:s.length,duplicate_issue_codes:c.rows,duplicate_issue_codes_truncated:c.truncated};t.configured_custom_fields.length>0&&(p.configured_custom_required_fields=[...t.configured_custom_fields]),Kb(p,t,o,r);let f=hm(t,o,i),g=gm(t,o,i);return{check:{name:"metadata",status:l.length===0?"ok":"warn",ok:l.length===0,details:p},warnings:l,closeReasonBackfillRows:f,estimateBackfillRows:g}}function Xb(e,t,n){let r=new Set(t.terminal_done_statuses);r.add(t.close_status);let i=e.filter(m=>r.has(Zr(m.status,t))),a=[],o=[];for(let m of i){let p=kb.filter(f=>!Z(m[f]));p.length!==0&&(a.push({id:m.id,missing_fields:p}),o.push({id:m.id,missing_fields:p,close_reason:Z(m.close_reason)}))}let s=a.length>0?[`validate_resolution_missing_fields:${a.length}`]:[],c=n?Number.POSITIVE_INFINITY:ut,l=ie(a.map(m=>`${m.id}:${m.missing_fields.join(",")}`),c),d=a.map(m=>Wb(m)),u=ie(d,c);return{check:{name:"resolution",status:s.length===0?"ok":"warn",ok:s.length===0,details:{checked_closed_items:i.length,missing_resolution_items:a.length,missing_resolution_rows:l.values,missing_resolution_rows_truncated:l.truncated,missing_resolution_remediation_hints:u.values,missing_resolution_remediation_hints_truncated:u.truncated}},warnings:s,resolutionBackfillRows:o}}function _m(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function ym(e,t="pm",n=di()){let r=new Set(e.map(a=>a.id)),i=[...e].sort((a,o)=>a.id.localeCompare(o.id));return new Map(i.map(a=>{let o=new Set,s=Te(a.blocked_by);s&&r.has(s)&&o.add(s),(a.dependencies??[]).filter(l=>{let d=Te(l.kind);return d!==void 0&&n.resolve(d)?.ordering===!0}).map(l=>Te(l.id)).filter(l=>l!==void 0&&r.has(l)).forEach(l=>o.add(l));let c=Te(a.definition_of_ready);return vm(c??"",t).filter(l=>r.has(l)).forEach(l=>o.add(l)),[a.id,[...o].sort((l,d)=>l.localeCompare(d))]}))}function wm(e,t,n){let r=Ps(e,n?d=>In(d,n):void 0),i=r.active.map(d=>`${d.holder_id}:${d.target_id}:${d.kind}`),a=r.legacy_terminal.map(d=>`${d.holder_id}:${d.target_id}:${d.kind}:${d.holder_status}`),o=t?Number.POSITIVE_INFINITY:ut,s=ie(i,o),c=ie(a,o),l=ie(r.active.map(d=>d.source==="parent"?`pm update ${d.holder_id} --unset parent`:d.source==="blocked_by"?`pm update ${d.holder_id} --unset blocked_by`:`pm update ${d.holder_id} --replace-deps '<correct dependency edges>'`),o);return{check:{name:"dependency_references",status:i.length===0?"ok":"warn",ok:i.length===0,details:{checked_items:e.length,dangling_reference_count:i.length+a.length,active_dangling_reference_count:i.length,dangling_reference_rows:s.values,dangling_reference_rows_truncated:s.truncated,legacy_terminal_dangling_reference_count:a.length,legacy_closed_dangling_reference_count:r.legacy_terminal.filter(d=>d.holder_status==="closed").length,legacy_terminal_dangling_reference_rows:c.values,legacy_terminal_dangling_reference_rows_truncated:c.truncated,no_active_blocker_sentinel_count:r.no_active_blocker_sentinels.length,remediation_hints:l.values,remediation_hints_truncated:l.truncated}},warnings:i.length>0?[`validate_dangling_dependency_references:${i.length}`]:[]}}function vm(e,t="pm"){let n=(t.trim().toLowerCase()||"pm").replace(/-+$/g,""),r=new RegExp(`(?:^|[^a-z0-9-])(${_m(n)}-[a-z0-9][a-z0-9-]*)`,"gi");return[...new Set([...e.matchAll(r)].map(i=>i[1].toLowerCase()))].sort((i,a)=>i.localeCompare(a))}function ao(e){let t=0,n=new Map,r=new Map,i=[],a=new Set,o=[],s=d=>{n.set(d,t),r.set(d,t),t+=1,i.push(d),a.add(d);for(let m of e.get(d)??[])n.has(m)?a.has(m)&&r.set(d,Math.min(r.get(d),n.get(m))):(s(m),r.set(d,Math.min(r.get(d),r.get(m))));if(r.get(d)!==n.get(d))return;let u=[];for(;i.length>0;){let m=i.pop();if(a.delete(m),u.push(m),m===d)break}u.sort((m,p)=>m.localeCompare(p)),o.push(u)},c=[...e.keys()].sort((d,u)=>d.localeCompare(u));for(let d of c)n.has(d)||s(d);return o.filter(d=>{if(d.length>1)return!0;let u=d[0];return(e.get(u)??[]).includes(u)}).sort((d,u)=>d[0].localeCompare(u[0])||d.length-u.length||d.join(",").localeCompare(u.join(",")))}function oo(e,t){let n=e[0];if(e.length===1)return[n,n];let r=new Set(e),i=[n],a=new Set([n]),o=s=>{let c=(t.get(s)??[]).filter(l=>r.has(l));for(let l of c){if(l===n&&i.length>1)return i.push(n),!0;if(!a.has(l)){if(a.add(l),i.push(l),o(l))return!0;i.pop(),a.delete(l)}}return!1};return o(n)?[...i]:[...e,n]}function bm(e,t="pm"){let n=ym(e,t),r=ao(n),i=[...new Set(r.flat())].sort((o,s)=>o.localeCompare(s)),a=r.map(o=>oo(o,n).join("->"));return{cycle_count:r.length,cycle_item_ids:i,cycle_sample_paths:a}}function km(e,t=di()){let n=new Map(e.map(a=>[a.id.toLowerCase(),a.id])),r=new Map(e.map(a=>[a.id,[]]));return[...e].sort((a,o)=>a.id.localeCompare(o.id)).forEach(a=>{let o=r.get(a.id),s=Te(a.parent),c=s?n.get(s.toLowerCase()):void 0;c&&o.push(c),(a.dependencies??[]).forEach(l=>{let d=t.resolve(l.kind);if(!d?.hierarchy)return;let u=n.get(l.id.toLowerCase());u&&(d.hierarchyDirection==="source_parent"?r.get(u).push(a.id):o.push(u))})}),r.forEach((a,o)=>{r.set(o,[...new Set(a)].sort((s,c)=>s.localeCompare(c)))}),r}function xm(e){let t=km(e),n=ao(t),r=[...new Set(n.flat())].sort((a,o)=>a.localeCompare(o)),i=n.map(a=>oo(a,t).join("->"));return{cycle_count:n.length,cycle_item_ids:r,cycle_sample_paths:i}}function Sm(e){return e.startsWith("docs/")?"docs_unowned":e.startsWith("tests/")?"tests_unowned":e.startsWith("src/")?"source_unowned":e.endsWith(".md")?"docs_unowned":"unlinked_existing"}function Xr(e){let t=e.lastIndexOf("/");return t===-1?"":e.slice(0,t)}function Em(e,t){let n=Xr(e).split("/").filter(Boolean),r=Xr(t).split("/").filter(Boolean),i=0;for(;i<n.length&&i<r.length&&n[i]===r[i];)i+=1;return i}function Zb(e,t){let n=Xr(t),r=Xr(e),i=t.endsWith("/")?t:`${t}/`,a=e.startsWith(i),o=n.length>0&&n===r,s=Em(e,t);return!a&&!o&&s===0?null:a?{score:t.length+1e3,confidence:"path_prefix"}:o?{score:s+500,confidence:"same_directory"}:{score:s,confidence:"shared_directory"}}function Qb(e,t,n){return e===void 0||n>e.score||n===e.score&&t.id.localeCompare(e.item.id)<0}function ek(e,t,n){let r=t==="docs_unowned"?"docs":"files",i;return n.flatMap(a=>(r==="docs"?a.docs??[]:a.files??[]).map(o=>({item:a,link:o}))).forEach(({item:a,link:o})=>{if(o.scope!=="project")return;let s=kt(o.path);if(s.length===0||s===e)return;let c=Zb(e,s);c!==null&&Qb(i,a,c.score)&&(i={item:a,score:c.score,confidence:c.confidence})}),i?{id:i.item.id,type:i.item.type,title:i.item.title,status:i.item.status,confidence:i.confidence}:null}function Am(e,t){return e.map(n=>{let r=Sm(n),i=r==="docs_unowned"?"docs":"files",a=ek(n,r,t),o=a?.id??"<id>";return{path:n,classification:r,owner_candidate:a,remediation_hint:`pm ${i} ${o} --add path=${n},scope=project,note="<why this artifact belongs to the item>"`}})}function Rm(e){return e.map(t=>`${t.path}:${t.classification} owner_candidate=${t.owner_candidate?.id??"unowned"} hint=${JSON.stringify(t.remediation_hint)}`)}function tk(e,t){return Object.entries(t.closure_like_metadata_field_patterns).filter(([n,r])=>{let i=Te(e[n]);return i?r.some(a=>i.toLowerCase().includes(a)):!1}).map(([n])=>n).sort((n,r)=>n.localeCompare(r))}function nk(e,t,n,r,i){let a=Te(t.parent),o=a?n.get(r.get(a.toLowerCase())??a):void 0;return{id:e.id,parent_id:t.id,grandparent_id:o?.id,grandparent_active:o!==void 0&&!In(o.status,i)}}function rk(e,t,n,r){let i=Te(e.blocked_by),a=Te(e.blocked_reason),o=a?.toLowerCase(),s=Zr(e.status,n),c=[];return t.has(s)?(!i&&!a&&c.push("blocked_status_missing_blocker_context"),o?.includes("no active blocker")&&c.push("blocked_status_reason_reports_no_active_blocker"),o&&r.stale_blocker_reason_patterns.some(l=>o.includes(l))&&c.push("blocked_status_reason_matches_stale_pattern"),c):(i&&c.push("non_blocked_status_has_blocked_by"),a&&c.push("non_blocked_status_has_blocked_reason"),c)}function ik(e,t,n,r){let i=new Map(e.map(c=>[c.id,c])),a=new Map(e.map(c=>[c.id.toLowerCase(),c.id])),o=n.blocked_statuses.size>0?n.blocked_statuses:new Set(["blocked"]),s={activeItems:e.filter(c=>!In(c.status,n)),closureLikeRows:[],terminalParentRows:[],terminalParentFixRows:[],staleBlockerRows:[]};for(let c of s.activeItems){let l=tk(c,r);l.length>0&&s.closureLikeRows.push({id:c.id,fields:l});let d=Te(c.parent),u=d?i.get(a.get(d.toLowerCase())??d):void 0;if(u&&In(u.status,n)&&(s.terminalParentRows.push({id:c.id,parent_id:u.id,parent_status:u.status}),s.terminalParentFixRows.push(nk(c,u,i,a,n))),t){let m=rk(c,o,n,r);m.length>0&&s.staleBlockerRows.push({id:c.id,status:c.status,reasons:[...new Set(m)].sort((p,f)=>p.localeCompare(f))})}}return s}function ak(e){e.closureLikeRows.sort((t,n)=>t.id.localeCompare(n.id)),e.terminalParentRows.sort((t,n)=>t.id.localeCompare(n.id)||t.parent_id.localeCompare(n.parent_id)),e.terminalParentFixRows.sort((t,n)=>t.id.localeCompare(n.id)||t.parent_id.localeCompare(n.parent_id)),e.staleBlockerRows.sort((t,n)=>t.id.localeCompare(n.id))}function Qu(e,t,n){return n<=0||t==="off"?null:`${t==="error"?`${e}_error`:e}:${n}`}function ok(e,t,n,r,i,a){let o=[];e.closureLikeRows.length>0&&o.push(`validate_lifecycle_active_closure_like_metadata:${e.closureLikeRows.length}`),e.terminalParentRows.length>0&&o.push(`validate_lifecycle_active_terminal_parent:${e.terminalParentRows.length}`),t&&e.staleBlockerRows.length>0&&o.push(`validate_lifecycle_stale_blockers:${e.staleBlockerRows.length}`);let s=Qu("validate_lifecycle_dependency_cycles",n,i),c=Qu("validate_hierarchy_parent_cycle",r,a);return[...o,...s?[s]:[],...c?[c]:[]]}function Im(e){let t=kt(e);return t.length>Tb||t.split(/[\\/]/).some(n=>n.length>Ob)}async function sk(e,t){let n=he.isAbsolute(t)?t:he.resolve(e,t);if(Im(n))return!1;try{let r=await no.stat(n);return!r.isFile()&&!r.isDirectory()}catch(r){return jb(r,["ENOENT","ENOTDIR"])}}async function ck(e,t){let n={linkedProjectPaths:new Set,remoteLinkedPaths:new Set,missingLinkedPaths:[],staleLinkRows:[]},r=e.flatMap(i=>[...(i.files??[]).map(a=>({item:i,artifact:a,link_kind:"files"})),...(i.docs??[]).map(a=>({item:i,artifact:a,link_kind:"docs"}))]);for(let{item:i,artifact:a,link_kind:o}of r){if(a.scope!=="project")continue;if(An(a.path)){n.remoteLinkedPaths.add(a.path.trim());continue}let s=kt(a.path);s.length!==0&&(n.linkedProjectPaths.add(s),await sk(t,a.path)&&(n.missingLinkedPaths.push(s),n.staleLinkRows.push({item_id:i.id,path:s,link_kind:o})))}return n}function lk(e,t,n,r,i,a){let o=r==="tracked-all-strict",s=o&&!i,c=i||o,l=c?[]:Ub(t,n),d=l.length===0?[]:e.candidateFiles.filter(p=>Zu(p,l)),u=l.length===0?e.candidateFiles:e.candidateFiles.filter(p=>!Zu(p,l)),m={};if(d.length>0){let p=dt(d,a);m.pm_internals={count:d.length,paths:p.values,paths_truncated:p.truncated,paths_total:p.total}}return{strictTrackedAllMode:o,strictModeForcesPmInternals:s,includePmInternalsEffective:c,pmInternalCandidatePrefixes:l,excludedPmInternalPaths:d,candidateFiles:u,excludedByReason:m}}function Cm(e,t,n,r,i,a,o,s="pm"){let c=ik(e,t,i,a);ak(c);let l=bm(c.activeItems,s),d=xm(e),u=ok(c,t,n,r,l.cycle_count,d.cycle_count),m=o?Number.POSITIVE_INFINITY:ut,p=ie(c.closureLikeRows.map(R=>`${R.id}:${R.fields.join(",")}`),m),f=ie(c.terminalParentRows.map(R=>`${R.id}:${R.parent_id}:${R.parent_status}`),m),g=ie(c.staleBlockerRows.map(R=>`${R.id}:${R.status}:${R.reasons.join(",")}`),m),h=ie(l.cycle_item_ids,m),w=ie(l.cycle_sample_paths,m),v=ie(d.cycle_item_ids,m),b=ie(d.cycle_sample_paths,m),x=l.cycle_count>0&&n==="error"||d.cycle_count>0&&r==="error";return{check:{name:"lifecycle",status:x?"error":u.length===0?"ok":"warn",ok:!x&&u.length===0,details:{checked_active_items:c.activeItems.length,active_closure_like_metadata_items:c.closureLikeRows.length,active_closure_like_metadata_rows:p.values,active_closure_like_metadata_rows_truncated:p.truncated,active_terminal_parent_items:c.terminalParentRows.length,active_terminal_parent_rows:f.values,active_terminal_parent_rows_truncated:f.truncated,stale_blocker_checks_enabled:t,stale_blocker_items:c.staleBlockerRows.length,stale_blocker_rows:g.values,stale_blocker_rows_truncated:g.truncated,dependency_cycle_severity_policy:n,dependency_cycle_count:l.cycle_count,dependency_cycle_item_count:l.cycle_item_ids.length,dependency_cycle_item_ids:h.values,dependency_cycle_item_ids_truncated:h.truncated,dependency_cycle_sample_paths:w.values,dependency_cycle_sample_paths_truncated:w.truncated,parent_cycle_severity_policy:r,parent_cycle_count:d.cycle_count,parent_cycle_item_count:d.cycle_item_ids.length,parent_cycle_item_ids:v.values,parent_cycle_item_ids_truncated:v.truncated,parent_cycle_sample_paths:b.values,parent_cycle_sample_paths_truncated:b.truncated,stale_blocker_reason_patterns:[...a.stale_blocker_reason_patterns],stale_blocker_reason_pattern_source:a.stale_blocker_reason_pattern_source,closure_like_blocked_reason_patterns:[...a.closure_like_metadata_field_patterns.blocked_reason],closure_like_blocked_reason_pattern_source:a.closure_like_metadata_field_pattern_sources.blocked_reason,closure_like_resolution_patterns:[...a.closure_like_metadata_field_patterns.resolution],closure_like_resolution_pattern_source:a.closure_like_metadata_field_pattern_sources.resolution,closure_like_actual_result_patterns:[...a.closure_like_metadata_field_patterns.actual_result],closure_like_actual_result_pattern_source:a.closure_like_metadata_field_pattern_sources.actual_result}},warnings:u,terminalParentFixRows:c.terminalParentFixRows}}async function $m(e,t,n,r,i,a){let o=await ck(e,t),s=new Map(e.map(D=>[D.id,D])),c=[...new Set(o.missingLinkedPaths)].sort((D,W)=>D.localeCompare(W)),l=await zb(t,r),d=lk(l,n,t,r,i,a),u=d.candidateFiles.filter(D=>!o.linkedProjectPaths.has(D)),m=Am(u,e),p=$u(c,d.candidateFiles),f=new Map(p.map(D=>[D.path,D.classification])),g=p.filter(D=>D.classification==="moved").length,h=o.staleLinkRows.map(D=>({...D,classification:f.get(D.path)??"deleted"})).sort((D,W)=>D.item_id.localeCompare(W.item_id)||D.path.localeCompare(W.path)||D.link_kind.localeCompare(W.link_kind)),w=[];d.strictModeForcesPmInternals&&w.push("validate_files_tracked_all_strict_forces_pm_internals"),c.length>0&&w.push(`validate_files_missing_linked_paths:${c.length}`),u.length>0&&w.push(`validate_files_orphaned_paths:${u.length}`);let v=[...o.remoteLinkedPaths].sort((D,W)=>D.localeCompare(W)),b=dt(v,a),x=dt(c,a),R=dt(u,a),k=dt(m.map(D=>`${D.path}:${D.classification}:owner_candidate=${D.owner_candidate?.id??"unowned"}`),a),F=a?m:dt(Rm(m),!1).values,T=dt(Tu(p),a),E=h.map(D=>({item_id:D.item_id,path:D.path,link_kind:D.link_kind,classification:D.classification})),U=Du(E,D=>{let W=s.get(D);return W?{type:W.type,title:W.title,status:W.status}:void 0}),B=a?U:dt(Pu(U),!1).values;return{check:{name:"files",status:w.length===0?"ok":"warn",ok:w.length===0,details:{workspace_root:t,scan_mode_requested:l.requestedMode,scan_mode_applied:l.appliedMode,strict_tracked_all_mode:d.strictTrackedAllMode,strict_mode_forces_pm_internals:d.strictModeForcesPmInternals,strict_mode_forces_pm_internals_notice:d.strictModeForcesPmInternals?"tracked-all-strict force-enables PM internals; pass --include-pm-internals to make inclusion explicit.":null,file_list_detail_mode:a?"full":"summary",file_list_summary_limit:tm,candidate_scan_source:l.source,include_pm_internals:d.includePmInternalsEffective,include_pm_internals_requested:i,pm_internal_candidate_prefixes:d.pmInternalCandidatePrefixes,pm_internal_excluded_count:d.excludedPmInternalPaths.length,excluded_total:d.excludedPmInternalPaths.length,excluded_by_reason:d.excludedByReason,linked_project_paths:o.linkedProjectPaths.size,remote_linked_paths_count:v.length,remote_linked_paths_total:b.total,remote_linked_paths:b.values,remote_linked_paths_truncated:b.truncated,candidate_total_raw:l.candidateTotal,candidate_scanned_raw:l.candidateScanned,candidate_total:d.candidateFiles.length,candidate_scanned:d.candidateFiles.length,scanned_candidate_files:d.candidateFiles.length,missing_linked_paths_count:c.length,missing_linked_paths_total:x.total,missing_linked_paths:x.values,missing_linked_paths_truncated:x.truncated,missing_linked_paths_moved_count:g,missing_linked_paths_deleted_count:c.length-g,missing_linked_path_classifications:T.values,missing_linked_path_classifications_truncated:T.truncated,missing_linked_path_rows_count:U.length,missing_linked_path_rows:B,orphaned_paths_count:u.length,orphaned_paths_total:R.total,orphaned_paths:R.values,orphaned_paths_truncated:R.truncated,orphaned_path_classifications:k.values,orphaned_path_classifications_truncated:k.truncated,orphaned_path_rows_count:m.length,orphaned_path_rows:F}},warnings:w,staleLinkPruneRows:h}}function dk(e,t,n){let r=n.trim().replaceAll(/\s+/g," "),i=r.length>120?`${r.slice(0,117)}...`:r;return`${e}:${t}:${i}`}function Tm(e,t,n){let r=new Set(e.map(h=>h.id.toLowerCase())),i=0,a=0,o=new Set,s=[],c=e.flatMap(h=>(h.tests??[]).map(w=>({item:h,linkedTest:w})));for(let{item:h,linkedTest:w}of c){if(typeof w.command!="string"||w.command.trim().length===0)continue;i+=1;let v=Bu(w.command,t);if(v.length!==0){a+=v.length;for(let b of v)o.add(b),r.has(b.toLowerCase())||s.push(dk(h.id,b,w.command))}}let l=[...new Set(s)].sort((h,w)=>h.localeCompare(w)),d=[...new Set(l.map(h=>h.split(":")[1]??""))].filter(h=>h.length>0).sort((h,w)=>h.localeCompare(w)),u=l.length>0?[`validate_command_references_stale_pm_ids:${l.length}`]:[],m=n?Number.POSITIVE_INFINITY:ut,p=ie(l,m),f=ie(d,m),g=ie([...o].sort((h,w)=>h.localeCompare(w)),m);return{check:{name:"command_references",status:u.length===0?"ok":"warn",ok:u.length===0,details:{checked_items:e.length,linked_commands_scanned:i,referenced_pm_ids_count:a,unique_referenced_pm_ids_count:o.size,unique_referenced_pm_ids:g.values,unique_referenced_pm_ids_truncated:g.truncated,stale_pm_id_references_count:l.length,stale_pm_ids_count:d.length,stale_pm_ids:f.values,stale_pm_ids_truncated:f.truncated,stale_pm_id_reference_rows:p.values,stale_pm_id_reference_rows_truncated:p.truncated}},warnings:u}}function uk(e,t){let n=Jn(e.map(c=>({ref:c.id,version:Hn(c)}))),r=[];n.outdated.length>0&&r.push(`validate_format_version_outdated_items:${n.outdated.length}`),n.ahead.length>0&&r.push(`validate_format_version_ahead_items:${n.ahead.length}`);let i=t?Number.POSITIVE_INFINITY:ut,a=ie(n.outdated,i),o=ie(n.ahead,i),s=n.ahead.length>0?"error":n.outdated.length>0?"warn":"ok";return{check:{name:"format_version",status:s,ok:s==="ok",details:{checked_items:e.length,current_format_version:ts,outdated_items_count:n.outdated.length,outdated_items:a.values,outdated_items_truncated:a.truncated,ahead_items_count:n.ahead.length,ahead_items:o.values,ahead_items_truncated:o.truncated}},warnings:r}}var to="pm validate auto-fix";async function Om(e,t,n){switch(e.kind){case"set_resolution":case"set_close_reason":case"set_estimate":case"reparent":case"unset_parent":{let r={message:to};if(e.kind==="set_resolution"?r.resolution=e.value:e.kind==="set_close_reason"?r.closeReason=e.value:e.kind==="set_estimate"?r.estimatedMinutes=e.value:e.kind==="reparent"?r.parent=e.parent_id:r.unset=["parent"],!n.runUpdate)throw new _("Applying validate metadata/lifecycle fixes requires a runUpdate mutation service.",y.USAGE);await n.runUpdate(e.item_id,r,t);return}case"prune_file_link":throw new Error(`Unsupported non-batched fix kind: ${e.kind}`);case"prune_doc_link":throw new Error(`Unsupported non-batched fix kind: ${e.kind}`)}}function Za(e){return e.kind!=="prune_file_link"&&e.kind!=="prune_doc_link"?null:`${e.kind}:${e.item_id}`}async function Dm(e,t,n){let r=[],i=[],a=new Map;for(let o of e.filter(s=>Za(s)===null))try{await Om(o,t,n),r.push(o)}catch(s){i.push({fix:o,error:s})}for(let o of e.filter(s=>Za(s)!==null)){let s=Za(o),c=a.get(s);c?c.push(o):a.set(s,[o])}for(let o of a.values()){let s=o[0];if(!s)continue;let c=o.map(l=>l.path).filter(l=>typeof l=="string"&&l.length>0);try{s.kind==="prune_file_link"?await Uu(s.item_id,{remove:c,message:to},t):await Fu(s.item_id,{remove:c,message:to},t),r.push(...o)}catch(l){i.push(...o.map(d=>({fix:d,error:l})))}}return{applied:r,failed:i}}var q0={applyValidateFix:Om,applyValidateFixes:Dm,attachValidateFixHints:dm,buildCommandReferencesCheck:Tm,buildDependencyReferencesCheck:wm,buildCloseReasonBackfillRows:hm,buildFilesCheck:$m,buildLifecycleCheck:Cm,buildLifecycleDependencyGraph:ym,buildLifecycleParentGraph:km,buildEstimateBackfillRows:gm,buildMetadataCounts:pm,buildMissingFieldOccurrences:fm,buildOrphanedPathRows:Am,classifyOrphanedPath:Sm,collectDefaultProjectFileCandidates:eo,collectTrackedGitFileCandidates:lm,detectLifecycleDependencyCycles:bm,detectLifecycleParentCycles:xm,escapeRegExp:_m,extractItemIds:vm,findLifecycleDependencyCycleComponents:ao,isMetadataFieldMissing:om,linkedArtifactPathExceedsFilesystemLimits:Im,listFilesRecursive:io,resolveDependencyCycleSeverity:im,resolveParentCycleSeverity:am,resolveFileScanMode:sm,resolveLifecycleDependencyCycleSamplePath:oo,resolveRequestedChecks:um,resolveValidateMetadataProfile:rm,resolveWorkspaceRoot:cm,sharedDirectoryPrefixLength:Em,summarizeOrphanedPathRows:Rm,summarizeDuplicateIssueCodes:mm,toMeaningfulString:Te};async function mk(e,t,n,r){let i=await mu(e,new Set(t.map(g=>g.id)),n,{schema:r.schema,extensionFieldNames:xt(z())}),a=[];i.unreadable_item_files.length>0&&a.push(`validate_storage_unreadable_items:${i.unreadable_item_files.length}`),i.duplicate_item_ids.length>0&&a.push(`validate_storage_duplicate_item_ids:${i.duplicate_item_ids.length}`),i.history_conflict_marker_streams.length>0&&a.push(`validate_storage_history_conflict_markers:${i.history_conflict_marker_streams.length}`),i.history_unparseable_streams.length>0&&a.push(`validate_storage_unparseable_history:${i.history_unparseable_streams.length}`),i.resurrected_items.length>0&&a.push(`validate_storage_resurrected_items:${i.resurrected_items.length}`),i.unparseable_config_files.length>0&&a.push(`validate_storage_unparseable_config:${i.unparseable_config_files.length}`);let o=a.length,s=await jr(e);s.tracked_path_count>0&&a.push(`validate_storage_tracked_runtime_cache_files:${s.tracked_path_count}`);let c=await Bc(e,kr(r));c.status==="drift"&&a.push(`validate_merge_fence_drift:${c.missing_patterns.length+c.stale_patterns.length}`);let l=await gt(e),d=l===null?null:await xr(l);d!==null&&d.status!=="ok"&&a.push(`validate_merge_driver_configuration:${d.missing_keys.length+d.drifted_keys.length}`);let u=l===null?[]:await kn(l,{includeLossless:!0,pmRoot:e}),{pendingDecisions:m,lossless:p}=zr(u);m.length>0&&a.push(`validate_merge_decisions_unreviewed:${m.length}`);let f=o>0?"error":a.length>0?"warn":"ok";return{check:{name:"storage_integrity",status:f,ok:f==="ok",details:{...i,merge_fence:c,merge_driver_configuration:d,pending_merge_decision_count:m.length,pending_merge_decision_items:[...new Set(m.map(g=>g.item_id))].sort((g,h)=>g.localeCompare(h)),lossless_merge_receipt_count:p.length,lossless_merge_receipt_items:[...new Set(p.map(g=>g.item_id))].sort((g,h)=>g.localeCompare(h)),tracked_runtime_cache:{tracker_relative_root:s.tracker_relative_root,tracked_paths:s.tracked_paths,tracked_path_count:s.tracked_path_count,remediation_command:s.remediation_command}}},warnings:a}}function nt(e,t,n){n&&dm(t.check,t.warnings),e.checks.push(t.check),e.warnings.push(...t.warnings)}async function pk(e){let t={checks:[],warnings:[...e.initialWarnings],closeReasonBackfillRows:[],estimateBackfillRows:[],resolutionBackfillRows:[],terminalParentFixRows:[],staleLinkPruneRows:[]},n=e.options.fixHints===!0,r=e.options.verboseDiagnostics===!0||e.options.allAffectedIds===!0||e.global.json===!0;if(e.requestedChecks.has("metadata")){let i=Yb(e.items,e.metadataPolicy,e.statusRegistry,r);t.closeReasonBackfillRows=i.closeReasonBackfillRows,t.estimateBackfillRows=i.estimateBackfillRows,nt(t,i,n)}if(e.requestedChecks.has("resolution")){let i=Xb(e.items,e.statusRegistry,r);t.resolutionBackfillRows=i.resolutionBackfillRows,nt(t,i,n)}if(e.requestedChecks.has("lifecycle")){let i=Cm(e.items,!!e.options.checkStaleBlockers,e.dependencyCycleSeverity,e.parentCycleSeverity,e.statusRegistry,e.lifecyclePatternPolicy,r,e.settings.id_prefix);t.terminalParentFixRows=i.terminalParentFixRows,nt(t,i,n),nt(t,wm(e.items,r,e.statusRegistry),n)}if(e.requestedChecks.has("files")){let i=await $m(e.items,e.workspaceRoot,e.pmRoot,e.fileScanMode,!!e.options.includePmInternals,!!e.options.verboseFileLists);t.staleLinkPruneRows=i.staleLinkPruneRows,nt(t,i,n)}return e.requestedChecks.has("command_references")&&nt(t,Tm(e.items,e.settings.id_prefix,r),n),e.requestedChecks.has("history_drift")&&nt(t,await Vu(e.pmRoot,e.items,r),n),e.requestedChecks.has("format_version")&&nt(t,uk(e.items,r),n),e.requestedChecks.has("storage_integrity")&&nt(t,await mk(e.pmRoot,e.items,G(e.settings,z()).type_to_folder,e.settings),n),t}function fk(e,t,n){let r=[];return e.autoFix===!0&&(r.push(...wu(t.closeReasonBackfillRows)),r.push(...yu(t.resolutionBackfillRows)),r.push(...vu(t.estimateBackfillRows,n.validation.estimate_defaults_by_type)),r.push(...bu(t.terminalParentFixRows))),e.pruneMissing===!0&&r.push(...ku(t.staleLinkPruneRows)),r}async function hk(e,t,n,r,i,a){if(e.autoFix!==!0&&e.pruneMissing!==!0)return;let o=fk(e,t,n),{applicable:s,gated:c}=Su(o,r),l=e.dryRun===!0,d=[],u=[];if(!l){let m=await Dm(s,i,a);d.push(...m.applied.map(En)),u.push(...m.failed.map(({fix:p,error:f})=>({...En(p),error:f instanceof Error?f.message:String(f)})))}return{mode:l?"dry_run":"apply",auto_fix:e.autoFix===!0,prune_missing:e.pruneMissing===!0,granted_fix_scopes:[...r].sort((m,p)=>m.localeCompare(p)),planned_count:o.length,applied_count:d.length,gated_count:c.length,failed_count:u.length,planned_fixes:o.map(En),applied_fixes:d,gated_fixes:c.map(m=>({...En(m),gate_hint:`Withheld: re-run with --fix-scope ${m.gate} to apply.`})),failed_fixes:u}}async function Pm(e,t,n={}){Xo(e.counts===!0,e.full===!0,"--counts");let r=e.autoFix===!0||e.pruneMissing===!0;if(e.dryRun===!0&&!r)throw new _("--dry-run requires --auto-fix or --prune-missing (there is nothing to preview otherwise).",y.USAGE);if(e.fixScope!==void 0&&e.fixScope.length>0&&e.autoFix!==!0)throw new _("--fix-scope requires --auto-fix.",y.USAGE);let i=xu(e.fixScope),a=L(process.cwd(),t.path);if(!await A(K(a)))throw new _(`Tracker is not initialized at ${a}. Run pm init first.`,y.NOT_FOUND);let o=await I(a),s=qe(o.schema),c=G(o,z()),l=um(e),d=[],u=await Ju({includeBody:l.has("history_drift"),pmRoot:a,settings:o,typeToFolder:c.type_to_folder,warnings:d});if(l.has("history_drift")){let E=await cn(a);E.actionable_unknown_event_count>0&&d.push(`validate_history_unknown_author_events:${E.actionable_unknown_event_count}`)}let m=typeof e.metadataProfile=="string"?"option":"settings",p=rm(typeof e.metadataProfile=="string"?e.metadataProfile:o.validation.metadata_profile),f=Lb(p,m,o.validation.metadata_required_fields),g=Nb(o),h=im(e.dependencyCycleSeverity),w=am(e.parentCycleSeverity),v=sm(e.scanMode),b=cm(a),x=await pk({requestedChecks:l,options:e,global:t,pmRoot:a,workspaceRoot:b,settings:o,items:u,statusRegistry:s,metadataPolicy:f,lifecyclePatternPolicy:g,dependencyCycleSeverity:h,parentCycleSeverity:w,fileScanMode:v,initialWarnings:[...new Set(d)]}),R=r?await hk(e,x,o,i,t,n):void 0,k=[...new Set(x.warnings)].sort((E,U)=>E.localeCompare(U)),T={ok:!x.checks.some(E=>E.status==="error"),has_warnings:k.length>0,checks:x.checks,warnings:k,...R!==void 0?{fixes:R}:{},generated_at:$(),projection:{mode:"full",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:["diagnostic_rows"]}};return e.counts!==!0?T:{...Pb(T),projection:{mode:"counts",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:[]}}}import{execFile as gk}from"node:child_process";import{promisify as _k}from"node:util";(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]="f9c26dab-b2fb-5ca0-b575-682b4b0bb830")}catch{}})();var yk=_k(gk),wk=16,vk=3e4;function bk(e,t,n){if(!(e.keys[t].value_type==="number"?typeof n.value=="number"&&Number.isFinite(n.value):Array.isArray(n.value)&&n.value.every(a=>typeof a=="string")))throw new TypeError(`assurance provider ${e.id} key ${t} returned the wrong value type`);if(!Number.isInteger(n.population_size)||n.population_size<0||!Number.isFinite(n.cost)||n.cost<0)throw new TypeError(`assurance provider ${e.id} returned an invalid population or cost`);return n}function kk(e,t){let n=e.keys[t.key];if(!n)throw new TypeError(`assurance provider ${e.id} does not declare key ${t.key}`);let r=t.parameters??{},i=n.parameters??{};for(let a of Object.entries(i).filter(([,o])=>o.required===!0).map(([o])=>o))if(!Object.hasOwn(r,a))throw new TypeError(`assurance provider ${e.id} key ${t.key} requires parameter ${a}`);for(let[a,o]of Object.entries(r)){let s=i[a];if(!s)throw new TypeError(`assurance provider ${e.id} key ${t.key} does not declare parameter ${a}`);if(o===null||typeof o!==s.type)throw new TypeError(`assurance provider ${e.id} parameter ${a} must be ${s.type}`)}return{...r}}async function xk(e,t,n,r){let i=kk(e,t),a=Promise.resolve().then(()=>e.resolve({provider:e.id,key:t.key,parameters:i,trigger:r,pm_root:n,...Qo(n)}));a.catch(()=>{});let o;try{let s=await Promise.race([a,new Promise((c,l)=>{o=setTimeout(()=>l(new TypeError(`assurance provider ${e.id} timed out`)),e.timeout_ms??vk),o.unref?.()})]);return bk(e,t.key,s)}finally{clearTimeout(o)}}function Mm(e,t,n,r){let i=e;for(let a of t.split(".")){if(typeof i!="object"||i===null||Array.isArray(i))throw new Me(`assurance field ${t} is not present`,{source_kind:n,field:t,...r?{check:r}:{}});i=i[a]}if(typeof i=="number"&&Number.isFinite(i)||Array.isArray(i)&&i.every(a=>typeof a=="string"))return i;throw new Me(`assurance field ${t} must resolve to a finite number or string array`,{source_kind:n,field:t,...r?{check:r}:{}})}function Nm(e,t,n,r){let i=e.checks.find(o=>o.name===t);if(!i)throw new Me(`assurance check ${t} is not present`,{source_kind:r,field:n,check:t});return{value:n==="status"||n==="ok"?i.ok?0:1:Mm(i.details,n,r,t),population_size:1,cost:e.checks.length}}async function Sk(e,t){if(t?.trim())return t.trim();try{let{stdout:n}=await yk("git",["rev-parse","HEAD^{commit}"],{cwd:e,encoding:"utf8",timeout:5e3,windowsHide:!0});return n.trim()}catch{return"working-copy"}}async function Ek(e,t){let n=new Array(t.length),r=0,i=Array.from({length:Math.min(wk,t.length)},async()=>{for(;r<t.length;){let a=r;r+=1;let o=t[a],s=await Vn(Mn(e,o.id),o.id);n[a]=s.map(c=>({op:c.op,author:c.author,agent_harness:c.agent_harness,agent_model:c.agent_model}))}});return await Promise.all(i),n.flat()}async function Qr(e,t={}){let n=await I(e),r=G(n),i=qe(n.schema),o=(await Dt(e,n.item_format,r.type_to_folder,void 0,n.schema)).map(p=>({...p,id:p.id,status:p.status,type:p.type})),s={path:e},c=z(),l=Object.fromEntries((c?.assurance_providers??[]).map(p=>[p.definition.id,{cost_class:p.runtime_definition.cost_class,network:p.runtime_definition.network}])),d=new Map,u,m;return{tree_id:t.resolve_tree===!1?t.tree_id??"working-copy":await Sk(e,t.tree_id),items:o,history:t.include_history===!1?[]:await Ek(e,o),terminal_statuses:[...i.terminal_statuses],provider_capabilities:{...l,...t.provider_capabilities},external:async p=>{if(p.kind==="graph"){let h=ye({operation:p.operation,parameters:p.parameters??{}}),w=d.get(h);w===void 0&&(w=Ms(p.operation,void 0,void 0,{...p.parameters,full:!0},s),d.set(h,w));let v=await w;return{value:Mm(v,p.field,p.kind),population_size:o.length,cost:o.length}}if(p.kind==="validate"){u??=Pm({counts:!0},s);let h=await u;return Nm(h,p.check,p.field,p.kind)}if(p.kind==="health"){m??=du(s,{checkOnly:!0,full:!0});let h=await m;return Nm(h,p.check,p.field,p.kind)}let f=t.providers?.[p.provider];if(f)return f(p);let g=ps(c,p.provider);if(!g)throw new TypeError(`assurance provider ${p.provider} is not registered`);return xk(g.runtime_definition,p,e,t.trigger??"sdk")}}}(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]="06d21369-1339-54b2-8d78-442f02e24cef")}catch{}})();var Lm=["list","show","put","remove","run","verdicts","presets","apply","derive","promote"],Fm=["measurement","assertion","gate"];function Ak(e){if(Lm.includes(e))return e;throw new _(`Unknown assurance action ${e}. Expected: ${Lm.join(", ")}`,y.USAGE)}function Rk(e){if(e&&Fm.includes(e))return e;throw new _(`Assurance declaration kind is required. Expected: ${Fm.join(", ")}`,y.USAGE)}function jm(e){if(e&&mr.includes(e))return e;throw new _(`Assurance preset is required. Expected: ${mr.join(", ")}`,y.USAGE)}function so(e){if(e.owner?.trim())return e.owner.trim();throw new _("assurance preset and derivation actions require --owner <pm-item-id>",y.USAGE)}function Ik(e,t){let n=t;if(typeof t=="string")if(!t.trim())n=void 0;else try{n=JSON.parse(t)}catch(r){throw new _("assurance definition must be valid JSON",y.USAGE,{reason:r instanceof Error?r.message:"invalid_json"})}if(typeof n!="object"||n===null||Array.isArray(n))throw new _("assurance put requires a JSON object definition",y.USAGE);return n}async function Ck(e){let[t,n,r]=await Promise.all([on(e,"measurement"),on(e,"assertion"),on(e,"gate")]);return{version:1,measurements:t.items,assertions:n.items,gates:r.items}}function Um(e,t){return t===!0?{id:e.id}:e}async function $k(e,t){let n=t.authorization_decision;if(!n)return[];let r=await Qr(e,{include_history:!1,resolve_tree:!1}),i=r.items.find(o=>o.id===n),a=new Set(r.terminal_statuses);if(!i||i.type.toLowerCase()!=="decision"||!a.has(i.status))throw new _(`Assurance authorization ${n} must name a terminal Decision item`,y.USAGE);return[i.id]}async function Tk(e,t){let n=Fi(e.limit,"assurance verdict limit");if(n!==void 0&&(n<1||n>Lt))throw new _(`assurance verdict limit must be an integer from 1 through ${Lt}`,y.USAGE);let r=await Qs(t,{gate_id:e.id??e.gate,limit:n});return{items:r,count:r.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function Ok(e,t,n){if(e==="presets"){if(t.preset??t.id)return pr(jm(t.preset??t.id),so(t));let i=mr.map(a=>{let o=pr(a,"pm-owner");return{id:a,title:o.title,description:o.description}});return{items:i,count:i.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}if(e==="apply")return Mt(()=>tc(n,jm(t.preset??t.id),so(t),{author:t.author,message:t.message}));if(e==="derive"){let i=await nc(await Qr(n,{resolve_tree:!1,trigger:"derive"}),so(t)),a=t.apply?await Mt(()=>rc(n,i,{author:t.author,message:t.message??"Accept observation-derived assurance proposals"})):void 0;return{items:i,count:i.length,...a?{applied:a}:{}}}if(!t.id)throw new _("assurance promote requires an assertion id",y.USAGE);if(t.enforcement!=="warn"&&t.enforcement!=="block")throw new _("assurance promote requires --enforcement warn|block",y.USAGE);let r=await Di(n,"assertion",t.id);return Mt(()=>ic(n,r,t.enforcement,{author:t.author,message:t.message}))}async function Dk(e,t,n){if(!e.id)throw new _("assurance run requires a gate id",y.USAGE);let r=e.id;if(!e.trigger)throw new _("assurance run requires a trigger",y.USAGE);if(!ht.includes(e.trigger))throw new _(`Unknown assurance trigger ${e.trigger}. Expected: ${ht.join(", ")}`,y.USAGE);let i=e.trigger,[a,o]=await Promise.all([Ck(t),Qr(t,{...n.workspace,tree_id:e.tree,trigger:i})]),s=await Ls(()=>Ks(r,a,o,{trigger:i,dry_run:e.dry_run===!0}));return s.dry_run||await Zs(t,s,{author:e.author,message:e.message}),s}async function Pk(e,t={},n={}){let r=Ak(e.action),i=L(process.cwd(),t.path);if(r==="presets"||r==="apply"||r==="derive"||r==="promote")return Ok(r,e,i);if(r==="verdicts")return Tk(e,i);if(r==="run")return Dk(e,i,n);let a=Rk(e.kind);if(r==="list")return on(i,a);if(!e.id)throw new _(`assurance ${r} requires an id`,y.USAGE);let o=e.id;if(r==="show")return Di(i,a,o);if(r==="remove"){let d=await Mt(()=>Xs(i,a,o,{author:e.author,message:e.message}));return Um(d,e.idOnly)}let s=Ik(a,e.definition);if(s.id!==o)throw new _(`Assurance definition id ${s.id} does not match requested id ${o}`,y.USAGE);let c={author:e.author,message:e.message,...a==="assertion"?{authorized_decision_ids:await $k(i,s)}:{}},l=await Mt(()=>dr(i,a,s,c));return Um(l,e.idOnly)}function uO(e,t,n){let r={...e,...t};return Pk({action:C(r,"subcommand")??C(r,"assuranceAction")??C(r,"operation")??"",kind:C(r,"kind"),id:C(r,"id"),definition:r.definition,trigger:C(r,"trigger"),tree:C(r,"treeId")??C(r,"tree"),gate:C(r,"gate"),limit:Fi(r.limit,"assurance verdict limit"),dry_run:r.dryRun===!0||r.dry_run===!0,fullChangedFields:r.fullChangedFields===!0,idOnly:r.idOnly===!0,author:C(r,"author"),message:C(r,"message"),preset:C(r,"preset"),owner:C(r,"owner"),apply:r.apply===!0,enforcement:C(r,"enforcement")},n)}import{execFile as Nk}from"node:child_process";import Mk from"node:path";import{promisify as Lk}from"node:util";(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]="cdfc451a-1148-50c5-934a-cd8bc2bb39e7")}catch{}})();var Fk=Lk(Nk),jk="@unbrained/pm-cli",Uk="latest";function zk(e){let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new _('Options "--project/--local" and "--global" are mutually exclusive.',y.USAGE);return n?"global":"project"}function ti(e){return e.trim().toLowerCase()}function zm(e,t){let n=ti(t);return[e.name,e.directory,e.source.input,e.source.location,e.source.package,e.source.repository,e.source.owner&&e.source.repo?`${e.source.owner}/${e.source.repo}`:void 0].some(i=>typeof i=="string"&&ti(i)===n)}function Gk(e,t){let n=L(process.cwd(),t.path),r=St(n,process.cwd());return{selected_root:e==="global"?r.global:r.project}}async function qk(e,t,n){try{let r=await Fk(e,t,{cwd:n?.cwd,encoding:"utf8"});return{stdout:r.stdout,stderr:r.stderr}}catch(r){let i=typeof r=="object"&&r!==null&&"stderr"in r?String(r.stderr??""):"",a=i.trim().length>0?i.trim():r instanceof Error?r.message:String(r);throw new _(`Command failed: ${e} ${t.join(" ")}
45
- ${a}`,y.GENERIC_FAILURE)}}async function Wk(){return ko(import.meta.url,["../../.."])}function ni(e){return typeof e.tag=="string"&&e.tag.trim().length>0?e.tag.trim():Uk}function ei(e){return typeof e.packageName=="string"&&e.packageName.trim().length>0?e.packageName.trim():jk}async function Bk(e,t){let n=e.commandRunner??qk,r=ei(e),i=ni(e),a=`${r}@${i}`,o=["npm","install","-g",a];e.repair===!0&&o.push("--force");let s=await Wk(),c={requested:!0,status:"planned",package:r,target:a,command:o,before_version:s,repair:e.repair===!0};if(t)return c;try{await n(o[0],o.slice(1));let l=await n("pm",["--version"]);return{...c,status:"updated",after_version:l.stdout.trim()||void 0}}catch(l){return{...c,status:"failed",error:l instanceof Error?l.message:String(l)}}}function Hk(e){return Mk.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")||e.startsWith("file:")}function Jk(e,t){if(e.kind==="npm"){let n=e.input.startsWith("npm:")?e.input.slice(4).trim():e.input.trim();return!Hk(n)&&e.package&&e.package.trim().length>0?`npm:${e.package.trim()}@${t}`:e.input.startsWith("npm:")?e.input:`npm:${e.input}`}return e.input}async function Vk(e,t){let n=Jk(e,t);return e.kind!=="local"||await A(n)?n:await A(e.location)?e.location:n}function Kk(e,t,n,r){let i=["pm","install",t,n==="global"?"--global":"--project"];return e.kind==="github"&&r&&r.trim().length>0&&i.push("--ref",r.trim()),i}async function Gm(e,t){let n=Gk(e,t);return(await pe(n.selected_root)).state.entries.filter(i=>i.scope===e)}async function Yk(e,t,n){let r=await Gm(e,t);return r.find(i=>zm(i,n.name))??r.find(i=>ti(i.directory)===ti(n.directory))}async function Xk(e,t,n,r,i){let a=ni(t),o=await Vk(e.source,a),s=Kk(e.source,o,r,e.source.ref),c={name:e.name,directory:e.directory,scope:r,source:e.source,status:"planned",command:s,previous_version:e.manifest_version};if(i)return c;try{await Ca(o,{install:!0,project:r==="project",global:r==="global",ref:e.source.kind==="github"?e.source.ref:void 0},n);let l=await Yk(r,n,e);return{...c,status:"updated",installed_version:l?.manifest_version}}catch(l){return{...c,status:"failed",error:l instanceof Error?l.message:String(l)}}}function Zk(e,t,n,r){let i=[n?e.status:void 0,...t.map(a=>a.status)].filter(a=>typeof a=="string");return{requested_cli:n,requested_packages:r,planned:i.filter(a=>a==="planned").length,updated:i.filter(a=>a==="updated").length,skipped:i.filter(a=>a==="skipped").length,failed:i.filter(a=>a==="failed").length}}async function yO(e,t,n){if(t.cliOnly===!0&&t.packagesOnly===!0)throw new _('Options "--cli-only" and "--packages-only" are mutually exclusive.',y.USAGE);let r=zk(t),i=t.dryRun===!0,a=typeof e=="string"&&e.trim().length>0?e.trim():void 0;if(t.cliOnly===!0&&a)throw new _('A package target cannot be used with "--cli-only".',y.USAGE);let o=!(t.packagesOnly===!0||a),s=t.cliOnly!==!0,c=o?await Bk(t,i):{requested:!1,status:"skipped",package:ei(t),target:`${ei(t)}@${ni(t)}`,command:["npm","install","-g",`${ei(t)}@${ni(t)}`],repair:t.repair===!0,reason:"not_requested"},l=s?await Gm(r,n):[];if(a&&(l=l.filter(m=>zm(m,a)),l.length===0))throw new _(`Managed package "${a}" was not found in ${r} scope.`,y.NOT_FOUND);let d=[];for(let m of l)d.push(await Xk(m,t,n,r,i));let u=Zk(c,d,o,s);return{ok:u.failed===0,action:"upgrade",dry_run:i,scope:r,target:a,cli:c,packages:d,summary:u}}import Xt from"node:fs/promises";import ii from"node:path";import ri from"node:fs/promises";import co from"node:path";(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]="b26cf702-330e-5cf5-8371-204220d5c5c9")}catch{}})();var Qk=864e5;function ex(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!="object"||t===null||Array.isArray(t))return null;let n=t.created_at;return typeof n=="string"?n:null}async function tx(e,t){let n;try{n=await ri.readdir(e,{withFileTypes:!0})}catch(i){if(j(i))return[];throw i}let r=[];for(let i of n)if(i.isDirectory()){let a=co.join(e,i.name),o;try{o=await ri.readdir(a)}catch(s){j(s)||t.push(`checkpoint_subdir_unreadable:${i.name}`);continue}for(let s of o)s.endsWith(".json")&&r.push(`${i.name}/${s}`)}else i.name.endsWith(".json")&&r.push(i.name);return r.sort()}async function qm(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*Qk,o=co.join(e,"checkpoints"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c=await tx(o,s.warnings);for(let l of c){let d=co.join(o,l),u=`checkpoints/${l}`;s.scanned+=1,r?.onRead&&s.warnings.push(...await r.onRead(d));let m;try{m=await ri.readFile(d,"utf8")}catch(w){if(j(w)){s.scanned-=1;continue}s.warnings.push(`checkpoint_unreadable:${l}`),s.retained.push(u),s.entries.push({file:u,created_at:null,age_seconds:null,stale:!1,reason:"unparseable"});continue}let p=ex(m),f=p===null?Number.NaN:Date.parse(p);if(!Number.isFinite(f)){s.warnings.push(`checkpoint_unparseable:${l}`),s.retained.push(u),s.entries.push({file:u,created_at:p,age_seconds:null,stale:!1,reason:"unparseable"});continue}let g=i-f,h={file:u,created_at:p,age_seconds:Math.floor(g/1e3),stale:g>a,reason:g>a?"expired":"active"};if(!h.stale){s.retained.push(u),s.entries.push(h);continue}if(!n){try{await ri.unlink(d)}catch(w){if(!j(w)){s.warnings.push(`checkpoint_remove_failed:${l}`),s.retained.push(u),s.entries.push(h);continue}}r?.onWrite&&s.warnings.push(...await r.onWrite(d))}s.removed.push(u),s.entries.push(h)}return s}import lo from"node:fs/promises";import Wm from"node:path";(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]="7df80849-51e1-5efa-b40a-b44088f941a9")}catch{}})();var nx=1440*60*1e3,rx=new Set(["committed","compensated"]);function ix(e){let t;try{t=JSON.parse(e)}catch{return{status:null,updatedAt:null}}if(typeof t!="object"||t===null||Array.isArray(t))return{status:null,updatedAt:null};let n=t;return{status:typeof n.status=="string"?n.status:null,updatedAt:typeof n.updatedAt=="string"?n.updatedAt:null}}function ax(e,t,n,r,i){let a=n===null?Number.NaN:Date.parse(n);if(t===null||!Number.isFinite(a))return{entry:{file:e,status:t,age_seconds:null,stale:!1,reason:"unparseable"},remove:!1};let o=r-a;return rx.has(t)?o>i?{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!0},remove:!0}:{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!1,reason:"fresh"},remove:!1}:{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!1,reason:"active"},remove:!1}}async function ox(e,t,n,r){let i=r.hooks?.onRead?await r.hooks.onRead(e):[],a=ix(await lo.readFile(e,"utf8")),o=ax(t,a.status,a.updatedAt,r.nowMs,r.retentionMs);return o.entry.reason==="unparseable"&&i.push(`transaction_journal_unparseable:${n}`),o.remove&&!r.dryRun&&(await lo.rm(e,{force:!0}),r.hooks?.onWrite&&i.push(...await r.hooks.onWrite(e))),{decision:o,warnings:i}}async function Bm(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*nx,o=Wm.join(e,"transactions","sdk"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c;try{c=(await lo.readdir(o)).filter(l=>l.endsWith(".json")).sort((l,d)=>l.localeCompare(d))}catch(l){if(j(l))return s;throw l}for(let l of c){let d=Wm.join(o,l),u=`transactions/sdk/${l}`,m=await ox(d,u,l,{dryRun:n,hooks:r,nowMs:i,retentionMs:a});s.warnings.push(...m.warnings),s.scanned+=1;let{decision:p}=m;if(!p.remove){s.retained.push(u),s.entries.push(p.entry);continue}s.removed.push(u),s.entries.push(p.entry)}return s}(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]="e982158e-4a8d-57a9-bd0b-24bd73aef342")}catch{}})();var Cn=["index","embeddings","runtime","locks","checkpoints","transactions"],sx=1440*60*1e3,cx=[{scope:"index",relativePath:"index/manifest.json",kind:"file"},{scope:"embeddings",relativePath:"search/embeddings.jsonl",kind:"file"},{scope:"embeddings",relativePath:"search/vectorization-status.json",kind:"file"},{scope:"embeddings",relativePath:"search/lancedb",kind:"directory"},{scope:"embeddings",relativePath:"search/pending-refresh.json",kind:"file"},{scope:"embeddings",relativePath:"search/pending-refresh.gate.lock",kind:"directory"},{scope:"runtime",relativePath:"runtime/test-runs",kind:"directory"},{scope:"runtime",relativePath:"runtime/history-drift-cache.json",kind:"file"}];async function lx(e,t,n){let r=t.relativePath,i=ii.join(e,r),a=await We({path:i,scope:"project"});try{let o=await Xt.stat(i);if(t.kind==="file"&&!o.isFile())return{removed:!1,warnings:[...a,`not_a_file:${r}`]};if(t.kind==="directory"&&!o.isDirectory())return{removed:!1,warnings:[...a,`not_a_directory:${r}`]};if(n)return{removed:!0,warnings:a};t.kind==="file"?await Xt.unlink(i):await Xt.rm(i,{recursive:!0,force:!0});let s=await re({path:i,scope:"project",op:"gc:remove"});return{removed:!0,warnings:[...a,...s]}}catch(o){if(j(o))return{removed:!1,warnings:a};throw o}}async function dx(e,t){let n=[{relativePath:"runtime/workspace-snapshots/objects",prefix:".create-"},{relativePath:"runtime/workspace-snapshots/refs",prefix:".ref-"}],r=[],i=[],a=[],o=Date.now()-sx;for(let s of n){let c=ii.join(e,s.relativePath);if(!await A(c))continue;let l=(await Xt.readdir(c)).filter(d=>d.startsWith(s.prefix)).sort();for(let d of l){let u=ii.posix.join(s.relativePath,d),m=ii.join(c,d);a.push(...await We({path:m,scope:"project"}));let p=await Xt.stat(m).catch(f=>{if(!j(f))throw f});if(p){if(p.mtimeMs>o){i.push(u);continue}r.push(u),!t&&(await Xt.rm(m,{recursive:!0,force:!0}),a.push(...await re({path:m,scope:"project",op:"gc:workspace_snapshot_temp_remove"})))}}}return{removed:r,retained:i,warnings:a}}function ux(e){if(!e||e.length===0)return[...Cn];let t=e.flatMap(r=>r.split(",")).map(r=>r.trim().toLowerCase()).filter(r=>r.length>0);if(t.length===0)throw new _(`--scope requires at least one value (${Cn.join(",")})`,y.USAGE);let n=new Set;for(let r of t){if(!Cn.includes(r))throw new _(`Invalid --scope value "${r}". Expected one or more of: ${Cn.join(", ")}`,y.USAGE);n.add(r)}return Cn.filter(r=>n.has(r))}function mx(e){let t=[];e.dryRun&&t.push("Dry-run preview only: no cache artifacts were deleted.");let n=e.scopes.includes("index")||e.scopes.includes("embeddings"),r=e.removed.some(i=>i==="index/manifest.json"||i==="search/embeddings.jsonl"||i==="search/vectorization-status.json"||i==="search/lancedb"||i==="search/pending-refresh.json"||i==="search/pending-refresh.gate.lock");return n&&r&&t.push('Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.'),e.removed.includes("runtime/history-drift-cache.json")&&t.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.'),!e.dryRun&&e.removed.some(i=>i.startsWith("checkpoints/"))&&t.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.'),!e.dryRun&&e.removed.some(i=>i.startsWith("transactions/"))&&t.push("Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting."),t}async function UO(e,t={}){let n=L(process.cwd(),e.path);if(!await A(K(n)))throw new _(`Tracker is not initialized at ${n}. Run pm init first.`,y.NOT_FOUND);let r=await I(n),i=t.dryRun===!0,a=ux(t.scope),o=cx.filter(f=>a.includes(f.scope)),s=[],c=[],l=[];for(let f of o){let g=await lx(n,f,i);g.removed?s.push(f.relativePath):c.push(f.relativePath),l.push(...g.warnings)}if(a.includes("runtime")){let f=await dx(n,i);s.push(...f.removed),c.push(...f.retained),l.push(...f.warnings)}let d;if(a.includes("locks")){let f=await Ic(n,{dryRun:i,hooks:{onRead:g=>We({path:g,scope:"project"}),onWrite:g=>re({path:g,scope:"project",op:"gc:lock_remove"})}});s.push(...f.removed),c.push(...f.retained),l.push(...f.warnings),d={scanned:f.scanned,removed:f.removed.length,retained:f.retained.length}}let u;if(a.includes("transactions")){let f=r.checkpoints.retention_days,g=await Bm(n,{dryRun:i,retentionDays:f,hooks:{onRead:h=>We({path:h,scope:"project"}),onWrite:h=>re({path:h,scope:"project",op:"gc:transaction_journal_remove"})}});s.push(...g.removed),c.push(...g.retained),l.push(...g.warnings),u={scanned:g.scanned,removed:g.removed.length,retained:g.retained.length,retention_days:f}}let m;if(a.includes("checkpoints")){let f=r.checkpoints.retention_days,g=await qm(n,{dryRun:i,retentionDays:f,hooks:{onRead:h=>We({path:h,scope:"project"}),onWrite:h=>re({path:h,scope:"project",op:"gc:checkpoint_remove"})}});s.push(...g.removed),c.push(...g.retained),l.push(...g.warnings),m={scanned:g.scanned,removed:g.removed.length,retained:g.retained.length,retention_days:f}}l.push(...await Bn({mode:i?"gc:dry-run":"gc",total_items:o.length}));let p=mx({dryRun:i,scopes:a,removed:s});return{ok:l.length===0,dry_run:i,scope:a,removed:s,retained:c,warnings:l,...d?{locks:d}:{},...m?{checkpoints:m}:{},...u?{transactions:u}:{},guidance:p,generated_at:$()}}import px from"node:fs/promises";import $n from"node:path";(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]="fc124f85-8d28-508b-a3f7-2fe767382197")}catch{}})();var uo="index/manifest.json",mo="search/embeddings.jsonl",fx="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function hx(e){return e.progress===!0||process.stderr.isTTY===!0}function ae(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
46
- `)}catch{}}function gx(e){let t=(e??"keyword").trim().toLowerCase();if(t==="keyword")return"keyword";if(t==="semantic"||t==="hybrid")return t;throw new _("Reindex mode must be one of keyword|semantic|hybrid",y.USAGE)}async function _x(e,t,n,r){let i=[];return{candidates:await us(e,t,n,i,r),warnings:i}}async function fo(e,t,n,r,i){let a=xt(z()),o=[];for(let s of t)if(!(i&&!i.has(s.metadata.id))){if(typeof s.body=="string"){o.push({metadata:s.metadata,body:s.body});continue}try{let c=await px.readFile(s.item_path,"utf8"),l=$t(c,{format:s.item_format,schema:n,extensionFieldNames:a,onWarning:d=>r.push(d)});o.push({metadata:s.metadata,body:l.body})}catch{r.push(`item_list_item_read_failed:${$n.relative(e,s.item_path)}`),o.push({metadata:s.metadata,body:""})}}return o}function yx(e,t,n){let r=e.metadata;return{id:r.id,mode:t,updated_at:r.updated_at,corpus:ws(e,{fields:n})}}var Zt=Z;function wx(e){let t=z(),n=Zt(e.search?.provider);if(!n)return null;let r=fs(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=Zt(i.name)??Zt(r.definition.name);if(!a)return null;let o=i.embedBatch,s=i.embed_batch,c=i.embed,l=typeof o=="function"?o:typeof s=="function"?s:void 0,d=typeof c=="function"?c:void 0;return!l&&!d?null:{name:a,embedBatch:l,embed:d}}function vx(e){let t=z(),n=Zt(e.vector_store?.adapter);if(!n)return null;let r=hs(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=Zt(i.name)??Zt(r.definition.name);if(!a)return null;let o=i.upsert,s=i.delete;return{adapterName:a,...typeof o=="function"?{upsert:o}:{},...typeof s=="function"?{delete:s}:{}}}function po(e,t){if(!Array.isArray(e)||e.some(n=>typeof n!="number"||!Number.isFinite(n)))throw new _(`Invalid vector returned by ${t}`,y.GENERIC_FAILURE);return e}async function bx(e,t,n){let r=t.search?.embedding_model?.trim()||"text-embedding-3-small";if(e.embedBatch){let a=await Promise.resolve(e.embedBatch({inputs:n,settings:t,model:r}));if(!Array.isArray(a))throw new _(`Extension search provider "${e.name}" embedBatch must return an array of vectors`,y.GENERIC_FAILURE);return a.map((o,s)=>po(o,`extension search provider "${e.name}" embedBatch output at index ${s}`))}if(!e.embed)throw new _(`Extension search provider "${e.name}" does not implement embed/embedBatch`,y.GENERIC_FAILURE);let i=[];for(let[a,o]of n.entries()){let s=await Promise.resolve(e.embed({input:o,settings:t,model:r}));i.push(po(s,`extension search provider "${e.name}" embed output at index ${a}`))}return i}function Hm(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function Jm(e,t,n){let r=n?ft(n.name,Hm(e)):t?ft(t.name,t.model):null;if(!r)throw new _("No embedding identity available for semantic reindex mode",y.USAGE);return r}function kx(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,r)=>n.localeCompare(r))}async function Vm(e,t,n,r,i,a,o,s){let c=r?.name??n?.name,l=vs(c,e.search.embedding_corpus_max_characters).maxCharacters,d=Si(e),u=i.map(f=>bs(f,{providerName:c,maxCharacters:l,fields:d})),m=[],p=null;if(r)try{m=await bx(r,e,u),p=ft(r.name,Hm(e))}catch(f){if(!n)throw new _(`Extension search provider "${r.name}" failed to generate embeddings: ${f instanceof Error?f.message:String(f)}`,y.GENERIC_FAILURE);a.push(`Extension search provider "${r.name}" failed; falling back to built-in provider (${f instanceof Error?f.message:String(f)})`)}if(m.length===0){if(!n)throw new _(`No embedding executor available for reindex mode '${t}'`,y.USAGE);let f=await ks(n,e,u,{onProgress:g=>{g.phase==="complete"&&(o.batches_completed=g.batch_index),ae(s,`embedding_batch_${g.phase} batch=${g.batch_index}/${g.batch_total} size=${g.batch_size} completed_inputs=${g.completed_inputs}/${g.total_inputs}`)}});a.push(...f.warnings),m=f.vectors,p=ft(n.name,n.model)}if(ae(s,`embedding_complete vectors=${m.length}`),m.length!==i.length)throw new _(`Embedding output size mismatch (expected ${i.length}, received ${m.length})`,y.GENERIC_FAILURE);if(!p)throw new _(`No embedding identity available for reindex mode '${t}'`,y.USAGE);return{vectors:m,embeddingIdentity:p}}async function xx(e,t,n,r,i,a){let o=Object.keys(n);if(t){if(o.length>0&&t.delete)try{await Promise.resolve(t.delete({ids:o.sort((s,c)=>s.localeCompare(c)),settings:r}))}catch(s){throw new _(`Extension vector adapter "${t.adapterName}" failed to delete vectors during reindex reset: ${s instanceof Error?s.message:String(s)}`,y.GENERIC_FAILURE)}else o.length>0&&i.push(`search_semantic_reindex_reset_skipped:adapter=${t.adapterName}:known_ids=${o.length}`);if(!e)return}e&&await Es(e,o,{},a)}async function Km(e,t,n,r,i){if(n.length!==0){if(t){if(t.delete)try{await Promise.resolve(t.delete({ids:n,settings:r}))}catch(a){throw new _(`Extension vector adapter "${t.adapterName}" failed to delete orphan vectors during reindex: ${a instanceof Error?a.message:String(a)}`,y.GENERIC_FAILURE)}else i.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${t.adapterName}:count=${n.length}`);if(!e)return}e&&await Ss(e,n)}}function Sx(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function Ex(e,t,n){return{version:1,mode:e,generated_at:t,total_items:n.length,items:n.map(r=>({id:r.metadata.id,type:r.metadata.type,status:r.metadata.status,priority:r.metadata.priority,updated_at:r.metadata.updated_at}))}}function Ax(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=nn(e.settings);if(!t.active&&!e.extensionEmbedding)throw new _(`Reindex mode '${e.requestedMode}' requires a configured embedding provider in settings.providers.openai/settings.providers.ollama or an extension provider selected by settings.search.provider`,y.USAGE);let n=rr(e.settings,e.pmRoot);if(!n.active&&!e.extensionVectorAdapter)throw new _(`Reindex mode '${e.requestedMode}' requires a configured vector store in settings.vector_store.qdrant/settings.vector_store.lancedb or an extension adapter selected by settings.vector_store.adapter`,y.USAGE);return{activeEmbeddingProvider:t.active,activeVectorStore:n.active}}async function Rx(e){let t=G(e.settings,z()),n=await _x(e.pmRoot,e.settings.item_format,t.type_to_folder,e.settings.schema);return{documentCandidates:n.candidates,warnings:[...n.warnings],metadataDocuments:n.candidates.map(r=>({metadata:r.metadata,body:typeof r.body=="string"?r.body:""}))}}async function Ix(e){let t=await Nt(e.pmRoot);if(e.reindexWarnings.push(...t.warnings),e.forceFullSemantic&&e.reindexWarnings.push("search_semantic_reindex_full_ignored:mode_keyword"),!t.embedding)return;let n=(()=>{try{return Jm(e.settings,nn(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&Pt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(fx))}async function Cx(e){let t=await Nt(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=Jm(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),r=new Set(e.metadataDocuments.map(l=>l.metadata.id)),i=kx(t.entries,r),a=Pt(t.embedding,n);e.forceFullSemantic&&!a&&e.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced");let o=e.forceFullSemantic||a?e.metadataDocuments:e.metadataDocuments.filter(l=>t.entries[l.metadata.id]!==l.metadata.updated_at),s=new Set(o.map(l=>l.metadata.id)),c=s.size>0?await fo(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,s):[];return{ledgerEntries:t.entries,ledgerEmbedding:t.embedding,orphanIds:i,resetRequired:a,staleDocuments:c,freshDocuments:e.metadataDocuments.length-c.length}}async function $x(e){let t=new Set(e.metadataDocuments.map(i=>i.metadata.id)),n=await fo(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,ae(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let r=await Vm(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...r,staleDocuments:n,vectorDimension:Ei(r.vectors,"Reindex embeddings")}}async function Tx(e){let t=await Vm(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,r=t.embeddingIdentity,i=Ei(n,"Reindex embeddings");if(!(!e.resetRequired&&(Pt(e.ledgerEmbedding,r)||Rs(e.ledgerEmbedding,i))))return{vectors:n,embeddingIdentity:r,staleDocuments:e.staleDocuments,vectorDimension:i,resetRequired:e.resetRequired};let o=await $x(e);return n=o.vectors,r=o.embeddingIdentity,i=o.vectorDimension,{vectors:n,embeddingIdentity:r,staleDocuments:o.staleDocuments,vectorDimension:i,resetRequired:!0}}async function Ox(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(ae(e.progressEnabled,`vector_upsert_start adapter=${t} points=${e.points.length}`),typeof e.extensionVectorAdapter.upsert!="function")throw new _(`Extension vector adapter "${t}" does not support upserting vectors.`,y.USAGE);await Promise.resolve(e.extensionVectorAdapter.upsert({points:e.points,settings:e.settings})),e.semanticSummary.vector_upserted=e.points.length,ae(e.progressEnabled,`vector_upsert_complete adapter=${t}`);return}catch(t){if(t instanceof _)throw t;if(!e.activeVectorStore)throw new _(`Extension vector adapter "${e.extensionVectorAdapter.adapterName}" failed to upsert vectors: ${t instanceof Error?t.message:String(t)}`,y.GENERIC_FAILURE);e.semanticWarnings.push(`Extension vector adapter "${e.extensionVectorAdapter.adapterName}" failed; falling back to built-in vector store (${t instanceof Error?t.message:String(t)})`),ae(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){ae(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await xs(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,ae(e.progressEnabled,`vector_upsert_complete adapter=${e.activeVectorStore.name}`);return}throw new _(`No vector upsert executor available for reindex mode '${e.requestedMode}'`,y.USAGE)}function Dx(e,t){return e.map((n,r)=>({id:n.metadata.id,vector:po(t[r],`reindex embeddings output at index ${r}`),payload:{id:n.metadata.id,type:n.metadata.type,status:n.metadata.status,priority:n.metadata.priority,updated_at:n.metadata.updated_at}}))}async function Px(e){ae(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await Tx({pmRoot:e.pmRoot,settings:e.settings,requestedMode:e.requestedMode,activeEmbeddingProvider:e.activeEmbeddingProvider,extensionEmbedding:e.extensionEmbedding,documentCandidates:e.documentCandidates,metadataDocuments:e.metadataDocuments,staleDocuments:e.plan.staleDocuments,ledgerEmbedding:e.plan.ledgerEmbedding,resetRequired:e.plan.resetRequired,semanticWarnings:e.semanticWarnings,reindexWarnings:e.reindexWarnings,semanticSummary:e.semanticSummary,progressEnabled:e.progressEnabled});t.resetRequired?(ae(e.progressEnabled,"vector_reset_start"),await xx(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),ae(e.progressEnabled,"vector_reset_complete")):await Km(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=Dx(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await Ox({requestedMode:e.requestedMode,activeVectorStore:e.activeVectorStore,extensionVectorAdapter:e.extensionVectorAdapter,settings:e.settings,points:n,semanticWarnings:e.semanticWarnings,semanticSummary:e.semanticSummary,progressEnabled:e.progressEnabled}),{staleDocuments:t.staleDocuments,embeddingMetadata:As(t.embeddingIdentity,t.vectorDimension)}}async function Nx(e){let t=await Cx(e);e.semanticSummary.stale_items=t.staleDocuments.length,e.semanticSummary.unchanged_items=t.freshDocuments;let n=Object.fromEntries(e.metadataDocuments.map(a=>[a.metadata.id,a.metadata.updated_at]));if(ae(e.progressEnabled,`semantic_stale_items stale=${t.staleDocuments.length} total=${e.metadataDocuments.length} unchanged=${t.freshDocuments} full=${e.forceFullSemantic||t.resetRequired}`),t.staleDocuments.length===0)return ae(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await Km(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let r=await Px({...e,plan:t});t.freshDocuments>0&&e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`);let i=new Map(r.staleDocuments.map(a=>[a.metadata.id,a]));return{documentsForKeywordArtifacts:e.metadataDocuments.map(a=>i.get(a.metadata.id)??a),vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:r.embeddingMetadata}}async function Mx(e){let t=$n.join(e.pmRoot,uo),n=$n.join(e.pmRoot,mo),r=Si(e.settings),i=e.documentsForKeywordArtifacts.map(o=>JSON.stringify(yx(o,e.mode,r))).join(`
47
- `);ae(e.progressEnabled,"writing keyword artifacts"),await ce(t,`${JSON.stringify(e.manifest,null,2)}
48
- `),await ce(n,`${i}
49
- `);let a=[];if(e.mode!=="keyword")try{ae(e.progressEnabled,"writing vectorization status ledger"),await Is(e.pmRoot,e.vectorizationLedgerEntries,e.vectorizationEmbeddingMetadata)}catch(o){a.push(`search_vectorization_status_ledger_write_failed:${o instanceof Error?o.message:String(o)}`)}return a}async function BO(e,t){let n=gx(e.mode),r=hx(e),i=e.full===!0;ae(r,`start mode=${n}`);let a=L(process.cwd(),t.path);if(!await A(K(a)))throw new _(`Tracker is not initialized at ${a}. Run pm init first.`,y.NOT_FOUND);let o=nr(await I(a)).settings,s=null;try{s=await le(a,ys,o.locks.ttl_seconds,Y(void 0,"pm-reindex"),!1,o.governance.force_required_for_stale_lock,o.locks.wait_ms)}catch(c){throw c instanceof _&&c.exitCode===y.CONFLICT?new _("Another pm reindex run is already active for this project. Wait for it to finish before starting a new keyword, semantic, or hybrid reindex.",y.CONFLICT,{code:"reindex_already_running",type:"urn:pm-cli:error:reindex_already_running",why:"Semantic reindex can be expensive and duplicate runs compete for the same local embedding model and vector store.",nextSteps:["Check active pm reindex processes before starting another reindex.","Rerun with --progress when you need non-interactive visibility."]}):c}try{let c=wx(o),l=vx(o),d=Ax({requestedMode:n,pmRoot:a,settings:o,extensionEmbedding:c,extensionVectorAdapter:l}),u=n;ae(r,"loading item corpus");let m=await Rx({pmRoot:a,settings:o}),p=m.warnings,{documentCandidates:f,metadataDocuments:g}=m;ae(r,`loaded_items=${g.length}`);let h=$(),w=Ex(u,h,g),v=$n.join(a,uo),b=$n.join(a,mo),x=u==="keyword"?await fo(a,f,o.schema,p):g,R=[],k={},F=null,T=Sx(u);if(u==="keyword"&&await Ix({pmRoot:a,settings:o,forceFullSemantic:i,extensionEmbedding:c,reindexWarnings:p}),u!=="keyword"){let B=await Nx({pmRoot:a,settings:o,requestedMode:n,activeEmbeddingProvider:d.activeEmbeddingProvider,activeVectorStore:d.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:l,documentCandidates:f,metadataDocuments:g,documentsForKeywordArtifacts:x,forceFullSemantic:i,reindexWarnings:p,semanticWarnings:R,semanticSummary:T,progressEnabled:r});x=B.documentsForKeywordArtifacts,k=B.vectorizationLedgerEntries,F=B.vectorizationEmbeddingMetadata}let E=await Mx({pmRoot:a,mode:u,manifest:w,documentsForKeywordArtifacts:x,settings:o,vectorizationLedgerEntries:k,vectorizationEmbeddingMetadata:F,progressEnabled:r}),U=[...await re({path:v,scope:"project",op:"reindex:manifest"}),...await re({path:b,scope:"project",op:"reindex:embeddings"}),...await Bn({mode:u,total_items:g.length})];return ae(r,"done"),{ok:!0,mode:u,total_items:g.length,semantic:T,artifacts:{manifest:uo,embeddings:mo},warnings:[...p,...R,...E,...U],generated_at:h}}finally{await s?.()}}export{xE as a,nl as b,N as c,ve as d,Me as e,Mt as f,Ls as g,js as h,ht as i,Ri as j,ip as k,Ci as l,$i as m,qs as n,Ft as o,an as p,Oi as q,gp as r,Ks as s,on as t,Di as u,dr as v,Pi as w,Xs as x,Zs as y,Qs as z,mr as A,pr as B,tc as C,nc as D,rc as E,ic as F,yr as G,sc as H,C as I,ee as J,Sp as K,Fi as L,RS as M,IS as N,mc as O,CS as P,$S as Q,TS as R,OS as S,DS as T,ji as U,PS as V,NS as W,Li as X,MS as Y,LS as Z,pc as _,FS as $,Op as aa,hc as ba,JS as ca,cn as da,Mp as ea,Lp as fa,VS as ga,Fp as ha,Tc as ia,lf as ja,df as ka,gt as la,qE as ma,_f as na,ih as oa,BA as pa,HA as qa,JA as ra,un as sa,VA as ta,KA as ua,YA as va,XA as wa,ZA as xa,QA as ya,eR as za,tR as Aa,nR as Ba,rR as Ca,iR as Da,Ca as Ea,ZS as Fa,QS as Ga,wc as Ha,Wy as Ia,XC as Ja,kn as Ka,zr as La,ZC as Ma,QC as Na,du as Oa,j$ as Pa,mu as Qa,Fu as Ra,X$ as Sa,gu as Ta,Uu as Ua,WT as Va,BT as Wa,rb as Xa,ib as Ya,KT as Za,YT as _a,XT as $a,ZT as ab,ob as bb,sb as cb,cb as db,QT as eb,qu as fb,db as gb,Wu as hb,Xa as ib,Hu as jb,ub as kb,mb as lb,pb as mb,Pb as nb,q0 as ob,Pm as pb,Qr as qb,Lm as rb,Fm as sb,Pk as tb,uO as ub,yO as vb,UO as wb,BO as xb};
50
- //# sourceMappingURL=chunk-ITAUHSO6.js.map
15
+ `;return c===i?{path:r,changed:!1}:(n||await Ff(r,c,"utf8"),{path:r,changed:!0})}function Rr(e){let t=q(e,null);return[...new Set(Object.values(t.type_to_folder))].sort((n,r)=>n.localeCompare(r))}async function ll(e,t){let n=te.resolve(e),r=null,i="",a=n;for(let v=0;v<8;v+=1){let b=te.join(a,".gitattributes");try{let R=await Ar(b,"utf8");if(R.includes(qt)||R.includes(Er)){r=a,i=R;break}}catch{}let x=te.dirname(a);if(x===a)break;a=x}if(r===null)return{status:"not_installed",missing_patterns:[],stale_patterns:[],schema_scope:"project"};let o=te.join(r,".gitattributes"),s=i.includes(qt),c=s?qt:Er,l=s?ia:il,d=i.indexOf(c),u=i.indexOf(l),m=u>d?i.slice(d+c.length,u).split(`
16
+ `).map(v=>v.trim()).filter(v=>v.length>0):[],p=sa(oa(r,n),t),f=new Set(m),g=new Set(p),h=p.filter(v=>!f.has(v)),w=m.filter(v=>!g.has(v));return{status:h.length>0||w.length>0?"drift":"ok",path:o,missing_patterns:h,stale_patterns:w,schema_scope:"project"}}async function Ir(e){let t=al(),n=[],r=[];for(let i of ol){let a=`merge.${i.key}.driver`,o=` merge driver ${i.artifact} "%O" "%A" "%B"${i.itemPath===void 0?"":` --item-path ${i.itemPath}`}`,s=`${t}${o}`;try{let{stdout:c}=await aa("git",["config","--local","--get",a],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4}),l=c.trim();l!==s&&!await Gf(l,o)&&r.push(a)}catch{n.push(a)}}return{status:n.length>0?"missing":r.length>0?"drift":"ok",missing_keys:n,drifted_keys:r}}async function dl(e){let t;try{t=await sl(te.resolve(e))}catch{return{status:"no_git"}}let n=oa(t,te.resolve(e)),r=await I(e),i=Y(void 0,r.author_default),a=await de(e,zf,r.locks.ttl_seconds,i,!1,Te(r).force_required_for_stale_lock,r.locks.wait_ms);try{let o=te.join(t,".gitattributes"),s;try{s=await Ar(o,"utf8")}catch(u){if(u instanceof Error&&"code"in u&&j(u))return{status:"not_installed",path:o};throw u}if(!s.includes(qt)&&!s.includes(Er))return{status:"not_installed",path:o};let c=await I(e),l=Rr(c),d=await cl(t,sa(n,l),!1);return{status:d.changed?"refreshed":"unchanged",path:d.path}}finally{await a()}}async function GA(e,t){let n=qf({cwd:process.cwd(),explicitPath:t.path,dryRun:e.dryRun===!0,environment:process.env}),r=n.pm_root;if(!await A(K(r)))throw new y(`Tracker is not initialized at ${r}. Run pm init first.`,_.NOT_FOUND);let i=await sl(n.workspace_start);return Wf({pmRoot:r,workspaceRoot:i,dryRun:e.dryRun===!0})}async function Wf(e){let t=te.resolve(e.pmRoot),n=te.resolve(e.workspaceRoot),r=e.dryRun===!0,i,a;try{[i,a]=await Promise.all([ra(t),ra(n)])}catch(p){throw new y(`Cannot resolve tracker root ${t} or workspace root ${n}: ${String(p)}`,_.NOT_FOUND,{code:"merge_root_not_found",nextSteps:["Initialize the tracker and ensure both paths are accessible.",'Retry "pm merge install" from the repository workspace.']})}let o=oa(a,i);if(na(o))throw new y(`Tracker root ${t} is outside the git repository ${n}; there is nothing to configure for this repository.`,_.USAGE);let s=await I(i),c=Rr(s),l=sa(o,c),d=[],u=al();for(let p of ol)d.push({key:`merge.${p.key}.name`,value:p.name}),d.push({key:`merge.${p.key}.driver`,value:`${u} merge driver ${p.artifact} "%O" "%A" "%B"${p.itemPath===void 0?"":` --item-path ${p.itemPath}`}`});if(!r)try{for(let p of d)await aa("git",["config","--local",p.key,p.value],{cwd:a,encoding:"utf8",windowsHide:!0,timeout:1e4})}catch{throw new y(`Cannot install repository-local merge drivers in ${a}. Ensure the repository Git config is writable and no other Git process holds its lock, then retry.`,_.DEPENDENCY_FAILED,{code:"merge_git_config_unwritable",why:"pm merge install must persist clone-local driver commands before publishing their shared .gitattributes mappings.",nextSteps:["Make the repository Git config writable or wait for the process holding its lock to finish.",'Retry "pm merge install"; the operation is idempotent.','Use "pm merge install --dry-run --json" when the workspace is intentionally read-only.']})}let m=await cl(a,l,r);return{ok:!0,dry_run:r,workspace_root:a,pm_root:i,gitattributes:{path:m.path,changed:m.changed,patterns:l,schema_scope:"project"},git_config:d,guidance:["Commit .gitattributes so every branch and collaborator shares the merge mapping.",'git config is per-clone: each collaborator (and each fresh worktree/clone) runs "pm merge install" once.','After merging branches, run "pm merge reconcile --dry-run" to inspect the complete receipt and history repair, then apply "pm merge reconcile"; use --force only after explicitly accepting any discarded values.',"Custom item types registered later refresh this fence automatically (pm schema add-type/remove-type); rerun pm merge install only after out-of-band type-folder edits."],generated_at:$()}}(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]="3d53ef97-6dd5-5dea-a5c2-9bc9e62d881c")}catch{}})();var Bf=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function Hf(e){let t=Bf.exec(e.trim());if(!t)return;let n=t[1];if(!(n.length<2)&&!/^[A-Za-z]\d+$/.test(n))return n.toLowerCase()}function Jf(e){return e.split(/[-_]+/).filter(t=>t.length>0).map(t=>`${t.slice(0,1).toUpperCase()}${t.slice(1).toLowerCase()}`).join("")}function ul(e,t={}){let n=typeof t.minCount=="number"&&t.minCount>0?Math.trunc(t.minCount):10,r=typeof t.maxExamples=="number"&&t.maxExamples>0?Math.trunc(t.maxExamples):3,i=new Map;for(let o of e){let s=typeof o=="string"?o.trim():"";if(s.length===0)continue;let c=Hf(s);if(c===void 0)continue;let l=i.get(c)??{count:0,examples:[]};l.count+=1,l.examples.length<r&&l.examples.push(s),i.set(c,l)}let a=[];for(let[o,s]of i.entries()){if(s.count<n)continue;let c=Jf(o);a.push({name:c,prefix:o,count:s.count,examples:s.examples,shadows_builtin:Ko(c)!==void 0})}return a.sort((o,s)=>s.count-o.count||o.name.localeCompare(s.name)),a}import{createHash as xl}from"node:crypto";import wt from"node:fs/promises";import Wt from"node:path";import{mkdir as Vf,readFile as Kf}from"node:fs/promises";import _l from"node:path";(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]="6ed4a26f-2ae2-556a-87db-56844108757f")}catch{}})();var ca=class extends Error{constructor(t="Workspace transaction interrupted"){super(t),this.name="WorkspaceTransactionInterruptedError"}},Yf="sdk-workspace-transaction",Xf=/^[a-zA-Z0-9._-]+$/,Zf=30,Qf=3e3;function ml(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n||!Xf.test(n))throw new TypeError(`${t} must match [a-zA-Z0-9._-]+`);return n}function pl(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n)throw new TypeError(`${t} must be non-empty`);return n}function fl(e,t,n){let r=e??t;if(!Number.isInteger(r)||r<=0)throw new TypeError(`${n} must be a positive integer`);return r}function yl(e,t){return _l.join(e,"transactions","sdk",`${t}.json`)}async function at(e,t){t.updatedAt=$();let n=yl(e,t.transactionId);await Vf(_l.dirname(n),{recursive:!0}),await le(n,`${JSON.stringify(t,null,2)}
17
+ `)}function eh(e){return Number.isInteger(e.attempt)&&typeof e.author=="string"&&typeof e.createdAt=="string"&&typeof e.updatedAt=="string"}function yt(e){return Object.assign(Object.create(null),e)}function th(e,t){try{let n=JSON.stringify(e,(r,i)=>{if(typeof i=="number"&&!Number.isFinite(i))throw new TypeError(`${t} contains a non-finite number`);if(i===void 0||typeof i=="function"||typeof i=="symbol")throw new TypeError(`${t} contains a non-JSON value`);return i});return JSON.parse(n)}catch(n){throw new TypeError(`${t} must be JSON serializable`,{cause:n})}}function la(e,t){return e===void 0?void 0:th(e,t)}function da(e,t,n,r){let i=la(n,r);i===void 0?delete e[t]:e[t]=i}function hl(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function gl(e,t){return Array.isArray(e)&&new Set(e).size===e.length&&e.every(n=>typeof n=="string"&&t.includes(n))}function nh(e,t){if(!gl(e.startedStepIds,t)||!gl(e.completedStepIds,t)||!hl(e.results)||!hl(e.compensationData))return!1;let n=e.startedStepIds,r=new Set(n),i=e.completedStepIds,a=new Set(i);return Object.keys(e.compensationData).some(o=>!r.has(o))||Object.keys(e.results).some(o=>!a.has(o))?!1:e.status==="committed"?t.every(o=>a.has(o)):e.status!=="compensated"||a.size===0&&r.size===0}function rh(e,t,n){let r;try{r=JSON.parse(e)}catch{throw new TypeError(`Workspace transaction ${t} journal is invalid JSON`)}if(!r||typeof r!="object"||Array.isArray(r))throw new TypeError(`Workspace transaction ${t} journal is invalid`);let i=r,a=i.schemaVersion===1&&i.transactionId===t,o=Array.isArray(i.stepIds)&&i.stepIds.length===n.length&&i.stepIds.every((d,u)=>d===n[u]),s=nh(i,n),c=eh(i),l=["applying","compensating","compensated","committed"].includes(String(i.status));if(!a||!o||!s||!c||!l)throw new TypeError(`Workspace transaction ${t} journal does not match the supplied plan`);return{...i,results:yt(i.results),compensationData:yt(i.compensationData)}}async function ih(e,t,n,r,i){let a=i,o=a!==void 0;if(a?.status==="compensating"&&await wl(e,a),a===void 0||a.status==="compensated"){let s=$();a={schemaVersion:1,transactionId:t,author:n,status:"applying",attempt:(a?.attempt??0)+1,createdAt:a?.createdAt??s,updatedAt:s,stepIds:r,startedStepIds:[],completedStepIds:[],results:yt(),compensationData:yt()},await at(e.pmRoot,a),await Ye(e,a,"prepared")}return{journal:a,recovered:o}}async function ah(e,t,n){try{await sh(t,e.steps),await at(e.pmRoot,t);let r=new Set(t.completedStepIds),i=new Set(t.startedStepIds);for(let a of e.steps){if(r.has(a.id))continue;let o=await a.inspect(),s=la(o.result,`Step ${a.id} result`);if(o.state!=="applied"){let c=await a.prepareCompensation?.();da(t.compensationData,a.id,c,`Step ${a.id} compensation data`),i.add(a.id),t.startedStepIds=e.steps.map(d=>d.id).filter(d=>i.has(d)),await at(e.pmRoot,t);let l=await a.apply();s=la(l,`Step ${a.id} result`)}await Ye(e,t,"step_applied",a.id),r.add(a.id),t.completedStepIds=e.steps.map(c=>c.id).filter(c=>r.has(c)),da(t.results,a.id,s,`Step ${a.id} result`),await at(e.pmRoot,t),await Ye(e,t,"step_recorded",a.id)}return await Ye(e,t,"committing"),t.status="committed",await at(e.pmRoot,t),await Ye(e,t,"committed"),{transactionId:t.transactionId,status:"committed",recovered:n,results:yt(t.results)}}catch(r){if(r instanceof ca||t.status==="committed")throw r;try{await wl(e,t)}catch(i){throw new AggregateError([r,i],`Workspace transaction failed and compensation failed: ${String(i)}`,{cause:i})}throw r}}async function oh(e,t,n){try{return rh(await Kf(yl(e,t),"utf8"),t,n)}catch(r){if(r!==null&&typeof r=="object"&&"code"in r&&j(r))return;throw r}}async function Ye(e,t,n,r){await e.onTransition?.({transactionId:t.transactionId,attempt:t.attempt,transition:n,...r===void 0?{}:{stepId:r}})}async function sh(e,t){let n=new Set,r=yt();for(let i of t){let a=await i.inspect();a.state==="applied"&&(n.add(i.id),da(r,i.id,a.result,`Step ${i.id} result`))}e.results=r,e.completedStepIds=t.map(i=>i.id).filter(i=>n.has(i))}async function wl(e,t){t.status="compensating",await at(e.pmRoot,t),await Ye(e,t,"compensating");let n=new Set(t.completedStepIds),r=new Set(t.startedStepIds);for(let i of[...e.steps].reverse()){if(!r.has(i.id)&&!n.has(i.id))continue;let a;try{a=r.has(i.id)&&(await i.inspect()).state==="applied"}catch{a=r.has(i.id)}a&&(await Ye(e,t,"step_compensating",i.id),await i.compensate(t.compensationData[i.id])),n.delete(i.id),r.delete(i.id),t.completedStepIds=e.steps.map(o=>o.id).filter(o=>n.has(o)),t.startedStepIds=e.steps.map(o=>o.id).filter(o=>r.has(o)),delete t.results[i.id],delete t.compensationData[i.id],await at(e.pmRoot,t),await Ye(e,t,"step_compensated",i.id)}t.status="compensated",await at(e.pmRoot,t),await Ye(e,t,"compensated")}async function vl(e){let t=pl(e.pmRoot,"Transaction pmRoot"),n=ml(e.transactionId,"Transaction id"),r=pl(e.author,"Transaction author"),i=fl(e.lockTtlSeconds,Zf,"Transaction lock TTL"),a=fl(e.lockWaitMs,Qf,"Transaction lock wait"),o=[...e.steps];if(o.length===0)throw new TypeError("Workspace transaction requires at least one step");let s=o.map(d=>{let u=ml(d.id,"Transaction step id");if(u!==d.id)throw new TypeError("Transaction step id must not contain surrounding whitespace");return u});if(new Set(s).size!==s.length)throw new TypeError("Workspace transaction step ids must be unique");let c={...e,pmRoot:t,transactionId:n,author:r,steps:o,lockTtlSeconds:i,lockWaitMs:a},l=await de(t,Yf,i,r,!1,!1,a);try{let d=await oh(t,n,s),u=d!==void 0;if(d?.status==="committed")return{transactionId:n,status:"committed",recovered:!0,results:yt(d.results)};let m=await ih(c,n,r,s,d);return await ah(c,m.journal,u||m.recovered)}finally{await l()}}(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]="cd777de3-665f-5e01-ac98-8986f2a5a4c2")}catch{}})();function Xe(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Schema migration ${t} must be non-empty`);return e.trim()}function Sl(e){let t=Xe(e,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(t))throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");return t}function El(e,t){let n=ma(e),r=Xe(t,"migrationScope");return`auto-${xl("sha256").update(JSON.stringify({scope:r,request:n})).digest("hex").slice(0,20)}`}function ma(e){let t=e.kind==="rename-type"?{kind:e.kind,from:Xe(e.from,"source"),to:Xe(e.to,"target")}:e.kind==="rename-field"?{kind:e.kind,from:se(Xe(e.from,"source")),to:se(Xe(e.to,"target")),...e.type===void 0?{}:{type:Xe(e.type,"type")}}:{kind:e.kind,from:se(Xe(e.from,"source")),to:se(Xe(e.to,"target"))};if(t.from.toLowerCase()===t.to.toLowerCase())throw new TypeError("Schema migration source and target must differ");return t}function ch(e){return e.kind==="rename-type"?"types":e.kind==="rename-field"?"fields":"statuses"}function lh(e,t,n){let r=we(t.schema),i=ch(n);return Le(e,r.files[i],Ae[i])}function Al(e,t){return Wt.join(e,"transactions","schema",`${t}-plan.json`)}function Cr(e){return e.length===0?null:JSON.parse(e)}async function Gt(e){let t=await X(e);return{exists:t!==null,raw:t??""}}async function Rl(e,t){t.exists?await le(e,t.raw):await wt.rm(e,{force:!0})}function dh(e,t,n){let r=We(e),i=r.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.from.toLowerCase()),a=r.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.to.toLowerCase());if(n==="stage"){if(a>=0)return it(r);if(i<0)throw new TypeError(`Unknown custom type "${t.from}".`);r.definitions.push({...r.definitions[i],name:t.to})}else i>=0&&r.definitions.splice(i,1);return it(r)}function uh(e,t,n){let r=At(e),i=r.fields.findIndex(o=>o.key===t.from),a=r.fields.findIndex(o=>o.key===t.to);if(n==="stage"){if(a>=0)return Rt(r);if(i<0)throw new TypeError(`Unknown custom field "${t.from}".`);let o=r.fields[i];r.fields.push({...o,key:t.to,metadata_key:t.to,front_matter_key:t.to,cli_flag:t.to.replaceAll("_","-")})}else i>=0&&r.fields.splice(i,1);return Rt(r)}function mh(e,t,n){let r=It(e),i=r.statuses.findIndex(o=>o.id===t.from),a=r.statuses.findIndex(o=>o.id===t.to);if(n==="stage"){if(a>=0)return Ct(r);if(i<0)throw new TypeError(`Unknown custom status "${t.from}".`);r.statuses.push({...r.statuses[i],id:t.to})}else i>=0&&r.statuses.splice(i,1);return Ct(r)}function ph(e,t,n){return t.kind==="rename-type"?dh(e,t,n):t.kind==="rename-field"?uh(e,t,n):mh(e,t,n)}function ot(e,t){return typeof e=="string"&&e.trim().toLowerCase()===t.from.toLowerCase()?t.to:e}function pa(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function Bt(e){return Array.isArray(e)?e.map(t=>pa(t)).filter(t=>t!==void 0):[]}function fh(e,t){for(let n of Bt(e.fields))Array.isArray(n.required_types)&&(n.required_types=n.required_types.map(r=>ot(r,t)));for(let n of Bt(e.type_workflows))n.type=ot(n.type,t)}function hh(e,t){for(let r of Bt(e.definitions))r.default_status=ot(r.default_status,t);let n=pa(e.workflow);if(n)for(let[r,i]of Object.entries(n))n[r]=ot(i,t);for(let r of Bt(e.type_workflows))Array.isArray(r.allowed_transitions)&&(r.allowed_transitions=r.allowed_transitions.map(i=>Array.isArray(i)?i.map(a=>ot(a,t)):i))}function gh(e,t){for(let n of Bt(e.definitions)){for(let r of["required_create_fields","required_create_repeatables"])Array.isArray(n[r])&&(n[r]=n[r].map(i=>ot(i,t)));for(let r of["options","command_option_policies"])for(let i of Bt(n[r])){let a=r==="options"?"key":"option";i[a]=ot(i[a],t)}}}function _h(e,t){let n=pa(e.options);if(!n)return;if(t.kind==="rename-field"){if(!Object.prototype.hasOwnProperty.call(n,t.from))return;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision in saved template "${String(e.name??"unknown")}": target field "${t.to}" already exists.`);n[t.to]=n[t.from],delete n[t.from];return}let r=t.kind==="rename-type"?"type":"status";n[r]=ot(n[r],t)}function ua(e,t){let n=JSON.parse(e);if(typeof n!="object"||n===null||Array.isArray(n))return e;let r=n;return t.kind==="rename-type"?fh(r,t):t.kind==="rename-field"?gh(r,t):hh(r,t),_h(r,t),`${JSON.stringify(r,null,2)}
18
+ `}function Il(e,t){if(t.kind==="rename-type"){let r=We(e).definitions;return{source:r.some(i=>i.name.trim().toLowerCase()===t.from.toLowerCase()),target:r.some(i=>i.name.trim().toLowerCase()===t.to.toLowerCase())}}if(t.kind==="rename-field"){let r=At(e).fields;return{source:r.some(i=>i.key===t.from),target:r.some(i=>i.key===t.to)}}let n=It(e).statuses;return{source:n.some(r=>r.id===t.from),target:n.some(r=>r.id===t.to)}}function yh(e,t){let n=e;return t.kind==="rename-type"?e.type.toLowerCase()===t.to.toLowerCase()?[]:["type"]:t.kind==="remap-status"?e.status.toLowerCase()===t.to.toLowerCase()?[]:["status"]:Object.prototype.hasOwnProperty.call(n,t.to)&&!Object.prototype.hasOwnProperty.call(n,t.from)?[]:[t.from,t.to]}function wh(e,t){if(t.kind==="rename-type")return e.type.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"type",before:e.type,after:t.to}]}:null;if(t.kind==="remap-status")return e.status.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"status",before:e.status,after:t.to}]}:null;if(t.type!==void 0&&e.type.toLowerCase()!==t.type.toLowerCase())return null;let n=e;if(!Object.prototype.hasOwnProperty.call(n,t.from))return null;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision on item "${e.id}": target field "${t.to}" already exists.`);return{id:e.id,changes:[{field:t.from,before:n[t.from],after:void 0},{field:t.to,before:void 0,after:n[t.from]}]}}function Cl(e,t){let n=ma(t.request),r=t.migrationId===void 0?El(n,t.migrationScope??"plan"):Sl(t.migrationId),i=e.map(c=>wh(c,n)).filter(c=>c!==null).sort((c,l)=>c.id.localeCompare(l.id)),a=xl("sha256").update(JSON.stringify({migrationId:r,request:n,items:i})).digest("hex"),o=new Set([...t.completedItemIds??[]].map(c=>c.trim()).filter(c=>c.length>0)),s=i.filter(c=>!o.has(c.id));return Object.freeze({migration_id:r,request:n,fingerprint:a,affected_item_count:i.length,pending_item_count:s.length,skipped_completed_count:i.length-s.length,items:Object.freeze(s)})}async function vh(e){let t=q(e.settings,z()),n=[...new Set(Object.values(t.type_to_folder))],r=await sr(e.pmRoot,n),i=e.request.kind==="rename-type"?{types:[e.request.from]}:e.request.kind==="remap-status"?{statuses:[e.request.from]}:{metadataKeys:[e.request.from],...e.request.type===void 0?{}:{types:[e.request.type]}},a=r?await xs({pmRoot:e.pmRoot,expectedSourceCursor:r.source_cursor,query:i}):null;return a?{items:a.items,selectionSource:"derived_index",typeToFolder:t.type_to_folder}:{items:await Je(e.pmRoot,e.settings.item_format,t.type_to_folder,[],e.settings.schema),selectionSource:"scan",typeToFolder:t.type_to_folder}}async function bh(e,t){let n=await X(Al(e,t));if(n===null)return null;try{let r=JSON.parse(n);if(r.schema_version!==1||r.plan.migration_id!==t||!Array.isArray(r.plan.items))throw new TypeError("invalid plan envelope");return r.plan}catch(r){throw new y(`Stored schema migration plan "${t}" is invalid: ${Uo(r)}`,_.GENERIC_FAILURE)}}async function kh(e,t){let n=Al(e,t.migration_id);await wt.mkdir(Wt.dirname(n),{recursive:!0});let r={schema_version:1,plan:t,created_at:new Date().toISOString()};await le(n,`${JSON.stringify(r,null,2)}
19
+ `)}function xh(e,t){return JSON.stringify(e)===JSON.stringify(t)}async function Sh(e){let t=await Ot(e.pmRoot,e.id,e.settings.id_prefix,e.settings.item_format,e.typeToFolder);if(!t)throw new y(`Schema migration item "${e.id}" no longer exists.`,_.NOT_FOUND);return(await Dt(t,{schema:e.settings.schema})).document.metadata}function bl(e,t,n){let r=n==="forward"?t.from:t.to,i=n==="forward"?t.to:t.from;if(t.kind==="rename-type"){if(e.metadata.type.toLowerCase()===i.toLowerCase())return[];if(e.metadata.type.toLowerCase()!==r.toLowerCase())throw new TypeError(`Schema migration expected type "${r}" on item "${e.metadata.id}".`);return e.metadata.type=i,["type"]}if(t.kind==="remap-status"){if(e.metadata.status.toLowerCase()===i.toLowerCase())return[];if(e.metadata.status.toLowerCase()!==r.toLowerCase())throw new TypeError(`Schema migration expected status "${r}" on item "${e.metadata.id}".`);return e.metadata.status=i,["status"]}let a=e.metadata;if(Object.prototype.hasOwnProperty.call(a,i)&&!Object.prototype.hasOwnProperty.call(a,r))return[];if(!Object.prototype.hasOwnProperty.call(a,r)||Object.prototype.hasOwnProperty.call(a,i))throw new TypeError(`Schema migration field state changed concurrently on item "${e.metadata.id}".`);return a[i]=a[r],delete a[r],[r,i]}function kl(e){return{id:e.id,inspect:async()=>{let t=await Gt(e.filePath),n=Il(t.raw,e.request),r=e.phase==="stage"?n.source&&n.target:!n.source&&n.target;return{state:r?"applied":"pending",...r?{result:{phase:e.phase}}:{}}},prepareCompensation:async()=>{let t=await Gt(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await Gt(e.filePath);return await le(e.filePath,ph(t.raw,e.request,e.phase)),{phase:e.phase}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema snapshot for ${e.id} compensation.`);await Rl(e.filePath,{exists:t.exists,raw:t.raw})}}}function Eh(e){return{id:e.stepId,inspect:async()=>{let t=await Gt(e.filePath);return{state:ua(t.raw,e.request)===t.raw?"applied":"pending"}},prepareCompensation:async()=>{let t=await Gt(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await Gt(e.filePath);return await le(e.filePath,ua(t.raw,e.request)),{file:e.filePath}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema reference snapshot for ${e.stepId} compensation.`);await Rl(e.filePath,{exists:t.exists,raw:t.raw})}}}function Ah(e){return{id:`item-${e.id}`,inspect:async()=>{let t=await I(e.pmRoot),n=q(t,z()).type_to_folder,r=await Sh({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id}),i=yh(r,e.request).length===0;return{state:i?"applied":"pending",...i?{result:{item_id:e.id}}:{}}},apply:async()=>{let t=await I(e.pmRoot),n=q(t,z()).type_to_folder,r=await ft({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}`,author:e.author,message:`Schema migration ${e.request.kind}: ${e.request.from} -> ${e.request.to}`,force:e.force,skipNoop:!0,mutate(i){return{changedFields:bl(i,e.request,"forward")}}});return{item_id:e.id,changed_fields:r.changedFields}},compensate:async()=>{let t=await I(e.pmRoot),n=q(t,z()).type_to_folder;await ft({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}_compensate`,author:e.author,message:`Compensate schema migration ${e.request.kind}: ${e.request.to} -> ${e.request.from}`,force:!0,skipNoop:!0,mutate(r){return{changedFields:bl(r,e.request,"reverse")}}})}}}async function Rh(e){let t=await bh(e.pmRoot,e.migrationId);if(t){if(!xh(t.request,e.request))throw new y(`Schema migration id "${e.migrationId}" already belongs to a different request.`,_.CONFLICT);return{plan:t,stored:!0}}let n=await vh({pmRoot:e.pmRoot,settings:e.settings,request:e.request});return{plan:{...Cl(n.items,{migrationId:e.migrationId,request:e.request}),selection_source:n.selectionSource},stored:!1}}async function Ih(e){let t=Il(await X(e.schemaPath)??"",e.request);if(!t.source)throw new y(`Schema migration source "${e.request.from}" is not a custom definition.`,_.NOT_FOUND);if(t.target)throw new y(`Schema migration target "${e.request.to}" already exists.`,_.CONFLICT);await kh(e.pmRoot,e.plan)}async function Ch(e){let t=we(e.settings.schema),n=[...new Set([["types",Ae.types],["fields",Ae.fields],["workflows",Ae.workflows]].map(([i,a])=>Le(e.pmRoot,t.files[i],a)).filter(i=>i!==e.schemaPath))];try{let i=Wt.join(e.pmRoot,"templates"),a=await wt.readdir(i,{withFileTypes:!0});n.push(...a.filter(o=>o.isFile()&&o.name.toLowerCase().endsWith(".json")).map(o=>Wt.join(i,o.name)))}catch(i){if(typeof i!="object"||i===null||!("code"in i)||!j(i))throw i}n.sort((i,a)=>i.localeCompare(a));let r=[];for(let i of n){let a=await X(i);a!==null&&ua(a,e.request)!==a&&r.push({filePath:i,beforeRaw:a})}return{paths:n,snapshots:r}}async function $h(e){for(let t of e.snapshots){let n=await wt.readFile(t.filePath,"utf8"),r=Wt.relative(e.pmRoot,t.filePath).replaceAll("\\","/");await Ci({pmRoot:e.pmRoot,author:e.author,documentPath:r,before:Cr(t.beforeRaw),after:Cr(n),op:"schema_migration_reference",idempotencyKey:`${e.plan.migration_id}:${e.plan.fingerprint}:${r}`,message:`${e.request.kind}: ${e.request.from} -> ${e.request.to}`,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}}async function Th(e,t,n){let r=ma(e),i=L(process.cwd(),n.path);if(!await A(K(i)))throw new y(`Tracker is not initialized at ${i}. Run pm init first.`,_.NOT_FOUND);let a=t.migrationId===void 0?El(r,await wt.realpath(i)):Sl(t.migrationId),o=await I(i),s=Y(t.author,o.author_default),c=await Rh({pmRoot:i,settings:o,migrationId:a,request:r}),l=c.plan;if(t.dryRun===!0)return{...l,action:r.kind,applied:!1,recovered:!1,migrated_item_count:0};let d=lh(i,o,r),u=await wt.readFile(d,"utf8");c.stored||await Ih({pmRoot:i,schemaPath:d,request:r,plan:l});let m=await Ch({pmRoot:i,schemaPath:d,settings:o,request:r}),p=[kl({id:"stage-schema",filePath:d,request:r,phase:"stage"}),...m.paths.map((w,v)=>Eh({filePath:w,request:r,stepId:`reference-${String(v+1).padStart(4,"0")}`})),...l.items.map(w=>Ah({pmRoot:i,id:w.id,request:r,author:s,force:t.force===!0})),kl({id:"retire-source",filePath:d,request:r,phase:"retire"})],f=await vl({pmRoot:i,transactionId:`schema-${a}`,author:s,steps:p,lockTtlSeconds:Math.max(o.locks.ttl_seconds,300),lockWaitMs:o.locks.wait_ms}),g=await wt.readFile(d,"utf8"),{historyPath:h}=await Ci({pmRoot:i,author:s,documentPath:Wt.relative(i,d).replaceAll("\\","/"),before:Cr(u),after:Cr(g),op:"schema_migration",idempotencyKey:`${l.migration_id}:${l.fingerprint}`,message:`${r.kind}: ${r.from} -> ${r.to}; affected=${l.affected_item_count}`,lockTtlSeconds:o.locks.ttl_seconds,lockWaitMs:o.locks.wait_ms});return await $h({pmRoot:i,author:s,settings:o,request:r,plan:l,snapshots:m.snapshots}),{...l,action:r.kind,applied:!0,recovered:f.recovered,migrated_item_count:l.affected_item_count,workspace_history_path:h}}(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]="2ab8a5a9-dbea-526f-a541-b7ca2b106ac5")}catch{}})();var BR=["add-type","remove-type","add-status","remove-status","add-field","remove-field","list-fields","show-field","apply-preset","list","show","show-status","rename-type","rename-field","remap-status"],$r="schema-types",$l="schema-statuses",Tl="schema-fields";function st(e){return ar({pmRoot:e.pmRoot,filePath:e.filePath,raw:e.raw,op:e.op,author:e.author,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}async function HR(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i;try{i=xi({name:e,description:t.description,defaultStatus:t.defaultStatus,folder:t.folder,aliases:t.alias})}catch(p){throw new y(p instanceof Error?p.message:String(p),_.USAGE)}let a=await I(r),o=we(a.schema),s=Le(r,o.files.types,Ae.types),c=[],l=Y(t.author,a.author_default),d=Te(a),u=await de(r,$r,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms),m;try{let p=await X(s),f;try{f=We(p)}catch(g){throw new y(g instanceof Error?g.message:String(g),_.GENERIC_FAILURE)}try{Yo(i,f);let g=new Map,h=q(a,z());for(let[w,v]of Object.entries(h.type_to_folder)){let b=v.trim().toLowerCase();b.length>0&&!g.has(b)&&g.set(b,w)}Xo(i,f,g)}catch(g){throw new y(g instanceof Error?g.message:String(g),_.USAGE)}m=Jn(f,i),m.replaced&&m.previousName!==void 0&&m.previousName!==m.definition.name&&c.push(`type_recased:${m.previousName}->${m.definition.name}`),await st({pmRoot:r,filePath:s,raw:it(m.file),op:"schema:add-type",author:l,settings:a}),await hn(r,[m.definition],c,"schema:add-type-folder"),c.push(...await re({path:s,scope:"project",op:"schema:add-type"}))}finally{await u()}return await Ol(r,c),{action:"add-type",registered:!0,replaced:m.replaced,type:m.definition,file:{path:s,definitions:m.file.definitions.length},warnings:ct(c),generated_at:$()}}async function Ze(e){if(!await A(K(e)))throw new y(`Tracker is not initialized at ${e}. Run pm init first.`,_.NOT_FOUND)}async function Ol(e,t){try{let n=await dl(e);n.status==="refreshed"?t.push("merge_fence_refreshed"):n.status==="not_installed"&&t.push('merge_fence_not_installed:type folders lack git merge drivers; run "pm merge install"')}catch{t.push('merge_fence_refresh_failed:run "pm merge install" to reconcile')}}function ct(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}async function Ph(e,t,n,r){let i=q(t,z()),a=r.trim().toLowerCase();return(await Je(e,t.item_format,i.type_to_folder,[],n)).filter(s=>typeof s.type=="string"&&s.type.toLowerCase()===a).length}async function Nh(e,t,n,r){let i=q(t,z()),a=Be(n),o=se(r);return(await Je(e,t.item_format,i.type_to_folder,[],n)).filter(c=>{let l=typeof c.status=="string"?c.status:"";return(a.alias_to_id.get(se(l))??se(l))===o}).length}async function Mh(e,t,n,r,i){if(i.length===0||Ei.has(i))return;let a=await Nh(t,n,r,i);a>0&&e.push(`items_using_status:${a}`);let o=Lh(r.workflow,i);o.length>0&&e.push(`status_referenced_by_workflow:${o.join(",")}`)}function Lh(e,t){return[["draft_status",e.draft_status],["open_status",e.open_status],["in_progress_status",e.in_progress_status],["blocked_status",e.blocked_status],["close_status",e.close_status],["canceled_status",e.canceled_status]].filter(([,r])=>r!==void 0&&se(r)===t).map(([r])=>r)}async function JR(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i=await I(r),a=we(i.schema),o=Le(r,a.files.types,Ae.types),s=[],c=Y(t.author,i.author_default),l=Te(i),d=await de(r,$r,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=We(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=Zo(p,e)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}if(u.removed){let f=(u.definition?.name??e??"").trim();if(f.length>0){let g=await Ph(r,i,a,f);g>0&&s.push(`items_using_type:${g}`)}await st({pmRoot:r,filePath:o,raw:it(u.file),op:"schema:remove-type",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-type"}))}}finally{await d()}return u.removed&&await Ol(r,s),{action:"remove-type",removed:u.removed,...u.definition?{type:u.definition}:{},file:{path:o,definitions:u.file.definitions.length},warnings:ct(s),generated_at:$()}}function fa(e,t){return Le(e,t.files.statuses,Ae.statuses)}function Tr(e,t){return Le(e,t.files.fields,Ae.fields)}function Dl(e,t){return Le(e,t.files.types,Ae.types)}async function hn(e,t,n,r){for(let i of t){let a=Fo(i.folder??Lo(i.name)),o=Oh.join(e,a);await A(o)||(await Dh(o,{recursive:!0}),n.push(...await re({path:o,scope:"project",op:r})))}}function ha(e){return{key:e.key,type:e.type,commands:[...e.commands],cli_flag:`--${e.cli_flag}`,cli_aliases:e.cli_aliases.map(t=>`--${t}`),...e.description?{description:e.description}:{},required:e.required,required_on_create:e.required_on_create,allow_unset:e.allow_unset,required_types:[...e.required_types]}}function Fh(e){if(e)return{id:e.id,...e.roles.length>0?{roles:[...e.roles]}:{},...e.aliases.length>0?{aliases:[...e.aliases]}:{},...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function jh(e){let t=new Map;for(let n of e){let r=se(n.id);if(r.length!==0){t.set(r,r);for(let i of Array.isArray(n.aliases)?n.aliases:[]){let a=se(i);a.length>0&&!t.has(a)&&t.set(a,r)}}}return t}async function VR(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i;try{i=is({id:e,roles:t.role,aliases:t.alias,description:t.description,order:t.order})}catch(g){throw new y(g instanceof Error?g.message:String(g),_.USAGE)}let a=await I(r),o=we(a.schema),s=fa(r,o),c=Be(o);try{Ai(i,c.alias_to_id)}catch(g){throw new y(g instanceof Error?g.message:String(g),_.USAGE)}let l=Fh(c.by_id.get(i.id)),d=[],u=Y(t.author,a.author_default),m=Te(a),p=await de(r,$l,a.locks.ttl_seconds,u,!!t.force,m.force_required_for_stale_lock,a.locks.wait_ms),f;try{let g=await X(s),h;try{h=It(g)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.GENERIC_FAILURE)}let w=jh(h.statuses);try{Ai(i,w)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.USAGE)}f=as(h,i,l),await st({pmRoot:r,filePath:s,raw:Ct(f.file),op:"schema:add-status",author:u,settings:a}),d.push(...await re({path:s,scope:"project",op:"schema:add-status"}))}finally{await p()}return{action:"add-status",registered:!0,replaced:f.replaced,status:f.definition,file:{path:s,statuses:f.file.statuses.length},warnings:ct(d),generated_at:$()}}async function KR(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i=await I(r),a=we(i.schema),o=fa(r,a),s=[],c=Y(t.author,i.author_default),l=Te(i),d=await de(r,$l,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=It(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=os(p,e)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}if(u.removed){let f=se(u.definition?.id??e);await Mh(s,r,i,a,f),await st({pmRoot:r,filePath:o,raw:Ct(u.file),op:"schema:remove-status",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-status"}))}}finally{await d()}return{action:"remove-status",removed:u.removed,...u.definition?{status:u.definition}:{},file:{path:o,statuses:u.file.statuses.length},warnings:ct(s),generated_at:$()}}function Pl(e){return{name:e.name,folder:e.folder,aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.default_status?{default_status:e.default_status}:{},...e.description?{description:e.description}:{}}}function Uh(e,t,n){return{...Pl(e),source:t,...n?{extension:n}:{},required_create_fields:[...e.required_create_fields],required_create_repeatables:[...e.required_create_repeatables],options:structuredClone(e.options),command_option_policies:structuredClone(e.command_option_policies)}}function Nl(e){return{id:e.id,source:Ei.has(e.id)?"builtin":"custom",roles:Array.isArray(e.roles)?[...e.roles]:[],aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function Ml(e,t,n){let r=e.toLowerCase();return n.has(r)?"extension":t.has(r)?"custom":"builtin"}function zh(){let e=new Map,t=z();for(let n of t?.item_types??[]){let r=n.types;if(Array.isArray(r))for(let i of r){if(typeof i!="object"||i===null||Array.isArray(i))continue;let a=i.name;typeof a=="string"&&a.trim().length>0&&e.set(a.trim().toLowerCase(),{layer:n.layer,name:n.name})}}return e}function qh(e){let t=Be(e),n=[],r=[];for(let i of t.definitions){let a=Nl(i);a.source==="builtin"?n.push(a):r.push(a)}return{builtin:n,custom:r}}async function gn(e){let t=L(process.cwd(),e.path);await Ze(t);let n=await I(t),r=we(n.schema),i=Le(t,r.files.types,Ae.types),a=fa(t,r),o=q(n,z()),s=zh(),c=new Set((n.item_types?.definitions??[]).map(l=>l.name.trim().toLowerCase()).filter(l=>l.length>0&&!s.has(l)));return{pmRoot:t,typesPath:i,statusesPath:a,byType:o.by_type,customNames:c,extensionProvenance:s,schema:r}}async function YR(e){let t=await gn(e),n=[],r=[],i=[];for(let s of Object.values(t.byType).sort((c,l)=>c.name.localeCompare(l.name))){let c=Ml(s.name,t.customNames,new Set(t.extensionProvenance.keys())),l=Pl(s);c==="extension"?i.push(l):c==="custom"?r.push(l):n.push(l)}let a=qh(t.schema),o=Vn(t.schema).definitions.map(ha);return{action:"list",builtin:n,custom:r,extension:i,counts:{builtin:n.length,custom:r.length,extension:i.length,total:n.length+r.length+i.length},statuses:{builtin:a.builtin,custom:a.custom,counts:{builtin:a.builtin.length,custom:a.custom.length,total:a.builtin.length+a.custom.length}},fields:{custom:o,counts:{total:o.length}},file:{path:t.typesPath},generated_at:$()}}async function XR(e,t){let n=(e??"").trim();if(n.length===0)throw new y("Type name must not be empty.",_.USAGE);let r=await gn(t),i=Object.values(r.byType).find(a=>a.name.toLowerCase()===n.toLowerCase()||a.aliases.some(o=>o.toLowerCase()===n.toLowerCase()));if(!i)throw new y(`Unknown item type "${n}". Run pm schema list to inspect registered types, or pm schema add-type "${Hn(n)}" to register it.`,_.NOT_FOUND,{code:"unknown_item_type"});return{action:"show",type:Uh(i,Ml(i.name,r.customNames,new Set(r.extensionProvenance.keys())),r.extensionProvenance.get(i.name.toLowerCase())),file:{path:r.typesPath},generated_at:$()}}async function ZR(e,t){let n=se(e);if(n.length===0)throw new y("Status id must not be empty.",_.USAGE);let r=await gn(t),i=Be(r.schema),a=i.alias_to_id.get(n)??n,o=i.by_id.get(a);if(!o)throw new y(`Unknown status "${e}". Run pm schema list to inspect registered statuses, or pm schema add-status "${Hn(e??"")}" to register it.`,_.NOT_FOUND,{code:"unknown_status"});return{action:"show-status",status:Nl(o),file:{path:r.statusesPath},generated_at:$()}}async function QR(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i;try{i=ts({key:e,type:t.type,commands:t.commands,description:t.description,cliFlag:t.cliFlag,aliases:t.alias,required:t.required,requiredOnCreate:t.requiredOnCreate,allowUnset:t.allowUnset,requiredTypes:t.requiredTypes})}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}let a=await I(r),o=we(a.schema),s=Tr(r,o),c=[],l=Kn(i.key);l&&c.push(`custom_field_mcp_input_collision:${l.field}:${l.property}:${l.owner}:use=${l.nested_path}`);let d=Y(t.author,a.author_default),u=Te(a),m=await de(r,Tl,a.locks.ttl_seconds,d,!!t.force,u.force_required_for_stale_lock,a.locks.wait_ms),p;try{let f=await X(s),g;try{g=At(f)}catch(h){throw new y(h instanceof Error?h.message:String(h),_.GENERIC_FAILURE)}p=ns(g,i),await st({pmRoot:r,filePath:s,raw:Rt(p.file),op:"schema:add-field",author:d,settings:a}),c.push(...await re({path:s,scope:"project",op:"schema:add-field"}))}finally{await m()}return{action:"add-field",registered:!0,replaced:p.replaced,field:p.definition,file:{path:s,fields:p.file.fields.length},warnings:ct(c),generated_at:$()}}async function Gh(e,t,n,r){let i=q(t,z());return(await Je(e,t.item_format,i.type_to_folder,[],n)).filter(o=>{let s=o[r];return s==null?!1:Array.isArray(s)?s.length>0:typeof s=="string"?s.trim().length>0:!0}).length}async function eI(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i=await I(r),a=we(i.schema),o=Tr(r,a),s=[],c=Y(t.author,i.author_default),l=Te(i),d=await de(r,Tl,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await X(o),p;try{p=At(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=rs(p,e)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}if(u.removed){let f=se(u.definition?.key??e),g=se(u.definition?.metadata_key??u.definition?.front_matter_key??f);if(g.length>0){let h=await Gh(r,i,a,g);h>0&&s.push(`items_using_field:${h}`)}await st({pmRoot:r,filePath:o,raw:Rt(u.file),op:"schema:remove-field",author:c,settings:i}),s.push(...await re({path:o,scope:"project",op:"schema:remove-field"}))}}finally{await d()}return{action:"remove-field",removed:u.removed,...u.definition?{field:u.definition}:{},file:{path:o,fields:u.file.fields.length},warnings:ct(s),generated_at:$()}}async function tI(e){let t=await gn(e),n=Vn(t.schema).definitions.map(ha);return{action:"list-fields",fields:n,counts:{total:n.length},file:{path:Tr(t.pmRoot,t.schema)},generated_at:$()}}async function nI(e,t){let n=se(e);if(n.length===0)throw new y("Field key must not be empty.",_.USAGE);let r=await gn(t),i=Vn(r.schema).by_key.get(n);if(!i)throw new y(`Unknown custom field "${e}". Run pm schema list-fields to inspect registered fields, or pm schema add-field "${Hn(e??"")}" to register it.`,_.NOT_FOUND,{code:"unknown_field"});return{action:"show-field",field:ha(i),file:{path:Tr(r.pmRoot,r.schema)},generated_at:$()}}async function rI(e,t,n){let r=L(process.cwd(),n.path);await Ze(r);let i;try{let g=es(e);if(g===void 0)throw new Error(`Type preset name is required. Allowed: ${Qo.join(", ")}.`);i=g}catch(g){throw new y(g instanceof Error?g.message:String(g),_.USAGE)}let a=await I(r),o=we(a.schema),s=Dl(r,o),c=[],l=Y(t.author,a.author_default),d=Te(a),u=[],m=[],p,f=await de(r,$r,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms);try{let g=await X(s),h;try{h=We(g)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.GENERIC_FAILURE)}let w=h;for(let v of Si(i)){let b=Jn(w,v);w=b.file,(b.replaced?m:u).push(b.definition.name)}p=w.definitions.length,await st({pmRoot:r,filePath:s,raw:it(w),op:"schema:apply-preset",author:l,settings:a}),await hn(r,Si(i),c,"schema:apply-preset-folder"),c.push(...await re({path:s,scope:"project",op:"schema:apply-preset"}))}finally{await f()}return{action:"apply-preset",preset:i,registered:u,replaced:m,file:{path:s,definitions:p},warnings:ct(c),generated_at:$()}}function Wh(e){if(e===void 0)return 10;if(!Number.isInteger(e)||e<1)throw new y("--min-count must be a positive integer (>= 1).",_.USAGE);return e}async function iI(e,t){let n=L(process.cwd(),t.path);await Ze(n);let r=await I(n),i=we(r.schema),a=Dl(n,i),o=Wh(e.minCount),s=q(r,z()),l=(await Je(n,r.item_format,s.type_to_folder,[],i)).map(b=>typeof b.title=="string"?b.title:""),d=ul(l,{minCount:o}),u=[],m=[],p=[],f=[],g;if(!e.apply){let b;try{b=We(await X(a))}catch(x){throw new y(x instanceof Error?x.message:String(x),_.GENERIC_FAILURE)}return g=b.definitions.length,{action:"infer-types",applied:!1,min_count:o,candidates:d,registered:m,replaced:p,skipped:f,file:{path:a,definitions:g},warnings:u,generated_at:$()}}let h=Y(e.author,r.author_default),w=Te(r),v=await de(n,$r,r.locks.ttl_seconds,h,!!e.force,w.force_required_for_stale_lock,r.locks.wait_ms);try{let b=await X(a),x;try{x=We(b)}catch(k){throw new y(k instanceof Error?k.message:String(k),_.GENERIC_FAILURE)}let R=x;for(let k of d){if(k.shadows_builtin){f.push({name:k.name,reason:"shadows_builtin"});continue}let F;try{F=xi({name:k.name})}catch{f.push({name:k.name,reason:"invalid_type_token"});continue}let T=Jn(R,F);R=T.file,(T.replaced?p:m).push(T.definition.name)}g=R.definitions.length,await st({pmRoot:n,filePath:a,raw:it(R),op:"schema:infer-types",author:h,settings:r}),await hn(n,R.definitions.filter(k=>m.includes(k.name)||p.includes(k.name)),u,"schema:infer-types-folder"),u.push(...await re({path:a,scope:"project",op:"schema:infer-types"}))}finally{await v()}return{action:"infer-types",applied:!0,min_count:o,candidates:d,registered:m,replaced:p,skipped:f,file:{path:a,definitions:g},warnings:ct(u),generated_at:$()}}import Ll from"node:fs/promises";import ga from"node:path";(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]="af718efb-d1cf-5adc-9518-c858627e1b54")}catch{}})();function ke(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function S(e){return e.trim().toLowerCase()}function Or(e){let t=e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-"),n=0;for(;t[n]==="-";)n+=1;let r=t.length;for(;r>n&&t[r-1]==="-";)r-=1;let i=t.slice(n,r);if(i.length===0)throw new y("Extension manifest name must resolve to a non-empty directory name.",_.USAGE);if(i==="."||i==="..")throw new y('Extension manifest name must not resolve to "." or "..".',_.USAGE);return i}function _a(e){return Bo(e)}async function Bh(e){try{let t=JSON.parse(await Ll.readFile(ga.join(e,"package.json"),"utf8")),n=typeof t.name=="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(t.name)?t.name:void 0;return{...n?{package_name:n}:{},has_build_script:["build","prepare","prepack"].some(r=>typeof t.scripts?.[r]=="string")}}catch{return{has_build_script:!1}}}async function Hh(e,t,n){if(n.source_kind!=="github"||typeof n.source_root!="string")return new y(`Extension entry file is missing at "${t}".`,_.USAGE);let r=await Bh(n.source_root),i=r.package_name?`pm install npm:${r.package_name}`:void 0,a=n.source_input??n.source_root;return new y(`Extension entry "${e.entry}" is absent from GitHub source "${a}". pm install copies GitHub repositories without running package scripts${r.has_build_script?", and this package declares a build or publish script":""}. ${i?`Try "${i}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,_.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:i?[i,`pm install ${n.source_root}`]:[`pm install ${n.source_root}`],nextSteps:i?[`Retry with ${i}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm install npm:<package-name>."],recovery:{attempted_command:`pm install ${a}`,normalized_args:["install",a],...i?{next_best_command:i}:{}}})}async function Ht(e,t={}){let n=ga.join(e,"manifest.json");if(!await A(n))throw new y(`Extension manifest is missing at "${n}".`,_.USAGE);let r;try{r=JSON.parse(await Ll.readFile(n,"utf8"))}catch(o){throw new y(`Failed to parse extension manifest at "${n}": ${Jh(o)}`,_.USAGE)}let i=_a(r);if(!i)throw new y(`Extension manifest at "${n}" is invalid.`,_.USAGE);let a=ga.resolve(e,i.entry);if(!ye(e,a))throw new y(`Extension entry "${i.entry}" resolves outside extension directory "${e}".`,_.USAGE);if(!await A(a))throw await Hh(i,a,t);if(!await Ho(e,a))throw new y(`Extension entry "${i.entry}" resolves outside extension directory after symlink resolution.`,_.USAGE);return{directory:e,manifest_path:n,entry_path:a,manifest:i}}function Jh(e){return e instanceof Error?e.message:String(e)}import ya from"node:fs/promises";import Vh from"node:path";(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]="159d7bbd-1d2a-503d-b3ce-f32dcc6f6547")}catch{}})();var Kh=".managed-extensions.json",Dr=1;function _n(e){return Vh.join(e,Kh)}function Yh(){return{version:Dr,updated_at:$(),entries:[]}}function yn(e){return[...e].sort((t,n)=>{let r=t.scope.localeCompare(n.scope);if(r!==0)return r;let i=t.name.localeCompare(n.name);return i!==0?i:t.directory.localeCompare(n.directory)})}function Fl(e,t){return e.kind!==t.kind||e.input!==t.input||e.location!==t.location?!1:e.kind==="npm"&&t.kind==="npm"?e.package===t.package&&e.version===t.version:e.kind==="github"&&t.kind==="github"?e.repository===t.repository&&e.ref===t.ref&&e.subpath===t.subpath&&e.commit===t.commit:e.kind==="builtin"&&t.kind==="builtin"?e.name===t.name:!0}function xe(e){return typeof e=="string"?e:void 0}function Xh(e){return typeof e.name=="string"&&e.name.trim().length>0&&typeof e.directory=="string"&&e.directory.trim().length>0&&(e.scope==="project"||e.scope==="global")&&typeof e.manifest_version=="string"&&typeof e.manifest_entry=="string"&&Array.isArray(e.capabilities)&&e.capabilities.every(t=>typeof t=="string")&&typeof e.installed_at=="string"&&typeof e.updated_at=="string"}function Zh(e){if(typeof e!="object"||e===null)return null;let t=e;return t.kind!=="local"&&t.kind!=="github"&&t.kind!=="npm"&&t.kind!=="builtin"||typeof t.input!="string"||typeof t.location!="string"?null:{kind:t.kind,input:t.input,location:t.location,name:xe(t.name),package:xe(t.package),version:xe(t.version),repository:xe(t.repository),owner:xe(t.owner),repo:xe(t.repo),ref:xe(t.ref),subpath:xe(t.subpath),commit:xe(t.commit)}}function Qh(e){if(typeof e!="object"||e===null)return null;let t=e;if(!Xh(t))return null;let n=Zh(t.source);if(!n)return null;let r=qo(t.contributions);return r===null?null:{name:t.name.trim(),directory:t.directory.trim(),scope:t.scope,manifest_version:t.manifest_version,manifest_entry:t.manifest_entry,capabilities:ke(t.capabilities),contributions:r,installed_at:t.installed_at,updated_at:t.updated_at,source:n,last_update_check_at:xe(t.last_update_check_at),last_update_remote_commit:xe(t.last_update_remote_commit),update_available:typeof t.update_available=="boolean"||t.update_available===null?t.update_available:void 0,update_error:xe(t.update_error)}}function eg(e){if(typeof e!="object"||e===null)return null;let t=e;if(t.version!==Dr||!Array.isArray(t.entries))return null;let n=[];for(let r of t.entries){let i=Qh(r);i&&n.push(i)}return{version:Dr,updated_at:xe(t.updated_at)??$(),entries:yn(n)}}async function pe(e){let t=_n(e),n=Yh();try{let r=await ya.readFile(t,"utf8"),i=JSON.parse(r),a=eg(i);if(!a)throw new y(`Managed extension state file "${t}" has an invalid schema. Repair or remove it before mutating extension state.`,_.GENERIC_FAILURE);return{path:t,state:a,warnings:[]}}catch(r){if(r instanceof y)throw r;if(typeof r=="object"&&r!==null&&"code"in r&&j(r))return{path:t,state:n,warnings:[]};throw new y(`Managed extension state file "${t}" could not be read. Repair or remove it before mutating extension state.`,_.GENERIC_FAILURE)}}async function vt(e,t){let n=_n(e),r={version:Dr,updated_at:$(),entries:yn(t.entries)};await ya.mkdir(e,{recursive:!0}),await ya.writeFile(n,`${JSON.stringify(r,null,2)}
20
+ `,"utf8")}function wn(e,t){let n=e.entries.filter(r=>S(r.name)!==S(t.name)&&S(r.directory)!==S(t.directory));return n.push(t),{...e,updated_at:$(),entries:yn(n)}}async function jl(e,t,n,r){let i=t.entries.find(o=>S(o.name)===S(n));if(!i)return t;let a=wn(t,{...i,contributions:r});return await vt(e,a),a}import{execFile as ug}from"node:child_process";import G from"node:fs/promises";import xa from"node:os";import O from"node:path";import{fileURLToPath as mg}from"node:url";import{promisify as pg}from"node:util";import fg from"npm-package-arg";import{extract as hg,list as gg}from"tar";import tg from"node:fs/promises";import Oe from"node:path";(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]="259656b0-09b7-52c5-8f54-52ac29eec607")}catch{}})();var ng="PM_CLI_PACKAGE_ROOT",Ul={beads:{package_directory:"pm-beads",legacy_extension_directory:"beads"},todos:{package_directory:"pm-todos",legacy_extension_directory:"todos"}},rg=new Set(["*","all"]);function wa(){let e=[],t=process.env[ng];return typeof t=="string"&&t.trim().length>0&&e.push(Oe.resolve(t.trim())),e.push(Ee(import.meta.url,["../../.."])),[...new Set(e)]}async function vn(e){let t=e.trim().toLowerCase(),n=await ql(t);if(n)return n;let r=Ul[t];if(!r)return null;for(let i of wa()){let a=Oe.join(i,".agents","pm","extensions",r.legacy_extension_directory);if(await A(Oe.join(a,"manifest.json")))return a}return null}function zl(e){return rg.has(e.trim().toLowerCase())}function ig(e){return e.replace(/^pm-/i,"").trim().toLowerCase()}async function ag(e,t){let n=await tg.readdir(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||!r.name.startsWith("pm-"))continue;let i=Oe.join(e,r.name);if(!await A(Oe.join(i,"package.json")))continue;let a=await Wn(i),o=a.aliases&&a.aliases.length>0?a.aliases:[ig(r.name)];for(let s of o){let c=s.trim().toLowerCase();c.length===0||t.has(c)||t.set(c,{alias:c,package_directory:r.name,package_root:i,package_name:a.package_name??null})}}}async function va(){let e=new Map;for(let t of wa()){let n=Oe.join(t,"packages");await A(n)&&await ag(n,e)}for(let[t,n]of Object.entries(Ul))if(!e.has(t))for(let r of wa()){let i=Oe.join(r,"packages",n.package_directory);if(await A(Oe.join(i,"package.json"))){e.set(t,{alias:t,package_directory:n.package_directory,package_root:i,package_name:null});break}}return[...e.values()].sort((t,n)=>t.alias.localeCompare(n.alias))}async function Pr(){return(await va()).map(e=>e.alias)}async function ql(e){let t=e.trim().toLowerCase();return(await va()).find(r=>r.alias===t||r.package_directory.toLowerCase()===t||r.package_name?.toLowerCase()===t)?.package_root??null}async function Gl(e){let t=await ql(e);return t?(await Wn(t)).package_name??null:null}async function Wl(e){let t=await vn(e);if(!t)return null;try{let n=await Bn(t);return n.length!==1?null:(await Ht(n[0])).manifest.name}catch{return null}}function og(e){return{docs:e.catalog?.links?.docs??e.package_homepage,npm:e.catalog?.links?.npm??(e.package_name&&e.package_private!==!0?`https://www.npmjs.com/package/${encodeURIComponent(e.package_name)}`:void 0),repository:e.catalog?.links?.repository??e.package_repository_url,report:e.catalog?.links?.report??e.package_bugs_url}}function sg(e,t,n,r,i,a){let o=r==="global"?"--global":"--project",s=Object.fromEntries(ki.filter(c=>c!=="extensions").map(c=>[c,e.resources[c]??[]]).filter(([,c])=>Array.isArray(c)&&c.length>0));return{alias:t.alias,aliases:n,bundled:!0,available:!0,installed:n.some(c=>i.has(c))||a.has(Oe.resolve(t.package_root)),install_target:t.alias,install_command:`pm install ${t.alias} ${o}`,package_name:e.package_name,package_version:e.package_version,description:e.catalog?.summary??e.package_description,keywords:e.package_keywords??[],resources:e.resources,installable_resources:{extensions:e.resources.extensions??[]},metadata_only_resources:s,catalog:{display_name:e.catalog?.display_name,category:e.catalog?.category,tags:e.catalog?.tags??e.package_keywords??[],links:og(e),media:e.catalog?.media}}}async function Bl(e,t,n={}){let r=Et(L(process.cwd(),t.path),process.cwd()),i=e==="global"?r.global:r.project,a=await pe(i),o=new Set(a.state.entries.filter(m=>m.scope===e).filter(m=>m.source.kind!=="builtin").map(m=>Oe.resolve(m.source.location))),s=new Set(a.state.entries.filter(m=>m.scope===e&&m.source.kind==="builtin").flatMap(m=>[m.source.name,m.source.input,m.source.location]).filter(m=>typeof m=="string"&&m.trim().length>0).map(m=>m.trim().toLowerCase())),c=[],l=new Map;for(let m of await va()){let p=Oe.resolve(m.package_root),f=l.get(p)??[];f.push(m),l.set(p,f)}for(let m of l.values()){let p=m[0],f=m.map(h=>h.alias).sort((h,w)=>h.localeCompare(w)),g=await Wn(p.package_root);c.push(sg(g,p,f,e,s,o))}let d=lg(n.fields),u=d?c.map(m=>dg(m,d)):c;return{total:u.length,scope:e,installable_resource_kinds:["extensions"],metadata_only_resource_kinds:ki.filter(m=>m!=="extensions"),packages:u}}var cg=new Set(["alias","aliases","bundled","available","installed","install_target","install_command","package_name","package_version","description","keywords","resources","installable_resources","metadata_only_resources","catalog","category","display_name"]);function lg(e){if(e===void 0)return;let t=ur(e);if(t.length===0)throw new y("Package catalog --fields requires a comma-separated list of field names",_.USAGE);let n=t.filter(r=>!cg.has(r));if(n.length>0)throw new y(`Unknown package catalog --fields value(s): ${n.join(", ")}`,_.USAGE,{examples:["pm package list --project --fields alias,installed,install_command","pm package catalog --project --fields alias,package_name,category"]});return t}function dg(e,t){let n={};for(let r of t)r==="category"?n[r]=e.catalog?.category??null:r==="display_name"?n[r]=e.catalog?.display_name??null:n[r]=e[r]??null;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]="8994c8e2-8e3a-5e00-a3ca-7bd553c045d7")}catch{}})();var Sa=pg(ug),Mr="@unbrained/pm-cli",_g={maxArchiveBytes:64*1024*1024,maxEntries:4096,maxExpandedBytes:256*1024*1024,maxEntryBytes:64*1024*1024},ba;async function Hl(e,t=process.cwd()){let n=e.trim();if(!/^(@[^/\\\s]+\/[^/\\\s]+|[^@/\\\s][^/\\\s]*)$/u.test(n))return null;let r=O.resolve(t);for(;;){let i=O.join(r,"node_modules",...n.split("/")),a=O.join(i,"package.json");if(await A(a))try{let s=JSON.parse(await G.readFile(a,"utf8"));if(s.name===n)return{package:n,...typeof s.version=="string"?{version:s.version}:{},directory:i}}catch{return null}let o=O.dirname(r);if(o===r)return null;r=o}}function ka(e,t,n){let r=e.split("/").map(l=>l.trim()).filter(l=>l.length>0);if(r.length<2)return null;let i=r[0],a=r[1].replace(/\.git$/i,"");if(i.length===0||a.length===0)return null;let o=r.slice(2),s,c;return o[0]==="tree"&&o.length>=2?(s=o[1],c=o.slice(2).join("/")):o.length>0&&(c=o.join("/")),typeof n=="string"&&n.trim().length>0&&(s=n.trim()),{kind:"github",input:t,owner:i,repo:a,repository:`https://github.com/${i}/${a}.git`,ref:s,subpath:c&&c.length>0?c:void 0}}function yg(e,t,n){let r=e.slice(4).trim();if(r.length===0)throw new y('npm package source must include a package spec after "npm:".',_.USAGE);if(t)throw new y('Options "--gh/--github" cannot be combined with npm: package sources.',_.USAGE);if(n)throw new y('Option "--ref" cannot be combined with npm: package sources.',_.USAGE);return{kind:"npm",input:e,spec:r}}function Lr(e,t={}){let n=e.trim();if(n.length===0)throw new y("Extension source is required for --install.",_.USAGE);let r=typeof t.ref=="string"&&t.ref.trim().length>0?t.ref.trim():void 0;if(n.startsWith("npm:"))return yg(n,t.forceGithub===!0,r);let i=(()=>{try{let o=new URL(n);if(o.hostname!=="github.com")return null;let s=o.pathname.replace(/^\/+/,"");return ka(s,n,r)}catch{return null}})();if(i)return i;let a=n.startsWith("github.com/")?n.slice(11):null;if(a){let o=ka(a,n,r);if(!o)throw new y(`Invalid GitHub source "${n}".`,_.USAGE);return o}if(t.forceGithub){let o=ka(n,n,r);if(!o)throw new y(`Invalid GitHub shorthand "${n}".`,_.USAGE);return o}if(/^https?:\/\//i.test(n))throw new y(`Unsupported extension source URL "${n}". Supported remote source host: github.com.`,_.USAGE);return{kind:"local",input:n,absolute_path:O.resolve(process.cwd(),n)}}async function Nr(e,t=Sa,n){try{return((await t("git",e,{encoding:"utf8",timeout:n})).stdout??"").trim()}catch(r){let i=typeof r=="object"&&r!==null&&"stderr"in r?String(r.stderr):"",a=i.trim().length>0?i.trim():r instanceof Error?r.message:String(r);throw new y(`Git command failed: git ${e.join(" ")}
21
+ ${a}`,_.GENERIC_FAILURE)}}function wg(e=process.platform){return e==="win32"?"npm.cmd":"npm"}function vg(e=process.platform){return e==="win32"}async function Jl(e,t,n=Sa,r=process.platform){let i=wg(r);try{return((await n(i,e,{cwd:t,encoding:"utf8",shell:vg(r)})).stdout??"").trim()}catch(a){let o=typeof a=="object"&&a!==null&&"stderr"in a?String(a.stderr):"",s=o.trim().length>0?o.trim():a instanceof Error?a.message:String(a);throw new y(`npm command failed: ${i} ${e.join(" ")}
22
+ ${s}`,_.GENERIC_FAILURE)}}function bg(e){let t=e.trim(),n=t.includes("@file:")?t.slice(0,t.lastIndexOf("@file:")):t;return n.startsWith("@")?n.match(/^(@[^/@\s]+\/[^/@\s]+)/)?.[1]??n:n.match(/^([^/@\s]+)/)?.[1]??n}function kg(e){let n=(e instanceof Error?e.message:String(e)).toLowerCase();return n.includes("npm err! code e404")||n.includes("404 not found")||n.includes("is not in this registry")}function xg(e){let n=(e instanceof Error?e.message:String(e)).toLowerCase();return kg(e)||n.includes("not found")}function Sg(e){let t=e.trim().toLowerCase();return t.startsWith("@unbrained/pm-")||t.startsWith("pm-")}function Eg(e){let t=bg(e),n=Sg(t),r=t.replace(/^.*\//,""),i=n?`github.com/unbraind/${r}`:void 0,a=i?`pm install --project ${i}`:void 0;return{message:n?`npm package "${e}" was not found in the registry. If this is an unpublished first-party pm package, install its GitHub repository instead.`:`npm package "${e}" was not found in the registry.`,context:{code:"npm_package_not_found",required:"Use an install source that exists, or publish the npm package before installing it with npm:<name>.",why:"Classifying npm 404s avoids repeated registry retries and gives agents a deterministic fallback path.",examples:a?[a,"pm package catalog --project --json"]:[`npm view ${t}`,"pm package catalog --project --json"],nextSteps:a?[`Try ${a} if the repository exists.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."]:[`Verify ${t} exists in the npm registry and that you have access to it.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."],recovery:{attempted_command:`pm install --project npm:${e}`,normalized_args:["install","--project",`npm:${e}`],...i&&a?{fallback_candidates:[{source:i,command:a,reason:"canonical first-party GitHub repository fallback for unpublished pm packages"}],next_best_command:a}:{}}}}}function Ag(e,t){if(!xg(t))return null;let n=Eg(e);return new y(n.message,_.NOT_FOUND,n.context)}async function Vl(e){if(O.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")){let t=O.resolve(process.cwd(),e);return await A(t)?t:null}try{let t=new URL(e);if(t.protocol==="file:"){let n=mg(t);return await A(n)?n:null}}catch{}if(!/^[a-z][a-z0-9+.-]*:/i.test(e)){let t=O.resolve(process.cwd(),e);if(await A(t))return t}return null}async function Rg(e){let t=await Vl(e);if(t)return t;let n=Ig(e);return n!==e?n:(/^[a-z][a-z0-9+.-]*:/i.test(e),e)}function Ig(e,t=process.cwd()){let n="@file:",r=e.lastIndexOf(n);if(r<=0)return e;let i=e.slice(0,r),a=e.slice(r+n.length);if(i.trim().length===0||a.trim().length===0||a.startsWith("//")&&!a.startsWith("///"))return e;if(!a.startsWith("/"))return`${i}@${O.resolve(t,a)}`;let o;try{o=decodeURIComponent(new URL(`file:${a}`).pathname)}catch{return e}let s=/^\/[A-Za-z]:/.test(o)?o.slice(1):o;return`${i}@${s}`}function Cg(e,t){try{let r=JSON.parse(e),i=Array.isArray(r)?r[0]:void 0;if(i&&typeof i.filename=="string"&&i.filename.trim().length>0)return{tarball:O.resolve(t,i.filename),package:typeof i.name=="string"?i.name:void 0,version:typeof i.version=="string"?i.version:void 0}}catch{}let n=e.split(/\r?\n/).map(r=>r.trim()).filter(r=>r.length>0).at(-1);if(!n)throw new y("npm pack did not report a tarball filename.",_.GENERIC_FAILURE);return{tarball:O.resolve(t,n)}}async function $g(e){return Tg(e,Jl)}async function Tg(e,t){let n=await Vl(e.spec);if(n){if((await G.stat(n)).isFile()&&Kl(n))return Yl(n);let s=O.join(n,"package.json"),c=await A(s)?JSON.parse(await G.readFile(s,"utf8")):{};return{directory:await bn(n,e.input),package:typeof c.name=="string"?c.name:void 0,version:typeof c.version=="string"?c.version:void 0,cleanup:async()=>{}}}let r=await G.mkdtemp(O.join(xa.tmpdir(),"pm-npm-package-source-")),i=O.join(r,"pack"),a=O.join(r,"extract");await G.mkdir(i,{recursive:!0}),await G.mkdir(a,{recursive:!0});try{let o=await Rg(e.spec),s=await t(["pack",o,"--json","--pack-destination",i]),c=Cg(s,i);await Sa("tar",["-xzf",c.tarball,"-C",a],{encoding:"utf8"});let l=O.join(a,"package");return await Xl(l),{directory:await bn(l,e.input),package:c.package,version:c.version,cleanup:async()=>{await G.rm(r,{recursive:!0,force:!0})}}}catch(o){await G.rm(r,{recursive:!0,force:!0});let s=Ag(e.spec,o);throw s||o}}function Kl(e){let t=e.toLowerCase();return t.endsWith(".tgz")||t.endsWith(".tar.gz")}function Qe(e){throw new y(e,_.USAGE,{code:"local_package_archive_unsafe",required:"Use a bounded npm .tgz or .tar.gz archive with one package/ root and no links or escaping paths.",why:"Package archives are untrusted input and must be validated before any entry reaches the filesystem."})}function Og(e,t,n){if(e.meta)return;n.entries+=1,n.entries>t.maxEntries&&Qe(`Local package archive exceeds the ${t.maxEntries} entry limit.`);let r=e.path,i=r.split("/");(r.includes("\\")||r.startsWith("/")||/^[A-Za-z]:/u.test(r)||i.some(a=>a===".."))&&Qe(`Local package archive contains an escaping path: "${r}".`),i[0]!=="package"&&Qe(`Local package archive entry "${r}" is outside the required package/ root.`),(e.type==="SymbolicLink"||e.type==="Link")&&Qe(`Local package archive link "${r}" is not supported.`),e.type!=="File"&&e.type!=="OldFile"&&e.type!=="Directory"&&Qe(`Local package archive entry "${r}" uses unsupported type "${e.type}".`),e.size>t.maxEntryBytes&&Qe(`Local package archive entry "${r}" exceeds the ${t.maxEntryBytes} byte entry limit.`),n.expandedBytes+=e.size,n.expandedBytes>t.maxExpandedBytes&&Qe(`Local package archive exceeds the ${t.maxExpandedBytes} expanded byte limit.`),r==="package/package.json"&&(n.packageJsonEntries+=1)}async function Yl(e,t=_g){(await G.stat(e)).size>t.maxArchiveBytes&&Qe(`Local package archive exceeds the ${t.maxArchiveBytes} archive byte limit.`);let r=await G.mkdtemp(O.join(xa.tmpdir(),"pm-local-package-archive-")),i=O.join(r,"extract");await G.mkdir(i,{recursive:!0});let a={entries:0,expandedBytes:0,packageJsonEntries:0},o;try{if(await gg({file:e,strict:!0,maxDecompressionRatio:100,onReadEntry:d=>{if(o===void 0)try{Og(d,t,a)}catch(u){o=u}}}),o!==void 0)throw o;a.packageJsonEntries!==1&&Qe(`Local package archive must contain exactly one package/package.json entry; found ${a.packageJsonEntries}.`),await hg({file:e,cwd:i,strict:!0,preservePaths:!1,preserveOwner:!1,noMtime:!0,unlink:!0,maxDepth:64,maxDecompressionRatio:100});let s=O.join(i,"package"),c=O.join(s,"package.json"),l=JSON.parse(await G.readFile(c,"utf8"));return await Xl(s),{directory:await bn(s,e),package:typeof l.name=="string"?l.name:void 0,version:typeof l.version=="string"?l.version:void 0,cleanup:async()=>{await G.rm(r,{recursive:!0,force:!0})}}}catch(s){throw await G.rm(r,{recursive:!0,force:!0}),s}}async function Xl(e,t=Jl){let n=O.join(e,"package.json");if(!await A(n))return;let r;try{r=JSON.parse(await G.readFile(n,"utf8"))}catch{return}if(typeof r!="object"||r===null)return;let i=r,a=Fg(i),o=Dg(i);if(a.length===0&&!o)return;let s={...r};delete s.devDependencies;let c={...s};Pg(c),await G.writeFile(n,`${JSON.stringify(c,null,2)}
23
+ `,"utf8");try{await Promise.all([G.rm(O.join(e,"package-lock.json"),{force:!0}),G.rm(O.join(e,"npm-shrinkwrap.json"),{force:!0})]),a.length>0&&await t(["install","--ignore-scripts","--no-audit","--fund=false","--package-lock=false","--no-save","--omit=peer","--"],e),o&&await Ng(e)}finally{await G.writeFile(n,`${JSON.stringify(s,null,2)}
24
+ `,"utf8")}}function Dg(e){for(let t of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(typeof t=="object"&&t!==null&&Mr in t)return!0;return!1}function Pg(e){for(let t of["dependencies","optionalDependencies","peerDependencies"]){let n=e[t];if(typeof n!="object"||n===null)continue;let r={...n};delete r[Mr],Object.keys(r).length===0?delete e[t]:e[t]=r}}async function Ng(e){let t=Ee(import.meta.url,["../../.."]),[n,r]=Mr.split("/"),i=O.join(e,"node_modules",n),a=O.join(i,r);await G.mkdir(i,{recursive:!0}),await G.rm(a,{recursive:!0,force:!0}),await G.symlink(t,a,Mg(process.platform))}function Mg(e){return e==="win32"?"junction":"dir"}function Lg(e,t){if(e.startsWith("-"))throw new y(`Extension runtime dependency name "${e}" is unsafe because npm could interpret it as a command-line option.`,_.USAGE,{code:"extension_dependency_name_unsafe",required:"Use a valid npm package name that does not begin with a dash.",why:"Extension manifests are untrusted input and dependency names must never become npm options."});if([...t].some(r=>{let i=r.charCodeAt(0);return i<=31||i===127||"&|;()`\"'".includes(r)}))throw new y(`Extension runtime dependency "${e}" has an unsafe version specifier.`,_.USAGE,{code:"extension_dependency_version_unsafe",required:"Use an npm version, range, dist-tag, URL, or file specifier without shell metacharacters.",why:"npm.cmd requires a command shell on Windows, so untrusted shell metacharacters cannot be forwarded."});try{fg.resolve(e,t)}catch{throw new y(`Extension runtime dependency "${e}@${t}" is not a valid npm dependency specifier.`,_.USAGE,{code:"extension_dependency_spec_invalid",required:"Use a valid npm package name and npm-supported version, range, dist-tag, URL, or file specifier.",why:"Only grammar-validated dependency specs may be written to the isolated runtime install manifest."})}return`${e}@${t}`}function Fg(e){let t=new Map;for(let n of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(!(typeof n!="object"||n===null))for(let[r,i]of Object.entries(n)){if(r===Mr||typeof i!="string"||i.trim().length===0||t.has(r))continue;let a=i.trim();t.set(r,Lg(r,a))}return[...t.values()]}async function bn(e,t){let n=await Bn(e);if(n.length===1)return n[0];if(n.length>1){let r=n.map(i=>O.relative(e,i).replaceAll(O.sep,"/")).sort((i,a)=>i.localeCompare(a));throw new y(`Package source "${t}" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${r.join(", ")}`,_.USAGE)}throw new y(`Unable to locate a pm extension manifest in package source "${t}". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,_.USAGE)}async function jg(e,t){let n=[];t.subpath&&(n.push(t.subpath),n.push(O.posix.join(".agents/pm/extensions",t.subpath)),n.push(O.posix.join(".custom/pm-extensions",t.subpath)),n.push(O.posix.join(".custom/pm-extension",t.subpath)));for(let i of n){let a=O.resolve(e,i);if(ye(e,a)&&await A(O.join(a,"manifest.json")))return{directory:a,resolved_subpath:i}}if(await A(O.join(e,"manifest.json")))return{directory:e,resolved_subpath:"."};let r=await bn(e,t.input);return{directory:r,resolved_subpath:O.relative(e,r).replaceAll(O.sep,"/")}}function Ug(e){let t=e.trim();return t.length===0||t.startsWith(".")||t.startsWith("~")?!1:t.startsWith("@")?t.split("/").length===2:!t.includes("/")&&!t.includes("\\")}async function zg(e){let t=`Local extension source does not exist: "${e.absolute_path}".`,n=e.input.trim();if(!Ug(n))return new y(t,_.NOT_FOUND);let r=[];try{let a=process.env.PM_CLI_PACKAGE_ROOT,o=typeof a=="string"&&a.trim().length>0?O.resolve(a.trim()):"";ba?.key!==o&&(ba={key:o,aliases:await Pr()}),r=ba.aliases}catch{}let i=[`Retry with pm install npm:${n} if the package is published to npm.`,`Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${r.join(", ")}`];return new y(`${t} "${n}" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as "npm:${n}".`,_.NOT_FOUND,{code:"local_source_not_found_bare_name",required:`Use "npm:${n}" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,why:"Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.",examples:[`pm install npm:${n}`,"pm package catalog --project --json"],nextSteps:i,recovery:{attempted_command:`pm install ${n}`,normalized_args:["install",n],next_best_command:`pm install npm:${n}`}})}async function Zl(e){if(e.kind==="local"){let r;try{r=await G.stat(e.absolute_path)}catch{throw await zg(e)}if(r.isFile()&&Kl(e.absolute_path)){let a=await Yl(e.absolute_path);return{source:e,directory:a.directory,source_root:O.dirname(a.directory),resolved_subpath:O.relative(O.dirname(a.directory),a.directory).replaceAll(O.sep,"/"),npm_package:a.package,npm_version:a.version,cleanup:a.cleanup}}if(!r.isDirectory())throw new y(`Local extension source must be a directory or npm .tgz/.tar.gz archive: "${e.absolute_path}".`,_.USAGE);let i=await bn(e.absolute_path,e.input);return{source:e,directory:i,source_root:e.absolute_path}}if(e.kind==="npm"){let r=await $g(e);return{source:e,directory:r.directory,source_root:O.dirname(r.directory),cleanup:r.cleanup,resolved_subpath:O.relative(O.dirname(r.directory),r.directory).replaceAll(O.sep,"/"),npm_package:r.package,npm_version:r.version}}let t=await G.mkdtemp(O.join(xa.tmpdir(),"pm-extension-source-")),n=["clone","--depth","1"];e.ref&&n.push("--branch",e.ref),n.push(e.repository,t);try{await Nr(n);let r=await Nr(["-C",t,"rev-parse","HEAD"]),i=await jg(t,e);return{source:e,directory:i.directory,source_root:t,resolved_subpath:i.resolved_subpath,commit:r,cleanup:async()=>{await G.rm(t,{recursive:!0,force:!0})}}}catch(r){throw await G.rm(t,{recursive:!0,force:!0}),r}}async function Ql(e,t){if(!await A(e)||!await A(t))return!1;let[n,r]=await Promise.all([G.realpath(e),G.realpath(t)]);return n===r}import kn from"node:fs/promises";import xn from"node:path";(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]="30dfc6e4-27c5-56c0-981b-94e85b780f1f")}catch{}})();var Ea=1,bt="2026.6.24",qg=">=22.18.0",Gg={fs_read:!1,fs_write:!1,network:!1,env_read:!1,env_write:!1,process_spawn:!1},ed=new Set([...ss.map(e=>e.split("-")[0].toLowerCase()),...Object.keys(ds).map(e=>e.toLowerCase()),"scaffold"]),Wg="^6.0.0",Bg="^22.0.0",rd=["type StarterHarness = Awaited<ReturnType<typeof createExtensionTestHarness>>;","","async function deactivateIfNeeded(ext: StarterHarness, deactivated: boolean): Promise<void> {"," if (!deactivated) {"," try {"," await ext.deactivate();"," } catch {"," // Preserve the original assertion error; cleanup is best effort."," }"," }","}",""],ze=[" } finally {"," await deactivateIfNeeded(ext, deactivated);"," }"];function td(e,t){return e.map(n=>n===""?n:`${t}${n}`)}function id(e){let t=e.includeMigrationReplacementHint===!0?[" // as your migration grows."]:[];return[" // assertItemType/Field/Migration throw unless the registration is present, so"," // reaching each next line already proves the wiring; assert on the returned"," // definitions to demonstrate inspecting registered metadata.",` const itemType = ext.assertItemType({ name: ${JSON.stringify(e.itemTypeName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,` assert.equal(itemType.itemType.folder, ${JSON.stringify(e.itemTypeFolder)});`,` const itemField = ext.assertItemField({ name: ${JSON.stringify(e.fieldName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,' assert.equal(itemField.field.type, "string");',` ext.assertMigration({ name: ${JSON.stringify(e.migrationId)}, extensionName: ${JSON.stringify(e.extensionName)}, mandatory: false });`,""," // runMigration invokes the migration through pm's real runner with a synthetic"," // context and returns its result.",...t,` const migrated = await ext.runMigration({ migration: ${JSON.stringify(e.migrationId)} });`,` assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(e.migrationId)} });`]}function ad(e){return[" // assertProfile throws unless the profile is registered, so reaching the next"," // line already proves the wiring; assert on the returned definition to inspect"," // the bundled archetype dimensions.",` const { profile } = ext.assertProfile({ name: ${JSON.stringify(e)}, extensionName: ${JSON.stringify(e)} });`,` assert.equal(profile.title, ${JSON.stringify(`${e} archetype`)});`," assert.equal(profile.types.length, 1);"," assert.equal(profile.workflows.length, 1);"]}var Hg={compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",strict:!0,esModuleInterop:!0,skipLibCheck:!0,noEmit:!0,allowImportingTsExtensions:!0,resolveJsonModule:!0,types:["node"]},include:["**/*.ts"]},nd=["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"],od={commands:["commands"],hooks:["commands","hooks"],search:["commands","search"],importers:["commands","schema","importers"],schema:["commands","schema"],profile:["commands","schema"],renderers:["commands","renderers"],parser:["commands","parser","schema"],preflight:["commands","preflight"],services:["commands","services"]},Jg={commands:'["commands"]',hooks:'["commands", "hooks"]',search:'["commands", "search"]',importers:'["commands", "schema", "importers"]',schema:'["commands", "schema"]',profile:'["commands", "schema"]',renderers:'["commands", "renderers"]',parser:'["commands", "parser", "schema"]',preflight:'["commands", "preflight"]',services:'["commands", "services"]'},Vg={commands:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration plus a `deactivate` teardown stub.",hooks:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub.",search:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub.",importers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub.",schema:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a custom item type, a custom item field, a schema migration, and a `deactivate` teardown stub.",profile:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a project profile (item types, statuses, fields, a workflow, config, a template, and package recommendations) registered via `api.registerProfile`, and a `deactivate` teardown stub.",renderers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a `toon` output renderer override, and a `deactivate` teardown stub.",parser:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a parser override that rewrites the command's parsed options, and a `deactivate` teardown stub.",preflight:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a preflight override over pm's pre-run gate decision, and a `deactivate` teardown stub.",services:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `output_format` service override, and a `deactivate` teardown stub."},Kg={commands:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.",hooks:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.",search:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.",importers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers.",schema:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, item type/field/migration registration, migration invocation, and teardown via the SDK testing helpers.",profile:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, project-profile registration (asserting the bundled archetype dimensions), and teardown via the SDK testing helpers.",renderers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, renderer override registration and invocation (including format pass-through), and teardown via the SDK testing helpers.",parser:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, parser override registration and the option rewrite it produces, and teardown via the SDK testing helpers.",preflight:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, preflight override registration and the gate decision it returns, and teardown via the SDK testing helpers.",services:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, service override registration and invocation (including command pass-through), and teardown via the SDK testing helpers."},sd="- `tsconfig.json`: strict type-check-only TypeScript config (`noEmit`) for the `.ts` source the loader runs directly.",Yg={commands:[],hooks:["","## Lifecycle Hook","`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.","pm fires it once a command finishes, passing the command outcome and the","items it mutated (`context.affected`). React there to keep external context","in sync - sync records, emit telemetry, or refresh derived state. The","`hooks` capability in `manifest.json` is what grants the hook registration;","remove it (and the hook) if your package only needs commands."],search:["","## Search Provider","`index.ts` registers a deterministic in-memory search provider and","vector-store adapter through `api.registerSearchProvider` and","`api.registerVectorStoreAdapter`. Replace the sample scoring,","embedding, and storage behavior with your project-specific retrieval","logic. The `search` capability in `manifest.json` grants both","registrations."],importers:["","## Importer and Exporter","`index.ts` registers paired project-context import/export commands through","`api.registerImporter` and `api.registerExporter`. Replace the starter","payloads with your domain adapter: GitHub issues, CSV rows, documents,","tickets, or another project-management source of truth. The `importers`","capability grants both registrations, and `schema` grants the example","command flag metadata."],schema:["","## Custom Schema","`index.ts` models a project domain by registering a custom item type, a","custom item field, and a schema migration through `api.registerItemTypes`,","`api.registerItemFields`, and `api.registerMigration`. This is how a package","turns pm into a domain-specific tracker \u2014 `project management = context","management`. Replace the sample type/field/migration with your own domain","model; the `schema` capability in `manifest.json` grants all three","registrations. Once installed, the custom type is usable everywhere, e.g.",'`pm create <type> "<title>"` and `pm list --type <type>`.'],profile:["","## Project Profile","`index.ts` registers a complete project-profile archetype through","`api.registerProfile`. A profile is the broadest customization primitive pm","has \u2014 one declarative bundle of item types, custom statuses, fields, a per-type","workflow, config knobs, create templates, and package recommendations. Once the","package is installed the profile resolves by name through `pm profile list`,","`pm profile show <name>`, and `pm profile apply <name>`, which stages every","dimension idempotently \u2014 exactly like a core archetype (agile/ops/research),","with no consumer code required. Replace the sample archetype with your own","domain; the `schema` capability in `manifest.json` grants the registration (a","profile is a schema+config bundle, so it needs no separate capability)."],renderers:["","## Output Renderer","`index.ts` registers a `toon` output renderer override through","`api.registerRenderer`. Renderer overrides run for every command's output in","that format, so this starter scopes itself to THIS package's own command and","returns `null` (pass-through to pm's default renderer) for everything else.","Return a string to take over rendering. Replace the sample serialization with","your own; the `renderers` capability in `manifest.json` grants the","registration."],parser:["","## Parser Override","`index.ts` registers a parser override for the starter command through","`api.registerParser`. pm runs it on the command's parsed options BEFORE the","handler, merging the delta you return. This starter rewrites a deprecated","`--shout` alias to the canonical `--upper` flag; replace it with your","command's real normalization. The `parser` capability in `manifest.json`","grants the registration."],preflight:["","## Preflight Override","`index.ts` registers a preflight override through `api.registerPreflight`. pm","calls it only for its declared command ownership to compute the migration/format","gate decision. Overlapping or legacy global ownership is diagnosed. Return only","the decision keys you want to","change; this starter echoes the current decision unchanged (a safe no-op) so","installing the package does not alter gate behavior. The `preflight`","capability in `manifest.json` grants the registration."],services:["","## Service Override","`index.ts` overrides the built-in `output_format` service through","`api.registerService`. The service renders a command's structured result;","returning the payload unchanged passes through to pm's default formatting.","This starter scopes itself to THIS package's own command and passes every","other command through, so it never disrupts unrelated output. The `services`","capability in `manifest.json` grants the registration."]},Xg={package:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","package's `activate` registers. pm imports and activates the package lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands (`pm list`, `pm search`, ...) never pay to load it. Keep this list in","sync with the registrations in `index.ts`: add an entry when you register a new","command, importer, or exporter, and remove one you drop. An omitted or stale","entry means the matching command will not dispatch from the CLI. Globally-scoped","surfaces (hooks, parser/preflight/renderer overrides, and search providers for","built-in search commands) still activate regardless of this list."],extension:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","extension's `activate` registers. pm imports and activates the extension lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands never pay to load it. Keep this list in sync with the registrations in","`index.ts`: an omitted or stale entry means the matching command will not dispatch","from the CLI. Globally-scoped surfaces (hooks, parser/preflight/renderer overrides,","and search providers for built-in search commands) still activate regardless."]},Zg={package:["","## Activation","This package contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the package","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`. If you","drop the schema registrations and keep only command/hook/search/importer surfaces,","add `activation.commands` back so pm can load the package lazily."],extension:["","## Activation","This extension contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the extension","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`."]},Qg={package:["","## Activation","This package contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands \u2014 commands the package does not own \u2014 so `manifest.json` intentionally","declares no `activation.commands`. pm activates the package conservatively (for","every command, granted by the `schema` capability) so the profile is present","whenever `pm profile` runs. Declaring narrow `activation.commands` here would","gate activation to only the listed commands and silently leave the profile","unregistered for `pm profile`."],extension:["","## Activation","This extension contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands, so `manifest.json` intentionally declares no `activation.commands`. pm","activates the extension conservatively (for every command, granted by the","`schema` capability) so the profile is present whenever `pm profile` runs.","Declaring narrow `activation.commands` here would silently leave the profile","unregistered for `pm profile`."]};function cd(e,t){return e==="schema"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the custom item type activates for every command).`:e==="profile"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the contributed profile resolves through \`pm profile\` for every command).`:`- \`manifest.json\`: ${t} metadata, capabilities, and \`activation.commands\` (the command paths that lazily activate this ${t}).`}function ld(e,t){return e==="schema"?Zg[t]:e==="profile"?Qg[t]:Xg[t]}function e_(e){let t=e.replace(/-/g," ").trim().split(/\s+/).filter(c=>c.length>0);if(t.length===0)return"starter ping";let n=t[0].toLowerCase(),r=0;for(;t[r]?.toLowerCase()==="starter";)r+=1;let i=t[r]?.toLowerCase(),a=r>0&&(r===t.length||i!==void 0&&ed.has(i));return`${(ed.has(n)||a?["starter",...t]:t).join(" ")} ping`}function dd(e){let t=e,n=`${e}s`,r=e.replace(/-/g,""),i=r===t?[]:[r],a=`${e.replace(/-/g,"_")}_owner`,o="reviewing";return[` name: ${JSON.stringify(e)},`,` title: ${JSON.stringify(`${e} archetype`)},`,' summary: "Starter project profile. Replace these dimensions with your own archetype.",'," // Item types the profile upserts into the project schema when applied."," types: ["," {",` name: ${JSON.stringify(t)},`,` folder: ${JSON.stringify(n)},`,` aliases: ${JSON.stringify(i)},`,` description: ${JSON.stringify(`A ${e} work item that flows to done.`)},`," },"," ],"," // Custom statuses upserted into the project status set."," statuses: ["," {",` id: ${JSON.stringify(o)},`,' roles: ["active"],',' aliases: ["in-review"],',' description: "Work is implementation-complete and awaiting review.",'," },"," ],"," // Custom item-metadata fields the archetype tracks."," fields: ["," {",` key: ${JSON.stringify(a)},`,' type: "string",',' commands: ["create", "update", "list"],',' description: "Stakeholder accountable for the item.",'," },"," ],"," // Per-type workflow transition allow-list staged into settings."," workflows: ["," {",` type: ${JSON.stringify(t)},`," allowed_transitions: [",' ["open", "in_progress"],',` ["in_progress", ${JSON.stringify(o)}],`,` [${JSON.stringify(o)}, "in_progress"],`,` [${JSON.stringify(o)}, "closed"],`,' ["in_progress", "blocked"],',' ["blocked", "in_progress"],'," ],"," },"," ],"," // Nested-settings knobs staged when the profile is applied."," config: [",' { key: "search_provider", value: "bm25", summary: "Offline BM25 lexical search needs no embedding service." },',' { key: "search_max_results", value: "20", summary: "Result cap tuned for quick triage." },'," ],"," // Create templates staged into <pmRoot>/templates."," templates: ["," {",` name: ${JSON.stringify(e)},`," options: {",` type: ${JSON.stringify(t)},`,' priority: "2",',` tags: ${JSON.stringify(e)},`,' acceptanceCriteria: "Item delivers the stated outcome with tests and docs updated.",',' body: "## Context\\n\\n## Acceptance\\n- [ ] \\n",'," },"," },"," ],"," // Advisory package recommendations (never auto-installed)."," packages: [",' { spec: "templates", reason: "Reusable create templates for recurring item shapes." },'," ],"]}function t_(e,t,n){let r=`${e}-search`,i=`${e}-vector`,a=`${e.replace(/-/g," ")} items`,o=[" api.registerCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",'," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,",' message: "Starter extension scaffold is active.",'," }),"," });"];if(n==="commands")return o;if(n==="search")return[...o,""," // Search providers let packages customize how pm ranks and retrieves"," // project context. This starter is deterministic and dependency-free:"," // replace the scoring with your domain retrieval, embedding, or rerank"," // logic as the package grows."," api.registerSearchProvider({",` name: ${JSON.stringify(r)},`," query: async (context) => {"," const needle = context.query.toLowerCase();"," const hits = context.documents"," .filter((document) => {",' const title = String(document.metadata.title ?? "").toLowerCase();'," return title.includes(needle);"," })"," .map((document) => ({"," id: document.metadata.id,"," score: 1,",' matched_fields: ["title"],'," }));"," return { hits };"," },"," embed: async (context) => [context.input.length],"," });",""," // Vector-store adapters let packages own semantic index storage. This"," // starter returns a stable in-memory hit so generated tests can exercise"," // the adapter without external services."," api.registerVectorStoreAdapter({",` name: ${JSON.stringify(i)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),"," });"];if(n==="schema"){let s=e,c=`${e}s`,l=e.replace(/-/g,""),d=l===s?[]:[l],u=`${e.replace(/-/g,"_")}_note`,m=`${e}-0001-init`;return[...o,""," // Schema registrations let a package model its own project domain \u2014 the",' // heart of "project management = context management". Item types and fields'," // are GLOBAL contributions: built-in commands like `pm create <type>` and"," // `pm list --type <type>` must see them, so this package declares no"," // `activation.commands` and pm activates it conservatively for every command."," // The `schema` capability in manifest.json grants all three registrations."," api.registerItemFields(["," {",` name: ${JSON.stringify(u)},`,' type: "string",'," optional: true,"," },"," ]);",""," api.registerItemTypes(["," {",` name: ${JSON.stringify(s)},`," // Replace with your domain's canonical plural folder name.",` folder: ${JSON.stringify(c)},`,` aliases: ${JSON.stringify(d)},`," // Add field names here to force them at `pm create` time."," required_create_fields: [],"," },"," ]);",""," // Migrations let a package evolve stored items as its schema changes. pm"," // runs each migration ONCE through the preflight gate (not once per item),"," // passing a context that identifies the migration itself: `context.id` is"," // the migration id (not an item id), alongside `context.pm_root` \u2014 iterate"," // the corpus yourself from there. This starter is a deterministic no-op so"," // package tests can invoke it without touching the corpus; replace the body"," // with your real rewrite."," api.registerMigration({",` id: ${JSON.stringify(m)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),"," });"]}return n==="profile"?[...o,""," // A project profile is the broadest customization primitive pm has: one"," // declarative bundle of item types, custom statuses, fields, a per-type"," // workflow, config knobs, create templates, and package recommendations. Once"," // this package is installed the profile resolves by name through `pm profile"," // list`, `pm profile show`, and `pm profile apply`, which stages every dimension"," // idempotently like a core archetype. A profile registration is a schema+config"," // bundle, so the `schema` capability in manifest.json grants it."," api.registerProfile({",...dd(e).map(s=>` ${s}`)," });"]:n==="importers"?[...o,""," // Importers/exporters are the bridge between pm's context graph and"," // another project-management system. Keep the starter deterministic so"," // package tests can run without touching the network or filesystem; replace"," // these payloads with your adapter's real mapping as the package grows."," api.registerImporter(",` ${JSON.stringify(a)},`," async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,"," }),"," {",` action: ${JSON.stringify(`${a} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," },"," );",""," api.registerExporter(",` ${JSON.stringify(a)},`," async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,"," }),"," {",` action: ${JSON.stringify(`${a} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," },"," );"]:n==="renderers"?[...o,""," // Renderer overrides customize how pm serializes a command's structured",' // result for an output format ("toon" or "json"). Host-enforced ownership'," // prevents unrelated commands from reaching this callback."," // The `renderers` capability in manifest.json grants the registration.",' api.registerRenderer("toon", (context) => {',` return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,` }, { commands: [${JSON.stringify(t)}] });`]:n==="parser"?[" api.registerCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",'," flags: ["," {",' long: "--shout",',' value_type: "boolean",',' description: "Deprecated alias for --upper; the parser override rewrites it.",'," },"," {",' long: "--upper",',' value_type: "boolean",',' description: "Echo the canonical flag the parser override produces.",'," },"," ],"," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,"," // Surfaces the normalized option so `--shout`/`--upper` is observable."," upper: context.options.upper === true,",' message: "Starter extension scaffold is active.",'," }),"," });",""," // Parser overrides preprocess a command's parsed options BEFORE its handler"," // runs, returning a delta \u2014 only the keys you set are merged over the parsed"," // input. This override is scoped to THIS package's own command. Here it"," // rewrites the deprecated `--shout` boolean alias to the canonical `--upper`"," // flag; replace it with your command's real normalization. The `parser`"," // capability in manifest.json grants the registration.",` api.registerParser(${JSON.stringify(t)}, (context) => {`," const options = { ...context.options };"," if (options.shout === true) {"," options.upper = true;"," }"," delete options.shout;"," return { options };"," });"]:n==="preflight"?[...o,""," // Preflight overrides adjust pm's pre-run gate decision (extension"," // migrations + item-format checks) for the commands it owns. Disjoint"," // packages compose; overlapping or legacy global ownership is diagnosed."," // Return a delta of the keys you want to change"," // (enforce_item_format_gate, run_preflight_item_format_sync,"," // run_extension_migrations, enforce_mandatory_migration_gate); returning"," // context.decision unchanged is a safe no-op so installing the package does"," // not alter gate behavior \u2014 replace it with your policy, e.g."," // `{ run_extension_migrations: false }`. The `preflight` capability in"," // manifest.json grants the registration."," api.registerPreflight({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,"," });"]:n==="services"?[...o,""," // Service overrides replace a built-in pm service. The `output_format`"," // service renders a command's structured result; returning the payload"," // unchanged passes through to pm's default formatting. This override scopes"," // itself to THIS package's own command and passes every other command"," // through, so it never disrupts unrelated output. The `services` capability"," // in manifest.json grants the registration.",' api.registerService("output_format", (context) => {',` if (context.command !== ${JSON.stringify(t)}) {`," return { handled: false };"," }",` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`," });"]:[...o,""," // after_command hooks fire once pm finishes a command, receiving the items"," // it mutated. This is the natural place to react to every change - sync to"," // an external system, emit telemetry, or refresh derived context",' // ("project management = context management"). This starter is a documented'," // no-op on the success path; replace the body with your own reaction."," api.hooks.afterCommand((context) => {"," if (!context.ok) {"," return;"," }"," // `context.affected` lists the items pm mutated (id, status,"," // changed_fields). React here, e.g.:"," // for (const item of context.affected ?? []) { /* ...item.id... */ }"," });"]}function n_(e,t,n){let r=n==="hooks",i=n==="search",a=n==="importers",o=n==="schema",s=n==="profile",c=n==="renderers",l=n==="parser",d=n==="preflight",u=n==="services",m=Jg[n],p=e,f=`${e}s`,g=`${e.replace(/-/g,"_")}_note`,h=`${e}-0001-init`,w=[" assertExtensionDeactivated,"," createExtensionTestHarness,"],v=r?[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertHook throws unless an after_command hook is registered, so"," // reaching the next line already proves the hook is wired."," ext.assertHook({",' kind: "after_command",',` extensionName: ${JSON.stringify(e)},`," });"," // runHook fires the hook through pm's real runner with a synthetic"," // context and returns the warnings it produced; a clean hook returns none."," // Replace the context/assertions as your hook grows."," const warnings = await ext.runHook({",' kind: "after_command",'," context: {",` command: ${JSON.stringify(t)},`," args: [],",' pm_root: "",'," ok: true,"," affected: [],"," },"," });"," assert.deepEqual(warnings, []);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],b=i?Aa(e,t,"search",m):[],x=a?Aa(e,t,"importers",m):[],R=o?[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {",...td(id({extensionName:e,itemTypeName:p,itemTypeFolder:f,fieldName:g,migrationId:h,includeMigrationReplacementHint:!0})," ")," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],k=s?[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {",...td(ad(e)," ")," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],F=c?[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertRendererOverride throws unless a renderer is registered for the"," // format, so reaching the next line already proves the wiring.",` const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,' assert.equal(override.format, "toon");',""," // runRendererOverride renders through pm's real runner. The override"," // customizes only THIS package's command output and returns a string the"," // host uses verbatim. Replace the assertions as it grows."," const rendered = await ext.runRendererOverride({",' format: "toon",',` command: ${JSON.stringify(t)},`," result: { ok: true },"," });"," assert.equal(rendered.overridden, true);",` assert.equal(rendered.rendered, ${JSON.stringify(`${e}: `)} + JSON.stringify({ ok: true }));`,""," // Output for any other command passes through to pm's default renderer."," const passthrough = await ext.runRendererOverride({",' format: "toon",',' command: "list",'," result: { ok: true },"," });"," assert.equal(passthrough.overridden, false);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],T=l?[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertParserOverride throws unless a parser is registered for the"," // command, so reaching the next line already proves the wiring.",` ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,""," // runParserOverride runs the override through pm's real parser runner and"," // returns the rewritten context. The starter rewrites the deprecated"," // `shout` alias to the canonical `upper` flag."," const result = await ext.runParserOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: { shout: true },"," global: {},",' pm_root: "",'," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.context.options, { upper: true });",""," // End to end: feed the rewritten options into the command handler to"," // prove `pm <command> --shout` surfaces the normalized `upper` flag in"," // the result.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`," upper: true,",' message: "Starter extension scaffold is active.",'," });"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],E=d?[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertPreflightOverride throws unless a preflight override is"," // registered, so reaching the next line already proves the wiring.",` ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,""," // runPreflightOverride runs the override through pm's real runner with a"," // synthetic gate decision. The starter echoes the decision unchanged;"," // replace the values/assertions with your real policy."," const decision = {"," enforce_item_format_gate: true,"," run_preflight_item_format_sync: false,"," run_extension_migrations: true,"," enforce_mandatory_migration_gate: false,"," };"," const result = await ext.runPreflightOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: {},"," global: {},",' pm_root: "",'," decision,"," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.decision, decision);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],U=u?[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertServiceOverride throws unless a service override is registered"," // for the service, so reaching the next line proves the wiring.",` ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,""," // runServiceOverride runs the override through pm's real service runner."," // The override customizes only THIS package's command output (handled),"," // passing every other command through (not handled)."," const handled = await ext.runServiceOverride({",' service: "output_format",',` command: ${JSON.stringify(t)},`," payload: { ok: true },"," });"," assert.equal(handled.handled, true);",` assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,""," // Output for any other command passes through to pm's default formatter."," const passthrough = await ext.runServiceOverride({",' service: "output_format",',' command: "list",'," payload: { ok: true },"," });"," assert.equal(passthrough.handled, false);"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[];return['import assert from "node:assert/strict";','import { test } from "node:test";',"import {",...w,'} from "@unbrained/pm-cli/sdk/testing";',...i?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension from "./index.ts";',"",...rd,`test(${JSON.stringify(`${e} registers its starter command`)}, async () => {`," // `capabilities` mirrors manifest.json so the in-memory activation grants"," // the capabilities the entrypoint relies on."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," let deactivated = false;"," try {"," // assertCommandContract is bound to the right activation registry and throws"," // if the command is not registered, so reaching here already proves the"," // wiring; assert on the returned definition to inspect metadata."," const registered = ext.assertCommandContract({",` name: ${JSON.stringify(t)},`,` extensionName: ${JSON.stringify(e)},`," });",' assert.equal(typeof registered.command.description, "string");',""," // runCommand invokes the handler through pm's real dispatch engine, so this"," // asserts behavior - not just that the command is wired. Replace these"," // assertions as you flesh out your command."," const invocation = await ext.runCommand({",` command: ${JSON.stringify(t)},`," });"," assert.equal(invocation.handled, true);"," // The handler result is typed `unknown`, so deep-equality on the whole"," // structured payload keeps the assertion type-safe without a cast."," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`,...l?[" upper: false,"]:[],' message: "Starter extension scaffold is active.",'," });"," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});","",...v,...b,...x,...R,...k,...F,...T,...E,...U,`test(${JSON.stringify(`${e} tears down cleanly via deactivate`)}, async () => {`," // createExtensionTestHarness binds teardown to the same name/layer used for"," // activation, so this proves your `deactivate` hook runs without throwing."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${m},`," });"," const teardown = await ext.deactivate();"," // assertExtensionDeactivated throws unless exactly one extension tore down"," // with no failures, so reaching the next line already proves teardown ran."," assertExtensionDeactivated(teardown);"," assert.equal(teardown.deactivated, 1);","});",""].join(`
25
+ `)}function r_(e,t,n){if(n==="schema"||n==="profile")return[];if(n==="importers"){let r=`${e.replace(/-/g," ")} items`;return[t,`${r} import`,`${r} export`]}return[t]}var i_={commands:"starter command",hooks:"starter command and after_command hook",search:"starter command, search provider, and vector-store adapter",importers:"starter command, importer, and exporter",schema:"starter command, custom item type, item field, and migration",profile:"starter command and project profile",renderers:"starter command and toon renderer override",parser:"starter command and parser override",preflight:"starter command and preflight override",services:"starter command and output_format service override"},a_={commands:"`commands`",hooks:"`commands` and `hooks.afterCommand`",search:"`commands`, `searchProviders`, and `vectorStoreAdapters`",importers:"`commands`, `importers`, and `exporters`",schema:"`commands`, `itemTypes`, `itemFields`, and `migrations`",profile:"`commands` and `profiles`",renderers:"`commands` and `renderers`",parser:"`commands` and `parsers`",preflight:"`commands` and `preflights`",services:"`commands` and `services`"};function o_(e,t,n){let r=n==="parser";return["// The starter command, authored with the `defineCommand` builder so its literal","// name is preserved and the handler `context` is inferred. Exporting it lets you","// unit-test the definition in isolation, apart from the blueprint.","export const pingCommand = defineCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",',...r?[" flags: ["," {",' long: "--shout",',' value_type: "boolean",',' description: "Deprecated alias for --upper; the parser override rewrites it.",'," },"," {",' long: "--upper",',' value_type: "boolean",',' description: "Echo the canonical flag the parser override produces.",'," },"," ],"]:[]," run: async (context) => ({"," ok: true,",` source: ${JSON.stringify(e)},`," command: context.command,",...r?[" upper: context.options.upper === true,"]:[],' message: "Starter extension scaffold is active.",'," }),","});"]}function s_(e,t,n){let r=[],i=[...o_(e,t,n)],a=[" commands: [pingCommand],"],o=`${e}-search`,s=`${e}-vector`,c=`${e.replace(/-/g," ")} items`,l=e,d=`${e}s`,u=e.replace(/-/g,""),m=u===l?[]:[u],p=`${e.replace(/-/g,"_")}_note`,f=`${e}-0001-init`;switch(n){case"commands":break;case"hooks":r.push("defineAfterCommandHook"),i.push("","// after_command hooks fire once pm finishes a command, receiving the items it","// mutated. React here - sync to an external system, emit telemetry, or refresh",'// derived context ("project management = context management"). This starter is a',"// documented no-op on the success path; replace the body with your own reaction.","export const afterCommandHook = defineAfterCommandHook((context) => {"," if (!context.ok) {"," return;"," }"," // `context.affected` lists the items pm mutated (id, status, changed_fields):"," // for (const item of context.affected ?? []) { /* ...item.id... */ }","});"),a.push(" hooks: { afterCommand: [afterCommandHook] },");break;case"search":r.push("defineSearchProvider","defineVectorStoreAdapter"),i.push("","// Search providers let packages customize how pm ranks and retrieves project","// context. This starter is deterministic and dependency-free: replace the scoring","// with your domain retrieval, embedding, or rerank logic as the package grows.","export const searchProvider = defineSearchProvider({",` name: ${JSON.stringify(o)},`," query: async (context) => {"," const needle = context.query.toLowerCase();"," const hits = context.documents"," .filter((document) => {",' const title = String(document.metadata.title ?? "").toLowerCase();'," return title.includes(needle);"," })"," .map((document) => ({"," id: document.metadata.id,"," score: 1,",' matched_fields: ["title"],'," }));"," return { hits };"," },"," embed: async (context) => [context.input.length],","});","","// Vector-store adapters let packages own semantic index storage. This starter","// returns a stable in-memory hit so generated tests can exercise the adapter","// without external services.","export const vectorStoreAdapter = defineVectorStoreAdapter({",` name: ${JSON.stringify(s)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),","});"),a.push(" searchProviders: [searchProvider],"," vectorStoreAdapters: [vectorStoreAdapter],");break;case"importers":r.push("defineExporter","defineImporter"),i.push("","// Importers/exporters are the bridge between pm's context graph and another","// project-management system. Keep the starter deterministic so package tests can","// run without touching the network or filesystem; replace these payloads with","// your adapter's real mapping as the package grows.","export const importer = defineImporter(async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,","}));"),a.push(" importers: ["," {",` name: ${JSON.stringify(c)},`," importer,"," options: {",` action: ${JSON.stringify(`${c} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," },"," },"," ],"," exporters: ["," {",` name: ${JSON.stringify(c)},`," exporter,"," options: {",` action: ${JSON.stringify(`${c} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," },"," },"," ],");break;case"schema":r.push("defineItemField","defineItemType","defineMigration"),i.push("","// Schema registrations let a package model its own project domain - the heart of",'// "project management = context management". Item types and fields are GLOBAL',"// contributions, so this package declares no `activation.commands` and pm","// activates it conservatively for every command.","export const noteField = defineItemField({",` name: ${JSON.stringify(p)},`,' type: "string",'," optional: true,","});","","export const itemType = defineItemType({",` name: ${JSON.stringify(l)},`," // Replace with your domain's canonical plural folder name.",` folder: ${JSON.stringify(d)},`,` aliases: ${JSON.stringify(m)},`," // Add field names here to force them at `pm create` time."," required_create_fields: [],","});","","// Migrations let a package evolve stored items as its schema changes. pm runs each","// migration ONCE through the preflight gate (not once per item), passing a context","// that identifies the migration itself: `context.id` is the migration id (not an","// item id), alongside `context.pm_root`. This starter is a deterministic no-op so","// package tests can invoke it without touching the corpus; replace the body with","// your real rewrite.","export const initMigration = defineMigration({",` id: ${JSON.stringify(f)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),","});"),a.push(" itemTypes: [itemType],"," itemFields: [noteField],"," migrations: [initMigration],");break;case"profile":r.push("defineProjectProfile"),i.push("","// A project profile is the broadest customization primitive pm has: one","// declarative bundle of item types, custom statuses, fields, a per-type workflow,","// config knobs, create templates, and package recommendations. Once installed it","// resolves by name through `pm profile list/show/apply`, which stages every","// dimension idempotently like a core archetype. A profile registration is a","// schema+config bundle, so the `schema` capability grants it.","export const starterProfile = defineProjectProfile({",...dd(e),"});"),a.push(" profiles: [starterProfile],");break;case"renderers":r.push("defineRendererOverride"),i.push("","// Host-enforced command ownership prevents unrelated output from reaching","// this renderer callback; return a string to take over serialization.","export const toonRenderer = defineRendererOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => {",` return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`," },","});"),a.push(" renderers: { toon: toonRenderer },");break;case"parser":r.push("defineParserOverride"),i.push("","// Parser overrides preprocess a command's parsed options BEFORE its handler runs,","// returning a delta - only the keys you set are merged over the parsed input. This","// override is scoped to THIS package's own command; here it rewrites the deprecated","// `--shout` boolean alias to the canonical `--upper` flag.","export const pingParser = defineParserOverride((context) => {"," const options = { ...context.options };"," if (options.shout === true) {"," options.upper = true;"," }"," delete options.shout;"," return { options };","});"),a.push(` parsers: { ${JSON.stringify(t)}: pingParser },`);break;case"preflight":r.push("definePreflightOverride"),i.push("","// Preflight overrides adjust pm's pre-run gate decision (extension migrations +","// item-format checks) for the commands it owns. Scoped ownership composes with","// other packages; overlapping or legacy global ownership is diagnosed.","// Return a delta of the keys you want to change (enforce_item_format_gate,","// run_preflight_item_format_sync, run_extension_migrations,","// enforce_mandatory_migration_gate); returning context.decision unchanged is a","// safe no-op - replace it with your policy, e.g. { run_extension_migrations: false }.","export const preflightOverride = definePreflightOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,","});"),a.push(" preflights: [preflightOverride],");break;case"services":r.push("defineServiceOverride"),i.push("","// Service overrides replace a built-in pm service. The `output_format` service","// renders a command's structured result; returning the payload unchanged passes","// through to pm's default formatting. This override scopes itself to THIS","// package's own command and passes every other command through.","export const outputService = defineServiceOverride((context) => {",` if (context.command !== ${JSON.stringify(t)}) {`," return { handled: false };"," }",` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),a.push(" services: { output_format: outputService },");break}return{builderImports:r,definitions:i,blueprintFields:a}}function c_(e,t,n){let r=s_(e,t,n);return[`import { ${["composeExtension","defineCommand","defineExtensionBlueprint",...r.builderImports].sort((a,o)=>a.localeCompare(o)).join(", ")} } from "@unbrained/pm-cli/sdk";`,"",...r.definitions,"","// Declarative authoring: describe WHAT the package registers as a blueprint and","// let `composeExtension` generate the `activate` that wires every surface in order,","// instead of hand-writing each `api.register*` call. `defineExtensionBlueprint`","// contract-checks the blueprint where it is authored. Keep `manifest.json`'s","// `capabilities` equal to the set this blueprint derives.","export const blueprint = defineExtensionBlueprint({",...r.blueprintFields," // `deactivate` is the teardown counterpart to the generated `activate`: pm runs"," // it on host shutdown/reload to release anything the package opened (timers,"," // connections, caches). This starter holds none, so it stays a no-op."," deactivate: () => {},","});","","// `composeExtension(blueprint)` is the package's default export \u2014 the runtime","// `ExtensionModule` pm loads. Guard the blueprint with `assertExtensionPreflight`","// in index.test.ts before publishing.","export default composeExtension(blueprint);",""].join(`
26
+ `)}function Aa(e,t,n,r){if(n==="commands")return[];let i=`${e}-search`,a=`${e}-vector`,o=`${e.replace(/-/g," ")} items`,s=e,c=`${e}s`,l=`${e.replace(/-/g,"_")}_note`,d=`${e}-0001-init`,u=[" const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${r},`," });"],m=p=>[...u," let deactivated = false;"," try {",...p.map(f=>f===""?f:` ${f}`)," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze];switch(n){case"hooks":return[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,...m([" // assertHook throws unless an after_command hook is registered, so reaching the"," // next line already proves the hook is wired.",` ext.assertHook({ kind: "after_command", extensionName: ${JSON.stringify(e)} });`," // runHook fires the hook through pm's real runner with a synthetic context and"," // returns the warnings it produced; a clean hook returns none."," const warnings = await ext.runHook({",' kind: "after_command",'," context: {",` command: ${JSON.stringify(t)},`," args: [],",' pm_root: "",'," ok: true,"," affected: [],"," },"," });"," assert.deepEqual(warnings, []);"]),"});",""];case"search":return[`test(${JSON.stringify(`${e} registers and invokes search primitives`)}, async () => {`,...m([` ext.assertSearchProvider({ name: ${JSON.stringify(i)}, extensionName: ${JSON.stringify(e)} });`,` ext.assertVectorStoreAdapter({ name: ${JSON.stringify(a)}, extensionName: ${JSON.stringify(e)} });`,""," // The starter provider reads only document title/id, so `settings` is a minimal"," // typed stub and `documents` carry just the fields it inspects."," const query = await ext.runSearchProvider({",` provider: ${JSON.stringify(i)},`,' operation: "query",'," context: {",' query: "sync",',' mode: "semantic",',' tokens: ["sync"],'," options: {},"," settings: {} as PmSettings,"," documents: [",' { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',' { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },'," ] as ItemDocument[],"," },"," });",' assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',""," const embedding = await ext.runSearchProvider({",` provider: ${JSON.stringify(i)},`,' operation: "embed",',' context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },'," });"," assert.deepEqual(embedding, [3]);",""," const vectorHits = await ext.runVectorStoreAdapter({",` adapter: ${JSON.stringify(a)},`,' operation: "query",'," context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },"," });",' assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);']),"});",""];case"importers":return[`test(${JSON.stringify(`${e} registers and invokes import/export primitives`)}, async () => {`,...m([` ext.assertImporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,` ext.assertExporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,""," const imported = await ext.runImporter({",` importer: ${JSON.stringify(o)},`,' options: { source: "tickets" },',' args: ["batch-1"],'," });"," assert.equal(imported.handled, true);",' assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',""," const exported = await ext.runExporter({",` exporter: ${JSON.stringify(o)},`,' options: { destination: "archive" },',' args: ["done"],'," });"," assert.equal(exported.handled, true);",' assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });']),"});",""];case"schema":return[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,...m(id({extensionName:e,itemTypeName:s,itemTypeFolder:c,fieldName:l,migrationId:d})),"});",""];case"profile":return[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,...m(ad(e)),"});",""];case"renderers":return[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,...m([" // assertRendererOverride throws unless a renderer is registered for the format,"," // so reaching the next line already proves the wiring.",` const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,' assert.equal(override.format, "toon");',""," // runRendererOverride renders through pm's real runner. The override customizes"," // only THIS package's command output and returns a string the host uses verbatim."," const rendered = await ext.runRendererOverride({",' format: "toon",',` command: ${JSON.stringify(t)},`," result: { ok: true },"," });"," assert.equal(rendered.overridden, true);"," assert.equal(rendered.rendered, JSON.stringify({ ok: true }));",""," // Output for any other command passes through to pm's default renderer."," const passthrough = await ext.runRendererOverride({",' format: "toon",',' command: "list",'," result: { ok: true },"," });"," assert.equal(passthrough.overridden, false);"]),"});",""];case"parser":return[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,...m([" // assertParserOverride throws unless a parser is registered for the command, so"," // reaching the next line already proves the wiring.",` ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,""," // runParserOverride runs the override through pm's real parser runner and returns"," // the rewritten context. The starter rewrites the deprecated `shout` alias to the"," // canonical `upper` flag."," const result = await ext.runParserOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: { shout: true },"," global: {},",' pm_root: "",'," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.context.options, { upper: true });",""," // End to end: feed the rewritten options into the command handler to prove"," // `pm <command> --shout` surfaces the normalized `upper` flag in the result.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`," upper: true,",' message: "Starter extension scaffold is active.",'," });"]),"});",""];case"preflight":return[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,...m([" // assertPreflightOverride throws unless a preflight override is registered, so"," // reaching the next line already proves the wiring.",` ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,""," // runPreflightOverride runs the override through pm's real runner with a synthetic"," // gate decision. The starter echoes the decision unchanged; replace the"," // values/assertions with your real policy."," const decision = {"," enforce_item_format_gate: true,"," run_preflight_item_format_sync: false,"," run_extension_migrations: true,"," enforce_mandatory_migration_gate: false,"," };"," const result = await ext.runPreflightOverride({",` command: ${JSON.stringify(t)},`," args: [],"," options: {},"," global: {},",' pm_root: "",'," decision,"," });"," assert.equal(result.overridden, true);"," assert.deepEqual(result.decision, decision);"]),"});",""];case"services":return[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,...m([" // assertServiceOverride throws unless a service override is registered for the"," // service, so reaching the next line proves the wiring.",` ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,""," // runServiceOverride runs the override through pm's real service runner. The"," // override customizes only THIS package's command output (handled), passing every"," // other command through (not handled)."," const handled = await ext.runServiceOverride({",' service: "output_format",',` command: ${JSON.stringify(t)},`," payload: { ok: true },"," });"," assert.equal(handled.handled, true);",` assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,""," // Output for any other command passes through to pm's default formatter."," const passthrough = await ext.runServiceOverride({",' service: "output_format",',' command: "list",'," payload: { ok: true },"," });"," assert.equal(passthrough.handled, false);"]),"});",""]}}function l_(e,t,n){let r=n==="parser",i=JSON.stringify([...od[n]].sort());return['import assert from "node:assert/strict";','import { test } from "node:test";','import { assertExtensionDeactivated, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, createExtensionTestHarness } from "@unbrained/pm-cli/sdk/testing";',...n==="search"?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension, { blueprint } from "./index.ts";','import manifest from "./manifest.json" with { type: "json" };',"",...rd,`test(${JSON.stringify(`${e} passes author-time preflight`)}, () => {`," // assertExtensionPreflight is the author-time capstone: it lints the blueprint,"," // synthesizes the least-privilege manifest from `identity`, and checks the version"," // bounds against `target` in one call, throwing on any blocking finding. It returns"," // the full report so you can inspect the derived data."," const report = assertExtensionPreflight(blueprint, {"," identity: {",` name: ${JSON.stringify(e)},`,' version: "0.1.0",',' entry: "./index.ts",'," priority: 0,",` pm_min_version: ${JSON.stringify(bt)},`," },",` target: { pmVersion: ${JSON.stringify(bt)} },`," });"," // Fail the starter suite whenever the checked-in manifest drifts from the"," // capabilities derived from the blueprint."," assertExtensionManifestMatchesBlueprint(manifest, blueprint);"," // The capability set is DERIVED from the blueprint, never hand-synced. Keep"," // manifest.json's `capabilities` equal to this list (set match, sorted).",` assert.deepEqual(report.capabilities, ${i});`,` assert.deepEqual(report.manifest?.capabilities, ${i});`,"});","",`test(${JSON.stringify(`${e} registers and runs its starter command`)}, async () => {`," // createExtensionTestHarness activates the composed module once and binds the"," // assert*/run*/deactivate helpers to the right activation sub-registry, so you"," // never thread activation.registrations vs activation.commands by hand."," // `capabilities` mirrors manifest.json so the in-memory activation grants what the"," // blueprint needs."," const ext = await createExtensionTestHarness(extension, {",` name: ${JSON.stringify(e)},`,` capabilities: ${i},`," });"," let deactivated = false;"," try {"," // assertCommandContract throws unless the command is registered, so reaching"," // the next line already proves the wiring; assert on the returned definition"," // to demonstrate inspecting registered metadata.",` const registered = ext.assertCommandContract({ name: ${JSON.stringify(t)} });`,' assert.equal(typeof registered.command.description, "string");',""," // runCommand invokes the handler through pm's real dispatch engine, so this"," // asserts behavior - not just that the command is wired. Replace these"," // assertions as you flesh out your command.",` const invocation = await ext.runCommand({ command: ${JSON.stringify(t)} });`," assert.equal(invocation.handled, true);"," assert.deepEqual(invocation.result, {"," ok: true,",` source: ${JSON.stringify(e)},`,` command: ${JSON.stringify(t)},`,...r?[" upper: false,"]:[],' message: "Starter extension scaffold is active.",'," });"," // deactivate runs pm's real teardown engine over the module; exactly one"," // extension tears down with no failures."," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});","",...Aa(e,t,n,i)].join(`
27
+ `)}function d_(e,t,n){let r=cd(n,"package"),i=ld(n,"package");return[`# ${e}`,"","Generated by `pm package init --declarative`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",r,`- \`index.ts\`: the TypeScript manifest entry \u2014 a \`defineExtensionBlueprint\` blueprint (${i_[n]}) composed into the runtime module by \`composeExtension\`, plus a \`deactivate\` teardown stub.`,"- `index.test.ts`: sample `node:test` suite covering author-time preflight (`assertExtensionPreflight`) and runtime surface invocation/teardown via `createExtensionTestHarness`.",sd,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Declarative Authoring","`index.ts` uses the SDK's declarative authoring loop instead of an imperative","`activate` body. You describe WHAT the package registers as an","`ExtensionBlueprint` and `composeExtension` generates the `activate` that wires","every surface in order:","- The `define*` builders author each surface with literal-type preservation and"," contextual handler inference (`defineCommand`, `defineSearchProvider`,"," `defineItemType`, `defineParserOverride`, ...).","- `defineExtensionBlueprint({ ... })` collects the definitions into the blueprint;",` this starter populates ${a_[n]}. Add more`," fields as the package grows.","- `composeExtension(blueprint)` is the default export \u2014 the runtime module pm"," loads. Its generated `activate` requires exactly the capabilities the blueprint"," derives, so `manifest.json`'s `capabilities` never drift.","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`index.test.ts` exercises both authoring capstones: `assertExtensionPreflight`","(the author-time lint + manifest synthesis + version-compatibility check over the","exported `blueprint`) and `createExtensionTestHarness` (the runtime fixture whose","`assert*`/`run*`/`deactivate` methods bind to the right activation sub-registry).","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.",...i,"","## Compatibility Bounds","`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Ea}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${bt}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
28
+ `)}function u_(e){let t=e,n=e.replace(/-/g,"");return{searchProviderName:`${e}-search`,vectorAdapterName:`${e}-vector`,adapterName:`${e.replace(/-/g," ")} items`,itemTypeName:t,itemTypeFolder:`${e}s`,itemTypeAliases:n===t?[]:[n],fieldName:`${e.replace(/-/g,"_")}_note`,migrationId:`${e}-0001-init`}}function m_(e){return["defineCommand",...e==="hooks"?["defineAfterCommandHook"]:[],...e==="search"?["defineSearchProvider","defineVectorStoreAdapter"]:[],...e==="importers"?["defineImporter","defineExporter"]:[],...e==="schema"?["defineItemType","defineItemField","defineMigration"]:[],...e==="profile"?["defineProjectProfile"]:[],...e==="renderers"?["defineRendererOverride"]:[],...e==="parser"?["defineParserOverride"]:[],...e==="preflight"?["definePreflightOverride"]:[],...e==="services"?["defineServiceOverride"]:[]].join(", ")}function p_(e,t,n,r){let i=["export const pingCommand = defineCommand({",` name: ${JSON.stringify(t)},`,' description: "Starter scaffold command. Replace with your own behavior.",',...n==="parser"?[" flags: [",' { long: "--shout", value_type: "boolean", description: "Deprecated alias for --upper." },',' { long: "--upper", value_type: "boolean", description: "Canonical flag the parser produces." },'," ],"," run: (context) => ({ ok: true, command: context.command, upper: context.options.upper === true }),"]:[" run: (context) => ({ ok: true, command: context.command }),"],"});"];return n==="hooks"&&i.push("","export const afterCommandHook = defineAfterCommandHook((context) => {"," if (!context.ok) return;"," // React to context.affected here as your package grows.","});"),n==="search"&&i.push("","export const searchProvider = defineSearchProvider({",` name: ${JSON.stringify(r.searchProviderName)},`," query: async (context) => ({"," hits: context.documents",' .filter((document) => String(document.metadata.title ?? "").toLowerCase().includes(context.query.toLowerCase()))',' .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: ["title"] })),'," }),"," embed: async (context) => [context.input.length],","});","","export const vectorStoreAdapter = defineVectorStoreAdapter({",` name: ${JSON.stringify(r.vectorAdapterName)},`,' query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],'," upsert: async (context) => ({ upserted: context.points.length }),"," delete: async (context) => ({ deleted: context.ids.length }),","});"),n==="importers"&&i.push("","export const importer = defineImporter(async (context) => ({"," imported: 1,",' source: context.options.source ?? "starter",'," args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({"," exported: true,",' destination: context.options.destination ?? "stdout",'," args: context.args,","}));"),n==="schema"&&i.push("",`export const noteField = defineItemField({ name: ${JSON.stringify(r.fieldName)}, type: "string", optional: true });`,"","export const itemType = defineItemType({",` name: ${JSON.stringify(r.itemTypeName)},`,` folder: ${JSON.stringify(r.itemTypeFolder)},`,` aliases: ${JSON.stringify(r.itemTypeAliases)},`," required_create_fields: [],","});","","export const initMigration = defineMigration({",` id: ${JSON.stringify(r.migrationId)},`,` description: ${JSON.stringify(`Initialize ${e} schema state.`)},`," mandatory: false,"," run: async (context) => ({ migrated: true, id: context.id }),","});"),n==="profile"&&i.push("","export const starterProfile = defineProjectProfile({",` name: ${JSON.stringify(e)},`,` title: ${JSON.stringify(`${e} archetype`)},`,' summary: "Starter project profile. Replace these dimensions with your own archetype.",'," types: [",` { name: ${JSON.stringify(r.itemTypeName)}, folder: ${JSON.stringify(r.itemTypeFolder)} },`," ],"," // ...plus statuses, fields, workflows, config, templates, and packages.","});"),n==="renderers"&&i.push("","export const toonRenderer = defineRendererOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => JSON.stringify(context.result),","});"),n==="parser"&&i.push("","export const pingParser = defineParserOverride((context) => {"," const options = { ...context.options };"," if (options.shout === true) options.upper = true;"," delete options.shout;"," return { options };","});"),n==="preflight"&&i.push("","// Return a delta of the gate-decision keys you want to change; returning","// context.decision unchanged is a safe no-op (e.g. { run_extension_migrations: false }).","export const preflightOverride = definePreflightOverride({",` commands: [${JSON.stringify(t)}],`," run: (context) => context.decision,","});"),n==="services"&&i.push("","export const outputService = defineServiceOverride((context) => {",` if (context.command !== ${JSON.stringify(t)}) return { handled: false };`,` return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),i}function f_(e,t,n){let r=[];return t==="renderers"&&r.push(' api.registerRenderer("toon", toonRenderer.run, toonRenderer);'),t==="parser"&&r.push(` api.registerParser(${JSON.stringify(e)}, pingParser);`),t==="preflight"&&r.push(" api.registerPreflight(preflightOverride);"),t==="services"&&r.push(' api.registerService("output_format", outputService);'),t==="hooks"&&r.push(" api.hooks.afterCommand(afterCommandHook);"),t==="search"&&r.push(" api.registerSearchProvider(searchProvider);"," api.registerVectorStoreAdapter(vectorStoreAdapter);"),t==="schema"&&r.push(" api.registerItemFields([noteField]);"," api.registerItemTypes([itemType]);"," api.registerMigration(initMigration);"),t==="profile"&&r.push(" api.registerProfile(starterProfile);"),t==="importers"&&r.push(` api.registerImporter(${JSON.stringify(n.adapterName)}, importer, {`,` action: ${JSON.stringify(`${n.adapterName} import`)},`,' description: "Import starter records into pm context.",'," flags: ["," {",' long: "--source",',' value_name: "name",',' value_type: "string",',' description: "Source name or path to import from.",'," },"," ],"," });",` api.registerExporter(${JSON.stringify(n.adapterName)}, exporter, {`,` action: ${JSON.stringify(`${n.adapterName} export`)},`,' description: "Export pm context into starter records.",'," flags: ["," {",' long: "--destination",',' value_name: "name",',' value_type: "string",',' description: "Destination name or path to export to.",'," },"," ],"," });"),r}function h_(e,t,n,r="commands",i=!1){let a=`pm-${e}`,o=od[r],s=r_(e,t,r),c=`${JSON.stringify({name:e,version:"0.1.0",entry:"./index.ts",manifest_version:Ea,pm_min_version:bt,trusted:!0,sandbox_profile:"strict",permissions:{...Gg},capabilities:o,...s.length>0?{activation:{commands:s}}:{}},null,2)}
29
+ `,l=['import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"","export function activate(api: ExtensionApi): void {",...t_(e,t,r),"}","","// `deactivate` is the teardown counterpart to `activate`: pm runs it on host","// shutdown/reload (e.g. the MCP server between requests) to release anything","// `activate` opened - timers, connections, caches. This starter holds no such","// resources, so it stays a documented no-op; add cleanup here as you grow.","export function deactivate(): void {}","","export default {"," activate,"," deactivate,","};",""].join(`
30
+ `),d=`${JSON.stringify(Hg,null,2)}
31
+ `,u=Vg[r],m=cd(r,"package"),p=`${JSON.stringify({name:a,version:"0.1.0",private:!0,type:"module",keywords:["pm-package"],engines:{node:qg},scripts:{typecheck:"tsc --noEmit","test:runtime":"node --test",test:"npm run typecheck && npm run test:runtime"},peerDependencies:{"@unbrained/pm-cli":`>=${bt}`},devDependencies:{"@types/node":Bg,typescript:Wg},pm:{aliases:[e],extensions:["."],docs:["README.md"],examples:["README.md"],catalog:{display_name:e,category:"workflow",summary:"Starter pm package scaffold.",tags:["starter"]}}},null,2)}
32
+ `,f=n_(e,t,r),g=Kg[r],h=["node_modules/","*.log","*.tsbuildinfo",""].join(`
33
+ `),w=u_(e),b=["```ts",`import { ${m_(r)} } from "@unbrained/pm-cli/sdk";`,'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"",...p_(e,t,r,w),"","export function activate(api: ExtensionApi): void {"," api.registerCommand(pingCommand);",...f_(t,r,w),"}","","export function deactivate(): void {}","","export default { activate, deactivate };","```"],x=[`# ${a}`,"","Generated by `pm package init` or `pm extension init`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",m,u,g,sd,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.","","## Authoring With define* Builders","`index.ts` is authored fully in TypeScript so every registration is checked","against the SDK contracts at author time. Use the public SDK authoring","builders for exported definitions you want literal-type preservation,","contextual handler inference, and direct unit tests for:",...b,"The builders return their argument unchanged; runtime validation still lives","in `api.register*`, and behavior validation lives in `sdk/testing`.",...Yg[r],...ld(r,"package"),"","## Compatibility Bounds",`- \`peerDependencies["@unbrained/pm-cli"]\` uses the stable range \`>=${bt}\`. Keep a normal stable range instead of pinning a date ordinal: SemVer excludes prerelease ordinals such as \`2026.7.24-3\`, while daily stable releases continue to satisfy the range.`,"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Ea}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${bt}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
34
+ `);return{"package.json":p,"manifest.json":c,"index.ts":i?c_(e,t,r):l,"index.test.ts":i?l_(e,t,r):f,"tsconfig.json":d,".gitignore":h,"README.md":i?d_(a,t,r):x}}async function ud(e,t="extension",n="commands",r=!1){let i=n.trim().toLowerCase();if(!nd.includes(i))throw new y(`Unknown scaffold capability "${n}". Supported capabilities: ${nd.join(", ")}.`,_.USAGE);let a=i;if(r&&t!=="package")throw new y("--declarative scaffolds a package-mode blueprint starter (composeExtension is a runtime SDK import). Use `pm package init`, not `pm extension init`.",_.USAGE);let o=r?"declarative":"imperative",s=e.trim(),c=xn.resolve(process.cwd(),s),l=Or(xn.basename(c)).replace(/^(?:pm-)+/u,""),d=e_(l),u=h_(l,d,t,a,r),m=!1;if(await A(c)){if(!(await kn.stat(c)).isDirectory())throw new y(`Scaffold target "${c}" exists and is not a directory.`,_.CONFLICT)}else await kn.mkdir(c,{recursive:!0}),m=!0;for(let[f,g]of Object.entries(u)){let h=xn.join(c,f);if(!await A(h))continue;if(await kn.readFile(h,"utf8")!==g)throw new y(`Scaffold file "${f}" already exists with different content in "${c}". Choose a new target path or remove conflicting files.`,_.CONFLICT)}let p=[];for(let[f,g]of Object.entries(u)){let h=xn.join(c,f);if(await A(h)){p.push({path:f,status:"unchanged"});continue}await kn.mkdir(xn.dirname(h),{recursive:!0}),await kn.writeFile(h,g,"utf8"),p.push({path:f,status:"created"})}return{extension_name:l,package_name:`pm-${l}`,command_name:d,invocation_command:`pm ${d}`,capability:a,style:o,target_path:c,created_directory:m,files:p}}(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]="536ed530-7726-50ab-bb2d-ace030818f1d")}catch{}})();function md(e,t){return`${e}:${S(t)}`}function g_(e,t){let n=[];for(let[r,i]of[["handler",e.commands.handlers],["override",e.commands.overrides]]){let a=new Map;for(let o of i){let s=a.get(o.command)??[];a.set(o.command,[...s,o])}for(let[o,s]of a){if(t!==null&&!s.some(l=>t.has(S(l.name))))continue;let c=s.at(-1);n.push({command:o,surface:r,policy:"last_activated_wins",collision:s.length>1,claimants:s.map(l=>({name:l.name,layer:l.layer,winner:l===c}))})}}return n.sort((r,i)=>r.command.localeCompare(i.command)||r.surface.localeCompare(i.surface))}function pd(e,t,n){let r=new Set(n.failed.map(l=>md(l.layer,l.name))),i=[...t.loaded.map(l=>({name:l.name,layer:l.layer,version:l.version,activation_status:r.has(md(l.layer,l.name))?"failed":"ok",surfaces:zt(n,{extensionName:l.name})})),...t.failed.map(l=>({name:l.name,layer:l.layer,version:"unknown",activation_status:"not_loaded",surfaces:zt(n,{extensionName:l.name})}))].sort((l,d)=>l.name.localeCompare(d.name)||l.layer.localeCompare(d.layer)),a=typeof e=="string"?S(e):null,o=a===null?null:new Set(t.loaded.filter(l=>S(l.name)===a||typeof l.source_package=="string"&&S(l.source_package)===a||(l.source_aliases??[]).some(d=>S(d)===a)).map(l=>S(l.name)).concat(a)),s=o===null?i:i.filter(l=>o.has(S(l.name))),c=o===null?{}:{extensionNames:[...o]};return{target:typeof e=="string"?e.trim():null,total:s.length,extensions:s,union:zt(n,c),command_ownership:g_(n,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]="54ce5bae-db04-5c19-81df-093802bf41c7")}catch{}})();function Ra(e){return e.map(({layer:t,name:n,error:r})=>({layer:t,name:n,error:r}))}function Fr(e,t,n){let r=S(t),i=n.trim();if(r.length===0||i.length===0)return;let a=e.get(r)??new Set;a.add(i),e.set(r,a)}function __(e){let t=new Map,n=new Map;for(let r of e.registrations.commands)Fr(t,r.name,r.command),Fr(n,r.name,r.action);for(let r of e.commands.handlers)Fr(t,r.name,r.command);for(let r of e.commands.overrides)Fr(t,r.name,r.command);return{commandPathsByExtension:t,actionPathsByExtension:n}}function fd(e){if(!(!e||e.size===0))return[...e].sort((t,n)=>t.localeCompare(n))}function y_(e){let{enabled:t,normalizedName:n,loadedNames:r,loadFailedNames:i,activationFailedNames:a}=e;return t?i.has(n)||a.has(n)?{runtime_active:!1,activation_status:"failed"}:r.has(n)?{runtime_active:!0,activation_status:"ok"}:{runtime_active:!1,activation_status:"not_loaded"}:{runtime_active:!1,activation_status:"not_loaded"}}function jr(e,t,n){let r=new Set(t.loaded.map(c=>S(c.name))),i=new Set(t.failed.map(c=>S(c.name))),a=new Set(n.failed.map(c=>S(c.name))),{commandPathsByExtension:o,actionPathsByExtension:s}=__(n);return e.map(c=>{let l=S(c.name),d=fd(o.get(l)),u=fd(s.get(l)),m={...d?{command_paths:d}:{},...u?{action_paths:u}:{}},p=y_({enabled:c.enabled,normalizedName:l,loadedNames:r,loadFailedNames:i,activationFailedNames:a});return{...c,...p,...m}})}function w_(e){let t=0,n=0,r=0;for(let i of e)if(i.startsWith("extension_policy_")){if(t+=1,i.startsWith("extension_policy_violation_")){n+=1;continue}i.startsWith("extension_policy_blocked_")&&(r+=1)}return{warning_count:t,violation_count:n,blocked_count:r}}function ce(e,t){return e.vocabulary==="package"?`pm package --${t}`:`pm extension --${t}`}var _d=new Set(["extension_command_handler_collision","extension_command_override_collision","extension_command_override_handler_overlap","extension_parser_override_collision","extension_preflight_override_collision","extension_renderer_collision","extension_service_override_collision"]);function v_(e){return _d.has(xd(e))}function hd(e){return e==="project"||e==="global"}function yd(e){let t=e.split(":"),n=t[0];if(!n||!_d.has(n))return null;let r=t.at(-4),i=t.at(-3)?.trim(),a=t.at(-2),o=t.at(-1)?.trim();return!hd(r)||!hd(a)||!i||!o?null:{code:n,surface:t.slice(1,-4).join(":")||"global",winner:{layer:r,name:i},displaced:{layer:a,name:o}}}function b_(e){let t=new Set;for(let n of e){let r=yd(n);r&&(t.add(r.winner.name),t.add(r.displaced.name))}return[...t].sort((n,r)=>n.localeCompare(r))}function Ia(e,t){let n=e.filter(v_);if(n.length===0)return null;let r=b_(n);return`Extension registration collisions or handler/override overlaps detected.${r.length>0?` Conflicting extensions: ${r.join(", ")}.`:""} Single-winner surfaces can hide earlier package behavior. Deactivate one conflicting package with ${t.deactivate}, or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${t.doctor}.`}function k_(e,t,n,r){let i=t.map(u=>yd(u)).filter(u=>u!==null).sort((u,m)=>`${u.code}:${u.surface}:${u.winner.name}:${u.displaced.name}`.localeCompare(`${m.code}:${m.surface}:${m.winner.name}:${m.displaced.name}`));if(i.length===0)return;let a=e==="global"?"--global":"--project",o=ce(r,"deactivate"),s=`${ce(r,"doctor")} ${a} --detail deep --trace`,c=new Map(n.map(u=>[S(u.name),u])),l=new Map;for(let u of i)for(let m of[u.winner.name,u.displaced.name]){let p=S(m);l.set(p,(l.get(p)??0)+1)}let d=[...l.entries()].map(([u,m])=>{let p=c.get(u),f=p?.name??u,g=p?.command_paths??[],h=p?.action_paths??[];return{action:"deactivate",extension:f,command:`${o} ${f} ${a}`,affected_collisions:m,feature_loss:{command_paths:[...g].sort((w,v)=>w.localeCompare(v)),action_paths:[...h].sort((w,v)=>w.localeCompare(v))}}}).sort((u,m)=>{let p=m.affected_collisions-u.affected_collisions;if(p!==0)return p;let f=u.feature_loss.command_paths.length+u.feature_loss.action_paths.length,g=m.feature_loss.command_paths.length+m.feature_loss.action_paths.length;return f!==g?f-g:u.extension.localeCompare(m.extension)});return{status:"conflicts_detected",collision_count:i.length,extension_count:l.size,next_best_command:s,collisions:i,remediation_candidates:d}}function wd(e){let t=[];for(let n of e){let r=n.error.toLowerCase();(r.includes("cannot find package '@unbrained/pm-cli'")||r.includes('cannot find module "@unbrained/pm-cli"')||r.includes("cannot find module '@unbrained/pm-cli'"))&&t.push(`extension_load_failed_sdk_dependency_missing:${n.name}`),(r.includes("cannot use import statement outside a module")||r.includes("to load an es module")||r.includes("must use import to load es module"))&&t.push(`extension_load_failed_module_mode_mismatch:${n.name}`)}return[...new Set(t)].sort((n,r)=>n.localeCompare(r))}function vd(e=[]){let t=Array.isArray(e)?e:[],n=[];for(let r of t){if(!r||typeof r.name!="string")continue;let i=r.trace?.missing_capability??r.trace?.capability;typeof i=="string"&&i.trim().length>0&&n.push(`extension_capability_missing:${r.name}:${i.trim().toLowerCase()}`)}return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}function bd(e,t){let n=[];for(let r of ls(e.loaded,t))for(let i of r.unused)n.push(`extension_capability_unused:${r.layer}:${r.name}:${i}`);return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}var x_=[{matches:e=>e.some(t=>t.startsWith("extension_manifest_")),build:e=>`Run ${ce(e.options,"explore")} ${e.scopeFlag} to inspect discovered manifests and directories.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unknown:")),build:()=>`Unknown extension capabilities detected. Allowed capabilities: ${Fn.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_legacy_alias:")),build:()=>"Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."},{matches:e=>e.some(t=>t.startsWith("extension_capability_missing:")),build:e=>`Extension activation failed because code registered a surface missing from manifest capabilities. Run ${ce(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unused:")),build:e=>`Extension manifests declare capabilities that are never registered against. Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${ce(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace for per-extension registration counts.`},{matches:e=>e.some(t=>t.startsWith("extension_command_definition_legacy_handler_alias:")),build:()=>"Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."},{matches:e=>e.some(t=>t.startsWith("extension_output_service_override_global:")||t.startsWith("extension_output_renderer_override_global:")),build:()=>"Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering."},{matches:e=>e.some(t=>t.startsWith("extension_schema_narrow_activation:")),build:()=>"A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or \u2014 if the schema is intentionally command-scoped \u2014 knowingly ignore this advisory."},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_sdk_dependency_missing:")),build:e=>`Detected extension load failures caused by missing SDK dependency resolution. Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${ce(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_module_mode_mismatch:")),build:e=>`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" or use an explicit .mjs entry and rerun ${ce(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_pm_min_version_")||t.startsWith("extension_pm_max_version_")),build:e=>`Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${ce(e.options,"doctor")} ${e.scopeFlag}.`},{matches:(e,t)=>t.updateCheckFailedTotal>0,build:e=>`Run ${ce(e.options,"manage")} ${e.scopeFlag} after validating network and repository access.`},{matches:e=>e.some(t=>t.startsWith("extension_manager_state_")),build:e=>`Review and repair ${e.scope} managed extension state file if schema/read warnings persist.`},{matches:(e,t)=>t.policyWarningCount>0,build:()=>"Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces."}];function S_(e){let{normalizedWarnings:t,options:n,scope:r,scopeFlag:i,updateCheckFailedTotal:a,policyWarningCount:o,updateHealthPartial:s,skippedUnmanagedTotal:c,skippedNonGithubTotal:l,updateAvailableTotal:d}=e,u=[],m={options:n,scope:r,scopeFlag:i,updateCheckFailedTotal:a,policyWarningCount:o};if(t.length>0){let p=Ia(t,{deactivate:`${ce(n,"deactivate")} <name> ${i}`,doctor:`${ce(n,"doctor")} ${i} --detail deep --trace`});p&&u.push(p);for(let f of x_)f.matches(t,m)&&u.push(f.build(m))}return s?u.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${ce(n,"manage")} ${i} --fix-managed-state (or ${ce(n,"adopt-all")} ${i}, ${ce(n,"adopt")} <name> ${i}, or reinstall via ${ce(n,"install")} ${i} <source>).`):c>0&&u.push(`Loaded unmanaged extensions are currently treated as informational. Use ${ce(n,"manage")} ${i} --fix-managed-state to adopt them for update checks.`),l>0&&u.push("Non-GitHub managed extensions are skipped by update checks. Use doctor output for non-update diagnostics."),d>0&&u.push(`Update available managed extensions via ${ce(n,"install")} ${i} <source>.`),u.length===0&&u.push(`No immediate action required. Re-run ${ce(n,"manage")} ${i} after extension changes.`),u}function Ur(e,t,n,r={}){let i=[...new Set(t)].sort((E,U)=>E.localeCompare(U)),a=n.filter(E=>E.managed).length,o=n.filter(E=>E.enabled).length,s=n.filter(E=>E.active).length,c=n.filter(E=>E.update_available===!0).length,l=n.filter(E=>E.managed===!1),d=l.filter(E=>gd(E)).map(E=>E.name).sort((E,U)=>E.localeCompare(U)),u=l.filter(E=>!gd(E)).map(E=>E.name).sort((E,U)=>E.localeCompare(U)),m={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(let E of n)m[E.update_check_status]+=1;let p=m.failed,f=m.skipped_unmanaged,g=m.skipped_non_github,h=u.length>0,w=h?"partial":"full",v=h?[`extension_update_health_partial_coverage:skipped_unmanaged:${u.length}`]:[],b=[...new Set([...i,...v])].sort((E,U)=>E.localeCompare(U)),x=[...new Set(b.map(E=>xd(E)))].sort((E,U)=>E.localeCompare(U)),R=w_(b),k=e==="global"?"--global":"--project",F=k_(e,i,n,r),T=S_({normalizedWarnings:i,options:r,scope:e,scopeFlag:k,updateCheckFailedTotal:p,policyWarningCount:R.warning_count,updateHealthPartial:h,skippedUnmanagedTotal:f,skippedNonGithubTotal:g,updateAvailableTotal:c});return{status:b.length===0?"ok":"warn",warning_count:b.length,warning_codes:x,warnings:b,policy_warning_count:R.warning_count,policy_violation_count:R.violation_count,policy_blocked_count:R.blocked_count,total_extensions:n.length,managed_total:a,enabled_total:o,active_total:s,update_available_total:c,update_health_coverage:w,update_health_partial:h,unmanaged_loaded_extension_count:l.length,unmanaged_loaded_extensions:l.map(E=>E.name).sort((E,U)=>E.localeCompare(U)),unmanaged_expected_extension_count:d.length,unmanaged_expected_extensions:d,unmanaged_action_required_extension_count:u.length,unmanaged_action_required_extensions:u,update_check_status_totals:m,update_check_failed_total:p,top_warnings:b.slice(0,8),remediation:T,...F?{collision_plan:F}:{}}}function kd(e){if(!e||e.trim().length===0)return"summary";let t=e.trim().toLowerCase();if(t==="summary"||t==="deep")return t;throw new y(`Invalid --detail value "${e}". Expected summary or deep.`,_.USAGE)}function xd(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function Sn(e){let t=new Set,n=[];for(let r of e){let i=(()=>{let a=$o(r);return a?[a]:To(r)})();for(let a of i){let o=`${a.layer}:${a.name}:${a.capability}`;t.has(o)||(t.add(o),n.push(a))}}return n}function En(){return{version:jn.version,capabilities:[...jn.capabilities],legacy_aliases:{...jn.legacy_aliases}}}function gd(e){let t=S(e.name),n=S(e.directory);return t.startsWith("builtin-")?!0:n==="beads"||n==="todos"}function Sd(e,t,n,r,i){if(e!=="project"||i)return{warnings:[],summary:{active_project_count:0,loaded_project_count:0,active_project_names:[],loaded_project_names:[],missing_active_project_names:[]}};let a=[...new Set(t.filter(d=>d.active).map(d=>S(d.name)))].sort((d,u)=>d.localeCompare(u)),o=[...new Set(n.filter(d=>d.layer==="project").map(d=>S(d.name)))].sort((d,u)=>d.localeCompare(u)),s=new Set(r.map(d=>S(d.name))),c=a.filter(d=>!o.includes(d)&&!s.has(d)).sort((d,u)=>d.localeCompare(u));return{warnings:c.length>0?[`extension_doctor_consistency_active_not_loaded:${c.join(",")}`]:[],summary:{active_project_count:a.length,loaded_project_count:o.length,active_project_names:a,loaded_project_names:o,missing_active_project_names:c}}}import{randomUUID as E_}from"node:crypto";import ne from"node:fs/promises";import A_ from"node:os";import J from"node:path";(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]="263602a2-c000-5df7-80d2-6f095985496f")}catch{}})();var Ed=3,R_=120,Ad=250,I_=12e4,C_=new Set(["EEXIST","ENOTEMPTY","ENOENT"]),Rd=e=>typeof e=="object"&&e!==null&&"code"in e?e.code:void 0,Id=e=>C_.has(String(Rd(e))),zr=(e,t)=>Rd(e)===t,Cd=e=>new Promise(t=>{setTimeout(t,e)}),$d=async e=>{let t=J.join(e,"package.json");await A(t)||await ne.writeFile(t,`${JSON.stringify({type:"module"},null,2)}
35
+ `,"utf8")},Td=async e=>{let t=Ee(import.meta.url,["../../.."]),n=J.join(e,"node_modules","@unbrained"),r=J.join(n,"pm-cli");await ne.mkdir(n,{recursive:!0}),await ne.rm(r,{recursive:!0,force:!0}),await ne.symlink(t,r,process.platform==="win32"?"junction":"dir")},Ca=async e=>{let t=J.resolve(e),n=J.dirname(t),r=J.parse(n).root,i=await ne.realpath(r).catch(()=>r),a=J.relative(r,n),o=a===""?[]:a.split(J.sep);for(let[s,c]of o.entries()){let l=J.join(i,c);try{i=await ne.realpath(l)}catch{i=J.join(i,...o.slice(s));break}}return J.join(i,J.basename(t))},Od=async(e,t,n,r=A_.tmpdir())=>{let i=J.resolve(e),a=await ne.realpath(i).catch(()=>i),o=await Ca(t);if(a===o)return;if(!ye(a,o)){await n(e,t,{recursive:!0,force:!0});return}let s=m=>{let p=J.resolve(m);if(p!==i&&!ye(i,p))return!1;let f=J.resolve(a,J.relative(i,p));if(f===o||ye(o,f))return!1;let h=J.relative(a,f).split(J.sep);return h.some(w=>w==="node_modules"||w.startsWith(".pm-extension-install-backup-"))?!1:h[0]!==".agents"},c=await ne.realpath(J.resolve(r)).catch(()=>Ca(r)),l=ye(a,c)?J.dirname(a):c;if(ye(a,l))throw new y(`Extension source "${e}" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,_.USAGE,{code:"extension_install_source_contains_destination"});let d=await ne.mkdtemp(J.join(l,"pm-extension-copy-")),u=J.join(d,"extension");try{await n(e,u,{recursive:!0,force:!0,filter:s}),await n(u,t,{recursive:!0,force:!0})}finally{await ne.rm(d,{recursive:!0,force:!0})}},Dd=async(e,t,n=ne.cp)=>{for(let r=1;r<=Ed;r+=1)try{await ne.rm(t,{recursive:!0,force:!0}),await Od(e,t,n);return}catch(i){if(!Id(i)||r===Ed)throw i;await Cd(Ad)}},$a=async e=>{let t;try{t=await ne.readFile(J.join(e,"owner.json"),"utf8")}catch(i){if(!zn(i))throw i;return null}let n;try{n=JSON.parse(t)}catch{return null}if(typeof n!="object"||n===null||!("token"in n))return null;let r=n.token;return typeof r=="string"&&r.length>0?r:null},Pd=async(e,t)=>await $a(e)!==t?!1:(await ne.rm(e,{recursive:!0,force:!0}),!0),$_=async(e,t)=>{let n;try{n=await ne.stat(e)}catch{return!1}if(Date.now()-n.mtimeMs<=t)return!1;let r=await $a(e);return r===null?(await ne.rm(e,{recursive:!0,force:!0}),!0):Pd(e,r)},T_=(e,t,n)=>{let r=Promise.resolve(),i=setInterval(()=>{r=r.then(async()=>{if(await $a(e)!==t)return;let a=new Date;await ne.utimes(e,a,a)}).catch(()=>{})},n);return i.unref(),async()=>{clearInterval(i),await r}},O_=async(e,t)=>{await ne.mkdir(e);try{await ne.writeFile(J.join(e,"owner.json"),`${JSON.stringify(t,null,2)}
36
+ `,"utf8")}catch(n){throw await ne.rm(e,{recursive:!0,force:!0}).catch(()=>{}),n}},D_=async(e,t,n,r,i)=>{for(let a=1;a<=n;a+=1)try{return await O_(e,t),!0}catch(o){if(!zr(o,"EEXIST"))throw o;await $_(e,i)?a-=1:await Cd(r)}return!1},Ta=async(e,t,n,r)=>{let i=J.join(e,"runtime","extension-install-locks"),a=J.join(i,"scope.lock");await ne.mkdir(i,{recursive:!0});let{attempts:o=R_,delay_ms:s=Ad,stale_ms:c=I_,heartbeat_ms:l}=r??{};if(![o,s,c,l].filter(w=>w!==void 0).every(Number.isFinite))throw new y("Extension install lock timings must be finite numbers.",_.USAGE);let d=Math.max(1,Math.floor(o)),u=Math.max(0,Math.floor(s)),m=Math.floor(c),p=Math.floor(l??m/3);if(m<=0||p<=0||p>=m)throw new y("Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.",_.USAGE);let f={pid:process.pid,token:E_(),created_at:$(),destination:t};if(!await D_(a,f,d,u,m))throw new y(`Timed out waiting for extension install lock for "${t}".`,_.CONFLICT);let h=T_(a,f.token,p);try{return await n()}finally{await h(),await Pd(a,f.token).catch(()=>!1)}};(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]="4d3c62e9-9116-5cdc-bbda-48bbd2e39476")}catch{}})();var Nd=async(e,t,n)=>{if(!Number.isInteger(t)||t<1)throw new RangeError("concurrency must be a positive integer");let r=new Array(e.length),i=0,a=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,r[o]=await n(e[o])}});return await Promise.all(a),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]="b17dfc10-9e07-5912-b294-c5663133f192")}catch{}})();function Md(e,t){let n=S(e),r=t.find(i=>S(i.name)===n);return{command_paths:[...r?.command_paths??[]].sort((i,a)=>i.localeCompare(a)),action_paths:[...r?.action_paths??[]].sort((i,a)=>i.localeCompare(a))}}(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]="0dc7b063-dc72-595f-8e40-8a06f9db69e1")}catch{}})();function Ld(e,t){let n=new Set((t?.loaded??[]).flatMap(a=>(a.activation?.commands?.length??0)>0?[`${a.layer}:${S(a.name)}`]:[])),r=e.services.overrides.filter(a=>a.service==="output_format").filter(a=>!n.has(`${a.layer}:${S(a.name)}`)).map(a=>`extension_output_service_override_global:${a.service}:${a.layer}:${a.name}`),i=e.renderers.overrides.filter(a=>(a.commands?.length??0)===0&&a.resultDiscriminator===void 0).map(a=>`extension_output_renderer_override_global:${a.format}:${a.layer}:${a.name}`);return[...new Set([...r,...i])].sort((a,o)=>a.localeCompare(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]="17145dd7-3938-5f20-b5b5-49f8d38d3d8d")}catch{}})();var Fd=e=>[...e.registrations.item_fields.flatMap(t=>t.fields.map(n=>({layer:t.layer,extension:t.name,field:n.name}))),...e.registrations.profiles.flatMap(t=>t.profile.fields.map(n=>({layer:t.layer,extension:t.name,field:n.key??""})))].flatMap(t=>{let n=Kn(t.field);return n?[`extension_custom_field_mcp_input_collision:${t.layer}:${t.extension}:${n.field}:${n.property}:${n.owner}:use=${n.nested_path}`]:[]}).filter((t,n,r)=>r.indexOf(t)===n).sort((t,n)=>t.localeCompare(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]="ccb857a5-045d-57a7-91d2-b761225fe53a")}catch{}})();var P_=1e4,N_=(e,t,n)=>{let r=e.split(/\r?\n/).map(o=>o.trim()).filter(Boolean).map(o=>{let[s,c=""]=o.split(/\s+/);return{commit:s,ref:c}}),i=r.find(o=>o.ref.endsWith("^{}"))??r[0];if(!i)return{checked_at:n,available:null,error:"no_remote_reference_found"};let a=t?.trim();return a?{checked_at:n,remote_commit:i.commit,available:i.commit!==a}:{checked_at:n,remote_commit:i.commit,available:null,error:"missing_installed_commit"}},jd=async(e,t=Nr)=>{let n=$();if(e.kind!=="github"||!e.repository)return{checked_at:n,available:null,error:"not_a_github_managed_source"};try{let r=[e.ref?.trim(),"HEAD"].find(Boolean),i=await t(["ls-remote",e.repository,r,`${r}^{}`],void 0,P_);return N_(i,e.commit,n)}catch(r){return{checked_at:n,available:null,error:r instanceof Error?r.message:String(r)}}};import M_ from"node:fs/promises";import L_ from"node:path";(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]="56290db9-933c-590d-8b9f-df62ff45e515")}catch{}})();function Oa(e){return L_.join(e,"extension-migrations.json")}function Ud(e,t){let n=e.definition.id;return typeof n=="string"&&n.trim().length>0?n.trim():`migration-${String(t+1).padStart(3,"0")}`}function zd(e,t){return`${e.layer}:${e.name}:${t}`}async function F_(e){let t=Oa(e);if(!await A(t))return{version:1,updated_at:"",entries:[]};let n=JSON.parse(await M_.readFile(t,"utf8"));return{version:1,updated_at:typeof n.updated_at=="string"?n.updated_at:"",entries:Array.isArray(n.entries)?n.entries.filter(r=>typeof r?.key=="string"&&(r.status==="applied"||r.status==="failed")):[]}}async function Da(e,t){let n=await F_(e),r=new Map(n.entries.map(i=>[i.key,i]));return t.forEach((i,a)=>{let o=Ud(i,a),s=r.get(zd(i,o));s&&(i.definition.status=s.status,s.status==="failed"?i.definition.reason=s.error:(delete i.definition.reason,delete i.definition.error,delete i.definition.message))}),n}async function j_(e){let t=await Da(e.pmRoot,e.migrations),n=new Map(t.entries.map(d=>[d.key,d])),r=[],i=!1,a=e.migrations.map((d,u)=>({migration:d,index:u})).filter(({migration:d})=>e.scope===void 0||d.layer===e.scope);for(let{migration:d,index:u}of a){let m=Ud(d,u),p=zd(d,m),f=n.get(p),g=String(d.definition.status??"pending").toLowerCase(),h=f?.status??(g==="applied"||g==="failed"?g:"pending");if(h==="applied"){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"skipped"});continue}if(e.dryRun===!0){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"pending"});continue}let w=d.runtime_definition?.run??d.definition.run;if(typeof w!="function"){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"pending"});continue}let v=new Date().toISOString();try{await Promise.resolve(w({id:m,command:"migration",layer:d.layer,extension:d.name,pm_root:e.pmRoot,status:h}));let b={key:p,layer:d.layer,extension:d.name,id:m,status:"applied",attempted_at:v};n.set(p,b),d.definition.status="applied",delete d.definition.reason,delete d.definition.error,delete d.definition.message,r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"applied"}),i=!0}catch(b){let x=b instanceof Error?b.message:String(b),R={key:p,layer:d.layer,extension:d.name,id:m,status:"failed",attempted_at:v,error:x};n.set(p,R),d.definition.status="failed",d.definition.reason=x,r.push({key:p,layer:d.layer,extension:d.name,id:m,before:h,outcome:"failed",error:x}),i=!0}}if(i){let d=await I(e.pmRoot),u={version:1,updated_at:new Date().toISOString(),entries:[...n.values()].sort((m,p)=>m.key.localeCompare(p.key))};await ar({pmRoot:e.pmRoot,filePath:Oa(e.pmRoot),raw:`${JSON.stringify(u,null,2)}
37
+ `,op:"extension_migrations_apply",author:e.author,lockTtlSeconds:d.locks.ttl_seconds,lockWaitMs:d.locks.wait_ms})}let o=r.filter(d=>d.outcome==="pending").length,s=r.filter(d=>d.outcome==="applied").length,c=r.filter(d=>d.outcome==="skipped").length,l=r.filter(d=>d.outcome==="failed").length;return{ok:l===0,dry_run:e.dryRun===!0,state_path:Oa(e.pmRoot),total:r.length,pending_count:o,applied_count:s,skipped_count:c,failed_count:l,migrations:r}}async function qd(e){let t=await I(e.resolvedRoots.settings_root),n=await Ne({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),r=await Me(n);e.warnings.push(...n.warnings,...r.warnings);let i=await j_({pmRoot:e.resolvedRoots.pm_root,migrations:r.registrations.migrations,author:typeof e.global.author=="string"&&e.global.author.trim().length>0?e.global.author.trim():"pm-extension-migration",dryRun:e.options.dryRun===!0,...e.scope==="global"?{scope:"global"}:{}});return e.withResult({migration:i,load_failure_count:n.failed.length,activation_failure_count:r.failed.length},i.ok)}(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]="39bc7f14-2d32-5b58-97ab-647f9f238273")}catch{}})();async function Gd(e,t,n){let r=typeof t=="string"?null:await vn(e),i=r===null?null:e.trim().toLowerCase(),a=i===null?null:await Gl(i),o=Lr(r??e,{forceGithub:typeof t=="string",ref:n}),s=i===null?null:await Hl(e);return{bundledAliasName:i,bundledPackageName:a,installSource:o,sourceResolution:{requested:e,selected:{kind:i===null?o.kind:"builtin",input:i??o.input,...a===null?{}:{package:a}},ambiguous:s!==null,precedence:"bundled_alias_before_installed_npm",candidates:[...i===null?[]:[{kind:"builtin",input:i,...a===null?{}:{package:a},command:`pm install ${i}`}],...s===null?[]:[{kind:"npm",input:`npm:${s.package}`,package:s.package,...s.version===void 0?{}:{version:s.version},directory:s.directory,command:`pm install npm:${s.package}`}]]}}}import kt from"node:fs/promises";import U_ from"node:path";(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]="98b47a2f-d48a-5c90-8b88-3f33bdd1c826")}catch{}})();var Pa=async e=>kt.readFile(e).catch(t=>{if(zr(t,"ENOENT"))return null;throw t}),Wd=async(e,t,n,r,i)=>{let a=_n(e),o=K(t),[s,c]=await Promise.all([Pa(a),Pa(o)]);return r&&await kt.cp(n,i,{recursive:!0,force:!0}),{backupDirectory:i,destinationDirectory:n,destinationExists:r,managedStatePath:a,managedStateContents:s,settingsPath:o,settingsContents:c}},Bd=async e=>{await kt.rm(e.destinationDirectory,{recursive:!0,force:!0}),e.destinationExists&&await kt.cp(e.backupDirectory,e.destinationDirectory,{recursive:!0,force:!0});for(let[t,n]of[[e.managedStatePath,e.managedStateContents],[e.settingsPath,e.settingsContents]])n===null?await kt.rm(t,{force:!0}):(await kt.mkdir(U_.dirname(t),{recursive:!0}),await kt.writeFile(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]="8b0fbe09-2221-5b8e-8712-90a83df19306")}catch{}})();var z_=4,Kd=[["install","install","--install"],["uninstall","uninstall","--uninstall"],["explore","explore","--explore"],["list","explore","--explore"],["manage","manage","--manage"],["describe","describe","--describe"],["reload","reload","--reload"],["doctor","doctor","--doctor"],["catalog","catalog","--catalog"],["init","init","--init"],["scaffold","init","--scaffold"],["adopt","adopt","--adopt"],["adopt-all","adopt-all","--adopt-all"],["activate","activate","--activate"],["deactivate","deactivate","--deactivate"],["migrate","migrate","--migrate"]],q_=Kd.map(([,,e])=>e).filter((e,t,n)=>n.indexOf(e)===t).join(", "),G_={install:"--install",uninstall:"--uninstall",explore:"--explore",manage:"--manage",describe:"--describe",reload:"--reload",doctor:"--doctor",catalog:"--catalog",adopt:"--adopt","adopt-all":"--adopt-all",activate:"--activate",deactivate:"--deactivate",migrate:"--migrate",init:"--init"},W_="__pm_native_output",B_=["trusted_extensions","allowed_extensions","blocked_extensions","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],Yd=["allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],H_=["disabled","require_trusted","require_provenance"],Xd={mode:"off",trust_mode:"off",require_provenance:!1,trusted_extensions:[],default_sandbox_profile:"none",allowed_extensions:[],blocked_extensions:[],allowed_capabilities:[],blocked_capabilities:[],allowed_surfaces:[],blocked_surfaces:[],allowed_commands:[],blocked_commands:[],allowed_actions:[],blocked_actions:[],allowed_services:[],blocked_services:[],extension_overrides:[]},J_=e=>{let t=e??Xd,n={};for(let r of B_)n[r]=ke(t[r]??[]);return n},V_=(e,t)=>{for(let n of Yd)t[n].length>0&&(e[n]=t[n]);return e},K_=(e,t)=>{for(let n of H_)t[n]===!0&&(e[n]=!0);return t.sandbox_profile&&(e.sandbox_profile=t.sandbox_profile),e},Y_=e=>{let t={};for(let n of Yd)t[n]=ke(e[n]??[]);return t},X_=e=>{let t=typeof e.name=="string"?e.name.trim():"";return t.length===0?null:V_(K_({name:t},e),Y_(e))},Z_=e=>(e??[]).map(t=>X_(t)).filter(t=>t!==null).sort((t,n)=>t.name.localeCompare(n.name)),Q_=e=>{let t=Object.assign({},Xd,e??{}),n=J_(e),r=Z_(t.extension_overrides);return{mode:t.mode,trust_mode:t.trust_mode,require_provenance:t.require_provenance===!0,trusted_extensions:n.trusted_extensions,default_sandbox_profile:t.default_sandbox_profile,allowed_extensions:n.allowed_extensions,blocked_extensions:n.blocked_extensions,allowed_capabilities:n.allowed_capabilities,blocked_capabilities:n.blocked_capabilities,allowed_surfaces:n.allowed_surfaces,blocked_surfaces:n.blocked_surfaces,allowed_commands:n.allowed_commands,blocked_commands:n.blocked_commands,allowed_actions:n.allowed_actions,blocked_actions:n.blocked_actions,allowed_services:n.allowed_services,blocked_services:n.blocked_services,extension_overrides:r}},Zd=async(e,t)=>{let n=[t],r=await Wl(t);r&&n.push(r);let i=[...new Set(n.map(a=>S(a)).filter(a=>a.length>0))];for(let a of i){let o=e.find(c=>S(c.name)===a);if(o)return o;let s=e.find(c=>S(c.directory)===a);if(s)return s}},Qd=(e,t)=>{let n=t.trim(),r=new Set(ke(e.extensions.enabled));return new Set(ke(e.extensions.disabled)).has(n)?!1:r.size===0?!0:r.has(n)},eu=(e,t)=>{let n=t.trim(),r=new Set(ke(e.extensions.enabled)),i=new Set(ke(e.extensions.disabled)),a=[...r],o=[...i];return i.delete(n),r.size>0&&r.add(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},ey=(e,t)=>{let n=t.trim(),r=new Set(ke(e.extensions.enabled)),i=new Set(ke(e.extensions.disabled)),a=[...r],o=[...i];return r.delete(n),i.add(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},ty=(e,t)=>{let n=t.trim(),r=new Set(ke(e.extensions.enabled)),i=new Set(ke(e.extensions.disabled)),a=[...r],o=[...i];return r.delete(n),i.delete(n),e.extensions.enabled=[...r].sort((s,c)=>s.localeCompare(c)),e.extensions.disabled=[...i].sort((s,c)=>s.localeCompare(c)),e.extensions.enabled.join("\0")!==a.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},ny=e=>{let t=e.trim().toLowerCase(),n=Math.min(2,Math.max(1,Math.ceil(t.length/4))),r=Kd.map(([i,a,o])=>({action:a,flag:o,distance:Co(t,i,n)})).filter(i=>i.distance!==null).sort((i,a)=>i.distance-a.distance)[0];return r?{action:r.action,flag:r.flag}:null},ry=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=ny(e);if(!r)return new y(`One action flag is required. Use one of: ${q_}. Bare \`pm package\` and \`pm extension\` default to --explore.`,_.USAGE);let i=`pm ${n} ${r.flag}`;return As({command_path:n,display_name:`${n} lifecycle`,token_kind:"action",token:e,allowed:Object.keys(tu),retry_command:i,message_suffix:`. Did you mean "${r.flag}"?`,fallback_candidates:[{source:"lifecycle_action",command:i,reason:`nearest lifecycle action for "${e}"`}]})},iy=[["install","install"],["uninstall","uninstall"],["explore","explore"],["manage","manage"],["describe","describe"],["reload","reload"],["doctor","doctor"],["catalog","catalog"],["init","init"],["scaffold","init"],["adopt","adopt"],["adoptAll","adopt-all"],["activate","activate"],["deactivate","deactivate"],["migrate","migrate"]],tu={doctor:"doctor",reload:"reload",catalog:"catalog",init:"init",scaffold:"init",explore:"explore",manage:"manage",migrate:"migrate",list:"explore","":"explore"},ay=e=>tu[e]??null,oy=(e,t)=>{let n=[...new Set(iy.filter(([r])=>t[r]===!0).map(([,r])=>r))];if(n.length===0){if(e===void 0)return"explore";let r=ay(e.trim().toLowerCase());if(r)return r;throw ry(e,t)}if(n.length>1)throw new y("Extension action flags are mutually exclusive.",_.USAGE);return n[0]},sy=e=>{let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new y('Options "--project/--local" and "--global" are mutually exclusive.',_.USAGE);return n?"global":"project"},cy=[e=>e?null:{status:"skipped_unmanaged",reason:"extension_not_managed"},e=>e&&e.source.kind!=="github"?{status:"skipped_non_github",reason:`managed_source_kind_${e.source.kind}`}:null,e=>{let t=typeof e?.update_error=="string"?e.update_error.trim():"";return t.length>0?{status:"failed",reason:t}:null},e=>{let t=e;return(typeof t.last_update_check_at=="string"?t.last_update_check_at.trim():"").length===0?null:{status:"checked",reason:{true:"update_available",false:"up_to_date"}[String(t.update_available)]??"checked_without_commit_baseline"}}],nu=e=>{for(let t of cy){let n=t(e);if(n)return n}return{status:"not_checked",reason:"no_update_check_recorded"}},ru=(e,t,n,r)=>{let i=n??{};return{name:e.name,directory:e.directory,version:e.version,entry:e.entry,scope:t,active:e.enabled,enabled:e.enabled,runtime_active:null,activation_status:"unknown",contributions:i.contributions,managed:!!n,source:i.source,update_available:i.update_available,last_update_check_at:i.last_update_check_at,last_update_remote_commit:i.last_update_remote_commit,update_error:i.update_error,update_check_status:r.status,update_check_reason:r.reason}},ly=(e,t,n,r)=>{let i=Object.assign({name:e,manifest_version:"unknown",manifest_entry:"unknown"},r),a=r?Qd(n,r.name):!1;return{warning:`extension_manifest_missing:${t}:${e}`,summary:ru({name:i.name,directory:e,version:i.manifest_version,entry:i.manifest_entry,enabled:a},t,r,nu(r))}},dy=async(e,t,n,r,i,a)=>{let o=Ie.join(e,t),s=Ie.join(o,"manifest.json"),c=a.get(S(t));if(!await A(s))return ly(t,n,r,c);let l=Symbol("invalid-extension-manifest-json"),d=await lt.readFile(s,"utf8").then(p=>JSON.parse(p)).catch(()=>l);if(d===l)return{warning:`extension_manifest_invalid_json:${n}:${t}`};let u=_a(d);if(!u)return{warning:`extension_manifest_invalid:${n}:${t}`};let m=i.get(S(u.name))??a.get(S(t));return{summary:ru({name:u.name,directory:t,version:u.version,entry:u.entry,enabled:Qd(r,u.name)},n,m,nu(m))}},qe=async(e,t,n,r)=>{if(!await A(e))return{extensions:[],warnings:[]};let a=(await lt.readdir(e,{withFileTypes:!0})).filter(d=>d.isDirectory()).map(d=>d.name).sort((d,u)=>d.localeCompare(u)),o=new Map(r.entries.map(d=>[S(d.name),d])),s=new Map(r.entries.map(d=>[S(d.directory),d])),c=[],l=[];for(let d of a){let u=await dy(e,d,t,n,o,s);u.warning&&c.push(u.warning),u.summary&&l.push(u.summary)}return{extensions:l.sort((d,u)=>d.name.localeCompare(u.name)),warnings:c.sort((d,u)=>d.localeCompare(u))}},uy=ms(),my=(e,t)=>[t.package,t.kind==="builtin"?t.name:void 0].find(n=>n?.trim())?.trim()??e,py=(e,t,n,r)=>{let i=n.command_paths.map(s=>`pm ${s} --help`),a=r?.error.toLowerCase().includes("@unbrained/pm-cli")===!0,o=n.command_paths.length>0?[...i]:["Run pm package doctor --project --detail deep if expected package commands are missing."];return a&&o.unshift("Install @unbrained/pm-cli in the target workspace so declarative package runtime imports resolve, then reinstall the package."),{package_name:my(e,t),extension_name:e,command_paths:n.command_paths,action_paths:n.action_paths,help_commands:i,next_steps:o,...a?{sdk_dependency_status:"missing"}:{}}},fy=e=>{let t=e.trace,n={layer:e.layer,name:e.name,entry_path:e.entry_path,error:e.error};return t&&(n.trace=Object.fromEntries(Object.entries(t).filter(([,r])=>r!==void 0)),t.missing_capability&&(n.missing_capability=t.missing_capability),t.hint&&(n.hint=t.hint)),n},iu=e=>e.map(t=>fy(t)).sort((t,n)=>`${t.layer}:${t.name}`.localeCompare(`${n.layer}:${n.name}`)),au=(e,t,n)=>{let r=S(e);return t.find(i=>(n===void 0||i.layer===n)&&S(i.name)===r)},hy=(e,t,n,r)=>n.find(a=>a.scope===t&&S(a.name)===S(e))?.activation_status??(r?"failed":"unknown"),ou=(e,t,n,r,i)=>uy.enqueue(async()=>{let a=process.env.PM_CLI_PACKAGE_ROOT,o=await lt.mkdtemp(Ie.join(t,".pm-module-graph-"));process.env.PM_CLI_PACKAGE_ROOT=Ee(import.meta.url,["../.."]);try{let s=await Ne({pmRoot:e,settings:n,cwd:process.cwd(),noExtensions:i.noExtensions===!0,reload_token:vi(),cache_bust:!0,module_graph_snapshot_root:o}),c=await Me({...s}),l=[...s.failed.map(u=>({layer:u.layer,name:u.name,entry_path:u.entry_path,error:u.error})),...iu(c.failed)],d=Object.fromEntries(s.loaded.map(u=>[S(u.name),Go(zt(c,{extensionName:u.name}))]));return{installed:jr(r,s,c),warnings:[...s.warnings,...c.warnings],activation_failures:l,extensions_disabled:s.disabled_by_flag,item_type_registrations:c.registrations.item_types,contribution_inventories:d}}finally{await lt.rm(o,{recursive:!0,force:!0}),a===void 0?delete process.env.PM_CLI_PACKAGE_ROOT:process.env.PM_CLI_PACKAGE_ROOT=a}}),Ma=async(e,t,n,r)=>{let i=n.filter(c=>!c.managed),a=[...i].sort((c,l)=>{let d=c.name.localeCompare(l.name);return d!==0?d:c.directory.localeCompare(l.directory)}),o=r,s=[];for(let c of a){let l=Ie.join(e,c.directory),d=await Ht(l),u=$(),m={kind:"local",input:c.name,location:l};o=wn(o,{name:d.manifest.name,directory:c.directory,scope:t,manifest_version:d.manifest.version,manifest_entry:d.manifest.entry,capabilities:[...d.manifest.capabilities],contributions:d.manifest.contributions,installed_at:u,updated_at:u,source:m}),s.push({name:d.manifest.name,directory:c.directory,version:d.manifest.version,entry:d.manifest.entry,source:m})}return s.length>0&&await vt(e,o),{state:o,adopted_entries:s,unmanaged_candidates:a,already_managed_count:n.length-i.length}},gy=(e,t)=>{let n=L(process.cwd(),t.path),r=Et(n,process.cwd()),i=e==="global"?qn(process.cwd()):n,a=e==="global"?r.global:r.project;return{pm_root:n,scope:e,settings_root:i,selected_root:a,roots:r}},qr=e=>{let t=[e.gh,e.github].filter(r=>typeof r=="string").map(r=>r.trim()).filter(Boolean),n=[...new Set(t)];if(n.length>1)throw new y('Options "--gh" and "--github" must match when both are provided.',_.USAGE);return n[0]},_y=e=>G_[e],yy=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=e==="install"?"source":"name",i=`${n} ${r}`,a=_y(e),o=`<${r}>`,s=`pm ${n} ${a} ${o}`;throw new y(`Action "${e}" requires ${i} input.`,_.USAGE,{code:"missing_lifecycle_target",required:`Provide a ${r} target for ${e}.`,examples:[`pm ${n} ${e} ${o}`,s,`pm ${n} --help`],recovery:{attempted_command:`pm ${n} ${e}`,suggested_retry:s,fallback_candidates:[{source:"lifecycle_action",command:s,reason:`flag-form ${e} command with required ${r} target`}]}})},Gr=(e,t,n={})=>{let r=e?.trim();if(r)return r;if(t==="init")throw new y('Action "init" requires a scaffold target path (for example: pm package init ./my-package or pm extension init ./my-extension).',_.USAGE);return yy(t,n)},wy=(e,t)=>{let n=new Set([...t.registrations.item_types.map(r=>({entry:r,count:r.types.length})),...t.registrations.item_fields.map(r=>({entry:r,count:r.fields.length}))].filter(({count:r})=>r>0).map(({entry:r})=>`${r.layer}:${S(r.name)}`));return e.loaded.filter(r=>(r.activation?.commands??[]).length>0).filter(r=>n.has(`${r.layer}:${S(r.name)}`)).map(r=>`extension_schema_narrow_activation:${r.layer}:${r.name}`).filter((r,i,a)=>a.indexOf(r)===i).sort((r,i)=>r.localeCompare(i))},vy=(e,t)=>{let r=[{triggered:t.strictExit===!0||t.failOnWarn===!0,allowed:e==="doctor",message:"--strict-exit and --fail-on-warn are only valid with --doctor."},{triggered:t.trace===!0,allowed:e==="doctor",message:"--trace is only valid with --doctor."},{triggered:t.watch===!0,allowed:e==="reload",message:"--watch is only valid with --reload."},{triggered:t.runtimeProbe===!0,allowed:e==="manage",message:"--runtime-probe is only valid with --manage."},{triggered:t.fixManagedState===!0,allowed:e==="manage"||e==="doctor",message:"--fix-managed-state is only valid with --manage or --doctor."},{triggered:t.isolated===!0||t.ignoreGlobal===!0,allowed:e==="doctor",message:"--isolated and --ignore-global are only valid with --doctor."},{triggered:t.capability!==void 0,allowed:e==="init",message:"--capability is only valid with --init/--scaffold."},{triggered:t.declarative===!0,allowed:e==="init",message:"--declarative is only valid with --init/--scaffold."},{triggered:t.dryRun===!0,allowed:e==="migrate",message:"--dry-run is only valid with --migrate."}].find(i=>i.triggered&&!i.allowed);if(r)throw new y(r.message,_.USAGE)},by=(e,t,n)=>{let r=String(e??"").trim().toLowerCase(),i=[n.init,n.scaffold].includes(!0);return({doctor:["doctor"],reload:["reload"],catalog:["catalog"],init:i?[]:["init","scaffold"]}[t]??[]).includes(r)?void 0:e},ky=e=>[e.action==="catalog",typeof e.options.fields=="string",String(e.options.fields).trim().length>0].every(Boolean)?{project:"project",global:"global",selected:e.scope,settings_root:"project"}:{project:e.resolvedRoots.roots.project,global:e.resolvedRoots.roots.global,selected:e.resolvedRoots.selected_root,settings_root:e.resolvedRoots.settings_root},xy=(e,t,n)=>{let r={ok:n,action:e.action,scope:e.scope,roots:ky(e),warnings:[...new Set(e.warnings)].sort((i,a)=>i.localeCompare(a)),details:t};return e.action==="doctor"&&Object.defineProperty(r,W_,{value:!0,enumerable:!1,configurable:!1}),r},La=async(e,t,n)=>{let r=oy(e,t);vy(r,t);let i=by(e,r,t),a=sy(t),o=gy(a,n),c={action:r,normalizedTarget:i,scope:a,resolvedRoots:o,warnings:[],options:t,global:n},d={...c,withResult:(u,m=!0)=>xy(c,u,m)};return await nw(d)},Sy=(e,t)=>{let n=t.vocabulary??"extension",r=e.target_path.replace(/\\/g,"/"),i=Qi(r),a={package:`Install dependencies: cd ${i}, then run "npm install"`,extension:`Install type-check dependencies: cd ${i}, then run "npm install -D typescript @types/node @unbrained/pm-cli"`},o={package:`Validate the package: cd ${i}, then run "npm run typecheck" and "npm test"`,extension:`Type-check the source (optional): cd ${i}, then run "npx tsc --noEmit"`},s=[];return[n==="package",t.declarative===!0].every(Boolean)&&s.push("Ensure the target workspace can resolve @unbrained/pm-cli before installing this declarative package."),[a[n],...s,`Install the scaffold: ${Kc(n==="package"?["install","--project",r]:["extension","--install","--project",r])}`,`Smoke-test command path: pm ${e.command_name}`,o[n],`Run diagnostics: ${n==="package"?"pm package doctor":"pm extension --doctor"} --project --detail summary`]},Ey=async e=>{let{action:t,normalizedTarget:n,options:r,withResult:i}=e;if([qr(r),r.ref].filter(l=>typeof l=="string").map(l=>l.trim()).filter(Boolean).length>0)throw new y('Action "init" does not accept --gh/--github/--ref options.',_.USAGE);let s=Gr(n,t,r),c=await ud(s,r.vocabulary??"extension",r.capability,r.declarative===!0);return i({scaffolded:c.created_directory||c.files.some(l=>l.status==="created"),extension:{name:c.extension_name,command:c.command_name},capability:c.capability,style:c.style,target_path:c.target_path,created_directory:c.created_directory,files:c.files,next_steps:Sy(c,r)})},Ay=async e=>{let{normalizedTarget:t,resolvedRoots:n,warnings:r,options:i,global:a,withResult:o}=e;if(t!==void 0)throw new y('Action "reload" does not accept a target argument.',_.USAGE);let s=await I(n.settings_root),c=vi(),l=await Ne({pmRoot:n.settings_root,settings:s,cwd:process.cwd(),noExtensions:a.noExtensions,reload_token:c,cache_bust:!0});r.push(...l.warnings);let d=await Me(l);r.push(...d.warnings);let u={reload:{token:c,cache_bust:!0,watch:i.watch===!0},loaded_count:l.loaded.length,failed_count:l.failed.length,activated_count:Math.max(0,l.loaded.length-d.failed.length),activation_failed_count:d.failed.length,loaded_extensions:l.loaded.map(m=>({name:m.name,layer:m.layer,version:m.version})),failed_extensions:l.failed.map(m=>({name:m.name,layer:m.layer,error:m.error})),activation_failures:d.failed.map(m=>({name:m.name,layer:m.layer,error:m.error}))};return i.watch===!0&&r.push("extension_reload_watch_hint:watch_mode_requested_non_interactive_single_pass_only"),o(u)},Ry=async e=>{let{normalizedTarget:t,scope:n,options:r,global:i,withResult:a}=e;if(typeof t=="string"&&t.length>0&&t!=="catalog")throw new y('Action "catalog" does not accept a package target.',_.USAGE);return a(await Bl(n,i,r))},Iy=(e,t)=>({kind:"builtin",input:e,location:e,name:e,...t===null?{}:{package:t}}),Cy=e=>({kind:"local",input:e.input,location:e.absolute_path}),$y=(e,t)=>({kind:"npm",input:e.input,location:t.resolved_subpath??".",package:t.npm_package,version:t.npm_version}),Ty=(e,t)=>({kind:"github",input:e.input,location:t.resolved_subpath??e.subpath??".",repository:e.repository,owner:e.owner,repo:e.repo,ref:e.ref,subpath:t.resolved_subpath??e.subpath,commit:t.commit}),Oy=(e,t,n,r)=>e?Iy(e,t):n.kind==="local"?Cy(n):n.kind==="npm"?$y(n,r):Ty(n,r),Dy=(e,t,n,r)=>e?e.manifest_version!==t?{installed_at:e.installed_at,updated_at:r}:Fl(e.source,n)?{installed_at:e.installed_at,updated_at:e.updated_at}:{installed_at:e.installed_at,updated_at:r}:{installed_at:r,updated_at:r},Py=async(e,t)=>{let{scope:n,resolvedRoots:r,warnings:i}=e,{validated:a,destinationDirectoryName:o}=t,s=await I(r.settings_root),c=await pe(r.selected_root);i.push(...c.warnings);let l=Ie.join(r.selected_root,o),d=await A(l),u=await Ql(a.directory,l);await lt.mkdir(r.selected_root,{recursive:!0});let m=await lt.mkdtemp(Ie.join(r.selected_root,".pm-extension-install-backup-")),p=Ie.join(m,"destination");try{let f=await Wd(r.selected_root,r.settings_root,l,d,p),g=Oy(t.bundledAliasName,t.bundledPackageName,t.installSource,t.resolvedSource),h=c.state.entries.find(x=>S(x.name)===S(a.manifest.name)),w=Dy(h,a.manifest.version,g,$()),v=wn(c.state,{name:a.manifest.name,directory:o,scope:n,manifest_version:a.manifest.version,manifest_entry:a.manifest.entry,capabilities:[...a.manifest.capabilities],contributions:a.manifest.contributions,...w,source:g}),b=eu(s,a.manifest.name);try{u||await Dd(a.directory,l),await $d(l),await Td(l),await vt(r.selected_root,v),b&&await or(r.settings_root,s,"settings:write")}catch(x){try{await Bd(f)}catch(R){throw new AggregateError([x,R],`Extension install failed: ${String(x)}; rollback failed: ${String(R)}`,{cause:R})}throw x}return{settings:s,managedState:v,sourceRecord:g,destinationDirectory:l,destinationExists:d,installInPlace:u,activationChanged:b}}finally{await lt.rm(m,{recursive:!0,force:!0}).catch(()=>{})}},Ny=async(e,t,n)=>{let r=n.filter(i=>S(i.name)===S(t)).flatMap(i=>i.types.map(a=>({name:a.name,folder:a.folder})));return e.scope==="project"&&r.length>0&&await hn(e.resolvedRoots.pm_root,r,e.warnings,"install:type-folder"),r},My=(e,t,n,r,i)=>{let a=au(t,n.activation_failures,e.scope),o=hy(t,e.scope,n.installed,a),s=[!n.extensions_disabled,o==="ok"].every(Boolean);s||e.warnings.push(`extension_install_activation_failed:${e.scope}:${t}:${o}`);let c={true:{status:"ok",blocking_failure_count:0},false:{status:"degraded",blocking_failure_count:1}};return{activated:s,status:o,failure:a,verification:{status:c[String(s)].status,target_pm_root:e.resolvedRoots.pm_root,activation_status:o,activated:s,registered_commands:r.command_paths,registered_actions:r.action_paths,registered_item_types:i,module_graph_verification:"fresh_in_topology_snapshot",health:c[String(s)]}}},Ly=async(e,t)=>{let{scope:n,resolvedRoots:r,warnings:i,global:a,withResult:o}=e,{validated:s,destinationDirectoryName:c}=t,l=await Py(e,t),d=await qe(r.selected_root,n,l.settings,l.managedState);i.push(...d.warnings);let u=await ou(r.pm_root,Ie.dirname(r.selected_root),l.settings,d.extensions,a);i.push(...u.warnings);let m=await Ny(e,s.manifest.name,u.item_type_registrations),p=Md(s.manifest.name,u.installed),f=My(e,s.manifest.name,u,p,m),g=u.contribution_inventories[S(s.manifest.name)];return g&&(l.managedState=await jl(r.selected_root,l.managedState,s.manifest.name,g)),o({extension:{name:s.manifest.name,version:s.manifest.version,entry:s.manifest.entry,capabilities:s.manifest.capabilities,directory:c},source:l.sourceRecord,source_resolution:t.sourceResolution,destination_path:l.destinationDirectory,overwritten:[l.destinationExists,!l.installInPlace].every(Boolean),installed_in_place:l.installInPlace,activated:f.activated,settings_changed:l.activationChanged,runtime_activation_status:f.status,command_paths:p.command_paths,action_paths:p.action_paths,contributions:g,command_discovery:py(s.manifest.name,l.sourceRecord,p,f.failure),verification:f.verification,activation_diagnostics:{failed_count:u.activation_failures.length,failed:u.activation_failures,installed_extension_failed:f.failure??null}},f.activated)},Fy=async e=>{let{options:t,global:n,warnings:r,withResult:i}=e;if(typeof t.ref=="string"&&t.ref.trim().length>0)throw new y('Action "install all" does not accept --ref.',_.USAGE);let a=[],o=new Map;for(let c of await Pr()){let l=await vn(c),d=Ie.resolve(l),u=o.get(d);u===void 0&&(u=await La(c,{...t,install:!0},n),o.set(d,u)),a.push({alias:c,result:u})}r.push(...a.flatMap(c=>c.result.warnings));let s=a.every(c=>c.result.ok);return i({installed_all:s,installed_count:a.filter(c=>c.result.ok).length,failed_count:a.filter(c=>!c.result.ok).length,packages:a.map(c=>{let l=c.result.details;return{alias:c.alias,ok:c.result.ok,extension:l.extension,source:l.source,source_resolution:l.source_resolution,destination_path:l.destination_path,activated:l.activated,settings_changed:l.settings_changed,command_paths:l.command_paths,action_paths:l.action_paths,command_discovery:l.command_discovery,verification:l.verification,runtime_activation_status:l.runtime_activation_status,activation_diagnostics:l.activation_diagnostics,warnings:c.result.warnings}})},s)},jy=async(e,t,n)=>{let{resolvedRoots:r}=e,{bundledAliasName:i,bundledPackageName:a,installSource:o,sourceResolution:s}=await Gd(t,n,e.options.ref);if(s.ambiguous){let l=s.candidates.find(d=>d.kind==="npm");e.warnings.push(`extension_install_source_ambiguous:${t}:builtin:${i}:npm:${l.package}`)}let c=await Zl(o);try{let l=await Ht(c.directory,{source_kind:o.kind,source_input:o.input,source_root:c.source_root}),d=Or(l.manifest.name);return await Ta(r.settings_root,d,()=>Ly(e,{validated:l,destinationDirectoryName:d,bundledAliasName:i,bundledPackageName:a,sourceResolution:s,installSource:o,resolvedSource:c}))}finally{c.cleanup&&await c.cleanup()}},Uy=async e=>{let t=qr(e.options),n=t??Gr(e.normalizedTarget,e.action,e.options);return[t===void 0,zl(n)].every(Boolean)?Fy(e):jy(e,n,t)},zy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,withResult:o}=e;if(t!==void 0)throw new y('Action "adopt-all" does not accept a target argument.',_.USAGE);if(qr(a)!==void 0||typeof a.ref=="string"&&a.ref.trim().length>0)throw new y('Action "adopt-all" does not accept --gh/--github/--ref options.',_.USAGE);let c=await I(r.settings_root),l=await pe(r.selected_root);i.push(...l.warnings);let d=await qe(r.selected_root,n,c,l.state);i.push(...d.warnings);let u=await Ma(r.selected_root,n,d.extensions,l.state),m=await qe(r.selected_root,n,c,u.state);i.push(...m.warnings);let p=Ur(n,i,m.extensions,a);i.push(...p.warnings);let f=new Map(m.extensions.map(w=>[`${S(w.name)}:${S(w.directory)}`,w])),g=new Map(m.extensions.map(w=>[S(w.directory),w])),h=u.adopted_entries.map(w=>{let v=S(w.directory),b=f.get(`${S(w.name)}:${v}`)??g.get(v);return{...w,...su(b)}});return o({adopted_all:h.length>0,adopted_count:h.length,already_managed_count:u.already_managed_count,extensions:h,triage:p,warning_codes:p.warning_codes,update_health_partial:p.update_health_partial,update_health_coverage:p.update_health_coverage})},su=e=>({update_check_status:e?.update_check_status??null,update_check_reason:e?.update_check_reason??null}),qy=(e,t,n,r)=>{if(e===void 0)return{kind:"local",input:t,location:n};let i=Lr(e,{forceGithub:!0,ref:r});if(i.kind!=="github")throw new y(`Invalid GitHub shorthand "${e}".`,_.USAGE);return{kind:"github",input:i.input,location:i.subpath??".",repository:i.repository,owner:i.owner,repo:i.repo,ref:i.ref,subpath:i.subpath}},Gy=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o,withResult:s}=e,c=Gr(n,t,o),l=qr(o),d=await I(i.settings_root),u=await pe(i.selected_root);a.push(...u.warnings);let m=await qe(i.selected_root,r,d,u.state);a.push(...m.warnings);let p=await Zd(m.extensions,c);if(!p)throw new y(`Installed extension "${c}" was not found in ${r} scope.`,_.NOT_FOUND);if(p.managed)return s({adopted:!1,already_managed:!0,extension:{name:p.name,directory:p.directory}});let f=Ie.join(i.selected_root,p.directory),g=await Ht(f),h=$(),w=qy(l,c,f,o.ref),v=wn(u.state,{name:g.manifest.name,directory:p.directory,scope:r,manifest_version:g.manifest.version,manifest_entry:g.manifest.entry,capabilities:[...g.manifest.capabilities],contributions:g.manifest.contributions,installed_at:h,updated_at:h,source:w});await vt(i.selected_root,v);let b=await qe(i.selected_root,r,d,v);a.push(...b.warnings);let x=b.extensions.find(R=>S(R.name)===S(g.manifest.name))??b.extensions.find(R=>S(R.directory)===S(p.directory));return s({adopted:!0,extension:{name:g.manifest.name,directory:p.directory,version:g.manifest.version,entry:g.manifest.entry},source:w,...su(x)})},cu=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o}=e,s=Gr(n,t,o),c=await I(i.settings_root),l=await pe(i.selected_root);a.push(...l.warnings);let d=await qe(i.selected_root,r,c,l.state);a.push(...d.warnings);let u=await Zd(d.extensions,s);if(!u)throw new y(`Installed extension "${s}" was not found in ${r} scope.`,_.NOT_FOUND);return{settings:c,managedStateRead:l,candidate:u}},Wy=async e=>{let{resolvedRoots:t,withResult:n}=e,{settings:r,managedStateRead:i,candidate:a}=await cu(e),o=Ie.join(t.selected_root,a.directory);await lt.rm(o,{recursive:!0,force:!0});let s={...i.state,updated_at:$(),entries:i.state.entries.filter(l=>S(l.name)!==S(a.name)&&S(l.directory)!==S(a.directory))};await vt(t.selected_root,s);let c=ty(r,a.name);return c&&await or(t.settings_root,r,"settings:write"),n({removed:!0,extension:{name:a.name,directory:a.directory},destination_path:o,settings_changed:c})},Hd=async e=>{let{action:t,resolvedRoots:n,warnings:r,global:i,withResult:a}=e,{settings:o,candidate:s}=await cu(e),c=t==="activate"?eu(o,s.name):ey(o,s.name);c&&await or(n.settings_root,o,"settings:write");let l=t==="activate"?await ou(n.pm_root,Ie.dirname(n.selected_root),o,[s],i).then(d=>(r.push(...d.warnings),au(s.name,d.activation_failures,e.scope))):void 0;return l&&r.push(`extension_activate_failed:${e.scope}:${s.name}`),a({extension:{name:s.name,directory:s.directory},active:t==="activate"&&l===void 0,runtime_active:t==="activate"&&l===void 0,activation_failure:l??null,settings_changed:c,settings:{enabled:[...o.extensions.enabled],disabled:[...o.extensions.disabled]}},l===void 0)},By=(e,t,n,r,i,a)=>{let o=r==="package"?"package":"extension",s={package:"doctor",extension:"--doctor"}[o],c=i?.adopted_entries.length??0,l=[[a!==null,a??""],[t>0,`Run pm ${o} explore --project and pm ${o} explore --global to inspect load failures.`],[n>0,`Review activation failures in pm ${o} ${s} --detail deep output.`],[c>0,`Managed-state fix adopted ${c} extension(s).`]];return[...new Set([...e,...l.filter(([d])=>d).map(([,d])=>d)].map(d=>d.trim()).filter(d=>d.length>0))]},Na=e=>e.loaded.some(t=>t.layer==="global")||e.failed.some(t=>t.layer==="global")||e.warnings.some(t=>t.includes(":global:")),Hy=(e,t,n,r)=>{if(e!=="project"||t||!Na(r))return null;let i=n==="package"?"package":"extension";return`Global ${i} registrations are included in project diagnostics. For hermetic ${i} smoke tests, rerun pm ${i} doctor --project --isolated --detail deep --trace, or set PM_GLOBAL_PATH to a temporary directory for the whole test process.`},Jy=(e,t,n)=>{if(String(e??"").trim().length>0)throw new y('Action "doctor" does not accept a target argument.',_.USAGE);let r=[n.isolated,n.ignoreGlobal].includes(!0);if([r,t==="global"].every(Boolean))throw new y("--isolated and --ignore-global are only valid with project-scope doctor diagnostics.",_.USAGE);let i=kd(n.detail),a=n.trace===!0;if([a,i!=="deep"].every(Boolean))throw new y("--trace requires --detail deep with --doctor.",_.USAGE);return{isolated:r,detailMode:i,includeTrace:a}},Vy=async(e,t,n)=>{if(e.options.fixManagedState!==!0)return{state:n,fix:null};let r=await Ma(e.resolvedRoots.selected_root,e.scope,t,n);return{state:r.state,fix:r}},Ky=(e,t,n,r)=>{let i=n==="package"?"package":"extension";if(e!=="project")return{isolated:t,global_extensions_included:!1,global_diagnostics_present:Na(r),rerun_command:null,pm_global_path_recipe:null};let a=`pm ${i} doctor --project --isolated --detail deep --trace`;return{isolated:t,global_extensions_included:!t,global_diagnostics_present:Na(r),rerun_command:t?null:a,pm_global_path_recipe:`PM_GLOBAL_PATH=$(mktemp -d) pm ${i} doctor --project --detail deep --trace`}},Yy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,global:o,withResult:s}=e,{isolated:c,detailMode:l,includeTrace:d}=Jy(t,n,a),u=await I(r.settings_root),m=await pe(r.selected_root);i.push(...m.warnings);let p=await qe(r.selected_root,n,u,m.state);i.push(...p.warnings);let{state:f,fix:g}=await Vy(e,p.extensions,m.state),h=await qe(r.selected_root,n,u,f);i.push(...h.warnings);let w=await Ne({pmRoot:r.pm_root,settings:u,cwd:process.cwd(),noExtensions:o.noExtensions===!0,ignoreGlobalExtensions:c}),v=await Me({...w,loaded:w.loaded});i.push(...w.warnings),i.push(...wd(w.failed)),i.push(...v.warnings),i.push(...vd(v.failed)),i.push(...bd(w,v)),i.push(...Ld(v,w)),i.push(...wy(w,v)),i.push(...Fd(v));let b=jr(h.extensions,w,v),x=Sd(n,b,w.loaded.map(M=>({layer:M.layer,name:M.name})),w.failed.map(M=>({name:M.name})),w.disabled_by_flag);i.push(...x.warnings);let R=b.filter(M=>M.update_check_status==="failed").map(M=>`extension_update_check_failed:${M.name}`);i.push(...R);let k=Ur(n,i,b,a);i.push(...k.warnings);let F=[...k.warnings],T={mode:w.policy.mode,trust_mode:w.policy.trust_mode,require_provenance:w.policy.require_provenance,default_sandbox_profile:w.policy.default_sandbox_profile,sandbox_enforcement:"advisory: sandbox_profile/permissions are declaration-based load gates, not runtime isolation (ADR pm-6ef3)",trusted_extensions_count:w.policy.trusted_extensions.length,allowed_extensions_count:w.policy.allowed_extensions.length,blocked_extensions_count:w.policy.blocked_extensions.length,allowed_capabilities_count:w.policy.allowed_capabilities.length,blocked_capabilities_count:w.policy.blocked_capabilities.length,allowed_surfaces_count:w.policy.allowed_surfaces.length,blocked_surfaces_count:w.policy.blocked_surfaces.length,allowed_commands_count:w.policy.allowed_commands.length,blocked_commands_count:w.policy.blocked_commands.length,allowed_actions_count:w.policy.allowed_actions.length,blocked_actions_count:w.policy.blocked_actions.length,allowed_services_count:w.policy.allowed_services.length,blocked_services_count:w.policy.blocked_services.length,extension_override_count:w.policy.extension_overrides.length},E=Sn(F),U=En(),B=k.warning_codes,D=Hy(n,c,a.vocabulary,w),W=By(k.remediation,w.failed.length,v.failed.length,a.vocabulary,g,D),_e=Ky(n,c,a.vocabulary,w),me={status:k.status,scope:n,warning_count:k.warning_count,warning_codes:B,total_extensions:b.length,managed_total:b.filter(M=>M.managed).length,enabled_total:b.filter(M=>M.enabled).length,active_total:b.filter(M=>M.active).length,unmanaged_loaded_extension_count:k.unmanaged_loaded_extension_count,unmanaged_action_required_extension_count:k.unmanaged_action_required_extension_count,unmanaged_expected_extension_count:k.unmanaged_expected_extension_count,runtime_active_total:b.filter(M=>M.runtime_active===!0).length,activation_status_totals:{ok:b.filter(M=>M.activation_status==="ok").length,failed:b.filter(M=>M.activation_status==="failed").length,not_loaded:b.filter(M=>M.activation_status==="not_loaded").length,unknown:b.filter(M=>M.activation_status==="unknown").length},unknown_capability_count:E.length,capability_contract_version:U.version,update_available_total:b.filter(M=>M.update_available===!0).length,update_health_coverage:k.update_health_coverage,update_health_partial:k.update_health_partial,update_check_failed_total:b.filter(M=>M.update_check_status==="failed").length,load_failure_count:w.failed.length,activation_failure_count:v.failed.length,load_failures:Ra(w.failed),activation_failures:Ra(v.failed),blocking_failure_count:w.failed.length+v.failed.length,has_blocking_failures:w.failed.length+v.failed.length>0,consistency_warning_count:x.warnings.length,trace_enabled:d,isolation:_e,policy:T,remediation:W},Ge=g?{requested:!0,applied:g.adopted_entries.length>0,adopted_count:g.adopted_entries.length,already_managed_count:g.already_managed_count,adopted_extensions:g.adopted_entries.map(M=>M.name)}:{requested:!1,applied:!1,adopted_count:0,already_managed_count:h.extensions.filter(M=>M.managed).length,adopted_extensions:[]},Pe={mode:l,summary:me,triage:k,trace_enabled:d,capability_contract:U,capability_guidance:E,managed_state_fix:Ge,isolation:_e,policy:w.policy};if(l==="deep"){let M=d?v.failed:v.failed.map(H=>{let{trace:mi,...pi}=H;return pi});Pe.deep={warnings:F,warning_codes:B,capability_contract:U,capability_guidance:E,trace_enabled:d,managed_state:{path:m.path,count:f.entries.length,entries:f.entries},installed_extensions:b,load:{roots:w.roots,policy:w.policy,warnings:w.warnings,failed:w.failed,loaded:w.loaded.map(H=>({layer:H.layer,directory:H.directory,name:H.name,version:H.version,entry:H.entry,priority:H.priority}))},activation:{failed:M,warnings:v.warnings,hook_counts:v.hook_counts,registration_counts:v.registration_counts,parser_override_count:v.parser_override_count,preflight_override_count:v.preflight_override_count,service_override_count:v.service_override_count,renderer_override_count:v.renderer_override_count},consistency:x.summary},d&&(Pe.deep.trace={activation_failures:v.failed.filter(H=>H.trace!==void 0).map(H=>({layer:H.layer,name:H.name,entry_path:H.entry_path,error:H.error,method:H.trace.method,command:H.trace.command,capability:H.trace.capability,missing_capability:H.trace.missing_capability,registration_index:H.trace.registration_index,expected_schema:H.trace.expected_schema,hint:H.trace.hint,received:H.trace.received}))})}return s(Pe)},Xy=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,global:o,withResult:s}=e,c=await I(r.settings_root),l=await Ne({pmRoot:r.pm_root,settings:c,cwd:process.cwd(),noExtensions:o.noExtensions===!0}),d=await Me(l);i.push(...l.warnings),i.push(...d.warnings);let u=pd(t,l,d);if(t!==void 0&&u.extensions.length===0){let m=a.vocabulary==="package"?"package":"extension",p=[...new Set(l.loaded.map(g=>a.vocabulary==="package"&&typeof g.source_package=="string"&&g.source_package.trim().length>0?g.source_package.trim():g.name))].sort((g,h)=>g.localeCompare(h)),f=p.length>0?` Loaded ${m} names: ${p.join(", ")}.`:"";throw new y(`No loaded ${m} named "${t}" was found in ${n} scope.${f} Run pm ${m} explore to list discovered ${m}s.`,_.NOT_FOUND)}return s({target:u.target,total:u.total,extensions:u.extensions,union:u.union,command_ownership:u.command_ownership})},Zy=async(e,t,n)=>{let r=n,i=null;if([e.action==="manage",e.options.fixManagedState===!0].every(Boolean)&&(i=await Ma(e.resolvedRoots.selected_root,e.scope,t,n),r=i.state),e.action==="manage"){let a=await Nd(r.entries,z_,async o=>{if(o.source.kind!=="github")return o;let s=await jd(o.source);return{...o,last_update_check_at:s.checked_at,last_update_remote_commit:s.remote_commit,update_available:s.available,update_error:s.error}});r={...r,updated_at:$(),entries:yn(a)},await vt(e.resolvedRoots.selected_root,r)}return{state:r,fix:i}},Qy=async(e,t,n)=>{let r=await Ne({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),i=await Me({...r,loaded:r.loaded});return e.warnings.push(...r.warnings,...i.warnings),{installed:jr(n,r,i),failures:iu(i.failed),summary:{requested:!0,executed:!0,reason:e.action==="explore"?"explore_defaults_to_runtime_probe":e.options.runtimeProbe===!0?"runtime_probe_requested":"manage_defaults_to_runtime_probe",load_failure_count:r.failed.length,activation_failure_count:i.failed.length,warning_count:[...new Set([...r.warnings,...i.warnings])].length,policy:r.policy}}},ew=(e,t)=>e?{requested:!0,applied:e.adopted_entries.length>0,adopted_count:e.adopted_entries.length,adopted_extensions:e.adopted_entries.map(n=>n.name),already_managed_count:e.already_managed_count}:{requested:!1,applied:!1,adopted_count:0,adopted_extensions:[],already_managed_count:t.filter(n=>n.managed).length},Jd=async e=>{let{action:t,scope:n,resolvedRoots:r,warnings:i,options:a,withResult:o}=e,s=await I(r.settings_root),c=Q_(s.extensions.policy),l=await pe(r.selected_root);i.push(...l.warnings);let d=await qe(r.selected_root,n,s,l.state);i.push(...d.warnings);let{state:u,fix:m}=await Zy(e,d.extensions,l.state),p=await qe(r.selected_root,n,s,u);if(i.push(...p.warnings),t==="manage"){let v=p.extensions.filter(b=>b.update_check_status==="failed").map(b=>`extension_update_check_failed:${b.name}`);i.push(...v)}let f=await Qy(e,s,p.extensions),g=f.installed,h=Ur(n,i,g,a);i.push(...h.warnings);let w={total:g.length,managed_total:g.filter(v=>v.managed).length,enabled_total:g.filter(v=>v.enabled).length,active_total:g.filter(v=>v.active).length,extensions:g,triage:h,policy:c};return f.failures!==void 0&&(w.activation_diagnostics={failed_count:f.failures.length,failed:f.failures}),t==="explore"&&(w.runtime_probe=f.summary),t==="manage"&&(w.runtime_probe=f.summary,w.managed_state_fix=ew(m,g)),o(w)},Vd={init:Ey,install:Uy,uninstall:Wy,explore:Jd,manage:Jd,describe:Xy,reload:Ay,doctor:Yy,catalog:Ry,adopt:Gy,"adopt-all":zy,activate:Hd,deactivate:Hd,migrate:qd},tw=e=>[e.action==="uninstall",e.action==="manage",e.action==="adopt",e.action==="adopt-all",e.action==="activate",e.action==="deactivate",e.action==="migrate",[e.action==="doctor",e.options.fixManagedState===!0].every(Boolean)].some(Boolean),nw=e=>tw(e)?Ta(e.resolvedRoots.settings_root,`${e.action}-state`,()=>Vd[e.action](e)):Vd[e.action](e);import{execFile as rw}from"node:child_process";import{realpath as iw}from"node:fs/promises";import lu from"node:path";import{promisify as aw}from"node:util";(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]="d18b51d7-294a-52da-b1cf-a10f24aefbc9")}catch{}})();var ow=aw(rw),sw=32*1024*1024,cw=1e4,lw=["search/eval-queries.json"];function Fa(e){return e.replaceAll("\\","/").replace(/\/+$/,"")}function dw(e){return`'${e.replaceAll("'","'\\''")}'`}async function uw(e,t=iw){return t(e).catch(()=>lu.resolve(e))}async function Wr(e){let t=await _t(e);if(t===null)return{git_workspace_root:null,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null};let n=await uw(e),r=Fa(lu.relative(t,n));if(r.length===0)return{git_workspace_root:t,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null};let i=ta.map(a=>`${r}/${Fa(a)}`);try{let{stdout:a}=await ow("git",["ls-files","-z","--",...i.map(l=>`:(literal)${l}`)],{cwd:t,encoding:"utf8",maxBuffer:sw,windowsHide:!0,timeout:cw}),o=new Set(lw.map(l=>`${r}/${l}`)),s=[...new Set(a.split("\0").filter(l=>l.length>0&&!o.has(Fa(l))))].sort((l,d)=>l.localeCompare(d)),c=i.filter(l=>s.some(d=>d===l||d.startsWith(`${l}/`)));return{git_workspace_root:t,tracker_relative_root:r,tracked_paths:s,tracked_path_count:s.length,remediation_command:s.length===0?null:`git rm --cached -r -- ${c.map(l=>dw(`:(literal)${l}`)).join(" ")}`}}catch{return{git_workspace_root:t,tracker_relative_root:r,tracked_paths:[],tracked_path_count:0,remediation_command:null}}}import{execFile as mw}from"node:child_process";import{randomUUID as pw}from"node:crypto";import{readdir as fw,readFile as mu}from"node:fs/promises";import Se from"node:path";import{promisify as hw}from"node:util";(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]="7b87b458-164a-5332-8803-6b0695481644")}catch{}})();var gw=hw(mw);async function ja(e){try{let{stdout:t}=await gw("git",["rev-parse","--path-format=absolute","--git-path","pm-merge-receipts"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4});return t.trim()}catch{return null}}async function pu(e,t){let n=Se.dirname(Se.resolve(e,t));for(let r=0;r<12;r+=1){if(await A(Se.join(n,"settings.json")))return n;let i=Se.dirname(n);if(i===n)break;n=i}return null}function Ua(e){return Se.join(e,"merge-receipts")}function Br(e){return`${e}.json`}function _w(e){return{receipt_id:e.id,item_id:e.item_id,item_path:e.item_path,conflict_fields:e.decisions.map(t=>t.field),fields_from_theirs:e.fields_from_theirs,union_fields:e.union_fields,requested_preference:e.requested_preference??e.preferred??"ours",conflict_resolution:e.conflict_resolution,decisions:e.decisions.map(t=>({field:t.field,retained_hash:du(t.retained)??wi(oe(t.retained)),discarded_hash:du(t.discarded)??wi(oe(t.discarded))}))}}function du(e){if(typeof e!="object"||e===null||Array.isArray(e)||!("pm_value_hash"in e))return;let t=e.pm_value_hash;return typeof t=="string"&&/^[a-f0-9]{64}$/u.test(t)?t:void 0}async function X$(e){let t=await ja(e.cwd);if(t===null)return null;let n=e.itemPath.trim(),r=n.length>=2&&(n.startsWith("'")&&n.endsWith("'")||n.startsWith('"')&&n.endsWith('"'))?n.slice(1,-1):n,i=Se.basename(r,Se.extname(r)),a={version:1,id:pw(),item_path:r.replaceAll("\\","/"),item_id:i,requested_preference:e.preferred,conflict_resolution:e.conflictResolution??"preferred_side",fields_from_theirs:[...e.fieldsFromTheirs],union_fields:[...e.unionFields],decisions:structuredClone(e.decisions),state:"pending",created_at:$(),value_availability:"clone_local"};await gi(t),await le(Se.join(t,Br(a.id)),`${JSON.stringify(a,null,2)}
38
+ `);let o=await pu(e.cwd,a.item_path);if(o!==null){let s=Ua(o),c=_w(a),l={...a,decisions:c.decisions.map(d=>({field:d.field,base:null,ours:null,theirs:null,retained:{pm_value_hash:d.retained_hash},discarded:{pm_value_hash:d.discarded_hash}})),value_availability:"hash_only"};await gi(s),await le(Se.join(s,Br(a.id)),`${JSON.stringify(l,null,2)}
39
+ `)}return a}async function uu(e,t){if(!await A(e))return[];let n;try{n=await fw(e)}catch{return[]}let r=[];for(let i of n.sort((a,o)=>a.localeCompare(o)))if(i.endsWith(".json"))try{let a=JSON.parse(await mu(Se.join(e,i),"utf8")),{preferred:o,...s}=a,c={...s,requested_preference:a.requested_preference??o??"ours",conflict_resolution:a.conflict_resolution??"preferred_side"};c.version===1&&(t.includeReconciled||c.state==="pending")&&(t.includeLossless!==!1||c.decisions.length>0)&&r.push(c)}catch{}return r}async function An(e,t={}){let n=await ja(e),r=n===null?[]:await uu(n,t),i=t.pmRoot??Se.join(e,".agents","pm"),a=await uu(Ua(i),t),o=new Map(a.map(s=>[s.id,s]));for(let s of r)o.set(s.id,s);return[...o.values()].sort((s,c)=>s.created_at.localeCompare(c.created_at))}function Hr(e){let t=[],n=[];for(let r of e)(Array.isArray(r.decisions)&&r.decisions.length>0?t:n).push(r);return{pendingDecisions:t,lossless:n}}async function Z$(e,t){let n=await ja(e);if(n===null)return;await le(Se.join(n,Br(t.id)),`${JSON.stringify({...t,state:"reconciled",reconciled_at:$()},null,2)}
40
+ `);let r=await pu(e,t.item_path);if(r!==null){let i=Se.join(Ua(r),Br(t.id));if(await A(i)){let a=JSON.parse(await mu(i,"utf8"));await le(i,`${JSON.stringify({...a,state:"reconciled",reconciled_at:$()},null,2)}
41
+ `)}}}async function Q$(e){let t=await An(e.cwd??process.cwd(),{...e,includeLossless:!0});return{ok:!0,count:t.length,receipts:t,generated_at:$()}}(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]="e7be701e-085c-5903-96da-61149452c673")}catch{}})();var yw=new Set(Js),hu=25,In=8,Rn=100,ww=fe.join("runtime","telemetry","events.jsonl"),vw=fe.join("runtime","telemetry","state.json"),bw=2500,kw=500,gu=Hs-3,xw=["x-pm-telemetry-max-schema-version","x-pm-telemetry-max-version"];function Ha(e,t=!1){return e.startsWith("telemetry_")||e.startsWith("history_stream_over_compact_threshold:")||e.startsWith("stale_in_progress_items:")||e.startsWith("provenance_resolver_zero_success:")||e.startsWith("provenance_value_domain_invalid:")||!t&&e.startsWith("merge_driver_configuration_missing:")}function Ja(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function Vt(e){return e.trim().toLowerCase()}function Ga(e,t){let n=Vt(e),r=Vt(t);return n.startsWith("builtin-")?!0:r==="beads"||r==="todos"}async function Va(e){try{return(await tt.stat(e)).isDirectory()}catch{return!1}}async function Sw(e){let t=(await tt.readdir(e,{withFileTypes:!0})).filter(r=>r.isDirectory()),n=await Promise.all(t.map(r=>tt.readdir(fe.join(e,r.name),{withFileTypes:!0})));return new Set(n.flatMap(r=>r.filter(i=>i.isFile()).filter(i=>tn.some(a=>i.name.endsWith(a))).map(i=>fe.parse(i.name).name)))}async function Ew(e,t,n,r){let i=await He({path:e,scope:"project"}),a=t!=="_workspace"&&!r.has(t);if(!n.enabled&&!a)return{warnings:i,overThreshold:!1,classification:"live"};let o;try{o=await tt.readFile(e,"utf8")}catch{return{warnings:i,overThreshold:!1,classification:"unreadable"}}let s="live";if(a){let l=o.split(/\r?\n/).map(d=>d.trim()).filter(Boolean).at(-1);try{s=JSON.parse(l??"{}").op==="delete"?"tombstone":"orphaned"}catch{s="orphaned"}}let c=n.enabled?o.split(/\r?\n/).filter(l=>l.trim().length>0).length:0;return{warnings:i,overThreshold:n.enabled&&c>n.max_entries,classification:s}}async function Aw(e,t,n){let r=fe.join(e,"history");if(!await Va(r))return{count:0,warnings:[],over_threshold:[],max_entries:null,tombstones:[],orphaned:[]};let i=(await tt.readdir(r)).filter(u=>u.endsWith(".jsonl")).sort((u,m)=>u.localeCompare(m)),o=t.enabled?t.max_entries:null,s=[],c=[],l=[],d=[];for(let u of i){let m=fe.join(r,u),p=u.slice(0,-6),f=await Ew(m,p,t,n);s.push(...f.warnings),f.classification==="tombstone"&&l.push(p),f.classification==="orphaned"&&d.push(p),f.overThreshold&&c.push(p)}return{count:i.length,warnings:[...s,...c.map(u=>`history_stream_over_compact_threshold:${u}`),...d.map(u=>`history_orphaned_stream:${u}`)],over_threshold:c,max_entries:o,tombstones:l,orphaned:d}}function Wa(e,t){return fe.relative(e,t).replaceAll("\\","/")}async function _u(e,t){let n=[...new Set(Object.values(t))].sort((i,a)=>i.localeCompare(a)),r=[];for(let i of n){let a=fe.join(e,i),o=[];try{o=await tt.readdir(a)}catch(s){if(typeof s=="object"&&s!==null&&"code"in s&&j(s))continue;continue}for(let s of o)tn.some(c=>s.toLowerCase().endsWith(c))&&r.push(fe.join(a,s))}return r.sort((i,a)=>Wa(e,i).localeCompare(Wa(e,a))),r}function Rw(e){return!(typeof e=="object"&&e!==null&&"code"in e&&j(e))}async function Iw(e,t,n){let r=await _u(e,t),i=[],a=[],o=[],s=[],c=St(z());for(let l of r){let d=Wa(e,l),u;try{u=await tt.readFile(l,"utf8")}catch{i.push(d);continue}let m=$t(u);if(m){a.push({path:d,...m});continue}try{let p=Tt(u,{format:jo(l),schema:n,extensionFieldNames:c});s.push({ref:d,version:Qn(p.metadata)})}catch{o.push(d)}}return{paths:r,unreadable:i,conflictMarkers:a,parseFailures:o,formatVersions:s}}async function Cw(e){let t=fe.join(e,"history"),n=[],r=[],i=[],a=[];try{a=(await tt.readdir(t)).filter(o=>o.endsWith(".jsonl")).sort((o,s)=>o.localeCompare(s))}catch(o){Rw(o)&&n.push("history")}for(let o of a){let s=o.slice(0,-6),c;try{c=await tt.readFile(fe.join(t,o),"utf8")}catch{n.push(s);continue}let l=$t(c);if(l){r.push({id:s,...l});continue}c.split(/\r?\n/).forEach((d,u)=>{if(d.trim())try{JSON.parse(d)}catch{i.push({id:s,line:u+1})}})}return{files:a,unreadable:n,conflictMarkers:r,invalidJson:i}}async function $w(e,t,n,r){let i=await Iw(e,t,n),a=await Cw(e),o=er(i.formatVersions),s=await Wr(e),c=await _t(e),l=c===null?null:await Ir(c),d=c===null?[]:await An(c,{includeLossless:!0,pmRoot:e}),{pendingDecisions:u,lossless:m}=Hr(d),p=l?.status==="missing"&&l.missing_keys.length===5&&l.drifted_keys.length===0,f=[...i.unreadable.map(h=>`integrity_item_unreadable:${h}`),...i.conflictMarkers.map(h=>`integrity_item_conflict_marker:${h.path}:L${h.line}`),...i.parseFailures.map(h=>`integrity_item_parse_failed:${h}`),...a.unreadable.map(h=>`integrity_history_unreadable:${h}`),...a.conflictMarkers.map(h=>`integrity_history_conflict_marker:${h.id}:L${h.line}`),...a.invalidJson.map(h=>`integrity_history_invalid_json:${h.id}:L${h.line}`),...o.outdated.map(h=>`integrity_item_outdated_format_version:${h}`),...o.ahead.map(h=>`integrity_item_ahead_format_version:${h}`),...s.tracked_path_count>0?[`tracked_runtime_cache_files:${s.tracked_path_count}`]:[],...l!==null&&l.status!=="ok"?[`merge_driver_configuration_${p?"missing":"drift"}:${l.missing_keys.length+l.drifted_keys.length}`]:[],...u.length>0?[`merge_decisions_unreviewed:${u.length}`]:[]],g=[...new Set(f)].sort((h,w)=>h.localeCompare(w));return{check:{name:"integrity",status:g.length===0?"ok":"warn",ok:g.length===0,details:{checked_item_files:i.paths.length,checked_history_streams:a.files.length,counts:{item_unreadable:i.unreadable.length,item_conflict_markers:i.conflictMarkers.length,item_parse_failures:i.parseFailures.length,history_unreadable:a.unreadable.length,history_conflict_markers:a.conflictMarkers.length,history_invalid_json:a.invalidJson.length,item_outdated_format_version:o.outdated.length,item_ahead_format_version:o.ahead.length,tracked_runtime_cache_files:s.tracked_path_count,merge_driver_configuration:l===null||l.status==="ok"?0:l.missing_keys.length+l.drifted_keys.length,pending_merge_decisions:u.length,lossless_merge_receipts:m.length},item_unreadable:i.unreadable,item_conflict_markers:i.conflictMarkers,item_parse_failures:i.parseFailures,item_outdated_format_version:o.outdated,item_ahead_format_version:o.ahead,history_unreadable:a.unreadable,history_conflict_markers:a.conflictMarkers,history_invalid_json:a.invalidJson,tracked_runtime_cache:{tracker_relative_root:s.tracker_relative_root,tracked_paths:s.tracked_paths,tracked_path_count:s.tracked_path_count,remediation_command:s.remediation_command},merge_driver_configuration:l===null?null:{...l,required:r},pending_merge_decision_items:[...new Set(u.map(h=>h.item_id))].sort((h,w)=>h.localeCompare(w)),lossless_merge_receipt_items:[...new Set(m.map(h=>h.item_id))].sort((h,w)=>h.localeCompare(w))}},warnings:g}}function Tw(e){if(typeof e.activate=="function")return!0;let t=e.default;return typeof t!="object"||t===null?!1:typeof t.activate=="function"}function Ow(e){let t={layer:e.layer,directory:e.directory,manifest_path:e.manifest_path,name:e.name,version:e.version,entry:e.entry,priority:e.priority,entry_path:e.entry_path,has_activate:Tw(e.module)};return Array.isArray(e.capabilities)&&(t.capabilities=[...e.capabilities]),t}function Dw(e,t){let n=Z(e.id);return n||`migration-${String(t+1).padStart(3,"0")}`}function Pw(e){let n=Z(e.status)?.toLowerCase();return n==="failed"?"failed":n==="applied"?"applied":"pending"}function Nw(e){return Z(e.reason)??Z(e.error)??Z(e.message)}function za(e,t){let n=(e.layer??"").localeCompare(t.layer??"");if(n!==0)return n;let r=(e.name??"").localeCompare(t.name??"");return r!==0?r:(e.id??"").localeCompare(t.id??"")}function Mw(e){let t=[],n=[],r=[];e.forEach((a,o)=>{let s=Dw(a.definition,o),c=Pw(a.definition);if(c==="applied"){t.push({layer:a.layer,name:a.name,id:s,status:c});return}if(c==="failed"){r.push({layer:a.layer,name:a.name,id:s,status:c,reason:Nw(a.definition)});return}n.push({layer:a.layer,name:a.name,id:s,status:c})}),t.sort(za),n.sort(za),r.sort(za);let i=[...r.map(a=>`extension_migration_failed:${a.layer}:${a.name}:${a.id}`),...n.map(a=>`extension_migration_pending:${a.layer}:${a.name}:${a.id}`)];return{summary:{applied:t,pending:n,failed:r,applied_count:t.length,pending_count:n.length,failed_count:r.length},warnings:i}}function yu(e,t,n,r,i,a,o,s,c){let l=[...new Set(e)].sort((h,w)=>h.localeCompare(w)),d=[...new Set(l.map(h=>Ja(h)))].sort((h,w)=>h.localeCompare(w)),u=l.filter(h=>h.startsWith("extension_capability_unknown:")).length,m=c.length>0,p=m?"partial":"full",f=[],g=Ia(l,{deactivate:"pm extension --deactivate <name> --project/--global",doctor:"pm extension --doctor --project/--global --detail deep --trace"});return g&&f.push(g),t>0&&f.push("Run pm extension --explore --project and pm extension --explore --global to inspect load failures."),n>0&&f.push("Review checks[name=extensions].details.activation.failed in pm health --json for activation error details."),(r.failed_count>0||r.pending_count>0)&&f.push("Resolve pending/failed extension migrations before write commands; use --force only when policy allows."),i>0&&f.push("Run pm extension --manage --project and pm extension --manage --global to refresh managed-state diagnostics."),u>0&&f.push(`Unknown extension capabilities detected. Allowed capabilities: ${Fn.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`),l.some(h=>h.startsWith("extension_capability_legacy_alias:"))&&f.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."),l.some(h=>h.startsWith("extension_command_definition_legacy_handler_alias:"))&&f.push("Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."),m?f.push("Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via pm extension --manage --project/--global --fix-managed-state, pm extension --adopt-all --project/--global, or pm extension --adopt <name>."):o.length>0&&f.push("Loaded unmanaged extensions are currently treated as informational. Use pm extension --manage --project/--global --fix-managed-state to adopt them for update checks."),f.length===0&&f.push("No immediate action required. Re-run pm health after extension configuration changes."),{status:l.length===0?"ok":"warn",warning_count:l.length,warning_codes:d,load_failure_count:t,activation_failure_count:n,migration_failed_count:r.failed_count,migration_pending_count:r.pending_count,managed_state_warning_count:i,managed_extension_entries_count:a,unmanaged_loaded_extension_count:o.length,unmanaged_loaded_extensions:o,unmanaged_expected_extension_count:s.length,unmanaged_expected_extensions:s,unmanaged_action_required_extension_count:c.length,unmanaged_action_required_extensions:c,update_health_coverage:p,update_health_partial:m,unknown_capability_count:u,top_warnings:l.slice(0,8),remediation:f}}async function Lw(e,t,n){let r=await Ne({pmRoot:e,settings:t,cwd:process.cwd(),noExtensions:n}),i=r.loaded.map(k=>Ow(k)),a=await kc(r.loaded,pt(e)),o=await Me({...r,loaded:r.loaded}),[s,c]=await Promise.all([pe(r.roots.project),pe(r.roots.global)]);await Da(e,o.registrations.migrations);let l=Mw(o.registrations.migrations),d={failed:o.failed,warnings:o.warnings,hook_counts:o.hook_counts,command_override_count:o.command_override_count,command_handler_count:o.command_handler_count,parser_override_count:o.parser_override_count,preflight_override_count:o.preflight_override_count,service_override_count:o.service_override_count,renderer_override_count:o.renderer_override_count,registration_counts:o.registration_counts,registrations:o.registrations,migration_status:l.summary,managed_extensions:{project:{path:s.path,count:s.state.entries.length,entries:s.state.entries},global:{path:c.path,count:c.state.entries.length,entries:c.state.entries}}},u=new Set(s.state.entries.map(k=>Vt(k.name))),m=new Set(c.state.entries.map(k=>Vt(k.name))),p=[...new Map(r.loaded.filter(k=>!(k.layer==="project"?u:m).has(Vt(k.name))).map(k=>[`${k.layer}:${k.name}`,{layer:k.layer,name:k.name,directory:k.directory}])).values()].sort((k,F)=>{let T=`${k.layer}:${k.name}`,E=`${F.layer}:${F.name}`;return T.localeCompare(E)}),f=p.map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),g=p.filter(k=>Ga(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),h=p.filter(k=>!Ga(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,F)=>k.localeCompare(F)),w=h.length>0?[`extension_update_health_partial_coverage:skipped_unmanaged:${h.length}`]:[],v=[...r.warnings,...d.warnings,...l.warnings,...s.warnings,...c.warnings,...w,...a.warnings],b=Sn(v),x=En(),R=yu(v,r.failed.length,o.failed.length,l.summary,s.warnings.length+c.warnings.length,s.state.entries.length+c.state.entries.length,f,g,h);return{check:{name:"extensions",status:v.length===0?"ok":"warn",ok:v.length===0,details:{...r,loaded:i,warnings:v,activation:d,triage:R,...l.summary.pending_count>0?{remediation_map:{extension_migration_pending:"pm extension migrate --project"}}:{},capability_contract:x,capability_guidance:b,host_version_census:a}},warnings:v}}function Fw(e,t){return e.length<=t?{values:e,truncated:!1}:{values:e.slice(0,t),truncated:!0}}function et(e,t){return Array.isArray(e)?{count:e.length,sample:e.slice(0,t),truncated:e.length>t}:{count:0,sample:[],truncated:!1}}function jw(e){if(typeof e!="object"||e===null||Array.isArray(e))return{};let t=e;return{layer:t.layer,directory:t.directory,name:t.name,version:t.version,enabled:t.enabled,status:t.status,has_activate:t.has_activate,capabilities:t.capabilities}}function Jr(e,t){let n=et(e,t);return{...n,sample:n.sample.map(r=>jw(r))}}function V(e,t){if(!Array.isArray(e))return{count:0,sample:[],truncated:!1};let n=e.filter(r=>typeof r=="string");return{count:n.length,sample:n.slice(0,t),truncated:n.length>t}}function Uw(e){if(typeof e!="object"||e===null)return null;let t=e;return{applied_count:t.applied_count,pending_count:t.pending_count,failed_count:t.failed_count}}var zw={settings:(e,t)=>({version:e.version,id_prefix:e.id_prefix,locks_ttl_seconds:e.locks_ttl_seconds,warnings:V(e.warnings,t)}),directories:(e,t)=>({required_count:Array.isArray(e.required)?e.required.length:0,optional_count:Array.isArray(e.optional)?e.optional.length:0,missing_required:V(e.missing_required,t),missing_optional:V(e.missing_optional,t),missing:V(e.missing,t),strict_directories:e.strict_directories}),settings_values:(e,t)=>({warnings:V(e.warnings,t)}),telemetry:e=>({enabled:e.enabled,capture_level:e.capture_level,endpoint:e.endpoint,queue_exists:e.queue_exists,queue_entries:e.queue_entries,queue_draining:e.queue_draining,queue_invalid_rows:e.queue_invalid_rows,queue_rows_total:e.queue_rows_total,last_successful_flush_at:e.last_successful_flush_at,last_failed_flush_at:e.last_failed_flush_at,endpoint_probe:e.endpoint_probe,env_overrides:e.env_overrides}),extensions:(e,t)=>{let n=typeof e.activation=="object"&&e.activation!==null?e.activation:{};return{disabled_by_flag:e.disabled_by_flag,discovered:Jr(e.discovered,t),effective:Jr(e.effective,t),loaded:Jr(e.loaded,t),failed:et(e.failed,t),warnings:V(e.warnings,t),activation:{failed:et(n.failed,t),warnings:V(n.warnings,t),hook_counts:n.hook_counts,command_handler_count:n.command_handler_count,service_override_count:n.service_override_count,renderer_override_count:n.renderer_override_count,registration_counts:n.registration_counts,migration_status:Uw(n.migration_status)},triage:e.triage,capability_contract:e.capability_contract,capability_guidance:et(e.capability_guidance,t),host_version_census:e.host_version_census}},storage:(e,t)=>{let n=typeof e.author_attribution=="object"&&e.author_attribution!==null?e.author_attribution:void 0;return{...e,...n?{author_attribution:{...n,affected_item_ids:V(n.affected_item_ids,t),samples:et(n.samples,t)}}:{}}},locks:e=>({active_lock_count:e.active_lock_count,stale_lock_count:e.stale_lock_count,unreadable_lock_count:e.unreadable_lock_count,unparseable_lock_count:e.unparseable_lock_count}),integrity:(e,t)=>{let n=typeof e.tracked_runtime_cache=="object"&&e.tracked_runtime_cache!==null?e.tracked_runtime_cache:void 0;return{checked_item_files:e.checked_item_files,checked_history_streams:e.checked_history_streams,counts:e.counts,item_unreadable:V(e.item_unreadable,t),item_conflict_markers:et(e.item_conflict_markers,t),item_parse_failures:V(e.item_parse_failures,t),tracked_runtime_cache:n===void 0?e.tracked_runtime_cache:{...n,tracked_paths:V(n.tracked_paths,t)},history_unreadable:V(e.history_unreadable,t),history_conflict_markers:et(e.history_conflict_markers,t),history_invalid_json:et(e.history_invalid_json,t),skipped:e.skipped}},history_drift:(e,t)=>({checked_items:e.checked_items,counts:e.counts,drifted_items:V(e.drifted_items,t),missing_streams:V(e.missing_streams,t),unreadable_streams:V(e.unreadable_streams,t),hash_mismatches:V(e.hash_mismatches,t),chain_mismatches:V(e.chain_mismatches,t),workspace_state_mismatches:V(e.workspace_state_mismatches,t),workspace_state_missing:V(e.workspace_state_missing,t),workspace_state_unreadable:V(e.workspace_state_unreadable,t),skipped:e.skipped}),vectorization:(e,t)=>({semantic_runtime_available:e.semantic_runtime_available,compatibility_mode_auto_defaults:e.compatibility_mode_auto_defaults,auto_ollama_defaults_applied:e.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:e.auto_ollama_defaults_skipped_reason,auto_ollama_defaults_remediation:e.auto_ollama_defaults_remediation,refresh_policy:e.refresh_policy,provider_active:e.provider_active,vector_store_active:e.vector_store_active,items:e.items,ledger_entries_before:e.ledger_entries_before,stale_items_before_total:e.stale_items_before_total,stale_items_before:V(e.stale_items_before,t),refresh_attempted:e.refresh_attempted,refresh_skipped_reason:e.refresh_skipped_reason,refresh_result:e.refresh_result,ledger_entries_after:e.ledger_entries_after,stale_items_after_total:e.stale_items_after_total,stale_items_after:V(e.stale_items_after,t),skipped:e.skipped})};function wu(e,t){let n=zw[e.name];return n?n(e.details,t):e.details}function qw(e){let t=V(e.warnings,In);return{ok:e.ok,checks:e.checks.map(n=>({name:n.name,status:n.status,ok:n.ok,details:wu(n,In)})),warnings:t.sample,findings:e.findings.filter(n=>t.sample.includes(n.warning)||e.failed_because.includes(n.warning)),failed_because:e.failed_because,projection:{mode:"brief",warning_count:t.count,warnings_truncated:t.truncated,detail_limit:In},generated_at:e.generated_at}}function fu(e){return e.details.skipped===!0}function Gw(e){let t=V(e.warnings,In),n=e.checks.filter(fu).map(r=>r.name);return{ok:e.ok,checks:e.checks.filter(r=>!fu(r)).map(r=>({name:r.name,status:r.status,ok:r.ok,details:{}})),warning_count:t.count,warnings:t.sample,findings:e.findings.filter(r=>t.sample.includes(r.warning)||e.failed_because.includes(r.warning)),failed_because:e.failed_because,projection:{mode:"summary",warning_count:t.count,warnings_truncated:t.truncated,detail_limit:In,omitted_checks:n},generated_at:e.generated_at}}function Ba(e,t){if(t)return{values:e,truncated:!1,total:e.length};let n=Fw(e,hu);return{values:n.values,truncated:n.truncated,total:e.length}}function Jt(e){let t=(process.env[e]??"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}function Ww(){let e=(process.env.PM_TELEMETRY_SOURCE_CONTEXT??"").trim().toLowerCase();return yw.has(e)?e:null}function Vr(e){let t=e.trim();if(t.length===0)return"";try{let n=new URL(t);return n.username="",n.password="",n.search="",n.hash="",n.toString()}catch{return t}}function vu(e){let t=0,n=0,r=0,i=0,a=0;for(let o of e.split(`
42
+ `)){let s=o.trim();if(s.length!==0){r+=1;try{let c=JSON.parse(s);if(typeof c=="object"&&c!==null&&typeof c.attempts=="number"&&Number.isFinite(c.attempts)){let l=Math.max(0,Math.trunc(c.attempts));t+=1,a=Math.max(a,l),l>=gu&&(i+=1)}else n+=1}catch{n+=1}}}return{validEntries:t,invalidRows:n,totalRows:r,highRetryEntries:i,maxAttempts:a}}function Bw(){return{validEntries:0,invalidRows:0,totalRows:0,highRetryEntries:0,maxAttempts:0}}function Hw(e){if(!e||e.trim().length===0)return{runtimeState:{},stateParseFailed:!1};try{let t=JSON.parse(e);return typeof t=="object"&&t!==null&&!Array.isArray(t)?{runtimeState:t,stateParseFailed:!1}:{runtimeState:{},stateParseFailed:!0}}catch{return{runtimeState:{},stateParseFailed:!0}}}async function Jw(e,t){let n=e.telemetry.endpoint.trim();return!t||!e.telemetry.enabled||n.length===0?void 0:{attempted:!0,...await bu(n)}}function Vw(e,t,n){let r=[];if(t.invalidRows>0&&r.push(`telemetry_queue_invalid_rows:${t.invalidRows}`),!e.telemetry.enabled||t.validEntries===0)return r;let i=n.last_successful_flush_at,a=n.last_failed_flush_at,o=a&&(!i||a>i),s=!i,c=t.validEntries>=kw;return(o||s||c)&&r.push(`telemetry_queue_pending:${t.validEntries}`),t.highRetryEntries>0&&r.push(`telemetry_queue_high_retries:${t.highRetryEntries}`),r}function Kw(e){return!e||e.ok!==!1?[]:typeof e.status=="number"?[`telemetry_endpoint_probe_http_status:${e.status}`]:["telemetry_endpoint_probe_failed"]}function Yw(e){let t=Number.parseInt(e?.max_schema_version??"",10);return e?.ok===!0&&Number.isInteger(t)&&t>Bs?[`telemetry_schema_version_behind:${t}`]:[]}function Xw(e,t){let n=typeof t.pending_otel_spans=="number"?t.pending_otel_spans:0,r=t.last_otel_success_at,i=t.last_otel_failure_at;return e.telemetry.enabled&&n>0&&!!i&&(!r||i>=r)?[`telemetry_otel_export_failing:${n}`]:[]}function Zw(){return{telemetry_disabled:Jt("PM_TELEMETRY_DISABLED")||Jt("PM_NO_TELEMETRY"),pm_no_telemetry:Jt("PM_NO_TELEMETRY"),telemetry_otel_disabled:Jt("PM_TELEMETRY_OTEL_DISABLED"),telemetry_inline_flush:Jt("PM_TELEMETRY_INLINE_FLUSH"),telemetry_source_context:Ww()}}function Qw(e,t){return e.telemetry.enabled&&t.validEntries>0}function ev(e,t){return e&&t.every(n=>!n.startsWith("telemetry_queue_pending:")&&!n.startsWith("telemetry_queue_high_retries:"))}async function bu(e){let t=e;try{let n=new URL(e);n.pathname="/healthz",n.search="",n.hash="",t=n.toString()}catch{}try{let n=await fetch(t,{method:"GET",signal:AbortSignal.timeout(bw)});return{probe_url:Vr(t),ok:n.ok,status:n.status,max_schema_version:(()=>{for(let r of xw){let i=n.headers.get(r)?.trim();if(i&&i.length>0)return i}})()}}catch(n){return{probe_url:Vr(t),ok:!1,error:n instanceof Error?n.message:"probe_failed"}}}async function tv(e,t){let n=qn(process.cwd()),r=fe.join(n,ww),i=fe.join(n,vw),a=await X(r),o=a!==null,s=a?Buffer.byteLength(a,"utf8"):0,c=a?vu(a):Bw(),l=await X(i),{runtimeState:d,stateParseFailed:u}=Hw(l),m=e.telemetry.endpoint.trim(),p=Vr(m),f=await Jw(e,t.checkTelemetry),g=[];u&&g.push("telemetry_state_invalid_json"),g.push(...Vw(e,c,d),...Kw(f),...Yw(f),...Xw(e,d));let h=Qw(e,c),w=typeof d.pending_otel_spans=="number"?d.pending_otel_spans:0;return{check:{name:"telemetry",status:g.length===0?"ok":"warn",ok:g.length===0,details:{enabled:e.telemetry.enabled,capture_level:e.telemetry.capture_level,endpoint:p,global_pm_root:n,queue_path:r,queue_exists:o,queue_entries:c.validEntries,queue_draining:ev(h,g),queue_invalid_rows:c.invalidRows,queue_rows_total:c.totalRows,queue_size_bytes:s,queue_high_retry_entries:c.highRetryEntries,queue_high_retry_threshold:gu,queue_max_attempts:c.maxAttempts,runtime_state_path:i,last_attempted_flush_at:d.last_attempted_flush_at??null,last_successful_flush_at:d.last_successful_flush_at??null,last_failed_flush_at:d.last_failed_flush_at??null,last_failed_flush_error:d.last_failed_flush_error??null,pending_otel_spans:w,last_otel_attempt_at:d.last_otel_attempt_at??null,last_otel_success_at:d.last_otel_success_at??null,last_otel_failure_at:d.last_otel_failure_at??null,last_otel_failure_error:d.last_otel_failure_error??null,endpoint_probe:f??{attempted:!1},env_overrides:Zw()}},warnings:g}}async function nv(e){let t;try{t=await Bc(e)}catch(r){let i=r instanceof Error?r.message:String(r);return{check:{name:"locks",status:"warn",ok:!1,details:{active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0,scan_failed:!0,error:i,pm_root:e}},warnings:[`locks_scan_failed:${i}`]}}let n=[];return t.stale_lock_count>0&&n.push(`locks_stale_count:${t.stale_lock_count}`),t.unreadable_lock_count>0&&n.push(`locks_unreadable:${t.unreadable_lock_count}`),{check:{name:"locks",status:n.length===0?"ok":"warn",ok:n.length===0,details:{active_lock_count:t.active_lock_count,stale_lock_count:t.stale_lock_count,unreadable_lock_count:t.unreadable_lock_count,unparseable_lock_count:t.unparseable_lock_count}},warnings:n}}async function rv(e,t){let n="metadata",{missingStreams:r,unreadableStreams:i,hashMismatches:a,chainMismatches:o,driftedItems:s,workspaceStateMismatches:c,workspaceStateMissing:l,workspaceStateUnreadable:d}=await xr(e,t,{cacheHitVerification:n}),u=[...r.map(m=>`history_drift_missing_stream:${m}`),...i.map(m=>`history_drift_unreadable_stream:${m}`),...a.map(m=>`history_drift_hash_mismatch:${m}`),...o.map(m=>`history_drift_chain_mismatch:${m}`),...c.map(m=>`history_drift_workspace_state_mismatch:${m}`),...l.map(m=>`history_drift_workspace_state_missing:${m}`),...d.map(m=>`history_drift_workspace_state_unreadable:${m}`)];return{check:{name:"history_drift",status:u.length===0?"ok":"warn",ok:u.length===0,details:{checked_items:t.length,cache_hit_verification:n,drifted_items:s,counts:{drifted:s.length,missing_streams:r.length,unreadable_streams:i.length,hash_mismatches:a.length,chain_mismatches:o.length,workspace_state_mismatches:c.length,workspace_state_missing:l.length,workspace_state_unreadable:d.length},missing_streams:r,unreadable_streams:i,hash_mismatches:a,chain_mismatches:o,workspace_state_mismatches:c,workspace_state_missing:l,workspace_state_unreadable:d}},warnings:u}}function iv(e,t){let n=lr(e),r=an(n.settings),i=dr(n.settings,t),a=r.active?ht(r.active.name,r.active.model):null;return{runtimeDefaults:n,providerResolution:r,vectorStoreResolution:i,runtimeEmbeddingIdentity:a,semanticRuntimeAvailable:!!(r.active&&i.active)}}function av(){return{refreshed:[],skipped:[],warnings:[]}}async function ov(e){return!e.refreshPolicy.enabled||!e.snapshot.semanticRuntimeAvailable||e.staleBefore.length===0?av():Gs(e.pmRoot,e.staleBefore,{settings:e.snapshot.runtimeDefaults.settings,apply_runtime_defaults:!1})}function sv(e){return e.strictVectorizationWarnings&&e.semanticRuntimeAvailable&&!!(e.ledgerBefore.embedding&&e.runtimeEmbeddingIdentity&&Nt(e.ledgerBefore.embedding,e.runtimeEmbeddingIdentity))}function cv(e){let t=new Set([...e.ledgerBefore.warnings,...e.ledgerAfter.warnings]);if(e.strictVectorizationWarnings)for(let n of e.refreshResult.warnings)t.add(n);return e.embeddingIdentityChanged&&t.add("vectorization_embedding_identity_changed"),e.strictVectorizationWarnings&&e.semanticRuntimeAvailable&&e.staleAfter.length>0&&t.add(`vectorization_stale_items_remaining:${e.staleAfter.length}`),[...t].sort((n,r)=>n.localeCompare(r))}function lv(e,t,n){return e.enabled&&t&&n.length>0?null:e.enabled?t?"no_stale_items":"semantic_runtime_unavailable":"refresh_disabled"}function ku(e,t){let n=t.providerResolution.active?.name??null,r=t.vectorStoreResolution.active?.name??null;return{provider_active:n,provider_configured:typeof e.search?.provider=="string"?e.search.provider:null,provider_source:$i(n,e.search?.provider??null),vector_store_active:r,vector_store_configured:typeof e.vector_store?.adapter=="string"?e.vector_store.adapter:null,vector_store_source:$i(r,e.vector_store?.adapter??null)}}function dv(e){return{enabled:e.enabled,check_only:e.checkOnly,no_refresh:e.noRefresh,refresh_vectors:e.refreshVectors}}function uv(e,t,n){return e.enabled&&n.length>0&&t}async function mv(e,t,n,r,i){let a=iv(t,e),o=await Mt(e),s=a.semanticRuntimeAvailable?Di(n,o.entries):[],c=await ov({pmRoot:e,snapshot:a,refreshPolicy:r,staleBefore:s}),l=await Mt(e),d=a.semanticRuntimeAvailable?Di(n,l.entries):[],u=!a.runtimeDefaults.auto_ollama_defaults_applied,m=sv({strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,ledgerBefore:o,runtimeEmbeddingIdentity:a.runtimeEmbeddingIdentity}),p=cv({ledgerBefore:o,ledgerAfter:l,refreshResult:c,strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,embeddingIdentityChanged:m,staleAfter:d}),f=Ba(s,i),g=Ba(d,i),h=uv(r,a.semanticRuntimeAvailable,s);return{check:{name:"vectorization",status:p.length===0?"ok":"warn",ok:p.length===0,details:{semantic_runtime_available:a.semanticRuntimeAvailable,compatibility_mode_auto_defaults:a.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_applied:a.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:a.runtimeDefaults.auto_ollama_defaults_skipped_reason??null,auto_ollama_defaults_remediation:a.runtimeDefaults.auto_ollama_defaults_remediation??null,refresh_policy:dv(r),...ku(t,a),embedding_identity_changed:m,embedding_identity_before:o.embedding??null,embedding_identity_runtime:a.runtimeEmbeddingIdentity??null,items:n.length,ledger_entries_before:Object.keys(o.entries).length,stale_items_detail_mode:i?"full":"summary",stale_items_summary_limit:hu,stale_items_before_total:f.total,stale_items_before:f.values,stale_items_before_truncated:f.truncated,refresh_attempted:h,refresh_skipped_reason:lv(r,a.semanticRuntimeAvailable,s),refresh_result:c,ledger_entries_after:Object.keys(l.entries).length,stale_items_after_total:g.total,stale_items_after:g.values,stale_items_after_truncated:g.truncated}},warnings:p}}function pv(e){let t=[];return e.id_prefix.trim().length===0&&t.push("settings:id_prefix_empty"),e.locks.ttl_seconds<=0&&t.push("settings:locks_ttl_non_positive"),t}function xu(e){let t=e.checkOnly===!0,n=e.refreshVectors===!0;if(n&&t)throw new y("--check-only cannot be combined with --refresh-vectors",_.USAGE);if(n&&e.noRefresh===!0)throw new y("--no-refresh cannot be combined with --refresh-vectors",_.USAGE);return{enabled:n,checkOnly:t,noRefresh:!n,refreshVectors:n}}var fv=new Set(["extensions","locks","search"]);function hv(e){let t=new Set(Do.filter(i=>i.length>0)),n=new Set,r=new Set(Object.values(Po));for(let i of e.folders)t.has(i)&&!r.has(i)||(t.delete(i),n.add(i));for(let i of fv)t.delete(i),n.add(i);return{requiredDirs:[...t].sort((i,a)=>i.localeCompare(a)),optionalDirs:[...n].sort((i,a)=>i.localeCompare(a)),optionalDirSet:n}}async function gv(e,t,n){let{requiredDirs:r,optionalDirs:i,optionalDirSet:a}=hv(t),o=[],s=[],c=[];for(let l of[...r,...i]){let d=fe.join(e,l);c.push(...await He({path:d,scope:"project"})),!await Va(d)&&(a.has(l)?s.push(l):o.push(l))}return{requiredDirs:r,optionalDirs:i,missingRequiredDirs:o,missingOptionalDirs:s,missingDirs:n?[...o,...s]:[...o],hookWarnings:c}}function Su(e){let t=e.checkOnly===!0&&e.brief!==!0&&e.summary!==!0&&e.full!==!0,n=(e.summary===!0||t)&&e.full!==!0,r=e.checkOnly===!0&&(e.brief===!0||e.summary===!0)&&e.full!==!0;return{summaryMode:n,skipIntegrity:(e.skipIntegrity===!0||r)&&e.full!==!0,skipDrift:(e.skipDrift===!0||r)&&e.full!==!0,skipVectors:(e.skipVectors===!0||r)&&e.full!==!0}}async function _v(e){return e.skipPolicy.skipDrift&&e.skipPolicy.skipVectors?Je(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema):cr(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema)}function qa(e){return{check:{name:e,status:"ok",ok:!0,details:{skipped:!0}},warnings:[]}}function yv(e,t,n){return{name:"settings",status:n.length===0?"ok":"warn",ok:n.length===0,details:{path:e,version:t.version,id_prefix:t.id_prefix,locks_ttl_seconds:t.locks.ttl_seconds,warnings:n}}}function wv(e,t){return{name:"directories",status:e.missingDirs.length===0?"ok":"warn",ok:e.missingDirs.length===0,details:{required:e.requiredDirs,optional:e.optionalDirs,missing_required:e.missingRequiredDirs,missing_optional:e.missingOptionalDirs,missing:e.missingDirs,strict_directories:t}}}function vv(e){return{name:"settings_values",status:e.length===0?"ok":"warn",ok:e.length===0,details:{warnings:e}}}var Ka=e=>e.unknown_event_count??0,Ya=e=>e.actionable_unknown_event_count??Ka(e);function bv(e,t,n,r,i,a,o){let s=Ka(r),c=Ya(r),l=s>0,d=c>0,u=i.count>0;return{name:"storage",status:n.over_threshold.length===0&&n.orphaned.length===0&&!d&&!u?"ok":"warn",ok:n.over_threshold.length===0&&n.orphaned.length===0&&!d&&!u,details:{items:e.length,history_streams:n.count,tombstones:{retention_policy:"retain_append_only",gc_enabled:!1,count:n.tombstones.length,ids:n.tombstones.slice(0,25),truncated:n.tombstones.length>25},orphaned_history_streams:{count:n.orphaned.length,ids:n.orphaned.slice(0,25),truncated:n.orphaned.length>25},...l?{author_attribution:r}:{},...u?{stale_in_progress:i}:{},...a.length>0?{provenance_resolver_outcomes:a}:{},...o.length>0?{provenance_invalid_values:o}:{},...n.max_entries!==null?{compact_policy:{enabled:t.history.compact_policy.enabled,max_entries:n.max_entries,trigger:t.history.compact_policy.trigger,over_threshold_count:n.over_threshold.length,over_threshold:n.over_threshold}}:{}}}}function Eu(e){let t=e.count===0?[]:[`stale_in_progress_items:${e.count}`];return{scan:e,warnings:t}}function kv(e){let t=[...e.directoryState.missingDirs.map(n=>`missing_directory:${n}`),...e.normalizedSettingsReadWarnings,...e.settingWarnings,...e.normalizedItemReadWarnings,...e.telemetryCheck.warnings,...e.extensionCheck.warnings,...e.historyPolicyWarnings,...e.historySummary.warnings,...e.authorAttributionWarnings,...e.staleInProgressWarnings,...e.provenanceWarnings,...e.locksCheck.warnings,...e.integrityCheck.warnings,...e.historyDriftCheck.warnings,...e.vectorizationCheck.warnings,...e.directoryState.hookWarnings];return[...new Set(t)]}function xv(e){let t=e.check.details.counts;return typeof t?.drifted=="number"?t.drifted:0}function Sv(e){return{settings:e.normalizedSettingsReadWarnings,directories:e.directoryState.missingDirs.map(t=>`missing_directory:${t}`).concat(e.directoryState.hookWarnings),settings_values:e.settingWarnings,telemetry:e.telemetryCheck.warnings,extensions:e.extensionCheck.warnings,storage:[...e.historyPolicyWarnings,...e.historySummary.over_threshold.map(t=>`history_stream_over_compact_threshold:${t}`),...e.authorAttributionWarnings,...e.staleInProgressWarnings,...e.provenanceWarnings],locks:e.locksCheck.warnings,integrity:[...e.normalizedItemReadWarnings,...e.integrityCheck.warnings],history_drift:e.historyDriftCheck.warnings,vectorization:e.vectorizationCheck.warnings}}function Au(e){let t=new Map;for(let[i,a]of Object.entries(e.remediationSources))for(let o of a)t.has(o)||t.set(o,i);let n=new Map(e.checks.map(i=>[i.name,i]));return e.warnings.map(i=>{let a=t.get(i)??"integrity",o=Xi(i)?.code??Ja(i),s=n.get(a)?.details,l=(typeof s?.remediation_map=="object"&&s.remediation_map!==null?s.remediation_map:{})[o],d=Ha(i,e.requireMergeDrivers)?"advisory":"gate_failing";return{warning:i,code:o,check:a,severity:d,...typeof l=="string"?{remediation:l}:d==="gate_failing"?{disposition:"no_safe_automatic_remediation"}:{}}})}function Ev(e){if(e.check.name==="history_drift"&&e.historyDriftedCount>1)for(let t of Object.keys(e.remediationMap))e.remediationMap[t]="pm history-repair --all";if(e.check.name==="storage"&&e.overThresholdCount>1)for(let t of Object.keys(e.remediationMap))e.remediationMap[t]="pm history-compact --all-streams"}function Av(e){for(let t of e.checks){let n=Zi(e.remediationSources[t.name]);Ev({check:t,remediationMap:n,historyDriftedCount:e.historyDriftedCount,overThresholdCount:e.overThresholdCount}),Object.keys(n).length>0&&(t.details={...t.details,remediation_map:n})}}function Ru(e,t,n){let r=e.warning_count??e.warnings.length,i={...e,warning_count:r,warning_limit:Rn,warnings_truncated:r>Rn,warnings:e.warnings.slice(0,Rn),findings:(e.findings??[]).filter(o=>e.warnings.slice(0,Rn).includes(o.warning)||e.failed_because.includes(o.warning))},a=n?Gw(i):t.brief===!0?qw(i):i;return{...a,warning_count:r,warning_limit:Rn,warnings_truncated:r>a.warnings.length,...a.projection?{projection:{...a.projection,warning_count:r,warnings_truncated:r>a.warnings.length}}:{}}}async function Iu(e,t={}){let n=L(process.cwd(),e.path),r=K(n);if(!await A(r))throw new y(`Tracker is not initialized at ${n}. Run pm init first.`,_.NOT_FOUND);let{settings:i,warnings:a}=await bs(n),o=[...new Set(a)],s=q(i,z()),c=t.strictDirectories===!0,l=xu(t),d=await gv(n,s,c),u=pv(i),m=await tv(i,{checkTelemetry:t.checkTelemetry===!0}),p=await Lw(n,i,!!e.noExtensions),f=Su(t),g=[],h=await _v({pmRoot:n,settings:i,typeRegistry:s,skipPolicy:f,itemReadWarnings:g}),w=h,v=[...new Set(g)],b=f.skipDrift?{warnings:[]}:await ks({pmRoot:n,settings:i,itemIds:h.map(fi=>fi.id),commandLabel:"health"}),x=await Aw(n,i.history.compact_policy,await Sw(n)),R=await mn(n,20,t.verboseAuthorEvents===!0),k=Ya(R),F=k>0?[`history_unknown_author_events:${k}`]:[],T=Eu(await Ws(n,h,{in_progress_status:i.schema.workflow.in_progress_status,threshold_hours:i.mutation_guard.stale_in_progress_hours})),E=await Lc(n),U=E.outcomes,B=E.invalid_values,D=E.warnings,W=await nv(n),_e=f.skipIntegrity?qa("integrity"):await $w(n,s.type_to_folder,i.schema,t.requireMergeDrivers===!0),me=f.skipDrift?qa("history_drift"):await rv(n,w),Ge=f.skipVectors?qa("vectorization"):await mv(n,i,w,l,t.verboseStaleItems===!0),Pe=[yv(r,i,o),wv(d,c),vv(u),m.check,p.check,bv(h,i,x,R,T.scan,U,B),W.check,_e.check,me.check,Ge.check],M=kv({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:b.warnings,historySummary:x,authorAttributionWarnings:F,staleInProgressWarnings:T.warnings,provenanceWarnings:D,locksCheck:W,integrityCheck:_e,historyDriftCheck:me,vectorizationCheck:Ge}),H=Sv({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:b.warnings,historySummary:x,authorAttributionWarnings:F,staleInProgressWarnings:T.warnings,provenanceWarnings:D,locksCheck:W,integrityCheck:_e,historyDriftCheck:me,vectorizationCheck:Ge});Av({checks:Pe,remediationSources:H,historyDriftedCount:xv(me),overThresholdCount:x.over_threshold.length});let mi=M.filter(fi=>!Ha(fi,t.requireMergeDrivers===!0)),pi=Au({warnings:M,checks:Pe,remediationSources:H,requireMergeDrivers:t.requireMergeDrivers===!0}),bp={ok:mi.length===0,checks:Pe,warnings:M,findings:pi,failed_because:mi,generated_at:$()};return Ru(bp,t,f.summaryMode)}var jT={buildExtensionHealthTriageSummary:yu,buildHealthFindings:Au,buildCapabilityContractMetadata:En,buildStaleInProgressHealthSummary:Eu,buildVectorizationProviderDetails:ku,collectUnknownCapabilityGuidance:Sn,isAdvisoryHealthWarning:Ha,isDirectory:Va,isExpectedUnmanagedExtension:Ga,listItemDocumentPaths:_u,normalizeEndpointForDisplay:Vr,normalizeExtensionNameForMatch:Vt,parseTelemetryQueue:vu,probeTelemetryEndpointHealth:bu,projectHealthResult:Ru,resolveActionableUnknownAuthorEventCount:Ya,resolveHealthSkipPolicy:Su,resolveUnknownAuthorEventCount:Ka,resolveVectorRefreshPolicy:xu,selectStaleItemDetail:Ba,summarizeHealthCheckDetails:wu,summarizeExtensionList:Jr,summarizeRecordList:et,summarizeStringList:V,telemetryEnvFlagEnabled:Jt,warningCode:Ja};import Kt from"node:fs/promises";import Yt from"node:path";(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]="59b566d5-1d4f-500b-98e3-004e6f57d2b4")}catch{}})();async function Rv(e,t){let n=[...new Set(Object.values(t))],r=[];return await Promise.all(n.map(async i=>{let a;try{a=await Kt.readdir(Yt.join(e,i))}catch{return}for(let o of a)for(let s of tn)if(o.toLowerCase().endsWith(s)){r.push({relativePath:`${i}/${o}`,id:o.slice(0,-s.length)});break}})),r.sort((i,a)=>i.relativePath.localeCompare(a.relativePath))}function Iv(e,t){let{id:n,relativePath:r,liveItemIds:i,out:a}=e,o=$t(t);if(o){a.conflictMarkers.push({id:n,path:r,line:o.line,detail:`unresolved merge conflict marker ${o.marker}`});return}let s=null,c=t.split(/\r?\n/).map((l,d)=>({content:l.trim(),number:d+1})).filter(l=>l.content.length>0);for(let l of c)try{let d=JSON.parse(l.content);if(typeof d!="object"||d===null||Array.isArray(d))throw new TypeError("history entry must be an object");s=d}catch{a.unparseable.push({id:n,path:r,line:l.number,detail:"history line is not a valid JSON object"});return}s!==null&&(s.op==="delete"&&i.has(n)&&a.resurrected.push({id:n,deleted_at:typeof s.ts=="string"?s.ts:"",deleted_by:typeof s.author=="string"?s.author:""}),s.op==="history_repair"&&Array.isArray(s.patch)&&s.patch.length>0&&(a.repairReconciliations+=1))}function Xa(e,t){let n=typeof t=="object"&&t!==null&&"code"in t&&typeof t.code=="string"?t.code:"UNKNOWN";return`${e} could not be read (error code: ${n})`}async function Cv(e,t){let n={conflictMarkers:[],unparseable:[],resurrected:[],repairReconciliations:0,scanned:0},r;try{r=await Kt.readdir(Yt.join(e,"history"))}catch{return n}for(let i of r.sort((a,o)=>a.localeCompare(o))){if(!i.endsWith(".jsonl"))continue;n.scanned+=1;let a;try{a=await Kt.readFile(Yt.join(e,"history",i),"utf8")}catch(o){n.unparseable.push({id:i.slice(0,-6),path:`history/${i}`,detail:Xa("history stream",o)});continue}Iv({id:i.slice(0,-6),relativePath:`history/${i}`,liveItemIds:t,out:n},a)}return n}function Cu(e){let t=$t(e);if(t)return`unresolved merge conflict marker ${t.marker} at line ${t.line}`;try{return JSON.parse(e),null}catch(n){return`invalid JSON (${String(n)})`}}async function $v(e){let t=[],n=0,r=null;try{r=await X(K(e))}catch(a){n+=1,t.push({path:"settings.json",detail:Xa("configuration file",a)})}if(r!==null){n+=1;let a=Cu(r);a!==null&&t.push({path:"settings.json",detail:a})}let i;try{i=await Kt.readdir(Yt.join(e,"schema"))}catch{return{scanned:n,unparseable:t}}for(let a of i.sort((o,s)=>o.localeCompare(s))){if(!a.endsWith(".json"))continue;n+=1;let o;try{o=await Kt.readFile(Yt.join(e,"schema",a),"utf8")}catch(c){t.push({path:`schema/${a}`,detail:Xa("configuration file",c)});continue}let s=Cu(o);s!==null&&t.push({path:`schema/${a}`,detail:s})}return{scanned:n,unparseable:t}}async function $u(e,t,n,r={}){let i=await Rv(e,n),a=new Set(i.map(u=>u.id)),o=new Map;for(let u of i){let m=o.get(u.id);m===void 0?o.set(u.id,[u.relativePath]):m.push(u.relativePath)}let s=[...o.entries()].filter(([,u])=>u.length>1).map(([u,m])=>({id:u,paths:[...m].sort((p,f)=>p.localeCompare(f))})).sort((u,m)=>u.id.localeCompare(m.id)),c=(await Promise.all(i.map(async u=>{if(!t.has(u.id))return{path:u.relativePath,id:u.id};try{let m=Yt.join(e,u.relativePath);return Tt(await Kt.readFile(m,"utf8"),{format:m.toLowerCase().endsWith(".md")?"json_markdown":"toon",schema:r.schema,extensionFieldNames:r.extensionFieldNames}),null}catch{return{path:u.relativePath,id:u.id}}}))).filter(u=>u!==null),l=await Cv(e,a),d=await $v(e);return{item_files_on_disk:i.length,item_ids_on_disk:a.size,parsed_items:t.size,unreadable_item_files:c,duplicate_item_ids:s,history_streams_scanned:l.scanned,history_conflict_marker_streams:l.conflictMarkers,history_unparseable_streams:l.unparseable,resurrected_items:l.resurrected,history_repair_reconciliations:l.repairReconciliations,config_files_scanned:d.scanned,unparseable_config_files:d.unparseable}}import{execFile as Tv}from"node:child_process";import Tu from"node:path";(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]="b8b3f729-be32-5a77-b08f-f616ee068e0f")}catch{}})();function Ou(e,t){return new Promise((n,r)=>{Tv("git",[...t],{cwd:e,encoding:"utf8",maxBuffer:4*1024*1024},(i,a)=>{i?r(i):n(a)})})}function Du(e){if(e&&(!Number.isSafeInteger(e.start)||!Number.isSafeInteger(e.end)||e.start<1||e.end<e.start))throw new RangeError("Source line range must be inclusive positive integers with end >= start.")}function XT(e){let t=/^(\d+):(\d+)$/u.exec(e.trim()),n=t?{start:Number(t[1]),end:Number(t[2])}:void 0;if(Du(n),!n)throw new RangeError("Source line range must use start:end.");return n}function Ov(e){let t=new Map;for(let n of e.split(`
43
+ `)){let r=/^([0-9a-f^]{40,64}) \d+ \d+(?: \d+)?$/u.exec(n)?.[1];r&&t.set(r,(t.get(r)??0)+1)}return t}function Dv(e){let t=e.split("\0"),n=new Map;for(let r=0;r+1<t.length;r+=2){let i=t[r]?.trim();if(!i)continue;let a=[...new Set(t[r+1]?.match(/\bpm-[a-z0-9][a-z0-9-]{2,63}\b/gu)??[])].sort((o,s)=>o.localeCompare(s));n.set(i,a)}return n}async function Pv(e){let t=Tu.relative(e.workspaceRoot,Tu.resolve(e.workspaceRoot,e.sourcePath)),n=await Ou(e.workspaceRoot,["blame","--line-porcelain","-L",`${e.lineRange.start},${e.lineRange.end}`,"--",t]),r=await Ou(e.workspaceRoot,["log","-n","256","--format=%H%x00%B%x00","--",t]);return{commitLines:Ov(n),commitItems:Dv(r),available:!0}}function Nv(e){let t=e.current.nodes.at(-1),n=e.current.kinds.length+1,r;for(let i of e.graph.incidentEdges(t)){let a=i.source===t,o=a?i.target:i.source;if((e.visitedDepth.get(o)??Number.POSITIVE_INFINITY)<n)continue;e.visitedDepth.set(o,n);let s=e.graph.registry().require(i.kind),c={nodes:[...e.current.nodes,o],kinds:[...e.current.kinds,a?i.kind:s.inverse??i.kind]};e.details.get(o)?.type?.toLowerCase()==="decision"?(r=n,e.found.push(c)):e.queue.push(c)}return r}function Mv(e){let t=[{nodes:[e.itemId],kinds:[]}],n=new Map([[e.itemId,0]]),r=[],i;for(;t.length>0;){let a=t.shift(),o=a.kinds.length;i!==void 0&&o>=i||o>=e.maxDepth||(i=Nv({current:a,graph:e.graph,details:e.details,visitedDepth:n,queue:t,found:r})??i)}return r.sort((a,o)=>a.nodes.join("\0").localeCompare(o.nodes.join("\0"))),r}function Lv(e,t,n){let r=Ks(t);if(!r.graph.hasNode(e))return{status:"not_found",nodes:[],kinds:[],alternative_decision_ids:[]};let i=Mv({itemId:e,maxDepth:n,graph:r.graph,details:new Map(r.details.map(s=>[s.id,s]))}),a=i[0];if(!a)return{status:"not_found",nodes:[],kinds:[],alternative_decision_ids:[]};let o=[...new Set(i.map(s=>s.nodes.at(-1)))];return{status:o.length===1?"found":"ambiguous",nodes:a.nodes,kinds:a.kinds,alternative_decision_ids:o.slice(1)}}async function Fv(e){if(!e.lineRange)return{commitLines:new Map,commitItems:new Map,available:!0};try{return await Pv({workspaceRoot:e.workspaceRoot,sourcePath:e.paths[0],lineRange:e.lineRange})}catch{return{commitLines:new Map,commitItems:new Map,available:!1}}}function jv(e){let t=[];return e.hasLineRange&&!e.attributionAvailable&&t.push("git_attribution_unavailable"),e.hasLineRange&&e.contributionLines===0&&t.push("line_attribution_unmapped"),e.decisionStatus==="ambiguous"&&t.push("multiple_governing_decisions"),e.decisionStatus==="not_found"&&t.push("governing_decision_not_found"),t}function Uv(e){return[...e.commitLines.keys()].filter(t=>(e.commitItems.get(t)?.length??0)>0)}async function Pu(e){Du(e.lineRange);let t=e.decisionDepth??8;if(!Number.isSafeInteger(t)||t<1||t>32)throw new RangeError("Decision path depth must be an integer from 1 to 32.");let n=await Fv(e),r=Uv(n),i=new Map;for(let a of e.candidates){let o=[...n.commitLines.entries()].filter(([d])=>n.commitItems.get(d)?.includes(a.item.id)),s=o.reduce((d,[,u])=>d+u,0),c=Lv(a.item.id,e.corpus,t),l=jv({hasLineRange:e.lineRange!==void 0,attributionAvailable:n.available,contributionLines:s,decisionStatus:c.status});i.set(a.item.id,{score:s*100+a.files.length*10+Math.max(0,9-Math.floor((Date.now()-Date.parse(a.item.updated_at))/(720*60*60*1e3))),contribution_lines:s,evidence:[...a.files.map(d=>({kind:"linked_file",reference:d.path})),...o.map(([d,u])=>({kind:"git_commit",reference:d.slice(0,12),contribution_lines:u}))],rationale:{value:a.item.value?.trim()||null,why_now:a.item.why_now?.trim()||null,outcome:a.item.outcome?.trim()||null,objective:a.item.objective?.trim()||null},decision_path:c,ambiguities:l})}return{explanations:i,receipt:{line_range:e.lineRange??null,blamed_commit_count:n.commitLines.size,mapped_commit_count:r.length,unmapped_commit_count:n.commitLines.size-r.length,decision_depth:t}}}import mo from"node:fs/promises";import{realpathSync as Bb}from"node:fs";import{execFile as Hb}from"node:child_process";import he from"node:path";import{promisify as Jb}from"node:util";(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]="ab236f47-a866-5236-b8da-f7f23140b978")}catch{}})();var zv=["metadata","resolution"],Za=["metadata","resolution","estimates","lifecycle"],qv="completed";function Qa(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function Nu(e){let t=e?.trim();return t!==void 0&&t.length>0?t:void 0}function Mu(e){let t=[];for(let n of e){if(!n.missing_fields.includes("resolution"))continue;let r=Nu(n.close_reason)??qv;t.push({item_id:n.id,check:"resolution",field:"resolution",kind:"set_resolution",value:r,command:`pm update ${n.id} --resolution ${Qa(r)}`,gate:"resolution"})}return t}function Lu(e){let t=[];for(let n of e){let r=Nu(n.resolution);r!==void 0&&t.push({item_id:n.id,check:"metadata",field:"close_reason",kind:"set_close_reason",value:r,command:`pm update ${n.id} --close-reason ${Qa(r)}`,gate:"metadata"})}return t}function Fu(e,t){return e.map(n=>{let r=vs(n.type,t);return{item_id:n.id,check:"metadata",field:"estimated_minutes",kind:"set_estimate",value:String(r),command:`pm update ${n.id} --estimate ${r}`,gate:"estimates"}})}function ju(e){return e.map(t=>t.grandparent_id!==void 0&&t.grandparent_active===!0?{item_id:t.id,check:"lifecycle",field:"parent",kind:"reparent",parent_id:t.grandparent_id,command:`pm update ${t.id} --parent ${t.grandparent_id}`,gate:"lifecycle"}:{item_id:t.id,check:"lifecycle",field:"parent",kind:"unset_parent",command:`pm update ${t.id} --unset parent`,gate:"lifecycle"})}function Uu(e){let t=[];for(let n of e){if(n.classification!=="deleted")continue;let r=n.link_kind==="files"?"files":"docs";t.push({item_id:n.item_id,check:"files",field:n.link_kind,kind:n.link_kind==="files"?"prune_file_link":"prune_doc_link",path:n.path,command:`pm ${r} ${n.item_id} --remove ${Qa(n.path)}`})}return t}function zu(e){let t=(e??[]).flatMap(r=>r.split(",")).map(r=>r.trim()).filter(r=>r.length>0);if(t.length===0){if(e!==void 0&&e.length>0)throw new y(`--fix-scope values must not be empty. Supported values: ${Za.join(", ")}.`,_.USAGE);return new Set(zv)}let n=new Set;for(let r of t){let i=r.toLowerCase().replaceAll("-","_");if(Za.includes(i)){n.add(i);continue}throw new y(`Unknown --fix-scope value "${r}". Supported values: ${Za.join(", ")}.`,_.USAGE)}return n}function qu(e,t){let n=[],r=[];for(let i of e)i.gate!==void 0&&!t.has(i.gate)?r.push(i):n.push(i);return{applicable:n,gated:r}}function Cn(e){return{item_id:e.item_id,check:e.check,field:e.field,command:e.command,...e.gate!==void 0?{gate:e.gate}:{}}}(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]="087bac58-e32d-5cb8-8fda-0e09075c3f35")}catch{}})();var Gv=/^([A-Z][A-Z0-9]*-\d+)\b/;function Wv(e){if(typeof e!="string")return null;let t=e.trim().toUpperCase();if(t.length===0)return null;let n=Gv.exec(t);return n?n[1]:null}function Gu(e){return typeof e=="string"&&e.trim().length>0}function Wu(e){let t=new Map;for(let r of e){if(typeof r.title!="string"||Gu(r.duplicate_of))continue;let i=Wv(r.title);if(i===null)continue;let a=t.get(i);a||(a=[],t.set(i,a)),a.some(o=>o.id===r.id)||a.push({id:r.id,title:r.title,parent:Gu(r.parent)?r.parent.trim():null})}let n=[];for(let[r,i]of t){if(i.length<2)continue;let a=new Set(i.map(c=>c.id.toLowerCase())),o=i.filter(c=>c.parent===null||!a.has(c.parent.toLowerCase()));if(o.length<2)continue;let s=[...o].sort((c,l)=>c.id.localeCompare(l.id));n.push({code:r,count:s.length,ids:s.map(c=>c.id),titles:s.map(c=>c.title)})}return n.sort((r,i)=>r.code.localeCompare(i.code))}(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]="1951b0f1-11fa-5728-b516-7458a55b1e29")}catch{}})();function Bu(e){let t=new Map;for(let r of e){let i=t.get(r.item_type);i||(i=new Map,t.set(r.item_type,i)),i.set(r.field,(i.get(r.field)??0)+1)}let n={};for(let r of[...t.keys()].sort((i,a)=>i.localeCompare(a))){let i=t.get(r),a={};for(let o of[...i.keys()].sort((s,c)=>s.localeCompare(c)))a[o]=i.get(o);n[r]=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]="5a5b0bd8-d99b-52fb-82ae-52ba48c54c30")}catch{}})();var Hu=3;function Ju(e){let t=Math.max(e.lastIndexOf("/"),e.lastIndexOf("\\"));return t===-1?e:e.slice(t+1)}function Vu(e,t,n=Hu){let r=Number.isFinite(n)&&n>=1?Math.floor(n):Hu,i=new Map;for(let a of t){let o=Ju(a);if(o.length===0)continue;let s=i.get(o);s?s.push(a):i.set(o,[a])}return e.map(a=>{let o=(i.get(Ju(a))??[]).filter(s=>s!==a).sort((s,c)=>s.localeCompare(c));return o.length===0?{path:a,classification:"deleted",candidates:[],candidates_truncated:!1}:{path:a,classification:"moved",candidates:o.slice(0,r),candidates_truncated:o.length>r}})}function Ku(e){return e.map(t=>t.classification==="moved"?`${t.path}:moved:${t.candidates[0]}`:`${t.path}:deleted`)}(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]="2b9ba0a4-396f-5870-bc89-e7fc789bb49d")}catch{}})();var Bv=/^[a-z][a-z0-9+.-]+:\/\//i;function $n(e){return Bv.test(e.trim())}(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]="e063d634-4306-5725-927a-5f2af1722458")}catch{}})();function Hv(e,t){return e==="moved"||t==="moved"?"moved":"deleted"}function Yu(e){return`${e.item_id} ${e.link_kind}`}function Xu(e,t){let n=new Map;for(let r of e){let i=n.get(r.path);i?(i.classification=Hv(i.classification,r.classification),i.owners.set(Yu(r),r)):n.set(r.path,{classification:r.classification,owners:new Map([[Yu(r),r]])})}return[...n.entries()].sort(([r],[i])=>r.localeCompare(i)).map(([r,i])=>({path:r,classification:i.classification,items:[...i.owners.values()].map(a=>{let o=t(a.item_id);return{id:a.item_id,type:o?.type??"Unknown",title:o?.title??"",status:o?.status??"",field:a.link_kind}}).sort((a,o)=>{let s=a.id.localeCompare(o.id);return s!==0?s:a.field.localeCompare(o.field)})}))}function Jv(e){return e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}function Zu(e){let t=[];for(let n of e)for(let r of n.items)t.push(`${n.path}:${n.classification} owner=${r.id} status=${r.status} field=${r.field} title="${Jv(r.title)}"`);return t}import Vv from"node:fs/promises";import Ce from"node:path";import Kv from"fast-glob";(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]="72f57c4d-65c5-57f1-a16a-f6c970aca680")}catch{}})();var Yv=["path","scope","note"],Xv=["pattern","glob","path","scope","note"],Zv=["path"],Qv=["from","to"],eb=new Set(["note","scope"]);function em(e){let t=e??"project";if(!hi.includes(t))throw new y(`Invalid scope "${e}". Valid scopes: ${hi.join(", ")} (default: project).`,_.USAGE);return t}function to(e){if(e.startsWith("```")||e.includes(`
44
+ `)||/^(?:[-*+]\s+)?(?:path|scope|note)\s*[:=]/i.test(e))return!0;let t=e.indexOf("=");return t>=0&&!/\s/u.test(e)&&(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(e)||/^(?:[A-Za-z]:[\\/]|[\\/]{1,2}|\.\.?(?:[\\/]))/u.test(e)||[e.indexOf("/"),e.indexOf("\\")].some(n=>n>=0&&n<t))?!1:e.includes("=")||$s(e)}function tb(e){return e.flatMap(t=>{let n=t.trim();return n.length===0||to(n)||!n.includes(",")?[t]:ur(n)})}function nb(e){let t=0;for(let n of e)if(n==="("&&(t+=1),n===")"&&(t-=1),t<0)return!1;return t===0}function rb(e){if(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(e)&&!to(e))return{path:e,scope:"project",note:void 0};let t=e.indexOf("](");if(e.startsWith("[")&&t>0&&e.endsWith(")")){let a=e.slice(t+2,-1).trim();if(a.length>0&&nb(a))return{path:a,scope:"project",note:e.slice(1,t).trim()||void 0}}let n=e.indexOf(",");if(n<0)return;let r=e.slice(0,n).trim(),i=e.slice(n+1).trim();if(!(r.length===0||!/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(i)))return{path:i,scope:"project",note:r}}function ib(e,t){return e?e.flatMap(n=>{let r=n.trim();if(t==="doc"){let i=rb(r);if(i!==void 0)return[i]}return tb([n]).map(i=>{let a=i.trim(),o=to(a)?nn(i,"--add"):{path:a};if(rn(o,"--add",Yv),!o.path)throw new y(`--add requires path=<value> or a bare ${t} path`,_.USAGE);return{path:o.path,scope:em(o.scope),note:o.note?.trim()||void 0}})}):[]}function ab(e){return e?e.map(t=>{let n=t.trim();if(!n)throw new y("--add-glob requires a glob pattern value",_.USAGE);if(n.includes("=")||/^(?:[-*+]\s+)?(?:pattern|glob|path)\s*[:=]/i.test(n)||n.startsWith("```")){let r=nn(n,"--add-glob");rn(r,"--add-glob",Xv);let i=r.pattern?.trim()||r.glob?.trim()||r.path?.trim();if(!i)throw new y("--add-glob key/value form requires pattern=<glob>",_.USAGE);return{pattern:i,scope:em(r.scope),note:r.note?.trim()||void 0}}return{pattern:n,scope:"project"}}):[]}function ob(e){return e?e.map(t=>{let n=t.trim();if(!n)throw new y("--remove requires a path value",_.USAGE);if(n.includes("=")||/^(?:[-*+]\s+)?path\s*[:=]/i.test(n)||n.startsWith("```")){let r=nn(n,"--remove"),i=Object.keys(r).filter(a=>eb.has(a.toLowerCase()));if(i.length>0)throw new y(`--remove identifies a linked artifact by path only and does not accept ${i.map(a=>`"${a}"`).join(", ")}. Pass just the path (path=<value>, path:<value>, or a bare path); record removal context with --message "<why removed>".`,_.USAGE);if(rn(r,"--remove",Zv),!r.path)throw new y("--remove key/value form requires path=<value>",_.USAGE);return r.path}return n}):[]}function sb(e){return e?e.map(t=>{let n=nn(t,"--migrate");rn(n,"--migrate",Qv);let r=n.from?.trim(),i=n.to?.trim();if(!r||!i)throw new y("--migrate requires from=<value> and to=<value>",_.USAGE);return{from:r,to:i}}):[]}function Tn(e,t){let n=e;for(let r of t)n.startsWith(r.from)&&(n=`${r.to}${n.slice(r.from.length)}`);return n}function cb(e,t,n=[]){if(e.length===0||t.length===0)return;let r=new Set(e.map(a=>Tn(a.path,n))),i=[...new Set(t.map(a=>Tn(a,n)).filter(a=>r.has(a)))].sort((a,o)=>a.localeCompare(o));if(i.length!==0)throw new y(`Linked artifact mutation cannot add and remove the same normalized path in one transaction: ${i.join(", ")}. Split the replacement into separate commands so each history event has one unambiguous intent.`,_.USAGE,{code:"linked_artifact_mutation_conflict",reason:"same_path_added_and_removed",required:"Use distinct normalized paths for --add and --remove in one invocation.",why:"Conflicting batch intent cannot be applied deterministically without silently discarding metadata or a removal.",nextSteps:["Run the removal and addition as separate commands with a --message describing each intent."]})}function nt(e){return e.split(Ce.sep).join("/")}function eo(e,t,n=process.cwd()){let r=e.trim();if($n(r))return r;if(Ce.isAbsolute(r)||/^[A-Za-z]:[\\/]/.test(r))return nt(r.replaceAll("\\",Ce.sep));let i=Ce.relative(t,n);return i.startsWith(`..${Ce.sep}`)||i===".."||Ce.isAbsolute(i)?nt(Ce.normalize(r)):nt(Ce.relative(t,Ce.resolve(n,r)))}async function lb(e,t=process.cwd(),n=process.cwd()){let r=[];for(let i of e){let a=Ce.isAbsolute(i.pattern),o=await Kv(i.pattern,{cwd:n,absolute:a,onlyFiles:!0,dot:!0,unique:!0,followSymbolicLinks:!0}),s=[...new Set(o.map(c=>eo(c,t,n)))].sort((c,l)=>c.localeCompare(l));for(let c of s)r.push({path:c,scope:i.scope,note:i.note})}return r}function db(e,t,n){if(t===void 0)return e;if(!n)throw new y("--note requires --add or --add-glob in the same invocation (the note annotates the links being added)",_.USAGE);let r=t.trim();return r.length===0?e:e.map(i=>i.note===void 0?{...i,note:r}:i)}function ub(e){return`${e.path}::${e.scope}`}function no(e){return[...e].sort((t,n)=>{let r=t.path.localeCompare(n.path);return r!==0?r:t.scope.localeCompare(n.scope)})}function ro(e){return[...new Map(e.map(t=>[ub(t),t])).values()].map(t=>({...t,note:t.note?.trim()||void 0}))}async function mb(e,t=process.cwd()){let n=[...new Set(e)].sort((s,c)=>s.localeCompare(c)),r=[],i=[],a=[],o=[];for(let s of n){if($n(s)){o.push(s.trim());continue}let c=Ce.isAbsolute(s)?s:Ce.resolve(t,s);try{(await Vv.stat(c)).isFile()?r.push(s):a.push(s)}catch(l){if(typeof l=="object"&&l!==null&&"code"in l&&zn(l)){i.push(s);continue}a.push(s)}}return{checked:n.length,existing_files:r,missing_paths:i,non_file_paths:a,remote_references:o}}function pb(e,t,n,r){let i=0;for(let o=0;o<e.length;o+=1){let s=Tn(e[o].path,r);s!==e[o].path&&(e[o]={...e[o],path:s},i+=1)}return{adds:t.map(o=>{let s=Tn(o.path,r);return s!==o.path&&(i+=1),{...o,path:s}}),removes:n.map(o=>Tn(o,r)),count:i}}function fb(e,t,n,r){for(let a of t)e.some(o=>o.path===a.path&&o.scope===a.scope)||e.push(a);if(n.length>0)for(let a=e.length-1;a>=0;a-=1)n.includes(e[a].path)&&e.splice(a,1);let i=ro(e);return r?i:no(i)}async function Qu(e){let t=e.artifacts.map(n=>n.path);return{id:e.id,artifacts:e.artifacts,changed:e.changed,count:e.artifacts.length,migrations_applied:e.migrationsApplied&&e.migrationsApplied>0?e.migrationsApplied:void 0,validation:e.options.validatePaths?await mb(t,e.workspaceRoot):void 0}}async function Kr(e,t,n,r){let{metadataKey:i}=r,a=Ts(),o=L(process.cwd(),n.path),s=pt(o),c=process.cwd();if(!await A(K(o)))throw new y(`Tracker is not initialized at ${o}. Run pm init first.`,_.NOT_FOUND);let l=await I(o),d=q(l,z()),u=await a.resolveList(t.add,"--add"),m=await a.resolveList(t.addGlob,"--add-glob"),p=await a.resolveList(t.remove,"--remove"),f=await a.resolveList(t.migrate,"--migrate"),g=ib(u,r.bareNoun).map(B=>({...B,path:eo(B.path,s,c)})),h=ab(m),w=await lb(h,s,c),v=db([...g,...w],t.note,g.length>0||h.length>0),b=ob(p).map(B=>eo(B,s,c)),x=sb(f);if(cb(v,b,x),!(v.length>0||b.length>0||x.length>0)){let B=await Ot(o,e,l.id_prefix,l.item_format,d.type_to_folder);if(!B)throw new y(`Item ${e} not found`,_.NOT_FOUND);let W=(await Dt(B,{schema:l.schema})).document.metadata[i]??[];return Qu({id:B.id,artifacts:W,changed:!1,options:t,workspaceRoot:s})}let k=Y(t.author,l.author_default),F=await ft({pmRoot:o,settings:l,id:e,op:r.op,author:k,message:t.message,force:t.force,skipNoop:!0,mutate(B){let D=B.metadata,W=D[i]??[],_e=[...W],me=pb(_e,v,b,x),Ge=fb(_e,me.adds,me.removes,r.supportsAppendStable&&t.appendStable===!0);Ge.length>0?D[i]=Ge:delete D[i];let Pe=!Wo(W,Ge);return{changedFields:Pe?[i]:[],warnings:Pe&&me.count>0?[`path_migrations_applied:${me.count}`]:[]}}}),T=F.item[i]??[],E=F.warnings.find(B=>B.startsWith("path_migrations_applied:")),U=E?Number(E.slice(24)):0;return Qu({id:F.item.id,artifacts:T,changed:F.changedFields.includes(i),migrationsApplied:U,options:t,workspaceRoot:s})}function Yr(e,t){let n={};for(let[r,i]of Object.entries(e))n[r==="artifacts"?t:r]=i;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]="c4c82f8f-7890-5ed2-8f0f-a82ba42cf807")}catch{}})();async function tm(e,t,n){let r=await Kr(e,t,n,{metadataKey:"docs",op:"docs_add",bareNoun:"doc",supportsAppendStable:!1});return Yr(r,"docs")}import nm from"node:fs/promises";import $e from"node:path";(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]="515cd35c-8e0e-51d4-8ad9-1cea5be8a572")}catch{}})();var hb=32768;function io(e){return nt($e.normalize(e))}async function Xr(e){try{return await nm.realpath(e)}catch{return $e.resolve(e)}}function Xt(e,t){let n=$e.isAbsolute(e.path)?$e.resolve(e.path):$e.resolve(t,e.path);return`${io(n)}::${e.scope}`}function Zr(e,t,n){if(typeof e=="string"){let r=e.trim();r.length>0&&n.push({field:t,value:r});return}if(Array.isArray(e)){e.forEach((r,i)=>Zr(r,`${t}[${i}]`,n));return}if(typeof e=="object"&&e!==null)for(let[r,i]of Object.entries(e))Zr(i,t?`${t}.${r}`:r,n)}function gb(e){let t=[];return Zr(e.metadata,"metadata",t),Zr(e.body,"body",t),t}function _b(e){let t=e.trim();return t=t.replace(/^[`"'<([{]+/u,""),t=t.replace(/[`"'>)\]},;!?]+$/u,""),t=t.replace(/[.]+$/u,""),t=t.replace(/:(?:\d+)(?::\d+)?$/u,""),t=t.replace(/[.]+$/u,""),t}function yb(e){let t=[],n=/(?:[A-Za-z]:[\\/]|\/)[^\s"'`<>()[\]{},;]+/gu,r=/(?:\.{1,2}[\\/])?(?:(?:[A-Za-z0-9_.@-]+[\\/])+[A-Za-z0-9_.@-]+|[A-Za-z0-9_.@-]+\.[A-Za-z0-9][A-Za-z0-9._-]*)/gu;for(let i of e){let a=new Set,o=i.value.slice(0,hb);for(let[s,c]of[[n,i.value],[r,o]]){s.lastIndex=0;for(let l of c.matchAll(s)){let d=_b(l[0]);!d||a.has(d)||(a.add(d),t.push({field:i.field,value:d}))}}}return t}async function wb(e,t,n=t){let r=$e.isAbsolute(e)?$e.resolve(e):$e.resolve(n,e),i;try{i=await nm.stat(r)}catch{return}if(!i.isFile())return;let[a,o]=await Promise.all([Xr(t),Xr(r)]);if(ye(a,o)){let s=$e.relative(a,o);return!s||s.startsWith("..")||$e.isAbsolute(s)?void 0:{path:io(s),scope:"project"}}return{path:io(r),scope:"global"}}async function vb(e,t,n=t){let r=new Set((e.metadata.files??[]).map(c=>Xt(c,t))),i=new Map,a=yb(gb(e)),o=new Map;await Promise.all([...new Set(a.map(c=>c.value))].map(async c=>{o.set(c,await wb(c,t,n))}));let s=a.map(c=>({reference:c,resolved:o.get(c.value)}));for(let{reference:c,resolved:l}of s){if(!l)continue;let d=Xt(l,t),u=i.get(d)??{path:l.path,scope:l.scope,sourceFields:new Set,originalPaths:new Set,sourceCount:0};u.sourceFields.add(c.field),u.originalPaths.add(c.value),u.sourceCount+=1,i.set(d,u)}return[...i.entries()].map(([c,l])=>({path:l.path,scope:l.scope,status:r.has(c)?"already_linked":"addable",source_count:l.sourceCount,source_fields:[...l.sourceFields].sort((d,u)=>d.localeCompare(u)),original_paths:[...l.originalPaths].sort((d,u)=>d.localeCompare(u))})).sort((c,l)=>{let d=c.status.localeCompare(l.status);if(d!==0)return d;let u=c.path.localeCompare(l.path);return u!==0?u:c.scope.localeCompare(l.scope)})}async function rm(e,t,n){let r=await Kr(e,t,n,{metadataKey:"files",op:"files_add",bareNoun:"file",supportsAppendStable:!0});return Yr(r,"files")}async function bb(e,t){let n=await Xr(t),r=await Promise.all(e.map(async a=>{let o=a.trim();if(!o)throw new y("Files lookup paths must not be empty.",_.USAGE);if(!$e.isAbsolute(o))return nt(o);let s=await Xr(o);return ye(n,s)?nt($e.relative(n,s)):nt(s)})),i=[...new Set(r)].sort((a,o)=>a.localeCompare(o));if(i.length===0)throw new y("Files lookup requires at least one path.",_.USAGE);return i}function kb(e){for(let[r,i]of[["limit",e.limit],["offset",e.offset]])if(i!==void 0&&(!Number.isInteger(i)||i<0))throw new y(`Files lookup ${r} must be a non-negative integer.`,_.USAGE);let{offset:t=0,limit:n=50}=e;return{offset:Math.max(0,Math.floor(t)),limit:e.noTruncate?void 0:Math.max(0,Math.floor(n))}}function im(e){return{id:e.id,title:e.title,type:e.type,status:e.status,priority:e.priority,updated_at:e.updated_at}}function am(e,t){let n=e.item.priority-t.item.priority;if(n!==0)return n;let r=t.item.updated_at.localeCompare(e.item.updated_at);return r===0?e.item.id.localeCompare(t.item.id):r}function xb(e){return e.metadata.map(t=>({item:t,files:(t.files??[]).filter(n=>e.paths.includes(nt(n.path))&&(e.scope===void 0||n.scope===e.scope)).sort((n,r)=>{let i=n.path.localeCompare(r.path);return i===0?n.scope.localeCompare(r.scope):i})})).filter(t=>t.files.length>0).sort(am)}async function Sb(e){if(e.explain)return Pu({workspaceRoot:e.workspaceRoot,paths:e.paths,candidates:e.matching,corpus:e.metadata,...e.lineRange?{lineRange:e.lineRange}:{},...e.decisionDepth===void 0?{}:{decisionDepth:e.decisionDepth}})}async function Eb(e){if([e.strictRead,e.noTruncate,e.explain,fs()].includes(!0))return null;let t=await sr(e.pmRoot,[...new Set(Object.values(e.typeToFolder))]);return t?Ss({pmRoot:e.pmRoot,expectedSourceCursor:t.source_cursor,paths:e.paths,scope:e.scope,limit:e.limit,offset:e.offset}):null}async function Ab(e){let t=[],n=await Pt(e.pmRoot,e.settings.item_format,e.typeToFolder,t,e.settings.schema),r=xb({metadata:n,paths:e.paths,scope:e.scope}),i=t.filter(c=>/^item_list_(?:item|directory)_read_failed:/u.test(c));if(e.strictRead&&i.length>0)throw new y(`Files lookup could not read every item: ${i.join("; ")}`,_.GENERIC_FAILURE);let a=await Sb({explain:e.explain,workspaceRoot:e.workspaceRoot,paths:e.paths,matching:r,metadata:n,lineRange:e.lineRange,decisionDepth:e.decisionDepth}),s=(a?[...r].sort((c,l)=>{let d=a.explanations.get(l.item.id).score-a.explanations.get(c.item.id).score;return d!==0?d:am(c,l)}):r).slice(e.offset,e.limit===void 0?void 0:e.offset+e.limit);return{paths:e.paths,total:r.length,count:s.length,offset:e.offset,limit:e.limit??null,has_more:e.offset+s.length<r.length,truncated:e.offset+s.length<r.length,completeness:{status:i.length===0?"complete":"partial",source:"source_scan"},warnings:t,matches:s.map(c=>({item:im(c.item),files:c.files,...a?{traceability:a.explanations.get(c.item.id)}:{}})),...a?{traceability_receipt:a.receipt}:{}}}async function W0(e,t){let n=L(process.cwd(),t.path),r=pt(n);if(!await A(K(n)))throw new y(`Tracker is not initialized at ${n}. Run pm init first.`,_.NOT_FOUND);let i=await bb(e.paths,r);if(e.lineRange&&i.length!==1)throw new y("Files lookup line attribution requires exactly one source path.",_.USAGE);let a=await I(n),o=q(a,z()),{offset:s,limit:c}=kb(e),l=await Eb({pmRoot:n,typeToFolder:o.type_to_folder,paths:i,scope:e.scope,limit:c,offset:s,strictRead:e.strictRead===!0,noTruncate:e.noTruncate===!0,explain:e.explain===!0||e.lineRange!==void 0});return l?{paths:i,total:l.total,count:l.matches.length,offset:s,limit:c,has_more:s+l.matches.length<l.total,truncated:s+l.matches.length<l.total,completeness:{status:"unchecked",source:"index"},warnings:[],matches:l.matches.map(d=>({item:im(d.item),files:d.files}))}:Ab({pmRoot:n,settings:a,typeToFolder:o.type_to_folder,paths:i,scope:e.scope,limit:c,offset:s,strictRead:e.strictRead===!0,workspaceRoot:r,explain:e.explain===!0||e.lineRange!==void 0,lineRange:e.lineRange,decisionDepth:e.decisionDepth})}async function B0(e,t,n){let r=L(process.cwd(),n.path),i=pt(r);if(!await A(K(r)))throw new y(`Tracker is not initialized at ${r}. Run pm init first.`,_.NOT_FOUND);let a=await I(r),o=q(a,z()),s=await Ot(r,e,a.id_prefix,a.item_format,o.type_to_folder);if(!s)throw new y(`Item ${e} not found`,_.NOT_FOUND);let c=await Dt(s,{schema:a.schema}),l=await vb(c.document,i,process.cwd()),d=l.filter(T=>T.status==="addable"),u=l.filter(T=>T.status==="already_linked"),m=t.apply===!0,p=t.note?.trim()||"discovered from item text";if(!m||d.length===0){let T=c.document.metadata.files??[];return{id:s.id,files:T,changed:!1,apply:m,count:T.length,candidate_count:l.length,addable_count:d.length,added_count:0,skipped_existing_count:u.length,candidates:l,added:[],skipped_existing:u}}let f=Y(t.author,a.author_default),g=d.map(T=>({path:T.path,scope:T.scope,note:p})),h=[],w=new Set,v=await ft({pmRoot:r,settings:a,id:e,op:"files_discover",author:f,message:t.message??"Discover referenced file links",force:t.force,mutate(T){let E=[...T.metadata.files??[]],U=new Set(E.map(W=>Xt(W,i)));h=[],w.clear();for(let[W,_e]of g.entries()){let me=Xt(_e,i);U.has(me)||(E.push(_e),U.add(me),h.push(_e),w.add(W))}let B=ro(E),D=t.appendStable?B:no(B);return D.length>0?T.metadata.files=D:delete T.metadata.files,{changedFields:h.length>0?["files"]:[],warnings:h.length!==g.length?[`files_discover_skipped_existing:${g.length-h.length}`]:[]}}}),b=v.item.files??[],x=new Set(h.map(T=>Xt(T,i))),R=b.filter(T=>x.has(Xt(T,i))),k=d.filter((T,E)=>!w.has(E)),F=[...u,...k];return{id:v.item.id,files:b,changed:R.length>0,apply:!0,count:b.length,candidate_count:l.length,addable_count:d.length,added_count:R.length,skipped_existing_count:F.length,candidates:l,added:R,skipped_existing:F}}import{readFileSync as Rb}from"node:fs";import Qr from"node:path";(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]="673a5a26-6214-58d6-af19-baee5a8359f0")}catch{}})();var Ib=new Set(["get","history","restore","update","close","delete","append","claim","release","comments","notes","learnings","files","docs","deps","test"]),ao=new Set(["--pm-path","--path","--author"]),Cb={get:new Set(["--depth","--fields","--tree-depth","--tree_depth","--at","--format"]),history:new Set(["--limit","--field","--format"]),restore:new Set(["--message"]),update:new Set(["--title","-t","--description","-d","--body","-b","--status","-s","--close-reason","--close_reason","--priority","-p","--type","--tags","--add-tags","--add_tags","--remove-tags","--remove_tags","--deadline","--estimated-minutes","--estimate","--estimated_minutes","--acceptance-criteria","--ac","--acceptance_criteria","--definition-of-ready","--definition_of_ready","--order","--rank","--goal","--objective","--value","--impact","--outcome","--why-now","--why_now","--message","--assignee","--parent","--reviewer","--risk","--confidence","--sprint","--release","--blocked-by","--blocked_by","--blocked-reason","--blocked_reason","--unblock-note","--unblock_note","--reporter","--severity","--environment","--repro-steps","--repro_steps","--resolution","--expected-result","--expected_result","--expected","--actual-result","--actual_result","--actual","--affected-version","--affected_version","--fixed-version","--fixed_version","--component","--regression","--customer-impact","--customer_impact","--dep","--dep-remove","--dep_remove","--comment","--note","--learning","--file","--test","--doc","--reminder","--event","--type-option","--type_option","--field","--unset","--body-file"]),close:new Set(["--reason","-r","--close-reason","--duplicate-of","-d","--message","-m","--validate-close","--resolution","--expected-result","--expected_result","--expected","--actual-result","--actual_result","--actual"]),delete:new Set(["--message"]),append:new Set(["--body","--text","--message"]),claim:new Set(["--assignee","--message","--type","--tag","--priority","--assignee-filter","--parent","--sprint","--release","--max-attempts"]),release:new Set(["--assignee","--message"]),comments:new Set(["--add","--body","--comment","--file","--edit","--delete","--limit","--message"]),notes:new Set(["--add","--file","--edit","--delete","--limit","--message"]),learnings:new Set(["--add","--file","--edit","--delete","--limit","--message"]),files:new Set(["--add","--add-glob","--remove","--migrate","--note","--message"]),docs:new Set(["--add","--add-glob","--remove","--migrate","--note","--message"]),deps:new Set(["--format","--max-depth","--collapse","--node-limit","--edge-limit","--token-budget","--cursor","--direction","--kind"]),test:new Set(["--add","--add-json","--remove","--match","--only-index","--timeout","--env-set","--env-clear","--pm-context","--message"])},$b=new Set(["-p","--package"]),Tb=new Set(["-c","--call"]),Ob=new Set(["-c","-C","--config","--dir","--filter","--workspace-dir"]),Db=new Set(["-C","--prefix","--userconfig","--cache"]),K0=new Set(["--cwd"]),Y0=new Set(["--cwd"]),Pb=new Set(["exec","x"]),X0=new Set(["run","run-script"]),Z0=new Set(["-C","--dir","--cwd","-w","--workspace","--filter"]);function Nb(e){return e.split(/&&|\|\||\||;/).map(t=>t.trim()).filter(t=>t.length>0)}function Mb(e,t=process.cwd()){let n=Lb(e.split(" ").filter(o=>o.length>0));if(n.length===0)return null;let[r,...i]=n;if(om(r)||sm(r,t))return i;if(r==="node"&&i[0]&&sm(i[0],t))return i.slice(1);let a=r==="npx"||r==="bunx"?oo(i):r==="pnpm"?Ub(i):r==="npm"?zb(i):null;return a&&(om(a.command)||jb(a.command))?a.args:null}var cm=(e,t="pm")=>{let n=t.trim().toLowerCase(),r=n.length;for(;r>0&&n[r-1]==="-";)r-=1;let i=n.slice(0,r);if(i.length===0)return[];let a=e.trim().replaceAll("\\","/").replaceAll('"',"").replaceAll("'","").replaceAll(/\s+/g," ").toLowerCase(),o=new Set;for(let s of Nb(a)){let c=Mb(s),l=c?qb(c):null,d=l&&Ib.has(l.subcommand)?Gb(l.remaining,Cb[l.subcommand]):void 0,u=d?.trim().toLowerCase();u?.startsWith(`${i}-`)===!0&&u.length>i.length+1&&o.add(d)}return[...o].sort((s,c)=>s.localeCompare(c))};function Lb(e){let t=0;for(e[t]==="env"&&(t+=1);t<e.length;){let n=e[t];if(/^(?:[a-z_][a-z0-9_]*|\$env:[a-z_][a-z0-9_]*)=.*/.test(n)){t+=1;continue}break}return e.slice(t)}function Q0(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(ao.has(n)){t+=2;continue}t+=1;continue}return n}}function om(e){return e==="pm"||e==="pm.cmd"||e==="pm.exe"||e.endsWith("/pm")||e.endsWith("/pm.cmd")||e.endsWith("/pm.exe")}function Fb(e){let t=e.trim();if(!t.startsWith("@")){let i=t.indexOf("@");return i===-1?t:t.slice(0,i)}let n=t.indexOf("/");if(n===-1)return t;let r=t.indexOf("@",n+1);return r===-1?t:t.slice(0,r)}function jb(e){let t=Fb(e);return t==="pm-cli"||t.endsWith("/pm-cli")||e==="pm-cli"||e.endsWith("/pm-cli")}function sm(e,t=process.cwd()){let n=e.replaceAll("\\","/");if(n!=="dist/cli.js"&&n!=="./dist/cli.js"&&!n.endsWith("/dist/cli.js"))return!1;let r=Qr.resolve(t,e);try{return JSON.parse(Rb(Qr.join(Qr.dirname(Qr.dirname(r)),"package.json"),"utf8")).name==="@unbrained/pm-cli"}catch{return!1}}function oo(e){let t=0;for(;t<e.length;){let r=e[t];if(r==="--"){t+=1;break}if(!r.startsWith("-"))break;let i=/^(?:-c|--call)=(.*)$/.exec(r);if(i){let a=i[1];return a?{command:a,args:e.slice(t+1)}:null}if(Tb.has(r)){t+=1;break}t+=$b.has(r)&&!r.includes("=")?2:1}let n=e[t];return n?{command:n,args:e.slice(t+1)}:null}function lm(e,t){let n=0;for(;n<e.length;){let r=e[n];if(r==="--"){n+=1;continue}if(r.startsWith("-")){if(r.includes("=")){n+=1;continue}if(t.has(r)){n+=2;continue}n+=1;continue}return{subcommand:r,args:e.slice(n+1)}}return null}function Ub(e){let t=lm(e,Ob);return t?.subcommand!=="dlx"?null:oo(t.args)}function zb(e){let t=lm(e,Db);return!t||!Pb.has(t.subcommand)?null:oo(t.args)}function qb(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(ao.has(n)){t+=2;continue}t+=1;continue}return{subcommand:n,remaining:e.slice(t+1)}}return null}function Gb(e,t=new Set){for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="--")return e[n+1];if(!r.startsWith("-"))return r;!r.includes("=")&&(ao.has(r)||t.has(r))&&(n+=1)}}(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]="01f042d0-7f02-59f5-8894-cf48eb936d99")}catch{}})();async function dm(e){return e.includeBody?cr(e.pmRoot,e.settings.item_format,e.typeToFolder,e.warnings,e.settings.schema,{forceSourceScan:!0}):Pt(e.pmRoot,e.settings.item_format,e.typeToFolder,e.warnings,e.settings.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]="a1261d65-222c-5c6c-8634-a4413a91aba9")}catch{}})();var Wb=5;async function um(e,t,n){let r=await xr(e,t),a=[["validate_history_drift_missing_streams",r.missingStreams.length],["validate_history_drift_unreadable_streams",r.unreadableStreams.length],["validate_history_drift_hash_mismatches",r.hashMismatches.length],["validate_history_drift_chain_mismatches",r.chainMismatches.length],["validate_history_drift_workspace_state_mismatches",r.workspaceStateMismatches.length],["validate_history_drift_workspace_state_missing",r.workspaceStateMissing.length],["validate_history_drift_workspace_state_unreadable",r.workspaceStateUnreadable.length]].filter(([,c])=>c>0).map(([c,l])=>`${c}:${l}`),o=n?Number.POSITIVE_INFINITY:Wb,s=r.driftedItems.slice(0,o);return{check:{name:"history_drift",status:a.length===0?"ok":"warn",ok:a.length===0,details:{checked_items:t.length,drifted_items_count:r.driftedItems.length,drifted_items:s,drifted_items_truncated:s.length<r.driftedItems.length,counts:{missing_streams:r.missingStreams.length,unreadable_streams:r.unreadableStreams.length,hash_mismatches:r.hashMismatches.length,chain_mismatches:r.chainMismatches.length,workspace_state_mismatches:r.workspaceStateMismatches.length,workspace_state_missing:r.workspaceStateMissing.length,workspace_state_unreadable:r.workspaceStateUnreadable.length},workspace_state_mismatches:r.workspaceStateMismatches,workspace_state_missing:r.workspaceStateMissing,workspace_state_unreadable:r.workspaceStateUnreadable}},warnings:a}}(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]="b8c4707f-5445-5079-96e5-dc0dbd649b34")}catch{}})();var Vb=["src","tests","docs"],Kb=["README.md","PRD.md","CHANGELOG.md","AGENTS.md","CONTRIBUTING.md","SECURITY.md","CODE_OF_CONDUCT.md","LICENSE"],Yb=new Set(["node_modules",".git",".cursor",".agents","dist","coverage"]),Xb=["resolution","expected_result","actual_result"],Zb=["default","tracked-all","tracked-all-strict"],mm=["core","strict","custom"],ti=["off","warn","error"];var co=["author","acceptance_criteria","estimated_minutes","close_reason"],_m=[...co,"reviewer","risk","confidence","sprint","release"],po=Array.from(new Set(_m)),Qb={author:"author",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",estimate:"estimated_minutes",close_reason:"close_reason","close-reason":"close_reason",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release"},ek={author:"validate_metadata_missing_author",acceptance_criteria:"validate_metadata_missing_acceptance_criteria",estimated_minutes:"validate_metadata_missing_estimate",close_reason:"validate_metadata_missing_close_reason",reviewer:"validate_metadata_missing_reviewer",risk:"validate_metadata_missing_risk",confidence:"validate_metadata_missing_confidence",sprint:"validate_metadata_missing_sprint",release:"validate_metadata_missing_release"},tk={author:"missing_author",acceptance_criteria:"missing_acceptance_criteria",estimated_minutes:"missing_estimated_minutes",close_reason:"closed_missing_close_reason",reviewer:"missing_reviewer",risk:"missing_risk",confidence:"missing_confidence",sprint:"missing_sprint",release:"missing_release"},nk={author:"missing_author_item_ids",acceptance_criteria:"missing_acceptance_criteria_item_ids",estimated_minutes:"missing_estimated_minutes_item_ids",close_reason:"closed_missing_close_reason_item_ids",reviewer:"missing_reviewer_item_ids",risk:"missing_risk_item_ids",confidence:"missing_confidence_item_ids",sprint:"missing_sprint_item_ids",release:"missing_release_item_ids"},rk={author:"missing_author_truncated",acceptance_criteria:"missing_acceptance_criteria_truncated",estimated_minutes:"missing_estimated_minutes_truncated",close_reason:"closed_missing_close_reason_truncated",reviewer:"missing_reviewer_truncated",risk:"missing_risk_truncated",confidence:"missing_confidence_truncated",sprint:"missing_sprint_truncated",release:"missing_release_truncated"},ik=32*1024*1024,ak=1e4,ym=40,mt=5,ok=4096,sk=255,ck=Jb(Hb);function wm(e){let t={};for(let[n,r]of Object.entries(e))Array.isArray(r)||(t[n]=typeof r=="object"&&r!==null?wm(r):r);return t}function lk(e){return{...e,checks:e.checks.map(t=>({...t,details:wm(t.details)})),...e.fixes?{fixes:{mode:e.fixes.mode,auto_fix:e.fixes.auto_fix,prune_missing:e.fixes.prune_missing,planned_count:e.fixes.planned_count,applied_count:e.fixes.applied_count,gated_count:e.fixes.gated_count,failed_count:e.fixes.failed_count}}:{}}}function xt(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/^\/+/,"")}function pm(e){return xt(e).replace(/\/+$/,"")}function De(e){let t=Z(e);if(!t)return;let n=t.toLowerCase();if(!(n==="none"||n==="null"||n==="n/a"||n==="na"))return t}function ri(e,t){return gs(e,t)??e}function On(e,t){return t.terminal_statuses.has(ri(e,t))}function dt(e){return[...new Set((e??[]).map(t=>t.trim().toLowerCase()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function ei(e,t){return e.length!==t.length?!1:e.every((n,r)=>n===t[r])}function dk(e){let t=dt(No),n={blocked_reason:dt(Un.blocked_reason),resolution:dt(Un.resolution),actual_result:dt(Un.actual_result)},r=dt(e.validation.lifecycle_stale_blocker_reason_patterns),i={blocked_reason:dt(e.validation.lifecycle_closure_like_blocked_reason_patterns),resolution:dt(e.validation.lifecycle_closure_like_resolution_patterns),actual_result:dt(e.validation.lifecycle_closure_like_actual_result_patterns)};return{stale_blocker_reason_patterns:r,stale_blocker_reason_pattern_source:ei(r,t)?"default":"settings",closure_like_metadata_field_patterns:i,closure_like_metadata_field_pattern_sources:{blocked_reason:ei(i.blocked_reason,n.blocked_reason)?"default":"settings",resolution:ei(i.resolution,n.resolution)?"default":"settings",actual_result:ei(i.actual_result,n.actual_result)?"default":"settings"}}}function vm(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"core";if(mm.includes(t))return t;throw new y(`Unknown --metadata-profile value "${e}". Supported values: ${mm.join(", ")}.`,_.USAGE)}function bm(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"warn";if(ti.includes(t))return t;throw new y(`Unknown --dependency-cycle-severity value "${e}". Supported values: ${ti.join(", ")}.`,_.USAGE)}function km(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"warn";if(ti.includes(t))return t;throw new y(`Unknown --parent-cycle-severity value "${e}". Supported values: ${ti.join(", ")}.`,_.USAGE)}function uk(e){return[...new Set((e??[]).map(n=>n.trim().toLowerCase().replaceAll("-","_")))].map(n=>Qb[n]).filter(n=>n!==void 0).sort((n,r)=>n.localeCompare(r))}function mk(e,t,n){let r=uk(n);return e==="core"?{profile:e,profile_source:t,required_fields:[...co],configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:e==="strict"?{profile:e,profile_source:t,required_fields:[..._m],configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:r.length>0?{profile:e,profile_source:t,required_fields:r,configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:{profile:e,profile_source:t,required_fields:[...co],configured_custom_fields:r,fallback_to_core:!0,warnings:["validate_metadata_custom_profile_missing_required_fields:0"]}}var pk=new Set(["acceptance_criteria","estimated_minutes"]);function xm(e,t,n,r){return!r&&pk.has(t)&&On(e.status,n)?!1:t==="author"?!Z(e.author):t==="acceptance_criteria"?!Z(e.acceptance_criteria):t==="estimated_minutes"?!Number.isFinite(e.estimated_minutes):t==="close_reason"?ri(e.status,n)===n.close_status&&!Z(e.close_reason):t==="reviewer"?!Z(e.reviewer):t==="risk"?!Z(e.risk):t==="confidence"?typeof e.confidence=="number"?!Number.isFinite(e.confidence):!Z(e.confidence):t==="sprint"?!Z(e.sprint):!Z(e.release)}function Sm(e){if(e===void 0)return"default";let t=e.trim().toLowerCase();if(t.length===0||t==="default")return"default";if(t==="tracked-all"||t==="tracked_all")return"tracked-all";if(t==="tracked-all-strict"||t==="tracked_all_strict")return"tracked-all-strict";throw new y(`Unknown --scan-mode value "${e}". Supported values: ${Zb.join(", ")}.`,_.USAGE)}function Em(e){let t=process.env.PM_SOURCE_WORKSPACE_ROOT?.trim();if(t)return he.resolve(t);let n=he.resolve(e);if(n.replaceAll("\\","/").endsWith("/.agents/pm"))return he.dirname(he.dirname(n));let i=he.resolve(process.cwd()),a=fm(n),o=fm(i),s=he.relative(a,o);return s.length===0||!s.startsWith("..")&&!he.isAbsolute(s)?n:i}function fm(e){try{return Bb.native(e)}catch{return he.resolve(e)}}function fk(e,t){return typeof e=="object"&&e!==null&&"code"in e&&typeof e.code=="string"&&t.includes(e.code)}async function fo(e,t,n){let r=t.length>0?he.join(e,t):e,i;try{i=await mo.readdir(r,{withFileTypes:!0})}catch(a){if(j(a))return;throw a}for(let a of i){if(a.name.startsWith("."))continue;let o=t.length>0?he.join(t,a.name):a.name;if(a.isDirectory()){if(Yb.has(a.name))continue;await fo(e,o,n);continue}a.isFile()&&n.push(xt(o))}}async function lo(e){let t=[];for(let n of Vb)await fo(e,n,t);for(let n of Kb){let r=he.join(e,n);try{(await mo.stat(r)).isFile()&&t.push(xt(n))}catch{}}return[...new Set(t)].sort((n,r)=>n.localeCompare(r))}async function Am(e){try{let{stdout:t}=await ck("git",["ls-files","-z"],{cwd:e,encoding:"utf8",maxBuffer:ik,windowsHide:!0,timeout:ak}),n=t.split("\0").map(r=>xt(r)).filter(r=>r.length>0);return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}catch{return null}}function hk(e,t){let n=new Set,r=pm(Oo);r.length>0&&n.add(r);let i=pm(he.relative(t,e));return i.length>0&&!i.startsWith("..")&&n.add(i),[...n].sort((a,o)=>a.localeCompare(o))}function hm(e,t){for(let n of t)if(e===n||e.startsWith(`${n}/`))return!0;return!1}async function gk(e,t){if(t==="tracked-all"||t==="tracked-all-strict"){let r=await Am(e);if(r)return{requestedMode:t,appliedMode:t,source:"tracked-git",candidateFiles:r,candidateTotal:r.length,candidateScanned:r.length};let i=await lo(e);return{requestedMode:t,appliedMode:"default",source:"tracked-all-fallback-default",candidateFiles:i,candidateTotal:i.length,candidateScanned:i.length}}let n=await lo(e);return{requestedMode:t,appliedMode:"default",source:"default-curated",candidateFiles:n,candidateTotal:n.length,candidateScanned:n.length}}function ie(e,t=mt){return e.length<=t?{values:e,truncated:!1}:{values:e.slice(0,t),truncated:!0}}function ut(e,t){if(t)return{values:e,truncated:!1,total:e.length};let n=ie(e,ym);return{values:n.values,truncated:n.truncated,total:e.length}}var _k={resolution:"--resolution",expected_result:"--expected-result",actual_result:"--actual-result"},yk={resolution:"Describe how this item was resolved",expected_result:"Describe the expected result",actual_result:"Describe the actual result"};function wk(e){let t=e.missing_fields.map(n=>`${_k[n]} "${yk[n]}"`).join(" ");return`pm update ${e.id} ${t} --message "Backfill resolution metadata"`}function Rm(e,t){let n=e.details?.missing_resolution_remediation_hints,r=Array.isArray(n)&&n.length>0,i=r?n.filter(o=>typeof o=="string"):Jc(t);if(i.length===0)return;let a=r&&e.details?.missing_resolution_remediation_hints_truncated===!0;e.details={...e.details,fix_hints:i,...a?{fix_hints_truncated:!0}:{}}}function Im(e){let t=new Set;return e.checkMetadata&&t.add("metadata"),e.checkResolution&&t.add("resolution"),(e.checkLifecycle||e.checkStaleBlockers)&&t.add("lifecycle"),e.checkFiles&&t.add("files"),e.checkHistoryDrift&&t.add("history_drift"),e.checkCommandReferences&&t.add("command_references"),e.checkStorageIntegrity&&t.add("storage_integrity"),t.size===0?(e.autoFix&&(t.add("metadata"),t.add("resolution"),t.add("lifecycle")),e.pruneMissing&&t.add("files"),t.size===0&&(t.add("metadata"),t.add("resolution"),t.add("lifecycle"),t.add("files"),t.add("command_references"),t.add("history_drift"),t.add("format_version"),t.add("storage_integrity")),t):(e.pruneMissing&&t.add("files"),t)}var vk="validate_metadata_duplicate_issue_codes";function Cm(e,t){if(e.length===0)return{rows:[],truncated:!1,warnings:[]};let n=t?e.length:mt,r=e.slice(0,n);return{rows:r.map(a=>({code:a.code,count:a.count,ids:a.ids,titles:a.titles,remediation_hint:`Items ${a.ids.join(", ")} share issue code "${a.code}"; rename or merge so each logical code maps to one item.`})),truncated:r.length<e.length,warnings:[`${vk}:${e.length}`]}}function bk(){return Object.fromEntries(po.map(e=>[e,[]]))}function kk(e,t,n){let r=bk();for(let i of e)for(let a of po)xm(i,a,t,n)&&r[a].push(i.id);return r}function xk(e,t,n){let r=[...e.warnings];for(let i of e.required_fields){let a=t[i];a.length>0&&r.push(`${ek[i]}:${a.length}`)}return r.push(...n),r}function $m(e,t){let n={};for(let r of e.required_fields){let i=t[r],a=i?i.length:0,o=tk[r];n[o]=a}return n}function Tm(e,t,n){let r=[];for(let i of e.required_fields){let a=t[i];if(a)for(let o of a){let s=n.get(o)?.type,c=typeof s=="string"&&s.length>0?s:"Unknown";r.push({item_type:c,field:i})}}return r}function Sk(e,t,n,r){for(let i of t.required_fields){let a=n[i];if(!a||a.length===0)continue;let o=nk[i],s=rk[i];if(!o||!s)continue;let c=ie(a,r?a.length:mt);e[o]=c.values,e[s]=c.truncated}}function Om(e,t,n){if(!e.required_fields.includes("close_reason"))return[];let r=t.close_reason;return r?r.map(i=>({id:i,resolution:Z(n.get(i)?.resolution)})):[]}function Dm(e,t,n){if(!e.required_fields.includes("estimated_minutes"))return[];let r=t.estimated_minutes;return r?r.map(i=>({id:i,type:Z(n.get(i)?.type)})):[]}function Ek(e,t,n,r){let i=new Map(e.map(h=>[h.id,h])),a=t.profile==="strict",o=kk(e,n,a),s=Wu(e),c=Cm(s,r),l=xk(t,o,c.warnings),d=$m(t,o),u=Tm(t,o,i),m=Bu(u),p={checked_items:e.length,metadata_profile:t.profile,metadata_profile_source:t.profile_source,metadata_profile_fallback_to_core:t.fallback_to_core,required_fields:[...t.required_fields],supported_required_fields:[...po],counts:d,missing_by_type:m,duplicate_issue_codes_count:s.length,duplicate_issue_codes:c.rows,duplicate_issue_codes_truncated:c.truncated};t.configured_custom_fields.length>0&&(p.configured_custom_required_fields=[...t.configured_custom_fields]),Sk(p,t,o,r);let f=Om(t,o,i),g=Dm(t,o,i);return{check:{name:"metadata",status:l.length===0?"ok":"warn",ok:l.length===0,details:p},warnings:l,closeReasonBackfillRows:f,estimateBackfillRows:g}}function Ak(e,t,n){let r=new Set(t.terminal_done_statuses);r.add(t.close_status);let i=e.filter(m=>r.has(ri(m.status,t))),a=[],o=[];for(let m of i){let p=Xb.filter(f=>!Z(m[f]));p.length!==0&&(a.push({id:m.id,missing_fields:p}),o.push({id:m.id,missing_fields:p,close_reason:Z(m.close_reason)}))}let s=a.length>0?[`validate_resolution_missing_fields:${a.length}`]:[],c=n?Number.POSITIVE_INFINITY:mt,l=ie(a.map(m=>`${m.id}:${m.missing_fields.join(",")}`),c),d=a.map(m=>wk(m)),u=ie(d,c);return{check:{name:"resolution",status:s.length===0?"ok":"warn",ok:s.length===0,details:{checked_closed_items:i.length,missing_resolution_items:a.length,missing_resolution_rows:l.values,missing_resolution_rows_truncated:l.truncated,missing_resolution_remediation_hints:u.values,missing_resolution_remediation_hints_truncated:u.truncated}},warnings:s,resolutionBackfillRows:o}}function Pm(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Nm(e,t="pm",n=_i()){let r=new Set(e.map(a=>a.id)),i=[...e].sort((a,o)=>a.id.localeCompare(o.id));return new Map(i.map(a=>{let o=new Set,s=De(a.blocked_by);s&&r.has(s)&&o.add(s),(a.dependencies??[]).filter(l=>{let d=De(l.kind);return d!==void 0&&n.resolve(d)?.ordering===!0}).map(l=>De(l.id)).filter(l=>l!==void 0&&r.has(l)).forEach(l=>o.add(l));let c=De(a.definition_of_ready);return Lm(c??"",t).filter(l=>r.has(l)).forEach(l=>o.add(l)),[a.id,[...o].sort((l,d)=>l.localeCompare(d))]}))}function Mm(e,t,n){let r=Vs(e,n?d=>On(d,n):void 0),i=r.active.map(d=>`${d.holder_id}:${d.target_id}:${d.kind}`),a=r.legacy_terminal.map(d=>`${d.holder_id}:${d.target_id}:${d.kind}:${d.holder_status}`),o=t?Number.POSITIVE_INFINITY:mt,s=ie(i,o),c=ie(a,o),l=ie(r.active.map(d=>d.source==="parent"?`pm update ${d.holder_id} --unset parent`:d.source==="blocked_by"?`pm update ${d.holder_id} --unset blocked_by`:`pm update ${d.holder_id} --replace-deps '<correct dependency edges>'`),o);return{check:{name:"dependency_references",status:i.length===0?"ok":"warn",ok:i.length===0,details:{checked_items:e.length,dangling_reference_count:i.length+a.length,active_dangling_reference_count:i.length,dangling_reference_rows:s.values,dangling_reference_rows_truncated:s.truncated,legacy_terminal_dangling_reference_count:a.length,legacy_closed_dangling_reference_count:r.legacy_terminal.filter(d=>d.holder_status==="closed").length,legacy_terminal_dangling_reference_rows:c.values,legacy_terminal_dangling_reference_rows_truncated:c.truncated,no_active_blocker_sentinel_count:r.no_active_blocker_sentinels.length,remediation_hints:l.values,remediation_hints_truncated:l.truncated}},warnings:i.length>0?[`validate_dangling_dependency_references:${i.length}`]:[]}}function Lm(e,t="pm"){let n=(t.trim().toLowerCase()||"pm").replace(/-+$/g,""),r=new RegExp(`(?:^|[^a-z0-9-])(${Pm(n)}-[a-z0-9][a-z0-9-]*)`,"gi");return[...new Set([...e.matchAll(r)].map(i=>i[1].toLowerCase()))].sort((i,a)=>i.localeCompare(a))}function ho(e){let t=0,n=new Map,r=new Map,i=[],a=new Set,o=[],s=d=>{n.set(d,t),r.set(d,t),t+=1,i.push(d),a.add(d);for(let m of e.get(d)??[])n.has(m)?a.has(m)&&r.set(d,Math.min(r.get(d),n.get(m))):(s(m),r.set(d,Math.min(r.get(d),r.get(m))));if(r.get(d)!==n.get(d))return;let u=[];for(;i.length>0;){let m=i.pop();if(a.delete(m),u.push(m),m===d)break}u.sort((m,p)=>m.localeCompare(p)),o.push(u)},c=[...e.keys()].sort((d,u)=>d.localeCompare(u));for(let d of c)n.has(d)||s(d);return o.filter(d=>{if(d.length>1)return!0;let u=d[0];return(e.get(u)??[]).includes(u)}).sort((d,u)=>d[0].localeCompare(u[0])||d.length-u.length||d.join(",").localeCompare(u.join(",")))}function go(e,t){let n=e[0];if(e.length===1)return[n,n];let r=new Set(e),i=[n],a=new Set([n]),o=s=>{let c=(t.get(s)??[]).filter(l=>r.has(l));for(let l of c){if(l===n&&i.length>1)return i.push(n),!0;if(!a.has(l)){if(a.add(l),i.push(l),o(l))return!0;i.pop(),a.delete(l)}}return!1};return o(n)?[...i]:[...e,n]}function Fm(e,t="pm"){let n=Nm(e,t),r=ho(n),i=[...new Set(r.flat())].sort((o,s)=>o.localeCompare(s)),a=r.map(o=>go(o,n).join("->"));return{cycle_count:r.length,cycle_item_ids:i,cycle_sample_paths:a}}function jm(e,t=_i()){let n=new Map(e.map(a=>[a.id.toLowerCase(),a.id])),r=new Map(e.map(a=>[a.id,[]]));return[...e].sort((a,o)=>a.id.localeCompare(o.id)).forEach(a=>{let o=r.get(a.id),s=De(a.parent),c=s?n.get(s.toLowerCase()):void 0;c&&o.push(c),(a.dependencies??[]).forEach(l=>{let d=t.resolve(l.kind);if(!d?.hierarchy)return;let u=n.get(l.id.toLowerCase());u&&(d.hierarchyDirection==="source_parent"?r.get(u).push(a.id):o.push(u))})}),r.forEach((a,o)=>{r.set(o,[...new Set(a)].sort((s,c)=>s.localeCompare(c)))}),r}function Um(e){let t=jm(e),n=ho(t),r=[...new Set(n.flat())].sort((a,o)=>a.localeCompare(o)),i=n.map(a=>go(a,t).join("->"));return{cycle_count:n.length,cycle_item_ids:r,cycle_sample_paths:i}}function zm(e){return e.startsWith("docs/")?"docs_unowned":e.startsWith("tests/")?"tests_unowned":e.startsWith("src/")?"source_unowned":e.endsWith(".md")?"docs_unowned":"unlinked_existing"}function ni(e){let t=e.lastIndexOf("/");return t===-1?"":e.slice(0,t)}function qm(e,t){let n=ni(e).split("/").filter(Boolean),r=ni(t).split("/").filter(Boolean),i=0;for(;i<n.length&&i<r.length&&n[i]===r[i];)i+=1;return i}function Rk(e,t){let n=ni(t),r=ni(e),i=t.endsWith("/")?t:`${t}/`,a=e.startsWith(i),o=n.length>0&&n===r,s=qm(e,t);return!a&&!o&&s===0?null:a?{score:t.length+1e3,confidence:"path_prefix"}:o?{score:s+500,confidence:"same_directory"}:{score:s,confidence:"shared_directory"}}function Ik(e,t,n){return e===void 0||n>e.score||n===e.score&&t.id.localeCompare(e.item.id)<0}function Ck(e,t,n){let r=t==="docs_unowned"?"docs":"files",i;return n.flatMap(a=>(r==="docs"?a.docs??[]:a.files??[]).map(o=>({item:a,link:o}))).forEach(({item:a,link:o})=>{if(o.scope!=="project")return;let s=xt(o.path);if(s.length===0||s===e)return;let c=Rk(e,s);c!==null&&Ik(i,a,c.score)&&(i={item:a,score:c.score,confidence:c.confidence})}),i?{id:i.item.id,type:i.item.type,title:i.item.title,status:i.item.status,confidence:i.confidence}:null}function Gm(e,t){return e.map(n=>{let r=zm(n),i=r==="docs_unowned"?"docs":"files",a=Ck(n,r,t),o=a?.id??"<id>";return{path:n,classification:r,owner_candidate:a,remediation_hint:`pm ${i} ${o} --add path=${n},scope=project,note="<why this artifact belongs to the item>"`}})}function Wm(e){return e.map(t=>`${t.path}:${t.classification} owner_candidate=${t.owner_candidate?.id??"unowned"} hint=${JSON.stringify(t.remediation_hint)}`)}function $k(e,t){return Object.entries(t.closure_like_metadata_field_patterns).filter(([n,r])=>{let i=De(e[n]);return i?r.some(a=>i.toLowerCase().includes(a)):!1}).map(([n])=>n).sort((n,r)=>n.localeCompare(r))}function Tk(e,t,n,r,i){let a=De(t.parent),o=a?n.get(r.get(a.toLowerCase())??a):void 0;return{id:e.id,parent_id:t.id,grandparent_id:o?.id,grandparent_active:o!==void 0&&!On(o.status,i)}}function Ok(e,t,n,r){let i=De(e.blocked_by),a=De(e.blocked_reason),o=a?.toLowerCase(),s=ri(e.status,n),c=[];return t.has(s)?(!i&&!a&&c.push("blocked_status_missing_blocker_context"),o?.includes("no active blocker")&&c.push("blocked_status_reason_reports_no_active_blocker"),o&&r.stale_blocker_reason_patterns.some(l=>o.includes(l))&&c.push("blocked_status_reason_matches_stale_pattern"),c):(i&&c.push("non_blocked_status_has_blocked_by"),a&&c.push("non_blocked_status_has_blocked_reason"),c)}function Dk(e,t,n,r){let i=new Map(e.map(c=>[c.id,c])),a=new Map(e.map(c=>[c.id.toLowerCase(),c.id])),o=n.blocked_statuses.size>0?n.blocked_statuses:new Set(["blocked"]),s={activeItems:e.filter(c=>!On(c.status,n)),closureLikeRows:[],terminalParentRows:[],terminalParentFixRows:[],staleBlockerRows:[]};for(let c of s.activeItems){let l=$k(c,r);l.length>0&&s.closureLikeRows.push({id:c.id,fields:l});let d=De(c.parent),u=d?i.get(a.get(d.toLowerCase())??d):void 0;if(u&&On(u.status,n)&&(s.terminalParentRows.push({id:c.id,parent_id:u.id,parent_status:u.status}),s.terminalParentFixRows.push(Tk(c,u,i,a,n))),t){let m=Ok(c,o,n,r);m.length>0&&s.staleBlockerRows.push({id:c.id,status:c.status,reasons:[...new Set(m)].sort((p,f)=>p.localeCompare(f))})}}return s}function Pk(e){e.closureLikeRows.sort((t,n)=>t.id.localeCompare(n.id)),e.terminalParentRows.sort((t,n)=>t.id.localeCompare(n.id)||t.parent_id.localeCompare(n.parent_id)),e.terminalParentFixRows.sort((t,n)=>t.id.localeCompare(n.id)||t.parent_id.localeCompare(n.parent_id)),e.staleBlockerRows.sort((t,n)=>t.id.localeCompare(n.id))}function gm(e,t,n){return n<=0||t==="off"?null:`${t==="error"?`${e}_error`:e}:${n}`}function Nk(e,t,n,r,i,a){let o=[];e.closureLikeRows.length>0&&o.push(`validate_lifecycle_active_closure_like_metadata:${e.closureLikeRows.length}`),e.terminalParentRows.length>0&&o.push(`validate_lifecycle_active_terminal_parent:${e.terminalParentRows.length}`),t&&e.staleBlockerRows.length>0&&o.push(`validate_lifecycle_stale_blockers:${e.staleBlockerRows.length}`);let s=gm("validate_lifecycle_dependency_cycles",n,i),c=gm("validate_hierarchy_parent_cycle",r,a);return[...o,...s?[s]:[],...c?[c]:[]]}function Bm(e){let t=xt(e);return t.length>ok||t.split(/[\\/]/).some(n=>n.length>sk)}async function Mk(e,t){let n=he.isAbsolute(t)?t:he.resolve(e,t);if(Bm(n))return!1;try{let r=await mo.stat(n);return!r.isFile()&&!r.isDirectory()}catch(r){return fk(r,["ENOENT","ENOTDIR"])}}async function Lk(e,t){let n={linkedProjectPaths:new Set,remoteLinkedPaths:new Set,missingLinkedPaths:[],staleLinkRows:[]},r=e.flatMap(i=>[...(i.files??[]).map(a=>({item:i,artifact:a,link_kind:"files"})),...(i.docs??[]).map(a=>({item:i,artifact:a,link_kind:"docs"}))]);for(let{item:i,artifact:a,link_kind:o}of r){if(a.scope!=="project")continue;if($n(a.path)){n.remoteLinkedPaths.add(a.path.trim());continue}let s=xt(a.path);s.length!==0&&(n.linkedProjectPaths.add(s),await Mk(t,a.path)&&(n.missingLinkedPaths.push(s),n.staleLinkRows.push({item_id:i.id,path:s,link_kind:o})))}return n}function Fk(e,t,n,r,i,a){let o=r==="tracked-all-strict",s=o&&!i,c=i||o,l=c?[]:hk(t,n),d=l.length===0?[]:e.candidateFiles.filter(p=>hm(p,l)),u=l.length===0?e.candidateFiles:e.candidateFiles.filter(p=>!hm(p,l)),m={};if(d.length>0){let p=ut(d,a);m.pm_internals={count:d.length,paths:p.values,paths_truncated:p.truncated,paths_total:p.total}}return{strictTrackedAllMode:o,strictModeForcesPmInternals:s,includePmInternalsEffective:c,pmInternalCandidatePrefixes:l,excludedPmInternalPaths:d,candidateFiles:u,excludedByReason:m}}function Hm(e,t,n,r,i,a,o,s="pm"){let c=Dk(e,t,i,a);Pk(c);let l=Fm(c.activeItems,s),d=Um(e),u=Nk(c,t,n,r,l.cycle_count,d.cycle_count),m=o?Number.POSITIVE_INFINITY:mt,p=ie(c.closureLikeRows.map(R=>`${R.id}:${R.fields.join(",")}`),m),f=ie(c.terminalParentRows.map(R=>`${R.id}:${R.parent_id}:${R.parent_status}`),m),g=ie(c.staleBlockerRows.map(R=>`${R.id}:${R.status}:${R.reasons.join(",")}`),m),h=ie(l.cycle_item_ids,m),w=ie(l.cycle_sample_paths,m),v=ie(d.cycle_item_ids,m),b=ie(d.cycle_sample_paths,m),x=l.cycle_count>0&&n==="error"||d.cycle_count>0&&r==="error";return{check:{name:"lifecycle",status:x?"error":u.length===0?"ok":"warn",ok:!x&&u.length===0,details:{checked_active_items:c.activeItems.length,active_closure_like_metadata_items:c.closureLikeRows.length,active_closure_like_metadata_rows:p.values,active_closure_like_metadata_rows_truncated:p.truncated,active_terminal_parent_items:c.terminalParentRows.length,active_terminal_parent_rows:f.values,active_terminal_parent_rows_truncated:f.truncated,stale_blocker_checks_enabled:t,stale_blocker_items:c.staleBlockerRows.length,stale_blocker_rows:g.values,stale_blocker_rows_truncated:g.truncated,dependency_cycle_severity_policy:n,dependency_cycle_count:l.cycle_count,dependency_cycle_item_count:l.cycle_item_ids.length,dependency_cycle_item_ids:h.values,dependency_cycle_item_ids_truncated:h.truncated,dependency_cycle_sample_paths:w.values,dependency_cycle_sample_paths_truncated:w.truncated,parent_cycle_severity_policy:r,parent_cycle_count:d.cycle_count,parent_cycle_item_count:d.cycle_item_ids.length,parent_cycle_item_ids:v.values,parent_cycle_item_ids_truncated:v.truncated,parent_cycle_sample_paths:b.values,parent_cycle_sample_paths_truncated:b.truncated,stale_blocker_reason_patterns:[...a.stale_blocker_reason_patterns],stale_blocker_reason_pattern_source:a.stale_blocker_reason_pattern_source,closure_like_blocked_reason_patterns:[...a.closure_like_metadata_field_patterns.blocked_reason],closure_like_blocked_reason_pattern_source:a.closure_like_metadata_field_pattern_sources.blocked_reason,closure_like_resolution_patterns:[...a.closure_like_metadata_field_patterns.resolution],closure_like_resolution_pattern_source:a.closure_like_metadata_field_pattern_sources.resolution,closure_like_actual_result_patterns:[...a.closure_like_metadata_field_patterns.actual_result],closure_like_actual_result_pattern_source:a.closure_like_metadata_field_pattern_sources.actual_result}},warnings:u,terminalParentFixRows:c.terminalParentFixRows}}async function Jm(e,t,n,r,i,a){let o=await Lk(e,t),s=new Map(e.map(D=>[D.id,D])),c=[...new Set(o.missingLinkedPaths)].sort((D,W)=>D.localeCompare(W)),l=await gk(t,r),d=Fk(l,n,t,r,i,a),u=d.candidateFiles.filter(D=>!o.linkedProjectPaths.has(D)),m=Gm(u,e),p=Vu(c,d.candidateFiles),f=new Map(p.map(D=>[D.path,D.classification])),g=p.filter(D=>D.classification==="moved").length,h=o.staleLinkRows.map(D=>({...D,classification:f.get(D.path)??"deleted"})).sort((D,W)=>D.item_id.localeCompare(W.item_id)||D.path.localeCompare(W.path)||D.link_kind.localeCompare(W.link_kind)),w=[];d.strictModeForcesPmInternals&&w.push("validate_files_tracked_all_strict_forces_pm_internals"),c.length>0&&w.push(`validate_files_missing_linked_paths:${c.length}`),u.length>0&&w.push(`validate_files_orphaned_paths:${u.length}`);let v=[...o.remoteLinkedPaths].sort((D,W)=>D.localeCompare(W)),b=ut(v,a),x=ut(c,a),R=ut(u,a),k=ut(m.map(D=>`${D.path}:${D.classification}:owner_candidate=${D.owner_candidate?.id??"unowned"}`),a),F=a?m:ut(Wm(m),!1).values,T=ut(Ku(p),a),E=h.map(D=>({item_id:D.item_id,path:D.path,link_kind:D.link_kind,classification:D.classification})),U=Xu(E,D=>{let W=s.get(D);return W?{type:W.type,title:W.title,status:W.status}:void 0}),B=a?U:ut(Zu(U),!1).values;return{check:{name:"files",status:w.length===0?"ok":"warn",ok:w.length===0,details:{workspace_root:t,scan_mode_requested:l.requestedMode,scan_mode_applied:l.appliedMode,strict_tracked_all_mode:d.strictTrackedAllMode,strict_mode_forces_pm_internals:d.strictModeForcesPmInternals,strict_mode_forces_pm_internals_notice:d.strictModeForcesPmInternals?"tracked-all-strict force-enables PM internals; pass --include-pm-internals to make inclusion explicit.":null,file_list_detail_mode:a?"full":"summary",file_list_summary_limit:ym,candidate_scan_source:l.source,include_pm_internals:d.includePmInternalsEffective,include_pm_internals_requested:i,pm_internal_candidate_prefixes:d.pmInternalCandidatePrefixes,pm_internal_excluded_count:d.excludedPmInternalPaths.length,excluded_total:d.excludedPmInternalPaths.length,excluded_by_reason:d.excludedByReason,linked_project_paths:o.linkedProjectPaths.size,remote_linked_paths_count:v.length,remote_linked_paths_total:b.total,remote_linked_paths:b.values,remote_linked_paths_truncated:b.truncated,candidate_total_raw:l.candidateTotal,candidate_scanned_raw:l.candidateScanned,candidate_total:d.candidateFiles.length,candidate_scanned:d.candidateFiles.length,scanned_candidate_files:d.candidateFiles.length,missing_linked_paths_count:c.length,missing_linked_paths_total:x.total,missing_linked_paths:x.values,missing_linked_paths_truncated:x.truncated,missing_linked_paths_moved_count:g,missing_linked_paths_deleted_count:c.length-g,missing_linked_path_classifications:T.values,missing_linked_path_classifications_truncated:T.truncated,missing_linked_path_rows_count:U.length,missing_linked_path_rows:B,orphaned_paths_count:u.length,orphaned_paths_total:R.total,orphaned_paths:R.values,orphaned_paths_truncated:R.truncated,orphaned_path_classifications:k.values,orphaned_path_classifications_truncated:k.truncated,orphaned_path_rows_count:m.length,orphaned_path_rows:F}},warnings:w,staleLinkPruneRows:h}}function jk(e,t,n){let r=n.trim().replaceAll(/\s+/g," "),i=r.length>120?`${r.slice(0,117)}...`:r;return`${e}:${t}:${i}`}function Vm(e,t,n){let r=new Set(e.map(h=>h.id.toLowerCase())),i=0,a=0,o=new Set,s=[],c=e.flatMap(h=>(h.tests??[]).map(w=>({item:h,linkedTest:w})));for(let{item:h,linkedTest:w}of c){if(typeof w.command!="string"||w.command.trim().length===0)continue;i+=1;let v=cm(w.command,t);if(v.length!==0){a+=v.length;for(let b of v)o.add(b),r.has(b.toLowerCase())||s.push(jk(h.id,b,w.command))}}let l=[...new Set(s)].sort((h,w)=>h.localeCompare(w)),d=[...new Set(l.map(h=>h.split(":")[1]??""))].filter(h=>h.length>0).sort((h,w)=>h.localeCompare(w)),u=l.length>0?[`validate_command_references_stale_pm_ids:${l.length}`]:[],m=n?Number.POSITIVE_INFINITY:mt,p=ie(l,m),f=ie(d,m),g=ie([...o].sort((h,w)=>h.localeCompare(w)),m);return{check:{name:"command_references",status:u.length===0?"ok":"warn",ok:u.length===0,details:{checked_items:e.length,linked_commands_scanned:i,referenced_pm_ids_count:a,unique_referenced_pm_ids_count:o.size,unique_referenced_pm_ids:g.values,unique_referenced_pm_ids_truncated:g.truncated,stale_pm_id_references_count:l.length,stale_pm_ids_count:d.length,stale_pm_ids:f.values,stale_pm_ids_truncated:f.truncated,stale_pm_id_reference_rows:p.values,stale_pm_id_reference_rows_truncated:p.truncated}},warnings:u}}function Uk(e,t){let n=er(e.map(c=>({ref:c.id,version:Qn(c)}))),r=[];n.outdated.length>0&&r.push(`validate_format_version_outdated_items:${n.outdated.length}`),n.ahead.length>0&&r.push(`validate_format_version_ahead_items:${n.ahead.length}`);let i=t?Number.POSITIVE_INFINITY:mt,a=ie(n.outdated,i),o=ie(n.ahead,i),s=n.ahead.length>0?"error":n.outdated.length>0?"warn":"ok";return{check:{name:"format_version",status:s,ok:s==="ok",details:{checked_items:e.length,current_format_version:hs,outdated_items_count:n.outdated.length,outdated_items:a.values,outdated_items_truncated:a.truncated,ahead_items_count:n.ahead.length,ahead_items:o.values,ahead_items_truncated:o.truncated}},warnings:r}}var uo="pm validate auto-fix";async function Km(e,t,n){switch(e.kind){case"set_resolution":case"set_close_reason":case"set_estimate":case"reparent":case"unset_parent":{let r={message:uo};if(e.kind==="set_resolution"?r.resolution=e.value:e.kind==="set_close_reason"?r.closeReason=e.value:e.kind==="set_estimate"?r.estimatedMinutes=e.value:e.kind==="reparent"?r.parent=e.parent_id:r.unset=["parent"],!n.runUpdate)throw new y("Applying validate metadata/lifecycle fixes requires a runUpdate mutation service.",_.USAGE);await n.runUpdate(e.item_id,r,t);return}case"prune_file_link":throw new Error(`Unsupported non-batched fix kind: ${e.kind}`);case"prune_doc_link":throw new Error(`Unsupported non-batched fix kind: ${e.kind}`)}}function so(e){return e.kind!=="prune_file_link"&&e.kind!=="prune_doc_link"?null:`${e.kind}:${e.item_id}`}async function Ym(e,t,n){let r=[],i=[],a=new Map;for(let o of e.filter(s=>so(s)===null))try{await Km(o,t,n),r.push(o)}catch(s){i.push({fix:o,error:s})}for(let o of e.filter(s=>so(s)!==null)){let s=so(o),c=a.get(s);c?c.push(o):a.set(s,[o])}for(let o of a.values()){let s=o[0];if(!s)continue;let c=o.map(l=>l.path).filter(l=>typeof l=="string"&&l.length>0);try{s.kind==="prune_file_link"?await rm(s.item_id,{remove:c,message:uo},t):await tm(s.item_id,{remove:c,message:uo},t),r.push(...o)}catch(l){i.push(...o.map(d=>({fix:d,error:l})))}}return{applied:r,failed:i}}var GO={applyValidateFix:Km,applyValidateFixes:Ym,attachValidateFixHints:Rm,buildCommandReferencesCheck:Vm,buildDependencyReferencesCheck:Mm,buildCloseReasonBackfillRows:Om,buildFilesCheck:Jm,buildLifecycleCheck:Hm,buildLifecycleDependencyGraph:Nm,buildLifecycleParentGraph:jm,buildEstimateBackfillRows:Dm,buildMetadataCounts:$m,buildMissingFieldOccurrences:Tm,buildOrphanedPathRows:Gm,classifyOrphanedPath:zm,collectDefaultProjectFileCandidates:lo,collectTrackedGitFileCandidates:Am,detectLifecycleDependencyCycles:Fm,detectLifecycleParentCycles:Um,escapeRegExp:Pm,extractItemIds:Lm,findLifecycleDependencyCycleComponents:ho,isMetadataFieldMissing:xm,linkedArtifactPathExceedsFilesystemLimits:Bm,listFilesRecursive:fo,resolveDependencyCycleSeverity:bm,resolveParentCycleSeverity:km,resolveFileScanMode:Sm,resolveLifecycleDependencyCycleSamplePath:go,resolveRequestedChecks:Im,resolveValidateMetadataProfile:vm,resolveWorkspaceRoot:Em,sharedDirectoryPrefixLength:qm,summarizeOrphanedPathRows:Wm,summarizeDuplicateIssueCodes:Cm,toMeaningfulString:De};async function zk(e,t,n,r){let i=await $u(e,new Set(t.map(g=>g.id)),n,{schema:r.schema,extensionFieldNames:St(z())}),a=[];i.unreadable_item_files.length>0&&a.push(`validate_storage_unreadable_items:${i.unreadable_item_files.length}`),i.duplicate_item_ids.length>0&&a.push(`validate_storage_duplicate_item_ids:${i.duplicate_item_ids.length}`),i.history_conflict_marker_streams.length>0&&a.push(`validate_storage_history_conflict_markers:${i.history_conflict_marker_streams.length}`),i.history_unparseable_streams.length>0&&a.push(`validate_storage_unparseable_history:${i.history_unparseable_streams.length}`),i.resurrected_items.length>0&&a.push(`validate_storage_resurrected_items:${i.resurrected_items.length}`),i.unparseable_config_files.length>0&&a.push(`validate_storage_unparseable_config:${i.unparseable_config_files.length}`);let o=a.length,s=await Wr(e);s.tracked_path_count>0&&a.push(`validate_storage_tracked_runtime_cache_files:${s.tracked_path_count}`);let c=await ll(e,Rr(r));c.status==="drift"&&a.push(`validate_merge_fence_drift:${c.missing_patterns.length+c.stale_patterns.length}`);let l=await _t(e),d=l===null?null:await Ir(l);d!==null&&d.status!=="ok"&&a.push(`validate_merge_driver_configuration:${d.missing_keys.length+d.drifted_keys.length}`);let u=l===null?[]:await An(l,{includeLossless:!0,pmRoot:e}),{pendingDecisions:m,lossless:p}=Hr(u);m.length>0&&a.push(`validate_merge_decisions_unreviewed:${m.length}`);let f=o>0?"error":a.length>0?"warn":"ok";return{check:{name:"storage_integrity",status:f,ok:f==="ok",details:{...i,merge_fence:c,merge_driver_configuration:d,pending_merge_decision_count:m.length,pending_merge_decision_items:[...new Set(m.map(g=>g.item_id))].sort((g,h)=>g.localeCompare(h)),lossless_merge_receipt_count:p.length,lossless_merge_receipt_items:[...new Set(p.map(g=>g.item_id))].sort((g,h)=>g.localeCompare(h)),tracked_runtime_cache:{tracker_relative_root:s.tracker_relative_root,tracked_paths:s.tracked_paths,tracked_path_count:s.tracked_path_count,remediation_command:s.remediation_command}}},warnings:a}}function rt(e,t,n){n&&Rm(t.check,t.warnings),e.checks.push(t.check),e.warnings.push(...t.warnings)}async function qk(e){let t={checks:[],warnings:[...e.initialWarnings],closeReasonBackfillRows:[],estimateBackfillRows:[],resolutionBackfillRows:[],terminalParentFixRows:[],staleLinkPruneRows:[]},n=e.options.fixHints===!0,r=e.options.verboseDiagnostics===!0||e.options.allAffectedIds===!0||e.global.json===!0;if(e.requestedChecks.has("metadata")){let i=Ek(e.items,e.metadataPolicy,e.statusRegistry,r);t.closeReasonBackfillRows=i.closeReasonBackfillRows,t.estimateBackfillRows=i.estimateBackfillRows,rt(t,i,n)}if(e.requestedChecks.has("resolution")){let i=Ak(e.items,e.statusRegistry,r);t.resolutionBackfillRows=i.resolutionBackfillRows,rt(t,i,n)}if(e.requestedChecks.has("lifecycle")){let i=Hm(e.items,!!e.options.checkStaleBlockers,e.dependencyCycleSeverity,e.parentCycleSeverity,e.statusRegistry,e.lifecyclePatternPolicy,r,e.settings.id_prefix);t.terminalParentFixRows=i.terminalParentFixRows,rt(t,i,n),rt(t,Mm(e.items,r,e.statusRegistry),n)}if(e.requestedChecks.has("files")){let i=await Jm(e.items,e.workspaceRoot,e.pmRoot,e.fileScanMode,!!e.options.includePmInternals,!!e.options.verboseFileLists);t.staleLinkPruneRows=i.staleLinkPruneRows,rt(t,i,n)}return e.requestedChecks.has("command_references")&&rt(t,Vm(e.items,e.settings.id_prefix,r),n),e.requestedChecks.has("history_drift")&&rt(t,await um(e.pmRoot,e.items,r),n),e.requestedChecks.has("format_version")&&rt(t,Uk(e.items,r),n),e.requestedChecks.has("storage_integrity")&&rt(t,await zk(e.pmRoot,e.items,q(e.settings,z()).type_to_folder,e.settings),n),t}function Gk(e,t,n){let r=[];return e.autoFix===!0&&(r.push(...Lu(t.closeReasonBackfillRows)),r.push(...Mu(t.resolutionBackfillRows)),r.push(...Fu(t.estimateBackfillRows,n.validation.estimate_defaults_by_type)),r.push(...ju(t.terminalParentFixRows))),e.pruneMissing===!0&&r.push(...Uu(t.staleLinkPruneRows)),r}async function Wk(e,t,n,r,i,a){if(e.autoFix!==!0&&e.pruneMissing!==!0)return;let o=Gk(e,t,n),{applicable:s,gated:c}=qu(o,r),l=e.dryRun===!0,d=[],u=[];if(!l){let m=await Ym(s,i,a);d.push(...m.applied.map(Cn)),u.push(...m.failed.map(({fix:p,error:f})=>({...Cn(p),error:f instanceof Error?f.message:String(f)})))}return{mode:l?"dry_run":"apply",auto_fix:e.autoFix===!0,prune_missing:e.pruneMissing===!0,granted_fix_scopes:[...r].sort((m,p)=>m.localeCompare(p)),planned_count:o.length,applied_count:d.length,gated_count:c.length,failed_count:u.length,planned_fixes:o.map(Cn),applied_fixes:d,gated_fixes:c.map(m=>({...Cn(m),gate_hint:`Withheld: re-run with --fix-scope ${m.gate} to apply.`})),failed_fixes:u}}async function Xm(e,t,n={}){us(e.counts===!0,e.full===!0,"--counts");let r=e.autoFix===!0||e.pruneMissing===!0;if(e.dryRun===!0&&!r)throw new y("--dry-run requires --auto-fix or --prune-missing (there is nothing to preview otherwise).",_.USAGE);if(e.fixScope!==void 0&&e.fixScope.length>0&&e.autoFix!==!0)throw new y("--fix-scope requires --auto-fix.",_.USAGE);let i=zu(e.fixScope),a=L(process.cwd(),t.path);if(!await A(K(a)))throw new y(`Tracker is not initialized at ${a}. Run pm init first.`,_.NOT_FOUND);let o=await I(a),s=Be(o.schema),c=q(o,z()),l=Im(e),d=[],u=await dm({includeBody:l.has("history_drift"),pmRoot:a,settings:o,typeToFolder:c.type_to_folder,warnings:d});if(l.has("history_drift")){let E=await mn(a);E.actionable_unknown_event_count>0&&d.push(`validate_history_unknown_author_events:${E.actionable_unknown_event_count}`)}let m=typeof e.metadataProfile=="string"?"option":"settings",p=vm(typeof e.metadataProfile=="string"?e.metadataProfile:o.validation.metadata_profile),f=mk(p,m,o.validation.metadata_required_fields),g=dk(o),h=bm(e.dependencyCycleSeverity),w=km(e.parentCycleSeverity),v=Sm(e.scanMode),b=Em(a),x=await qk({requestedChecks:l,options:e,global:t,pmRoot:a,workspaceRoot:b,settings:o,items:u,statusRegistry:s,metadataPolicy:f,lifecyclePatternPolicy:g,dependencyCycleSeverity:h,parentCycleSeverity:w,fileScanMode:v,initialWarnings:[...new Set(d)]}),R=r?await Wk(e,x,o,i,t,n):void 0,k=[...new Set(x.warnings)].sort((E,U)=>E.localeCompare(U)),T={ok:!x.checks.some(E=>E.status==="error"),has_warnings:k.length>0,checks:x.checks,warnings:k,...R!==void 0?{fixes:R}:{},generated_at:$(),projection:{mode:"full",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:["diagnostic_rows"]}};return e.counts!==!0?T:{...lk(T),projection:{mode:"counts",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:[]}}}import{execFile as Bk}from"node:child_process";import{promisify as Hk}from"node:util";(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]="f9c26dab-b2fb-5ca0-b575-682b4b0bb830")}catch{}})();var Jk=Hk(Bk),Vk=16,Kk=3e4;function Yk(e,t,n){if(!(e.keys[t].value_type==="number"?typeof n.value=="number"&&Number.isFinite(n.value):Array.isArray(n.value)&&n.value.every(a=>typeof a=="string")))throw new TypeError(`assurance provider ${e.id} key ${t} returned the wrong value type`);if(!Number.isInteger(n.population_size)||n.population_size<0||!Number.isFinite(n.cost)||n.cost<0)throw new TypeError(`assurance provider ${e.id} returned an invalid population or cost`);return n}function Xk(e,t){let n=e.keys[t.key];if(!n)throw new TypeError(`assurance provider ${e.id} does not declare key ${t.key}`);let r=t.parameters??{},i=n.parameters??{};for(let a of Object.entries(i).filter(([,o])=>o.required===!0).map(([o])=>o))if(!Object.hasOwn(r,a))throw new TypeError(`assurance provider ${e.id} key ${t.key} requires parameter ${a}`);for(let[a,o]of Object.entries(r)){let s=i[a];if(!s)throw new TypeError(`assurance provider ${e.id} key ${t.key} does not declare parameter ${a}`);if(o===null||typeof o!==s.type)throw new TypeError(`assurance provider ${e.id} parameter ${a} must be ${s.type}`)}return{...r}}async function Zk(e,t,n,r){let i=Xk(e,t),a=Promise.resolve().then(()=>e.resolve({provider:e.id,key:t.key,parameters:i,trigger:r,pm_root:n,...ps(n)}));a.catch(()=>{});let o;try{let s=await Promise.race([a,new Promise((c,l)=>{o=setTimeout(()=>l(new TypeError(`assurance provider ${e.id} timed out`)),e.timeout_ms??Kk),o.unref?.()})]);return Yk(e,t.key,s)}finally{clearTimeout(o)}}function Qm(e,t,n,r){let i=e;for(let a of t.split(".")){if(typeof i!="object"||i===null||Array.isArray(i))throw new Fe(`assurance field ${t} is not present`,{source_kind:n,field:t,...r?{check:r}:{}});i=i[a]}if(typeof i=="number"&&Number.isFinite(i)||Array.isArray(i)&&i.every(a=>typeof a=="string"))return i;throw new Fe(`assurance field ${t} must resolve to a finite number or string array`,{source_kind:n,field:t,...r?{check:r}:{}})}function Zm(e,t,n,r){let i=e.checks.find(o=>o.name===t);if(!i)throw new Fe(`assurance check ${t} is not present`,{source_kind:r,field:n,check:t});return{value:n==="status"||n==="ok"?i.ok?0:1:Qm(i.details,n,r,t),population_size:1,cost:e.checks.length}}async function Qk(e,t){if(t?.trim())return t.trim();try{let{stdout:n}=await Jk("git",["rev-parse","HEAD^{commit}"],{cwd:e,encoding:"utf8",timeout:5e3,windowsHide:!0});return n.trim()}catch{return"working-copy"}}async function ex(e,t){let n=new Array(t.length),r=0,i=Array.from({length:Math.min(Vk,t.length)},async()=>{for(;r<t.length;){let a=r;r+=1;let o=t[a],s=await tr(Gn(e,o.id),o.id);n[a]=s.map(c=>({op:c.op,author:c.author,agent_harness:c.agent_harness,agent_model:c.agent_model}))}});return await Promise.all(i),n.flat()}async function Dn(e,t={}){let n=await I(e),r=q(n),i=Be(n.schema),o=(await Pt(e,n.item_format,r.type_to_folder,void 0,n.schema)).map(p=>({...p,id:p.id,status:p.status,type:p.type})),s={path:e},c=z(),l=Object.fromEntries((c?.assurance_providers??[]).map(p=>[p.definition.id,{cost_class:p.runtime_definition.cost_class,network:p.runtime_definition.network}])),d=new Map,u,m;return{tree_id:t.resolve_tree===!1?t.tree_id??"working-copy":await Qk(e,t.tree_id),items:o,history:t.include_history===!1?[]:await ex(e,o),terminal_statuses:[...i.terminal_statuses],provider_capabilities:{...l,...t.provider_capabilities},external:async p=>{if(p.kind==="graph"){let h=oe({operation:p.operation,parameters:p.parameters??{}}),w=d.get(h);w===void 0&&(w=Ys(p.operation,void 0,void 0,{...p.parameters,full:!0},s),d.set(h,w));let v=await w;return{value:Qm(v,p.field,p.kind),population_size:o.length,cost:o.length}}if(p.kind==="validate"){u??=Xm({counts:!0},s);let h=await u;return Zm(h,p.check,p.field,p.kind)}if(p.kind==="health"){m??=Iu(s,{checkOnly:!0,full:!0});let h=await m;return Zm(h,p.check,p.field,p.kind)}let f=t.providers?.[p.provider];if(f)return f(p);let g=Rs(c,p.provider);if(!g)throw new TypeError(`assurance provider ${p.provider} is not registered`);return Zk(g.runtime_definition,p,e,t.trigger??"sdk")}}}import{createHash as tx}from"node:crypto";(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]="e78c3363-1741-52b9-8bd5-729e3ccada50")}catch{}})();function ii(e){return{files:(Array.isArray(e.files)?e.files:[]).flatMap(t=>{if(typeof t!="object"||t===null||Array.isArray(t))return[];let n=t.path;return typeof n=="string"?[n]:[]}),package_names:Array.isArray(e.package_names)?e.package_names.filter(t=>typeof t=="string"):[],item_ids:[e.id],tags:Array.isArray(e.tags)?e.tags.filter(t=>typeof t=="string"):[],error_codes:Array.isArray(e.error_codes)?e.error_codes.filter(t=>typeof t=="string"):[]}}(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]="59f5918f-108e-5cad-905b-7f690c3c4794")}catch{}})();var oi=["production_defect","nightly_regression","scanner_finding","review_caught_late"],yo=["gate_added","gate_strengthened","explicit_waiver"],ep=256,nx=1024,Pn=new Map,rx=["files","package_names","item_ids","tags","error_codes"];function ge(e){return[...new Set(e.map(t=>t.trim()).filter(Boolean))].sort((t,n)=>t<n?-1:1)}function tp(e){return tx("sha256").update(oe(e)).digest("hex")}function _o(e,t){if(typeof e!="string"||!e.trim())throw new TypeError(`${t} must be a non-empty string`)}function Nn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Zt(e){return Array.isArray(e)&&e.every(t=>typeof t=="string")}function rp(e,t){if(!Nn(e))throw new TypeError(`${t} must be an object`);for(let n of rx)if(e[n]!==void 0&&!Zt(e[n]))throw new TypeError(`${t}.${n} must be an array of strings`);return e}function ix(e,t){if(!Nn(e))throw new TypeError(`defect recurrence family ${t} triggers must be an object`);for(let r of["package_names","item_ids","tags","error_codes"])if(e[r]!==void 0&&!Zt(e[r]))throw new TypeError(`defect recurrence family ${t} triggers.${r} must be an array of strings`);let n=e.file_patterns;if(n!==void 0&&!Zt(n))throw new TypeError(`defect recurrence family ${t} triggers.file_patterns must be an array of strings`);for(let r of n??[])if(r.length>ep)throw new TypeError(`defect recurrence family ${t} file pattern exceeds ${ep} characters`)}function ax(e,t){if(_o(e.id,"defect recurrence family id"),t.has(e.id))throw new TypeError(`Duplicate defect recurrence family ${e.id}`);if(t.add(e.id),!Number.isInteger(e.version)||e.version<1)throw new TypeError(`defect recurrence family ${e.id} version must be a positive integer`);if(!oi.includes(e.escape_class))throw new TypeError(`defect recurrence family ${e.id} has an invalid escape class`);_o(e.title,`defect recurrence family ${e.id} title`),_o(e.owner_item_id,`defect recurrence family ${e.id} owner_item_id`)}function ox(e){if(!Zt(e.historical_item_ids)||e.historical_item_ids.length===0||e.historical_item_ids.some(t=>!t.trim()))throw new TypeError(`defect recurrence family ${e.id} requires historical_item_ids`);if(ix(e.triggers,e.id),!Nn(e.checks)||!Zt(e.checks.local)||!Zt(e.checks.hosted)||e.checks.local.length===0||e.checks.hosted.length===0||e.checks.local.some(t=>!t.trim())||e.checks.hosted.some(t=>!t.trim()))throw new TypeError(`defect recurrence family ${e.id} checks must contain nonempty local and hosted string arrays`)}function sx(e){if(!Nn(e.budget)||typeof e.budget.max_escape_rate!="number"||!Number.isFinite(e.budget.max_escape_rate)||typeof e.budget.max_false_positive_rate!="number"||!Number.isFinite(e.budget.max_false_positive_rate))throw new TypeError(`defect recurrence family ${e.id} requires numeric budgets`);if(e.budget.max_escape_rate<0||e.budget.max_escape_rate>1||e.budget.max_false_positive_rate<0||e.budget.max_false_positive_rate>1)throw new TypeError(`defect recurrence family ${e.id} budgets must be between 0 and 1`)}function cx(e){let t=rp(e.negative_control,`defect recurrence family ${e.id} negative_control`);if(vo(e,t,{}).length===0)throw new TypeError(`defect recurrence family ${e.id} negative_control must select its own family`)}function wo(e){if(e.version!==1)throw new TypeError(`Unsupported defect recurrence policy version ${e.version}`);if(typeof e.evidence_epoch!="string"||!Number.isFinite(Date.parse(e.evidence_epoch)))throw new TypeError("defect recurrence evidence_epoch must be an ISO timestamp");let t=new Set;for(let n of e.families){if(!Nn(n))throw new TypeError("defect recurrence family must be an object");ax(n,t),ox(n),sx(n),cx(n)}}function lx(e,t){let n=Pn.get(e);if(n===void 0){if(Pn.size>=nx){let i=Pn.keys().next().value;Pn.delete(i)}let r=e.replaceAll("**","\0").replaceAll(/[|\\{}()[\]^$+?./]/gu,"\\$&").replaceAll("*","[^/]*").replaceAll("\0",".*");n=new RegExp(`^${r}$`,"u"),Pn.set(e,n)}return n.test(t)}function dx(e,t){let n=[],r=ge(e.triggers.file_patterns??[]);for(let i of ge(t.files??[]))for(let a of r)lx(a,i)&&n.push({signal:"file",value:i,matched:a});return n}function ux(e,t){let n=[{signal:"package",values:ge(t.package_names??[]),triggers:ge(e.triggers.package_names??[])},{signal:"tag",values:ge(t.tags??[]),triggers:ge(e.triggers.tags??[])},{signal:"error_code",values:ge(t.error_codes??[]),triggers:ge(e.triggers.error_codes??[])}],r=[];for(let i of n){let a=new Set(i.triggers);for(let o of i.values)a.has(o)&&r.push({signal:i.signal,value:o,matched:o})}return r}function mx(e,t,n){let r=new Set(e.triggers.item_ids??[]);return ge(t.item_ids??[]).flatMap(i=>r.has(i)||n[i]?.includes(e.id)?[{signal:"item",value:i,matched:e.id}]:[])}function vo(e,t,n){return[...dx(e,t),...ux(e,t),...mx(e,t,n)].sort((i,a)=>i.signal!==a.signal?i.signal.localeCompare(a.signal):i.value!==a.value?i.value.localeCompare(a.value):i.matched.localeCompare(a.matched))}function px(e,t){if(!e)return 0;let n;try{n=JSON.parse(Buffer.from(e,"base64url").toString("utf8"))}catch{throw new TypeError("defect change-risk cursor is invalid")}if(typeof n!="object"||n===null||Array.isArray(n)||n.index_fingerprint!==t||!Number.isInteger(n.offset)||n.offset<0)throw new TypeError("defect change-risk cursor does not match this index");return n.offset}function fx(e){return[e.files,e.package_names,e.item_ids,e.tags,e.error_codes].reduce((t,n)=>t+(n?.length??0),0)}function ip(e,t,n={}){wo(e);let r=[...e.families].sort((d,u)=>d.id<u.id?-1:1),i=tp({...e,families:r}),a=new Set(n.changed_item_ids??[]),o=n.previous_index?.policy_fingerprint===i,s=o?Object.fromEntries(Object.entries(n.previous_index?.item_families??{}).filter(([d])=>!a.has(d))):{},c=o?Object.keys(s).length:0;for(let d of t){let u=ii(d),m=r.filter(p=>p.historical_item_ids.includes(d.id)||vo(p,u,{}).length>0).map(p=>p.id);m.length>0?s[d.id]=m:delete s[d.id]}let l=Object.fromEntries(Object.entries(s).sort(([d],[u])=>d<u?-1:1).map(([d,u])=>[d,ge(u)]));return{version:1,policy_fingerprint:i,index_fingerprint:tp({policy_fingerprint:i,item_families:l}),families:r,item_families:l,build:{items_scanned:t.length,items_reused:c,items_indexed:Object.keys(l).length}}}function ap(e,t,n={}){let r=n.limit??25;if(!Number.isInteger(r)||r<1||r>100)throw new TypeError("defect change-risk limit must be an integer from 1 through 100");let i=px(n.cursor,e.index_fingerprint),a=e.families.flatMap(d=>{let u=vo(d,t,e.item_families);return u.length===0?[]:[{family_id:d.id,family_version:d.version,owner_item_id:d.owner_item_id,escape_class:d.escape_class,reasons:u,local_checks:ge(d.checks.local),hosted_checks:ge(d.checks.hosted),budget:d.budget}]}),o=a.slice(i,i+r),s=i+o.length,c=s<a.length?Buffer.from(JSON.stringify({index_fingerprint:e.index_fingerprint,offset:s})).toString("base64url"):void 0,l={risk_detected:a.length>0,index_fingerprint:e.index_fingerprint,items:o,total:a.length,...c?{next_cursor:c}:{},required_local_checks:ge(a.flatMap(d=>d.local_checks)),required_hosted_checks:ge(a.flatMap(d=>d.hosted_checks)),row_contract:{row_keys:["items"],jq_selector:".items[]"}};return{...l,cost:{families_evaluated:e.families.length,signals_evaluated:fx(t),families_selected:a.length,estimated_output_tokens:Math.ceil(JSON.stringify(l).length/4)}}}function hx(e){return typeof e.type=="string"&&e.type.toLowerCase()==="issue"||(Array.isArray(e.tags)?e.tags:[]).some(t=>typeof t=="string"&&["bug","defect","security"].includes(t.toLowerCase()))}function ai(e){return typeof e=="string"&&e.trim().length>0}function np(e){return Array.isArray(e)&&e.length>0&&e.every(ai)}function gx(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return{valid:!1,expired:!1};let n=e;if(!yo.includes(n.disposition)||typeof n.owner!="string"||!n.owner.trim())return{valid:!1,expired:!1};if(n.disposition==="explicit_waiver"){let r=Date.parse(n.waiver_expires_at??"");return{valid:ai(n.waiver_reason)&&Number.isFinite(r)&&r>=t,expired:Number.isFinite(r)&&r<t}}return{valid:ai(n.gate_id)&&ai(n.negative_control)&&np(n.local_checks)&&np(n.hosted_checks),expired:!1}}function _x(e,t){let n=[];if(!Number.isFinite(Date.parse(typeof e.completed_at=="string"?e.completed_at:""))&&!Number.isFinite(Date.parse(typeof e.closed_at=="string"?e.closed_at:""))&&n.push({item_id:e.id,kind:"invalid_completion_timestamp",detail:`${e.id} requires a valid completed_at or closed_at timestamp after the defect-evidence epoch.`}),typeof e.escape_class!="string"?n.push({item_id:e.id,kind:"missing_escape_class",detail:`${e.id} requires escape_class after the defect-evidence epoch.`}):oi.includes(e.escape_class)||n.push({item_id:e.id,kind:"invalid_escape_class",detail:`${e.id} has unsupported escape_class ${e.escape_class}.`}),e.gate_evidence===void 0)return n.push({item_id:e.id,kind:"missing_gate_evidence",detail:`${e.id} requires structured gate_evidence after the defect-evidence epoch.`}),n;let r=gx(e.gate_evidence,t);return r.valid||n.push({item_id:e.id,kind:r.expired?"expired_waiver":"invalid_gate_evidence",detail:r.expired?`${e.id} carries an expired gate-evidence waiver.`:`${e.id} gate_evidence does not prove a gate or explicit waiver.`}),n}function oD(e,t,n,r=new Date){wo(t);let i=Date.parse(t.evidence_epoch),a=new Set(n),o=e.filter(m=>a.has(m.status)&&hx(m)),s=o.filter(m=>{let p=Date.parse(typeof m.completed_at=="string"?m.completed_at:"");if(Number.isFinite(p))return p>=i;let f=Date.parse(typeof m.closed_at=="string"?m.closed_at:"");if(Number.isFinite(f))return f>=i;let g=Date.parse(typeof m.created_at=="string"?m.created_at:"");return!Number.isFinite(g)||g>=i}),c=Object.fromEntries(oi.map(m=>[m,0])),l=Object.fromEntries(yo.map(m=>[m,0])),d=o.filter(m=>typeof m.escape_class=="string"&&oi.includes(m.escape_class));for(let m of d)if(c[m.escape_class]+=1,typeof m.gate_evidence=="object"&&m.gate_evidence!==null&&!Array.isArray(m.gate_evidence)){let p=m.gate_evidence.disposition;typeof p=="string"&&yo.includes(p)&&(l[p]+=1)}let u=s.flatMap(m=>_x(m,r.getTime()));return u.sort((m,p)=>m.item_id!==p.item_id?m.item_id.localeCompare(p.item_id):m.kind.localeCompare(p.kind)),{ok:u.length===0,governed_item_count:s.length,classified_item_count:d.length,class_counts:c,evidence_disposition_counts:l,findings:u}}function yx(e){if(typeof e!="object"||e===null||Array.isArray(e))throw new TypeError("defect recurrence policy must be an object");let t=e;if(!Array.isArray(t.families))throw new TypeError("defect recurrence policy families must be an array");return wo(t),t}function op(e){if(typeof e!="object"||e===null||Array.isArray(e))throw new TypeError("defect change-risk request must be an object");let t=e,n=rp(t.change,"defect change-risk request.change");if(t.cursor!==void 0&&typeof t.cursor!="string")throw new TypeError("defect change-risk request.cursor must be a string");if(t.limit!==void 0&&!Number.isInteger(t.limit))throw new TypeError("defect change-risk request.limit must be an integer");return{policy:yx(t.policy),change:n,...t.cursor===void 0?{}:{cursor:t.cursor},...t.limit===void 0?{}:{limit:t.limit}}}import{createHash as wx}from"node:crypto";(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]="57c12241-812d-5db6-9a07-ca256152b130")}catch{}})();var bo,sp=["list","show","put","remove","run","verdicts","presets","apply","derive","promote","risk"],cp=["measurement","assertion","gate"];function vx(e){if(sp.includes(e))return e;throw new y(`Unknown assurance action ${e}. Expected: ${sp.join(", ")}`,_.USAGE)}function bx(e){if(e&&cp.includes(e))return e;throw new y(`Assurance declaration kind is required. Expected: ${cp.join(", ")}`,_.USAGE)}function lp(e){if(e&&wr.includes(e))return e;throw new y(`Assurance preset is required. Expected: ${wr.join(", ")}`,_.USAGE)}function ko(e){if(e.owner?.trim())return e.owner.trim();throw new y("assurance preset and derivation actions require --owner <pm-item-id>",_.USAGE)}function kx(e,t){let n=t;if(typeof t=="string")if(!t.trim())n=void 0;else try{n=JSON.parse(t)}catch(r){throw new y("assurance definition must be valid JSON",_.USAGE,{reason:r instanceof Error?r.message:"invalid_json"})}if(typeof n!="object"||n===null||Array.isArray(n))throw new y("assurance put requires a JSON object definition",_.USAGE);return n}async function xx(e){let[t,n,r]=await Promise.all([cn(e,"measurement"),cn(e,"assertion"),cn(e,"gate")]);return{version:1,measurements:t.items,assertions:n.items,gates:r.items}}function dp(e,t){return t===!0?{id:e.id}:e}async function Sx(e,t){let n=t.authorization_decision;if(!n)return[];let r=await Dn(e,{include_history:!1,resolve_tree:!1}),i=r.items.find(o=>o.id===n),a=new Set(r.terminal_statuses);if(!i||i.type.toLowerCase()!=="decision"||!a.has(i.status))throw new y(`Assurance authorization ${n} must name a terminal Decision item`,_.USAGE);return[i.id]}async function Ex(e,t){let n=Hi(e.limit,"assurance verdict limit");if(n!==void 0&&(n<1||n>Ft))throw new y(`assurance verdict limit must be an integer from 1 through ${Ft}`,_.USAGE);let r=await pc(t,{gate_id:e.id??e.gate,limit:n});return{items:r,count:r.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function Ax(e,t,n){if(e==="presets"){if(t.preset??t.id)return vr(lp(t.preset??t.id),ko(t));let i=wr.map(a=>{let o=vr(a,"pm-owner");return{id:a,title:o.title,description:o.description}});return{items:i,count:i.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}if(e==="apply")return Lt(()=>hc(n,lp(t.preset??t.id),ko(t),{author:t.author,message:t.message}));if(e==="derive"){let i=await gc(await Dn(n,{resolve_tree:!1,trigger:"derive"}),ko(t)),a=t.apply?await Lt(()=>_c(n,i,{author:t.author,message:t.message??"Accept observation-derived assurance proposals"})):void 0;return{items:i,count:i.length,...a?{applied:a}:{}}}if(!t.id)throw new y("assurance promote requires an assertion id",_.USAGE);if(t.enforcement!=="warn"&&t.enforcement!=="block")throw new y("assurance promote requires --enforcement warn|block",_.USAGE);let r=await Ui(n,"assertion",t.id);return Lt(()=>yc(n,r,t.enforcement,{author:t.author,message:t.message}))}async function Rx(e,t,n){if(!e.id)throw new y("assurance run requires a gate id",_.USAGE);let r=e.id;if(!e.trigger)throw new y("assurance run requires a trigger",_.USAGE);if(!gt.includes(e.trigger))throw new y(`Unknown assurance trigger ${e.trigger}. Expected: ${gt.join(", ")}`,_.USAGE);let i=e.trigger,[a,o]=await Promise.all([xx(t),Dn(t,{...n.workspace,tree_id:e.tree,trigger:i})]),s=await Xs(()=>lc(r,a,o,{trigger:i,dry_run:e.dry_run===!0}));return s.dry_run||await mc(t,s,{author:e.author,message:e.message}),s}function up(e){throw e instanceof y?e:new y(e instanceof Error?e.message:"assurance risk request is invalid",_.USAGE)}function Ix(e){if(e.limit!==void 0)throw new y("assurance risk does not accept --limit; set limit inside the risk definition",_.USAGE);let t=e.definition;if(typeof t=="string")try{t=JSON.parse(t)}catch(n){throw new y("assurance risk definition must be valid JSON",_.USAGE,{reason:n instanceof Error?n.message:"invalid_json"})}try{return op(t)}catch(n){return up(n)}}function Cx(e,t){let n=new Set;for(let[r,i]of t)e.item_fingerprints.get(r)!==i&&n.add(r);for(let r of e.item_fingerprints.keys())t.has(r)||n.add(r);return n}function $x(e,t,n){let r=oe(t.policy),i=bo?.pm_root===e?bo:void 0,a=new Map(n.map(l=>[l.id,wx("sha256").update(oe(ii(l))).digest("hex")])),o=i?.policy_serialized===r?i:void 0,s=o?Cx(o,a):new Set,c=ip(t.policy,o?n.filter(l=>s.has(l.id)):n,o?{previous_index:o.index,changed_item_ids:[...s]}:{});return bo={pm_root:e,policy_serialized:r,item_fingerprints:a,index:c},c}async function Tx(e,t){let n=Ix(e),r=await Dn(t,{include_history:!1,resolve_tree:!1});try{return ap($x(t,n,r.items),n.change,{cursor:n.cursor,limit:n.limit})}catch(i){return up(i)}}async function Ox(e,t={},n={}){let r=vx(e.action),i=L(process.cwd(),t.path);if(r==="presets"||r==="apply"||r==="derive"||r==="promote")return Ax(r,e,i);if(r==="verdicts")return Ex(e,i);if(r==="run")return Rx(e,i,n);if(r==="risk")return Tx(e,i);let a=bx(e.kind);if(r==="list")return cn(i,a);if(!e.id)throw new y(`assurance ${r} requires an id`,_.USAGE);let o=e.id;if(r==="show")return Ui(i,a,o);if(r==="remove"){let d=await Lt(()=>uc(i,a,o,{author:e.author,message:e.message}));return dp(d,e.idOnly)}let s=kx(a,e.definition);if(s.id!==o)throw new y(`Assurance definition id ${s.id} does not match requested id ${o}`,_.USAGE);let c={author:e.author,message:e.message,...a==="assertion"?{authorized_decision_ids:await Sx(i,s)}:{}},l=await Lt(()=>_r(i,a,s,c));return dp(l,e.idOnly)}function bD(e,t,n){let r={...e,...t};return Ox({action:C(r,"subcommand")??C(r,"assuranceAction")??C(r,"operation")??"",kind:C(r,"kind"),id:C(r,"id"),definition:r.definition,trigger:C(r,"trigger"),tree:C(r,"treeId")??C(r,"tree"),gate:C(r,"gate"),limit:Hi(r.limit,"assurance verdict limit"),dry_run:r.dryRun===!0||r.dry_run===!0,fullChangedFields:r.fullChangedFields===!0,idOnly:r.idOnly===!0,author:C(r,"author"),message:C(r,"message"),preset:C(r,"preset"),owner:C(r,"owner"),apply:r.apply===!0,enforcement:C(r,"enforcement")},n)}import{execFile as Dx}from"node:child_process";import Px from"node:path";import{promisify as Nx}from"node:util";(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]="cdfc451a-1148-50c5-934a-cd8bc2bb39e7")}catch{}})();var Mx=Nx(Dx),Lx="@unbrained/pm-cli",Fx="latest";function jx(e){let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new y('Options "--project/--local" and "--global" are mutually exclusive.',_.USAGE);return n?"global":"project"}function ci(e){return e.trim().toLowerCase()}function mp(e,t){let n=ci(t);return[e.name,e.directory,e.source.input,e.source.location,e.source.package,e.source.repository,e.source.owner&&e.source.repo?`${e.source.owner}/${e.source.repo}`:void 0].some(i=>typeof i=="string"&&ci(i)===n)}function Ux(e,t){let n=L(process.cwd(),t.path),r=Et(n,process.cwd());return{selected_root:e==="global"?r.global:r.project}}async function zx(e,t,n){try{let r=await Mx(e,t,{cwd:n?.cwd,encoding:"utf8"});return{stdout:r.stdout,stderr:r.stderr}}catch(r){let i=typeof r=="object"&&r!==null&&"stderr"in r?String(r.stderr??""):"",a=i.trim().length>0?i.trim():r instanceof Error?r.message:String(r);throw new y(`Command failed: ${e} ${t.join(" ")}
45
+ ${a}`,_.GENERIC_FAILURE)}}async function qx(){return Mo(import.meta.url,["../../.."])}function li(e){return typeof e.tag=="string"&&e.tag.trim().length>0?e.tag.trim():Fx}function si(e){return typeof e.packageName=="string"&&e.packageName.trim().length>0?e.packageName.trim():Lx}async function Gx(e,t){let n=e.commandRunner??zx,r=si(e),i=li(e),a=`${r}@${i}`,o=["npm","install","-g",a];e.repair===!0&&o.push("--force");let s=await qx(),c={requested:!0,status:"planned",package:r,target:a,command:o,before_version:s,repair:e.repair===!0};if(t)return c;try{await n(o[0],o.slice(1));let l=await n("pm",["--version"]);return{...c,status:"updated",after_version:l.stdout.trim()||void 0}}catch(l){return{...c,status:"failed",error:l instanceof Error?l.message:String(l)}}}function Wx(e){return Px.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")||e.startsWith("file:")}function Bx(e,t){if(e.kind==="npm"){let n=e.input.startsWith("npm:")?e.input.slice(4).trim():e.input.trim();return!Wx(n)&&e.package&&e.package.trim().length>0?`npm:${e.package.trim()}@${t}`:e.input.startsWith("npm:")?e.input:`npm:${e.input}`}return e.input}async function Hx(e,t){let n=Bx(e,t);return e.kind!=="local"||await A(n)?n:await A(e.location)?e.location:n}function Jx(e,t,n,r){let i=["pm","install",t,n==="global"?"--global":"--project"];return e.kind==="github"&&r&&r.trim().length>0&&i.push("--ref",r.trim()),i}async function pp(e,t){let n=Ux(e,t);return(await pe(n.selected_root)).state.entries.filter(i=>i.scope===e)}async function Vx(e,t,n){let r=await pp(e,t);return r.find(i=>mp(i,n.name))??r.find(i=>ci(i.directory)===ci(n.directory))}async function Kx(e,t,n,r,i){let a=li(t),o=await Hx(e.source,a),s=Jx(e.source,o,r,e.source.ref),c={name:e.name,directory:e.directory,scope:r,source:e.source,status:"planned",command:s,previous_version:e.manifest_version};if(i)return c;try{await La(o,{install:!0,project:r==="project",global:r==="global",ref:e.source.kind==="github"?e.source.ref:void 0},n);let l=await Vx(r,n,e);return{...c,status:"updated",installed_version:l?.manifest_version}}catch(l){return{...c,status:"failed",error:l instanceof Error?l.message:String(l)}}}function Yx(e,t,n,r){let i=[n?e.status:void 0,...t.map(a=>a.status)].filter(a=>typeof a=="string");return{requested_cli:n,requested_packages:r,planned:i.filter(a=>a==="planned").length,updated:i.filter(a=>a==="updated").length,skipped:i.filter(a=>a==="skipped").length,failed:i.filter(a=>a==="failed").length}}async function ID(e,t,n){if(t.cliOnly===!0&&t.packagesOnly===!0)throw new y('Options "--cli-only" and "--packages-only" are mutually exclusive.',_.USAGE);let r=jx(t),i=t.dryRun===!0,a=typeof e=="string"&&e.trim().length>0?e.trim():void 0;if(t.cliOnly===!0&&a)throw new y('A package target cannot be used with "--cli-only".',_.USAGE);let o=!(t.packagesOnly===!0||a),s=t.cliOnly!==!0,c=o?await Gx(t,i):{requested:!1,status:"skipped",package:si(t),target:`${si(t)}@${li(t)}`,command:["npm","install","-g",`${si(t)}@${li(t)}`],repair:t.repair===!0,reason:"not_requested"},l=s?await pp(r,n):[];if(a&&(l=l.filter(m=>mp(m,a)),l.length===0))throw new y(`Managed package "${a}" was not found in ${r} scope.`,_.NOT_FOUND);let d=[];for(let m of l)d.push(await Kx(m,t,n,r,i));let u=Yx(c,d,o,s);return{ok:u.failed===0,action:"upgrade",dry_run:i,scope:r,target:a,cli:c,packages:d,summary:u}}import Qt from"node:fs/promises";import ui from"node:path";import di from"node:fs/promises";import xo from"node:path";(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]="b26cf702-330e-5cf5-8371-204220d5c5c9")}catch{}})();var Xx=864e5;function Zx(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!="object"||t===null||Array.isArray(t))return null;let n=t.created_at;return typeof n=="string"?n:null}async function Qx(e,t){let n;try{n=await di.readdir(e,{withFileTypes:!0})}catch(i){if(j(i))return[];throw i}let r=[];for(let i of n)if(i.isDirectory()){let a=xo.join(e,i.name),o;try{o=await di.readdir(a)}catch(s){j(s)||t.push(`checkpoint_subdir_unreadable:${i.name}`);continue}for(let s of o)s.endsWith(".json")&&r.push(`${i.name}/${s}`)}else i.name.endsWith(".json")&&r.push(i.name);return r.sort()}async function fp(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*Xx,o=xo.join(e,"checkpoints"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c=await Qx(o,s.warnings);for(let l of c){let d=xo.join(o,l),u=`checkpoints/${l}`;s.scanned+=1,r?.onRead&&s.warnings.push(...await r.onRead(d));let m;try{m=await di.readFile(d,"utf8")}catch(w){if(j(w)){s.scanned-=1;continue}s.warnings.push(`checkpoint_unreadable:${l}`),s.retained.push(u),s.entries.push({file:u,created_at:null,age_seconds:null,stale:!1,reason:"unparseable"});continue}let p=Zx(m),f=p===null?Number.NaN:Date.parse(p);if(!Number.isFinite(f)){s.warnings.push(`checkpoint_unparseable:${l}`),s.retained.push(u),s.entries.push({file:u,created_at:p,age_seconds:null,stale:!1,reason:"unparseable"});continue}let g=i-f,h={file:u,created_at:p,age_seconds:Math.floor(g/1e3),stale:g>a,reason:g>a?"expired":"active"};if(!h.stale){s.retained.push(u),s.entries.push(h);continue}if(!n){try{await di.unlink(d)}catch(w){if(!j(w)){s.warnings.push(`checkpoint_remove_failed:${l}`),s.retained.push(u),s.entries.push(h);continue}}r?.onWrite&&s.warnings.push(...await r.onWrite(d))}s.removed.push(u),s.entries.push(h)}return s}import So from"node:fs/promises";import hp from"node:path";(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]="7df80849-51e1-5efa-b40a-b44088f941a9")}catch{}})();var eS=1440*60*1e3,tS=new Set(["committed","compensated"]);function nS(e){let t;try{t=JSON.parse(e)}catch{return{status:null,updatedAt:null}}if(typeof t!="object"||t===null||Array.isArray(t))return{status:null,updatedAt:null};let n=t;return{status:typeof n.status=="string"?n.status:null,updatedAt:typeof n.updatedAt=="string"?n.updatedAt:null}}function rS(e,t,n,r,i){let a=n===null?Number.NaN:Date.parse(n);if(t===null||!Number.isFinite(a))return{entry:{file:e,status:t,age_seconds:null,stale:!1,reason:"unparseable"},remove:!1};let o=r-a;return tS.has(t)?o>i?{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!0},remove:!0}:{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!1,reason:"fresh"},remove:!1}:{entry:{file:e,status:t,age_seconds:Math.floor(o/1e3),stale:!1,reason:"active"},remove:!1}}async function iS(e,t,n,r){let i=r.hooks?.onRead?await r.hooks.onRead(e):[],a=nS(await So.readFile(e,"utf8")),o=rS(t,a.status,a.updatedAt,r.nowMs,r.retentionMs);return o.entry.reason==="unparseable"&&i.push(`transaction_journal_unparseable:${n}`),o.remove&&!r.dryRun&&(await So.rm(e,{force:!0}),r.hooks?.onWrite&&i.push(...await r.hooks.onWrite(e))),{decision:o,warnings:i}}async function gp(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*eS,o=hp.join(e,"transactions","sdk"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c;try{c=(await So.readdir(o)).filter(l=>l.endsWith(".json")).sort((l,d)=>l.localeCompare(d))}catch(l){if(j(l))return s;throw l}for(let l of c){let d=hp.join(o,l),u=`transactions/sdk/${l}`,m=await iS(d,u,l,{dryRun:n,hooks:r,nowMs:i,retentionMs:a});s.warnings.push(...m.warnings),s.scanned+=1;let{decision:p}=m;if(!p.remove){s.retained.push(u),s.entries.push(p.entry);continue}s.removed.push(u),s.entries.push(p.entry)}return s}(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]="e982158e-4a8d-57a9-bd0b-24bd73aef342")}catch{}})();var Mn=["index","embeddings","runtime","locks","checkpoints","transactions"],aS=1440*60*1e3,oS=[{scope:"index",relativePath:"index/manifest.json",kind:"file"},{scope:"embeddings",relativePath:"search/embeddings.jsonl",kind:"file"},{scope:"embeddings",relativePath:"search/vectorization-status.json",kind:"file"},{scope:"embeddings",relativePath:"search/lancedb",kind:"directory"},{scope:"embeddings",relativePath:"search/pending-refresh.json",kind:"file"},{scope:"embeddings",relativePath:"search/pending-refresh.gate.lock",kind:"directory"},{scope:"runtime",relativePath:"runtime/test-runs",kind:"directory"},{scope:"runtime",relativePath:"runtime/history-drift-cache.json",kind:"file"}];async function sS(e,t,n){let r=t.relativePath,i=ui.join(e,r),a=await He({path:i,scope:"project"});try{let o=await Qt.stat(i);if(t.kind==="file"&&!o.isFile())return{removed:!1,warnings:[...a,`not_a_file:${r}`]};if(t.kind==="directory"&&!o.isDirectory())return{removed:!1,warnings:[...a,`not_a_directory:${r}`]};if(n)return{removed:!0,warnings:a};t.kind==="file"?await Qt.unlink(i):await Qt.rm(i,{recursive:!0,force:!0});let s=await re({path:i,scope:"project",op:"gc:remove"});return{removed:!0,warnings:[...a,...s]}}catch(o){if(j(o))return{removed:!1,warnings:a};throw o}}async function cS(e,t){let n=[{relativePath:"runtime/workspace-snapshots/objects",prefix:".create-"},{relativePath:"runtime/workspace-snapshots/refs",prefix:".ref-"}],r=[],i=[],a=[],o=Date.now()-aS;for(let s of n){let c=ui.join(e,s.relativePath);if(!await A(c))continue;let l=(await Qt.readdir(c)).filter(d=>d.startsWith(s.prefix)).sort();for(let d of l){let u=ui.posix.join(s.relativePath,d),m=ui.join(c,d);a.push(...await He({path:m,scope:"project"}));let p=await Qt.stat(m).catch(f=>{if(!j(f))throw f});if(p){if(p.mtimeMs>o){i.push(u);continue}r.push(u),!t&&(await Qt.rm(m,{recursive:!0,force:!0}),a.push(...await re({path:m,scope:"project",op:"gc:workspace_snapshot_temp_remove"})))}}}return{removed:r,retained:i,warnings:a}}function lS(e){if(!e||e.length===0)return[...Mn];let t=e.flatMap(r=>r.split(",")).map(r=>r.trim().toLowerCase()).filter(r=>r.length>0);if(t.length===0)throw new y(`--scope requires at least one value (${Mn.join(",")})`,_.USAGE);let n=new Set;for(let r of t){if(!Mn.includes(r))throw new y(`Invalid --scope value "${r}". Expected one or more of: ${Mn.join(", ")}`,_.USAGE);n.add(r)}return Mn.filter(r=>n.has(r))}function dS(e){let t=[];e.dryRun&&t.push("Dry-run preview only: no cache artifacts were deleted.");let n=e.scopes.includes("index")||e.scopes.includes("embeddings"),r=e.removed.some(i=>i==="index/manifest.json"||i==="search/embeddings.jsonl"||i==="search/vectorization-status.json"||i==="search/lancedb"||i==="search/pending-refresh.json"||i==="search/pending-refresh.gate.lock");return n&&r&&t.push('Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.'),e.removed.includes("runtime/history-drift-cache.json")&&t.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.'),!e.dryRun&&e.removed.some(i=>i.startsWith("checkpoints/"))&&t.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.'),!e.dryRun&&e.removed.some(i=>i.startsWith("transactions/"))&&t.push("Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting."),t}async function YD(e,t={}){let n=L(process.cwd(),e.path);if(!await A(K(n)))throw new y(`Tracker is not initialized at ${n}. Run pm init first.`,_.NOT_FOUND);let r=await I(n),i=t.dryRun===!0,a=lS(t.scope),o=oS.filter(f=>a.includes(f.scope)),s=[],c=[],l=[];for(let f of o){let g=await sS(n,f,i);g.removed?s.push(f.relativePath):c.push(f.relativePath),l.push(...g.warnings)}if(a.includes("runtime")){let f=await cS(n,i);s.push(...f.removed),c.push(...f.retained),l.push(...f.warnings)}let d;if(a.includes("locks")){let f=await Hc(n,{dryRun:i,hooks:{onRead:g=>He({path:g,scope:"project"}),onWrite:g=>re({path:g,scope:"project",op:"gc:lock_remove"})}});s.push(...f.removed),c.push(...f.retained),l.push(...f.warnings),d={scanned:f.scanned,removed:f.removed.length,retained:f.retained.length}}let u;if(a.includes("transactions")){let f=r.checkpoints.retention_days,g=await gp(n,{dryRun:i,retentionDays:f,hooks:{onRead:h=>He({path:h,scope:"project"}),onWrite:h=>re({path:h,scope:"project",op:"gc:transaction_journal_remove"})}});s.push(...g.removed),c.push(...g.retained),l.push(...g.warnings),u={scanned:g.scanned,removed:g.removed.length,retained:g.retained.length,retention_days:f}}let m;if(a.includes("checkpoints")){let f=r.checkpoints.retention_days,g=await fp(n,{dryRun:i,retentionDays:f,hooks:{onRead:h=>He({path:h,scope:"project"}),onWrite:h=>re({path:h,scope:"project",op:"gc:checkpoint_remove"})}});s.push(...g.removed),c.push(...g.retained),l.push(...g.warnings),m={scanned:g.scanned,removed:g.removed.length,retained:g.retained.length,retention_days:f}}l.push(...await Zn({mode:i?"gc:dry-run":"gc",total_items:o.length}));let p=dS({dryRun:i,scopes:a,removed:s});return{ok:l.length===0,dry_run:i,scope:a,removed:s,retained:c,warnings:l,...d?{locks:d}:{},...m?{checkpoints:m}:{},...u?{transactions:u}:{},guidance:p,generated_at:$()}}import uS from"node:fs/promises";import Ln from"node:path";(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]="fc124f85-8d28-508b-a3f7-2fe767382197")}catch{}})();var Eo="index/manifest.json",Ao="search/embeddings.jsonl",mS="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function pS(e){return e.progress===!0||process.stderr.isTTY===!0}function ae(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
46
+ `)}catch{}}function fS(e){let t=(e??"keyword").trim().toLowerCase();if(t==="keyword")return"keyword";if(t==="semantic"||t==="hybrid")return t;throw new y("Reindex mode must be one of keyword|semantic|hybrid",_.USAGE)}async function hS(e,t,n,r){let i=[];return{candidates:await Es(e,t,n,i,r),warnings:i}}async function Io(e,t,n,r,i){let a=St(z()),o=[];for(let s of t)if(!(i&&!i.has(s.metadata.id))){if(typeof s.body=="string"){o.push({metadata:s.metadata,body:s.body});continue}try{let c=await uS.readFile(s.item_path,"utf8"),l=Tt(c,{format:s.item_format,schema:n,extensionFieldNames:a,onWarning:d=>r.push(d)});o.push({metadata:s.metadata,body:l.body})}catch{r.push(`item_list_item_read_failed:${Ln.relative(e,s.item_path)}`),o.push({metadata:s.metadata,body:""})}}return o}function gS(e,t,n){let r=e.metadata;return{id:r.id,mode:t,updated_at:r.updated_at,corpus:Ds(e,{fields:n})}}var en=Z;function _S(e){let t=z(),n=en(e.search?.provider);if(!n)return null;let r=Is(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=en(i.name)??en(r.definition.name);if(!a)return null;let o=i.embedBatch,s=i.embed_batch,c=i.embed,l=typeof o=="function"?o:typeof s=="function"?s:void 0,d=typeof c=="function"?c:void 0;return!l&&!d?null:{name:a,embedBatch:l,embed:d}}function yS(e){let t=z(),n=en(e.vector_store?.adapter);if(!n)return null;let r=Cs(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=en(i.name)??en(r.definition.name);if(!a)return null;let o=i.upsert,s=i.delete;return{adapterName:a,...typeof o=="function"?{upsert:o}:{},...typeof s=="function"?{delete:s}:{}}}function Ro(e,t){if(!Array.isArray(e)||e.some(n=>typeof n!="number"||!Number.isFinite(n)))throw new y(`Invalid vector returned by ${t}`,_.GENERIC_FAILURE);return e}async function wS(e,t,n){let r=t.search?.embedding_model?.trim()||"text-embedding-3-small";if(e.embedBatch){let a=await Promise.resolve(e.embedBatch({inputs:n,settings:t,model:r}));if(!Array.isArray(a))throw new y(`Extension search provider "${e.name}" embedBatch must return an array of vectors`,_.GENERIC_FAILURE);return a.map((o,s)=>Ro(o,`extension search provider "${e.name}" embedBatch output at index ${s}`))}if(!e.embed)throw new y(`Extension search provider "${e.name}" does not implement embed/embedBatch`,_.GENERIC_FAILURE);let i=[];for(let[a,o]of n.entries()){let s=await Promise.resolve(e.embed({input:o,settings:t,model:r}));i.push(Ro(s,`extension search provider "${e.name}" embed output at index ${a}`))}return i}function _p(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function yp(e,t,n){let r=n?ht(n.name,_p(e)):t?ht(t.name,t.model):null;if(!r)throw new y("No embedding identity available for semantic reindex mode",_.USAGE);return r}function vS(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,r)=>n.localeCompare(r))}async function wp(e,t,n,r,i,a,o,s){let c=r?.name??n?.name,l=Ps(c,e.search.embedding_corpus_max_characters).maxCharacters,d=Ti(e),u=i.map(f=>Ns(f,{providerName:c,maxCharacters:l,fields:d})),m=[],p=null;if(r)try{m=await wS(r,e,u),p=ht(r.name,_p(e))}catch(f){if(!n)throw new y(`Extension search provider "${r.name}" failed to generate embeddings: ${f instanceof Error?f.message:String(f)}`,_.GENERIC_FAILURE);a.push(`Extension search provider "${r.name}" failed; falling back to built-in provider (${f instanceof Error?f.message:String(f)})`)}if(m.length===0){if(!n)throw new y(`No embedding executor available for reindex mode '${t}'`,_.USAGE);let f=await Ms(n,e,u,{onProgress:g=>{g.phase==="complete"&&(o.batches_completed=g.batch_index),ae(s,`embedding_batch_${g.phase} batch=${g.batch_index}/${g.batch_total} size=${g.batch_size} completed_inputs=${g.completed_inputs}/${g.total_inputs}`)}});a.push(...f.warnings),m=f.vectors,p=ht(n.name,n.model)}if(ae(s,`embedding_complete vectors=${m.length}`),m.length!==i.length)throw new y(`Embedding output size mismatch (expected ${i.length}, received ${m.length})`,_.GENERIC_FAILURE);if(!p)throw new y(`No embedding identity available for reindex mode '${t}'`,_.USAGE);return{vectors:m,embeddingIdentity:p}}async function bS(e,t,n,r,i,a){let o=Object.keys(n);if(t){if(o.length>0&&t.delete)try{await Promise.resolve(t.delete({ids:o.sort((s,c)=>s.localeCompare(c)),settings:r}))}catch(s){throw new y(`Extension vector adapter "${t.adapterName}" failed to delete vectors during reindex reset: ${s instanceof Error?s.message:String(s)}`,_.GENERIC_FAILURE)}else o.length>0&&i.push(`search_semantic_reindex_reset_skipped:adapter=${t.adapterName}:known_ids=${o.length}`);if(!e)return}e&&await js(e,o,{},a)}async function vp(e,t,n,r,i){if(n.length!==0){if(t){if(t.delete)try{await Promise.resolve(t.delete({ids:n,settings:r}))}catch(a){throw new y(`Extension vector adapter "${t.adapterName}" failed to delete orphan vectors during reindex: ${a instanceof Error?a.message:String(a)}`,_.GENERIC_FAILURE)}else i.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${t.adapterName}:count=${n.length}`);if(!e)return}e&&await Fs(e,n)}}function kS(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function xS(e,t,n){return{version:1,mode:e,generated_at:t,total_items:n.length,items:n.map(r=>({id:r.metadata.id,type:r.metadata.type,status:r.metadata.status,priority:r.metadata.priority,updated_at:r.metadata.updated_at}))}}function SS(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=an(e.settings);if(!t.active&&!e.extensionEmbedding)throw new y(`Reindex mode '${e.requestedMode}' requires a configured embedding provider in settings.providers.openai/settings.providers.ollama or an extension provider selected by settings.search.provider`,_.USAGE);let n=dr(e.settings,e.pmRoot);if(!n.active&&!e.extensionVectorAdapter)throw new y(`Reindex mode '${e.requestedMode}' requires a configured vector store in settings.vector_store.qdrant/settings.vector_store.lancedb or an extension adapter selected by settings.vector_store.adapter`,_.USAGE);return{activeEmbeddingProvider:t.active,activeVectorStore:n.active}}async function ES(e){let t=q(e.settings,z()),n=await hS(e.pmRoot,e.settings.item_format,t.type_to_folder,e.settings.schema);return{documentCandidates:n.candidates,warnings:[...n.warnings],metadataDocuments:n.candidates.map(r=>({metadata:r.metadata,body:typeof r.body=="string"?r.body:""}))}}async function AS(e){let t=await Mt(e.pmRoot);if(e.reindexWarnings.push(...t.warnings),e.forceFullSemantic&&e.reindexWarnings.push("search_semantic_reindex_full_ignored:mode_keyword"),!t.embedding)return;let n=(()=>{try{return yp(e.settings,an(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&Nt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(mS))}async function RS(e){let t=await Mt(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=yp(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),r=new Set(e.metadataDocuments.map(l=>l.metadata.id)),i=vS(t.entries,r),a=Nt(t.embedding,n);e.forceFullSemantic&&!a&&e.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced");let o=e.forceFullSemantic||a?e.metadataDocuments:e.metadataDocuments.filter(l=>t.entries[l.metadata.id]!==l.metadata.updated_at),s=new Set(o.map(l=>l.metadata.id)),c=s.size>0?await Io(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,s):[];return{ledgerEntries:t.entries,ledgerEmbedding:t.embedding,orphanIds:i,resetRequired:a,staleDocuments:c,freshDocuments:e.metadataDocuments.length-c.length}}async function IS(e){let t=new Set(e.metadataDocuments.map(i=>i.metadata.id)),n=await Io(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,ae(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let r=await wp(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...r,staleDocuments:n,vectorDimension:Oi(r.vectors,"Reindex embeddings")}}async function CS(e){let t=await wp(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,r=t.embeddingIdentity,i=Oi(n,"Reindex embeddings");if(!(!e.resetRequired&&(Nt(e.ledgerEmbedding,r)||zs(e.ledgerEmbedding,i))))return{vectors:n,embeddingIdentity:r,staleDocuments:e.staleDocuments,vectorDimension:i,resetRequired:e.resetRequired};let o=await IS(e);return n=o.vectors,r=o.embeddingIdentity,i=o.vectorDimension,{vectors:n,embeddingIdentity:r,staleDocuments:o.staleDocuments,vectorDimension:i,resetRequired:!0}}async function $S(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(ae(e.progressEnabled,`vector_upsert_start adapter=${t} points=${e.points.length}`),typeof e.extensionVectorAdapter.upsert!="function")throw new y(`Extension vector adapter "${t}" does not support upserting vectors.`,_.USAGE);await Promise.resolve(e.extensionVectorAdapter.upsert({points:e.points,settings:e.settings})),e.semanticSummary.vector_upserted=e.points.length,ae(e.progressEnabled,`vector_upsert_complete adapter=${t}`);return}catch(t){if(t instanceof y)throw t;if(!e.activeVectorStore)throw new y(`Extension vector adapter "${e.extensionVectorAdapter.adapterName}" failed to upsert vectors: ${t instanceof Error?t.message:String(t)}`,_.GENERIC_FAILURE);e.semanticWarnings.push(`Extension vector adapter "${e.extensionVectorAdapter.adapterName}" failed; falling back to built-in vector store (${t instanceof Error?t.message:String(t)})`),ae(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){ae(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await Ls(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,ae(e.progressEnabled,`vector_upsert_complete adapter=${e.activeVectorStore.name}`);return}throw new y(`No vector upsert executor available for reindex mode '${e.requestedMode}'`,_.USAGE)}function TS(e,t){return e.map((n,r)=>({id:n.metadata.id,vector:Ro(t[r],`reindex embeddings output at index ${r}`),payload:{id:n.metadata.id,type:n.metadata.type,status:n.metadata.status,priority:n.metadata.priority,updated_at:n.metadata.updated_at}}))}async function OS(e){ae(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await CS({pmRoot:e.pmRoot,settings:e.settings,requestedMode:e.requestedMode,activeEmbeddingProvider:e.activeEmbeddingProvider,extensionEmbedding:e.extensionEmbedding,documentCandidates:e.documentCandidates,metadataDocuments:e.metadataDocuments,staleDocuments:e.plan.staleDocuments,ledgerEmbedding:e.plan.ledgerEmbedding,resetRequired:e.plan.resetRequired,semanticWarnings:e.semanticWarnings,reindexWarnings:e.reindexWarnings,semanticSummary:e.semanticSummary,progressEnabled:e.progressEnabled});t.resetRequired?(ae(e.progressEnabled,"vector_reset_start"),await bS(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),ae(e.progressEnabled,"vector_reset_complete")):await vp(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=TS(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await $S({requestedMode:e.requestedMode,activeVectorStore:e.activeVectorStore,extensionVectorAdapter:e.extensionVectorAdapter,settings:e.settings,points:n,semanticWarnings:e.semanticWarnings,semanticSummary:e.semanticSummary,progressEnabled:e.progressEnabled}),{staleDocuments:t.staleDocuments,embeddingMetadata:Us(t.embeddingIdentity,t.vectorDimension)}}async function DS(e){let t=await RS(e);e.semanticSummary.stale_items=t.staleDocuments.length,e.semanticSummary.unchanged_items=t.freshDocuments;let n=Object.fromEntries(e.metadataDocuments.map(a=>[a.metadata.id,a.metadata.updated_at]));if(ae(e.progressEnabled,`semantic_stale_items stale=${t.staleDocuments.length} total=${e.metadataDocuments.length} unchanged=${t.freshDocuments} full=${e.forceFullSemantic||t.resetRequired}`),t.staleDocuments.length===0)return ae(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await vp(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let r=await OS({...e,plan:t});t.freshDocuments>0&&e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`);let i=new Map(r.staleDocuments.map(a=>[a.metadata.id,a]));return{documentsForKeywordArtifacts:e.metadataDocuments.map(a=>i.get(a.metadata.id)??a),vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:r.embeddingMetadata}}async function PS(e){let t=Ln.join(e.pmRoot,Eo),n=Ln.join(e.pmRoot,Ao),r=Ti(e.settings),i=e.documentsForKeywordArtifacts.map(o=>JSON.stringify(gS(o,e.mode,r))).join(`
47
+ `);ae(e.progressEnabled,"writing keyword artifacts"),await le(t,`${JSON.stringify(e.manifest,null,2)}
48
+ `),await le(n,`${i}
49
+ `);let a=[];if(e.mode!=="keyword")try{ae(e.progressEnabled,"writing vectorization status ledger"),await qs(e.pmRoot,e.vectorizationLedgerEntries,e.vectorizationEmbeddingMetadata)}catch(o){a.push(`search_vectorization_status_ledger_write_failed:${o instanceof Error?o.message:String(o)}`)}return a}async function tP(e,t){let n=fS(e.mode),r=pS(e),i=e.full===!0;ae(r,`start mode=${n}`);let a=L(process.cwd(),t.path);if(!await A(K(a)))throw new y(`Tracker is not initialized at ${a}. Run pm init first.`,_.NOT_FOUND);let o=lr(await I(a)).settings,s=null;try{s=await de(a,Os,o.locks.ttl_seconds,Y(void 0,"pm-reindex"),!1,o.governance.force_required_for_stale_lock,o.locks.wait_ms)}catch(c){throw c instanceof y&&c.exitCode===_.CONFLICT?new y("Another pm reindex run is already active for this project. Wait for it to finish before starting a new keyword, semantic, or hybrid reindex.",_.CONFLICT,{code:"reindex_already_running",type:"urn:pm-cli:error:reindex_already_running",why:"Semantic reindex can be expensive and duplicate runs compete for the same local embedding model and vector store.",nextSteps:["Check active pm reindex processes before starting another reindex.","Rerun with --progress when you need non-interactive visibility."]}):c}try{let c=_S(o),l=yS(o),d=SS({requestedMode:n,pmRoot:a,settings:o,extensionEmbedding:c,extensionVectorAdapter:l}),u=n;ae(r,"loading item corpus");let m=await ES({pmRoot:a,settings:o}),p=m.warnings,{documentCandidates:f,metadataDocuments:g}=m;ae(r,`loaded_items=${g.length}`);let h=$(),w=xS(u,h,g),v=Ln.join(a,Eo),b=Ln.join(a,Ao),x=u==="keyword"?await Io(a,f,o.schema,p):g,R=[],k={},F=null,T=kS(u);if(u==="keyword"&&await AS({pmRoot:a,settings:o,forceFullSemantic:i,extensionEmbedding:c,reindexWarnings:p}),u!=="keyword"){let B=await DS({pmRoot:a,settings:o,requestedMode:n,activeEmbeddingProvider:d.activeEmbeddingProvider,activeVectorStore:d.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:l,documentCandidates:f,metadataDocuments:g,documentsForKeywordArtifacts:x,forceFullSemantic:i,reindexWarnings:p,semanticWarnings:R,semanticSummary:T,progressEnabled:r});x=B.documentsForKeywordArtifacts,k=B.vectorizationLedgerEntries,F=B.vectorizationEmbeddingMetadata}let E=await PS({pmRoot:a,mode:u,manifest:w,documentsForKeywordArtifacts:x,settings:o,vectorizationLedgerEntries:k,vectorizationEmbeddingMetadata:F,progressEnabled:r}),U=[...await re({path:v,scope:"project",op:"reindex:manifest"}),...await re({path:b,scope:"project",op:"reindex:embeddings"}),...await Zn({mode:u,total_items:g.length})];return ae(r,"done"),{ok:!0,mode:u,total_items:g.length,semantic:T,artifacts:{manifest:Eo,embeddings:Ao},warnings:[...p,...R,...E,...U],generated_at:h}}finally{await s?.()}}export{xA as a,vl as b,N as c,ve as d,Fe as e,Lt as f,Xs as g,Qs as h,gt as i,Pi as j,Cp as k,Mi as l,Li as m,rc as n,jt as o,sn as p,ji as q,zp as r,lc as s,cn as t,Ui as u,_r as v,zi as w,uc as x,mc as y,pc as z,wr as A,vr as B,hc as C,gc as D,_c as E,yc as F,xr as G,kc as H,C as I,ee as J,Vp as K,Hi as L,EE as M,AE as N,Rc as O,RE as P,IE as Q,CE as R,$E as S,TE as T,Ji as U,OE as V,DE as W,Bi as X,PE as Y,NE as Z,Ic as _,ME as $,nf as aa,Tc as ba,HE as ca,mn as da,JE as ea,df as fa,uf as ga,VE as ha,mf as ia,Kc as ja,Mf as ka,Lf as la,_t as ma,GA as na,Wf as oa,Th as pa,BR as qa,HR as ra,JR as sa,hn as ta,VR as ua,KR as va,YR as wa,XR as xa,ZR as ya,QR as za,eI as Aa,tI as Ba,nI as Ca,rI as Da,iI as Ea,La as Fa,ZE as Ga,QE as Ha,Lc as Ia,_w as Ja,X$ as Ka,An as La,Hr as Ma,Z$ as Na,Q$ as Oa,Iu as Pa,jT as Qa,$u as Ra,tm as Sa,XT as Ta,Pu as Ua,rm as Va,W0 as Wa,B0 as Xa,Ob as Ya,Db as Za,K0 as _a,Y0 as $a,X0 as ab,Z0 as bb,Nb as cb,Mb as db,Lb as eb,Q0 as fb,om as gb,jb as hb,sm as ib,oo as jb,lm as kb,Ub as lb,zb as mb,qb as nb,lk as ob,GO as pb,Xm as qb,Dn as rb,oi as sb,yo as tb,ip as ub,ap as vb,oD as wb,yx as xb,op as yb,sp as zb,cp as Ab,Ox as Bb,bD as Cb,ID as Db,YD as Eb,tP as Fb};
50
+ //# sourceMappingURL=chunk-SALH6B6K.js.map