@unbrained/pm-cli 2026.9.6 → 2026.9.8

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

@@ -0,0 +1,2202 @@
+import{a as Qa,b as Ve,c as tn,d as tc,e as nc,h as oc}from"./chunk-KR3RP4FH.js";import{D as yo,F as ic,G as yc,I as bc,K as vc,L as wc,a as vt,b as co,d as Oe,e as Ka,k as go}from"./chunk-3BZZA6A3.js";import{$ as ro,Ac as fc,Bc as _c,Bd as vo,Cd as wo,Dc as hc,Eb as xe,Ec as gc,Ed as Ec,F as gt,G as h,H as Yi,Hc as nn,I as Ji,Jc as kc,K as J,L as Xi,Ld as Ac,M as qt,Ma as Ga,Mb as $e,Md as Rc,N as Zi,Na as io,Nb as fo,O as eo,P as zt,Pa as qa,Pb as Ya,Q as to,Qa as za,R as Ae,Ra as ao,Rc as Sc,S as Qi,T as no,Tc as Ic,U as z,Ub as _o,V as oo,W as B,X as ea,Y as ta,Z as so,_ as na,bb as Jt,ha as oa,ib as Ha,id as bo,ja as Da,jb as Xt,kb as Ba,kc as wt,lc as ho,ma as Na,mb as He,mc as Ja,na as ja,nb as Va,nc as Xa,ob as lo,oc as be,pb as Zt,pc as Za,rb as Be,rc as ec,sa as bt,sc as cc,tc as lc,uc as dc,vb as Qt,wb as Wa,xb as en,xc as mc,yc as pc,zc as uc}from"./chunk-QOEKOECV.js";import{A as Ht,Aa,B as aa,C as Ce,D as ca,E as Bt,F as la,G as Vt,J as da,Ka as Wt,L as ma,M as pa,N as ua,O as fa,Oa as sc,P as _a,Q as ha,R as ga,Ra as rc,S as ya,T as ba,U as va,V as wa,W as ka,X as Sa,Y as Ia,Z as Ea,b as Hi,q as sa,ta as yt,w as ra,y as Re,z as ia}from"./chunk-FLDWYEND.js";import{Fa as Ki,Gc as mo,Oa as Ra,Pa as Ca,Qa as Ta,Ta as xa,Ua as Oa,Ub as ce,Va as $a,Wa as Pa,Ya as Te,Za as Fa,_ as Wi,_a as La,_c as po,bb as Kt,db as Ma,dd as uo,gd as ac,hb as ye,ib as Ua,j as qi,jb as Yt,l as zi,y as Bi,z as Vi}from"./chunk-XOD2PCB6.js";import{$ as Us,$b as Js,$d as Ee,$m as Di,Ad as Ft,Ai as Mr,Bj as Kn,Bl as li,Bm as ki,Cc as Zs,Cd as pr,Dd as ur,Di as ie,Dl as di,Eb as Pt,Ec as Ln,Ed as fr,El as Ut,Fc as Mn,Fj as Yr,Fl as mi,Gc as Dn,Gi as Dr,Gj as Jr,Hc as Nn,Hd as Ue,Hh as pt,Hi as Nr,Hj as Xr,Hk as ii,Hm as Si,I as u,Ic as jn,Id as Se,Ig as Tr,Ih as ut,Ij as Zr,Ik as ai,Im as Ii,Jb as Ne,Jc as Un,Jd as _r,Ji as Dt,Jj as Qr,Jm as Ei,K as m,Ka as Rn,Kc as Gn,Kd as hr,Ke as Hn,La as Cn,Lc as T,Ld as Ie,Le as C,Lg as xr,Li as jr,Lj as ei,Ll as pi,M as js,Ma as Tn,Md as gr,Me as Q,Mj as ti,Mm as Ai,N as he,Na as xn,Nj as ni,Od as j,Oj as ht,Pb as zs,Pj as oi,Pl as ui,Qb as Hs,Qc as Qs,Qd as dt,Qj as jt,Qm as Ri,Rb as Bs,Rc as er,Rd as yr,Rj as si,Rm as Ci,Sb as Vs,Si as Ur,Sj as Yn,Sk as ci,Sm as Ti,T as En,Tb as Ws,Tf as Ar,Tj as Jn,Tl as fi,Tm as xi,Ub as Ks,Uc as q,Ud as br,Uf as Rr,Uj as ri,Ul as _i,Um as Oi,Vb as Ys,Vi as E,Wa as $,Wg as Or,Wi as Gr,Wl as hi,Wm as $i,X as S,Xa as $t,Xe as Y,Xf as Cr,Xi as qr,Xm as Pi,Yc as tr,Ye as Mt,Yi as zr,Ym as Fi,Zc as nr,Zl as gi,Zm as Li,_b as at,_m as Mi,b as ot,ba as Gs,be as Ge,ca as Ct,cb as I,cd as je,ch as $r,cn as Ni,d as $s,da as Tt,dn as Gt,ea as xt,en as ji,fa as Ot,fb as it,fe as Lt,fh as qe,fi as ze,fj as Hr,fn as Ui,gb as On,gd as or,ge as mt,hd as sr,he as zn,hj as Br,i as _e,ib as ke,ij as Vr,j as De,jh as Pr,jn as Qn,k as In,ka as re,kd as ct,kj as Wr,kn as A,l as se,ld as rr,li as Bn,lj as O,m as te,md as ir,mi as Vn,mj as ae,n as st,nd as ar,nj as ge,nm as yi,o as Ps,od as cr,qj as ft,qm as bi,ra as qs,rm as vi,s as Fs,sa as rt,sc as $n,se as vr,sf as Sr,si as Fr,t as Ls,tc as Pn,td as qn,te as wr,tj as Nt,u as Ms,ua as An,uc as Fn,ud as lr,ue as kr,v as Ds,vd as lt,vf as Ir,vk as Xn,wc as Xs,wi as Lr,wj as _t,xd as dr,xj as Kr,xk as Zn,y as Ns,yd as mr,yf as Er,yn as Gi,zj as Wn,zm as wi}from"./chunk-AMRDVX36.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]="cde4f476-6821-53be-b70e-62794fa2ae52")}catch{}})();var cg=Ps,lg=Fs,dg=Ds,mg=Ls,pg=Ms;function Cc(e,t,n,o){let s=e.flag.slice(2).replace(/[-_]([a-z])/gu,(i,a)=>a.toUpperCase()),r=n.has(s);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:r?"string":"boolean",...r?{value_name:e.value_name??"value"}:{}}}function Tc(e,t=[]){let n=new Set(t.flatMap(s=>s.keys)),o=[];for(let s of li(e.map(r=>({...r})))){o.push(Cc(s,s.flag,n,s.short));for(let r of s.aliases??[])o.push(Cc(s,r,n))}return o}var ug=Tc(Ut,ii),qd=Tc(Gt,ai);import{AsyncLocalStorage as hh}from"node:async_hooks";import $d from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="176b4ac2-2c47-50d6-beee-62e1d3dc9281")}catch{}})();function xc(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function zd(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 ko(e,t){let n=zd(t),o=n==="brief"?n:xc(e.projection)&&typeof e.projection.mode=="string"?e.projection.mode:n;return{...e,query_summary:{filters:xc(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]="3046466c-614c-5e2b-a156-df96fba8c483")}catch{}})();async function Oc(e,t){let n=I(t??process.cwd(),e),o=await E(n);return ft(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]="f6e02611-4b44-5aa3-b762-9fd984aa12bc")}catch{}})();var Hd=["invalid_envelope","source_incomplete","source_unchecked","filtered_corpus","terminal_items_excluded","strict_read_unproven","page_incomplete","count_mismatch","projection_incomplete","field_omission","omission_receipt_missing","omission_receipt_invalid","read_output_missing","read_output_invalid","read_output_dimensions_incomplete","budget_compaction","budget_omission","session_projection","invalid_item_id","duplicate_item_id"],on=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 --output-include full --strict-read --no-truncate --output-budget unbounded --output-limit unbounded --json",sdk:"await client.listAllComplete()"}}}};function So(e={}){return{excludeTerminal:!1,full:!0,...e.includeBody===void 0?{}:{includeBody:e.includeBody},noTruncate:!0,outputBudget:"unbounded",outputLimit:"unbounded",strictRead:!0}}function le(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function P(e,t,n,o){t&&e.push({code:n,message:o})}function Bd(e,t){let n=le(e.completeness)?e.completeness:{};P(t,n.status==="partial","source_incomplete","The source scan reported unreadable tracker artifacts."),P(t,n.status!=="complete"&&n.status!=="partial","source_unchecked","The source scan did not prove completeness.");let o=n.unreadable_item_count,s=n.unreadable_directory_count;P(t,n.status==="complete"&&(o!==0||s!==0)&&Number.isSafeInteger(o)&&Number.isSafeInteger(s),"source_incomplete","The source scan reports unreadable tracker artifacts despite a complete status."),P(t,n.status==="complete"&&(!Number.isSafeInteger(o)||!Number.isSafeInteger(s)||Number(o)<0||Number(s)<0),"source_unchecked","The source scan did not report safe non-negative unreadable counts.");let r=le(e.filters)?e.filters:{},i=le(r.runtime_filters)?r.runtime_filters:{},a=new Set(["exclude_terminal","include_body","no_truncate","runtime_filters","status","strict_read"]);return P(t,r.status!=="all"||Object.keys(i).length>0||Object.keys(r).some(c=>!a.has(c)),"filtered_corpus","The list did not explicitly select every lifecycle status."),P(t,r.exclude_terminal===!0,"terminal_items_excluded","Terminal lifecycle states were explicitly excluded."),P(t,r.strict_read!==!0,"strict_read_unproven","The result does not echo strict source-read enforcement."),r}function Vd(e,t,n){P(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."),P(n,e.count!==e.items.length||e.total!==e.items.length,"count_mismatch","Envelope counts do not equal the returned item count.");let o=le(e.projection)?e.projection:{};P(n,o.mode!=="full"||o.fields!==null,"projection_incomplete","The result is not the full metadata projection.");let s=le(e.omission_receipt)?e.omission_receipt:void 0;P(n,s===void 0,"omission_receipt_missing","The result carries no field-omission receipt."),P(n,s!==void 0&&(s.has_omissions!==!1||s.omitted_field_group_count!==0||!Number.isSafeInteger(s.omitted_field_group_count)||!Array.isArray(s.omitted_field_groups)||s.omitted_field_groups.length!==0),"omission_receipt_invalid","The field-omission receipt is malformed or contradicts its no-omission claim."),P(n,s?.has_omissions===!0,"field_omission","The omission receipt reports withheld field groups.")}function Wd(e){return e.contract_version!==1||e.command!=="list"||e.within_budget!==!0||e.strings_compacted!==!1||e.rows_compacted!==!1||e.result_omitted!==!1}function Kd(e){if(!Array.isArray(e.requested_dimensions))return!1;let t=new Set(e.requested_dimensions);return["include","amount","cost"].every(n=>t.has(n))}function Yd(e,t){let n=le(e.read_output)?e.read_output:void 0;P(t,n===void 0,"read_output_missing","The result carries no universal read-output receipt."),P(t,n!==void 0&&Wd(n),"read_output_invalid","The universal read-output receipt does not prove an intact list result."),P(t,n!==void 0&&!Kd(n),"read_output_dimensions_incomplete","The universal read-output receipt does not prove full, unbounded include, amount, and cost dimensions."),P(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=le(e.output_budget_exceeded)?e.output_budget_exceeded:void 0;P(t,n?.result_omitted===!0||o?.omitted_result===!0,"budget_omission","Universal output shaping omitted the useful result."),P(t,e.read_session!==void 0,"session_projection","A cross-call read session can suppress previously served facts.")}function Jd(e,t){let n=e.map(o=>le(o)&&typeof o.id=="string"?o.id.trim():"");P(t,n.some(o=>o.length===0),"invalid_item_id","Every full item row must carry a non-empty string id."),P(t,new Set(n).size!==n.length,"duplicate_item_id","Every item id must occur exactly once.")}function $c(e){if(!le(e)||!Array.isArray(e.items))return{ok:!1,findings:[{code:Hd[0],message:"The result must be an object with an items array."}]};let t=e,n=[],o=Bd(t,n);return Vd(t,o,n),Yd(t,n),Jd(t.items,n),{ok:n.length===0,findings:n}}function sn(e){let t=$c(e);if(!t.ok)throw new on(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 Xd(e){sn(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]="0c84b11c-502f-5c33-a757-5757402357b4")}catch{}})();function Pc(e){return e.map(t=>({key:t.key,optionName:yr(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 Fc(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",family:t.family??"extensions"}))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="e8137f8b-745a-5ef5-9e7e-14b7d032c1ea")}catch{}})();var Zd=50,ve=new Map;function Io(){ve.clear()}function Lc(e,t){let n=ve.get(e);if(n!==void 0)return n;if(ve.size>=Zd){let s=ve.keys().next().value;ve.delete(s)}let o=t().catch(s=>{throw ve.get(e)===o&&ve.delete(e),s});return ve.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]="0c7a926a-46a2-560c-ae95-33b92b8c820e")}catch{}})();var Qd={"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 Mc(e){return Object.fromEntries(Ar.map(t=>[`${e}-${t}`,{action:e,options:{[t==="adopt-all"?"adoptAll":t]:!0,...e==="package"?{vocabulary:"package"}:{}}}]))}var Eo={ctx:{action:"context"},...Qd,...Mc("extension"),...Mc("package"),...Object.fromEntries(Rr.map(e=>[`package-${e}`,{action: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]="9133d39d-b2fb-5f99-8fd3-87a7d2f8df6d")}catch{}})();var Dc="PmCliError";function em(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 tm(e,t={}){if(typeof e!="string"||e.trim().length===0)throw new TypeError("createPmCliExpectedError message must be a non-empty string");let n=new m(e,em(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 Ao(e){if(!(e instanceof Error)||e.name!==Dc)return!1;let t=e;return typeof t.exitCode=="number"&&Number.isFinite(t.exitCode)}import{constants as kt}from"node:fs";import{lstat as Nc,mkdir as Co,open as jc}from"node:fs/promises";import de from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="e57a9bca-1190-5ffd-bb7d-d76a22fc9e57")}catch{}})();function Ro(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Relationship event ${t} must be non-empty`);return e.trim()}function To(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 nm(e){return Object.freeze({...e,...e.payload===void 0?{}:{payload:Object.freeze(structuredClone(e.payload))}})}function om(e,t,n,o){let s=n.require(e.kind),r=o.outgoingOne.get(`${s.kind}\0${e.source}`);if(r!==void 0&&r!==t)throw new TypeError(`Relationship outgoing cardinality exceeded for ${s.kind}`);let i=o.incomingOne.get(`${s.kind}\0${e.target}`);if(i!==void 0&&i!==t)throw new TypeError(`Relationship incoming cardinality exceeded for ${s.kind}`);let a=To(e,n),c=o.identities.get(a);if(c!==void 0&&c!==t)throw new TypeError(`Relationship edge already active: ${a}`)}function sm(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 rm(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=Ro(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:Ro(e.relationshipId,"relationshipId"),author:Ro(e.author,"author"),timestamp:new Date(e.timestamp).toISOString()}}function im(e,t,n,o,s,r){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 l=new Ne([a,c],[e.edge],s).edges()[0];return om(l,t,s,r),nm(l)}var St=class{#t;#n;#o=[];#r=new Set;#e=new Map;#s={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??Pt()}get version(){return this.#o.length}events(){return Object.freeze([...this.#o])}*stream(t={}){let n=t.fromVersion??1,o=t.toVersion??this.version,s=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(s)||s<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 r=n-1;r<o;r+=s)yield Object.freeze(this.#o.slice(r,Math.min(r+s,o)))}project(t,n,o={}){if(typeof n!="function")throw new TypeError("Relationship event projection requires a reducer");let s=t,r=0,i;for(let a of this.stream({...o,batchSize:256}))for(let c of a)s=n(s,c),r+=1,i=c;return Object.freeze({state:s,version:i?.sequence??Math.max(0,(o.fromVersion??1)-1),processed:r,...i===void 0?{}:{asOf:i.timestamp}})}#i(t,n){let o=this.#n.require(n.kind);this.#s.identities.set(To(n,this.#n),t),o.outgoing==="one"&&this.#s.outgoingOne.set(`${o.kind}\0${n.source}`,t),o.incoming==="one"&&this.#s.incomingOne.set(`${o.kind}\0${n.target}`,t)}#a(t){let n=this.#n.require(t.kind);this.#s.identities.delete(To(t,this.#n)),n.outgoing==="one"&&this.#s.outgoingOne.delete(`${n.kind}\0${t.source}`),n.incoming==="one"&&this.#s.incomingOne.delete(`${n.kind}\0${t.target}`)}append(t){let n=rm(t,this.version,this.#r),o=this.#e.get(n.relationshipId),s=im(t,n.relationshipId,this.#e,this.#t,this.#n,this.#s),r=Object.freeze({eventId:n.eventId,relationshipId:n.relationshipId,action:t.action,...s===void 0?{}:{edge:s},author:n.author,timestamp:n.timestamp,...t.reason?.trim()?{reason:t.reason.trim()}:{},sequence:this.version+1});return this.#o.push(r),this.#r.add(n.eventId),o&&this.#a(o),t.action==="remove"?this.#e.delete(n.relationshipId):(this.#e.set(n.relationshipId,s),this.#i(n.relationshipId,s)),r}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 r=Date.parse(t.atTimestamp);if(!Number.isFinite(r))throw new TypeError("Relationship snapshot timestamp must be valid");n=this.#o.filter(i=>Date.parse(i.timestamp)<=r)}else{let r=t.atVersion??this.version;if(!Number.isInteger(r)||r<0||r>this.version)throw new TypeError(`Relationship snapshot version out of range: ${r}`);n=this.#o.slice(0,r)}let o=sm(n),s=new Ne(this.#t,o.values(),this.#n);return Object.freeze({version:n.at(-1)?.sequence??0,...n.at(-1)?{asOf:n.at(-1).timestamp}:{},edges:s.edges(),graph:s})}page(t){if(!Number.isInteger(t.limit)||t.limit<1)throw new TypeError("Relationship event page limit must be positive");let n=Sr("relationship-events",{order:"append-sequence"}),o=t.cursor===void 0?this.version:Number(Ir(t.cursor,n).snapshot);if(!Number.isSafeInteger(o)||o<0||o>this.version)throw new TypeError("Relationship event cursor snapshot version is invalid");let s=Er(this.#o.slice(0,o),{cursor:t.cursor,fingerprint:n,limit:t.limit,readId:r=>r.eventId,snapshot:String(o)});return{version:o,events:s.rows,hasMore:s.has_more,...s.next_cursor?{nextCursor:s.next_cursor}:{}}}},am="relationship-event-store",Uc=kt.O_NOFOLLOW;function rn(e){return Q(e,am,30,`relationship-store:${process.pid}`,!1,!1,3e3)}async function Pe(e,t="relationships/events.jsonl"){let n=de.resolve(e),o=de.resolve(n,t),s=de.relative(n,o);if(s.length===0)throw new TypeError("Relationship event path must name a file within the tracker root");if(s===".."||s.startsWith(`..${de.sep}`)||de.isAbsolute(s))throw new TypeError("Relationship event path must stay within the tracker root");if(await Co(n,{recursive:!0}),(await Nc(n)).isSymbolicLink())throw new TypeError("Relationship event tracker root must not be a symbolic link");let i=n;for(let a of s.split(de.sep)){i=de.join(i,a);try{if((await Nc(i)).isSymbolicLink())throw new TypeError("Relationship event path must not contain symbolic links")}catch(c){if(In(c))break;throw c}}return o}async function an(e,t,n){let o=new St(t,{registry:n}),s,r;try{r=await jc(e,kt.O_RDONLY|Uc),s=await r.readFile("utf8")}catch(a){if(In(a))return{log:o,raw:""};throw a}finally{await r?.close()}let i=s.split(`
+`);for(let a=0;a<i.length;a+=1){let c=i[a].trim();if(!c)continue;let l;try{l=JSON.parse(c)}catch{throw new TypeError(`Invalid relationship event JSONL at line ${a+1}`)}if(l.sequence!==o.version+1)throw new TypeError(`Invalid relationship event sequence at line ${a+1}`);o.append({eventId:l.eventId,relationshipId:l.relationshipId,action:l.action,...l.edge===void 0?{}:{edge:l.edge},author:l.author,timestamp:l.timestamp,...l.reason===void 0?{}:{reason:l.reason},expectedVersion:o.version})}return{log:o,raw:s}}function cm(e,t,n,o){let s=Date.parse(t.timestamp),r;return t.action!=="remove"&&t.edge!==void 0&&(r=new Ne(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(s)&&e.timestamp===new Date(s).toISOString()&&e.reason===(t.reason?.trim()||void 0)&&at(e.edge)===at(r)}var cn=class e{#t;#n;#o;#r;#e;constructor(t,n,o,s){this.#t=t.pmRoot,this.#n=n,this.#o=t.registry,this.#r=o,this.#e=s}static async open(t){let n=Object.freeze([...t.nodes]),o=await Pe(t.pmRoot,t.relativePath),s=await rn(t.pmRoot);try{await Pe(t.pmRoot,o);let{log:r}=await an(o,n,t.registry);return new e(t,n,o,r)}finally{await s()}}get path(){return this.#r}async currentVersion(){return this.#e=await this.#s(),this.#e.version}async append(t){let n=await rn(this.#t);try{let o=await Pe(this.#t,this.#r),{log:s}=await an(o,this.#n,this.#o),r=s.append(t);await Co(de.dirname(o),{recursive:!0}),await Pe(this.#t,o);let i=await jc(o,kt.O_APPEND|kt.O_CREAT|kt.O_WRONLY|Uc);try{await i.appendFile(`${JSON.stringify(r)}
+`,"utf8")}finally{await i.close()}return this.#e=s,r}finally{await n()}}async appendBatch(t,n={}){let o=await rn(this.#t);try{let s=await Pe(this.#t,this.#r),{log:r,raw:i}=await an(s,this.#n,this.#o),a=r.version,c=new Map(r.events().map(p=>[p.eventId,p])),l=[],d=[];for(let p of t){let f=p.eventId.trim(),g=c.get(f);if(g!==void 0){if(n.existingEventPolicy==="skip_identical"&&cm(g,p,this.#n,this.#o)){d.push(g.eventId);continue}if(n.existingEventPolicy==="skip_identical")throw new TypeError(`Relationship event id collision with different content: ${f}`)}let v=r.append(p);c.set(v.eventId,v),l.push(v)}if(l.length>0){let p=i.length===0||i.endsWith(`
+`)?i:`${i}
+`;await Co(de.dirname(s),{recursive:!0}),await Pe(this.#t,s),await te(s,`${p}${l.map(f=>JSON.stringify(f)).join(`
+`)}
+`)}return this.#e=r,Object.freeze({version_before:a,version_after:r.version,appended:Object.freeze(l),skipped_event_ids:Object.freeze(d)})}finally{await o()}}async snapshot(t={}){return this.#e=await this.#s(),this.#e.snapshot(t)}async page(t){return this.#e=await this.#s(),this.#e.page(t)}async*stream(t={}){this.#e=await this.#s(),yield*this.#e.stream(t)}async project(t,n,o={}){return this.#e=await this.#s(),this.#e.project(t,n,o)}async#s(){let t=await rn(this.#t);try{let n=await Pe(this.#t,this.#r);return(await an(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]="3113ad4b-282a-50af-a836-8e9abfde7d7e")}catch{}})();function xo(e){let t=Pt();for(let n of e)t.register(n);return t}function Gc(e,t){return{client:t,isItemNotFoundError:n=>Ao(n)&&n.exitCode===u.NOT_FOUND,getItemAt:(n,o)=>qi(n,o,{pmRoot:e}),openRelationshipEventStore:n=>cn.open({pmRoot:e,nodes:n.nodes,registry:xo(n.definitions),...n.relativePath===void 0?{}:{relativePath:n.relativePath}}),createRelationshipGraph:n=>new Ne(n.nodes,n.edges,xo(n.definitions)),analyzeRelationshipImpact:(n,o,s)=>zi(n,o,s),validateRelationshipEvents:n=>{let o=new St(n.nodes,{registry:xo(n.definitions)});return n.events.map(s=>o.append({...s,expectedVersion:o.version}))},commitWorkspaceTransaction:n=>Hi({...n,pmRoot: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]="c2766f4e-6354-55bb-9e40-676273ee901f")}catch{}})();async function qc(e,t,n=Or){try{await n({pmRoot:e,result:t})}catch{if(typeof t=="object"&&t!==null&&!Array.isArray(t)){let o=t,s=Array.isArray(o.warnings)?o.warnings.filter(r=>typeof r=="string"):[];o.warnings=[...new Set([...s,"context_usage_feedback_write_failed"])].sort()}}}import{readFile as lm}from"node:fs/promises";import dm 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]="c64f304d-9081-5bad-8187-7bf6b65e4a07")}catch{}})();var Oo="context-intents.json";function ln(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function mm(e,t,n){if(!ln(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(s=>typeof s=="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 zc(e,t){let n=Array.isArray(e)?e:ln(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,s)=>mm(o,t,s))}async function pm(e){let t=dm.join(e,Oo),n;try{n=await lm(t,"utf8")}catch(s){if(De(s))return[];throw await Wr(e),s}let o;try{o=JSON.parse(n)}catch(s){let r=s instanceof Error?s.message:String(s);throw new TypeError(`Invalid ${Oo}: ${r}`,{cause:s})}return zc(o,Oo)}function um(e){if(!ln(e))return;let t=e.contextIntents??e.context_intents;if(t!==void 0)return t;let n=e.default;return ln(n)?n.contextIntents??n.context_intents:void 0}function fm(e){return e.flatMap(t=>{let n=um(t.module);return n===void 0?[]:zc(n,`package ${t.name}`)})}async function _m(e){let t=await pm(e.pmRoot),n=fm(e.packages??[]);return{workspaceContracts:t,packageContracts:n}}async function $o(e,t){let n=await _m(e);return await $r(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]="663579ae-aebb-524c-81c9-9aed44e40f35")}catch{}})();async function Bc(e,t,n){if(t.body===void 0)throw new m("Missing required --body text",u.USAGE);let o=Ft(),s=I(process.cwd(),n.path);await O(s);let r=await E(s),i=C(t.author,r.author_default),c=(await o.resolveValue(t.body,"--body",mr(t,"body"))).trim();if(c.length===0)throw new m("--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 l=await _t({pmRoot:s,settings:r,id:e,op:"append",author:i,message:t.message,force:t.force,mutate(d){let p=d.body.trim().length>0?`
+
+`:"";return d.body=`${d.body.trimEnd()}${p}${c}
+`,{changedFields:["body"]}}});return{item:l.item,appended:c,changed_fields:l.changedFields}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="aec6f8e2-5fd0-53f3-8262-c6b49741ff96")}catch{}})();var Wc=1,Po="close-many",hm=["--filter-status","--filter-type","--filter-tag","--filter-priority","--filter-sprint","--filter-release","--filter-parent","--filter-assignee","--filter-updated-before","--ids"].join(", ");function gm(e,t){return vt(e,t,{includePagination:!1})}function ym(e,t){return vt(e,t)}function bm(e){if(e?.ids!=null&&String(e.ids).trim().length===0)throw new m("--ids requires at least one non-empty item ID",u.USAGE)}function vm(e){let t={};if(!e)return t;for(let[n,o]of Object.entries(e))o==null||typeof o=="string"&&!o.split(",").some(s=>s.trim().length>0)||(t[n]=o);return t}function wm(e,t){let n=String(e??"").trim();if(n.length>0)return n;if(t)throw new m("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 km(e,t){let n=j(t.schema),o=$(t,T()),s=await ft(e,t.item_format,o.type_to_folder,void 0,t.schema),r=new Map,i=new Map;for(let a of s){if(typeof a.parent!="string"||a.parent.length===0||(i.set(a.id,a.parent),Ge(a.status,n)))continue;let c=r.get(a.parent);c?c.push(a.id):r.set(a.parent,[a.id])}for(let a of r.values())a.sort((c,l)=>c.localeCompare(l));return{childrenByParent:r,parentByChild:i}}function Vc(e,t,n){let o=n?.get(e);if(o!==void 0)return o;let s=0,r=t.get(e),i=[],a=new Set,c=!1;for(;r!==void 0&&!a.has(r);){let l=n?.get(r);if(l!==void 0){s+=l+1;break}a.add(r),i.push(r),s+=1,r=t.get(r)}if(r!==void 0&&a.has(r)&&(c=!0),!c){n?.set(e,s);for(let[l,d]of i.entries())n?.set(d,s-l-1)}return s}async function Sm(e){let t=await xt(e.pmRoot,Po,e.rollbackId,Wc),n=e.options.message??`Rollback close-many checkpoint ${t.id}`,o=await Ot(t.items,(s,r)=>Oe(s,r,{author:e.options.author,message:n,force:!0},e.global));return{...$e({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 Im(e,t,n,o,s){return e.map(r=>{let i=(t.get(r.id)??[]).filter(c=>!n.has(c)),a=!Kc(r,o,s);return{id:r.id,title:typeof r.title=="string"?r.title:"",status:r.status,action:a?"skip":"close",...a?{skip_reason:"already_terminal"}:{},...i.length>0?{active_child_ids:i}:{}}})}async function Em(e){let t=await Tt(e.pmRoot,Po,e.checkpointId,{schema_version:Wc,id:e.checkpointId,created_at:e.nowValue,author:C(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 Am(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 s=await xe(o.id,e.reason,e.closeOptions,e.global);t.push({id:o.id,status:"closed",changed_fields:s.changed_fields,...s.warnings&&s.warnings.length>0?{warnings:s.warnings}:{}}),n.push(o.id)}catch(s){t.push({id:o.id,status:"failed",error:he(s)})}}return{rows:t,closedIds:n}}function Rm(e){return typeof e.rollback=="string"?e.rollback:void 0}function Cm(e,t){if(t.trim().length===0)throw new m("--rollback requires a checkpoint id",u.USAGE);if(e.dryRun===!0)throw new m("--dry-run cannot be combined with --rollback",u.USAGE);if(ym(e.list,e.status))throw new m("Rollback mode does not accept filter options",u.USAGE)}function Tm(e){if(!gm(e.list,e.status))throw new m(`close-many requires at least one filter to scope the close (for example: ${hm}). Refusing to match every item.`,u.USAGE)}function xm(e,t){let n=new Map;return[...e].sort((o,s)=>{let r=Vc(s.id,t,n)-Vc(o.id,t,n);return r!==0?r:o.id.localeCompare(s.id)})}function Kc(e,t,n){return n||!Ge(e.status,t)}function Om(e,t,n){return new Set(e.filter(o=>Kc(o,t,n)).map(o=>o.id))}async function $m(e){Tm(e.options);let t=j(e.settings.schema),n=wm(e.options.reason,e.settings.governance.require_close_reason),o=e.options.force===!0,s=await ce(e.options.status,vm(e.options.list),e.global),{childrenByParent:r,parentByChild:i}=await km(e.pmRoot,e.settings),a=xm(s.items,i),c=[...new Set(String(e.options.list?.ids??"").split(",").map(f=>f.trim()).filter(f=>f.length>0))],l=c.length===0?[]:(await ce(void 0,{ids:c.join(","),noTruncate:!0,full:!0},e.global)).items,d=new Set(l.map(f=>f.id)),p=Om(a,t,o);return{pmRoot:e.pmRoot,settings:e.settings,statusRegistry:t,reason:n,validateCloseMode:e.options.validateClose,force:o,listed:s,matched:a,unmatchedIds:c.length===0?void 0:c.filter(f=>!d.has(f)),planRows:Im(a,r,p,t,o)}}function Pm(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!==void 0?{unmatched_ids:e.unmatchedIds,unmatched_count:e.unmatchedIds.length}:{}}}async function Fm(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 Em({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 Yc(e,t){let n=I(process.cwd(),t.path);await O(n);let o=await E(n),s=e.dryRun===!0,r=Rm(e);if(bm(e.list),r!==void 0)return Cm(e,r),Sm({pmRoot:n,rollbackId:r,options:e,global:t});let i=await $m({pmRoot:n,settings:o,options:e,global:t});if(s)return Pm(i);let a=new Set(i.planRows.filter(_=>_.action==="close").map(_=>_.id)),c=S(),l=Ct(Po,c),d=await Fm({context:i,options:e,closableIds:a,checkpointId:l,nowValue:c}),p={author:e.author,message:e.message??`close-many apply ${l}`,completedAt:e.completedAt,validateClose:i.validateCloseMode,force:i.force,resolution:e.resolution,expectedResult:e.expectedResult,actualResult:e.actualResult},{rows:f,closedIds:g}=await Am({matched:i.matched,closableIds:a,reason:i.reason,closeOptions:p,global:t}),v=f.filter(_=>_.status==="closed").length,w=f.filter(_=>_.status==="skipped").length,y=f.filter(_=>_.status==="failed").length;return{...$e({applied:v,skipped:w,failed:y,unmatched:i.unmatchedIds?.length??0}),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}:{},...d?{checkpoint:d}:{},closed_count:v,skipped_count:w,failed_count:y,rows:f,ids:g,...i.unmatchedIds!==void 0?{unmatched_ids:i.unmatchedIds,unmatched_count:i.unmatchedIds.length}:{}}}import{readFile as Lm}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]="29e1738e-026c-5714-b279-30e45951d256")}catch{}})();async function Fo(e,t){let n=e.add!==void 0,o=e.stdin===!0,s=typeof e.file=="string",r=Number(n)+Number(o)+Number(s);if(r===0)return;if(r>1)throw new m("Specify comment text using only one input source: --add, --stdin, or --file",u.USAGE);if(n)return{value:await t.resolveValue(e.add,"--add",dr(e))??"",emptyFlag:"--add"};if(o)return lo(e,"--stdin"),{value:await t.resolveValue("-","--stdin")??"",emptyFlag:"--stdin"};let i=e.file.trim();if(!i)throw new m("--file path cannot be empty",u.USAGE);if(i==="-")return lo(e,"--file -"),{value:await t.resolveValue("-","--file")??"",emptyFlag:"--file"};try{return{value:await Lm(i,"utf8"),emptyFlag:"--file"}}catch(a){if(Va(a)&&De(a))throw new m(`--file path not found: ${i}. Use --file - to read stdin.`,u.USAGE);let c=a instanceof Error?a.message:String(a);throw new m(`Failed to read --file path "${i}": ${c}. Use --file - to read stdin.`,u.USAGE)}}async function Mm(e,t){let n=e.edit,o=e.delete,s=n!==void 0,r=o!==void 0;if(s&&r)throw new m("Specify only one of --edit or --delete",u.USAGE);if(n!==void 0&&(!Number.isInteger(n)||n<1))throw new m("--edit must be a positive integer",u.USAGE);if(o!==void 0&&(!Number.isInteger(o)||o<1))throw new m("--delete must be a positive integer",u.USAGE);if(r){if(await Fo(e,t)!==void 0)throw new m("--delete does not take comment text",u.USAGE);return{mode:"delete",index:o}}if(s){let c=await Fo(e,t);if(c===void 0)throw new m("--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 Fo(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 Jc(e,t,n){let o=Ft(),s=await Mm(t,o),r=s.mode==="add"||s.mode==="edit",i=s.value??"";return Be(e,t,n,{input:{...s,rawValue:t.add??i,value:r?He(i,{stripPlainTextPrefix:!0}):i},collectionKey:"comments",op:"comment_add",editOp:"comment_edit",deleteOp:"comment_delete",parseText:a=>a,createEntry:a=>a,bypassOwnershipConflict:!!(s.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]="99f91321-fd91-5ec6-8d09-1493f40dacb1")}catch{}})();async function Xc(e,t,n){return Be(e,t,n,{input:await Zt(t,"learning"),collectionKey:"learnings",op:"learning_add",editOp:"learning_edit",deleteOp:"learning_delete",parseText:o=>He(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]="eab6a65d-8f97-593e-8609-6ae452b1c5aa")}catch{}})();function Dm(e){if(e===void 0)return;if(e.trim().length===0)throw new m("--add-json must contain a JSON value",u.USAGE,{code:"structured_event_json_empty"});let t;try{t=JSON.parse(e)}catch{throw new m("--add-json must be valid JSON",u.USAGE,{code:"structured_event_json_invalid"})}return t}function Nm(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 jm(e){if(e===void 0)return;let t=Date.parse(e);if(!Number.isFinite(t))throw new m("--since must be a valid ISO timestamp",u.USAGE,{code:"structured_event_since_invalid"});return t}async function Zc(e,t,n){let o=Dm(t.addJson),s=[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&&s)throw new m("--add-json cannot be combined with text, edit, delete, stdin, or file inputs",u.USAGE,{code:"structured_event_input_conflict"});let r=o===void 0?void 0:at(o),i=[t.since,t.eventType].some(v=>v!==void 0),a=jm(t.since),c=Mr(t.limit),l=await Be(e,{...t,...i?{limit:void 0}:{},includeMeta:[t.includeMeta===!0,i].includes(!0)},n,{input:await Zt(r===void 0?t:{add:r},"note"),collectionKey:"notes",op:"note_add",editOp:"note_edit",deleteOp:"note_delete",parseText:v=>He(v),createEntry:v=>o===void 0?v:{...v,format:"json",data:o,event_type:Nm(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."]}}),d=t.eventType?.trim(),p=l.notes.filter(v=>{let w=[v.format==="json",v.data!==void 0].every(Boolean),y=[a===void 0,Date.parse(v.created_at)>=(a??Number.POSITIVE_INFINITY)].includes(!0),_=[!d,v.event_type===d].includes(!0);return[!i,[w,y,_].every(Boolean)].includes(!0)}),f=i?Ba(p,c):p,g=f.filter(v=>v.format==="json").length;return{...l,notes:f,count:f.length,...i?{total_count:p.length,returned_count:f.length,has_more:f.length<p.length,...c===void 0?{}:{limit:c},structured_event_count:g}:t.includeMeta===!0?{structured_event_count: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]="3ef785ae-bb1e-59dd-993c-3be56ddc26c2")}catch{}})();var el=1,Mo="update-many",Um=new Set(["author","message","force","ownershipMetadataBypass","ownershipDependencyBypass","allowUnresolvedDeps"]),Gm=["--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(", "),qm={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"},zm=[{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"}],Hm={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"},tl=e=>{let t={};for(let[n,o]of Object.entries(e))Um.has(n)||o!==void 0&&(t[n]=o);return t},Bm=e=>Object.keys(tl(e)).length>0,nl=e=>typeof e=="string"?e.trim():e,Vm=e=>{let t=String(e).trim(),n=Number(t);return Number.isInteger(n)?n:t},Lo=e=>{let t=String(e).trim(),n=Number(t);return Number.isFinite(n)?n:t},Wm=e=>{let t=String(e).trim().toLowerCase();return new Map([["true",!0],["1",!0],["false",!1],["0",!1]]).get(t)??nl(e)},Km={priority:Vm,estimatedMinutes:Lo,order:Lo,rank:Lo,regression:Wm},Ym=(e,t)=>{if(t!==void 0)return(Km[e]??nl)(t)},Jm=e=>{let t=e.trim().toLowerCase().replaceAll("-","_");return Hm[t]??t},dn=(e,t)=>Js(e,t),Xm=(e,t)=>t!==void 0?t:e==="type_options"?{}:[],Zm=(e,t)=>Array.isArray(t)?t.length:e==="type_options"&&t&&typeof t=="object"?Object.keys(t).length:0,Qm=e=>e.replace?"replace":e.clear?"clear_or_reset":e.removeCount>0?"merge_remove":"append",Qc=(e,t)=>t===void 0?void 0:e[t],We=e=>Array.isArray(e)?e.length:0,ep=(e,t,n)=>{let o=n[e.addKey],s=Qc(n,e.removeKey),r=We(o),i=We(s),a=n[e.clearKey]===!0,c=Qc(n,e.replaceKey)===!0;if(![a,c,r>0,i>0].includes(!0))return;let l=Xm(e.field,t[e.field]);return{field:e.field,before:l,after:{operation:Qm({replace:c,clear:a,removeCount:i}),clear:a,replace:c,add_count:r,remove_count:i,before_count:Zm(e.field,l)}}},tp=(e,t)=>{let n=[];for(let o of zm){let s=ep(o,e,t);s!==void 0&&n.push(s)}return n},np=e=>Array.isArray(e)?e.filter(t=>typeof t=="string"):[],op=(e,t)=>{if(![t.tags!==void 0,We(t.addTags)>0,We(t.removeTags)>0].includes(!0))return;let n=np(e.tags),o=t.tags===void 0?n:ct(t.tags),s=ar(o,t.addTags),r=cr(s,t.removeTags).slice().sort((a,c)=>a.localeCompare(c)),i=n.slice().sort((a,c)=>a.localeCompare(c));if(!dn(i,r))return{field:"tags",before:n,after:r}},sp=(e,t)=>{let n=e.acceptance_criteria,o=ir(rr(n),t.addAc,t.removeAc);if(o.unmatchedRemovals.length>0)throw new m(`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 s=o.criteria.join("; ");if(!dn(typeof n=="string"?n:"",s))return{field:"acceptance_criteria",before:n,after:s}},rp=(e,t,n)=>{for(let[o,s]of Object.entries(qm)){let r=n[o];if(r===void 0)continue;let i=t[s],a=Ym(o,r);dn(i,a)||e.push({field:s,before:i,after:a})}},ip=(e,t,n,o)=>{let s=br(n,o,["update_many"]);for(let[r,i]of Object.entries(s)){let a=t[r];dn(a,i)||e.push({field:r,before:a,after:i})}},ap=(e,t,n)=>{for(let o of n??[]){let s=Jm(o),r=t[s];r!==void 0&&e.push({field:s,before:r,after:null})}},cp=(e,t,n={})=>{let o=e,s=[],r=op(o,n);if(r&&s.push(r),rp(s,o,n),We(n.addAc)>0||We(n.removeAc)>0){let i=sp(o,n);i!==void 0&&s.push(i)}return s.push(...tp(o,n)),ip(s,o,n,t),ap(s,o,n.unset),{id:e.id,changes:s}},lp=(e,t)=>Lr(e,t,{strict:!0,flagLabel:"--filter-status"}),dp=e=>{if(e?.ids!=null&&String(e.ids).trim().length===0)throw new m("--ids requires at least one non-empty item ID",u.USAGE)},mp=[({update:e})=>{e.priority!==void 0&&Fr(e.priority)},({update:e,settings:t,pmRoot:n})=>{if(e.type===void 0)return;let o=$(t,T());if(!$t(e.type,o))throw new m(jr(e.type,o.types,gr(n,t.schema)),u.USAGE)},({update:e,statusRegistry:t})=>{if(e.status!==void 0&&!Ee(e.status,t)){let n=t.definitions.map(o=>o.id);throw new m(`Invalid --status value "${e.status}". Allowed: ${n.join(", ")}`,u.USAGE)}},({update:e})=>{e.deadline!==void 0&&Gs(e.deadline,new Date,"deadline")},({update:e})=>{e.estimatedMinutes!==void 0&&pr(e.estimatedMinutes,"estimated-minutes")}],pp=(e,t,n,o)=>{let s={update:e,settings:t,statusRegistry:n,pmRoot:o};for(let r of mp)r(s)},up=async e=>{let t=await xt(e.pmRoot,Mo,e.rollbackId,el),n=e.options.update?.message??`Rollback update-many checkpoint ${t.id}`,o=await Ot(t.items,(s,r)=>Oe(s,r,{author:e.options.update?.author,message:n,force:e.options.update?.force??!0},e.global));return{...$e({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}},fp=async e=>{let t={schema_version:el,id:e.checkpointId,created_at:e.nowValue,author:C(e.options.update?.author,"unknown"),status_filter:e.statusFilter??null,list_filters:e.filters,update_options:e.updateSummary,items:e.checkpointItems},n=await Tt(e.pmRoot,Mo,e.checkpointId,t);return{id:e.checkpointId,created_at:e.nowValue,path:n,rollback_command:`pm update-many --rollback ${e.checkpointId}`}},_p=(e,t)=>{if(e==null)return;let n=[...new Set(String(e).split(",").map(s=>s.trim()).filter(s=>s.length>0))],o=new Set(t.map(s=>s.id));return n.filter(s=>!o.has(s))},Do=e=>e.unmatchedIds===void 0?{}:{unmatched_ids:e.unmatchedIds,unmatched_count:e.unmatchedIds.length},hp=async e=>{let t=I(process.cwd(),e.path);await O(t);let n=await E(t);return{pmRoot:t,settings:n,statusRegistry:j(n.schema),runtimeFieldRegistry:dt(n.schema)}},gp=e=>{if(e.options.dryRun===!0)throw new m("--dry-run cannot be combined with --rollback",u.USAGE);if(vt(e.options.list,e.options.status))throw new m("Rollback mode does not accept filter options",u.USAGE);if(Object.keys(e.updateSummary).length>0)throw new m("Rollback mode does not accept update mutation flags",u.USAGE);return up({pmRoot:e.runtime.pmRoot,rollbackId:e.rollbackId,options:e.options,global:e.global})},yp=async e=>{lp(e.options.status,e.runtime.statusRegistry);let t=await ce(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(s=>{let r=cp(s,e.runtime.runtimeFieldRegistry,e.options.update);return e.dependencyWarnings.length===0?r:{...r,warnings:[...e.dependencyWarnings]}}),o=e.options.list?.ids==null?[]:(await ce(void 0,{ids:e.options.list.ids,noTruncate:!0,full:!0},e.global)).items;return{listed:t,planned:n,actionable:n.filter(s=>s.changes.length>0),updateSummary:e.updateSummary,unmatchedIds:_p(e.options.list?.ids,o)}},bp=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:[],...Do(e)}),vp=e=>({...$e({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:[],...Do(e)}),wp=async e=>{let t=[],n=[],o=e.options.update.message??`update-many apply ${e.checkpointId}`,s=new Set(e.plans.filter(r=>r.changes.length>0).map(r=>r.id));for(let r of e.items){if(!s.has(r.id)){t.push({id:r.id,status:"skipped"});continue}try{let i=qn({...e.options.update,message:o,runtimeFieldCommands:["update_many"]}),a=await be(r.id,i,e.global);t.push({id:r.id,status:"updated",changed_fields:a.changed_fields,warnings:a.warnings}),n.push(r.id)}catch(i){t.push({id:r.id,status:"failed",error:he(i)})}}return{rows:t,updatedIds:n}},kp=async e=>{if(e.plan.actionable.length===0)return vp(e.plan);let t=S(),n=Ct(Mo,t),o=new Set(e.plan.actionable.map(p=>p.id)),s=e.plan.listed.items.filter(p=>o.has(p.id)).map(p=>({id:p.id,target_updated_at:p.updated_at})),r=e.options.checkpoint===!1?void 0:await fp({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:s}),i=await wp({items:e.plan.listed.items,plans:e.plan.planned,options:e.options,global:e.global,checkpointId:n}),a=p=>i.rows.filter(f=>f.status===p).length,c=a("updated"),l=a("skipped"),d=a("failed");return{...$e({applied:c,skipped:l,failed:d,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,...r?{checkpoint:r}:{},updated_count:c,skipped_count:l,failed_count:d,rows:i.rows,ids:i.updatedIds,...Do(e.plan)}},ol=async(e,t)=>{let n=await hp(t),o=typeof e.rollback=="string"?e.rollback:void 0;o===void 0&&(e={...e,update:qn(await Ja(e.update))});let s=tl(e.update);if(dp(e.list),o!==void 0)return gp({runtime:n,rollbackId:o,options:e,global:t,updateSummary:s});if(!Bm(e.update)&&e.dryRun!==!0)throw new m(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${Gm}), or pass --dry-run for a filter-only preview.`,u.USAGE);pp(e.update,n.settings,n.statusRegistry,n.pmRoot),Xa(e.update);let r=await fo({pmRoot:n.pmRoot,dependencies:ho(e.update.dep,n.settings.id_prefix,S(),C(e.update.author,n.settings.author_default)).additions,idPrefix:n.settings.id_prefix,itemFormat:n.settings.item_format,typeToFolder:$(n.settings,T()).type_to_folder,allowUnresolved:e.update.allowUnresolvedDeps}),i=await yp({options:e,global:t,runtime:n,updateSummary:s,dependencyWarnings:r});return await fo({pmRoot:n.pmRoot,dependencies:ho(e.update.dep,n.settings.id_prefix,S(),C(e.update.author,n.settings.author_default)).additions,idPrefix:n.settings.id_prefix,itemFormat:n.settings.item_format,typeToFolder:$(n.settings,T()).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?bp(i):kp({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]="374c7cb8-9fd0-5a2d-8aaf-9d09b63abaf0")}catch{}})();var Sp=["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"],sl=["brief","standard","deep"],al="plan-step-",zo="draft",qo=["bug-investigation","feature-implementation","refactoring-sprint"],rl={"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 Ip(e){let t=e.trim().toLowerCase(),n=Object.prototype.hasOwnProperty.call(rl,t)?rl[t]:void 0;if(!n)throw new m(`Unknown plan template "${e}". Allowed: ${qo.join(", ")}`,u.USAGE,{code:"unknown_plan_template",examples:[`pm plan create --title "Fix login crash" --template ${qo[0]}`]});return n.map(o=>({...o}))}function Ep(e,t){return t>0?Math.round(e/t*100):0}function cl(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 X(e){return Array.isArray(e)?e.flatMap(t=>Xn(t,{unique:!1})):typeof e=="string"&&e.trim().length>0?Xn(e,{unique:!1}):[]}function H(e){return Array.isArray(e)?e.map(t=>t.trim()).filter(Boolean):typeof e=="string"&&e.trim().length>0?[e.trim()]:[]}function ll(e,t=zo){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Rn.find(s=>s===n);if(!o)throw new m(`Invalid plan mode "${e}". Allowed: ${Rn.join(", ")}`,u.USAGE);return o}function Ho(e,t="pending"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Cn.find(s=>s===n);if(!o)throw new m(`Invalid step status "${e}". Allowed: ${Cn.join(", ")}`,u.USAGE);return o}function dl(e,t="related"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=xn.find(s=>s===n);if(!o)throw new m(`Invalid step link kind "${e}". Allowed: ${xn.join(", ")}`,u.USAGE);return o}function Ap(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t.length===0)return;let n=Tn.find(o=>o===t);if(!n)throw new m(`Invalid plan harness "${e}". Allowed: ${Tn.join(", ")}`,u.USAGE);return n}function Rp(e){if(e===void 0)return"brief";let t=e.trim().toLowerCase(),n=sl.find(o=>o===t);if(!n)throw new m(`Invalid --depth "${e}". Allowed: ${sl.join(", ")}`,u.USAGE);return n}function Cp(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 m("Plan --fields requires a comma-separated list of plan field names",u.USAGE);return t}var No=new Set(["id","title","status","mode","scope","harness","parent","resume_context","steps_summary","current_step","blocked_steps","steps","decisions","discoveries","validation","linked_items"]);function Tp(e,t){let n=e,o={},s=[];for(let r of t){let i=r.startsWith("plan.")?r.slice(5):r;if(i.length!==0){if(!No.has(i)){s.push(r);continue}Object.prototype.hasOwnProperty.call(n,i)&&(o[i]=n[i])}}if(s.length>0)throw new m(`Unknown Plan --fields value(s): ${s.join(", ")}`,u.USAGE,{nextSteps:[`Use --fields ${[...No].join(",")}`,"Run pm plan show <id> --depth brief for compact default fields."],recovery:{provided_fields:s,suggested_retry:`pm plan show <id> --fields ${[...No].join(",")}`}});return o}function Bo(e,t){let n={};for(let o of e.split(",")){let s=o.trim();if(s.length===0)continue;let r=s.indexOf("=");if(r<=0)throw new m(`Invalid ${t} entry "${s}"; 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[s.slice(0,r).trim().toLowerCase()]=s.slice(r+1).trim()}return n}function Vo(e){let t=Bo(e,"--file");if(!t.path)throw new m("--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 Wo(e){let t=Bo(e,"--test");if(!t.command&&!t.path)throw new m("--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 Ko(e){let t=Bo(e,"--doc");if(!t.path)throw new m("--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=Ep(t.completed,t.total),t}function Op(e){let t=new Set(e.map(n=>n.id));for(let n=e.length+1;n<e.length+1024;n+=1){let o=`${al}${String(n).padStart(3,"0")}`;if(!t.has(o))return o}throw new m("Could not allocate step id (limit reached)",u.GENERIC_FAILURE)}function Ke(e,t){let n=t.trim();if(n.length===0)throw new m("Step reference cannot be empty",u.USAGE);let o=e.find(s=>s.id===n);if(o)return o;if(/^\d+$/.test(n)){let s=Number.parseInt(n,10),r=e.find(i=>i.order===s);if(r)return r}throw new m(`Step "${t}" not found in plan`,u.NOT_FOUND)}function il(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 $p(e,t){let n=t.filter(i=>i.trim().toLowerCase()==="all"),o=[],s=[];if(n.length>0){if(t.length>n.length)throw new m("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=il(i);if(a){s.push({from_step:i.id,...a});continue}o.push(i)}return{targets:o,skipped:s}}let r=new Set;for(let i of t){let a=Ke(e,i);if(r.has(a.id))continue;r.add(a.id);let c=il(a);if(c){s.push({from_step:a.id,...c});continue}o.push(a)}return{targets:o,skipped:s}}function Pp(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 Fp(e){return e.find(t=>t.status==="in_progress")??e.find(t=>t.status==="pending")}function Lp(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 V(e,t="brief"){let n=(e.plan_steps??[]).slice().sort((i,a)=>i.order-a.order),o=xp(n),s=Fp(n),r={id:e.id,title:e.title,status:e.status,mode:e.plan_mode??zo,scope:e.plan_scope,harness:e.plan_harness,parent:e.parent,resume_context:e.plan_resume_context,steps_summary:o,current_step:s?{id:s.id,order:s.order,title:s.title,status:s.status}:void 0,blocked_steps:Lp(n),linked_items:(e.dependencies??[]).map(i=>({id:i.id,kind:i.kind}))};return(t==="standard"||t==="deep")&&(r.steps=n),t==="deep"&&(r.decisions=e.plan_decisions??[],r.discoveries=e.plan_discoveries??[],r.validation=e.plan_validation??[]),r}function W(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&&!Zn(t.mode)&&t.status!=="closed"&&t.status!=="canceled"&&n.push(`pm close ${e} "plan complete"`),n}function ml(e){if((e.type??"").trim().toLowerCase()!=="plan")throw new m(`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 Mp(e){let t=I(process.cwd(),e.path);await O(t);let n=await E(t);return{pmRoot:t,settings:n}}async function pl(e,t){let n=$(e.settings,T()),o=await ae(e.pmRoot,t,e.settings.id_prefix,e.settings.item_format,n.type_to_folder);if(!o)throw new m(`Plan ${t} not found`,u.NOT_FOUND);let s=await ge(o,{schema:e.settings.schema});return ml(s.document.metadata),{document:s.document,itemId:o.id}}function Dp(e){let t=[];e.parent&&t.push(`id=${e.parent.trim()},kind=parent`);for(let n of X(e.related))t.push(`id=${n},kind=related`);for(let n of X(e.blocks))t.push(`id=${n},kind=blocks`);for(let n of X(e.blockedBy))t.push(`id=${n},kind=blocked_by`);return t.length>0?t:void 0}function Np(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 jp(e){return!!e.stepBody?.trim()||!!e.stepOwner?.trim()||!!e.stepStatus?.trim()||!!e.stepEvidence?.trim()||!!e.stepBlockedReason?.trim()||!!e.stepReplacement?.trim()||X(e.dependsOn).length>0||X(e.link).length>0}function Up(e){let t=e.stepTitle?.trim()||void 0,n=cl(e.step),o=e.template?.trim()?Ip(e.template):[];return{repeatedStepTitles:n,stepTitleFlag:t,stepTitles:[...t?[t]:[],...n,...o.map(s=>s.title)],templateSteps:o}}function Gp(e,t){if((e.stepTitleFlag||e.repeatedStepTitles.length>0)&&e.templateSteps.length>0)throw new m("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 ${qo[0]}`,'pm plan create --title "Custom plan" --step "Read the code" --step "Write the fix"']});if(e.stepTitles.length>1&&t)throw new m("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 qp(e,t){let n=Ho(e.stepStatus,"pending"),o=Yo(e,"depends_on"),s=H(e.file).map(Vo),r=H(e.test).map(Wo),i=H(e.doc).map(Ko),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:s.length>0?s:void 0,tests:r.length>0?r:void 0,docs:i.length>0?i:void 0,created_at:a,updated_at:a,completed_at:n==="completed"?a:void 0}}function zp(e){let t=Up(e),n=jp(e);if(Gp(t,n),t.stepTitles.length===0)return{steps:[],hasPerStepDetailOptions:n};if(t.stepTitles.length===1)return{steps:[qp(e,t.stepTitles[0])],hasPerStepDetailOptions:n};let o=S();return{steps:t.stepTitles.map((s,r)=>({id:`${al}${String(r+1).padStart(3,"0")}`,order:r+1,title:s,body:t.templateSteps[r]?.body,status:"pending",created_at:o,updated_at:o})),hasPerStepDetailOptions:n}}function ul(e,t,n=[]){lt(e,t),n.length>0&&lr(t,n)}async function Hp(e,t,n){let o=e.title?.trim();if(!o)throw new m("pm plan create requires --title",u.USAGE,{code:"missing_required_option",examples:['pm plan create --title "Refactor lock retry" --scope pm-a1b2']});let s=ll(e.mode,zo),r=Ap(e.harness),i=e.fromSearch?.trim(),a=Np(e),{steps:c,hasPerStepDetailOptions:l}=zp(e);if(c.length===0&&l)throw new m("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 d=e.description?.trim()??e.scope?.trim()??o,p=e.claim?C(e.author,n.settings.author_default):e.assignee?.trim()||void 0,f={...e,title:o,description:d,type:"Plan",template:void 0,file:H(e.file),test:H(e.test),doc:H(e.doc),field:H(e.field),assignee:C(e.author,n.settings.author_default),blockedBy:void 0,dep:Dp(e),message:e.message??(i?`plan create (search: ${i})`:"plan create")};ul(e,f);let g=await wt(f,t),v=await _t({pmRoot:n.pmRoot,settings:n.settings,id:g.item.id,op:"plan_create_metadata",author:C(e.author,n.settings.author_default),message:"seed plan metadata",mutate(y){let _=["plan_mode"];y.metadata.plan_mode=s,r&&(y.metadata.plan_harness=r,_.push("plan_harness"));let k=e.scope?.trim();k&&(y.metadata.plan_scope=k,_.push("plan_scope"));let R=e.resumeContext?.trim();return R&&(y.metadata.plan_resume_context=R,_.push("plan_resume_context")),y.metadata.plan_steps=c,_.push("plan_steps"),a&&(y.metadata.plan_validation=[...y.metadata.plan_validation??[],a],_.push("plan_validation")),p&&(y.metadata.assignee=p,_.push("assignee")),{changedFields:_}}}),w=V(v.item,"brief");return{action:"create",plan:w,step:c[0],next_actions:W(g.item.id,w),warnings:[...g.warnings],generated_at:S()}}async function Bp(e,t,n){let o=Rp(t.depth),s=Cp(t.fields),{document:r,itemId:i}=await pl(n,e),a=V(r.metadata,s===null?o:"deep");return{action:"show",plan:s===null?a:Tp(a,s),next_actions:W(i,a),warnings:[],generated_at:S()}}function Vp(e,t){let n=new Map(Object.entries(t).filter(([o])=>o.startsWith("plan_")).map(([o,s])=>[o,JSON.stringify(s)]));return[...new Set([...e.keys(),...n.keys()])].filter(o=>e.get(o)!==n.get(o))}async function ne(e){let t=C(e.options.author,e.ctx.settings.author_default),n,o=await _t({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(s){ml(s.metadata);let r=j(e.ctx.settings.schema);if(Ge(s.metadata.status,r)||Zn(s.metadata.plan_mode))throw new m(`Plan ${s.metadata.id} is terminal (status=${s.metadata.status}, plan_mode=${s.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=(s.metadata.plan_steps??[]).slice(),a=new Map(Object.entries(s.metadata).filter(([p])=>p.startsWith("plan_")).map(([p,f])=>[p,JSON.stringify(f)])),c=e.mutator(i,s);n=c.resultStep;let l=i.slice().sort((p,f)=>p.order-f.order).map((p,f)=>({...p,order:f+1}));s.metadata.plan_steps=l;let d=Vp(a,s.metadata);return d.length===0&&c.changedSteps.length===0?{changedFields:[]}:{changedFields:d.length>0?d:["plan_steps"]}}});return{document:{metadata:o.item,body:o.body},resultStep:n,itemId:o.item.id}}async function Wp(e,t,n){let o=t.stepTitle?.trim();if(!o)throw new m("pm plan add-step requires --step-title",u.USAGE);let s=Ho(t.stepStatus,"pending"),r=t.allowMultipleActive===!0,{document:i,resultStep:a,itemId:c}=await ne({id:e,options:t,ctx:n,op:"plan_add_step",message:`plan add-step "${o}"`,mutator(d){let p=d.length+1;fl(d,void 0,s,r);let f=Kp(d,t,{order:p,title:o,status:s});return d.push(f),{changedSteps:[f.id],resultStep:f}}}),l=V(i.metadata,"standard");return{action:"add-step",plan:l,step:a,next_actions:W(c,l),warnings:[],generated_at:S()}}function fl(e,t,n,o){if(n!=="in_progress"||o)return;let s=e.find(r=>r.id!==t&&r.status==="in_progress");if(s)throw new m(`Plan already has step ${s.id} in_progress. Pass --allow-multiple-active or update that step first.`,u.CONFLICT)}function Kp(e,t,n){let o=Yo(t,"depends_on"),s=H(t.file).map(Vo),r=H(t.test).map(Wo),i=H(t.doc).map(Ko),a=S();return{id:Op(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:s.length>0?s:void 0,tests:r.length>0?r:void 0,docs:i.length>0?i:void 0,created_at:a,updated_at:a,completed_at:n.status==="completed"?a:void 0}}function Yo(e,t){let n=X(e.dependsOn).map(d=>({id:d,kind:t})),o=X(e.related).map(d=>({id:d,kind:"related"})),s=X(e.blocks).map(d=>({id:d,kind:"blocks"})),r=X(e.blockedBy).map(d=>({id:d,kind:"blocked_by"})),i=X(e.link),a=dl(e.linkKind,t),c=e.linkNote?.trim(),l=i.map(d=>{let p={id:d,kind:a};return c&&(p.note=c),p});return[...n,...o,...s,...r,...l]}async function jo(e,t,n,o){let{document:s,resultStep:r,itemId:i}=await ne({id:e,options:t,ctx:n,op:o.op,message:t.message??`${o.op} ${o.stepRef}`,mutator(c,l){let d=Ke(c,o.stepRef),p=S(),f=o.finalStatus??Ho(t.stepStatus,d.status),g=t.allowMultipleActive===!0||o.allowMultipleActive===!0;return fl(c,d.status==="in_progress"?d.id:void 0,f,g),Yp(d,t,f,p),l.metadata.updated_at=p,{changedSteps:[d.id],resultStep:d}}}),a=V(s.metadata,"standard");return{action:o.op==="plan_complete_step"?"complete-step":o.op==="plan_block_step"?"block-step":"update-step",plan:a,step:r,next_actions:W(i,a),warnings:[],generated_at:S()}}function Yp(e,t,n,o){Jp(e,t,n),Xp(e,t),e.status=n,e.updated_at=o,Zp(e,n,o)}function Jp(e,t,n){if(!(n!=="blocked"||t.stepBlockedReason?.trim()||e.blocked_reason))throw new m("Blocking a step requires --step-blocked-reason or an already-recorded blocked_reason.",u.USAGE)}function Xp(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=H(t.file).map(Vo),s=H(t.test).map(Wo),r=H(t.doc).map(Ko);o.length>0&&(e.files=Uo(e.files,o)),s.length>0&&(e.tests=Uo(e.tests,s)),r.length>0&&(e.docs=Uo(e.docs,r))}function Uo(e,t){let n=[...e??[]],o=new Set(n.map(s=>JSON.stringify(s)));for(let s of t){let r=JSON.stringify(s);o.has(r)||(o.add(r),n.push(s))}return n}function Zp(e,t,n){if(t==="completed"&&!e.completed_at){e.completed_at=n;return}t!=="completed"&&(e.completed_at=void 0)}async function Qp(e,t,n,o,s){let{document:r,itemId:i}=await ne({id:e,options:t,ctx:n,op:"plan_reorder_step",message:t.message??`plan reorder-step ${o} -> ${s}`,mutator(c){let l=Ke(c,o),d=c.filter(f=>f.id!==l.id),p=Math.max(1,Math.min(s,d.length+1));return d.splice(p-1,0,l),d.forEach((f,g)=>{f.order=g+1,f.updated_at=S()}),c.length=0,c.push(...d),{changedSteps:[l.id],resultStep:l}}}),a=V(r.metadata,"standard");return{action:"reorder-step",plan:a,next_actions:W(i,a),warnings:[],generated_at:S()}}async function eu(e,t,n,o){let{document:s,itemId:r}=await ne({id:e,options:t,ctx:n,op:"plan_remove_step",message:t.message??`plan remove-step ${o}`,mutator(a){let c=Ke(a,o),l=a.filter(d=>d.id!==c.id);return l.forEach((d,p)=>{d.order=p+1}),a.length=0,a.push(...l),{changedSteps:[c.id]}}}),i=V(s.metadata,"standard");return{action:"remove-step",plan:i,next_actions:W(r,i),warnings:[],generated_at:S()}}async function tu(e,t,n,o){let s=Yo(t,dl(t.linkKind,"related"));if(s.length===0)throw new m("pm plan link requires at least one --link/--related/--blocks/--blocked-by/--depends-on id",u.USAGE);let r=t.promoteToItemDep===!0,{document:i,itemId:a,resultStep:c}=await ne({id:e,options:t,ctx:n,op:"plan_link_step",message:t.message??`plan link ${o}`,mutator(d,p){let f=Ke(d,o),g=f.linked_items??[],v=y=>`${y.kind}:${y.id}`,w=new Set(g.map(v));for(let y of s){let _=v(y);w.has(_)||(g.push(y),w.add(_))}if(f.linked_items=g,f.updated_at=S(),r){let y=p.metadata.dependencies??[],_=R=>`${R.kind}:${R.id}`,k=new Set(y.map(_));for(let R of s){let x=R.kind==="depends_on"?"blocked_by":R.kind,F={id:R.id,kind:x,created_at:S(),author:C(t.author,n.settings.author_default)};k.has(_(F))||(y.push(F),k.add(_(F)))}p.metadata.dependencies=y}return{changedSteps:[f.id],resultStep:f}}}),l=V(i.metadata,"standard");return{action:"link",plan:l,step:c,next_actions:W(a,l),warnings:[],generated_at:S()}}async function nu(e,t,n,o){let s=X(t.link);if(s.length===0)throw new m("pm plan unlink requires --link <id> to remove",u.USAGE);let{document:r,itemId:i,resultStep:a}=await ne({id:e,options:t,ctx:n,op:"plan_unlink_step",message:t.message??`plan unlink ${o}`,mutator(l){let d=Ke(l,o),p=(d.linked_items??[]).filter(f=>!s.includes(f.id));return d.linked_items=p.length>0?p:void 0,d.updated_at=S(),{changedSteps:[d.id],resultStep:d}}}),c=V(r.metadata,"standard");return{action:"unlink",plan:c,step:a,next_actions:W(i,c),warnings:[],generated_at:S()}}async function Go(e,t,n,o){let s=Pp(o,t);if(!s){let l=`--${o}-text`,d=`--${o}`;throw new m(`pm plan ${o} requires ${l}`,u.USAGE,{code:"missing_required_option",examples:[`pm plan ${o} <plan-id> ${l} "..."`,`pm plan ${o} <plan-id> ${d} "..."`],recovery:{suggested_retry:`pm plan ${o} <plan-id> ${l} <value>`}})}let r=C(t.author,n.settings.author_default),{document:i,itemId:a}=await ne({id:e,options:t,ctx:n,op:`plan_append_${o}`,message:t.message??`plan ${o} append`,mutator(l,d){let p=S();if(o==="decision"){let g=d.metadata.plan_decisions??[];return g.push({ts:p,author:r,decision:s,rationale:t.decisionRationale?.trim()||void 0,evidence:t.decisionEvidence?.trim()||void 0}),d.metadata.plan_decisions=g,{changedSteps:[]}}if(o==="discovery"){let g=d.metadata.plan_discoveries??[];return g.push({ts:p,author:r,text:s}),d.metadata.plan_discoveries=g,{changedSteps:[]}}let f=d.metadata.plan_validation??[];return f.push({text:s,command:t.validationCommand?.trim()||void 0,expected:t.validationExpected?.trim()||void 0}),d.metadata.plan_validation=f,{changedSteps:[]}}}),c=V(i.metadata,"deep");return{action:o,plan:c,next_actions:W(a,c),warnings:[],generated_at:S()}}async function ou(e,t,n){let o=t.resumeContext?.trim();if(!o)throw new m("pm plan resume requires --resume-context <text>",u.USAGE);let{document:s,itemId:r}=await ne({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 l=t.scope?.trim();return l&&(c.metadata.plan_scope=l),{changedSteps:[]}}}),i=V(s.metadata,"brief");return{action:"resume",plan:i,next_actions:W(r,i),warnings:[],generated_at:S()}}async function su(e,t,n){let o=ll(t.mode??"approved","approved"),{document:s,itemId:r}=await ne({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 l=t.scope?.trim();return l&&(c.metadata.plan_scope=l),{changedSteps:[]}}}),i=V(s.metadata,"brief");return{action:"approve",plan:i,next_actions:W(r,i),warnings:[],generated_at:S()}}function _l(e){return e.map(t=>`plan_materialize_skipped:${t.from_step}:${t.reason}${t.existing_id?`:${t.existing_id}`:""}`)}function ru(e,t){let n=V(e.document.metadata,"standard");return{action:"materialize",plan:n,materialized:[],materialize_skipped:t,next_actions:W(e.itemId,n),warnings:_l(t),generated_at:S()}}function iu(e,t,n){let o=[`id=${e},kind=parent`,`id=${t},kind=discovered_from`];for(let s of n.linked_items??[]){let r=s.kind==="blocked_by"||s.kind==="blocks"||s.kind==="related"||s.kind==="discovered_from"?s.kind:"related";o.push(`id=${s.id},kind=${r}`)}return o}async function au(e){let t=[],n={},o=new Set(["title","description","type","parent","tags","author","message","dep"]);for(let s of H(e.options.field)){let r=s.indexOf("=");if(r<=0)throw new m(`Invalid --field entry "${s}"; expected name=value`,u.USAGE);let i=s.slice(0,r).trim(),a=s.slice(r+1).trim();if(i.length===0)throw new m(`Invalid --field entry "${s}"; 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 m(`Invalid --field entry "${s}"; expected name=value`,u.USAGE);let[l,...d]=c,p=`${l}${d.map(f=>`${f.slice(0,1).toUpperCase()}${f.slice(1)}`).join("")}`;if(o.has(p))throw new m(`Invalid --field entry "${s}"; "${p}" is reserved by materialize and cannot be overridden`,u.USAGE);n[p]=a}for(let s of e.targets){let r={...n,title:s.title,description:s.body?.trim()||s.title,type:e.resolvedTypeName,parent:e.parent,tags:e.tags,author:e.options.author,message:e.options.message??`materialized from plan ${e.planItemId} step ${s.id}`,dep:iu(e.parent,e.planItemId,s)};ul(e.options,r,["description",...Object.keys(n)]);let i=await wt(r,{path:e.pmRoot});t.push({id:i.item.id,title:i.item.title,type:e.resolvedTypeName,parent:i.item.parent,tags:i.item.tags??[],from_step:s.id})}return t}function cu(e,t,n){for(let o of t){let s=n.find(a=>a.from_step===o.id);if(!s)continue;let r=e.find(a=>a.id===o.id);if(!r)continue;let i=r.linked_items??[];i.push({id:s.id,kind:"implements",note:`materialized as ${s.type}`}),r.linked_items=i,r.updated_at=S()}}async function lu(e,t,n){let o=X(t.steps);if(o.length===0)throw new m("pm plan materialize requires --steps <ids|orders|all>",u.USAGE);let s=t.materializeType?.trim()||"Task",r=$(n.settings,T()),i=$t(s,r);if(!i)throw new m(`Invalid --materialize-type "${s}"`,u.USAGE);let a=t.materializeParent?.trim()||e,c=t.materializeTags,l=await pl(n,e),d=(l.document.metadata.plan_steps??[]).slice(),{targets:p,skipped:f}=$p(d,o);if(p.length===0){if(f.length>0)return ru(l,f);throw new m("No matching plan steps found for --steps",u.NOT_FOUND)}let g=await au({targets:p,parent:a,planItemId:l.itemId,resolvedTypeName:i,tags:c,options:t,pmRoot:n.pmRoot}),{document:v,itemId:w}=await ne({id:e,options:t,ctx:n,op:"plan_materialize",message:t.message??`plan materialize ${o.join(",")}`,mutator(_){return cu(_,p,g),{changedSteps:p.map(k=>k.id)}}}),y=V(v.metadata,"standard");return{action:"materialize",plan:y,materialized:g,...f.length>0?{materialize_skipped:f}:{},next_actions:W(w,y),warnings:_l(f),generated_at:S()}}function du(e){if(e.subcommand==="create")return e;let t=cl(e.options.step);if(t.length>1)throw new m(`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:lt(e.options,{...e.options,stepTitle:t[0]})}:e}function me(e,t){if(!e.id)throw new m(`pm plan ${t} requires a plan id`,u.USAGE);return e.id}function Fe(e,t){let n=me(e,t);if(!e.stepRef)throw new m(`pm plan ${t} requires <plan-id> <step>`,u.USAGE);return{id:n,stepRef:e.stepRef}}function mu(e){let t=Fe(e,"reorder-step");if(e.reorderTo===void 0)throw new m("pm plan reorder-step requires <plan-id> <step> <new-order>",u.USAGE);return{...t,reorderTo:e.reorderTo}}var pu={create:(e,t)=>Hp(e.options,e.global,t),show:(e,t)=>Bp(me(e,"show"),e.options,t),"add-step":(e,t)=>Wp(me(e,"add-step"),e.options,t),"update-step":(e,t)=>{let n=Fe(e,"update-step");return jo(n.id,e.options,t,{stepRef:n.stepRef,op:"plan_update_step"})},"complete-step":(e,t)=>{let n=Fe(e,"complete-step");return jo(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"completed",op:"plan_complete_step"})},"block-step":(e,t)=>{let n=Fe(e,"block-step");return jo(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"blocked",op:"plan_block_step"})},"reorder-step":(e,t)=>{let n=mu(e);return Qp(n.id,e.options,t,n.stepRef,n.reorderTo)},"remove-step":(e,t)=>{let n=Fe(e,"remove-step");return eu(n.id,e.options,t,n.stepRef)},link:(e,t)=>{let n=Fe(e,"link");return tu(n.id,e.options,t,n.stepRef)},unlink:(e,t)=>{let n=Fe(e,"unlink");return nu(n.id,e.options,t,n.stepRef)},decision:(e,t)=>Go(me(e,"decision"),e.options,t,"decision"),discovery:(e,t)=>Go(me(e,"discovery"),e.options,t,"discovery"),validation:(e,t)=>Go(me(e,"validation"),e.options,t,"validation"),resume:(e,t)=>ou(me(e,"resume"),e.options,t),approve:(e,t)=>su(me(e,"approve"),e.options,t),materialize:(e,t)=>lu(me(e,"materialize"),e.options,t)};function uu(e){let t=pu[e];if(!t)throw re({command_path:"plan",token:e,allowed:Sp});return t}async function hl(e){let t=await Mp(e.global),n=du(e);return uu(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]="64b269aa-d285-53bb-8949-b75bed767479")}catch{}})();function fu(e,t){return[...new Set([...Ns.filter(o=>e[o]!==void 0),...Object.keys(e).filter(o=>e[o]!==void 0),...t.length>0?["body"]:[]])].sort((o,s)=>o.localeCompare(s))}function _u(e,t){let n=`copied_from=${e}`;if(!t)return n;let o=t.trim();return o.length>0?`${o} | ${n}`:n}async function Jo(e,t,n){let o=I(process.cwd(),n.path);await O(o);let s=await E(o),r=$(s,T()),i=await ae(o,e,s.id_prefix,s.item_format,r.type_to_folder);if(!i)throw await Nt(o,e,s.id_prefix,r.type_to_folder);let a=await ge(i,{schema:s.schema}),c=a.document.metadata,l=S(),d=C(t.author,s.author_default),p=await Vn(o,s.id_prefix,{tokenLength:s.ids.token_length,typeToFolder:r.type_to_folder,probeExisting:!1}),f=j(s.schema),g=t.title?.trim();if(g!==void 0&&g.length===0)throw new m("Copy --title must not be empty",u.USAGE);let v={...c,id:p,title:g??c.title,status:f.open_status,created_at:l,updated_at:l};delete v.closed_at,delete v.completed_at,delete v.close_reason,delete v.test_runs;let w=je(T()),y=zn({metadata:v,body:a.document.body},{schema:s.schema,extensionFieldNames:w}),_=await _o({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[i.id]},{pmRoot:o,mode:s.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0?"off":s.governance.duplicate_detection_mode,threshold:s.governance.duplicate_detection_threshold,limit:s.governance.duplicate_detection_limit,allowDuplicate:t.allowDuplicate}),k=fu(y.metadata,y.body),R=On(o,y.metadata.type,p,s.item_format,r.type_to_folder),x=ke(o,p),F=await Q(o,p,s.locks.ttl_seconds,d,!1,s.governance.force_required_for_stale_lock,s.locks.wait_ms),N={metadata:{},body:""},Z,G;try{let nt=await Hr(o,d,{required:s.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0});try{s.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0&&await _o({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[i.id]},{pmRoot:o,mode:"strict",threshold:s.governance.duplicate_detection_threshold,limit:s.governance.duplicate_detection_limit,allowDuplicate:!1});let ue=await ae(o,p,s.id_prefix,s.item_format,r.type_to_folder);if(ue)throw new m(`Cannot copy to ${p}: an item with that id already exists at ${ue.itemPath}. Retry the copy to allocate a new id.`,u.CONFLICT,{code:"item_id_collision",why:`Allocated id ${p} already exists at ${ue.itemPath}.`,recovery:{suggested_retry:`pm copy ${i.id}`}});await te(R,mt(y,{format:s.item_format,schema:s.schema,extensionFieldNames:w}));try{let ee=pt({nowIso:l,author:d,op:"create",before:N,after:y,message:_u(i.id,t.message)});await ut(x,ee)}catch(ee){throw await st(R),ee}G=await Br({pmRoot:o,preferredFormat:s.item_format,typeToFolder:r.type_to_folder,schema:s.schema,itemPath:R,document:y})}finally{await nt()}Z=[...await q({path:R,scope:"project",op:"create",item_id:y.metadata.id,item_type:y.metadata.type,before:N,after:y,changed_fields:k}),...await q({path:x,scope:"project",op:"create:history",item_id:y.metadata.id,item_type:y.metadata.type,before:N,after:y,changed_fields:k})],Qs({id:y.metadata.id,op:"create",item_type:y.metadata.type,status:y.metadata.status,current:er(y.metadata,k),changed_fields:k})}finally{await F()}return{source_id:i.id,item:structuredClone(y.metadata),changed_fields:k,warnings:[...Ya(_),...G,...Z],..._===void 0?{}:{similarity_advisory:_}}}import mn 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]="eef2ba25-bbdb-5c06-9f90-1cf485e98497")}catch{}})();async function Xo(e,t,n){let o=I(process.cwd(),n.path);await O(o);let s=await E(o),r=C(t.author,s.author_default),i=await Kr({pmRoot:o,settings:s,id:e,author:r,message:t.message,force:t.force,dryRun:t.dryRun}),a=i.targetPath?mn.relative(o,i.targetPath).split(mn.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:mn.relative(o,ke(o,i.item.id)).split(mn.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]="8023e71b-f733-572c-bdc0-e9b8f481232c")}catch{}})();async function hu(e){await O(e)}async function Zo(e,t,n){let o=I(process.cwd(),n.path);if(await hu(o),t.clear===!0){if(e!==void 0)throw new m("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 p=await E(o),f=Hn(C(void 0,p.author_default));return await kr(o),await mo({pmRoot:o,settings:p,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 p=await vr(o);if(p===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 gu(o,p);return{action:"show",focused_item:p,title:f,message:`Focused on ${p}${f?` (${f})`:""}. New items default --parent to it.`}}let r=await E(o),i=$(r,T()),a=await ae(o,e,r.id_prefix,r.item_format,i.type_to_folder);if(!a)throw await Nt(o,e,r.id_prefix,i.type_to_folder);let c=Bn(a.id,r.id_prefix),l=await ge(a,{schema:r.schema}),d=gl(l.document.metadata.title);return await wr(o,c),await mo({pmRoot:o,settings:r,principal:Hn(C(void 0,r.author_default)),itemId:c}),{action:"set",focused_item:c,title:d,message:`Focused on ${c}${d?` (${d})`:""}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`}}async function gu(e,t){let n=await E(e),o=$(n,T()),s=await ae(e,t,n.id_prefix,n.item_format,o.type_to_folder);if(!s)return null;let r=await ge(s,{schema:n.schema});return gl(r.document.metadata.title)}function gl(e){return e.trim().length>0?e:null}import{readFile as yu,writeFile as bu}from"node:fs/promises";import vu 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]="47487ad3-22a0-52ac-8a42-ebaca439cb6e")}catch{}})();var yl=["item","history","relationship","json"];function wu(e){let t=e.trim().toLowerCase();if(yl.includes(t))return t;throw new m(`Unknown merge artifact "${e}". Supported values: ${yl.join(", ")}.`,u.USAGE)}function ku(e){if(e===void 0)return"ours";let t=e.trim().toLowerCase();if(t==="ours"||t==="theirs")return t;throw new m(`Unknown --prefer value "${e}". Supported values: ours, theirs.`,u.USAGE)}async function Qo(e,t){try{return await yu(e,"utf8")}catch{throw new m(`Cannot read merge ${t} file at ${e}.`,u.NOT_FOUND)}}async function Su(e){let t=I(process.cwd(),e.path);return await _e(it(t))?E(t):null}function Iu(e,t){return e.endsWith(".md")?"json_markdown":e.endsWith(".toon")?"toon":t?.item_format??"toon"}async function bl(e,t){let n=wu(e.artifact),o=ku(e.prefer),s=vu.resolve(e.outputPath??e.oursPath),[r,i,a]=await Promise.all([Qo(e.basePath,"base"),Qo(e.oursPath,"ours"),Qo(e.theirsPath,"theirs")]),c,l,d=[],p={};if(n==="history"){let g=Ca(r,i,a);c=g.merged,p.history={strategy:g.strategy,common_entries:g.common_entries,entries_from_ours:g.entries_from_ours,entries_from_theirs:g.entries_from_theirs,entries_total:g.entries_total,reanchored:g.reanchored}}else if(n==="relationship"){let g=Ta(r,i,a);c=g.merged,p.relationship={strategy:g.strategy,common_entries:g.common_entries,entries_from_ours:g.entries_from_ours,entries_from_theirs:g.entries_from_theirs,entries_total:g.entries_total,reanchored:g.reanchored}}else if(n==="item"){let g=await Su(t),v=Iu(e.itemPath??s,g),w=je(T()),y=xa(r,i,a,{format:v,schema:g?.schema,extensionFieldNames:w,preferred:o,conflictResolution:"latest_document_update"});if(c=y.merged,d.push(...y.conflict_fields),p.item={fields_from_theirs:y.fields_from_theirs,union_fields:y.union_fields,conflict_resolution:"latest_document_update",requested_preference_applied:!1},e.itemPath!==void 0){let _=Lt(c,{format:v,schema:g?.schema,extensionFieldNames:w}),k=_.metadata,R=[...new Set([...y.fields_from_theirs,...y.union_fields,...y.conflict_decisions.map(x=>x.field)])];l={cwd:process.cwd(),itemPath:e.itemPath,preferred:o,conflictResolution:"latest_document_update",fieldsFromTheirs:y.fields_from_theirs,unionFields:y.union_fields,mergedFieldHashes:Object.fromEntries(R.map(x=>[x,Ra(x==="body"?_.body:k[x])])),decisions:y.conflict_decisions,operation:await $a(process.cwd(),e.itemPath)}}}else{let g=Oa(r,i,a,{preferred:o});c=g.merged,d.push(...g.conflict_paths),p.json={paths_from_theirs:g.paths_from_theirs}}if(await bu(s,c,"utf8"),l!==void 0){let g=await Fa(l);g!==null&&(p.receipt=Te(g))}let f=[];if(d.length>0){let g=p.receipt===void 0?'Run "pm merge report" to inspect clone-local merge evidence.':`Run "pm merge report" and correlate receipt ${p.receipt.receipt_id} with item ${p.receipt.item_id}; clone-local discarded values are never copied into this result.`;f.push(`Both branches changed ${d.join(", ")}; the item driver kept the value from the later document update, with stable value order only as an equal-timestamp tie-break. --prefer does not apply to convergent item scalar conflicts. ${g} Review the merged file, re-apply the discarded change if needed, then "git add" it.`)}return n==="history"&&p.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:d.length===0,artifact:n,output_path:s,requested_preference:o,conflicts:d,...p,guidance:f,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]="5fd3624a-d36b-58e6-8053-f2c0626e0c10")}catch{}})();async function vl(e){if(e.cwd===null)return[];let t=[];for(let n of e.receipts){if(n.operation===void 0||!await Pa(e.cwd,n.item_path,n.operation))continue;let o={gitWorkspaceRoot:e.cwd,receipt:n};await ye(n.item_id,{dryRun:!0,mergeAbandonmentProof:o},e.global),e.dryRun||(await ye(n.item_id,{author:e.author??e.global.author,mergeAbandonmentProof:o,message:e.message??"Settle rebase receipt after exact original Git state restoration",auditOperation:"merge_reconcile",forceAuditEntry:!0,auditContext:{merge:{abandoned_receipts:[{...Te(n),reason:"original_git_state_restored",operation:n.operation}]}}},e.global),await Kt(e.cwd,n,{requireExisting:!0,settlement:"original_git_state_restored"})),t.push(n.id)}return t}import{readFile as Eu}from"node:fs/promises";import Au 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]="deef67cc-b902-5a4e-9c66-3839a1cdcc6f")}catch{}})();var Ru=4;function wl(e){let t=e.checks.find(a=>a.name==="integrity"),n=t?.details.counts,o=typeof n=="object"&&n!==null&&!Array.isArray(n)&&typeof n.missing_merge_receipt_history_references=="number"?n.missing_merge_receipt_history_references:0,s=t?.details.missing_merge_receipt_history_reference_details,r=t?.details.missing_merge_receipt_history_reference_details_truncated===!0,i=Array.isArray(s)?s.flatMap(a=>{if(typeof a!="object"||a===null||Array.isArray(a))return[];let c=a;return typeof c.item_id=="string"&&typeof c.history_line=="number"&&Number.isSafeInteger(c.history_line)&&typeof c.receipt_id=="string"?[{item_id:c.item_id,history_line:c.history_line,receipt_id:c.receipt_id}]:[]}):[];return{count:o,truncated:r,coordinates:i}}async function Cu(e,t){let n=[];for(let o of t){let s;try{s=await Eu(Au.join(e,"history",`${o.item_id}.jsonl`),"utf8")}catch{continue}let r=s.split(/\r?\n/)[o.history_line-1];if(r===void 0||r.trim().length===0)continue;let i;try{i=JSON.parse(r)}catch{continue}let a=ja(i,o.item_id).find(c=>c.receiptId===o.receipt_id);a===void 0||!Na(a)||a.eventTimestamp===void 0||Us(a.eventTimestamp,Da)>=0||n.push({...o,original_event_ts:a.eventTimestamp})}return n}async function Tu(e){if(e.options.dryRun===!0||e.options.force!==!0||e.candidates.length===0)return 0;let t=new Map;for(let n of e.candidates){let o=t.get(n.item_id)??[];o.push(n),t.set(n.item_id,o)}for(let[n,o]of t)await ye(n,{author:e.options.author??e.global.author,message:e.options.message??"accept unrecoverable pre-durable merge receipt references",force:!0,auditOperation:"merge_reconcile",forceAuditEntry:!0,auditContext:{merge:{missing_receipt_dispositions:o.map(s=>({receipt_id:s.receipt_id,original_history_line:s.history_line,original_event_ts:s.original_event_ts,reason:"legacy_clone_local_only"}))}}},e.global);return e.candidates.length}async function xu(e){try{return{status:"fulfilled",value:await ye(e.id,{dryRun:e.dryRun,author:e.options.author??e.global.author,message:e.options.message??"record field-aware branch merge provenance",force:e.options.force,auditOperation:"merge_reconcile",auditContext:e.auditContext,forceAuditEntry:!0,mergeReceiptProof:e.mergeReceiptProof},e.global)}}catch(t){return{status:"rejected",reason:t}}}function Ou(e){e.results.forEach((t,n)=>{let o=e.receiptOnlyIds[n];if(t.status==="fulfilled"){let s=t.value.changed?"repaired":"skipped_clean";e.repair.streams.push({id:o,outcome:s,entries_rehashed:t.value.history.entries_rehashed,entries_patch_repaired:t.value.history.entries_patch_repaired,reconciled_with_item:t.value.history.reconciled_with_item,...t.value.merge_receipt_proof?{merge_receipt_proof:t.value.merge_receipt_proof}:{},warnings:t.value.warnings}),e.repair.totals[s]+=1;return}e.repair.streams.push({id:o,outcome:"failed",error:t.reason instanceof Error?t.reason.message:String(t.reason)}),e.repair.totals.failed+=1})}async function $u(e){if(e.dryRun||e.repair.totals.failed>0)return 0;let t=new Set(e.repair.streams.flatMap(o=>o.merge_receipt_proof?.trusted?o.merge_receipt_proof.receipt_ids:[])),n=e.pendingReceipts.filter(o=>t.has(o.id));return await Promise.all(n.map(o=>Kt(e.gitWorkspaceRoot??process.cwd(),o,{requireExisting:!0}))),n.length}async function kl(e,t){let n=e.dryRun===!0,o=I(process.cwd(),t.path),s=await bt(t,{checkOnly:!0,full:!0,skipVectors:!0,skipDrift:!0}),r=wl(s),i=await Cu(o,r.coordinates),a=await sa(o),c=await La(a??process.cwd(),{includeLossless:!0,pmRoot:o});if(c.invalid_evidence_count>0)throw new m(`Merge reconciliation refused ${c.invalid_evidence_count} invalid receipt evidence file(s).`,u.CONFLICT,{code:"merge_receipt_evidence_invalid",required:"Every clone-local and durable receipt candidate must pass bounded-file, schema, and identity validation.",recovery:{suggested_retry:"pm health --check-only --full"}});let l=await Tu({candidates:i,options:e,global:t}),d=c.receipts,p=await vl({cwd:a,receipts:d,dryRun:n,author:e.author,message:e.message,global:t}),f=new Set(p),g=new Map;for(let M of d.filter(fe=>!f.has(fe.id))){let fe=g.get(M.item_id)??[];fe.push(M),g.set(M.item_id,fe)}let v=Object.fromEntries([...g].map(([M,fe])=>[M,{merge:{receipts:fe.map(Te)}}])),w=Object.fromEntries([...g].map(([M,fe])=>[M,{gitWorkspaceRoot:a,receipts:fe}])),y=await Yt({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:v,...d.length>0?{mergeReceiptProofById:w}:{}},t),_=new Set(y.streams.map(M=>M.id)),k=[...g.keys()].filter(M=>!_.has(M)),R=await Aa(k,Ru,M=>xu({id:M,dryRun:n,options:e,global:t,auditContext:v[M],mergeReceiptProof:w[M]}));Ou({receiptOnlyIds:k,results:R,repair:y});let x=await $u({dryRun:n,pendingReceipts:d,repair:y,gitWorkspaceRoot:a}),F=await Jt({checkHistoryDrift:!0,checkStorageIntegrity:!0},t),N=l===0?s:await bt(t,{checkOnly:!0,full:!0,skipVectors:!0,skipDrift:!0}),Z=wl(N),G=F.checks.every(M=>M.status==="ok"),nt=n?d.length===0:x+p.length===d.length,ue=[y.totals.failed===0,G,nt,Z.count===0,!Z.truncated].every(Boolean),ee=r.truncated||Z.truncated?"Missing receipt coordinates exceed the bounded detail response; each reviewed --force pass can disposition only the reported eligible batch. Repeat dry-run and --force passes until receipts.missing_history_references_after=0 and pm merge reconcile returns ok=true.":void 0,Gd=(n?["Review repair.streams, then rerun pm merge reconcile without --dry-run to apply audited repairs.",ee,"No Git hook is installed automatically; invoke this command from an explicit post-merge hook only when your repository policy opts in."]:ue?["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.",ee,...i.length>0&&l===0?["Pre-durable clone-local-only receipt references are eligible for an audited disposition; rerun with --force after reviewing receipts.legacy_disposition_eligible."]:[],"Do not commit repaired history streams as reconciled until pm merge reconcile returns ok=true."]).filter(M=>M!==void 0);return{ok:ue,dry_run:n,repair:y,receipts:{pending_before:d.length,reconciled:x,abandoned:p.length,summaries:d.map(Te),missing_history_references_before:r.count,legacy_disposition_eligible:i.length,legacy_disposition_recorded:l,missing_history_references_after:Z.count},validation:F,guidance:Gd,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]="66cead7f-c3f3-5073-82a5-ad1535f3f611")}catch{}})();function It(e){let t={...e.args,...e.options};return lt(e.options,t)}function pe(e,t){let n=h(e,t);if(n!==void 0)return n;throw new m(`Missing required parameter: ${t}`,u.USAGE)}function Ye(e){return typeof e=="string"?[e]:z(e)}function Sl(e){return ic(It(e),e.global)}function Il(e){let t=It(e),n=t.cursorMode;if(n!==void 0&&n!=="batch"&&n!=="row")throw new m("Mutation event cursor mode must be batch or row.",u.USAGE,{code:"invalid_event_cursor_mode"});let o=n;return ac({cwd:h(t,"cwd"),pmRoot:h(t,"path"),since:h(t,"since"),type:Ye(t.type),author:Ye(t.author),item:Ye(t.item),limit:t.limit===void 0?void 0:J(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:Ye(t.harness)},...t.agentInstance===void 0?{}:{agentInstance:Ye(t.agentInstance)},...t.provenanceFilter===void 0?{}:{provenanceFilter:Ye(t.provenanceFilter)}})}function El(e){let t=It(e),n=pe(t,"subcommand");if(n==="install")return ra({dryRun:t.dryRun===!0},e.global);if(n==="reconcile")return kl({dryRun:t.dryRun===!0,author:h(t,"author"),message:h(t,"message"),force:t.force===!0},e.global);if(n==="report")return Ma({includeReconciled:t.includeReconciled===!0,cwd:h(t,"cwd")});if(n==="driver")return bl({artifact:pe(t,"artifact"),basePath:pe(t,"basePath"),oursPath:pe(t,"oursPath"),theirsPath:pe(t,"theirsPath"),outputPath:h(t,"outputPath")??h(t,"output"),itemPath:h(t,"itemPath"),prefer:h(t,"prefer")},e.global);throw re({command_path:"merge",token:n,allowed:["install","reconcile","report","driver"],display_name:"merge"})}function Al(e){let t=It(e),n=pe(t,"subcommand");if(n==="position")return gc(e.global);if(n!=="snapshot")throw re({command_path:"workspace",token:n,allowed:["position","snapshot"],display_name:"workspace"});let o=h(t,"snapshotAction")??pe(t,"snapshot_action"),s=I(process.cwd(),e.global.path);if(o==="create")return mc(s,{name:h(t,"name")});if(o==="list")return uc(s);let r=pe(t,"target");if(o==="inspect")return pc(s,r);if(o==="delete")return hc(s,r);if(o==="restore")return t.dryRun===!0?fc(s,r):_c(s,r,{force:t.force===!0,author:h(t,"author"),message:h(t,"message"),lockTtlSeconds:J(t.lockTtlSeconds,"lockTtlSeconds"),lockWaitMs:J(t.lockWaitMs,"lockWaitMs")});throw re({command_path:"workspace snapshot",token:o,allowed:["create","list","inspect","restore","delete"],display_name:"workspace snapshot",token_kind:"action"})}function pn(e){let t=It(e),n=pe(t,"title");return e.action==="meet"?cc(n,t,e.global):e.action==="event"?lc(n,t,e.global):dc(n,t,e.global)}import ef 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]="ddcc068c-6727-5508-baa3-e089bcd0a0a9")}catch{}})();var Je=["agile","ops","research"],es={agile:{name:"agile",title:"Agile delivery",summary:"Story/Spike delivery with a review stage, story points, and acceptance ownership.",types:Vt.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:Vt.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:Vt.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 Pu(e){if(e===void 0)return;let t=we(e);if(t.length===0)throw new Error("Profile name must not be empty.");if(Je.includes(t))return t;throw new Error(`Invalid profile "${e}". Allowed: ${Je.join(", ")}.`)}function Kb(e){let t=Pu(e);if(t===void 0)throw new Error(`Profile name is required. Allowed: ${Je.join(", ")}.`);return es[t]}function Yb(){return Je.map(e=>es[e])}function we(e){return e.trim().toLowerCase().replaceAll("-","_")}function Rl(e){return e.map(t=>t.definition.name).join(", ")}function ts(e=[]){let t=Je.map(r=>({definition:es[r],source:"builtin"})),n=new Set(Je.map(r=>we(r))),o=new Set(n),s=[];for(let r of e){let i=we(r.profile.name);if(n.has(i)){s.push(`Extension "${r.name}" profile "${r.profile.name}" uses a name reserved by a built-in archetype and was ignored.`);continue}if(o.has(i)){s.push(`Profile "${r.profile.name}" from extension "${r.name}" duplicates an already-registered profile and was ignored.`);continue}o.add(i),t.push({definition:r.profile,source:"extension",package:r.name})}return{profiles:t,warnings:s}}function un(e,t=[]){let{profiles:n,warnings:o}=ts(t);if(typeof e!="string"||e.trim().length===0)throw new Error(`Profile name is required. Allowed: ${Rl(n)}.`);let s=we(e),r=n.find(i=>we(i.definition.name)===s);if(r===void 0)throw new Error(`Invalid profile "${e}". Allowed: ${Rl(n)}.`);return{resolved:r,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]="ab26bcb3-fb2a-5f2f-96e7-7965787b924e")}catch{}})();function os(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 Cl(e){return{name:e.name,title:e.title,summary:e.summary,composition:os(e),types:e.types.map(t=>ns(()=>ie(t).name,()=>String(t.name??""))),statuses:e.statuses.map(t=>ns(()=>Re(t).id,()=>String(t.id??""))),fields:e.fields.map(t=>ns(()=>Ce(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 ns(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]="38902c61-3d4d-52ad-a95c-fbac9102a041")}catch{}})();var mv=["profile","types","statuses","fields","workflows","config","templates","packages"],pv=["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"],Fu=new Set(_r.flatMap(e=>[Ue(e.id),...(e.aliases??[]).map(t=>Ue(t))]).filter(e=>e.length>0)),Tl=new Set(rt.map(e=>e.toLowerCase()));function Lu(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!==we(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 "${we(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 Mu(e,t){let n=new Set,o=new Set;for(let[s,r]of e.types.entries()){let i;try{i=ie(r).name}catch(c){t.push({severity:"error",code:"type_invalid",dimension:"types",target:typeof r.name=="string"?r.name:`#${s}`,message:he(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 Du(e,t){let n=new Set,o=new Set;for(let[s,r]of e.statuses.entries()){let i;try{i=Re(r)}catch(a){t.push({severity:"error",code:"status_invalid",dimension:"statuses",target:typeof r.id=="string"?r.id:`#${s}`,message:he(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(Ue(a))}return n}function Nu(e,t){let n=new Set;for(let[o,s]of e.fields.entries()){let r;try{r=Ce(s).key}catch(a){t.push({severity:"error",code:"field_invalid",dimension:"fields",target:typeof s.key=="string"?s.key:`#${o}`,message:he(a)});continue}if(n.has(r)){t.push({severity:"error",code:"field_duplicate",dimension:"fields",target:r,message:`Field "${r}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}n.add(r);let i=Gi(r);i&&t.push({severity:"warning",code:"field_mcp_input_collision",dimension:"fields",target:r,message:`Field "${r}" collides with canonical MCP property "${i.property}" owned by ${i.owner}; callers must pass the custom value through ${i.nested_path}.`})}}function ju(e,t,n,o){let s=new Set;for(let[r,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:`#${r}`,message:"Workflow has an empty type; the workflow resolver drops entries without a type."});continue}let c=s.has(a);s.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.`}):!Tl.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 l=new Set;for(let d of i.allowed_transitions){let p=Ue(d[0]),f=Ue(d[1]);if(p.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 g of[p,f])Fu.has(g)||n.has(g)||l.has(g)||(l.add(g),o.push({severity:"warning",code:"workflow_status_unknown",dimension:"workflows",target:g,message:`Workflow "${i.type}" references status "${g}" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`}))}}}function Uu(e,t){let n=new Set;for(let o of e.config){let s=Ve(o.key);if(s===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(s.key)?t.push({severity:"error",code:"config_duplicate",dimension:"config",target:s.key,message:`Config knob "${s.key}" is set more than once; the later value silently overwrites the earlier one.`}):n.add(s.key);let r=tn(s,o.value);r.ok||t.push({severity:"error",code:"config_value_invalid",dimension:"config",target:o.key,message:r.error.message})}}function Gu(e,t,n){for(let o of e.templates){let s=o.options.type;if(typeof s!="string"||s.trim().length===0)continue;let r=s.trim().toLowerCase();!Tl.has(r)&&!t.has(r)&&n.push({severity:"warning",code:"template_type_unknown",dimension:"templates",target:o.name,message:`Template "${o.name}" creates type "${s}" which is neither a built-in type nor declared by this profile.`})}}function qu(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 xl(e){let t=[];Lu(e,t);let n=Mu(e,t),o=Du(e,t);Nu(e,t),ju(e,n,o,t),Uu(e,t),Gu(e,n,t),qu(e,t);let s=t.filter(i=>i.severity==="error").length,r=t.length-s;return{profile:e.name,ok:s===0,findings:t,errorCount:s,warningCount: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]="9b9004b5-2446-539c-9adc-75aeaa3acbba")}catch{}})();function ss(e,t,n,o,s){let r=e,i=[];for(let a of t){let c=o(r),l=s(r,a),d=o(l.file);r=l.file;let p=c===d?"unchanged":l.replaced?"update":"add";i.push({key:n(a),status:p})}return{file:r,changes:i,changed:i.some(a=>a.status!=="unchanged")}}function Ol(e){return JSON.stringify(e.map(t=>t.join("\0")).sort())}function zu(e,t){let n=e.map(s=>({...s})),o=[];for(let s of t){let r=n.findIndex(a=>a.type===s.type),i={type:s.type,allowed_transitions:s.allowed_transitions};r<0?(n.push(i),o.push({type:s.type,status:"add"})):Ol(n[r].allowed_transitions)===Ol(s.allowed_transitions)?o.push({type:s.type,status:"unchanged"}):(n[r]=i,o.push({type:s.type,status:"update"}))}return{changes:o,result:n,changed:o.some(s=>s.status!=="unchanged")}}function Hu(e,t){let n=[];for(let o of e.config){let s=Ve(o.key);if(s===void 0)throw new Error(`Profile "${e.name}" references unknown config key "${o.key}".`);let r=tn(s,o.value);if(!r.ok)throw new Error(`Profile "${e.name}" config ${o.key}: ${r.error.message}`);let i=tc(t,s),a=i===null?"add":i===r.parsed.value?"unchanged":"update";n.push({key:s.key,path:s.path,value:r.parsed.value,status:a})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function $l(e){let t=Object.entries(e).sort(([n],[o])=>n.localeCompare(o));return JSON.stringify(t)}function Bu(e,t){let n=[];for(let o of e.templates){let s=t.get(o.name),r;s===void 0?r="add":$l(s)===$l(o.options)?r="unchanged":r="update",n.push({name:o.name,options:o.options,status:r})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function Pl(e,t){let n=ss(Dr(t.typesRaw),e.types,d=>ie(d).name,Dt,(d,p)=>Nr(d,ie(p))),o=ss(ia(t.statusesRaw),e.statuses,d=>Re(d).id,Ht,(d,p)=>aa(d,Re(p))),s=ss(ca(t.fieldsRaw),e.fields,d=>Ce(d).key,Bt,(d,p)=>la(d,Ce(p))),r=zu(t.workflows,e.workflows),i=Hu(e,t.settings),a=Bu(e,t.templates),c=e.packages.map(d=>({spec:d.spec,reason:d.reason,status:t.installedPackages.has(d.spec)?"installed":"recommended"})),l=n.changed||o.changed||s.changed||r.changed||i.changed||a.changed;return{profile:{name:e.name,title:e.title,summary:e.summary},types:n,statuses:o,fields:s,workflows:r,config:i,templates:a,packages:c,changed:l}}import Ll from"node:fs/promises";import Ml 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]="ff76c0f3-d8cf-51de-a7e6-acb0a4942268")}catch{}})();var Vu="templates",rs=".json",Dl=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/,Wu=ci.map(e=>e.target).filter(e=>e!=="acceptanceCriteria"),Ku=new Set(Wu),Fl="1970-01-01T00:00:00.000Z",Nl={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
+`}},Ov={normalizeTemplateName:fn,extractTemplateOptions:jl,parseStoredTemplateDocument:ls,builtinTemplateDocument:Ul,readStoredTemplateDocument:ql};function fn(e){let t=e.trim();if(!Dl.test(t))throw new m(`Invalid template name "${e}". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`,u.USAGE);return t}function is(e){return Ml.join(e,Vu)}function _n(e,t){return Ml.join(is(e),`${t}${rs}`)}async function as(e){await O(e)}function cs(e){return Object.fromEntries(Object.entries(e).sort(([t],[n])=>t.localeCompare(n)))}function jl(e){let t={};for(let[n,o]of Object.entries(e))if(o!==void 0){if(Ku.has(n)){if(typeof o=="string"){t[n]=[o];continue}if(!Array.isArray(o))continue;let s=o.filter(r=>typeof r=="string");s.length>0&&(t[n]=s);continue}if(typeof o=="string"){t[n]=o;continue}Array.isArray(o)&&o.every(s=>typeof s=="string")&&(t[n]=[...o])}return cs(t)}function Yu(e,t){if(typeof e!="object"||e===null||Array.isArray(e))throw new m(`Template "${t}" has invalid options payload.`,u.GENERIC_FAILURE);let n=e,o={};for(let[s,r]of Object.entries(n)){let i=s.trim();if(i.length===0)throw new m(`Template "${t}" contains an empty option key.`,u.GENERIC_FAILURE);if(typeof r=="string"){o[i]=r;continue}if(Array.isArray(r)&&r.every(a=>typeof a=="string")){o[i]=[...r];continue}throw new m(`Template "${t}" contains invalid value for option "${i}".`,u.GENERIC_FAILURE)}return cs(o)}function ls(e,t){let n;try{n=JSON.parse(e)}catch{throw new m(`Template "${t}" contains invalid JSON.`,u.GENERIC_FAILURE)}if(typeof n!="object"||n===null||Array.isArray(n))throw new m(`Template "${t}" has invalid document shape.`,u.GENERIC_FAILURE);let o=n,s=Yu(o.options,t),r=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:r,updated_at:typeof o.updated_at=="string"?o.updated_at:r,options:s}}function Ul(e){let t=Nl[e];return t?{name:e,created_at:Fl,updated_at:Fl,options:cs({...t})}:null}async function Gl(e,t){let n=await se(_n(e,t));if(n!==null)return{document:ls(n,t),source:"user"};let o=Ul(t);if(o)return{document:o,source:"builtin"};throw new m(`Template "${t}" not found`,u.NOT_FOUND)}async function ql(e,t){let n=await se(_n(e,t));if(n===null)throw new m(`Template "${t}" not found`,u.NOT_FOUND);return ls(n,t)}async function Ju(e,t){let n=fn(t),{document:o}=await Gl(e,n);return o.options}async function ds(e,t,n){let o=I(process.cwd(),n.path);await as(o);let s=fn(e),r=jl(t);if(Object.keys(r).length===0)throw new m("templates save requires at least one create option flag",u.USAGE);let i=S(),a=_n(o,s),c=i;await _e(a)&&(c=(await ql(o,s)).created_at);let l={name:s,created_at:c,updated_at:i,options:r},d=await E(o);return await Ll.mkdir(is(o),{recursive:!0}),await ze({pmRoot:o,filePath:a,raw:`${JSON.stringify(l,null,2)}
+`,op:"templates:save",author:C(void 0,d.author_default),lockTtlSeconds:d.locks.ttl_seconds,lockWaitMs:d.locks.wait_ms}),{name:l.name,created_at:l.created_at,updated_at:l.updated_at,path:a,options:l.options}}async function Xu(e){let t=is(e);return await _e(t)?(await Ll.readdir(t)).filter(o=>o.toLowerCase().endsWith(rs)).map(o=>o.slice(0,-rs.length)).filter(o=>Dl.test(o)):[]}async function Zu(e){let t=I(process.cwd(),e.path);await as(t);let n=await Xu(t),o=new Set(n),s=Object.keys(Nl).filter(c=>!o.has(c)),r=[...n].sort((c,l)=>c.localeCompare(l)),i=[...s].sort((c,l)=>c.localeCompare(l)),a=[...new Set([...r,...i])].sort((c,l)=>c.localeCompare(l));return{templates:a,count:a.length,builtin_templates:i,user_templates:r}}async function Qu(e,t){let n=I(process.cwd(),t.path);await as(n);let o=fn(e),{document:s,source:r}=await Gl(n,o);return{name:s.name,source:r,created_at:s.created_at,updated_at:s.updated_at,path:r==="builtin"?`builtin:${o}`:_n(n,o),options:s.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]="5529deea-21db-509b-9562-d5e08dfc004a")}catch{}})();var Vl=["list","show","apply","lint"],tf="schema-types",nf="schema-statuses",of="schema-fields";function hn(){let e=T();return e===null?[]:e.profiles.map(t=>({name:t.name,profile:t.profile}))}function Wl(){let{profiles:e,warnings:t}=ts(hn());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:os(n.definition)})),warnings:t,generated_at:S()}}function Kl(e){let t;try{t=un(e,hn())}catch(o){throw new m(o instanceof Error?o.message:String(o),u.USAGE)}let{resolved:n}=t;return{action:"show",...Cl(n.definition),source:n.source,...n.package!==void 0?{package:n.package}:{},warnings:t.warnings,generated_at:S()}}function Yl(e){let t;try{t=un(e,hn())}catch(s){throw new m(s instanceof Error?s.message:String(s),u.USAGE)}let{resolved:n}=t,o=xl(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 sf(e,t){return ef.join(e,"templates",`${t}.json`)}async function rf(e,t){let n=await se(sf(e,t));if(n!==null)try{let o=JSON.parse(n);if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let s=o.options;if(s!==null&&typeof s=="object"&&!Array.isArray(s))return s}}catch{}}async function zl(e,t,n,o){let s=new Map;for(let r of o.templates){let i=await rf(e,r.name);i!==void 0&&s.set(r.name,i)}return{typesRaw:await se(Ie(e,t.files.types,Se.types)),statusesRaw:await se(Ie(e,t.files.statuses,Se.statuses)),fieldsRaw:await se(Ie(e,t.files.fields,Se.fields)),workflows:n.schema.type_workflows??[],settings:n,templates:s,installedPackages:new Set}}function Xe(e){let t=[],n=[],o=[];for(let s of e)(s.status==="add"?t:s.status==="update"?n:o).push(s.key);return{added:t,updated:n,unchanged:o}}function Hl(e,t,n,o,s){return{action:"apply",name:e.name,title:e.title,applied:n,dry_run:o,changed:t.changed,types:Xe(t.types.changes),statuses:Xe(t.statuses.changes),fields:Xe(t.fields.changes),workflows:Xe(t.workflows.changes.map(r=>({key:r.type,status:r.status}))),config:Xe(t.config.changes),templates:Xe(t.templates.changes.map(r=>({key:r.name,status:r.status}))),packages:t.packages,warnings:[...new Set(s)].sort((r,i)=>r.localeCompare(i)),generated_at:S()}}async function af(e){await O(e)}function cf(e){try{let t=un(e,hn());return{profile:t.resolved.definition,warnings:t.warnings}}catch(t){throw new m(t instanceof Error?t.message:String(t),u.USAGE)}}async function Jl(e,t,n){let o=I(process.cwd(),n.path);await af(o);let s=cf(e),r=s.profile,i=s.warnings,a=t.dryRun===!0,c=await E(o),l=hr(c.schema);if(a){let _=await zl(o,l,c,r),k=Bl(r,_);return Hl(r,k,!1,!0,[...i])}let d=C(t.author,c.author_default),p=Ur(c),f=!!t.force,g=[...i],v=[],w=async _=>{v.push(await Q(o,_,c.locks.ttl_seconds,d,f,p.force_required_for_stale_lock,c.locks.wait_ms))},y;try{await w(tf),await w(nf),await w(of);let _=await zl(o,l,c,r);if(y=Bl(r,_),y.types.changed){let k=Ie(o,l.files.types,Se.types);await ze({pmRoot:o,filePath:k,raw:Dt(y.types.file),op:"profile:apply-types",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms});let R=new Set(r.types.map(F=>ie(F).name)),x=y.types.file.definitions.filter(F=>R.has(F.name));await fa(o,x,g,"profile:apply-type-folder"),g.push(...await q({path:k,scope:"project",op:"profile:apply-types"}))}if(y.statuses.changed){let k=Ie(o,l.files.statuses,Se.statuses);await ze({pmRoot:o,filePath:k,raw:Ht(y.statuses.file),op:"profile:apply-statuses",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),g.push(...await q({path:k,scope:"project",op:"profile:apply-statuses"}))}if(y.fields.changed){let k=Ie(o,l.files.fields,Se.fields);await ze({pmRoot:o,filePath:k,raw:Bt(y.fields.file),op:"profile:apply-fields",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),g.push(...await q({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 R=Ve(k.key);R!==void 0&&nc(c,R,k.value)}c.schema.type_workflows=y.workflows.result,await Gr(o,c,"profile:apply-config")}for(let k of y.templates.changes)k.status!=="unchanged"&&await ds(k.name,{...k.options},n)}finally{for(let _ of v.reverse())try{await _()}catch{}}return Hl(r,y,y.changed,!1,g)}function Bl(e,t){try{return Pl(e,t)}catch(n){throw new m(n instanceof Error?n.message:String(n),u.USAGE)}}function lf(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 nw(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 ow(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 sw(e){let t=e.source==="extension"?` [${e.package??"extension"}]`:"",n=e.warning_count+e.warnings.length,s=[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 r of e.findings){let i=r.target!==void 0?` (${r.target})`:"";s.push(`  ${r.severity} [${r.code}] ${r.dimension}${i}: ${r.message}`)}for(let r of e.warnings)s.push(`  warning: ${r}`);return s.join(`
+`)}function rw(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[s,r]of[["types",e.types],["statuses",e.statuses],["fields",e.fields],["workflows",e.workflows],["config",e.config],["templates",e.templates]]){let i=lf(s,r);i!==void 0&&n.push(i)}let o=e.packages.filter(s=>s.status==="recommended");o.length>0&&n.push(`  recommended packages: ${o.map(s=>s.spec).join(", ")}`);for(let s of e.warnings)n.push(`  warning: ${s}`);return n.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]="41f0e5cd-5974-5451-9f34-2aec1d8df07c")}catch{}})();function Xl(e){let t=e.options.all===!0,n=e.id??h(e.options,"id");return Ua(n,t),t?Yt(e.options,e.global):ye(n,e.options,e.global)}function Zl(e){let t=e.options.ids,n=fr(t);if(t!==void 0&&n==="")throw new m("history-compact ids requires at least one valid item ID.",u.USAGE,{code:"bulk_ids_input_empty",required:"Provide one or more string or finite numeric IDs; non-finite and unsupported selector values are rejected."});let o=n===void 0?void 0:ur(n),s=J(e.options.allOver??e.options.all_over,"history-compact allOver"),r=J(e.options.minEntries??e.options.min_entries,"history-compact minEntries"),i=h(e.options,"scope"),a=[];e.options.closed===!0&&a.push("closed"),(e.options.allStreams===!0||e.options.all_streams===!0)&&a.push("all-streams"),(i==="closed"||i==="all-streams")&&a.push(i);let c=[...new Set(a)];if(c.length>1)throw new m("history-compact: closed and all-streams scopes are mutually exclusive.",u.USAGE);let l=c[0];return vc(e.id,{ids:o,allOver:s,scope:l}),e.id!==void 0?bc(e.id,{before:h(e.options,"before"),dryRun:e.options.dryRun===!0||e.options.dry_run===!0,author:h(e.options,"author"),message:h(e.options,"message"),force:e.force},e.global):wc({ids:o,scope:l,allOver:s,minEntries:r,dryRun:e.options.dryRun===!0||e.options.dry_run===!0,author:h(e.options,"author"),message:h(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]="cd0e532e-0f27-5786-8216-c17132f6e784")}catch{}})();async function ms(e,t,n,o){let s=t.trim();if(s.length===0)throw new m("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 r=I(process.cwd(),o.path),i=j((await E(r)).schema),a=i.open_status,c=nn(i),l=n.status??a,d=Ee(l,i)??l;if(d!==a&&d!==c)throw new m(`Reopen target status must be ${a} or ${c}; received ${l}.`,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} "${s}" --status ${a}`,suggested_retry_args:["item","reopen",e,s,"--status",a]}});let p=await Za(e,{status:d,unset:["close-reason","resolution","expected-result","actual-result","fixed-version"],author:n.author,message:n.message,force:n.force},o,s);return{item:p.item,changed_fields:p.changed_fields,warnings:p.warnings,recurrence:p.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]="ddf427ce-aa09-5f14-be4d-d5e25c91eef0")}catch{}})();async function Ql(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),s=e.force===!0||o.force===!0,r={...e.args,...o},i=e.args.next===!0||o.next===!0?await Wa(s,e.global,r,r):await Qt(ps(e,o),s,e.global,r);return Y(i,{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function ps(e,t){let n=e.id??h(t,"id");if(!n)throw new m("Missing required argument: id",64);return n}function ed(e,t){return h(e.args,"reason")??h(e.args,"text")??h(t,"reason")??h(t,"text")}async function td(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return Y(await xe(ps(e,o),ed(e,o),{...o,force:e.force===!0||o.force===!0},e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function nd(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return Y(await ms(ps(e,o),ed(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]="419a061f-e181-5b18-9e3a-d22cc5aff416")}catch{}})();function od(e,t,n){let o;if(typeof e.lines=="string")o=io(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=io(`${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]="086d2640-2a64-554a-9e40-a8f6994ae3a8")}catch{}})();function sd(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:h(e,"metric"),measurementLimit:typeof e.measurementLimit=="number"?e.measurementLimit:void 0,observe:z(e.observe),direction:typeof e.improvementDirection=="string"?e.improvementDirection:void 0,measurementSource:h(e,"measurementSource"),measurementItem:h(e,"measurementItem"),measurementRevision:h(e,"measurementRevision"),author:h(e,"author"),message:h(e,"message"),provenanceCoverage:e.provenanceCoverage===!0,fleetAttribution:e.fleetAttribution===!0,since:h(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]="4277a72c-f012-55d2-9e18-c9a836d829d6")}catch{}})();var df=new Set(["true","1","yes","on"]),mf=new Set(["false","0","no","off"]);function pf(e,t,n=[]){let o=[t,...n];for(let s of o){let r=e[s];if(typeof r=="string"&&r.trim().length>0)return r.trim()}}function uf(e,t,n=[]){let o=[t,...n];for(let s of o){let r=e[s];if(r!==void 0){if(typeof r=="boolean")return r;if(typeof r=="string"){let i=r.trim().toLowerCase();if(df.has(i))return!0;if(mf.has(i))return!1}}}}function ff(e,t,n=[]){for(let o of[t,...n]){let s=e[o],i=(typeof s=="string"?s.split(","):Array.isArray(s)?s.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]="f248824b-d56a-52ec-ac50-8b69b5ab1c99")}catch{}})();function U(e){if(typeof e!="string")return;let t=e.trim();return t.length>0?t:void 0}function _f(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 hf(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 gf(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"?ct(e):[]}function yf(e){let t=U(e);if(t){let n=Ee(t);if(n)return n}return"open"}function fs(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 rd(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 Ze(e){if(!Array.isArray(e))return;let t=e.map(n=>U(n)).filter(n=>n!==void 0);return t.length>0?t:void 0}function us(e){return cd(e,U)}function id(e){return cd(e,dd)}function bf(e,t){if(typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=100)return e;let n=U(e)?.toLowerCase();if(!n)return;let o=n==="med"?"medium":n;if(t.some(r=>r===o))return o;let s=Number(o);return Number.isInteger(s)&&s>=0&&s<=100?s:void 0}function ad(e,t){let n=U(e)?.toLowerCase();if(!n)return;let o=n==="med"?"medium":n;return t.includes(o)?o:void 0}function _s(e){return U(e)?.toLowerCase()==="global"?"global":"project"}function vf(e,t){let n=hs(e,t.allowScalar===!0);if(!n)return;let o=n.map(s=>Ef(s,t)).filter(s=>s!==void 0);return o.length>0?o:void 0}function wf(e,t={}){return ld(e,t,(n,o)=>({path:n,scope:_s(o?.scope),note:U(o?.note)}))}function kf(e,t={}){return ld(e,t,(n,o)=>({path:n,scope:_s(o?.scope),note:U(o?.note)}))}function Sf(e,t={}){let n=hs(e,t.allowScalar===!0);if(!n)return;let o=n.map(s=>Cf(s,t)).filter(s=>s!==void 0);return o.length>0?o:void 0}function If(e,t){return C(e,t)}function yn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function hs(e,t){return Array.isArray(e)?e:t?[e]:void 0}function gn(e,t){for(let n of t){let o=U(e[n]);if(o)return o}}function cd(e,t){if(!yn(e))return;let n=Object.entries(e).map(([o,s])=>[o.trim(),t(s)]).filter(o=>o[0].length>0&&o[1]!==void 0);return n.length>0?Object.fromEntries(n):void 0}function Ef(e,t){if(typeof e=="string")return Af(e,t);if(!yn(e))return;let n=gn(e,t.textKeys??["text"]);if(!n)return;let o=t.createdAtKey??"created_at",s=t.authorKey??"author";return{created_at:(t.toIsoString?t.toIsoString(e[o]):U(e[o]))??t.fallbackCreatedAt,author:U(e[s])??t.fallbackAuthor,text:n}}function Af(e,t){let n=U(e);return n?{created_at:t.fallbackCreatedAt,author:t.fallbackAuthor,text:n}:void 0}function ld(e,t,n){let o=hs(e,t.allowScalar===!0);if(!o)return;let s=t.pathKeys??["path"],r=o.map(i=>Rf(i,s,n)).filter(i=>i!==void 0);return r.length>0?r:void 0}function Rf(e,t,n){if(typeof e=="string"){let s=U(e);return s?n(s):void 0}if(!yn(e))return;let o=gn(e,t);return o?n(o,e):void 0}function Cf(e,t){if(typeof e=="string"){let s=U(e);return s?{command:s,scope:"project"}:void 0}if(!yn(e))return;let n=gn(e,t.commandKeys??["command"]),o=gn(e,t.pathKeys??["path"]);if(!(!n&&(t.requireCommand===!0||!o)))return{...n?{command:n}:{},...o?{path:o}:{},scope:_s(e.scope),timeout_seconds:Tf(e.timeout_seconds,t),note:U(e.note),...t.includeExtendedAssertions===!0?xf(e):{}}}function Tf(e,t){let n=t.integerTimeout===!0?fs(e):dd(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 dd(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 xf(e){return{pm_context_mode:ad(e.pm_context_mode,["schema","tracker","auto"]),env_set:us(e.env_set),env_clear:Ze(e.env_clear),shared_host_safe:rd(e.shared_host_safe),assert_stdout_contains:Ze(e.assert_stdout_contains),assert_stdout_regex:Ze(e.assert_stdout_regex),assert_stderr_contains:Ze(e.assert_stderr_contains),assert_stderr_regex:Ze(e.assert_stderr_regex),assert_stdout_min_lines:fs(e.assert_stdout_min_lines),assert_json_field_equals:us(e.assert_json_field_equals),assert_json_field_gte:id(e.assert_json_field_gte)}}async function Of(e){await O(e)}function md(){return{metadata:{},body:""}}async function $f(e){let{pmRoot:t,id:n,itemPath:o,document:s,author:r,message:i,settings:a,conflictWarningPrefix:c}=e,l=ke(t,n),d=md();try{let p=await Q(t,n,a.locks.ttl_seconds,r,!1,a.governance.force_required_for_stale_lock,a.locks.wait_ms);try{await te(o,mt(s,{format:"toon"}));try{let f=pt({nowIso:S(),author:r,op:"import",before:d,after:s,message:i});return await ut(l,f),{committed:!0,writeWarnings:[...await q({path:o,scope:"project",op:"import",item_id:s.metadata.id,item_type:s.metadata.type,before:d,after:s,changed_fields:["imported"]}),...await q({path:l,scope:"project",op:"import:history",item_id:s.metadata.id,item_type:s.metadata.type,before:d,after:s,changed_fields:["imported"]})]}}catch(f){throw await st(o),f}}finally{await p()}}catch(p){if(p instanceof m&&p.exitCode===u.CONFLICT)return{committed:!1,conflictWarning:`${c}:${n}`};throw p}}import{readFile as Ff}from"node:fs/promises";import Lf 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]="780365af-6d4c-5313-865b-23b8c68f889f")}catch{}})();function Pf(e){return e.trim().toLowerCase().replaceAll("_","-")}var ys=[{id:"capabilities",aliases:["capability-map","families","routing"],title:"Generated Capability Routing",summary:"Route work through command families generated from the canonical agent capability contract.",intent:"Use this as the drift-free entrypoint when selecting a CLI, MCP, completion, documentation, or extension command surface.",commands:Ic().flatMap(({commands:e})=>e.map(t=>`pm ${t}`)),workflows:[],docs:[{path:"docs/generated/AGENT_CAPABILITY_ROUTING.md",purpose:"Generated command-to-family routing table."},{path:"docs/generated/AGENT_COMMAND_SURFACE.md",purpose:"Generated visibility-tier and family table."}],related:["commands","workflows","extensions"]},{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 package install <target> --project","pm package 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 package 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 merge report","pm merge reconcile --dry-run","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:"Settle A Merge Before Trusting Health",goal:"A lossless merge still leaves pending receipts that strict health reports until they are reconciled.",prompt:"After any branch merge that touched tracker data, read the merge report, preview the reconciliation, then apply it; only then treat a health verdict as a statement about the data.",commands:["pm merge report","pm merge reconcile --dry-run",'pm merge reconcile --message "Post-merge history reconciliation"',"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"]},{id:"evidence",aliases:["record","annotations","learnings","history-maintenance"],title:"Evidence, Durable Knowledge, and Record Maintenance",summary:"Append comments, notes, learnings, files, docs, and tests to items, and maintain the immutable history those records live in.",intent:"Use this when work must be explained to the next agent, when a durable lesson should outlive the item, or when a history stream needs verification, repair, redaction, compaction, or author attribution.",commands:['pm comments <ID> "<progress or verification evidence>"','pm notes <ID> --add "<rationale that belongs on the item>"','pm learnings <ID> --add "<lesson that should outlive the item>"',"pm append <ID> --body -","pm files <ID> --add path=<path>,scope=project,note=<why>","pm history <ID> --verify --strict-exit","pm history-repair --all --dry-run","pm history-redact <ID> --literal <secret> --dry-run","pm history-compact <ID> --dry-run","pm history-author-acknowledge --all-actionable --dry-run","pm close-many --ids <ID>,<ID> --reason <text> --dry-run","pm test-all --status open --limit 10 --progress"],workflows:[{name:"Record While Working, Not After",goal:"Another agent can rebuild the full situation from the item alone.",prompt:"Add a comment for each verified step, a note for each rationale the item body does not carry, and a learning for each lesson that applies beyond this item. Prefer appending over rewriting.",commands:['pm comments <ID> "Evidence: <what changed and what passed>"','pm notes <ID> --add "Decision log: <why this shape>"','pm learnings <ID> --add "<durable lesson>"',"pm learnings <ID> --limit 5"]},{name:"Verify And Repair A History Stream",goal:"Every mutation stays provable and the chain re-anchors after drift.",prompt:"Verify the chain with a strict exit before trusting a stream, preview any repair, and record why the repair was needed in the audit message.",commands:["pm history <ID> --verify --strict-exit","pm history-repair --all --dry-run",'pm history-repair --all --message "<why the chain drifted>"',"pm validate --check-history-drift"]},{name:"Redact, Compact, Or Attribute Without Losing Proof",goal:"Sensitive text, stream length, and unknown authors are handled through audited rewrites.",prompt:"Preview every history rewrite with --dry-run, read the receipt, then apply. Compaction renumbers ordinal versions, so record the checkpoint it created.",commands:["pm history-redact <ID> --literal <secret> --dry-run","pm history-compact <ID> --dry-run","pm history-author-acknowledge --all-actionable --dry-run"]}],docs:[{path:"docs/COMMANDS.md",purpose:"Annotation, bulk, and history-and-recovery command families."},{path:"docs/MUTATION_INTEGRITY.md",purpose:"Provenance and content-safety policy every mutation shares."},{path:"docs/AGENT_GUIDE.md",purpose:"Evidence expectations in the agent loop and self-repair remediation."}],related:["workflows","assurance","merge","graph"]},{id:"automation",aliases:["calendar","reminders","meetings","events"],title:"Reminders, Events, and Meetings",summary:"Attach time to items so context and agenda views can surface deadlines, meetings, and reminders when they matter.",intent:"Use this when an item needs a due signal, a scheduled event, or a meeting record that later context reads should surface.",commands:["pm remind <title> --at <when> --parent <ID>","pm event <title> --start <when> --parent <ID>","pm meet <title> --start <when> --duration <span> --parent <ID>","pm context --limit 10"],workflows:[{name:"Put A Deadline Where Context Will Find It",goal:"Time-bound work surfaces in the agenda section of context reads.",prompt:"Record the reminder or event under the item that owns the work, then confirm it appears in the agenda summary of a context read.",commands:["pm remind <title> --at <when> --parent <ID>","pm context --limit 10"]}],docs:[{path:"docs/COMMANDS.md",purpose:"Calendar and context command family."}],related:["workflows","quickstart","extensions"]}],gs=new Map;for(let e of ys){gs.set(e.id,e);for(let t of e.aliases)gs.set(t,e)}function pd(){return ys.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 bn(){return ys.map(e=>e.id)}function ud(e){if(!e)return null;let t=Pf(e);return t?gs.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]="3a7cf539-2663-5265-90e8-c2aa9926a62a")}catch{}})();var Mf=["markdown","toon","json"],Df=["brief","standard","deep"];function Nf(e){if(!e)return;let t=e.trim().toLowerCase();if(!Mf.includes(t))throw new m("Guide format must be one of markdown|toon|json",u.USAGE);return t}function jf(e,t){let n=Nf(e.format);if(t.json&&n&&n!=="json")throw new m("Cannot combine --json with --format markdown|toon",u.USAGE);return t.json?"json":n??"toon"}function Uf(e){if(!e)return"brief";let t=e.trim().toLowerCase();if(!Df.includes(t))throw new m("Guide depth must be one of brief|standard|deep",u.USAGE);return t}function Gf(){return qs(process.env,"PM_CLI_PACKAGE_ROOT",import.meta.url,["..","..",".."])}function fd(e){return e.replaceAll(`\r
+`,`
+`)}function qf(e,t,n){let s=fd(e).split(`
+`),i=s.slice(0,t).join(`
+`),a=s.length>t;return i.length>n&&(i=i.slice(0,n),a=!0),{excerpt:i.trimEnd(),truncated:a,lineCount:s.length}}async function zf(e,t,n){let o=t!=="brief",s=o?t==="deep"?"full":"excerpt":"none",r=[];for(let i of e.docs){let a=Lf.resolve(n,i.path);if(!o){r.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 Ff(a,"utf8");if(t==="deep"){let l=fd(c).trimEnd();r.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!0,line_count:l.length===0?0:l.split(`
+`).length,content_mode:"full",content:l,truncated:!1})}else{let l=qf(c,120,12e3);r.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!0,line_count:l.lineCount,content_mode:s,content:l.excerpt,truncated:l.truncated})}}catch(c){let l=De(c);if(r.push({path:i.path,purpose:i.purpose,optional:i.optional===!0,exists:!1,line_count:null,content_mode:"none",content:null,truncated:!1}),!l)throw new m(`Failed to read guide document "${i.path}".`,u.GENERIC_FAILURE)}}return r}function Hf(e){let t=pd().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 Bf(e){let t=ud(e);if(t)return t;let n=bn().join(", ");throw new m(`Unknown guide topic "${e}". Available topics: ${n}. Use "pm guide --list" to browse.`,u.USAGE)}async function Vf(e,t){let n=Uf(typeof e.depth=="string"?e.depth:void 0),o=e.list===!0,s=typeof e.topic=="string"?e.topic:void 0;if(o||!s)return Hf(n);let r=Bf(s),i=Gf(),a=await zf(r,n,i),c=a.filter(l=>!l.exists&&!l.optional).map(l=>`Missing required guide document: ${l.path}`);return{output_default:"toon",mode:"topic",depth:n,requested_topic:s,topic:r,docs:a,warnings:c}}function Wf(e){return e.replaceAll("```","``\\`")}function Kf(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(s=>`\`${s.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(Wf(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]="56fd6790-568a-5c97-ab94-4b645aaa3718")}catch{}})();var _d=["bash","zsh","fish"],Yf=[...rt],Jf=[...An],vs=new Set($s.filter(e=>e.hidden).map(e=>e.alias)),bs=Sc("full").filter(e=>!vs.has(e)),Xf=A(Ut),Zf=A(mi),Qf=A(vi),e_=A(Ri),Sd=kc("restore",Qn("restore")),t_=A(Ci),n_=A(wi),o_=A(ki),s_=A(Ai),r_=A(Fi),i_=A(Ti),a_=A(xi),c_=A(bi),vn=ot.map(e=>e.canonical_argv[1]).join(" "),l_=ot.map(e=>({...e,flags:A(Qn(e.alias))})),hd=A(pi),d_=A(ui,!1),m_=A($i),p_=A(Oi),u_=A(Pi),f_=A(Ni),__=A(Mi),h_=A(Ii),g_=A(Di),y_=A(Li),b_=A(Gt),v_=A(Si),w_=A(Ei),k_=A(_i),S_=A(ji),I_=A(fi),E_="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize",A_=A(Ui),R_=`${A_} bash zsh fish`,ws=Qe(bn()),wn="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate",ks=`${wn} upgrade`,C_=A(hi),T_=A(gi),x_=A(yi),O_="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",$_="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",P_="--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",F_="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",Id=[["init","Initialize pm storage for the current workspace"],["config","Read or update pm settings"],["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"]],L_=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"]]),Ed=di.flatMap(e=>[e.short,e.flag,...e.aliases??[]]).filter(e=>!!e).join(" "),Ss=[...Mt].join("|"),Is=[...Mt].map(e=>`${e}=*`).join("|"),Es=[...Ed.split(" ").filter(e=>!Mt.has(e)),"-h","-V"].join("|");function Qe(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n)).join(" ")}function M_(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].join(" ")}function Ad(e){return e.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function As(e,t){return M_(e.length>0?e:t.item_types??Yf)}function Rs(e){return Qe(e.statuses??Jf)}function Le(e,t){let n=[...e.split(/\s+/u).filter(o=>o.length>0),...t??[]];return Qe(n)}function Rd(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 Et(e){let t=Rd(e);return t.length===0?"":`${t.map(n=>`            '${n}[Runtime schema field flag]:value' \\`).join(`
+`)}
+`}function At(e,t={}){let n=t.trailingContinuation??!0,o=e.length-1;return e.map((s,r)=>`            ${s}${n||r!==o?" \\":""}`).join(`
+`)}function D_(){return Id.filter(([e])=>!vs.has(e)).map(([e,t])=>`    '${e}:${t}'`).join(`
+`)}function N_(){return Id.filter(([e])=>e!=="help"&&!vs.has(e)).map(([e,t])=>{let n=L_.get(e)??t;return`complete -c pm -n __pm_no_subcommand -a ${e.padEnd(16)} -d '${n}'`}).join(`
+`)}function gd(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 At([...[...t,...n].map(s=>`'--${e.missingPrefix}${s}'`),...o.flatMap(([s,r])=>[`'--${e.pairedPrefix}${s}'`,`'--${e.pairedPrefix}${r}'`])])}var j_=["'--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 yd(e){return At([...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 bd(e,t,n,o){return At([`'--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 Me(e,t){let n=Rd(t).map(s=>s.slice(2));if(e.length===0||n.length===0)return"";let o=[];for(let s of e)for(let r of n)o.push(`complete -c pm -n '__fish_seen_subcommand_from ${s}' -l ${r} -d 'Runtime schema field flag' -r`);return`${o.join(`
+`)}
+`}function vd(e,t,n){let o=e.toUpperCase(),s=`PM_COMPLETION_${o}_CACHE`,r=`PM_COMPLETION_${o}_CACHE_TS`,i=`PM_COMPLETION_${o}_TTL`,a=Ad(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="\${${r}:-0}"`,`  if [[ -n "\${${s}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,`    printf '%s\\n' "$${s}"`,"    return 0","  fi",`  resolved="$(pm ${t} 2>/dev/null)"`,'  if [[ -z "$resolved" ]]; then',`    resolved="${a}"`,"  fi",`  ${s}="$resolved"`,`  ${r}="$now"`,`  printf '%s\\n' "$${s}"`,"}"]}function wd(e,t,n){let o=e.toUpperCase(),s=`PM_COMPLETION_${o}_CACHE`,r=`PM_COMPLETION_${o}_CACHE_TS`,i=`PM_COMPLETION_${o}_TTL`,a=Ad(n);return`
+_pm_${e}_choices() {
+  local now ttl cache_ts resolved
+  now=\${EPOCHSECONDS:-0}
+  ttl=\${${i}:-120}
+  cache_ts=\${${r}:-0}
+  if [[ -n "\${${s}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
+    print -r -- "$${s}"
+    return
+  fi
+  resolved="$(pm ${t} 2>/dev/null)"
+  if [[ -z "$resolved" ]]; then
+    resolved="${a}"
+  fi
+  ${s}="$resolved"
+  ${r}="$now"
+  print -r -- "$${s}"
+}
+`}function kd(e,t,n){let o=e.toUpperCase(),s=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 '${s}'
+  end
+  set -gx PM_COMPLETION_${o}_CACHE $resolved
+  set -gx PM_COMPLETION_${o}_CACHE_TS $now
+  printf '%s\\n' $resolved
+end
+`}function U_(e=[],t=[],n=!1,o={}){let s=bs.join(" "),r=e.length===0,i=As(e,o),a=Rs(o),c=Qe(t),l=Le(Xf,o.command_flags?.list),d=Le(s_,o.command_flags?.create),p=Le(i_,o.command_flags?.update),f=Le(a_,o.command_flags?.["update-many"]),g=Le(b_,o.command_flags?.search),v=Le(p_,o.command_flags?.calendar),w=Le(u_,o.command_flags?.context),y=n||t.length>0,_=k=>`$(compgen -W "${k}" -- "$cur")`;return["# bash completion for pm",`# Source this file or add 'eval "$(pm completion bash)"' to ~/.bashrc`,"",...r?[...vd("type","completion-types",i),""]:[],...vd("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=(${_(s)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',r?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${_(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" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',`    COMPREPLY=(${_(c)})`,"    return 0","  fi"]:['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; 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"],"",'  if [[ "$prev" == "--tag" && ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    COMPREPLY=()","    return 0","  fi","",'  local cmd="" word_index=1 word',"  while (( word_index < cword )); do",'    word="${COMP_WORDS[word_index]}"','    case "${word//_/-}" in',`      ${Ss}) (( word_index += 2 )); continue ;;`,`      ${Is}|${Es}) (( word_index++ )); continue ;;`,"      --) break ;;","    esac",'    if [[ -z "$cmd" ]]; then','      cmd="$word"','      [[ "$cmd" == "history" ]] || break',"    else",'      case "$word" in',...ot.map(k=>`        ${k.canonical_argv[1]}) cmd="${k.alias}" ;;`),"      esac","      break","    fi","    (( word_index++ ))","  done",'  case "$cmd" in',...l_.flatMap(k=>[`    ${k.alias})`,`      COMPREPLY=(${_(k.flags)})`,"      return 0","      ;;"]),"    list)",`      COMPREPLY=(${_(l)})`,"      ;;","    aggregate)",`      COMPREPLY=(${_(Zf)})`,"      ;;","    duplicates)",`      COMPREPLY=(${_(h_)})`,"      ;;","    create)",`      COMPREPLY=(${_(d)})`,"      ;;","    copy)",`      COMPREPLY=(${_(e_)})`,"      ;;","    focus)",`      COMPREPLY=(${_(t_)})`,"      ;;","    update)",`      COMPREPLY=(${_(p)})`,"      ;;","    update-many)",`      COMPREPLY=(${_(f)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${_(v)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${_(w)})`,"      ;;","    next)",`      COMPREPLY=(${_(f_)})`,"      ;;","    guide)",`      COMPREPLY=(${_(`${y_} ${ws}`)})`,"      ;;","    search)",`      COMPREPLY=(${_(g)})`,"      ;;","    reindex)",`      COMPREPLY=(${_("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${_(`${k_} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    config)",`      COMPREPLY=(${_("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    extension)",`      COMPREPLY=(${_(`${wn} ${C_}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${_(`${ks} ${T_} ${x_}`)})`,"      ;;","    comments)",`      COMPREPLY=(${_("--add --body --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    notes)",`      COMPREPLY=(${_("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    learnings)",`      COMPREPLY=(${_("--add --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    files)",`      COMPREPLY=(${_("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=(${_("--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=(${_(Qf)})`,"      ;;","    deps)",`      COMPREPLY=(${_(__)})`,"      ;;","    graph)",`      COMPREPLY=(${_(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${g_}`)})`,"      ;;","    test)",`      COMPREPLY=(${_("--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=(${_("--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=(${_("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=(${_("--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=(${_(w_)})`,"      ;;","    history)","      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY=(${_(`${hd} ${vn}`)})`,"      else",`        COMPREPLY=(${_(hd)})`,"      fi","      ;;","    events)",`      COMPREPLY=(${_(m_)})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${_(`${d_} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${_(r_)})`,"      ;;","    schema)",`      COMPREPLY=(${_("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=(${_("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=(${_(`${E_} ${I_}`)})`,"      ;;","    contracts)",`      COMPREPLY=(${_(S_)})`,"      ;;","    gc)",`      COMPREPLY=(${_("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${_(v_)})`,"      ;;","    close|close-task)",`      COMPREPLY=(${_(P_)})`,"      ;;","    close-many)",`      COMPREPLY=(${_(c_)})`,"      ;;","    release)",`      COMPREPLY=(${_(F_)})`,"      ;;","    delete)",`      COMPREPLY=(${_($_)})`,"      ;;","    claim|start-task|pause-task)",`      COMPREPLY=(${_(O_)})`,"      ;;","    meet|event)",`      COMPREPLY=(${_(n_)})`,"      ;;","    remind)",`      COMPREPLY=(${_(o_)})`,"      ;;","    completion)",`      COMPREPLY=(${_(R_)})`,"      ;;","    templates)",`      COMPREPLY=(${_("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${_(Ed)})`,"      ;;","  esac",'  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',`    COMPREPLY+=(${_("--text")})`,"  fi","  return 0","}","","complete -F _pm_completion pm"].join(`
+`)}function G_(e=[],t=[],n=!1,o={}){let s=e.length===0,r=As(e,o),i=Rs(o),a=s?'${(f)"$(_pm_type_choices)"}':r,c='${(f)"$(_pm_status_choices)"}',l=ws,d=Qe(t),p=n||t.length>0,f=p?d:'${(f)"$(_pm_tag_choices)"}',g=Et(o.command_flags?.list),v=Et(o.command_flags?.create),w=Et(o.command_flags?.search),y=Et(o.command_flags?.calendar),_=Et(o.command_flags?.context),k=gd({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:!0}),R=gd({missingPrefix:"filter-",pairedPrefix:"filter-"}),x=At(j_),F=p?"":`
+_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=(
+${D_()}
+  )
+  _describe 'command' commands
+}
+${F}
+${s?wd("type","completion-types",r):""}
+${wd("status","completion-statuses",i)}
+
+_pm() {
+  local context state line
+  local -a words=("$words[@]")
+  local CURRENT=$CURRENT
+  local word_index=2 history_seen=0 operation_index=0 word
+  while (( word_index < CURRENT )); do
+    word="$words[word_index]"
+    case "\${word//_/-}" in
+      ${Ss}) (( word_index += 2 )); continue ;;
+      ${Is}|${Es}) (( word_index++ )); continue ;;
+      --) break ;;
+    esac
+    if (( history_seen == 0 )); then
+      [[ "$word" == "history" ]] || break
+      history_seen=1
+    else
+      operation_index=$word_index
+      break
+    fi
+    (( word_index++ ))
+  done
+  if (( history_seen && word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
+    local -a history_commands
+    history_commands=(${vn})
+    _describe 'history operation' history_commands
+    return
+  fi
+  if (( operation_index > 0 )); then
+    case "$words[operation_index]" in
+${ot.map(N=>`      ${N.canonical_argv[1]}) words=("$words[1]" "${N.alias}" "\${words[@]:$operation_index}"); (( CURRENT -= operation_index - 2 )) ;;`).join(`
+`)}
+    esac
+  fi
+  _arguments -C \\
+    '--json[Output JSON instead of TOON]' \\
+    '--all[Reveal every public command and compatibility alias]' \\
+    '--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)]' \\
+${g}            '--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' \\
+${v}            '--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 \\
+${yd("event")}
+          ;;
+        remind)
+          _arguments \\
+${yd("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' \\
+${x}
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        update-many)
+          _arguments \\
+${bd("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]' \\
+${R}
+            '--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]' \\
+${x}
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--force[Force override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        close-many)
+          _arguments \\
+${bd("closing",c,a,f)}
+${R}
+            '--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)' \\
+${_}            '--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:(${l})' \\
+            '--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 \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
+            '--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 \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
+            '--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 \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
+            '--salvage-tail[Recover an invalid suffix after a verified prefix]' \\
+            '--normalize-provenance[Remove invalid provenance with aggregate evidence]' \\
+            '--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' \\
+            '--unbounded[Return every matching activity entry]' \\
+            '--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:(rows ndjson jsonl)' \\
+            '--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' \\
+            '--text[Alias for --add]: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]' \\
+            '--if-absent[Append only when the resolved author and text are absent]' \\
+            '--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' \\
+            '--text[Alias for --add]: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]' \\
+            '--if-absent[Append only when the resolved author and text are absent]' \\
+            '--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' \\
+            '--text[Alias for --add]: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]' \\
+            '--if-absent[Append only when the resolved author and text are absent]' \\
+            '--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]'
+          ;;
+        restore)
+          _arguments \\
+${At(Sd.map(N=>`'${N.flag}[${N.description}]${N.takes_value?":value":""}'`),{trailingContinuation:!1})}
+          ;;
+        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:(${wn})' \\
+            '--init[Generate a starter extension scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${yt.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:(${ks})' \\
+            '--init[Generate a starter package scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${yt.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)]' \\
+            '--dry-run[Plan upgrades without mutating]' \\
+            '--cli-only[Upgrade only the pm CLI/SDK npm package]' \\
+            '--packages-only[Upgrade only managed pm packages]' \\
+            '--repair[Force npm global reinstall for the CLI/SDK]' \\
+            '--tag[npm version or dist-tag for upgrades]:tag' \\
+            '--package-name[Override the CLI package name]:package_name' \\
+            '--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 q_(e=[],t=[],n=!1,o={}){let s=bs.filter(G=>G==="list"||G.startsWith("list-")),r=s.join(" "),i=bs.join(" "),a=e.length===0,c=As(e,o),l=Rs(o),d=a?"(__pm_type_choices)":c,p="(__pm_status_choices)",f=ws,g=Qe(t),v=n||t.length>0,w=v?`'${g}'`:"'(__pm_tag_choices)'",y=Me(s,o.command_flags?.list),_=Me(["create"],o.command_flags?.create),k=Me(["update"],o.command_flags?.update),R=Me(["update-many"],o.command_flags?.["update-many"]),x=Me(["search"],o.command_flags?.search),F=Me(["calendar","cal"],o.command_flags?.calendar),N=Me(["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 all -d 'Reveal every public command and compatibility alias'
+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
+${v?"":`
+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?kd("type","completion-types",c):""}
+${kd("status","completion-statuses",l)}
+
+# Subcommands
+${N_()}
+
+# list* flags
+for list_cmd in ${r}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l status   -d 'Filter by status' -r -a '${p}'
+  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 '${d}'
+  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 '${p}'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l type -d 'Filter by item type' -r -a '${d}'
+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 '${d}'
+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 '${p}'
+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'
+${_}
+
+# 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 '${p}'
+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 '${d}'
+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 '${p}'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${d}'
+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 '${d}'
+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'
+${R}
+
+# 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 '${p}'
+complete -c pm -n '__fish_seen_subcommand_from search' -l type           -d 'Filter by type' -r -a '${d}'
+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'
+${x}
+
+# 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 '${d}'
+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 '${p}'
+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'
+${F}
+
+# 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 '${d}'
+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'
+${N}
+
+# next flags
+complete -c pm -n '__fish_seen_subcommand_from next' -l type           -d 'Filter candidates by type' -r -a '${d}'
+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
+
+# Read the first command positions after consuming recognized global options.
+function __pm_history_tokens
+  set -l tokens (commandline -opc)
+  set -l skip_value 0
+  set -l positions 0
+  for token in $tokens[2..-1]
+    if test $skip_value -eq 1
+      set skip_value 0
+      continue
+    end
+    switch (string replace -a _ - -- "$token")
+      case ${Ss.replaceAll("|"," ")}
+        set skip_value 1
+        continue
+      case ${Is.split("|").map(G=>`'${G}'`).join(" ")} ${Es.replaceAll("|"," ")}
+        continue
+      case --
+        printf '%s\\n' --
+        return
+    end
+    printf '%s\\n' "$token"
+    set positions (math $positions + 1)
+    if test $positions -eq 2; or test "$token" != history
+      return
+    end
+  end
+  if test $skip_value -eq 1
+    printf '%s\\n' --value
+  end
+end
+
+# Match only the command positions, keeping item history separate from maintenance.
+function __pm_history_operation
+  set -l tokens (__pm_history_tokens)
+  if test "$tokens[1]" = history; and contains -- "$tokens[2]" ${vn}
+    test "$tokens[2]" = "$argv[2]"
+  else
+    test "$tokens[1]" = "$argv[1]"
+  end
+end
+complete -c pm -n 'test (count (__pm_history_tokens)) -eq 1; and __pm_history_operation history' -a '${vn}' -d 'History operation'
+${Sd.map(G=>`complete -c pm -n '__pm_history_operation restore restore' -l ${G.flag.slice(2)}${G.takes_value?" -r":""}`).join(`
+`)}
+
+# history / activity flags
+complete -c pm -n '__pm_history_operation history'  -l limit -d 'Max history entries' -r
+complete -c pm -n '__pm_history_operation history'  -l compact -d 'Condensed history projection'
+complete -c pm -n '__pm_history_operation history'  -l full -d 'Show full history entries'
+complete -c pm -n '__pm_history_operation history'  -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__pm_history_operation history'  -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation history'  -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation history'  -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation history'  -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation history'  -l diff -d 'Include per-entry field-level before/after value diffs'
+complete -c pm -n '__pm_history_operation history'  -l field -d 'With --diff, show only entries that changed this field' -r
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation history-compact compact' -l before -d 'Compact entries strictly before this version number or ISO timestamp' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l ids -d 'Bulk: compact an explicit comma-separated list of item ids' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l all-over -d 'Bulk: compact every stream with more than N entries' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l closed -d 'Bulk: compact only closed (terminal) items streams'
+complete -c pm -n '__pm_history_operation history-compact compact' -l all-streams -d 'Bulk: compact every history stream regardless of lifecycle state'
+complete -c pm -n '__pm_history_operation history-compact compact' -l min-entries -d 'Bulk: skip streams with at most N entries' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l dry-run -d 'Preview compaction impact without writing the history file'
+complete -c pm -n '__pm_history_operation history-compact compact' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-compact 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 '__pm_history_operation history-redact redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l dry-run -d 'Preview redaction impact without writing files'
+complete -c pm -n '__pm_history_operation history-redact redact' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__pm_history_operation history-repair repair' -l salvage-tail -d 'Recover an invalid suffix after a verified prefix'
+complete -c pm -n '__pm_history_operation history-repair repair' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-repair repair' -l normalize-provenance -d 'Remove invalid provenance with aggregate evidence'
+complete -c pm -n '__pm_history_operation history-repair repair' -l all -d 'Repair every drifted stream in one audited pass'
+complete -c pm -n '__pm_history_operation history-repair repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
+complete -c pm -n '__pm_history_operation history-repair repair' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-repair repair' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-repair 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 '__pm_history_operation activity activity' -l id -d 'Filter by item ID' -r
+complete -c pm -n '__pm_history_operation activity activity' -l op -d 'Filter by history operation' -r
+complete -c pm -n '__pm_history_operation activity activity' -l author -d 'Filter by history author' -r
+complete -c pm -n '__pm_history_operation activity activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation activity activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation activity activity' -l limit -d 'Max activity entries' -r
+complete -c pm -n '__pm_history_operation activity activity' -l unbounded -d 'Return every matching activity entry'
+complete -c pm -n '__pm_history_operation activity activity' -l compact -d 'Condensed activity projection'
+complete -c pm -n '__pm_history_operation activity activity' -l raw -d 'Emit raw compact per-event activity output'
+complete -c pm -n '__pm_history_operation activity activity' -l full -d 'Show full activity entries'
+complete -c pm -n '__pm_history_operation activity activity' -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__pm_history_operation activity activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation activity activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation activity activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation activity activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation activity 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 comments notes learnings' -l text -d 'Alias for --add' -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 comments notes learnings' -l if-absent -d 'Append only when the resolved author and text are absent'
+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 '${p}'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${d}'
+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 '${wn}' -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 '${yt.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 '${ks}' -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 '${yt.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)'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l dry-run -d 'Plan upgrades without mutating'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l cli-only -d 'Upgrade only the pm CLI/SDK npm package'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l packages-only -d 'Upgrade only managed pm packages'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l repair -d 'Force npm global reinstall for the CLI/SDK'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l tag -d 'npm version or dist-tag for upgrades' -r
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l package-name -d 'Override the CLI package name' -r
+end`}var z_={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 H_(e,t=[],n=[],o=!1,s={}){let r=e.trim().toLowerCase();if(!_d.includes(r))throw new m(`Unknown shell: "${e}". Supported shells: ${_d.join(", ")}.`,u.USAGE);let i=r,a;return i==="bash"?a=U_(t,n,o,s):i==="zsh"?a=G_(t,n,o,s):a=q_(t,n,o,s),{shell:i,script:a,setup_hint:z_[i]}}import B_ from"node:fs/promises";import Rt 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]="02e6f711-7e60-5bb7-a439-9b23d23575f5")}catch{}})();var Cs="index/manifest.json",Ts="search/embeddings.jsonl",V_="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function W_(e){return e.progress===!0||process.stderr.isTTY===!0}function D(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
+`)}catch{}}function K_(e){let t=(e??"keyword").trim().toLowerCase();if(t==="keyword")return"keyword";if(t==="semantic"||t==="hybrid")return t;throw new m("Reindex mode must be one of keyword|semantic|hybrid",u.USAGE)}async function Y_(e,t,n,o){let s=[];return{candidates:await Vr(e,t,n,s,o),warnings:s}}async function Os(e,t,n,o,s){let r=je(T()),i=[];for(let a of t)if(!(s&&!s.has(a.metadata.id))){if(typeof a.body=="string"){i.push({metadata:a.metadata,body:a.body});continue}try{let c=await B_.readFile(a.item_path,"utf8"),l=Lt(c,{format:a.item_format,schema:n,extensionFieldNames:r,onWarning:d=>o.push(d)});i.push({metadata:a.metadata,body:l.body})}catch{o.push(`item_list_item_read_failed:${Rt.relative(e,a.item_path)}`),i.push({metadata:a.metadata,body:""})}}return i}function J_(e,t,n){let o=e.metadata;return{id:o.id,mode:t,updated_at:o.updated_at,corpus:Yr(e,{fields:n})}}var et=js;function X_(e){let t=T(),n=et(e.search?.provider);if(!n)return null;let o=or(t,n);if(!o)return null;let s=o.runtime_definition??o.definition,r=et(s.name)??et(o.definition.name);if(!r)return null;let i=s.embedBatch,a=s.embed_batch,c=s.embed,l=typeof i=="function"?i:typeof a=="function"?a:void 0,d=typeof c=="function"?c:void 0;return!l&&!d?null:{name:r,embedBatch:l,embed:d}}function Z_(e){let t=T(),n=et(e.vector_store?.adapter);if(!n)return null;let o=sr(t,n);if(!o)return null;let s=o.runtime_definition??o.definition,r=et(s.name)??et(o.definition.name);if(!r)return null;let i=s.upsert,a=s.delete;return{adapterName:r,...typeof i=="function"?{upsert:i}:{},...typeof a=="function"?{delete:a}:{}}}function xs(e,t){if(!Array.isArray(e)||e.some(n=>typeof n!="number"||!Number.isFinite(n)))throw new m(`Invalid vector returned by ${t}`,u.GENERIC_FAILURE);return e}async function Q_(e,t,n){let o=t.search?.embedding_model?.trim()||"text-embedding-3-small";if(e.embedBatch){let r=await Promise.resolve(e.embedBatch({inputs:n,settings:t,model:o}));if(!Array.isArray(r))throw new m(`Extension search provider "${e.name}" embedBatch must return an array of vectors`,u.GENERIC_FAILURE);return r.map((i,a)=>xs(i,`extension search provider "${e.name}" embedBatch output at index ${a}`))}if(!e.embed)throw new m(`Extension search provider "${e.name}" does not implement embed/embedBatch`,u.GENERIC_FAILURE);let s=[];for(let[r,i]of n.entries()){let a=await Promise.resolve(e.embed({input:i,settings:t,model:o}));s.push(xs(a,`extension search provider "${e.name}" embed output at index ${r}`))}return s}function Cd(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function Td(e,t,n){let o=n?ht(n.name,Cd(e)):t?ht(t.name,t.model):null;if(!o)throw new m("No embedding identity available for semantic reindex mode",u.USAGE);return o}function eh(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,o)=>n.localeCompare(o))}async function xd(e,t,n,o,s,r,i,a){let c=o?.name??n?.name,l=Jr(c,e.search.embedding_corpus_max_characters).maxCharacters,d=Kn(e),p=s.map(v=>Xr(v,{providerName:c,maxCharacters:l,fields:d})),f=[],g=null;if(o)try{f=await Q_(o,e,p),g=ht(o.name,Cd(e))}catch(v){if(!n)throw new m(`Extension search provider "${o.name}" failed to generate embeddings: ${v instanceof Error?v.message:String(v)}`,u.GENERIC_FAILURE);r.push(`Extension search provider "${o.name}" failed; falling back to built-in provider (${v instanceof Error?v.message:String(v)})`)}if(f.length===0){if(!n)throw new m(`No embedding executor available for reindex mode '${t}'`,u.USAGE);let v=await Zr(n,e,p,{onProgress:w=>{w.phase==="complete"&&(i.batches_completed=w.batch_index),D(a,`embedding_batch_${w.phase} batch=${w.batch_index}/${w.batch_total} size=${w.batch_size} completed_inputs=${w.completed_inputs}/${w.total_inputs}`)}});r.push(...v.warnings),f=v.vectors,g=ht(n.name,n.model)}if(D(a,`embedding_complete vectors=${f.length}`),f.length!==s.length)throw new m(`Embedding output size mismatch (expected ${s.length}, received ${f.length})`,u.GENERIC_FAILURE);if(!g)throw new m(`No embedding identity available for reindex mode '${t}'`,u.USAGE);return{vectors:f,embeddingIdentity:g}}async function th(e,t,n,o,s,r){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 m(`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&&s.push(`search_semantic_reindex_reset_skipped:adapter=${t.adapterName}:known_ids=${i.length}`);if(!e)return}e&&await ni(e,i,{},r)}async function Od(e,t,n,o,s){if(n.length!==0){if(t){if(t.delete)try{await Promise.resolve(t.delete({ids:n,settings:o}))}catch(r){throw new m(`Extension vector adapter "${t.adapterName}" failed to delete orphan vectors during reindex: ${r instanceof Error?r.message:String(r)}`,u.GENERIC_FAILURE)}else s.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${t.adapterName}:count=${n.length}`);if(!e)return}e&&await ti(e,n)}}function nh(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function oh(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 sh(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=Wn(e.settings);if(!t.active&&!e.extensionEmbedding)throw new m(`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=Qr(e.settings,e.pmRoot);if(!n.active&&!e.extensionVectorAdapter)throw new m(`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 rh(e){let t=$(e.settings,T()),n=await Y_(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 ih(e){let t=await Jn(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 Td(e.settings,Wn(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&jt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(V_))}async function ah(e){let t=await Jn(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=Td(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),o=new Set(e.metadataDocuments.map(l=>l.metadata.id)),s=eh(t.entries,o),r=jt(t.embedding,n);e.forceFullSemantic&&!r&&e.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced");let i=e.forceFullSemantic||r?e.metadataDocuments:e.metadataDocuments.filter(l=>t.entries[l.metadata.id]!==l.metadata.updated_at),a=new Set(i.map(l=>l.metadata.id)),c=a.size>0?await Os(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,a):[];return{ledgerEntries:t.entries,ledgerEmbedding:t.embedding,orphanIds:s,resetRequired:r,staleDocuments:c,freshDocuments:e.metadataDocuments.length-c.length}}async function ch(e){let t=new Set(e.metadataDocuments.map(s=>s.metadata.id)),n=await Os(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,D(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let o=await xd(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...o,staleDocuments:n,vectorDimension:Yn(o.vectors,"Reindex embeddings")}}async function lh(e){let t=await xd(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,o=t.embeddingIdentity,s=Yn(n,"Reindex embeddings");if(!(!e.resetRequired&&(jt(e.ledgerEmbedding,o)||si(e.ledgerEmbedding,s))))return{vectors:n,embeddingIdentity:o,staleDocuments:e.staleDocuments,vectorDimension:s,resetRequired:e.resetRequired};let i=await ch(e);return n=i.vectors,o=i.embeddingIdentity,s=i.vectorDimension,{vectors:n,embeddingIdentity:o,staleDocuments:i.staleDocuments,vectorDimension:s,resetRequired:!0}}async function dh(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(D(e.progressEnabled,`vector_upsert_start adapter=${t} points=${e.points.length}`),typeof e.extensionVectorAdapter.upsert!="function")throw new m(`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,D(e.progressEnabled,`vector_upsert_complete adapter=${t}`);return}catch(t){if(t instanceof m)throw t;if(!e.activeVectorStore)throw new m(`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)})`),D(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){D(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await ei(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,D(e.progressEnabled,`vector_upsert_complete adapter=${e.activeVectorStore.name}`);return}throw new m(`No vector upsert executor available for reindex mode '${e.requestedMode}'`,u.USAGE)}function mh(e,t){return e.map((n,o)=>({id:n.metadata.id,vector:xs(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 ph(e){D(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await lh({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?(D(e.progressEnabled,"vector_reset_start"),await th(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),D(e.progressEnabled,"vector_reset_complete")):await Od(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=mh(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await dh({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:oi(t.embeddingIdentity,t.vectorDimension)}}async function uh(e){let t=await ah(e);e.semanticSummary.stale_items=t.staleDocuments.length,e.semanticSummary.unchanged_items=t.freshDocuments;let n=Object.fromEntries(e.metadataDocuments.map(r=>[r.metadata.id,r.metadata.updated_at]));if(D(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 D(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await Od(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let o=await ph({...e,plan:t});t.freshDocuments>0&&e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`);let s=new Map(o.staleDocuments.map(r=>[r.metadata.id,r]));return{documentsForKeywordArtifacts:e.metadataDocuments.map(r=>s.get(r.metadata.id)??r),vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:o.embeddingMetadata}}async function fh(e){let t=Rt.join(e.pmRoot,Cs),n=Rt.join(e.pmRoot,Ts),o=Kn(e.settings),s=e.documentsForKeywordArtifacts.map(i=>JSON.stringify(J_(i,e.mode,o))).join(`
+`);D(e.progressEnabled,"writing keyword artifacts"),await te(t,`${JSON.stringify(e.manifest,null,2)}
+`),await te(n,`${s}
+`);let r=[];if(e.mode!=="keyword")try{D(e.progressEnabled,"writing vectorization status ledger"),await ri(e.pmRoot,e.vectorizationLedgerEntries,e.vectorizationEmbeddingMetadata)}catch(i){r.push(`search_vectorization_status_ledger_write_failed:${i instanceof Error?i.message:String(i)}`)}return r}async function _h(e,t){let n=K_(e.mode),o=W_(e),s=e.full===!0;D(o,`start mode=${n}`);let r=I(process.cwd(),t.path);await O(r);let i=qr(await E(r)).settings,a=null;try{a=await Q(r,zr,i.locks.ttl_seconds,C(void 0,"pm-reindex"),!1,i.governance.force_required_for_stale_lock,i.locks.wait_ms)}catch(c){throw c instanceof m&&c.exitCode===u.CONFLICT?new m("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=X_(i),l=Z_(i),d=sh({requestedMode:n,pmRoot:r,settings:i,extensionEmbedding:c,extensionVectorAdapter:l}),p=n;D(o,"loading item corpus");let f=await rh({pmRoot:r,settings:i}),g=f.warnings,{documentCandidates:v,metadataDocuments:w}=f;D(o,`loaded_items=${w.length}`);let y=S(),_=oh(p,y,w),k=Rt.join(r,Cs),R=Rt.join(r,Ts),x=p==="keyword"?await Os(r,v,i.schema,g):w,F=[],N={},Z=null,G=nh(p);if(p==="keyword"&&await ih({pmRoot:r,settings:i,forceFullSemantic:s,extensionEmbedding:c,reindexWarnings:g}),p!=="keyword"){let ee=await uh({pmRoot:r,settings:i,requestedMode:n,activeEmbeddingProvider:d.activeEmbeddingProvider,activeVectorStore:d.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:l,documentCandidates:v,metadataDocuments:w,documentsForKeywordArtifacts:x,forceFullSemantic:s,reindexWarnings:g,semanticWarnings:F,semanticSummary:G,progressEnabled:o});x=ee.documentsForKeywordArtifacts,N=ee.vectorizationLedgerEntries,Z=ee.vectorizationEmbeddingMetadata}let nt=await fh({pmRoot:r,mode:p,manifest:_,documentsForKeywordArtifacts:x,settings:i,vectorizationLedgerEntries:N,vectorizationEmbeddingMetadata:Z,progressEnabled:o}),ue=[...await q({path:k,scope:"project",op:"reindex:manifest"}),...await q({path:R,scope:"project",op:"reindex:embeddings"}),...await tr({mode:p,total_items:w.length})];return D(o,"done"),{ok:!0,mode:p,total_items:w.length,semantic:G,artifacts:{manifest:Cs,embeddings:Ts},warnings:[...g,...F,...nt,...ue],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]="556364bc-5faa-5412-a327-e409564fbadf")}catch{}})();var Md=Symbol("pm.active-extension-host-context");function K(e){return{fullChangedFields:!0,options:e}}var b=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[Md]=!0,n}run(t,n={}){return kh({...this.defaults,...n,action:t})}runTyped(t,n={}){return this.run(t,n)}context(t={}){return this.runTyped("context",{options:t})}listAllItemMetadataLight(){return Oc(this.defaults.path,this.defaults.cwd)}list(t={}){return this.runTyped("list",{options:t})}async listAllComplete(t={}){return sn(await this.list(So(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,...K(gt(o,{body:n}))})}init(t,n={}){return this.runTyped("init",{...t===void 0?{}:{prefix:t},options:n})}config(t,n,o,s,r={}){return this.runTyped("config",{scope:t,configAction:n,...o===void 0?{}:{key:o},...s===void 0?{}:{value:s},options:r})}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,s){return this.runTyped("schema",{name:t,options:{...o,subcommand:"rename-field",to:n,...s?{fieldTypeScope:s}:{}}})}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={},s,r){return this.runTyped("plan",{...n===void 0?{}:{id:n},...s===void 0?{}:{stepRef:s},...r===void 0?{}:{reorderTo:r},options:gt(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,s={}){return this.plan("reorder-step",t,s,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",K(t))}update(t,n={}){return this.runTyped("update",{id:t,...K(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,...K(o)})}claim(t,n={}){return this.runTyped("claim",{id:t,...K(n)})}claimNext(t={}){return this.runTyped("claim",{next:!0,...K(t)})}release(t,n={}){return this.runTyped("release",{id:t,...K(n)})}copy(t,n={}){return this.runTyped("copy",{id:t,...K(n)})}delete(t,n={}){return this.runTyped("delete",{id:t,...K(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},...K(n)})}startTask(t,n={}){return this.runTyped("start-task",{id:t,...K(n)})}pauseTask(t,n={}){return this.runTyped("pause-task",{id:t,...K(n)})}closeTask(t,n,o={}){return this.runTyped("close-task",{id:t,reason:n,...K(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 TE(e={},t={}){return new b(t).context(e)}function xE(e={},t={}){return new b(t).list(e)}function OE(e={},t={}){return new b(t).listAllComplete(e)}function $E(e,t={},n={}){return new b(n).search(e,t)}function PE(e,t={},n={}){return new b(n).get(e,t)}function FE(e={},t={}){return new b(t).next(e)}function LE(e={},t={}){return new b(t).aggregate(e)}function ME(e={},t={}){return new b(t).stats(e)}function DE(e={},t={}){return new b(t).duplicates(e)}function NE(e,t={},n={}){return new b(n).comments(e,t)}function jE(e,t={},n={}){return new b(n).notes(e,t)}function UE(e,t={},n={}){return new b(n).learnings(e,t)}function GE(e,t={},n={}){return new b(n).files(e,t)}function qE(e,t={},n={}){return new b(n).filesDiscover(e,t)}function zE(e,t={}){return new b(t).filesLookup(e)}function HE(e,t={},n={}){return new b(n).docs(e,t)}function BE(e,t={},n={}){return new b(n).deps(e,t)}function VE(e,t={},n={},o={}){return new b(o).graph(e,t,n)}function WE(e,t,n={},o={}){return new b(o).append(e,t,n)}function KE(e,t={},n={}){return new b(n).init(e,t)}function YE(e,t,n,o,s={},r={}){return new b(r).config(e,t,n,o,s)}function JE(e,t={},n={}){return new b(n).schema(e,t)}function XE(e={}){return new b(e).schemaList()}function ZE(e,t={}){return new b(t).schemaShow(e)}function QE(e,t={},n={}){return new b(n).schemaAddType(e,t)}function eA(e,t={},n={}){return new b(n).schemaRemoveType(e,t)}function tA(e,t={},n={}){return new b(n).schemaAddStatus(e,t)}function nA(e,t={},n={}){return new b(n).schemaRemoveStatus(e,t)}function oA(e,t={},n={}){return new b(n).schemaAddField(e,t)}function sA(e,t={},n={}){return new b(n).schemaRemoveField(e,t)}function rA(e={}){return new b(e).schemaListFields()}function iA(e,t={}){return new b(t).schemaShowField(e)}function aA(e,t={},n={}){return new b(n).schemaApplyPreset(e,t)}function cA(e={},t={}){return new b(t).schemaInferTypes(e)}function lA(e,t,n,o={}){return new b(o).schemaRenameType(e,t,n)}function dA(e,t,n,o,s={}){return new b(s).schemaRenameField(e,t,n,o)}function mA(e,t,n,o={}){return new b(o).schemaRemapStatus(e,t,n)}function pA(e,t={}){return new b(t).schemaShowStatus(e)}function uA(e,t={},n={}){return new b(n).profile(e,t)}function fA(e={}){return new b(e).profileList()}function _A(e,t={}){return new b(t).profileShow(e)}function hA(e,t={},n={}){return new b(n).profileApply(e,t)}function gA(e,t={}){return new b(t).profileLint(e)}function yA(e={},t={}){return new b(t).validate(e)}function bA(e={},t={}){return new b(t).health(e)}function vA(e={},t={}){return new b(t).gc(e)}function wA(e,t,n={}){return new b(n).historyRedact(e,t)}function kA(e,t={},n={}){return new b(n).historyRepair(e,t)}function SA(e={},t={}){return new b(t).historyRepairAll(e)}function IA(e,t={},n={}){return new b(n).historyCompact(e,t)}function EA(e,t={}){return new b(t).historyCompactBulk(e)}function AA(e={},t={}){return new b(t).create(e)}function RA(e,t={},n={}){return new b(n).update(e,t)}function CA(e,t,n={},o={}){return new b(o).reopen(e,t,n)}function TA(e,t,n={},o={}){return new b(o).close(e,t,n)}function xA(e,t={},n={}){return new b(n).claim(e,t)}function OA(e={},t={}){return new b(t).claimNext(e)}function $A(e,t={},n={}){return new b(n).release(e,t)}function PA(e,t={},n={}){return new b(n).copy(e,t)}function FA(e,t={},n={}){return new b(n).delete(e,t)}function LA(e,t,n={},o={}){return new b(o).restore(e,t,n)}function MA(e,t={},n={}){return new b(n).focus(e,t)}function DA(e,t={},n={}){return new b(n).startTask(e,t)}function NA(e,t={},n={}){return new b(n).pauseTask(e,t)}function jA(e,t,n={},o={}){return new b(o).closeTask(e,t,n)}function UA(e,t={},n={}){return new b(n).extension(e,t)}function GA(e={},t={}){return new b(t).extensionList(e)}function qA(e,t={},n={}){return new b(n).extensionActivate(e,t)}function zA(e,t={},n={}){return new b(n).extensionDeactivate(e,t)}function HA(e,t={},n={}){return new b(n).package(e,t)}function BA(e={},t={}){return new b(t).packageList(e)}function VA(e,t={},n={}){return new b(n).packageInstall(e,t)}function WA(e,t={},n={}){return new b(n).packageUninstall(e,t)}function KA(e={},t={}){return new b(t).packageDoctor(e)}function YA(e,t={},n={}){return new b(n).packageManage(e,t)}function JA(e,t={},n={}){return new b(n).packageDescribe(e,t)}function XA(e={},t={}){return new b(t).packageReload(e)}function ZA(e={},t={}){return new b(t).packageCatalog(e)}function QA(e,t={},n={}){return new b(n).packageActivate(e,t)}function eR(e,t={},n={}){return new b(n).packageDeactivate(e,t)}function tR(e,t={},n={}){return new b(n).upgrade(e,t)}function gh(e,t,n){return JSON.stringify([$d.resolve(e),$d.resolve(n??process.cwd()),t.extensions.enabled,t.extensions.disabled,t.extensions.policy])}async function yh(e,t,n){let o=gh(e,t,n);return Lc(o,()=>tg(e,t,n))}async function nR(e,t={}){let n=await E(e),o=t.extensionRegistrations??(t.noExtensions===!0?null:await yh(e,n,t.cwd)),s=$(n,o),r=j(n.schema),i=dt(n.schema);return{types:[...s.types],statuses:r.definitions.map(a=>a.id),openStatus:r.open_status,closeStatus:r.close_status,canceledStatus:r.canceled_status,fields:Pc(i.definitions),extensionCommands:Fc(o?.commands??[])}}async function oR(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 bo(n,o)}function oe(e,t){let n=h(e,t);if(!n)throw new m(`Missing required argument: ${t}`,64);return n}var Pd=Xs(),Dd=new hh;function kn(){Ln(zs()),Mn(Hs()),Dn(Bs()),Nn(Vs()),jn(Ws()),Un(Ks()),Gn(Ys())}async function Nd(e,t,n,o){return Zs(()=>t===void 0?Pd.read(()=>Fd(e,n,o)):Pd.write(()=>vh(t,()=>Fd(e,n,o))))}async function sR(e,t){let n=e.cwd,o=n??process.cwd();return Nd(qt({path:e.path,noExtensions:e.noExtensions}),n,o,()=>Dd.run(!0,t))}async function Fd(e,t,n){let o=I(t,e.path);if(e.noExtensions)return kn(),$o({pmRoot:o},()=>n(null));if(!await _e(it(o)))return kn(),n(null);let s=null,r;try{let i=await E(o),a=await $n({pmRoot:o,settings:i,cwd:t,noExtensions:!1}),c=await Fn({...a,loaded:a.loaded});r={loadResult:a,activationResult:c},Ln(c.hooks),Mn(c.commands),Dn(c.parsers),Nn(c.preflight),jn(c.services),Un(c.renderers),Gn(c.registrations),s={registrations:c.registrations,commands:c.commands,pmRoot:o,packages:a.loaded}}catch(i){kn(),console.error("[pm-sdk] extension activation failed; continuing without active extensions:",i)}try{return await $o({pmRoot:o,packages:s?.packages},()=>n(s))}finally{kn(),r&&await Pn(r.loadResult,r.activationResult).catch(()=>{})}}async function bh(e,t,n,o,s){if(!s)throw new m(`Unsupported native pm action: ${e}`,u.USAGE);let r=Ae(e),a=s.registrations.commands.find(l=>Ae(l.action)===r)?.command??s.commands.handlers.find(l=>Ae(l.command)===r)?.command;if(!a)throw new m(`Unsupported native pm action: ${e}`,u.USAGE);let c=await nr({command:no(a),args:z(n.args??t.args),options:oo(t,n),global:o,pm_root:s.pmRoot,sdk:Gc(s.pmRoot,b.forActiveExtensionHost({pmRoot:s.pmRoot,author:typeof o.author=="string"&&o.author.trim()?o.author.trim():"pm-extension"}))});if(!c.handled){let l=c.warnings.length>0?` (${c.warnings.join(", ")})`:"";throw new m(`Unsupported native pm action: ${e}${l}`,u.USAGE)}return c.result}async function vh(e,t){let n=process.cwd();process.chdir(e);try{return await t()}finally{process.chdir(n)}}function wh(e){let t=oe(e,"action"),n=Ae(t),o=tt(Eo,n),s=o?.action??n,r={...e,action:s};return o?.options!==void 0&&(r.options={...o.options,...En(e.options)}),s==="package"&&(r.options={...En(r.options),vocabulary:"package"}),{action:s,args:r}}async function kh(e){let t=wh(e),n=qt(t.args),o=Qi(t.action),s=h(t.args,"cwd"),r=s??process.cwd();t.action==="init"&&(n[sc]=r),(t.action!=="init"||n.path!==void 0||(process.env.PM_PATH?.trim().length??0)>0)&&(n.path=I(r,n.path));try{return e[Md]===!0||Dd.getStore()===!0?await Ld(t.action,t.args,n,null):await Nd(n,s,r,i=>Ld(t.action,t.args,n,i))}finally{o&&Io()}}function tt(e,t){return Object.prototype.hasOwnProperty.call(e,t)?e[t]:void 0}function Sn(e){return h(e.args,"target")??h(e.options,"target")}function L(e,t=e.options){return e.id??oe(t,"id")}async function Sh(e){let t=qe("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),ko(await ce(h(e.args,"status")??h(t,"status"),t,e.global),t)}async function Ih(e){let t=oe(e.args,"query"),n=qe("search",e.options,[t]);return n.compact===void 0&&n.full===void 0&&n.fields===void 0&&(n.compact=!0),ko(await yo(t,n,e.global),n)}async function Eh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return Y(await wt(o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Ah(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),s={...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 Y(await Jo(L(e,s),s,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Rh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return Y(await be(L(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function Ch(e){let t=Xt(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")),Jc(L(e),t,e.global)}function jd(e,t){return za(od(e.options,t,J),e.global)}function Th(e){let t=z(e.options.lookupPath);if(t&&t.length>0)return jd(e,t);let n=L(e);return e.options.discover===!0?ao(n,to(e.options),e.global):qa(n,zt(e.options),e.global)}function xh(e){return Ec({subcommand:h(e.args,"subcommand")??h(e.options,"subcommand"),limit:Xi(e.args,e.options)},e.global)}function Oh(e){let t={...e.options};return t.brief===void 0&&t.summary===void 0&&t.full===void 0&&(t.summary=!0),bt(e.global,t)}function $h(e){let t=h(e.args,"configAction")??h(e.options,"configAction")??h(e.options,"action");if(t===void 0)throw new m("Missing required argument: configAction",64);let n=h(e.args,"value")??h(e.options,"value"),o=h(e.options,"policy")!==void 0&&n!==void 0?{...e.options,value:n}:e.options;return oc(h(e.args,"scope")??h(e.options,"scope")??"project",t,h(e.args,"key")??h(e.options,"key"),o,e.global,h(e.options,"policy")===void 0?n:void 0)}function Ph(e){let t=e.options;return Vi(Bi(t),e.global)}function Fh(e,t){if(typeof e=="number"){if(!Number.isFinite(e)||!Number.isInteger(e))throw new m(`${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 m(`${t} must be a finite integer.`,64);let o=Number.parseInt(n,10);if(!Number.isInteger(o))throw new m(`${t} must be a finite integer.`,64);return o}}function Lh(e){let t=h(e.args,"subcommand")??oe(e.options,"subcommand"),n=e.options;return hl({subcommand:t,id:typeof e.id=="string"?e.id:typeof n.id=="string"?n.id:void 0,stepRef:Mh(e),reorderTo:Fh(n.reorderTo??e.args.reorderTo,"plan reorderTo"),options:e.options,global:e.global})}function Mh(e){return typeof e.options.stepRef=="string"?e.options.stepRef:typeof e.args.stepRef=="string"?e.args.stepRef:void 0}function Dh(e){let t=h(e.args,"subcommand")??oe(e.options,"subcommand"),n=e.args.alias??e.options.alias;return{ctx:e,subcommand:t.trim().toLowerCase(),name:h(e.args,"name")??h(e.options,"name"),author:h(e.args,"author")??h(e.options,"author"),force:e.args.force===!0||e.options.force===!0,aliases:n===void 0?void 0:z(n)}}function Nh(e){let{ctx:t,subcommand:n,name:o,author:s,force:r}=e,a=tt({list:()=>ga(t.global),show:()=>ya(o,t.global),"show-status":()=>ba(o,t.global),"list-fields":()=>ka(t.global),"show-field":()=>Sa(o,t.global),"remove-type":()=>ua(o,{author:s,force:r},t.global),"remove-field":()=>wa(o,{author:s,force:r},t.global),"remove-status":()=>ha(o,{author:s,force:r},t.global),"apply-preset":()=>Ia(h(t.args,"typePreset")??h(t.options,"typePreset"),{author:s,force:r},t.global)},n);return a?a():null}function jh(e){let{ctx:t,name:n,author:o,force:s,aliases:r}=e,i=t.args.commands??t.options.commands,a=t.args.requiredTypes??t.options.requiredTypes;return va(n,{type:h(t.args,"fieldType")??h(t.options,"fieldType"),commands:i===void 0?void 0:z(i),description:h(t.args,"description")??h(t.options,"description"),cliFlag:h(t.args,"cliFlag")??h(t.options,"cliFlag"),alias:r,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:z(a),author:o,force:s},t.global)}function Uh(e){let{ctx:t,name:n,author:o,force:s,aliases:r}=e,i=t.args.role??t.options.role;return _a(n,{role:i===void 0?void 0:z(i),alias:r,description:h(t.args,"description")??h(t.options,"description"),order:J(t.args.order??t.options.order,"schema add-status order"),author:o,force:s},t.global)}function Gh(e){let{ctx:t,name:n,author:o,force:s,aliases:r}=e;return pa(n,{description:h(t.args,"description")??h(t.options,"description"),defaultStatus:h(t.args,"defaultStatus")??h(t.args,"default_status")??h(t.options,"defaultStatus")??h(t.options,"default_status"),folder:h(t.args,"folder")??h(t.options,"folder"),alias:r,author:o,force:s},t.global)}function qh(e){let{ctx:t,subcommand:n,name:o,author:s,force:r}=e,i=h(t.args,"to")??oe(t.options,"to"),a=h(t.args,"migrationId")??h(t.args,"migration_id")??h(t.options,"migrationId")??h(t.options,"migration_id"),c=h(t.args,"fieldTypeScope")??h(t.options,"fieldTypeScope")??h(t.args,"type")??h(t.options,"type"),l=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 da(l,{migrationId:a,dryRun:t.args.dryRun===!0||t.options.dryRun===!0,author:s,force:r},t.global)}function zh(e){let t=Dh(e),n=Nh(t);if(n!==null)return n;if(t.subcommand==="rename-type"||t.subcommand==="rename-field"||t.subcommand==="remap-status")return qh(t);if(t.subcommand==="add-field")return jh(t);if(t.subcommand==="add-status")return Uh(t);if(t.subcommand==="add-type")return e.args.infer===!0||e.options.infer===!0?Ea({minCount:J(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):Gh(t);throw re({command_path:"schema",token:t.subcommand,allowed:ma,exit_code:64})}function Hh(e){let t=h(e.args,"subcommand")??oe(e.options,"subcommand"),n=t.trim().toLowerCase(),o=h(e.args,"name")??h(e.options,"name"),r=tt({list:()=>Wl(),show:()=>Kl(o),lint:()=>Yl(o),apply:()=>Jl(o,{dryRun:e.args.dryRun===!0||e.options.dryRun===!0,author:h(e.args,"author")??h(e.options,"author"),force:e.args.force===!0||e.options.force===!0},e.global)},n);if(!r)throw re({command_path:"profile",token:t,allowed:Vl,exit_code:64});return r()}async function Bh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return Y(await Bc(L(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Vh(e){let{changedFields:t,runnerOptions:n}=B(e.args,e.options);return Y(await ol(ro(n),e.global),{changedFields:t})}async function Wh(e){let{changedFields:t,runnerOptions:n}=B(e.args,e.options),o=h(e.args,"reason"),s=o!==void 0&&n.reason===void 0?{...n,reason:o}:{...n};return e.force&&s.force===void 0&&(s.force=!0),Y(await Yc(so(s),e.global),{changedFields:t})}async function Kh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),s=h(o,"target")??oe(e.args,"target");return Y(await Oe(L(e,o),s,o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Yh(e){let t=I(process.cwd(),e.global.path),n=await E(t),o=nn(j(n.schema)),s=L(e),r=await Qt(s,e.force,e.global,e.options),i=await be(s,gt(e.options,{status:o,force:e.force},["assignee"]),e.global);return{id:s,action:"start_task",claim:r,update:i}}async function Jh(e){let t=I(process.cwd(),e.global.path),n=await E(t),o=L(e),s=j(n.schema).open_status,r=await be(o,gt(e.options,{status:s,force:e.force},["assignee"]),e.global),i=await en(o,e.force,e.global,e.options);return{id:o,action:"pause_task",update:r,release:i}}async function Xh(e){let t=L(e),n=h(e.args,"reason")??h(e.args,"text")??h(e.options,"reason")??h(e.options,"text"),o=await xe(t,n,{...e.options,force:e.force},e.global),s=await en(t,e.force,e.global,e.options);return{id:t,action:"close_task",close:o,release:s}}function Zh(e){let t={...e.args,...e.options};return Ki(oe(t,"subcommand"),h(t,"id")??e.id,h(t,"target"),ta(t),e.global)}function Qh(e){return oa(I(process.cwd(),e.global.path),{...e.args,...e.options})}var Ud={init:e=>rc(h(e.args,"prefix"),e.global,e.options),context:e=>po(qe("context",e.options),e.global),next:e=>uo(qe("next",e.options),e.global),eval:Sl,events:Il,merge:El,workspace:Al,meet:pn,event:pn,remind:pn,list:Sh,get:e=>{let t=L(e);return go(t,e.global,qe("get",e.options,[t]))},search:Ih,duplicates:e=>{let t=typeof e.options.status=="string"?[e.options.status]:z(e.options.status);return wo(e.global,{exhaustive:e.options.exhaustive===!0,...t.length===0?{}:{status:t},since:h(e.options,"since"),threshold:typeof e.options.threshold=="number"?e.options.threshold:void 0,limit:e.options.limit==="default"?void 0:J(e.options.limit,"limit")})},create:Eh,copy:Ah,focus:e=>Zo(e.id,{clear:e.options.clear===!0||e.args.clear===!0},e.global),update:Rh,"item-reopen":nd,restore:Kh,claim:Ql,release:e=>en(L(e),e.force,e.global,e.options),"start-task":Yh,"pause-task":Jh,"close-task":Xh,close:td,comments:Ch,notes:e=>Zc(L(e),Xt(e.options),e.global),learnings:e=>Xc(L(e),Xt(e.options),e.global),files:Th,docs:e=>Ga(L(e),zt(e.options),e.global),test:e=>Ac(L(e),e.options,e.global),"test-all":e=>Rc(e.options,e.global),telemetry:xh,validate:e=>Jt(e.options,e.global,{runUpdate:(t,n,o)=>be(t,n,o)}),health:Oh,assurance:e=>Ha(e.args,e.options,e.global),contracts:e=>bo(e.options,e.global),config:$h,activity:Ph,aggregate:e=>co(e.options,e.global),extension:e=>Wt(Sn(e),e.options,e.global),package:e=>Wt(Sn(e),e.options,e.global),install:e=>Wt(Sn(e),{...e.options,install:!0},e.global),upgrade:e=>Qa(Sn(e),e.options,e.global),delete:e=>Xo(L(e),e.options,e.global),deps:e=>Wi(L(e),e.options,e.global),graph:Zh,"files-discover":e=>ao(L(e),e.options,e.global),"files-lookup":e=>jd(e,z(e.options.paths)),history:e=>Ka(L(e),e.options,e.global),"history-redact":e=>yc(L(e),e.options,e.global),"history-repair":Xl,"history-compact":Zl,"history-author-acknowledge":Qh,plan:Lh,schema:zh,profile:Hh,stats:e=>vo(e.global,sd(e.options)),append:Bh,"update-many":Vh,"close-many":Wh,gc:e=>ec(e.global,e.options)};function rR(e=Cr){return e.map(t=>{let n=Ae(t),o=tt(Eo,n),s=o?.action??n,r=tt(Ud,s)!==void 0;return{action:t,resolved_action:s,covered:r,route:r?o?"alias":"native":"missing"}})}async function Ld(e,t,n,o){let s=eo(t,e);Tr(e,s),xr(e,s);let r={action:e,args:t,options:s,id:h(t,"id"),force:t.force===!0||s.force===!0,global:n,activeExtensions:o},i=tt(Ud,e),a=i?await i(r):await bh(e,t,s,n,o);s.resolvedOutputFormat="json";let c=Pr(e,s,a);return await qc(I(process.cwd(),n.path),c),c}var eg={closeManyOptionsFromFlat:so,extensionOptionsFromArgs:oo,globalOptions:qt,mutationListOptions:ea,normalizeActionName:Ae,normalizeCommandPath:no,normalizeMcpUpdateOptions:na,normalizeMcpOptionsArrays:Zi,optionsWithAuthor:eo,readRequiredString:oe,readScalarString:Yi,readScalarStringAllowBlank:Ji,readStringArray:z,updateManyOptionsFromFlat:ro,withAddNoteOption:zt,withFilesDiscoveryOptions:to,withMutationCompaction:B};(process.env.NODE_ENV==="test"||process.env.VITEST!==void 0||process.env.VITEST_WORKER_ID!==void 0)&&(globalThis.__pmCliActionRunnerTestHooks=eg);async function tg(e,t,n){let o=await $n({pmRoot:e,settings:t,cwd:n??process.cwd(),noExtensions:!1}),s=await Fn(o);try{return s.registrations}finally{try{await Pn(o,s)}catch{}}}export{Dc as a,tm as b,Ao as c,St as d,cn as e,Gc as f,cg as g,lg as h,dg as i,mg as j,pg as k,Tc as l,ug as m,qd as n,Hd as o,on as p,So as q,$c as r,sn as s,Xd as t,Io as u,Oo as v,zc as w,pm as x,fm as y,_m as z,$o as A,Bc as B,Yc as C,Jc as D,Xc as E,Zc as F,ol as G,Sp as H,sl as I,qo as J,hl as K,Jo as L,Xo as M,Zo as N,yl as O,bl as P,kl as Q,Je as R,es as S,Pu as T,Kb as U,Yb as V,os as W,Cl as X,mv as Y,pv as Z,xl as _,Pl as $,Ov as aa,Ju as ba,ds as ca,Zu as da,Qu as ea,Vl as fa,Wl as ga,Kl as ha,Yl as ia,Jl as ja,nw as ka,ow as la,sw as ma,rw as na,ms as oa,pf as pa,uf as qa,ff as ra,U as sa,_f as ta,hf as ua,gf as va,yf as wa,fs as xa,rd as ya,Ze as za,us as Aa,id as Ba,bf as Ca,ad as Da,vf as Ea,wf as Fa,kf as Ga,Sf as Ha,If as Ia,Of as Ja,md as Ka,$f as La,jf as Ma,Vf as Na,Kf as Oa,H_ as Pa,_h as Qa,b as Ra,TE as Sa,xE as Ta,OE as Ua,$E as Va,PE as Wa,FE as Xa,LE as Ya,ME as Za,DE as _a,NE as $a,jE as ab,UE as bb,GE as cb,qE as db,zE as eb,HE as fb,BE as gb,VE as hb,WE as ib,KE as jb,YE as kb,JE as lb,XE as mb,ZE as nb,QE as ob,eA as pb,tA as qb,nA as rb,oA as sb,sA as tb,rA as ub,iA as vb,aA as wb,cA as xb,lA as yb,dA as zb,mA as Ab,pA as Bb,uA as Cb,fA as Db,_A as Eb,hA as Fb,gA as Gb,yA as Hb,bA as Ib,vA as Jb,wA as Kb,kA as Lb,SA as Mb,IA as Nb,EA as Ob,AA as Pb,RA as Qb,CA as Rb,TA as Sb,xA as Tb,OA as Ub,$A as Vb,PA as Wb,FA as Xb,LA as Yb,MA as Zb,DA as _b,NA as $b,jA as ac,UA as bc,GA as cc,qA as dc,zA as ec,HA as fc,BA as gc,VA as hc,WA as ic,KA as jc,YA as kc,JA as lc,XA as mc,ZA as nc,QA as oc,eR as pc,tR as qc,nR as rc,oR as sc,oe as tc,sR as uc,kh as vc,rR as wc};
+//# sourceMappingURL=chunk-DAM4CBBR.js.map