@unbrained/pm-cli 2026.8.23 → 2026.8.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +27 -1
- package/dist/cli/description-stdin.js +5 -4
- package/dist/cli/extension-command-help.d.ts +5 -0
- package/dist/cli/extension-command-help.js +6 -2
- package/dist/cli/help-content.d.ts +5 -0
- package/dist/cli/help-content.js +56 -3
- package/dist/cli/help-json-payload.d.ts +5 -2
- package/dist/cli/help-json-payload.js +57 -17
- package/dist/cli/main.d.ts +3 -0
- package/dist/cli/main.js +28 -3
- package/dist/cli/register-annotations.js +5 -5
- package/dist/cli/register-mutation.js +73 -27
- package/dist/cli-bundle/bundle-manifest.json +152 -152
- package/dist/cli-bundle/chunks/{chunk-HWZ6CELB.js → chunk-244MI4GS.js} +3 -3
- package/dist/cli-bundle/chunks/{chunk-QDVHNHAQ.js → chunk-2F3LUFMW.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-EG6CLDZT.js → chunk-5I5RWIJC.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-KPH73XXJ.js → chunk-65MHLHAA.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-6C7GIMIL.js +13 -0
- package/dist/cli-bundle/chunks/chunk-OWHNAR2B.js +2 -0
- package/dist/cli-bundle/chunks/chunk-QKGMHGEI.js +202 -0
- package/dist/cli-bundle/chunks/chunk-QLUORNIB.js +2092 -0
- package/dist/cli-bundle/chunks/{chunk-JB4KZWBF.js → chunk-T2ENPRXF.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-F3AI2JFL.js → chunk-TPQIBSL2.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-YQMYF3YD.js +35 -0
- package/dist/cli-bundle/chunks/{register-list-query-UJB5FMV2.js → register-list-query-XVN2ZLI7.js} +2 -2
- package/dist/cli-bundle/chunks/register-mutation-QCKAEGIJ.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-RXIJIYXC.js → register-operations-SDEAXE7E.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-GFUZEKRE.js → register-setup-LXVBRCJ3.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-QGFNI65N.js → chunk-2UIWOP3O.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-42S3GGZ7.js +50 -0
- package/dist/cli-bundle/focused-chunks/{chunk-OGLQBL46.js → chunk-7I23XGWO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-7YCDTCBC.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-OFVUGTLJ.js → chunk-A644DUFQ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-AUFH5H35.js → chunk-GQR3WH3F.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-3UPTYG44.js → chunk-H5JZEIQV.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-IBZZZGK3.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-LMKG3DFE.js +5 -0
- package/dist/cli-bundle/focused-chunks/{chunk-LYVSW5VM.js → chunk-N7W67YIG.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-37Z4OEAP.js → chunk-NOOZGIXP.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-FZS4H32O.js → chunk-OHIHZ7HS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-ONYQCALA.js +19 -0
- package/dist/cli-bundle/focused-chunks/chunk-OVJL6NZE.js +4 -0
- package/dist/cli-bundle/focused-chunks/chunk-RAFKLNZX.js +16 -0
- package/dist/cli-bundle/focused-chunks/{chunk-IFLWKY2R.js → chunk-VXWATRFL.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-R27IDGHD.js → chunk-XUQPEKRN.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-JOWDB2MH.js → chunk-YO3ZF3FI.js} +2 -2
- package/dist/cli-bundle/main.js +18 -17
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +32 -32
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +32 -33
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +6 -5
- package/dist/core/diagnostics/remediation.js +17 -2
- package/dist/core/extensions/command-metadata-contract.d.ts +10 -0
- package/dist/core/extensions/command-metadata-contract.js +23 -0
- package/dist/core/extensions/command-visibility-tier.js +12 -2
- package/dist/core/extensions/extension-types.d.ts +6 -0
- package/dist/core/extensions/extension-types.js +2 -2
- package/dist/core/extensions/loader.js +4 -3
- package/dist/core/io/body-file.js +7 -2
- package/dist/core/io/bulk-ids-input.d.ts +24 -0
- package/dist/core/io/bulk-ids-input.js +113 -0
- package/dist/core/item/parse.d.ts +22 -2
- package/dist/core/item/parse.js +97 -4
- package/dist/mcp/server.d.ts +3 -2
- package/dist/mcp/server.js +16 -9
- package/dist/sdk/agent/refusal-closure-census.d.ts +66 -0
- package/dist/sdk/agent/refusal-closure-census.js +144 -0
- package/dist/sdk/agent-capability-contracts.d.ts +34 -1
- package/dist/sdk/agent-capability-contracts.js +104 -6
- package/dist/sdk/annotations.d.ts +2 -0
- package/dist/sdk/annotations.js +25 -7
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +10 -0
- package/dist/sdk/cli-contracts/runtime-contracts.js +20 -3
- package/dist/sdk/cli-contracts/tool-parameter-tables.js +38 -2
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +4 -1
- package/dist/sdk/cli-contracts/typed-action-inputs.js +2 -2
- package/dist/sdk/comments.js +15 -7
- package/dist/sdk/flag-invocation-contracts.d.ts +2 -0
- package/dist/sdk/flag-invocation-contracts.js +28 -3
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +109 -52
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +62 -2
- package/dist/sdk/governance/health.js +98 -11
- package/dist/sdk/governance/validate.js +15 -9
- package/dist/sdk/guide-topics.d.ts +0 -5
- package/dist/sdk/guide-topics.js +28 -2
- package/dist/sdk/history-compact.d.ts +2 -1
- package/dist/sdk/history-compact.js +24 -5
- package/dist/sdk/history-mcp.js +11 -10
- package/dist/sdk/history-repair.d.ts +24 -0
- package/dist/sdk/history-repair.js +145 -4
- package/dist/sdk/index.d.ts +1 -0
- package/dist/sdk/index.js +3 -2
- package/dist/sdk/item-transaction.js +19 -12
- package/dist/sdk/lifecycle/append.js +4 -4
- package/dist/sdk/lifecycle/close-many.js +16 -7
- package/dist/sdk/lifecycle/create.js +29 -21
- package/dist/sdk/lifecycle/plan.js +24 -6
- package/dist/sdk/lifecycle/update-many.js +15 -8
- package/dist/sdk/lifecycle/update.d.ts +2 -0
- package/dist/sdk/lifecycle/update.js +34 -24
- package/dist/sdk/merge/driver.js +25 -4
- package/dist/sdk/merge/receipt-file-boundary.d.ts +21 -0
- package/dist/sdk/merge/receipt-file-boundary.js +47 -0
- package/dist/sdk/merge/receipts.d.ts +24 -1
- package/dist/sdk/merge/receipts.js +342 -36
- package/dist/sdk/merge/reconcile.js +117 -47
- package/dist/sdk/read-output/continuation.d.ts +15 -2
- package/dist/sdk/read-output/continuation.js +86 -6
- package/dist/sdk/read-output-contracts.d.ts +4 -1
- package/dist/sdk/read-output-contracts.js +9 -6
- package/dist/sdk/runtime-extended-actions.js +5 -3
- package/dist/sdk/runtime-input.d.ts +4 -0
- package/dist/sdk/runtime-input.js +98 -23
- package/dist/sdk/runtime-primitives.d.ts +2 -1
- package/dist/sdk/runtime-primitives.js +4 -3
- package/dist/sdk/runtime.js +7 -20
- package/dist/sdk/scheduling-shortcuts.js +5 -3
- package/dist/sdk/structured-mutations.js +10 -3
- package/dist/sdk/workspace-contracts.d.ts +3 -0
- package/dist/sdk/workspace-contracts.js +3 -2
- package/docs/MERGE_SAFETY.md +34 -5
- package/docs/OUTPUT_PROJECTION_CONTRACTS.md +13 -1
- package/docs/README.md +2 -0
- package/docs/READ_OUTPUT_CONTRACTS.md +25 -2
- package/docs/RELEASING.md +40 -21
- package/docs/SCRIPTING.md +62 -3
- package/docs/SDK.md +8 -0
- package/docs/generated/AGENT_CAPABILITY_ROUTING.md +17 -0
- package/docs/generated/AGENT_COMMAND_SURFACE.md +1 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +359 -0
- package/marketplace.json +2 -2
- package/package.json +1 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/README.md +9 -11
- package/packages/pm-command-kit/extensions/command-kit/index.ts +3 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/extensions/guide-shell/index.ts +10 -0
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/scripts/generate-agent-capability-surfaces.mjs +27 -1
- package/sdk/public-surface.json +351 -26
- package/dist/cli-bundle/chunks/chunk-3ENVHX6C.js +0 -36
- package/dist/cli-bundle/chunks/chunk-DW2CGEMU.js +0 -2
- package/dist/cli-bundle/chunks/chunk-HZBMLSZI.js +0 -201
- package/dist/cli-bundle/chunks/chunk-KXPMB2YL.js +0 -2092
- package/dist/cli-bundle/chunks/chunk-TFI5V5N2.js +0 -13
- package/dist/cli-bundle/chunks/register-mutation-NX5XE4VX.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-5S7E72FY.js +0 -16
- package/dist/cli-bundle/focused-chunks/chunk-E7X25GC3.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-FQCSTBWE.js +0 -4
- package/dist/cli-bundle/focused-chunks/chunk-MRCNF3U6.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-OY7QAV4Y.js +0 -51
- package/dist/cli-bundle/focused-chunks/chunk-UYRFYCDQ.js +0 -5
- package/dist/cli-bundle/focused-chunks/chunk-ZHVA42R5.js +0 -18
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
import{a as Ci,c as Xn,d as Zn,e as hs,g as gs,h as $i,i as _s,j as Rt,k as It,l as ys,m as ws,n as Oi,o as bs,p as Ct,q as Tt,r as ks,s as xs,t as Di}from"./chunk-R27IDGHD.js";import{e as ir,f as Pi}from"./chunk-JOWDB2MH.js";import{C as nr,a as ls,g as Ii,i as ds}from"./chunk-E7X25GC3.js";import{P as gc}from"./chunk-LYVSW5VM.js";import{$ as oc,Aa as mc,Ba as pc,Da as Ui,I as _r,J as Zs,K as Mi,L as dn,N as Fi,R as Qs,S as ec,T as tc,U as nc,V as yr,X as rc,Y as ic,Z as ac,_ as gt,aa as Lt,ba as sc,ca as ji,da as Mt,e as Js,ea as cc,f as Vs,fa as lc,g as Ks,t as cn,u as Ys,ua as dc,v as ln,va as wr,w as Xs,za as uc}from"./chunk-ZHVA42R5.js";import{a as us,b as Qn,c as Ti,d as ms,e as ps,f as He,g as er,h as fs,i as it}from"./chunk-37Z4OEAP.js";import{$a as dr,Ab as Nt,Bb as Ve,Cb as hr,Ea as Ni,Ga as Fs,Gb as ht,Ib as gr,Mb as un,Ob as vr,Sa as js,Vb as fc,Xa as ue,Y as K,Ya as lr,Yb as hc,Z as $,Za as Us,_ as Ps,_a as Li,ab as ur,b as $s,bb as mr,cb as zs,d as Os,da as de,db as Oe,eb as qs,fb as I,gb as pr,ib as Ws,ja as Ns,ka as or,l as z,na as sr,nb as Gs,o as ae,oa as Ls,ob as Bs,q as Je,qa as Ms,r as Ds,ra as $t,s as ar,ta as Ot,tb as fr,vb as Hs,wa as cr,xb as oe,yb as Dt,zb as Pt}from"./chunk-IFLWKY2R.js";import{Ba as Ri,Ca as ss,Da as cs,E as Xo,Ea as At,F as Zo,G as q,Ga as Ne,Ia as Le,Ka as ce,L as on,La as Ae,M as F,N as pt,Na as we,O as Kn,Oa as Me,P as ft,R as Qo,S as Yn,Sa as $e,U as es,Ua as tr,W as X,Wa as vs,Ya as rr,Z as ts,Za as As,_a as Rs,a as Wo,ba as ns,d as Go,e as Bo,ea as rs,ga as Ai,h as Et,p as an,q as O,r as Vn,s as j,sa as is,t as Y,ta as as,u as ie,x as ye,y as Ee,z as Yo}from"./chunk-FQCSTBWE.js";import{a as Is,b as Cs,d as Ts}from"./chunk-FZS4H32O.js";import{O as Ho,Q as Jo,S as Vo,U as Ko,V as Jn,Y as _,Z as y,a as Bn,aa as re,ba as os,ca as sn,d as Hn,fa as Ss,oa as Es,t as Ei}from"./chunk-UYRFYCDQ.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 D=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 Ft(e){try{return await e()}catch(t){throw t instanceof D?new y(t.message,_.USAGE,{code:"invalid_argument_value",reason:"assurance_mutation_refused"}):t}}async function _c(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 Bp}from"node:crypto";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]="b911b43d-d14d-5e4f-a35e-5020b1a84542")}catch{}})();var jt=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]="d4c380ce-031e-5b2d-aaa8-658bb4aa3087")}catch{}})();var wc=1,_t=["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"],zi=["items","dependency_kind","prose_edge_gap","graph","validate","health","history","links","provider","derived"],Jp=["ceiling","floor","equals","zero","monotone_nondecreasing","monotone_nonincreasing","subset_of"],Vp=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/,br=30,kr=5e3,vc=4,Kp=50;function Ke(e,t){if(!Vp.test(e))throw new D(`${t} must be a stable lowercase id`)}function Yp(e,t){if(!Number.isFinite(e)||e<0)throw new D(`${t} must be a finite non-negative number`)}function mn(e){let t=Jp.filter(i=>e[i]!==void 0);if(t.length!==1)throw new D(`assertion ${e.id} must declare exactly one polarity`);let n=t[0],r=e[n];return{polarity:n,value:n==="zero"?0:r}}function Wi(e,t){return re(e)===re(t)}function bc(e,t){if(t.polarity==="equals")return Wi(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 kc(e){let t=mn(e),n=e.negative_control.cases;return n.some(r=>r.expected==="pass")&&n.some(r=>r.expected==="fail")&&n.every(r=>bc(r.observed,t)===(r.expected==="pass"))}function Xp(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!Wi(e.value,t.value)}function Zp(e,t){if(e.measurement_id!==t.measurement_id||e.owner_item_id!==t.owner_item_id||re(e.scope)!==re(t.scope))return!0;let n={observe:0,warn:1,block:2},r=(e.lifetime??"hold")==="hold"&&(t.lifetime??"hold")==="retire";return Xp(mn(e),mn(t))||n[t.enforcement]<n[e.enforcement]||r}function Qp(e){if(e.state!==void 0&&!(e.state==="present"||e.state==="missing"))throw new D("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 D("items source with field requires exactly one of equals or state");if(e.field===void 0&&r!==0)throw new D("items source equals/state requires field")}function ef(e){if(typeof e.dependency_kind!="string"||e.dependency_kind.trim().length===0)throw new D("dependency_kind source requires dependency_kind");if([e.source_kind,e.source_kind_prefix,e.source_kind_state].filter(n=>n!==void 0).length>1)throw new D("dependency_kind source accepts at most one source_kind predicate");if(e.source_kind!==void 0&&e.source_kind.trim().length===0||e.source_kind_prefix!==void 0&&e.source_kind_prefix.trim().length===0)throw new D("dependency_kind source provenance values must not be empty");if(e.source_kind_state!==void 0&&e.source_kind_state!=="present"&&e.source_kind_state!=="missing")throw new D("dependency_kind source source_kind_state must be present or missing")}function tf(e){if(e.sample_limit!==void 0&&(!Number.isInteger(e.sample_limit)||e.sample_limit<1))throw new D("prose_edge_gap sample_limit must be a positive integer");for(let t of e.exemptions??[]){if(typeof t.holder_id!="string"||t.holder_id.trim().length===0||typeof t.reason!="string"||t.reason.trim().length===0)throw new D("prose_edge_gap exemptions require holder_id and reason");if(t.target_id!==void 0&&t.target_id.trim().length===0||t.text_contains!==void 0&&t.text_contains.trim().length===0)throw new D("prose_edge_gap exemption selectors must not be empty")}}function Gi(e){Ke(e.id,"measurement.id"),e.max_cost!==void 0&&Yp(e.max_cost,"measurement.max_cost");let t=e.source;if(Object.prototype.toString.call(t)!=="[object Object]")throw new D(`measurement.source.kind must be one of ${zi.join(", ")}`);let n=Reflect.get(t,"kind");if(!zi.includes(n))throw new D(`measurement.source.kind must be one of ${zi.join(", ")}`);let r=t;if(r.kind==="items"&&Qp(r),r.kind==="dependency_kind"&&ef(r),r.kind==="prose_edge_gap"&&tf(r),(r.kind==="graph"||r.kind==="validate"||r.kind==="health")&&(typeof r.field!="string"||r.field.trim().length===0))throw new D(`${r.kind} source requires field`);return r.kind==="provider"&&(Ke(r.provider,"provider source provider"),Ke(r.key,"provider source key")),e}function Bi(e){if(Ke(e.id,"assertion.id"),Ke(e.measurement_id,"assertion.measurement_id"),typeof e.owner_item_id!="string"||e.owner_item_id.trim().length===0)throw new D("assertion.owner_item_id is required");let t=mn(e);if(typeof t.value=="number"&&!Number.isFinite(t.value))throw new D(`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 D("retired assertion requires retire_reason");e.scope.kind==="filter"&&Ke(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 D("assertion negative control requires pass and fail cases");if(!kc(e))throw new D(`assertion ${e.id} negative control does not prove its bound`);return e}function nf(e){if(!Array.isArray(e.allowed_providers))throw new D("gate provider_policy.allowed_providers must be an array");for(let t of e.allowed_providers)Ke(t,"gate.provider_policy.allowed_provider");if(typeof e.triggers!="object"||e.triggers===null||Array.isArray(e.triggers))throw new D("gate provider_policy.triggers must be an object");for(let[t,n]of Object.entries(e.triggers)){if(!_t.includes(t))throw new D(`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 D(`gate provider policy trigger ${t} is invalid`)}}function xc(e){if(Ke(e.id,"gate.id"),!Array.isArray(e.assertion_ids))throw new D("gate.assertion_ids is required and must be an array");if(e.assertion_ids.length===0)throw new D("gate requires at least one assertion");for(let t of e.assertion_ids)Ke(t,"gate.assertion_id");if(!Array.isArray(e.triggers))throw new D(`gate.triggers is required and must be an array of ${_t.join(", ")}`);if(e.triggers.length===0)throw new D("gate requires at least one trigger");for(let t of e.triggers)if(!_t.includes(t))throw new D(`gate trigger must be one of ${_t.join(", ")}`);return e.provider_policy&&nf(e.provider_policy),e}function Ut(e){if(e.version!==wc)throw new D(`unsupported assurance document version ${String(e.version)}`);let t=new Set;for(let r of e.measurements){if(Gi(r),t.has(`measurement:${r.id}`))throw new D(`duplicate measurement ${r.id}`);t.add(`measurement:${r.id}`)}for(let r of e.assertions){if(Bi(r),t.has(`assertion:${r.id}`))throw new D(`duplicate assertion ${r.id}`);t.add(`assertion:${r.id}`)}for(let r of e.gates){xc(r);let i=r.assertion_ids.filter(a=>!e.assertions.some(o=>o.id===a));if(i.length>0)throw new D(`gate ${r.id} references missing assertions: ${i.join(", ")}`);if(t.has(`gate:${r.id}`))throw new D(`duplicate gate ${r.id}`);t.add(`gate:${r.id}`)}let n=new Set(e.measurements.map(r=>r.id));for(let[r,i]of Sc(e))if(!n.has(r))throw new D(`${i.join(", ")} references missing measurement ${r}`);return e}function Hi(e,t){if("measurement"in e){t.push(e.measurement);return}if("operator"in e)for(let n of e.operands)Hi(n,t)}function Sc(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=[];Hi(r.source.expression,i);for(let a of i)n(a,`derived measurement ${r.id}`)}return t}function rf(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"&&Hi(o.source.expression,n)}return i}function pn(){return{version:wc,measurements:[],assertions:[],gates:[]}}function af(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 Wi(i,e.equals)})()));return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n.map(r=>r.id)}}function of(e,t){return e.source_kind!==void 0?t?.toLowerCase()===e.source_kind.trim().toLowerCase():e.source_kind_prefix!==void 0?t?.toLowerCase().startsWith(e.source_kind_prefix.trim().toLowerCase())===!0:e.source_kind_state==="present"?t!==void 0&&t.length>0:e.source_kind_state==="missing"?t===void 0||t.length===0:!0}function sf(e,t){let n=[],r=Ai(e.dependency_kind)??e.dependency_kind.trim().toLowerCase();for(let i of t.items)for(let a of i.dependencies??[]){let o=Ai(a.kind)??a.kind.trim().toLowerCase(),s=a.source_kind?.trim();o===r&&of(e,s)&&n.push(`${i.id}->${a.id}${s?`@${s}`:""}`)}return{value:n.length,population_size:t.items.length,cost:t.items.length,contributors:n}}function cf(e){let t=[e.description,e.body].filter(n=>typeof n=="string").map(n=>n.trim()).filter(Boolean);for(let n of["comments","notes","learnings"]){let r=e[n];if(Array.isArray(r)){for(let i of r)if(typeof i=="string")t.push(i);else if(typeof i=="object"&&i!==null){let a=Reflect.get(i,"text");typeof a=="string"&&t.push(a)}}}return t}function lf(e,t,n,r){return e.some(i=>i.holder_id.trim().toLowerCase()===t.toLowerCase()&&(i.target_id===void 0||i.target_id.trim().toLowerCase()===n.toLowerCase())&&(i.text_contains===void 0||r.toLowerCase().includes(i.text_contains.trim().toLowerCase())))}function qi(e,t){return[e.toLowerCase(),t.toLowerCase()].sort().join("\0")}function df(e){let t=new Map,n=new Set,r=[],i=/\b[a-z][a-z0-9]*-[a-z0-9]+\b/giu,a=0;for(let o of e){t.set(o.id.toLowerCase(),o.id);for(let s of o.dependencies??[])n.add(qi(o.id,s.id));for(let s of[o.parent,o.blocked_by])typeof s=="string"&&n.add(qi(o.id,s));for(let s of cf(o)){let c=[...s.matchAll(i)].map(l=>l[0]);a+=c.length,r.push({holder_id:o.id,segment:s,mentioned_ids:c})}}return{canonical_ids:t,linked_pairs:n,prose_mentions:r,mention_count:a}}function uf(e,t){let n=df(t.items),r=new Map;for(let o of n.prose_mentions){let s=o.mentioned_ids.map(l=>n.canonical_ids.get(l.toLowerCase())).filter(l=>l!==void 0&&l!==o.holder_id),c=[...new Set(s)];for(let l of c){let d=qi(o.holder_id,l);if(n.linked_pairs.has(d)||lf(e.exemptions??[],o.holder_id,l,o.segment))continue;let u=c.some(m=>m!==l);r.get(d)?.explicit===!0&&!u||r.set(d,{contributor:`${o.holder_id}->${l}|subject=${u?"explicit":"implicit"}`,explicit:u})}}let i=[...r.values()],a=i.map(o=>o.contributor).sort();return{value:a.length,population_size:n.canonical_ids.size,cost:t.items.length+n.linked_pairs.size+n.mention_count,contributors:a.slice(0,e.sample_limit??25),partitions:{explicit_subject:i.filter(o=>o.explicit).length,implicit_subject:i.filter(o=>!o.explicit).length}}}function mf(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 pf(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 ff(e,t){let n=e.source;return n.kind==="items"?af(n,t):n.kind==="dependency_kind"?sf(n,t):n.kind==="prose_edge_gap"?uf(n,t):n.kind==="history"?mf(n,t):n.kind==="links"?pf(n,t):null}function Ec(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 hf(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 Ac(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 Rc(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 Ic(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 Ac(e.operands,vc,o=>Rc(o,t,n,r,i));return{value:hf(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 gf(e,t,n,r,i){Gi(e);let a=Date.now(),o,s=[],c=0;if(e.source.kind==="derived"){let u=await Rc(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=ff(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==="prose_edge_gap"||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=Ec([...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:${Bp("sha256").update(re(e)).digest("hex")}`,value:o.value,population_size:o.population_size,cost:d,contributors:o.contributors??[],...o.partitions?{partitions:o.partitions}:{}}}function Ic(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=gf(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 Ic(e,t,n,[],{cache:new Map,charged:new Set})}function _f(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 yf(e,t,n={}){Bi(e);let r=mn(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:_f(t.value,r),verdict:i?"retired":bc(t.value,r)?"pass":"fail",enforcement:e.enforcement,negative_control_proven:kc(e),cost:t.cost,contributors:t.contributors,...t.partitions?{partitions:t.partitions}:{}}}function wf(e,t,n,r){let i=rf(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 yc(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 Cc(e,t,n,r){Ut(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}`);wf(i,t,n,r.trigger);let a=await Ac(i.assertion_ids,vc,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(h=>!f.has(h.status))}}else if(l.scope.kind==="filter"){let f=l.scope.measurement_id,h=t.measurements.find(v=>v.id===f),g=await yc(i.id,l.id,h,n,t.measurements),w=new Set(g.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 yf(l,await yc(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:Ec(a.map(c=>c.cost),Math.max(0,...a.map(c=>c.cost.duration_ms)))}}function xr(e){return Hp.join(e,"assurance.json")}async function Tc(e){let t=await Y(xr(e));return t===null?pn():Sr(t)}function Sr(e){try{return Ut(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 Er(e,t){return t==="measurement"?e.measurements:t==="assertion"?e.assertions:e.gates}function vf(e,t){e==="measurement"?Gi(t):e==="assertion"?Bi(t):xc(t)}async function fn(e,t){let n=structuredClone(Er(await Tc(e),t));return{items:n,count:n.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function Vi(e,t,n){let r=Er(await Tc(e),t).find(i=>i.id===n);if(!r)throw new TypeError(`assurance ${t} ${n} not found`);return structuredClone(r)}async function Ar(e,t,n,r={}){vf(t,n);let i=await I(e),a=K(r.author,i.author_default),o=await ur({pmRoot:e,filePath:xr(e),op:`assurance:${t}:put`,author:a,message:r.message,lockTtlSeconds:br,lockWaitMs:kr,mutate:s=>{let c=s===null?pn():Sr(s),l=Er(c,t),d=l.findIndex(m=>m.id===n.id),u=d<0?"created":"updated";if(t==="assertion"&&d>=0&&Zp(l[d],n)){let m=n.authorization_decision;if(!m||!r.authorized_decision_ids?.includes(m))throw new D(`loosening assertion ${n.id} requires a verified authorization_decision`)}return d<0?l.push(structuredClone(n)):l[d]=structuredClone(n),Ut(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 Ki(e,t,n={}){let r=pn();r.measurements=structuredClone(t.measurements),r.assertions=structuredClone(t.assertions),r.gates=structuredClone(t.gates),Ut(r);let i=await I(e),a=K(n.author,i.author_default),o=await ur({pmRoot:e,filePath:xr(e),op:"assurance:bundle:apply",author:a,message:n.message,lockTtlSeconds:br,lockWaitMs:kr,mutate:s=>{let c=s===null?pn():Sr(s),l=[],d=[],u=(m,p,f)=>{for(let h of p){let g=m.find(w=>w.id===h.id);if(!g){m.push(structuredClone(h)),l.push(`${f}:${h.id}`);continue}if(re(g)!==re(h))throw new D(`assurance bundle refuses to replace divergent ${f} ${h.id}`);d.push(`${f}:${h.id}`)}};return u(c.measurements,r.measurements,"measurement"),u(c.assertions,r.assertions,"assertion"),u(c.gates,r.gates,"gate"),Ut(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 $c(e,t,n,r={}){let i=await I(e),a=K(r.author,i.author_default),o=await ur({pmRoot:e,filePath:xr(e),op:`assurance:${t}:remove`,author:a,message:r.message,lockTtlSeconds:br,lockWaitMs:kr,mutate:s=>{let c=s===null?pn():Sr(s);if(t==="measurement"){let u=Sc(c).get(n);if(u&&u.length>0)throw new D(`assurance measurement ${n} is referenced by ${u.join(", ")}`)}if(t==="assertion"&&c.gates.some(u=>u.assertion_ids.includes(n)))throw new D(`assurance assertion ${n} is referenced by gate`);let l=Er(c,t),d=l.findIndex(u=>u.id===n);if(d<0)throw new D(`assurance ${t} ${n} not found`);return l.splice(d,1),Ut(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 Oc(e,t,n={}){if(t.dry_run)throw new TypeError("dry-run assurance verdicts are not persisted");let r=await I(e);await dr({pmRoot:e,op:"assurance:gate:verdict",author:K(n.author,r.author_default),context:{assurance_verdict:t},message:n.message??`Assurance gate ${t.gate_id} returned ${t.verdict}`,lockTtlSeconds:br,lockWaitMs:kr})}async function Dc(e,t={}){let n=t.limit??Kp;if(!Number.isInteger(n)||n<1||n>jt)throw new TypeError(`assurance verdict limit must be an integer from 1 through ${jt}`);return(await cr(lr(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 hn=["software-delivery","research","agent-evaluation","operations"];function Pc(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 Rr(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=>Pc(`${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 Ir(e,t){return e==="software-delivery"?Rr(e,"Software delivery","Warn when active delivery work lacks executable tests or documentation.",t,["tests","docs"]):e==="research"?Rr(e,"Research","Warn when active research work lacks reproducibility files or documentation.",t,["files","docs"]):e==="agent-evaluation"?Rr(e,"Agent evaluation","Warn when active evaluation work lacks executable scenarios or recorded artifacts.",t,["tests","files"]):Rr(e,"Operations","Warn when active operational work lacks runbook documentation or repair evidence.",t,["docs","files"])}function Nc(e,t,n,r={}){return Ki(e,Ir(t,n).declarations,r)}async function Lc(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=Pc(`${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 Mc(e,t,n={}){return Ki(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 Fc(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 Ar(e,"assertion",{...t,enforcement:n},{...r,message:r.message??`Promote assurance assertion ${t.id} from ${t.enforcement} to ${n}`})}import zc from"node:fs/promises";import{createRequire as bf}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 jc(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 kf(e){return e.includes(`${be.sep}.pnpm${be.sep}`)?"pnpm":e.includes(`${be.sep}node_modules${be.sep}`)?"npm":"other"}async function Uc(e){try{let t=JSON.parse(await zc.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 Yi(e){try{return await zc.realpath(e)}catch{return be.resolve(e)}}async function qc(e,t,n=Ee(import.meta.url,["../../.."])){let r=await Yi(t),i=await Yi(be.join(n,"package.json")),a=await Uc(i),o=new Map;a!==void 0&&o.set(i,{version:a,path:jc(i,r),layout:"host",consumers:["pm-cli-host"]});for(let l of e)try{let d=bf(l.entry_path).resolve("@unbrained/pm-cli/package.json"),u=await Yi(d),m=await Uc(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((h,g)=>h.localeCompare(g)));continue}o.set(p,{version:m,path:jc(u,r),layout:kf(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 Yc}from"node:crypto";import _n from"node:fs/promises";import yn from"node:path";import{Option as tA}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]="01742f33-d1e8-5684-a585-2add88ddb73c")}catch{}})();function xf(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 Cr(e,t){return e.find(r=>r.target===t)??{target:t,keys:[t]}}function L(e,t){return e[t]===!0?!0:void 0}function Ye(e,t){return e[t]===!1?!0:void 0}function Wc(e,t){return t.some(n=>e[n]===!0)?!0:void 0}function Gc(e,t){for(let[n,r]of Object.entries(t))n==="__proto__"||n==="constructor"||n==="prototype"||Object.hasOwn(e,n)||(e[n]=r)}function Bc(e){let t=i=>Ii(e,Cr(ir,i)),n=i=>ds(e,Cr(Pi,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:xf(e,Cr(Pi,"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:Wc(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:L(e,"replaceDeps"),replaceTests:L(e,"replaceTests"),replaceFiles:L(e,"replaceFiles"),replaceDocs:L(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:L(e,"clearDeps"),clearComments:L(e,"clearComments"),clearNotes:L(e,"clearNotes"),clearLearnings:L(e,"clearLearnings"),clearFiles:L(e,"clearFiles"),clearTests:L(e,"clearTests"),clearDocs:L(e,"clearDocs"),clearReminders:L(e,"clearReminders"),clearEvents:L(e,"clearEvents"),clearTypeOptions:L(e,"clearTypeOptions")};return Gc(r,e),r}function Z(e,t){let n=Cr(ls,t),r=Ii(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 Sf(e){let t=L(e,"filterFilesMissing"),n=L(e,"filterDocsMissing");return{filterReviewerMissing:L(e,"filterReviewerMissing"),filterRiskMissing:L(e,"filterRiskMissing"),filterConfidenceMissing:L(e,"filterConfidenceMissing"),filterSprintMissing:L(e,"filterSprintMissing"),filterReleaseMissing:L(e,"filterReleaseMissing"),hasNotes:L(e,"hasNotes"),hasLearnings:L(e,"hasLearnings"),hasFiles:L(e,"hasFiles"),hasDocs:L(e,"hasDocs"),hasTests:L(e,"hasTests"),hasComments:L(e,"hasComments"),hasDeps:L(e,"hasDeps"),hasBody:L(e,"hasBody"),hasLinkedCommand:L(e,"hasLinkedCommand"),noNotes:Ye(e,"notes"),noLearnings:Ye(e,"learnings"),noFiles:Ye(e,"files")??t,filterFilesMissing:t,noDocs:Ye(e,"docs")??n,filterDocsMissing:n,noTests:Ye(e,"tests"),noComments:Ye(e,"comments"),noDeps:Ye(e,"deps"),emptyBody:L(e,"emptyBody"),noLinkedCommand:Ye(e,"linkedCommand")}}function Xi(e){let t={status:Z(e,"status"),type:Z(e,"type"),tag:Z(e,"tag"),priority:Z(e,"priority"),deadlineBefore:Z(e,"deadlineBefore"),deadlineAfter:Z(e,"deadlineAfter"),updatedAfter:Z(e,"updatedAfter"),updatedBefore:Z(e,"updatedBefore"),createdAfter:Z(e,"createdAfter"),createdBefore:Z(e,"createdBefore"),today:L(e,"today"),recent:L(e,"recent"),ids:Z(e,"ids"),assignee:Z(e,"assignee"),assigneeFilter:Z(e,"assigneeFilter"),parent:Z(e,"parent"),sprint:Z(e,"sprint"),release:Z(e,"release"),limit:Z(e,"limit"),offset:Z(e,"offset"),noTruncate:Ye(e,"truncate"),includeBody:L(e,"includeBody"),strictRead:L(e,"strictRead"),compact:L(e,"compact"),brief:L(e,"brief"),full:L(e,"full"),fields:Z(e,"fields"),sort:Z(e,"sort"),order:Z(e,"order"),tree:L(e,"tree"),treeDepth:Z(e,"treeDepth"),filterAcMissing:L(e,"filterAcMissing"),filterEstimatesMissing:Wc(e,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:L(e,"filterResolutionMissing"),filterMetadataMissing:L(e,"filterMetadataMissing"),...Sf(e)};return Gc(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 Ef(e,t){let n=e[t];return typeof n=="string"?n:typeof n=="number"&&Number.isFinite(n)?String(n):void 0}function gn(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function ea(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 dA(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 uA(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 Af=new Set(["tags","blockedBy","blocked_by","skills","fields"]),Rf=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"]),If=new Set(["files","files-discover","docs","test","test-all"]),Cf=new Set(["claim","release","start-task","pause-task","close-task"]),Tf={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"]},$f=["outputInclude","outputLimit","outputBudget","outputFormat","outputSession","outputCursor"];function Jc(e,t){let n={},r=t!==void 0&&If.has(t),i=t==="files"||t==="files-discover"||t==="docs";for(let[a,o]of Object.entries(e)){if(Array.isArray(o)&&Af.has(a)){n[a]=o.join(",");continue}if(a==="note"&&i){n[a]=o;continue}if(typeof o=="string"&&Rf.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 mA(e,t){let n=ns(e.options),r={},i=c=>{n[c]!==void 0||e[c]===void 0||(r[c]=e[c])};for(let c of Tf[t??""]??[])i(c);for(let c of $f)i(c);let a=Jc({...r,...n},t),o=C(e,"author"),s=t!==void 0&&Cf.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 pA(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 fA(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 hA(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 gA(e){return e.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ")}function ta(e){return Array.isArray(e)?e.map(t=>String(t)).filter(t=>t.length>0):[]}function _A(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 yA(e,t){return{changedFields:e.fullChangedFields===!0?"full":"compact",idOnly:e.idOnly===!0,runnerOptions:{...t}}}function Qi(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:Ef(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 Zi(e){if(typeof e=="string"&&e.trim().length>0)return e;if(Array.isArray(e))return ta(e)}function Tr(e){if(typeof e=="number"&&Number.isFinite(e)||typeof e=="string"&&e.trim().length>0)return e}function wA(e){let t=Zi(e.kind),n=Zi(e.exemptIsolate),r=Zi(e.exemptIsolateType);return{...t===void 0?{}:{kind:t},maxDepth:Tr(e.maxDepth),limit:Tr(e.limit),after:C(e,"after"),direction:C(e,"direction"),maxPaths:Tr(e.maxPaths),sample:Tr(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 vA(e){return{status:C(e,"filterStatus"),list:gn(e.list)?Xi(e.list):Qi(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 Of=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 Hc(e){let t={};for(let[n,r]of Object.entries(e))Of.has(n)||(t[n]=r);return Vc(t)}function Vc(e){let t=Jc(e,"update-many");for(let n of ir)for(let r of n.keys){let i=t[r];typeof i=="number"&&Number.isFinite(i)&&(t[r]=String(i))}return Bc(t)}function bA(e){if(gn(e.list)||gn(e.update)){let t=gn(e.update)?e.update:Hc(e);return{status:ee(e,"filterStatus"),list:gn(e.list)?Xi(e.list):Qi(e),update:Vc(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:Qi(e),update:Hc(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 Df="2026-07-15T06:22:12.276Z",Pf=Date.parse(Df),Nf=[["attributed","attributed"],["legacy_unknown","actionable_unknown"]],Kc=e=>typeof e=="string"?e:"",Xc=e=>{let t=e??{},n=Kc(t.author).trim().toLowerCase(),r=Number(["","unknown"].includes(n)),i=+(Date.parse(Kc(t.ts))>=Pf);return Nf[r][i]};function Zc(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 h=Xc(f);if(h!=="attributed"){if(d+=1,h==="actionable_unknown"&&r.has(`${e}:${m+1}`)){u+=1;continue}s[h]+=1,i&&h==="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 $A=(e,t,n=20,r=new Set)=>Zc(e,t,n,r);function Qc(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 wn=async(e,t=20,n=!1)=>{let r=yn.join(e,"history"),i;try{i=(await _n.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",h=new Set;if(i.includes(f))try{h=Qc(await _n.readFile(yn.join(r,f),"utf8"))}catch{h=new Set}for(let w of i){let v;try{v=await _n.readFile(yn.join(r,w),"utf8")}catch{continue}let x=w.slice(0,-6),b=Zc(x,v,t-o.length,h,n);c+=1,l+=b.checked_events,d+=b.unknown_event_count,u+=b.legacy_unknown_event_count,m+=b.actionable_unknown_event_count,p+=b.acknowledged_actionable_event_count,b.unknown_event_count>0&&a.add(x),o.push(...b.samples),n&&s.push(...b.actionable_events)}let g=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:g>o.length,...n?{actionable_events:s}:{}}};function Lf(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 Mf(e){try{return Qc(await _n.readFile(yn.join(e,"history","_workspace.jsonl"),"utf8"))}catch{return new Set}}function Ff(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 jf(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 Xc(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:Yc("sha256").update(r).digest("hex"),disposition:t.has(`${e.item_id}:${e.line}`)?"already_acknowledged":"actionable"}}async function el(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=Lf(t.all_actionable===!0?(await wn(e,0,!0)).actionable_events:r),o=await Mf(e),s=new Map;for(let m of a)if(Ff(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 _n.readFile(yn.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=>jf(m,o,s.get(m.item_id))),l=t.all_actionable===!0?"all_actionable":"events",d=Yc("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 OA(e,t,n=50){return(await el(e,t,n)).plan}function Uf(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:zf(e),all_actionable:t}}function zf(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 DA(e,t){let n=Uf(ta(t.historyEvent),t.allActionable===!0||t.all_actionable===!0);return qf(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 qf(e,t){let n=t.reviewer?.trim()??"",r=t.attributed_author?.trim()??"",i=t.reason?.trim()??"",a=await el(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 dr({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 na from"node:fs/promises";import ra 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 Wf=8388608,Gf=new Set(["resolved","failed"]),Bf=[{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 ia(e){return Bf.find(t=>t.matches(e))?.kind}function MA(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)?ia(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}`,h=t.get(f)??{harness:p,dimension:d,kind:m,count:0};h.count+=1,t.set(f,h)}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 FA(e){let t=[];for(let n of await tl(e))try{let r=await na.readFile(ra.join(e,"history",n),"utf8");for(let i of r.split(`
|
|
5
|
-
`)){if(i.trim().length===0)continue;let a=nl(i);if(a===null||!je(a.agent_provenance))continue;if(Object.values(a.agent_provenance).some(s=>je(s)&&ia(s.value)!==void 0)){t.push(n.slice(0,-6));break}}}catch{}return t}async function tl(e){try{return(await na.readdir(ra.join(e,"history"))).filter(t=>t.endsWith(".jsonl")).sort()}catch{return[]}}async function Hf(e,t,n){let r;try{r=await na.open(ra.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 nl(e){try{let t=JSON.parse(e);return je(t)?t:null}catch{return null}}function Jf(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=ia(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"||!Gf.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 Vf(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=nl(o);s&&Jf(s,t,n)}return{eventsRead:a,truncated:!1}}async function rl(e,t=1e4){let n=new Map,r=new Map,i=0,a=0,o=!1;for(let l of await tl(e)){let d=await Hf(e,l,Math.max(0,Wf-a));if(d===null)continue;a+=d.bytesRead;let u=Vf(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 zt from"node:fs/promises";import{createHash as Kf}from"node:crypto";import al 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 ol=4,Yf="history-drift-cache.json";function sl(e){return al.join(e,"runtime",Yf)}async function Xf(e){try{let t=await zt.readFile(sl(e),"utf8"),n=JSON.parse(t);return n.version!==ol||typeof n.entries!="object"||n.entries===null?null:n}catch{return null}}async function Zf(e,t,n,r,i){let a=lr(e),o;try{o=await zt.stat(a)}catch(l){return j(l)||i.unreadableStreams.push(ue),!1}let s=i.missingStreams.length,c=await ll({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 cl(e){return Kf("sha256").update(e).digest("hex")}async function Qf(e){let t=await zt.readFile(e,"utf8");return cl(t)}async function eh(e){let t=await zt.readFile(e,"utf8"),n=cl(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=js(r);return{latestAfterHash:i,chainOk:a.ok,contentHash:n,itemHashVersion:a.item_hash_version??Ni}}function th(e,t){return e!==void 0&&e.mtime_ms===t.mtimeMs&&e.ctime_ms===t.ctimeMs&&e.size===t.size}async function il(e,t,n){try{let r=await eh(t);return r||(n.missingStreams.push(e),null)}catch{return n.unreadableStreams.push(e),null}}async function ll(e){let t=typeof e.cached?.content_hash=="string"&&e.cached.content_hash.length>0?e.cached.content_hash:void 0;if(!(th(e.cached,e.stat)&&t!==void 0&&e.cached!==void 0)||!e.cached)return{verification:await il(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0};let r;if(e.verifyCacheHitByContent)try{r=await Qf(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??Ni},cacheDirty:!1}:{verification:await il(e.itemId,e.historyPath,e.accumulator),cacheDirty:!0}}async function nh(e,t,n,r){let i=Yn(e,t.id),a;try{a=await zt.stat(i)}catch(d){return(j(d)?r.missingStreams:r.unreadableStreams).push(t.id),!1}let o=await ll({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 Fs({metadata:c,body:s},o.verification.itemHashVersion)!==o.verification.latestAfterHash&&r.hashMismatches.push(t.id),o.cacheDirty}async function rh(e,t){if(!(t.unreadableStreams.includes(ue)||t.chainMismatches.includes(ue)))try{let n=await Us(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 $r(e,t,n={}){let r={missingStreams:[],unreadableStreams:[],hashMismatches:[],chainMismatches:[],workspaceStateMismatches:[],workspaceStateMissing:[],workspaceStateUnreadable:[]},a=(await Xf(e))?.entries??{},o={},s=!1,c=n.cacheHitVerification!=="metadata",l={previousEntries:a,nextEntries:o,verifyCacheHitByContent:c};for(let m of t)await nh(e,m,l,r)&&(s=!0);let d=await Zf(e,a,o,c,r);if(s||=d,await rh(e,r),s||Object.keys(a).length!==Object.keys(o).length){let m=sl(e);try{await zt.mkdir(al.dirname(m),{recursive:!0}),await ie(m,JSON.stringify({version:ol,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 vn from"node:fs/promises";import Or 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 ih(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 dl(e,t,n){let r=ih(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 ul(e,t){let n=t??Date.now(),r=Or.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 vn.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 vn.readFile(Or.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}=dl(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 ml(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Or.join(e,"locks"),o={scanned:0,removed:[],retained:[],warnings:[],entries:[]},s;try{s=(await vn.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=Or.join(a,c),d=`locks/${c}`;if(r?.onRead){let p=await r.onRead(l);o.warnings.push(...p)}let u;try{u=await vn.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=dl(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 vn.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 ah=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 aa(e){if(typeof e!="string")return;let t=e.trim();for(let n of ah)if(t===n.code||t.startsWith(`${n.code}:`))return n}function oa(e){let t={};for(let n of e){let r=aa(n);r!==void 0&&!Object.prototype.hasOwnProperty.call(t,r.code)&&(t[r.code]=r.command)}return t}function pl(e){return Object.values(oa(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 oh=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function qt(e,t={}){let n=new Set;t.extensionName!==void 0&&n.add(rr(t.extensionName));for(let g of t.extensionNames??[])n.add(rr(g));let r=g=>n.size===0||n.has(rr(g)),i=(g,w)=>fl(g.filter(v=>r(v.name)).map(w)),a=(g,w)=>fl(g.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??[],g=>g.definitions.map(w=>w.kind)),f=u.overrides.filter(g=>r(g.name)&&((g.commands?.length??0)>0||g.resultDiscriminator!==void 0)).map(g=>({format:g.format,commands:[...g.commands??[]],result_discriminator:g.resultDiscriminator!==void 0})).sort((g,w)=>g.format.localeCompare(w.format)),h=i(o.assurance_providers??[],g=>g.definition.id);return{capabilities:As(e,t),commands:i(o.commands,g=>g.command),command_overrides:i(s.overrides,g=>g.command),command_handlers:i(s.handlers,g=>g.command),hooks:oh.filter(([g])=>m[g].some(w=>r(w.name))).map(([,g])=>g),flag_commands:i(o.flags,g=>g.target_command),item_types:a(o.item_types,g=>g.types.map(w=>w.name)),item_fields:a(o.item_fields,g=>g.fields.map(w=>w.name)),...p.length>0?{relationship_kinds:p}:{},migrations:a(o.migrations,g=>typeof g.definition.id=="string"?[g.definition.id]:[]),profiles:i(o.profiles,g=>g.profile.name),importers:i(o.importers,g=>g.importer),exporters:i(o.exporters,g=>g.exporter),search_providers:i(o.search_providers,g=>g.definition.name),vector_store_adapters:i(o.vector_store_adapters,g=>g.definition.name),...h.length>0?{assurance_providers:h}:{},parser_overrides:i(c.overrides,g=>g.command),service_overrides:i(d.overrides,g=>g.service),renderer_overrides:i(u.overrides,g=>g.format),...f.length>0?{renderer_ownership:f}:{},preflight_overrides:l.overrides.filter(g=>r(g.name)).length,preflight_ownership:l.overrides.filter(g=>r(g.name)).map(g=>({commands:[...g.commands??[]]}))}}function fl(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}import sg from"node:path";import{mkdir as cg}from"node:fs/promises";import{readFile as Pr,realpath as da,writeFile as ph}from"node:fs/promises";import{execFile as fh}from"node:child_process";import te from"node:path";import{promisify as hh}from"node:util";import{readFile as sh,writeFile as ch}from"node:fs/promises";import bn 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 gl="# pm-cli:runtime-cache:start",sa="# pm-cli:runtime-cache:end",_l=".agents/pm",ca=["runtime/","search/","locks/","transactions/","checkpoints/"],lh=["search/eval-queries.json"];async function hl(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 yl(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/\/+$/,"")}function la(e){let t=e.replaceAll("\\","/");return bn.isAbsolute(e)||t===".."||t.startsWith("../")}function dh(e=_l){let t=yl(e);return[gl,...ca.map(n=>n==="search/"?`${t}/${n}*`:`${t}/${n}`),...lh.map(n=>`!${t}/${n}`),sa].join(`
|
|
8
|
-
`)}async function sR(e,t={}){let n=bn.join(e,".gitignore"),r=_l;if(t.pmRoot!==void 0){let d=yl(bn.relative(bn.resolve(e),bn.resolve(t.pmRoot)));if(la(d))return{path:n,changed:!1};d.length>0&&(r=d)}let i="";try{i=await hl(()=>sh(n,"utf8"))}catch(d){if(!(d instanceof Error&&"code"in d&&j(d)))throw d}let a=i.indexOf(gl),o=i.indexOf(sa),c=(a>=0&&o>=a?`${i.slice(0,a)}${i.slice(o+sa.length)}`:i).trimEnd(),l=`${c.length>0?`${c}
|
|
9
|
-
|
|
10
|
-
`:""}${dh(r)}
|
|
11
|
-
`;return l===i?{path:n,changed:!1}:(await hl(()=>ch(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 uh="PM_SOURCE_CONTEXT_ACCESS",mh="PM_ALLOW_SOURCE_CONTEXT_WRITES";function wl(e){let t=e[uh],n=t===void 0||t.trim().toLowerCase()==="write"?"write":"read_only",r=n==="read_only"&&e[mh]?.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]="dea4137f-adbd-5dca-bfc7-b56c99c7aa79")}catch{}})();var ma=hh(fh),Dr="# pm-cli:merge-drivers:start",xl="# pm-cli:merge-drivers:end",Wt="# pm-cli:merge-drivers:v2:start",ua="# pm-cli:merge-drivers:v2:end",gh="merge-fence";function vl(e){return`'${e.replaceAll("'",`'"'"'`)}'`}function Sl(){let e=Ee(import.meta.url,["../../.."]);return`${vl(process.execPath)} ${vl(te.join(e,"dist","cli.js"))}`}var El=[{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 _h(e){let t=e.explicitPath?.trim(),n=e.environment.PM_SOURCE_WORKSPACE_ROOT?.trim(),r=e.environment.PM_SOURCE_PM_PATH?.trim(),i=wl(e.environment),a=!!(n&&r),o=t===void 0&&a&&(e.dryRun||i.source_writes_allowed);if(t!==void 0){let s=F(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?F(e.cwd,".agents/pm"):F(e.cwd),workspace_start:e.cwd,source_coordinates_available:a,source_context_selected:!1,source_policy:i}}async function yt(e){try{let{stdout:t}=await ma("git",["rev-parse","--show-toplevel"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4});return await da(t.trim())}catch{return null}}async function Al(e){let t=await yt(e);if(t===null)throw new y("pm merge install requires a git repository (merge drivers are git configuration).",_.USAGE);return t}function pa(e,t){return te.relative(e,t).replaceAll("\\","/")}function Ue(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function bl(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 yh(e,t){let n=bl(e,0);if(n===null||e[n.nextOffset]!==" ")return!1;let r=bl(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 O(n.value)||!await O(r.value))return!1;try{let i=te.dirname(te.dirname(r.value)),a=JSON.parse(await Pr(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 fa(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 kl(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 Rl(e,t,n){let r=te.join(e,".gitattributes"),i="";try{i=await Pr(r,"utf8")}catch(l){if(!(l instanceof Error&&"code"in l&&j(l)))throw l}let a=[Wt,...t,ua].join(`
|
|
12
|
-
`),s=kl(kl(i,Wt,ua),Dr,xl).trimEnd(),c=`${s.length>0?`${s}
|
|
13
|
-
|
|
14
|
-
`:""}${a}
|
|
15
|
-
`;return c===i?{path:r,changed:!1}:(n||await ph(r,c,"utf8"),{path:r,changed:!0})}function Nr(e){let t=q(e,null);return[...new Set(Object.values(t.type_to_folder))].sort((n,r)=>n.localeCompare(r))}async function Il(e,t){let n=te.resolve(e),r=null,i="",a=n;for(let v=0;v<8;v+=1){let x=te.join(a,".gitattributes");try{let S=await Pr(x,"utf8");if(S.includes(Wt)||S.includes(Dr)){r=a,i=S;break}}catch{}let b=te.dirname(a);if(b===a)break;a=b}if(r===null)return{status:"not_installed",missing_patterns:[],stale_patterns:[],schema_scope:"project"};let o=te.join(r,".gitattributes"),s=i.includes(Wt),c=s?Wt:Dr,l=s?ua:xl,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=fa(pa(r,n),t),f=new Set(m),h=new Set(p),g=p.filter(v=>!f.has(v)),w=m.filter(v=>!h.has(v));return{status:g.length>0||w.length>0?"drift":"ok",path:o,missing_patterns:g,stale_patterns:w,schema_scope:"project"}}async function Lr(e){let t=Sl(),n=[],r=[];for(let i of El){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 ma("git",["config","--local","--get",a],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4}),l=c.trim();l!==s&&!await yh(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 Cl(e){let t;try{t=await Al(te.resolve(e))}catch{return{status:"no_git"}}let n=pa(t,te.resolve(e)),r=await I(e),i=K(void 0,r.author_default),a=await de(e,gh,r.locks.ttl_seconds,i,!1,Oe(r).force_required_for_stale_lock,r.locks.wait_ms);try{let o=te.join(t,".gitattributes"),s;try{s=await Pr(o,"utf8")}catch(u){if(u instanceof Error&&"code"in u&&j(u))return{status:"not_installed",path:o};throw u}if(!s.includes(Wt)&&!s.includes(Dr))return{status:"not_installed",path:o};let c=await I(e),l=Nr(c),d=await Rl(t,fa(n,l),!1);return{status:d.changed?"refreshed":"unchanged",path:d.path}}finally{await a()}}async function IR(e,t){let n=_h({cwd:process.cwd(),explicitPath:t.path,dryRun:e.dryRun===!0,environment:process.env}),r=n.pm_root;await oe(r);let i=await Al(n.workspace_start);return wh({pmRoot:r,workspaceRoot:i,dryRun:e.dryRun===!0})}async function wh(e){let t=te.resolve(e.pmRoot),n=te.resolve(e.workspaceRoot),r=e.dryRun===!0,i,a;try{[i,a]=await Promise.all([da(t),da(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=pa(a,i);if(la(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=Nr(s),l=fa(o,c),d=[],u=Sl();for(let p of El)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 ma("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 Rl(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 vh=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function bh(e){let t=vh.exec(e.trim());if(!t)return;let n=t[1];if(!(n.length<2)&&!/^[A-Za-z]\d+$/.test(n))return n.toLowerCase()}function kh(e){return e.split(/[-_]+/).filter(t=>t.length>0).map(t=>`${t.slice(0,1).toUpperCase()}${t.slice(1).toLowerCase()}`).join("")}function Tl(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=bh(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=kh(o);a.push({name:c,prefix:o,count:s.count,examples:s.examples,shadows_builtin:us(c)!==void 0})}return a.sort((o,s)=>s.count-o.count||o.name.localeCompare(s.name)),a}import{createHash as ql}from"node:crypto";import vt from"node:fs/promises";import Bt from"node:path";import{mkdir as xh,readFile as Sh}from"node:fs/promises";import Ll 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 ha=class extends Error{constructor(t="Workspace transaction interrupted"){super(t),this.name="WorkspaceTransactionInterruptedError"}},Eh="sdk-workspace-transaction",Ah=/^[a-zA-Z0-9._-]+$/,Rh=30,Ih=3e3;function $l(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n||!Ah.test(n))throw new TypeError(`${t} must match [a-zA-Z0-9._-]+`);return n}function Ol(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 Dl(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 Ml(e,t){return Ll.join(e,"transactions","sdk",`${t}.json`)}async function at(e,t){t.updatedAt=$();let n=Ml(e,t.transactionId);await xh(Ll.dirname(n),{recursive:!0}),await ie(n,`${JSON.stringify(t,null,2)}
|
|
17
|
-
`)}function Ch(e){return Number.isInteger(e.attempt)&&typeof e.author=="string"&&typeof e.createdAt=="string"&&typeof e.updatedAt=="string"}function wt(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 ga(e,t){return e===void 0?void 0:Th(e,t)}function _a(e,t,n,r){let i=ga(n,r);i===void 0?delete e[t]:e[t]=i}function Pl(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function Nl(e,t){return Array.isArray(e)&&new Set(e).size===e.length&&e.every(n=>typeof n=="string"&&t.includes(n))}function $h(e,t){if(!Nl(e.startedStepIds,t)||!Nl(e.completedStepIds,t)||!Pl(e.results)||!Pl(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 Oh(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=$h(i,n),c=Ch(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:wt(i.results),compensationData:wt(i.compensationData)}}async function Dh(e,t,n,r,i){let a=i,o=a!==void 0;if(a?.status==="compensating"&&await Fl(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:wt(),compensationData:wt()},await at(e.pmRoot,a),await Xe(e,a,"prepared")}return{journal:a,recovered:o}}async function Ph(e,t,n){try{await Lh(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=ga(o.result,`Step ${a.id} result`);if(o.state!=="applied"){let c=await a.prepareCompensation?.();_a(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=ga(l,`Step ${a.id} result`)}await Xe(e,t,"step_applied",a.id),r.add(a.id),t.completedStepIds=e.steps.map(c=>c.id).filter(c=>r.has(c)),_a(t.results,a.id,s,`Step ${a.id} result`),await at(e.pmRoot,t),await Xe(e,t,"step_recorded",a.id)}return await Xe(e,t,"committing"),t.status="committed",await at(e.pmRoot,t),await Xe(e,t,"committed"),{transactionId:t.transactionId,status:"committed",recovered:n,results:wt(t.results)}}catch(r){if(r instanceof ha||t.status==="committed")throw r;try{await Fl(e,t)}catch(i){throw new AggregateError([r,i],`Workspace transaction failed and compensation failed: ${String(i)}`,{cause:i})}throw r}}async function Nh(e,t,n){try{return Oh(await Sh(Ml(e,t),"utf8"),t,n)}catch(r){if(r!==null&&typeof r=="object"&&"code"in r&&j(r))return;throw r}}async function Xe(e,t,n,r){await e.onTransition?.({transactionId:t.transactionId,attempt:t.attempt,transition:n,...r===void 0?{}:{stepId:r}})}async function Lh(e,t){let n=new Set,r=wt();for(let i of t){let a=await i.inspect();a.state==="applied"&&(n.add(i.id),_a(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 Fl(e,t){t.status="compensating",await at(e.pmRoot,t),await Xe(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 Xe(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 Xe(e,t,"step_compensated",i.id)}t.status="compensated",await at(e.pmRoot,t),await Xe(e,t,"compensated")}async function jl(e){let t=Ol(e.pmRoot,"Transaction pmRoot"),n=$l(e.transactionId,"Transaction id"),r=Ol(e.author,"Transaction author"),i=Dl(e.lockTtlSeconds,Rh,"Transaction lock TTL"),a=Dl(e.lockWaitMs,Ih,"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=$l(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,Eh,i,r,!1,!1,a);try{let d=await Nh(t,n,s),u=d!==void 0;if(d?.status==="committed")return{transactionId:n,status:"committed",recovered:!0,results:wt(d.results)};let m=await Dh(c,n,r,s,d);return await Ph(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]="60738c1f-3b44-5f8a-82c9-99d2b2de1e51")}catch{}})();function Ze(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Schema migration ${t} must be non-empty`);return e.trim()}function Wl(e){let t=Ze(e,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(t))throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");return t}function Gl(e,t){let n=wa(e),r=Ze(t,"migrationScope");return`auto-${ql("sha256").update(JSON.stringify({scope:r,request:n})).digest("hex").slice(0,20)}`}function wa(e){let t=e.kind==="rename-type"?{kind:e.kind,from:Ze(e.from,"source"),to:Ze(e.to,"target")}:e.kind==="rename-field"?{kind:e.kind,from:ce(Ze(e.from,"source")),to:ce(Ze(e.to,"target")),...e.type===void 0?{}:{type:Ze(e.type,"type")}}:{kind:e.kind,from:ce(Ze(e.from,"source")),to:ce(Ze(e.to,"target"))};if(t.from.toLowerCase()===t.to.toLowerCase())throw new TypeError("Schema migration source and target must differ");return t}function Mh(e){return e.kind==="rename-type"?"types":e.kind==="rename-field"?"fields":"statuses"}function Fh(e,t,n){let r=we(t.schema),i=Mh(n);return Me(e,r.files[i],Ae[i])}function Bl(e,t){return Bt.join(e,"transactions","schema",`${t}-plan.json`)}function Mr(e){return e.length===0?null:JSON.parse(e)}async function Gt(e){let t=await Y(e);return{exists:t!==null,raw:t??""}}async function Hl(e,t){t.exists?await ie(e,t.raw):await vt.rm(e,{force:!0})}function jh(e,t,n){let r=He(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=Rt(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 It(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 It(r)}function zh(e,t,n){let r=Ct(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 Tt(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 Tt(r)}function qh(e,t,n){return t.kind==="rename-type"?jh(e,t,n):t.kind==="rename-field"?Uh(e,t,n):zh(e,t,n)}function ot(e,t){return typeof e=="string"&&e.trim().toLowerCase()===t.from.toLowerCase()?t.to:e}function va(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function Ht(e){return Array.isArray(e)?e.map(t=>va(t)).filter(t=>t!==void 0):[]}function Wh(e,t){for(let n of Ht(e.fields))Array.isArray(n.required_types)&&(n.required_types=n.required_types.map(r=>ot(r,t)));for(let n of Ht(e.type_workflows))n.type=ot(n.type,t)}function Gh(e,t){for(let r of Ht(e.definitions))r.default_status=ot(r.default_status,t);let n=va(e.workflow);if(n)for(let[r,i]of Object.entries(n))n[r]=ot(i,t);for(let r of Ht(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 Bh(e,t){for(let n of Ht(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 Ht(n[r])){let a=r==="options"?"key":"option";i[a]=ot(i[a],t)}}}function Hh(e,t){let n=va(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 ya(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"?Wh(r,t):t.kind==="rename-field"?Bh(r,t):Gh(r,t),Hh(r,t),`${JSON.stringify(r,null,2)}
|
|
18
|
-
`}function Jl(e,t){if(t.kind==="rename-type"){let r=He(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=Rt(e).fields;return{source:r.some(i=>i.key===t.from),target:r.some(i=>i.key===t.to)}}let n=Ct(e).statuses;return{source:n.some(r=>r.id===t.from),target:n.some(r=>r.id===t.to)}}function Jh(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 Vh(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 Vl(e,t){let n=wa(t.request),r=t.migrationId===void 0?Gl(n,t.migrationScope??"plan"):Wl(t.migrationId),i=e.map(c=>Vh(c,n)).filter(c=>c!==null).sort((c,l)=>c.id.localeCompare(l.id)),a=ql("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 Kh(e){let t=q(e.settings,z()),n=[...new Set(Object.values(t.type_to_folder))],r=await fr(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 Gs({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 Ve(e.pmRoot,e.settings.item_format,t.type_to_folder,[],e.settings.schema),selectionSource:"scan",typeToFolder:t.type_to_folder}}async function Yh(e,t){let n=await Y(Bl(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: ${ts(r)}`,_.GENERIC_FAILURE)}}async function Xh(e,t){let n=Bl(e,t.migration_id);await vt.mkdir(Bt.dirname(n),{recursive:!0});let r={schema_version:1,plan:t,created_at:new Date().toISOString()};await ie(n,`${JSON.stringify(r,null,2)}
|
|
19
|
-
`)}function Zh(e,t){return JSON.stringify(e)===JSON.stringify(t)}async function Qh(e){let t=await Dt(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 Pt(t,{schema:e.settings.schema})).document.metadata}function Ul(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 zl(e){return{id:e.id,inspect:async()=>{let t=await Gt(e.filePath),n=Jl(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 ie(e.filePath,qh(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 Hl(e.filePath,{exists:t.exists,raw:t.raw})}}}function eg(e){return{id:e.stepId,inspect:async()=>{let t=await Gt(e.filePath);return{state:ya(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 ie(e.filePath,ya(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 Hl(e.filePath,{exists:t.exists,raw:t.raw})}}}function tg(e){return{id:`item-${e.id}`,inspect:async()=>{let t=await I(e.pmRoot),n=q(t,z()).type_to_folder,r=await Qh({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id}),i=Jh(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 ht({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:Ul(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 ht({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:Ul(r,e.request,"reverse")}}})}}}async function ng(e){let t=await Yh(e.pmRoot,e.migrationId);if(t){if(!Zh(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 Kh({pmRoot:e.pmRoot,settings:e.settings,request:e.request});return{plan:{...Vl(n.items,{migrationId:e.migrationId,request:e.request}),selection_source:n.selectionSource},stored:!1}}async function rg(e){let t=Jl(await Y(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 Xh(e.pmRoot,e.plan)}async function ig(e){let t=we(e.settings.schema),n=[...new Set([["types",Ae.types],["fields",Ae.fields],["workflows",Ae.workflows]].map(([i,a])=>Me(e.pmRoot,t.files[i],a)).filter(i=>i!==e.schemaPath))];try{let i=Bt.join(e.pmRoot,"templates"),a=await vt.readdir(i,{withFileTypes:!0});n.push(...a.filter(o=>o.isFile()&&o.name.toLowerCase().endsWith(".json")).map(o=>Bt.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 Y(i);a!==null&&ya(a,e.request)!==a&&r.push({filePath:i,beforeRaw:a})}return{paths:n,snapshots:r}}async function ag(e){for(let t of e.snapshots){let n=await vt.readFile(t.filePath,"utf8"),r=Bt.relative(e.pmRoot,t.filePath).replaceAll("\\","/");await Li({pmRoot:e.pmRoot,author:e.author,documentPath:r,before:Mr(t.beforeRaw),after:Mr(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 og(e,t,n){let r=wa(e),i=F(process.cwd(),n.path);await oe(i);let a=t.migrationId===void 0?Gl(r,await vt.realpath(i)):Wl(t.migrationId),o=await I(i),s=K(t.author,o.author_default),c=await ng({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=Fh(i,o,r),u=await vt.readFile(d,"utf8");c.stored||await rg({pmRoot:i,schemaPath:d,request:r,plan:l});let m=await ig({pmRoot:i,schemaPath:d,settings:o,request:r}),p=[zl({id:"stage-schema",filePath:d,request:r,phase:"stage"}),...m.paths.map((w,v)=>eg({filePath:w,request:r,stepId:`reference-${String(v+1).padStart(4,"0")}`})),...l.items.map(w=>tg({pmRoot:i,id:w.id,request:r,author:s,force:t.force===!0})),zl({id:"retire-source",filePath:d,request:r,phase:"retire"})],f=await jl({pmRoot:i,transactionId:`schema-${a}`,author:s,steps:p,lockTtlSeconds:Math.max(o.locks.ttl_seconds,300),lockWaitMs:o.locks.wait_ms}),h=await vt.readFile(d,"utf8"),{historyPath:g}=await Li({pmRoot:i,author:s,documentPath:Bt.relative(i,d).replaceAll("\\","/"),before:Mr(u),after:Mr(h),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 ag({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:g}}(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]="6112923d-5e06-5839-b452-a32818c6398d")}catch{}})();var OI=["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"],Fr="schema-types",Kl="schema-statuses",Yl="schema-fields";function st(e){return mr({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 DI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i;try{i=Ti({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=Me(r,o.files.types,Ae.types),c=[],l=K(t.author,a.author_default),d=Oe(a),u=await de(r,Fr,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms),m;try{let p=await Y(s),f;try{f=He(p)}catch(h){throw new y(h instanceof Error?h.message:String(h),_.GENERIC_FAILURE)}try{ms(i,f);let h=new Map,g=q(a,z());for(let[w,v]of Object.entries(g.type_to_folder)){let x=v.trim().toLowerCase();x.length>0&&!h.has(x)&&h.set(x,w)}ps(i,f,h)}catch(h){throw new y(h instanceof Error?h.message:String(h),_.USAGE)}m=er(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 kn(r,[m.definition],c,"schema:add-type-folder"),c.push(...await ae({path:s,scope:"project",op:"schema:add-type"}))}finally{await u()}return await Xl(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 Qe(e){await oe(e)}async function Xl(e,t){try{let n=await Cl(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 lg(e,t,n,r){let i=q(t,z()),a=r.trim().toLowerCase();return(await Ve(e,t.item_format,i.type_to_folder,[],n)).filter(s=>typeof s.type=="string"&&s.type.toLowerCase()===a).length}async function dg(e,t,n,r){let i=q(t,z()),a=$e(n),o=ce(r);return(await Ve(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(ce(l))??ce(l))===o}).length}async function ug(e,t,n,r,i){if(i.length===0||Oi.has(i))return;let a=await dg(t,n,r,i);a>0&&e.push(`items_using_status:${a}`);let o=mg(r.workflow,i);o.length>0&&e.push(`status_referenced_by_workflow:${o.join(",")}`)}function mg(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&&ce(r)===t).map(([r])=>r)}async function PI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i=await I(r),a=we(i.schema),o=Me(r,a.files.types,Ae.types),s=[],c=K(t.author,i.author_default),l=Oe(i),d=await de(r,Fr,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await Y(o),p;try{p=He(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=fs(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 h=await lg(r,i,a,f);h>0&&s.push(`items_using_type:${h}`)}await st({pmRoot:r,filePath:o,raw:it(u.file),op:"schema:remove-type",author:c,settings:i}),s.push(...await ae({path:o,scope:"project",op:"schema:remove-type"}))}}finally{await d()}return u.removed&&await Xl(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 ba(e,t){return Me(e,t.files.statuses,Ae.statuses)}function jr(e,t){return Me(e,t.files.fields,Ae.fields)}function Zl(e,t){return Me(e,t.files.types,Ae.types)}async function kn(e,t,n,r){for(let i of t){let a=Zo(i.folder??Xo(i.name)),o=sg.join(e,a);await O(o)||(await cg(o,{recursive:!0}),n.push(...await ae({path:o,scope:"project",op:r})))}}function ka(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 pg(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 fg(e){let t=new Map;for(let n of e){let r=ce(n.id);if(r.length!==0){t.set(r,r);for(let i of Array.isArray(n.aliases)?n.aliases:[]){let a=ce(i);a.length>0&&!t.has(a)&&t.set(a,r)}}}return t}async function NI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i;try{i=bs({id:e,roles:t.role,aliases:t.alias,description:t.description,order:t.order})}catch(h){throw new y(h instanceof Error?h.message:String(h),_.USAGE)}let a=await I(r),o=we(a.schema),s=ba(r,o),c=$e(o);try{Di(i,c.alias_to_id)}catch(h){throw new y(h instanceof Error?h.message:String(h),_.USAGE)}let l=pg(c.by_id.get(i.id)),d=[],u=K(t.author,a.author_default),m=Oe(a),p=await de(r,Kl,a.locks.ttl_seconds,u,!!t.force,m.force_required_for_stale_lock,a.locks.wait_ms),f;try{let h=await Y(s),g;try{g=Ct(h)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.GENERIC_FAILURE)}let w=fg(g.statuses);try{Di(i,w)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.USAGE)}f=ks(g,i,l),await st({pmRoot:r,filePath:s,raw:Tt(f.file),op:"schema:add-status",author:u,settings:a}),d.push(...await ae({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 LI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i=await I(r),a=we(i.schema),o=ba(r,a),s=[],c=K(t.author,i.author_default),l=Oe(i),d=await de(r,Kl,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await Y(o),p;try{p=Ct(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=xs(p,e)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}if(u.removed){let f=ce(u.definition?.id??e);await ug(s,r,i,a,f),await st({pmRoot:r,filePath:o,raw:Tt(u.file),op:"schema:remove-status",author:c,settings:i}),s.push(...await ae({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 Ql(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 hg(e,t,n){return{...Ql(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 ed(e){return{id:e.id,source:Oi.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 td(e,t,n){let r=e.toLowerCase();return n.has(r)?"extension":t.has(r)?"custom":"builtin"}function gg(){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 _g(e){let t=$e(e),n=[],r=[];for(let i of t.definitions){let a=ed(i);a.source==="builtin"?n.push(a):r.push(a)}return{builtin:n,custom:r}}async function xn(e){let t=F(process.cwd(),e.path);await Qe(t);let n=await I(t),r=we(n.schema),i=Me(t,r.files.types,Ae.types),a=ba(t,r),o=q(n,z()),s=gg(),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 MI(e){let t=await xn(e),n=[],r=[],i=[];for(let s of Object.values(t.byType).sort((c,l)=>c.name.localeCompare(l.name))){let c=td(s.name,t.customNames,new Set(t.extensionProvenance.keys())),l=Ql(s);c==="extension"?i.push(l):c==="custom"?r.push(l):n.push(l)}let a=_g(t.schema),o=tr(t.schema).definitions.map(ka);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 FI(e,t){let n=(e??"").trim();if(n.length===0)throw new y("Type name must not be empty.",_.USAGE);let r=await xn(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 "${Qn(n)}" to register it.`,_.NOT_FOUND,{code:"unknown_item_type"});return{action:"show",type:hg(i,td(i.name,r.customNames,new Set(r.extensionProvenance.keys())),r.extensionProvenance.get(i.name.toLowerCase())),file:{path:r.typesPath},generated_at:$()}}async function jI(e,t){let n=ce(e);if(n.length===0)throw new y("Status id must not be empty.",_.USAGE);let r=await xn(t),i=$e(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 "${Qn(e??"")}" to register it.`,_.NOT_FOUND,{code:"unknown_status"});return{action:"show-status",status:ed(o),file:{path:r.statusesPath},generated_at:$()}}async function UI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i;try{i=_s({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=jr(r,o),c=[],l=nr(i.key);l&&c.push(`custom_field_mcp_input_collision:${l.field}:${l.property}:${l.owner}:use=${l.nested_path}`);let d=K(t.author,a.author_default),u=Oe(a),m=await de(r,Yl,a.locks.ttl_seconds,d,!!t.force,u.force_required_for_stale_lock,a.locks.wait_ms),p;try{let f=await Y(s),h;try{h=Rt(f)}catch(g){throw new y(g instanceof Error?g.message:String(g),_.GENERIC_FAILURE)}p=ys(h,i),await st({pmRoot:r,filePath:s,raw:It(p.file),op:"schema:add-field",author:d,settings:a}),c.push(...await ae({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 yg(e,t,n,r){let i=q(t,z());return(await Ve(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 zI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i=await I(r),a=we(i.schema),o=jr(r,a),s=[],c=K(t.author,i.author_default),l=Oe(i),d=await de(r,Yl,i.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,i.locks.wait_ms),u;try{let m=await Y(o),p;try{p=Rt(m)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.GENERIC_FAILURE)}try{u=ws(p,e)}catch(f){throw new y(f instanceof Error?f.message:String(f),_.USAGE)}if(u.removed){let f=ce(u.definition?.key??e),h=ce(u.definition?.metadata_key??u.definition?.front_matter_key??f);if(h.length>0){let g=await yg(r,i,a,h);g>0&&s.push(`items_using_field:${g}`)}await st({pmRoot:r,filePath:o,raw:It(u.file),op:"schema:remove-field",author:c,settings:i}),s.push(...await ae({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 qI(e){let t=await xn(e),n=tr(t.schema).definitions.map(ka);return{action:"list-fields",fields:n,counts:{total:n.length},file:{path:jr(t.pmRoot,t.schema)},generated_at:$()}}async function WI(e,t){let n=ce(e);if(n.length===0)throw new y("Field key must not be empty.",_.USAGE);let r=await xn(t),i=tr(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 "${Qn(e??"")}" to register it.`,_.NOT_FOUND,{code:"unknown_field"});return{action:"show-field",field:ka(i),file:{path:jr(r.pmRoot,r.schema)},generated_at:$()}}async function GI(e,t,n){let r=F(process.cwd(),n.path);await Qe(r);let i;try{let h=gs(e);if(h===void 0)throw new Error(`Type preset name is required. Allowed: ${hs.join(", ")}.`);i=h}catch(h){throw new y(h instanceof Error?h.message:String(h),_.USAGE)}let a=await I(r),o=we(a.schema),s=Zl(r,o),c=[],l=K(t.author,a.author_default),d=Oe(a),u=[],m=[],p,f=await de(r,Fr,a.locks.ttl_seconds,l,!!t.force,d.force_required_for_stale_lock,a.locks.wait_ms);try{let h=await Y(s),g;try{g=He(h)}catch(v){throw new y(v instanceof Error?v.message:String(v),_.GENERIC_FAILURE)}let w=g;for(let v of $i(i)){let x=er(w,v);w=x.file,(x.replaced?m:u).push(x.definition.name)}p=w.definitions.length,await st({pmRoot:r,filePath:s,raw:it(w),op:"schema:apply-preset",author:l,settings:a}),await kn(r,$i(i),c,"schema:apply-preset-folder"),c.push(...await ae({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 wg(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 BI(e,t){let n=F(process.cwd(),t.path);await Qe(n);let r=await I(n),i=we(r.schema),a=Zl(n,i),o=wg(e.minCount),s=q(r,z()),l=(await Ve(n,r.item_format,s.type_to_folder,[],i)).map(x=>typeof x.title=="string"?x.title:""),d=Tl(l,{minCount:o}),u=[],m=[],p=[],f=[],h;if(!e.apply){let x;try{x=He(await Y(a))}catch(b){throw new y(b instanceof Error?b.message:String(b),_.GENERIC_FAILURE)}return h=x.definitions.length,{action:"infer-types",applied:!1,min_count:o,candidates:d,registered:m,replaced:p,skipped:f,file:{path:a,definitions:h},warnings:u,generated_at:$()}}let g=K(e.author,r.author_default),w=Oe(r),v=await de(n,Fr,r.locks.ttl_seconds,g,!!e.force,w.force_required_for_stale_lock,r.locks.wait_ms);try{let x=await Y(a),b;try{b=He(x)}catch(k){throw new y(k instanceof Error?k.message:String(k),_.GENERIC_FAILURE)}let S=b;for(let k of d){if(k.shadows_builtin){f.push({name:k.name,reason:"shadows_builtin"});continue}let R;try{R=Ti({name:k.name})}catch{f.push({name:k.name,reason:"invalid_type_token"});continue}let T=er(S,R);S=T.file,(T.replaced?p:m).push(T.definition.name)}h=S.definitions.length,await st({pmRoot:n,filePath:a,raw:it(S),op:"schema:infer-types",author:g,settings:r}),await kn(n,S.definitions.filter(k=>m.includes(k.name)||p.includes(k.name)),u,"schema:infer-types-folder"),u.push(...await ae({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:h},warnings:ct(u),generated_at:$()}}import nd from"node:fs/promises";import xa 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 E(e){return e.trim().toLowerCase()}function Ur(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 Sa(e){return ss(e)}async function vg(e){try{let t=JSON.parse(await nd.readFile(xa.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 bg(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 vg(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 Jt(e,t={}){let n=xa.join(e,"manifest.json");if(!await O(n))throw new y(`Extension manifest is missing at "${n}".`,_.USAGE);let r;try{r=JSON.parse(await nd.readFile(n,"utf8"))}catch(o){throw new y(`Failed to parse extension manifest at "${n}": ${kg(o)}`,_.USAGE)}let i=Sa(r);if(!i)throw new y(`Extension manifest at "${n}" is invalid.`,_.USAGE);let a=xa.resolve(e,i.entry);if(!ye(e,a))throw new y(`Extension entry "${i.entry}" resolves outside extension directory "${e}".`,_.USAGE);if(!await O(a))throw await bg(i,a,t);if(!await cs(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 kg(e){return e instanceof Error?e.message:String(e)}import Ea from"node:fs/promises";import xg 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 Sg=".managed-extensions.json",zr=1;function Sn(e){return xg.join(e,Sg)}function Eg(){return{version:zr,updated_at:$(),entries:[]}}function En(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 rd(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 Ag(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 Rg(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 Ig(e){if(typeof e!="object"||e===null)return null;let t=e;if(!Ag(t))return null;let n=Rg(t.source);if(!n)return null;let r=is(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 Cg(e){if(typeof e!="object"||e===null)return null;let t=e;if(t.version!==zr||!Array.isArray(t.entries))return null;let n=[];for(let r of t.entries){let i=Ig(r);i&&n.push(i)}return{version:zr,updated_at:xe(t.updated_at)??$(),entries:En(n)}}async function pe(e){let t=Sn(e),n=Eg();try{let r=await Ea.readFile(t,"utf8"),i=JSON.parse(r),a=Cg(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 bt(e,t){let n=Sn(e),r={version:zr,updated_at:$(),entries:En(t.entries)};await Ea.mkdir(e,{recursive:!0}),await Ea.writeFile(n,`${JSON.stringify(r,null,2)}
|
|
20
|
-
`,"utf8")}function An(e,t){let n=e.entries.filter(r=>E(r.name)!==E(t.name)&&E(r.directory)!==E(t.directory));return n.push(t),{...e,updated_at:$(),entries:En(n)}}async function id(e,t,n,r){let i=t.entries.find(o=>E(o.name)===E(n));if(!i)return t;let a=An(t,{...i,contributions:r});return await bt(e,a),a}import{execFile as Ug}from"node:child_process";import W from"node:fs/promises";import Ta from"node:os";import P from"node:path";import{fileURLToPath as zg}from"node:url";import{promisify as qg}from"node:util";import Wg from"npm-package-arg";import{extract as Gg,list as Bg}from"tar";import Tg from"node:fs/promises";import De 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 $g="PM_CLI_PACKAGE_ROOT",ad={beads:{package_directory:"pm-beads",legacy_extension_directory:"beads"},todos:{package_directory:"pm-todos",legacy_extension_directory:"todos"}},Og=new Set(["*","all"]);function Aa(){let e=[],t=process.env[$g];return typeof t=="string"&&t.trim().length>0&&e.push(De.resolve(t.trim())),e.push(Ee(import.meta.url,["../../.."])),[...new Set(e)]}async function Rn(e){let t=e.trim().toLowerCase(),n=await sd(t);if(n)return n;let r=ad[t];if(!r)return null;for(let i of Aa()){let a=De.join(i,".agents","pm","extensions",r.legacy_extension_directory);if(await O(De.join(a,"manifest.json")))return a}return null}function od(e){return Og.has(e.trim().toLowerCase())}function Dg(e){return e.replace(/^pm-/i,"").trim().toLowerCase()}async function Pg(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=De.join(e,r.name);if(!await O(De.join(i,"package.json")))continue;let a=await Xn(i),o=a.aliases&&a.aliases.length>0?a.aliases:[Dg(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 Ra(){let e=new Map;for(let t of Aa()){let n=De.join(t,"packages");await O(n)&&await Pg(n,e)}for(let[t,n]of Object.entries(ad))if(!e.has(t))for(let r of Aa()){let i=De.join(r,"packages",n.package_directory);if(await O(De.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 qr(){return(await Ra()).map(e=>e.alias)}async function sd(e){let t=e.trim().toLowerCase();return(await Ra()).find(r=>r.alias===t||r.package_directory.toLowerCase()===t||r.package_name?.toLowerCase()===t)?.package_root??null}async function cd(e){let t=await sd(e);return t?(await Xn(t)).package_name??null:null}async function ld(e){let t=await Rn(e);if(!t)return null;try{let n=await Zn(t);return n.length!==1?null:(await Jt(n[0])).manifest.name}catch{return null}}function Ng(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 Lg(e,t,n,r,i,a){let o=r==="global"?"--global":"--project",s=Object.fromEntries(Ci.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(De.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:Ng(e),media:e.catalog?.media}}}async function dd(e,t,n={}){let r=At(F(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=>De.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 Ra()){let p=De.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(g=>g.alias).sort((g,w)=>g.localeCompare(w)),h=await Xn(p.package_root);c.push(Lg(h,p,f,e,s,o))}let d=Fg(n.fields),u=d?c.map(m=>jg(m,d)):c;return{total:u.length,scope:e,installable_resource_kinds:["extensions"],metadata_only_resource_kinds:Ci.filter(m=>m!=="extensions"),packages:u}}var Mg=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 Fg(e){if(e===void 0)return;let t=wr(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=>!Mg.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 jg(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]="89b84412-aa15-5868-95b3-c8d898b1f480")}catch{}})();var $a=qg(Ug),Gr="@unbrained/pm-cli",Hg={maxArchiveBytes:64*1024*1024,maxEntries:4096,maxExpandedBytes:256*1024*1024,maxEntryBytes:64*1024*1024},Ia;async function ud(e,t=process.cwd()){let n=e.trim();if(!/^(@[^/\\\s]+\/[^/\\\s]+|[^@/\\\s][^/\\\s]*)$/u.test(n))return null;let r=P.resolve(t);for(;;){let i=P.join(r,"node_modules",...n.split("/")),a=P.join(i,"package.json");if(await O(a))try{let s=JSON.parse(await W.readFile(a,"utf8"));if(s.name===n)return{package:n,...typeof s.version=="string"?{version:s.version}:{},directory:i}}catch{return null}let o=P.dirname(r);if(o===r)return null;r=o}}function Ca(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 Jg(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 Br(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 Jg(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 Ca(s,n,r)}catch{return null}})();if(i)return i;let a=n.startsWith("github.com/")?n.slice(11):null;if(a){let o=Ca(a,n,r);if(!o)throw new y(`Invalid GitHub source "${n}".`,_.USAGE);return o}if(t.forceGithub){let o=Ca(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:P.resolve(process.cwd(),n)}}async function Wr(e,t=$a,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 Vg(e=process.platform){return e==="win32"?"npm.cmd":"npm"}function Kg(e=process.platform){return e==="win32"}async function md(e,t,n=$a,r=process.platform,i=process.env){let a=Vg(r),o=Object.fromEntries(Object.entries(i).filter(([s])=>s.toLowerCase()!=="npm_config_allow_scripts"));o.NPM_CONFIG_ALLOW_SCRIPTS="";try{return((await n(a,e,{cwd:t,encoding:"utf8",env:o,shell:Kg(r)})).stdout??"").trim()}catch(s){let c=typeof s=="object"&&s!==null&&"stderr"in s?String(s.stderr):"",l=c.trim().length>0?c.trim():s instanceof Error?s.message:String(s);throw new y(`npm command failed: ${a} ${e.join(" ")}
|
|
22
|
-
${l}`,_.GENERIC_FAILURE)}}function Yg(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 Xg(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 Zg(e){let n=(e instanceof Error?e.message:String(e)).toLowerCase();return Xg(e)||n.includes("not found")}function Qg(e){let t=e.trim().toLowerCase();return t.startsWith("@unbrained/pm-")||t.startsWith("pm-")}function e_(e){let t=Yg(e),n=Qg(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 t_(e,t){if(!Zg(t))return null;let n=e_(e);return new y(n.message,_.NOT_FOUND,n.context)}async function pd(e){if(P.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")){let t=P.resolve(process.cwd(),e);return await O(t)?t:null}try{let t=new URL(e);if(t.protocol==="file:"){let n=zg(t);return await O(n)?n:null}}catch{}if(!/^[a-z][a-z0-9+.-]*:/i.test(e)){let t=P.resolve(process.cwd(),e);if(await O(t))return t}return null}async function n_(e){let t=await pd(e);if(t)return t;let n=r_(e);return n!==e?n:(/^[a-z][a-z0-9+.-]*:/i.test(e),e)}function r_(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}@${P.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 i_(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:P.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:P.resolve(t,n)}}async function a_(e){return o_(e,md)}async function o_(e,t){let n=await pd(e.spec);if(n){if((await W.stat(n)).isFile()&&fd(n))return hd(n);let s=P.join(n,"package.json"),c=await O(s)?JSON.parse(await W.readFile(s,"utf8")):{};return{directory:await In(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 W.mkdtemp(P.join(Ta.tmpdir(),"pm-npm-package-source-")),i=P.join(r,"pack"),a=P.join(r,"extract");await W.mkdir(i,{recursive:!0}),await W.mkdir(a,{recursive:!0});try{let o=await n_(e.spec),s=await t(["pack",o,"--json","--pack-destination",i]),c=i_(s,i);await $a("tar",["-xzf",c.tarball,"-C",a],{encoding:"utf8"});let l=P.join(a,"package");return await gd(l),{directory:await In(l,e.input),package:c.package,version:c.version,cleanup:async()=>{await W.rm(r,{recursive:!0,force:!0})}}}catch(o){await W.rm(r,{recursive:!0,force:!0});let s=t_(e.spec,o);throw s||o}}function fd(e){let t=e.toLowerCase();return t.endsWith(".tgz")||t.endsWith(".tar.gz")}function et(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 s_(e,t,n){if(e.meta)return;n.entries+=1,n.entries>t.maxEntries&&et(`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===".."))&&et(`Local package archive contains an escaping path: "${r}".`),i[0]!=="package"&&et(`Local package archive entry "${r}" is outside the required package/ root.`),(e.type==="SymbolicLink"||e.type==="Link")&&et(`Local package archive link "${r}" is not supported.`),e.type!=="File"&&e.type!=="OldFile"&&e.type!=="Directory"&&et(`Local package archive entry "${r}" uses unsupported type "${e.type}".`),e.size>t.maxEntryBytes&&et(`Local package archive entry "${r}" exceeds the ${t.maxEntryBytes} byte entry limit.`),n.expandedBytes+=e.size,n.expandedBytes>t.maxExpandedBytes&&et(`Local package archive exceeds the ${t.maxExpandedBytes} expanded byte limit.`),r==="package/package.json"&&(n.packageJsonEntries+=1)}async function hd(e,t=Hg){(await W.stat(e)).size>t.maxArchiveBytes&&et(`Local package archive exceeds the ${t.maxArchiveBytes} archive byte limit.`);let r=await W.mkdtemp(P.join(Ta.tmpdir(),"pm-local-package-archive-")),i=P.join(r,"extract");await W.mkdir(i,{recursive:!0});let a={entries:0,expandedBytes:0,packageJsonEntries:0},o;try{if(await Bg({file:e,strict:!0,maxDecompressionRatio:100,onReadEntry:d=>{if(o===void 0)try{s_(d,t,a)}catch(u){o=u}}}),o!==void 0)throw o;a.packageJsonEntries!==1&&et(`Local package archive must contain exactly one package/package.json entry; found ${a.packageJsonEntries}.`),await Gg({file:e,cwd:i,strict:!0,preservePaths:!1,preserveOwner:!1,noMtime:!0,unlink:!0,maxDepth:64,maxDecompressionRatio:100});let s=P.join(i,"package"),c=P.join(s,"package.json"),l=JSON.parse(await W.readFile(c,"utf8"));return await gd(s),{directory:await In(s,e),package:typeof l.name=="string"?l.name:void 0,version:typeof l.version=="string"?l.version:void 0,cleanup:async()=>{await W.rm(r,{recursive:!0,force:!0})}}}catch(s){throw await W.rm(r,{recursive:!0,force:!0}),s}}async function gd(e,t=md){let n=P.join(e,"package.json");if(!await O(n))return;let r;try{r=JSON.parse(await W.readFile(n,"utf8"))}catch{return}if(typeof r!="object"||r===null)return;let i=r,a=p_(i),o=c_(i);if(a.length===0&&!o)return;let s={...r};delete s.devDependencies;let c={...s};l_(c),await W.writeFile(n,`${JSON.stringify(c,null,2)}
|
|
23
|
-
`,"utf8");try{await Promise.all([W.rm(P.join(e,"package-lock.json"),{force:!0}),W.rm(P.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 d_(e)}finally{await W.writeFile(n,`${JSON.stringify(s,null,2)}
|
|
24
|
-
`,"utf8")}}function c_(e){for(let t of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(typeof t=="object"&&t!==null&&Gr in t)return!0;return!1}function l_(e){for(let t of["dependencies","optionalDependencies","peerDependencies"]){let n=e[t];if(typeof n!="object"||n===null)continue;let r={...n};delete r[Gr],Object.keys(r).length===0?delete e[t]:e[t]=r}}async function d_(e){let t=Ee(import.meta.url,["../../.."]),[n,r]=Gr.split("/"),i=P.join(e,"node_modules",n),a=P.join(i,r);await W.mkdir(i,{recursive:!0}),await W.rm(a,{recursive:!0,force:!0}),await W.symlink(t,a,u_(process.platform))}function u_(e){return e==="win32"?"junction":"dir"}function m_(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{Wg.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 p_(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===Gr||typeof i!="string"||i.trim().length===0||t.has(r))continue;let a=i.trim();t.set(r,m_(r,a))}return[...t.values()]}async function In(e,t){let n=await Zn(e);if(n.length===1)return n[0];if(n.length>1){let r=n.map(i=>P.relative(e,i).replaceAll(P.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 f_(e,t){let n=[];t.subpath&&(n.push(t.subpath),n.push(P.posix.join(".agents/pm/extensions",t.subpath)),n.push(P.posix.join(".custom/pm-extensions",t.subpath)),n.push(P.posix.join(".custom/pm-extension",t.subpath)));for(let i of n){let a=P.resolve(e,i);if(ye(e,a)&&await O(P.join(a,"manifest.json")))return{directory:a,resolved_subpath:i}}if(await O(P.join(e,"manifest.json")))return{directory:e,resolved_subpath:"."};let r=await In(e,t.input);return{directory:r,resolved_subpath:P.relative(e,r).replaceAll(P.sep,"/")}}function h_(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 g_(e){let t=`Local extension source does not exist: "${e.absolute_path}".`,n=e.input.trim();if(!h_(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?P.resolve(a.trim()):"";Ia?.key!==o&&(Ia={key:o,aliases:await qr()}),r=Ia.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 _d(e){if(e.kind==="local"){let r;try{r=await W.stat(e.absolute_path)}catch{throw await g_(e)}if(r.isFile()&&fd(e.absolute_path)){let a=await hd(e.absolute_path);return{source:e,directory:a.directory,source_root:P.dirname(a.directory),resolved_subpath:P.relative(P.dirname(a.directory),a.directory).replaceAll(P.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 In(e.absolute_path,e.input);return{source:e,directory:i,source_root:e.absolute_path}}if(e.kind==="npm"){let r=await a_(e);return{source:e,directory:r.directory,source_root:P.dirname(r.directory),cleanup:r.cleanup,resolved_subpath:P.relative(P.dirname(r.directory),r.directory).replaceAll(P.sep,"/"),npm_package:r.package,npm_version:r.version}}let t=await W.mkdtemp(P.join(Ta.tmpdir(),"pm-extension-source-")),n=["clone","--depth","1"];e.ref&&n.push("--branch",e.ref),n.push(e.repository,t);try{await Wr(n);let r=await Wr(["-C",t,"rev-parse","HEAD"]),i=await f_(t,e);return{source:e,directory:i.directory,source_root:t,resolved_subpath:i.resolved_subpath,commit:r,cleanup:async()=>{await W.rm(t,{recursive:!0,force:!0})}}}catch(r){throw await W.rm(t,{recursive:!0,force:!0}),r}}async function yd(e,t){if(!await O(e)||!await O(t))return!1;let[n,r]=await Promise.all([W.realpath(e),W.realpath(t)]);return n===r}import Cn from"node:fs/promises";import Tn 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]="5321d574-4de4-5f94-99db-0c49639673fc")}catch{}})();var Oa=1,kt="2026.6.24",__=">=22.18.0",y_={fs_read:!1,fs_write:!1,network:!1,env_read:!1,env_write:!1,process_spawn:!1},wd=new Set([...Es.map(e=>e.split("-")[0].toLowerCase()),...Object.keys(Ss).map(e=>e.toLowerCase()),"scaffold"]),w_="^6.0.0",v_="^22.0.0",kd=["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 vd(e,t){return e.map(n=>n===""?n:`${t}${n}`)}function xd(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 Sd(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 b_={compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",strict:!0,esModuleInterop:!0,skipLibCheck:!0,noEmit:!0,allowImportingTsExtensions:!0,resolveJsonModule:!0,types:["node"]},include:["**/*.ts"]},bd=["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"],Ed={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"]},k_={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"]'},x_={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."},S_={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."},Ad="- `tsconfig.json`: strict type-check-only TypeScript config (`noEmit`) for the `.ts` source the loader runs directly.",E_={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."]},A_={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."]},R_={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`."]},I_={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 Rd(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 Id(e,t){return e==="schema"?R_[t]:e==="profile"?I_[t]:A_[t]}function C_(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&&wd.has(i));return`${(wd.has(n)||a?["starter",...t]:t).join(" ")} ping`}function Cd(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({",...Cd(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 $_(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=k_[n],p=e,f=`${e}s`,h=`${e.replace(/-/g,"_")}_note`,g=`${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,"});",""]:[],x=i?Da(e,t,"search",m):[],b=a?Da(e,t,"importers",m):[],S=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 {",...vd(xd({extensionName:e,itemTypeName:p,itemTypeFolder:f,fieldName:h,migrationId:g,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 {",...vd(Sd(e)," ")," const teardown = await ext.deactivate();"," assertExtensionDeactivated(teardown);"," deactivated = true;",...ze,"});",""]:[],R=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,"});",""]:[],A=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";',"",...kd,`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,...x,...b,...S,...k,...R,...T,...A,...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 O_(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 D_={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"},P_={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 N_(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 L_(e,t,n){let r=[],i=[...N_(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({",...Cd(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 M_(e,t,n){let r=L_(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 Da(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 settings = {"," testing: {"," record_results_to_items: false,"," allow_untrusted_linked_tests: false,"," },"," } as PmSettings;"," const query = await ext.runSearchProvider({",` provider: ${JSON.stringify(i)},`,' operation: "query",'," context: {",' query: "sync",',' mode: "semantic",',' tokens: ["sync"],'," options: {},"," settings,"," 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, 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 },"," });",' 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(xd({extensionName:e,itemTypeName:s,itemTypeFolder:c,fieldName:l,migrationId:d})),"});",""];case"profile":return[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,...m(Sd(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 F_(e,t,n){let r=n==="parser",i=JSON.stringify([...Ed[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" };',"",...kd,`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(kt)},`," },",` target: { pmVersion: ${JSON.stringify(kt)} },`," });"," // 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,"});","",...Da(e,t,n,i)].join(`
|
|
27
|
-
`)}function j_(e,t,n){let r=Rd(n,"package"),i=Id(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 (${D_[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`.",Ad,"- `.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 ${P_[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 \`${Oa}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${kt}\`. 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 z_(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 q_(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 W_(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 G_(e,t,n,r="commands",i=!1){let a=`pm-${e}`,o=Ed[r],s=O_(e,t,r),c=`${JSON.stringify({name:e,version:"0.1.0",entry:"./index.ts",manifest_version:Oa,pm_min_version:kt,trusted:!0,sandbox_profile:"strict",permissions:{...y_},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(b_,null,2)}
|
|
31
|
-
`,u=x_[r],m=Rd(r,"package"),p=`${JSON.stringify({name:a,version:"0.1.0",private:!0,type:"module",keywords:["pm-package"],engines:{node:__},scripts:{typecheck:"tsc --noEmit","test:runtime":"node --test",test:"npm run typecheck && npm run test:runtime"},peerDependencies:{"@unbrained/pm-cli":`>=${kt}`},devDependencies:{"@types/node":v_,typescript:w_},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=$_(e,t,r),h=S_[r],g=["node_modules/","*.log","*.tsbuildinfo",""].join(`
|
|
33
|
-
`),w=U_(e),x=["```ts",`import { ${z_(r)} } from "@unbrained/pm-cli/sdk";`,'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"",...q_(e,t,r,w),"","export function activate(api: ExtensionApi): void {"," api.registerCommand(pingCommand);",...W_(t,r,w),"}","","export function deactivate(): void {}","","export default { activate, deactivate };","```"],b=[`# ${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,h,Ad,"- `.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:",...x,"The builders return their argument unchanged; runtime validation still lives","in `api.register*`, and behavior validation lives in `sdk/testing`.",...E_[r],...Id(r,"package"),"","## Compatibility Bounds",`- \`peerDependencies["@unbrained/pm-cli"]\` uses the stable range \`>=${kt}\`. 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 \`${Oa}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${kt}\`. 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?M_(e,t,r):l,"index.test.ts":i?F_(e,t,r):f,"tsconfig.json":d,".gitignore":g,"README.md":i?j_(a,t,r):b}}async function Td(e,t="extension",n="commands",r=!1){let i=n.trim().toLowerCase();if(!bd.includes(i))throw new y(`Unknown scaffold capability "${n}". Supported capabilities: ${bd.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=Tn.resolve(process.cwd(),s),l=Ur(Tn.basename(c)).replace(/^(?:pm-)+/u,""),d=C_(l),u=G_(l,d,t,a,r),m=!1;if(await O(c)){if(!(await Cn.stat(c)).isDirectory())throw new y(`Scaffold target "${c}" exists and is not a directory.`,_.CONFLICT)}else await Cn.mkdir(c,{recursive:!0}),m=!0;for(let[f,h]of Object.entries(u)){let g=Tn.join(c,f);if(!await O(g))continue;if(await Cn.readFile(g,"utf8")!==h)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,h]of Object.entries(u)){let g=Tn.join(c,f);if(await O(g)){p.push({path:f,status:"unchanged"});continue}await Cn.mkdir(Tn.dirname(g),{recursive:!0}),await Cn.writeFile(g,h,"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 $d(e,t){return`${e}:${E(t)}`}function B_(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(E(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 Od(e,t,n){let r=new Set(n.failed.map(l=>$d(l.layer,l.name))),i=[...t.loaded.map(l=>({name:l.name,layer:l.layer,version:l.version,activation_status:r.has($d(l.layer,l.name))?"failed":"ok",surfaces:qt(n,{extensionName:l.name})})),...t.failed.map(l=>({name:l.name,layer:l.layer,version:"unknown",activation_status:"not_loaded",surfaces:qt(n,{extensionName:l.name})}))].sort((l,d)=>l.name.localeCompare(d.name)||l.layer.localeCompare(d.layer)),a=typeof e=="string"?E(e):null,o=a===null?null:new Set(t.loaded.filter(l=>E(l.name)===a||typeof l.source_package=="string"&&E(l.source_package)===a||(l.source_aliases??[]).some(d=>E(d)===a)).map(l=>E(l.name)).concat(a)),s=o===null?i:i.filter(l=>o.has(E(l.name))),c=o===null?{}:{extensionNames:[...o]};return{target:typeof e=="string"?e.trim():null,total:s.length,extensions:s,union:qt(n,c),command_ownership:B_(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 Pa(e){return e.map(({layer:t,name:n,error:r})=>({layer:t,name:n,error:r}))}function Hr(e,t,n){let r=E(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 H_(e){let t=new Map,n=new Map;for(let r of e.registrations.commands)Hr(t,r.name,r.command),Hr(n,r.name,r.action);for(let r of e.commands.handlers)Hr(t,r.name,r.command);for(let r of e.commands.overrides)Hr(t,r.name,r.command);return{commandPathsByExtension:t,actionPathsByExtension:n}}function Dd(e){if(!(!e||e.size===0))return[...e].sort((t,n)=>t.localeCompare(n))}function J_(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=>E(c.name))),i=new Set(t.failed.map(c=>E(c.name))),a=new Set(n.failed.map(c=>E(c.name))),{commandPathsByExtension:o,actionPathsByExtension:s}=H_(n);return e.map(c=>{let l=E(c.name),d=Dd(o.get(l)),u=Dd(s.get(l)),m={...d?{command_paths:d}:{},...u?{action_paths:u}:{}},p=J_({enabled:c.enabled,normalizedName:l,loadedNames:r,loadFailedNames:i,activationFailedNames:a});return{...c,...p,...m}})}function V_(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 le(e,t){return e.vocabulary==="package"?`pm package --${t}`:`pm extension --${t}`}var Ld=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 K_(e){return Ld.has(qd(e))}function Pd(e){return e==="project"||e==="global"}function Md(e){let t=e.split(":"),n=t[0];if(!n||!Ld.has(n))return null;let r=t.at(-4),i=t.at(-3)?.trim(),a=t.at(-2),o=t.at(-1)?.trim();return!Pd(r)||!Pd(a)||!i||!o?null:{code:n,surface:t.slice(1,-4).join(":")||"global",winner:{layer:r,name:i},displaced:{layer:a,name:o}}}function Y_(e){let t=new Set;for(let n of e){let r=Md(n);r&&(t.add(r.winner.name),t.add(r.displaced.name))}return[...t].sort((n,r)=>n.localeCompare(r))}function Na(e,t){let n=e.filter(K_);if(n.length===0)return null;let r=Y_(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 X_(e,t,n,r){let i=t.map(u=>Md(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=le(r,"deactivate"),s=`${le(r,"doctor")} ${a} --detail deep --trace`,c=new Map(n.map(u=>[E(u.name),u])),l=new Map;for(let u of i)for(let m of[u.winner.name,u.displaced.name]){let p=E(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,h=p?.command_paths??[],g=p?.action_paths??[];return{action:"deactivate",extension:f,command:`${o} ${f} ${a}`,affected_collisions:m,feature_loss:{command_paths:[...h].sort((w,v)=>w.localeCompare(v)),action_paths:[...g].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,h=m.feature_loss.command_paths.length+m.feature_loss.action_paths.length;return f!==h?f-h: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 Fd(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 jd(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 Ud(e,t){let n=[];for(let r of Rs(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 Z_=[{matches:e=>e.some(t=>t.startsWith("extension_manifest_")),build:e=>`Run ${le(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: ${Bn.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 ${le(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 ${le(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 ${le(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 ${le(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 ${le(e.options,"doctor")} ${e.scopeFlag}.`},{matches:(e,t)=>t.updateCheckFailedTotal>0,build:e=>`Run ${le(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 Q_(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=Na(t,{deactivate:`${le(n,"deactivate")} <name> ${i}`,doctor:`${le(n,"doctor")} ${i} --detail deep --trace`});p&&u.push(p);for(let f of Z_)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 ${le(n,"manage")} ${i} --fix-managed-state (or ${le(n,"adopt-all")} ${i}, ${le(n,"adopt")} <name> ${i}, or reinstall via ${le(n,"install")} ${i} <source>).`):c>0&&u.push(`Loaded unmanaged extensions are currently treated as informational. Use ${le(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 ${le(n,"install")} ${i} <source>.`),u.length===0&&u.push(`No immediate action required. Re-run ${le(n,"manage")} ${i} after extension changes.`),u}function Vr(e,t,n,r={}){let i=[...new Set(t)].sort((A,U)=>A.localeCompare(U)),a=n.filter(A=>A.managed).length,o=n.filter(A=>A.enabled).length,s=n.filter(A=>A.active).length,c=n.filter(A=>A.update_available===!0).length,l=n.filter(A=>A.managed===!1),d=l.filter(A=>Nd(A)).map(A=>A.name).sort((A,U)=>A.localeCompare(U)),u=l.filter(A=>!Nd(A)).map(A=>A.name).sort((A,U)=>A.localeCompare(U)),m={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(let A of n)m[A.update_check_status]+=1;let p=m.failed,f=m.skipped_unmanaged,h=m.skipped_non_github,g=u.length>0,w=g?"partial":"full",v=g?[`extension_update_health_partial_coverage:skipped_unmanaged:${u.length}`]:[],x=[...new Set([...i,...v])].sort((A,U)=>A.localeCompare(U)),b=[...new Set(x.map(A=>qd(A)))].sort((A,U)=>A.localeCompare(U)),S=V_(x),k=e==="global"?"--global":"--project",R=X_(e,i,n,r),T=Q_({normalizedWarnings:i,options:r,scope:e,scopeFlag:k,updateCheckFailedTotal:p,policyWarningCount:S.warning_count,updateHealthPartial:g,skippedUnmanagedTotal:f,skippedNonGithubTotal:h,updateAvailableTotal:c});return{status:x.length===0?"ok":"warn",warning_count:x.length,warning_codes:b,warnings:x,policy_warning_count:S.warning_count,policy_violation_count:S.violation_count,policy_blocked_count:S.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:g,unmanaged_loaded_extension_count:l.length,unmanaged_loaded_extensions:l.map(A=>A.name).sort((A,U)=>A.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:x.slice(0,8),remediation:T,...R?{collision_plan:R}:{}}}function zd(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 qd(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function $n(e){let t=new Set,n=[];for(let r of e){let i=(()=>{let a=Go(r);return a?[a]:Bo(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 On(){return{version:Hn.version,capabilities:[...Hn.capabilities],legacy_aliases:{...Hn.legacy_aliases}}}function Nd(e){let t=E(e.name),n=E(e.directory);return t.startsWith("builtin-")?!0:n==="beads"||n==="todos"}function Wd(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=>E(d.name)))].sort((d,u)=>d.localeCompare(u)),o=[...new Set(n.filter(d=>d.layer==="project").map(d=>E(d.name)))].sort((d,u)=>d.localeCompare(u)),s=new Set(r.map(d=>E(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 ey}from"node:crypto";import ne from"node:fs/promises";import ty 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 Gd=3,ny=120,Bd=250,ry=12e4,iy=new Set(["EEXIST","ENOTEMPTY","ENOENT"]),Hd=e=>typeof e=="object"&&e!==null&&"code"in e?e.code:void 0,Jd=e=>iy.has(String(Hd(e))),Kr=(e,t)=>Hd(e)===t,Vd=e=>new Promise(t=>{setTimeout(t,e)}),Kd=async e=>{let t=J.join(e,"package.json");await O(t)||await ne.writeFile(t,`${JSON.stringify({type:"module"},null,2)}
|
|
35
|
-
`,"utf8")},Yd=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")},La=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))},Xd=async(e,t,n,r=ty.tmpdir())=>{let i=J.resolve(e),a=await ne.realpath(i).catch(()=>i),o=await La(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 g=J.relative(a,f).split(J.sep);return g.some(w=>w==="node_modules"||w.startsWith(".pm-extension-install-backup-"))?!1:g[0]!==".agents"},c=await ne.realpath(J.resolve(r)).catch(()=>La(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})}},Zd=async(e,t,n=ne.cp)=>{for(let r=1;r<=Gd;r+=1)try{await ne.rm(t,{recursive:!0,force:!0}),await Xd(e,t,n);return}catch(i){if(!Jd(i)||r===Gd)throw i;await Vd(Bd)}},Ma=async e=>{let t;try{t=await ne.readFile(J.join(e,"owner.json"),"utf8")}catch(i){if(!Vn(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},Qd=async(e,t)=>await Ma(e)!==t?!1:(await ne.rm(e,{recursive:!0,force:!0}),!0),ay=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 Ma(e);return r===null?(await ne.rm(e,{recursive:!0,force:!0}),!0):Qd(e,r)},oy=(e,t,n)=>{let r=Promise.resolve(),i=setInterval(()=>{r=r.then(async()=>{if(await Ma(e)!==t)return;let a=new Date;await ne.utimes(e,a,a)}).catch(()=>{})},n);return i.unref(),async()=>{clearInterval(i),await r}},sy=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}},cy=async(e,t,n,r,i)=>{for(let a=1;a<=n;a+=1)try{return await sy(e,t),!0}catch(o){if(!Kr(o,"EEXIST"))throw o;await ay(e,i)?a-=1:await Vd(r)}return!1},Fa=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=ny,delay_ms:s=Bd,stale_ms:c=ry,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:ey(),created_at:$(),destination:t};if(!await cy(a,f,d,u,m))throw new y(`Timed out waiting for extension install lock for "${t}".`,_.CONFLICT);let g=oy(a,f.token,p);try{return await n()}finally{await g(),await Qd(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 eu=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 tu(e,t){let n=E(e),r=t.find(i=>E(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]="e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998")}catch{}})();function nu(e,t){let n=new Set((t?.loaded??[]).flatMap(a=>(a.activation?.commands?.length??0)>0?[`${a.layer}:${E(a.name)}`]:[])),r=e.services.overrides.filter(a=>a.service==="output_format").filter(a=>a.passThrough!==!0).filter(a=>!n.has(`${a.layer}:${E(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 ru=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=nr(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 ly=1e4,dy=(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"}},iu=async(e,t=Wr)=>{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,ly);return dy(i,e.commit,n)}catch(r){return{checked_at:n,available:null,error:r instanceof Error?r.message:String(r)}}};import uy from"node:fs/promises";import my 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 ja(e){return my.join(e,"extension-migrations.json")}function au(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 ou(e,t){return`${e.layer}:${e.name}:${t}`}async function py(e){let t=ja(e);if(!await O(t))return{version:1,updated_at:"",entries:[]};let n=JSON.parse(await uy.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 Ua(e,t){let n=await py(e),r=new Map(n.entries.map(i=>[i.key,i]));return t.forEach((i,a)=>{let o=au(i,a),s=r.get(ou(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 fy(e){let t=await Ua(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=au(d,u),p=ou(d,m),f=n.get(p),h=String(d.definition.status??"pending").toLowerCase(),g=f?.status??(h==="applied"||h==="failed"?h:"pending");if(g==="applied"){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:g,outcome:"skipped"});continue}if(e.dryRun===!0){r.push({key:p,layer:d.layer,extension:d.name,id:m,before:g,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:g,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:g}));let x={key:p,layer:d.layer,extension:d.name,id:m,status:"applied",attempted_at:v};n.set(p,x),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:g,outcome:"applied"}),i=!0}catch(x){let b=x instanceof Error?x.message:String(x),S={key:p,layer:d.layer,extension:d.name,id:m,status:"failed",attempted_at:v,error:b};n.set(p,S),d.definition.status="failed",d.definition.reason=b,r.push({key:p,layer:d.layer,extension:d.name,id:m,before:g,outcome:"failed",error:b}),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 mr({pmRoot:e.pmRoot,filePath:ja(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:ja(e.pmRoot),total:r.length,pending_count:o,applied_count:s,skipped_count:c,failed_count:l,migrations:r}}async function su(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 Le(n);e.warnings.push(...n.warnings,...r.warnings);let i=await fy({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 cu(e,t,n){let r=typeof t=="string"?null:await Rn(e),i=r===null?null:e.trim().toLowerCase(),a=i===null?null:await cd(i),o=Br(r??e,{forceGithub:typeof t=="string",ref:n}),s=i===null?null:await ud(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 xt from"node:fs/promises";import hy 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 za=async e=>xt.readFile(e).catch(t=>{if(Kr(t,"ENOENT"))return null;throw t}),lu=async(e,t,n,r,i)=>{let a=Sn(e),o=ft(t),[s,c]=await Promise.all([za(a),za(o)]);return r&&await xt.cp(n,i,{recursive:!0,force:!0}),{backupDirectory:i,destinationDirectory:n,destinationExists:r,managedStatePath:a,managedStateContents:s,settingsPath:o,settingsContents:c}},du=async e=>{await xt.rm(e.destinationDirectory,{recursive:!0,force:!0}),e.destinationExists&&await xt.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 xt.rm(t,{force:!0}):(await xt.mkdir(hy.dirname(t),{recursive:!0}),await xt.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 gy=4,fu=[["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"]],_y=fu.map(([,,e])=>e).filter((e,t,n)=>n.indexOf(e)===t).join(", "),yy={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"},wy="__pm_native_output",vy=["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"],hu=["allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],by=["disabled","require_trusted","require_provenance"],gu={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:[]},ky=e=>{let t=e??gu,n={};for(let r of vy)n[r]=ke(t[r]??[]);return n},xy=(e,t)=>{for(let n of hu)t[n].length>0&&(e[n]=t[n]);return e},Sy=(e,t)=>{for(let n of by)t[n]===!0&&(e[n]=!0);return t.sandbox_profile&&(e.sandbox_profile=t.sandbox_profile),e},Ey=e=>{let t={};for(let n of hu)t[n]=ke(e[n]??[]);return t},Ay=e=>{let t=typeof e.name=="string"?e.name.trim():"";return t.length===0?null:xy(Sy({name:t},e),Ey(e))},Ry=e=>(e??[]).map(t=>Ay(t)).filter(t=>t!==null).sort((t,n)=>t.name.localeCompare(n.name)),Iy=e=>{let t=Object.assign({},gu,e??{}),n=ky(e),r=Ry(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}},_u=async(e,t)=>{let n=[t],r=await ld(t);r&&n.push(r);let i=[...new Set(n.map(a=>E(a)).filter(a=>a.length>0))];for(let a of i){let o=e.find(c=>E(c.name)===a);if(o)return o;let s=e.find(c=>E(c.directory)===a);if(s)return s}},yu=(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)},wu=(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")},Cy=(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")},$y=e=>{let t=e.trim().toLowerCase(),n=Math.min(2,Math.max(1,Math.ceil(t.length/4))),r=fu.map(([i,a,o])=>({action:a,flag:o,distance:Wo(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},Oy=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=$y(e);if(!r)return new y(`One action flag is required. Use one of: ${_y}. Bare \`pm package\` and \`pm extension\` default to --explore.`,_.USAGE);let i=`pm ${n} ${r.flag}`;return gr({command_path:n,display_name:`${n} lifecycle`,token_kind:"action",token:e,allowed:Object.keys(vu),retry_command:i,message_suffix:`. Did you mean "${r.flag}"?`,fallback_candidates:[{source:"lifecycle_action",command:i,reason:`nearest lifecycle action for "${e}"`}]})},Dy=[["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"]],vu={doctor:"doctor",reload:"reload",catalog:"catalog",init:"init",scaffold:"init",explore:"explore",manage:"manage",migrate:"migrate",list:"explore","":"explore"},Py=e=>vu[e]??null,Ny=(e,t)=>{let n=[...new Set(Dy.filter(([r])=>t[r]===!0).map(([,r])=>r))];if(n.length===0){if(e===void 0)return"explore";let r=Py(e.trim().toLowerCase());if(r)return r;throw Oy(e,t)}if(n.length>1)throw new y("Extension action flags are mutually exclusive.",_.USAGE);return n[0]},Ly=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"},My=[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"}}],bu=e=>{for(let t of My){let n=t(e);if(n)return n}return{status:"not_checked",reason:"no_update_check_recorded"}},ku=(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}},Fy=(e,t,n,r)=>{let i=Object.assign({name:e,manifest_version:"unknown",manifest_entry:"unknown"},r),a=r?yu(n,r.name):!1;return{warning:`extension_manifest_missing:${t}:${e}`,summary:ku({name:i.name,directory:e,version:i.manifest_version,entry:i.manifest_entry,enabled:a},t,r,bu(r))}},jy=async(e,t,n,r,i,a)=>{let o=Ie.join(e,t),s=Ie.join(o,"manifest.json"),c=a.get(E(t));if(!await O(s))return Fy(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=Sa(d);if(!u)return{warning:`extension_manifest_invalid:${n}:${t}`};let m=i.get(E(u.name))??a.get(E(t));return{summary:ku({name:u.name,directory:t,version:u.version,entry:u.entry,enabled:yu(r,u.name)},n,m,bu(m))}},qe=async(e,t,n,r)=>{if(!await O(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=>[E(d.name),d])),s=new Map(r.entries.map(d=>[E(d.directory),d])),c=[],l=[];for(let d of a){let u=await jy(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=$s(),zy=(e,t)=>[t.package,t.kind==="builtin"?t.name:void 0].find(n=>n?.trim())?.trim()??e,qy=(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:zy(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"}:{}}},Wy=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},xu=e=>e.map(t=>Wy(t)).sort((t,n)=>`${t.layer}:${t.name}`.localeCompare(`${n.layer}:${n.name}`)),Su=(e,t,n)=>{let r=E(e);return t.find(i=>(n===void 0||i.layer===n)&&E(i.name)===r)},Gy=(e,t,n,r)=>n.find(a=>a.scope===t&&E(a.name)===E(e))?.activation_status??(r?"failed":"unknown"),Eu=(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:Ri(),cache_bust:!0,module_graph_snapshot_root:o}),c=await Le({...s}),l=[...s.failed.map(u=>({layer:u.layer,name:u.name,entry_path:u.entry_path,error:u.error})),...xu(c.failed)],d=Object.fromEntries(s.loaded.map(u=>[E(u.name),as(qt(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}}),Wa=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 Jt(l),u=$(),m={kind:"local",input:c.name,location:l};o=An(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 bt(e,o),{state:o,adopted_entries:s,unmanaged_candidates:a,already_managed_count:n.length-i.length}},By=(e,t)=>{let n=F(process.cwd(),t.path),r=At(n,process.cwd()),i=e==="global"?Kn(process.cwd()):n,a=e==="global"?r.global:r.project;return{pm_root:n,scope:e,settings_root:i,selected_root:a,roots:r}},Yr=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]},Hy=e=>yy[e],Jy=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",r=e==="install"?"source":"name",i=`${n} ${r}`,a=Hy(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`}]}})},Xr=(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 Jy(t,n)},Vy=(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}:${E(r.name)}`));return e.loaded.filter(r=>(r.activation?.commands??[]).length>0).filter(r=>n.has(`${r.layer}:${E(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))},Ky=(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)},Yy=(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},Xy=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},Zy=(e,t,n)=>{let r={ok:n,action:e.action,scope:e.scope,roots:Xy(e),warnings:[...new Set(e.warnings)].sort((i,a)=>i.localeCompare(a)),details:t};return e.action==="doctor"&&Object.defineProperty(r,wy,{value:!0,enumerable:!1,configurable:!1}),r},Ga=async(e,t,n)=>{let r=Ny(e,t);Ky(r,t);let i=Yy(e,r,t),a=Ly(t),o=By(a,n),c={action:r,normalizedTarget:i,scope:a,resolvedRoots:o,warnings:[],options:t,global:n},d={...c,withResult:(u,m=!0)=>Zy(c,u,m)};return await $w(d)},Qy=(e,t)=>{let n=t.vocabulary??"extension",r=e.target_path.replace(/\\/g,"/"),i=Is(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: ${Cs(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`]},ew=async e=>{let{action:t,normalizedTarget:n,options:r,withResult:i}=e;if([Yr(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=Xr(n,t,r),c=await Td(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:Qy(c,r)})},tw=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=Ri(),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 Le(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)},nw=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 dd(n,i,r))},rw=(e,t)=>({kind:"builtin",input:e,location:e,name:e,...t===null?{}:{package:t}}),iw=e=>({kind:"local",input:e.input,location:e.absolute_path}),aw=(e,t)=>({kind:"npm",input:e.input,location:t.resolved_subpath??".",package:t.npm_package,version:t.npm_version}),ow=(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}),sw=(e,t,n,r)=>e?rw(e,t):n.kind==="local"?iw(n):n.kind==="npm"?aw(n,r):ow(n,r),cw=(e,t,n,r)=>e?e.manifest_version!==t?{installed_at:e.installed_at,updated_at:r}:rd(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},lw=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 O(l),u=await yd(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 lu(r.selected_root,r.settings_root,l,d,p),h=sw(t.bundledAliasName,t.bundledPackageName,t.installSource,t.resolvedSource),g=c.state.entries.find(b=>E(b.name)===E(a.manifest.name)),w=cw(g,a.manifest.version,h,$()),v=An(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:h}),x=wu(s,a.manifest.name);try{u||await Zd(a.directory,l),await Kd(l),await Yd(l),await bt(r.selected_root,v),x&&await pr(r.settings_root,s,"settings:write")}catch(b){try{await du(f)}catch(S){throw new AggregateError([b,S],`Extension install failed: ${String(b)}; rollback failed: ${String(S)}`,{cause:S})}throw b}return{settings:s,managedState:v,sourceRecord:h,destinationDirectory:l,destinationExists:d,installInPlace:u,activationChanged:x}}finally{await lt.rm(m,{recursive:!0,force:!0}).catch(()=>{})}},dw=async(e,t,n)=>{let r=n.filter(i=>E(i.name)===E(t)).flatMap(i=>i.types.map(a=>({name:a.name,folder:a.folder})));return e.scope==="project"&&r.length>0&&await kn(e.resolvedRoots.pm_root,r,e.warnings,"install:type-folder"),r},uw=(e,t,n,r,i)=>{let a=Su(t,n.activation_failures,e.scope),o=Gy(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)]}}},mw=async(e,t)=>{let{scope:n,resolvedRoots:r,warnings:i,global:a,withResult:o}=e,{validated:s,destinationDirectoryName:c}=t,l=await lw(e,t),d=await qe(r.selected_root,n,l.settings,l.managedState);i.push(...d.warnings);let u=await Eu(r.pm_root,Ie.dirname(r.selected_root),l.settings,d.extensions,a);i.push(...u.warnings);let m=await dw(e,s.manifest.name,u.item_type_registrations),p=tu(s.manifest.name,u.installed),f=uw(e,s.manifest.name,u,p,m),h=u.contribution_inventories[E(s.manifest.name)];return h&&(l.managedState=await id(r.selected_root,l.managedState,s.manifest.name,h)),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:h,command_discovery:qy(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)},pw=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 qr()){let l=await Rn(c),d=Ie.resolve(l),u=o.get(d);u===void 0&&(u=await Ga(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)},fw=async(e,t,n)=>{let{resolvedRoots:r}=e,{bundledAliasName:i,bundledPackageName:a,installSource:o,sourceResolution:s}=await cu(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 _d(o);try{let l=await Jt(c.directory,{source_kind:o.kind,source_input:o.input,source_root:c.source_root}),d=Ur(l.manifest.name);return await Fa(r.settings_root,d,()=>mw(e,{validated:l,destinationDirectoryName:d,bundledAliasName:i,bundledPackageName:a,sourceResolution:s,installSource:o,resolvedSource:c}))}finally{c.cleanup&&await c.cleanup()}},hw=async e=>{let t=Yr(e.options),n=t??Xr(e.normalizedTarget,e.action,e.options);return[t===void 0,od(n)].every(Boolean)?pw(e):fw(e,n,t)},gw=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(Yr(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 Wa(r.selected_root,n,d.extensions,l.state),m=await qe(r.selected_root,n,c,u.state);i.push(...m.warnings);let p=Vr(n,i,m.extensions,a);i.push(...p.warnings);let f=new Map(m.extensions.map(w=>[`${E(w.name)}:${E(w.directory)}`,w])),h=new Map(m.extensions.map(w=>[E(w.directory),w])),g=u.adopted_entries.map(w=>{let v=E(w.directory),x=f.get(`${E(w.name)}:${v}`)??h.get(v);return{...w,...Au(x)}});return o({adopted_all:g.length>0,adopted_count:g.length,already_managed_count:u.already_managed_count,extensions:g,triage:p,warning_codes:p.warning_codes,update_health_partial:p.update_health_partial,update_health_coverage:p.update_health_coverage})},Au=e=>({update_check_status:e?.update_check_status??null,update_check_reason:e?.update_check_reason??null}),_w=(e,t,n,r)=>{if(e===void 0)return{kind:"local",input:t,location:n};let i=Br(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}},yw=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o,withResult:s}=e,c=Xr(n,t,o),l=Yr(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 _u(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),h=await Jt(f),g=$(),w=_w(l,c,f,o.ref),v=An(u.state,{name:h.manifest.name,directory:p.directory,scope:r,manifest_version:h.manifest.version,manifest_entry:h.manifest.entry,capabilities:[...h.manifest.capabilities],contributions:h.manifest.contributions,installed_at:g,updated_at:g,source:w});await bt(i.selected_root,v);let x=await qe(i.selected_root,r,d,v);a.push(...x.warnings);let b=x.extensions.find(S=>E(S.name)===E(h.manifest.name))??x.extensions.find(S=>E(S.directory)===E(p.directory));return s({adopted:!0,extension:{name:h.manifest.name,directory:p.directory,version:h.manifest.version,entry:h.manifest.entry},source:w,...Au(b)})},Ru=async e=>{let{action:t,normalizedTarget:n,scope:r,resolvedRoots:i,warnings:a,options:o}=e,s=Xr(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 _u(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}},ww=async e=>{let{resolvedRoots:t,withResult:n}=e,{settings:r,managedStateRead:i,candidate:a}=await Ru(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=>E(l.name)!==E(a.name)&&E(l.directory)!==E(a.directory))};await bt(t.selected_root,s);let c=Ty(r,a.name);return c&&await pr(t.settings_root,r,"settings:write"),n({removed:!0,extension:{name:a.name,directory:a.directory},destination_path:o,settings_changed:c})},uu=async e=>{let{action:t,resolvedRoots:n,warnings:r,global:i,withResult:a}=e,{settings:o,candidate:s}=await Ru(e),c=t==="activate"?wu(o,s.name):Cy(o,s.name);c&&await pr(n.settings_root,o,"settings:write");let l=t==="activate"?await Eu(n.pm_root,Ie.dirname(n.selected_root),o,[s],i).then(d=>(r.push(...d.warnings),Su(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)},vw=(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))]},qa=e=>e.loaded.some(t=>t.layer==="global")||e.failed.some(t=>t.layer==="global")||e.warnings.some(t=>t.includes(":global:")),bw=(e,t,n,r)=>{if(e!=="project"||t||!qa(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.`},kw=(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=zd(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}},xw=async(e,t,n)=>{if(e.options.fixManagedState!==!0)return{state:n,fix:null};let r=await Wa(e.resolvedRoots.selected_root,e.scope,t,n);return{state:r.state,fix:r}},Sw=(e,t,n,r)=>{let i=n==="package"?"package":"extension";if(e!=="project")return{isolated:t,global_extensions_included:!1,global_diagnostics_present:qa(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:qa(r),rerun_command:t?null:a,pm_global_path_recipe:`PM_GLOBAL_PATH=$(mktemp -d) pm ${i} doctor --project --detail deep --trace`}},Ew=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:r,warnings:i,options:a,global:o,withResult:s}=e,{isolated:c,detailMode:l,includeTrace:d}=kw(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:h}=await xw(e,p.extensions,m.state),g=await qe(r.selected_root,n,u,f);i.push(...g.warnings);let w=await Ne({pmRoot:r.pm_root,settings:u,cwd:process.cwd(),noExtensions:o.noExtensions===!0,ignoreGlobalExtensions:c}),v=await Le({...w,loaded:w.loaded});i.push(...w.warnings),i.push(...Fd(w.failed)),i.push(...v.warnings),i.push(...jd(v.failed)),i.push(...Ud(w,v)),i.push(...nu(v,w)),i.push(...Vy(w,v)),i.push(...ru(v));let x=Jr(g.extensions,w,v),b=Wd(n,x,w.loaded.map(M=>({layer:M.layer,name:M.name})),w.failed.map(M=>({name:M.name})),w.disabled_by_flag);i.push(...b.warnings);let S=x.filter(M=>M.update_check_status==="failed").map(M=>`extension_update_check_failed:${M.name}`);i.push(...S);let k=Vr(n,i,x,a);i.push(...k.warnings);let R=[...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},A=$n(R),U=On(),B=k.warning_codes,N=bw(n,c,a.vocabulary,w),G=vw(k.remediation,w.failed.length,v.failed.length,a.vocabulary,h,N),_e=Sw(n,c,a.vocabulary,w),me={status:k.status,scope:n,warning_count:k.warning_count,warning_codes:B,total_extensions:x.length,managed_total:x.filter(M=>M.managed).length,enabled_total:x.filter(M=>M.enabled).length,active_total:x.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:x.filter(M=>M.runtime_active===!0).length,activation_status_totals:{ok:x.filter(M=>M.activation_status==="ok").length,failed:x.filter(M=>M.activation_status==="failed").length,not_loaded:x.filter(M=>M.activation_status==="not_loaded").length,unknown:x.filter(M=>M.activation_status==="unknown").length},unknown_capability_count:A.length,capability_contract_version:U.version,update_available_total:x.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:x.filter(M=>M.update_check_status==="failed").length,load_failure_count:w.failed.length,activation_failure_count:v.failed.length,load_failures:Pa(w.failed),activation_failures:Pa(v.failed),blocking_failure_count:w.failed.length+v.failed.length,has_blocking_failures:w.failed.length+v.failed.length>0,consistency_warning_count:b.warnings.length,trace_enabled:d,isolation:_e,policy:T,remediation:G},Be=h?{requested:!0,applied:h.adopted_entries.length>0,adopted_count:h.adopted_entries.length,already_managed_count:h.already_managed_count,adopted_extensions:h.adopted_entries.map(M=>M.name)}:{requested:!1,applied:!1,adopted_count:0,already_managed_count:g.extensions.filter(M=>M.managed).length,adopted_extensions:[]},Pe={mode:l,summary:me,triage:k,trace_enabled:d,capability_contract:U,capability_guidance:A,managed_state_fix:Be,isolation:_e,policy:w.policy};if(l==="deep"){let M=d?v.failed:v.failed.map(H=>{let{trace:ki,...xi}=H;return xi});Pe.deep={warnings:R,warning_codes:B,capability_contract:U,capability_guidance:A,trace_enabled:d,managed_state:{path:m.path,count:f.entries.length,entries:f.entries},installed_extensions:x,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:b.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)},Aw=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 Le(l);i.push(...l.warnings),i.push(...d.warnings);let u=Od(t,l,d);if(t!==void 0&&u.extensions.length===0){let m=a.vocabulary==="package"?"package":"extension",p=[...new Set(l.loaded.map(h=>a.vocabulary==="package"&&typeof h.source_package=="string"&&h.source_package.trim().length>0?h.source_package.trim():h.name))].sort((h,g)=>h.localeCompare(g)),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})},Rw=async(e,t,n)=>{let r=n,i=null;if([e.action==="manage",e.options.fixManagedState===!0].every(Boolean)&&(i=await Wa(e.resolvedRoots.selected_root,e.scope,t,n),r=i.state),e.action==="manage"){let a=await eu(r.entries,gy,async o=>{if(o.source.kind!=="github")return o;let s=await iu(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:En(a)},await bt(e.resolvedRoots.selected_root,r)}return{state:r,fix:i}},Iw=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 Le({...r,loaded:r.loaded});return e.warnings.push(...r.warnings,...i.warnings),{installed:Jr(n,r,i),failures:xu(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}}},Cw=(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},mu=async e=>{let{action:t,scope:n,resolvedRoots:r,warnings:i,options:a,withResult:o}=e,s=await I(r.settings_root),c=Iy(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 Rw(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(x=>x.update_check_status==="failed").map(x=>`extension_update_check_failed:${x.name}`);i.push(...v)}let f=await Iw(e,s,p.extensions),h=f.installed,g=Vr(n,i,h,a);i.push(...g.warnings);let w={total:h.length,managed_total:h.filter(v=>v.managed).length,enabled_total:h.filter(v=>v.enabled).length,active_total:h.filter(v=>v.active).length,extensions:h,triage:g,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=Cw(m,h)),o(w)},pu={init:ew,install:hw,uninstall:ww,explore:mu,manage:mu,describe:Aw,reload:tw,doctor:Ew,catalog:nw,adopt:yw,"adopt-all":gw,activate:uu,deactivate:uu,migrate:su},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),$w=e=>Tw(e)?Fa(e.resolvedRoots.settings_root,`${e.action}-state`,()=>pu[e.action](e)):pu[e.action](e);import{execFile as Ow}from"node:child_process";import{realpath as Dw}from"node:fs/promises";import Iu from"node:path";import{promisify as Pw}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 Nw=Pw(Ow),Lw=32*1024*1024,Mw=1e4,Fw=["search/eval-queries.json"];function Ba(e){return e.replaceAll("\\","/").replace(/\/+$/,"")}function jw(e){return`'${e.replaceAll("'","'\\''")}'`}async function Uw(e,t=Dw){return t(e).catch(()=>Iu.resolve(e))}async function Zr(e){let t=await yt(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=Ba(Iu.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=ca.map(a=>`${r}/${Ba(a)}`);try{let{stdout:a}=await Nw("git",["ls-files","-z","--",...i.map(l=>`:(literal)${l}`)],{cwd:t,encoding:"utf8",maxBuffer:Lw,windowsHide:!0,timeout:Mw}),o=new Set(Fw.map(l=>`${r}/${l}`)),s=[...new Set(a.split("\0").filter(l=>l.length>0&&!o.has(Ba(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=>jw(`:(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 zw}from"node:child_process";import{randomUUID as qw}from"node:crypto";import{readdir as Ww,readFile as $u}from"node:fs/promises";import Se from"node:path";import{promisify as Gw}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 Bw=Gw(zw);async function Ha(e){try{let{stdout:t}=await Bw("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 Ou(e,t){let n=Se.dirname(Se.resolve(e,t));for(let r=0;r<12;r+=1){if(await O(Se.join(n,"settings.json")))return n;let i=Se.dirname(n);if(i===n)break;n=i}return null}function Ja(e){return Se.join(e,"merge-receipts")}function Qr(e){return`${e}.json`}function Hw(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:Cu(t.retained)??sn(re(t.retained)),discarded_hash:Cu(t.discarded)??sn(re(t.discarded))}))}}function Cu(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 F$(e){let t=await Ha(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:qw(),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 an(t),await ie(Se.join(t,Qr(a.id)),`${JSON.stringify(a,null,2)}
|
|
38
|
-
`);let o=await Ou(e.cwd,a.item_path);if(o!==null){let s=Ja(o),c=Hw(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 an(s),await ie(Se.join(s,Qr(a.id)),`${JSON.stringify(l,null,2)}
|
|
39
|
-
`)}return a}async function Tu(e,t){if(!await O(e))return[];let n;try{n=await Ww(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 $u(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 Dn(e,t={}){let n=await Ha(e),r=n===null?[]:await Tu(n,t),i=t.pmRoot??Se.join(e,".agents","pm"),a=await Tu(Ja(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 ei(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 j$(e,t){let n=await Ha(e);if(n===null)return;await ie(Se.join(n,Qr(t.id)),`${JSON.stringify({...t,state:"reconciled",reconciled_at:$()},null,2)}
|
|
40
|
-
`);let r=await Ou(e,t.item_path);if(r!==null){let i=Se.join(Ja(r),Qr(t.id));if(await O(i)){let a=JSON.parse(await $u(i,"utf8"));await ie(i,`${JSON.stringify({...a,state:"reconciled",reconciled_at:$()},null,2)}
|
|
41
|
-
`)}}}async function U$(e){let t=await Dn(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]="f7b3ff92-1fc7-55e9-aa76-af956714998f")}catch{}})();var Jw=new Set(pc),Pu=25,Kt=8,Pn=100,Vw=fe.join("runtime","telemetry","events.jsonl"),Kw=fe.join("runtime","telemetry","state.json"),Yw=2500,Xw=500,Nu=mc-3,Zw=["x-pm-telemetry-max-schema-version","x-pm-telemetry-max-version"];function Qa(e,t=!1){return e.startsWith("telemetry_")||e.startsWith("history_stream_over_compact_threshold:")||e.startsWith("integrity_legacy_hierarchy_")||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 eo(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function Yt(e){return e.trim().toLowerCase()}function Ya(e,t){let n=Yt(e),r=Yt(t);return n.startsWith("builtin-")?!0:r==="beads"||r==="todos"}async function to(e){try{return(await tt.stat(e)).isDirectory()}catch{return!1}}async function Qw(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=>on.some(a=>i.name.endsWith(a))).map(i=>fe.parse(i.name).name)))}async function ev(e,t,n,r){let i=await Je({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 tv(e,t,n){let r=fe.join(e,"history");if(!await to(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 ev(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 Xa(e,t){return fe.relative(e,t).replaceAll("\\","/")}async function Lu(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)on.some(c=>s.toLowerCase().endsWith(c))&&r.push(fe.join(a,s))}return r.sort((i,a)=>Xa(e,i).localeCompare(Xa(e,a))),r}function nv(e){return!(typeof e=="object"&&e!==null&&"code"in e&&j(e))}async function rv(e,t,n){let r=await Lu(e,t),i=[],a=[],o=[],s=[],c=Et(z());for(let l of r){let d=Xa(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=Ot(u,{format:Qo(l),schema:n,extensionFieldNames:c});s.push({ref:d,version:or(p.metadata)})}catch{o.push(d)}}return{paths:r,unreadable:i,conflictMarkers:a,parseFailures:o,formatVersions:s}}async function iv(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){nv(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}}function Mu(e){return[...e.cycles.map(t=>t.legacy_terminal?`integrity_legacy_hierarchy_cycle:${t.item_ids.join(",")}`:`integrity_hierarchy_cycle:${t.item_ids.join(",")}`),...e.cardinality_violations.map(t=>t.legacy_terminal?`integrity_legacy_hierarchy_cardinality:${t.child_id}`:`integrity_hierarchy_cardinality:${t.child_id}`),...e.divergences.map(t=>t.legacy_terminal?`integrity_legacy_hierarchy_divergence:${t.child_id}`:`integrity_hierarchy_divergence:${t.child_id}`)]}async function av(e,t,n,r,i){let a=await rv(e,t,n),o=await iv(e),s=sr(a.formatVersions),c=$e(n),l=vr(i,b=>Ms(b,c),un()),d=await Zr(e),u=await yt(e),m=u===null?null:await Lr(u),p=u===null?[]:await Dn(u,{includeLossless:!0,pmRoot:e}),{pendingDecisions:f,lossless:h}=ei(p),g=m?.status==="missing"&&m.missing_keys.length===5&&m.drifted_keys.length===0,w=[...a.unreadable.map(b=>`integrity_item_unreadable:${b}`),...a.conflictMarkers.map(b=>`integrity_item_conflict_marker:${b.path}:L${b.line}`),...a.parseFailures.map(b=>`integrity_item_parse_failed:${b}`),...o.unreadable.map(b=>`integrity_history_unreadable:${b}`),...o.conflictMarkers.map(b=>`integrity_history_conflict_marker:${b.id}:L${b.line}`),...o.invalidJson.map(b=>`integrity_history_invalid_json:${b.id}:L${b.line}`),...s.outdated.map(b=>`integrity_item_outdated_format_version:${b}`),...s.ahead.map(b=>`integrity_item_ahead_format_version:${b}`),...Mu(l),...d.tracked_path_count>0?[`tracked_runtime_cache_files:${d.tracked_path_count}`]:[],...m!==null&&m.status!=="ok"?[`merge_driver_configuration_${g?"missing":"drift"}:${m.missing_keys.length+m.drifted_keys.length}`]:[],...f.length>0?[`merge_decisions_unreviewed:${f.length}`]:[]],v=[...new Set(w)].sort((b,S)=>b.localeCompare(S)),x=v.filter(b=>!b.startsWith("integrity_legacy_hierarchy_"));return{check:{name:"integrity",status:x.length===0?"ok":"warn",ok:x.length===0,details:{checked_item_files:a.paths.length,checked_history_streams:o.files.length,counts:{item_unreadable:a.unreadable.length,item_conflict_markers:a.conflictMarkers.length,item_parse_failures:a.parseFailures.length,history_unreadable:o.unreadable.length,history_conflict_markers:o.conflictMarkers.length,history_invalid_json:o.invalidJson.length,item_outdated_format_version:s.outdated.length,item_ahead_format_version:s.ahead.length,hierarchy_cycles:l.cycles.length,hierarchy_cardinality_violations:l.cardinality_violations.length,hierarchy_parent_divergences:l.divergences.length,tracked_runtime_cache_files:d.tracked_path_count,merge_driver_configuration:m===null||m.status==="ok"?0:m.missing_keys.length+m.drifted_keys.length,pending_merge_decisions:f.length,lossless_merge_receipts:h.length},item_unreadable:a.unreadable,item_conflict_markers:a.conflictMarkers,item_parse_failures:a.parseFailures,item_outdated_format_version:s.outdated,item_ahead_format_version:s.ahead,hierarchy_integrity:{...l,relations:We(l.relations,Kt)},history_unreadable:o.unreadable,history_conflict_markers:o.conflictMarkers,history_invalid_json:o.invalidJson,tracked_runtime_cache:{tracker_relative_root:d.tracker_relative_root,tracked_paths:d.tracked_paths,tracked_path_count:d.tracked_path_count,remediation_command:d.remediation_command},merge_driver_configuration:m===null?null:{...m,required:r},pending_merge_decision_items:[...new Set(f.map(b=>b.item_id))].sort((b,S)=>b.localeCompare(S)),lossless_merge_receipt_items:[...new Set(h.map(b=>b.item_id))].sort((b,S)=>b.localeCompare(S))}},warnings:v}}function ov(e){if(typeof e.activate=="function")return!0;let t=e.default;return typeof t!="object"||t===null?!1:typeof t.activate=="function"}function sv(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:ov(e.module)};return Array.isArray(e.capabilities)&&(t.capabilities=[...e.capabilities]),t}function cv(e,t){let n=X(e.id);return n||`migration-${String(t+1).padStart(3,"0")}`}function lv(e){let n=X(e.status)?.toLowerCase();return n==="failed"?"failed":n==="applied"?"applied":"pending"}function dv(e){return X(e.reason)??X(e.error)??X(e.message)}function Va(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 uv(e){let t=[],n=[],r=[];e.forEach((a,o)=>{let s=cv(a.definition,o),c=lv(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:dv(a.definition)});return}n.push({layer:a.layer,name:a.name,id:s,status:c})}),t.sort(Va),n.sort(Va),r.sort(Va);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 Fu(e,t,n,r,i,a,o,s,c){let l=[...new Set(e)].sort((g,w)=>g.localeCompare(w)),d=[...new Set(l.map(g=>eo(g)))].sort((g,w)=>g.localeCompare(w)),u=l.filter(g=>g.startsWith("extension_capability_unknown:")).length,m=c.length>0,p=m?"partial":"full",f=[],h=Na(l,{deactivate:"pm extension --deactivate <name> --project/--global",doctor:"pm extension --doctor --project/--global --detail deep --trace"});return h&&f.push(h),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: ${Bn.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`),l.some(g=>g.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(g=>g.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 mv(e,t,n){let r=await Ne({pmRoot:e,settings:t,cwd:process.cwd(),noExtensions:n}),i=r.loaded.map(k=>sv(k)),a=await qc(r.loaded,pt(e)),o=await Le({...r,loaded:r.loaded}),[s,c]=await Promise.all([pe(r.roots.project),pe(r.roots.global)]);await Ua(e,o.registrations.migrations);let l=uv(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=>Yt(k.name))),m=new Set(c.state.entries.map(k=>Yt(k.name))),p=[...new Map(r.loaded.filter(k=>!(k.layer==="project"?u:m).has(Yt(k.name))).map(k=>[`${k.layer}:${k.name}`,{layer:k.layer,name:k.name,directory:k.directory}])).values()].sort((k,R)=>{let T=`${k.layer}:${k.name}`,A=`${R.layer}:${R.name}`;return T.localeCompare(A)}),f=p.map(k=>`${k.layer}:${k.name}`).sort((k,R)=>k.localeCompare(R)),h=p.filter(k=>Ya(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,R)=>k.localeCompare(R)),g=p.filter(k=>!Ya(k.name,k.directory)).map(k=>`${k.layer}:${k.name}`).sort((k,R)=>k.localeCompare(R)),w=g.length>0?[`extension_update_health_partial_coverage:skipped_unmanaged:${g.length}`]:[],v=[...r.warnings,...d.warnings,...l.warnings,...s.warnings,...c.warnings,...w,...a.warnings],x=$n(v),b=On(),S=Fu(v,r.failed.length,o.failed.length,l.summary,s.warnings.length+c.warnings.length,s.state.entries.length+c.state.entries.length,f,h,g);return{check:{name:"extensions",status:v.length===0?"ok":"warn",ok:v.length===0,details:{...r,loaded:i,warnings:v,activation:d,triage:S,...l.summary.pending_count>0?{remediation_map:{extension_migration_pending:"pm extension migrate --project"}}:{},capability_contract:b,capability_guidance:x,host_version_census:a}},warnings:v}}function pv(e,t){return e.length<=t?{values:e,truncated:!1}:{values:e.slice(0,t),truncated:!0}}function We(e,t){return Array.isArray(e)?{count:e.length,sample:e.slice(0,t),truncated:e.length>t}:{count:0,sample:[],truncated:!1}}function fv(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 ti(e,t){let n=We(e,t);return{...n,sample:n.sample.map(r=>fv(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 hv(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 gv={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:ti(e.discovered,t),effective:ti(e.effective,t),loaded:ti(e.loaded,t),failed:We(e.failed,t),warnings:V(e.warnings,t),activation:{failed:We(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:hv(n.migration_status)},triage:e.triage,capability_contract:e.capability_contract,capability_guidance:We(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:We(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:We(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:We(e.history_conflict_markers,t),history_invalid_json:We(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 ju(e,t){let n=gv[e.name];return n?n(e.details,t):e.details}function _v(e){let t=V(e.warnings,Kt);return{ok:e.ok,checks:e.checks.map(n=>({name:n.name,status:n.status,ok:n.ok,details:ju(n,Kt)})),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:Kt},generated_at:e.generated_at}}function Du(e){return e.details.skipped===!0}function yv(e){let t=V(e.warnings,Kt),n=e.checks.filter(Du).map(r=>r.name);return{ok:e.ok,checks:e.checks.filter(r=>!Du(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:Kt,omitted_checks:n},generated_at:e.generated_at}}function Za(e,t){if(t)return{values:e,truncated:!1,total:e.length};let n=pv(e,Pu);return{values:n.values,truncated:n.truncated,total:e.length}}function Vt(e){let t=(process.env[e]??"").trim().toLowerCase();return t==="1"||t==="true"||t==="yes"||t==="on"}function wv(){let e=(process.env.PM_TELEMETRY_SOURCE_CONTEXT??"").trim().toLowerCase();return Jw.has(e)?e:null}function ni(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 Uu(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>=Nu&&(i+=1)}else n+=1}catch{n+=1}}}return{validEntries:t,invalidRows:n,totalRows:r,highRetryEntries:i,maxAttempts:a}}function vv(){return{validEntries:0,invalidRows:0,totalRows:0,highRetryEntries:0,maxAttempts:0}}function bv(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 kv(e,t){let n=e.telemetry.endpoint.trim();return!t||!e.telemetry.enabled||n.length===0?void 0:{attempted:!0,...await zu(n)}}function xv(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>=Xw;return(o||s||c)&&r.push(`telemetry_queue_pending:${t.validEntries}`),t.highRetryEntries>0&&r.push(`telemetry_queue_high_retries:${t.highRetryEntries}`),r}function Sv(e){return!e||e.ok!==!1?[]:typeof e.status=="number"?[`telemetry_endpoint_probe_http_status:${e.status}`]:["telemetry_endpoint_probe_failed"]}function Ev(e){let t=Number.parseInt(e?.max_schema_version??"",10);return e?.ok===!0&&Number.isInteger(t)&&t>uc?[`telemetry_schema_version_behind:${t}`]:[]}function Av(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 Rv(){return{telemetry_disabled:Vt("PM_TELEMETRY_DISABLED")||Vt("PM_NO_TELEMETRY"),pm_no_telemetry:Vt("PM_NO_TELEMETRY"),telemetry_otel_disabled:Vt("PM_TELEMETRY_OTEL_DISABLED"),telemetry_inline_flush:Vt("PM_TELEMETRY_INLINE_FLUSH"),telemetry_source_context:wv()}}function Iv(e,t){return e.telemetry.enabled&&t.validEntries>0}function Cv(e,t){return e&&t.every(n=>!n.startsWith("telemetry_queue_pending:")&&!n.startsWith("telemetry_queue_high_retries:"))}async function zu(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(Yw)});return{probe_url:ni(t),ok:n.ok,status:n.status,max_schema_version:(()=>{for(let r of Zw){let i=n.headers.get(r)?.trim();if(i&&i.length>0)return i}})()}}catch(n){return{probe_url:ni(t),ok:!1,error:n instanceof Error?n.message:"probe_failed"}}}async function Tv(e,t){let n=Kn(process.cwd()),r=fe.join(n,Vw),i=fe.join(n,Kw),a=await Y(r),o=a!==null,s=a?Buffer.byteLength(a,"utf8"):0,c=a?Uu(a):vv(),l=await Y(i),{runtimeState:d,stateParseFailed:u}=bv(l),m=e.telemetry.endpoint.trim(),p=ni(m),f=await kv(e,t.checkTelemetry),h=[];u&&h.push("telemetry_state_invalid_json"),h.push(...xv(e,c,d),...Sv(f),...Ev(f),...Av(e,d));let g=Iv(e,c),w=typeof d.pending_otel_spans=="number"?d.pending_otel_spans:0;return{check:{name:"telemetry",status:h.length===0?"ok":"warn",ok:h.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:Cv(g,h),queue_invalid_rows:c.invalidRows,queue_rows_total:c.totalRows,queue_size_bytes:s,queue_high_retry_entries:c.highRetryEntries,queue_high_retry_threshold:Nu,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:Rv()}},warnings:h}}async function $v(e){let t;try{t=await ul(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 Ov(e,t){let n="metadata",{missingStreams:r,unreadableStreams:i,hashMismatches:a,chainMismatches:o,driftedItems:s,workspaceStateMismatches:c,workspaceStateMissing:l,workspaceStateUnreadable:d}=await $r(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 Dv(e,t){let n=_r(e),r=dn(n.settings),i=yr(n.settings,t),a=r.active?gt(r.active.name,r.active.model):null;return{runtimeDefaults:n,providerResolution:r,vectorStoreResolution:i,runtimeEmbeddingIdentity:a,semanticRuntimeAvailable:!!(r.active&&i.active)}}function Pv(){return{refreshed:[],skipped:[],warnings:[]}}async function Nv(e){return!e.refreshPolicy.enabled||!e.snapshot.semanticRuntimeAvailable||e.staleBefore.length===0?Pv():lc(e.pmRoot,e.staleBefore,{settings:e.snapshot.runtimeDefaults.settings,apply_runtime_defaults:!1})}function Lv(e){return e.strictVectorizationWarnings&&e.semanticRuntimeAvailable&&!!(e.ledgerBefore.embedding&&e.runtimeEmbeddingIdentity&&Lt(e.ledgerBefore.embedding,e.runtimeEmbeddingIdentity))}function Mv(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 Fv(e,t,n){return e.enabled&&t&&n.length>0?null:e.enabled?t?"no_stale_items":"semantic_runtime_unavailable":"refresh_disabled"}function qu(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:Mi(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:Mi(r,e.vector_store?.adapter??null)}}function jv(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 zv(e,t,n,r,i){let a=Dv(t,e),o=await Mt(e),s=a.semanticRuntimeAvailable?Ui(n,o.entries):[],c=await Nv({pmRoot:e,snapshot:a,refreshPolicy:r,staleBefore:s}),l=await Mt(e),d=a.semanticRuntimeAvailable?Ui(n,l.entries):[],u=!a.runtimeDefaults.auto_ollama_defaults_applied,m=Lv({strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,ledgerBefore:o,runtimeEmbeddingIdentity:a.runtimeEmbeddingIdentity}),p=Mv({ledgerBefore:o,ledgerAfter:l,refreshResult:c,strictVectorizationWarnings:u,semanticRuntimeAvailable:a.semanticRuntimeAvailable,embeddingIdentityChanged:m,staleAfter:d}),f=Za(s,i),h=Za(d,i),g=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:jv(r),...qu(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:Pu,stale_items_before_total:f.total,stale_items_before:f.values,stale_items_before_truncated:f.truncated,refresh_attempted:g,refresh_skipped_reason:Fv(r,a.semanticRuntimeAvailable,s),refresh_result:c,ledger_entries_after:Object.keys(l.entries).length,stale_items_after_total:h.total,stale_items_after:h.values,stale_items_after_truncated:h.truncated}},warnings:p}}function qv(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 Wu(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 Wv=new Set(["extensions","locks","search"]);function Gv(e){let t=new Set(Jo.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 Wv)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 Bv(e,t,n){let{requiredDirs:r,optionalDirs:i,optionalDirSet:a}=Gv(t),o=[],s=[],c=[];for(let l of[...r,...i]){let d=fe.join(e,l);c.push(...await Je({path:d,scope:"project"})),!await to(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 Gu(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 Hv(e){return e.skipPolicy.skipDrift&&e.skipPolicy.skipVectors?Ve(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema):hr(e.pmRoot,e.settings.item_format,e.typeRegistry.type_to_folder,e.itemReadWarnings,e.settings.schema)}function Ka(e){return{check:{name:e,status:"ok",ok:!0,details:{skipped:!0}},warnings:[]}}function Jv(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 Vv(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 Kv(e){return{name:"settings_values",status:e.length===0?"ok":"warn",ok:e.length===0,details:{warnings:e}}}var no=e=>e.unknown_event_count??0,ro=e=>e.actionable_unknown_event_count??no(e);function Yv(e,t,n,r,i,a,o){let s=no(r),c=ro(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 Bu(e){let t=e.count===0?[]:[`stale_in_progress_items:${e.count}`];return{scan:e,warnings:t}}function Xv(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 Zv(e){let t=e.check.details.counts;return typeof t?.drifted=="number"?t.drifted:0}function Qv(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 Hu(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=aa(i)?.code??eo(i),s=n.get(a)?.details,l=(typeof s?.remediation_map=="object"&&s.remediation_map!==null?s.remediation_map:{})[o],d=Qa(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 eb(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 tb(e){for(let t of e.checks){let n=oa(e.remediationSources[t.name]);eb({check:t,remediationMap:n,historyDriftedCount:e.historyDriftedCount,overThresholdCount:e.overThresholdCount}),Object.keys(n).length>0&&(t.details={...t.details,remediation_map:n})}}function Ju(e,t,n){let r=e.warning_count??e.warnings.length,i={...e,warning_count:r,warning_limit:Pn,warnings_truncated:r>Pn,warnings:e.warnings.slice(0,Pn),findings:(e.findings??[]).filter(o=>e.warnings.slice(0,Pn).includes(o.warning)||e.failed_because.includes(o.warning))},a=n?yv(i):t.brief===!0?_v(i):i;return{...a,warning_count:r,warning_limit:Pn,warnings_truncated:r>a.warnings.length,...a.projection?{projection:{...a.projection,warning_count:r,warnings_truncated:r>a.warnings.length}}:{}}}async function Vu(e,t={}){let n=F(process.cwd(),e.path);await oe(n);let r=ft(n),{settings:i,warnings:a}=await qs(n),o=[...new Set(a)],s=q(i,z()),c=t.strictDirectories===!0,l=Wu(t),d=await Bv(n,s,c),u=qv(i),m=await Tv(i,{checkTelemetry:t.checkTelemetry===!0}),p=await mv(n,i,!!e.noExtensions),f=Gu(t),h=[],g=await Hv({pmRoot:n,settings:i,typeRegistry:s,skipPolicy:f,itemReadWarnings:h}),w=g,v=[...new Set(h)],x=f.skipDrift?{warnings:[]}:await Ws({pmRoot:n,settings:i,itemIds:g.map(Si=>Si.id),commandLabel:"health"}),b=await tv(n,i.history.compact_policy,await Qw(n)),S=await wn(n,20,t.verboseAuthorEvents===!0),k=ro(S),R=k>0?[`history_unknown_author_events:${k}`]:[],T=Bu(await dc(n,g,{in_progress_status:i.schema.workflow.in_progress_status,threshold_hours:i.mutation_guard.stale_in_progress_hours})),A=await rl(n),U=A.outcomes,B=A.invalid_values,N=A.warnings,G=await $v(n),_e=f.skipIntegrity?Ka("integrity"):await av(n,s.type_to_folder,i.schema,t.requireMergeDrivers===!0,g),me=f.skipDrift?Ka("history_drift"):await Ov(n,w),Be=f.skipVectors?Ka("vectorization"):await zv(n,i,w,l,t.verboseStaleItems===!0),Pe=[Jv(r,i,o),Vv(d,c),Kv(u),m.check,p.check,Yv(g,i,b,S,T.scan,U,B),G.check,_e.check,me.check,Be.check],M=Xv({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:x.warnings,historySummary:b,authorAttributionWarnings:R,staleInProgressWarnings:T.warnings,provenanceWarnings:N,locksCheck:G,integrityCheck:_e,historyDriftCheck:me,vectorizationCheck:Be}),H=Qv({directoryState:d,normalizedSettingsReadWarnings:o,settingWarnings:u,normalizedItemReadWarnings:v,telemetryCheck:m,extensionCheck:p,historyPolicyWarnings:x.warnings,historySummary:b,authorAttributionWarnings:R,staleInProgressWarnings:T.warnings,provenanceWarnings:N,locksCheck:G,integrityCheck:_e,historyDriftCheck:me,vectorizationCheck:Be});tb({checks:Pe,remediationSources:H,historyDriftedCount:Zv(me),overThresholdCount:b.over_threshold.length});let ki=M.filter(Si=>!Qa(Si,t.requireMergeDrivers===!0)),xi=Hu({warnings:M,checks:Pe,remediationSources:H,requireMergeDrivers:t.requireMergeDrivers===!0}),Gp={ok:ki.length===0,checks:Pe,warnings:M,findings:xi,failed_because:ki,generated_at:$()};return Ju(Gp,t,f.summaryMode)}var $0={buildHierarchyIntegrityWarnings:Mu,buildExtensionHealthTriageSummary:Fu,buildHealthFindings:Hu,buildCapabilityContractMetadata:On,buildStaleInProgressHealthSummary:Bu,buildVectorizationProviderDetails:qu,collectUnknownCapabilityGuidance:$n,isAdvisoryHealthWarning:Qa,isDirectory:to,isExpectedUnmanagedExtension:Ya,listItemDocumentPaths:Lu,normalizeEndpointForDisplay:ni,normalizeExtensionNameForMatch:Yt,parseTelemetryQueue:Uu,probeTelemetryEndpointHealth:zu,projectHealthResult:Ju,resolveActionableUnknownAuthorEventCount:ro,resolveHealthSkipPolicy:Gu,resolveUnknownAuthorEventCount:no,resolveVectorRefreshPolicy:Wu,selectStaleItemDetail:Za,summarizeHealthCheckDetails:ju,summarizeExtensionList:ti,summarizeRecordList:We,summarizeStringList:V,telemetryEnvFlagEnabled:Vt,warningCode:eo};import Xt from"node:fs/promises";import Zt 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 nb(e,t){let n=[...new Set(Object.values(t))],r=[];return await Promise.all(n.map(async i=>{let a;try{a=await Xt.readdir(Zt.join(e,i))}catch{return}for(let o of a)for(let s of on)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 rb(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 io(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 ib(e,t){let n={conflictMarkers:[],unparseable:[],resurrected:[],repairReconciliations:0,scanned:0},r;try{r=await Xt.readdir(Zt.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 Xt.readFile(Zt.join(e,"history",i),"utf8")}catch(o){n.unparseable.push({id:i.slice(0,-6),path:`history/${i}`,detail:io("history stream",o)});continue}rb({id:i.slice(0,-6),relativePath:`history/${i}`,liveItemIds:t,out:n},a)}return n}function Ku(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 ab(e){let t=[],n=0,r=null;try{r=await Y(ft(e))}catch(a){n+=1,t.push({path:"settings.json",detail:io("configuration file",a)})}if(r!==null){n+=1;let a=Ku(r);a!==null&&t.push({path:"settings.json",detail:a})}let i;try{i=await Xt.readdir(Zt.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 Xt.readFile(Zt.join(e,"schema",a),"utf8")}catch(c){t.push({path:`schema/${a}`,detail:io("configuration file",c)});continue}let s=Ku(o);s!==null&&t.push({path:`schema/${a}`,detail:s})}return{scanned:n,unparseable:t}}async function Yu(e,t,n,r={}){let i=await nb(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=Zt.join(e,u.relativePath);return Ot(await Xt.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 ib(e,a),d=await ab(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 ob}from"node:child_process";import Xu 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 Zu(e,t){return new Promise((n,r)=>{ob("git",[...t],{cwd:e,encoding:"utf8",maxBuffer:4*1024*1024},(i,a)=>{i?r(i):n(a)})})}function Qu(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 W0(e){let t=/^(\d+):(\d+)$/u.exec(e.trim()),n=t?{start:Number(t[1]),end:Number(t[2])}:void 0;if(Qu(n),!n)throw new RangeError("Source line range must use start:end.");return n}function sb(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 cb(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 lb(e){let t=Xu.relative(e.workspaceRoot,Xu.resolve(e.workspaceRoot,e.sourcePath)),n=await Zu(e.workspaceRoot,["blame","--line-porcelain","-L",`${e.lineRange.start},${e.lineRange.end}`,"--",t]),r=await Zu(e.workspaceRoot,["log","-n","256","--format=%H%x00%B%x00","--",t]);return{commitLines:sb(n),commitItems:cb(r),available:!0}}function db(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 ub(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=db({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 mb(e,t,n){let r=hc(t);if(!r.graph.hasNode(e))return{status:"not_found",nodes:[],kinds:[],alternative_decision_ids:[]};let i=ub({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 pb(e){if(!e.lineRange)return{commitLines:new Map,commitItems:new Map,available:!0};try{return await lb({workspaceRoot:e.workspaceRoot,sourcePath:e.paths[0],lineRange:e.lineRange})}catch{return{commitLines:new Map,commitItems:new Map,available:!1}}}function fb(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 hb(e){return[...e.commitLines.keys()].filter(t=>(e.commitItems.get(t)?.length??0)>0)}async function em(e){Qu(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 pb(e),r=hb(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=mb(a.item.id,e.corpus,t),l=fb({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 Ro from"node:fs/promises";import{realpathSync as Ck}from"node:fs";import{execFile as Tk}from"node:child_process";import he from"node:path";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]="ab236f47-a866-5236-b8da-f7f23140b978")}catch{}})();var gb=["metadata","resolution"],ao=["metadata","resolution","estimates","lifecycle"],_b="completed";function oo(e){return`"${e.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function tm(e){let t=e?.trim();return t!==void 0&&t.length>0?t:void 0}function nm(e){let t=[];for(let n of e){if(!n.missing_fields.includes("resolution"))continue;let r=tm(n.close_reason)??_b;t.push({item_id:n.id,check:"resolution",field:"resolution",kind:"set_resolution",value:r,command:`pm update ${n.id} --resolution ${oo(r)}`,gate:"resolution"})}return t}function rm(e){let t=[];for(let n of e){let r=tm(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 ${oo(r)}`,gate:"metadata"})}return t}function im(e,t){return e.map(n=>{let r=zs(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 am(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 om(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 ${oo(n.path)}`})}return t}function sm(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: ${ao.join(", ")}.`,_.USAGE);return new Set(gb)}let n=new Set;for(let r of t){let i=r.toLowerCase().replaceAll("-","_");if(ao.includes(i)){n.add(i);continue}throw new y(`Unknown --fix-scope value "${r}". Supported values: ${ao.join(", ")}.`,_.USAGE)}return n}function cm(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 Nn(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 yb=/^([A-Z][A-Z0-9]*-\d+)\b/;function wb(e){if(typeof e!="string")return null;let t=e.trim().toUpperCase();if(t.length===0)return null;let n=yb.exec(t);return n?n[1]:null}function lm(e){return typeof e=="string"&&e.trim().length>0}function dm(e){let t=new Map;for(let r of e){if(typeof r.title!="string"||lm(r.duplicate_of))continue;let i=wb(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:lm(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 um(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 mm=3;function pm(e){let t=Math.max(e.lastIndexOf("/"),e.lastIndexOf("\\"));return t===-1?e:e.slice(t+1)}function fm(e,t,n=mm){let r=Number.isFinite(n)&&n>=1?Math.floor(n):mm,i=new Map;for(let a of t){let o=pm(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(pm(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 hm(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 vb=/^[a-z][a-z0-9+.-]+:\/\//i;function Ln(e){return vb.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 bb(e,t){return e==="moved"||t==="moved"?"moved":"deleted"}function gm(e){return`${e.item_id} ${e.link_kind}`}function _m(e,t){let n=new Map;for(let r of e){let i=n.get(r.path);i?(i.classification=bb(i.classification,r.classification),i.owners.set(gm(r),r)):n.set(r.path,{classification:r.classification,owners:new Map([[gm(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 kb(e){return e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}function ym(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="${kb(r.title)}"`);return t}import xb from"node:fs/promises";import Ce from"node:path";import Sb 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]="1832e2b3-0ece-523d-8f38-598303d3f590")}catch{}})();var Eb=["path","scope","note"],Ab=["pattern","glob","path","scope","note"],Rb=["path"],Ib=["from","to"],Cb=new Set(["note","scope"]);function vm(e){let t=e??"project";if(!Ei.includes(t))throw new y(`Invalid scope "${e}". Valid scopes: ${Ei.join(", ")} (default: project).`,_.USAGE);return t}function co(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("=")||Ys(e)}function Tb(e){return e.flatMap(t=>{let n=t.trim();return n.length===0||co(n)||!n.includes(",")?[t]:wr(n)})}function $b(e){let t=0;for(let n of e)if(n==="("&&(t+=1),n===")"&&(t-=1),t<0)return!1;return t===0}function Ob(e){if(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(e)&&!co(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&&$b(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 Db(e,t){return e?e.flatMap(n=>{let r=n.trim();if(t==="doc"){let i=Ob(r);if(i!==void 0)return[i]}return Tb([n]).map(i=>{let a=i.trim(),o=co(a)?cn(i,"--add"):{path:a};if(ln(o,"--add",Eb),!o.path)throw new y(`--add requires path=<value> or a bare ${t} path`,_.USAGE);return{path:o.path,scope:vm(o.scope),note:o.note?.trim()||void 0}})}):[]}function Pb(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=cn(n,"--add-glob");ln(r,"--add-glob",Ab);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:vm(r.scope),note:r.note?.trim()||void 0}}return{pattern:n,scope:"project"}}):[]}function Nb(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=cn(n,"--remove"),i=Object.keys(r).filter(a=>Cb.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(ln(r,"--remove",Rb),!r.path)throw new y("--remove key/value form requires path=<value>",_.USAGE);return r.path}return n}):[]}function Lb(e){return e?e.map(t=>{let n=cn(t,"--migrate");ln(n,"--migrate",Ib);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 Mn(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 Mb(e,t,n=[]){if(e.length===0||t.length===0)return;let r=new Set(e.map(a=>Mn(a.path,n))),i=[...new Set(t.map(a=>Mn(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 so(e,t,n=process.cwd()){let r=e.trim();if(Ln(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 Fb(e,t=process.cwd(),n=process.cwd()){let r=[];for(let i of e){let a=Ce.isAbsolute(i.pattern),o=await Sb(i.pattern,{cwd:n,absolute:a,onlyFiles:!0,dot:!0,unique:!0,followSymbolicLinks:!0}),s=[...new Set(o.map(c=>so(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 jb(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 lo(e){return[...e].sort((t,n)=>{let r=t.path.localeCompare(n.path);return r!==0?r:t.scope.localeCompare(n.scope)})}function uo(e){return[...new Map(e.map(t=>[Ub(t),t])).values()].map(t=>({...t,note:t.note?.trim()||void 0}))}async function zb(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(Ln(s)){o.push(s.trim());continue}let c=Ce.isAbsolute(s)?s:Ce.resolve(t,s);try{(await xb.stat(c)).isFile()?r.push(s):a.push(s)}catch(l){if(typeof l=="object"&&l!==null&&"code"in l&&Vn(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 qb(e,t,n,r){let i=0;for(let o=0;o<e.length;o+=1){let s=Mn(e[o].path,r);s!==e[o].path&&(e[o]={...e[o],path:s},i+=1)}return{adds:t.map(o=>{let s=Mn(o.path,r);return s!==o.path&&(i+=1),{...o,path:s}}),removes:n.map(o=>Mn(o,r)),count:i}}function Wb(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=uo(e);return r?i:lo(i)}async function wm(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 zb(t,e.workspaceRoot):void 0}}async function ri(e,t,n,r){let{metadataKey:i}=r,a=Xs(),o=F(process.cwd(),n.path),s=pt(o),c=process.cwd();await oe(o);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"),h=Db(u,r.bareNoun).map(B=>({...B,path:so(B.path,s,c)})),g=Pb(m),w=await Fb(g,s,c),v=jb([...h,...w],t.note,h.length>0||g.length>0),x=Nb(p).map(B=>so(B,s,c)),b=Lb(f);if(Mb(v,x,b),!(v.length>0||x.length>0||b.length>0)){let B=await Dt(o,e,l.id_prefix,l.item_format,d.type_to_folder);if(!B)throw new y(`Item ${e} not found`,_.NOT_FOUND);let G=(await Pt(B,{schema:l.schema})).document.metadata[i]??[];return wm({id:B.id,artifacts:G,changed:!1,options:t,workspaceRoot:s})}let k=K(t.author,l.author_default),R=await ht({pmRoot:o,settings:l,id:e,op:r.op,author:k,message:t.message,force:t.force,skipNoop:!0,mutate(B){let N=B.metadata,G=N[i]??[],_e=[...G],me=qb(_e,v,x,b),Be=Wb(_e,me.adds,me.removes,r.supportsAppendStable&&t.appendStable===!0);Be.length>0?N[i]=Be:delete N[i];let Pe=!os(G,Be);return{changedFields:Pe?[i]:[],warnings:Pe&&me.count>0?[`path_migrations_applied:${me.count}`]:[]}}}),T=R.item[i]??[],A=R.warnings.find(B=>B.startsWith("path_migrations_applied:")),U=A?Number(A.slice(24)):0;return wm({id:R.item.id,artifacts:T,changed:R.changedFields.includes(i),migrationsApplied:U,options:t,workspaceRoot:s})}function ii(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 bm(e,t,n){let r=await ri(e,t,n,{metadataKey:"docs",op:"docs_add",bareNoun:"doc",supportsAppendStable:!1});return ii(r,"docs")}import km from"node:fs/promises";import Te 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]="ed504f2b-8b78-5fca-a4a7-7b0709a65533")}catch{}})();var Gb=32768;function mo(e){return nt(Te.normalize(e))}async function ai(e){try{return await km.realpath(e)}catch{return Te.resolve(e)}}function Qt(e,t){let n=Te.isAbsolute(e.path)?Te.resolve(e.path):Te.resolve(t,e.path);return`${mo(n)}::${e.scope}`}function oi(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)=>oi(r,`${t}[${i}]`,n));return}if(typeof e=="object"&&e!==null)for(let[r,i]of Object.entries(e))oi(i,t?`${t}.${r}`:r,n)}function Bb(e){let t=[];return oi(e.metadata,"metadata",t),oi(e.body,"body",t),t}function Hb(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 Jb(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,Gb);for(let[s,c]of[[n,i.value],[r,o]]){s.lastIndex=0;for(let l of c.matchAll(s)){let d=Hb(l[0]);!d||a.has(d)||(a.add(d),t.push({field:i.field,value:d}))}}}return t}async function Vb(e,t,n=t){let r=Te.isAbsolute(e)?Te.resolve(e):Te.resolve(n,e),i;try{i=await km.stat(r)}catch{return}if(!i.isFile())return;let[a,o]=await Promise.all([ai(t),ai(r)]);if(ye(a,o)){let s=Te.relative(a,o);return!s||s.startsWith("..")||Te.isAbsolute(s)?void 0:{path:mo(s),scope:"project"}}return{path:mo(r),scope:"global"}}async function Kb(e,t,n=t){let r=new Set((e.metadata.files??[]).map(c=>Qt(c,t))),i=new Map,a=Jb(Bb(e)),o=new Map;await Promise.all([...new Set(a.map(c=>c.value))].map(async c=>{o.set(c,await Vb(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=Qt(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 xm(e,t,n){let r=await ri(e,t,n,{metadataKey:"files",op:"files_add",bareNoun:"file",supportsAppendStable:!0});return ii(r,"files")}async function Yb(e,t){let n=await ai(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(!Te.isAbsolute(o))return nt(o);let s=await ai(o);return ye(n,s)?nt(Te.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 Xb(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 Sm(e){return{id:e.id,title:e.title,type:e.type,status:e.status,priority:e.priority,updated_at:e.updated_at}}function Em(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 Zb(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(Em)}async function Qb(e){if(e.explain)return em({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 ek(e){if([e.strictRead,e.noTruncate,e.explain,Ds()].includes(!0))return null;let t=await fr(e.pmRoot,[...new Set(Object.values(e.typeToFolder))]);return t?Bs({pmRoot:e.pmRoot,expectedSourceCursor:t.source_cursor,paths:e.paths,scope:e.scope,limit:e.limit,offset:e.offset}):null}async function tk(e){let t=[],n=await Nt(e.pmRoot,e.settings.item_format,e.typeToFolder,t,e.settings.schema),r=Zb({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 Qb({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:Em(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:Sm(c.item),files:c.files,...a?{traceability:a.explanations.get(c.item.id)}:{}})),...a?{traceability_receipt:a.receipt}:{}}}async function MO(e,t){let n=F(process.cwd(),t.path),r=pt(n);await oe(n);let i=await Yb(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}=Xb(e),l=await ek({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:Sm(d.item),files:d.files}))}:tk({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 FO(e,t,n){let r=F(process.cwd(),n.path),i=pt(r);await oe(r);let a=await I(r),o=q(a,z()),s=await Dt(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 Pt(s,{schema:a.schema}),l=await Kb(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=K(t.author,a.author_default),h=d.map(T=>({path:T.path,scope:T.scope,note:p})),g=[],w=new Set,v=await ht({pmRoot:r,settings:a,id:e,op:"files_discover",author:f,message:t.message??"Discover referenced file links",force:t.force,mutate(T){let A=[...T.metadata.files??[]],U=new Set(A.map(G=>Qt(G,i)));g=[],w.clear();for(let[G,_e]of h.entries()){let me=Qt(_e,i);U.has(me)||(A.push(_e),U.add(me),g.push(_e),w.add(G))}let B=uo(A),N=t.appendStable?B:lo(B);return N.length>0?T.metadata.files=N:delete T.metadata.files,{changedFields:g.length>0?["files"]:[],warnings:g.length!==h.length?[`files_discover_skipped_existing:${h.length-g.length}`]:[]}}}),x=v.item.files??[],b=new Set(g.map(T=>Qt(T,i))),S=x.filter(T=>b.has(Qt(T,i))),k=d.filter((T,A)=>!w.has(A)),R=[...u,...k];return{id:v.item.id,files:x,changed:S.length>0,apply:!0,count:x.length,candidate_count:l.length,addable_count:d.length,added_count:S.length,skipped_existing_count:R.length,candidates:l,added:S,skipped_existing:R}}import{readFileSync as nk}from"node:fs";import si 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 rk=new Set(["get","history","restore","update","close","delete","append","claim","release","comments","notes","learnings","files","docs","deps","test"]),po=new Set(["--pm-path","--path","--author"]),ik={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"])},ak=new Set(["-p","--package"]),ok=new Set(["-c","--call"]),sk=new Set(["-c","-C","--config","--dir","--filter","--workspace-dir"]),ck=new Set(["-C","--prefix","--userconfig","--cache"]),qO=new Set(["--cwd"]),WO=new Set(["--cwd"]),lk=new Set(["exec","x"]),GO=new Set(["run","run-script"]),BO=new Set(["-C","--dir","--cwd","-w","--workspace","--filter"]);function dk(e){return e.split(/&&|\|\||\||;/).map(t=>t.trim()).filter(t=>t.length>0)}function uk(e,t=process.cwd()){let n=mk(e.split(" ").filter(o=>o.length>0));if(n.length===0)return null;let[r,...i]=n;if(Am(r)||Rm(r,t))return i;if(r==="node"&&i[0]&&Rm(i[0],t))return i.slice(1);let a=r==="npx"||r==="bunx"?fo(i):r==="pnpm"?hk(i):r==="npm"?gk(i):null;return a&&(Am(a.command)||fk(a.command))?a.args:null}var Im=(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 dk(a)){let c=uk(s),l=c?_k(c):null,d=l&&rk.has(l.subcommand)?yk(l.remaining,ik[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 mk(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 HO(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(po.has(n)){t+=2;continue}t+=1;continue}return n}}function Am(e){return e==="pm"||e==="pm.cmd"||e==="pm.exe"||e.endsWith("/pm")||e.endsWith("/pm.cmd")||e.endsWith("/pm.exe")}function pk(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 fk(e){let t=pk(e);return t==="pm-cli"||t.endsWith("/pm-cli")||e==="pm-cli"||e.endsWith("/pm-cli")}function Rm(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=si.resolve(t,e);try{return JSON.parse(nk(si.join(si.dirname(si.dirname(r)),"package.json"),"utf8")).name==="@unbrained/pm-cli"}catch{return!1}}function fo(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(ok.has(r)){t+=1;break}t+=ak.has(r)&&!r.includes("=")?2:1}let n=e[t];return n?{command:n,args:e.slice(t+1)}:null}function Cm(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 hk(e){let t=Cm(e,sk);return t?.subcommand!=="dlx"?null:fo(t.args)}function gk(e){let t=Cm(e,ck);return!t||!lk.has(t.subcommand)?null:fo(t.args)}function _k(e){let t=0;for(;t<e.length;){let n=e[t];if(n==="--"){t+=1;continue}if(n.startsWith("-")){if(po.has(n)){t+=2;continue}t+=1;continue}return{subcommand:n,remaining:e.slice(t+1)}}return null}function yk(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("=")&&(po.has(r)||t.has(r))&&(n+=1)}}import{execFile as wk}from"node:child_process";import{readFile as vk}from"node:fs/promises";import $m from"node:path";import{promisify as bk}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]="30a61f26-5db8-50ba-af37-1990a4742ce8")}catch{}})();var kk=bk(wk),ho=1,xk="linked-test-trust.json";function go(e){return $m.join(es(e),xk)}function Tm(){return{version:ho,acknowledged:{}}}async function _o(e){try{let t=JSON.parse(await vk(go(e),"utf8"));return t.version!==ho||typeof t.acknowledged!="object"||t.acknowledged===null||Array.isArray(t.acknowledged)?Tm():{version:ho,acknowledged:t.acknowledged}}catch{return Tm()}}async function yo(e=process.cwd()){let t=process.env.GITHUB_HEAD_REF?.trim()||process.env.GITHUB_REF_NAME?.trim();if(t&&t!=="merge")return t;try{let{stdout:n}=await kk("git",["symbolic-ref","--quiet","--short","HEAD"],{cwd:e,encoding:"utf8",windowsHide:!0,timeout:1e4}),r=n.trim();return r.length===0?void 0:r}catch{return}}function wo(e=process.cwd()){return process.env.PM_SOURCE_WORKSPACE_ROOT?.trim()||e}function Sk(e){return e===null||typeof e!="object"?!1:typeof e.author=="string"&&e.author.trim().length>0&&typeof e.created_at=="string"&&Ps(e.created_at)&&(e.source_kind==="local_mutation"||e.source_kind==="merge_union")}function Fn(e,t){return{...e?{source_ref:e}:{},...t?{current_source_ref:t}:{}}}function Ek(e,t,n,r){return e?.map(i=>i.command&&!i.provenance?{...i,provenance:{author:t,created_at:n,source_kind:"local_mutation",...r?{source_ref:r}:{}}}:i)}async function nD(e,t,n){if(!e||e.length===0)return e;let r=wo();return Ek(e,t,n,await yo(r))}function Om(e){return sn(re({command:e.command??null,path:e.path??null,scope:e.scope,pm_context_mode:e.pm_context_mode??null,workspace_context_mode:e.workspace_context_mode??null,env_set:e.env_set??null,env_clear:e.env_clear??null,shared_host_safe:e.shared_host_safe??null,provenance:e.provenance??null,provenance_invalid:e.provenance_invalid??null}))}async function rD(e,t,n){let r=await _o(e);return Dm(t,n,r)}function Dm(e,t,n){let r=Om(e),i=e.provenance?.source_ref;if(e.provenance===void 0&&e.provenance_invalid!==!0)return{fingerprint:r,trusted:!0,reason:"legacy"};let a=Object.hasOwn(n.acknowledged,r);return e.provenance_invalid===!0||!Sk(e.provenance)?a?{fingerprint:r,trusted:!0,reason:"acknowledged",...Fn(void 0,t)}:{fingerprint:r,trusted:!1,reason:"invalid_provenance",...Fn(void 0,t)}:e.provenance.source_kind==="local_mutation"&&i===void 0?{fingerprint:r,trusted:!0,reason:"local_mutation",...Fn(void 0,t)}:e.provenance.source_kind==="local_mutation"&&i!==void 0&&i===t?{fingerprint:r,trusted:!0,reason:"local_source_ref",source_ref:i,current_source_ref:t}:a?{fingerprint:r,trusted:!0,reason:"acknowledged",...Fn(i,t)}:{fingerprint:r,trusted:!1,reason:"foreign_source_ref",...Fn(i,t)}}async function Pm(e,t,n){let r=await _o(e);return t.map(i=>Dm(i,n,r))}async function iD(e,t,n){let r=await _o(e),i=t.filter(a=>typeof a.command=="string"&&a.command.length>0).map(Om);for(let a of i)r.acknowledged[a]={acknowledged_at:n};return await an($m.dirname(go(e))),await ie(go(e),`${JSON.stringify(r,null,2)}
|
|
45
|
-
`),{acknowledged:i.length,fingerprints:i}}(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 Nm(e){return e.includeBody?hr(e.pmRoot,e.settings.item_format,e.typeToFolder,e.warnings,e.settings.schema,{forceSourceScan:!0}):Nt(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 Ak=5;async function Lm(e,t,n){let r=await $r(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:Ak,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]="77a3c404-bbcd-5a5e-80bf-cb61c45af55d")}catch{}})();function ci(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=>{for(let c of(t.get(s)??[]).filter(l=>r.has(l))){if(c===n&&i.length>1)return i.push(n),!0;if(!a.has(c)){if(a.add(c),i.push(c),o(c))return!0;i.pop(),a.delete(c)}}return!1};return o(n)?[...i]:[...e,n]}function Rk(e,t){if(typeof e!="string")return;let n=e.trim().toLowerCase();return n.length>0?t.get(n):void 0}function Ik(e,t,n,r){for(let i of e.dependencies??[]){if(typeof i!="object"||i===null||typeof i.id!="string")continue;let a=r.resolve(i.kind);if(!a?.hierarchy)continue;let o=n.get(i.id.toLowerCase());o&&(a.hierarchyDirection==="source_parent"?t.get(o).push(e.id):t.get(e.id).push(o))}}function vo(e,t=un()){let n=new Map(e.map(i=>[i.id.toLowerCase(),i.id])),r=new Map(e.map(i=>[i.id,[]]));for(let i of[...e].sort((a,o)=>a.id.localeCompare(o.id))){let a=r.get(i.id),o=Rk(i.parent,n);o&&a.push(o),Ik(i,r,n,t)}for(let[i,a]of r)r.set(i,[...new Set(a)].sort());return r}function bo(e,t,n=un()){let r=vr(e,o=>t?vs(o,t):o==="closed"||o==="canceled",n),i=vo(e,n),a=r.cycles.map(o=>o.item_ids);return{cycle_count:a.length,active_cycle_count:r.cycles.filter(o=>!o.legacy_terminal).length,legacy_cycle_count:r.cycles.filter(o=>o.legacy_terminal).length,cycle_item_ids:[...new Set(a.flat())].sort(),cycle_sample_paths:a.map(o=>ci(o,i).join("->")),cardinality_violation_count:r.cardinality_violations.length,active_cardinality_violation_count:r.cardinality_violations.filter(o=>!o.legacy_terminal).length,legacy_cardinality_violation_count:r.cardinality_violations.filter(o=>o.legacy_terminal).length,cardinality_violation_rows:r.cardinality_violations.map(o=>`${o.child_id}:${o.parent_ids.join(",")}:${o.legacy_terminal?"legacy":"active"}`),parent_divergence_count:r.divergences.length,active_parent_divergence_count:r.divergences.filter(o=>!o.legacy_terminal).length,legacy_parent_divergence_count:r.divergences.filter(o=>o.legacy_terminal).length,parent_divergence_rows:r.divergences.map(o=>`${o.child_id}:scalar=${o.scalar_parent_id}:dependencies=${o.dependency_parent_ids.join(",")}:${o.legacy_terminal?"legacy":"active"}`)}}(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]="aca69fd7-c47a-5424-b58f-f305f690edd9")}catch{}})();var Ok=["src","tests","docs"],Dk=["README.md","PRD.md","CHANGELOG.md","AGENTS.md","CONTRIBUTING.md","SECURITY.md","CODE_OF_CONDUCT.md","LICENSE"],Pk=new Set(["node_modules",".git",".cursor",".agents","dist","coverage"]),Nk=["resolution","expected_result","actual_result"],Lk=["default","tracked-all","tracked-all-strict"],Mm=["core","strict","custom"],ui=["off","warn","error"],So=["author","acceptance_criteria","estimated_minutes","close_reason"],zm=[...So,"reviewer","risk","confidence","sprint","release"],Io=Array.from(new Set(zm)),Mk={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"},Fk={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"},jk={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"},Uk={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"},zk={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"},qk=32*1024*1024,Wk=1e4,qm=40,mt=5,Gk=4096,Bk=255,Hk=$k(Tk);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 Jk(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 St(e){return e.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/^\/+/,"")}function Fm(e){return St(e).replace(/\/+$/,"")}function Ge(e){let t=X(e);if(!t)return;let n=t.toLowerCase();if(!(n==="none"||n==="null"||n==="n/a"||n==="na"))return t}function pi(e,t){return Ls(e,t)??e}function jn(e,t){return t.terminal_statuses.has(pi(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 li(e,t){return e.length!==t.length?!1:e.every((n,r)=>n===t[r])}function Vk(e){let t=dt(Ko),n={blocked_reason:dt(Jn.blocked_reason),resolution:dt(Jn.resolution),actual_result:dt(Jn.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:li(r,t)?"default":"settings",closure_like_metadata_field_patterns:i,closure_like_metadata_field_pattern_sources:{blocked_reason:li(i.blocked_reason,n.blocked_reason)?"default":"settings",resolution:li(i.resolution,n.resolution)?"default":"settings",actual_result:li(i.actual_result,n.actual_result)?"default":"settings"}}}function Gm(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(ui.includes(t))return t;throw new y(`Unknown --dependency-cycle-severity value "${e}". Supported values: ${ui.join(", ")}.`,_.USAGE)}function Hm(e){let t=e?.trim().toLowerCase();if(!t||t.length===0)return"warn";if(ui.includes(t))return t;throw new y(`Unknown --parent-cycle-severity value "${e}". Supported values: ${ui.join(", ")}.`,_.USAGE)}function Kk(e){return[...new Set((e??[]).map(n=>n.trim().toLowerCase().replaceAll("-","_")))].map(n=>Mk[n]).filter(n=>n!==void 0).sort((n,r)=>n.localeCompare(r))}function Yk(e,t,n){let r=Kk(n);return e==="core"?{profile:e,profile_source:t,required_fields:[...So],configured_custom_fields:r,fallback_to_core:!1,warnings:[]}:e==="strict"?{profile:e,profile_source:t,required_fields:[...zm],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:[...So],configured_custom_fields:r,fallback_to_core:!0,warnings:["validate_metadata_custom_profile_missing_required_fields:0"]}}var Xk=new Set(["acceptance_criteria","estimated_minutes"]);function Jm(e,t,n,r){return!r&&Xk.has(t)&&jn(e.status,n)?!1:t==="author"?!X(e.author):t==="acceptance_criteria"?!X(e.acceptance_criteria):t==="estimated_minutes"?!Number.isFinite(e.estimated_minutes):t==="close_reason"?pi(e.status,n)===n.close_status&&!X(e.close_reason):t==="reviewer"?!X(e.reviewer):t==="risk"?!X(e.risk):t==="confidence"?typeof e.confidence=="number"?!Number.isFinite(e.confidence):!X(e.confidence):t==="sprint"?!X(e.sprint):!X(e.release)}function Vm(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: ${Lk.join(", ")}.`,_.USAGE)}function Km(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=jm(n),o=jm(i),s=he.relative(a,o);return s.length===0||!s.startsWith("..")&&!he.isAbsolute(s)?n:i}function jm(e){try{return Ck.native(e)}catch{return he.resolve(e)}}function Zk(e,t){return typeof e=="object"&&e!==null&&"code"in e&&typeof e.code=="string"&&t.includes(e.code)}async function Co(e,t,n){let r=t.length>0?he.join(e,t):e,i;try{i=await Ro.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(Pk.has(a.name))continue;await Co(e,o,n);continue}a.isFile()&&n.push(St(o))}}async function Eo(e){let t=[];for(let n of Ok)await Co(e,n,t);for(let n of Dk){let r=he.join(e,n);try{(await Ro.stat(r)).isFile()&&t.push(St(n))}catch{}}return[...new Set(t)].sort((n,r)=>n.localeCompare(r))}async function Ym(e){try{let{stdout:t}=await Hk("git",["ls-files","-z"],{cwd:e,encoding:"utf8",maxBuffer:qk,windowsHide:!0,timeout:Wk}),n=t.split("\0").map(r=>St(r)).filter(r=>r.length>0);return[...new Set(n)].sort((r,i)=>r.localeCompare(i))}catch{return null}}function Qk(e,t){let n=new Set,r=Fm(Ho);r.length>0&&n.add(r);let i=Fm(he.relative(t,e));return i.length>0&&!i.startsWith("..")&&n.add(i),[...n].sort((a,o)=>a.localeCompare(o))}function Um(e,t){for(let n of t)if(e===n||e.startsWith(`${n}/`))return!0;return!1}async function ex(e,t){if(t==="tracked-all"||t==="tracked-all-strict"){let r=await Ym(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 Q(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=Q(e,qm);return{values:n.values,truncated:n.truncated,total:e.length}}var tx={resolution:"--resolution",expected_result:"--expected-result",actual_result:"--actual-result"},nx={resolution:"Describe how this item was resolved",expected_result:"Describe the expected result",actual_result:"Describe the actual result"};function rx(e){let t=e.missing_fields.map(n=>`${tx[n]} "${nx[n]}"`).join(" ");return`pm update ${e.id} ${t} --message "Backfill resolution metadata"`}function Xm(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"):pl(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 Zm(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 ix="validate_metadata_duplicate_issue_codes";function Qm(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:[`${ix}:${e.length}`]}}function ax(){return Object.fromEntries(Io.map(e=>[e,[]]))}function ox(e,t,n){let r=ax();for(let i of e)for(let a of Io)Jm(i,a,t,n)&&r[a].push(i.id);return r}function sx(e,t,n){let r=[...e.warnings];for(let i of e.required_fields){let a=t[i];a.length>0&&r.push(`${Fk[i]}:${a.length}`)}return r.push(...n),r}function ep(e,t){let n={};for(let r of e.required_fields){let i=t[r],a=i?i.length:0,o=jk[r];n[o]=a}return n}function tp(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 cx(e,t,n,r){for(let i of t.required_fields){let a=n[i];if(!a||a.length===0)continue;let o=Uk[i],s=zk[i];if(!o||!s)continue;let c=Q(a,r?a.length:mt);e[o]=c.values,e[s]=c.truncated}}function np(e,t,n){if(!e.required_fields.includes("close_reason"))return[];let r=t.close_reason;return r?r.map(i=>({id:i,resolution:X(n.get(i)?.resolution)})):[]}function rp(e,t,n){if(!e.required_fields.includes("estimated_minutes"))return[];let r=t.estimated_minutes;return r?r.map(i=>({id:i,type:X(n.get(i)?.type)})):[]}function lx(e,t,n,r){let i=new Map(e.map(g=>[g.id,g])),a=t.profile==="strict",o=ox(e,n,a),s=dm(e),c=Qm(s,r),l=sx(t,o,c.warnings),d=ep(t,o),u=tp(t,o,i),m=um(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:[...Io],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]),cx(p,t,o,r);let f=np(t,o,i),h=rp(t,o,i);return{check:{name:"metadata",status:l.length===0?"ok":"warn",ok:l.length===0,details:p},warnings:l,closeReasonBackfillRows:f,estimateBackfillRows:h}}function dx(e,t,n){let r=new Set(t.terminal_done_statuses);r.add(t.close_status);let i=e.filter(m=>r.has(pi(m.status,t))),a=[],o=[];for(let m of i){let p=Nk.filter(f=>!X(m[f]));p.length!==0&&(a.push({id:m.id,missing_fields:p}),o.push({id:m.id,missing_fields:p,close_reason:X(m.close_reason)}))}let s=a.length>0?[`validate_resolution_missing_fields:${a.length}`]:[],c=n?Number.POSITIVE_INFINITY:mt,l=Q(a.map(m=>`${m.id}:${m.missing_fields.join(",")}`),c),d=a.map(m=>rx(m)),u=Q(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 ip(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function ap(e,t="pm",n=rs()){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=Ge(a.blocked_by);s&&r.has(s)&&o.add(s),(a.dependencies??[]).filter(l=>{let d=Ge(l.kind);return d!==void 0&&n.resolve(d)?.ordering===!0}).map(l=>Ge(l.id)).filter(l=>l!==void 0&&r.has(l)).forEach(l=>o.add(l));let c=Ge(a.definition_of_ready);return sp(c??"",t).filter(l=>r.has(l)).forEach(l=>o.add(l)),[a.id,[...o].sort((l,d)=>l.localeCompare(d))]}))}function op(e,t,n){let r=fc(e,n?d=>jn(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=Q(i,o),c=Q(a,o),l=Q(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 sp(e,t="pm"){let n=(t.trim().toLowerCase()||"pm").replace(/-+$/g,""),r=new RegExp(`(?:^|[^a-z0-9-])(${ip(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 cp(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 lp(e,t="pm"){let n=ap(e,t),r=cp(n),i=[...new Set(r.flat())].sort((o,s)=>o.localeCompare(s)),a=r.map(o=>ci(o,n).join("->"));return{cycle_count:r.length,cycle_item_ids:i,cycle_sample_paths:a}}function dp(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 mi(e){let t=e.lastIndexOf("/");return t===-1?"":e.slice(0,t)}function up(e,t){let n=mi(e).split("/").filter(Boolean),r=mi(t).split("/").filter(Boolean),i=0;for(;i<n.length&&i<r.length&&n[i]===r[i];)i+=1;return i}function ux(e,t){let n=mi(t),r=mi(e),i=t.endsWith("/")?t:`${t}/`,a=e.startsWith(i),o=n.length>0&&n===r,s=up(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 mx(e,t,n){return e===void 0||n>e.score||n===e.score&&t.id.localeCompare(e.item.id)<0}function px(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=St(o.path);if(s.length===0||s===e)return;let c=ux(e,s);c!==null&&mx(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 mp(e,t){return e.map(n=>{let r=dp(n),i=r==="docs_unowned"?"docs":"files",a=px(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 pp(e){return e.map(t=>`${t.path}:${t.classification} owner_candidate=${t.owner_candidate?.id??"unowned"} hint=${JSON.stringify(t.remediation_hint)}`)}function fx(e,t){return Object.entries(t.closure_like_metadata_field_patterns).filter(([n,r])=>{let i=Ge(e[n]);return i?r.some(a=>i.toLowerCase().includes(a)):!1}).map(([n])=>n).sort((n,r)=>n.localeCompare(r))}function hx(e,t,n,r,i){let a=Ge(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&&!jn(o.status,i)}}function gx(e,t,n,r){let i=Ge(e.blocked_by),a=Ge(e.blocked_reason),o=a?.toLowerCase(),s=pi(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 _x(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=>!jn(c.status,n)),closureLikeRows:[],terminalParentRows:[],terminalParentFixRows:[],staleBlockerRows:[]};for(let c of s.activeItems){let l=fx(c,r);l.length>0&&s.closureLikeRows.push({id:c.id,fields:l});let d=Ge(c.parent),u=d?i.get(a.get(d.toLowerCase())??d):void 0;if(u&&jn(u.status,n)&&(s.terminalParentRows.push({id:c.id,parent_id:u.id,parent_status:u.status}),s.terminalParentFixRows.push(hx(c,u,i,a,n))),t){let m=gx(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 yx(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 di(e,t,n){return n<=0||t==="off"?null:`${t==="error"?`${e}_error`:e}:${n}`}function ko(e,t,n){return n>0&&t!=="off"?`${e}:${n}`:null}function wx(e,t,n,r,i){let a=[];e.closureLikeRows.length>0&&a.push(`validate_lifecycle_active_closure_like_metadata:${e.closureLikeRows.length}`),e.terminalParentRows.length>0&&a.push(`validate_lifecycle_active_terminal_parent:${e.terminalParentRows.length}`),t&&e.staleBlockerRows.length>0&&a.push(`validate_lifecycle_stale_blockers:${e.staleBlockerRows.length}`);let o=di("validate_lifecycle_dependency_cycles",n,i.dependencyCycles),s=di("validate_hierarchy_parent_cycle",r,i.activeHierarchyCycles),c=di("validate_hierarchy_cardinality_violation",r,i.activeHierarchyCardinality),l=di("validate_hierarchy_parent_divergence",r,i.activeHierarchyDivergence),d=ko("validate_legacy_hierarchy_parent_cycle",r,i.legacyHierarchyCycles),u=ko("validate_legacy_hierarchy_cardinality_violation",r,i.legacyHierarchyCardinality),m=ko("validate_legacy_hierarchy_parent_divergence",r,i.legacyHierarchyDivergence);return[...a,...o?[o]:[],...s?[s]:[],...c?[c]:[],...l?[l]:[],...d?[d]:[],...u?[u]:[],...m?[m]:[]]}function fp(e){let t=St(e);return t.length>Gk||t.split(/[\\/]/).some(n=>n.length>Bk)}async function vx(e,t){let n=he.isAbsolute(t)?t:he.resolve(e,t);if(fp(n))return!1;try{let r=await Ro.stat(n);return!r.isFile()&&!r.isDirectory()}catch(r){return Zk(r,["ENOENT","ENOTDIR"])}}async function bx(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(Ln(a.path)){n.remoteLinkedPaths.add(a.path.trim());continue}let s=St(a.path);s.length!==0&&(n.linkedProjectPaths.add(s),await vx(t,a.path)&&(n.missingLinkedPaths.push(s),n.staleLinkRows.push({item_id:i.id,path:s,link_kind:o})))}return n}function kx(e,t,n,r,i,a){let o=r==="tracked-all-strict",s=o&&!i,c=i||o,l=c?[]:Qk(t,n),d=l.length===0?[]:e.candidateFiles.filter(p=>Um(p,l)),u=l.length===0?e.candidateFiles:e.candidateFiles.filter(p=>!Um(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 hp(e,t,n,r,i,a,o,s="pm"){let c=_x(e,t,i,a);yx(c);let l=lp(c.activeItems,s),d=bo(e,i),u=wx(c,t,n,r,{dependencyCycles:l.cycle_count,activeHierarchyCycles:d.active_cycle_count,activeHierarchyCardinality:d.active_cardinality_violation_count,activeHierarchyDivergence:d.active_parent_divergence_count,legacyHierarchyCycles:d.legacy_cycle_count,legacyHierarchyCardinality:d.legacy_cardinality_violation_count,legacyHierarchyDivergence:d.legacy_parent_divergence_count}),m=o?Number.POSITIVE_INFINITY:mt,p=Q(c.closureLikeRows.map(R=>`${R.id}:${R.fields.join(",")}`),m),f=Q(c.terminalParentRows.map(R=>`${R.id}:${R.parent_id}:${R.parent_status}`),m),h=Q(c.staleBlockerRows.map(R=>`${R.id}:${R.status}:${R.reasons.join(",")}`),m),g=Q(l.cycle_item_ids,m),w=Q(l.cycle_sample_paths,m),v=Q(d.cycle_item_ids,m),x=Q(d.cycle_sample_paths,m),b=Q(d.cardinality_violation_rows,m),S=Q(d.parent_divergence_rows,m),k=l.cycle_count>0&&n==="error"||(d.active_cycle_count>0||d.active_cardinality_violation_count>0||d.active_parent_divergence_count>0)&&r==="error";return{check:{name:"lifecycle",status:k?"error":u.length===0?"ok":"warn",ok:!k&&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:h.values,stale_blocker_rows_truncated:h.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:g.values,dependency_cycle_item_ids_truncated:g.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,active_parent_cycle_count:d.active_cycle_count,legacy_parent_cycle_count:d.legacy_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:x.values,parent_cycle_sample_paths_truncated:x.truncated,hierarchy_cardinality_violation_count:d.cardinality_violation_count,active_hierarchy_cardinality_violation_count:d.active_cardinality_violation_count,legacy_hierarchy_cardinality_violation_count:d.legacy_cardinality_violation_count,hierarchy_cardinality_violation_rows:b.values,hierarchy_cardinality_violation_rows_truncated:b.truncated,hierarchy_parent_divergence_count:d.parent_divergence_count,active_hierarchy_parent_divergence_count:d.active_parent_divergence_count,legacy_hierarchy_parent_divergence_count:d.legacy_parent_divergence_count,hierarchy_parent_divergence_rows:S.values,hierarchy_parent_divergence_rows_truncated:S.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 gp(e,t,n,r,i,a){let o=await bx(e,t),s=new Map(e.map(N=>[N.id,N])),c=[...new Set(o.missingLinkedPaths)].sort((N,G)=>N.localeCompare(G)),l=await ex(t,r),d=kx(l,n,t,r,i,a),u=d.candidateFiles.filter(N=>!o.linkedProjectPaths.has(N)),m=mp(u,e),p=fm(c,d.candidateFiles),f=new Map(p.map(N=>[N.path,N.classification])),h=p.filter(N=>N.classification==="moved").length,g=o.staleLinkRows.map(N=>({...N,classification:f.get(N.path)??"deleted"})).sort((N,G)=>N.item_id.localeCompare(G.item_id)||N.path.localeCompare(G.path)||N.link_kind.localeCompare(G.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((N,G)=>N.localeCompare(G)),x=ut(v,a),b=ut(c,a),S=ut(u,a),k=ut(m.map(N=>`${N.path}:${N.classification}:owner_candidate=${N.owner_candidate?.id??"unowned"}`),a),R=a?m:ut(pp(m),!1).values,T=ut(hm(p),a),A=g.map(N=>({item_id:N.item_id,path:N.path,link_kind:N.link_kind,classification:N.classification})),U=_m(A,N=>{let G=s.get(N);return G?{type:G.type,title:G.title,status:G.status}:void 0}),B=a?U:ut(ym(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:qm,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:x.total,remote_linked_paths:x.values,remote_linked_paths_truncated:x.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:b.total,missing_linked_paths:b.values,missing_linked_paths_truncated:b.truncated,missing_linked_paths_moved_count:h,missing_linked_paths_deleted_count:c.length-h,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:S.total,orphaned_paths:S.values,orphaned_paths_truncated:S.truncated,orphaned_path_classifications:k.values,orphaned_path_classifications_truncated:k.truncated,orphaned_path_rows_count:m.length,orphaned_path_rows:R}},warnings:w,staleLinkPruneRows:g}}function _p(e){let t=e.trim().replaceAll(/\s+/g," ");return t.length>120?`${t.slice(0,117)}...`:t}function xx(e,t,n){return`${e}:${t}:${_p(n)}`}function Sx(e,t){let n=[];return e.forEach(({item:r,linkedTest:i},a)=>{let o=t[a];if(o.trusted)return;let s=_p(i.command??"");n.push(`${r.id}:${o.source_ref??"unknown"}->${o.current_source_ref??"unknown"}:${s}`)}),n}async function yp(e,t,n,r){let i=new Set(e.map(S=>S.id.toLowerCase())),a=0,o=0,s=new Set,c=[],l=e.flatMap(S=>(S.tests??[]).map(k=>({item:S,linkedTest:k}))),d=await yo(wo()),u=await Pm(r,l.map(({linkedTest:S})=>S),d),m=Sx(l,u);for(let{item:S,linkedTest:k}of l){if(typeof k.command!="string"||k.command.trim().length===0)continue;a+=1;let R=Im(k.command,t);if(R.length!==0){o+=R.length;for(let T of R)s.add(T),i.has(T.toLowerCase())||c.push(xx(S.id,T,k.command))}}let p=[...new Set(c)].sort((S,k)=>S.localeCompare(k)),f=[...new Set(p.map(S=>S.split(":")[1]??""))].filter(S=>S.length>0).sort((S,k)=>S.localeCompare(k)),h=[];p.length>0&&h.push(`validate_command_references_stale_pm_ids:${p.length}`),m.length>0&&h.push(`validate_linked_test_trust_unacknowledged:${m.length}`);let g=n?Number.POSITIVE_INFINITY:mt,w=Q(p,g),v=Q(f,g),x=Q([...s].sort((S,k)=>S.localeCompare(k)),g),b=Q(m,g);return{check:{name:"command_references",status:h.length===0?"ok":"warn",ok:h.length===0,details:{checked_items:e.length,linked_commands_scanned:a,referenced_pm_ids_count:o,unique_referenced_pm_ids_count:s.size,unique_referenced_pm_ids:x.values,unique_referenced_pm_ids_truncated:x.truncated,linked_test_trust_current_source_ref:d??null,untrusted_linked_tests_count:m.length,untrusted_linked_tests:b.values,untrusted_linked_tests_truncated:b.truncated,stale_pm_id_references_count:p.length,stale_pm_ids_count:f.length,stale_pm_ids:v.values,stale_pm_ids_truncated:v.truncated,stale_pm_id_reference_rows:w.values,stale_pm_id_reference_rows_truncated:w.truncated}},warnings:h}}function Ex(e,t){let n=sr(e.map(c=>({ref:c.id,version:or(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=Q(n.outdated,i),o=Q(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:Ns,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 Ao="pm validate auto-fix";async function wp(e,t,n){switch(e.kind){case"set_resolution":case"set_close_reason":case"set_estimate":case"reparent":case"unset_parent":{let r={message:Ao};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 xo(e){return e.kind!=="prune_file_link"&&e.kind!=="prune_doc_link"?null:`${e.kind}:${e.item_id}`}async function vp(e,t,n){let r=[],i=[],a=new Map;for(let o of e.filter(s=>xo(s)===null))try{await wp(o,t,n),r.push(o)}catch(s){i.push({fix:o,error:s})}for(let o of e.filter(s=>xo(s)!==null)){let s=xo(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 xm(s.item_id,{remove:c,message:Ao},t):await bm(s.item_id,{remove:c,message:Ao},t),r.push(...o)}catch(l){i.push(...o.map(d=>({fix:d,error:l})))}}return{applied:r,failed:i}}var tP={applyValidateFix:wp,applyValidateFixes:vp,attachValidateFixHints:Xm,buildCommandReferencesCheck:yp,buildDependencyReferencesCheck:op,buildCloseReasonBackfillRows:np,buildFilesCheck:gp,buildLifecycleCheck:hp,buildLifecycleDependencyGraph:ap,buildLifecycleParentGraph:vo,buildEstimateBackfillRows:rp,buildMetadataCounts:ep,buildMissingFieldOccurrences:tp,buildOrphanedPathRows:mp,classifyOrphanedPath:dp,collectDefaultProjectFileCandidates:Eo,collectTrackedGitFileCandidates:Ym,detectLifecycleDependencyCycles:lp,detectLifecycleParentCycles:bo,escapeRegExp:ip,extractItemIds:sp,findLifecycleDependencyCycleComponents:cp,isMetadataFieldMissing:Jm,linkedArtifactPathExceedsFilesystemLimits:fp,listFilesRecursive:Co,resolveDependencyCycleSeverity:Bm,resolveParentCycleSeverity:Hm,resolveFileScanMode:Vm,resolveLifecycleDependencyCycleSamplePath:ci,resolveRequestedChecks:Zm,resolveValidateMetadataProfile:Gm,resolveWorkspaceRoot:Km,sharedDirectoryPrefixLength:up,summarizeOrphanedPathRows:pp,summarizeDuplicateIssueCodes:Qm,toMeaningfulString:Ge};async function Ax(e,t,n,r){let i=await Yu(e,new Set(t.map(h=>h.id)),n,{schema:r.schema,extensionFieldNames:Et(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 Zr(e);s.tracked_path_count>0&&a.push(`validate_storage_tracked_runtime_cache_files:${s.tracked_path_count}`);let c=await Il(e,Nr(r));c.status==="drift"&&a.push(`validate_merge_fence_drift:${c.missing_patterns.length+c.stale_patterns.length}`);let l=await yt(e),d=l===null?null:await Lr(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 Dn(l,{includeLossless:!0,pmRoot:e}),{pendingDecisions:m,lossless:p}=ei(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(h=>h.item_id))].sort((h,g)=>h.localeCompare(g)),lossless_merge_receipt_count:p.length,lossless_merge_receipt_items:[...new Set(p.map(h=>h.item_id))].sort((h,g)=>h.localeCompare(g)),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&&Xm(t.check,t.warnings),e.checks.push(t.check),e.warnings.push(...t.warnings)}async function Rx(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=lx(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=dx(e.items,e.statusRegistry,r);t.resolutionBackfillRows=i.resolutionBackfillRows,rt(t,i,n)}if(e.requestedChecks.has("lifecycle")){let i=hp(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,op(e.items,r,e.statusRegistry),n)}if(e.requestedChecks.has("files")){let i=await gp(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,await yp(e.items,e.settings.id_prefix,r,e.pmRoot),n),e.requestedChecks.has("history_drift")&&rt(t,await Lm(e.pmRoot,e.items,r),n),e.requestedChecks.has("format_version")&&rt(t,Ex(e.items,r),n),e.requestedChecks.has("storage_integrity")&&rt(t,await Ax(e.pmRoot,e.items,q(e.settings,z()).type_to_folder,e.settings),n),t}function Ix(e,t,n){let r=[];return e.autoFix===!0&&(r.push(...rm(t.closeReasonBackfillRows)),r.push(...nm(t.resolutionBackfillRows)),r.push(...im(t.estimateBackfillRows,n.validation.estimate_defaults_by_type)),r.push(...am(t.terminalParentFixRows))),e.pruneMissing===!0&&r.push(...om(t.staleLinkPruneRows)),r}async function Cx(e,t,n,r,i,a){if(e.autoFix!==!0&&e.pruneMissing!==!0)return;let o=Ix(e,t,n),{applicable:s,gated:c}=cm(o,r),l=e.dryRun===!0,d=[],u=[];if(!l){let m=await vp(s,i,a);d.push(...m.applied.map(Nn)),u.push(...m.failed.map(({fix:p,error:f})=>({...Nn(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(Nn),applied_fixes:d,gated_fixes:c.map(m=>({...Nn(m),gate_hint:`Withheld: re-run with --fix-scope ${m.gate} to apply.`})),failed_fixes:u}}async function bp(e,t,n={}){Ts(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=sm(e.fixScope),a=F(process.cwd(),t.path);await oe(a);let o=await I(a),s=$e(o.schema),c=q(o,z()),l=Zm(e),d=[],u=await Nm({includeBody:l.has("history_drift"),pmRoot:a,settings:o,typeToFolder:c.type_to_folder,warnings:d});if(l.has("history_drift")){let A=await wn(a);A.actionable_unknown_event_count>0&&d.push(`validate_history_unknown_author_events:${A.actionable_unknown_event_count}`)}let m=typeof e.metadataProfile=="string"?"option":"settings",p=Gm(typeof e.metadataProfile=="string"?e.metadataProfile:o.validation.metadata_profile),f=Yk(p,m,o.validation.metadata_required_fields),h=Vk(o),g=Bm(e.dependencyCycleSeverity),w=Hm(e.parentCycleSeverity),v=Vm(e.scanMode),x=Km(a),b=await Rx({requestedChecks:l,options:e,global:t,pmRoot:a,workspaceRoot:x,settings:o,items:u,statusRegistry:s,metadataPolicy:f,lifecyclePatternPolicy:h,dependencyCycleSeverity:g,parentCycleSeverity:w,fileScanMode:v,initialWarnings:[...new Set(d)]}),S=r?await Cx(e,b,o,i,t,n):void 0,k=[...new Set(b.warnings)].sort((A,U)=>A.localeCompare(U)),T={ok:!b.checks.some(A=>A.status==="error"),has_warnings:k.length>0,checks:b.checks,warnings:k,...S!==void 0?{fixes:S}:{},generated_at:$(),projection:{mode:"full",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:["diagnostic_rows"]}};return e.counts!==!0?T:{...Jk(T),projection:{mode:"counts",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:[]}}}import{execFile as Tx}from"node:child_process";import{promisify as $x}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 Ox=$x(Tx),Dx=16,Px=3e4;function Nx(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 Lx(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 Mx(e,t,n,r){let i=Lx(e,t),a=Promise.resolve().then(()=>e.resolve({provider:e.id,key:t.key,parameters:i,trigger:r,pm_root:n,...Os(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??Px),o.unref?.()})]);return Nx(e,t.key,s)}finally{clearTimeout(o)}}function xp(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 kp(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:xp(i.details,n,r,t),population_size:1,cost:e.checks.length}}async function Fx(e,t){if(t?.trim())return t.trim();try{let{stdout:n}=await Ox("git",["rev-parse","HEAD^{commit}"],{cwd:e,encoding:"utf8",timeout:5e3,windowsHide:!0});return n.trim()}catch{return"working-copy"}}async function jx(e,t){let n=new Array(t.length),r=0,i=Array.from({length:Math.min(Dx,t.length)},async()=>{for(;r<t.length;){let a=r;r+=1;let o=t[a],s=await cr(Yn(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 Un(e,t={}){let n=await I(e),r=q(n),i=$e(n.schema),o=(await Nt(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 Fx(e,t.tree_id),items:o,history:t.include_history===!1?[]:await jx(e,o),terminal_statuses:[...i.terminal_statuses],provider_capabilities:{...l,...t.provider_capabilities},external:async p=>{if(p.kind==="graph"){let g=re({operation:p.operation,parameters:p.parameters??{}}),w=d.get(g);w===void 0&&(w=gc(p.operation,void 0,void 0,{...p.parameters,full:!0},s),d.set(g,w));let v=await w;return{value:xp(v,p.field,p.kind),population_size:o.length,cost:o.length}}if(p.kind==="validate"){u??=bp({counts:!0},s);let g=await u;return kp(g,p.check,p.field,p.kind)}if(p.kind==="health"){m??=Vu(s,{checkOnly:!0,full:!0});let g=await m;return kp(g,p.check,p.field,p.kind)}let f=t.providers?.[p.provider];if(f)return f(p);let h=Js(c,p.provider);if(!h)throw new TypeError(`assurance provider ${p.provider} is not registered`);return Mx(h.runtime_definition,p,e,t.trigger??"sdk")}}}import{createHash as Ux}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 fi(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 gi=["production_defect","nightly_regression","scanner_finding","review_caught_late"],$o=["gate_added","gate_strengthened","explicit_waiver"],Sp=256,zx=1024,zn=new Map,qx=["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 Ep(e){return Ux("sha256").update(re(e)).digest("hex")}function To(e,t){if(typeof e!="string"||!e.trim())throw new TypeError(`${t} must be a non-empty string`)}function qn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function en(e){return Array.isArray(e)&&e.every(t=>typeof t=="string")}function Rp(e,t){if(!qn(e))throw new TypeError(`${t} must be an object`);for(let n of qx)if(e[n]!==void 0&&!en(e[n]))throw new TypeError(`${t}.${n} must be an array of strings`);return e}function Wx(e,t){if(!qn(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&&!en(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&&!en(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>Sp)throw new TypeError(`defect recurrence family ${t} file pattern exceeds ${Sp} characters`)}function Gx(e,t){if(To(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(!gi.includes(e.escape_class))throw new TypeError(`defect recurrence family ${e.id} has an invalid escape class`);To(e.title,`defect recurrence family ${e.id} title`),To(e.owner_item_id,`defect recurrence family ${e.id} owner_item_id`)}function Bx(e){if(!en(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(Wx(e.triggers,e.id),!qn(e.checks)||!en(e.checks.local)||!en(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 Hx(e){if(!qn(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 Jx(e){let t=Rp(e.negative_control,`defect recurrence family ${e.id} negative_control`);if(Do(e,t,{}).length===0)throw new TypeError(`defect recurrence family ${e.id} negative_control must select its own family`)}function Oo(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(!qn(n))throw new TypeError("defect recurrence family must be an object");Gx(n,t),Bx(n),Hx(n),Jx(n)}}function Vx(e,t){let n=zn.get(e);if(n===void 0){if(zn.size>=zx){let i=zn.keys().next().value;zn.delete(i)}let r=e.replaceAll("**","\0").replaceAll(/[|\\{}()[\]^$+?./]/gu,"\\$&").replaceAll("*","[^/]*").replaceAll("\0",".*");n=new RegExp(`^${r}$`,"u"),zn.set(e,n)}return n.test(t)}function Kx(e,t){let n=[],r=ge(e.triggers.file_patterns??[]);for(let i of ge(t.files??[]))for(let a of r)Vx(a,i)&&n.push({signal:"file",value:i,matched:a});return n}function Yx(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 Xx(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 Do(e,t,n){return[...Kx(e,t),...Yx(e,t),...Xx(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 Zx(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 Qx(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={}){Oo(e);let r=[...e.families].sort((d,u)=>d.id<u.id?-1:1),i=Ep({...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=fi(d),m=r.filter(p=>p.historical_item_ids.includes(d.id)||Do(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:Ep({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 Cp(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=Zx(n.cursor,e.index_fingerprint),a=e.families.flatMap(d=>{let u=Do(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:Qx(t),families_selected:a.length,estimated_output_tokens:Math.ceil(JSON.stringify(l).length/4)}}}function eS(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 hi(e){return typeof e=="string"&&e.trim().length>0}function Ap(e){return Array.isArray(e)&&e.length>0&&e.every(hi)}function tS(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return{valid:!1,expired:!1};let n=e;if(!$o.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:hi(n.waiver_reason)&&Number.isFinite(r)&&r>=t,expired:Number.isFinite(r)&&r<t}}return{valid:hi(n.gate_id)&&hi(n.negative_control)&&Ap(n.local_checks)&&Ap(n.hosted_checks),expired:!1}}function nS(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.`}):gi.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=tS(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 yP(e,t,n,r=new Date){Oo(t);let i=Date.parse(t.evidence_epoch),a=new Set(n),o=e.filter(m=>a.has(m.status)&&eS(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 h=Date.parse(typeof m.created_at=="string"?m.created_at:"");return!Number.isFinite(h)||h>=i}),c=Object.fromEntries(gi.map(m=>[m,0])),l=Object.fromEntries($o.map(m=>[m,0])),d=o.filter(m=>typeof m.escape_class=="string"&&gi.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"&&$o.includes(p)&&(l[p]+=1)}let u=s.flatMap(m=>nS(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 rS(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 Oo(t),t}function Tp(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:rS(t.policy),change:n,...t.cursor===void 0?{}:{cursor:t.cursor},...t.limit===void 0?{}:{limit:t.limit}}}import{createHash as iS}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]="f66a964d-1352-5523-ab91-5177d0d93ce8")}catch{}})();var Po,$p=["list","show","put","remove","run","verdicts","presets","apply","derive","promote","risk"],No=["measurement","assertion","gate"];function aS(e){if($p.includes(e))return e;throw gr({command_path:"assurance",token:e,allowed:$p,display_name:"assurance action"})}function tn(e,t,n){throw new y(t,_.USAGE,{code:"missing_required_argument",required:`Provide the missing assurance operand: ${e}.`,examples:[n],recovery:{missing:[e]}})}function oS(e){if(!e)return tn("kind",`Assurance declaration kind is required. Expected: ${No.join(", ")}`,"pm assurance list measurement");if(No.includes(e))return e;throw new y(`Assurance declaration kind is required. Expected: ${No.join(", ")}`,_.USAGE)}function Op(e){if(!e)return tn("preset",`Assurance preset is required. Expected: ${hn.join(", ")}`,"pm assurance apply software-delivery --owner <pm-item-id>");if(hn.includes(e))return e;throw new y(`Assurance preset is required. Expected: ${hn.join(", ")}`,_.USAGE)}function Lo(e){return e.owner?.trim()?e.owner.trim():tn("owner","assurance preset and derivation actions require --owner <pm-item-id>","pm assurance apply software-delivery --owner <pm-item-id>")}function sS(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 cS(e){let[t,n,r]=await Promise.all([fn(e,"measurement"),fn(e,"assertion"),fn(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 lS(e,t){let n=t.authorization_decision;if(!n)return[];let r=await Un(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 dS(e,t){let n=ea(e.limit,"assurance verdict limit");if(n!==void 0&&(n<1||n>jt))throw new y(`assurance verdict limit must be an integer from 1 through ${jt}`,_.USAGE);let r=await Dc(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 uS(e,t,n){if(e==="presets"){if(t.preset??t.id)return Ir(Op(t.preset??t.id),Lo(t));let i=hn.map(a=>{let o=Ir(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 Ft(()=>Nc(n,Op(t.preset??t.id),Lo(t),{author:t.author,message:t.message}));if(e==="derive"){let i=await Lc(await Un(n,{resolve_tree:!1,trigger:"derive"}),Lo(t)),a=t.apply?await Ft(()=>Mc(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)return tn("assertion-id","assurance promote requires an assertion id","pm assurance promote <assertion-id> --enforcement warn");if(t.enforcement!=="warn"&&t.enforcement!=="block")throw new y("assurance promote requires --enforcement warn|block",_.USAGE);let r=await Vi(n,"assertion",t.id);return Ft(()=>Fc(n,r,t.enforcement,{author:t.author,message:t.message}))}async function mS(e,t,n){if(!e.id)return tn("gate-id","assurance run requires a gate id","pm assurance run <gate-id> --trigger ci --dry-run");let r=e.id;if(!e.trigger)throw new y("assurance run requires a trigger",_.USAGE);if(!_t.includes(e.trigger))throw new y(`Unknown assurance trigger ${e.trigger}. Expected: ${_t.join(", ")}`,_.USAGE);let i=e.trigger,[a,o]=await Promise.all([cS(t),Un(t,{...n.workspace,tree_id:e.tree,trigger:i})]),s=await _c(()=>Cc(r,a,o,{trigger:i,dry_run:e.dry_run===!0}));return s.dry_run||await Oc(t,s,{author:e.author,message:e.message}),s}function Pp(e){throw e instanceof y?e:new y(e instanceof Error?e.message:"assurance risk request is invalid",_.USAGE)}function pS(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 Tp(t)}catch(n){return Pp(n)}}function fS(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 hS(e,t,n){let r=re(t.policy),i=Po?.pm_root===e?Po:void 0,a=new Map(n.map(l=>[l.id,iS("sha256").update(re(fi(l))).digest("hex")])),o=i?.policy_serialized===r?i:void 0,s=o?fS(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 Po={pm_root:e,policy_serialized:r,item_fingerprints:a,index:c},c}async function gS(e,t){let n=pS(e),r=await Un(t,{include_history:!1,resolve_tree:!1});try{return Cp(hS(t,n,r.items),n.change,{cursor:n.cursor,limit:n.limit})}catch(i){return Pp(i)}}async function _S(e,t={},n={}){let r=aS(e.action),i=F(process.cwd(),t.path);if(r==="presets"||r==="apply"||r==="derive"||r==="promote")return uS(r,e,i);if(r==="verdicts")return dS(e,i);if(r==="run")return mS(e,i,n);if(r==="risk")return gS(e,i);let a=oS(e.kind);if(r==="list")return fn(i,a);if(!e.id)return tn("id",`assurance ${r} requires an id`,`pm assurance ${r} ${a} <id>`);let o=e.id;if(r==="show")return Vi(i,a,o);if(r==="remove"){let d=await Ft(()=>$c(i,a,o,{author:e.author,message:e.message}));return Dp(d,e.idOnly)}let s=sS(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 lS(i,s)}:{}},l=await Ft(()=>Ar(i,a,s,c));return Dp(l,e.idOnly)}function PP(e,t,n){let r={...e,...t};return _S({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:ea(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 yS}from"node:child_process";import wS from"node:path";import{promisify as vS}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 bS=vS(yS),kS="@unbrained/pm-cli",xS="latest";function SS(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 yi(e){return e.trim().toLowerCase()}function Np(e,t){let n=yi(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"&&yi(i)===n)}function ES(e,t){let n=F(process.cwd(),t.path),r=At(n,process.cwd());return{selected_root:e==="global"?r.global:r.project}}async function AS(e,t,n){try{let r=await bS(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(" ")}
|
|
46
|
-
${a}`,_.GENERIC_FAILURE)}}async function RS(){return Yo(import.meta.url,["../../.."])}function wi(e){return typeof e.tag=="string"&&e.tag.trim().length>0?e.tag.trim():xS}function _i(e){return typeof e.packageName=="string"&&e.packageName.trim().length>0?e.packageName.trim():kS}async function IS(e,t){let n=e.commandRunner??AS,r=_i(e),i=wi(e),a=`${r}@${i}`,o=["npm","install","-g",a];e.repair===!0&&o.push("--force");let s=await RS(),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 CS(e){return wS.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")||e.startsWith("file:")}function TS(e,t){if(e.kind==="npm"){let n=e.input.startsWith("npm:")?e.input.slice(4).trim():e.input.trim();return!CS(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 $S(e,t){let n=TS(e,t);return e.kind!=="local"||await O(n)?n:await O(e.location)?e.location:n}function OS(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 Lp(e,t){let n=ES(e,t);return(await pe(n.selected_root)).state.entries.filter(i=>i.scope===e)}async function DS(e,t,n){let r=await Lp(e,t);return r.find(i=>Np(i,n.name))??r.find(i=>yi(i.directory)===yi(n.directory))}async function PS(e,t,n,r,i){let a=wi(t),o=await $S(e.source,a),s=OS(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 Ga(o,{install:!0,project:r==="project",global:r==="global",ref:e.source.kind==="github"?e.source.ref:void 0},n);let l=await DS(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 NS(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 zP(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=SS(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 IS(t,i):{requested:!1,status:"skipped",package:_i(t),target:`${_i(t)}@${wi(t)}`,command:["npm","install","-g",`${_i(t)}@${wi(t)}`],repair:t.repair===!0,reason:"not_requested"},l=s?await Lp(r,n):[];if(a&&(l=l.filter(m=>Np(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 PS(m,t,n,r,i));let u=NS(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 nn from"node:fs/promises";import bi from"node:path";import vi from"node:fs/promises";import Mo 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 LS=864e5;function MS(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 FS(e,t){let n;try{n=await vi.readdir(e,{withFileTypes:!0})}catch(i){if(j(i))return[];throw i}let r=[];for(let i of n)if(i.isDirectory()){let a=Mo.join(e,i.name),o;try{o=await vi.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 Mp(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*LS,o=Mo.join(e,"checkpoints"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c=await FS(o,s.warnings);for(let l of c){let d=Mo.join(o,l),u=`checkpoints/${l}`;s.scanned+=1,r?.onRead&&s.warnings.push(...await r.onRead(d));let m;try{m=await vi.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=MS(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 h=i-f,g={file:u,created_at:p,age_seconds:Math.floor(h/1e3),stale:h>a,reason:h>a?"expired":"active"};if(!g.stale){s.retained.push(u),s.entries.push(g);continue}if(!n){try{await vi.unlink(d)}catch(w){if(!j(w)){s.warnings.push(`checkpoint_remove_failed:${l}`),s.retained.push(u),s.entries.push(g);continue}}r?.onWrite&&s.warnings.push(...await r.onWrite(d))}s.removed.push(u),s.entries.push(g)}return s}import Fo from"node:fs/promises";import Fp 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 jS=1440*60*1e3,US=new Set(["committed","compensated"]);function zS(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 qS(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 US.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 WS(e,t,n,r){let i=r.hooks?.onRead?await r.hooks.onRead(e):[],a=zS(await Fo.readFile(e,"utf8")),o=qS(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 Fo.rm(e,{force:!0}),r.hooks?.onWrite&&i.push(...await r.hooks.onWrite(e))),{decision:o,warnings:i}}async function jp(e,t){let{dryRun:n,hooks:r}=t,i=t.now??Date.now(),a=Math.max(0,t.retentionDays)*jS,o=Fp.join(e,"transactions","sdk"),s={scanned:0,removed:[],retained:[],warnings:[],entries:[]},c;try{c=(await Fo.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=Fp.join(o,l),u=`transactions/sdk/${l}`,m=await WS(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]="76f8405f-138d-5119-a300-f068354394a5")}catch{}})();var Wn=["index","embeddings","runtime","locks","checkpoints","transactions"],GS=1440*60*1e3,BS=[{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 HS(e,t,n){let r=t.relativePath,i=bi.join(e,r),a=await Je({path:i,scope:"project"});try{let o=await nn.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 nn.unlink(i):await nn.rm(i,{recursive:!0,force:!0});let s=await ae({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 JS(e,t){let n=[{relativePath:"runtime/workspace-snapshots/objects",prefix:".create-"},{relativePath:"runtime/workspace-snapshots/refs",prefix:".ref-"}],r=[],i=[],a=[],o=Date.now()-GS;for(let s of n){let c=bi.join(e,s.relativePath);if(!await O(c))continue;let l=(await nn.readdir(c)).filter(d=>d.startsWith(s.prefix)).sort();for(let d of l){let u=bi.posix.join(s.relativePath,d),m=bi.join(c,d);a.push(...await Je({path:m,scope:"project"}));let p=await nn.stat(m).catch(f=>{if(!j(f))throw f});if(p){if(p.mtimeMs>o){i.push(u);continue}r.push(u),!t&&(await nn.rm(m,{recursive:!0,force:!0}),a.push(...await ae({path:m,scope:"project",op:"gc:workspace_snapshot_temp_remove"})))}}}return{removed:r,retained:i,warnings:a}}function VS(e){if(!e||e.length===0)return[...Wn];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 (${Wn.join(",")})`,_.USAGE);let n=new Set;for(let r of t){if(!Wn.includes(r))throw new y(`Invalid --scope value "${r}". Expected one or more of: ${Wn.join(", ")}`,_.USAGE);n.add(r)}return Wn.filter(r=>n.has(r))}function KS(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 dN(e,t={}){let n=F(process.cwd(),e.path);await oe(n);let r=await I(n),i=t.dryRun===!0,a=VS(t.scope),o=BS.filter(f=>a.includes(f.scope)),s=[],c=[],l=[];for(let f of o){let h=await HS(n,f,i);h.removed?s.push(f.relativePath):c.push(f.relativePath),l.push(...h.warnings)}if(a.includes("runtime")){let f=await JS(n,i);s.push(...f.removed),c.push(...f.retained),l.push(...f.warnings)}let d;if(a.includes("locks")){let f=await ml(n,{dryRun:i,hooks:{onRead:h=>Je({path:h,scope:"project"}),onWrite:h=>ae({path:h,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,h=await jp(n,{dryRun:i,retentionDays:f,hooks:{onRead:g=>Je({path:g,scope:"project"}),onWrite:g=>ae({path:g,scope:"project",op:"gc:transaction_journal_remove"})}});s.push(...h.removed),c.push(...h.retained),l.push(...h.warnings),u={scanned:h.scanned,removed:h.removed.length,retained:h.retained.length,retention_days:f}}let m;if(a.includes("checkpoints")){let f=r.checkpoints.retention_days,h=await Mp(n,{dryRun:i,retentionDays:f,hooks:{onRead:g=>Je({path:g,scope:"project"}),onWrite:g=>ae({path:g,scope:"project",op:"gc:checkpoint_remove"})}});s.push(...h.removed),c.push(...h.retained),l.push(...h.warnings),m={scanned:h.scanned,removed:h.removed.length,retained:h.retained.length,retention_days:f}}l.push(...await ar({mode:i?"gc:dry-run":"gc",total_items:o.length}));let p=KS({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 YS from"node:fs/promises";import Gn 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]="1bcd20e1-2995-56ef-8d04-f265b8282c19")}catch{}})();var jo="index/manifest.json",Uo="search/embeddings.jsonl",XS="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function ZS(e){return e.progress===!0||process.stderr.isTTY===!0}function se(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
|
|
47
|
-
`)}catch{}}function QS(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 eE(e,t,n,r){let i=[];return{candidates:await Hs(e,t,n,i,r),warnings:i}}async function qo(e,t,n,r,i){let a=Et(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 YS.readFile(s.item_path,"utf8"),l=Ot(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:${Gn.relative(e,s.item_path)}`),o.push({metadata:s.metadata,body:""})}}return o}function tE(e,t,n){let r=e.metadata;return{id:r.id,mode:t,updated_at:r.updated_at,corpus:Qs(e,{fields:n})}}var rn=X;function nE(e){let t=z(),n=rn(e.search?.provider);if(!n)return null;let r=Vs(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=rn(i.name)??rn(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 rE(e){let t=z(),n=rn(e.vector_store?.adapter);if(!n)return null;let r=Ks(t,n);if(!r)return null;let i=r.runtime_definition??r.definition,a=rn(i.name)??rn(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 zo(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 iE(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)=>zo(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(zo(s,`extension search provider "${e.name}" embed output at index ${a}`))}return i}function Up(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function zp(e,t,n){let r=n?gt(n.name,Up(e)):t?gt(t.name,t.model):null;if(!r)throw new y("No embedding identity available for semantic reindex mode",_.USAGE);return r}function aE(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,r)=>n.localeCompare(r))}async function qp(e,t,n,r,i,a,o,s){let c=r?.name??n?.name,l=ec(c,e.search.embedding_corpus_max_characters).maxCharacters,d=Fi(e),u=i.map(f=>tc(f,{providerName:c,maxCharacters:l,fields:d})),m=[],p=null;if(r)try{m=await iE(r,e,u),p=gt(r.name,Up(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 nc(n,e,u,{onProgress:h=>{h.phase==="complete"&&(o.batches_completed=h.batch_index),se(s,`embedding_batch_${h.phase} batch=${h.batch_index}/${h.batch_total} size=${h.batch_size} completed_inputs=${h.completed_inputs}/${h.total_inputs}`)}});a.push(...f.warnings),m=f.vectors,p=gt(n.name,n.model)}if(se(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 oE(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 ac(e,o,{},a)}async function Wp(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 ic(e,n)}}function sE(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function cE(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 lE(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=dn(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=yr(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 dE(e){let t=q(e.settings,z()),n=await eE(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 uE(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 zp(e.settings,dn(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&Lt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(XS))}async function mE(e){let t=await Mt(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=zp(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),r=new Set(e.metadataDocuments.map(l=>l.metadata.id)),i=aE(t.entries,r),a=Lt(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 qo(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 pE(e){let t=new Set(e.metadataDocuments.map(i=>i.metadata.id)),n=await qo(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,se(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let r=await qp(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...r,staleDocuments:n,vectorDimension:ji(r.vectors,"Reindex embeddings")}}async function fE(e){let t=await qp(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,r=t.embeddingIdentity,i=ji(n,"Reindex embeddings");if(!(!e.resetRequired&&(Lt(e.ledgerEmbedding,r)||sc(e.ledgerEmbedding,i))))return{vectors:n,embeddingIdentity:r,staleDocuments:e.staleDocuments,vectorDimension:i,resetRequired:e.resetRequired};let o=await pE(e);return n=o.vectors,r=o.embeddingIdentity,i=o.vectorDimension,{vectors:n,embeddingIdentity:r,staleDocuments:o.staleDocuments,vectorDimension:i,resetRequired:!0}}async function hE(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(se(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,se(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)})`),se(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){se(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await rc(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,se(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 gE(e,t){return e.map((n,r)=>({id:n.metadata.id,vector:zo(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 _E(e){se(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await fE({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?(se(e.progressEnabled,"vector_reset_start"),await oE(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),se(e.progressEnabled,"vector_reset_complete")):await Wp(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=gE(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await hE({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:oc(t.embeddingIdentity,t.vectorDimension)}}async function yE(e){let t=await mE(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(se(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 se(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await Wp(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let r=await _E({...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 wE(e){let t=Gn.join(e.pmRoot,jo),n=Gn.join(e.pmRoot,Uo),r=Fi(e.settings),i=e.documentsForKeywordArtifacts.map(o=>JSON.stringify(tE(o,e.mode,r))).join(`
|
|
48
|
-
`);se(e.progressEnabled,"writing keyword artifacts"),await ie(t,`${JSON.stringify(e.manifest,null,2)}
|
|
49
|
-
`),await ie(n,`${i}
|
|
50
|
-
`);let a=[];if(e.mode!=="keyword")try{se(e.progressEnabled,"writing vectorization status ledger"),await cc(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 gN(e,t){let n=QS(e.mode),r=ZS(e),i=e.full===!0;se(r,`start mode=${n}`);let a=F(process.cwd(),t.path);await oe(a);let o=_r(await I(a)).settings,s=null;try{s=await de(a,Zs,o.locks.ttl_seconds,K(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=nE(o),l=rE(o),d=lE({requestedMode:n,pmRoot:a,settings:o,extensionEmbedding:c,extensionVectorAdapter:l}),u=n;se(r,"loading item corpus");let m=await dE({pmRoot:a,settings:o}),p=m.warnings,{documentCandidates:f,metadataDocuments:h}=m;se(r,`loaded_items=${h.length}`);let g=$(),w=cE(u,g,h),v=Gn.join(a,jo),x=Gn.join(a,Uo),b=u==="keyword"?await qo(a,f,o.schema,p):h,S=[],k={},R=null,T=sE(u);if(u==="keyword"&&await uE({pmRoot:a,settings:o,forceFullSemantic:i,extensionEmbedding:c,reindexWarnings:p}),u!=="keyword"){let B=await yE({pmRoot:a,settings:o,requestedMode:n,activeEmbeddingProvider:d.activeEmbeddingProvider,activeVectorStore:d.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:l,documentCandidates:f,metadataDocuments:h,documentsForKeywordArtifacts:b,forceFullSemantic:i,reindexWarnings:p,semanticWarnings:S,semanticSummary:T,progressEnabled:r});b=B.documentsForKeywordArtifacts,k=B.vectorizationLedgerEntries,R=B.vectorizationEmbeddingMetadata}let A=await wE({pmRoot:a,mode:u,manifest:w,documentsForKeywordArtifacts:b,settings:o,vectorizationLedgerEntries:k,vectorizationEmbeddingMetadata:R,progressEnabled:r}),U=[...await ae({path:v,scope:"project",op:"reindex:manifest"}),...await ae({path:x,scope:"project",op:"reindex:embeddings"}),...await ar({mode:u,total_items:h.length})];return se(r,"done"),{ok:!0,mode:u,total_items:h.length,semantic:T,artifacts:{manifest:jo,embeddings:Uo},warnings:[...p,...S,...A,...U],generated_at:g}}finally{await s?.()}}export{sR as a,jl as b,D as c,ve as d,Fe as e,Ft as f,_c as g,wc as h,_t as i,zi as j,Zp as k,Gi as l,Bi as m,xc as n,Ut as o,pn as p,Ji as q,yf as r,Cc as s,fn as t,Vi as u,Ar as v,Ki as w,$c as x,Oc as y,Dc as z,hn as A,Ir as B,Nc as C,Lc as D,Mc as E,Fc as F,$r as G,qc as H,C as I,ee as J,Ef as K,ea as L,dA as M,uA as N,Jc as O,mA as P,pA as Q,fA as R,hA as S,gA as T,ta as U,_A as V,yA as W,Qi as X,wA as Y,vA as Z,Vc as _,bA as $,Df as aa,Xc as ba,$A as ca,wn as da,OA as ea,Uf as fa,zf as ga,DA as ha,qf as ia,uh as ja,mh as ka,yt as la,IR as ma,wh as na,og as oa,OI as pa,DI as qa,PI as ra,kn as sa,NI as ta,LI as ua,MI as va,FI as wa,jI as xa,UI as ya,zI as za,qI as Aa,WI as Ba,GI as Ca,BI as Da,Ga as Ea,MA as Fa,FA as Ga,rl as Ha,Hw as Ia,F$ as Ja,Dn as Ka,ei as La,j$ as Ma,U$ as Na,Vu as Oa,$0 as Pa,Yu as Qa,bm as Ra,W0 as Sa,em as Ta,xm as Ua,MO as Va,FO as Wa,sk as Xa,ck as Ya,qO as Za,WO as _a,GO as $a,BO as ab,dk as bb,uk as cb,mk as db,HO as eb,Am as fb,fk as gb,Rm as hb,fo as ib,Cm as jb,hk as kb,gk as lb,_k as mb,yo as nb,wo as ob,nD as pb,rD as qb,iD as rb,Jk as sb,tP as tb,bp as ub,Un as vb,gi as wb,$o as xb,Ip as yb,Cp as zb,yP as Ab,rS as Bb,Tp as Cb,$p as Db,No as Eb,_S as Fb,PP as Gb,zP as Hb,dN as Ib,gN as Jb};
|
|
51
|
-
//# sourceMappingURL=chunk-OY7QAV4Y.js.map
|