@unbrained/pm-cli 2026.8.19 → 2026.8.21

package/dist/cli-bundle/chunks/chunk-BKYB45NQ.js

@@ -0,0 +1,2092 @@
+import{a as dc,b as ot,c as _n,d as mc,e as pc,f as uc}from"./chunk-JSLOFXGA.js";import{C as $o,E as _c,a as Et,b as So,d as sc,j as Oo}from"./chunk-7VHZS727.js";import{E as ua,Fc as xc,G as b,Gb as je,H as fa,Hb as Ao,I as _a,Jb as ic,K as re,Ka as Xa,L as ha,La as vo,M as rn,N as ga,Na as Za,Nb as Co,O as _o,Oa as Qa,P as sn,Pa as ko,Q as ho,R as ke,S as go,T as K,Ta as mn,U as yo,V as se,W as ya,X as ba,Xc as Po,Y as bo,Z as wa,_ as wo,bc as xt,cc as To,db as ec,dc as ac,eb as pn,ec as Ie,fb as nc,fc as cc,ga as va,hb as tt,hc as lc,ia as za,ib as oc,ic as gc,ja as Ha,jb as un,jc as yc,kc as bc,la as It,lb as nt,ma as Ba,na as Va,oa as Wa,od as Fo,pa as Ka,pb as Ro,pd as Lo,qa as Ya,qb as rc,qc as wc,ra as Ja,rb as fn,rc as vc,rd as Rc,sc as kc,tc as Sc,uc as Ic,wc as Ec,xc as hn,xd as Ac,yb as Ne,yd as Cc}from"./chunk-OCLPLFAY.js";import{A as an,B as Ia,C as De,D as Ea,E as cn,F as xa,G as dn,Ga as ln,J as Ra,L as Aa,M as Ca,Ma as fc,N as Ta,O as Oa,P as $a,Q as Pa,R as Fa,S as La,T as Ma,U as Da,V as Na,W as ja,X as Ua,Y as Ga,Z as qa,b as ca,ta as St,w as ka,y as Me,z as Sa}from"./chunk-N3DSV4CH.js";import{A as da,B as la,Ka as tc,T as ma,Wb as Io,b as oa,c as en,d as fo,e as ra,f as tn,fb as Se,g as nn,h as on,i as sa,l as ia,n as aa,oc as Eo,tc as xo,wc as hc,xa as pa}from"./chunk-S4IRYKBU.js";import{$a as de,$c as Ce,$g as Ys,Af as Fs,Al as Vi,Bk as Oi,Bl as Wi,C as u,Ca as zn,Cb as ss,Cc as Ut,Ch as x,Cl as Ki,Da as Hn,Db as is,Dc as gt,Df as Ls,Dg as et,Dh as ni,Dl as Yi,E as p,Ea as Bn,Eb as as,Eh as oi,Ek as $i,El as Ji,Fa as Vn,Fb as cs,Fh as ri,Fl as Xi,G as ns,Gb as ds,Gc as F,Gl as Zi,H as ve,Hb as ls,Hc as _s,Ib as ms,Ic as oo,Id as Es,Ie as Os,Ig as so,Jd as xs,Jg as bt,Jl as Qi,Kc as hs,Kd as Rs,Kg as io,Kl as Qt,Lc as gs,Lf as Ms,Ll as ea,Mb as D,Ml as ta,N as Gn,Na as $,Nb as ps,Nh as Kt,Oa as Nt,Of as Ze,Ph as Yt,Q as S,Qc as Ke,Qg as wt,Qh as si,Rg as Hs,Rl as C,Sf as Ds,Sg as Bs,Sh as ii,T as Pt,Tg as Vs,Th as O,Tl as na,Uc as ys,Ue as $s,Ug as Ws,Uh as oe,V as os,Va as I,Vc as bs,Vh as z,W as Ft,Wd as ro,X as Lt,Xc as Ye,Xd as R,Xe as Ps,Xh as Le,Xk as Pi,Y as Mt,Ya as _t,Yc as Ae,Yd as Xe,Yf as Ns,Yg as Vt,Yh as ai,Yk as Fi,Z as Dt,Za as ht,Zc as ws,Zh as ci,_c as vs,_g as Ks,_h as Jt,ad as ks,ae,aj as po,bi as vt,c as V,ca as ue,cd as N,ci as di,cj as uo,d as Ve,dg as le,dh as Js,e as Un,ec as Wn,ed as yt,eg as $e,ei as ao,el as Li,f as G,fc as Kn,fd as Ss,g as W,gc as Yn,gg as zt,gi as co,gk as Ii,gl as Mi,h as ut,hg as ne,hh as Xs,i as Jr,ic as us,id as Is,ig as Pe,ik as Ei,ja as rs,jg as js,jk as Zt,ka as ft,kg as Fe,kh as he,ki as li,kk as xi,lg as Us,li as mi,m as Xr,ma as qn,mi as pi,mj as vi,ml as Di,n as Zr,ng as Gs,nh as Zs,ni as ui,nj as ki,nl as Ni,o as Qr,oc as fs,og as Qe,oh as Qs,oi as fi,ol as ji,p as es,pd as Te,pg as qs,qc as Jn,qg as Ht,qh as Wt,qi as _i,qk as Ri,rb as jt,rc as Xn,rd as Je,re as As,rg as _e,ri as hi,rl as Ui,s as ts,sc as Zn,sd as Gt,sg as Bt,sh as ei,si as gi,tc as Qn,ti as kt,uc as eo,ue as Cs,ug as zs,ui as yi,uk as Ai,vc as to,vd as qt,vi as Xt,vl as Gi,wb as We,wc as no,wd as fe,wg as X,wi as bi,wl as qi,xc as A,xd as Oe,xe as Ts,xi as lo,xj as Si,xl as zi,yi as mo,yk as Ci,yl as Hi,zh as ti,zi as wi,zk as Ti,zl as Bi}from"./chunk-2MA6ZQVZ.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]="bb16b445-3bd4-520d-becf-c55621bfa186")}catch{}})();var ty=Jr,ny=Xr,oy=es,ry=Zr,sy=Qr;function Tc(e,t,n,o){let r=e.flag.slice(2).replace(/[-_]([a-z])/gu,(i,a)=>a.toUpperCase()),s=n.has(r);return{long:t,...o?{short:o}:{},description:e.description??`Standard pm ${e.flag} option.`,...e.required===!0?{required:!0}:{},...e.list===!0?{list:!0}:{},...e.repeatable===!0?{repeatable:!0}:{},value_type:s?"string":"boolean",...s?{value_name:e.value_name??"value"}:{}}}function Oc(e,t=[]){let n=new Set(t.flatMap(r=>r.keys)),o=[];for(let r of Ii(e.map(s=>({...s})))){o.push(Tc(r,r.flag,n,r.short));for(let s of r.aliases??[])o.push(Tc(r,s,n))}return o}var iy=Oc(Zt,vi),tm=Oc(Qt,ki);import{AsyncLocalStorage as ag}from"node:async_hooks";import zl 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]="27dd77f6-e53d-55b7-be15-db0e60eaec4e")}catch{}})();function $c(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function nm(e){return e.brief===!0?"brief":typeof e.fields=="string"&&e.fields.trim().length>0||Array.isArray(e.fields)&&e.fields.length>0?"fields":e.compact===!0?"compact":"full"}function Mo(e,t){let n=nm(t),o=n==="brief"?n:$c(e.projection)&&typeof e.projection.mode=="string"?e.projection.mode:n;return{...e,query_summary:{filters:$c(e.filters)?e.filters:{},projection: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]="6ede8efb-54ec-5b13-a1bf-216b525acc12")}catch{}})();async function Pc(e,t){let n=I(t??process.cwd(),e),o=await x(n);return Le(n,o.item_format,$(o,null).type_to_folder,void 0,o.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]="cc342d27-aa2d-5e84-8441-46a35c42dc00")}catch{}})();var om=["invalid_envelope","source_incomplete","source_unchecked","filtered_corpus","terminal_items_excluded","strict_read_unproven","page_incomplete","count_mismatch","projection_incomplete","field_omission","budget_compaction","budget_omission","session_projection","invalid_item_id","duplicate_item_id"],gn=class extends Error{receipt;constructor(t){super(`Complete-list certification failed: ${t.map(n=>n.code).join(", ")}.`),this.name="PmCompleteListValidationError",this.receipt={contract_version:1,contract:"complete_list",findings:t,recovery:{suggested_retry:"pm list-all --full --strict-read --no-truncate --output-budget unbounded --json",sdk:"await client.listAllComplete()"}}}};function Do(e={}){return{excludeTerminal:!1,full:!0,...e.includeBody===void 0?{}:{includeBody:e.includeBody},noTruncate:!0,outputBudget:"unbounded",outputLimit:"unbounded",strictRead:!0}}function ge(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Y(e,t,n,o){t&&e.push({code:n,message:o})}function rm(e,t){let n=ge(e.completeness)?e.completeness:{};Y(t,n.status==="partial","source_incomplete","The source scan reported unreadable tracker artifacts."),Y(t,n.status!=="complete"&&n.status!=="partial","source_unchecked","The source scan did not prove completeness.");let o=ge(e.filters)?e.filters:{},r=ge(o.runtime_filters)?o.runtime_filters:{},s=new Set(["exclude_terminal","include_body","no_truncate","runtime_filters","status","strict_read"]);return Y(t,o.status!=="all"||Object.keys(r).length>0||Object.keys(o).some(i=>!s.has(i)),"filtered_corpus","The list did not explicitly select every lifecycle status."),Y(t,o.exclude_terminal===!0,"terminal_items_excluded","Terminal lifecycle states were explicitly excluded."),Y(t,o.strict_read!==!0,"strict_read_unproven","The result does not echo strict source-read enforcement."),o}function sm(e,t,n){Y(n,e.has_more!==!1||e.next_cursor!==null||e.truncated!==!1||e.applied_limit!==void 0||t.no_truncate!==!0,"page_incomplete","Pagination or a row ceiling may have withheld items."),Y(n,e.count!==e.items.length||e.total!==e.items.length,"count_mismatch","Envelope counts do not equal the returned item count.");let o=ge(e.projection)?e.projection:{};Y(n,o.mode!=="full"||o.fields!==null,"projection_incomplete","The result is not the full metadata projection.");let r=ge(e.omission_receipt)?e.omission_receipt:void 0;Y(n,r?.has_omissions===!0,"field_omission","The omission receipt reports withheld field groups.")}function im(e,t){let n=ge(e.read_output)?e.read_output:void 0;Y(t,n?.strings_compacted===!0||n?.rows_compacted===!0||e.output_budget_truncation!==void 0,"budget_compaction","Universal output shaping compacted the result.");let o=ge(e.output_budget_exceeded)?e.output_budget_exceeded:void 0;Y(t,n?.result_omitted===!0||o?.omitted_result===!0,"budget_omission","Universal output shaping omitted the useful result."),Y(t,e.read_session!==void 0,"session_projection","A cross-call read session can suppress previously served facts.")}function am(e,t){let n=e.map(o=>ge(o)&&typeof o.id=="string"?o.id.trim():"");Y(t,n.some(o=>o.length===0),"invalid_item_id","Every full item row must carry a non-empty string id."),Y(t,new Set(n).size!==n.length,"duplicate_item_id","Every item id must occur exactly once.")}function Fc(e){if(!ge(e)||!Array.isArray(e.items))return{ok:!1,findings:[{code:om[0],message:"The result must be an object with an items array."}]};let t=e,n=[],o=rm(t,n);return sm(t,o,n),im(t,n),am(t.items,n),{ok:n.length===0,findings:n}}function yn(e){let t=Fc(e);if(!t.ok)throw new gn(t.findings);let n=e;return{...n,complete_list:{contract_version:1,item_count:n.items.length,unique_item_id_count:new Set(n.items.map(o=>o.id)).size,terminal_items_included:!0,source_complete:!0,full_projection:!0,no_omissions:!0,unbounded:!0}}}function cm(e){yn(e)}(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]="b9eae1a3-3eb6-5415-86c3-a8e8e1fedd1f")}catch{}})();function Lc(e){return e.map(t=>({key:t.key,optionName:Ss(t),metadataKey:t.metadata_key,type:t.type,commands:[...t.commands],repeatable:t.repeatable,requiredOnCreate:t.required_on_create,...t.description?{description:t.description}:{}}))}function Mc(e){return e.map(t=>({command:t.command,action:t.action,arguments:t.arguments.map(n=>({name:n.name,required:n.required===!0,variadic:n.variadic===!0,description:n.description})),description:t.description,tier:t.tier??"standard"}))}(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]="7c898a52-eba4-5626-8207-5ffefd4990ba")}catch{}})();var dm=50,Ee=new Map;function No(){Ee.clear()}function Dc(e,t){let n=Ee.get(e);if(n!==void 0)return n;if(Ee.size>=dm){let r=Ee.keys().next().value;Ee.delete(r)}let o=t().catch(r=>{throw Ee.get(e)===o&&Ee.delete(e),r});return Ee.set(e,o),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]="6f62939a-7b99-5687-93ae-834e0032f1d5")}catch{}})();var lm={"list-all":{action:"list",options:{excludeTerminal:!1}},"list-draft":{action:"list",options:{status:"draft",excludeTerminal:!1}},"list-open":{action:"list",options:{status:"open",excludeTerminal:!1}},"list-in-progress":{action:"list",options:{status:"in_progress",excludeTerminal:!1}},"list-blocked":{action:"list",options:{status:"blocked",excludeTerminal:!1}},"list-closed":{action:"list",options:{status:"closed",excludeTerminal:!1}},"list-canceled":{action:"list",options:{status:"canceled",excludeTerminal:!1}}};function Nc(e){return Object.fromEntries($s.map(t=>[`${e}-${t}`,{action:e,options:{[t==="adopt-all"?"adoptAll":t]:!0,...e==="package"?{vocabulary:"package"}:{}}}]))}var jo={ctx:{action:"context"},...lm,...Nc("extension"),...Nc("package")};(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]="41012e87-ed61-56b2-8505-8f786b3952b2")}catch{}})();var jc="PmCliError";function mm(e){if(!Number.isFinite(e))throw new TypeError("createPmCliExpectedError options.exitCode must be a finite number");let t=Math.trunc(e);if(t<=u.SUCCESS)throw new TypeError("createPmCliExpectedError options.exitCode must be a positive exit code");return t}function pm(e,t={}){if(typeof e!="string"||e.trim().length===0)throw new TypeError("createPmCliExpectedError message must be a non-empty string");let n=new p(e,mm(t.exitCode??u.USAGE),t.context??{});return"cause"in t&&Object.defineProperty(n,"cause",{value:t.cause,enumerable:!1,configurable:!0,writable:!0}),n}function Uo(e){if(!(e instanceof Error)||e.name!==jc)return!1;let t=e;return typeof t.exitCode=="number"&&Number.isFinite(t.exitCode)}import{constants as Rt}from"node:fs";import{lstat as Uc,mkdir as qo,open as Gc}from"node:fs/promises";import ye 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]="bb5dfa6f-b60f-55f2-ae17-3dbcaaff1b47")}catch{}})();function Go(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Relationship event ${t} must be non-empty`);return e.trim()}function zo(e,t){let n=t.require(e.kind),o=n.direction==="undirected"?[e.source,e.target].sort().join("\0"):`${e.source}\0${e.target}`;return`${n.kind}\0${o}`}function um(e){return Object.freeze({...e,...e.payload===void 0?{}:{payload:Object.freeze(structuredClone(e.payload))}})}function fm(e,t,n,o){let r=n.require(e.kind),s=o.outgoingOne.get(`${r.kind}\0${e.source}`);if(s!==void 0&&s!==t)throw new TypeError(`Relationship outgoing cardinality exceeded for ${r.kind}`);let i=o.incomingOne.get(`${r.kind}\0${e.target}`);if(i!==void 0&&i!==t)throw new TypeError(`Relationship incoming cardinality exceeded for ${r.kind}`);let a=zo(e,n),c=o.identities.get(a);if(c!==void 0&&c!==t)throw new TypeError(`Relationship edge already active: ${a}`)}function _m(e){let t=new Map;for(let n of e)n.action==="remove"?t.delete(n.relationshipId):t.set(n.relationshipId,n.edge);return t}function hm(e,t,n){if(e.expectedVersion!==void 0&&e.expectedVersion!==t)throw new TypeError(`Relationship event version conflict: expected ${e.expectedVersion}, current ${t}`);let o=Go(e.eventId,"eventId");if(n.has(o))throw new TypeError(`Relationship event already exists: ${o}`);if(e.action!=="add"&&e.action!=="remove"&&e.action!=="supersede")throw new TypeError(`Unknown relationship event action: ${e.action}`);if(!Number.isFinite(Date.parse(e.timestamp)))throw new TypeError("Relationship event timestamp must be valid");return{eventId:o,relationshipId:Go(e.relationshipId,"relationshipId"),author:Go(e.author,"author"),timestamp:new Date(e.timestamp).toISOString()}}function gm(e,t,n,o,r,s){let i=n.has(t);if(e.action==="add"&&i)throw new TypeError(`Relationship is already active: ${t}`);if(e.action!=="add"&&!i)throw new TypeError(`Relationship is not active: ${t}`);if(e.action==="remove")return;if(!e.edge)throw new TypeError(`Relationship ${e.action} event requires an edge`);let a=typeof e.edge.source=="string"?e.edge.source.trim():"",c=typeof e.edge.target=="string"?e.edge.target.trim():"";if(!o.has(a)||!o.has(c))throw new TypeError(`Relationship endpoint not found: ${a} -> ${c}`);let d=new We([a,c],[e.edge],r).edges()[0];return fm(d,t,r,s),um(d)}var At=class{#t;#n;#o=[];#s=new Set;#e=new Map;#r={identities:new Map,outgoingOne:new Map,incomingOne:new Map};constructor(t,n={}){this.#t=new Set([...t].filter(o=>typeof o=="string").map(o=>o.trim()).filter(Boolean)),this.#n=n.registry??jt()}get version(){return this.#o.length}events(){return Object.freeze([...this.#o])}*stream(t={}){let n=t.fromVersion??1,o=t.toVersion??this.version,r=t.batchSize??100;if(!Number.isInteger(n)||n<1)throw new TypeError("Relationship event stream fromVersion must be positive");if(!Number.isInteger(o)||o<0||o>this.version)throw new TypeError(`Relationship event stream toVersion out of range: ${o}`);if(!Number.isInteger(r)||r<1)throw new TypeError("Relationship event stream batchSize must be positive");if(n>o+1)throw new TypeError("Relationship event stream fromVersion exceeds the selected prefix");for(let s=n-1;s<o;s+=r)yield Object.freeze(this.#o.slice(s,Math.min(s+r,o)))}project(t,n,o={}){if(typeof n!="function")throw new TypeError("Relationship event projection requires a reducer");let r=t,s=0,i;for(let a of this.stream({...o,batchSize:256}))for(let c of a)r=n(r,c),s+=1,i=c;return Object.freeze({state:r,version:i?.sequence??Math.max(0,(o.fromVersion??1)-1),processed:s,...i===void 0?{}:{asOf:i.timestamp}})}#i(t,n){let o=this.#n.require(n.kind);this.#r.identities.set(zo(n,this.#n),t),o.outgoing==="one"&&this.#r.outgoingOne.set(`${o.kind}\0${n.source}`,t),o.incoming==="one"&&this.#r.incomingOne.set(`${o.kind}\0${n.target}`,t)}#a(t){let n=this.#n.require(t.kind);this.#r.identities.delete(zo(t,this.#n)),n.outgoing==="one"&&this.#r.outgoingOne.delete(`${n.kind}\0${t.source}`),n.incoming==="one"&&this.#r.incomingOne.delete(`${n.kind}\0${t.target}`)}append(t){let n=hm(t,this.version,this.#s),o=this.#e.get(n.relationshipId),r=gm(t,n.relationshipId,this.#e,this.#t,this.#n,this.#r),s=Object.freeze({eventId:n.eventId,relationshipId:n.relationshipId,action:t.action,...r===void 0?{}:{edge:r},author:n.author,timestamp:n.timestamp,...t.reason?.trim()?{reason:t.reason.trim()}:{},sequence:this.version+1});return this.#o.push(s),this.#s.add(n.eventId),o&&this.#a(o),t.action==="remove"?this.#e.delete(n.relationshipId):(this.#e.set(n.relationshipId,r),this.#i(n.relationshipId,r)),s}snapshot(t={}){if(t.atVersion!==void 0&&t.atTimestamp!==void 0)throw new TypeError("Relationship snapshot accepts one target");let n;if(t.atTimestamp!==void 0){let s=Date.parse(t.atTimestamp);if(!Number.isFinite(s))throw new TypeError("Relationship snapshot timestamp must be valid");n=this.#o.filter(i=>Date.parse(i.timestamp)<=s)}else{let s=t.atVersion??this.version;if(!Number.isInteger(s)||s<0||s>this.version)throw new TypeError(`Relationship snapshot version out of range: ${s}`);n=this.#o.slice(0,s)}let o=_m(n),r=new We(this.#t,o.values(),this.#n);return Object.freeze({version:n.at(-1)?.sequence??0,...n.at(-1)?{asOf:n.at(-1).timestamp}:{},edges:r.edges(),graph:r})}page(t){if(!Number.isInteger(t.limit)||t.limit<1)throw new TypeError("Relationship event page limit must be positive");let n=As("relationship-events",{order:"append-sequence"}),o=t.cursor===void 0?this.version:Number(Cs(t.cursor,n).snapshot);if(!Number.isSafeInteger(o)||o<0||o>this.version)throw new TypeError("Relationship event cursor snapshot version is invalid");let r=Ts(this.#o.slice(0,o),{cursor:t.cursor,fingerprint:n,limit:t.limit,readId:s=>s.eventId,snapshot:String(o)});return{version:o,events:r.rows,hasMore:r.has_more,...r.next_cursor?{nextCursor:r.next_cursor}:{}}}},ym="relationship-event-store",qc=Rt.O_NOFOLLOW;function bn(e){return X(e,ym,30,`relationship-store:${process.pid}`,!1,!1,3e3)}async function Ue(e,t="relationships/events.jsonl"){let n=ye.resolve(e),o=ye.resolve(n,t),r=ye.relative(n,o);if(r.length===0)throw new TypeError("Relationship event path must name a file within the tracker root");if(r===".."||r.startsWith(`..${ye.sep}`)||ye.isAbsolute(r))throw new TypeError("Relationship event path must stay within the tracker root");if(await qo(n,{recursive:!0}),(await Uc(n)).isSymbolicLink())throw new TypeError("Relationship event tracker root must not be a symbolic link");let i=n;for(let a of r.split(ye.sep)){i=ye.join(i,a);try{if((await Uc(i)).isSymbolicLink())throw new TypeError("Relationship event path must not contain symbolic links")}catch(c){if(Un(c))break;throw c}}return o}async function wn(e,t,n){let o=new At(t,{registry:n}),r,s;try{s=await Gc(e,Rt.O_RDONLY|qc),r=await s.readFile("utf8")}catch(a){if(Un(a))return{log:o,raw:""};throw a}finally{await s?.close()}let i=r.split(`
+`);for(let a=0;a<i.length;a+=1){let c=i[a].trim();if(!c)continue;let d;try{d=JSON.parse(c)}catch{throw new TypeError(`Invalid relationship event JSONL at line ${a+1}`)}if(d.sequence!==o.version+1)throw new TypeError(`Invalid relationship event sequence at line ${a+1}`);o.append({eventId:d.eventId,relationshipId:d.relationshipId,action:d.action,...d.edge===void 0?{}:{edge:d.edge},author:d.author,timestamp:d.timestamp,...d.reason===void 0?{}:{reason:d.reason},expectedVersion:o.version})}return{log:o,raw:r}}function bm(e,t,n,o){let r=Date.parse(t.timestamp),s;return t.action!=="remove"&&t.edge!==void 0&&(s=new We(n,[t.edge],o).edges()[0]),e.eventId===t.eventId.trim()&&e.relationshipId===t.relationshipId.trim()&&e.action===t.action&&e.author===t.author.trim()&&Number.isFinite(r)&&e.timestamp===new Date(r).toISOString()&&e.reason===(t.reason?.trim()||void 0)&&D(e.edge)===D(s)}var vn=class e{#t;#n;#o;#s;#e;constructor(t,n,o,r){this.#t=t.pmRoot,this.#n=n,this.#o=t.registry,this.#s=o,this.#e=r}static async open(t){let n=Object.freeze([...t.nodes]),o=await Ue(t.pmRoot,t.relativePath),r=await bn(t.pmRoot);try{await Ue(t.pmRoot,o);let{log:s}=await wn(o,n,t.registry);return new e(t,n,o,s)}finally{await r()}}get path(){return this.#s}async currentVersion(){return this.#e=await this.#r(),this.#e.version}async append(t){let n=await bn(this.#t);try{let o=await Ue(this.#t,this.#s),{log:r}=await wn(o,this.#n,this.#o),s=r.append(t);await qo(ye.dirname(o),{recursive:!0}),await Ue(this.#t,o);let i=await Gc(o,Rt.O_APPEND|Rt.O_CREAT|Rt.O_WRONLY|qc);try{await i.appendFile(`${JSON.stringify(s)}
+`,"utf8")}finally{await i.close()}return this.#e=r,s}finally{await n()}}async appendBatch(t,n={}){let o=await bn(this.#t);try{let r=await Ue(this.#t,this.#s),{log:s,raw:i}=await wn(r,this.#n,this.#o),a=s.version,c=new Map(s.events().map(m=>[m.eventId,m])),d=[],l=[];for(let m of t){let f=m.eventId.trim(),_=c.get(f);if(_!==void 0){if(n.existingEventPolicy==="skip_identical"&&bm(_,m,this.#n,this.#o)){l.push(_.eventId);continue}if(n.existingEventPolicy==="skip_identical")throw new TypeError(`Relationship event id collision with different content: ${f}`)}let h=s.append(m);c.set(h.eventId,h),d.push(h)}if(d.length>0){let m=i.length===0||i.endsWith(`
+`)?i:`${i}
+`;await qo(ye.dirname(r),{recursive:!0}),await Ue(this.#t,r),await W(r,`${m}${d.map(f=>JSON.stringify(f)).join(`
+`)}
+`)}return this.#e=s,Object.freeze({version_before:a,version_after:s.version,appended:Object.freeze(d),skipped_event_ids:Object.freeze(l)})}finally{await o()}}async snapshot(t={}){return this.#e=await this.#r(),this.#e.snapshot(t)}async page(t){return this.#e=await this.#r(),this.#e.page(t)}async*stream(t={}){this.#e=await this.#r(),yield*this.#e.stream(t)}async project(t,n,o={}){return this.#e=await this.#r(),this.#e.project(t,n,o)}async#r(){let t=await bn(this.#t);try{let n=await Ue(this.#t,this.#s);return(await wn(n,this.#n,this.#o)).log}finally{await 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]="ff13ec2a-64a8-5512-973f-5447be945978")}catch{}})();function Ho(e){let t=jt();for(let n of e)t.register(n);return t}function zc(e,t){return{client:t,isItemNotFoundError:n=>Uo(n)&&n.exitCode===u.NOT_FOUND,getItemAt:(n,o)=>ia(n,o,{pmRoot:e}),openRelationshipEventStore:n=>vn.open({pmRoot:e,nodes:n.nodes,registry:Ho(n.definitions),...n.relativePath===void 0?{}:{relativePath:n.relativePath}}),createRelationshipGraph:n=>new We(n.nodes,n.edges,Ho(n.definitions)),analyzeRelationshipImpact:(n,o,r)=>aa(n,o,r),validateRelationshipEvents:n=>{let o=new At(n.nodes,{registry:Ho(n.definitions)});return n.events.map(r=>o.append({...r,expectedVersion:o.version}))},commitWorkspaceTransaction:n=>ca({...n,pmRoot:e})}}import{readFile as wm}from"node:fs/promises";import vm 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]="1a7548f2-93a0-5dfc-9d9a-c5aef4656c7c")}catch{}})();var Bo="context-intents.json";function kn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function km(e,t,n){if(!kn(e))throw new TypeError(`${t} context intent at index ${String(n)} must be an object`);let o=e.included_field_groups;if(typeof e.command!="string"||typeof e.intent!="string"||typeof e.description!="string"||!Array.isArray(o)||!o.every(r=>typeof r=="string")||typeof e.token_budget!="number")throw new TypeError(`${t} context intent at index ${String(n)} has an invalid contract shape`);return{command:e.command,intent:e.intent,description:e.description,included_field_groups:o,token_budget:e.token_budget}}function Hc(e,t){let n=Array.isArray(e)?e:kn(e)&&Array.isArray(e.intents)?e.intents:void 0;if(!n)throw new TypeError(`${t} context intents must be an array or an object with an intents array`);return n.map((o,r)=>km(o,t,r))}async function Sm(e){let t=vm.join(e,Bo),n;try{n=await wm(t,"utf8")}catch(r){if(Ve(r))return[];throw await ii(e),r}let o;try{o=JSON.parse(n)}catch(r){let s=r instanceof Error?r.message:String(r);throw new TypeError(`Invalid ${Bo}: ${s}`,{cause:r})}return Hc(o,Bo)}function Im(e){if(!kn(e))return;let t=e.contextIntents??e.context_intents;if(t!==void 0)return t;let n=e.default;return kn(n)?n.contextIntents??n.context_intents:void 0}function Em(e){return e.flatMap(t=>{let n=Im(t.module);return n===void 0?[]:Hc(n,`package ${t.name}`)})}async function xm(e){let t=await Sm(e.pmRoot),n=Em(e.packages??[]);return{workspaceContracts:t,packageContracts:n}}async function Vo(e,t){let n=await xm(e);return await Ms(n,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]="73184370-6517-533e-90db-536893402616")}catch{}})();async function Vc(e,t,n){if(t.body===void 0)throw new p("Missing required --body text",u.USAGE);let o=Vt(),r=I(process.cwd(),n.path);await O(r);let s=await x(r),i=R(t.author,s.author_default),c=(await o.resolveValue(t.body,"--body")).trim();if(c.length===0)throw new p("--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.",u.USAGE,{code:"append_empty_body",required:"Provide non-empty body text positionally, via --body, or with - for stdin.",examples:['pm append pm-a1b2 --body "Progress note"',"pm append pm-a1b2 --body -"]});let d=await vt({pmRoot:r,settings:s,id:e,op:"append",author:i,message:t.message,force:t.force,mutate(l){let m=l.body.trim().length>0?`
+
+`:"";return l.body=`${l.body.trimEnd()}${m}${c}
+`,{changedFields:["body"]}}});return{item:d.item,appended:c,changed_fields:d.changedFields}}import Rm from"fast-json-patch";import Wo from"node:fs/promises";(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]="db5f3a6d-9ae5-5f9b-bedf-766b2b79324c")}catch{}})();function Am(e,t){return oa(e,t,{errorSubject:"restore",allowFutureTimestamp:!0})}function Cm(e){let t=fo(e,e.length-1);return Object.keys(t.metadata).length===0?{metadata:{},body:t.body}:Oe(Pe(t))}async function Tm(e,t,n,o){let r=await oe(e,t,n.id_prefix,n.item_format,o);if(r){let c=de(e,r.id),d=await zs({pmRoot:e,settings:n,itemId:r.id,commandLabel:"restore"});return{id:r.id,historyPath:c,located:r,historyPolicyWarnings:d.warnings}}let s=bt(t,n.id_prefix),i=so(t),a=s===i?[s]:[s,i];for(let c of a){let d=de(e,c);if(await V(d))return{id:c,historyPath:d,located:null,historyPolicyWarnings:[]}}throw new p(`Item ${t} not found`,u.NOT_FOUND)}function Om(e,t){let n=Fe(e),o=Fe(t),r=Rm.compare(n,o),s=new Set;for(let i of r){if(i.path==="/body"||i.path.startsWith("/body/")){s.add("body");continue}let a=i.path.replace(/^\/(?:metadata|front_matter)\/?/,"").split("/")[0];s.add(a.replaceAll("~1","/").replaceAll("~0","~"))}return Array.from(s).sort((i,a)=>i.localeCompare(a))}async function $m(e){if(await G(e.subject.historyPath)!==e.historyRawBeforeLock)throw new p(`History for ${e.resolvedId} changed while waiting for lock; retry restore.`,u.CONFLICT);let n=await oe(e.pmRoot,e.resolvedId,e.settings.id_prefix,e.settings.item_format,e.typeToFolder),o=n?await z(n,{schema:e.settings.schema}):null;if((o?.raw??null)!==e.currentItemRawBeforeLock)throw new p(`Item ${e.resolvedId} changed while waiting for lock; retry restore.`,u.CONFLICT);return{loadedItemUnderLock:o,existingItemPath:n?.itemPath??null}}function Pm(e,t){return e?{document:e.document,originalRaw:e.raw}:{document:Cm(t),originalRaw:null}}function Fm(e){let t=e.document.metadata.assignee?.trim();if(!(t&&t!==e.author&&!e.force))return[];if(e.enforcement==="strict")throw new p(`Item ${e.resolvedId} is assigned to ${t}. Use --force to override.`,u.CONFLICT);return e.enforcement==="warn"?[`ownership_warning:assignee_conflict:${e.resolvedId}:${t}`]:[]}async function Lm(e){if(e.existingItemPath&&e.resolvedOriginalRaw!==null&&e.restoredItemPath!==e.existingItemPath){await W(e.existingItemPath,e.resolvedOriginalRaw),await Wo.rm(e.restoredItemPath,{force:!0});return}if(e.existingItemPath&&e.resolvedOriginalRaw!==null){await W(e.existingItemPath,e.resolvedOriginalRaw);return}await Wo.rm(e.restoredItemPath,{force:!0})}async function Mm(e){return[...await F({path:e.restoredItemPath,scope:"project",op:"restore",item_id:e.after.metadata.id,item_type:e.after.metadata.type,before:e.before,after:e.after,changed_fields:["restored"]}),...await F({path:e.historyPath,scope:"project",op:"restore:history",item_id:e.after.metadata.id,item_type:e.after.metadata.type,before:e.before,after:e.after,changed_fields:["restored"]})]}async function Ge(e,t,n,o){let r=I(process.cwd(),o.path);await O(r);let s=await x(r),i=$(s,A()),a=await Tm(r,e,s,i.type_to_folder),c=a.id,d=await G(a.historyPath),l=await Xe(a.historyPath,c);if(l.length===0)throw new p(`No history exists for ${c}; restore is unavailable.`,u.NOT_FOUND);let m=Am(t,l),f=ra(fo(l,m.historyIndex),m),_=js(f,{schema:s.schema});if(_.metadata.id!==c)throw new p(`Restore target resolved to item ${_.metadata.id}, expected ${c}.`,u.GENERIC_FAILURE);let w=(a.located?await z(a.located,{schema:s.schema}):null)?.raw??null,y=R(n.author,s.author_default),g=await X(r,c,s.locks.ttl_seconds,y,!!n.force,s.governance.force_required_for_stale_lock,s.locks.wait_ms);try{let{loadedItemUnderLock:k,existingItemPath:E}=await $m({pmRoot:r,resolvedId:c,subject:a,settings:s,typeToFolder:i.type_to_folder,historyRawBeforeLock:d,currentItemRawBeforeLock:w}),P="toon",T=Pm(k,l),H=Fm({document:T.document,author:y,force:n.force,enforcement:s.governance.ownership_enforcement,resolvedId:c}),j=Om(T.document,_);await _s({pm_root:r,operation:"restore",before:T.document,after:_,changed_fields:j,sdk:ci({pmRoot:r,settings:s,typeToFolder:i.type_to_folder})});let te=fe(_,{format:P,schema:s.schema}),B=ht(r,_.metadata.type,c,P,i.type_to_folder),ce=await Kt(r,y),U=[];try{await W(B,te),E&&B!==E&&await Wo.rm(E);let Ql=le({nowIso:S(),author:y,op:"restore",before:T.document,after:_,message:n.message});try{await $e(a.historyPath,Ql)}catch(em){throw await Lm({existingItemPath:E,resolvedOriginalRaw:T.originalRaw,restoredItemPath:B}),em}U=await Yt({pmRoot:r,preferredFormat:s.item_format,typeToFolder:i.type_to_folder,schema:s.schema,itemPath:B,previousItemPath:E??void 0,document:_})}finally{await ce()}let jn=await Mm({restoredItemPath:B,historyPath:a.historyPath,before:T.document,after:_});Ut({id:_.metadata.id,op:"restore",item_type:_.metadata.type,previous_status:T.document.metadata.status,status:_.metadata.status,previous:gt(T.document.metadata,j),current:gt(_.metadata,j),changed_fields:j});let Yr=l[m.historyIndex];return{item:_.metadata,restored_from:{kind:m.kind,target:m.raw,history_index:m.historyIndex+1,entry_ts:Yr.ts,entry_op:Yr.op},changed_fields:j,warnings:[...a.historyPolicyWarnings,...H,...U,...jn]}}finally{await 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]="a7113374-b169-5f92-9c20-075a47520440")}catch{}})();var Kc=1,Ko="close-many",Dm=["--filter-status","--filter-type","--filter-tag","--filter-priority","--filter-sprint","--filter-release","--filter-parent","--filter-assignee","--filter-updated-before","--ids"].join(", ");function Nm(e,t){return Et(e,t,{includePagination:!1})}function jm(e,t){return Et(e,t)}function Um(e){if(e?.ids!=null&&String(e.ids).trim().length===0)throw new p("--ids requires at least one non-empty item ID",u.USAGE)}function Gm(e){let t={};if(!e)return t;for(let[n,o]of Object.entries(e))o==null||typeof o=="string"&&!o.split(",").some(r=>r.trim().length>0)||(t[n]=o);return t}function qm(e,t){let n=String(e??"").trim();if(n.length>0)return n;if(t)throw new p("pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.",u.USAGE,{code:"close_reason_required",required:"Provide a shared closing summary via --reason for the whole batch.",why:"governance.require_close_reason is enabled, so every close must record why the items are done.",examples:['pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met"','pm close-many --ids pm-a,pm-b --reason "Superseded by redesign"'],nextSteps:["Re-run with --reason describing the shared outcome.","To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled"]})}async function zm(e,t){let n=N(t.schema),o=$(t,A()),r=await Le(e,t.item_format,o.type_to_folder,void 0,t.schema),s=new Map,i=new Map;for(let a of r){if(typeof a.parent!="string"||a.parent.length===0||(i.set(a.id,a.parent),Je(a.status,n)))continue;let c=s.get(a.parent);c?c.push(a.id):s.set(a.parent,[a.id])}for(let a of s.values())a.sort((c,d)=>c.localeCompare(d));return{childrenByParent:s,parentByChild:i}}function Wc(e,t,n){let o=n?.get(e);if(o!==void 0)return o;let r=0,s=t.get(e),i=[],a=new Set,c=!1;for(;s!==void 0&&!a.has(s);){let d=n?.get(s);if(d!==void 0){r+=d+1;break}a.add(s),i.push(s),r+=1,s=t.get(s)}if(s!==void 0&&a.has(s)&&(c=!0),!c){n?.set(e,r);for(let[d,l]of i.entries())n?.set(l,r-d-1)}return r}async function Hm(e){let t=await Mt(e.pmRoot,Ko,e.rollbackId,Kc),n=e.options.message??`Rollback close-many checkpoint ${t.id}`,o=await Dt(t.items,(r,s)=>Ge(r,s,{author:e.options.author,message:n,force:!0},e.global));return{...je({applied:o.restored_ids.length,skipped:0,failed:o.failed_count,unmatched:0}),mode:"rollback",matched_count:t.items.length,dry_run:!1,rollback_checkpoint_id:t.id,checkpoint:{id:t.id,created_at:t.created_at,path:t.path,rollback_command:`pm close-many --rollback ${t.id}`},restored_count:o.restored_ids.length,failed_count:o.failed_count,rows:o.rows,ids:o.restored_ids}}function Bm(e,t,n,o,r){return e.map(s=>{let i=(t.get(s.id)??[]).filter(c=>!n.has(c)),a=!Yc(s,o,r);return{id:s.id,title:typeof s.title=="string"?s.title:"",status:s.status,action:a?"skip":"close",...a?{skip_reason:"already_terminal"}:{},...i.length>0?{active_child_ids:i}:{}}})}async function Vm(e){let t=await Lt(e.pmRoot,Ko,e.checkpointId,{schema_version:Kc,id:e.checkpointId,created_at:e.nowValue,author:R(e.options.author,"unknown"),...e.reason!==void 0?{reason:e.reason}:{},filters:e.filters,items:e.checkpointItems});return{id:e.checkpointId,created_at:e.nowValue,path:t,rollback_command:`pm close-many --rollback ${e.checkpointId}`}}async function Wm(e){let t=[],n=[];for(let o of e.matched){if(!e.closableIds.has(o.id)){t.push({id:o.id,status:"skipped",skip_reason:"already_terminal"});continue}try{let r=await Ne(o.id,e.reason,e.closeOptions,e.global);t.push({id:o.id,status:"closed",changed_fields:r.changed_fields,...r.warnings&&r.warnings.length>0?{warnings:r.warnings}:{}}),n.push(o.id)}catch(r){t.push({id:o.id,status:"failed",error:ve(r)})}}return{rows:t,closedIds:n}}function Km(e){return typeof e.rollback=="string"?e.rollback:void 0}function Ym(e,t){if(t.trim().length===0)throw new p("--rollback requires a checkpoint id",u.USAGE);if(e.dryRun===!0)throw new p("--dry-run cannot be combined with --rollback",u.USAGE);if(jm(e.list,e.status))throw new p("Rollback mode does not accept filter options",u.USAGE)}function Jm(e){if(!Nm(e.list,e.status))throw new p(`close-many requires at least one filter to scope the close (for example: ${Dm}). Refusing to match every item.`,u.USAGE)}function Xm(e,t){let n=new Map;return[...e].sort((o,r)=>{let s=Wc(r.id,t,n)-Wc(o.id,t,n);return s!==0?s:o.id.localeCompare(r.id)})}function Yc(e,t,n){return n||!Je(e.status,t)}function Zm(e,t,n){return new Set(e.filter(o=>Yc(o,t,n)).map(o=>o.id))}async function Qm(e){Jm(e.options);let t=N(e.settings.schema),n=qm(e.options.reason,e.settings.governance.require_close_reason),o=e.options.force===!0,r=await Se(e.options.status,Gm(e.options.list),e.global),{childrenByParent:s,parentByChild:i}=await zm(e.pmRoot,e.settings),a=Xm(r.items,i),c=[...new Set(String(e.options.list?.ids??"").split(",").map(m=>m.trim()).filter(m=>m.length>0))],d=new Set(a.map(m=>m.id)),l=Zm(a,t,o);return{pmRoot:e.pmRoot,settings:e.settings,statusRegistry:t,reason:n,validateCloseMode:e.options.validateClose,force:o,listed:r,matched:a,unmatchedIds:c.filter(m=>!d.has(m)),planRows:Bm(a,s,l,t,o)}}function ep(e){return{outcome:"effect",exit_code:u.SUCCESS,mode:"dry_run",matched_count:e.matched.length,dry_run:!0,...e.reason!==void 0?{reason:e.reason}:{},filters:e.listed.filters,...e.validateCloseMode?{validate_close:e.validateCloseMode}:{},item_plans:e.planRows,ids:[],...e.unmatchedIds.length>0?{unmatched_ids:e.unmatchedIds,unmatched_count:e.unmatchedIds.length}:{}}}async function tp(e){if(e.options.checkpoint===!1||e.closableIds.size===0)return;let t=e.context.matched.filter(n=>e.closableIds.has(n.id)).map(n=>({id:n.id,target_updated_at:n.updated_at}));return Vm({pmRoot:e.context.pmRoot,checkpointId:e.checkpointId,nowValue:e.nowValue,options:e.options,reason:e.context.reason,filters:e.context.listed.filters,checkpointItems:t})}async function Jc(e,t){let n=I(process.cwd(),t.path);await O(n);let o=await x(n),r=e.dryRun===!0,s=Km(e);if(Um(e.list),s!==void 0)return Ym(e,s),Hm({pmRoot:n,rollbackId:s,options:e,global:t});let i=await Qm({pmRoot:n,settings:o,options:e,global:t});if(r)return ep(i);let a=new Set(i.planRows.filter(g=>g.action==="close").map(g=>g.id)),c=S(),d=Ft(Ko,c),l=await tp({context:i,options:e,closableIds:a,checkpointId:d,nowValue:c}),m={author:e.author,message:e.message??`close-many apply ${d}`,completedAt:e.completedAt,validateClose:i.validateCloseMode,force:i.force,resolution:e.resolution,expectedResult:e.expectedResult,actualResult:e.actualResult},{rows:f,closedIds:_}=await Wm({matched:i.matched,closableIds:a,reason:i.reason,closeOptions:m,global:t}),h=f.filter(g=>g.status==="closed").length,w=f.filter(g=>g.status==="skipped").length,y=f.filter(g=>g.status==="failed").length;return{...je({applied:h,skipped:w,failed:y,unmatched:i.unmatchedIds.length}),mode:"apply",matched_count:i.matched.length,dry_run:!1,...i.reason!==void 0?{reason:i.reason}:{},filters:i.listed.filters,...i.validateCloseMode?{validate_close:i.validateCloseMode}:{},...l?{checkpoint:l}:{},closed_count:h,skipped_count:w,failed_count:y,rows:f,ids:_,...i.unmatchedIds.length>0?{unmatched_ids:i.unmatchedIds,unmatched_count:i.unmatchedIds.length}:{}}}import{readFile as np}from"node:fs/promises";(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]="a7687052-a04e-536e-ace5-a665ebd477e3")}catch{}})();async function Yo(e,t){let n=e.add!==void 0,o=e.stdin===!0,r=typeof e.file=="string",s=Number(n)+Number(o)+Number(r);if(s===0)return;if(s>1)throw new p("Specify comment text using only one input source: --add, --stdin, or --file",u.USAGE);if(n)return{value:await t.resolveValue(e.add,"--add")??"",emptyFlag:"--add"};if(o)return{value:await t.resolveValue("-","--stdin")??"",emptyFlag:"--stdin"};let i=e.file.trim();if(!i)throw new p("--file path cannot be empty",u.USAGE);try{return{value:await np(i,"utf8"),emptyFlag:"--file"}}catch(a){if(oc(a)&&Ve(a))throw new p(`--file path not found: ${i}`,u.USAGE);let c=a instanceof Error?a.message:String(a);throw new p(`Failed to read --file path "${i}": ${c}`,u.USAGE)}}async function op(e,t){let n=e.edit,o=e.delete,r=n!==void 0,s=o!==void 0;if(r&&s)throw new p("Specify only one of --edit or --delete",u.USAGE);if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new p("--edit must be a positive integer",u.USAGE);if(o!==void 0&&(!Number.isInteger(o)||o<1))throw new p("--delete must be a positive integer",u.USAGE);if(s){if(await Yo(e,t)!==void 0)throw new p("--delete does not take comment text",u.USAGE);return{mode:"delete",index:o}}if(r){let c=await Yo(e,t);if(c===void 0)throw new p("--edit requires replacement text via positional [text], --add, --stdin, or --file",u.USAGE);return{mode:"edit",index:n,value:c.value,emptyFlag:c.emptyFlag}}let i=await Yo(e,t);return i===void 0?{mode:"list"}:{mode:i.emptyFlag==="--add"?"add":i.emptyFlag==="--stdin"?"stdin":"file",value:i.value,emptyFlag:i.emptyFlag}}async function Xc(e,t,n){let o=Vt(),r=await op(t,o),s=r.mode==="add"||r.mode==="edit",i=r.value??"";return nt(e,t,n,{input:{...r,rawValue:t.add??i,value:s?tt(i,{stripPlainTextPrefix:!0}):i},collectionKey:"comments",op:"comment_add",editOp:"comment_edit",deleteOp:"comment_delete",parseText:a=>a,createEntry:a=>a,bypassOwnershipConflict:!!(r.mode==="add"&&t.ownershipAppendBypass),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm comments pm-a1b2 --add "review note" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}})}(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]="93184f29-f215-5413-9628-fb5b34523995")}catch{}})();async function Zc(e,t,n){return nt(e,t,n,{input:await un(t,"learning"),collectionKey:"learnings",op:"learning_add",editOp:"learning_edit",deleteOp:"learning_delete",parseText:o=>tt(o),createEntry:o=>o,bypassOwnershipConflict:!!(t.edit===void 0&&t.delete===void 0&&t.ownershipAppendBypass),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm learnings pm-a1b2 --add "review learning" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}})}(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]="ebd9f151-593f-5081-97da-d78f83de4914")}catch{}})();function rp(e){if(e===void 0)return;if(e.trim().length===0)throw new p("--add-json must contain a JSON value",u.USAGE,{code:"structured_event_json_empty"});let t;try{t=JSON.parse(e)}catch{throw new p("--add-json must be valid JSON",u.USAGE,{code:"structured_event_json_invalid"})}return t}function sp(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e.type;return typeof t=="string"&&t.trim().length>0?t.trim():void 0}function ip(e){if(e===void 0)return;let t=Date.parse(e);if(!Number.isFinite(t))throw new p("--since must be a valid ISO timestamp",u.USAGE,{code:"structured_event_since_invalid"});return t}async function Qc(e,t,n){let o=rp(t.addJson),r=[t.add!==void 0,t.stdin===!0,t.file!==void 0,t.edit!==void 0,t.delete!==void 0].includes(!0);if(o!==void 0&&r)throw new p("--add-json cannot be combined with text, edit, delete, stdin, or file inputs",u.USAGE,{code:"structured_event_input_conflict"});let s=o===void 0?void 0:D(o),i=[t.since,t.eventType].some(h=>h!==void 0),a=ip(t.since),c=Xs(t.limit),d=await nt(e,{...t,...i?{limit:void 0}:{},includeMeta:[t.includeMeta===!0,i].includes(!0)},n,{input:await un(s===void 0?t:{add:s},"note"),collectionKey:"notes",op:"note_add",editOp:"note_edit",deleteOp:"note_delete",parseText:h=>tt(h),createEntry:h=>o===void 0?h:{...h,format:"json",data:o,event_type:sp(o)},bypassOwnershipConflict:!![t.edit===void 0,t.delete===void 0,t.ownershipAppendBypass===!0].every(Boolean),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm notes pm-a1b2 --add "review note" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}}),l=t.eventType?.trim(),m=d.notes.filter(h=>{let w=[h.format==="json",h.data!==void 0].every(Boolean),y=[a===void 0,Date.parse(h.created_at)>=(a??Number.POSITIVE_INFINITY)].includes(!0),g=[!l,h.event_type===l].includes(!0);return[!i,[w,y,g].every(Boolean)].includes(!0)}),f=i?nc(m,c):m,_=f.filter(h=>h.format==="json").length;return{...d,notes:f,count:f.length,...i?{total_count:m.length,returned_count:f.length,has_more:f.length<m.length,...c===void 0?{}:{limit:c},structured_event_count:_}:t.includeMeta===!0?{structured_event_count:_}:{}}}(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]="7a157c2e-e9e6-5bce-b124-0a7d34e3c7dc")}catch{}})();var td=1,Xo="update-many",ap=new Set(["author","message","force","ownershipMetadataBypass","ownershipDependencyBypass","allowUnresolvedDeps"]),cp=["--status","--priority","--type","--tags","--description","--body","--deadline","--estimate","--assignee","--dep","--dep-remove","--comment","--note","--learning","--file","--test","--doc","--replace-deps","--replace-tests","--replace-files","--replace-docs","--unset","--clear-*"].join(", "),dp={title:"title",description:"description",body:"body",status:"status",closeReason:"close_reason",priority:"priority",type:"type",deadline:"deadline",estimatedMinutes:"estimated_minutes",acceptanceCriteria:"acceptance_criteria",definitionOfReady:"definition_of_ready",order:"order",goal:"goal",objective:"objective",value:"value",impact:"impact",outcome:"outcome",whyNow:"why_now",assignee:"assignee",parent:"parent",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release",blockedBy:"blocked_by",blockedReason:"blocked_reason",unblockNote:"unblock_note",reporter:"reporter",severity:"severity",environment:"environment",reproSteps:"repro_steps",resolution:"resolution",expectedResult:"expected_result",actualResult:"actual_result",affectedVersion:"affected_version",fixedVersion:"fixed_version",component:"component",regression:"regression",customerImpact:"customer_impact"},lp=[{field:"dependencies",addKey:"dep",removeKey:"depRemove",clearKey:"clearDeps",replaceKey:"replaceDeps"},{field:"comments",addKey:"comment",clearKey:"clearComments"},{field:"notes",addKey:"note",clearKey:"clearNotes"},{field:"learnings",addKey:"learning",clearKey:"clearLearnings"},{field:"files",addKey:"file",clearKey:"clearFiles",replaceKey:"replaceFiles"},{field:"tests",addKey:"test",clearKey:"clearTests",replaceKey:"replaceTests"},{field:"docs",addKey:"doc",clearKey:"clearDocs",replaceKey:"replaceDocs"},{field:"reminders",addKey:"reminder",clearKey:"clearReminders"},{field:"events",addKey:"event",clearKey:"clearEvents"},{field:"type_options",addKey:"typeOption",clearKey:"clearTypeOptions"}],mp={close_reason:"close_reason","close-reason":"close_reason",deadline:"deadline",estimate:"estimated_minutes",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",ac:"acceptance_criteria",definition_of_ready:"definition_of_ready","definition-of-ready":"definition_of_ready",order:"order",rank:"order",goal:"goal",objective:"objective",value:"value",impact:"impact",outcome:"outcome",why_now:"why_now","why-now":"why_now",assignee:"assignee",parent:"parent",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release",blocked_by:"blocked_by","blocked-by":"blocked_by",blocked_reason:"blocked_reason","blocked-reason":"blocked_reason",unblock_note:"unblock_note","unblock-note":"unblock_note",reporter:"reporter",severity:"severity",environment:"environment",repro_steps:"repro_steps","repro-steps":"repro_steps",resolution:"resolution",expected_result:"expected_result","expected-result":"expected_result",actual_result:"actual_result","actual-result":"actual_result",affected_version:"affected_version","affected-version":"affected_version",fixed_version:"fixed_version","fixed-version":"fixed_version",component:"component",regression:"regression",customer_impact:"customer_impact","customer-impact":"customer_impact",type_options:"type_options","type-options":"type_options",tags:"tags"},nd=e=>{let t={};for(let[n,o]of Object.entries(e))ap.has(n)||o!==void 0&&(t[n]=o);return t},pp=e=>Object.keys(nd(e)).length>0,od=e=>typeof e=="string"?e.trim():e,up=e=>{let t=String(e).trim(),n=Number(t);return Number.isInteger(n)?n:t},Jo=e=>{let t=String(e).trim(),n=Number(t);return Number.isFinite(n)?n:t},fp=e=>{let t=String(e).trim().toLowerCase();return new Map([["true",!0],["1",!0],["false",!1],["0",!1]]).get(t)??od(e)},_p={priority:up,estimatedMinutes:Jo,order:Jo,rank:Jo,regression:fp},hp=(e,t)=>{if(t!==void 0)return(_p[e]??od)(t)},gp=e=>{let t=e.trim().toLowerCase().replaceAll("-","_");return mp[t]??t},Sn=(e,t)=>ps(e,t),yp=(e,t)=>t!==void 0?t:e==="type_options"?{}:[],bp=(e,t)=>Array.isArray(t)?t.length:e==="type_options"&&t&&typeof t=="object"?Object.keys(t).length:0,wp=e=>e.replace?"replace":e.clear?"clear_or_reset":e.removeCount>0?"merge_remove":"append",ed=(e,t)=>t===void 0?void 0:e[t],rt=e=>Array.isArray(e)?e.length:0,vp=(e,t,n)=>{let o=n[e.addKey],r=ed(n,e.removeKey),s=rt(o),i=rt(r),a=n[e.clearKey]===!0,c=ed(n,e.replaceKey)===!0;if(![a,c,s>0,i>0].includes(!0))return;let d=yp(e.field,t[e.field]);return{field:e.field,before:d,after:{operation:wp({replace:c,clear:a,removeCount:i}),clear:a,replace:c,add_count:s,remove_count:i,before_count:bp(e.field,d)}}},kp=(e,t)=>{let n=[];for(let o of lp){let r=vp(o,e,t);r!==void 0&&n.push(r)}return n},Sp=e=>Array.isArray(e)?e.filter(t=>typeof t=="string"):[],Ip=(e,t)=>{if(![t.tags!==void 0,rt(t.addTags)>0,rt(t.removeTags)>0].includes(!0))return;let n=Sp(e.tags),o=t.tags===void 0?n:wt(t.tags),r=Vs(o,t.addTags),s=Ws(r,t.removeTags).slice().sort((a,c)=>a.localeCompare(c)),i=n.slice().sort((a,c)=>a.localeCompare(c));if(!Sn(i,s))return{field:"tags",before:n,after:s}},Ep=(e,t)=>{let n=e.acceptance_criteria,o=Bs(Hs(n),t.addAc,t.removeAc);if(o.unmatchedRemovals.length>0)throw new p(`Acceptance criteria removal did not match: ${o.unmatchedRemovals.join(", ")}`,u.NOT_FOUND,{code:"acceptance_criteria_remove_unmatched",reason:"exact_match_not_found",field:"acceptance_criteria",unmatched:o.unmatchedRemovals});let r=o.criteria.join("; ");if(!Sn(typeof n=="string"?n:"",r))return{field:"acceptance_criteria",before:n,after:r}},xp=(e,t,n)=>{for(let[o,r]of Object.entries(dp)){let s=n[o];if(s===void 0)continue;let i=t[r],a=hp(o,s);Sn(i,a)||e.push({field:r,before:i,after:a})}},Rp=(e,t,n,o)=>{let r=Is(n,o,["update_many"]);for(let[s,i]of Object.entries(r)){let a=t[s];Sn(a,i)||e.push({field:s,before:a,after:i})}},Ap=(e,t,n)=>{for(let o of n??[]){let r=gp(o),s=t[r];s!==void 0&&e.push({field:r,before:s,after:null})}},Cp=(e,t,n={})=>{let o=e,r=[],s=Ip(o,n);if(s&&r.push(s),xp(r,o,n),rt(n.addAc)>0||rt(n.removeAc)>0){let i=Ep(o,n);i!==void 0&&r.push(i)}return r.push(...kp(o,n)),Rp(r,o,n,t),Ap(r,o,n.unset),{id:e.id,changes:r}},Tp=(e,t)=>Js(e,t,{strict:!0,flagLabel:"--filter-status"}),Op=e=>{if(e?.ids!=null&&String(e.ids).trim().length===0)throw new p("--ids requires at least one non-empty item ID",u.USAGE)},$p=[({update:e})=>{e.priority!==void 0&&Ys(e.priority)},({update:e,settings:t,pmRoot:n})=>{if(e.type===void 0)return;let o=$(t,A());if(!Nt(e.type,o))throw new p(ei(e.type,o.types,ks(n,t.schema)),u.USAGE)},({update:e,statusRegistry:t})=>{if(e.status!==void 0&&!Te(e.status,t)){let n=t.definitions.map(o=>o.id);throw new p(`Invalid --status value "${e.status}". Allowed: ${n.join(", ")}`,u.USAGE)}},({update:e})=>{e.deadline!==void 0&&os(e.deadline,new Date,"deadline")},({update:e})=>{e.estimatedMinutes!==void 0&&Ks(e.estimatedMinutes,"estimated-minutes")}],Pp=(e,t,n,o)=>{let r={update:e,settings:t,statusRegistry:n,pmRoot:o};for(let s of $p)s(r)},Fp=async e=>{let t=await Mt(e.pmRoot,Xo,e.rollbackId,td),n=e.options.update?.message??`Rollback update-many checkpoint ${t.id}`,o=await Dt(t.items,(r,s)=>Ge(r,s,{author:e.options.update?.author,message:n,force:e.options.update?.force??!0},e.global));return{...je({applied:o.restored_ids.length,skipped:0,failed:o.failed_count,unmatched:0}),mode:"rollback",matched_count:t.items.length,dry_run:!1,rollback_checkpoint_id:t.id,checkpoint:{id:t.id,created_at:t.created_at,path:t.path,rollback_command:`pm update-many --rollback ${t.id}`},restored_count:o.restored_ids.length,failed_count:o.failed_count,rows:o.rows,ids:o.restored_ids}},Lp=async e=>{let t={schema_version:td,id:e.checkpointId,created_at:e.nowValue,author:R(e.options.update?.author,"unknown"),status_filter:e.statusFilter??null,list_filters:e.filters,update_options:e.updateSummary,items:e.checkpointItems},n=await Lt(e.pmRoot,Xo,e.checkpointId,t);return{id:e.checkpointId,created_at:e.nowValue,path:n,rollback_command:`pm update-many --rollback ${e.checkpointId}`}},Mp=(e,t)=>{if(e==null)return;let n=[...new Set(String(e).split(",").map(r=>r.trim()).filter(r=>r.length>0))],o=new Set(t.map(r=>r.id));return n.filter(r=>!o.has(r))},Zo=e=>e.unmatchedIds===void 0?{}:{unmatched_ids:e.unmatchedIds,unmatched_count:e.unmatchedIds.length},Dp=async e=>{let t=I(process.cwd(),e.path);await O(t);let n=await x(t);return{pmRoot:t,settings:n,statusRegistry:N(n.schema),runtimeFieldRegistry:yt(n.schema)}},Np=e=>{if(e.options.dryRun===!0)throw new p("--dry-run cannot be combined with --rollback",u.USAGE);if(Et(e.options.list,e.options.status))throw new p("Rollback mode does not accept filter options",u.USAGE);if(Object.keys(e.updateSummary).length>0)throw new p("Rollback mode does not accept update mutation flags",u.USAGE);return Fp({pmRoot:e.runtime.pmRoot,rollbackId:e.rollbackId,options:e.options,global:e.global})},jp=async e=>{Tp(e.options.status,e.runtime.statusRegistry);let t=await Se(void 0,{...e.options.list,status:e.options.status,compact:void 0,brief:void 0,fields:void 0,includeBody:!0,full:!0},e.global),n=t.items.map(r=>{let s=Cp(r,e.runtime.runtimeFieldRegistry,e.options.update);return e.dependencyWarnings.length===0?s:{...s,warnings:[...e.dependencyWarnings]}}),o=e.options.list?.ids==null?[]:(await Se(void 0,{ids:e.options.list.ids,noTruncate:!0,full:!0},e.global)).items;return{listed:t,planned:n,actionable:n.filter(r=>r.changes.length>0),updateSummary:e.updateSummary,unmatchedIds:Mp(e.options.list?.ids,o)}},Up=e=>({outcome:"effect",exit_code:u.SUCCESS,mode:"dry_run",matched_count:e.listed.items.length,dry_run:!0,filters:e.listed.filters,planned_update_options:e.updateSummary,item_plans:e.planned,ids:[],...Zo(e)}),Gp=e=>({...je({applied:0,skipped:e.listed.items.length,failed:0,unmatched:e.unmatchedIds?.length??0}),mode:"apply",matched_count:e.listed.items.length,dry_run:!1,filters:e.listed.filters,planned_update_options:e.updateSummary,updated_count:0,skipped_count:e.listed.items.length,failed_count:0,rows:e.planned.map(t=>({id:t.id,status:"skipped"})),ids:[],...Zo(e)}),qp=async e=>{let t=[],n=[],o=e.options.update.message??`update-many apply ${e.checkpointId}`,r=new Set(e.plans.filter(s=>s.changes.length>0).map(s=>s.id));for(let s of e.items){if(!r.has(s.id)){t.push({id:s.id,status:"skipped"});continue}try{let i=await Ie(s.id,{...e.options.update,message:o,runtimeFieldCommands:["update_many"]},e.global);t.push({id:s.id,status:"updated",changed_fields:i.changed_fields,warnings:i.warnings}),n.push(s.id)}catch(i){t.push({id:s.id,status:"failed",error:ve(i)})}}return{rows:t,updatedIds:n}},zp=async e=>{if(e.plan.actionable.length===0)return Gp(e.plan);let t=S(),n=Ft(Xo,t),o=new Set(e.plan.actionable.map(m=>m.id)),r=e.plan.listed.items.filter(m=>o.has(m.id)).map(m=>({id:m.id,target_updated_at:m.updated_at})),s=e.options.checkpoint===!1?void 0:await Lp({pmRoot:e.runtime.pmRoot,checkpointId:n,nowValue:t,options:e.options,statusFilter:e.options.status,filters:e.plan.listed.filters,updateSummary:e.plan.updateSummary,checkpointItems:r}),i=await qp({items:e.plan.listed.items,plans:e.plan.planned,options:e.options,global:e.global,checkpointId:n}),a=m=>i.rows.filter(f=>f.status===m).length,c=a("updated"),d=a("skipped"),l=a("failed");return{...je({applied:c,skipped:d,failed:l,unmatched:e.plan.unmatchedIds?.length??0}),mode:"apply",matched_count:e.plan.listed.items.length,dry_run:!1,filters:e.plan.listed.filters,planned_update_options:e.plan.updateSummary,...s?{checkpoint:s}:{},updated_count:c,skipped_count:d,failed_count:l,rows:i.rows,ids:i.updatedIds,...Zo(e.plan)}},rd=async(e,t)=>{let n=await Dp(t),o=typeof e.rollback=="string"?e.rollback:void 0,r=nd(e.update);if(Op(e.list),o!==void 0)return Np({runtime:n,rollbackId:o,options:e,global:t,updateSummary:r});if(!pp(e.update))throw new p(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${cp}).`,u.USAGE);Pp(e.update,n.settings,n.statusRegistry,n.pmRoot),ac(e.update);let s=await Ao({pmRoot:n.pmRoot,dependencies:To(e.update.dep,n.settings.id_prefix,S(),R(e.update.author,n.settings.author_default)).additions,idPrefix:n.settings.id_prefix,itemFormat:n.settings.item_format,typeToFolder:$(n.settings,A()).type_to_folder,allowUnresolved:e.update.allowUnresolvedDeps}),i=await jp({options:e,global:t,runtime:n,updateSummary:r,dependencyWarnings:s});return await Ao({pmRoot:n.pmRoot,dependencies:To(e.update.dep,n.settings.id_prefix,S(),R(e.update.author,n.settings.author_default)).additions,idPrefix:n.settings.id_prefix,itemFormat:n.settings.item_format,typeToFolder:$(n.settings,A()).type_to_folder,allowUnresolved:e.update.allowUnresolvedDeps,holders:i.listed.items.map(a=>({id:a.id,createdAt:a.created_at})),schema:n.settings.schema}),e.dryRun===!0?Up(i):zp({runtime:n,options:e,global:t,plan: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]="49fd5730-99c2-5a93-a80e-83c806a124bf")}catch{}})();var Hp=["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"],sd=["brief","standard","deep"],cd="plan-step-",rr="draft",or=["bug-investigation","feature-implementation","refactoring-sprint"],id={"bug-investigation":[{title:"Reproduce the bug",body:"Capture exact steps, inputs, and the observed vs expected behavior."},{title:"Locate the root cause",body:"Trace the failure to the responsible code path with evidence."},{title:"Write a failing test",body:"Add a regression test that fails for the current bug."},{title:"Implement the fix",body:"Apply the minimal change that makes the failing test pass."},{title:"Verify and document",body:"Run the full suite and record the resolution and verification."}],"feature-implementation":[{title:"Clarify requirements & acceptance criteria",body:"Confirm scope, edge cases, and done-conditions."},{title:"Design the approach",body:"Decide the data model, interfaces, and integration points."},{title:"Implement the change",body:"Build the feature behind the agreed design."},{title:"Add tests",body:"Cover the new behavior and its edge cases."},{title:"Update docs & changelog",body:"Document the feature and surface it to users."}],"refactoring-sprint":[{title:"Map the current structure & risks",body:"Inventory the code to change and its blast radius."},{title:"Add characterization tests",body:"Lock in current behavior before refactoring."},{title:"Refactor incrementally",body:"Apply small, reversible steps keeping tests green."},{title:"Verify behavior is unchanged",body:"Run the full suite and compare against the baseline."},{title:"Clean up & document",body:"Remove dead code and record the new structure."}]};function Bp(e){let t=e.trim().toLowerCase(),n=Object.prototype.hasOwnProperty.call(id,t)?id[t]:void 0;if(!n)throw new p(`Unknown plan template "${e}". Allowed: ${or.join(", ")}`,u.USAGE,{code:"unknown_plan_template",examples:[`pm plan create --title "Fix login crash" --template ${or[0]}`]});return n.map(o=>({...o}))}function Vp(e,t){return t>0?Math.round(e/t*100):0}function dd(e){return(Array.isArray(e)?e:e==null?[]:[e]).filter(n=>n!=null).map(n=>(typeof n=="string"?n:String(n)).trim()).filter(n=>n.length>0)}function ie(e){return Array.isArray(e)?e.flatMap(t=>po(t,{unique:!1})):typeof e=="string"&&e.trim().length>0?po(e,{unique:!1}):[]}function J(e){return Array.isArray(e)?e.map(t=>t.trim()).filter(Boolean):typeof e=="string"&&e.trim().length>0?[e.trim()]:[]}function ld(e,t=rr){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=zn.find(r=>r===n);if(!o)throw new p(`Invalid plan mode "${e}". Allowed: ${zn.join(", ")}`,u.USAGE);return o}function sr(e,t="pending"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Hn.find(r=>r===n);if(!o)throw new p(`Invalid step status "${e}". Allowed: ${Hn.join(", ")}`,u.USAGE);return o}function md(e,t="related"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Vn.find(r=>r===n);if(!o)throw new p(`Invalid step link kind "${e}". Allowed: ${Vn.join(", ")}`,u.USAGE);return o}function Wp(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t.length===0)return;let n=Bn.find(o=>o===t);if(!n)throw new p(`Invalid plan harness "${e}". Allowed: ${Bn.join(", ")}`,u.USAGE);return n}function Kp(e){if(e===void 0)return"brief";let t=e.trim().toLowerCase(),n=sd.find(o=>o===t);if(!n)throw new p(`Invalid --depth "${e}". Allowed: ${sd.join(", ")}`,u.USAGE);return n}function Yp(e){if(e===void 0)return null;let t=e.split(",").map(n=>n.trim()).filter(n=>n.length>0);if(t.length===0)throw new p("Plan --fields requires a comma-separated list of plan field names",u.USAGE);return t}var Qo=new Set(["id","title","status","mode","scope","harness","parent","resume_context","steps_summary","current_step","blocked_steps","steps","decisions","discoveries","validation","linked_items"]);function Jp(e,t){let n=e,o={},r=[];for(let s of t){let i=s.startsWith("plan.")?s.slice(5):s;if(i.length!==0){if(!Qo.has(i)){r.push(s);continue}Object.prototype.hasOwnProperty.call(n,i)&&(o[i]=n[i])}}if(r.length>0)throw new p(`Unknown Plan --fields value(s): ${r.join(", ")}`,u.USAGE,{nextSteps:[`Use --fields ${[...Qo].join(",")}`,"Run pm plan show <id> --depth brief for compact default fields."],recovery:{provided_fields:r,suggested_retry:`pm plan show <id> --fields ${[...Qo].join(",")}`}});return o}function ir(e,t){let n={};for(let o of e.split(",")){let r=o.trim();if(r.length===0)continue;let s=r.indexOf("=");if(s<=0)throw new p(`Invalid ${t} entry "${r}"; expected key=value`,u.USAGE,{code:"malformed_plan_step_evidence",required:`${t} entries must use comma-separated key=value fields.`,why:"Structured Plan evidence must be validated before it is persisted.",examples:['--file "path=src/index.ts,scope=project,note=implementation"','--test "command=pnpm test,note=regression"','--doc "path=docs/PLAN.md,scope=project"']});n[r.slice(0,s).trim().toLowerCase()]=r.slice(s+1).trim()}return n}function ar(e){let t=ir(e,"--file");if(!t.path)throw new p("--file requires path=<value>",u.USAGE,{code:"malformed_plan_step_evidence",required:"--file requires a non-empty path field.",why:"Plan file evidence needs a stable path for later verification."});let n={path:t.path};return(t.scope==="global"||t.scope==="project")&&(n.scope=t.scope),t.note&&(n.note=t.note),n}function cr(e){let t=ir(e,"--test");if(!t.command&&!t.path)throw new p("--test requires at least command=<value> or path=<value>",u.USAGE,{code:"malformed_plan_step_evidence",required:"--test requires a command or path field.",why:"Plan test evidence must identify something runnable or inspectable."});let n={};return t.command&&(n.command=t.command),t.path&&(n.path=t.path),t.note&&(n.note=t.note),n}function dr(e){let t=ir(e,"--doc");if(!t.path)throw new p("--doc requires path=<value>",u.USAGE,{code:"malformed_plan_step_evidence",required:"--doc requires a non-empty path field.",why:"Plan documentation evidence needs a stable path for later verification."});let n={path:t.path};return(t.scope==="global"||t.scope==="project")&&(n.scope=t.scope),t.note&&(n.note=t.note),n}function Xp(e){let t={total:e.length,pending:0,in_progress:0,blocked:0,completed:0,skipped:0,superseded:0,completion_pct:0};for(let n of e)t[n.status]+=1;return t.completion_pct=Vp(t.completed,t.total),t}function Zp(e){let t=new Set(e.map(n=>n.id));for(let n=e.length+1;n<e.length+1024;n+=1){let o=`${cd}${String(n).padStart(3,"0")}`;if(!t.has(o))return o}throw new p("Could not allocate step id (limit reached)",u.GENERIC_FAILURE)}function st(e,t){let n=t.trim();if(n.length===0)throw new p("Step reference cannot be empty",u.USAGE);let o=e.find(r=>r.id===n);if(o)return o;if(/^\d+$/.test(n)){let r=Number.parseInt(n,10),s=e.find(i=>i.order===r);if(s)return s}throw new p(`Step "${t}" not found in plan`,u.NOT_FOUND)}function ad(e){if(e.status==="completed")return{reason:"already_completed"};let t=(e.linked_items??[]).find(n=>n.kind==="implements");if(t)return{reason:"already_materialized",existing_id:t.id}}function Qp(e,t){let n=t.filter(i=>i.trim().toLowerCase()==="all"),o=[],r=[];if(n.length>0){if(t.length>n.length)throw new p("pm plan materialize --steps all cannot be combined with other step refs",u.USAGE);for(let i of e.slice().sort((a,c)=>a.order-c.order)){let a=ad(i);if(a){r.push({from_step:i.id,...a});continue}o.push(i)}return{targets:o,skipped:r}}let s=new Set;for(let i of t){let a=st(e,i);if(s.has(a.id))continue;s.add(a.id);let c=ad(a);if(c){r.push({from_step:a.id,...c});continue}o.push(a)}return{targets:o,skipped:r}}function eu(e,t){let n=e==="decision"?t.decisionText:e==="discovery"?t.discoveryText:t.validationText,o=e==="decision"?t.decision:e==="discovery"?t.discovery:t.validation;return n?.trim()||o?.trim()||void 0}function tu(e){return e.find(t=>t.status==="in_progress")??e.find(t=>t.status==="pending")}function nu(e){return e.filter(t=>t.status==="blocked").map(t=>({id:t.id,order:t.order,title:t.title,blocked_reason:t.blocked_reason}))}function Z(e,t="brief"){let n=(e.plan_steps??[]).slice().sort((i,a)=>i.order-a.order),o=Xp(n),r=tu(n),s={id:e.id,title:e.title,status:e.status,mode:e.plan_mode??rr,scope:e.plan_scope,harness:e.plan_harness,parent:e.parent,resume_context:e.plan_resume_context,steps_summary:o,current_step:r?{id:r.id,order:r.order,title:r.title,status:r.status}:void 0,blocked_steps:nu(n),linked_items:(e.dependencies??[]).map(i=>({id:i.id,kind:i.kind}))};return(t==="standard"||t==="deep")&&(s.steps=n),t==="deep"&&(s.decisions=e.plan_decisions??[],s.discoveries=e.plan_discoveries??[],s.validation=e.plan_validation??[]),s}function Q(e,t){let n=[];return t.steps_summary.total===0&&n.push(`pm plan add-step ${e} --step-title "First step"`),t.current_step&&n.push(`pm plan update-step ${e} ${t.current_step.id} --step-status in_progress`,`pm plan complete-step ${e} ${t.current_step.id} --step-evidence "..."`),t.steps_summary.blocked>0&&n.push(`pm plan show ${e} --depth standard`),(t.mode==="draft"||t.mode==="research")&&n.push(`pm plan approve ${e} --message "ready to execute"`),t.steps_summary.completed===t.steps_summary.total&&t.steps_summary.total>0&&!uo(t.mode)&&t.status!=="closed"&&t.status!=="canceled"&&n.push(`pm close ${e} "plan complete"`),n}function pd(e){if((e.type??"").trim().toLowerCase()!=="plan")throw new p(`Item ${e.id} is type ${e.type}; pm plan commands require type=Plan. Use pm plan create or pm create --type Plan first.`,u.USAGE,{code:"wrong_item_type",required:"Use pm plan commands only with items whose type is Plan.",why:"Plan commands read and mutate Plan-specific step, decision, discovery, and validation fields.",examples:[`pm get ${e.id} --depth brief`,'pm plan create --title "Execution plan" --scope "<goal>"']})}async function ou(e){let t=I(process.cwd(),e.path);await O(t);let n=await x(t);return{pmRoot:t,settings:n}}async function ud(e,t){let n=$(e.settings,A()),o=await oe(e.pmRoot,t,e.settings.id_prefix,e.settings.item_format,n.type_to_folder);if(!o)throw new p(`Plan ${t} not found`,u.NOT_FOUND);let r=await z(o,{schema:e.settings.schema});return pd(r.document.metadata),{document:r.document,itemId:o.id}}function ru(e){let t=[];e.parent&&t.push(`id=${e.parent.trim()},kind=parent`);for(let n of ie(e.related))t.push(`id=${n},kind=related`);for(let n of ie(e.blocks))t.push(`id=${n},kind=blocks`);for(let n of ie(e.blockedBy))t.push(`id=${n},kind=blocked_by`);return t.length>0?t:void 0}function su(e){let t=e.validationText?.trim(),n=e.validationCommand?.trim(),o=e.validationExpected?.trim();if(!(!t&&!n&&!o))return{text:t||n||"Validation check",command:n||void 0,expected:o||void 0}}function iu(e){return!!e.stepBody?.trim()||!!e.stepOwner?.trim()||!!e.stepStatus?.trim()||!!e.stepEvidence?.trim()||!!e.stepBlockedReason?.trim()||!!e.stepReplacement?.trim()||ie(e.dependsOn).length>0||ie(e.link).length>0}function au(e){let t=e.stepTitle?.trim()||void 0,n=dd(e.step),o=e.template?.trim()?Bp(e.template):[];return{repeatedStepTitles:n,stepTitleFlag:t,stepTitles:[...t?[t]:[],...n,...o.map(r=>r.title)],templateSteps:o}}function cu(e,t){if((e.stepTitleFlag||e.repeatedStepTitles.length>0)&&e.templateSteps.length>0)throw new p("pm plan create --template cannot be combined with --step-title or --step; choose one step seeding source",u.USAGE,{code:"ambiguous_option_combination",examples:[`pm plan create --title "Fix login crash" --template ${or[0]}`,'pm plan create --title "Custom plan" --step "Read the code" --step "Write the fix"']});if(e.stepTitles.length>1&&t)throw new p("pm plan create per-step options apply to a single initial step; with multiple --step values create the plan first, then refine steps individually",u.USAGE,{code:"ambiguous_option_combination",examples:['pm plan create --title "Execution plan" --step "Read the code" --step "Write the fix"','pm plan update-step <plan-id> plan-step-001 --step-body "Inspect retry path"']})}function du(e,t){let n=sr(e.stepStatus,"pending"),o=lr(e,"depends_on"),r=J(e.file).map(ar),s=J(e.test).map(cr),i=J(e.doc).map(dr),a=S();return{id:"plan-step-001",order:1,title:t,body:e.stepBody?.trim()||void 0,status:n,owner:e.stepOwner?.trim()||void 0,evidence:e.stepEvidence?.trim()||void 0,blocked_reason:n==="blocked"?e.stepBlockedReason?.trim()||"":void 0,linked_items:o.length>0?o:void 0,files:r.length>0?r:void 0,tests:s.length>0?s:void 0,docs:i.length>0?i:void 0,created_at:a,updated_at:a,completed_at:n==="completed"?a:void 0}}function lu(e){let t=au(e),n=iu(e);if(cu(t,n),t.stepTitles.length===0)return{steps:[],hasPerStepDetailOptions:n};if(t.stepTitles.length===1)return{steps:[du(e,t.stepTitles[0])],hasPerStepDetailOptions:n};let o=S();return{steps:t.stepTitles.map((r,s)=>({id:`${cd}${String(s+1).padStart(3,"0")}`,order:s+1,title:r,body:t.templateSteps[s]?.body,status:"pending",created_at:o,updated_at:o})),hasPerStepDetailOptions:n}}async function mu(e,t,n){let o=e.title?.trim();if(!o)throw new p("pm plan create requires --title",u.USAGE,{code:"missing_required_option",examples:['pm plan create --title "Refactor lock retry" --scope pm-a1b2']});let r=ld(e.mode,rr),s=Wp(e.harness),i=e.fromSearch?.trim(),a=su(e),{steps:c,hasPerStepDetailOptions:d}=lu(e);if(c.length===0&&d)throw new p("pm plan create step options require --step-title (or a single --step)",u.USAGE,{code:"missing_required_option",examples:['pm plan create --title "Execution plan" --step-title "Read the code"']});let l=e.description?.trim()??e.scope?.trim()??o,m=e.claim?R(e.author,n.settings.author_default):e.assignee?.trim()||void 0,f={...e,title:o,description:l,type:"Plan",template:void 0,file:J(e.file),test:J(e.test),doc:J(e.doc),field:J(e.field),assignee:R(e.author,n.settings.author_default),blockedBy:void 0,dep:ru(e),message:e.message??(i?`plan create (search: ${i})`:"plan create")},_=await xt(f,t),h=await vt({pmRoot:n.pmRoot,settings:n.settings,id:_.item.id,op:"plan_create_metadata",author:R(e.author,n.settings.author_default),message:"seed plan metadata",mutate(y){let g=["plan_mode"];y.metadata.plan_mode=r,s&&(y.metadata.plan_harness=s,g.push("plan_harness"));let k=e.scope?.trim();k&&(y.metadata.plan_scope=k,g.push("plan_scope"));let E=e.resumeContext?.trim();return E&&(y.metadata.plan_resume_context=E,g.push("plan_resume_context")),y.metadata.plan_steps=c,g.push("plan_steps"),a&&(y.metadata.plan_validation=[...y.metadata.plan_validation??[],a],g.push("plan_validation")),m&&(y.metadata.assignee=m,g.push("assignee")),{changedFields:g}}}),w=Z(h.item,"brief");return{action:"create",plan:w,step:c[0],next_actions:Q(_.item.id,w),warnings:[..._.warnings],generated_at:S()}}async function pu(e,t,n){let o=Kp(t.depth),r=Yp(t.fields),{document:s,itemId:i}=await ud(n,e),a=Z(s.metadata,r===null?o:"deep");return{action:"show",plan:r===null?a:Jp(a,r),next_actions:Q(i,a),warnings:[],generated_at:S()}}function uu(e,t){let n=new Map(Object.entries(t).filter(([o])=>o.startsWith("plan_")).map(([o,r])=>[o,JSON.stringify(r)]));return[...new Set([...e.keys(),...n.keys()])].filter(o=>e.get(o)!==n.get(o))}async function me(e){let t=R(e.options.author,e.ctx.settings.author_default),n,o=await vt({pmRoot:e.ctx.pmRoot,settings:e.ctx.settings,id:e.id,op:e.op,author:t,message:e.options.message??e.message,force:e.options.force,mutate(r){pd(r.metadata);let s=N(e.ctx.settings.schema);if(Je(r.metadata.status,s)||uo(r.metadata.plan_mode))throw new p(`Plan ${r.metadata.id} is terminal (status=${r.metadata.status}, plan_mode=${r.metadata.plan_mode??"unset"}) and cannot be mutated.`,u.CONFLICT,{code:"terminal_plan_mutation",required:"Create or reopen a non-terminal Plan before changing its execution context or steps.",why:"Terminal Plan history is immutable execution evidence."});let i=(r.metadata.plan_steps??[]).slice(),a=new Map(Object.entries(r.metadata).filter(([m])=>m.startsWith("plan_")).map(([m,f])=>[m,JSON.stringify(f)])),c=e.mutator(i,r);n=c.resultStep;let d=i.slice().sort((m,f)=>m.order-f.order).map((m,f)=>({...m,order:f+1}));r.metadata.plan_steps=d;let l=uu(a,r.metadata);return l.length===0&&c.changedSteps.length===0?{changedFields:[]}:{changedFields:l.length>0?l:["plan_steps"]}}});return{document:{metadata:o.item,body:o.body},resultStep:n,itemId:o.item.id}}async function fu(e,t,n){let o=t.stepTitle?.trim();if(!o)throw new p("pm plan add-step requires --step-title",u.USAGE);let r=sr(t.stepStatus,"pending"),s=t.allowMultipleActive===!0,{document:i,resultStep:a,itemId:c}=await me({id:e,options:t,ctx:n,op:"plan_add_step",message:`plan add-step "${o}"`,mutator(l){let m=l.length+1;fd(l,void 0,r,s);let f=_u(l,t,{order:m,title:o,status:r});return l.push(f),{changedSteps:[f.id],resultStep:f}}}),d=Z(i.metadata,"standard");return{action:"add-step",plan:d,step:a,next_actions:Q(c,d),warnings:[],generated_at:S()}}function fd(e,t,n,o){if(n!=="in_progress"||o)return;let r=e.find(s=>s.id!==t&&s.status==="in_progress");if(r)throw new p(`Plan already has step ${r.id} in_progress. Pass --allow-multiple-active or update that step first.`,u.CONFLICT)}function _u(e,t,n){let o=lr(t,"depends_on"),r=J(t.file).map(ar),s=J(t.test).map(cr),i=J(t.doc).map(dr),a=S();return{id:Zp(e),order:n.order,title:n.title,body:t.stepBody?.trim()||void 0,status:n.status,owner:t.stepOwner?.trim()||void 0,evidence:t.stepEvidence?.trim()||void 0,blocked_reason:n.status==="blocked"?t.stepBlockedReason?.trim()||"":void 0,linked_items:o.length>0?o:void 0,files:r.length>0?r:void 0,tests:s.length>0?s:void 0,docs:i.length>0?i:void 0,created_at:a,updated_at:a,completed_at:n.status==="completed"?a:void 0}}function lr(e,t){let n=ie(e.dependsOn).map(l=>({id:l,kind:t})),o=ie(e.related).map(l=>({id:l,kind:"related"})),r=ie(e.blocks).map(l=>({id:l,kind:"blocks"})),s=ie(e.blockedBy).map(l=>({id:l,kind:"blocked_by"})),i=ie(e.link),a=md(e.linkKind,t),c=e.linkNote?.trim(),d=i.map(l=>{let m={id:l,kind:a};return c&&(m.note=c),m});return[...n,...o,...r,...s,...d]}async function er(e,t,n,o){let{document:r,resultStep:s,itemId:i}=await me({id:e,options:t,ctx:n,op:o.op,message:t.message??`${o.op} ${o.stepRef}`,mutator(c,d){let l=st(c,o.stepRef),m=S(),f=o.finalStatus??sr(t.stepStatus,l.status),_=t.allowMultipleActive===!0||o.allowMultipleActive===!0;return fd(c,l.status==="in_progress"?l.id:void 0,f,_),hu(l,t,f,m),d.metadata.updated_at=m,{changedSteps:[l.id],resultStep:l}}}),a=Z(r.metadata,"standard");return{action:o.op==="plan_complete_step"?"complete-step":o.op==="plan_block_step"?"block-step":"update-step",plan:a,step:s,next_actions:Q(i,a),warnings:[],generated_at:S()}}function hu(e,t,n,o){gu(e,t,n),yu(e,t),e.status=n,e.updated_at=o,bu(e,n,o)}function gu(e,t,n){if(!(n!=="blocked"||t.stepBlockedReason?.trim()||e.blocked_reason))throw new p("Blocking a step requires --step-blocked-reason or an already-recorded blocked_reason.",u.USAGE)}function yu(e,t){let n=t.stepTitle?.trim();n&&(e.title=n),t.stepBody!==void 0&&(e.body=t.stepBody.trim()||void 0),t.stepOwner!==void 0&&(e.owner=t.stepOwner.trim()||void 0),t.stepEvidence!==void 0&&(e.evidence=t.stepEvidence.trim()||void 0),t.stepBlockedReason!==void 0&&(e.blocked_reason=t.stepBlockedReason.trim()||void 0),t.stepReplacement!==void 0&&(e.superseded_by=t.stepReplacement.trim()||void 0);let o=J(t.file).map(ar),r=J(t.test).map(cr),s=J(t.doc).map(dr);o.length>0&&(e.files=tr(e.files,o)),r.length>0&&(e.tests=tr(e.tests,r)),s.length>0&&(e.docs=tr(e.docs,s))}function tr(e,t){let n=[...e??[]],o=new Set(n.map(r=>JSON.stringify(r)));for(let r of t){let s=JSON.stringify(r);o.has(s)||(o.add(s),n.push(r))}return n}function bu(e,t,n){if(t==="completed"&&!e.completed_at){e.completed_at=n;return}t!=="completed"&&(e.completed_at=void 0)}async function wu(e,t,n,o,r){let{document:s,itemId:i}=await me({id:e,options:t,ctx:n,op:"plan_reorder_step",message:t.message??`plan reorder-step ${o} -> ${r}`,mutator(c){let d=st(c,o),l=c.filter(f=>f.id!==d.id),m=Math.max(1,Math.min(r,l.length+1));return l.splice(m-1,0,d),l.forEach((f,_)=>{f.order=_+1,f.updated_at=S()}),c.length=0,c.push(...l),{changedSteps:[d.id],resultStep:d}}}),a=Z(s.metadata,"standard");return{action:"reorder-step",plan:a,next_actions:Q(i,a),warnings:[],generated_at:S()}}async function vu(e,t,n,o){let{document:r,itemId:s}=await me({id:e,options:t,ctx:n,op:"plan_remove_step",message:t.message??`plan remove-step ${o}`,mutator(a){let c=st(a,o),d=a.filter(l=>l.id!==c.id);return d.forEach((l,m)=>{l.order=m+1}),a.length=0,a.push(...d),{changedSteps:[c.id]}}}),i=Z(r.metadata,"standard");return{action:"remove-step",plan:i,next_actions:Q(s,i),warnings:[],generated_at:S()}}async function ku(e,t,n,o){let r=lr(t,md(t.linkKind,"related"));if(r.length===0)throw new p("pm plan link requires at least one --link/--related/--blocks/--blocked-by/--depends-on id",u.USAGE);let s=t.promoteToItemDep===!0,{document:i,itemId:a,resultStep:c}=await me({id:e,options:t,ctx:n,op:"plan_link_step",message:t.message??`plan link ${o}`,mutator(l,m){let f=st(l,o),_=f.linked_items??[],h=y=>`${y.kind}:${y.id}`,w=new Set(_.map(h));for(let y of r){let g=h(y);w.has(g)||(_.push(y),w.add(g))}if(f.linked_items=_,f.updated_at=S(),s){let y=m.metadata.dependencies??[],g=E=>`${E.kind}:${E.id}`,k=new Set(y.map(g));for(let E of r){let P=E.kind==="depends_on"?"blocked_by":E.kind,T={id:E.id,kind:P,created_at:S(),author:R(t.author,n.settings.author_default)};k.has(g(T))||(y.push(T),k.add(g(T)))}m.metadata.dependencies=y}return{changedSteps:[f.id],resultStep:f}}}),d=Z(i.metadata,"standard");return{action:"link",plan:d,step:c,next_actions:Q(a,d),warnings:[],generated_at:S()}}async function Su(e,t,n,o){let r=ie(t.link);if(r.length===0)throw new p("pm plan unlink requires --link <id> to remove",u.USAGE);let{document:s,itemId:i,resultStep:a}=await me({id:e,options:t,ctx:n,op:"plan_unlink_step",message:t.message??`plan unlink ${o}`,mutator(d){let l=st(d,o),m=(l.linked_items??[]).filter(f=>!r.includes(f.id));return l.linked_items=m.length>0?m:void 0,l.updated_at=S(),{changedSteps:[l.id],resultStep:l}}}),c=Z(s.metadata,"standard");return{action:"unlink",plan:c,step:a,next_actions:Q(i,c),warnings:[],generated_at:S()}}async function nr(e,t,n,o){let r=eu(o,t);if(!r){let d=`--${o}-text`,l=`--${o}`;throw new p(`pm plan ${o} requires ${d}`,u.USAGE,{code:"missing_required_option",examples:[`pm plan ${o} <plan-id> ${d} "..."`,`pm plan ${o} <plan-id> ${l} "..."`],recovery:{suggested_retry:`pm plan ${o} <plan-id> ${d} <value>`}})}let s=R(t.author,n.settings.author_default),{document:i,itemId:a}=await me({id:e,options:t,ctx:n,op:`plan_append_${o}`,message:t.message??`plan ${o} append`,mutator(d,l){let m=S();if(o==="decision"){let _=l.metadata.plan_decisions??[];return _.push({ts:m,author:s,decision:r,rationale:t.decisionRationale?.trim()||void 0,evidence:t.decisionEvidence?.trim()||void 0}),l.metadata.plan_decisions=_,{changedSteps:[]}}if(o==="discovery"){let _=l.metadata.plan_discoveries??[];return _.push({ts:m,author:s,text:r}),l.metadata.plan_discoveries=_,{changedSteps:[]}}let f=l.metadata.plan_validation??[];return f.push({text:r,command:t.validationCommand?.trim()||void 0,expected:t.validationExpected?.trim()||void 0}),l.metadata.plan_validation=f,{changedSteps:[]}}}),c=Z(i.metadata,"deep");return{action:o,plan:c,next_actions:Q(a,c),warnings:[],generated_at:S()}}async function Iu(e,t,n){let o=t.resumeContext?.trim();if(!o)throw new p("pm plan resume requires --resume-context <text>",u.USAGE);let{document:r,itemId:s}=await me({id:e,options:t,ctx:n,op:"plan_resume",message:t.message??"plan resume context update",mutator(a,c){c.metadata.plan_resume_context=o;let d=t.scope?.trim();return d&&(c.metadata.plan_scope=d),{changedSteps:[]}}}),i=Z(r.metadata,"brief");return{action:"resume",plan:i,next_actions:Q(s,i),warnings:[],generated_at:S()}}async function Eu(e,t,n){let o=ld(t.mode??"approved","approved"),{document:r,itemId:s}=await me({id:e,options:t,ctx:n,op:"plan_approve",message:t.message??`plan approve mode=${o}`,mutator(a,c){c.metadata.plan_mode=o;let d=t.scope?.trim();return d&&(c.metadata.plan_scope=d),{changedSteps:[]}}}),i=Z(r.metadata,"brief");return{action:"approve",plan:i,next_actions:Q(s,i),warnings:[],generated_at:S()}}function _d(e){return e.map(t=>`plan_materialize_skipped:${t.from_step}:${t.reason}${t.existing_id?`:${t.existing_id}`:""}`)}function xu(e,t){let n=Z(e.document.metadata,"standard");return{action:"materialize",plan:n,materialized:[],materialize_skipped:t,next_actions:Q(e.itemId,n),warnings:_d(t),generated_at:S()}}function Ru(e,t,n){let o=[`id=${e},kind=parent`,`id=${t},kind=discovered_from`];for(let r of n.linked_items??[]){let s=r.kind==="blocked_by"||r.kind==="blocks"||r.kind==="related"||r.kind==="discovered_from"?r.kind:"related";o.push(`id=${r.id},kind=${s}`)}return o}async function Au(e){let t=[],n={},o=new Set(["title","description","type","parent","tags","author","message","dep"]);for(let r of J(e.options.field)){let s=r.indexOf("=");if(s<=0)throw new p(`Invalid --field entry "${r}"; expected name=value`,u.USAGE);let i=r.slice(0,s).trim(),a=r.slice(s+1).trim();if(i.length===0)throw new p(`Invalid --field entry "${r}"; expected name=value`,u.USAGE);let c=i.trim().replaceAll(/([a-z0-9])([A-Z])/g,"$1 $2").replaceAll(/[^A-Za-z0-9]+/g," ").split(/\s+/).filter(Boolean).map(f=>f.toLowerCase());if(c.length===0)throw new p(`Invalid --field entry "${r}"; expected name=value`,u.USAGE);let[d,...l]=c,m=`${d}${l.map(f=>`${f.slice(0,1).toUpperCase()}${f.slice(1)}`).join("")}`;if(o.has(m))throw new p(`Invalid --field entry "${r}"; "${m}" is reserved by materialize and cannot be overridden`,u.USAGE);n[m]=a}for(let r of e.targets){let s=await xt({...n,title:r.title,description:r.body?.trim()||r.title,type:e.resolvedTypeName,parent:e.parent,tags:e.tags,author:e.options.author,message:e.options.message??`materialized from plan ${e.planItemId} step ${r.id}`,dep:Ru(e.parent,e.planItemId,r)},{path:e.pmRoot});t.push({id:s.item.id,title:s.item.title,type:e.resolvedTypeName,parent:s.item.parent,tags:s.item.tags??[],from_step:r.id})}return t}function Cu(e,t,n){for(let o of t){let r=n.find(a=>a.from_step===o.id);if(!r)continue;let s=e.find(a=>a.id===o.id);if(!s)continue;let i=s.linked_items??[];i.push({id:r.id,kind:"implements",note:`materialized as ${r.type}`}),s.linked_items=i,s.updated_at=S()}}async function Tu(e,t,n){let o=ie(t.steps);if(o.length===0)throw new p("pm plan materialize requires --steps <ids|orders|all>",u.USAGE);let r=t.materializeType?.trim()||"Task",s=$(n.settings,A()),i=Nt(r,s);if(!i)throw new p(`Invalid --materialize-type "${r}"`,u.USAGE);let a=t.materializeParent?.trim()||e,c=t.materializeTags,d=await ud(n,e),l=(d.document.metadata.plan_steps??[]).slice(),{targets:m,skipped:f}=Qp(l,o);if(m.length===0){if(f.length>0)return xu(d,f);throw new p("No matching plan steps found for --steps",u.NOT_FOUND)}let _=await Au({targets:m,parent:a,planItemId:d.itemId,resolvedTypeName:i,tags:c,options:t,pmRoot:n.pmRoot}),{document:h,itemId:w}=await me({id:e,options:t,ctx:n,op:"plan_materialize",message:t.message??`plan materialize ${o.join(",")}`,mutator(g){return Cu(g,m,_),{changedSteps:m.map(k=>k.id)}}}),y=Z(h.metadata,"standard");return{action:"materialize",plan:y,materialized:_,...f.length>0?{materialize_skipped:f}:{},next_actions:Q(w,y),warnings:_d(f),generated_at:S()}}function Ou(e){if(e.subcommand==="create")return e;let t=dd(e.options.step);if(t.length>1)throw new p(`pm plan ${e.subcommand} accepts a single --step/--step-title value (repeated --step seeds ordered steps only on pm plan create)`,u.USAGE);return t.length===1&&!e.options.stepTitle?.trim()?{...e,options:{...e.options,stepTitle:t[0]}}:e}function be(e,t){if(!e.id)throw new p(`pm plan ${t} requires a plan id`,u.USAGE);return e.id}function qe(e,t){let n=be(e,t);if(!e.stepRef)throw new p(`pm plan ${t} requires <plan-id> <step>`,u.USAGE);return{id:n,stepRef:e.stepRef}}function $u(e){let t=qe(e,"reorder-step");if(e.reorderTo===void 0)throw new p("pm plan reorder-step requires <plan-id> <step> <new-order>",u.USAGE);return{...t,reorderTo:e.reorderTo}}var Pu={create:(e,t)=>mu(e.options,e.global,t),show:(e,t)=>pu(be(e,"show"),e.options,t),"add-step":(e,t)=>fu(be(e,"add-step"),e.options,t),"update-step":(e,t)=>{let n=qe(e,"update-step");return er(n.id,e.options,t,{stepRef:n.stepRef,op:"plan_update_step"})},"complete-step":(e,t)=>{let n=qe(e,"complete-step");return er(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"completed",op:"plan_complete_step"})},"block-step":(e,t)=>{let n=qe(e,"block-step");return er(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"blocked",op:"plan_block_step"})},"reorder-step":(e,t)=>{let n=$u(e);return wu(n.id,e.options,t,n.stepRef,n.reorderTo)},"remove-step":(e,t)=>{let n=qe(e,"remove-step");return vu(n.id,e.options,t,n.stepRef)},link:(e,t)=>{let n=qe(e,"link");return ku(n.id,e.options,t,n.stepRef)},unlink:(e,t)=>{let n=qe(e,"unlink");return Su(n.id,e.options,t,n.stepRef)},decision:(e,t)=>nr(be(e,"decision"),e.options,t,"decision"),discovery:(e,t)=>nr(be(e,"discovery"),e.options,t,"discovery"),validation:(e,t)=>nr(be(e,"validation"),e.options,t,"validation"),resume:(e,t)=>Iu(be(e,"resume"),e.options,t),approve:(e,t)=>Eu(be(e,"approve"),e.options,t),materialize:(e,t)=>Tu(be(e,"materialize"),e.options,t)};function Fu(e){let t=Pu[e];if(!t)throw ue({command_path:"plan",token:e,allowed:Hp});return t}async function hd(e){let t=await ou(e.global),n=Ou(e);return Fu(n.subcommand)(n,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]="b59e8e54-f9e0-5cdb-bc59-6dcbf67f278d")}catch{}})();function Lu(e,t){return[...new Set([...ts.filter(o=>e[o]!==void 0),...Object.keys(e).filter(o=>e[o]!==void 0),...t.length>0?["body"]:[]])].sort((o,r)=>o.localeCompare(r))}function Mu(e,t){let n=`copied_from=${e}`;if(!t)return n;let o=t.trim();return o.length>0?`${o} | ${n}`:n}async function mr(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await x(o),s=$(r,A()),i=await oe(o,e,r.id_prefix,r.item_format,s.type_to_folder);if(!i)throw await Jt(o,e,r.id_prefix,s.type_to_folder);let a=await z(i,{schema:r.schema}),c=a.document.metadata,d=S(),l=R(t.author,r.author_default),m=await io(o,r.id_prefix,{tokenLength:r.ids.token_length,typeToFolder:s.type_to_folder,probeExisting:!1}),f=N(r.schema),_=t.title?.trim();if(_!==void 0&&_.length===0)throw new p("Copy --title must not be empty",u.USAGE);let h={...c,id:m,title:_??c.title,status:f.open_status,created_at:d,updated_at:d};delete h.closed_at,delete h.completed_at,delete h.close_reason,delete h.test_runs;let w=Ke(A()),y=Oe({metadata:h,body:a.document.body},{schema:r.schema,extensionFieldNames:w}),g=await Co({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[i.id]},{pmRoot:o,mode:r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0?"off":r.governance.duplicate_detection_mode,threshold:r.governance.duplicate_detection_threshold,limit:r.governance.duplicate_detection_limit,allowDuplicate:t.allowDuplicate}),k=Lu(y.metadata,y.body),E=ht(o,y.metadata.type,m,r.item_format,s.type_to_folder),P=de(o,m),T=await X(o,m,r.locks.ttl_seconds,l,!1,r.governance.force_required_for_stale_lock,r.locks.wait_ms),H={metadata:{},body:""},j,te;try{let B=await Kt(o,l,{required:r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0});try{r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0&&await Co({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[i.id]},{pmRoot:o,mode:"strict",threshold:r.governance.duplicate_detection_threshold,limit:r.governance.duplicate_detection_limit,allowDuplicate:!1});let ce=await oe(o,m,r.id_prefix,r.item_format,s.type_to_folder);if(ce)throw new p(`Cannot copy to ${m}: an item with that id already exists at ${ce.itemPath}. Retry the copy to allocate a new id.`,u.CONFLICT,{code:"item_id_collision",why:`Allocated id ${m} already exists at ${ce.itemPath}.`,recovery:{suggested_retry:`pm copy ${i.id}`}});await W(E,fe(y,{format:r.item_format,schema:r.schema,extensionFieldNames:w}));try{let U=le({nowIso:d,author:l,op:"create",before:H,after:y,message:Mu(i.id,t.message)});await $e(P,U)}catch(U){throw await ut(E),U}te=await Yt({pmRoot:o,preferredFormat:r.item_format,typeToFolder:s.type_to_folder,schema:r.schema,itemPath:E,document:y})}finally{await B()}j=[...await F({path:E,scope:"project",op:"create",item_id:y.metadata.id,item_type:y.metadata.type,before:H,after:y,changed_fields:k}),...await F({path:P,scope:"project",op:"create:history",item_id:y.metadata.id,item_type:y.metadata.type,before:H,after:y,changed_fields:k})],Ut({id:y.metadata.id,op:"create",item_type:y.metadata.type,status:y.metadata.status,current:gt(y.metadata,k),changed_fields:k})}finally{await T()}return{source_id:i.id,item:structuredClone(y.metadata),changed_fields:k,warnings:[...ic(g),...te,...j],...g===void 0?{}:{similarity_advisory:g}}}import In 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]="7819b53c-b0e4-50b0-a670-f80b36765085")}catch{}})();async function pr(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await x(o),s=R(t.author,r.author_default),i=await di({pmRoot:o,settings:r,id:e,author:s,message:t.message,force:t.force,dryRun:t.dryRun}),a=i.targetPath?In.relative(o,i.targetPath).split(In.sep).join("/"):void 0;return{item:i.item,changed_fields:i.changedFields,dry_run:t.dryRun===!0,deleted:t.dryRun!==!0,outcome:t.dryRun===!0?"would_delete":"deleted",previous_status:i.item.status,...a?{target_path:a}:{},history_retained:In.relative(o,de(o,i.item.id)).split(In.sep).join("/"),tombstone_retention:"retain_append_only",warnings:i.warnings}}(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]="a5ddb139-9780-50e0-87a5-621913cb0de4")}catch{}})();async function Du(e){await O(e)}async function ur(e,t,n){let o=I(process.cwd(),n.path);if(await Du(o),t.clear===!0){if(e!==void 0)throw new p("pm focus --clear does not take an item id. Use 'pm focus --clear' to clear focus or 'pm focus <id>' to set it.",u.USAGE);let m=await x(o),f=ro(R(void 0,m.author_default));return await Rs(o),await Io({pmRoot:o,settings:m,principal:f}),{action:"clear",focused_item:null,title:null,message:"Focus cleared. New items will not inherit a default parent."}}if(e===void 0){let m=await Es(o);if(m===void 0)return{action:"show",focused_item:null,title:null,message:"No focus set. Use 'pm focus <id>' to set a default parent for new items."};let f=await Nu(o,m);return{action:"show",focused_item:m,title:f,message:`Focused on ${m}${f?` (${f})`:""}. New items default --parent to it.`}}let s=await x(o),i=$(s,A()),a=await oe(o,e,s.id_prefix,s.item_format,i.type_to_folder);if(!a)throw await Jt(o,e,s.id_prefix,i.type_to_folder);let c=bt(a.id,s.id_prefix),d=await z(a,{schema:s.schema}),l=gd(d.document.metadata.title);return await xs(o,c),await Io({pmRoot:o,settings:s,principal:ro(R(void 0,s.author_default)),itemId:c}),{action:"set",focused_item:c,title:l,message:`Focused on ${c}${l?` (${l})`:""}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`}}async function Nu(e,t){let n=await x(e),o=$(n,A()),r=await oe(e,t,n.id_prefix,n.item_format,o.type_to_folder);if(!r)return null;let s=await z(r,{schema:n.schema});return gd(s.document.metadata.title)}function gd(e){return e.trim().length>0?e:null}import{readFile as Yu,writeFile as Ju}from"node:fs/promises";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]="3c9d6924-ae7c-57c3-a346-1e2189c532fa")}catch{}})();function fr(e,t){let n=Gt(e);if(n)throw new p(`History merge input (${t}) contains unresolved conflict markers at line ${n.line}. Merge drivers must receive clean per-side versions.`,u.GENERIC_FAILURE);let o=[];for(let[r,s]of e.split(/\r?\n/).entries()){let i=s.trim();if(i)try{let a=JSON.parse(i);if(typeof a!="object"||a===null||Array.isArray(a))throw new TypeError("history entry must be an object");o.push(a)}catch{throw new p(`History merge input (${t}) contains invalid JSON at line ${r+1}.`,u.GENERIC_FAILURE)}}return o}function xe(e){return D({ts:e.ts,author:e.author,op:e.op,patch:e.patch,message:e.message??null})}function ju(e,t){let n=Math.min(e.length,t.length),o=0;for(;o<n&&xe(e[o])===xe(t[o]);)o+=1;return o}function yd(e,t,n){fr(e,"base");let o=fr(t,"ours"),r=fr(n,"theirs"),s=ju(o,r);if(s===o.length&&s===r.length)return{merged:_e(o),strategy:"identical",common_entries:s,entries_from_ours:0,entries_from_theirs:0,entries_total:o.length,reanchored:!1};if(s===r.length)return{merged:_e(o),strategy:"fast_forward_ours",common_entries:s,entries_from_ours:o.length-s,entries_from_theirs:0,entries_total:o.length,reanchored:!1};if(s===o.length)return{merged:_e(r),strategy:"fast_forward_theirs",common_entries:s,entries_from_ours:0,entries_from_theirs:r.length-s,entries_total:r.length,reanchored:!1};let i=o.slice(s),a=new Set(i.map(xe)),c=r.slice(s).filter(m=>!a.has(xe(m))),d=[...i,...c].sort((m,f)=>{let _=Pt(m.ts,f.ts);if(_!==0)return _;let h=a.has(xe(m)),w=a.has(xe(f));return h!==w?Number(w)-Number(h):xe(m).localeCompare(xe(f))}),l=Ht([...o.slice(0,s),...d]);return{merged:_e(l.entries),strategy:"union_reanchor",common_entries:s,entries_from_ours:i.length,entries_from_theirs:c.length,entries_total:l.entries.length,reanchored:!0}}function _r(e,t){let n=Gt(e);if(n)throw new p(`Relationship merge input (${t}) contains unresolved conflict markers at line ${n.line}. Merge drivers must receive clean per-side versions.`,u.GENERIC_FAILURE);let o=[];for(let[r,s]of e.split(/\r?\n/).entries()){let i=s.trim();if(!i)continue;let a;try{a=JSON.parse(i)}catch{throw new p(`Relationship merge input (${t}) contains invalid JSON at line ${r+1}.`,u.GENERIC_FAILURE)}if(typeof a!="object"||a===null||Array.isArray(a)||typeof a.eventId!="string"||typeof a.sequence!="number")throw new p(`Relationship merge input (${t}) line ${r+1} is not a relationship event (eventId + sequence required).`,u.GENERIC_FAILURE);o.push(a)}return o}function En(e){return e.length===0?"":`${e.map(t=>JSON.stringify(t)).join(`
+`)}
+`}function Uu(e){return e.map((t,n)=>({...t,sequence:n+1}))}function bd(e,t,n){_r(e,"base");let o=_r(t,"ours"),r=_r(n,"theirs"),s=Math.min(o.length,r.length),i=0;for(;i<s&&o[i].eventId===r[i].eventId;)i+=1;if(i===o.length&&i===r.length)return{merged:En(o),strategy:"identical",common_entries:i,entries_from_ours:0,entries_from_theirs:0,entries_total:o.length,reanchored:!1};if(i===r.length)return{merged:En(o),strategy:"fast_forward_ours",common_entries:i,entries_from_ours:o.length-i,entries_from_theirs:0,entries_total:o.length,reanchored:!1};if(i===o.length)return{merged:En(r),strategy:"fast_forward_theirs",common_entries:i,entries_from_ours:0,entries_from_theirs:r.length-i,entries_total:r.length,reanchored:!1};let a=o.slice(i),c=new Set(a.map(f=>f.eventId)),d=r.slice(i).filter(f=>!c.has(f.eventId)),l=[...a,...d].sort((f,_)=>{if(f.timestamp!==void 0&&_.timestamp!==void 0){let y=Pt(f.timestamp,_.timestamp);if(y!==0)return y}else{if(f.timestamp===void 0&&_.timestamp!==void 0)return 1;if(f.timestamp!==void 0)return-1}let h=c.has(f.eventId),w=c.has(_.eventId);return h!==w?Number(w)-Number(h):0}),m=Uu([...o.slice(0,i),...l]);return{merged:En(m),strategy:"union_reanchor",common_entries:i,entries_from_ours:a.length,entries_from_theirs:d.length,entries_total:m.length,reanchored:!0}}var Gu=["tags","dependencies","comments","notes","learnings","files","tests","test_runs","docs","reminders","events"],qu=["updated_at"];function ze(e,t){return D(e??null)===D(t??null)}function zu(e,t,n){let o=l=>Array.isArray(l)?l:[],r=new Set(o(e).map(l=>D(l))),s=o(t),i=new Set(s.map(l=>D(l))),a=o(n),c=new Set(a.map(l=>D(l))),d=s.filter(l=>{let m=D(l);return!r.has(m)||c.has(m)});for(let l of a){let m=D(l);!i.has(m)&&!r.has(m)&&d.push(l)}return d}function Hu(e,t){return Pt(String(e),String(t))>=0?e:t}function wd(e,t,n,o){return ze(t,n)?{value:t,from_theirs:!1,conflict:!1}:ze(e,t)?{value:n,from_theirs:!0,conflict:!1}:ze(e,n)?{value:t,from_theirs:!1,conflict:!1}:{value:o==="theirs"?n:t,from_theirs:o==="theirs",conflict:!0}}function vd(e,t,n,o,r){let s=wd(e,t,n,o);if(!s.conflict||r==="preferred_side")return s;let i=D(n).localeCompare(D(t))<0;return{value:i?n:t,from_theirs:i,conflict:!0}}function hr(e){return{...e.metadata}}function gr(e,t,n){try{return Oe(qt(e,n),n)}catch(o){throw new p(`Item merge input (${t}) is not a readable item document: ${String(o)}`,u.GENERIC_FAILURE)}}function Bu(e,t,n,o,r){let s=new Set(Gu),i=new Set(qu),a=[...new Set([...Object.keys(t),...Object.keys(n)])].sort((d,l)=>d.localeCompare(l)),c={merged:{},conflictFields:[],fieldsFromTheirs:[],unionFields:[],conflictDecisions:[]};for(let d of a){let l=e[d],m=t[d],f=n[d];if(s.has(d)){let h=zu(l,m,f);c.merged[d]=h,ze(h,m)||c.unionFields.push(d);continue}if(i.has(d)){c.merged[d]=Hu(m,f);continue}let _=vd(l,m,f,o,r);_.value!==void 0&&(c.merged[d]=_.value),_.conflict?(c.conflictFields.push(d),c.conflictDecisions.push({field:d,base:l,ours:m,theirs:f,retained:_.value,discarded:_.from_theirs?m:f})):_.from_theirs&&c.fieldsFromTheirs.push(d)}return c}function kd(e,t,n,o={}){let r=o.preferred??"ours",s=o.conflictResolution??"preferred_side",i=e.trim().length>0,a=gr(t,"ours",o),c=gr(n,"theirs",o),d=i?gr(e,"base",o):a,l=i?hr(d):{},m=hr(a),f=hr(c),{merged:_,conflictFields:h,fieldsFromTheirs:w,unionFields:y,conflictDecisions:g}=Bu(l,m,f,r,s),k=vd(i?d.body:"",a.body,c.body,r,s);return k.conflict?(h.push("body"),g.push({field:"body",base:i?d.body:"",ours:a.body,theirs:c.body,retained:k.value,discarded:k.from_theirs?a.body:c.body})):k.from_theirs&&w.push("body"),{merged:fe({metadata:_,body:k.value},o),conflict_fields:h,fields_from_theirs:w,union_fields:y,conflict_decisions:g,requested_preference:r,conflict_resolution:s}}function yr(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function br(e,t){let n=Gt(e);if(n)throw new p(`JSON merge input (${t}) contains unresolved conflict markers at line ${n.line}.`,u.GENERIC_FAILURE);if(e.trim().length!==0)try{return JSON.parse(e)}catch{throw new p(`JSON merge input (${t}) is not valid JSON.`,u.GENERIC_FAILURE)}}function Vu(e,t,n){if(!Array.isArray(e)||!Array.isArray(t)||!Array.isArray(n))return null;let o=d=>{let l=new Map;for(let m of d){let f=D(m);l.set(f,(l.get(f)??0)+1)}return l},r=o(e),s=o(t),i=o(n);for(let[d,l]of r)if((s.get(d)??0)<l||(i.get(d)??0)<l)return null;let a=new Map(s),c=[];for(let d of n){let l=D(d),m=a.get(l)??0;m>0?a.set(l,m-1):c.push(d)}return{merged:[...t,...c],acceptedTheirs:c.length>0}}function Wu(e,t,n,o,r,s,i){if(!yr(t)||!yr(n))return null;let a=yr(e)?e:{},c={},d=[...new Set([...Object.keys(t),...Object.keys(n)])].sort((l,m)=>l.localeCompare(m));for(let l of d){let m=r.length>0?`${r}.${l}`:l,f=Ku(a,t,n,l,o,m,s,i);f!==void 0&&(c[l]=f)}return c}function Sd(e,t,n,o,r,s,i){if(ze(t,n))return t;let a=Vu(e,t,n);if(a!==null)return a.acceptedTheirs&&i.push(r),a.merged;let c=Wu(e,t,n,o,r,s,i);if(c!==null)return c;let d=wd(e,t,n,o);return d.conflict?s.push(r):d.from_theirs&&i.push(r),d.value}function Ku(e,t,n,o,r,s,i,a){let c=Object.prototype.hasOwnProperty.call(t,o),d=Object.prototype.hasOwnProperty.call(n,o),l=Object.prototype.hasOwnProperty.call(e,o);if(c&&d)return Sd(e[o],t[o],n[o],r,s,i,a);if(c){if(l&&ze(e[o],t[o])){a.push(s);return}return l?(i.push(s),r==="theirs"?void 0:t[o]):t[o]}if(!(l&&ze(e[o],n[o])))return l?(i.push(s),r==="theirs"?n[o]:void 0):(a.push(s),n[o])}function Id(e,t,n,o={}){let r=o.preferred??"ours",s=br(e,"base"),i=br(t,"ours"),a=br(n,"theirs"),c=[],d=[],l=Sd(s,i,a,r,"",c,d);return{merged:`${JSON.stringify(l??null,null,2)}
+`,conflict_paths:c,paths_from_theirs:d,preferred: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]="8d79e3a4-6104-5855-837f-69a041b87b27")}catch{}})();var Ed=["item","history","relationship","json"];function Zu(e){let t=e.trim().toLowerCase();if(Ed.includes(t))return t;throw new p(`Unknown merge artifact "${e}". Supported values: ${Ed.join(", ")}.`,u.USAGE)}function Qu(e){if(e===void 0)return"ours";let t=e.trim().toLowerCase();if(t==="ours"||t==="theirs")return t;throw new p(`Unknown --prefer value "${e}". Supported values: ours, theirs.`,u.USAGE)}async function wr(e,t){try{return await Yu(e,"utf8")}catch{throw new p(`Cannot read merge ${t} file at ${e}.`,u.NOT_FOUND)}}async function ef(e){let t=I(process.cwd(),e.path);return await V(_t(t))?x(t):null}function tf(e,t){return e.endsWith(".md")?"json_markdown":e.endsWith(".toon")?"toon":t?.item_format??"toon"}async function xd(e,t){let n=Zu(e.artifact),o=Qu(e.prefer),r=Xu.resolve(e.outputPath??e.oursPath),[s,i,a]=await Promise.all([wr(e.basePath,"base"),wr(e.oursPath,"ours"),wr(e.theirsPath,"theirs")]),c,d,l=[],m={};if(n==="history"){let _=yd(s,i,a);c=_.merged,m.history={strategy:_.strategy,common_entries:_.common_entries,entries_from_ours:_.entries_from_ours,entries_from_theirs:_.entries_from_theirs,entries_total:_.entries_total,reanchored:_.reanchored}}else if(n==="relationship"){let _=bd(s,i,a);c=_.merged,m.relationship={strategy:_.strategy,common_entries:_.common_entries,entries_from_ours:_.entries_from_ours,entries_from_theirs:_.entries_from_theirs,entries_total:_.entries_total,reanchored:_.reanchored}}else if(n==="item"){let _=await ef(t),h=kd(s,i,a,{format:tf(e.itemPath??r,_),schema:_?.schema,extensionFieldNames:Ke(A()),preferred:o,conflictResolution:"stable_value_order"});c=h.merged,l.push(...h.conflict_fields),m.item={fields_from_theirs:h.fields_from_theirs,union_fields:h.union_fields,conflict_resolution:"stable_value_order"},e.itemPath!==void 0&&(d={cwd:process.cwd(),itemPath:e.itemPath,preferred:o,conflictResolution:"stable_value_order",fieldsFromTheirs:h.fields_from_theirs,unionFields:h.union_fields,decisions:h.conflict_decisions})}else{let _=Id(s,i,a,{preferred:o});c=_.merged,l.push(..._.conflict_paths),m.json={paths_from_theirs:_.paths_from_theirs}}if(await Ju(r,c,"utf8"),d!==void 0){let _=await Ba(d);_!==null&&(m.receipt=It(_))}let f=[];if(l.length>0){let _=m.receipt===void 0?'Run "pm merge report" to inspect clone-local merge evidence.':`Run "pm merge report" and correlate receipt ${m.receipt.receipt_id} with item ${m.receipt.item_id}; clone-local discarded values are never copied into this result.`;f.push(`Both branches changed ${l.join(", ")}; the item driver kept the direction-independent stable value. ${_} Review the merged file, re-apply the discarded change if needed, then "git add" it.`)}return n==="history"&&m.history?.reanchored&&f.push('The merged history chain was re-anchored. Run "pm merge reconcile --dry-run" to inspect the complete post-merge repair, then "pm merge reconcile" to apply it; use --force only after explicitly accepting reported discards.'),{ok:l.length===0,artifact:n,output_path:r,requested_preference:o,conflicts:l,...m,guidance:f,generated_at:S()}}import Cd from"fast-json-patch";(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]="d201aa9f-1ed3-5655-8c06-e5729557b86a")}catch{}})();function Rd(e,t){return t==="body"?e.body:e.metadata[t]}function vr(e,t){if(e===void 0||Object.is(e,t))return!0;if(Array.isArray(e)){if(!Array.isArray(t))return!1;let o=new Set;return e.every(r=>{let s=t.findIndex((i,a)=>!o.has(a)&&vr(r,i));return s<0?!1:(o.add(s),!0)})}if(e===null||t===null||typeof e!="object"||typeof t!="object"||Array.isArray(t))return!1;let n=t;return Object.entries(e).every(([o,r])=>Object.hasOwn(n,o)&&vr(r,n[o]))}function Ad(e,t){let n=new Set(t),o=[];for(let r=e.length-1;r>=0&&n.size>0;r-=1){let s=e[r],i=new Set;for(let c of Us(s.patch))i.add(Bt(c.path)),c.from&&i.add(Bt(c.from));let a=[...n].filter(c=>i.has(c));if(a.length!==0){for(let c of a)n.delete(c);o.push({index:r+1,ts:s.ts,author:s.author,op:s.op,fields:a.sort((c,d)=>c.localeCompare(d))})}}return o.reverse()}function nf(e,t,n){let o=Cd.compare(t,n);if(o.length===0)return;let r=new Set;for(let h of o)r.add(Bt(h.path));let s=new Set([...r].filter(h=>vr(Rd(t,h),Rd(n,h)))),i=new Set([...r].filter(h=>!s.has(h))),a=Ad(e,i),c=Ad(e,s),d=[...r].sort((h,w)=>h.localeCompare(w)),l=[...i].sort((h,w)=>h.localeCompare(w)),m=[...s].sort((h,w)=>h.localeCompare(w)),f=[...new Set(a.map(h=>h.author))].sort((h,w)=>h.localeCompare(w)),_=[...new Set(c.map(h=>h.author))].sort((h,w)=>h.localeCompare(w));return{reconciled_field_count:r.size,reconciled_fields:d,reverted_field_count:i.size,reverted_fields:l,discarded_events:a,discarded_authors:f,preserved_field_count:s.size,preserved_fields:m,preserved_events:c,preserved_authors:_,recovery_hint:a.length>0?"Reconciliation keeps the on-disk item and overwrites these replayed mutations. To recover one, inspect it with pm history <id> --diff --field <field>, then re-apply the lost value with pm update.":null}}async function of(e,t,n,o){let r=e.located?.itemPath??null,s=e.located?await z(e.located,{schema:t.schema}):null;if(!s)return{currentItemReplay:null,currentItemPath:r,matchedChainBefore:null,currentItemRawBeforeLock:null,loadedItem:null};let i=Fe(s.document),a=n[n.length-1]?.after_hash;return{currentItemReplay:i,currentItemPath:r,matchedChainBefore:ne(i,o)===a,currentItemRawBeforeLock:s.raw,loadedItem:s}}function rf(e){return typeof e.message=="string"&&e.message.trim().length>0?e.message:`history-repair re-anchored ${e.entriesRehashed} entr${e.entriesRehashed===1?"y":"ies"}${e.entriesPatchRepaired>0?`, repaired ${e.entriesPatchRepaired} patch(es)`:""}${e.reconcileNeeded?", reconciled chain with on-disk item":""}.`}function sf(e){let t=[...e.reanchorEntries];if(!e.changed)return{rewrittenEntries:t,auditEntryAdded:!1};let n=e.reconcileNeeded&&e.currentItemReplay?e.currentItemReplay:e.finalReplay;return t.push({ts:S(),author:e.author,op:e.auditOperation,patch:e.reconcileNeeded&&e.currentItemReplay?Cd.compare(e.finalReplay,e.currentItemReplay):[],before_hash:ne(e.finalReplay,e.itemHashVersion),after_hash:ne(n,e.itemHashVersion),message:e.message,...e.explicitItemHashVersion?{item_hash_version:e.itemHashVersion}:{},...e.auditContext===void 0?{}:{context:e.auditContext}}),{rewrittenEntries:t,auditEntryAdded:!0}}function af(e,t,n){let o=[];return e||o.push("history_repair_no_changes"),t>0&&o.push(`history_repair_skipped_unresolvable_ops:${t}`),n&&n.discarded_events.length>0&&o.push(`history_repair_reconcile_discards_events:${n.discarded_events.length}`,`history_repair_discarded_authors:${n.discarded_authors.join(",")}`),o}async function cf(e){return nn({pmRoot:e.pmRoot,subject:e.subject,settings:e.settings,typeRegistry:e.typeRegistry,historyRawBeforeLock:e.historyRawBeforeLock,currentItemRawBeforeLock:e.currentItemRawBeforeLock,operation:"history-repair",author:e.author,force:e.force,itemDocument:e.loadedItem?.document??null,applyRewrite:async({historyRawUnderLock:t})=>tn({historyPath:e.historyPath,nextHistoryRaw:_e(e.rewrittenEntries),historyRawUnderLock:t}),applyPostRewrite:async()=>F({path:e.historyPath,scope:"project",op:"history_repair:history"})})}async function Ct(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await x(o),s=$(r,A()),i=await on(o,e,r,s.type_to_folder);if(!await V(i.historyPath))throw new p(`No history stream exists for ${i.id}.`,u.NOT_FOUND);let a=await G(i.historyPath),c=await Xe(i.historyPath,i.id);if(c.length===0)throw new p(`No history entries exist for ${i.id}; nothing to repair.`,u.USAGE);let d=Qe(c),l=Gs(c),m=t.normalizeProvenance?za(c):{entries:c,receipt:{changed:!1,events_changed:0,observations_removed:0,invalid_values:[]}},f=qs(m.entries),_=new Set(m.entries.map(U=>U.item_hash_version).filter(U=>U!==void 0)),h=Ht(m.entries,f),w=await of(i,r,c,f),y=h.finalDocument,g=w.currentItemReplay!==null&&ne(y,f)!==ne(w.currentItemReplay,f),k=g&&w.currentItemReplay?nf(h.entries,y,w.currentItemReplay):void 0,E=[h.entriesRehashed>0,h.entriesPatchRepaired>0,g,t.forceAuditEntry===!0,m.receipt.changed].some(Boolean),P=R(t.author,r.author_default),T=!!t.dryRun,H=rf({message:t.message,entriesRehashed:h.entriesRehashed,entriesPatchRepaired:h.entriesPatchRepaired,reconcileNeeded:g}),{rewrittenEntries:j,auditEntryAdded:te}=sf({reanchorEntries:h.entries,changed:E,reconcileNeeded:g,currentItemReplay:w.currentItemReplay,finalReplay:y,author:P,message:H,auditOperation:t.auditOperation??"history_repair",auditContext:m.receipt.changed?{...t.auditContext,provenance_normalization:m.receipt}:t.auditContext,itemHashVersion:f,explicitItemHashVersion:h.explicitItemHashVersion}),B=Qe(j);if(!B.ok)throw new p(`history-repair produced an invalid rewritten chain (${B.errors.join(", ")}).`,u.GENERIC_FAILURE);let ce=af(E,h.skippedOps,k);return E&&!T&&ce.push(...await cf({pmRoot:o,subject:i,settings:r,typeRegistry:s,historyRawBeforeLock:a,currentItemRawBeforeLock:w.currentItemRawBeforeLock,author:P,force:t.force,loadedItem:w.loadedItem,historyPath:i.historyPath,rewrittenEntries:j})),{id:i.id,dry_run:T,changed:E,history:{path:i.historyPath,entries_scanned:c.length,chain_drift_before:!d.ok,entries_rehashed:h.entriesRehashed,entries_patch_repaired:h.entriesPatchRepaired,converted_replace_to_add:h.convertedReplaceToAdd,skipped_ops:h.skippedOps,reconciled_with_item:g,audit_entry_added:te,verify_ok:B.ok,verify_errors:B.errors,item_hash_version_before:l.item_hash_version??null,item_hash_version_after:f,version_disposition:_.size>1?"selected_for_ambiguous_stream":"preserved"},item:{exists:w.currentItemPath!==null,path:w.currentItemPath,matched_chain_before:w.matchedChainBefore},provenance_normalization:{requested:t.normalizeProvenance===!0,...m.receipt},...k?{reconciliation:k}:{},warnings:[...new Set(ce)].sort((U,jn)=>U.localeCompare(jn)),generated_at:S()}}function Td(e,t){if(t&&e!==void 0)throw new p("history-repair: <id> and --all are mutually exclusive; pass an item id to repair one stream or --all to repair every drifted stream.",u.USAGE);if(!t&&e===void 0)throw new p("history-repair: provide an item <id> or pass --all to repair every drifted stream.",u.USAGE)}async function xn(e,t){let n=I(process.cwd(),t.path);await O(n);let o=await x(n),r=$(o,A()),s=[],i=await ai(n,o.item_format,r.type_to_folder,s,o.schema,{forceSourceScan:!0}),a=await ua(n,i),c=e.normalizeProvenance?await Ha(n):[],d=[...new Set([...a.driftedItems,...c])].sort((_,h)=>_.localeCompare(h)),l=[],m=[],f={repaired:0,skipped_clean:0,failed:0};for(let _ of d)try{let h=await Ct(_,{...e,auditContext:e.auditContextById?.[_],auditContextById:void 0},t),w=h.changed?"repaired":"skipped_clean";f[w]+=1,m.push(...h.warnings.map(y=>`${_}:${y}`)),l.push({id:_,outcome:w,entries_rehashed:h.history.entries_rehashed,entries_patch_repaired:h.history.entries_patch_repaired,reconciled_with_item:h.history.reconciled_with_item,...h.reconciliation?{reconciliation:h.reconciliation}:{},warnings:h.warnings})}catch(h){f.failed+=1,l.push({id:_,outcome:"failed",error:h instanceof Error?h.message:String(h)})}return e.dryRun||await Ns(n),{all:!0,dry_run:!!e.dryRun,scanned_streams:i.length,drifted_streams:a.driftedItems.length,provenance_invalid_streams:c.length,streams:l,totals:f,warnings:[...new Set([...s,...m])].sort((_,h)=>_.localeCompare(h)),generated_at: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]="c5620467-6c8c-5702-b742-57fba9e302c5")}catch{}})();async function Od(e,t){let n=e.dryRun===!0,o=await Va(process.cwd(),{includeLossless:!0}),{pendingDecisions:r}=Wa(o);if(!n&&e.force!==!0&&r.length>0)throw new p(`Merge reconciliation would accept ${r.length} receipt(s) containing discarded scalar values. Review pm merge report and rerun with --force only after deciding which values to retain or re-apply.`,u.CONFLICT,{code:"merge_reconcile_discards_require_acceptance",required:"Explicitly review every discarded field before accepting reconciliation.",nextSteps:r.map(y=>`Review receipt ${y.id} for ${y.item_id}: ${y.decisions.map(g=>g.field).join(", ")}.`),recovery:{suggested_retry:"pm merge reconcile --dry-run"}});let s=o.reduce((y,g)=>((y[g.item_id]??=[]).push(g),y),{}),i=Object.fromEntries(Object.entries(s).map(([y,g])=>[y,{merge:{receipts:g.map(It)}}])),a=await xn({dryRun:n,author:e.author??t.author,message:e.message??"post-merge reconciliation of field-aware tracker history",force:e.force,auditOperation:"merge_reconcile",auditContextById:i},t),c=new Set(a.streams.map(y=>y.id)),d=Object.keys(s).filter(y=>!c.has(y));(await Promise.allSettled(d.map(y=>Ct(y,{dryRun:n,author:e.author??t.author,message:e.message??"record field-aware branch merge provenance",force:e.force,auditOperation:"merge_reconcile",auditContext:i[y],forceAuditEntry:!0},t)))).forEach((y,g)=>{let k=d[g];if(y.status==="fulfilled"){let E=y.value.changed?"repaired":"skipped_clean";a.streams.push({id:k,outcome:E,entries_rehashed:y.value.history.entries_rehashed,entries_patch_repaired:y.value.history.entries_patch_repaired,reconciled_with_item:y.value.history.reconciled_with_item,warnings:y.value.warnings}),a.totals[E]+=1}else a.streams.push({id:k,outcome:"failed",error:y.reason instanceof Error?y.reason.message:String(y.reason)}),a.totals.failed+=1});let m=0;!n&&a.totals.failed===0&&(await Promise.all(o.map(y=>Ka(process.cwd(),y))),m=o.length);let f=await mn({checkHistoryDrift:!0,checkStorageIntegrity:!0},t),_=f.checks.every(y=>y.status==="ok"),h=a.totals.failed===0&&_,w=n?["Review repair.streams, then rerun pm merge reconcile without --dry-run to apply audited repairs.","No Git hook is installed automatically; invoke this command from an explicit post-merge hook only when your repository policy opts in."]:h?["Reconciliation is complete; commit changed history streams with the merge result.","Rerun pm merge reconcile --dry-run after future tracker-data merges as a non-mutating integrity check."]:["Reconciliation remains incomplete; inspect repair failures and non-green validation checks before retrying.","Do not commit repaired history streams as reconciled until pm merge reconcile returns ok=true."];return{ok:h,dry_run:n,repair:a,receipts:{pending_before:o.length,reconciled:m,summaries:o.map(It)},validation:f,guidance:w,generated_at:f.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]="0492d773-2af2-5072-8164-9f8aab536191")}catch{}})();function Tt(e){return{...e.args,...e.options}}function we(e,t){let n=b(e,t);if(n!==void 0)return n;throw new p(`Missing required parameter: ${t}`,u.USAGE)}function it(e){return typeof e=="string"?[e]:K(e)}function $d(e){return _c(Tt(e),e.global)}function Pd(e){let t=Tt(e),n=t.cursorMode;if(n!==void 0&&n!=="batch"&&n!=="row")throw new p("Mutation event cursor mode must be batch or row.",u.USAGE,{code:"invalid_event_cursor_mode"});let o=n;return hc({cwd:b(t,"cwd"),pmRoot:b(t,"path"),since:b(t,"since"),type:it(t.type),author:it(t.author),item:it(t.item),limit:t.limit===void 0?void 0:re(t.limit,"limit"),full:t.full===!0,cursorMode:o,...t.provenance===void 0?{}:{provenance:t.provenance===!0},...t.provenanceSummary===void 0?{}:{provenanceSummary:t.provenanceSummary===!0},...t.harness===void 0?{}:{harness:it(t.harness)},...t.agentInstance===void 0?{}:{agentInstance:it(t.agentInstance)},...t.provenanceFilter===void 0?{}:{provenanceFilter:it(t.provenanceFilter)}})}function Fd(e){let t=Tt(e),n=we(t,"subcommand");if(n==="install")return ka({dryRun:t.dryRun===!0},e.global);if(n==="reconcile")return Od({dryRun:t.dryRun===!0,author:b(t,"author"),message:b(t,"message"),force:t.force===!0},e.global);if(n==="report")return Ya({includeReconciled:t.includeReconciled===!0,cwd:b(t,"cwd")});if(n==="driver")return xd({artifact:we(t,"artifact"),basePath:we(t,"basePath"),oursPath:we(t,"oursPath"),theirsPath:we(t,"theirsPath"),outputPath:b(t,"outputPath")??b(t,"output"),itemPath:b(t,"itemPath"),prefer:b(t,"prefer")},e.global);throw ue({command_path:"merge",token:n,allowed:["install","reconcile","report","driver"],display_name:"merge"})}function Ld(e){let t=Tt(e),n=we(t,"subcommand");if(n!=="snapshot")throw ue({command_path:"workspace",token:n,allowed:["snapshot"],display_name:"workspace"});let o=b(t,"snapshotAction")??we(t,"snapshot_action"),r=I(process.cwd(),e.global.path);if(o==="create")return wc(r,{name:b(t,"name")});if(o==="list")return kc(r);let s=we(t,"target");if(o==="inspect")return vc(r,s);if(o==="delete")return Ec(r,s);if(o==="restore")return t.dryRun===!0?Sc(r,s):Ic(r,s,{force:t.force===!0,author:b(t,"author"),message:b(t,"message"),lockTtlSeconds:re(t.lockTtlSeconds,"lockTtlSeconds"),lockWaitMs:re(t.lockWaitMs,"lockWaitMs")});throw ue({command_path:"workspace snapshot",token:o,allowed:["create","list","inspect","restore","delete"],display_name:"workspace snapshot",token_kind:"action"})}function Rn(e){let t=Tt(e),n=we(t,"title");return e.action==="meet"?gc(n,t,e.global):e.action==="event"?yc(n,t,e.global):bc(n,t,e.global)}import Tf 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]="bed1d1d4-0c1d-59e5-8267-fbe800dfd83b")}catch{}})();var at=["agile","ops","research"],kr={agile:{name:"agile",title:"Agile delivery",summary:"Story/Spike delivery with a review stage, story points, and acceptance ownership.",types:dn.agile,statuses:[{id:"review",roles:["active"],aliases:["in-review"],description:"Work is implementation-complete and awaiting peer review."}],fields:[{key:"story_points",type:"number",commands:["create","update","list"],description:"Relative estimation size for a story or spike.",aliases:["points"]},{key:"acceptance_owner",type:"string",commands:["create","update","list"],description:"Stakeholder accountable for accepting the delivered story.",aliases:["acceptor"]}],workflows:[{type:"Story",allowed_transitions:[["open","in_progress"],["in_progress","review"],["review","in_progress"],["review","closed"],["in_progress","blocked"],["blocked","in_progress"]]}],config:[{key:"search_provider",value:"bm25",summary:"Offline BM25 lexical search works without an embedding service."},{key:"search_max_results",value:"20",summary:"Sprint-sized result cap for quick triage."}],templates:[{name:"story",options:{type:"Story",priority:"2",tags:"story",acceptanceCriteria:"Story delivers the stated user outcome with tests and docs updated.",body:`## As a
+
+## I want
+
+## So that
+
+## Acceptance
+- [ ] 
+`}}],packages:[{spec:"templates",reason:"Reusable create templates for recurring story shapes."},{spec:"calendar",reason:"Sprint and iteration scheduling views."},{spec:"search-advanced",reason:"Richer retrieval as the backlog grows."}]},ops:{name:"ops",title:"Operations",summary:"Incident/Runbook response with mitigation and monitoring stages, severity, and service fields.",types:dn.ops,statuses:[{id:"mitigating",roles:["active"],aliases:["mitigation"],description:"Active mitigation is underway to restore service."},{id:"monitoring",roles:["active"],aliases:["observing"],description:"Mitigation applied; monitoring for recurrence before closure."}],fields:[{key:"severity",type:"string",commands:["create","update","list"],description:"Incident severity classification (e.g. sev1, sev2, sev3).",aliases:["sev"]},{key:"service",type:"string",commands:["create","update","list"],description:"Primary affected service or component."}],workflows:[{type:"Incident",allowed_transitions:[["open","mitigating"],["mitigating","monitoring"],["monitoring","mitigating"],["monitoring","closed"],["mitigating","blocked"],["blocked","mitigating"]]}],config:[{key:"search_provider",value:"bm25",summary:"Offline BM25 lexical search for fast incident lookup."},{key:"search_max_results",value:"25",summary:"Wider result cap to surface related incidents and runbooks."}],templates:[{name:"incident",options:{type:"Incident",priority:"1",tags:"incident",acceptanceCriteria:"Service restored, root cause documented, and follow-ups filed.",body:`## Impact
+
+## Timeline
+
+## Root cause
+
+## Mitigation
+
+## Follow-ups
+`}}],packages:[{spec:"lifecycle-hooks",reason:"Automate transitions and notifications on incident state changes."},{spec:"governance-audit",reason:"Audit incident metadata completeness and closure quality."},{spec:"calendar",reason:"On-call and follow-up scheduling."}]},research:{name:"research",title:"Research",summary:"Experiment/Hypothesis investigation with an analysis stage, hypothesis, and method fields.",types:dn.research,statuses:[{id:"analyzing",roles:["active"],aliases:["analysis"],description:"Data collected; analysis and synthesis in progress."}],fields:[{key:"hypothesis",type:"string",commands:["create","update"],description:"The testable claim the experiment evaluates."},{key:"method",type:"string",commands:["create","update","list"],description:"Experimental method or protocol used to evaluate the hypothesis.",aliases:["protocol"]}],workflows:[{type:"Experiment",allowed_transitions:[["open","in_progress"],["in_progress","analyzing"],["analyzing","in_progress"],["analyzing","closed"],["in_progress","blocked"],["blocked","in_progress"]]}],config:[{key:"search_provider",value:"bm25",summary:"Offline BM25 lexical search across the research corpus."},{key:"search_max_results",value:"50",summary:"Broader recall cap for literature and prior-experiment discovery."}],templates:[{name:"experiment",options:{type:"Experiment",priority:"2",tags:"experiment",acceptanceCriteria:"Hypothesis is supported, rejected, or refined with recorded evidence.",body:`## Hypothesis
+
+## Method
+
+## Results
+
+## Conclusion
+`}}],packages:[{spec:"search-advanced",reason:"Semantic retrieval over experiments and findings."},{spec:"templates",reason:"Consistent experiment and hypothesis scaffolds."},{spec:"beads",reason:"Import structured prior work into the tracker."}]}};function df(e){if(e===void 0)return;let t=Re(e);if(t.length===0)throw new Error("Profile name must not be empty.");if(at.includes(t))return t;throw new Error(`Invalid profile "${e}". Allowed: ${at.join(", ")}.`)}function sv(e){let t=df(e);if(t===void 0)throw new Error(`Profile name is required. Allowed: ${at.join(", ")}.`);return kr[t]}function iv(){return at.map(e=>kr[e])}function Re(e){return e.trim().toLowerCase().replaceAll("-","_")}function Md(e){return e.map(t=>t.definition.name).join(", ")}function Sr(e=[]){let t=at.map(s=>({definition:kr[s],source:"builtin"})),n=new Set(at.map(s=>Re(s))),o=new Set(n),r=[];for(let s of e){let i=Re(s.profile.name);if(n.has(i)){r.push(`Extension "${s.name}" profile "${s.profile.name}" uses a name reserved by a built-in archetype and was ignored.`);continue}if(o.has(i)){r.push(`Profile "${s.profile.name}" from extension "${s.name}" duplicates an already-registered profile and was ignored.`);continue}o.add(i),t.push({definition:s.profile,source:"extension",package:s.name})}return{profiles:t,warnings:r}}function An(e,t=[]){let{profiles:n,warnings:o}=Sr(t);if(typeof e!="string"||e.trim().length===0)throw new Error(`Profile name is required. Allowed: ${Md(n)}.`);let r=Re(e),s=n.find(i=>Re(i.definition.name)===r);if(s===void 0)throw new Error(`Invalid profile "${e}". Allowed: ${Md(n)}.`);return{resolved:s,warnings: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]="933d8f74-c4aa-58d0-bd3b-8932a35d3702")}catch{}})();function Er(e){return{types:e.types.length,statuses:e.statuses.length,fields:e.fields.length,workflows:e.workflows.length,config:e.config.length,templates:e.templates.length,packages:e.packages.length}}function Dd(e){return{name:e.name,title:e.title,summary:e.summary,composition:Er(e),types:e.types.map(t=>Ir(()=>he(t).name,()=>String(t.name??""))),statuses:e.statuses.map(t=>Ir(()=>Me(t).id,()=>String(t.id??""))),fields:e.fields.map(t=>Ir(()=>De(t).key,()=>String(t.key??""))),workflows:e.workflows.map(t=>t.type),config:e.config.map(t=>`${t.key}=${t.value}`),templates:e.templates.map(t=>t.name),packages:e.packages.map(t=>({spec:t.spec,reason:t.reason}))}}function Ir(e,t){try{return e()}catch{return t()}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="f9b22df0-7ec2-5d72-bc88-3eb7201a6051")}catch{}})();var kv=["profile","types","statuses","fields","workflows","config","templates","packages"],Sv=["profile_name_empty","profile_name_not_normalized","profile_title_empty","profile_summary_empty","type_invalid","type_duplicate","status_invalid","status_duplicate","field_invalid","field_duplicate","field_mcp_input_collision","workflow_type_empty","workflow_type_unknown","workflow_duplicate_type","workflow_transition_malformed","workflow_status_unknown","config_key_unknown","config_value_invalid","config_duplicate","template_type_unknown","package_spec_empty"],lf=new Set(ws.flatMap(e=>[Ye(e.id),...(e.aliases??[]).map(t=>Ye(t))]).filter(e=>e.length>0)),Nd=new Set(ft.map(e=>e.toLowerCase()));function mf(e,t){e.name.trim().length===0?t.push({severity:"error",code:"profile_name_empty",dimension:"profile",message:"Profile name must not be empty; profile resolution requires a non-blank name."}):e.name!==Re(e.name)&&t.push({severity:"warning",code:"profile_name_not_normalized",dimension:"profile",target:e.name,message:`Profile name "${e.name}" is not in canonical form; resolution folds it to "${Re(e.name)}" (lowercase, hyphens as underscores).`}),e.title.trim().length===0&&t.push({severity:"warning",code:"profile_title_empty",dimension:"profile",message:"Profile title is empty; list and show surfaces will render a blank title."}),e.summary.trim().length===0&&t.push({severity:"warning",code:"profile_summary_empty",dimension:"profile",message:"Profile summary is empty; list and show surfaces will render a blank archetype description."})}function pf(e,t){let n=new Set,o=new Set;for(let[r,s]of e.types.entries()){let i;try{i=he(s).name}catch(c){t.push({severity:"error",code:"type_invalid",dimension:"types",target:typeof s.name=="string"?s.name:`#${r}`,message:ve(c)});continue}let a=i.toLowerCase();if(o.has(a)){t.push({severity:"error",code:"type_duplicate",dimension:"types",target:i,message:`Item type "${i}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}o.add(a),n.add(a)}return n}function uf(e,t){let n=new Set,o=new Set;for(let[r,s]of e.statuses.entries()){let i;try{i=Me(s)}catch(a){t.push({severity:"error",code:"status_invalid",dimension:"statuses",target:typeof s.id=="string"?s.id:`#${r}`,message:ve(a)});continue}if(o.has(i.id)){t.push({severity:"error",code:"status_duplicate",dimension:"statuses",target:i.id,message:`Status "${i.id}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}o.add(i.id),n.add(i.id);for(let a of i.aliases??[])n.add(Ye(a))}return n}function ff(e,t){let n=new Set;for(let[o,r]of e.fields.entries()){let s;try{s=De(r).key}catch(a){t.push({severity:"error",code:"field_invalid",dimension:"fields",target:typeof r.key=="string"?r.key:`#${o}`,message:ve(a)});continue}if(n.has(s)){t.push({severity:"error",code:"field_duplicate",dimension:"fields",target:s,message:`Field "${s}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}n.add(s);let i=na(s);i&&t.push({severity:"warning",code:"field_mcp_input_collision",dimension:"fields",target:s,message:`Field "${s}" collides with canonical MCP property "${i.property}" owned by ${i.owner}; callers must pass the custom value through ${i.nested_path}.`})}}function _f(e,t,n,o){let r=new Set;for(let[s,i]of e.workflows.entries()){let a=i.type.trim().toLowerCase();if(a.length===0){o.push({severity:"error",code:"workflow_type_empty",dimension:"workflows",target:`#${s}`,message:"Workflow has an empty type; the workflow resolver drops entries without a type."});continue}let c=r.has(a);r.add(a),c?o.push({severity:"warning",code:"workflow_duplicate_type",dimension:"workflows",target:i.type,message:`Workflow type "${i.type}" is declared more than once; the later transition set wins.`}):!Nd.has(a)&&!t.has(a)&&o.push({severity:"warning",code:"workflow_type_unknown",dimension:"workflows",target:i.type,message:`Workflow governs type "${i.type}" which is neither a built-in type nor declared by this profile; it has no effect unless that type already exists.`});let d=new Set;for(let l of i.allowed_transitions){let m=Ye(l[0]),f=Ye(l[1]);if(m.length===0||f.length===0){o.push({severity:"error",code:"workflow_transition_malformed",dimension:"workflows",target:i.type,message:`Workflow "${i.type}" has a transition with an empty status; the workflow resolver silently drops it.`});continue}for(let _ of[m,f])lf.has(_)||n.has(_)||d.has(_)||(d.add(_),o.push({severity:"warning",code:"workflow_status_unknown",dimension:"workflows",target:_,message:`Workflow "${i.type}" references status "${_}" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`}))}}}function hf(e,t){let n=new Set;for(let o of e.config){let r=ot(o.key);if(r===void 0){t.push({severity:"error",code:"config_key_unknown",dimension:"config",target:o.key,message:`Config knob "${o.key}" is not a recognized setting; apply rejects it with a usage error.`});continue}n.has(r.key)?t.push({severity:"error",code:"config_duplicate",dimension:"config",target:r.key,message:`Config knob "${r.key}" is set more than once; the later value silently overwrites the earlier one.`}):n.add(r.key);let s=_n(r,o.value);s.ok||t.push({severity:"error",code:"config_value_invalid",dimension:"config",target:o.key,message:s.error.message})}}function gf(e,t,n){for(let o of e.templates){let r=o.options.type;if(typeof r!="string"||r.trim().length===0)continue;let s=r.trim().toLowerCase();!Nd.has(s)&&!t.has(s)&&n.push({severity:"warning",code:"template_type_unknown",dimension:"templates",target:o.name,message:`Template "${o.name}" creates type "${r}" which is neither a built-in type nor declared by this profile.`})}}function yf(e,t){for(let[n,o]of e.packages.entries())o.spec.trim().length===0&&t.push({severity:"warning",code:"package_spec_empty",dimension:"packages",target:`#${n}`,message:"Package recommendation has an empty spec; it cannot be surfaced as an install hint."})}function jd(e){let t=[];mf(e,t);let n=pf(e,t),o=uf(e,t);ff(e,t),_f(e,n,o,t),hf(e,t),gf(e,n,t),yf(e,t);let r=t.filter(i=>i.severity==="error").length,s=t.length-r;return{profile:e.name,ok:r===0,findings:t,errorCount:r,warningCount: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]="ead1caea-8e8b-5208-9fba-23fb114044b5")}catch{}})();function xr(e,t,n,o,r){let s=e,i=[];for(let a of t){let c=o(s),d=r(s,a),l=o(d.file);s=d.file;let m=c===l?"unchanged":d.replaced?"update":"add";i.push({key:n(a),status:m})}return{file:s,changes:i,changed:i.some(a=>a.status!=="unchanged")}}function Ud(e){return JSON.stringify(e.map(t=>t.join("\0")).sort())}function bf(e,t){let n=e.map(r=>({...r})),o=[];for(let r of t){let s=n.findIndex(a=>a.type===r.type),i={type:r.type,allowed_transitions:r.allowed_transitions};s<0?(n.push(i),o.push({type:r.type,status:"add"})):Ud(n[s].allowed_transitions)===Ud(r.allowed_transitions)?o.push({type:r.type,status:"unchanged"}):(n[s]=i,o.push({type:r.type,status:"update"}))}return{changes:o,result:n,changed:o.some(r=>r.status!=="unchanged")}}function wf(e,t){let n=[];for(let o of e.config){let r=ot(o.key);if(r===void 0)throw new Error(`Profile "${e.name}" references unknown config key "${o.key}".`);let s=_n(r,o.value);if(!s.ok)throw new Error(`Profile "${e.name}" config ${o.key}: ${s.error.message}`);let i=mc(t,r),a=i===null?"add":i===s.parsed.value?"unchanged":"update";n.push({key:r.key,path:r.path,value:s.parsed.value,status:a})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function Gd(e){let t=Object.entries(e).sort(([n],[o])=>n.localeCompare(o));return JSON.stringify(t)}function vf(e,t){let n=[];for(let o of e.templates){let r=t.get(o.name),s;r===void 0?s="add":Gd(r)===Gd(o.options)?s="unchanged":s="update",n.push({name:o.name,options:o.options,status:s})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function qd(e,t){let n=xr(Zs(t.typesRaw),e.types,l=>he(l).name,Wt,(l,m)=>Qs(l,he(m))),o=xr(Sa(t.statusesRaw),e.statuses,l=>Me(l).id,an,(l,m)=>Ia(l,Me(m))),r=xr(Ea(t.fieldsRaw),e.fields,l=>De(l).key,cn,(l,m)=>xa(l,De(m))),s=bf(t.workflows,e.workflows),i=wf(e,t.settings),a=vf(e,t.templates),c=e.packages.map(l=>({spec:l.spec,reason:l.reason,status:t.installedPackages.has(l.spec)?"installed":"recommended"})),d=n.changed||o.changed||r.changed||s.changed||i.changed||a.changed;return{profile:{name:e.name,title:e.title,summary:e.summary},types:n,statuses:o,fields:r,workflows:s,config:i,templates:a,packages:c,changed:d}}import Hd from"node:fs/promises";import Bd 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]="5c70da27-21f6-5d31-b506-96e1818996d6")}catch{}})();var kf="templates",Rr=".json",Vd=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/,Sf=Si.map(e=>e.target).filter(e=>e!=="acceptanceCriteria"),If=new Set(Sf),zd="1970-01-01T00:00:00.000Z",Wd={bug:{type:"Issue",priority:"1",tags:"bug",acceptanceCriteria:"Bug no longer reproduces with the steps below and a regression test guards it.",expectedResult:"Describe the correct behavior.",actualResult:"Describe the observed (buggy) behavior.",body:`## Repro steps
+1. 
+2. 
+3. 
+
+## Expected
+
+## Actual
+`},feature:{type:"Feature",priority:"2",tags:"feature",acceptanceCriteria:"Feature is shipped behind agreed scope with tests and docs updated.",whyNow:"Explain why this is worth doing now (impact / urgency).",body:`## Goal
+
+## Why now
+
+## Out of scope
+`},spike:{type:"Task",priority:"2",tags:"spike",estimatedMinutes:"120",acceptanceCriteria:"Timeboxed investigation complete; findings and a recommendation are recorded.",body:`## Question to answer
+
+## Timebox
+2h
+
+## Findings
+
+## Recommendation
+`},chore:{type:"Chore",priority:"3",tags:"chore",acceptanceCriteria:"Maintenance task done with no behavior change and green checks.",body:`## What
+
+## Why
+`}},qv={normalizeTemplateName:Cn,extractTemplateOptions:Kd,parseStoredTemplateDocument:Or,builtinTemplateDocument:Yd,readStoredTemplateDocument:Xd};function Cn(e){let t=e.trim();if(!Vd.test(t))throw new p(`Invalid template name "${e}". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`,u.USAGE);return t}function Ar(e){return Bd.join(e,kf)}function Tn(e,t){return Bd.join(Ar(e),`${t}${Rr}`)}async function Cr(e){await O(e)}function Tr(e){return Object.fromEntries(Object.entries(e).sort(([t],[n])=>t.localeCompare(n)))}function Kd(e){let t={};for(let[n,o]of Object.entries(e))if(o!==void 0){if(If.has(n)){if(typeof o=="string"){t[n]=[o];continue}if(!Array.isArray(o))continue;let r=o.filter(s=>typeof s=="string");r.length>0&&(t[n]=r);continue}if(typeof o=="string"){t[n]=o;continue}Array.isArray(o)&&o.every(r=>typeof r=="string")&&(t[n]=[...o])}return Tr(t)}function Ef(e,t){if(typeof e!="object"||e===null||Array.isArray(e))throw new p(`Template "${t}" has invalid options payload.`,u.GENERIC_FAILURE);let n=e,o={};for(let[r,s]of Object.entries(n)){let i=r.trim();if(i.length===0)throw new p(`Template "${t}" contains an empty option key.`,u.GENERIC_FAILURE);if(typeof s=="string"){o[i]=s;continue}if(Array.isArray(s)&&s.every(a=>typeof a=="string")){o[i]=[...s];continue}throw new p(`Template "${t}" contains invalid value for option "${i}".`,u.GENERIC_FAILURE)}return Tr(o)}function Or(e,t){let n;try{n=JSON.parse(e)}catch{throw new p(`Template "${t}" contains invalid JSON.`,u.GENERIC_FAILURE)}if(typeof n!="object"||n===null||Array.isArray(n))throw new p(`Template "${t}" has invalid document shape.`,u.GENERIC_FAILURE);let o=n,r=Ef(o.options,t),s=S();return{name:typeof o.name=="string"&&o.name.trim().length>0?o.name.trim():t,created_at:typeof o.created_at=="string"?o.created_at:s,updated_at:typeof o.updated_at=="string"?o.updated_at:s,options:r}}function Yd(e){let t=Wd[e];return t?{name:e,created_at:zd,updated_at:zd,options:Tr({...t})}:null}async function Jd(e,t){let n=await G(Tn(e,t));if(n!==null)return{document:Or(n,t),source:"user"};let o=Yd(t);if(o)return{document:o,source:"builtin"};throw new p(`Template "${t}" not found`,u.NOT_FOUND)}async function Xd(e,t){let n=await G(Tn(e,t));if(n===null)throw new p(`Template "${t}" not found`,u.NOT_FOUND);return Or(n,t)}async function xf(e,t){let n=Cn(t),{document:o}=await Jd(e,n);return o.options}async function $r(e,t,n){let o=I(process.cwd(),n.path);await Cr(o);let r=Cn(e),s=Kd(t);if(Object.keys(s).length===0)throw new p("templates save requires at least one create option flag",u.USAGE);let i=S(),a=Tn(o,r),c=i;await V(a)&&(c=(await Xd(o,r)).created_at);let d={name:r,created_at:c,updated_at:i,options:s},l=await x(o);return await Hd.mkdir(Ar(o),{recursive:!0}),await et({pmRoot:o,filePath:a,raw:`${JSON.stringify(d,null,2)}
+`,op:"templates:save",author:R(void 0,l.author_default),lockTtlSeconds:l.locks.ttl_seconds,lockWaitMs:l.locks.wait_ms}),{name:d.name,created_at:d.created_at,updated_at:d.updated_at,path:a,options:d.options}}async function Rf(e){let t=Ar(e);return await V(t)?(await Hd.readdir(t)).filter(o=>o.toLowerCase().endsWith(Rr)).map(o=>o.slice(0,-Rr.length)).filter(o=>Vd.test(o)):[]}async function Af(e){let t=I(process.cwd(),e.path);await Cr(t);let n=await Rf(t),o=new Set(n),r=Object.keys(Wd).filter(c=>!o.has(c)),s=[...n].sort((c,d)=>c.localeCompare(d)),i=[...r].sort((c,d)=>c.localeCompare(d)),a=[...new Set([...s,...i])].sort((c,d)=>c.localeCompare(d));return{templates:a,count:a.length,builtin_templates:i,user_templates:s}}async function Cf(e,t){let n=I(process.cwd(),t.path);await Cr(n);let o=Cn(e),{document:r,source:s}=await Jd(n,o);return{name:r.name,source:s,created_at:r.created_at,updated_at:r.updated_at,path:s==="builtin"?`builtin:${o}`:Tn(n,o),options:r.options}}(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]="f65b4f1f-5501-5829-a04b-d4fbcfb59f5c")}catch{}})();var tl=["list","show","apply","lint"],Of="schema-types",$f="schema-statuses",Pf="schema-fields";function On(){let e=A();return e===null?[]:e.profiles.map(t=>({name:t.name,profile:t.profile}))}function nl(){let{profiles:e,warnings:t}=Sr(On());return{action:"list",profiles:e.map(n=>({name:n.definition.name,title:n.definition.title,summary:n.definition.summary,source:n.source,...n.package!==void 0?{package:n.package}:{},composition:Er(n.definition)})),warnings:t,generated_at:S()}}function ol(e){let t;try{t=An(e,On())}catch(o){throw new p(o instanceof Error?o.message:String(o),u.USAGE)}let{resolved:n}=t;return{action:"show",...Dd(n.definition),source:n.source,...n.package!==void 0?{package:n.package}:{},warnings:t.warnings,generated_at:S()}}function rl(e){let t;try{t=An(e,On())}catch(r){throw new p(r instanceof Error?r.message:String(r),u.USAGE)}let{resolved:n}=t,o=jd(n.definition);return{action:"lint",name:n.definition.name,title:n.definition.title,source:n.source,...n.package!==void 0?{package:n.package}:{},ok:o.ok,error_count:o.errorCount,warning_count:o.warningCount,findings:o.findings,warnings:t.warnings,generated_at:S()}}function Ff(e,t){return Tf.join(e,"templates",`${t}.json`)}async function Lf(e,t){let n=await G(Ff(e,t));if(n!==null)try{let o=JSON.parse(n);if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let r=o.options;if(r!==null&&typeof r=="object"&&!Array.isArray(r))return r}}catch{}}async function Zd(e,t,n,o){let r=new Map;for(let s of o.templates){let i=await Lf(e,s.name);i!==void 0&&r.set(s.name,i)}return{typesRaw:await G(Ce(e,t.files.types,Ae.types)),statusesRaw:await G(Ce(e,t.files.statuses,Ae.statuses)),fieldsRaw:await G(Ce(e,t.files.fields,Ae.fields)),workflows:n.schema.type_workflows??[],settings:n,templates:r,installedPackages:new Set}}function ct(e){let t=[],n=[],o=[];for(let r of e)(r.status==="add"?t:r.status==="update"?n:o).push(r.key);return{added:t,updated:n,unchanged:o}}function Qd(e,t,n,o,r){return{action:"apply",name:e.name,title:e.title,applied:n,dry_run:o,changed:t.changed,types:ct(t.types.changes),statuses:ct(t.statuses.changes),fields:ct(t.fields.changes),workflows:ct(t.workflows.changes.map(s=>({key:s.type,status:s.status}))),config:ct(t.config.changes),templates:ct(t.templates.changes.map(s=>({key:s.name,status:s.status}))),packages:t.packages,warnings:[...new Set(r)].sort((s,i)=>s.localeCompare(i)),generated_at:S()}}async function Mf(e){await O(e)}function Df(e){try{let t=An(e,On());return{profile:t.resolved.definition,warnings:t.warnings}}catch(t){throw new p(t instanceof Error?t.message:String(t),u.USAGE)}}async function sl(e,t,n){let o=I(process.cwd(),n.path);await Mf(o);let r=Df(e),s=r.profile,i=r.warnings,a=t.dryRun===!0,c=await x(o),d=vs(c.schema);if(a){let g=await Zd(o,d,c,s),k=el(s,g);return Qd(s,k,!1,!0,[...i])}let l=R(t.author,c.author_default),m=ti(c),f=!!t.force,_=[...i],h=[],w=async g=>{h.push(await X(o,g,c.locks.ttl_seconds,l,f,m.force_required_for_stale_lock,c.locks.wait_ms))},y;try{await w(Of),await w($f),await w(Pf);let g=await Zd(o,d,c,s);if(y=el(s,g),y.types.changed){let k=Ce(o,d.files.types,Ae.types);await et({pmRoot:o,filePath:k,raw:Wt(y.types.file),op:"profile:apply-types",author:l,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms});let E=new Set(s.types.map(T=>he(T).name)),P=y.types.file.definitions.filter(T=>E.has(T.name));await Oa(o,P,_,"profile:apply-type-folder"),_.push(...await F({path:k,scope:"project",op:"profile:apply-types"}))}if(y.statuses.changed){let k=Ce(o,d.files.statuses,Ae.statuses);await et({pmRoot:o,filePath:k,raw:an(y.statuses.file),op:"profile:apply-statuses",author:l,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),_.push(...await F({path:k,scope:"project",op:"profile:apply-statuses"}))}if(y.fields.changed){let k=Ce(o,d.files.fields,Ae.fields);await et({pmRoot:o,filePath:k,raw:cn(y.fields.file),op:"profile:apply-fields",author:l,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),_.push(...await F({path:k,scope:"project",op:"profile:apply-fields"}))}if(y.config.changed||y.workflows.changed){for(let k of y.config.changes){if(k.status==="unchanged")continue;let E=ot(k.key);E!==void 0&&pc(c,E,k.value)}c.schema.type_workflows=y.workflows.result,await ni(o,c,"profile:apply-config")}for(let k of y.templates.changes)k.status!=="unchanged"&&await $r(k.name,{...k.options},n)}finally{for(let g of h.reverse())try{await g()}catch{}}return Qd(s,y,y.changed,!1,_)}function el(e,t){try{return qd(e,t)}catch(n){throw new p(n instanceof Error?n.message:String(n),u.USAGE)}}function Nf(e,t){let n=[];if(t.added.length>0&&n.push(`+${t.added.join(", ")}`),t.updated.length>0&&n.push(`~${t.updated.join(", ")}`),n.length!==0)return`  ${e}: ${n.join("  ")}`}function uk(e){let t=["Project profiles:"];for(let n of e.profiles){let o=n.source==="extension"?` [${n.package??"extension"}]`:"";t.push(`  ${n.name} \u2014 ${n.title}: ${n.summary}${o}`)}for(let n of e.warnings)t.push(`  warning: ${n}`);return t.join(`
+`)}function fk(e){let t=e.source==="extension"?` [${e.package??"extension"}]`:"",n=[`${e.name} \u2014 ${e.title}${t}`,e.summary,""];n.push(`types: ${e.types.join(", ")||"(none)"}`),n.push(`statuses: ${e.statuses.join(", ")||"(none)"}`),n.push(`fields: ${e.fields.join(", ")||"(none)"}`),n.push(`workflows: ${e.workflows.join(", ")||"(none)"}`),n.push(`config: ${e.config.join(", ")||"(none)"}`),n.push(`templates: ${e.templates.join(", ")||"(none)"}`),n.push(`packages: ${e.packages.map(o=>o.spec).join(", ")||"(none)"}`);for(let o of e.warnings)n.push(`warning: ${o}`);return n.join(`
+`)}function _k(e){let t=e.source==="extension"?` [${e.package??"extension"}]`:"",n=e.warning_count+e.warnings.length,r=[e.ok?`Profile ${e.name}${t}: ok (${n} warning${n===1?"":"s"})`:`Profile ${e.name}${t}: ${e.error_count} error${e.error_count===1?"":"s"}, ${n} warning${n===1?"":"s"}`];for(let s of e.findings){let i=s.target!==void 0?` (${s.target})`:"";r.push(`  ${s.severity} [${s.code}] ${s.dimension}${i}: ${s.message}`)}for(let s of e.warnings)r.push(`  warning: ${s}`);return r.join(`
+`)}function hk(e){let t=e.dry_run?"dry-run":e.applied?"applied":"no changes",n=[`Profile ${e.name} (${t})`];if(!e.changed)n.push("  already up to date");else for(let[r,s]of[["types",e.types],["statuses",e.statuses],["fields",e.fields],["workflows",e.workflows],["config",e.config],["templates",e.templates]]){let i=Nf(r,s);i!==void 0&&n.push(i)}let o=e.packages.filter(r=>r.status==="recommended");o.length>0&&n.push(`  recommended packages: ${o.map(r=>r.spec).join(", ")}`);for(let r of e.warnings)n.push(`  warning: ${r}`);return n.join(`
+`)}import al from"node:fs/promises";import cl 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]="7e0f84f6-9528-55c5-8976-6f85cd920486")}catch{}})();function jf(e,t,n){let o=new Set,r=[];for(let s of e){let i=s.trim();if(i.length===0||o.has(i))continue;o.add(i);let a=t.get(i);if(a===void 0){r.push({id:i,entries:0,selected:!1,skip_reason:"no_stream"});continue}if(a.entries<=n){r.push({id:i,entries:a.entries,selected:!1,skip_reason:"already_compact"});continue}r.push({id:i,entries:a.entries,selected:!0,skip_reason:null})}return r}function Uf(e,t){let n=[...e].sort((r,s)=>s.entries-r.entries||r.id.localeCompare(s.id)),o=[];for(let r of n){if(t.scope==="closed"&&r.bucket!=="closed"){o.push({id:r.id,entries:r.entries,selected:!1,skip_reason:"scope_mismatch"});continue}if(r.entries<=t.minEntries){o.push({id:r.id,entries:r.entries,selected:!1,skip_reason:"already_compact"});continue}if(t.allOver!==void 0&&r.entries<=t.allOver){o.push({id:r.id,entries:r.entries,selected:!1,skip_reason:"below_threshold"});continue}o.push({id:r.id,entries:r.entries,selected:!0,skip_reason:null})}return o}function il(e,t){if(t.ids!==void 0&&t.ids.length>0){let n=new Map(e.map(o=>[o.id,o]));return jf(t.ids,n,t.minEntries)}return Uf(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]="adcf4d1b-689d-52cb-903b-5fba857707f3")}catch{}})();function Gf(e,t){if(e===void 0)return{kind:"default",raw:null,compactCount:t.length,retainedCount:0};let n=e.trim();if(n.length===0)throw new p("history-compact --before requires a non-empty value.",u.USAGE);if(/^\d+$/.test(n)){let s=Number.parseInt(n,10);if(!Number.isSafeInteger(s)||s<1||s>t.length+1)throw new p(`history-compact --before version must be between 1 and ${t.length+1}.`,u.USAGE);let i=Math.max(0,Math.min(t.length,s-1));return{kind:"version",raw:n,compactCount:i,retainedCount:t.length-i}}let o=Date.parse(n);if(!Number.isFinite(o))throw new p(`Invalid history-compact --before value "${e}". Use a version number or ISO timestamp.`,u.USAGE);let r=0;for(let[s,i]of t.entries()){let a=Date.parse(i.ts);if(!Number.isFinite(a))throw new p(`History for this item contains invalid timestamp at entry ${s+1}.`,u.GENERIC_FAILURE);if(a>=o)break;r+=1}return{kind:"timestamp",raw:n,compactCount:r,retainedCount:t.length-r}}function qf(e,t){let n=zt(),o=zt();for(let r=0;r<e.length;r+=1){let s=e[r];if(ne(n)!==s.before_hash)throw new p(`history-compact detected before-hash drift at entry ${r+1}; run pm history-repair first.`,u.CONFLICT);if(n=en(n,s.patch,r+1,s.op),ne(n)!==s.after_hash)throw new p(`history-compact detected after-hash drift at entry ${r+1}; run pm history-repair first.`,u.CONFLICT);r+1===t&&(o=structuredClone(n))}return{checkpoint:o,finalReplay:n}}function zf(e,t,n){let o=structuredClone(t),r=[];for(let[s,i]of e.entries()){let a=ne(o);o=en(o,i.patch,n+s+1,i.op),r.push({...i,before_hash:a,after_hash:ne(o)})}return{entries:r,finalReplay:o}}async function Hf(e,t,n){let o=e.located?await z(e.located,{schema:t.schema}):null;return o?{loadedItem:o,currentItemRawBeforeLock:o.raw,matchedChainBefore:ne(Fe(o.document))===n[n.length-1]?.after_hash}:{loadedItem:null,currentItemRawBeforeLock:null,matchedChainBefore:null}}function Bf(e,t){return typeof e.message=="string"&&e.message.trim().length>0?e.message:t.raw===null?`history-compact compacted full stream (${t.compactCount} entr${t.compactCount===1?"y":"ies"}).`:`history-compact compacted ${t.compactCount} entr${t.compactCount===1?"y":"ies"} before ${t.raw}.`}function Vf(e){return e.raw===null?`history-compact baseline snapshot after compacting ${e.compactCount} entr${e.compactCount===1?"y":"ies"}.`:`history-compact baseline snapshot before ${e.raw}.`}function Wf(e){if(!e.changed)return{rewrittenEntries:e.historyEntries,baselineEntryAdded:!1,auditEntryAdded:!1};let{checkpoint:t,finalReplay:n}=qf(e.historyEntries,e.boundary.compactCount),o=e.historyEntries.slice(e.boundary.compactCount),r=zf(o,t,e.boundary.compactCount),i=[le({nowIso:S(),author:e.author,op:"history_compact_baseline",before:Pe(zt()),after:Pe(t),message:Vf(e.boundary)}),...r.entries];return e.dryRun||i.push(le({nowIso:S(),author:e.author,op:"history_compact",before:Pe(n),after:Pe(n),message:Bf(e.options,e.boundary)})),{rewrittenEntries:i,baselineEntryAdded:!0,auditEntryAdded:!e.dryRun}}async function Kf(e){return nn({pmRoot:e.pmRoot,subject:e.subject,settings:e.settings,typeRegistry:e.typeRegistry,historyRawBeforeLock:e.historyRawBeforeLock,currentItemRawBeforeLock:e.currentItemRawBeforeLock,operation:"history-compact",author:e.author,force:e.force,itemDocument:e.loadedItem?.document??null,applyRewrite:async({historyRawUnderLock:t})=>tn({historyPath:e.historyPath,nextHistoryRaw:_e(e.rewrittenEntries),historyRawUnderLock:t}),applyPostRewrite:async()=>F({path:e.historyPath,scope:"project",op:"history_compact:history"})})}async function Pr(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await x(o),s=$(r,A()),i=await on(o,e,r,s.type_to_folder),a=i.historyPath,c=await G(a);if(c===null)throw new p(`No history stream exists for ${i.id}.`,u.NOT_FOUND);let d=await Xe(a,i.id);if(d.length===0)throw new p(`No history entries exist for ${i.id}; nothing to compact.`,u.USAGE);let l=Qe(d);if(!l.ok)throw new p(`history-compact requires a valid history chain (${l.errors.join(", ")}). Run pm history-repair ${i.id} first.`,u.CONFLICT);let m=Gf(t.before,d),f=m.compactCount>0,_=!!t.dryRun,h=R(t.author,r.author_default),w=[];f||w.push("history_compact_noop_before_boundary");let y=await Hf(i,r,d);y.matchedChainBefore===!1&&w.push("history_compact_item_chain_mismatch");let{rewrittenEntries:g,baselineEntryAdded:k,auditEntryAdded:E}=Wf({historyEntries:d,boundary:m,changed:f,dryRun:_,author:h,options:t}),P=Qe(g);if(!P.ok)throw new p(`history-compact produced an invalid rewritten chain (${P.errors.join(", ")}).`,u.GENERIC_FAILURE);f&&!_&&w.push(...await Kf({pmRoot:o,subject:i,settings:r,typeRegistry:s,historyRawBeforeLock:c,currentItemRawBeforeLock:y.currentItemRawBeforeLock,author:h,force:t.force,loadedItem:y.loadedItem,historyPath:a,rewrittenEntries:g}));let T=m.retainedCount>0?m.compactCount+1:null;return{id:i.id,dry_run:_,changed:f,compact_boundary:{kind:m.kind,before:m.raw,entries_compacted:m.compactCount,entries_retained:m.retainedCount,first_retained_entry:T},history:{path:a,entries_scanned:d.length,entries_after:g.length,baseline_entry_added:k,audit_entry_added:E,verify_ok:P.ok,verify_errors:P.errors},item:{exists:i.located!==null,path:i.located?.itemPath??null,matched_chain_before:y.matchedChainBefore},warnings:[...new Set(w)].sort((H,j)=>H.localeCompare(j)),generated_at:S()}}var Yf=3;function dl(e,t){let n=t.ids!==void 0&&t.ids.length>0,o=t.allOver!==void 0||t.scope!==void 0;if((e!==void 0?1:0)+(n?1:0)+(o?1:0)===0)throw new p("history-compact: provide an item <id>, or a bulk selector (--ids, --all-over <N>, --closed, or --all-streams).",u.USAGE);if(e!==void 0&&(n||o))throw new p("history-compact: <id> and bulk selectors (--ids/--all-over/--closed/--all-streams) are mutually exclusive; pass one item id, or use bulk mode without a positional id.",u.USAGE);if(n&&o)throw new p("history-compact: --ids is mutually exclusive with --all-over/--closed/--all-streams; pass an explicit id list or a scan selector, not both.",u.USAGE)}function Jf(e){let t=0;for(let n of e.split(/\r?\n/))n.trim().length>0&&(t+=1);return t}async function Xf(e){let t=N(e.settings.schema),n=tc(t),o=await Le(e.pmRoot,e.settings.item_format,e.typeToFolder,void 0,e.settings.schema),r=new Map(o.map(d=>[d.id,n.classify(d.status)])),s=cl.join(e.pmRoot,"history"),i=[],a=[];if(!await V(s))return{candidates:i,preselectionErrors:a};let c=(await al.readdir(s)).filter(d=>d.endsWith(".jsonl")).sort((d,l)=>d.localeCompare(l));for(let d of c){let l=cl.join(s,d),m=d.slice(0,-6);try{let f=await al.readFile(l,"utf8");await oo({path:l,scope:"project"}),i.push({id:m,entries:Jf(f),bucket:r.get(m)??null})}catch(f){a.push({id:m,outcome:"errored",entries_before:0,entries_after:null,skip_reason:null,changed:!1,error:f instanceof Error?f.message:String(f)})}}return{candidates:i,preselectionErrors:a}}async function Zf(e){if(!e.row.selected)return{selected:!1,compacted:!1,errored:!1,result:{id:e.row.id,outcome:"skipped",entries_before:e.row.entries,entries_after:null,skip_reason:e.row.skip_reason,changed:!1,error:null}};try{let t=await Pr(e.row.id,{dryRun:e.dryRun,author:e.options.author,message:e.options.message,force:e.options.force},e.global);return{selected:!0,compacted:!0,errored:!1,result:{id:e.row.id,outcome:"compacted",entries_before:e.row.entries,entries_after:t.history.entries_after,skip_reason:null,changed:t.changed,error:null}}}catch(t){return{selected:!0,compacted:!1,errored:!0,result:{id:e.row.id,outcome:"errored",entries_before:e.row.entries,entries_after:null,skip_reason:null,changed:!1,error:t instanceof Error?t.message:String(t)}}}}async function ll(e,t){let n=I(process.cwd(),t.path);await O(n);let o=await x(n),r=$(o,A()),{candidates:s,preselectionErrors:i}=await Xf({pmRoot:n,settings:o,typeToFolder:r.type_to_folder}),a=e.ids!==void 0&&e.ids.length>0?"ids":"scan",c=e.minEntries??Yf,d=o.history.compact_policy,l=a==="scan"&&e.allOver===void 0&&d.enabled,m=e.allOver??(l?d.max_entries:void 0),f=il(s,{ids:e.ids,scope:e.scope,minEntries:c,allOver:m}),_=!!e.dryRun,h=[...i],w={streams_considered:s.length+i.length,selected:0,items_compacted:0,items_skipped:0,items_errored:i.length};for(let y of f){let g=await Zf({row:y,options:e,dryRun:_,global:t});if(h.push(g.result),!g.selected){w.items_skipped+=1;continue}w.selected+=1,g.compacted&&(w.items_compacted+=1),g.errored&&(w.items_errored+=1)}return{bulk:!0,dry_run:_,mode:a,scope:e.scope??null,criteria:{min_entries:c,all_over:m??null,policy_threshold_applied:l},totals:w,results:h,generated_at: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]="f762b5e6-8224-531f-9dd1-f71dc18c3ddf")}catch{}})();function ml(e){let t=e.options.all===!0,n=e.id??b(e.options,"id");return Td(n,t),t?xn(e.options,e.global):Ct(n,e.options,e.global)}function pl(e){let t=e.options.ids,n=Array.isArray(t)?t.map(String).filter(d=>d.trim().length>0):typeof t=="string"?t.split(",").map(d=>d.trim()).filter(Boolean):void 0,o=re(e.options.allOver??e.options.all_over,"history-compact allOver"),r=re(e.options.minEntries??e.options.min_entries,"history-compact minEntries"),s=b(e.options,"scope"),i=[];e.options.closed===!0&&i.push("closed"),(e.options.allStreams===!0||e.options.all_streams===!0)&&i.push("all-streams"),(s==="closed"||s==="all-streams")&&i.push(s);let a=[...new Set(i)];if(a.length>1)throw new p("history-compact: closed and all-streams scopes are mutually exclusive.",u.USAGE);let c=a[0];return dl(e.id,{ids:n,allOver:o,scope:c}),e.id!==void 0?Pr(e.id,{before:b(e.options,"before"),dryRun:e.options.dryRun===!0||e.options.dry_run===!0,author:b(e.options,"author"),message:b(e.options,"message"),force:e.force},e.global):ll({ids:n,scope:c,allOver:o,minEntries:r,dryRun:e.options.dryRun===!0||e.options.dry_run===!0,author:b(e.options,"author"),message:b(e.options,"message"),force:e.force},e.global)}(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]="08dcee99-5572-5133-b76a-6a50e4e292e7")}catch{}})();async function Fr(e,t,n,o){let r=t.trim();if(r.length===0)throw new p("pm item reopen requires a non-empty recurrence reason.",u.USAGE,{code:"reopen_reason_required",required:"Describe why the terminal work became active again.",recovery:{suggested_retry:`pm item reopen ${e} "<recurrence reason>"`,suggested_retry_args:["item","reopen",e,"<recurrence reason>"]}});let s=I(process.cwd(),o.path),i=N((await x(s)).schema),a=i.open_status,c=hn(i),d=n.status??a,l=Te(d,i)??d;if(l!==a&&l!==c)throw new p(`Reopen target status must be ${a} or ${c}; received ${d}.`,u.USAGE,{code:"reopen_target_status_invalid",required:"Choose the workspace open or in-progress lifecycle status.",recovery:{allowed_values:[...new Set([a,c])],suggested_retry:`pm item reopen ${e} "${r}" --status ${a}`,suggested_retry_args:["item","reopen",e,r,"--status",a]}});let m=await cc(e,{status:l,unset:["close-reason","resolution","expected-result","actual-result","fixed-version"],author:n.author,message:n.message,force:n.force},o,r);return{item:m.item,changed_fields:m.changed_fields,warnings:m.warnings,recurrence:m.lifecycle_transition}}(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]="55869854-565d-52d2-8dca-b66aade074bb")}catch{}})();function ul(e,t){let n=e.id??b(t,"id");if(!n)throw new p("Missing required argument: id",64);return n}function fl(e,t){return b(e.args,"reason")??b(e.args,"text")??b(t,"reason")??b(t,"text")}async function _l(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options);return ae(await Ne(ul(e,o),fl(e,o),{...o,force:e.force===!0||o.force===!0},e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function hl(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options);return ae(await Fr(ul(e,o),fl(e,o)??"",{...o,force:e.force===!0||o.force===!0},e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly: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]="c2ef0de1-bc44-5550-862c-f3929334fbef")}catch{}})();function gl(e,t,n){let o;if(typeof e.lines=="string")o=vo(e.lines);else if(e.lineRange!==void 0){if(e.lineRange===null||typeof e.lineRange!="object"||Array.isArray(e.lineRange))throw new RangeError("Source line range must be an object with numeric start and end values.");o=vo(`${String(Reflect.get(e.lineRange,"start"))}:${String(Reflect.get(e.lineRange,"end"))}`)}return{paths:t,scope:e.scope==="project"||e.scope==="global"?e.scope:void 0,limit:n(e.limit,"files lookup limit"),offset:n(e.offset,"files lookup offset"),noTruncate:e.noTruncate===!0,strictRead:e.strictRead===!0,explain:e.explain===!0,lineRange:o,decisionDepth:n(e.decisionDepth,"files lookup decision depth")}}(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]="0e63298a-d2d7-5217-af50-a206348b4cd4")}catch{}})();function yl(e){return{includeEmpty:e.includeEmpty===!0,storage:e.storage===!0,metadataCoverage:e.metadataCoverage===!0,fieldUtilization:e.fieldUtilization===!0,byAssignee:e.byAssignee===!0,byTag:e.byTag===!0,byPriority:e.byPriority===!0,tagPrefix:typeof e.tagPrefix=="string"?e.tagPrefix:void 0,measurements:e.measurements===!0,metric:b(e,"metric"),measurementLimit:typeof e.measurementLimit=="number"?e.measurementLimit:void 0,observe:K(e.observe),direction:typeof e.improvementDirection=="string"?e.improvementDirection:void 0,measurementSource:b(e,"measurementSource"),measurementItem:b(e,"measurementItem"),measurementRevision:b(e,"measurementRevision"),author:b(e,"author"),message:b(e,"message"),provenanceCoverage:e.provenanceCoverage===!0,fleetAttribution:e.fleetAttribution===!0,since:b(e,"since"),eventLimit:typeof e.eventLimit=="number"?e.eventLimit:void 0,minimumSample:typeof e.minimumSample=="number"?e.minimumSample: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]="2643d11d-befc-5a87-8bec-760951eec4d0")}catch{}})();var Qf=new Set(["true","1","yes","on"]),e_=new Set(["false","0","no","off"]);function t_(e,t,n=[]){let o=[t,...n];for(let r of o){let s=e[r];if(typeof s=="string"&&s.trim().length>0)return s.trim()}}function n_(e,t,n=[]){let o=[t,...n];for(let r of o){let s=e[r];if(s!==void 0){if(typeof s=="boolean")return s;if(typeof s=="string"){let i=s.trim().toLowerCase();if(Qf.has(i))return!0;if(e_.has(i))return!1}}}}function o_(e,t,n=[]){for(let o of[t,...n]){let r=e[o],i=(typeof r=="string"?r.split(","):Array.isArray(r)?r.flatMap(a=>typeof a=="string"?a.split(","):[]):[]).map(a=>a.trim()).filter(a=>a.length>0);if(i.length>0)return i}return[]}(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]="863df651-49e0-552f-a7f0-92c3cc9a12a2")}catch{}})();function q(e){if(typeof e!="string")return;let t=e.trim();return t.length>0?t:void 0}function r_(e){if(typeof e=="number"&&Number.isFinite(e)&&e>=0)return e;if(typeof e=="string"&&e.trim().length>0){let t=Number(e);if(Number.isFinite(t)&&t>=0)return t}}function s_(e){if(typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=4)return e;if(typeof e=="string"&&e.trim().length>0){let t=Number(e);if(Number.isInteger(t)&&t>=0&&t<=4)return t}return 2}function i_(e){if(Array.isArray(e)){let t=e.filter(n=>typeof n=="string").map(n=>n.trim().toLowerCase()).filter(n=>n.length>0);return Array.from(new Set(t)).sort((n,o)=>n.localeCompare(o))}return typeof e=="string"?wt(e):[]}function a_(e){let t=q(e);if(t){let n=Te(t);if(n)return n}return"open"}function Mr(e){if(typeof e=="number"&&Number.isInteger(e))return e;if(typeof e!="string"||e.trim().length===0)return;let t=Number(e);return Number.isInteger(t)?t:void 0}function bl(e){if(typeof e=="boolean")return e;if(typeof e=="number")return e===1?!0:e===0?!1:void 0;if(typeof e!="string")return;let t=e.trim().toLowerCase();return t==="true"||t==="1"?!0:t==="false"||t==="0"?!1:void 0}function dt(e){if(!Array.isArray(e))return;let t=e.map(n=>q(n)).filter(n=>n!==void 0);return t.length>0?t:void 0}function Lr(e){return kl(e,q)}function wl(e){return kl(e,Il)}function c_(e,t){if(typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=100)return e;let n=q(e)?.toLowerCase();if(!n)return;let o=n==="med"?"medium":n;if(t.some(s=>s===o))return o;let r=Number(o);return Number.isInteger(r)&&r>=0&&r<=100?r:void 0}function vl(e,t){let n=q(e)?.toLowerCase();if(!n)return;let o=n==="med"?"medium":n;return t.includes(o)?o:void 0}function Dr(e){return q(e)?.toLowerCase()==="global"?"global":"project"}function d_(e,t){let n=Nr(e,t.allowScalar===!0);if(!n)return;let o=n.map(r=>f_(r,t)).filter(r=>r!==void 0);return o.length>0?o:void 0}function l_(e,t={}){return Sl(e,t,(n,o)=>({path:n,scope:Dr(o?.scope),note:q(o?.note)}))}function m_(e,t={}){return Sl(e,t,(n,o)=>({path:n,scope:Dr(o?.scope),note:q(o?.note)}))}function p_(e,t={}){let n=Nr(e,t.allowScalar===!0);if(!n)return;let o=n.map(r=>g_(r,t)).filter(r=>r!==void 0);return o.length>0?o:void 0}function u_(e,t){return R(e,t)}function Pn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Nr(e,t){return Array.isArray(e)?e:t?[e]:void 0}function $n(e,t){for(let n of t){let o=q(e[n]);if(o)return o}}function kl(e,t){if(!Pn(e))return;let n=Object.entries(e).map(([o,r])=>[o.trim(),t(r)]).filter(o=>o[0].length>0&&o[1]!==void 0);return n.length>0?Object.fromEntries(n):void 0}function f_(e,t){if(typeof e=="string")return __(e,t);if(!Pn(e))return;let n=$n(e,t.textKeys??["text"]);if(!n)return;let o=t.createdAtKey??"created_at",r=t.authorKey??"author";return{created_at:(t.toIsoString?t.toIsoString(e[o]):q(e[o]))??t.fallbackCreatedAt,author:q(e[r])??t.fallbackAuthor,text:n}}function __(e,t){let n=q(e);return n?{created_at:t.fallbackCreatedAt,author:t.fallbackAuthor,text:n}:void 0}function Sl(e,t,n){let o=Nr(e,t.allowScalar===!0);if(!o)return;let r=t.pathKeys??["path"],s=o.map(i=>h_(i,r,n)).filter(i=>i!==void 0);return s.length>0?s:void 0}function h_(e,t,n){if(typeof e=="string"){let r=q(e);return r?n(r):void 0}if(!Pn(e))return;let o=$n(e,t);return o?n(o,e):void 0}function g_(e,t){if(typeof e=="string"){let r=q(e);return r?{command:r,scope:"project"}:void 0}if(!Pn(e))return;let n=$n(e,t.commandKeys??["command"]),o=$n(e,t.pathKeys??["path"]);if(!(!n&&(t.requireCommand===!0||!o)))return{...n?{command:n}:{},...o?{path:o}:{},scope:Dr(e.scope),timeout_seconds:y_(e.timeout_seconds,t),note:q(e.note),...t.includeExtendedAssertions===!0?b_(e):{}}}function y_(e,t){let n=t.integerTimeout===!0?Mr(e):Il(e);if(n===void 0)return;let o=t.timeoutMinimum??0;return t.timeoutExclusiveMinimum===!0?n>o?n:void 0:n>=o?n:void 0}function Il(e){if(typeof e=="number"&&Number.isFinite(e))return e;if(typeof e!="string"||e.trim().length===0)return;let t=Number(e);return Number.isFinite(t)?t:void 0}function b_(e){return{pm_context_mode:vl(e.pm_context_mode,["schema","tracker","auto"]),env_set:Lr(e.env_set),env_clear:dt(e.env_clear),shared_host_safe:bl(e.shared_host_safe),assert_stdout_contains:dt(e.assert_stdout_contains),assert_stdout_regex:dt(e.assert_stdout_regex),assert_stderr_contains:dt(e.assert_stderr_contains),assert_stderr_regex:dt(e.assert_stderr_regex),assert_stdout_min_lines:Mr(e.assert_stdout_min_lines),assert_json_field_equals:Lr(e.assert_json_field_equals),assert_json_field_gte:wl(e.assert_json_field_gte)}}async function w_(e){await O(e)}function El(){return{metadata:{},body:""}}async function v_(e){let{pmRoot:t,id:n,itemPath:o,document:r,author:s,message:i,settings:a,conflictWarningPrefix:c}=e,d=de(t,n),l=El();try{let m=await X(t,n,a.locks.ttl_seconds,s,!1,a.governance.force_required_for_stale_lock,a.locks.wait_ms);try{await W(o,fe(r,{format:"toon"}));try{let f=le({nowIso:S(),author:s,op:"import",before:l,after:r,message:i});return await $e(d,f),{committed:!0,writeWarnings:[...await F({path:o,scope:"project",op:"import",item_id:r.metadata.id,item_type:r.metadata.type,before:l,after:r,changed_fields:["imported"]}),...await F({path:d,scope:"project",op:"import:history",item_id:r.metadata.id,item_type:r.metadata.type,before:l,after:r,changed_fields:["imported"]})]}}catch(f){throw await ut(o),f}}finally{await m()}}catch(m){if(m instanceof p&&m.exitCode===u.CONFLICT)return{committed:!1,conflictWarning:`${c}:${n}`};throw m}}import{readFile as S_}from"node:fs/promises";import I_ 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]="7be35c3f-df6f-5ed6-b887-a7d8d53910a7")}catch{}})();function k_(e){return e.trim().toLowerCase().replaceAll("_","-")}var Ur=[{id:"quickstart",aliases:["start","getting-started","bootstrap"],title:"Quickstart",summary:"Initialize a tracker and run the shortest safe plan -> execute -> close loop.",intent:"Use this when a human or agent needs to start productive work quickly with minimal context load.",commands:["pm init","pm context --limit 10","pm list --status open --limit 20",'pm create --create-mode progressive --title "..." --description "..." --type Task',"pm claim <ID>","pm update <ID> --status in_progress",'pm close <ID> "<reason with evidence>" --validate-close warn'],workflows:[{name:"Start Session Safely",goal:"Bootstrap without mutating unrelated state.",prompt:"You are bootstrapping pm work. Use a token-efficient context snapshot first, then select one open item, claim it, and only then mutate.",commands:["pm context --limit 10","pm list --status open --limit 20","pm claim <ID>"]}],docs:[{path:"README.md",purpose:"High-level project and install entrypoint."},{path:"docs/QUICKSTART.md",purpose:"Short setup and first-command walkthrough."},{path:"docs/COMMANDS.md",purpose:"Task-oriented command recipes."}],related:["commands","workflows","release"]},{id:"commands",aliases:["cli","operations","reference"],title:"CLI Command Routing",summary:"Find the right command family quickly and use command-scoped help/contracts output.",intent:"Use this when selecting command paths, flags, and output formats for implementation or automation.",commands:["pm --help","pm <command> --help","pm <command> --help --explain","pm contracts --command <command> --flags-only","pm contracts --command <command> --availability-only --runtime-only","pm completion <bash|zsh|fish>"],workflows:[{name:"Flag Discovery",goal:"Resolve command flags deterministically before mutations.",prompt:"You are preparing to run a command. Use help and contracts surfaces to verify required/optional flags before execution.",commands:["pm <command> --help --explain","pm contracts --command <command> --flags-only"]}],docs:[{path:"docs/COMMANDS.md",purpose:"Command grouping and examples."},{path:"docs/CONFIGURATION.md",purpose:"Project/global settings and policy controls."},{path:"docs/TESTING.md",purpose:"Linked-test orchestration and safety guidance."}],related:["quickstart","workflows","sdk","extensions"]},{id:"workflows",aliases:["developer","maintainer","agent"],title:"Developer and Agent Workflows",summary:"Apply canonical claim -> execute -> verify -> close workflows with append-only evidence.",intent:"Use this for day-to-day coding-agent execution loops and handoff-safe updates.",commands:["pm claim <ID>","pm update <ID> --status in_progress","pm files <ID> --add ...","pm test <ID> --add ...",'pm comments <ID> "..."',"pm validate --check-resolution --check-history-drift","pm release <ID>"],workflows:[{name:"Execution Loop",goal:"Keep code, tests, and tracker evidence synchronized.",prompt:"You are implementing a scoped change. Claim first, link files/tests/docs as you go, append evidence comments, and close only after validation.",commands:["pm claim <ID>","pm update <ID> --status in_progress","pm files <ID> --add path=<file>,scope=project","pm test <ID> --run --progress",'pm close <ID> "<evidence>" --validate-close warn']}],docs:[{path:"AGENTS.md",purpose:"Repository operating rules and required workflow."},{path:"docs/AGENT_GUIDE.md",purpose:"Agent-oriented usage and context strategy."},{path:"docs/TESTING.md",purpose:"Sandbox-safe test execution rules."}],related:["quickstart","commands","skills"]},{id:"sdk",aliases:["api","typescript-sdk"],title:"SDK and Integrations",summary:"Use the published SDK surface for extension authoring and contract-safe integrations.",intent:"Use this when building or reviewing programmatic integrations against @unbrained/pm-cli/sdk.",commands:["pm contracts --schema-only","pm contracts --command extension --flags-only","pm contracts --runtime-only --availability-only"],workflows:[{name:"Integration Contract Check",goal:"Confirm action schemas and runtime availability before coding.",prompt:"You are wiring an integration. Capture schema + runtime availability first, then map your adapter payload fields to contract keys.",commands:["pm contracts --schema-only","pm contracts --availability-only --runtime-only","pm contracts --command <command> --flags-only"]}],docs:[{path:"docs/SDK.md",purpose:"Public SDK exports and extension authoring references."},{path:"docs/ARCHITECTURE.md",purpose:"Core runtime composition and extension load flow."}],related:["extensions","commands"]},{id:"extensions",aliases:["plugins","extension-authoring","packages","package-authoring"],title:"Packages and Extensions",summary:"Install, author, and diagnose packages/extensions with deterministic lifecycle controls.",intent:"Use this for package management, extension capability registration, and runtime diagnostics.",commands:["pm install <target> --project","pm upgrade --dry-run","pm package explore --project","pm package manage --detail summary","pm package doctor --detail deep","pm package activate <target> --project","pm package deactivate <target> --project"],workflows:[{name:"Lifecycle Triage",goal:"Diagnose extension state before forceful lifecycle actions.",prompt:"You are debugging package behavior. Inspect managed state first, then run doctor diagnostics, then apply install/adopt/activate actions.",commands:["pm package explore --project","pm package manage --detail summary","pm package doctor --detail deep","pm upgrade --packages-only --dry-run"]}],docs:[{path:"docs/EXTENSIONS.md",purpose:"Capability model and lifecycle command usage."},{path:"docs/examples/starter-extension/README.md",purpose:"Starter extension scaffold and local development path."},{path:"docs/SDK.md",purpose:"SDK contracts used by extension implementations."}],related:["sdk","commands","skills"]},{id:"skills",aliases:["agent-skills","agentskills"],title:"Agent Skills",summary:"Skill bundles for developer, user, extensions, and sdk workflows aligned to the current CLI.",intent:"Use this when an agent needs reproducible prompts/workflows with strict compatibility metadata.",commands:["pm guide skills --depth deep","pm contracts --command guide --flags-only","pm validate --check-command-references"],workflows:[{name:"Skill Selection",goal:"Pick the narrowest compatible skill first to minimize context usage.",prompt:"Select a pm skill based on the task intent, then execute only the workflow section needed for the current change.",commands:["pm guide skills","pm guide skills --depth deep"]}],docs:[{path:"docs/AGENT_GUIDE.md",purpose:"Agent-first usage and context model."},{path:"docs/README.md",purpose:"Documentation routing with progressive disclosure."},{path:".agents/skills/README.md",purpose:"Agent skills index and routing overview."},{path:".agents/skills/pm-developer/SKILL.md",purpose:"Developer-oriented pm skill workflow."},{path:".agents/skills/pm-user/SKILL.md",purpose:"User/operator pm skill workflow."},{path:".agents/skills/pm-extensions/SKILL.md",purpose:"Extension-focused pm skill workflow."},{path:".agents/skills/pm-sdk/SKILL.md",purpose:"SDK integration pm skill workflow."}],related:["workflows","harnesses","commands"]},{id:"harnesses",aliases:["compatibility","agent-compatibility"],title:"Agent Harness Compatibility",summary:"Cross-harness compatibility guidance for docs routing.",intent:"Use this when adapting pm docs and SDK contracts for an external automation harness.",commands:["pm guide skills","pm guide commands","pm contracts --runtime-only --availability-only"],workflows:[{name:"Harness Mapping",goal:"Route each harness to the same canonical skill/docs sources.",prompt:"Map harness-specific entrypoints to the same pm guide topics and .agents/skills workflows without adding runtime harness-specific code.",commands:["pm guide harnesses --depth standard","pm guide skills --depth deep"]}],docs:[{path:"docs/AGENT_GUIDE.md",purpose:"Agent context and output-mode conventions."},{path:"docs/README.md",purpose:"Single-source documentation routing entrypoint."},{path:".agents/skills/HARNESS_COMPATIBILITY.md",purpose:"Harness compatibility matrix and usage notes."}],related:["skills","workflows"]},{id:"release",aliases:["gates","ship","release-readiness"],title:"Release and Staleness Gates",summary:"Run release gates and docs/skills freshness checks before publishing.",intent:"Use this when validating release readiness and preventing docs/skills drift.",commands:["pnpm build","pnpm test:coverage","pnpm quality:static","node scripts/release/run-gates.mjs --telemetry-mode best-effort","pnpm security:scan"],workflows:[{name:"Pre-Release Gate Sweep",goal:"Ensure code, docs, and skills are all green before publish.",prompt:"Run release gates in deterministic order and treat docs/skills freshness failures as release blockers.",commands:["pnpm build","pnpm test:coverage","node scripts/release/run-gates.mjs --telemetry-mode best-effort"]}],docs:[{path:"docs/RELEASING.md",purpose:"Release flow and safety checks."},{path:"CHANGELOG.md",purpose:"Versioned release history and unreleased notes."},{path:"scripts/release/run-gates.mjs",purpose:"Source of truth for release gate ordering."}],related:["commands","skills","workflows"]},{id:"tokens",aliases:["output","budget","context-cost","projections"],title:"Read Output and Token Budgets",summary:"Bound what a read costs before it is emitted, and resume the part a budget withheld.",intent:"Use this when an agent must keep context small: every read declares a token ceiling, degrades deterministically, and reports what it omitted.",commands:["pm contracts --summary --json","pm list --status open --output-limit 20","pm get <ID> --output-include id,title,status,dependencies","pm context --limit 10 --token-accounting","pm notes <ID> --output-cursor <cursor>","pm list --status closed --output-budget unbounded"],workflows:[{name:"Bound A Read Before Emitting It",goal:"Never pay for rows the task does not need.",prompt:"Choose the narrowest projection first, then a row limit, then a token budget. Read the omission receipt before concluding the result is complete.",commands:["pm contracts --command list --flags-only --json","pm list --status open --output-limit 20 --output-format toon","pm list --status open --token-accounting"]},{name:"Recover A Truncated Read",goal:"Continue a bounded read instead of re-running it unbounded.",prompt:"When output_budget_truncation appears, prefer the declared continuation cursor. Only widen the budget when the response declares no cursor.",commands:["pm notes <ID> --output-cursor <cursor>","pm get <ID> --output-budget 20000"]}],docs:[{path:"docs/READ_OUTPUT_CONTRACTS.md",purpose:"Budget, truncation, continuation, and omission receipts."},{path:"docs/OUTPUT_PROJECTION_CONTRACTS.md",purpose:"Field and section projection grammar for every read."},{path:"docs/OUTPUT_TOKEN_ACCOUNTING.md",purpose:"Per-section token cost receipts."},{path:"docs/ITEM_READ_PROJECTIONS.md",purpose:"Item-level projection defaults and restore hints."}],related:["commands","workflows","quickstart"]},{id:"graph",aliases:["relationships","deps","dependencies","analytics"],title:"Relationship Graph and Planning Analytics",summary:"Type the relationships between items, then read the project as a graph rather than as a list.",intent:"Use this when the question is about lineage, ordering, blast radius, bottlenecks, or which work reaches a declared outcome.",commands:["pm deps <ID>",'pm update <ID> --dep "id=<other>,kind=implements"',"pm graph analyze","pm graph impact <ID> --direction downstream","pm graph paths <ID> <ID>","pm graph audit"],workflows:[{name:"Place New Work In The Ladder",goal:"Every item resolves to an outcome through a typed, explainable path.",prompt:"Set parent lineage first, then add typed edges that cite durable evidence. Never add an edge to satisfy a count.",commands:['pm search "<topic>" --limit 10','pm update <ID> --dep "id=<parent-goal>,kind=implements"',"pm graph ancestors <ID>"]},{name:"Assess Blast Radius Before Changing Something",goal:"Know what derives from an item before touching it.",prompt:"Walk the directed graph downstream from the item, then check whether any bottleneck node sits on the path.",commands:["pm graph impact <ID> --direction downstream","pm graph dominators <ID>","pm graph articulation"]}],docs:[{path:"docs/RELATIONSHIP_GRAPH.md",purpose:"Graph model, traversal verbs, and analytics surface."},{path:"docs/DEPENDENCY_KIND_CONTRACT.md",purpose:"Every typed edge kind, its direction, and its semantics."}],related:["commands","workflows","assurance"]},{id:"assurance",aliases:["gates","invariants","measurements","quality"],title:"Declared Invariants and Gates",summary:"Express a project's own quality rules as tracked data the SDK evaluates, instead of as scripts.",intent:"Use this when a rule must hold over the record itself \u2014 a floor, a ceiling, or a monotone property \u2014 and must fail closed in CI.",commands:["pm assurance list","pm assurance run <gate-id> --trigger ci --dry-run","pm validate --check-resolution --check-history-drift","pm health --summary"],workflows:[{name:"Add An Invariant Rather Than A Script",goal:"A new enforcement gap becomes declared data, not a new bespoke gate script.",prompt:"Define the measurement, bind an assertion with an explicit bound and polarity, prove a negative control, then attach it to a trigger.",commands:["pm assurance list --json","pm assurance run <gate-id> --trigger ci --dry-run --json"]},{name:"Read A Verdict Before Believing It",goal:"Know which population a passing assertion speaks for.",prompt:"Read population_size and scope on every assertion. A gate that cannot fail for the reason it exists is not evidence.",commands:["pm assurance run <gate-id> --trigger ci --dry-run --json --output-budget unbounded"]}],docs:[{path:"docs/ASSURANCE.md",purpose:"Measurement, assertion, gate, and trigger vocabulary."},{path:"docs/MUTATION_INTEGRITY.md",purpose:"What every mutation must record to remain provable."}],related:["release","graph","workflows"]},{id:"merge",aliases:["branches","concurrency","multi-agent","fleet"],title:"Branching, Merging, and Concurrent Agents",summary:"Keep tracker data and history conflict-free while many agents work on separate branches.",intent:"Use this when more than one agent or worktree mutates the same tracker and the results must merge without hand resolution.",commands:["pm merge install","pm claim <ID>","pm release <ID>","pm validate --check-history-drift","pm health --check-only"],workflows:[{name:"Prepare A Clone For Field-Aware Merges",goal:"The committed merge fence needs clone-local driver configuration once.",prompt:"Run the merge installer in every fresh clone or worktree before the first branch merge of tracker data.",commands:["pm merge install","pm health --check-only"]},{name:"Hand Work Between Agents Safely",goal:"Ownership and evidence survive the handoff.",prompt:"Claim before substantial edits, record evidence as comments, and release the claim when pausing, handing off, closing, or canceling.",commands:["pm claim <ID>",'pm comments <ID> "Handoff: <state and next step>"',"pm release <ID>"]}],docs:[{path:"docs/MERGE_SAFETY.md",purpose:"Merge driver, field-aware resolution, and clone setup."},{path:"docs/SDK_CONTEXT_COORDINATION.md",purpose:"Coordination primitives for concurrent agents."}],related:["workflows","assurance","commands"]}],jr=new Map;for(let e of Ur){jr.set(e.id,e);for(let t of e.aliases)jr.set(t,e)}function xl(){return Ur.map(e=>({...e,aliases:[...e.aliases],commands:[...e.commands],workflows:e.workflows.map(t=>({...t,commands:[...t.commands]})),docs:e.docs.map(t=>({...t})),related:[...e.related]}))}function Fn(){return Ur.map(e=>e.id)}function Rl(e){if(!e)return null;let t=k_(e);return t?jr.get(t)??null:null}(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]="27be0fa5-1c6a-53de-a0e8-179aab7c795a")}catch{}})();var E_=["markdown","toon","json"],x_=["brief","standard","deep"];function R_(e){if(!e)return;let t=e.trim().toLowerCase();if(!E_.includes(t))throw new p("Guide format must be one of markdown|toon|json",u.USAGE);return t}function A_(e,t){let n=R_(e.format);if(t.json&&n&&n!=="json")throw new p("Cannot combine --json with --format markdown|toon",u.USAGE);return t.json?"json":n??"toon"}function C_(e){if(!e)return"brief";let t=e.trim().toLowerCase();if(!x_.includes(t))throw new p("Guide depth must be one of brief|standard|deep",u.USAGE);return t}function T_(){return rs(process.env,"PM_CLI_PACKAGE_ROOT",import.meta.url,["..","..",".."])}function Al(e){return e.replaceAll(`\r
+`,`
+`)}function O_(e,t,n){let r=Al(e).split(`
+`),i=r.slice(0,t).join(`
+`),a=r.length>t;return i.length>n&&(i=i.slice(0,n),a=!0),{excerpt:i.trimEnd(),truncated:a,lineCount:r.length}}async function $_(e,t,n){let o=t!=="brief",r=o?t==="deep"?"full":"excerpt":"none",s=[];for(let i of e.docs){let a=I_.resolve(n,i.path);if(!o){s.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!0,line_count:null,content_mode:"none",content:null,truncated:!1});continue}try{let c=await S_(a,"utf8");if(t==="deep"){let d=Al(c).trimEnd();s.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!0,line_count:d.length===0?0:d.split(`
+`).length,content_mode:"full",content:d,truncated:!1})}else{let d=O_(c,120,12e3);s.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!0,line_count:d.lineCount,content_mode:r,content:d.excerpt,truncated:d.truncated})}}catch(c){let d=Ve(c);if(s.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!1,line_count:null,content_mode:"none",content:null,truncated:!1}),!d)throw new p(`Failed to read guide document "${i.path}".`,u.GENERIC_FAILURE)}}return s}function P_(e){let t=xl().map(n=>({id:n.id,aliases:n.aliases,title:n.title,summary:n.summary,intent:n.intent,quick_commands:e==="brief"?n.commands.slice(0,3):n.commands.slice(0,6),docs:n.docs.map(o=>({path:o.path,purpose:o.purpose})),related:n.related}));return{output_default:"toon",mode:"index",depth:e,topics:t,suggested_next_steps:["pm guide <topic>","pm guide <topic> --depth standard","pm guide <topic> --depth deep --format markdown","pm guide <topic> --json"]}}function F_(e){let t=Rl(e);if(t)return t;let n=Fn().join(", ");throw new p(`Unknown guide topic "${e}". Available topics: ${n}. Use "pm guide --list" to browse.`,u.USAGE)}async function L_(e,t){let n=C_(typeof e.depth=="string"?e.depth:void 0),o=e.list===!0,r=typeof e.topic=="string"?e.topic:void 0;if(o||!r)return P_(n);let s=F_(r),i=T_(),a=await $_(s,n,i),c=a.filter(d=>!d.exists&&!d.optional).map(d=>`Missing required guide document: ${d.path}`);return{output_default:"toon",mode:"topic",depth:n,requested_topic:r,topic:s,docs:a,warnings:c}}function M_(e){return e.replaceAll("```","``\\`")}function D_(e){if(e.mode==="index"){let n=["# pm guide","","Token-efficient local documentation index for agent and maintainer workflows.","","## Topics"];for(let o of e.topics)n.push(`- \`${o.id}\` - ${o.summary}`),e.depth!=="brief"&&(n.push(`  - intent: ${o.intent}`),n.push(`  - docs: ${o.docs.map(r=>`\`${r.path}\``).join(", ")}`));n.push("","## Next steps");for(let o of e.suggested_next_steps)n.push(`- \`${o}\``);return n.join(`
+`)}let t=[`# pm guide ${e.topic.id}`,"",e.topic.summary,"","## Intent",e.topic.intent,"","## Key commands",...e.topic.commands.map(n=>`- \`${n}\``),"","## Workflow prompts"];for(let n of e.topic.workflows)t.push(`### ${n.name}`),t.push(`goal: ${n.goal}`),t.push(`prompt: ${n.prompt}`),t.push("commands:"),t.push(...n.commands.map(o=>`- \`${o}\``)),t.push("");t.push("## Documents");for(let n of e.docs){let o=n.exists?"available":n.optional?"missing (optional)":"missing (required)";t.push(`- \`${n.path}\` - ${n.purpose} (${o})`),n.exists&&n.content_mode!=="none"&&n.content&&(t.push(""),t.push(`### Excerpt: \`${n.path}\``),n.truncated&&t.push("_truncated for context efficiency_"),t.push("```markdown"),t.push(M_(n.content)),t.push("```"))}return e.topic.related.length>0&&(t.push("","## Related topics"),t.push(...e.topic.related.map(n=>`- \`${n}\``))),e.warnings.length>0&&(t.push("","## Warnings"),t.push(...e.warnings.map(n=>`- ${n}`))),t.join(`
+`)}(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]="48da3e98-ab96-54de-8993-7de0c4edf19b")}catch{}})();var Cl=["bash","zsh","fish"],N_=[...ft],j_=[...qn],U_=new Set(Os.filter(e=>e.hidden).map(e=>e.alias)),Gr=xc("full").filter(e=>!U_.has(e)),G_=C(Zt),q_=C(xi),z_=C(Fi),H_=C(Gi),B_=C(qi),V_=C(Li),W_=C(Mi),K_=C(Ui),Y_=C(Yi),J_=C(zi),X_=C(Hi),Z_=C(Pi),Q_=C(Vi),eh=C(Ri),th=C(Ai,!1),nh=C(Wi),oh=C(Bi),rh=C(Ki),sh=C(Qi),ih=C(Xi),ah=C(Ni),ch=C(Zi),dh=C(Ji),lh=C(Qt),mh=C(Di),ph=C(ji),uh=C(Ti),fh=C(ea),_h=C(Ci),hh="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize",gh=C(ta),yh=`${gh} bash zsh fish`,qr=lt(Fn()),Ln="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate",bh=C(Oi),wh=C($i),vh="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",kh="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",Sh="--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",Ih="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",Ml=[["init","Initialize pm storage for the current workspace"],["config","Read or update pm settings"],["extension","Manage extension lifecycle operations"],["package","Manage package lifecycle operations"],["packages","Alias for package"],["create","Create a new project management item"],["copy","Copy an existing item to a new ID"],["focus","Set/clear/show the session focused parent for new items"],["list","List active items with optional filters"],["aggregate","Aggregate grouped item counts and numeric stats for governance queries"],["duplicates","Find bounded duplicate clusters across lifecycle statuses"],["guide","Browse local progressive-disclosure guides"],["calendar","Show calendar views for deadlines and reminders"],["cal","Alias for calendar"],["context","Show a token-efficient project context snapshot"],["ctx","Alias for context"],["get","Show item details by ID"],["next","Recommend the next actionable (unblocked, ready) work item"],["search","Search items with keyword, semantic, or hybrid modes"],["reindex","Rebuild search artifacts"],["history","Show item history entries"],["history-compact","Compact history streams into a synthetic baseline + retained tail"],["history-redact","Redact sensitive literals/patterns and recompute history hashes"],["history-repair","Re-anchor a drifted history chain so pm health/validate report ok"],["schema","Manage custom item types and statuses in .agents/pm/schema/*.json"],["profile","List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"],["plan","Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["activity","Show recent activity across items"],["restore","Restore an item to an earlier state"],["update","Update item fields and metadata"],["update-many","Bulk-update matched items with dry-run and rollback checkpoints"],["close","Close an item (reason requirement follows governance settings)"],["close-many","Bulk-close matched items with an optional shared reason and rollback checkpoint"],["delete","Delete an item and record the change"],["append","Append text to an item body"],["comments","List or add comments for an item"],["notes","List or add notes for an item"],["learnings","List or add learnings for an item"],["files","Manage linked files"],["docs","Manage linked docs"],["deps","Show dependency relationships for an item"],["graph","Bounded graph traversal, analytics, and governance-audit queries"],["test","Manage linked tests and optionally run them"],["test-all","Run linked tests across matching items"],["test-runs","Manage background linked-test runs"],["stats","Show project tracker statistics"],["health","Show project tracker health checks"],["validate","Run standalone validation checks"],["gc","Clean optional cache artifacts"],["contracts","Show machine-readable command and schema contracts"],["claim","Claim an item for active work"],["release","Release the active claim for an item"],["start-task","Lifecycle alias to claim and set in_progress"],["pause-task","Lifecycle alias to reopen and release claim"],["close-task","Lifecycle alias to close and release claim"],["meet","Shortcut to create a Meeting with scheduling defaults"],["event","Shortcut to create an Event with scheduling defaults"],["remind","Shortcut to create a Reminder from a point in time"],["templates","Manage reusable create templates"],["completion","Generate shell completion"],["help","Display help for a command"]],Eh=new Map([["calendar","Show deadline/reminder calendar views"],["schema","Inspect and manage runtime schema"],["profile","List, show, apply, and lint project profiles (archetype bundles)"],["plan","Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["start-task","Lifecycle alias to claim and set in-progress"]]),xh=Ei.flatMap(e=>[e.short,e.flag,...e.aliases??[]]).filter(e=>!!e).join(" ");function lt(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n)).join(" ")}function Rh(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].join(" ")}function Dl(e){return e.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function zr(e,t){return Rh(e.length>0?e:t.item_types??N_)}function Hr(e){return lt(e.statuses??j_)}function He(e,t){let n=[...e.split(/\s+/u).filter(o=>o.length>0),...t??[]];return lt(n)}function Nl(e){let t=(e??[]).map(n=>n.trim()).filter(n=>n.startsWith("--")&&n.length>2).map(n=>`--${n.slice(2).replaceAll("_","-")}`);return[...new Set(t)].sort((n,o)=>n.localeCompare(o))}function Ot(e){let t=Nl(e);return t.length===0?"":`${t.map(n=>`            '${n}[Runtime schema field flag]:value' \\`).join(`
+`)}
+`}function Mn(e,t={}){let n=t.trailingContinuation??!0,o=e.length-1;return e.map((r,s)=>`            ${r}${n||s!==o?" \\":""}`).join(`
+`)}function Ah(){return Ml.map(([e,t])=>`    '${e}:${t}'`).join(`
+`)}function Ch(){return Ml.filter(([e])=>e!=="help").map(([e,t])=>{let n=Eh.get(e)??t;return`complete -c pm -n __pm_no_subcommand -a ${e.padEnd(16)} -d '${n}'`}).join(`
+`)}function Tl(e){let t=["reviewer-missing[Select only items missing reviewer]","risk-missing[Select only items missing risk]","confidence-missing[Select only items missing confidence]","sprint-missing[Select only items missing sprint]","release-missing[Select only items missing release]"],n=e.includeContentMissingAliases===!0?["files-missing[Alias for --no-files]","docs-missing[Alias for --no-docs]"]:[],o=[["has-notes[Select only items that have notes]","no-notes[Select only items with no notes]"],["has-learnings[Select only items that have learnings]","no-learnings[Select only items with no learnings]"],["has-files[Select only items that have linked files]","no-files[Select only items with no linked files]"],["has-docs[Select only items that have linked docs]","no-docs[Select only items with no linked docs]"],["has-tests[Select only items that have linked tests]","no-tests[Select only items with no linked tests]"],["has-comments[Select only items that have comments]","no-comments[Select only items with no comments]"],["has-deps[Select only items that have dependencies]","no-deps[Select only items with no dependencies]"],["has-body[Select only items with non-empty body]","empty-body[Select only items with empty body]"],["has-linked-command[Select only items that have a linked command]","no-linked-command[Select only items with no linked command]"]];return Mn([...[...t,...n].map(r=>`'--${e.missingPrefix}${r}'`),...o.flatMap(([r,s])=>[`'--${e.pairedPrefix}${r}'`,`'--${e.pairedPrefix}${s}'`])])}var Th=["'--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment'","'--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note'","'--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning'","'--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file'","'--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test'","'--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc'","'--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder'","'--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event'","'--type-option[Type option key=value or key=<name>,value=<value>]:type_option'","'--unset[Clear scalar metadata field by name]:field'","'--replace-files[Atomically replace linked files with provided --file values]'","'--replace-docs[Atomically replace linked docs with provided --doc values]'","'--clear-deps[Clear dependency entries]'","'--clear-comments[Clear comments]'","'--clear-notes[Clear notes]'","'--clear-learnings[Clear learnings]'","'--clear-files[Clear linked files]'","'--clear-tests[Clear linked tests]'","'--clear-docs[Clear linked docs]'","'--clear-reminders[Clear reminders]'","'--clear-events[Clear events]'","'--clear-type-options[Clear type options]'"];function Ol(e){return Mn([...e==="reminder"?["'--at[Reminder time (default +1d)]:at'","'--text[Reminder text (defaults to title)]:text'"]:["'--start[Start time (ISO, now, or relative)]:start'","'--duration[Duration from start (default 1h)]:duration'","'--end[End time (overrides --duration)]:end'","'--location[Location]:location'","'--timezone[IANA timezone]:timezone'","'--all-day[Mark as an all-day event]'"],"'--parent[Parent item id]:parent'","'--allow-missing-parent[Permit a parent id that does not exist yet]'","'--tags[Comma-separated tags]:tags'","'(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)'","'(-b --body)'{-b,--body}'[Item body]:body'","'(-d --description)'{-d,--description}'[Short description]:description'","'--author[Mutation author]:author'","'--message[History message]:message'","'--json[Output JSON]'","'--quiet[Suppress stdout]'"],{trailingContinuation:!1})}function $l(e,t,n,o){return Mn([`'--filter-status[Filter by status before ${e}]:(${t})'`,`'--filter-type[Filter by type before ${e}]:(${n})'`,`'--filter-tag[Filter by tag before ${e}]:(${o})'`,`'--filter-priority[Filter by priority before ${e}]:(0 1 2 3 4)'`,"'--filter-deadline-before[Filter by deadline upper bound]:deadline'","'--filter-deadline-after[Filter by deadline lower bound]:deadline'","'--filter-updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp'","'--filter-updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp'","'--filter-created-after[Filter by created_at lower bound (ISO/relative)]:timestamp'","'--filter-created-before[Filter by created_at upper bound (ISO/relative)]:timestamp'",`'--filter-assignee[Filter by assignee before ${e}]:assignee'`,"'--filter-assignee-filter[Filter assignee presence]:(assigned unassigned)'","'--filter-parent[Filter by parent item ID]:parent'","'--filter-sprint[Filter by sprint]:sprint'","'--filter-release[Filter by release]:release'"])}function Be(e,t){let n=Nl(t).map(r=>r.slice(2));if(e.length===0||n.length===0)return"";let o=[];for(let r of e)for(let s of n)o.push(`complete -c pm -n '__fish_seen_subcommand_from ${r}' -l ${s} -d 'Runtime schema field flag' -r`);return`${o.join(`
+`)}
+`}function Pl(e,t,n){let o=e.toUpperCase(),r=`PM_COMPLETION_${o}_CACHE`,s=`PM_COMPLETION_${o}_CACHE_TS`,i=`PM_COMPLETION_${o}_TTL`,a=Dl(n);return[`_pm_completion_${e}_choices() {`,"  local now ttl cache_ts resolved",'  now="$(date +%s 2>/dev/null || echo 0)"',`  ttl="\${${i}:-120}"`,`  cache_ts="\${${s}:-0}"`,`  if [[ -n "\${${r}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,`    printf '%s\\n' "$${r}"`,"    return 0","  fi",`  resolved="$(pm ${t} 2>/dev/null)"`,'  if [[ -z "$resolved" ]]; then',`    resolved="${a}"`,"  fi",`  ${r}="$resolved"`,`  ${s}="$now"`,`  printf '%s\\n' "$${r}"`,"}"]}function Fl(e,t,n){let o=e.toUpperCase(),r=`PM_COMPLETION_${o}_CACHE`,s=`PM_COMPLETION_${o}_CACHE_TS`,i=`PM_COMPLETION_${o}_TTL`,a=Dl(n);return`
+_pm_${e}_choices() {
+  local now ttl cache_ts resolved
+  now=\${EPOCHSECONDS:-0}
+  ttl=\${${i}:-120}
+  cache_ts=\${${s}:-0}
+  if [[ -n "\${${r}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
+    print -r -- "$${r}"
+    return
+  fi
+  resolved="$(pm ${t} 2>/dev/null)"
+  if [[ -z "$resolved" ]]; then
+    resolved="${a}"
+  fi
+  ${r}="$resolved"
+  ${s}="$now"
+  print -r -- "$${r}"
+}
+`}function Ll(e,t,n){let o=e.toUpperCase(),r=n.replaceAll("'","\\'");return`
+function __pm_${e}_choices
+  set -l now (date +%s ^/dev/null)
+  if test -z "$now"
+    set now 0
+  end
+  set -l ttl 120
+  if set -q PM_COMPLETION_${o}_TTL
+    set ttl $PM_COMPLETION_${o}_TTL
+  end
+  if set -q PM_COMPLETION_${o}_CACHE; and set -q PM_COMPLETION_${o}_CACHE_TS
+    set -l age (math "$now - $PM_COMPLETION_${o}_CACHE_TS")
+    if test $age -lt $ttl
+      printf '%s\\n' $PM_COMPLETION_${o}_CACHE
+      return
+    end
+  end
+  set -l resolved (pm ${t} ^/dev/null)
+  if test (count $resolved) -eq 0
+    set resolved '${r}'
+  end
+  set -gx PM_COMPLETION_${o}_CACHE $resolved
+  set -gx PM_COMPLETION_${o}_CACHE_TS $now
+  printf '%s\\n' $resolved
+end
+`}function Oh(e=[],t=[],n=!1,o={}){let r=Gr.join(" "),s=e.length===0,i=zr(e,o),a=Hr(o),c=lt(t),d=He(G_,o.command_flags?.list),l=He(K_,o.command_flags?.create),m=He(J_,o.command_flags?.update),f=He(X_,o.command_flags?.["update-many"]),_=He(lh,o.command_flags?.search),h=He(oh,o.command_flags?.calendar),w=He(rh,o.command_flags?.context),y=n||t.length>0,g=k=>`$(compgen -W "${k}" -- "$cur")`;return["# bash completion for pm",`# Source this file or add 'eval "$(pm completion bash)"' to ~/.bashrc`,"",...s?[...Pl("type","completion-types",i),""]:[],...Pl("status","completion-statuses",a),"","_pm_completion() {","  local cur prev words cword","  _init_completion 2>/dev/null || {",'    cur="${COMP_WORDS[COMP_CWORD]}"','    prev="${COMP_WORDS[COMP_CWORD-1]}"',"    cword=$COMP_CWORD","  }","","  if [[ $cword -eq 1 ]]; then",`    COMPREPLY=(${g(r)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',s?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${g(i)})`,"    return 0","  fi","",'  if [[ "$prev" == "--status" ]]; then','    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',"    return 0","  fi","",...y?['  if [[ "$prev" == "--tag" || "$prev" == "--tags" ]]; then',`    COMPREPLY=(${g(c)})`,"    return 0","  fi"]:['  if [[ "$prev" == "--tag" || "$prev" == "--tags" ]]; then',"    local now ttl cache_ts tag_values",'    now="$(date +%s 2>/dev/null || echo 0)"','    ttl="${PM_COMPLETION_TAG_TTL:-120}"','    cache_ts="${PM_COMPLETION_TAG_CACHE_TS:-0}"','    tag_values="${PM_COMPLETION_TAG_CACHE:-}"','    if [[ -z "$tag_values" || "$now" -eq 0 || $((now - cache_ts)) -ge "$ttl" ]]; then','      tag_values="$(pm completion-tags 2>/dev/null)"','      PM_COMPLETION_TAG_CACHE="$tag_values"','      PM_COMPLETION_TAG_CACHE_TS="$now"',"    fi",'    COMPREPLY=($(compgen -W "$tag_values" -- "$cur"))',"    return 0","  fi"],"",'  local cmd="${COMP_WORDS[1]}"',"",'  case "$cmd" in',"    list)",`      COMPREPLY=(${g(d)})`,"      ;;","    aggregate)",`      COMPREPLY=(${g(q_)})`,"      ;;","    duplicates)",`      COMPREPLY=(${g(ah)})`,"      ;;","    create)",`      COMPREPLY=(${g(l)})`,"      ;;","    copy)",`      COMPREPLY=(${g(H_)})`,"      ;;","    focus)",`      COMPREPLY=(${g(B_)})`,"      ;;","    update)",`      COMPREPLY=(${g(m)})`,"      ;;","    update-many)",`      COMPREPLY=(${g(f)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${g(h)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${g(w)})`,"      ;;","    next)",`      COMPREPLY=(${g(sh)})`,"      ;;","    guide)",`      COMPREPLY=(${g(`${dh} ${qr}`)})`,"      ;;","    search)",`      COMPREPLY=(${g(_)})`,"      ;;","    reindex)",`      COMPREPLY=(${g("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${g(`${uh} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    config)",`      COMPREPLY=(${g("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    extension)",`      COMPREPLY=(${g(`${Ln} ${bh}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${g(`${Ln} ${wh}`)})`,"      ;;","    comments)",`      COMPREPLY=(${g("--add --body --stdin --file --edit --delete --limit --full-history --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    notes)",`      COMPREPLY=(${g("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    learnings)",`      COMPREPLY=(${g("--add --stdin --file --edit --delete --limit --full-history --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    files)",`      COMPREPLY=(${g("discover lookup --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --scope --limit --offset --no-truncate --strict-read --explain --lines --decision-depth --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    docs)",`      COMPREPLY=(${g("--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    append)",`      COMPREPLY=(${g(z_)})`,"      ;;","    deps)",`      COMPREPLY=(${g(ih)})`,"      ;;","    graph)",`      COMPREPLY=(${g(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${ch}`)})`,"      ;;","    test)",`      COMPREPLY=(${g("--add --add-json --remove --remove-index --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    test-all)",`      COMPREPLY=(${g("--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    test-runs)",`      COMPREPLY=(${g("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    validate)",`      COMPREPLY=(${g("--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    health)",`      COMPREPLY=(${g(ph)})`,"      ;;","    history)",`      COMPREPLY=(${g(eh)})`,"      ;;","    events)",`      COMPREPLY=(${g(nh)})`,"      ;;","    history-compact)",`      COMPREPLY=(${g("--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${g(`${th} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${g(Y_)})`,"      ;;","    history-redact)",`      COMPREPLY=(${g("--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    history-repair)",`      COMPREPLY=(${g("--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    schema)",`      COMPREPLY=(${g("list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --to --migration-id --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    profile)",`      COMPREPLY=(${g("list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    plan)",`      COMPREPLY=(${g(`${hh} ${_h}`)})`,"      ;;","    activity)",`      COMPREPLY=(${g(Q_)})`,"      ;;","    contracts)",`      COMPREPLY=(${g(fh)})`,"      ;;","    gc)",`      COMPREPLY=(${g("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${g(mh)})`,"      ;;","    close|close-task)",`      COMPREPLY=(${g(Sh)})`,"      ;;","    close-many)",`      COMPREPLY=(${g(Z_)})`,"      ;;","    release)",`      COMPREPLY=(${g(Ih)})`,"      ;;","    delete)",`      COMPREPLY=(${g(kh)})`,"      ;;","    claim|restore|start-task|pause-task)",`      COMPREPLY=(${g(vh)})`,"      ;;","    meet|event)",`      COMPREPLY=(${g(V_)})`,"      ;;","    remind)",`      COMPREPLY=(${g(W_)})`,"      ;;","    completion)",`      COMPREPLY=(${g(yh)})`,"      ;;","    templates)",`      COMPREPLY=(${g("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${g(xh)})`,"      ;;","  esac","  return 0","}","","complete -F _pm_completion pm"].join(`
+`)}function $h(e=[],t=[],n=!1,o={}){let r=e.length===0,s=zr(e,o),i=Hr(o),a=r?'${(f)"$(_pm_type_choices)"}':s,c='${(f)"$(_pm_status_choices)"}',d=qr,l=lt(t),m=n||t.length>0,f=m?l:'${(f)"$(_pm_tag_choices)"}',_=Ot(o.command_flags?.list),h=Ot(o.command_flags?.create),w=Ot(o.command_flags?.search),y=Ot(o.command_flags?.calendar),g=Ot(o.command_flags?.context),k=Tl({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:!0}),E=Tl({missingPrefix:"filter-",pairedPrefix:"filter-"}),P=Mn(Th),T=m?"":`
+_pm_tag_choices() {
+  local now ttl cache_ts
+  now=\${EPOCHSECONDS:-0}
+  ttl=\${PM_COMPLETION_TAG_TTL:-120}
+  cache_ts=\${PM_COMPLETION_TAG_CACHE_TS:-0}
+  if [[ -n "\${PM_COMPLETION_TAG_CACHE:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
+    print -r -- "$PM_COMPLETION_TAG_CACHE"
+    return
+  fi
+  PM_COMPLETION_TAG_CACHE="$(pm completion-tags 2>/dev/null)"
+  PM_COMPLETION_TAG_CACHE_TS="$now"
+  print -r -- "$PM_COMPLETION_TAG_CACHE"
+}
+`;return`#compdef pm
+# zsh completion for pm
+# Source this file or add 'eval "$(pm completion zsh)"' to ~/.zshrc
+
+_pm_commands() {
+  local -a commands
+  commands=(
+${Ah()}
+  )
+  _describe 'command' commands
+}
+${T}
+${r?Fl("type","completion-types",s):""}
+${Fl("status","completion-statuses",i)}
+
+_pm() {
+  local context state line
+  _arguments -C \\
+    '--json[Output JSON instead of TOON]' \\
+    '--quiet[Suppress stdout output]' \\
+    '--output-include[Retain comma-separated read fields or sections]:selectors' \\
+    '--output-limit[Set the universal read row ceiling]:limit' \\
+    '--output-budget[Set the universal estimated-token ceiling]:tokens' \\
+    '--output-format[Select the universal read encoding]:(toon json)' \\
+    '--output-session[Carry cross-call read budget and served-item state]:state' \\
+    '--output-row-contract[Include row schema metadata in read output]' \\
+    '--no-changed-fields[Omit changed_fields array from mutation output]' \\
+    '--pm-path[Explicit tracker storage path for this command]:path:_files -/' \\
+    '--path[Compatibility alias for --pm-path]:path:_files -/' \\
+    '--no-extensions[Disable extension loading]' \\
+    '--no-pager[Disable pager integration for help and long output]' \\
+    '--profile[Print deterministic timing diagnostics]' \\
+    '(-V --version)--version[Output the version number]' \\
+    '(-h --help)--help[Display help]' \\
+    '1: :_pm_commands' \\
+    '*:: :->args' && return 0
+
+  case $state in
+    args)
+      case $line[1] in
+        list)
+          _arguments \\
+            '*--status[Filter by status; repeatable, comma-separated, or all]:(${c})' \\
+            '--all[Include every lifecycle status]' \\
+            '--type[Filter by item type]:(${a})' \\
+            '--tag[Filter by tag]:(${f})' \\
+            '--tags[Alias for --tag]:(${f})' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--deadline-before[Filter by deadline upper bound (ISO/date string or relative)]:date' \\
+            '--deadline-after[Filter by deadline lower bound (ISO/date string or relative)]:date' \\
+            '--today[Filter to items updated since local midnight today]' \\
+            '--recent[Filter to items updated in the last 7 days]' \\
+            '--updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp' \\
+            '--updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp' \\
+            '--created-after[Filter by created_at lower bound (ISO/relative)]:timestamp' \\
+            '--created-before[Filter by created_at upper bound (ISO/relative)]:timestamp' \\
+            '--assignee[Filter by assignee]:assignee' \\
+            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
+            '--sprint[Filter by sprint]:sprint' \\
+            '--release[Filter by release]:release' \\
+${k}
+            '--limit[Limit returned item count]:number' \\
+            '--offset[Skip the first n matching rows before limit]:number' \\
+            '--no-truncate[Return every matched row, overriding --limit]' \\
+            '--include-body[Include item body in each returned list row]' \\
+            '--compact[Render compact list projection fields]' \\
+            '--fields[Render custom comma-separated list fields]:fields' \\
+            '--tree[Render hierarchical subtree output rooted at --parent or top-level parents]' \\
+            '--tree-depth[Cap recursion depth for --tree (0 = root only)]:number' \\
+            '--sort[Sort field]:(priority deadline updated_at created_at title parent)' \\
+            '--order[Sort order (requires --sort)]:(asc desc)' \\
+            '--stream[Emit line-delimited JSON rows (requires --json)]' \\
+${_}            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]' \\
+            '--pm-path[Explicit tracker storage path]:path:_files -/' \\
+            '--path[Compatibility alias for --pm-path]:path:_files -/'
+          ;;
+        aggregate)
+          _arguments \\
+            '--group-by[Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)]:fields' \\
+            '--count[Return grouped counts]' \\
+            '--completion[Add open/in_progress/closed/other counts and completion percentage]' \\
+            '--sum[Numeric field to sum per group]:field' \\
+            '--avg[Numeric field to average per group]:field' \\
+            '--include-unparented[Include unparented rows when grouping by parent]' \\
+            '--status[Filter by status]:(${c})' \\
+            '--type[Filter by item type]:(${a})' \\
+            '--tag[Filter by tag]:(${f})' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--deadline-before[Filter by deadline upper bound (ISO/date string or relative)]:date' \\
+            '--deadline-after[Filter by deadline lower bound (ISO/date string or relative)]:date' \\
+            '--assignee[Filter by assignee]:assignee' \\
+            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
+            '--parent[Filter by parent item ID]:parent_id' \\
+            '--sprint[Filter by sprint]:sprint' \\
+            '--release[Filter by release]:release' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        duplicates)
+          _arguments \\
+            '*--status[Include lifecycle status (repeatable)]:(${c})' \\
+            '--since[Only inspect items created at or after this ISO timestamp]:timestamp' \\
+            '--threshold[Minimum similarity score from zero through one]:number' \\
+            '--limit[Maximum duplicate clusters]:number'
+          ;;
+        create)
+          _arguments \\
+            '(-t --title)'{-t,--title}'[Item title]:title' \\
+            '(-d --description)'{-d,--description}'[Item description]:description' \\
+            '--type[Item type]:(${a})' \\
+            '--create-mode[Create required-option policy mode]:(strict progressive)' \\
+            '--schedule-preset[Scheduling preset for Reminder/Meeting/Event]:(lightweight)' \\
+            '(-s --status)'{-s,--status}'[Item status]:(${c})' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '--add-tags[Add tags additively without replacing existing]:tags' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '--body-file[Load the item body from a file]:body_file:_files' \\
+            '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
+            '--estimate[Estimated minutes]:minutes' \\
+            '--acceptance-criteria[Acceptance criteria]:criteria' \\
+            '--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder' \\
+            '--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event' \\
+            '--type-option[Type option key=value or key=<name>,value=<value>]:type_option' \\
+            '--unset[Clear scalar metadata field by name]:field' \\
+            '--replace-deps[Atomically replace dependencies with provided --dep values]' \\
+            '--replace-tests[Atomically replace linked tests with provided --test values]' \\
+            '--clear-deps[Clear dependency entries]' \\
+            '--clear-comments[Clear comments]' \\
+            '--clear-notes[Clear notes]' \\
+            '--clear-learnings[Clear learnings]' \\
+            '--clear-files[Clear linked files]' \\
+            '--clear-tests[Clear linked tests]' \\
+            '--clear-docs[Clear linked docs]' \\
+            '--clear-reminders[Clear reminders]' \\
+            '--clear-events[Clear events]' \\
+            '--clear-type-options[Clear type options]' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--assignee[Assignee]:assignee' \\
+${h}            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        copy)
+          _arguments \\
+            '--title[Override copied title]:title' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force ownership override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        focus)
+          _arguments \\
+            '--clear[Clear the focused item]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        meet|event)
+          _arguments \\
+${Ol("event")}
+          ;;
+        remind)
+          _arguments \\
+${Ol("reminder")}
+          ;;
+        update)
+          _arguments \\
+            '(-t --title)'{-t,--title}'[Item title]:title' \\
+            '(-d --description)'{-d,--description}'[Item description]:description' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '--body-file[Load the item body from a file]:body_file:_files' \\
+            '(-s --status)'{-s,--status}'[Item status]:(${c})' \\
+            '--close-reason[Set close reason]:close_reason' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '--type[Item type]:(${a})' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '--add-tags[Add tags additively without replacing existing]:tags' \\
+            '--remove-tags[Remove tags from the existing list]:tags' \\
+            '--add-ac[Add one acceptance criterion without replacing existing]:criteria' \\
+            '--remove-ac[Remove one acceptance criterion by exact text]:criteria' \\
+            '--expected[Short alias for --expected-result]:expected_result' \\
+            '--actual[Short alias for --actual-result]:actual_result' \\
+${P}
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        update-many)
+          _arguments \\
+${$l("applying updates",c,a,f)}
+            '--filter-ac-missing[Select only items missing acceptance_criteria]' \\
+            '--filter-estimates-missing[Select only items missing estimated_minutes]' \\
+            '--filter-resolution-missing[Select only terminal items missing resolution]' \\
+            '--filter-metadata-missing[Select only items missing any tracked metadata]' \\
+${E}
+            '--ids[Explicit comma-separated ID allowlist]:ids' \\
+            '--limit[Limit matched item count]:number' \\
+            '--offset[Skip first n matched rows]:number' \\
+            '--dry-run[Preview updates without mutating]' \\
+            '--rollback[Rollback checkpoint ID]:checkpoint_id' \\
+            '--no-checkpoint[Disable checkpoint creation during apply mode]' \\
+            '(-t --title)'{-t,--title}'[Item title]:title' \\
+            '(-d --description)'{-d,--description}'[Item description]:description' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '--type[Item type]:(${a})' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '--add-tags[Add tags additively without replacing existing]:tags' \\
+            '--remove-tags[Remove tags from the existing list]:tags' \\
+            '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
+            '--estimate[Estimated minutes]:minutes' \\
+            '--acceptance-criteria[Acceptance criteria]:criteria' \\
+            '--add-ac[Add one acceptance criterion without replacing existing]:criteria' \\
+            '--remove-ac[Remove one acceptance criterion by exact text]:criteria' \\
+            '--definition-of-ready[Definition of ready]:definition_of_ready' \\
+            '--order[Planning order/rank]:order' \\
+            '--goal[Goal identifier]:goal' \\
+            '--objective[Objective identifier]:objective' \\
+            '--value[Business value summary]:value' \\
+            '--impact[Business impact summary]:impact' \\
+            '--outcome[Expected outcome summary]:outcome' \\
+            '--why-now[Why-now rationale]:why_now' \\
+            '--reviewer[Reviewer]:reviewer' \\
+            '--risk[Risk level]:risk' \\
+            '--confidence[Confidence level]:confidence' \\
+            '--sprint[Sprint identifier]:sprint' \\
+            '--release[Release identifier]:release' \\
+            '--reporter[Issue reporter]:reporter' \\
+            '--severity[Issue severity]:severity' \\
+            '--environment[Issue environment context]:environment' \\
+            '--repro-steps[Issue reproduction steps]:repro_steps' \\
+            '--resolution[Issue resolution summary]:resolution' \\
+            '--expected-result[Issue expected behavior]:expected_result' \\
+            '--actual-result[Issue observed behavior]:actual_result' \\
+            '--expected[Short alias for --expected-result]:expected_result' \\
+            '--actual[Short alias for --actual-result]:actual_result' \\
+            '--affected-version[Affected version identifier]:affected_version' \\
+            '--fixed-version[Fixed version identifier]:fixed_version' \\
+            '--component[Issue component ownership]:component' \\
+            '--regression[Regression marker true|false|1|0]:regression' \\
+            '--customer-impact[Customer impact summary]:customer_impact' \\
+            '--dep[Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>]:dep' \\
+            '--dep-remove[Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>]:dep_remove' \\
+            '--replace-deps[Atomically replace dependencies with provided --dep values]' \\
+            '--replace-tests[Atomically replace linked tests with provided --test values]' \\
+${P}
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        close-many)
+          _arguments \\
+${$l("closing",c,a,f)}
+${E}
+            '--ids[Explicit comma-separated ID allowlist]:ids' \\
+            '--limit[Limit matched item count]:number' \\
+            '--offset[Skip first n matched rows]:number' \\
+            '--reason[Optional shared close reason applied to every matched item]:reason' \\
+            '--resolution[Shared closure resolution]:resolution' \\
+            '--expected-result[Shared expected-result note]:expected_result' \\
+            '--actual-result[Shared actual-result note]:actual_result' \\
+            '--expected[Short alias for --expected-result]:expected_result' \\
+            '--actual[Short alias for --actual-result]:actual_result' \\
+            '--validate-close[Validate closure metadata per item]:(off warn strict)' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Re-close terminal matches and override ownership]' \\
+            '--dry-run[Preview matched items without mutating]' \\
+            '--rollback[Rollback checkpoint ID]:checkpoint_id' \\
+            '--no-checkpoint[Disable checkpoint creation during apply mode]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        calendar|cal)
+          _arguments \\
+            '--view[Calendar view]:(agenda day week month)' \\
+            '--date[Anchor date/time (ISO/date string or relative)]:date' \\
+            '--from[Agenda lower bound (ISO/date string or relative)]:date' \\
+            '--to[Agenda upper bound (ISO/date string or relative)]:date' \\
+            '--past[Include past entries]' \\
+            '--full-period[Include full anchored day/week/month period]' \\
+            '--type[Filter by type]:(${a})' \\
+            '--tag[Filter by tag]:(${f})' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--status[Filter by status]:(${c})' \\
+            '--assignee[Filter by assignee]:assignee' \\
+            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
+            '--sprint[Filter by sprint]:sprint' \\
+            '--release[Filter by release]:release' \\
+${y}            '--include[Include event sources]:(all deadlines reminders events scheduled)' \\
+            '--recurrence-lookahead-days[Bound open-ended recurrence lookahead]:days' \\
+            '--recurrence-lookback-days[Bound open-ended recurrence lookback]:days' \\
+            '--occurrence-limit[Cap occurrences per recurring event]:number' \\
+            '--limit[Limit returned events]:number' \\
+            '--format[Output override]:(markdown toon json)' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        context|ctx)
+          _arguments \\
+            '--date[Anchor date/time (ISO/date string or relative)]:date' \\
+            '--from[Agenda lower bound (ISO/date string or relative)]:date' \\
+            '--to[Agenda upper bound (ISO/date string or relative)]:date' \\
+            '--past[Include past entries in bounded windows]' \\
+            '--type[Filter by type]:(${a})' \\
+            '--tag[Filter by tag]:(${f})' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--assignee[Filter by assignee]:assignee' \\
+            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
+            '--sprint[Filter by sprint]:sprint' \\
+            '--release[Filter by release]:release' \\
+            '--parent[Scope snapshot to one item subtree]:id' \\
+            '--limit[Limit focus and agenda rows per section]:number' \\
+            '--depth[Context depth]:(brief standard deep full)' \\
+            '--format[Output override]:(markdown toon json)' \\
+${g}            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        next)
+          _arguments \\
+            '--type[Filter candidates by type]:(${a})' \\
+            '--tag[Filter candidates by tag]:(${f})' \\
+            '--priority[Filter candidates by priority]:(0 1 2 3 4)' \\
+            '--assignee[Filter candidates by assignee]:assignee' \\
+            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
+            '--sprint[Filter candidates by sprint]:sprint' \\
+            '--release[Filter candidates by release]:release' \\
+            '--parent[Scope to one item subtree]:id' \\
+            '--limit[Limit ready rows]:number' \\
+            '--blocked-limit[Limit blocked rows]:number' \\
+            '--ready-only[Omit the blocked companion list]' \\
+            '--format[Output override]:(markdown toon json)' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        guide)
+          _arguments \\
+            '1:topic:(${d})' \\
+            '--list[Show guide topic index]' \\
+            '--format[Output override]:(markdown toon json)' \\
+            '--depth[Guide detail depth]:(brief standard deep)' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        search)
+          _arguments \\
+            '--mode[Search mode]:(keyword semantic hybrid)' \\
+            '--match-mode[Token match mode]:(and or exact)' \\
+            '--min-score[Per-query minimum score threshold]:number' \\
+            '--count[Return only the match count]' \\
+            '--include-linked[Include linked content in scoring]' \\
+            '--highlight[Emit per-field matched-text snippets on each hit]' \\
+            '--limit[Max results]:number' \\
+            '--status[Filter by status (open/closed/canceled, csv)]:(${c})' \\
+            '--type[Filter by type]:(${a})' \\
+            '--tag[Filter by tag]:(${f})' \\
+            '--tags[Alias for --tag]:(${f})' \\
+            '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--updated-after[Filter by updated_at lower bound]:value' \\
+            '--updated-before[Filter by updated_at upper bound]:value' \\
+            '--created-after[Filter by created_at lower bound]:value' \\
+            '--created-before[Filter by created_at upper bound]:value' \\
+            '--assignee[Filter by assignee]:value' \\
+            '--sprint[Filter by sprint]:value' \\
+            '--release[Filter by release]:value' \\
+            '--parent[Filter by parent item ID]:value' \\
+${k}
+${w}            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        reindex)
+          _arguments \\
+            '--mode[Reindex mode]:(keyword semantic hybrid)' \\
+            '--progress[Emit progress updates to stderr]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history)
+          _arguments \\
+            '--limit[Max entries]:number' \\
+            '--compact[Condensed history projection]' \\
+            '--full[Show full history entries]' \\
+            '--provenance[Patch-free identity and agent provenance projection]' \\
+            '--provenance-summary[Include bounded provenance completeness counts]' \\
+            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
+            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
+            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
+            '--diff[Include per-entry field-level before/after value diffs]' \\
+            '--field[With --diff, show only entries that changed this field]:field' \\
+            '--verify[Verify history hash chain and replay integrity]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        events)
+          _arguments \\
+            '--since[Resume after a cursor or from an ISO timestamp]:cursor_or_timestamp' \\
+            '*--type[Filter by mutation operation]:operation' \\
+            '*--author[Filter by mutation author]:author' \\
+            '*--item[Filter by item or workspace stream]:item' \\
+            '--limit[Maximum events, up to 1000]:number' \\
+            '--full[Include complete authoritative history entries]' \\
+            '--provenance[Include patch-free identity and agent provenance]' \\
+            '--provenance-summary[Include bounded provenance completeness counts]' \\
+            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
+            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
+            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
+            '--follow[Continue emitting committed events]' \\
+            '--interval-ms[Empty-read delay while following]:milliseconds' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history-compact)
+          _arguments \\
+            '--before[Compact entries strictly before this version number or ISO timestamp]:before' \\
+            '--ids[Bulk: compact an explicit comma-separated list of item ids]:ids' \\
+            '--all-over[Bulk: compact every stream with more than N entries]:all-over' \\
+            '--closed[Bulk: compact only closed (terminal) items streams]' \\
+            '--all-streams[Bulk: compact every history stream regardless of lifecycle state]' \\
+            '--min-entries[Bulk: skip streams with at most N entries]:min-entries' \\
+            '--dry-run[Preview compaction impact without writing the history file]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Audit history message]:message' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history-author-acknowledge)
+          _arguments \\
+            '*--event[Actionable unknown-author event]:item_and_line' \\
+            '--all-actionable[Select every currently actionable event]' \\
+            '--dry-run[Preview a deterministic source-bound plan]' \\
+            '--plan-fingerprint[Apply the exact dry-run plan]:sha256' \\
+            '--limit[Maximum coordinate rows returned in the plan]:number' \\
+            '--attributed-author[Principal attributed by maintainer review]:author' \\
+            '--reviewer[Reviewer recording the disposition]:reviewer' \\
+            '--reason[Evidence-backed review rationale]:reason' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        get)
+          _arguments \\
+            '--depth[Detail depth]:(brief standard deep full)' \\
+            '--full[Explicit full item read]' \\
+            '--fields[Render custom comma-separated item fields]:fields' \\
+            '--tree[Include descendant subtree in result payload]' \\
+            '--tree-depth[Cap subtree depth for --tree (0 = root only)]:number' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history-redact)
+          _arguments \\
+            '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
+            '--regex[Regex matcher to redact (/pattern/flags or raw pattern)]:regex' \\
+            '--replacement[Replacement text (defaults to [redacted])]:replacement' \\
+            '--dry-run[Preview redaction impact without writing files]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Audit history message]:message' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        history-repair)
+          _arguments \\
+            '--all[Repair every drifted stream in one audited pass]' \\
+            '--dry-run[Preview the re-anchor impact without writing the history file]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Audit history message]:message' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        schema)
+          _arguments \\
+            '1:subcommand:(list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status)' \\
+            '--description[Human description for the custom item type, status, or field]:text' \\
+            '--default-status[Default status hint for the custom item type]:status' \\
+            '--folder[Storage folder for items of this custom type]:dir' \\
+            '--alias[Alias for the custom type, status, or field flag (repeatable)]:name' \\
+            '--role[Lifecycle role for a custom status (repeatable)]:role' \\
+            '--order[Display/sort order for a custom status]:n' \\
+            '--type[Value type for a custom field]:type:(string number boolean string_array array object)' \\
+            '--commands[Commands a custom field is wired onto (repeatable)]:commands' \\
+            '--cli-flag[Override the auto-derived CLI flag for a custom field]:flag' \\
+            '--required[Mark a custom field as always required]' \\
+            '--required-on-create[Mark a custom field as required at create time]' \\
+            '--no-allow-unset[Disallow clearing a custom field via --unset]' \\
+            '--required-types[Restrict a custom field requirement to specific item types (repeatable)]:types' \\
+            '--infer[Infer item types from title-prefix conventions (add-type)]' \\
+            '--min-count[Minimum items sharing a prefix for --infer]:n' \\
+            '--apply[Register inferred types (with --infer)]' \\
+            '--author[Mutation author]:author' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        profile)
+          _arguments \\
+            '1:subcommand:(list show apply lint)' \\
+            '2:name:(agile ops research)' \\
+            '--dry-run[Preview the apply diff without writing any files]' \\
+            '--author[Mutation author]:author' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        plan)
+          _arguments \\
+            '1:subcommand:(create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize)' \\
+            '--title[Plan title]:title' \\
+            '--scope[Plan scope statement]:scope' \\
+            '--harness[Plan harness provenance]:harness:(codex claude-code cursor generic)' \\
+            '--mode[Plan mode]:mode:(draft research review approved executing paused completed superseded)' \\
+            '--resume-context[Resume context summary]:text' \\
+            '--step-title[Step title]:title' \\
+            '*--step[Step title (repeatable on create)]:title' \\
+            '--step-status[Step status]:status:(pending in_progress completed blocked skipped superseded)' \\
+            '--step-evidence[Step evidence]:text' \\
+            '--depends-on[Pm item id step depends on]:id' \\
+            '--link[Pm item id to link]:id' \\
+            '--link-kind[Link kind]:kind:(related blocks blocked_by depends_on discovered_from implements verifies supersedes)' \\
+            '--depth[Show depth]:depth:(brief standard deep)' \\
+            '--steps[Step ids/orders for materialize]:steps' \\
+            '--materialize-type[Item type for materialized steps]:type' \\
+            '--allow-multiple-active[Allow multiple in_progress steps]' \\
+            '--promote-to-item-dep[Also add link as top-level item dependency]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Mutation message]:message' \\
+            '--force[Force ownership override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        activity)
+          _arguments \\
+            '--id[Filter by item ID]:id' \\
+            '--op[Filter by history operation]:op' \\
+            '--author[Filter by history author]:author' \\
+            '--from[Lower timestamp bound (ISO/date string or relative)]:date' \\
+            '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
+            '--limit[Max entries]:number' \\
+            '--compact[Condensed activity projection]' \\
+            '--raw[Emit raw compact per-event activity output]' \\
+            '--full[Show full activity entries]' \\
+            '--provenance[Patch-free identity and agent provenance projection]' \\
+            '--provenance-summary[Include bounded provenance completeness counts]' \\
+            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
+            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
+            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
+            '--stream[Emit line-delimited JSON rows (requires --json)]:mode' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        contracts)
+          _arguments \\
+            '--action[Filter schema by tool action]:action' \\
+            '--command[Scope output to one command (narrow-by-default)]:command' \\
+            '--summary[Return compact command intent summary]' \\
+            '--schema-only[Return schema-only payload]' \\
+            '--flags-only[Return command flag contracts only]' \\
+            '--availability-only[Return action availability only]' \\
+            '--runtime-only[Include only actions invocable in the current runtime]' \\
+            '--active-only[Alias for --runtime-only]' \\
+            '--full[Include complete command and schema contract details]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        gc)
+          _arguments \\
+            '--dry-run[Preview cleanup targets without deleting files]' \\
+            '--scope[Limit cleanup to one or more scopes: index, embeddings, runtime, locks, checkpoints, transactions]:scope' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        stats)
+          _arguments \\
+            '--include-empty[Include registered zero-count type and status buckets]' \\
+            '--storage[Include aggregate history-stream storage metrics]' \\
+            '--metadata-coverage[Include metadata coverage percentages overall and by type]' \\
+            '--field-utilization[Include content-field utilization rates across all items]' \\
+            '--by-assignee[Lifecycle-bucketed breakdown grouped by assignee]' \\
+            '--by-tag[Lifecycle-bucketed breakdown grouped by tag]' \\
+            '--by-priority[Lifecycle-bucketed breakdown grouped by priority]' \\
+            '--tag-prefix[With --by-tag: only count tags with this prefix]:prefix' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        comments)
+          _arguments \\
+            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
+            '--stdin[Read comment text from stdin (supports multiline markdown)]' \\
+            '--file[Read comment text from file (supports multiline markdown)]:path' \\
+            '--edit[Replace the comment at 1-based index (text from positional/--add/--stdin/--file)]:index' \\
+            '--delete[Delete the comment at 1-based index]:index' \\
+            '--limit[Return only latest n entries]:number' \\
+            '--full-history[Return complete post-mutation history]' \\
+            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        notes)
+          _arguments \\
+            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
+            '--add-json[Append one validated JSON context event]:json' \\
+            '--stdin[Read entry text from stdin]' \\
+            '--file[Read entry text from file]:path' \\
+            '--edit[Replace the entry at a 1-based index]:index' \\
+            '--delete[Delete the entry at a 1-based index]:index' \\
+            '--limit[Return only latest n entries]:number' \\
+            '--since[Return structured events at or after an ISO timestamp]:timestamp' \\
+            '--event-type[Return structured events with this top-level type]:event_type' \\
+            '--include-meta[Include result counts and truncation metadata]' \\
+            '--full-history[Return complete post-mutation history]' \\
+            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        learnings)
+          _arguments \\
+            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
+            '--stdin[Read entry text from stdin]' \\
+            '--file[Read entry text from file]:path' \\
+            '--edit[Replace the entry at a 1-based index]:index' \\
+            '--delete[Delete the entry at a 1-based index]:index' \\
+            '--limit[Return only latest n entries]:number' \\
+            '--full-history[Return complete post-mutation history]' \\
+            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        files)
+          _arguments \\
+            '1:subcommand:(discover lookup)' \\
+            '--add[Add a linked file]:file' \\
+            '--add-glob[Add linked files matching a glob]:glob' \\
+            '--remove[Remove a linked file]:file' \\
+            '--migrate[Migrate linked-file metadata]' \\
+            '--list[List linked files]' \\
+            '--apply[Apply discovered linked files]' \\
+            '--note[Linked-file note]:note' \\
+            '--append-stable[Preserve stable append ordering]' \\
+            '--validate-paths[Validate linked-file paths]' \\
+            '--scope[Filter lookup by evidence scope]:(project global)' \\
+            '--limit[Maximum lookup matches]:number' \\
+            '--offset[Skip the first lookup matches]:number' \\
+            '--no-truncate[Return every lookup match]' \\
+            '--strict-read[Require authoritative source reads]' \\
+            '--explain[Include ranked source-to-work rationale]' \\
+            '--lines[Attribute an inclusive source line range]:start_end' \\
+            '--decision-depth[Maximum governing-decision relationship depth]:number' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        deps)
+          _arguments \\
+            '--format[Output format]:(tree graph context)' \\
+            '--max-depth[Maximum traversal depth (0 keeps root only)]:depth' \\
+            '--collapse[Collapse mode]:(none repeated)' \\
+            '--summary[Return counts only without tree/graph payload]' \\
+            '--node-limit[Maximum nodes in context output]:number' \\
+            '--edge-limit[Maximum edges in context output]:number' \\
+            '--token-budget[Maximum estimated tokens in context output]:number' \\
+            '--cursor[Continue an equivalent context query]:cursor' \\
+            '--direction[Context traversal direction]:(outgoing incoming both)' \\
+            '--kind[Restrict context traversal to relationship kinds]:kind' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        graph)
+          _arguments \\
+            '1:subcommand:(ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index)' \\
+            '--kind[Restrict traversal to registered relationship kinds]:kind' \\
+            '--max-depth[Maximum traversal depth]:depth' \\
+            '--limit[Maximum returned rows per bounded collection]:number' \\
+            '--after[Resume a traversal after this node id]:id' \\
+            '--direction[Edge orientation for paths/impact]:(outgoing incoming both)' \\
+            '--max-paths[Maximum enumerated paths]:number' \\
+            '--sample[Maximum evidence sample entries per audit finding]:number' \\
+            '--exempt-isolate[Item ids treated as explicitly valid isolates]:id' \\
+            '--exempt-isolate-type[Item types whose active isolates are policy-valid]:type' \\
+            '--save-baseline[Persist the audit census as the comparison baseline]' \\
+            '--rebuild[Rebuild and warm the durable graph index]' \\
+            '--clear[Delete the durable graph index]' \\
+            '--summary[Return counts-first envelopes without row collections]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        test)
+          _arguments \\
+            '--add[Add linked test entry]:entry' \\
+            '--add-json[Add linked test entry from JSON object/array]:json' \\
+            '--remove[Remove linked test entry by command/path]:entry' \\
+            '--remove-index[Remove linked test entry by 1-based index]:index' \\
+            '--list[List linked tests without mutating]' \\
+            '--run[Run linked tests]' \\
+            '--match[Run linked tests whose command/path contains substring]:substring' \\
+            '--only-index[Run one linked test by 1-based index]:number' \\
+            '--only-last[Run the most recently added linked test]' \\
+            '--background[Run linked tests in managed background mode]' \\
+            '--timeout[Default timeout seconds]:seconds' \\
+            '--progress[Emit linked-test progress to stderr]' \\
+            '--env-set[Set linked-test runtime environment values]:entry' \\
+            '--env-clear[Clear linked-test runtime environment values]:name' \\
+            '--shared-host-safe[Apply shared-host-safe runtime defaults]' \\
+            '--pm-context[PM linked-test context mode]:(schema tracker auto)' \\
+            '--override-linked-pm-context[Force run-level --pm-context over per-linked-test pm_context_mode metadata]' \\
+            '--fail-on-context-mismatch[Fail when context item counts mismatch]' \\
+            '--fail-on-skipped[Treat skipped linked tests as dependency failures]' \\
+            '--fail-on-empty-test-run[Treat empty linked-test selections as failures]' \\
+            '--require-assertions-for-pm[Require assertions for linked PM command tests]' \\
+            '--check-context[Preflight linked PM command context diagnostics before execution]' \\
+            '--auto-pm-context[Auto-remediate tracker-read context mismatches using tracker context]' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        test-all)
+          _arguments \\
+            '--status[Filter by status]:(open in_progress)' \\
+            '--limit[Limit matching items before running linked tests]:number' \\
+            '--offset[Skip matching items before running linked tests]:number' \\
+            '--background[Run linked tests in managed background mode]' \\
+            '--timeout[Default timeout seconds]:seconds' \\
+            '--progress[Emit linked-test progress to stderr]' \\
+            '--env-set[Set linked-test runtime environment values]:entry' \\
+            '--env-clear[Clear linked-test runtime environment values]:name' \\
+            '--shared-host-safe[Apply shared-host-safe runtime defaults]' \\
+            '--pm-context[PM linked-test context mode]:(schema tracker auto)' \\
+            '--override-linked-pm-context[Force run-level --pm-context over per-linked-test pm_context_mode metadata]' \\
+            '--fail-on-context-mismatch[Fail when context item counts mismatch]' \\
+            '--fail-on-skipped[Treat skipped linked tests as dependency failures]' \\
+            '--fail-on-empty-test-run[Treat empty linked-test selections as failures]' \\
+            '--require-assertions-for-pm[Require assertions for linked PM command tests]' \\
+            '--check-context[Preflight linked PM command context diagnostics before execution]' \\
+            '--auto-pm-context[Auto-remediate tracker-read context mismatches using tracker context]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        test-runs)
+          _arguments \\
+            '1:subcommand:(list status logs stop resume)' \\
+            '--status[Filter by background run status]:status:(queued running passed failed stopped canceled)' \\
+            '--limit[Limit returned runs]:number' \\
+            '--stream[Background log stream]:stream:(stdout stderr both)' \\
+            '--tail[Tail number of lines]:number' \\
+            '--force[Force stop with SIGKILL]' \\
+            '--author[Resume author]:author' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        init)
+          _arguments \\
+            '(1)--id-prefix[Set the item ID prefix]:prefix' \\
+            '(1)--prefix[Alias for --id-prefix]:prefix' \\
+            '1:optional id prefix or tracker path' \\
+            '--preset[Governance preset for new setups]:preset:(minimal default strict)' \\
+            '--defaults[Use non-interactive setup defaults]' \\
+            '-y[Alias for --defaults]' \\
+            '--yes[Alias for --defaults]' \\
+            '--author[Set the default mutation author for this project]:author' \\
+            '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
+            '--type-preset[Register domain item types]:type-preset:(agile ops research)' \\
+            '--with-packages[Install bundled first-party packages during initialization]' \\
+            '--verbose[Include the full resolved settings tree in init output]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        config)
+          _arguments \\
+            '--criterion[Criteria value for definition-of-done metadata-required-fields or lifecycle pattern keys (repeatable for set)]:criterion' \\
+            '--clear-criteria[Clear config criteria-list key values]' \\
+            '--format[Item format for item-format key]:format:(toon)' \\
+            '--policy[Policy value for supported policy keys]:policy' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        close)
+          _arguments \\
+            '--reason[Closure reason]:reason' \\
+            '--close-reason[Alias for --reason]:close_reason' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--validate-close[Validate closure metadata mode]:(off warn strict)' \\
+            '--resolution[Closure resolution summary]:resolution' \\
+            '--expected-result[Expected behavior note]:expected_result' \\
+            '--actual-result[Observed behavior note]:actual_result' \\
+            '--expected[Short alias for --expected-result]:expected_result' \\
+            '--actual[Short alias for --actual-result]:actual_result' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        claim)
+          _arguments \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--if-available[Skip work held by another author]' \\
+            '--next[Atomically claim the next actionable item]' \\
+            '--type[Filter --next candidates by type]:(${a})' \\
+            '--tag[Filter --next candidates by tag]:(${f})' \\
+            '--priority[Filter --next candidates by priority]:(0 1 2 3 4)' \\
+            '--assignee-filter[Filter --next candidates by ownership]:assignee_filter:(assigned unassigned)' \\
+            '--parent[Scope --next candidates to a subtree]:parent' \\
+            '--sprint[Filter --next candidates by sprint]:sprint' \\
+            '--release[Filter --next candidates by release]:release' \\
+            '--max-attempts[Bound the --next candidate walk]:max_attempts' \\
+            '--include-decisions[Allow human-gated Decision candidates]' \\
+            '--token-budget[Bound ranked candidate tokens]:token_budget' \\
+            '--explain-ranking[Include ranking provenance]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        release)
+          _arguments \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        delete)
+          _arguments \\
+            '--dry-run[Preview the item file that would be deleted without mutating]' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        start-task|pause-task)
+          _arguments \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        close-task)
+          _arguments \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--validate-close[Validate closure metadata mode]:(off warn strict)' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        validate)
+          _arguments \\
+            '--check-metadata[Run metadata completeness checks]' \\
+            '--metadata-profile[Select metadata validation profile for --check-metadata]:(core strict custom)' \\
+            '--check-resolution[Run closed-item resolution metadata checks]' \\
+            '--check-lifecycle[Run active-item lifecycle governance drift checks]' \\
+            '--check-stale-blockers[Include stale blocker-pattern diagnostics in lifecycle checks]' \\
+            '--dependency-cycle-severity[Set dependency-cycle warning policy for lifecycle checks]:(off warn error)' \\
+            '--parent-cycle-severity[Set parent-hierarchy cycle warning policy for lifecycle checks]:(off warn error)' \\
+            '--check-files[Run linked-file and orphaned-file checks]' \\
+            '--scan-mode[Select file candidate scan mode for --check-files]:(default tracked-all tracked-all-strict)' \\
+            '--include-pm-internals[Include PM storage internals in tracked-all candidate scans]' \\
+            '--verbose-file-lists[Include full file-path lists for validate --check-files details]' \\
+            '--verbose-diagnostics[Include full validate diagnostic ID lists instead of compact summaries]' \\
+            '--all-affected-ids[Emit complete missing_* affected-ID lists with no truncation (implied by --json)]' \\
+            '--strict-exit[Return non-zero exit when validation warnings are present]' \\
+            '--fail-on-warn[Alias for --strict-exit]' \\
+            '--fix-hints[Add a machine-executable fix_hints[] of pm commands to each failing check]' \\
+            '--auto-fix[Apply the safe, deterministic subset of fix-hint remediations automatically]' \\
+            '--dry-run[Preview planned --auto-fix/--prune-missing fixes without applying them]' \\
+            '--fix-scope[Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)]:(metadata resolution estimates lifecycle)' \\
+            '--prune-missing[Remove stale linked-file/doc links classified as deleted]' \\
+            '--check-history-drift[Run item/history hash drift checks]' \\
+            '--check-command-references[Run linked-command PM-ID reference checks]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        health)
+          _arguments \\
+            '--strict-directories[Treat optional item-type directories as required failures]' \\
+            '--check-only[Run read-only health diagnostics without refreshing vectors]' \\
+            '--no-refresh[Disable automatic vector refresh attempts during health checks]' \\
+            '--refresh-vectors[Explicitly enable vector refresh attempts during health checks]' \\
+            '--verbose-stale-items[Include full stale vectorization ID lists in health output]' \\
+            '--verbose-author-events[Include complete actionable unknown-author coordinates]' \\
+            '--brief[Emit compact health details for low-token agent checks]' \\
+            '--summary[Emit one-line-style health status with check names and warning count]' \\
+            '--strict-exit[Return non-zero exit when health warnings are present]' \\
+            '--fail-on-warn[Alias for --strict-exit]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        extension)
+          _arguments \\
+            '1:extension_action:(init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate)' \\
+            '--init[Generate a starter extension scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${St.join(" ")})' \\
+            '--install[Install extension from local path or GitHub source]' \\
+            '--uninstall[Uninstall extension by name]' \\
+            '--explore[List discovered extensions for selected scope]' \\
+            '--manage[List managed extensions with update metadata]' \\
+            '--describe[Map every surface a loaded extension registers]' \\
+            '--markdown[Render describe output as a Markdown reference document]' \\
+            '--output[Write describe Markdown to a file]:path:_files' \\
+            '--reload[Reload extensions with cache-busted module imports]' \\
+            '--watch[Enable watch mode with --reload]' \\
+            '--doctor[Run consolidated extension diagnostics (summary/deep)]' \\
+            '--catalog[List bundled first-party package catalog entries]' \\
+            '--adopt[Adopt an unmanaged extension into managed metadata]' \\
+            '--adopt-all[Adopt all unmanaged extensions into managed metadata]' \\
+            '--activate[Activate extension in selected scope settings]' \\
+            '--deactivate[Deactivate extension in selected scope settings]' \\
+            '--project[Use project extension scope (default)]' \\
+            '--local[Alias for --project]' \\
+            '--global[Use global extension scope]' \\
+            '--gh[Install from GitHub shorthand owner/repo/path]:github_spec' \\
+            '--github[Alias for --gh]:github_spec' \\
+            '--ref[Git ref/branch/tag for GitHub source]:git_ref' \\
+            '--detail[Detail mode for extension diagnostics]:detail_mode:(summary deep)' \\
+            '--trace[Include registration traces in doctor deep diagnostics]' \\
+            '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
+            '--fix-managed-state[Adopt unmanaged extensions before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope extensions only]' \\
+            '--ignore-global[Alias for --isolated]' \\
+            '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
+            '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]' \\
+            '*:target_or_name:_files -/'
+          ;;
+        package|packages)
+          _arguments \\
+            '1:package_action:(init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate)' \\
+            '--init[Generate a starter package scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${St.join(" ")})' \\
+            '--declarative[Generate a composeExtension blueprint starter]' \\
+            '--install[Install package from local path, GitHub source, npm source, or bundled alias]' \\
+            '--uninstall[Uninstall package by name]' \\
+            '--explore[List discovered packages for selected scope]' \\
+            '--manage[List managed packages with update metadata]' \\
+            '--describe[Map every surface a loaded package registers]' \\
+            '--markdown[Render describe output as a Markdown reference document]' \\
+            '--output[Write describe Markdown to a file]:path:_files' \\
+            '--reload[Reload packages with cache-busted module imports]' \\
+            '--watch[Enable watch mode with --reload]' \\
+            '--doctor[Run consolidated package diagnostics (summary/deep)]' \\
+            '--catalog[List bundled first-party package catalog entries]' \\
+            '--adopt[Adopt an unmanaged package into managed metadata]' \\
+            '--adopt-all[Adopt all unmanaged packages into managed metadata]' \\
+            '--activate[Activate package in selected scope settings]' \\
+            '--deactivate[Deactivate package in selected scope settings]' \\
+            '--project[Use project package scope (default)]' \\
+            '--local[Alias for --project]' \\
+            '--global[Use global package scope]' \\
+            '--gh[Install from GitHub shorthand owner/repo/path]:github_spec' \\
+            '--github[Alias for --gh]:github_spec' \\
+            '--ref[Git ref/branch/tag for GitHub source]:git_ref' \\
+            '--detail[Detail mode for package diagnostics]:detail_mode:(summary deep)' \\
+            '--trace[Include registration traces in doctor deep diagnostics]' \\
+            '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
+            '--fix-managed-state[Adopt unmanaged packages before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope packages only]' \\
+            '--ignore-global[Alias for --isolated]' \\
+            '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
+            '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]' \\
+            '*:target_or_name:_files -/'
+          ;;
+        completion)
+          _arguments \\
+            '--eager-tags[Embed current tracker tags directly in script output]' \\
+            '1:shell:(bash zsh fish)'
+          ;;
+        templates)
+          local -a templates_cmds
+          templates_cmds=('save:Save or update a create template' 'list:List saved create templates' 'show:Show saved template details')
+          _describe 'templates command' templates_cmds
+          ;;
+      esac
+      ;;
+  esac
+}
+
+compdef _pm pm`}function Ph(e=[],t=[],n=!1,o={}){let r=Gr.filter(te=>te==="list"||te.startsWith("list-")),s=r.join(" "),i=Gr.join(" "),a=e.length===0,c=zr(e,o),d=Hr(o),l=a?"(__pm_type_choices)":c,m="(__pm_status_choices)",f=qr,_=lt(t),h=n||t.length>0,w=h?`'${_}'`:"'(__pm_tag_choices)'",y=Be(r,o.command_flags?.list),g=Be(["create"],o.command_flags?.create),k=Be(["update"],o.command_flags?.update),E=Be(["update-many"],o.command_flags?.["update-many"]),P=Be(["search"],o.command_flags?.search),T=Be(["calendar","cal"],o.command_flags?.calendar),H=Be(["context","ctx"],o.command_flags?.context);return`# Fish shell completion for pm
+# Save to ~/.config/fish/completions/pm.fish
+# or run: pm completion fish > ~/.config/fish/completions/pm.fish
+
+# Disable file completion by default
+complete -c pm -f
+
+# Global flags (available for all subcommands)
+complete -c pm -l json -d 'Output JSON instead of TOON'
+complete -c pm -l quiet -d 'Suppress stdout output'
+complete -c pm -l output-include -d 'Retain comma-separated read fields or sections' -r
+complete -c pm -l output-limit -d 'Set the universal read row ceiling' -r
+complete -c pm -l output-budget -d 'Set the universal estimated-token ceiling' -r
+complete -c pm -l output-format -d 'Select the universal read encoding' -r -a 'toon json'
+complete -c pm -l output-session -d 'Carry cross-call read budget and served-item state' -r
+complete -c pm -l output-row-contract -d 'Include row schema metadata in read output'
+complete -c pm -l no-changed-fields -d 'Omit changed_fields array from mutation output'
+complete -c pm -l id-only -d 'Print only id and status for single-item mutation output'
+complete -c pm -l pm-path -d 'Explicit tracker storage path for this command' -r
+complete -c pm -l path -d 'Override PM path for this command' -r
+complete -c pm -l no-extensions -d 'Disable extension loading'
+complete -c pm -l profile -d 'Print deterministic timing diagnostics'
+complete -c pm -s V -l version -d 'Output the version number'
+complete -c pm -s h -l help -d 'Display help'
+
+# Helper: true when no subcommand has been given yet
+function __pm_no_subcommand
+  not __fish_seen_subcommand_from ${i}
+end
+${h?"":`
+function __pm_tag_choices
+  set -l now (date +%s ^/dev/null)
+  if test -z "$now"
+    set now 0
+  end
+  set -l ttl 120
+  if set -q PM_COMPLETION_TAG_TTL
+    set ttl $PM_COMPLETION_TAG_TTL
+  end
+  if set -q PM_COMPLETION_TAG_CACHE; and set -q PM_COMPLETION_TAG_CACHE_TS
+    set -l age (math "$now - $PM_COMPLETION_TAG_CACHE_TS")
+    if test $age -lt $ttl
+      printf '%s
+' $PM_COMPLETION_TAG_CACHE
+      return
+    end
+  end
+  set -l resolved (pm completion-tags ^/dev/null)
+  set -gx PM_COMPLETION_TAG_CACHE $resolved
+  set -gx PM_COMPLETION_TAG_CACHE_TS $now
+  printf '%s
+' $resolved
+end
+`}
+${a?Ll("type","completion-types",c):""}
+${Ll("status","completion-statuses",d)}
+
+# Subcommands
+${Ch()}
+
+# list* flags
+for list_cmd in ${s}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l status   -d 'Filter by status' -r -a '${m}'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l all      -d 'Include every lifecycle status'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l type     -d 'Filter by item type' -r -a '${l}'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tag      -d 'Filter by tag' -r -a ${w}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tags     -d 'Alias for --tag' -r -a ${w}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l assignee -d 'Filter by assignee' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l sprint   -d 'Filter by sprint' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l release  -d 'Filter by release' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l limit    -d 'Limit returned item count' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l offset   -d 'Skip the first n matching rows before limit' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-truncate -d 'Return every matched row, overriding --limit'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l include-body -d 'Include item body in each returned list row'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l compact -d 'Render compact list projection fields'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l fields -d 'Render custom comma-separated list fields' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tree -d 'Render hierarchical subtree output rooted at --parent or top-level parents'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tree-depth -d 'Cap recursion depth for --tree (0 = root only)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l sort -d 'Sort field' -r -a 'priority deadline updated_at created_at title parent'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l order -d 'Sort order (requires --sort)' -r -a 'asc desc'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l stream -d 'Emit line-delimited JSON rows (requires --json)'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-before -d 'Filter by deadline upper bound (ISO/date string or relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-after  -d 'Filter by deadline lower bound (ISO/date string or relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l today -d 'Filter to items updated since local midnight today'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l recent -d 'Filter to items updated in the last 7 days'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-after  -d 'Filter by updated_at lower bound (ISO/relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-before -d 'Filter by updated_at upper bound (ISO/relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-after  -d 'Filter by created_at lower bound (ISO/relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-before -d 'Filter by created_at upper bound (ISO/relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-risk-missing       -d 'Select only items missing risk'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-confidence-missing -d 'Select only items missing confidence'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-sprint-missing     -d 'Select only items missing sprint'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-release-missing    -d 'Select only items missing release'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-notes            -d 'Select only items that have notes'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-notes             -d 'Select only items with no notes'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-learnings        -d 'Select only items that have learnings'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-learnings         -d 'Select only items with no learnings'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-files            -d 'Select only items that have linked files'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-files             -d 'Select only items with no linked files'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-files-missing -d 'Alias for --no-files'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-docs             -d 'Select only items that have linked docs'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-docs              -d 'Select only items with no linked docs'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-docs-missing  -d 'Alias for --no-docs'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-tests            -d 'Select only items that have linked tests'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-tests             -d 'Select only items with no linked tests'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-comments         -d 'Select only items that have comments'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-comments          -d 'Select only items with no comments'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-deps             -d 'Select only items that have dependencies'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-deps              -d 'Select only items with no dependencies'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-body             -d 'Select only items with non-empty body'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l empty-body           -d 'Select only items with empty body'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-linked-command   -d 'Select only items that have a linked command'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-linked-command    -d 'Select only items with no linked command'
+end
+${y}
+
+# aggregate flags
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l group-by -d 'Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l count -d 'Return grouped counts'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l completion -d 'Add completion counts and percentage per group'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l sum -d 'Numeric field to sum per group' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l avg -d 'Numeric field to average per group' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l include-unparented -d 'Include unparented rows when grouping by parent'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l status -d 'Filter by status' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l type -d 'Filter by item type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l tag -d 'Filter by tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l deadline-before -d 'Filter by deadline upper bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l deadline-after -d 'Filter by deadline lower bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l assignee -d 'Filter by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l parent -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l sprint -d 'Filter by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l release -d 'Filter by release' -r
+
+
+# create flags
+complete -c pm -n '__fish_seen_subcommand_from create' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l type                    -d 'Item type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from create' -l create-mode             -d 'Create required-option policy mode' -r -a 'strict progressive'
+complete -c pm -n '__fish_seen_subcommand_from create' -l schedule-preset         -d 'Scheduling preset for Reminder/Meeting/Event' -r -a 'lightweight'
+complete -c pm -n '__fish_seen_subcommand_from create' -s s -l status             -d 'Item status' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from create' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from create' -l tags                    -d 'Comma-separated tags' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l body-file               -d 'Load the item body from a file' -r -F
+complete -c pm -n '__fish_seen_subcommand_from create' -l deadline                -d 'Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l estimate                -d 'Estimated minutes' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l acceptance-criteria     -d 'Acceptance criteria' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l message                 -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l assignee                -d 'Assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-events            -d 'Clear events'
+complete -c pm -n '__fish_seen_subcommand_from create' -l clear-type-options      -d 'Clear type options'
+${g}
+
+# copy flags
+complete -c pm -n '__fish_seen_subcommand_from copy' -l title   -d 'Override copied title' -r
+complete -c pm -n '__fish_seen_subcommand_from copy' -l author  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from copy' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from copy' -l force   -d 'Force ownership override'
+
+# focus flags
+complete -c pm -n '__fish_seen_subcommand_from focus' -l clear -d 'Clear the focused item'
+
+# update flags
+complete -c pm -n '__fish_seen_subcommand_from update' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l body-file               -d 'Load the item body from a file' -r -F
+complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from update' -l close-reason            -d 'Set close reason' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from update' -l type                    -d 'Item type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from update' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l expected                -d 'Short alias for --expected-result' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l actual                  -d 'Short alias for --actual-result' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__fish_seen_subcommand_from update' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__fish_seen_subcommand_from update' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__fish_seen_subcommand_from update' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-events            -d 'Clear events'
+complete -c pm -n '__fish_seen_subcommand_from update' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__fish_seen_subcommand_from update' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l message                 -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l force                   -d 'Force override'
+${k}
+
+# update-many flags
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-tag              -d 'Filter by tag before applying updates' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-before  -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-after   -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-after    -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-before   -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-after    -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-before   -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee         -d 'Filter by assignee before applying updates' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee-filter  -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-parent           -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release          -d 'Filter by release before applying updates' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-ac-missing       -d 'Select only items missing acceptance_criteria'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-estimates-missing -d 'Select only items missing estimated_minutes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-resolution-missing -d 'Select only terminal items missing resolution'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-metadata-missing  -d 'Select only items missing any tracked metadata'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l limit                   -d 'Limit matched item count' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l offset                  -d 'Skip first n matched rows' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l dry-run                 -d 'Preview updates without mutating'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l rollback                -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l no-checkpoint           -d 'Disable checkpoint creation during apply mode'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l type                    -d 'Item type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l tags                    -d 'Comma-separated tags' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l deadline                -d 'Deadline (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l estimate                -d 'Estimated minutes' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l acceptance-criteria     -d 'Acceptance criteria' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l definition-of-ready     -d 'Definition of ready' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l order                   -d 'Planning order/rank' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l goal                    -d 'Goal identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l objective               -d 'Objective identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l value                   -d 'Business value summary' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l impact                  -d 'Business impact summary' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l outcome                 -d 'Expected outcome summary' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l why-now                 -d 'Why-now rationale' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l reviewer                -d 'Reviewer' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l risk                    -d 'Risk level' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l confidence              -d 'Confidence level' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l sprint                  -d 'Sprint identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l release                 -d 'Release identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l reporter                -d 'Issue reporter' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l severity                -d 'Issue severity' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l environment             -d 'Issue environment context' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l repro-steps             -d 'Issue reproduction steps' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l resolution              -d 'Issue resolution summary' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected-result         -d 'Issue expected behavior' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual-result           -d 'Issue observed behavior' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected                 -d 'Short alias for --expected-result' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual                   -d 'Short alias for --actual-result' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l affected-version        -d 'Affected version identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l fixed-version           -d 'Fixed version identifier' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l component               -d 'Issue component ownership' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l regression              -d 'Regression marker true|false|1|0' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l customer-impact         -d 'Customer impact summary' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l dep                     -d 'Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l dep-remove              -d 'Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-events            -d 'Clear events'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l message                 -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l force                   -d 'Force override'
+${E}
+
+# files flags
+complete -c pm -n '__fish_seen_subcommand_from files' -a 'discover lookup' -d 'Linked-file subcommand'
+complete -c pm -n '__fish_seen_subcommand_from files' -l add -d 'Add a linked file' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l add-glob -d 'Add linked files matching a glob' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l remove -d 'Remove a linked file' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l migrate -d 'Migrate linked-file metadata'
+complete -c pm -n '__fish_seen_subcommand_from files' -l list -d 'List linked files'
+complete -c pm -n '__fish_seen_subcommand_from files' -l apply -d 'Apply discovered linked files'
+complete -c pm -n '__fish_seen_subcommand_from files' -l note -d 'Linked-file note' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l append-stable -d 'Preserve stable append ordering'
+complete -c pm -n '__fish_seen_subcommand_from files' -l validate-paths -d 'Validate linked-file paths'
+complete -c pm -n '__fish_seen_subcommand_from files' -l scope -d 'Filter lookup by evidence scope' -r -a 'project global'
+complete -c pm -n '__fish_seen_subcommand_from files' -l limit -d 'Maximum lookup matches' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l offset -d 'Skip the first lookup matches' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l no-truncate -d 'Return every lookup match'
+complete -c pm -n '__fish_seen_subcommand_from files' -l strict-read -d 'Require authoritative source reads'
+complete -c pm -n '__fish_seen_subcommand_from files' -l explain -d 'Include ranked source-to-work rationale'
+complete -c pm -n '__fish_seen_subcommand_from files' -l lines -d 'Attribute an inclusive source line range' -r
+complete -c pm -n '__fish_seen_subcommand_from files' -l decision-depth -d 'Maximum governing-decision relationship depth' -r
+
+
+# search flags
+complete -c pm -n '__fish_seen_subcommand_from search' -l mode          -d 'Search mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__fish_seen_subcommand_from search' -l match-mode    -d 'Token match mode' -r -a 'and or exact'
+complete -c pm -n '__fish_seen_subcommand_from search' -l min-score     -d 'Per-query minimum score threshold' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l count          -d 'Return only the match count'
+complete -c pm -n '__fish_seen_subcommand_from search' -l include-linked -d 'Include linked content in scoring'
+complete -c pm -n '__fish_seen_subcommand_from search' -l highlight      -d 'Emit per-field matched-text snippets on each hit'
+complete -c pm -n '__fish_seen_subcommand_from search' -l limit          -d 'Max results' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l status         -d 'Filter by status (open/closed/canceled, csv)' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from search' -l type           -d 'Filter by type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from search' -l tag            -d 'Filter by tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from search' -l tags           -d 'Alias for --tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from search' -l priority       -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from search' -l updated-after  -d 'Filter by updated_at lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l updated-before -d 'Filter by updated_at upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l created-after  -d 'Filter by created_at lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l created-before -d 'Filter by created_at upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l assignee       -d 'Filter by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l sprint         -d 'Filter by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l release        -d 'Filter by release' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l parent         -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-files-missing -d 'Alias for --no-files'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-docs-missing  -d 'Alias for --no-docs'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from search' -l empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-linked-command  -d 'Select only items with no linked command'
+${P}
+
+# calendar flags
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l view      -d 'Calendar view' -r -a 'agenda day week month'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l past      -d 'Include past entries'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l full-period -d 'Include full anchored day/week/month period'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l type      -d 'Filter by type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l tag       -d 'Filter by tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l status    -d 'Filter by status' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee  -d 'Filter by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l sprint    -d 'Filter by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l release   -d 'Filter by release' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l include   -d 'Include event sources' -r -a 'all deadlines reminders events scheduled'
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookahead-days -d 'Bound open-ended recurrence lookahead' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookback-days -d 'Bound open-ended recurrence lookback' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l occurrence-limit -d 'Cap occurrences per recurring event' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l limit     -d 'Limit returned events' -r
+complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l format    -d 'Output override' -r -a 'markdown toon json'
+${T}
+
+# context flags
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l past      -d 'Include past entries in bounded windows'
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l type      -d 'Filter by type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l tag       -d 'Filter by tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee  -d 'Filter by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l sprint    -d 'Filter by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l release   -d 'Filter by release' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l parent    -d 'Scope snapshot to one item subtree' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l limit     -d 'Limit focus and agenda rows per section' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l depth     -d 'Context depth' -r -a 'brief standard deep full'
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l format    -d 'Output override' -r -a 'markdown toon json'
+${H}
+
+# next flags
+complete -c pm -n '__fish_seen_subcommand_from next' -l type           -d 'Filter candidates by type' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from next' -l tag            -d 'Filter candidates by tag' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from next' -l priority       -d 'Filter candidates by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from next' -l assignee       -d 'Filter candidates by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from next' -l sprint         -d 'Filter candidates by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l release        -d 'Filter candidates by release' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l parent         -d 'Scope to one item subtree' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l limit          -d 'Limit ready rows' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l blocked-limit  -d 'Limit blocked rows' -r
+complete -c pm -n '__fish_seen_subcommand_from next' -l ready-only     -d 'Omit the blocked companion list'
+complete -c pm -n '__fish_seen_subcommand_from next' -l format         -d 'Output override' -r -a 'markdown toon json'
+
+# guide flags
+complete -c pm -n '__fish_seen_subcommand_from guide' -l list      -d 'Show guide topic index'
+complete -c pm -n '__fish_seen_subcommand_from guide' -l format    -d 'Output override' -r -a 'markdown toon json'
+complete -c pm -n '__fish_seen_subcommand_from guide' -l depth     -d 'Guide detail depth' -r -a 'brief standard deep'
+complete -c pm -n '__fish_seen_subcommand_from guide' -a '${f}' -d 'Guide topic'
+
+# reindex flags
+complete -c pm -n '__fish_seen_subcommand_from reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__fish_seen_subcommand_from reindex' -l progress -d 'Emit progress updates to stderr'
+
+# get flags
+complete -c pm -n '__fish_seen_subcommand_from get' -l depth -d 'Detail depth' -r -a 'brief standard deep full'
+complete -c pm -n '__fish_seen_subcommand_from get' -l full -d 'Explicit full item read'
+complete -c pm -n '__fish_seen_subcommand_from get' -l fields -d 'Render custom comma-separated item fields' -r
+complete -c pm -n '__fish_seen_subcommand_from get' -l tree -d 'Include descendant subtree in result payload'
+complete -c pm -n '__fish_seen_subcommand_from get' -l tree-depth -d 'Cap subtree depth for --tree (0 = root only)' -r
+
+# history / activity flags
+complete -c pm -n '__fish_seen_subcommand_from history'  -l limit -d 'Max history entries' -r
+complete -c pm -n '__fish_seen_subcommand_from history'  -l compact -d 'Condensed history projection'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l full -d 'Show full history entries'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__fish_seen_subcommand_from history'  -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__fish_seen_subcommand_from history'  -l diff -d 'Include per-entry field-level before/after value diffs'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l field -d 'With --diff, show only entries that changed this field' -r
+complete -c pm -n '__fish_seen_subcommand_from history'  -l verify -d 'Verify history hash chain and replay integrity'
+complete -c pm -n '__fish_seen_subcommand_from events' -l since -d 'Resume after a cursor or from an ISO timestamp' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l type -d 'Filter by mutation operation' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l author -d 'Filter by mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l item -d 'Filter by item or workspace stream' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l limit -d 'Maximum events, up to 1000' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l full -d 'Include complete authoritative history entries'
+complete -c pm -n '__fish_seen_subcommand_from events' -l provenance -d 'Include patch-free identity and agent provenance'
+complete -c pm -n '__fish_seen_subcommand_from events' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__fish_seen_subcommand_from events' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__fish_seen_subcommand_from events' -l follow -d 'Continue emitting committed events'
+complete -c pm -n '__fish_seen_subcommand_from events' -l interval-ms -d 'Empty-read delay while following' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l before -d 'Compact entries strictly before this version number or ISO timestamp' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l ids -d 'Bulk: compact an explicit comma-separated list of item ids' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l all-over -d 'Bulk: compact every stream with more than N entries' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l closed -d 'Bulk: compact only closed (terminal) items streams'
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l all-streams -d 'Bulk: compact every history stream regardless of lifecycle state'
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l min-entries -d 'Bulk: skip streams with at most N entries' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l dry-run -d 'Preview compaction impact without writing the history file'
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l message -d 'Audit history message' -r
+complete -c pm -n '__fish_seen_subcommand_from history-compact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l event -d 'Actionable unknown-author event' -r
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l all-actionable -d 'Select every currently actionable event'
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l dry-run -d 'Preview a deterministic source-bound plan'
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l plan-fingerprint -d 'Apply the exact dry-run plan' -r
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l limit -d 'Maximum coordinate rows returned in the plan' -r
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l attributed-author -d 'Principal attributed by maintainer review' -r
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reviewer -d 'Reviewer recording the disposition' -r
+complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reason -d 'Evidence-backed review rationale' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l dry-run -d 'Preview redaction impact without writing files'
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l message -d 'Audit history message' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l all -d 'Repair every drifted stream in one audited pass'
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l message -d 'Audit history message' -r
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from schema' -a 'list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type, status, or field' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l default-status -d 'Default status hint for the custom item type' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l folder -d 'Storage folder for items of this custom type' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type, status, or field flag (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l role -d 'Lifecycle role for a custom status (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l order -d 'Display/sort order for a custom status' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l type -d 'Value type for a custom field' -r -a 'string number boolean string_array array object'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l commands -d 'Commands a custom field is wired onto (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l cli-flag -d 'Override the auto-derived CLI flag for a custom field' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required -d 'Mark a custom field as always required'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required-on-create -d 'Mark a custom field as required at create time'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l no-allow-unset -d 'Disallow clearing a custom field via --unset'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required-types -d 'Restrict a custom field requirement to specific item types (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l infer -d 'Infer item types from title-prefix conventions (add-type)'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l min-count -d 'Minimum items sharing a prefix for --infer' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l apply -d 'Register inferred types (with --infer)'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from profile' -a 'list show apply lint' -d 'Profile subcommand'
+complete -c pm -n '__fish_seen_subcommand_from profile' -a 'agile ops research' -d 'Profile name'
+complete -c pm -n '__fish_seen_subcommand_from profile' -l dry-run -d 'Preview the apply diff without writing any files'
+complete -c pm -n '__fish_seen_subcommand_from profile' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from profile' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from plan' -a 'create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize' -d 'Plan subcommand'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l title -d 'Plan title' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l scope -d 'Plan scope statement' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l harness -d 'Plan harness provenance' -r -a 'codex claude-code cursor generic'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l mode -d 'Plan mode' -r -a 'draft research review approved executing paused completed superseded'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l resume-context -d 'Resume context summary' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-title -d 'Step title' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step -d 'Step title (repeatable on create)' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-status -d 'Step status' -r -a 'pending in_progress completed blocked skipped superseded'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-evidence -d 'Step evidence' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l depends-on -d 'Pm item id step depends on' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l link -d 'Pm item id to link' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l link-kind -d 'Link kind' -r -a 'related blocks blocked_by depends_on discovered_from implements verifies supersedes'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l depth -d 'Show depth' -r -a 'brief standard deep'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l steps -d 'Step ids/orders for materialize' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l materialize-type -d 'Item type for materialized steps' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l allow-multiple-active -d 'Allow multiple in_progress steps'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l promote-to-item-dep -d 'Also add link as item dependency'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l message -d 'Mutation message' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l force -d 'Force ownership override'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l id -d 'Filter by item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l op -d 'Filter by history operation' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l author -d 'Filter by history author' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l compact -d 'Condensed activity projection'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l raw -d 'Emit raw compact per-event activity output'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full activity entries'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows (requires --json)'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l summary -d 'Return compact command intent summary'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l schema-only -d 'Return schema-only payload'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l flags-only -d 'Return command flag contracts only'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l availability-only -d 'Return action availability only'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l runtime-only -d 'Include only actions invocable in the current runtime'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l active-only -d 'Alias for --runtime-only'
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l full -d 'Include complete command and schema contract details'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l format -d 'Output format' -r -a 'tree graph context'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l max-depth -d 'Maximum traversal depth (0 keeps root only)' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l collapse -d 'Collapse mode' -r -a 'none repeated'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l summary -d 'Return counts only without tree/graph payload'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l node-limit -d 'Maximum nodes in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l edge-limit -d 'Maximum edges in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l token-budget -d 'Maximum estimated tokens in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l cursor -d 'Continue an equivalent context query' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l direction -d 'Context traversal direction' -r -a 'outgoing incoming both'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l kind -d 'Restrict context traversal to relationship kinds' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -a 'ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index' -d 'Graph query'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l kind -d 'Restrict traversal to registered relationship kinds' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l max-depth -d 'Maximum traversal depth' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l limit -d 'Maximum returned rows per bounded collection' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l after -d 'Resume a traversal after this node id' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l direction -d 'Edge orientation for paths/impact' -r -a 'outgoing incoming both'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l max-paths -d 'Maximum enumerated paths' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l sample -d 'Maximum evidence sample entries per audit finding' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l exempt-isolate -d 'Item ids treated as explicitly valid isolates' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l exempt-isolate-type -d 'Item types whose active isolates are policy-valid' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l save-baseline -d 'Persist the audit census as the comparison baseline'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l rebuild -d 'Rebuild and warm the durable graph index'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l clear -d 'Delete the durable graph index'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l summary -d 'Return counts-first envelopes without row collections'
+
+# comments / notes / learnings flags
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l add -d 'Add one entry (text=<value> or plain text)' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l add-json -d 'Append one validated JSON context event' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l since -d 'Return structured events at or after an ISO timestamp' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l event-type -d 'Return structured events with this top-level type' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l include-meta -d 'Include result counts and truncation metadata'
+complete -c pm -n '__fish_seen_subcommand_from comments' -l stdin -d 'Read comment text from stdin (supports multiline markdown)'
+complete -c pm -n '__fish_seen_subcommand_from comments' -l file -d 'Read comment text from file (supports multiline markdown)' -r
+complete -c pm -n '__fish_seen_subcommand_from comments' -l edit -d 'Replace the comment at 1-based index (text from positional/--add/--stdin/--file)' -r
+complete -c pm -n '__fish_seen_subcommand_from comments' -l delete -d 'Delete the comment at 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l stdin -d 'Read entry text from stdin'
+complete -c pm -n '__fish_seen_subcommand_from notes' -l file -d 'Read entry text from file' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l edit -d 'Replace the entry at a 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from notes' -l delete -d 'Delete the entry at a 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l limit -d 'Return only latest n entries' -r
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l full-history -d 'Return complete post-mutation history'
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l author -d 'Entry author' -r
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l force -d 'Force override'
+
+# test flags
+complete -c pm -n '__fish_seen_subcommand_from test' -l add -d 'Add linked test entry' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l add-json -d 'Add linked test entry from JSON object/array' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l remove -d 'Remove linked test entry' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l remove-index -d 'Remove linked test entry by 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l list -d 'List linked tests without mutating'
+complete -c pm -n '__fish_seen_subcommand_from test' -l run -d 'Run linked tests'
+complete -c pm -n '__fish_seen_subcommand_from test' -l match -d 'Run linked tests whose command/path contains substring' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l only-index -d 'Run one linked test by 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l only-last -d 'Run the most recently added linked test'
+complete -c pm -n '__fish_seen_subcommand_from test' -l background -d 'Run linked tests in managed background mode'
+complete -c pm -n '__fish_seen_subcommand_from test' -l timeout -d 'Default timeout seconds' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l progress -d 'Emit linked-test progress to stderr'
+complete -c pm -n '__fish_seen_subcommand_from test' -l env-set -d 'Set linked-test runtime environment values' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l env-clear -d 'Clear linked-test runtime environment values' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
+complete -c pm -n '__fish_seen_subcommand_from test' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
+complete -c pm -n '__fish_seen_subcommand_from test' -l override-linked-pm-context -d 'Force run-level --pm-context over per-linked-test metadata'
+complete -c pm -n '__fish_seen_subcommand_from test' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
+complete -c pm -n '__fish_seen_subcommand_from test' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
+complete -c pm -n '__fish_seen_subcommand_from test' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
+complete -c pm -n '__fish_seen_subcommand_from test' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
+complete -c pm -n '__fish_seen_subcommand_from test' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
+complete -c pm -n '__fish_seen_subcommand_from test' -l auto-pm-context -d 'Auto-remediate tracker-read context mismatches using tracker context'
+complete -c pm -n '__fish_seen_subcommand_from test' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l force -d 'Force override'
+
+# test-all flags
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l status  -d 'Filter by status' -r -a 'open in_progress'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l limit -d 'Limit matching items before running linked tests' -r
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l offset -d 'Skip matching items before running linked tests' -r
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l background -d 'Run linked tests in managed background mode'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l timeout -d 'Default timeout seconds' -r
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l progress -d 'Emit linked-test progress to stderr'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l env-set -d 'Set linked-test runtime environment values' -r
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l env-clear -d 'Clear linked-test runtime environment values' -r
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l override-linked-pm-context -d 'Force run-level --pm-context over per-linked-test metadata'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
+complete -c pm -n '__fish_seen_subcommand_from test-all' -l auto-pm-context -d 'Auto-remediate tracker-read context mismatches using tracker context'
+
+# test-runs flags
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -a 'list status logs stop resume' -d 'test-runs subcommand'
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l status -d 'Filter background runs by status' -r -a 'queued running passed failed stopped canceled'
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l limit -d 'Limit returned runs' -r
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l stream -d 'Background log stream selector' -r -a 'stdout stderr both'
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l tail -d 'Tail number of lines from logs' -r
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l force -d 'Force-stop run with SIGKILL'
+complete -c pm -n '__fish_seen_subcommand_from test-runs' -l author -d 'Resume author' -r
+
+# gc flags
+complete -c pm -n '__fish_seen_subcommand_from gc' -l dry-run -d 'Preview cleanup targets without deleting files'
+complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
+
+# stats flags
+complete -c pm -n '__fish_seen_subcommand_from stats' -l include-empty -d 'Include registered zero-count type and status buckets'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l storage -d 'Include aggregate history-stream storage metrics'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l field-utilization -d 'Include content-field utilization rates across all items'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-assignee -d 'Lifecycle-bucketed breakdown grouped by assignee'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-tag -d 'Lifecycle-bucketed breakdown grouped by tag'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-priority -d 'Lifecycle-bucketed breakdown grouped by priority'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l tag-prefix -d 'With --by-tag: only count tags with this prefix' -r
+complete -c pm -n '__fish_seen_subcommand_from stats' -l analytics -d 'Improvement ledger/history analytics JSON' -r
+
+# append flags
+complete -c pm -n '__fish_seen_subcommand_from append' -s b -l body -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from append' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from append' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from append' -l force -d 'Force override'
+
+# close flags
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l force -d 'Force override'
+complete -c pm -n '__fish_seen_subcommand_from claim' -l if-available -d 'Skip work held by another author'
+complete -c pm -n '__fish_seen_subcommand_from claim' -l next -d 'Atomically claim the next actionable item'
+complete -c pm -n '__fish_seen_subcommand_from claim' -l token-budget -d 'Bound ranked candidate tokens' -r
+complete -c pm -n '__fish_seen_subcommand_from claim' -l explain-ranking -d 'Include ranking provenance'
+complete -c pm -n '__fish_seen_subcommand_from close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
+complete -c pm -n '__fish_seen_subcommand_from close' -l reason -d 'Closure reason' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l close-reason -d 'Alias for --reason' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l resolution -d 'Closure resolution summary' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l expected-result -d 'Expected behavior note' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l actual-result -d 'Observed behavior note' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l expected -d 'Short alias for --expected-result' -r
+complete -c pm -n '__fish_seen_subcommand_from close' -l actual -d 'Short alias for --actual-result' -r
+complete -c pm -n '__fish_seen_subcommand_from delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
+
+# scheduling shortcut flags (meet/event/remind)
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l start -d 'Start time (ISO, now, or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l duration -d 'Duration from start (default 1h)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l end -d 'End time (overrides --duration)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l location -d 'Location' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l timezone -d 'IANA timezone' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l all-day -d 'Mark as an all-day event'
+complete -c pm -n '__fish_seen_subcommand_from remind' -l at -d 'Reminder time (default +1d)' -r
+complete -c pm -n '__fish_seen_subcommand_from remind' -l text -d 'Reminder text (defaults to title)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l parent -d 'Parent item id' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l allow-missing-parent -d 'Permit a parent id that does not exist yet'
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l tags -d 'Comma-separated tags' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l body -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l description -d 'Short description' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l message -d 'History message' -r
+
+# close-many flags
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-status          -d 'Filter by status before closing' -r -a '${m}'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${l}'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-tag             -d 'Filter by tag before closing' -r -a ${w}
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-priority        -d 'Filter by priority before closing' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-before -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-after  -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-after   -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-before  -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-after   -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-before  -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee        -d 'Filter by assignee before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-parent          -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release         -d 'Filter by release before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l limit                  -d 'Limit matched item count' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l offset                 -d 'Skip first n matched rows' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l reason                 -d 'Optional shared close reason applied to every matched item' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l resolution             -d 'Shared closure resolution' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected-result        -d 'Shared expected-result note' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual-result          -d 'Shared actual-result note' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected               -d 'Short alias for --expected-result' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual                 -d 'Short alias for --actual-result' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l validate-close         -d 'Validate closure metadata per item' -r -a 'off warn strict'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l author                 -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l message                -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l force                  -d 'Re-close terminal matches and override ownership'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l dry-run                -d 'Preview matched items without mutating'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l rollback               -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
+
+# validate flags
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-resolution -d 'Run closed-item resolution metadata checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-lifecycle -d 'Run active-item lifecycle governance drift checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-stale-blockers -d 'Include stale blocker-pattern diagnostics in lifecycle checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l dependency-cycle-severity -d 'Set dependency-cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l parent-cycle-severity -d 'Set parent-hierarchy cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-files -d 'Run linked-file and orphaned-file checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l scan-mode -d 'Select file candidate scan mode for --check-files' -r -a 'default tracked-all tracked-all-strict'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l include-pm-internals -d 'Include PM storage internals in tracked-all candidate scans'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-diagnostics -d 'Include full validate diagnostic ID lists instead of compact summaries'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l all-affected-ids -d 'Emit complete missing_* affected-ID lists with no truncation (implied by --json)'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l fail-on-warn -d 'Alias for --strict-exit'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l auto-fix -d 'Apply the safe, deterministic subset of fix-hint remediations automatically'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l dry-run -d 'Preview planned --auto-fix/--prune-missing fixes without applying them'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-scope -d 'Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)' -r -a 'metadata resolution estimates lifecycle'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l prune-missing -d 'Remove stale linked-file/doc links classified as deleted'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
+complete -c pm -n '__fish_seen_subcommand_from init' -l preset -d 'Governance preset for new setups' -r -a 'minimal default strict'
+complete -c pm -n '__fish_seen_subcommand_from init' -l id-prefix -d 'Set the item ID prefix' -r
+complete -c pm -n '__fish_seen_subcommand_from init' -l prefix -d 'Alias for --id-prefix' -r
+complete -c pm -n '__fish_seen_subcommand_from init' -l defaults -d 'Use non-interactive setup defaults'
+complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for --defaults'
+complete -c pm -n '__fish_seen_subcommand_from init' -l author -d 'Set the default mutation author for this project' -r
+complete -c pm -n '__fish_seen_subcommand_from init' -l agent-guidance -d 'Agent guidance mode' -r -a 'ask add skip status'
+complete -c pm -n '__fish_seen_subcommand_from init' -l type-preset -d 'Register domain item types' -r -a 'agile ops research'
+complete -c pm -n '__fish_seen_subcommand_from init' -l with-packages -d 'Install bundled first-party packages during initialization'
+complete -c pm -n '__fish_seen_subcommand_from init' -l verbose -d 'Include the full resolved settings tree in init output'
+complete -c pm -n '__fish_seen_subcommand_from config' -l criterion -d 'Criteria value for definition-of-done metadata-required-fields or lifecycle pattern keys (repeatable for set)' -r
+complete -c pm -n '__fish_seen_subcommand_from config' -l clear-criteria -d 'Clear config criteria-list key values'
+complete -c pm -n '__fish_seen_subcommand_from config' -l format -d 'Item format for item-format key' -r -a 'toon'
+complete -c pm -n '__fish_seen_subcommand_from config' -l policy -d 'Policy value for supported policy keys' -r
+complete -c pm -n '__fish_seen_subcommand_from health' -l strict-directories -d 'Treat optional item-type directories as required failures'
+complete -c pm -n '__fish_seen_subcommand_from health' -l check-only -d 'Run read-only health diagnostics without refreshing vectors'
+complete -c pm -n '__fish_seen_subcommand_from health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
+complete -c pm -n '__fish_seen_subcommand_from health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
+complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
+complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-author-events -d 'Include complete actionable unknown-author coordinates'
+complete -c pm -n '__fish_seen_subcommand_from health' -l brief -d 'Emit compact health details for low-token agent checks'
+complete -c pm -n '__fish_seen_subcommand_from health' -l summary -d 'Emit one-line-style health status with check names and warning count'
+complete -c pm -n '__fish_seen_subcommand_from health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
+complete -c pm -n '__fish_seen_subcommand_from health' -l fail-on-warn -d 'Alias for --strict-exit'
+
+# completion shell argument
+complete -c pm -n '__fish_seen_subcommand_from completion' -l eager-tags -d 'Embed current tracker tags directly in script output'
+complete -c pm -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d 'Shell type'
+
+# templates subcommands
+complete -c pm -n '__fish_seen_subcommand_from templates' -a 'save list show' -d 'Templates command'
+
+# extension lifecycle flags
+complete -c pm -n '__fish_seen_subcommand_from extension' -a '${Ln}' -d 'Extension action subcommand'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l init -d 'Generate starter extension scaffold'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l scaffold -d 'Alias for --init'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l capability -d 'Capability the init scaffold targets' -r -a '${St.join(" ")}'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l install -d 'Install extension from local path or GitHub source'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l uninstall -d 'Uninstall extension by name'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l explore -d 'List discovered extensions for selected scope'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l manage -d 'List managed extensions with update metadata'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l describe -d 'Map every surface a loaded extension registers'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l markdown -d 'Render describe output as a Markdown reference document'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l output -d 'Write describe Markdown to a file' -r
+complete -c pm -n '__fish_seen_subcommand_from extension' -l reload -d 'Reload extensions with cache-busted module imports'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l watch -d 'Enable watch mode with --reload'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l doctor -d 'Run consolidated extension diagnostics'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l catalog -d 'List bundled first-party package catalog entries'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt -d 'Adopt an unmanaged extension into managed metadata'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt-all -d 'Adopt all unmanaged extensions into managed metadata'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l activate -d 'Activate extension in selected scope settings'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l deactivate -d 'Deactivate extension in selected scope settings'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l project -d 'Use project extension scope'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l local -d 'Alias for --project'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l global -d 'Use global extension scope'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l gh -d 'GitHub shorthand owner/repo/path' -r
+complete -c pm -n '__fish_seen_subcommand_from extension' -l github -d 'Alias for --gh' -r
+complete -c pm -n '__fish_seen_subcommand_from extension' -l ref -d 'Git ref/branch/tag for GitHub source' -r
+complete -c pm -n '__fish_seen_subcommand_from extension' -l detail -d 'Detail mode for extension diagnostics' -r -a 'summary deep'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l trace -d 'Include registration traces in doctor deep diagnostics'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l fix-managed-state -d 'Adopt unmanaged extensions before diagnostics/update checks'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l isolated -d 'Run doctor against project-scope extensions only'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l ignore-global -d 'Alias for --isolated'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
+
+# package lifecycle flags
+for package_cmd in package packages
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -a '${Ln}' -d 'Package action subcommand'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l init -d 'Generate starter package scaffold'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l scaffold -d 'Alias for --init'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l capability -d 'Capability the init scaffold targets' -r -a '${St.join(" ")}'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l declarative -d 'Generate a composeExtension blueprint starter'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l install -d 'Install package from local path, GitHub source, npm source, or bundled alias'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l uninstall -d 'Uninstall package by name'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l explore -d 'List discovered packages for selected scope'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l manage -d 'List managed packages with update metadata'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l describe -d 'Map every surface a loaded package registers'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l markdown -d 'Render describe output as a Markdown reference document'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l output -d 'Write describe Markdown to a file' -r
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l reload -d 'Reload packages with cache-busted module imports'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l watch -d 'Enable watch mode with --reload'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l doctor -d 'Run consolidated package diagnostics'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l catalog -d 'List bundled first-party package catalog entries'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l adopt -d 'Adopt an unmanaged package into managed metadata'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l adopt-all -d 'Adopt all unmanaged packages into managed metadata'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l activate -d 'Activate package in selected scope settings'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l deactivate -d 'Deactivate package in selected scope settings'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l project -d 'Use project package scope'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l local -d 'Alias for --project'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l global -d 'Use global package scope'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l gh -d 'GitHub shorthand owner/repo/path' -r
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l github -d 'Alias for --gh' -r
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ref -d 'Git ref/branch/tag for GitHub source' -r
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l detail -d 'Detail mode for package diagnostics' -r -a 'summary deep'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l trace -d 'Include registration traces in doctor deep diagnostics'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fix-managed-state -d 'Adopt unmanaged packages before diagnostics/update checks'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l isolated -d 'Run doctor against project-scope packages only'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ignore-global -d 'Alias for --isolated'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
+end`}var Fh={bash:'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',zsh:'Add to ~/.zshrc: eval "$(pm completion zsh)"',fish:"Run: pm completion fish > ~/.config/fish/completions/pm.fish"};function Lh(e,t=[],n=[],o=!1,r={}){let s=e.trim().toLowerCase();if(!Cl.includes(s))throw new p(`Unknown shell: "${e}". Supported shells: ${Cl.join(", ")}.`,u.USAGE);let i=s,a;return i==="bash"?a=Oh(t,n,o,r):i==="zsh"?a=$h(t,n,o,r):a=Ph(t,n,o,r),{shell:i,script:a,setup_hint:Fh[i]}}import Mh from"node:fs/promises";import $t 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 Br="index/manifest.json",Vr="search/embeddings.jsonl",Dh="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function Nh(e){return e.progress===!0||process.stderr.isTTY===!0}function M(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
+`)}catch{}}function jh(e){let t=(e??"keyword").trim().toLowerCase();if(t==="keyword")return"keyword";if(t==="semantic"||t==="hybrid")return t;throw new p("Reindex mode must be one of keyword|semantic|hybrid",u.USAGE)}async function Uh(e,t,n,o){let r=[];return{candidates:await si(e,t,n,r,o),warnings:r}}async function Kr(e,t,n,o,r){let s=Ke(A()),i=[];for(let a of t)if(!(r&&!r.has(a.metadata.id))){if(typeof a.body=="string"){i.push({metadata:a.metadata,body:a.body});continue}try{let c=await Mh.readFile(a.item_path,"utf8"),d=qt(c,{format:a.item_format,schema:n,extensionFieldNames:s,onWarning:l=>o.push(l)});i.push({metadata:a.metadata,body:d.body})}catch{o.push(`item_list_item_read_failed:${$t.relative(e,a.item_path)}`),i.push({metadata:a.metadata,body:""})}}return i}function Gh(e,t,n){let o=e.metadata;return{id:o.id,mode:t,updated_at:o.updated_at,corpus:li(e,{fields:n})}}var mt=ns;function qh(e){let t=A(),n=mt(e.search?.provider);if(!n)return null;let o=ys(t,n);if(!o)return null;let r=o.runtime_definition??o.definition,s=mt(r.name)??mt(o.definition.name);if(!s)return null;let i=r.embedBatch,a=r.embed_batch,c=r.embed,d=typeof i=="function"?i:typeof a=="function"?a:void 0,l=typeof c=="function"?c:void 0;return!d&&!l?null:{name:s,embedBatch:d,embed:l}}function zh(e){let t=A(),n=mt(e.vector_store?.adapter);if(!n)return null;let o=bs(t,n);if(!o)return null;let r=o.runtime_definition??o.definition,s=mt(r.name)??mt(o.definition.name);if(!s)return null;let i=r.upsert,a=r.delete;return{adapterName:s,...typeof i=="function"?{upsert:i}:{},...typeof a=="function"?{delete:a}:{}}}function Wr(e,t){if(!Array.isArray(e)||e.some(n=>typeof n!="number"||!Number.isFinite(n)))throw new p(`Invalid vector returned by ${t}`,u.GENERIC_FAILURE);return e}async function Hh(e,t,n){let o=t.search?.embedding_model?.trim()||"text-embedding-3-small";if(e.embedBatch){let s=await Promise.resolve(e.embedBatch({inputs:n,settings:t,model:o}));if(!Array.isArray(s))throw new p(`Extension search provider "${e.name}" embedBatch must return an array of vectors`,u.GENERIC_FAILURE);return s.map((i,a)=>Wr(i,`extension search provider "${e.name}" embedBatch output at index ${a}`))}if(!e.embed)throw new p(`Extension search provider "${e.name}" does not implement embed/embedBatch`,u.GENERIC_FAILURE);let r=[];for(let[s,i]of n.entries()){let a=await Promise.resolve(e.embed({input:i,settings:t,model:o}));r.push(Wr(a,`extension search provider "${e.name}" embed output at index ${s}`))}return r}function jl(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function Ul(e,t,n){let o=n?kt(n.name,jl(e)):t?kt(t.name,t.model):null;if(!o)throw new p("No embedding identity available for semantic reindex mode",u.USAGE);return o}function Bh(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,o)=>n.localeCompare(o))}async function Gl(e,t,n,o,r,s,i,a){let c=o?.name??n?.name,d=mi(c,e.search.embedding_corpus_max_characters).maxCharacters,l=co(e),m=r.map(h=>pi(h,{providerName:c,maxCharacters:d,fields:l})),f=[],_=null;if(o)try{f=await Hh(o,e,m),_=kt(o.name,jl(e))}catch(h){if(!n)throw new p(`Extension search provider "${o.name}" failed to generate embeddings: ${h instanceof Error?h.message:String(h)}`,u.GENERIC_FAILURE);s.push(`Extension search provider "${o.name}" failed; falling back to built-in provider (${h instanceof Error?h.message:String(h)})`)}if(f.length===0){if(!n)throw new p(`No embedding executor available for reindex mode '${t}'`,u.USAGE);let h=await ui(n,e,m,{onProgress:w=>{w.phase==="complete"&&(i.batches_completed=w.batch_index),M(a,`embedding_batch_${w.phase} batch=${w.batch_index}/${w.batch_total} size=${w.batch_size} completed_inputs=${w.completed_inputs}/${w.total_inputs}`)}});s.push(...h.warnings),f=h.vectors,_=kt(n.name,n.model)}if(M(a,`embedding_complete vectors=${f.length}`),f.length!==r.length)throw new p(`Embedding output size mismatch (expected ${r.length}, received ${f.length})`,u.GENERIC_FAILURE);if(!_)throw new p(`No embedding identity available for reindex mode '${t}'`,u.USAGE);return{vectors:f,embeddingIdentity:_}}async function Vh(e,t,n,o,r,s){let i=Object.keys(n);if(t){if(i.length>0&&t.delete)try{await Promise.resolve(t.delete({ids:i.sort((a,c)=>a.localeCompare(c)),settings:o}))}catch(a){throw new p(`Extension vector adapter "${t.adapterName}" failed to delete vectors during reindex reset: ${a instanceof Error?a.message:String(a)}`,u.GENERIC_FAILURE)}else i.length>0&&r.push(`search_semantic_reindex_reset_skipped:adapter=${t.adapterName}:known_ids=${i.length}`);if(!e)return}e&&await gi(e,i,{},s)}async function ql(e,t,n,o,r){if(n.length!==0){if(t){if(t.delete)try{await Promise.resolve(t.delete({ids:n,settings:o}))}catch(s){throw new p(`Extension vector adapter "${t.adapterName}" failed to delete orphan vectors during reindex: ${s instanceof Error?s.message:String(s)}`,u.GENERIC_FAILURE)}else r.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${t.adapterName}:count=${n.length}`);if(!e)return}e&&await hi(e,n)}}function Wh(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function Kh(e,t,n){return{version:1,mode:e,generated_at:t,total_items:n.length,items:n.map(o=>({id:o.metadata.id,type:o.metadata.type,status:o.metadata.status,priority:o.metadata.priority,updated_at:o.metadata.updated_at}))}}function Yh(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=ao(e.settings);if(!t.active&&!e.extensionEmbedding)throw new p(`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`,u.USAGE);let n=fi(e.settings,e.pmRoot);if(!n.active&&!e.extensionVectorAdapter)throw new p(`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`,u.USAGE);return{activeEmbeddingProvider:t.active,activeVectorStore:n.active}}async function Jh(e){let t=$(e.settings,A()),n=await Uh(e.pmRoot,e.settings.item_format,t.type_to_folder,e.settings.schema);return{documentCandidates:n.candidates,warnings:[...n.warnings],metadataDocuments:n.candidates.map(o=>({metadata:o.metadata,body:typeof o.body=="string"?o.body:""}))}}async function Xh(e){let t=await mo(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 Ul(e.settings,ao(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&Xt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(Dh))}async function Zh(e){let t=await mo(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=Ul(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),o=new Set(e.metadataDocuments.map(d=>d.metadata.id)),r=Bh(t.entries,o),s=Xt(t.embedding,n);e.forceFullSemantic&&!s&&e.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced");let i=e.forceFullSemantic||s?e.metadataDocuments:e.metadataDocuments.filter(d=>t.entries[d.metadata.id]!==d.metadata.updated_at),a=new Set(i.map(d=>d.metadata.id)),c=a.size>0?await Kr(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,a):[];return{ledgerEntries:t.entries,ledgerEmbedding:t.embedding,orphanIds:r,resetRequired:s,staleDocuments:c,freshDocuments:e.metadataDocuments.length-c.length}}async function Qh(e){let t=new Set(e.metadataDocuments.map(r=>r.metadata.id)),n=await Kr(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,M(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let o=await Gl(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...o,staleDocuments:n,vectorDimension:lo(o.vectors,"Reindex embeddings")}}async function eg(e){let t=await Gl(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,o=t.embeddingIdentity,r=lo(n,"Reindex embeddings");if(!(!e.resetRequired&&(Xt(e.ledgerEmbedding,o)||bi(e.ledgerEmbedding,r))))return{vectors:n,embeddingIdentity:o,staleDocuments:e.staleDocuments,vectorDimension:r,resetRequired:e.resetRequired};let i=await Qh(e);return n=i.vectors,o=i.embeddingIdentity,r=i.vectorDimension,{vectors:n,embeddingIdentity:o,staleDocuments:i.staleDocuments,vectorDimension:r,resetRequired:!0}}async function tg(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(M(e.progressEnabled,`vector_upsert_start adapter=${t} points=${e.points.length}`),typeof e.extensionVectorAdapter.upsert!="function")throw new p(`Extension vector adapter "${t}" does not support upserting vectors.`,u.USAGE);await Promise.resolve(e.extensionVectorAdapter.upsert({points:e.points,settings:e.settings})),e.semanticSummary.vector_upserted=e.points.length,M(e.progressEnabled,`vector_upsert_complete adapter=${t}`);return}catch(t){if(t instanceof p)throw t;if(!e.activeVectorStore)throw new p(`Extension vector adapter "${e.extensionVectorAdapter.adapterName}" failed to upsert vectors: ${t instanceof Error?t.message:String(t)}`,u.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)})`),M(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){M(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await _i(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,M(e.progressEnabled,`vector_upsert_complete adapter=${e.activeVectorStore.name}`);return}throw new p(`No vector upsert executor available for reindex mode '${e.requestedMode}'`,u.USAGE)}function ng(e,t){return e.map((n,o)=>({id:n.metadata.id,vector:Wr(t[o],`reindex embeddings output at index ${o}`),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 og(e){M(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await eg({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?(M(e.progressEnabled,"vector_reset_start"),await Vh(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),M(e.progressEnabled,"vector_reset_complete")):await ql(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=ng(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await tg({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:yi(t.embeddingIdentity,t.vectorDimension)}}async function rg(e){let t=await Zh(e);e.semanticSummary.stale_items=t.staleDocuments.length,e.semanticSummary.unchanged_items=t.freshDocuments;let n=Object.fromEntries(e.metadataDocuments.map(s=>[s.metadata.id,s.metadata.updated_at]));if(M(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 M(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await ql(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let o=await og({...e,plan:t});t.freshDocuments>0&&e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`);let r=new Map(o.staleDocuments.map(s=>[s.metadata.id,s]));return{documentsForKeywordArtifacts:e.metadataDocuments.map(s=>r.get(s.metadata.id)??s),vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:o.embeddingMetadata}}async function sg(e){let t=$t.join(e.pmRoot,Br),n=$t.join(e.pmRoot,Vr),o=co(e.settings),r=e.documentsForKeywordArtifacts.map(i=>JSON.stringify(Gh(i,e.mode,o))).join(`
+`);M(e.progressEnabled,"writing keyword artifacts"),await W(t,`${JSON.stringify(e.manifest,null,2)}
+`),await W(n,`${r}
+`);let s=[];if(e.mode!=="keyword")try{M(e.progressEnabled,"writing vectorization status ledger"),await wi(e.pmRoot,e.vectorizationLedgerEntries,e.vectorizationEmbeddingMetadata)}catch(i){s.push(`search_vectorization_status_ledger_write_failed:${i instanceof Error?i.message:String(i)}`)}return s}async function ig(e,t){let n=jh(e.mode),o=Nh(e),r=e.full===!0;M(o,`start mode=${n}`);let s=I(process.cwd(),t.path);await O(s);let i=oi(await x(s)).settings,a=null;try{a=await X(s,ri,i.locks.ttl_seconds,R(void 0,"pm-reindex"),!1,i.governance.force_required_for_stale_lock,i.locks.wait_ms)}catch(c){throw c instanceof p&&c.exitCode===u.CONFLICT?new p("Another pm reindex run is already active for this project. Wait for it to finish before starting a new keyword, semantic, or hybrid reindex.",u.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=qh(i),d=zh(i),l=Yh({requestedMode:n,pmRoot:s,settings:i,extensionEmbedding:c,extensionVectorAdapter:d}),m=n;M(o,"loading item corpus");let f=await Jh({pmRoot:s,settings:i}),_=f.warnings,{documentCandidates:h,metadataDocuments:w}=f;M(o,`loaded_items=${w.length}`);let y=S(),g=Kh(m,y,w),k=$t.join(s,Br),E=$t.join(s,Vr),P=m==="keyword"?await Kr(s,h,i.schema,_):w,T=[],H={},j=null,te=Wh(m);if(m==="keyword"&&await Xh({pmRoot:s,settings:i,forceFullSemantic:r,extensionEmbedding:c,reindexWarnings:_}),m!=="keyword"){let U=await rg({pmRoot:s,settings:i,requestedMode:n,activeEmbeddingProvider:l.activeEmbeddingProvider,activeVectorStore:l.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:d,documentCandidates:h,metadataDocuments:w,documentsForKeywordArtifacts:P,forceFullSemantic:r,reindexWarnings:_,semanticWarnings:T,semanticSummary:te,progressEnabled:o});P=U.documentsForKeywordArtifacts,H=U.vectorizationLedgerEntries,j=U.vectorizationEmbeddingMetadata}let B=await sg({pmRoot:s,mode:m,manifest:g,documentsForKeywordArtifacts:P,settings:i,vectorizationLedgerEntries:H,vectorizationEmbeddingMetadata:j,progressEnabled:o}),ce=[...await F({path:k,scope:"project",op:"reindex:manifest"}),...await F({path:E,scope:"project",op:"reindex:embeddings"}),...await hs({mode:m,total_items:w.length})];return M(o,"done"),{ok:!0,mode:m,total_items:w.length,semantic:te,artifacts:{manifest:Br,embeddings:Vr},warnings:[..._,...T,...B,...ce],generated_at:y}}finally{await 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]="c770afea-3eb6-5476-ba07-8ec1c5d9c699")}catch{}})();var Wl=Symbol("pm.active-extension-host-context");function ee(e){return{fullChangedFields:!0,options:e}}var v=class e{defaults;constructor(t={}){this.defaults={...t.pmRoot===void 0?{}:{path:t.pmRoot},...t.cwd===void 0?{}:{cwd:t.cwd},...t.author===void 0?{}:{author:t.author},...t.noExtensions===void 0?{}:{noExtensions:t.noExtensions}}}static forActiveExtensionHost(t){let n=new e({...t,noExtensions:!0});return n.defaults[Wl]=!0,n}run(t,n={}){return _g({...this.defaults,...n,action:t})}runTyped(t,n={}){return this.run(t,n)}context(t={}){return this.runTyped("context",{options:t})}listAllItemMetadataLight(){return Pc(this.defaults.path,this.defaults.cwd)}list(t={}){return this.runTyped("list",{options:t})}async listAllComplete(t={}){return yn(await this.list(Do(t)))}search(t,n={}){return this.runTyped("search",{query:t,options:n})}get(t,n={}){return this.runTyped("get",{id:t,options:n})}next(t={}){return this.runTyped("next",{options:t})}aggregate(t={}){return this.runTyped("aggregate",{options:t})}stats(t={}){return this.runTyped("stats",{options:t})}duplicates(t={}){return this.runTyped("duplicates",{options:t})}comments(t,n={}){return this.runTyped("comments",{id:t,options:n})}notes(t,n={}){return this.runTyped("notes",{id:t,options:n})}learnings(t,n={}){return this.runTyped("learnings",{id:t,options:n})}files(t,n={}){return this.runTyped("files",{id:t,options:n})}filesDiscover(t,n={}){return this.runTyped("files-discover",{id:t,options:n})}filesLookup(t){return this.runTyped("files-lookup",{options:t})}docs(t,n={}){return this.runTyped("docs",{id:t,options:n})}deps(t,n={}){return this.runTyped("deps",{id:t,options:n})}graph(t,n={},o={}){return this.runTyped("graph",{subcommand:t,...n,options:o})}append(t,n,o={}){return this.runTyped("append",{id:t,...ee({...o,body:n})})}init(t,n={}){return this.runTyped("init",{...t===void 0?{}:{prefix:t},options:n})}config(t,n,o,r,s={}){return this.runTyped("config",{scope:t,configAction:n,...o===void 0?{}:{key:o},...r===void 0?{}:{value:r},options:s})}schema(t,n={}){return this.runTyped("schema",{options:{...n,subcommand:t}})}schemaList(){return this.runTyped("schema",{options:{subcommand:"list"}})}schemaShow(t){return this.runTyped("schema",{name:t,options:{subcommand:"show"}})}schemaAddType(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-type"}})}schemaRemoveType(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-type"}})}schemaAddStatus(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-status"}})}schemaRemoveStatus(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-status"}})}schemaAddField(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-field"}})}schemaRemoveField(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-field"}})}schemaListFields(){return this.runTyped("schema",{options:{subcommand:"list-fields"}})}schemaShowField(t){return this.runTyped("schema",{name:t,options:{subcommand:"show-field"}})}schemaApplyPreset(t,n={}){return this.runTyped("schema",{typePreset:t,options:{...n,subcommand:"apply-preset"}})}schemaInferTypes(t={}){return this.runTyped("schema",{options:{...t,subcommand:"add-type",infer:!0}})}schemaRenameType(t,n,o){return this.runTyped("schema",{name:t,options:{...o,subcommand:"rename-type",to:n}})}schemaRenameField(t,n,o,r){return this.runTyped("schema",{name:t,options:{...o,subcommand:"rename-field",to:n,...r?{fieldTypeScope:r}:{}}})}schemaRemapStatus(t,n,o){return this.runTyped("schema",{name:t,options:{...o,subcommand:"remap-status",to:n}})}schemaShowStatus(t){return this.runTyped("schema",{name:t,options:{subcommand:"show-status"}})}profile(t,n={}){return this.runTyped("profile",{options:{...n,subcommand:t}})}profileList(){return this.runTyped("profile",{options:{subcommand:"list"}})}profileShow(t){return this.runTyped("profile",{name:t,options:{subcommand:"show"}})}profileApply(t,n={}){return this.runTyped("profile",{name:t,options:{...n,subcommand:"apply"}})}profileLint(t){return this.runTyped("profile",{name:t,options:{subcommand:"lint"}})}validate(t={}){return this.runTyped("validate",{options:t})}health(t={}){return this.runTyped("health",{options:t})}gc(t={}){return this.runTyped("gc",{options:t})}assurance(t){return this.runTyped("assurance",{options:{...t,subcommand:t.action}})}historyRedact(t,n){return this.runTyped("history-redact",{id:t,options:n})}historyRepair(t,n={}){return this.runTyped("history-repair",{id:t,options:n})}historyRepairAll(t={}){return this.runTyped("history-repair",{options:{...t,all:!0}})}historyCompact(t,n={}){return this.runTyped("history-compact",{id:t,options:n})}historyCompactBulk(t){return this.runTyped("history-compact",{options:t})}historyAuthorAcknowledge(t){return this.runTyped("history-author-acknowledge",{historyEvent:(t.events??[]).map(n=>`${n.item_id}:${String(n.line)}`),allActionable:t.all_actionable===!0,dryRun:t.dry_run===!0,planFingerprint:t.plan_fingerprint,limit:t.coordinate_limit,attributedAuthor:t.attributed_author,reviewer:t.reviewer,reason:t.reason})}plan(t,n,o={},r,s){return this.runTyped("plan",{...n===void 0?{}:{id:n},...r===void 0?{}:{stepRef:r},...s===void 0?{}:{reorderTo:s},options:{...o,subcommand:t}})}planCreate(t){return this.plan("create",void 0,t)}planShow(t,n={}){return this.plan("show",t,n)}planAddStep(t,n){return this.plan("add-step",t,n)}planUpdateStep(t,n,o){return this.plan("update-step",t,o,n)}planCompleteStep(t,n,o={}){return this.plan("complete-step",t,o,n)}planBlockStep(t,n,o){return this.plan("block-step",t,o,n)}planReorderStep(t,n,o,r={}){return this.plan("reorder-step",t,r,n,o)}planRemoveStep(t,n,o={}){return this.plan("remove-step",t,o,n)}planLink(t,n,o){return this.plan("link",t,o,n)}planUnlink(t,n,o){return this.plan("unlink",t,o,n)}planDecision(t,n){return this.plan("decision",t,n)}planDiscovery(t,n){return this.plan("discovery",t,n)}planValidation(t,n){return this.plan("validation",t,n)}planResume(t,n){return this.plan("resume",t,n)}planApprove(t,n={}){return this.plan("approve",t,n)}planMaterialize(t,n){return this.plan("materialize",t,n)}create(t={}){return this.runTyped("create",ee(t))}update(t,n={}){return this.runTyped("update",{id:t,...ee(n)})}reopen(t,n,o={}){return this.runTyped("item-reopen",{id:t,reason:n,fullChangedFields:!0,options:o})}close(t,n,o={}){return this.runTyped("close",{id:t,reason:n,...ee(o)})}claim(t,n={}){return this.runTyped("claim",{id:t,...ee(n)})}claimNext(t={}){return this.runTyped("claim",{next:!0,...ee(t)})}release(t,n={}){return this.runTyped("release",{id:t,...ee(n)})}copy(t,n={}){return this.runTyped("copy",{id:t,...ee(n)})}delete(t,n={}){return this.runTyped("delete",{id:t,...ee(n)})}restore(t,n,o={}){return this.runTyped("restore",{fullChangedFields:!0,id:t,options:{...o,target:n}})}focus(t,n={}){return this.runTyped("focus",{...t===void 0?{}:{id:t},...ee(n)})}startTask(t,n={}){return this.runTyped("start-task",{id:t,...ee(n)})}pauseTask(t,n={}){return this.runTyped("pause-task",{id:t,...ee(n)})}closeTask(t,n,o={}){return this.runTyped("close-task",{id:t,reason:n,...ee(o)})}extension(t,n={}){return this.runTyped("extension",{...t===void 0?{}:{target:t},options:n})}extensionList(t={}){return this.extension("list",t)}extensionActivate(t,n={}){return this.runTyped("extension-activate",{target:t,options:n})}extensionDeactivate(t,n={}){return this.runTyped("extension-deactivate",{target:t,options:n})}package(t,n={}){return this.runTyped("package",{...t===void 0?{}:{target:t},options:{...n,vocabulary:"package"}})}packageList(t={}){return this.package("list",t)}packageInstall(t,n={}){return this.runTyped("package-install",{target:t,options:n})}packageUninstall(t,n={}){return this.runTyped("package-uninstall",{target:t,options:n})}packageDoctor(t={}){return this.runTyped("package-doctor",{options:t})}packageManage(t,n={}){return this.runTyped("package-manage",{...t===void 0?{}:{target:t},options:n})}packageDescribe(t,n={}){return this.runTyped("package-describe",{...t===void 0?{}:{target:t},options:n})}packageReload(t={}){return this.runTyped("package-reload",{options:t})}packageCatalog(t={}){return this.runTyped("package-catalog",{options:t})}packageActivate(t,n={}){return this.runTyped("package-activate",{target:t,options:n})}packageDeactivate(t,n={}){return this.runTyped("package-deactivate",{target:t,options:n})}packageMigrate(t={}){return this.package(void 0,{...t,migrate:!0})}upgrade(t,n={}){return this.runTyped("upgrade",{...t===void 0?{}:{target:t},options:n})}};function sx(e={},t={}){return new v(t).context(e)}function ix(e={},t={}){return new v(t).list(e)}function ax(e={},t={}){return new v(t).listAllComplete(e)}function cx(e,t={},n={}){return new v(n).search(e,t)}function dx(e,t={},n={}){return new v(n).get(e,t)}function lx(e={},t={}){return new v(t).next(e)}function mx(e={},t={}){return new v(t).aggregate(e)}function px(e={},t={}){return new v(t).stats(e)}function ux(e={},t={}){return new v(t).duplicates(e)}function fx(e,t={},n={}){return new v(n).comments(e,t)}function _x(e,t={},n={}){return new v(n).notes(e,t)}function hx(e,t={},n={}){return new v(n).learnings(e,t)}function gx(e,t={},n={}){return new v(n).files(e,t)}function yx(e,t={},n={}){return new v(n).filesDiscover(e,t)}function bx(e,t={}){return new v(t).filesLookup(e)}function wx(e,t={},n={}){return new v(n).docs(e,t)}function vx(e,t={},n={}){return new v(n).deps(e,t)}function kx(e,t={},n={},o={}){return new v(o).graph(e,t,n)}function Sx(e,t,n={},o={}){return new v(o).append(e,t,n)}function Ix(e,t={},n={}){return new v(n).init(e,t)}function Ex(e,t,n,o,r={},s={}){return new v(s).config(e,t,n,o,r)}function xx(e,t={},n={}){return new v(n).schema(e,t)}function Rx(e={}){return new v(e).schemaList()}function Ax(e,t={}){return new v(t).schemaShow(e)}function Cx(e,t={},n={}){return new v(n).schemaAddType(e,t)}function Tx(e,t={},n={}){return new v(n).schemaRemoveType(e,t)}function Ox(e,t={},n={}){return new v(n).schemaAddStatus(e,t)}function $x(e,t={},n={}){return new v(n).schemaRemoveStatus(e,t)}function Px(e,t={},n={}){return new v(n).schemaAddField(e,t)}function Fx(e,t={},n={}){return new v(n).schemaRemoveField(e,t)}function Lx(e={}){return new v(e).schemaListFields()}function Mx(e,t={}){return new v(t).schemaShowField(e)}function Dx(e,t={},n={}){return new v(n).schemaApplyPreset(e,t)}function Nx(e={},t={}){return new v(t).schemaInferTypes(e)}function jx(e,t,n,o={}){return new v(o).schemaRenameType(e,t,n)}function Ux(e,t,n,o,r={}){return new v(r).schemaRenameField(e,t,n,o)}function Gx(e,t,n,o={}){return new v(o).schemaRemapStatus(e,t,n)}function qx(e,t={}){return new v(t).schemaShowStatus(e)}function zx(e,t={},n={}){return new v(n).profile(e,t)}function Hx(e={}){return new v(e).profileList()}function Bx(e,t={}){return new v(t).profileShow(e)}function Vx(e,t={},n={}){return new v(n).profileApply(e,t)}function Wx(e,t={}){return new v(t).profileLint(e)}function Kx(e={},t={}){return new v(t).validate(e)}function Yx(e={},t={}){return new v(t).health(e)}function Jx(e={},t={}){return new v(t).gc(e)}function Xx(e,t,n={}){return new v(n).historyRedact(e,t)}function Zx(e,t={},n={}){return new v(n).historyRepair(e,t)}function Qx(e={},t={}){return new v(t).historyRepairAll(e)}function eR(e,t={},n={}){return new v(n).historyCompact(e,t)}function tR(e,t={}){return new v(t).historyCompactBulk(e)}function nR(e={},t={}){return new v(t).create(e)}function oR(e,t={},n={}){return new v(n).update(e,t)}function rR(e,t,n={},o={}){return new v(o).reopen(e,t,n)}function sR(e,t,n={},o={}){return new v(o).close(e,t,n)}function iR(e,t={},n={}){return new v(n).claim(e,t)}function aR(e={},t={}){return new v(t).claimNext(e)}function cR(e,t={},n={}){return new v(n).release(e,t)}function dR(e,t={},n={}){return new v(n).copy(e,t)}function lR(e,t={},n={}){return new v(n).delete(e,t)}function mR(e,t,n={},o={}){return new v(o).restore(e,t,n)}function pR(e,t={},n={}){return new v(n).focus(e,t)}function uR(e,t={},n={}){return new v(n).startTask(e,t)}function fR(e,t={},n={}){return new v(n).pauseTask(e,t)}function _R(e,t,n={},o={}){return new v(o).closeTask(e,t,n)}function hR(e,t={},n={}){return new v(n).extension(e,t)}function gR(e={},t={}){return new v(t).extensionList(e)}function yR(e,t={},n={}){return new v(n).extensionActivate(e,t)}function bR(e,t={},n={}){return new v(n).extensionDeactivate(e,t)}function wR(e,t={},n={}){return new v(n).package(e,t)}function vR(e={},t={}){return new v(t).packageList(e)}function kR(e,t={},n={}){return new v(n).packageInstall(e,t)}function SR(e,t={},n={}){return new v(n).packageUninstall(e,t)}function IR(e={},t={}){return new v(t).packageDoctor(e)}function ER(e,t={},n={}){return new v(n).packageManage(e,t)}function xR(e,t={},n={}){return new v(n).packageDescribe(e,t)}function RR(e={},t={}){return new v(t).packageReload(e)}function AR(e={},t={}){return new v(t).packageCatalog(e)}function CR(e,t={},n={}){return new v(n).packageActivate(e,t)}function TR(e,t={},n={}){return new v(n).packageDeactivate(e,t)}function OR(e,t={},n={}){return new v(n).upgrade(e,t)}function cg(e,t,n){return JSON.stringify([zl.resolve(e),zl.resolve(n??process.cwd()),t.extensions.enabled,t.extensions.disabled,t.extensions.policy])}async function dg(e,t,n){let o=cg(e,t,n);return Dc(o,()=>Kg(e,t,n))}async function $R(e,t={}){let n=await x(e),o=t.extensionRegistrations??(t.noExtensions===!0?null:await dg(e,n,t.cwd)),r=$(n,o),s=N(n.schema),i=yt(n.schema);return{types:[...r.types],statuses:s.definitions.map(a=>a.id),openStatus:s.open_status,closeStatus:s.close_status,canceledStatus:s.canceled_status,fields:Lc(i.definitions),extensionCommands:Mc(o?.commands??[])}}async function PR(e,t={}){let n=typeof e=="string"?{...t,pmRoot:e}:e??t,o={json:!0,quiet:n.quiet??!0,noExtensions:n.noExtensions??!1,noPager:!0,profile:n.profile??!1,path:n.pmRoot};return Po(n,o)}function pe(e,t){let n=b(e,t);if(!n)throw new p(`Missing required argument: ${t}`,64);return n}var Hl=us(),Kl=new ag;function Dn(){Jn(ss()),Xn(is()),Zn(as()),Qn(cs()),eo(ds()),to(ls()),no(ms())}async function Yl(e,t,n,o){return fs(()=>t===void 0?Hl.read(()=>Bl(e,n,o)):Hl.write(()=>mg(t,()=>Bl(e,n,o))))}async function FR(e,t){let n=e.cwd,o=n??process.cwd();return Yl(rn({path:e.path,noExtensions:e.noExtensions}),n,o,()=>Kl.run(!0,t))}async function Bl(e,t,n){let o=I(t,e.path);if(e.noExtensions)return Dn(),Vo({pmRoot:o},()=>n(null));if(!await V(_t(o)))return Dn(),n(null);let r=null,s;try{let i=await x(o),a=await Wn({pmRoot:o,settings:i,cwd:t,noExtensions:!1}),c=await Yn({...a,loaded:a.loaded});s={loadResult:a,activationResult:c},Jn(c.hooks),Xn(c.commands),Zn(c.parsers),Qn(c.preflight),eo(c.services),to(c.renderers),no(c.registrations),r={registrations:c.registrations,commands:c.commands,pmRoot:o,packages:a.loaded}}catch(i){Dn(),console.error("[pm-sdk] extension activation failed; continuing without active extensions:",i)}try{return await Vo({pmRoot:o,packages:r?.packages},()=>n(r))}finally{Dn(),s&&await Kn(s.loadResult,s.activationResult).catch(()=>{})}}async function lg(e,t,n,o,r){if(!r)throw new p(`Unsupported native pm action: ${e}`,u.USAGE);let s=ke(e),a=r.registrations.commands.find(d=>ke(d.action)===s)?.command??r.commands.handlers.find(d=>ke(d.command)===s)?.command;if(!a)throw new p(`Unsupported native pm action: ${e}`,u.USAGE);let c=await gs({command:go(a),args:K(n.args??t.args),options:yo(t,n),global:o,pm_root:r.pmRoot,sdk:zc(r.pmRoot,v.forActiveExtensionHost({pmRoot:r.pmRoot,author:typeof o.author=="string"&&o.author.trim()?o.author.trim():"pm-extension"}))});if(!c.handled){let d=c.warnings.length>0?` (${c.warnings.join(", ")})`:"";throw new p(`Unsupported native pm action: ${e}${d}`,u.USAGE)}return c.result}async function mg(e,t){let n=process.cwd();process.chdir(e);try{return await t()}finally{process.chdir(n)}}var pg=new Set(["activity","aggregate","context","contracts","deps","files-discover","get","graph","health","history","list","next","search","stats","telemetry","validate"]);function ug(e){let t=pe(e,"action"),n=ke(t),o=pt(jo,n),r=o?.action??n,s={...e,action:r};return o?.options!==void 0&&(s.options={...o.options,...Gn(e.options)}),r==="package"&&(s.options={...Gn(s.options),vocabulary:"package"}),{action:r,args:s}}function fg(e){return!pg.has(ke(e))}async function _g(e){let t=ug(e),n=rn(t.args),o=fg(t.action),r=b(t.args,"cwd"),s=r??process.cwd();try{return e[Wl]===!0||Kl.getStore()===!0?await Vl(t.action,t.args,n,null):await Yl(n,r,s,i=>Vl(t.action,t.args,n,i))}finally{o&&No()}}function pt(e,t){return Object.prototype.hasOwnProperty.call(e,t)?e[t]:void 0}function Nn(e){return b(e.args,"target")??b(e.options,"target")}function L(e,t=e.options){return e.id??pe(t,"id")}async function hg(e){let t=Ze("list",e.options);return t.compact===void 0&&t.brief===void 0&&t.full===void 0&&t.fields===void 0&&t.includeBody===void 0&&(t.compact=!0),Mo(await Se(b(e.args,"status")??b(t,"status"),t,e.global),t)}async function gg(e){let t=pe(e.args,"query"),n=Ze("search",e.options,[t]);return n.compact===void 0&&n.full===void 0&&n.fields===void 0&&(n.compact=!0),Mo(await $o(t,n,e.global),n)}async function yg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options);return ae(await xt(o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function bg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options),r={...o,...o.title===void 0&&typeof e.args.title=="string"?{title:e.args.title}:{},...o.message===void 0&&typeof e.args.message=="string"?{message:e.args.message}:{}};return ae(await mr(L(e,r),r,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function wg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options);return ae(await Ie(L(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function vg(e){let t=pn(e.options);return t.add===void 0&&t.stdin===void 0&&t.file===void 0&&t.edit===void 0&&t.delete===void 0&&(t.includeMeta=!0,t.limit===void 0&&t.fullHistory!==!0&&(t.limit="20")),Xc(L(e),t,e.global)}function Jl(e,t){return Qa(gl(e.options,t,re),e.global)}function kg(e){let t=K(e.options.lookupPath);if(t&&t.length>0)return Jl(e,t);let n=L(e);return e.options.discover===!0?ko(n,ho(e.options),e.global):Za(n,sn(e.options),e.global)}function Sg(e){return Rc({subcommand:b(e.args,"subcommand")??b(e.options,"subcommand"),limit:ha(e.args,e.options)},e.global)}function Ig(e){let t={...e.options};return t.brief===void 0&&t.summary===void 0&&t.full===void 0&&(t.summary=!0),Ja(e.global,t)}function Eg(e){let t=b(e.args,"configAction")??b(e.options,"configAction")??b(e.options,"action");if(t===void 0)throw new p("Missing required argument: configAction",64);return uc(b(e.args,"scope")??b(e.options,"scope")??"project",t,b(e.args,"key")??b(e.options,"key"),e.options,e.global,b(e.args,"value")??b(e.options,"value"))}function xg(e){let t=e.options;return la(da(t),e.global)}function Rg(e,t){if(typeof e=="number"){if(!Number.isFinite(e)||!Number.isInteger(e))throw new p(`${t} must be a finite integer.`,64);return e}if(typeof e=="string"&&e.trim().length>0){let n=e.trim();if(!/^[+-]?\d+(?:st|nd|rd|th)?$/i.test(n))throw new p(`${t} must be a finite integer.`,64);let o=Number.parseInt(n,10);if(!Number.isInteger(o))throw new p(`${t} must be a finite integer.`,64);return o}}function Ag(e){let t=b(e.args,"subcommand")??pe(e.options,"subcommand"),n=e.options;return hd({subcommand:t,id:typeof e.id=="string"?e.id:typeof n.id=="string"?n.id:void 0,stepRef:Cg(e),reorderTo:Rg(n.reorderTo??e.args.reorderTo,"plan reorderTo"),options:e.options,global:e.global})}function Cg(e){return typeof e.options.stepRef=="string"?e.options.stepRef:typeof e.args.stepRef=="string"?e.args.stepRef:void 0}function Tg(e){let t=b(e.args,"subcommand")??pe(e.options,"subcommand"),n=e.args.alias??e.options.alias;return{ctx:e,subcommand:t.trim().toLowerCase(),name:b(e.args,"name")??b(e.options,"name"),author:b(e.args,"author")??b(e.options,"author"),force:e.args.force===!0||e.options.force===!0,aliases:n===void 0?void 0:K(n)}}function Og(e){let{ctx:t,subcommand:n,name:o,author:r,force:s}=e,a=pt({list:()=>Fa(t.global),show:()=>La(o,t.global),"show-status":()=>Ma(o,t.global),"list-fields":()=>ja(t.global),"show-field":()=>Ua(o,t.global),"remove-type":()=>Ta(o,{author:r,force:s},t.global),"remove-field":()=>Na(o,{author:r,force:s},t.global),"remove-status":()=>Pa(o,{author:r,force:s},t.global),"apply-preset":()=>Ga(b(t.args,"typePreset")??b(t.options,"typePreset"),{author:r,force:s},t.global)},n);return a?a():null}function $g(e){let{ctx:t,name:n,author:o,force:r,aliases:s}=e,i=t.args.commands??t.options.commands,a=t.args.requiredTypes??t.options.requiredTypes;return Da(n,{type:b(t.args,"fieldType")??b(t.options,"fieldType"),commands:i===void 0?void 0:K(i),description:b(t.args,"description")??b(t.options,"description"),cliFlag:b(t.args,"cliFlag")??b(t.options,"cliFlag"),alias:s,required:t.args.required===!0||t.options.required===!0,requiredOnCreate:t.args.requiredOnCreate===!0||t.options.requiredOnCreate===!0,allowUnset:!(t.args.allowUnset===!1||t.options.allowUnset===!1),requiredTypes:a===void 0?void 0:K(a),author:o,force:r},t.global)}function Pg(e){let{ctx:t,name:n,author:o,force:r,aliases:s}=e,i=t.args.role??t.options.role;return $a(n,{role:i===void 0?void 0:K(i),alias:s,description:b(t.args,"description")??b(t.options,"description"),order:re(t.args.order??t.options.order,"schema add-status order"),author:o,force:r},t.global)}function Fg(e){let{ctx:t,name:n,author:o,force:r,aliases:s}=e;return Ca(n,{description:b(t.args,"description")??b(t.options,"description"),defaultStatus:b(t.args,"defaultStatus")??b(t.args,"default_status")??b(t.options,"defaultStatus")??b(t.options,"default_status"),folder:b(t.args,"folder")??b(t.options,"folder"),alias:s,author:o,force:r},t.global)}function Lg(e){let{ctx:t,subcommand:n,name:o,author:r,force:s}=e,i=b(t.args,"to")??pe(t.options,"to"),a=b(t.args,"migrationId")??b(t.args,"migration_id")??b(t.options,"migrationId")??b(t.options,"migration_id"),c=b(t.args,"fieldTypeScope")??b(t.options,"fieldTypeScope")??b(t.args,"type")??b(t.options,"type"),d=n==="rename-type"?{kind:"rename-type",from:o??"",to:i}:n==="rename-field"?{kind:"rename-field",from:o??"",to:i,...c===void 0?{}:{type:c}}:{kind:"remap-status",from:o??"",to:i};return Ra(d,{migrationId:a,dryRun:t.args.dryRun===!0||t.options.dryRun===!0,author:r,force:s},t.global)}function Mg(e){let t=Tg(e),n=Og(t);if(n!==null)return n;if(t.subcommand==="rename-type"||t.subcommand==="rename-field"||t.subcommand==="remap-status")return Lg(t);if(t.subcommand==="add-field")return $g(t);if(t.subcommand==="add-status")return Pg(t);if(t.subcommand==="add-type")return e.args.infer===!0||e.options.infer===!0?qa({minCount:re(e.args.minCount??e.options.minCount,"schema infer minCount"),apply:e.args.apply===!0||e.options.apply===!0,author:t.author,force:t.force},e.global):Fg(t);throw ue({command_path:"schema",token:t.subcommand,allowed:Aa,exit_code:64})}function Dg(e){let t=b(e.args,"subcommand")??pe(e.options,"subcommand"),n=t.trim().toLowerCase(),o=b(e.args,"name")??b(e.options,"name"),s=pt({list:()=>nl(),show:()=>ol(o),lint:()=>rl(o),apply:()=>sl(o,{dryRun:e.args.dryRun===!0||e.options.dryRun===!0,author:b(e.args,"author")??b(e.options,"author"),force:e.args.force===!0||e.options.force===!0},e.global)},n);if(!s)throw ue({command_path:"profile",token:t,allowed:tl,exit_code:64});return s()}async function Ng(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options);return ae(await Vc(L(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function jg(e){let{changedFields:t,runnerOptions:n}=se(e.args,e.options);return ae(await rd(wo(n),e.global),{changedFields:t})}async function Ug(e){let{changedFields:t,runnerOptions:n}=se(e.args,e.options),o=b(e.args,"reason"),r=o!==void 0&&n.reason===void 0?{...n,reason:o}:{...n};return e.force&&r.force===void 0&&(r.force=!0),ae(await Jc(bo(r),e.global),{changedFields:t})}async function Gg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=se(e.args,e.options),r=b(o,"target")??pe(e.args,"target");return ae(await Ge(L(e,o),r,o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function Xl(e){let t={...e};return delete t.assignee,t}async function qg(e){let t=I(process.cwd(),e.global.path),n=await x(t),o=hn(N(n.schema)),r=L(e),s=await Ro(r,e.force,e.global,e.options),i=await Ie(r,{...Xl(e.options),status:o,force:e.force},e.global);return{id:r,action:"start_task",claim:s,update:i}}async function zg(e){let t=I(process.cwd(),e.global.path),n=await x(t),o=L(e),r=N(n.schema).open_status,s=await Ie(o,{...Xl(e.options),status:r,force:e.force},e.global),i=await fn(o,e.force,e.global,e.options);return{id:o,action:"pause_task",update:s,release:i}}async function Hg(e){let t=L(e),n=b(e.args,"reason")??b(e.args,"text")??b(e.options,"reason")??b(e.options,"text"),o=await Ne(t,n,{...e.options,force:e.force},e.global),r=await fn(t,e.force,e.global,e.options);return{id:t,action:"close_task",close:o,release:r}}function Bg(e){let t={...e.args,...e.options};return pa(pe(t,"subcommand"),b(t,"id")??e.id,b(t,"target"),ba(t),e.global)}function Vg(e){return va(I(process.cwd(),e.global.path),{...e.args,...e.options})}var Zl={init:e=>fc(b(e.args,"prefix"),e.global,e.options),context:e=>Eo(Ze("context",e.options),e.global),next:e=>xo(Ze("next",e.options),e.global),eval:$d,events:Pd,merge:Fd,workspace:Ld,meet:Rn,event:Rn,remind:Rn,list:hg,get:e=>{let t=L(e);return Oo(t,e.global,Ze("get",e.options,[t]))},search:gg,duplicates:e=>{let t=typeof e.options.status=="string"?[e.options.status]:K(e.options.status);return Lo(e.global,{...t.length===0?{}:{status:t},since:b(e.options,"since"),threshold:typeof e.options.threshold=="number"?e.options.threshold:void 0,limit:e.options.limit==="default"?void 0:re(e.options.limit,"limit")})},create:yg,copy:bg,focus:e=>ur(e.id,{clear:e.options.clear===!0||e.args.clear===!0},e.global),update:wg,"item-reopen":hl,restore:Gg,claim:e=>e.options.next===!0||e.args.next===!0?rc(e.force,e.global,{...e.options,...e.args},{...e.options,...e.args}):Ro(L(e),e.force,e.global,e.options),release:e=>fn(L(e),e.force,e.global,e.options),"start-task":qg,"pause-task":zg,"close-task":Hg,close:_l,comments:vg,notes:e=>Qc(L(e),pn(e.options),e.global),learnings:e=>Zc(L(e),pn(e.options),e.global),files:kg,docs:e=>Xa(L(e),sn(e.options),e.global),test:e=>Ac(L(e),e.options,e.global),"test-all":e=>Cc(e.options,e.global),telemetry:Sg,validate:e=>mn(e.options,e.global,{runUpdate:(t,n,o)=>Ie(t,n,o)}),health:Ig,assurance:e=>ec(e.args,e.options,e.global),contracts:e=>Po(e.options,e.global),config:Eg,activity:xg,aggregate:e=>So(e.options,e.global),extension:e=>ln(Nn(e),e.options,e.global),package:e=>ln(Nn(e),e.options,e.global),install:e=>ln(Nn(e),{...e.options,install:!0},e.global),upgrade:e=>dc(Nn(e),e.options,e.global),delete:e=>pr(L(e),e.options,e.global),deps:e=>ma(L(e),e.options,e.global),graph:Bg,"files-discover":e=>ko(L(e),e.options,e.global),"files-lookup":e=>Jl(e,K(e.options.paths)),history:e=>sc(L(e),e.options,e.global),"history-redact":e=>sa(L(e),e.options,e.global),"history-repair":ml,"history-compact":pl,"history-author-acknowledge":Vg,plan:Ag,schema:Mg,profile:Dg,stats:e=>Fo(e.global,yl(e.options)),append:Ng,"update-many":jg,"close-many":Ug,gc:e=>lc(e.global,e.options)};function LR(e=Ps){return e.map(t=>{let n=ke(t),o=pt(jo,n),r=o?.action??n,s=pt(Zl,r)!==void 0;return{action:t,resolved_action:r,covered:s,route:s?o?"alias":"native":"missing"}})}async function Vl(e,t,n,o){let r=_o(t,e);Fs(e,r),Ls(e,r);let s={action:e,args:t,options:r,id:b(t,"id"),force:t.force===!0||r.force===!0,global:n,activeExtensions:o},i=pt(Zl,e),a=i?await i(s):await lg(e,t,r,n,o);return r.resolvedOutputFormat="json",Ds(e,r,a)}var Wg={closeManyOptionsFromFlat:bo,extensionOptionsFromArgs:yo,globalOptions:rn,mutationListOptions:ya,normalizeActionName:ke,normalizeCommandPath:go,normalizeMcpUpdateOptions:wa,normalizeMcpOptionsArrays:ga,optionsWithAuthor:_o,readRequiredString:pe,readScalarString:fa,readScalarStringAllowBlank:_a,readStringArray:K,updateManyOptionsFromFlat:wo,withAddNoteOption:sn,withFilesDiscoveryOptions:ho,withMutationCompaction:se};(process.env.NODE_ENV==="test"||process.env.VITEST!==void 0||process.env.VITEST_WORKER_ID!==void 0)&&(globalThis.__pmCliActionRunnerTestHooks=Wg);async function Kg(e,t,n){let o=await Wn({pmRoot:e,settings:t,cwd:n??process.cwd(),noExtensions:!1}),r=await Yn(o);try{return r.registrations}finally{try{await Kn(o,r)}catch{}}}export{jc as a,pm as b,Uo as c,At as d,vn as e,zc as f,ty as g,ny as h,oy as i,ry as j,sy as k,Oc as l,iy as m,tm as n,om as o,gn as p,Do as q,Fc as r,yn as s,cm as t,No as u,Bo as v,Hc as w,Sm as x,Em as y,xm as z,Vo as A,Vc as B,Ge as C,Jc as D,Xc as E,Zc as F,Qc as G,rd as H,Hp as I,sd as J,or as K,hd as L,mr as M,pr as N,ur as O,yd as P,bd as Q,Gu as R,qu as S,kd as T,Id as U,Ed as V,xd as W,nf as X,Ct as Y,Td as Z,xn as _,Od as $,at as aa,kr as ba,df as ca,sv as da,iv as ea,Er as fa,Dd as ga,kv as ha,Sv as ia,jd as ja,qd as ka,qv as la,xf as ma,$r as na,Af as oa,Cf as pa,tl as qa,nl as ra,ol as sa,rl as ta,sl as ua,uk as va,fk as wa,_k as xa,hk as ya,Pr as za,Yf as Aa,dl as Ba,ll as Ca,Fr as Da,t_ as Ea,n_ as Fa,o_ as Ga,q as Ha,r_ as Ia,s_ as Ja,i_ as Ka,a_ as La,Mr as Ma,bl as Na,dt as Oa,Lr as Pa,wl as Qa,c_ as Ra,vl as Sa,d_ as Ta,l_ as Ua,m_ as Va,p_ as Wa,u_ as Xa,w_ as Ya,El as Za,v_ as _a,A_ as $a,L_ as ab,D_ as bb,Lh as cb,ig as db,v as eb,sx as fb,ix as gb,ax as hb,cx as ib,dx as jb,lx as kb,mx as lb,px as mb,ux as nb,fx as ob,_x as pb,hx as qb,gx as rb,yx as sb,bx as tb,wx as ub,vx as vb,kx as wb,Sx as xb,Ix as yb,Ex as zb,xx as Ab,Rx as Bb,Ax as Cb,Cx as Db,Tx as Eb,Ox as Fb,$x as Gb,Px as Hb,Fx as Ib,Lx as Jb,Mx as Kb,Dx as Lb,Nx as Mb,jx as Nb,Ux as Ob,Gx as Pb,qx as Qb,zx as Rb,Hx as Sb,Bx as Tb,Vx as Ub,Wx as Vb,Kx as Wb,Yx as Xb,Jx as Yb,Xx as Zb,Zx as _b,Qx as $b,eR as ac,tR as bc,nR as cc,oR as dc,rR as ec,sR as fc,iR as gc,aR as hc,cR as ic,dR as jc,lR as kc,mR as lc,pR as mc,uR as nc,fR as oc,_R as pc,hR as qc,gR as rc,yR as sc,bR as tc,wR as uc,vR as vc,kR as wc,SR as xc,IR as yc,ER as zc,xR as Ac,RR as Bc,AR as Cc,CR as Dc,TR as Ec,OR as Fc,$R as Gc,PR as Hc,pe as Ic,FR as Jc,_g as Kc,LR as Lc};
+//# sourceMappingURL=chunk-BKYB45NQ.js.map