@unbrained/pm-cli 2026.9.8 → 2026.9.10

package/dist/cli-bundle/chunks/chunk-4SFBH77G.js

@@ -0,0 +1,2233 @@
+import{a as dc,b as Je,c as dn,d as pc,e as uc,h as fc}from"./chunk-NKOYVKFM.js";import{E as vo,G as gc,H as Tc,J as xc,L as Oc,M as $c,a as vt,b as mo,d as Pe,e as lc,k as wo}from"./chunk-7WIHZI2M.js";import{$ as ao,Bc as kc,Cc as Sc,Dc as Ic,Eb as kt,Ec,Ed as So,F as ce,Fb as ho,Fc as Ac,Fd as Io,G as h,H as na,Hb as rc,Hc as Rc,Hd as Mc,I as oa,Ic as Cc,K as X,L as ra,M as Zt,Ma as Ya,Mb as go,Mc as Pc,N as ia,Na as co,O as no,Od as Dc,P as Qt,Pa as Ja,Pd as Nc,Q as oo,Qa as Xa,R as Te,Ra as lo,S as sa,T as ro,U as z,Uc as Fc,V as io,W as B,Wc as Lc,X as aa,Y as ca,Z as so,_ as la,bb as an,cc as St,dc as yo,ec as ic,fc as sc,gc as Ye,ha as da,hc as ac,ib as Za,ic as cc,ja as Wa,jb as cn,jc as It,kb as Qa,kc as bo,lc as Et,ld as ko,ma as Ba,mb as Ve,na as Va,nb as ec,ob as po,pb as ln,rb as Ke,sa as wt,tc as Fe,vb as tc,vc as mc,wb as nc,wc as bc,xb as oc,xc as wc,yc as vc}from"./chunk-MACGGTLQ.js";import{$ as Ta,A as en,B as fa,C as Oe,D as _a,E as tn,F as ha,G as nn,Ga as Fa,M as ga,P as ya,Qa as on,R as ba,S as wa,T as va,U as ka,Ua as _c,V as Sa,W as Ia,X as Ea,Xa as hc,Y as Aa,Z as Ra,_ as Ca,aa as xa,b as Xs,ba as Oa,ca as $a,da as Pa,q as ma,w as pa,y as xe,z as ua,za as bt}from"./chunk-I6XT3DLQ.js";import{Fa as ta,Gc as uo,Oa as La,Pa as Ma,Qa as Da,Ta as Na,Ua as ja,Ub as le,Va as Ua,Wa as Ga,Ya as $e,Za as qa,_ as ea,_a as za,_c as fo,bb as rn,db as Ha,dd as _o,gd as yc,hb as be,ib as Ka,j as Ys,jb as sn,l as Js,y as Zs,z as Qs}from"./chunk-TSWEX72T.js";import{$a as P,$g as Mi,$i as Wi,$j as ns,$l as ys,A as zr,Ad as mt,Af as xi,An as Bs,Bc as oi,Bi as Kn,Bj as Xi,Bn as Vs,Cd as hi,Ci as Yn,D as Hr,Dd as gi,Df as Oi,Dj as Zi,Ej as Qi,Fd as zt,Fn as Ce,Gj as es,Gn as E,Hc as ri,Hd as yi,Hj as O,Id as bi,Ii as Ui,Ij as ae,Jb as jt,Jc as Nn,Jd as wi,Jj as ye,Jm as Es,Kc as jn,Lc as Un,Mc as Gn,Md as ze,Mi as Gi,Mj as ht,Mm as As,N as u,Nc as qn,Nd as Ee,Nm as Rs,Ob as Ge,Oc as zn,Od as vi,P as m,Pa as Pn,Pc as Hn,Pd as ki,Pe as Vn,Pf as Bt,Pj as Kt,Qa as Fn,Qc as T,Qd as Ae,Qe as C,Qi as qi,R as Wr,Ra as Ln,Rd as Si,Re as Q,Rk as eo,S as ge,Sa as Mn,Sj as gt,Td as q,Ti as se,Tj as ts,Tk as to,Ub as Yr,Un as Ks,Vb as Jr,Vc as ii,Vd as pt,Vj as Jn,Vm as Cs,Wb as Xr,Wc as si,Wd as Ii,Wi as zi,Xb as Zr,Xh as ft,Xi as Hi,Xj as Xn,Xl as hs,Xm as Ts,Y as On,Yb as Qr,Yg as Li,Yh as _t,Zb as ei,Zc as G,Zd as Ei,Zi as Vt,Zl as gs,_b as ti,_l as Jt,aa as S,ab as Nt,af as J,ak as os,b as Dr,bd as ai,bf as Wt,bk as rs,bl as us,bn as xs,cd as ci,ck as is,cl as fs,cn as Os,dc as lt,dk as ss,dn as $s,ea as Br,ec as ni,ee as Re,f as Se,fk as as,fm as bs,ga as Vr,ge as He,gj as Bi,gk as cs,gn as Ps,ha as Ft,hb as I,hd as qe,hg as $i,hk as ls,i as Nr,ia as Lt,ig as Pi,ik as yt,ja as Mt,jj as A,jk as ds,jm as ws,ka as Dt,kb as ct,ke as Ht,kh as Di,kj as Vi,kk as Yt,kn as Fs,lb as Dn,ld as li,le as ut,lg as Fi,lj as Ki,lk as ms,ln as Ls,md as di,me as Bn,mj as Yi,mk as Zn,ml as _s,mn as Ms,n as he,nb as Ie,nk as Qn,nm as vs,nn as Ds,o as Ue,ok as ps,om as ks,on as Ns,p as xn,pa as ie,pd as dt,q as re,qd as mi,qm as Ss,qn as js,r as te,rd as pi,rn as Us,s as st,sd as ui,sh as Ni,sn as Gs,t as jr,td as fi,tm as Is,tn as qs,uj as Ji,un as zs,vh as We,vi as Be,vn as Hs,wa as Kr,x as Ur,xa as at,xc as Ut,xe as Ai,xf as Ti,y as Gr,yc as Gt,yd as Wn,ye as Ri,yn as Ws,z as qr,za as $n,zc as qt,zd as _i,ze as Ci,zh as ji,zn as Xt}from"./chunk-YKQTETJI.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 wg=jr,vg=Ur,kg=zr,Sg=Gr,Ig=qr;function jc(e,t,n,o){let r=e.flag.slice(2).replace(/[-_]([a-z])/gu,(s,a)=>a.toUpperCase()),i=n.has(r);return{long:t,...o?{short:o}:{},description:e.description??`Standard pm ${e.flag} option.`,...e.required===!0?{required:!0}:{},...e.list===!0?{list:!0}:{},...e.repeatable===!0?{repeatable:!0}:{},value_type:i?"string":"boolean",...i?{value_name:e.value_name??"value"}:{}}}function Uc(e,t=[]){let n=new Set(t.flatMap(r=>r.keys)),o=[];for(let r of hs(e.map(i=>({...i})))){o.push(jc(r,r.flag,n,r.short));for(let i of r.aliases??[])o.push(jc(r,i,n))}return o}var Eg=Uc(Jt,us),Zd=Uc(Xt,fs);import{AsyncLocalStorage as Ph}from"node:async_hooks";(function(){try{var e=typeof window<"u"?window:typeof 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 Gc(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function Qd(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 Eo(e,t){let n=Qd(t),o=n==="brief"?n:Gc(e.projection)&&typeof e.projection.mode=="string"?e.projection.mode:n;return{...e,query_summary:{filters:Gc(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 qc(e,t){let n=I(t??process.cwd(),e),o=await A(n);return ht(n,o.item_format,P(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 em=["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"],mn=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 Ao(e={}){return{excludeTerminal:!1,full:!0,...e.includeBody===void 0?{}:{includeBody:e.includeBody},noTruncate:!0,outputBudget:"unbounded",outputLimit:"unbounded",strictRead:!0}}function de(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function F(e,t,n,o){t&&e.push({code:n,message:o})}function tm(e,t){let n=de(e.completeness)?e.completeness:{};F(t,n.status==="partial","source_incomplete","The source scan reported unreadable tracker artifacts."),F(t,n.status!=="complete"&&n.status!=="partial","source_unchecked","The source scan did not prove completeness.");let o=n.unreadable_item_count,r=n.unreadable_directory_count;F(t,n.status==="complete"&&(o!==0||r!==0)&&Number.isSafeInteger(o)&&Number.isSafeInteger(r),"source_incomplete","The source scan reports unreadable tracker artifacts despite a complete status."),F(t,n.status==="complete"&&(!Number.isSafeInteger(o)||!Number.isSafeInteger(r)||Number(o)<0||Number(r)<0),"source_unchecked","The source scan did not report safe non-negative unreadable counts.");let i=de(e.filters)?e.filters:{},s=de(i.runtime_filters)?i.runtime_filters:{},a=new Set(["exclude_terminal","include_body","no_truncate","runtime_filters","status","strict_read"]);return F(t,i.status!=="all"||Object.keys(s).length>0||Object.keys(i).some(c=>!a.has(c)),"filtered_corpus","The list did not explicitly select every lifecycle status."),F(t,i.exclude_terminal===!0,"terminal_items_excluded","Terminal lifecycle states were explicitly excluded."),F(t,i.strict_read!==!0,"strict_read_unproven","The result does not echo strict source-read enforcement."),i}function nm(e,t,n){F(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."),F(n,e.count!==e.items.length||e.total!==e.items.length,"count_mismatch","Envelope counts do not equal the returned item count.");let o=de(e.projection)?e.projection:{};F(n,o.mode!=="full"||o.fields!==null,"projection_incomplete","The result is not the full metadata projection.");let r=de(e.omission_receipt)?e.omission_receipt:void 0;F(n,r===void 0,"omission_receipt_missing","The result carries no field-omission receipt."),F(n,r!==void 0&&(r.has_omissions!==!1||r.omitted_field_group_count!==0||!Number.isSafeInteger(r.omitted_field_group_count)||!Array.isArray(r.omitted_field_groups)||r.omitted_field_groups.length!==0),"omission_receipt_invalid","The field-omission receipt is malformed or contradicts its no-omission claim."),F(n,r?.has_omissions===!0,"field_omission","The omission receipt reports withheld field groups.")}function om(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 rm(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 im(e,t){let n=de(e.read_output)?e.read_output:void 0;F(t,n===void 0,"read_output_missing","The result carries no universal read-output receipt."),F(t,n!==void 0&&om(n),"read_output_invalid","The universal read-output receipt does not prove an intact list result."),F(t,n!==void 0&&!rm(n),"read_output_dimensions_incomplete","The universal read-output receipt does not prove full, unbounded include, amount, and cost dimensions."),F(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=de(e.output_budget_exceeded)?e.output_budget_exceeded:void 0;F(t,n?.result_omitted===!0||o?.omitted_result===!0,"budget_omission","Universal output shaping omitted the useful result."),F(t,e.read_session!==void 0,"session_projection","A cross-call read session can suppress previously served facts.")}function sm(e,t){let n=e.map(o=>de(o)&&typeof o.id=="string"?o.id.trim():"");F(t,n.some(o=>o.length===0),"invalid_item_id","Every full item row must carry a non-empty string id."),F(t,new Set(n).size!==n.length,"duplicate_item_id","Every item id must occur exactly once.")}function zc(e){if(!de(e)||!Array.isArray(e.items))return{ok:!1,findings:[{code:em[0],message:"The result must be an object with an items array."}]};let t=e,n=[],o=tm(t,n);return nm(t,o,n),im(t,n),sm(t.items,n),{ok:n.length===0,findings:n}}function pn(e){let t=zc(e);if(!t.ok)throw new mn(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 am(e){pn(e)}import Vc 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]="0c84b11c-502f-5c33-a757-5757402357b4")}catch{}})();function Hc(e){return e.map(t=>({key:t.key,optionName:Ii(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 Wc(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 cm=50,we=new Map;function Ro(){we.clear()}function Bc(e,t){let n=we.get(e);if(n!==void 0)return n;if(we.size>=cm){let r=we.keys().next().value;we.delete(r)}let o=t().catch(r=>{throw we.get(e)===o&&we.delete(e),r});return we.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]="b841f903-6276-5067-842f-6a6bff114cec")}catch{}})();function lm(e,t,n){return JSON.stringify([Vc.resolve(e),Vc.resolve(n??process.cwd()),t.extensions.enabled,t.extensions.disabled,t.extensions.policy])}async function dm(e,t,n){let o=lm(e,t,n);return Bc(o,()=>pm(e,t,n))}async function mm(e,t={}){let n=await A(e),o=t.extensionRegistrations??(t.noExtensions===!0?null:await dm(e,n,t.cwd)),r=P(n,o),i=q(n.schema),s=pt(n.schema);return{types:[...r.types],statuses:i.definitions.map(a=>a.id),openStatus:i.open_status,closeStatus:i.close_status,canceledStatus:i.canceled_status,fields:Hc(s.definitions),extensionCommands:Wc(o?.commands??[])}}async function pm(e,t,n){let o=await Ut({pmRoot:e,settings:t,cwd:n??process.cwd(),noExtensions:!1}),r=await qt(o);try{return r.registrations}finally{try{await Gt(o,r)}catch{}}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="0c7a926a-46a2-560c-ae95-33b92b8c820e")}catch{}})();var um={"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 Kc(e){return Object.fromEntries($i.map(t=>[`${e}-${t}`,{action:e,options:{[t==="adopt-all"?"adoptAll":t]:!0,...e==="package"?{vocabulary:"package"}:{}}}]))}var Co={ctx:{action:"context"},...um,...Kc("extension"),...Kc("package"),...Object.fromEntries(Pi.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 Yc="PmCliError";function fm(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 _m(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,fm(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 To(e){if(!(e instanceof Error)||e.name!==Yc)return!1;let t=e;return typeof t.exitCode=="number"&&Number.isFinite(t.exitCode)}import{constants as At}from"node:fs";import{lstat as Jc,mkdir as Oo,open as Xc}from"node:fs/promises";import me from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="e57a9bca-1190-5ffd-bb7d-d76a22fc9e57")}catch{}})();function xo(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Relationship event ${t} must be non-empty`);return e.trim()}function $o(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 hm(e){return Object.freeze({...e,...e.payload===void 0?{}:{payload:Object.freeze(structuredClone(e.payload))}})}function gm(e,t,n,o){let r=n.require(e.kind),i=o.outgoingOne.get(`${r.kind}\0${e.source}`);if(i!==void 0&&i!==t)throw new TypeError(`Relationship outgoing cardinality exceeded for ${r.kind}`);let s=o.incomingOne.get(`${r.kind}\0${e.target}`);if(s!==void 0&&s!==t)throw new TypeError(`Relationship incoming cardinality exceeded for ${r.kind}`);let a=$o(e,n),c=o.identities.get(a);if(c!==void 0&&c!==t)throw new TypeError(`Relationship edge already active: ${a}`)}function ym(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 bm(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=xo(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:xo(e.relationshipId,"relationshipId"),author:xo(e.author,"author"),timestamp:new Date(e.timestamp).toISOString()}}function wm(e,t,n,o,r,i){let s=n.has(t);if(e.action==="add"&&s)throw new TypeError(`Relationship is already active: ${t}`);if(e.action!=="add"&&!s)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 Ge([a,c],[e.edge],r).edges()[0];return gm(l,t,r,i),hm(l)}var Rt=class{#t;#n;#o=[];#i=new Set;#e=new Map;#r={identities:new Map,outgoingOne:new Map,incomingOne:new Map};constructor(t,n={}){this.#t=new Set([...t].filter(o=>typeof o=="string").map(o=>o.trim()).filter(Boolean)),this.#n=n.registry??jt()}get version(){return this.#o.length}events(){return Object.freeze([...this.#o])}*stream(t={}){let n=t.fromVersion??1,o=t.toVersion??this.version,r=t.batchSize??100;if(!Number.isInteger(n)||n<1)throw new TypeError("Relationship event stream fromVersion must be positive");if(!Number.isInteger(o)||o<0||o>this.version)throw new TypeError(`Relationship event stream toVersion out of range: ${o}`);if(!Number.isInteger(r)||r<1)throw new TypeError("Relationship event stream batchSize must be positive");if(n>o+1)throw new TypeError("Relationship event stream fromVersion exceeds the selected prefix");for(let i=n-1;i<o;i+=r)yield Object.freeze(this.#o.slice(i,Math.min(i+r,o)))}project(t,n,o={}){if(typeof n!="function")throw new TypeError("Relationship event projection requires a reducer");let r=t,i=0,s;for(let a of this.stream({...o,batchSize:256}))for(let c of a)r=n(r,c),i+=1,s=c;return Object.freeze({state:r,version:s?.sequence??Math.max(0,(o.fromVersion??1)-1),processed:i,...s===void 0?{}:{asOf:s.timestamp}})}#s(t,n){let o=this.#n.require(n.kind);this.#r.identities.set($o(n,this.#n),t),o.outgoing==="one"&&this.#r.outgoingOne.set(`${o.kind}\0${n.source}`,t),o.incoming==="one"&&this.#r.incomingOne.set(`${o.kind}\0${n.target}`,t)}#a(t){let n=this.#n.require(t.kind);this.#r.identities.delete($o(t,this.#n)),n.outgoing==="one"&&this.#r.outgoingOne.delete(`${n.kind}\0${t.source}`),n.incoming==="one"&&this.#r.incomingOne.delete(`${n.kind}\0${t.target}`)}append(t){let n=bm(t,this.version,this.#i),o=this.#e.get(n.relationshipId),r=wm(t,n.relationshipId,this.#e,this.#t,this.#n,this.#r),i=Object.freeze({eventId:n.eventId,relationshipId:n.relationshipId,action:t.action,...r===void 0?{}:{edge:r},author:n.author,timestamp:n.timestamp,...t.reason?.trim()?{reason:t.reason.trim()}:{},sequence:this.version+1});return this.#o.push(i),this.#i.add(n.eventId),o&&this.#a(o),t.action==="remove"?this.#e.delete(n.relationshipId):(this.#e.set(n.relationshipId,r),this.#s(n.relationshipId,r)),i}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 i=Date.parse(t.atTimestamp);if(!Number.isFinite(i))throw new TypeError("Relationship snapshot timestamp must be valid");n=this.#o.filter(s=>Date.parse(s.timestamp)<=i)}else{let i=t.atVersion??this.version;if(!Number.isInteger(i)||i<0||i>this.version)throw new TypeError(`Relationship snapshot version out of range: ${i}`);n=this.#o.slice(0,i)}let o=ym(n),r=new Ge(this.#t,o.values(),this.#n);return Object.freeze({version:n.at(-1)?.sequence??0,...n.at(-1)?{asOf:n.at(-1).timestamp}:{},edges:r.edges(),graph:r})}page(t){if(!Number.isInteger(t.limit)||t.limit<1)throw new TypeError("Relationship event page limit must be positive");let n=Ti("relationship-events",{order:"append-sequence"}),o=t.cursor===void 0?this.version:Number(xi(t.cursor,n).snapshot);if(!Number.isSafeInteger(o)||o<0||o>this.version)throw new TypeError("Relationship event cursor snapshot version is invalid");let r=Oi(this.#o.slice(0,o),{cursor:t.cursor,fingerprint:n,limit:t.limit,readId:i=>i.eventId,snapshot:String(o)});return{version:o,events:r.rows,hasMore:r.has_more,...r.next_cursor?{nextCursor:r.next_cursor}:{}}}},vm="relationship-event-store",Zc=At.O_NOFOLLOW;function un(e){return Q(e,vm,30,`relationship-store:${process.pid}`,!1,!1,3e3)}async function Le(e,t="relationships/events.jsonl"){let n=me.resolve(e),o=me.resolve(n,t),r=me.relative(n,o);if(r.length===0)throw new TypeError("Relationship event path must name a file within the tracker root");if(r===".."||r.startsWith(`..${me.sep}`)||me.isAbsolute(r))throw new TypeError("Relationship event path must stay within the tracker root");if(await Oo(n,{recursive:!0}),(await Jc(n)).isSymbolicLink())throw new TypeError("Relationship event tracker root must not be a symbolic link");let s=n;for(let a of r.split(me.sep)){s=me.join(s,a);try{if((await Jc(s)).isSymbolicLink())throw new TypeError("Relationship event path must not contain symbolic links")}catch(c){if(xn(c))break;throw c}}return o}async function fn(e,t,n){let o=new Rt(t,{registry:n}),r,i;try{i=await Xc(e,At.O_RDONLY|Zc),r=await i.readFile("utf8")}catch(a){if(xn(a))return{log:o,raw:""};throw a}finally{await i?.close()}let s=r.split(`
+`);for(let a=0;a<s.length;a+=1){let c=s[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:r}}function km(e,t,n,o){let r=Date.parse(t.timestamp),i;return t.action!=="remove"&&t.edge!==void 0&&(i=new Ge(n,[t.edge],o).edges()[0]),e.eventId===t.eventId.trim()&&e.relationshipId===t.relationshipId.trim()&&e.action===t.action&&e.author===t.author.trim()&&Number.isFinite(r)&&e.timestamp===new Date(r).toISOString()&&e.reason===(t.reason?.trim()||void 0)&&lt(e.edge)===lt(i)}var _n=class e{#t;#n;#o;#i;#e;constructor(t,n,o,r){this.#t=t.pmRoot,this.#n=n,this.#o=t.registry,this.#i=o,this.#e=r}static async open(t){let n=Object.freeze([...t.nodes]),o=await Le(t.pmRoot,t.relativePath),r=await un(t.pmRoot);try{await Le(t.pmRoot,o);let{log:i}=await fn(o,n,t.registry);return new e(t,n,o,i)}finally{await r()}}get path(){return this.#i}async currentVersion(){return this.#e=await this.#r(),this.#e.version}async append(t){let n=await un(this.#t);try{let o=await Le(this.#t,this.#i),{log:r}=await fn(o,this.#n,this.#o),i=r.append(t);await Oo(me.dirname(o),{recursive:!0}),await Le(this.#t,o);let s=await Xc(o,At.O_APPEND|At.O_CREAT|At.O_WRONLY|Zc);try{await s.appendFile(`${JSON.stringify(i)}
+`,"utf8")}finally{await s.close()}return this.#e=r,i}finally{await n()}}async appendBatch(t,n={}){let o=await un(this.#t);try{let r=await Le(this.#t,this.#i),{log:i,raw:s}=await fn(r,this.#n,this.#o),a=i.version,c=new Map(i.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"&&km(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 w=i.append(p);c.set(w.eventId,w),l.push(w)}if(l.length>0){let p=s.length===0||s.endsWith(`
+`)?s:`${s}
+`;await Oo(me.dirname(r),{recursive:!0}),await Le(this.#t,r),await te(r,`${p}${l.map(f=>JSON.stringify(f)).join(`
+`)}
+`)}return this.#e=i,Object.freeze({version_before:a,version_after:i.version,appended:Object.freeze(l),skipped_event_ids:Object.freeze(d)})}finally{await o()}}async snapshot(t={}){return this.#e=await this.#r(),this.#e.snapshot(t)}async page(t){return this.#e=await this.#r(),this.#e.page(t)}async*stream(t={}){this.#e=await this.#r(),yield*this.#e.stream(t)}async project(t,n,o={}){return this.#e=await this.#r(),this.#e.project(t,n,o)}async#r(){let t=await un(this.#t);try{let n=await Le(this.#t,this.#i);return(await fn(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 Po(e){let t=jt();for(let n of e)t.register(n);return t}function Qc(e,t){return{client:t,isItemNotFoundError:n=>To(n)&&n.exitCode===u.NOT_FOUND,getItemAt:(n,o)=>Ys(n,o,{pmRoot:e}),openRelationshipEventStore:n=>_n.open({pmRoot:e,nodes:n.nodes,registry:Po(n.definitions),...n.relativePath===void 0?{}:{relativePath:n.relativePath}}),createRelationshipGraph:n=>new Ge(n.nodes,n.edges,Po(n.definitions)),analyzeRelationshipImpact:(n,o,r)=>Js(n,o,r),validateRelationshipEvents:n=>{let o=new Rt(n.nodes,{registry:Po(n.definitions)});return n.events.map(r=>o.append({...r,expectedVersion:o.version}))},commitWorkspaceTransaction:n=>Xs({...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 el(e,t,n=Di){try{await n({pmRoot:e,result:t})}catch{if(typeof t=="object"&&t!==null&&!Array.isArray(t)){let o=t,r=Array.isArray(o.warnings)?o.warnings.filter(i=>typeof i=="string"):[];o.warnings=[...new Set([...r,"context_usage_feedback_write_failed"])].sort()}}}import{readFile as Sm}from"node:fs/promises";import Im 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 Fo="context-intents.json";function hn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Em(e,t,n){if(!hn(e))throw new TypeError(`${t} context intent at index ${String(n)} must be an object`);let o=e.included_field_groups;if(typeof e.command!="string"||typeof e.intent!="string"||typeof e.description!="string"||!Array.isArray(o)||!o.every(r=>typeof r=="string")||typeof e.token_budget!="number")throw new TypeError(`${t} context intent at index ${String(n)} has an invalid contract shape`);return{command:e.command,intent:e.intent,description:e.description,included_field_groups:o,token_budget:e.token_budget}}function tl(e,t){let n=Array.isArray(e)?e:hn(e)&&Array.isArray(e.intents)?e.intents:void 0;if(!n)throw new TypeError(`${t} context intents must be an array or an object with an intents array`);return n.map((o,r)=>Em(o,t,r))}async function Am(e){let t=Im.join(e,Fo),n;try{n=await Sm(t,"utf8")}catch(r){if(Ue(r))return[];throw await es(e),r}let o;try{o=JSON.parse(n)}catch(r){let i=r instanceof Error?r.message:String(r);throw new TypeError(`Invalid ${Fo}: ${i}`,{cause:r})}return tl(o,Fo)}function Rm(e){if(!hn(e))return;let t=e.contextIntents??e.context_intents;if(t!==void 0)return t;let n=e.default;return hn(n)?n.contextIntents??n.context_intents:void 0}function Cm(e){return e.flatMap(t=>{let n=Rm(t.module);return n===void 0?[]:tl(n,`package ${t.name}`)})}async function Tm(e){let t=await Am(e.pmRoot),n=Cm(e.packages??[]);return{workspaceContracts:t,packageContracts:n}}async function Lo(e,t){let n=await Tm(e);return await Ni(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 ol(e,t,n){if(t.body===void 0)throw new m("Missing required --body text",u.USAGE);let o=zt(),r=I(process.cwd(),n.path);await O(r);let i=await A(r),s=C(t.author,i.author_default),c=(await o.resolveValue(t.body,"--body",gi(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 gt({pmRoot:r,settings:i,id:e,op:"append",author:s,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 il=1,Mo="close-many",xm=["--filter-status","--filter-type","--filter-tag","--filter-priority","--filter-sprint","--filter-release","--filter-parent","--filter-assignee","--filter-updated-before","--ids"].join(", ");function Om(e,t){return vt(e,t,{includePagination:!1})}function $m(e,t){return vt(e,t)}function Pm(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 Fm(e){let t={};if(!e)return t;for(let[n,o]of Object.entries(e))o==null||typeof o=="string"&&!o.split(",").some(r=>r.trim().length>0)||(t[n]=o);return t}function Lm(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 Mm(e,t){let n=q(t.schema),o=P(t,T()),r=await ht(e,t.item_format,o.type_to_folder,void 0,t.schema),i=new Map,s=new Map;for(let a of r){if(typeof a.parent!="string"||a.parent.length===0||(s.set(a.id,a.parent),He(a.status,n)))continue;let c=i.get(a.parent);c?c.push(a.id):i.set(a.parent,[a.id])}for(let a of i.values())a.sort((c,l)=>c.localeCompare(l));return{childrenByParent:i,parentByChild:s}}function rl(e,t,n){let o=n?.get(e);if(o!==void 0)return o;let r=0,i=t.get(e),s=[],a=new Set,c=!1;for(;i!==void 0&&!a.has(i);){let l=n?.get(i);if(l!==void 0){r+=l+1;break}a.add(i),s.push(i),r+=1,i=t.get(i)}if(i!==void 0&&a.has(i)&&(c=!0),!c){n?.set(e,r);for(let[l,d]of s.entries())n?.set(d,r-l-1)}return r}async function Dm(e){let t=await Mt(e.pmRoot,Mo,e.rollbackId,il),n=e.options.message??`Rollback close-many checkpoint ${t.id}`,o=await Dt(t.items,(r,i)=>Pe(r,i,{author:e.options.author,message:n,force:!0},e.global));return{...Fe({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 Nm(e,t,n,o,r){return e.map(i=>{let s=(t.get(i.id)??[]).filter(c=>!n.has(c)),a=!sl(i,o,r);return{id:i.id,title:typeof i.title=="string"?i.title:"",status:i.status,action:a?"skip":"close",...a?{skip_reason:"already_terminal"}:{},...s.length>0?{active_child_ids:s}:{}}})}async function jm(e){let t=await Lt(e.pmRoot,Mo,e.checkpointId,{schema_version:il,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 Um(e){let t=[],n=[];for(let o of e.matched){if(!e.closableIds.has(o.id)){t.push({id:o.id,status:"skipped",skip_reason:"already_terminal"});continue}try{let r=await kt(o.id,e.reason,e.closeOptions,e.global);t.push({id:o.id,status:"closed",changed_fields:r.changed_fields,...r.warnings&&r.warnings.length>0?{warnings:r.warnings}:{}}),n.push(o.id)}catch(r){t.push({id:o.id,status:"failed",error:ge(r)})}}return{rows:t,closedIds:n}}function Gm(e){return typeof e.rollback=="string"?e.rollback:void 0}function qm(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($m(e.list,e.status))throw new m("Rollback mode does not accept filter options",u.USAGE)}function zm(e){if(!Om(e.list,e.status))throw new m(`close-many requires at least one filter to scope the close (for example: ${xm}). Refusing to match every item.`,u.USAGE)}function Hm(e,t){let n=new Map;return[...e].sort((o,r)=>{let i=rl(r.id,t,n)-rl(o.id,t,n);return i!==0?i:o.id.localeCompare(r.id)})}function sl(e,t,n){return n||!He(e.status,t)}function Wm(e,t,n){return new Set(e.filter(o=>sl(o,t,n)).map(o=>o.id))}async function Bm(e){zm(e.options);let t=q(e.settings.schema),n=Lm(e.options.reason,e.settings.governance.require_close_reason),o=e.options.force===!0,r=await le(e.options.status,Fm(e.options.list),e.global),{childrenByParent:i,parentByChild:s}=await Mm(e.pmRoot,e.settings),a=Hm(r.items,s),c=[...new Set(String(e.options.list?.ids??"").split(",").map(f=>f.trim()).filter(f=>f.length>0))],l=c.length===0?[]:(await le(void 0,{ids:c.join(","),noTruncate:!0,full:!0},e.global)).items,d=new Set(l.map(f=>f.id)),p=Wm(a,t,o);return{pmRoot:e.pmRoot,settings:e.settings,statusRegistry:t,reason:n,validateCloseMode:e.options.validateClose,force:o,listed:r,matched:a,unmatchedIds:c.length===0?void 0:c.filter(f=>!d.has(f)),planRows:Nm(a,i,p,t,o)}}function Vm(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 Km(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 jm({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 al(e,t){let n=I(process.cwd(),t.path);await O(n);let o=await A(n),r=e.dryRun===!0,i=Gm(e);if(Pm(e.list),i!==void 0)return qm(e,i),Dm({pmRoot:n,rollbackId:i,options:e,global:t});let s=await Bm({pmRoot:n,settings:o,options:e,global:t});if(r)return Vm(s);let a=new Set(s.planRows.filter(_=>_.action==="close").map(_=>_.id)),c=S(),l=Ft(Mo,c),d=await Km({context:s,options:e,closableIds:a,checkpointId:l,nowValue:c}),p={author:e.author,message:e.message??`close-many apply ${l}`,completedAt:e.completedAt,validateClose:s.validateCloseMode,force:s.force,resolution:e.resolution,expectedResult:e.expectedResult,actualResult:e.actualResult},{rows:f,closedIds:g}=await Um({matched:s.matched,closableIds:a,reason:s.reason,closeOptions:p,global:t}),w=f.filter(_=>_.status==="closed").length,v=f.filter(_=>_.status==="skipped").length,y=f.filter(_=>_.status==="failed").length;return{...Fe({applied:w,skipped:v,failed:y,unmatched:s.unmatchedIds?.length??0}),mode:"apply",matched_count:s.matched.length,dry_run:!1,...s.reason!==void 0?{reason:s.reason}:{},filters:s.listed.filters,...s.validateCloseMode?{validate_close:s.validateCloseMode}:{},...d?{checkpoint:d}:{},closed_count:w,skipped_count:v,failed_count:y,rows:f,ids:g,...s.unmatchedIds!==void 0?{unmatched_ids:s.unmatchedIds,unmatched_count:s.unmatchedIds.length}:{}}}import{readFile as Ym}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 Do(e,t){let n=e.add!==void 0,o=e.stdin===!0,r=typeof e.file=="string",i=Number(n)+Number(o)+Number(r);if(i===0)return;if(i>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",hi(e))??"",emptyFlag:"--add"};if(o)return po(e,"--stdin"),{value:await t.resolveValue("-","--stdin")??"",emptyFlag:"--stdin"};let s=e.file.trim();if(!s)throw new m("--file path cannot be empty",u.USAGE);if(s==="-")return po(e,"--file -"),{value:await t.resolveValue("-","--file")??"",emptyFlag:"--file"};try{return{value:await Ym(s,"utf8"),emptyFlag:"--file"}}catch(a){if(ec(a)&&Ue(a))throw new m(`--file path not found: ${s}. Use --file - to read stdin.`,u.USAGE);let c=a instanceof Error?a.message:String(a);throw new m(`Failed to read --file path "${s}": ${c}. Use --file - to read stdin.`,u.USAGE)}}async function Jm(e,t){let n=e.edit,o=e.delete,r=n!==void 0,i=o!==void 0;if(r&&i)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(i){if(await Do(e,t)!==void 0)throw new m("--delete does not take comment text",u.USAGE);return{mode:"delete",index:o}}if(r){let c=await Do(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 s=await Do(e,t);return s===void 0?{mode:"list"}:{mode:s.emptyFlag==="--add"?"add":s.emptyFlag==="--stdin"?"stdin":"file",value:s.value,emptyFlag:s.emptyFlag}}async function cl(e,t,n){let o=zt(),r=await Jm(t,o),i=r.mode==="add"||r.mode==="edit",s=r.value??"";return Ke(e,t,n,{input:{...r,rawValue:t.add??s,value:i?Ve(s,{stripPlainTextPrefix:!0}):s},collectionKey:"comments",op:"comment_add",editOp:"comment_edit",deleteOp:"comment_delete",parseText:a=>a,createEntry:a=>a,bypassOwnershipConflict:!!(r.mode==="add"&&t.ownershipAppendBypass),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm comments pm-a1b2 --add "review note" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}})}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="99f91321-fd91-5ec6-8d09-1493f40dacb1")}catch{}})();async function ll(e,t,n){return Ke(e,t,n,{input:await ln(t,"learning"),collectionKey:"learnings",op:"learning_add",editOp:"learning_edit",deleteOp:"learning_delete",parseText:o=>Ve(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 Xm(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 Zm(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 Qm(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 dl(e,t,n){let o=Xm(t.addJson),r=[t.add!==void 0,t.stdin===!0,t.file!==void 0,t.edit!==void 0,t.delete!==void 0].includes(!0);if(o!==void 0&&r)throw new m("--add-json cannot be combined with text, edit, delete, stdin, or file inputs",u.USAGE,{code:"structured_event_input_conflict"});let i=o===void 0?void 0:lt(o),s=[t.since,t.eventType].some(w=>w!==void 0),a=Qm(t.since),c=qi(t.limit),l=await Ke(e,{...t,...s?{limit:void 0}:{},includeMeta:[t.includeMeta===!0,s].includes(!0)},n,{input:await ln(i===void 0?t:{add:i},"note"),collectionKey:"notes",op:"note_add",editOp:"note_edit",deleteOp:"note_delete",parseText:w=>Ve(w),createEntry:w=>o===void 0?w:{...w,format:"json",data:o,event_type:Zm(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(w=>{let v=[w.format==="json",w.data!==void 0].every(Boolean),y=[a===void 0,Date.parse(w.created_at)>=(a??Number.POSITIVE_INFINITY)].includes(!0),_=[!d,w.event_type===d].includes(!0);return[!s,[v,y,_].every(Boolean)].includes(!0)}),f=s?Qa(p,c):p,g=f.filter(w=>w.format==="json").length;return{...l,notes:f,count:f.length,...s?{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 pl=1,jo="update-many",ep=new Set(["author","message","force","ownershipMetadataBypass","ownershipDependencyBypass","allowUnresolvedDeps"]),tp=["--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(", "),np={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"},op=[{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"}],rp={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"},ul=e=>{let t={};for(let[n,o]of Object.entries(e))ep.has(n)||o!==void 0&&(t[n]=o);return t},ip=e=>Object.keys(ul(e)).length>0,fl=e=>typeof e=="string"?e.trim():e,sp=e=>{let t=String(e).trim(),n=Number(t);return Number.isInteger(n)?n:t},No=e=>{let t=String(e).trim(),n=Number(t);return Number.isFinite(n)?n:t},ap=e=>{let t=String(e).trim().toLowerCase();return new Map([["true",!0],["1",!0],["false",!1],["0",!1]]).get(t)??fl(e)},cp={priority:sp,estimatedMinutes:No,order:No,rank:No,regression:ap},lp=(e,t)=>{if(t!==void 0)return(cp[e]??fl)(t)},dp=e=>{let t=e.trim().toLowerCase().replaceAll("-","_");return rp[t]??t},gn=(e,t)=>ni(e,t),mp=(e,t)=>t!==void 0?t:e==="type_options"?{}:[],pp=(e,t)=>Array.isArray(t)?t.length:e==="type_options"&&t&&typeof t=="object"?Object.keys(t).length:0,up=e=>e.replace?"replace":e.clear?"clear_or_reset":e.removeCount>0?"merge_remove":"append",ml=(e,t)=>t===void 0?void 0:e[t],Xe=e=>Array.isArray(e)?e.length:0,fp=(e,t,n)=>{let o=n[e.addKey],r=ml(n,e.removeKey),i=Xe(o),s=Xe(r),a=n[e.clearKey]===!0,c=ml(n,e.replaceKey)===!0;if(![a,c,i>0,s>0].includes(!0))return;let l=mp(e.field,t[e.field]);return{field:e.field,before:l,after:{operation:up({replace:c,clear:a,removeCount:s}),clear:a,replace:c,add_count:i,remove_count:s,before_count:pp(e.field,l)}}},_p=(e,t)=>{let n=[];for(let o of op){let r=fp(o,e,t);r!==void 0&&n.push(r)}return n},hp=e=>Array.isArray(e)?e.filter(t=>typeof t=="string"):[],gp=(e,t)=>{if(![t.tags!==void 0,Xe(t.addTags)>0,Xe(t.removeTags)>0].includes(!0))return;let n=hp(e.tags),o=t.tags===void 0?n:dt(t.tags),r=ui(o,t.addTags),i=fi(r,t.removeTags).slice().sort((a,c)=>a.localeCompare(c)),s=n.slice().sort((a,c)=>a.localeCompare(c));if(!gn(s,i))return{field:"tags",before:n,after:i}},yp=(e,t)=>{let n=e.acceptance_criteria,o=pi(mi(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 r=o.criteria.join("; ");if(!gn(typeof n=="string"?n:"",r))return{field:"acceptance_criteria",before:n,after:r}},bp=(e,t,n)=>{for(let[o,r]of Object.entries(np)){let i=n[o];if(i===void 0)continue;let s=t[r],a=lp(o,i);gn(s,a)||e.push({field:r,before:s,after:a})}},wp=(e,t,n,o)=>{let r=Ei(n,o,["update_many"]);for(let[i,s]of Object.entries(r)){let a=t[i];gn(a,s)||e.push({field:i,before:a,after:s})}},vp=(e,t,n)=>{for(let o of n??[]){let r=dp(o),i=t[r];i!==void 0&&e.push({field:r,before:i,after:null})}},kp=(e,t,n={})=>{let o=e,r=[],i=gp(o,n);if(i&&r.push(i),bp(r,o,n),Xe(n.addAc)>0||Xe(n.removeAc)>0){let s=yp(o,n);s!==void 0&&r.push(s)}return r.push(..._p(o,n)),wp(r,o,n,t),vp(r,o,n.unset),{id:e.id,changes:r}},Sp=(e,t)=>Gi(e,t,{strict:!0,flagLabel:"--filter-status"}),Ip=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)},Ep=[({update:e})=>{e.priority!==void 0&&Ui(e.priority)},({update:e,settings:t,pmRoot:n})=>{if(e.type===void 0)return;let o=P(t,T());if(!Nt(e.type,o))throw new m(Wi(e.type,o.types,Si(n,t.schema)),u.USAGE)},({update:e,statusRegistry:t})=>{if(e.status!==void 0&&!Re(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&&Vr(e.deadline,new Date,"deadline")},({update:e})=>{e.estimatedMinutes!==void 0&&yi(e.estimatedMinutes,"estimated-minutes")}],Ap=(e,t,n,o)=>{let r={update:e,settings:t,statusRegistry:n,pmRoot:o};for(let i of Ep)i(r)},Rp=async e=>{let t=await Mt(e.pmRoot,jo,e.rollbackId,pl),n=e.options.update?.message??`Rollback update-many checkpoint ${t.id}`,o=await Dt(t.items,(r,i)=>Pe(r,i,{author:e.options.update?.author,message:n,force:e.options.update?.force??!0},e.global));return{...Fe({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}},Cp=async e=>{let t={schema_version:pl,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 Lt(e.pmRoot,jo,e.checkpointId,t);return{id:e.checkpointId,created_at:e.nowValue,path:n,rollback_command:`pm update-many --rollback ${e.checkpointId}`}},Tp=(e,t)=>{if(e==null)return;let n=[...new Set(String(e).split(",").map(r=>r.trim()).filter(r=>r.length>0))],o=new Set(t.map(r=>r.id));return n.filter(r=>!o.has(r))},Uo=e=>e.unmatchedIds===void 0?{}:{unmatched_ids:e.unmatchedIds,unmatched_count:e.unmatchedIds.length},xp=async e=>{let t=I(process.cwd(),e.path);await O(t);let n=await A(t);return{pmRoot:t,settings:n,statusRegistry:q(n.schema),runtimeFieldRegistry:pt(n.schema)}},Op=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 Rp({pmRoot:e.runtime.pmRoot,rollbackId:e.rollbackId,options:e.options,global:e.global})},$p=async e=>{Sp(e.options.status,e.runtime.statusRegistry);let t=await le(void 0,{...e.options.list,status:e.options.status,compact:void 0,brief:void 0,fields:void 0,includeBody:!0,full:!0},e.global),n=t.items.map(r=>{let i=kp(r,e.runtime.runtimeFieldRegistry,e.options.update);return e.dependencyWarnings.length===0?i:{...i,warnings:[...e.dependencyWarnings]}}),o=e.options.list?.ids==null?[]:(await le(void 0,{ids:e.options.list.ids,noTruncate:!0,full:!0},e.global)).items;return{listed:t,planned:n,actionable:n.filter(r=>r.changes.length>0),updateSummary:e.updateSummary,unmatchedIds:Tp(e.options.list?.ids,o)}},Pp=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:[],...Uo(e)}),Fp=e=>({...Fe({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:[],...Uo(e)}),Lp=async e=>{let t=[],n=[],o=e.options.update.message??`update-many apply ${e.checkpointId}`,r=new Set(e.plans.filter(i=>i.changes.length>0).map(i=>i.id));for(let i of e.items){if(!r.has(i.id)){t.push({id:i.id,status:"skipped"});continue}try{let s=Wn({...e.options.update,message:o,runtimeFieldCommands:["update_many"]}),a=await Ye(i.id,s,e.global);t.push({id:i.id,status:"updated",changed_fields:a.changed_fields,warnings:a.warnings}),n.push(i.id)}catch(s){t.push({id:i.id,status:"failed",error:ge(s)})}}return{rows:t,updatedIds:n}},Mp=async e=>{if(e.plan.actionable.length===0)return Fp(e.plan);let t=S(),n=Ft(jo,t),o=new Set(e.plan.actionable.map(p=>p.id)),r=e.plan.listed.items.filter(p=>o.has(p.id)).map(p=>({id:p.id,target_updated_at:p.updated_at})),i=e.options.checkpoint===!1?void 0:await Cp({pmRoot:e.runtime.pmRoot,checkpointId:n,nowValue:t,options:e.options,statusFilter:e.options.status,filters:e.plan.listed.filters,updateSummary:e.plan.updateSummary,checkpointItems:r}),s=await Lp({items:e.plan.listed.items,plans:e.plan.planned,options:e.options,global:e.global,checkpointId:n}),a=p=>s.rows.filter(f=>f.status===p).length,c=a("updated"),l=a("skipped"),d=a("failed");return{...Fe({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,...i?{checkpoint:i}:{},updated_count:c,skipped_count:l,failed_count:d,rows:s.rows,ids:s.updatedIds,...Uo(e.plan)}},_l=async(e,t)=>{let n=await xp(t),o=typeof e.rollback=="string"?e.rollback:void 0;o===void 0&&(e={...e,update:Wn(await ic(e.update))});let r=ul(e.update);if(Ip(e.list),o!==void 0)return Op({runtime:n,rollbackId:o,options:e,global:t,updateSummary:r});if(!ip(e.update)&&e.dryRun!==!0)throw new m(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${tp}), or pass --dry-run for a filter-only preview.`,u.USAGE);Ap(e.update,n.settings,n.statusRegistry,n.pmRoot),sc(e.update);let i=await ho({pmRoot:n.pmRoot,dependencies:yo(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:P(n.settings,T()).type_to_folder,allowUnresolved:e.update.allowUnresolvedDeps}),s=await $p({options:e,global:t,runtime:n,updateSummary:r,dependencyWarnings:i});return await ho({pmRoot:n.pmRoot,dependencies:yo(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:P(n.settings,T()).type_to_folder,allowUnresolved:e.update.allowUnresolvedDeps,holders:s.listed.items.map(a=>({id:a.id,createdAt:a.created_at})),schema:n.settings.schema}),e.dryRun===!0?Pp(s):Mp({runtime:n,options:e,global:t,plan: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]="374c7cb8-9fd0-5a2d-8aaf-9d09b63abaf0")}catch{}})();var Dp=["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"],hl=["brief","standard","deep"],bl="plan-step-",Bo="draft",Wo=["bug-investigation","feature-implementation","refactoring-sprint"],gl={"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 Np(e){let t=e.trim().toLowerCase(),n=Object.prototype.hasOwnProperty.call(gl,t)?gl[t]:void 0;if(!n)throw new m(`Unknown plan template "${e}". Allowed: ${Wo.join(", ")}`,u.USAGE,{code:"unknown_plan_template",examples:[`pm plan create --title "Fix login crash" --template ${Wo[0]}`]});return n.map(o=>({...o}))}function jp(e,t){return t>0?Math.round(e/t*100):0}function wl(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 Z(e){return Array.isArray(e)?e.flatMap(t=>eo(t,{unique:!1})):typeof e=="string"&&e.trim().length>0?eo(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 vl(e,t=Bo){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Pn.find(r=>r===n);if(!o)throw new m(`Invalid plan mode "${e}". Allowed: ${Pn.join(", ")}`,u.USAGE);return o}function Vo(e,t="pending"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Fn.find(r=>r===n);if(!o)throw new m(`Invalid step status "${e}". Allowed: ${Fn.join(", ")}`,u.USAGE);return o}function kl(e,t="related"){if(e===void 0)return t;let n=e.trim().toLowerCase(),o=Mn.find(r=>r===n);if(!o)throw new m(`Invalid step link kind "${e}". Allowed: ${Mn.join(", ")}`,u.USAGE);return o}function Up(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t.length===0)return;let n=Ln.find(o=>o===t);if(!n)throw new m(`Invalid plan harness "${e}". Allowed: ${Ln.join(", ")}`,u.USAGE);return n}function Gp(e){if(e===void 0)return"brief";let t=e.trim().toLowerCase(),n=hl.find(o=>o===t);if(!n)throw new m(`Invalid --depth "${e}". Allowed: ${hl.join(", ")}`,u.USAGE);return n}function qp(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 Go=new Set(["id","title","status","mode","scope","harness","parent","resume_context","steps_summary","current_step","blocked_steps","steps","decisions","discoveries","validation","linked_items"]);function zp(e,t){let n=e,o={},r=[];for(let i of t){let s=i.startsWith("plan.")?i.slice(5):i;if(s.length!==0){if(!Go.has(s)){r.push(i);continue}Object.prototype.hasOwnProperty.call(n,s)&&(o[s]=n[s])}}if(r.length>0)throw new m(`Unknown Plan --fields value(s): ${r.join(", ")}`,u.USAGE,{nextSteps:[`Use --fields ${[...Go].join(",")}`,"Run pm plan show <id> --depth brief for compact default fields."],recovery:{provided_fields:r,suggested_retry:`pm plan show <id> --fields ${[...Go].join(",")}`}});return o}function Ko(e,t){let n={};for(let o of e.split(",")){let r=o.trim();if(r.length===0)continue;let i=r.indexOf("=");if(i<=0)throw new m(`Invalid ${t} entry "${r}"; expected key=value`,u.USAGE,{code:"malformed_plan_step_evidence",required:`${t} entries must use comma-separated key=value fields.`,why:"Structured Plan evidence must be validated before it is persisted.",examples:['--file "path=src/index.ts,scope=project,note=implementation"','--test "command=pnpm test,note=regression"','--doc "path=docs/PLAN.md,scope=project"']});n[r.slice(0,i).trim().toLowerCase()]=r.slice(i+1).trim()}return n}function Yo(e){let t=Ko(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 Jo(e){let t=Ko(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 Xo(e){let t=Ko(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 Hp(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=jp(t.completed,t.total),t}function Wp(e){let t=new Set(e.map(n=>n.id));for(let n=e.length+1;n<e.length+1024;n+=1){let o=`${bl}${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 Ze(e,t){let n=t.trim();if(n.length===0)throw new m("Step reference cannot be empty",u.USAGE);let o=e.find(r=>r.id===n);if(o)return o;if(/^\d+$/.test(n)){let r=Number.parseInt(n,10),i=e.find(s=>s.order===r);if(i)return i}throw new m(`Step "${t}" not found in plan`,u.NOT_FOUND)}function yl(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 Bp(e,t){let n=t.filter(s=>s.trim().toLowerCase()==="all"),o=[],r=[];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 s of e.slice().sort((a,c)=>a.order-c.order)){let a=yl(s);if(a){r.push({from_step:s.id,...a});continue}o.push(s)}return{targets:o,skipped:r}}let i=new Set;for(let s of t){let a=Ze(e,s);if(i.has(a.id))continue;i.add(a.id);let c=yl(a);if(c){r.push({from_step:a.id,...c});continue}o.push(a)}return{targets:o,skipped:r}}function Vp(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 Kp(e){return e.find(t=>t.status==="in_progress")??e.find(t=>t.status==="pending")}function Yp(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((s,a)=>s.order-a.order),o=Hp(n),r=Kp(n),i={id:e.id,title:e.title,status:e.status,mode:e.plan_mode??Bo,scope:e.plan_scope,harness:e.plan_harness,parent:e.parent,resume_context:e.plan_resume_context,steps_summary:o,current_step:r?{id:r.id,order:r.order,title:r.title,status:r.status}:void 0,blocked_steps:Yp(n),linked_items:(e.dependencies??[]).map(s=>({id:s.id,kind:s.kind}))};return(t==="standard"||t==="deep")&&(i.steps=n),t==="deep"&&(i.decisions=e.plan_decisions??[],i.discoveries=e.plan_discoveries??[],i.validation=e.plan_validation??[]),i}function K(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&&!to(t.mode)&&t.status!=="closed"&&t.status!=="canceled"&&n.push(`pm close ${e} "plan complete"`),n}function Sl(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 Jp(e){let t=I(process.cwd(),e.path);await O(t);let n=await A(t);return{pmRoot:t,settings:n}}async function Il(e,t){let n=P(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 r=await ye(o,{schema:e.settings.schema});return Sl(r.document.metadata),{document:r.document,itemId:o.id}}function Xp(e){let t=[];e.parent&&t.push(`id=${e.parent.trim()},kind=parent`);for(let n of Z(e.related))t.push(`id=${n},kind=related`);for(let n of Z(e.blocks))t.push(`id=${n},kind=blocks`);for(let n of Z(e.blockedBy))t.push(`id=${n},kind=blocked_by`);return t.length>0?t:void 0}function Zp(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 Qp(e){return!!e.stepBody?.trim()||!!e.stepOwner?.trim()||!!e.stepStatus?.trim()||!!e.stepEvidence?.trim()||!!e.stepBlockedReason?.trim()||!!e.stepReplacement?.trim()||Z(e.dependsOn).length>0||Z(e.link).length>0}function eu(e){let t=e.stepTitle?.trim()||void 0,n=wl(e.step),o=e.template?.trim()?Np(e.template):[];return{repeatedStepTitles:n,stepTitleFlag:t,stepTitles:[...t?[t]:[],...n,...o.map(r=>r.title)],templateSteps:o}}function tu(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 ${Wo[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 nu(e,t){let n=Vo(e.stepStatus,"pending"),o=Zo(e,"depends_on"),r=H(e.file).map(Yo),i=H(e.test).map(Jo),s=H(e.doc).map(Xo),a=S();return{id:"plan-step-001",order:1,title:t,body:e.stepBody?.trim()||void 0,status:n,owner:e.stepOwner?.trim()||void 0,evidence:e.stepEvidence?.trim()||void 0,blocked_reason:n==="blocked"?e.stepBlockedReason?.trim()||"":void 0,linked_items:o.length>0?o:void 0,files:r.length>0?r:void 0,tests:i.length>0?i:void 0,docs:s.length>0?s:void 0,created_at:a,updated_at:a,completed_at:n==="completed"?a:void 0}}function ou(e){let t=eu(e),n=Qp(e);if(tu(t,n),t.stepTitles.length===0)return{steps:[],hasPerStepDetailOptions:n};if(t.stepTitles.length===1)return{steps:[nu(e,t.stepTitles[0])],hasPerStepDetailOptions:n};let o=S();return{steps:t.stepTitles.map((r,i)=>({id:`${bl}${String(i+1).padStart(3,"0")}`,order:i+1,title:r,body:t.templateSteps[i]?.body,status:"pending",created_at:o,updated_at:o})),hasPerStepDetailOptions:n}}function El(e,t,n=[]){mt(e,t),n.length>0&&_i(t,n)}async function ru(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 r=vl(e.mode,Bo),i=Up(e.harness),s=e.fromSearch?.trim(),a=Zp(e),{steps:c,hasPerStepDetailOptions:l}=ou(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:Xp(e),message:e.message??(s?`plan create (search: ${s})`:"plan create")};El(e,f);let g=await St(f,t),w=await gt({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=r,i&&(y.metadata.plan_harness=i,_.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:_}}}),v=V(w.item,"brief");return{action:"create",plan:v,step:c[0],next_actions:K(g.item.id,v),warnings:[...g.warnings],generated_at:S()}}async function iu(e,t,n){let o=Gp(t.depth),r=qp(t.fields),{document:i,itemId:s}=await Il(n,e),a=V(i.metadata,r===null?o:"deep");return{action:"show",plan:r===null?a:zp(a,r),next_actions:K(s,a),warnings:[],generated_at:S()}}function su(e,t){let n=new Map(Object.entries(t).filter(([o])=>o.startsWith("plan_")).map(([o,r])=>[o,JSON.stringify(r)]));return[...new Set([...e.keys(),...n.keys()])].filter(o=>e.get(o)!==n.get(o))}async function ne(e){let t=C(e.options.author,e.ctx.settings.author_default),n,o=await gt({pmRoot:e.ctx.pmRoot,settings:e.ctx.settings,id:e.id,op:e.op,author:t,message:e.options.message??e.message,force:e.options.force,mutate(r){Sl(r.metadata);let i=q(e.ctx.settings.schema);if(He(r.metadata.status,i)||to(r.metadata.plan_mode))throw new m(`Plan ${r.metadata.id} is terminal (status=${r.metadata.status}, plan_mode=${r.metadata.plan_mode??"unset"}) and cannot be mutated.`,u.CONFLICT,{code:"terminal_plan_mutation",required:"Create or reopen a non-terminal Plan before changing its execution context or steps.",why:"Terminal Plan history is immutable execution evidence."});let s=(r.metadata.plan_steps??[]).slice(),a=new Map(Object.entries(r.metadata).filter(([p])=>p.startsWith("plan_")).map(([p,f])=>[p,JSON.stringify(f)])),c=e.mutator(s,r);n=c.resultStep;let l=s.slice().sort((p,f)=>p.order-f.order).map((p,f)=>({...p,order:f+1}));r.metadata.plan_steps=l;let d=su(a,r.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 au(e,t,n){let o=t.stepTitle?.trim();if(!o)throw new m("pm plan add-step requires --step-title",u.USAGE);let r=Vo(t.stepStatus,"pending"),i=t.allowMultipleActive===!0,{document:s,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;Al(d,void 0,r,i);let f=cu(d,t,{order:p,title:o,status:r});return d.push(f),{changedSteps:[f.id],resultStep:f}}}),l=V(s.metadata,"standard");return{action:"add-step",plan:l,step:a,next_actions:K(c,l),warnings:[],generated_at:S()}}function Al(e,t,n,o){if(n!=="in_progress"||o)return;let r=e.find(i=>i.id!==t&&i.status==="in_progress");if(r)throw new m(`Plan already has step ${r.id} in_progress. Pass --allow-multiple-active or update that step first.`,u.CONFLICT)}function cu(e,t,n){let o=Zo(t,"depends_on"),r=H(t.file).map(Yo),i=H(t.test).map(Jo),s=H(t.doc).map(Xo),a=S();return{id:Wp(e),order:n.order,title:n.title,body:t.stepBody?.trim()||void 0,status:n.status,owner:t.stepOwner?.trim()||void 0,evidence:t.stepEvidence?.trim()||void 0,blocked_reason:n.status==="blocked"?t.stepBlockedReason?.trim()||"":void 0,linked_items:o.length>0?o:void 0,files:r.length>0?r:void 0,tests:i.length>0?i:void 0,docs:s.length>0?s:void 0,created_at:a,updated_at:a,completed_at:n.status==="completed"?a:void 0}}function Zo(e,t){let n=Z(e.dependsOn).map(d=>({id:d,kind:t})),o=Z(e.related).map(d=>({id:d,kind:"related"})),r=Z(e.blocks).map(d=>({id:d,kind:"blocks"})),i=Z(e.blockedBy).map(d=>({id:d,kind:"blocked_by"})),s=Z(e.link),a=kl(e.linkKind,t),c=e.linkNote?.trim(),l=s.map(d=>{let p={id:d,kind:a};return c&&(p.note=c),p});return[...n,...o,...r,...i,...l]}async function qo(e,t,n,o){let{document:r,resultStep:i,itemId:s}=await ne({id:e,options:t,ctx:n,op:o.op,message:t.message??`${o.op} ${o.stepRef}`,mutator(c,l){let d=Ze(c,o.stepRef),p=S(),f=o.finalStatus??Vo(t.stepStatus,d.status),g=t.allowMultipleActive===!0||o.allowMultipleActive===!0;return Al(c,d.status==="in_progress"?d.id:void 0,f,g),lu(d,t,f,p),l.metadata.updated_at=p,{changedSteps:[d.id],resultStep:d}}}),a=V(r.metadata,"standard");return{action:o.op==="plan_complete_step"?"complete-step":o.op==="plan_block_step"?"block-step":"update-step",plan:a,step:i,next_actions:K(s,a),warnings:[],generated_at:S()}}function lu(e,t,n,o){du(e,t,n),mu(e,t),e.status=n,e.updated_at=o,pu(e,n,o)}function du(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 mu(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(Yo),r=H(t.test).map(Jo),i=H(t.doc).map(Xo);o.length>0&&(e.files=zo(e.files,o)),r.length>0&&(e.tests=zo(e.tests,r)),i.length>0&&(e.docs=zo(e.docs,i))}function zo(e,t){let n=[...e??[]],o=new Set(n.map(r=>JSON.stringify(r)));for(let r of t){let i=JSON.stringify(r);o.has(i)||(o.add(i),n.push(r))}return n}function pu(e,t,n){if(t==="completed"&&!e.completed_at){e.completed_at=n;return}t!=="completed"&&(e.completed_at=void 0)}async function uu(e,t,n,o,r){let{document:i,itemId:s}=await ne({id:e,options:t,ctx:n,op:"plan_reorder_step",message:t.message??`plan reorder-step ${o} -> ${r}`,mutator(c){let l=Ze(c,o),d=c.filter(f=>f.id!==l.id),p=Math.max(1,Math.min(r,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(i.metadata,"standard");return{action:"reorder-step",plan:a,next_actions:K(s,a),warnings:[],generated_at:S()}}async function fu(e,t,n,o){let{document:r,itemId:i}=await ne({id:e,options:t,ctx:n,op:"plan_remove_step",message:t.message??`plan remove-step ${o}`,mutator(a){let c=Ze(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]}}}),s=V(r.metadata,"standard");return{action:"remove-step",plan:s,next_actions:K(i,s),warnings:[],generated_at:S()}}async function _u(e,t,n,o){let r=Zo(t,kl(t.linkKind,"related"));if(r.length===0)throw new m("pm plan link requires at least one --link/--related/--blocks/--blocked-by/--depends-on id",u.USAGE);let i=t.promoteToItemDep===!0,{document:s,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=Ze(d,o),g=f.linked_items??[],w=y=>`${y.kind}:${y.id}`,v=new Set(g.map(w));for(let y of r){let _=w(y);v.has(_)||(g.push(y),v.add(_))}if(f.linked_items=g,f.updated_at=S(),i){let y=p.metadata.dependencies??[],_=R=>`${R.kind}:${R.id}`,k=new Set(y.map(_));for(let R of r){let x=R.kind==="depends_on"?"blocked_by":R.kind,L={id:R.id,kind:x,created_at:S(),author:C(t.author,n.settings.author_default)};k.has(_(L))||(y.push(L),k.add(_(L)))}p.metadata.dependencies=y}return{changedSteps:[f.id],resultStep:f}}}),l=V(s.metadata,"standard");return{action:"link",plan:l,step:c,next_actions:K(a,l),warnings:[],generated_at:S()}}async function hu(e,t,n,o){let r=Z(t.link);if(r.length===0)throw new m("pm plan unlink requires --link <id> to remove",u.USAGE);let{document:i,itemId:s,resultStep:a}=await ne({id:e,options:t,ctx:n,op:"plan_unlink_step",message:t.message??`plan unlink ${o}`,mutator(l){let d=Ze(l,o),p=(d.linked_items??[]).filter(f=>!r.includes(f.id));return d.linked_items=p.length>0?p:void 0,d.updated_at=S(),{changedSteps:[d.id],resultStep:d}}}),c=V(i.metadata,"standard");return{action:"unlink",plan:c,step:a,next_actions:K(s,c),warnings:[],generated_at:S()}}async function Ho(e,t,n,o){let r=Vp(o,t);if(!r){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 i=C(t.author,n.settings.author_default),{document:s,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:i,decision:r,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:i,text:r}),d.metadata.plan_discoveries=g,{changedSteps:[]}}let f=d.metadata.plan_validation??[];return f.push({text:r,command:t.validationCommand?.trim()||void 0,expected:t.validationExpected?.trim()||void 0}),d.metadata.plan_validation=f,{changedSteps:[]}}}),c=V(s.metadata,"deep");return{action:o,plan:c,next_actions:K(a,c),warnings:[],generated_at:S()}}async function gu(e,t,n){let o=t.resumeContext?.trim();if(!o)throw new m("pm plan resume requires --resume-context <text>",u.USAGE);let{document:r,itemId:i}=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:[]}}}),s=V(r.metadata,"brief");return{action:"resume",plan:s,next_actions:K(i,s),warnings:[],generated_at:S()}}async function yu(e,t,n){let o=vl(t.mode??"approved","approved"),{document:r,itemId:i}=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:[]}}}),s=V(r.metadata,"brief");return{action:"approve",plan:s,next_actions:K(i,s),warnings:[],generated_at:S()}}function Rl(e){return e.map(t=>`plan_materialize_skipped:${t.from_step}:${t.reason}${t.existing_id?`:${t.existing_id}`:""}`)}function bu(e,t){let n=V(e.document.metadata,"standard");return{action:"materialize",plan:n,materialized:[],materialize_skipped:t,next_actions:K(e.itemId,n),warnings:Rl(t),generated_at:S()}}function wu(e,t,n){let o=[`id=${e},kind=parent`,`id=${t},kind=discovered_from`];for(let r of n.linked_items??[]){let i=r.kind==="blocked_by"||r.kind==="blocks"||r.kind==="related"||r.kind==="discovered_from"?r.kind:"related";o.push(`id=${r.id},kind=${i}`)}return o}async function vu(e){let t=[],n={},o=new Set(["title","description","type","parent","tags","author","message","dep"]);for(let r of H(e.options.field)){let i=r.indexOf("=");if(i<=0)throw new m(`Invalid --field entry "${r}"; expected name=value`,u.USAGE);let s=r.slice(0,i).trim(),a=r.slice(i+1).trim();if(s.length===0)throw new m(`Invalid --field entry "${r}"; expected name=value`,u.USAGE);let c=s.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 "${r}"; 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 "${r}"; "${p}" is reserved by materialize and cannot be overridden`,u.USAGE);n[p]=a}for(let r of e.targets){let i={...n,title:r.title,description:r.body?.trim()||r.title,type:e.resolvedTypeName,parent:e.parent,tags:e.tags,author:e.options.author,message:e.options.message??`materialized from plan ${e.planItemId} step ${r.id}`,dep:wu(e.parent,e.planItemId,r)};El(e.options,i,["description",...Object.keys(n)]);let s=await St(i,{path:e.pmRoot});t.push({id:s.item.id,title:s.item.title,type:e.resolvedTypeName,parent:s.item.parent,tags:s.item.tags??[],from_step:r.id})}return t}function ku(e,t,n){for(let o of t){let r=n.find(a=>a.from_step===o.id);if(!r)continue;let i=e.find(a=>a.id===o.id);if(!i)continue;let s=i.linked_items??[];s.push({id:r.id,kind:"implements",note:`materialized as ${r.type}`}),i.linked_items=s,i.updated_at=S()}}async function Su(e,t,n){let o=Z(t.steps);if(o.length===0)throw new m("pm plan materialize requires --steps <ids|orders|all>",u.USAGE);let r=t.materializeType?.trim()||"Task",i=P(n.settings,T()),s=Nt(r,i);if(!s)throw new m(`Invalid --materialize-type "${r}"`,u.USAGE);let a=t.materializeParent?.trim()||e,c=t.materializeTags,l=await Il(n,e),d=(l.document.metadata.plan_steps??[]).slice(),{targets:p,skipped:f}=Bp(d,o);if(p.length===0){if(f.length>0)return bu(l,f);throw new m("No matching plan steps found for --steps",u.NOT_FOUND)}let g=await vu({targets:p,parent:a,planItemId:l.itemId,resolvedTypeName:s,tags:c,options:t,pmRoot:n.pmRoot}),{document:w,itemId:v}=await ne({id:e,options:t,ctx:n,op:"plan_materialize",message:t.message??`plan materialize ${o.join(",")}`,mutator(_){return ku(_,p,g),{changedSteps:p.map(k=>k.id)}}}),y=V(w.metadata,"standard");return{action:"materialize",plan:y,materialized:g,...f.length>0?{materialize_skipped:f}:{},next_actions:K(v,y),warnings:Rl(f),generated_at:S()}}function Iu(e){if(e.subcommand==="create")return e;let t=wl(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:mt(e.options,{...e.options,stepTitle:t[0]})}:e}function pe(e,t){if(!e.id)throw new m(`pm plan ${t} requires a plan id`,u.USAGE);return e.id}function Me(e,t){let n=pe(e,t);if(!e.stepRef)throw new m(`pm plan ${t} requires <plan-id> <step>`,u.USAGE);return{id:n,stepRef:e.stepRef}}function Eu(e){let t=Me(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 Au={create:(e,t)=>ru(e.options,e.global,t),show:(e,t)=>iu(pe(e,"show"),e.options,t),"add-step":(e,t)=>au(pe(e,"add-step"),e.options,t),"update-step":(e,t)=>{let n=Me(e,"update-step");return qo(n.id,e.options,t,{stepRef:n.stepRef,op:"plan_update_step"})},"complete-step":(e,t)=>{let n=Me(e,"complete-step");return qo(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"completed",op:"plan_complete_step"})},"block-step":(e,t)=>{let n=Me(e,"block-step");return qo(n.id,e.options,t,{stepRef:n.stepRef,finalStatus:"blocked",op:"plan_block_step"})},"reorder-step":(e,t)=>{let n=Eu(e);return uu(n.id,e.options,t,n.stepRef,n.reorderTo)},"remove-step":(e,t)=>{let n=Me(e,"remove-step");return fu(n.id,e.options,t,n.stepRef)},link:(e,t)=>{let n=Me(e,"link");return _u(n.id,e.options,t,n.stepRef)},unlink:(e,t)=>{let n=Me(e,"unlink");return hu(n.id,e.options,t,n.stepRef)},decision:(e,t)=>Ho(pe(e,"decision"),e.options,t,"decision"),discovery:(e,t)=>Ho(pe(e,"discovery"),e.options,t,"discovery"),validation:(e,t)=>Ho(pe(e,"validation"),e.options,t,"validation"),resume:(e,t)=>gu(pe(e,"resume"),e.options,t),approve:(e,t)=>yu(pe(e,"approve"),e.options,t),materialize:(e,t)=>Su(pe(e,"materialize"),e.options,t)};function Ru(e){let t=Au[e];if(!t)throw ie({command_path:"plan",token:e,allowed:Dp});return t}async function Cl(e){let t=await Jp(e.global),n=Iu(e);return Ru(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 Cu(e,t){return[...new Set([...Hr.filter(o=>e[o]!==void 0),...Object.keys(e).filter(o=>e[o]!==void 0),...t.length>0?["body"]:[]])].sort((o,r)=>o.localeCompare(r))}function Tu(e,t){let n=`copied_from=${e}`;if(!t)return n;let o=t.trim();return o.length>0?`${o} | ${n}`:n}async function Qo(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await A(o),i=P(r,T()),s=await ae(o,e,r.id_prefix,r.item_format,i.type_to_folder);if(!s)throw await Kt(o,e,r.id_prefix,i.type_to_folder);let a=await ye(s,{schema:r.schema}),c=a.document.metadata,l=S(),d=C(t.author,r.author_default),p=await Yn(o,r.id_prefix,{tokenLength:r.ids.token_length,typeToFolder:i.type_to_folder,probeExisting:!1}),f=q(r.schema),g=t.title?.trim();if(g!==void 0&&g.length===0)throw new m("Copy --title must not be empty",u.USAGE);let w={...c,id:p,title:g??c.title,status:f.open_status,created_at:l,updated_at:l};delete w.closed_at,delete w.completed_at,delete w.close_reason,delete w.test_runs;let v=qe(T()),y=Bn({metadata:w,body:a.document.body},{schema:r.schema,extensionFieldNames:v}),_=await go({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[s.id]},{pmRoot:o,mode:r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0?"off":r.governance.duplicate_detection_mode,threshold:r.governance.duplicate_detection_threshold,limit:r.governance.duplicate_detection_limit,allowDuplicate:t.allowDuplicate}),k=Cu(y.metadata,y.body),R=Dn(o,y.metadata.type,p,r.item_format,i.type_to_folder),x=Ie(o,p),L=await Q(o,p,r.locks.ttl_seconds,d,!1,r.governance.force_required_for_stale_lock,r.locks.wait_ms),D={metadata:{},body:""},W,$;try{let ke=await Xi(o,d,{required:r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0});try{r.governance.duplicate_detection_mode==="strict"&&t.allowDuplicate!==!0&&await go({title:y.metadata.title,description:y.metadata.description,body:y.body,excludeIds:[s.id]},{pmRoot:o,mode:"strict",threshold:r.governance.duplicate_detection_threshold,limit:r.governance.duplicate_detection_limit,allowDuplicate:!1});let fe=await ae(o,p,r.id_prefix,r.item_format,i.type_to_folder);if(fe)throw new m(`Cannot copy to ${p}: an item with that id already exists at ${fe.itemPath}. Retry the copy to allocate a new id.`,u.CONFLICT,{code:"item_id_collision",why:`Allocated id ${p} already exists at ${fe.itemPath}.`,recovery:{suggested_retry:`pm copy ${s.id}`}});await te(R,ut(y,{format:r.item_format,schema:r.schema,extensionFieldNames:v}));try{let ee=ft({nowIso:l,author:d,op:"create",before:D,after:y,message:Tu(s.id,t.message)});await _t(x,ee)}catch(ee){throw await st(R),ee}$=await Zi({pmRoot:o,preferredFormat:r.item_format,typeToFolder:i.type_to_folder,schema:r.schema,itemPath:R,document:y})}finally{await ke()}W=[...await G({path:R,scope:"project",op:"create",item_id:y.metadata.id,item_type:y.metadata.type,before:D,after:y,changed_fields:k}),...await G({path:x,scope:"project",op:"create:history",item_id:y.metadata.id,item_type:y.metadata.type,before:D,after:y,changed_fields:k})],ii({id:y.metadata.id,op:"create",item_type:y.metadata.type,status:y.metadata.status,current:si(y.metadata,k),changed_fields:k})}finally{await L()}return{source_id:s.id,item:structuredClone(y.metadata),changed_fields:k,warnings:[...rc(_),...$,...W],..._===void 0?{}:{similarity_advisory:_}}}import yn 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 er(e,t,n){let o=I(process.cwd(),n.path);await O(o);let r=await A(o),i=C(t.author,r.author_default),s=await ts({pmRoot:o,settings:r,id:e,author:i,message:t.message,force:t.force,dryRun:t.dryRun}),a=s.targetPath?yn.relative(o,s.targetPath).split(yn.sep).join("/"):void 0;return{item:s.item,changed_fields:s.changedFields,dry_run:t.dryRun===!0,deleted:t.dryRun!==!0,outcome:t.dryRun===!0?"would_delete":"deleted",previous_status:s.item.status,...a?{target_path:a}:{},history_retained:yn.relative(o,Ie(o,s.item.id)).split(yn.sep).join("/"),tombstone_retention:"retain_append_only",warnings:s.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 xu(e){await O(e)}async function tr(e,t,n){let o=I(process.cwd(),n.path);if(await xu(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 A(o),f=Vn(C(void 0,p.author_default));return await Ci(o),await uo({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 Ai(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 Ou(o,p);return{action:"show",focused_item:p,title:f,message:`Focused on ${p}${f?` (${f})`:""}. New items default --parent to it.`}}let i=await A(o),s=P(i,T()),a=await ae(o,e,i.id_prefix,i.item_format,s.type_to_folder);if(!a)throw await Kt(o,e,i.id_prefix,s.type_to_folder);let c=Kn(a.id,i.id_prefix),l=await ye(a,{schema:i.schema}),d=Tl(l.document.metadata.title);return await Ri(o,c),await uo({pmRoot:o,settings:i,principal:Vn(C(void 0,i.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 Ou(e,t){let n=await A(e),o=P(n,T()),r=await ae(e,t,n.id_prefix,n.item_format,o.type_to_folder);if(!r)return null;let i=await ye(r,{schema:n.schema});return Tl(i.document.metadata.title)}function Tl(e){return e.trim().length>0?e:null}import{readFile as $u,writeFile as Pu}from"node:fs/promises";import Fu 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 xl=["item","history","relationship","json"];function Lu(e){let t=e.trim().toLowerCase();if(xl.includes(t))return t;throw new m(`Unknown merge artifact "${e}". Supported values: ${xl.join(", ")}.`,u.USAGE)}function Mu(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 nr(e,t){try{return await $u(e,"utf8")}catch{throw new m(`Cannot read merge ${t} file at ${e}.`,u.NOT_FOUND)}}async function Du(e){let t=I(process.cwd(),e.path);return await he(ct(t))?A(t):null}function Nu(e,t){return e.endsWith(".md")?"json_markdown":e.endsWith(".toon")?"toon":t?.item_format??"toon"}async function Ol(e,t){let n=Lu(e.artifact),o=Mu(e.prefer),r=Fu.resolve(e.outputPath??e.oursPath),[i,s,a]=await Promise.all([nr(e.basePath,"base"),nr(e.oursPath,"ours"),nr(e.theirsPath,"theirs")]),c,l,d=[],p={};if(n==="history"){let g=Ma(i,s,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=Da(i,s,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 Du(t),w=Nu(e.itemPath??r,g),v=qe(T()),y=Na(i,s,a,{format:w,schema:g?.schema,extensionFieldNames:v,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 _=Ht(c,{format:w,schema:g?.schema,extensionFieldNames:v}),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,La(x==="body"?_.body:k[x])])),decisions:y.conflict_decisions,operation:await Ua(process.cwd(),e.itemPath)}}}else{let g=ja(i,s,a,{preferred:o});c=g.merged,d.push(...g.conflict_paths),p.json={paths_from_theirs:g.paths_from_theirs}}if(await Pu(r,c,"utf8"),l!==void 0){let g=await qa(l);g!==null&&(p.receipt=$e(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:r,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 $l(e){if(e.cwd===null)return[];let t=[];for(let n of e.receipts){if(n.operation===void 0||!await Ga(e.cwd,n.item_path,n.operation))continue;let o={gitWorkspaceRoot:e.cwd,receipt:n};await be(n.item_id,{dryRun:!0,mergeAbandonmentProof:o},e.global),e.dryRun||(await be(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:[{...$e(n),reason:"original_git_state_restored",operation:n.operation}]}}},e.global),await rn(e.cwd,n,{requireExisting:!0,settlement:"original_git_state_restored"})),t.push(n.id)}return t}import{readFile as ju}from"node:fs/promises";import Uu 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 Gu=4;function Pl(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,r=t?.details.missing_merge_receipt_history_reference_details,i=t?.details.missing_merge_receipt_history_reference_details_truncated===!0,s=Array.isArray(r)?r.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:i,coordinates:s}}async function qu(e,t){let n=[];for(let o of t){let r;try{r=await ju(Uu.join(e,"history",`${o.item_id}.jsonl`),"utf8")}catch{continue}let i=r.split(/\r?\n/)[o.history_line-1];if(i===void 0||i.trim().length===0)continue;let s;try{s=JSON.parse(i)}catch{continue}let a=Va(s,o.item_id).find(c=>c.receiptId===o.receipt_id);a===void 0||!Ba(a)||a.eventTimestamp===void 0||Br(a.eventTimestamp,Wa)>=0||n.push({...o,original_event_ts:a.eventTimestamp})}return n}async function zu(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 be(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(r=>({receipt_id:r.receipt_id,original_history_line:r.history_line,original_event_ts:r.original_event_ts,reason:"legacy_clone_local_only"}))}}},e.global);return e.candidates.length}async function Hu(e){try{return{status:"fulfilled",value:await be(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 Wu(e){e.results.forEach((t,n)=>{let o=e.receiptOnlyIds[n];if(t.status==="fulfilled"){let r=t.value.changed?"repaired":"skipped_clean";e.repair.streams.push({id:o,outcome:r,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[r]+=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 Bu(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=>rn(e.gitWorkspaceRoot??process.cwd(),o,{requireExisting:!0}))),n.length}async function Fl(e,t){let n=e.dryRun===!0,o=I(process.cwd(),t.path),r=await wt(t,{checkOnly:!0,full:!0,skipVectors:!0,skipDrift:!0}),i=Pl(r),s=await qu(o,i.coordinates),a=await ma(o),c=await za(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 zu({candidates:s,options:e,global:t}),d=c.receipts,p=await $l({cwd:a,receipts:d,dryRun:n,author:e.author,message:e.message,global:t}),f=new Set(p),g=new Map;for(let N of d.filter(_e=>!f.has(_e.id))){let _e=g.get(N.item_id)??[];_e.push(N),g.set(N.item_id,_e)}let w=Object.fromEntries([...g].map(([N,_e])=>[N,{merge:{receipts:_e.map($e)}}])),v=Object.fromEntries([...g].map(([N,_e])=>[N,{gitWorkspaceRoot:a,receipts:_e}])),y=await sn({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:w,...d.length>0?{mergeReceiptProofById:v}:{}},t),_=new Set(y.streams.map(N=>N.id)),k=[...g.keys()].filter(N=>!_.has(N)),R=await Fa(k,Gu,N=>Hu({id:N,dryRun:n,options:e,global:t,auditContext:w[N],mergeReceiptProof:v[N]}));Wu({receiptOnlyIds:k,results:R,repair:y});let x=await Bu({dryRun:n,pendingReceipts:d,repair:y,gitWorkspaceRoot:a}),L=await an({checkHistoryDrift:!0,checkStorageIntegrity:!0},t),D=l===0?r:await wt(t,{checkOnly:!0,full:!0,skipVectors:!0,skipDrift:!0}),W=Pl(D),$=L.checks.every(N=>N.status==="ok"),ke=n?d.length===0:x+p.length===d.length,fe=[y.totals.failed===0,$,ke,W.count===0,!W.truncated].every(Boolean),ee=i.truncated||W.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,Xd=(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."]:fe?["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,...s.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(N=>N!==void 0);return{ok:fe,dry_run:n,repair:y,receipts:{pending_before:d.length,reconciled:x,abandoned:p.length,summaries:d.map($e),missing_history_references_before:i.count,legacy_disposition_eligible:s.length,legacy_disposition_recorded:l,missing_history_references_after:W.count},validation:L,guidance:Xd,generated_at:L.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 Ct(e){let t={...e.args,...e.options};return mt(e.options,t)}function ue(e,t){let n=h(e,t);if(n!==void 0)return n;throw new m(`Missing required parameter: ${t}`,u.USAGE)}function Qe(e){return typeof e=="string"?[e]:z(e)}function Ll(e){return gc(Ct(e),e.global)}function Ml(e){let t=Ct(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 yc({cwd:h(t,"cwd"),pmRoot:h(t,"path"),since:h(t,"since"),type:Qe(t.type),author:Qe(t.author),item:Qe(t.item),limit:t.limit===void 0?void 0:X(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:Qe(t.harness)},...t.agentInstance===void 0?{}:{agentInstance:Qe(t.agentInstance)},...t.provenanceFilter===void 0?{}:{provenanceFilter:Qe(t.provenanceFilter)}})}function Dl(e){let t=Ct(e),n=ue(t,"subcommand");if(n==="install")return pa({dryRun:t.dryRun===!0},e.global);if(n==="reconcile")return Fl({dryRun:t.dryRun===!0,author:h(t,"author"),message:h(t,"message"),force:t.force===!0},e.global);if(n==="report")return Ha({includeReconciled:t.includeReconciled===!0,cwd:h(t,"cwd")});if(n==="driver")return Ol({artifact:ue(t,"artifact"),basePath:ue(t,"basePath"),oursPath:ue(t,"oursPath"),theirsPath:ue(t,"theirsPath"),outputPath:h(t,"outputPath")??h(t,"output"),itemPath:h(t,"itemPath"),prefer:h(t,"prefer")},e.global);throw ie({command_path:"merge",token:n,allowed:["install","reconcile","report","driver"],display_name:"merge"})}function Nl(e){let t=Ct(e),n=ue(t,"subcommand");if(n==="position")return Cc(e.global);if(n!=="snapshot")throw ie({command_path:"workspace",token:n,allowed:["position","snapshot"],display_name:"workspace"});let o=h(t,"snapshotAction")??ue(t,"snapshot_action"),r=I(process.cwd(),e.global.path);if(o==="create")return kc(r,{name:h(t,"name")});if(o==="list")return Ic(r);let i=ue(t,"target");if(o==="inspect")return Sc(r,i);if(o==="delete")return Rc(r,i);if(o==="restore")return t.dryRun===!0?Ec(r,i):Ac(r,i,{force:t.force===!0,author:h(t,"author"),message:h(t,"message"),lockTtlSeconds:X(t.lockTtlSeconds,"lockTtlSeconds"),lockWaitMs:X(t.lockWaitMs,"lockWaitMs")});throw ie({command_path:"workspace snapshot",token:o,allowed:["create","list","inspect","restore","delete"],display_name:"workspace snapshot",token_kind:"action"})}function bn(e){let t=Ct(e),n=ue(t,"title");return e.action==="meet"?bc(n,t,e.global):e.action==="event"?wc(n,t,e.global):vc(n,t,e.global)}import _f 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 et=["agile","ops","research"],or={agile:{name:"agile",title:"Agile delivery",summary:"Story/Spike delivery with a review stage, story points, and acceptance ownership.",types:nn.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:nn.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:nn.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 Vu(e){if(e===void 0)return;let t=ve(e);if(t.length===0)throw new Error("Profile name must not be empty.");if(et.includes(t))return t;throw new Error(`Invalid profile "${e}". Allowed: ${et.join(", ")}.`)}function fw(e){let t=Vu(e);if(t===void 0)throw new Error(`Profile name is required. Allowed: ${et.join(", ")}.`);return or[t]}function _w(){return et.map(e=>or[e])}function ve(e){return e.trim().toLowerCase().replaceAll("-","_")}function jl(e){return e.map(t=>t.definition.name).join(", ")}function rr(e=[]){let t=et.map(i=>({definition:or[i],source:"builtin"})),n=new Set(et.map(i=>ve(i))),o=new Set(n),r=[];for(let i of e){let s=ve(i.profile.name);if(n.has(s)){r.push(`Extension "${i.name}" profile "${i.profile.name}" uses a name reserved by a built-in archetype and was ignored.`);continue}if(o.has(s)){r.push(`Profile "${i.profile.name}" from extension "${i.name}" duplicates an already-registered profile and was ignored.`);continue}o.add(s),t.push({definition:i.profile,source:"extension",package:i.name})}return{profiles:t,warnings:r}}function wn(e,t=[]){let{profiles:n,warnings:o}=rr(t);if(typeof e!="string"||e.trim().length===0)throw new Error(`Profile name is required. Allowed: ${jl(n)}.`);let r=ve(e),i=n.find(s=>ve(s.definition.name)===r);if(i===void 0)throw new Error(`Invalid profile "${e}". Allowed: ${jl(n)}.`);return{resolved:i,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 sr(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 Ul(e){return{name:e.name,title:e.title,summary:e.summary,composition:sr(e),types:e.types.map(t=>ir(()=>se(t).name,()=>String(t.name??""))),statuses:e.statuses.map(t=>ir(()=>xe(t).id,()=>String(t.id??""))),fields:e.fields.map(t=>ir(()=>Oe(t).key,()=>String(t.key??""))),workflows:e.workflows.map(t=>t.type),config:e.config.map(t=>`${t.key}=${t.value}`),templates:e.templates.map(t=>t.name),packages:e.packages.map(t=>({spec:t.spec,reason:t.reason}))}}function ir(e,t){try{return e()}catch{return t()}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="38902c61-3d4d-52ad-a95c-fbac9102a041")}catch{}})();var Ow=["profile","types","statuses","fields","workflows","config","templates","packages"],$w=["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"],Ku=new Set(vi.flatMap(e=>[ze(e.id),...(e.aliases??[]).map(t=>ze(t))]).filter(e=>e.length>0)),Gl=new Set(at.map(e=>e.toLowerCase()));function Yu(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!==ve(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 "${ve(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 Ju(e,t){let n=new Set,o=new Set;for(let[r,i]of e.types.entries()){let s;try{s=se(i).name}catch(c){t.push({severity:"error",code:"type_invalid",dimension:"types",target:typeof i.name=="string"?i.name:`#${r}`,message:ge(c)});continue}let a=s.toLowerCase();if(o.has(a)){t.push({severity:"error",code:"type_duplicate",dimension:"types",target:s,message:`Item type "${s}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}o.add(a),n.add(a)}return n}function Xu(e,t){let n=new Set,o=new Set;for(let[r,i]of e.statuses.entries()){let s;try{s=xe(i)}catch(a){t.push({severity:"error",code:"status_invalid",dimension:"statuses",target:typeof i.id=="string"?i.id:`#${r}`,message:ge(a)});continue}if(o.has(s.id)){t.push({severity:"error",code:"status_duplicate",dimension:"statuses",target:s.id,message:`Status "${s.id}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}o.add(s.id),n.add(s.id);for(let a of s.aliases??[])n.add(ze(a))}return n}function Zu(e,t){let n=new Set;for(let[o,r]of e.fields.entries()){let i;try{i=Oe(r).key}catch(a){t.push({severity:"error",code:"field_invalid",dimension:"fields",target:typeof r.key=="string"?r.key:`#${o}`,message:ge(a)});continue}if(n.has(i)){t.push({severity:"error",code:"field_duplicate",dimension:"fields",target:i,message:`Field "${i}" is declared more than once; the later definition silently overwrites the earlier upsert.`});continue}n.add(i);let s=Ks(i);s&&t.push({severity:"warning",code:"field_mcp_input_collision",dimension:"fields",target:i,message:`Field "${i}" collides with canonical MCP property "${s.property}" owned by ${s.owner}; callers must pass the custom value through ${s.nested_path}.`})}}function Qu(e,t,n,o){let r=new Set;for(let[i,s]of e.workflows.entries()){let a=s.type.trim().toLowerCase();if(a.length===0){o.push({severity:"error",code:"workflow_type_empty",dimension:"workflows",target:`#${i}`,message:"Workflow has an empty type; the workflow resolver drops entries without a type."});continue}let c=r.has(a);r.add(a),c?o.push({severity:"warning",code:"workflow_duplicate_type",dimension:"workflows",target:s.type,message:`Workflow type "${s.type}" is declared more than once; the later transition set wins.`}):!Gl.has(a)&&!t.has(a)&&o.push({severity:"warning",code:"workflow_type_unknown",dimension:"workflows",target:s.type,message:`Workflow governs type "${s.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 s.allowed_transitions){let p=ze(d[0]),f=ze(d[1]);if(p.length===0||f.length===0){o.push({severity:"error",code:"workflow_transition_malformed",dimension:"workflows",target:s.type,message:`Workflow "${s.type}" has a transition with an empty status; the workflow resolver silently drops it.`});continue}for(let g of[p,f])Ku.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 "${s.type}" references status "${g}" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`}))}}}function ef(e,t){let n=new Set;for(let o of e.config){let r=Je(o.key);if(r===void 0){t.push({severity:"error",code:"config_key_unknown",dimension:"config",target:o.key,message:`Config knob "${o.key}" is not a recognized setting; apply rejects it with a usage error.`});continue}n.has(r.key)?t.push({severity:"error",code:"config_duplicate",dimension:"config",target:r.key,message:`Config knob "${r.key}" is set more than once; the later value silently overwrites the earlier one.`}):n.add(r.key);let i=dn(r,o.value);i.ok||t.push({severity:"error",code:"config_value_invalid",dimension:"config",target:o.key,message:i.error.message})}}function tf(e,t,n){for(let o of e.templates){let r=o.options.type;if(typeof r!="string"||r.trim().length===0)continue;let i=r.trim().toLowerCase();!Gl.has(i)&&!t.has(i)&&n.push({severity:"warning",code:"template_type_unknown",dimension:"templates",target:o.name,message:`Template "${o.name}" creates type "${r}" which is neither a built-in type nor declared by this profile.`})}}function nf(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 ql(e){let t=[];Yu(e,t);let n=Ju(e,t),o=Xu(e,t);Zu(e,t),Qu(e,n,o,t),ef(e,t),tf(e,n,t),nf(e,t);let r=t.filter(s=>s.severity==="error").length,i=t.length-r;return{profile:e.name,ok:r===0,findings:t,errorCount:r,warningCount: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]="9b9004b5-2446-539c-9adc-75aeaa3acbba")}catch{}})();function ar(e,t,n,o,r){let i=e,s=[];for(let a of t){let c=o(i),l=r(i,a),d=o(l.file);i=l.file;let p=c===d?"unchanged":l.replaced?"update":"add";s.push({key:n(a),status:p})}return{file:i,changes:s,changed:s.some(a=>a.status!=="unchanged")}}function zl(e){return JSON.stringify(e.map(t=>t.join("\0")).sort())}function of(e,t){let n=e.map(r=>({...r})),o=[];for(let r of t){let i=n.findIndex(a=>a.type===r.type),s={type:r.type,allowed_transitions:r.allowed_transitions};i<0?(n.push(s),o.push({type:r.type,status:"add"})):zl(n[i].allowed_transitions)===zl(r.allowed_transitions)?o.push({type:r.type,status:"unchanged"}):(n[i]=s,o.push({type:r.type,status:"update"}))}return{changes:o,result:n,changed:o.some(r=>r.status!=="unchanged")}}function rf(e,t){let n=[];for(let o of e.config){let r=Je(o.key);if(r===void 0)throw new Error(`Profile "${e.name}" references unknown config key "${o.key}".`);let i=dn(r,o.value);if(!i.ok)throw new Error(`Profile "${e.name}" config ${o.key}: ${i.error.message}`);let s=pc(t,r),a=s===null?"add":s===i.parsed.value?"unchanged":"update";n.push({key:r.key,path:r.path,value:i.parsed.value,status:a})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function Hl(e){let t=Object.entries(e).sort(([n],[o])=>n.localeCompare(o));return JSON.stringify(t)}function sf(e,t){let n=[];for(let o of e.templates){let r=t.get(o.name),i;r===void 0?i="add":Hl(r)===Hl(o.options)?i="unchanged":i="update",n.push({name:o.name,options:o.options,status:i})}return{changes:n,changed:n.some(o=>o.status!=="unchanged")}}function Wl(e,t){let n=ar(zi(t.typesRaw),e.types,d=>se(d).name,Vt,(d,p)=>Hi(d,se(p))),o=ar(ua(t.statusesRaw),e.statuses,d=>xe(d).id,en,(d,p)=>fa(d,xe(p))),r=ar(_a(t.fieldsRaw),e.fields,d=>Oe(d).key,tn,(d,p)=>ha(d,Oe(p))),i=of(t.workflows,e.workflows),s=rf(e,t.settings),a=sf(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||r.changed||i.changed||s.changed||a.changed;return{profile:{name:e.name,title:e.title,summary:e.summary},types:n,statuses:o,fields:r,workflows:i,config:s,templates:a,packages:c,changed:l}}import Vl from"node:fs/promises";import Kl 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 af="templates",cr=".json",Yl=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/,cf=_s.map(e=>e.target).filter(e=>e!=="acceptanceCriteria"),lf=new Set(cf),Bl="1970-01-01T00:00:00.000Z",Jl={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
+`}},Xw={normalizeTemplateName:vn,extractTemplateOptions:Xl,parseStoredTemplateDocument:pr,builtinTemplateDocument:Zl,readStoredTemplateDocument:ed};function vn(e){let t=e.trim();if(!Yl.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 lr(e){return Kl.join(e,af)}function kn(e,t){return Kl.join(lr(e),`${t}${cr}`)}async function dr(e){await O(e)}function mr(e){return Object.fromEntries(Object.entries(e).sort(([t],[n])=>t.localeCompare(n)))}function Xl(e){let t={};for(let[n,o]of Object.entries(e))if(o!==void 0){if(lf.has(n)){if(typeof o=="string"){t[n]=[o];continue}if(!Array.isArray(o))continue;let r=o.filter(i=>typeof i=="string");r.length>0&&(t[n]=r);continue}if(typeof o=="string"){t[n]=o;continue}Array.isArray(o)&&o.every(r=>typeof r=="string")&&(t[n]=[...o])}return mr(t)}function df(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[r,i]of Object.entries(n)){let s=r.trim();if(s.length===0)throw new m(`Template "${t}" contains an empty option key.`,u.GENERIC_FAILURE);if(typeof i=="string"){o[s]=i;continue}if(Array.isArray(i)&&i.every(a=>typeof a=="string")){o[s]=[...i];continue}throw new m(`Template "${t}" contains invalid value for option "${s}".`,u.GENERIC_FAILURE)}return mr(o)}function pr(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,r=df(o.options,t),i=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:i,updated_at:typeof o.updated_at=="string"?o.updated_at:i,options:r}}function Zl(e){let t=Jl[e];return t?{name:e,created_at:Bl,updated_at:Bl,options:mr({...t})}:null}async function Ql(e,t){let n=await re(kn(e,t));if(n!==null)return{document:pr(n,t),source:"user"};let o=Zl(t);if(o)return{document:o,source:"builtin"};throw new m(`Template "${t}" not found`,u.NOT_FOUND)}async function ed(e,t){let n=await re(kn(e,t));if(n===null)throw new m(`Template "${t}" not found`,u.NOT_FOUND);return pr(n,t)}async function mf(e,t){let n=vn(t),{document:o}=await Ql(e,n);return o.options}async function ur(e,t,n){let o=I(process.cwd(),n.path);await dr(o);let r=vn(e),i=Xl(t);if(Object.keys(i).length===0)throw new m("templates save requires at least one create option flag",u.USAGE);let s=S(),a=kn(o,r),c=s;await he(a)&&(c=(await ed(o,r)).created_at);let l={name:r,created_at:c,updated_at:s,options:i},d=await A(o);return await Vl.mkdir(lr(o),{recursive:!0}),await Be({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 pf(e){let t=lr(e);return await he(t)?(await Vl.readdir(t)).filter(o=>o.toLowerCase().endsWith(cr)).map(o=>o.slice(0,-cr.length)).filter(o=>Yl.test(o)):[]}async function uf(e){let t=I(process.cwd(),e.path);await dr(t);let n=await pf(t),o=new Set(n),r=Object.keys(Jl).filter(c=>!o.has(c)),i=[...n].sort((c,l)=>c.localeCompare(l)),s=[...r].sort((c,l)=>c.localeCompare(l)),a=[...new Set([...i,...s])].sort((c,l)=>c.localeCompare(l));return{templates:a,count:a.length,builtin_templates:s,user_templates:i}}async function ff(e,t){let n=I(process.cwd(),t.path);await dr(n);let o=vn(e),{document:r,source:i}=await Ql(n,o);return{name:r.name,source:i,created_at:r.created_at,updated_at:r.updated_at,path:i==="builtin"?`builtin:${o}`:kn(n,o),options:r.options}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="5529deea-21db-509b-9562-d5e08dfc004a")}catch{}})();var rd=["list","show","apply","lint"],hf="schema-types",gf="schema-statuses",yf="schema-fields";function Sn(){let e=T();return e===null?[]:e.profiles.map(t=>({name:t.name,profile:t.profile}))}function id(){let{profiles:e,warnings:t}=rr(Sn());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:sr(n.definition)})),warnings:t,generated_at:S()}}function sd(e){let t;try{t=wn(e,Sn())}catch(o){throw new m(o instanceof Error?o.message:String(o),u.USAGE)}let{resolved:n}=t;return{action:"show",...Ul(n.definition),source:n.source,...n.package!==void 0?{package:n.package}:{},warnings:t.warnings,generated_at:S()}}function ad(e){let t;try{t=wn(e,Sn())}catch(r){throw new m(r instanceof Error?r.message:String(r),u.USAGE)}let{resolved:n}=t,o=ql(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 bf(e,t){return _f.join(e,"templates",`${t}.json`)}async function wf(e,t){let n=await re(bf(e,t));if(n!==null)try{let o=JSON.parse(n);if(o!==null&&typeof o=="object"&&!Array.isArray(o)){let r=o.options;if(r!==null&&typeof r=="object"&&!Array.isArray(r))return r}}catch{}}async function td(e,t,n,o){let r=new Map;for(let i of o.templates){let s=await wf(e,i.name);s!==void 0&&r.set(i.name,s)}return{typesRaw:await re(Ae(e,t.files.types,Ee.types)),statusesRaw:await re(Ae(e,t.files.statuses,Ee.statuses)),fieldsRaw:await re(Ae(e,t.files.fields,Ee.fields)),workflows:n.schema.type_workflows??[],settings:n,templates:r,installedPackages:new Set}}function tt(e){let t=[],n=[],o=[];for(let r of e)(r.status==="add"?t:r.status==="update"?n:o).push(r.key);return{added:t,updated:n,unchanged:o}}function nd(e,t,n,o,r){return{action:"apply",name:e.name,title:e.title,applied:n,dry_run:o,changed:t.changed,types:tt(t.types.changes),statuses:tt(t.statuses.changes),fields:tt(t.fields.changes),workflows:tt(t.workflows.changes.map(i=>({key:i.type,status:i.status}))),config:tt(t.config.changes),templates:tt(t.templates.changes.map(i=>({key:i.name,status:i.status}))),packages:t.packages,warnings:[...new Set(r)].sort((i,s)=>i.localeCompare(s)),generated_at:S()}}async function vf(e){await O(e)}function kf(e){try{let t=wn(e,Sn());return{profile:t.resolved.definition,warnings:t.warnings}}catch(t){throw new m(t instanceof Error?t.message:String(t),u.USAGE)}}async function cd(e,t,n){let o=I(process.cwd(),n.path);await vf(o);let r=kf(e),i=r.profile,s=r.warnings,a=t.dryRun===!0,c=await A(o),l=ki(c.schema);if(a){let _=await td(o,l,c,i),k=od(i,_);return nd(i,k,!1,!0,[...s])}let d=C(t.author,c.author_default),p=Bi(c),f=!!t.force,g=[...s],w=[],v=async _=>{w.push(await Q(o,_,c.locks.ttl_seconds,d,f,p.force_required_for_stale_lock,c.locks.wait_ms))},y;try{await v(hf),await v(gf),await v(yf);let _=await td(o,l,c,i);if(y=od(i,_),y.types.changed){let k=Ae(o,l.files.types,Ee.types);await Be({pmRoot:o,filePath:k,raw:Vt(y.types.file),op:"profile:apply-types",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms});let R=new Set(i.types.map(L=>se(L).name)),x=y.types.file.definitions.filter(L=>R.has(L.name));await ka(o,x,g,"profile:apply-type-folder"),g.push(...await G({path:k,scope:"project",op:"profile:apply-types"}))}if(y.statuses.changed){let k=Ae(o,l.files.statuses,Ee.statuses);await Be({pmRoot:o,filePath:k,raw:en(y.statuses.file),op:"profile:apply-statuses",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),g.push(...await G({path:k,scope:"project",op:"profile:apply-statuses"}))}if(y.fields.changed){let k=Ae(o,l.files.fields,Ee.fields);await Be({pmRoot:o,filePath:k,raw:tn(y.fields.file),op:"profile:apply-fields",author:d,lockTtlSeconds:c.locks.ttl_seconds,lockWaitMs:c.locks.wait_ms}),g.push(...await G({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=Je(k.key);R!==void 0&&uc(c,R,k.value)}c.schema.type_workflows=y.workflows.result,await Vi(o,c,"profile:apply-config")}for(let k of y.templates.changes)k.status!=="unchanged"&&await ur(k.name,{...k.options},n)}finally{for(let _ of w.reverse())try{await _()}catch{}}return nd(i,y,y.changed,!1,g)}function od(e,t){try{return Wl(e,t)}catch(n){throw new m(n instanceof Error?n.message:String(n),u.USAGE)}}function Sf(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 kv(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 Sv(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 Iv(e){let t=e.source==="extension"?` [${e.package??"extension"}]`:"",n=e.warning_count+e.warnings.length,r=[e.ok?`Profile ${e.name}${t}: ok (${n} warning${n===1?"":"s"})`:`Profile ${e.name}${t}: ${e.error_count} error${e.error_count===1?"":"s"}, ${n} warning${n===1?"":"s"}`];for(let i of e.findings){let s=i.target!==void 0?` (${i.target})`:"";r.push(`  ${i.severity} [${i.code}] ${i.dimension}${s}: ${i.message}`)}for(let i of e.warnings)r.push(`  warning: ${i}`);return r.join(`
+`)}function Ev(e){let t=e.dry_run?"dry-run":e.applied?"applied":"no changes",n=[`Profile ${e.name} (${t})`];if(!e.changed)n.push("  already up to date");else for(let[r,i]of[["types",e.types],["statuses",e.statuses],["fields",e.fields],["workflows",e.workflows],["config",e.config],["templates",e.templates]]){let s=Sf(r,i);s!==void 0&&n.push(s)}let o=e.packages.filter(r=>r.status==="recommended");o.length>0&&n.push(`  recommended packages: ${o.map(r=>r.spec).join(", ")}`);for(let r of e.warnings)n.push(`  warning: ${r}`);return n.join(`
+`)}(function(){try{var e=typeof window<"u"?window:typeof 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 ld(e){let t=e.options.all===!0,n=e.id??h(e.options,"id");return Ka(n,t),t?sn(e.options,e.global):be(n,e.options,e.global)}function dd(e){let t=e.options.ids,n=wi(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:bi(n),r=X(e.options.allOver??e.options.all_over,"history-compact allOver"),i=X(e.options.minEntries??e.options.min_entries,"history-compact minEntries"),s=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"),(s==="closed"||s==="all-streams")&&a.push(s);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 Oc(e.id,{ids:o,allOver:r,scope:l}),e.id!==void 0?xc(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):$c({ids:o,scope:l,allOver:r,minEntries:i,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 fr(e,t,n,o){let r=t.trim();if(r.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 i=I(process.cwd(),o.path),s=q((await A(i)).schema),a=s.open_status,c=cc(s),l=n.status??a,d=Re(l,s)??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} "${r}" --status ${a}`,suggested_retry_args:["item","reopen",e,r,"--status",a]}});let p=await ac(e,{status:d,unset:["close-reason","resolution","expected-result","actual-result","fixed-version"],author:n.author,message:n.message,force:n.force},o,r);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]="343f871b-e160-5841-87db-cb6c5902c713")}catch{}})();async function md(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),r=e.force===!0||o.force===!0,i={...e.args,...o};if(i.start===!0)return It(Tt(e,o),ce(o,{force:r}),e.global);let s=e.args.next===!0||o.next===!0?await nc(r,e.global,i,i):await tc(Tt(e,o),r,e.global,i);return J(s,{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function Tt(e,t){let n=e.id??h(t,"id");if(!n)throw new m("Missing required argument: id",64);return n}function _r(e,t){return h(e.args,"reason")??h(e.args,"text")??h(t,"reason")??h(t,"text")}async function pd(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return o.releaseAssignment===!0?Et(Tt(e,o),_r(e,o),ce(o,{force:e.force===!0||o.force===!0}),e.global):J(await kt(Tt(e,o),_r(e,o),{...o,force:e.force===!0||o.force===!0},e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function ud(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return J(await fr(Tt(e,o),_r(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 fd(e,t,n){let o;if(typeof e.lines=="string")o=co(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=co(`${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 _d(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 If=new Set(["true","1","yes","on"]),Ef=new Set(["false","0","no","off"]);function Af(e,t,n=[]){let o=[t,...n];for(let r of o){let i=e[r];if(typeof i=="string"&&i.trim().length>0)return i.trim()}}function Rf(e,t,n=[]){let o=[t,...n];for(let r of o){let i=e[r];if(i!==void 0){if(typeof i=="boolean")return i;if(typeof i=="string"){let s=i.trim().toLowerCase();if(If.has(s))return!0;if(Ef.has(s))return!1}}}}function Cf(e,t,n=[]){for(let o of[t,...n]){let r=e[o],s=(typeof r=="string"?r.split(","):Array.isArray(r)?r.flatMap(a=>typeof a=="string"?a.split(","):[]):[]).map(a=>a.trim()).filter(a=>a.length>0);if(s.length>0)return s}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]="aba4af26-98d3-53aa-8b23-1be7c90a38d1")}catch{}})();function U(e){if(typeof e!="string")return;let t=e.trim();return t.length>0?t:void 0}function Tf(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 xf(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 Of(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"?dt(e):[]}function $f(e){let t=U(e);if(t){let n=Re(t);if(n)return n}return"open"}function gr(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 hd(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 nt(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 hr(e){return bd(e,U)}function gd(e){return bd(e,vd)}function Pf(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(i=>i===o))return o;let r=Number(o);return Number.isInteger(r)&&r>=0&&r<=100?r:void 0}function yd(e,t){let n=U(e)?.toLowerCase();if(!n)return;let o=n==="med"?"medium":n;return t.includes(o)?o:void 0}function yr(e){return U(e)?.toLowerCase()==="global"?"global":"project"}function Ff(e,t){let n=br(e,t.allowScalar===!0);if(!n)return;let o=n.map(r=>jf(r,t)).filter(r=>r!==void 0);return o.length>0?o:void 0}function Lf(e,t={}){return wd(e,t,(n,o)=>({path:n,scope:yr(o?.scope),note:U(o?.note)}))}function Mf(e,t={}){return wd(e,t,(n,o)=>({path:n,scope:yr(o?.scope),note:U(o?.note)}))}function Df(e,t={}){let n=br(e,t.allowScalar===!0);if(!n)return;let o=n.map(r=>qf(r,t)).filter(r=>r!==void 0);return o.length>0?o:void 0}function Nf(e,t){return C(e,t)}function En(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function br(e,t){return Array.isArray(e)?e:t?[e]:void 0}function In(e,t){for(let n of t){let o=U(e[n]);if(o)return o}}function bd(e,t){if(!En(e))return;let n=Object.entries(e).map(([o,r])=>[o.trim(),t(r)]).filter(o=>o[0].length>0&&o[1]!==void 0);return n.length>0?Object.fromEntries(n):void 0}function jf(e,t){if(typeof e=="string")return Uf(e,t);if(!En(e))return;let n=In(e,t.textKeys??["text"]);if(!n)return;let o=t.createdAtKey??"created_at",r=t.authorKey??"author";return{created_at:(t.toIsoString?t.toIsoString(e[o]):U(e[o]))??t.fallbackCreatedAt,author:U(e[r])??t.fallbackAuthor,text:n}}function Uf(e,t){let n=U(e);return n?{created_at:t.fallbackCreatedAt,author:t.fallbackAuthor,text:n}:void 0}function wd(e,t,n){let o=br(e,t.allowScalar===!0);if(!o)return;let r=t.pathKeys??["path"],i=o.map(s=>Gf(s,r,n)).filter(s=>s!==void 0);return i.length>0?i:void 0}function Gf(e,t,n){if(typeof e=="string"){let r=U(e);return r?n(r):void 0}if(!En(e))return;let o=In(e,t);return o?n(o,e):void 0}function qf(e,t){if(typeof e=="string"){let r=U(e);return r?{command:r,scope:"project"}:void 0}if(!En(e))return;let n=In(e,t.commandKeys??["command"]),o=In(e,t.pathKeys??["path"]);if(!(!n&&(t.requireCommand===!0||!o)))return{...n?{command:n}:{},...o?{path:o}:{},scope:yr(e.scope),timeout_seconds:zf(e.timeout_seconds,t),note:U(e.note),...t.includeExtendedAssertions===!0?Hf(e):{}}}function zf(e,t){let n=t.integerTimeout===!0?gr(e):vd(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 vd(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 Hf(e){return{pm_context_mode:yd(e.pm_context_mode,["schema","tracker","auto"]),env_set:hr(e.env_set),env_clear:nt(e.env_clear),shared_host_safe:hd(e.shared_host_safe),assert_stdout_contains:nt(e.assert_stdout_contains),assert_stdout_regex:nt(e.assert_stdout_regex),assert_stderr_contains:nt(e.assert_stderr_contains),assert_stderr_regex:nt(e.assert_stderr_regex),assert_stdout_min_lines:gr(e.assert_stdout_min_lines),assert_json_field_equals:hr(e.assert_json_field_equals),assert_json_field_gte:gd(e.assert_json_field_gte)}}async function Wf(e){await O(e)}function kd(){return{metadata:{},body:""}}async function Bf(e){let{pmRoot:t,id:n,itemPath:o,document:r,author:i,message:s,settings:a,conflictWarningPrefix:c}=e,l=Ie(t,n),d=kd();try{let p=await Q(t,n,a.locks.ttl_seconds,i,!1,a.governance.force_required_for_stale_lock,a.locks.wait_ms);try{let f=await Ji({pmRoot:t,settings:a,operation:"import",author:i,before:null,after:r});await te(o,ut(r,{format:"toon"}));try{let g=ft({nowIso:S(),author:i,op:"import",before:d,after:r,message:s,context:f.decisions.length===0?void 0:{workflow_policies:f.decisions}});return await _t(l,g),{committed:!0,writeWarnings:[...f.warnings,...await G({path:o,scope:"project",op:"import",item_id:r.metadata.id,item_type:r.metadata.type,before:d,after:r,changed_fields:["imported"]}),...await G({path:l,scope:"project",op:"import:history",item_id:r.metadata.id,item_type:r.metadata.type,before:d,after:r,changed_fields:["imported"]})]}}catch(g){throw await st(o),g}}finally{await p()}}catch(p){if(p instanceof m&&p.exitCode===u.CONFLICT&&!p.code?.startsWith("workflow_policy_"))return{committed:!1,conflictWarning:`${c}:${n}`};throw p}}import{readFile as Kf}from"node:fs/promises";import Yf 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 Vf(e){return e.trim().toLowerCase().replaceAll("_","-")}var vr=[{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:Lc().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"]}],wr=new Map;for(let e of vr){wr.set(e.id,e);for(let t of e.aliases)wr.set(t,e)}function Sd(){return vr.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 An(){return vr.map(e=>e.id)}function Id(e){if(!e)return null;let t=Vf(e);return t?wr.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 Jf=["markdown","toon","json"],Xf=["brief","standard","deep"];function Zf(e){if(!e)return;let t=e.trim().toLowerCase();if(!Jf.includes(t))throw new m("Guide format must be one of markdown|toon|json",u.USAGE);return t}function Qf(e,t){let n=Zf(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 e_(e){if(!e)return"brief";let t=e.trim().toLowerCase();if(!Xf.includes(t))throw new m("Guide depth must be one of brief|standard|deep",u.USAGE);return t}function t_(){return Kr(process.env,"PM_CLI_PACKAGE_ROOT",import.meta.url,["..","..",".."])}function Ed(e){return e.replaceAll(`\r
+`,`
+`)}function n_(e,t,n){let r=Ed(e).split(`
+`),s=r.slice(0,t).join(`
+`),a=r.length>t;return s.length>n&&(s=s.slice(0,n),a=!0),{excerpt:s.trimEnd(),truncated:a,lineCount:r.length}}async function o_(e,t,n){let o=t!=="brief",r=o?t==="deep"?"full":"excerpt":"none",i=[];for(let s of e.docs){let a=Yf.resolve(n,s.path);if(!o){i.push({path:s.path,purpose:s.purpose,optional:s.optional===!0,exists:!0,line_count:null,content_mode:"none",content:null,truncated:!1});continue}try{let c=await Kf(a,"utf8");if(t==="deep"){let l=Ed(c).trimEnd();i.push({path:s.path,purpose:s.purpose,optional:s.optional===!0,exists:!0,line_count:l.length===0?0:l.split(`
+`).length,content_mode:"full",content:l,truncated:!1})}else{let l=n_(c,120,12e3);i.push({path:s.path,purpose:s.purpose,optional:s.optional===!0,exists:!0,line_count:l.lineCount,content_mode:r,content:l.excerpt,truncated:l.truncated})}}catch(c){let l=Ue(c);if(i.push({path:s.path,purpose:s.purpose,optional:s.optional===!0,exists:!1,line_count:null,content_mode:"none",content:null,truncated:!1}),!l)throw new m(`Failed to read guide document "${s.path}".`,u.GENERIC_FAILURE)}}return i}function r_(e){let t=Sd().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 i_(e){let t=Id(e);if(t)return t;let n=An().join(", ");throw new m(`Unknown guide topic "${e}". Available topics: ${n}. Use "pm guide --list" to browse.`,u.USAGE)}async function s_(e,t){let n=e_(typeof e.depth=="string"?e.depth:void 0),o=e.list===!0,r=typeof e.topic=="string"?e.topic:void 0;if(o||!r)return r_(n);let i=i_(r),s=t_(),a=await o_(i,n,s),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:r,topic:i,docs:a,warnings:c}}function a_(e){return e.replaceAll("```","``\\`")}function c_(e){if(e.mode==="index"){let n=["# pm guide","","Token-efficient local documentation index for agent and maintainer workflows.","","## Topics"];for(let o of e.topics)n.push(`- \`${o.id}\` - ${o.summary}`),e.depth!=="brief"&&(n.push(`  - intent: ${o.intent}`),n.push(`  - docs: ${o.docs.map(r=>`\`${r.path}\``).join(", ")}`));n.push("","## Next steps");for(let o of e.suggested_next_steps)n.push(`- \`${o}\``);return n.join(`
+`)}let t=[`# pm guide ${e.topic.id}`,"",e.topic.summary,"","## Intent",e.topic.intent,"","## Key commands",...e.topic.commands.map(n=>`- \`${n}\``),"","## Workflow prompts"];for(let n of e.topic.workflows)t.push(`### ${n.name}`),t.push(`goal: ${n.goal}`),t.push(`prompt: ${n.prompt}`),t.push("commands:"),t.push(...n.commands.map(o=>`- \`${o}\``)),t.push("");t.push("## Documents");for(let n of e.docs){let o=n.exists?"available":n.optional?"missing (optional)":"missing (required)";t.push(`- \`${n.path}\` - ${n.purpose} (${o})`),n.exists&&n.content_mode!=="none"&&n.content&&(t.push(""),t.push(`### Excerpt: \`${n.path}\``),n.truncated&&t.push("_truncated for context efficiency_"),t.push("```markdown"),t.push(a_(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]="961951cf-e644-50ae-becc-205bea47225d")}catch{}})();var Ad=["bash","zsh","fish"],l_=[...at],d_=[...$n],Ir=new Set(Nr.filter(e=>e.hidden).map(e=>e.alias)),kr=Fc("full").filter(e=>!e.includes(" ")&&!Ir.has(e)),m_=E(Jt),p_=E(ys),u_=E(Rs),f_=E(Fs),Fd=Pc("restore",Ce("restore")),__=E(Ls),h_=E(Cs),g_=E(Ts),y_=E(Ps),b_=E(Gs),w_=E(Ms),v_=E(Ds),k_=E(As),$t=[...new Set(Se.map(e=>e.canonical_argv[0]))],je=Object.fromEntries($t.map(e=>[e,Se.filter(t=>t.canonical_argv[0]===e).map(t=>t.canonical_argv[1]).join(" ")])),S_=je.history,I_=Dr.map(e=>({...e,flags:E(Ce(e.alias))})),Rd=E(bs),E_=E(ws,!1),A_=E(js),R_=E(Ns),C_=E(Us),T_=E(Ws),x_=E(zs),O_=E(Os),$_=E(Hs),P_=E(qs),F_=E(Xt),L_=E(xs),M_=E($s),D_=E(ks),N_=E(Bs),j_=E(vs),Er=`${Bt.join(" ")} 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`,U_="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize",G_=E(Vs),q_=`${G_} bash zsh fish`,Ar=ot(An()),Rn="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate",Rr=`${Rn} upgrade`,z_=E(Ss),H_=E(Is),W_=E(Es),B_="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",V_="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help",K_=E(Ce("close")),Y_=E(Ce("close-task")),J_=E(Ce("release")),X_=E(Ce("claim")),Ld=[["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"]],Z_=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"]]),Sr=gs.flatMap(e=>[e.short,e.flag,...e.aliases??[]]).filter(e=>!!e).join(" "),Cr=[...Wt].join("|"),Tr=[...Wt].map(e=>`${e}=*`).join("|"),xr=[...Sr.split(" ").filter(e=>!Wt.has(e)),"-h","-V"].join("|");function ot(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n)).join(" ")}function Q_(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].join(" ")}function Md(e){return e.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function Or(e,t){return Q_(e.length>0?e:t.item_types??l_)}function $r(e){return ot(e.statuses??d_)}function De(e,t){let n=[...e.split(/\s+/u).filter(o=>o.length>0),...t??[]];return ot(n)}function Dd(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 xt(e){let t=Dd(e);return t.length===0?"":`${t.map(n=>`            '${n}[Runtime schema field flag]:value' \\`).join(`
+`)}
+`}function Ot(e,t={}){let n=t.trailingContinuation??!0,o=e.length-1;return e.map((r,i)=>`            ${r}${n||i!==o?" \\":""}`).join(`
+`)}function eh(){return[...Ld,["ops","Workspace maintenance and diagnostics"]].filter(([e])=>!Ir.has(e)).map(([e,t])=>`    '${e}:${t}'`).join(`
+`)}function th(){return[...Ld,["ops","Workspace maintenance and diagnostics"]].filter(([e])=>e!=="help"&&!Ir.has(e)).map(([e,t])=>{let n=Z_.get(e)??t;return`complete -c pm -n __pm_no_subcommand -a ${e.padEnd(16)} -d '${n}'`}).join(`
+`)}function Cd(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 Ot([...[...t,...n].map(r=>`'--${e.missingPrefix}${r}'`),...o.flatMap(([r,i])=>[`'--${e.pairedPrefix}${r}'`,`'--${e.pairedPrefix}${i}'`])])}var nh=["'--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 Td(e){return Ot([...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 xd(e,t,n,o){return Ot([`'--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 Ne(e,t){let n=Dd(t).map(r=>r.slice(2));if(e.length===0||n.length===0)return"";let o=[];for(let r of e){let i=$t.includes(r)||Se.some(s=>s.alias===r)?"__pm_history_operation":"__fish_seen_subcommand_from";for(let s of n)o.push(`complete -c pm -n '${i} ${r}' -l ${s} -d 'Runtime schema field flag' -r`)}return`${o.join(`
+`)}
+`}function Od(e,t,n){let o=e.toUpperCase(),r=`PM_COMPLETION_${o}_CACHE`,i=`PM_COMPLETION_${o}_CACHE_TS`,s=`PM_COMPLETION_${o}_TTL`,a=Md(n);return[`_pm_completion_${e}_choices() {`,"  local now ttl cache_ts resolved",'  now="$(date +%s 2>/dev/null || echo 0)"',`  ttl="\${${s}:-120}"`,`  cache_ts="\${${i}:-0}"`,`  if [[ -n "\${${r}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,`    printf '%s\\n' "$${r}"`,"    return 0","  fi",`  resolved="$(pm ${t} 2>/dev/null)"`,'  if [[ -z "$resolved" ]]; then',`    resolved="${a}"`,"  fi",`  ${r}="$resolved"`,`  ${i}="$now"`,`  printf '%s\\n' "$${r}"`,"}"]}function $d(e,t,n){let o=e.toUpperCase(),r=`PM_COMPLETION_${o}_CACHE`,i=`PM_COMPLETION_${o}_CACHE_TS`,s=`PM_COMPLETION_${o}_TTL`,a=Md(n);return`
+_pm_${e}_choices() {
+  local now ttl cache_ts resolved
+  now=\${EPOCHSECONDS:-0}
+  ttl=\${${s}:-120}
+  cache_ts=\${${i}:-0}
+  if [[ -n "\${${r}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
+    print -r -- "$${r}"
+    return
+  fi
+  resolved="$(pm ${t} 2>/dev/null)"
+  if [[ -z "$resolved" ]]; then
+    resolved="${a}"
+  fi
+  ${r}="$resolved"
+  ${i}="$now"
+  print -r -- "$${r}"
+}
+`}function Pd(e,t,n){let o=e.toUpperCase(),r=n.replaceAll("'","\\'");return`
+function __pm_${e}_choices
+  set -l now (date +%s ^/dev/null)
+  if test -z "$now"
+    set now 0
+  end
+  set -l ttl 120
+  if set -q PM_COMPLETION_${o}_TTL
+    set ttl $PM_COMPLETION_${o}_TTL
+  end
+  if set -q PM_COMPLETION_${o}_CACHE; and set -q PM_COMPLETION_${o}_CACHE_TS
+    set -l age (math "$now - $PM_COMPLETION_${o}_CACHE_TS")
+    if test $age -lt $ttl
+      printf '%s\\n' $PM_COMPLETION_${o}_CACHE
+      return
+    end
+  end
+  set -l resolved (pm ${t} ^/dev/null)
+  if test (count $resolved) -eq 0
+    set resolved '${r}'
+  end
+  set -gx PM_COMPLETION_${o}_CACHE $resolved
+  set -gx PM_COMPLETION_${o}_CACHE_TS $now
+  printf '%s\\n' $resolved
+end
+`}function oh(e=[],t=[],n=!1,o={}){let r=kr.join(" "),i=e.length===0,s=Or(e,o),a=$r(o),c=ot(t),l=De(m_,o.command_flags?.list),d=De(y_,o.command_flags?.create),p=De(w_,o.command_flags?.update),f=De(v_,o.command_flags?.["update-many"]),g=De(F_,o.command_flags?.search),w=De(R_,o.command_flags?.calendar),v=De(C_,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`,"",...i?[...Od("type","completion-types",s),""]:[],...Od("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=(${_(r)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',i?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${_(s)})`,"    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',`      ${Cr}) (( word_index += 2 )); continue ;;`,`      ${Tr}|${xr}) (( word_index++ )); continue ;;`,"      --) break ;;","    esac",'    if [[ -z "$cmd" ]]; then','      cmd="$word"','      [[ "$cmd" == "ctx" ]] && cmd="context"',`      case "$cmd" in ${$t.join("|")}) ;; *) break ;; esac`,"    else",'      case "$cmd $word" in',...Se.map(k=>`        "${k.canonical}") cmd="${k.alias}" ;;`),"      esac","      break","    fi","    (( word_index++ ))","  done",'  case "$cmd" in',...I_.flatMap(k=>[`    ${k.alias})`,`      COMPREPLY=(${_(k.flags)})`,"      return 0","      ;;"]),"    list)",`      COMPREPLY=(${_(l)})`,"      ;;","    aggregate)",`      COMPREPLY=(${_(p_)})`,"      ;;","    duplicates)",`      COMPREPLY=(${_(O_)})`,"      ;;","    create)",`      COMPREPLY=(${_(d)})`,"      ;;","    copy)",`      COMPREPLY=(${_(f_)})`,"      ;;","    focus)",`      COMPREPLY=(${_(__)})`,"      ;;","    update)",`      COMPREPLY=(${_(p)})`,"      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY+=(${_(je.update)})`,"      fi","      ;;","    update-many)",`      COMPREPLY=(${_(f)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${_(w)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${_(v)})`,"      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY+=(${_(je.context)})`,"      fi","      ;;","    ops)",`      COMPREPLY=(${_(`${Sr} ${je.ops}`)})`,"      ;;","    next)",`      COMPREPLY=(${_(T_)})`,"      ;;","    guide)",`      COMPREPLY=(${_(`${P_} ${Ar}`)})`,"      ;;","    search)",`      COMPREPLY=(${_(g)})`,"      ;;","    reindex)",`      COMPREPLY=(${_("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${_(`${D_} --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=(${_(`${Rn} ${z_}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${_(`${Rr} ${H_} ${W_}`)})`,"      ;;","    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=(${_(u_)})`,"      ;;","    deps)",`      COMPREPLY=(${_(x_)})`,"      ;;","    graph)",`      COMPREPLY=(${_(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${$_}`)})`,"      ;;","    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-completeness --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=(${_(M_)})`,"      ;;","    history)","      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY=(${_(`${Rd} ${S_}`)})`,"      else",`        COMPREPLY=(${_(Rd)})`,"      fi","      ;;","    events)",`      COMPREPLY=(${_(A_)})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${_(`${E_} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${_(b_)})`,"      ;;","    schema)",'      if [[ "$prev" == "policy-mode" ]]; then',`        COMPREPLY=(${_("advise refuse")})`,"        return","      fi",`      COMPREPLY=(${_(`${Er} --definition --policy --message --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=(${_(`${U_} ${j_}`)})`,"      ;;","    contracts)",`      COMPREPLY=(${_(N_)})`,"      ;;","    gc)",`      COMPREPLY=(${_("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${_(L_)})`,"      ;;","    close-task)",`      COMPREPLY=(${_(Y_)})`,"      ;;","    close)",`      COMPREPLY=(${_(K_)})`,'      if [[ "$cmd" == "close" && $word_index -eq $cword ]]; then',`        COMPREPLY+=(${_(je.close)})`,"      fi","      ;;","    close-many)",`      COMPREPLY=(${_(k_)})`,"      ;;","    release)",`      COMPREPLY=(${_(J_)})`,"      ;;","    delete)",`      COMPREPLY=(${_(V_)})`,"      ;;","    claim)",`      COMPREPLY=(${_(X_)})`,"      ;;","    start-task|pause-task)",`      COMPREPLY=(${_(B_)})`,"      ;;","    meet|event)",`      COMPREPLY=(${_(h_)})`,"      ;;","    remind)",`      COMPREPLY=(${_(g_)})`,"      ;;","    completion)",`      COMPREPLY=(${_(q_)})`,"      ;;","    templates)",`      COMPREPLY=(${_("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${_(Sr)})`,"      ;;","  esac",'  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',`    COMPREPLY+=(${_("--text")})`,"  fi","  return 0","}","","complete -F _pm_completion pm"].join(`
+`)}function rh(e=[],t=[],n=!1,o={}){let r=e.length===0,i=Or(e,o),s=$r(o),a=r?'${(f)"$(_pm_type_choices)"}':i,c='${(f)"$(_pm_status_choices)"}',l=Ar,d=ot(t),p=n||t.length>0,f=p?d:'${(f)"$(_pm_tag_choices)"}',g=xt(o.command_flags?.list),w=xt(o.command_flags?.create),v=xt(o.command_flags?.search),y=xt(o.command_flags?.calendar),_=xt(o.command_flags?.context),k=Cd({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:!0}),R=Cd({missingPrefix:"filter-",pairedPrefix:"filter-"}),x=Ot(nh),L=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=(
+${eh()}
+  )
+  _describe 'command' commands
+}
+${L}
+${r?$d("type","completion-types",i):""}
+${$d("status","completion-statuses",s)}
+
+_pm() {
+  local context state line
+  local -a words=("$words[@]")
+  local CURRENT=$CURRENT
+  local word_index=2 namespace_noun="" operation_index=0 word
+  while (( word_index < CURRENT )); do
+    word="$words[word_index]"
+    case "\${word//_/-}" in
+      ${Cr}) (( word_index += 2 )); continue ;;
+      ${Tr}|${xr}) (( word_index++ )); continue ;;
+      --) break ;;
+    esac
+    if [[ -z "$namespace_noun" ]]; then
+      [[ "$word" == "ctx" ]] && word="context"
+      case "$word" in ${$t.join("|")}) ;; *) break ;; esac
+      namespace_noun="$word"
+    else
+      operation_index=$word_index
+      break
+    fi
+    (( word_index++ ))
+  done
+  if [[ -n "$namespace_noun" ]] && (( word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
+    local -a history_commands
+    case "$namespace_noun" in
+${Object.entries(je).map(([D,W])=>`      ${D}) history_commands=(${W}) ;;`).join(`
+`)}
+    esac
+    _describe 'history operation' history_commands
+    return
+  fi
+  if (( operation_index > 0 )); then
+    case "$namespace_noun $words[operation_index]" in
+${Se.map(D=>`      "${D.canonical}") words=("$words[1]" "${D.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' \\
+${w}            '--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 \\
+${Td("event")}
+          ;;
+        remind)
+          _arguments \\
+${Td("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 \\
+${xd("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 \\
+${xd("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}
+${v}            '--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)
+          if [[ "\${words[CURRENT-1]}" == policy-mode ]]; then
+            compadd advise refuse
+            return
+          fi
+          _arguments \\
+            '1:subcommand:(${Er})' \\
+            '--definition[Policy definition or proposed fields JSON]:json' \\
+            '--policy[Approval policy id]:id' \\
+            '--message[History rationale]:text' \\
+            '--dry-run[Preview schema changes]' \\
+            '--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 \\
+            '--release-assignment[Close and release assignment]' \\
+            '--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 \\
+            '--start[Claim and start work]' \\
+            '--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 \\
+            '--pause[Return to open and release ownership]' \\
+            '--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 \\
+${Ot(Fd.map(D=>`'${D.flag}[${D.description}]${D.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-completeness[Check declarative required fields]' \\
+            '--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:(${Rn})' \\
+            '--init[Generate a starter extension scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${bt.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:(${Rr})' \\
+            '--init[Generate a starter package scaffold at target path]' \\
+            '--scaffold[Alias for --init]' \\
+            '--capability[Capability the init scaffold targets]:capability:(${bt.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 ih(e=[],t=[],n=!1,o={}){let r=kr.filter($=>$==="list"||$.startsWith("list-")),i=r.join(" "),s=kr.join(" "),a=e.length===0,c=Or(e,o),l=$r(o),d=a?"(__pm_type_choices)":c,p="(__pm_status_choices)",f=Ar,g=ot(t),w=n||t.length>0,v=w?`'${g}'`:"'(__pm_tag_choices)'",y=Ne(r,o.command_flags?.list),_=Ne(["create"],o.command_flags?.create),k=Ne(["update"],o.command_flags?.update),R=Ne(["update-many"],o.command_flags?.["update-many"]),x=Ne(["search"],o.command_flags?.search),L=Ne(["calendar","cal"],o.command_flags?.calendar),D=Ne(["context"],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 ${s}
+end
+${w?"":`
+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?Pd("type","completion-types",c):""}
+${Pd("status","completion-statuses",l)}
+
+# Subcommands
+${th()}
+
+# list* flags
+for list_cmd in ${i}
+  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 ${v}
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tags     -d 'Alias for --tag' -r -a ${v}
+  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 ${v}
+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 '__pm_history_operation focus' -l clear -d 'Clear the focused item'
+
+# update flags
+complete -c pm -n '__pm_history_operation update' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__pm_history_operation update' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__pm_history_operation update' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__pm_history_operation update' -l body-file               -d 'Load the item body from a file' -r -F
+complete -c pm -n '__pm_history_operation update' -s s -l status             -d 'Item status' -r -a '${p}'
+complete -c pm -n '__pm_history_operation update' -l close-reason            -d 'Set close reason' -r
+complete -c pm -n '__pm_history_operation update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update' -l type                    -d 'Item type' -r -a '${d}'
+complete -c pm -n '__pm_history_operation update' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__pm_history_operation update' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__pm_history_operation update' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__pm_history_operation update' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__pm_history_operation update' -l expected                -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation update' -l actual                  -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation update' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__pm_history_operation update' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__pm_history_operation update' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__pm_history_operation update' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__pm_history_operation update' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__pm_history_operation update' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__pm_history_operation update' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__pm_history_operation update' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__pm_history_operation update' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__pm_history_operation update' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__pm_history_operation update' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__pm_history_operation update' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__pm_history_operation update' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__pm_history_operation update' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__pm_history_operation update' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__pm_history_operation update' -l clear-events            -d 'Clear events'
+complete -c pm -n '__pm_history_operation update' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__pm_history_operation update' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation update' -l message                 -d 'History message' -r
+complete -c pm -n '__pm_history_operation update' -l force                   -d 'Force override'
+${k}
+
+# update-many flags
+complete -c pm -n '__pm_history_operation update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a '${p}'
+complete -c pm -n '__pm_history_operation update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${d}'
+complete -c pm -n '__pm_history_operation update-many' -l filter-tag              -d 'Filter by tag before applying updates' -r -a ${v}
+complete -c pm -n '__pm_history_operation update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update-many' -l filter-deadline-before  -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-deadline-after   -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-updated-after    -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-updated-before   -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-created-after    -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-created-before   -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-assignee         -d 'Filter by assignee before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-assignee-filter  -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation update-many' -l filter-parent           -d 'Filter by parent item ID' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-release          -d 'Filter by release before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-ac-missing       -d 'Select only items missing acceptance_criteria'
+complete -c pm -n '__pm_history_operation update-many' -l filter-estimates-missing -d 'Select only items missing estimated_minutes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-resolution-missing -d 'Select only terminal items missing resolution'
+complete -c pm -n '__pm_history_operation update-many' -l filter-metadata-missing  -d 'Select only items missing any tracked metadata'
+complete -c pm -n '__pm_history_operation update-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__pm_history_operation update-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__pm_history_operation update-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__pm_history_operation update-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__pm_history_operation update-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__pm_history_operation update-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__pm_history_operation update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__pm_history_operation update-many' -l limit                   -d 'Limit matched item count' -r
+complete -c pm -n '__pm_history_operation update-many' -l offset                  -d 'Skip first n matched rows' -r
+complete -c pm -n '__pm_history_operation update-many' -l dry-run                 -d 'Preview updates without mutating'
+complete -c pm -n '__pm_history_operation update-many' -l rollback                -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__pm_history_operation update-many' -l no-checkpoint           -d 'Disable checkpoint creation during apply mode'
+complete -c pm -n '__pm_history_operation update-many' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__pm_history_operation update-many' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__pm_history_operation update-many' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__pm_history_operation update-many' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update-many' -l type                    -d 'Item type' -r -a '${d}'
+complete -c pm -n '__pm_history_operation update-many' -l tags                    -d 'Comma-separated tags' -r
+complete -c pm -n '__pm_history_operation update-many' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__pm_history_operation update-many' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__pm_history_operation update-many' -l deadline                -d 'Deadline (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l estimate                -d 'Estimated minutes' -r
+complete -c pm -n '__pm_history_operation update-many' -l acceptance-criteria     -d 'Acceptance criteria' -r
+complete -c pm -n '__pm_history_operation update-many' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__pm_history_operation update-many' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__pm_history_operation update-many' -l definition-of-ready     -d 'Definition of ready' -r
+complete -c pm -n '__pm_history_operation update-many' -l order                   -d 'Planning order/rank' -r
+complete -c pm -n '__pm_history_operation update-many' -l goal                    -d 'Goal identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l objective               -d 'Objective identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l value                   -d 'Business value summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l impact                  -d 'Business impact summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l outcome                 -d 'Expected outcome summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l why-now                 -d 'Why-now rationale' -r
+complete -c pm -n '__pm_history_operation update-many' -l reviewer                -d 'Reviewer' -r
+complete -c pm -n '__pm_history_operation update-many' -l risk                    -d 'Risk level' -r
+complete -c pm -n '__pm_history_operation update-many' -l confidence              -d 'Confidence level' -r
+complete -c pm -n '__pm_history_operation update-many' -l sprint                  -d 'Sprint identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l release                 -d 'Release identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l reporter                -d 'Issue reporter' -r
+complete -c pm -n '__pm_history_operation update-many' -l severity                -d 'Issue severity' -r
+complete -c pm -n '__pm_history_operation update-many' -l environment             -d 'Issue environment context' -r
+complete -c pm -n '__pm_history_operation update-many' -l repro-steps             -d 'Issue reproduction steps' -r
+complete -c pm -n '__pm_history_operation update-many' -l resolution              -d 'Issue resolution summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l expected-result         -d 'Issue expected behavior' -r
+complete -c pm -n '__pm_history_operation update-many' -l actual-result           -d 'Issue observed behavior' -r
+complete -c pm -n '__pm_history_operation update-many' -l expected                 -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation update-many' -l actual                   -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation update-many' -l affected-version        -d 'Affected version identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l fixed-version           -d 'Fixed version identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l component               -d 'Issue component ownership' -r
+complete -c pm -n '__pm_history_operation update-many' -l regression              -d 'Regression marker true|false|1|0' -r
+complete -c pm -n '__pm_history_operation update-many' -l customer-impact         -d 'Customer impact summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l dep                     -d 'Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__pm_history_operation update-many' -l dep-remove              -d 'Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__pm_history_operation update-many' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__pm_history_operation update-many' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__pm_history_operation update-many' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__pm_history_operation update-many' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__pm_history_operation update-many' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__pm_history_operation update-many' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__pm_history_operation update-many' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__pm_history_operation update-many' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__pm_history_operation update-many' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__pm_history_operation update-many' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__pm_history_operation update-many' -l clear-events            -d 'Clear events'
+complete -c pm -n '__pm_history_operation update-many' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__pm_history_operation update-many' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation update-many' -l message                 -d 'History message' -r
+complete -c pm -n '__pm_history_operation 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 ${v}
+complete -c pm -n '__fish_seen_subcommand_from search' -l tags           -d 'Alias for --tag' -r -a ${v}
+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 ${v}
+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'
+${L}
+
+# context flags
+complete -c pm -n '__pm_history_operation context' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l past      -d 'Include past entries in bounded windows'
+complete -c pm -n '__pm_history_operation context' -l type      -d 'Filter by type' -r -a '${d}'
+complete -c pm -n '__pm_history_operation context' -l tag       -d 'Filter by tag' -r -a ${v}
+complete -c pm -n '__pm_history_operation context' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation context' -l assignee  -d 'Filter by assignee' -r
+complete -c pm -n '__pm_history_operation context' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation context' -l sprint    -d 'Filter by sprint' -r
+complete -c pm -n '__pm_history_operation context' -l release   -d 'Filter by release' -r
+complete -c pm -n '__pm_history_operation context' -l parent    -d 'Scope snapshot to one item subtree' -r
+complete -c pm -n '__pm_history_operation context' -l limit     -d 'Limit focus and agenda rows per section' -r
+complete -c pm -n '__pm_history_operation context' -l depth     -d 'Context depth' -r -a 'brief standard deep full'
+complete -c pm -n '__pm_history_operation context' -l format    -d 'Output override' -r -a 'markdown toon json'
+${D}
+
+# next flags
+complete -c pm -n '__pm_history_operation next' -l type           -d 'Filter candidates by type' -r -a '${d}'
+complete -c pm -n '__pm_history_operation next' -l tag            -d 'Filter candidates by tag' -r -a ${v}
+complete -c pm -n '__pm_history_operation next' -l priority       -d 'Filter candidates by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation next' -l assignee       -d 'Filter candidates by assignee' -r
+complete -c pm -n '__pm_history_operation next' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation next' -l sprint         -d 'Filter candidates by sprint' -r
+complete -c pm -n '__pm_history_operation next' -l release        -d 'Filter candidates by release' -r
+complete -c pm -n '__pm_history_operation next' -l parent         -d 'Scope to one item subtree' -r
+complete -c pm -n '__pm_history_operation next' -l limit          -d 'Limit ready rows' -r
+complete -c pm -n '__pm_history_operation next' -l blocked-limit  -d 'Limit blocked rows' -r
+complete -c pm -n '__pm_history_operation next' -l ready-only     -d 'Omit the blocked companion list'
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__pm_history_operation 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 ${Cr.replaceAll("|"," ")}
+        set skip_value 1
+        continue
+      case ${Tr.split("|").map($=>`'${$}'`).join(" ")} ${xr.replaceAll("|"," ")}
+        continue
+      case --
+        printf '%s\\n' --
+        return
+    end
+    if test $positions -eq 0; and test "$token" = ctx
+      set token context
+    end
+    printf '%s\\n' "$token"
+    set positions (math $positions + 1)
+    if test $positions -eq 2; or not contains -- "$token" ${$t.join(" ")}
+      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)
+  switch "$tokens[1] $tokens[2]"
+${Se.map($=>`    case '${$.canonical}'
+      contains -- '${$.alias}' $argv
+      return`).join(`
+`)}
+  end
+  contains -- "$tokens[1]" $argv
+end
+${Object.entries(je).map(([$,ke])=>`complete -c pm -n 'test (count (__pm_history_tokens)) -eq 1; and __pm_history_operation ${$}' -a '${ke}' -d '${$} operation'`).join(`
+`)}
+${Fd.map($=>`complete -c pm -n '__pm_history_operation restore restore' -l ${$.flag.slice(2)}${$.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 '__pm_history_operation events' -l since -d 'Resume after a cursor or from an ISO timestamp' -r
+complete -c pm -n '__pm_history_operation events' -l type -d 'Filter by mutation operation' -r
+complete -c pm -n '__pm_history_operation events' -l author -d 'Filter by mutation author' -r
+complete -c pm -n '__pm_history_operation events' -l item -d 'Filter by item or workspace stream' -r
+complete -c pm -n '__pm_history_operation events' -l limit -d 'Maximum events, up to 1000' -r
+complete -c pm -n '__pm_history_operation events' -l full -d 'Include complete authoritative history entries'
+complete -c pm -n '__pm_history_operation events' -l provenance -d 'Include patch-free identity and agent provenance'
+complete -c pm -n '__pm_history_operation events' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation events' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation events' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation events' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation events' -l follow -d 'Continue emitting committed events'
+complete -c pm -n '__pm_history_operation 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 '${Er}' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema; and __fish_seen_subcommand_from policy-mode' -a 'advise refuse' -d 'Policy enforcement'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l definition -d 'Policy definition or proposed fields JSON' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l policy -d 'Approval policy id' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l message -d 'History rationale' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l dry-run -d 'Preview schema changes'
+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 '__pm_history_operation test-all' -l status  -d 'Filter by status' -r -a 'open in_progress'
+complete -c pm -n '__pm_history_operation test-all' -l limit -d 'Limit matching items before running linked tests' -r
+complete -c pm -n '__pm_history_operation test-all' -l offset -d 'Skip matching items before running linked tests' -r
+complete -c pm -n '__pm_history_operation test-all' -l background -d 'Run linked tests in managed background mode'
+complete -c pm -n '__pm_history_operation test-all' -l timeout -d 'Default timeout seconds' -r
+complete -c pm -n '__pm_history_operation test-all' -l progress -d 'Emit linked-test progress to stderr'
+complete -c pm -n '__pm_history_operation test-all' -l env-set -d 'Set linked-test runtime environment values' -r
+complete -c pm -n '__pm_history_operation test-all' -l env-clear -d 'Clear linked-test runtime environment values' -r
+complete -c pm -n '__pm_history_operation test-all' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
+complete -c pm -n '__pm_history_operation test-all' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
+complete -c pm -n '__pm_history_operation test-all' -l override-linked-pm-context -d 'Force run-level --pm-context over per-linked-test metadata'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
+complete -c pm -n '__pm_history_operation test-all' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
+complete -c pm -n '__pm_history_operation test-all' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation gc' -l dry-run -d 'Preview cleanup targets without deleting files'
+complete -c pm -n '__pm_history_operation gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
+
+# stats flags
+complete -c pm -n '__pm_history_operation stats' -l include-empty -d 'Include registered zero-count type and status buckets'
+complete -c pm -n '__pm_history_operation stats' -l storage -d 'Include aggregate history-stream storage metrics'
+complete -c pm -n '__pm_history_operation stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
+complete -c pm -n '__pm_history_operation stats' -l field-utilization -d 'Include content-field utilization rates across all items'
+complete -c pm -n '__pm_history_operation stats' -l by-assignee -d 'Lifecycle-bucketed breakdown grouped by assignee'
+complete -c pm -n '__pm_history_operation stats' -l by-tag -d 'Lifecycle-bucketed breakdown grouped by tag'
+complete -c pm -n '__pm_history_operation stats' -l by-priority -d 'Lifecycle-bucketed breakdown grouped by priority'
+complete -c pm -n '__pm_history_operation stats' -l tag-prefix -d 'With --by-tag: only count tags with this prefix' -r
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation close' -l release-assignment -d 'Close and release assignment'
+complete -c pm -n '__pm_history_operation release' -l pause -d 'Return to open and release ownership'
+complete -c pm -n '__pm_history_operation claim' -l start -d 'Claim and start work'
+complete -c pm -n '__pm_history_operation claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
+complete -c pm -n '__pm_history_operation close' -l reason -d 'Closure reason' -r
+complete -c pm -n '__pm_history_operation close' -l close-reason -d 'Alias for --reason' -r
+complete -c pm -n '__pm_history_operation close' -l resolution -d 'Closure resolution summary' -r
+complete -c pm -n '__pm_history_operation close' -l expected-result -d 'Expected behavior note' -r
+complete -c pm -n '__pm_history_operation close' -l actual-result -d 'Observed behavior note' -r
+complete -c pm -n '__pm_history_operation close' -l expected -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation close' -l actual -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation close-many' -l filter-status          -d 'Filter by status before closing' -r -a '${p}'
+complete -c pm -n '__pm_history_operation close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${d}'
+complete -c pm -n '__pm_history_operation close-many' -l filter-tag             -d 'Filter by tag before closing' -r -a ${v}
+complete -c pm -n '__pm_history_operation close-many' -l filter-priority        -d 'Filter by priority before closing' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation close-many' -l filter-deadline-before -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-deadline-after  -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-updated-after   -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-updated-before  -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-created-after   -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-created-before  -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-assignee        -d 'Filter by assignee before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation close-many' -l filter-parent          -d 'Filter by parent item ID' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-release         -d 'Filter by release before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__pm_history_operation close-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__pm_history_operation close-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__pm_history_operation close-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__pm_history_operation close-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__pm_history_operation close-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__pm_history_operation close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__pm_history_operation close-many' -l limit                  -d 'Limit matched item count' -r
+complete -c pm -n '__pm_history_operation close-many' -l offset                 -d 'Skip first n matched rows' -r
+complete -c pm -n '__pm_history_operation close-many' -l reason                 -d 'Optional shared close reason applied to every matched item' -r
+complete -c pm -n '__pm_history_operation close-many' -l resolution             -d 'Shared closure resolution' -r
+complete -c pm -n '__pm_history_operation close-many' -l expected-result        -d 'Shared expected-result note' -r
+complete -c pm -n '__pm_history_operation close-many' -l actual-result          -d 'Shared actual-result note' -r
+complete -c pm -n '__pm_history_operation close-many' -l expected               -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation close-many' -l actual                 -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation close-many' -l validate-close         -d 'Validate closure metadata per item' -r -a 'off warn strict'
+complete -c pm -n '__pm_history_operation close-many' -l author                 -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation close-many' -l message                -d 'History message' -r
+complete -c pm -n '__pm_history_operation close-many' -l force                  -d 'Re-close terminal matches and override ownership'
+complete -c pm -n '__pm_history_operation close-many' -l dry-run                -d 'Preview matched items without mutating'
+complete -c pm -n '__pm_history_operation close-many' -l rollback               -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__pm_history_operation close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
+
+# validate flags
+complete -c pm -n '__pm_history_operation validate' -l check-completeness -d 'Check declarative required fields'
+complete -c pm -n '__pm_history_operation validate' -l check-metadata -d 'Run metadata completeness checks'
+complete -c pm -n '__pm_history_operation validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
+complete -c pm -n '__pm_history_operation validate' -l check-resolution -d 'Run closed-item resolution metadata checks'
+complete -c pm -n '__pm_history_operation validate' -l check-lifecycle -d 'Run active-item lifecycle governance drift checks'
+complete -c pm -n '__pm_history_operation validate' -l check-stale-blockers -d 'Include stale blocker-pattern diagnostics in lifecycle checks'
+complete -c pm -n '__pm_history_operation validate' -l dependency-cycle-severity -d 'Set dependency-cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__pm_history_operation validate' -l parent-cycle-severity -d 'Set parent-hierarchy cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__pm_history_operation validate' -l check-files -d 'Run linked-file and orphaned-file checks'
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation validate' -l include-pm-internals -d 'Include PM storage internals in tracked-all candidate scans'
+complete -c pm -n '__pm_history_operation validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
+complete -c pm -n '__pm_history_operation validate' -l verbose-diagnostics -d 'Include full validate diagnostic ID lists instead of compact summaries'
+complete -c pm -n '__pm_history_operation validate' -l all-affected-ids -d 'Emit complete missing_* affected-ID lists with no truncation (implied by --json)'
+complete -c pm -n '__pm_history_operation validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
+complete -c pm -n '__pm_history_operation validate' -l fail-on-warn -d 'Alias for --strict-exit'
+complete -c pm -n '__pm_history_operation validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
+complete -c pm -n '__pm_history_operation validate' -l auto-fix -d 'Apply the safe, deterministic subset of fix-hint remediations automatically'
+complete -c pm -n '__pm_history_operation validate' -l dry-run -d 'Preview planned --auto-fix/--prune-missing fixes without applying them'
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation validate' -l prune-missing -d 'Remove stale linked-file/doc links classified as deleted'
+complete -c pm -n '__pm_history_operation validate' -l check-history-drift -d 'Run item/history hash drift checks'
+complete -c pm -n '__pm_history_operation 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 '__pm_history_operation health' -l strict-directories -d 'Treat optional item-type directories as required failures'
+complete -c pm -n '__pm_history_operation health' -l check-only -d 'Run read-only health diagnostics without refreshing vectors'
+complete -c pm -n '__pm_history_operation health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
+complete -c pm -n '__pm_history_operation health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
+complete -c pm -n '__pm_history_operation health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
+complete -c pm -n '__pm_history_operation health' -l verbose-author-events -d 'Include complete actionable unknown-author coordinates'
+complete -c pm -n '__pm_history_operation health' -l brief -d 'Emit compact health details for low-token agent checks'
+complete -c pm -n '__pm_history_operation health' -l summary -d 'Emit one-line-style health status with check names and warning count'
+complete -c pm -n '__pm_history_operation health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
+complete -c pm -n '__pm_history_operation 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 '${Rn}' -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 '${bt.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 '${Rr}' -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 '${bt.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 sh={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 ah(e,t=[],n=[],o=!1,r={}){let i=e.trim().toLowerCase();if(!Ad.includes(i))throw new m(`Unknown shell: "${e}". Supported shells: ${Ad.join(", ")}.`,u.USAGE);let s=i,a;return s==="bash"?a=oh(t,n,o,r):s==="zsh"?a=rh(t,n,o,r):a=ih(t,n,o,r),{shell:s,script:a,setup_hint:sh[s]}}import ch from"node:fs/promises";import Pt 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 Pr="index/manifest.json",Fr="search/embeddings.jsonl",lh="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function dh(e){return e.progress===!0||process.stderr.isTTY===!0}function j(e,t){if(e)try{process.stderr.write(`[pm reindex] ${t}
+`)}catch{}}function mh(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 ph(e,t,n,o){let r=[];return{candidates:await Qi(e,t,n,r,o),warnings:r}}async function Mr(e,t,n,o,r){let i=qe(T()),s=[];for(let a of t)if(!(r&&!r.has(a.metadata.id))){if(typeof a.body=="string"){s.push({metadata:a.metadata,body:a.body});continue}try{let c=await ch.readFile(a.item_path,"utf8"),l=Ht(c,{format:a.item_format,schema:n,extensionFieldNames:i,onWarning:d=>o.push(d)});s.push({metadata:a.metadata,body:l.body})}catch{o.push(`item_list_item_read_failed:${Pt.relative(e,a.item_path)}`),s.push({metadata:a.metadata,body:""})}}return s}function uh(e,t,n){let o=e.metadata;return{id:o.id,mode:t,updated_at:o.updated_at,corpus:ns(e,{fields:n})}}var rt=Wr;function fh(e){let t=T(),n=rt(e.search?.provider);if(!n)return null;let o=li(t,n);if(!o)return null;let r=o.runtime_definition??o.definition,i=rt(r.name)??rt(o.definition.name);if(!i)return null;let s=r.embedBatch,a=r.embed_batch,c=r.embed,l=typeof s=="function"?s:typeof a=="function"?a:void 0,d=typeof c=="function"?c:void 0;return!l&&!d?null:{name:i,embedBatch:l,embed:d}}function _h(e){let t=T(),n=rt(e.vector_store?.adapter);if(!n)return null;let o=di(t,n);if(!o)return null;let r=o.runtime_definition??o.definition,i=rt(r.name)??rt(o.definition.name);if(!i)return null;let s=r.upsert,a=r.delete;return{adapterName:i,...typeof s=="function"?{upsert:s}:{},...typeof a=="function"?{delete:a}:{}}}function Lr(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 hh(e,t,n){let o=t.search?.embedding_model?.trim()||"text-embedding-3-small";if(e.embedBatch){let i=await Promise.resolve(e.embedBatch({inputs:n,settings:t,model:o}));if(!Array.isArray(i))throw new m(`Extension search provider "${e.name}" embedBatch must return an array of vectors`,u.GENERIC_FAILURE);return i.map((s,a)=>Lr(s,`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 r=[];for(let[i,s]of n.entries()){let a=await Promise.resolve(e.embed({input:s,settings:t,model:o}));r.push(Lr(a,`extension search provider "${e.name}" embed output at index ${i}`))}return r}function Nd(e){return e.search?.embedding_model?.trim()||"text-embedding-3-small"}function jd(e,t,n){let o=n?yt(n.name,Nd(e)):t?yt(t.name,t.model):null;if(!o)throw new m("No embedding identity available for semantic reindex mode",u.USAGE);return o}function gh(e,t){return Object.keys(e).filter(n=>!t.has(n)).sort((n,o)=>n.localeCompare(o))}async function Ud(e,t,n,o,r,i,s,a){let c=o?.name??n?.name,l=os(c,e.search.embedding_corpus_max_characters).maxCharacters,d=Xn(e),p=r.map(w=>rs(w,{providerName:c,maxCharacters:l,fields:d})),f=[],g=null;if(o)try{f=await hh(o,e,p),g=yt(o.name,Nd(e))}catch(w){if(!n)throw new m(`Extension search provider "${o.name}" failed to generate embeddings: ${w instanceof Error?w.message:String(w)}`,u.GENERIC_FAILURE);i.push(`Extension search provider "${o.name}" failed; falling back to built-in provider (${w instanceof Error?w.message:String(w)})`)}if(f.length===0){if(!n)throw new m(`No embedding executor available for reindex mode '${t}'`,u.USAGE);let w=await is(n,e,p,{onProgress:v=>{v.phase==="complete"&&(s.batches_completed=v.batch_index),j(a,`embedding_batch_${v.phase} batch=${v.batch_index}/${v.batch_total} size=${v.batch_size} completed_inputs=${v.completed_inputs}/${v.total_inputs}`)}});i.push(...w.warnings),f=w.vectors,g=yt(n.name,n.model)}if(j(a,`embedding_complete vectors=${f.length}`),f.length!==r.length)throw new m(`Embedding output size mismatch (expected ${r.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 yh(e,t,n,o,r,i){let s=Object.keys(n);if(t){if(s.length>0&&t.delete)try{await Promise.resolve(t.delete({ids:s.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 s.length>0&&r.push(`search_semantic_reindex_reset_skipped:adapter=${t.adapterName}:known_ids=${s.length}`);if(!e)return}e&&await ls(e,s,{},i)}async function Gd(e,t,n,o,r){if(n.length!==0){if(t){if(t.delete)try{await Promise.resolve(t.delete({ids:n,settings:o}))}catch(i){throw new m(`Extension vector adapter "${t.adapterName}" failed to delete orphan vectors during reindex: ${i instanceof Error?i.message:String(i)}`,u.GENERIC_FAILURE)}else r.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${t.adapterName}:count=${n.length}`);if(!e)return}e&&await cs(e,n)}}function bh(e){return{enabled:e!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function wh(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 vh(e){if(e.requestedMode==="keyword")return{activeEmbeddingProvider:null,activeVectorStore:null};let t=Jn(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=ss(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 kh(e){let t=P(e.settings,T()),n=await ph(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 Sh(e){let t=await Qn(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 jd(e.settings,Jn(e.settings).active,e.extensionEmbedding)}catch{return null}})();n&&Yt(t.embedding,n)&&(e.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed"),e.reindexWarnings.push(lh))}async function Ih(e){let t=await Qn(e.pmRoot);e.semanticWarnings.push(...t.warnings);let n=jd(e.settings,e.activeEmbeddingProvider,e.extensionEmbedding),o=new Set(e.metadataDocuments.map(l=>l.metadata.id)),r=gh(t.entries,o),i=Yt(t.embedding,n);e.forceFullSemantic&&!i&&e.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced");let s=e.forceFullSemantic||i?e.metadataDocuments:e.metadataDocuments.filter(l=>t.entries[l.metadata.id]!==l.metadata.updated_at),a=new Set(s.map(l=>l.metadata.id)),c=a.size>0?await Mr(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,a):[];return{ledgerEntries:t.entries,ledgerEmbedding:t.embedding,orphanIds:r,resetRequired:i,staleDocuments:c,freshDocuments:e.metadataDocuments.length-c.length}}async function Eh(e){let t=new Set(e.metadataDocuments.map(r=>r.metadata.id)),n=await Mr(e.pmRoot,e.documentCandidates,e.settings.schema,e.reindexWarnings,t);e.semanticSummary.stale_items=n.length,e.semanticSummary.unchanged_items=0,j(e.progressEnabled,`embedding_dimension_changed reset_items=${n.length}`);let o=await Ud(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,n,e.semanticWarnings,e.semanticSummary,e.progressEnabled);return{...o,staleDocuments:n,vectorDimension:Zn(o.vectors,"Reindex embeddings")}}async function Ah(e){let t=await Ud(e.settings,e.requestedMode,e.activeEmbeddingProvider,e.extensionEmbedding,e.staleDocuments,e.semanticWarnings,e.semanticSummary,e.progressEnabled),n=t.vectors,o=t.embeddingIdentity,r=Zn(n,"Reindex embeddings");if(!(!e.resetRequired&&(Yt(e.ledgerEmbedding,o)||ms(e.ledgerEmbedding,r))))return{vectors:n,embeddingIdentity:o,staleDocuments:e.staleDocuments,vectorDimension:r,resetRequired:e.resetRequired};let s=await Eh(e);return n=s.vectors,o=s.embeddingIdentity,r=s.vectorDimension,{vectors:n,embeddingIdentity:o,staleDocuments:s.staleDocuments,vectorDimension:r,resetRequired:!0}}async function Rh(e){if(e.extensionVectorAdapter)try{let t=e.extensionVectorAdapter.adapterName;if(j(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,j(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)})`),j(e.progressEnabled,"vector_upsert_fallback built_in_store")}if(e.activeVectorStore){j(e.progressEnabled,`vector_upsert_start adapter=${e.activeVectorStore.name} points=${e.points.length}`),await as(e.activeVectorStore,e.points),e.semanticSummary.vector_upserted=e.points.length,j(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 Ch(e,t){return e.map((n,o)=>({id:n.metadata.id,vector:Lr(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 Th(e){j(e.progressEnabled,`embedding_start items=${e.plan.staleDocuments.length} unchanged_items=${e.plan.freshDocuments}`);let t=await Ah({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?(j(e.progressEnabled,"vector_reset_start"),await yh(e.activeVectorStore,e.extensionVectorAdapter,e.plan.ledgerEntries,e.settings,e.semanticWarnings,e.plan.ledgerEmbedding?t.vectorDimension:void 0),j(e.progressEnabled,"vector_reset_complete")):await Gd(e.activeVectorStore,e.extensionVectorAdapter,e.plan.orphanIds,e.settings,e.semanticWarnings);let n=Ch(t.staleDocuments,t.vectors);return e.semanticSummary.embedded_items=t.vectors.length,await Rh({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:ds(t.embeddingIdentity,t.vectorDimension)}}async function xh(e){let t=await Ih(e);e.semanticSummary.stale_items=t.staleDocuments.length,e.semanticSummary.unchanged_items=t.freshDocuments;let n=Object.fromEntries(e.metadataDocuments.map(i=>[i.metadata.id,i.metadata.updated_at]));if(j(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 j(e.progressEnabled,`embedding_skipped unchanged_items=${t.freshDocuments}`),e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`),await Gd(e.activeVectorStore,e.extensionVectorAdapter,t.orphanIds,e.settings,e.semanticWarnings),{documentsForKeywordArtifacts:e.documentsForKeywordArtifacts,vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:t.ledgerEmbedding};let o=await Th({...e,plan:t});t.freshDocuments>0&&e.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${t.freshDocuments}`);let r=new Map(o.staleDocuments.map(i=>[i.metadata.id,i]));return{documentsForKeywordArtifacts:e.metadataDocuments.map(i=>r.get(i.metadata.id)??i),vectorizationLedgerEntries:n,vectorizationEmbeddingMetadata:o.embeddingMetadata}}async function Oh(e){let t=Pt.join(e.pmRoot,Pr),n=Pt.join(e.pmRoot,Fr),o=Xn(e.settings),r=e.documentsForKeywordArtifacts.map(s=>JSON.stringify(uh(s,e.mode,o))).join(`
+`);j(e.progressEnabled,"writing keyword artifacts"),await te(t,`${JSON.stringify(e.manifest,null,2)}
+`),await te(n,`${r}
+`);let i=[];if(e.mode!=="keyword")try{j(e.progressEnabled,"writing vectorization status ledger"),await ps(e.pmRoot,e.vectorizationLedgerEntries,e.vectorizationEmbeddingMetadata)}catch(s){i.push(`search_vectorization_status_ledger_write_failed:${s instanceof Error?s.message:String(s)}`)}return i}async function $h(e,t){let n=mh(e.mode),o=dh(e),r=e.full===!0;j(o,`start mode=${n}`);let i=I(process.cwd(),t.path);await O(i);let s=Ki(await A(i)).settings,a=null;try{a=await Q(i,Yi,s.locks.ttl_seconds,C(void 0,"pm-reindex"),!1,s.governance.force_required_for_stale_lock,s.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=fh(s),l=_h(s),d=vh({requestedMode:n,pmRoot:i,settings:s,extensionEmbedding:c,extensionVectorAdapter:l}),p=n;j(o,"loading item corpus");let f=await kh({pmRoot:i,settings:s}),g=f.warnings,{documentCandidates:w,metadataDocuments:v}=f;j(o,`loaded_items=${v.length}`);let y=S(),_=wh(p,y,v),k=Pt.join(i,Pr),R=Pt.join(i,Fr),x=p==="keyword"?await Mr(i,w,s.schema,g):v,L=[],D={},W=null,$=bh(p);if(p==="keyword"&&await Sh({pmRoot:i,settings:s,forceFullSemantic:r,extensionEmbedding:c,reindexWarnings:g}),p!=="keyword"){let ee=await xh({pmRoot:i,settings:s,requestedMode:n,activeEmbeddingProvider:d.activeEmbeddingProvider,activeVectorStore:d.activeVectorStore,extensionEmbedding:c,extensionVectorAdapter:l,documentCandidates:w,metadataDocuments:v,documentsForKeywordArtifacts:x,forceFullSemantic:r,reindexWarnings:g,semanticWarnings:L,semanticSummary:$,progressEnabled:o});x=ee.documentsForKeywordArtifacts,D=ee.vectorizationLedgerEntries,W=ee.vectorizationEmbeddingMetadata}let ke=await Oh({pmRoot:i,mode:p,manifest:_,documentsForKeywordArtifacts:x,settings:s,vectorizationLedgerEntries:D,vectorizationEmbeddingMetadata:W,progressEnabled:o}),fe=[...await G({path:k,scope:"project",op:"reindex:manifest"}),...await G({path:R,scope:"project",op:"reindex:embeddings"}),...await ai({mode:p,total_items:v.length})];return j(o,"done"),{ok:!0,mode:p,total_items:v.length,semantic:$,artifacts:{manifest:Pr,embeddings:Fr},warnings:[...g,...L,...ke,...fe],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]="d35e9a61-b8d8-5dc0-b242-586b2086cc95")}catch{}})();var Bd=Symbol("pm.active-extension-host-context");function Y(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[Bd]=!0,n}run(t,n={}){return Dh({...this.defaults,...n,action:t})}runTyped(t,n={}){return this.run(t,n)}context(t={}){return this.runTyped("context",{options:t})}listAllItemMetadataLight(){return qc(this.defaults.path,this.defaults.cwd)}list(t={}){return this.runTyped("list",{options:t})}async listAllComplete(t={}){return pn(await this.list(Ao(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,...Y(ce(o,{body:n}))})}init(t,n={}){return this.runTyped("init",{...t===void 0?{}:{prefix:t},options:n})}config(t,n,o,r,i={}){return this.runTyped("config",{scope:t,configAction:n,...o===void 0?{}:{key:o},...r===void 0?{}:{value:r},options:i})}schema(t,n={}){return this.runTyped("schema",{options:{...n,subcommand:t}})}workflowPolicy(t,n,o={}){return this.runTyped("schema",{name:n,options:{...o,subcommand:t}})}schemaList(){return this.runTyped("schema",{options:{subcommand:"list"}})}schemaShow(t){return this.runTyped("schema",{name:t,options:{subcommand:"show"}})}schemaAddType(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-type"}})}schemaRemoveType(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-type"}})}schemaAddStatus(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-status"}})}schemaRemoveStatus(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-status"}})}schemaAddField(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"add-field"}})}schemaRemoveField(t,n={}){return this.runTyped("schema",{name:t,options:{...n,subcommand:"remove-field"}})}schemaListFields(){return this.runTyped("schema",{options:{subcommand:"list-fields"}})}schemaShowField(t){return this.runTyped("schema",{name:t,options:{subcommand:"show-field"}})}schemaApplyPreset(t,n={}){return this.runTyped("schema",{typePreset:t,options:{...n,subcommand:"apply-preset"}})}schemaInferTypes(t={}){return this.runTyped("schema",{options:{...t,subcommand:"add-type",infer:!0}})}schemaRenameType(t,n,o){return this.runTyped("schema",{name:t,options:{...o,subcommand:"rename-type",to:n}})}schemaRenameField(t,n,o,r){return this.runTyped("schema",{name:t,options:{...o,subcommand:"rename-field",to:n,...r?{fieldTypeScope:r}:{}}})}schemaRemapStatus(t,n,o){return this.runTyped("schema",{name:t,options:{...o,subcommand:"remap-status",to:n}})}schemaShowStatus(t){return this.runTyped("schema",{name:t,options:{subcommand:"show-status"}})}profile(t,n={}){return this.runTyped("profile",{options:{...n,subcommand:t}})}profileList(){return this.runTyped("profile",{options:{subcommand:"list"}})}profileShow(t){return this.runTyped("profile",{name:t,options:{subcommand:"show"}})}profileApply(t,n={}){return this.runTyped("profile",{name:t,options:{...n,subcommand:"apply"}})}profileLint(t){return this.runTyped("profile",{name:t,options:{subcommand:"lint"}})}validate(t={}){return this.runTyped("validate",{options:t})}health(t={}){return this.runTyped("health",{options:t})}gc(t={}){return this.runTyped("gc",{options:t})}assurance(t){return this.runTyped("assurance",{options:{...t,subcommand:t.action}})}historyRedact(t,n){return this.runTyped("history-redact",{id:t,options:n})}historyRepair(t,n={}){return this.runTyped("history-repair",{id:t,options:n})}historyRepairAll(t={}){return this.runTyped("history-repair",{options:{...t,all:!0}})}historyCompact(t,n={}){return this.runTyped("history-compact",{id:t,options:n})}historyCompactBulk(t){return this.runTyped("history-compact",{options:t})}historyAuthorAcknowledge(t){return this.runTyped("history-author-acknowledge",{historyEvent:(t.events??[]).map(n=>`${n.item_id}:${String(n.line)}`),allActionable:t.all_actionable===!0,dryRun:t.dry_run===!0,planFingerprint:t.plan_fingerprint,limit:t.coordinate_limit,attributedAuthor:t.attributed_author,reviewer:t.reviewer,reason:t.reason})}plan(t,n,o={},r,i){return this.runTyped("plan",{...n===void 0?{}:{id:n},...r===void 0?{}:{stepRef:r},...i===void 0?{}:{reorderTo:i},options:ce(o,{subcommand:t})})}planCreate(t){return this.plan("create",void 0,t)}planShow(t,n={}){return this.plan("show",t,n)}planAddStep(t,n){return this.plan("add-step",t,n)}planUpdateStep(t,n,o){return this.plan("update-step",t,o,n)}planCompleteStep(t,n,o={}){return this.plan("complete-step",t,o,n)}planBlockStep(t,n,o){return this.plan("block-step",t,o,n)}planReorderStep(t,n,o,r={}){return this.plan("reorder-step",t,r,n,o)}planRemoveStep(t,n,o={}){return this.plan("remove-step",t,o,n)}planLink(t,n,o){return this.plan("link",t,o,n)}planUnlink(t,n,o){return this.plan("unlink",t,o,n)}planDecision(t,n){return this.plan("decision",t,n)}planDiscovery(t,n){return this.plan("discovery",t,n)}planValidation(t,n){return this.plan("validation",t,n)}planResume(t,n){return this.plan("resume",t,n)}planApprove(t,n={}){return this.plan("approve",t,n)}planMaterialize(t,n){return this.plan("materialize",t,n)}create(t={}){return this.runTyped("create",Y(t))}update(t,n={}){return this.runTyped("update",{id:t,...Y(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,...Y(o)})}claim(t,n={}){return this.runTyped("claim",{id:t,...Y(n)})}claimNext(t={}){return this.runTyped("claim",{next:!0,...Y(t)})}release(t,n={}){return this.runTyped("release",{id:t,...Y(n)})}copy(t,n={}){return this.runTyped("copy",{id:t,...Y(n)})}delete(t,n={}){return this.runTyped("delete",{id:t,...Y(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},...Y(n)})}startTask(t,n={}){return this.runTyped("start-task",{id:t,...Y(n)})}pauseTask(t,n={}){return this.runTyped("pause-task",{id:t,...Y(n)})}closeTask(t,n,o={}){return this.runTyped("close-task",{id:t,reason:n,...Y(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 JE(e={},t={}){return new b(t).context(e)}function XE(e={},t={}){return new b(t).list(e)}function ZE(e={},t={}){return new b(t).listAllComplete(e)}function QE(e,t={},n={}){return new b(n).search(e,t)}function eA(e,t={},n={}){return new b(n).get(e,t)}function tA(e={},t={}){return new b(t).next(e)}function nA(e={},t={}){return new b(t).aggregate(e)}function oA(e={},t={}){return new b(t).stats(e)}function rA(e={},t={}){return new b(t).duplicates(e)}function iA(e,t={},n={}){return new b(n).comments(e,t)}function sA(e,t={},n={}){return new b(n).notes(e,t)}function aA(e,t={},n={}){return new b(n).learnings(e,t)}function cA(e,t={},n={}){return new b(n).files(e,t)}function lA(e,t={},n={}){return new b(n).filesDiscover(e,t)}function dA(e,t={}){return new b(t).filesLookup(e)}function mA(e,t={},n={}){return new b(n).docs(e,t)}function pA(e,t={},n={}){return new b(n).deps(e,t)}function uA(e,t={},n={},o={}){return new b(o).graph(e,t,n)}function fA(e,t,n={},o={}){return new b(o).append(e,t,n)}function _A(e,t={},n={}){return new b(n).init(e,t)}function hA(e,t,n,o,r={},i={}){return new b(i).config(e,t,n,o,r)}function gA(e,t={},n={}){return new b(n).schema(e,t)}function yA(e={}){return new b(e).schemaList()}function bA(e,t={}){return new b(t).schemaShow(e)}function wA(e,t={},n={}){return new b(n).schemaAddType(e,t)}function vA(e,t={},n={}){return new b(n).schemaRemoveType(e,t)}function kA(e,t={},n={}){return new b(n).schemaAddStatus(e,t)}function SA(e,t={},n={}){return new b(n).schemaRemoveStatus(e,t)}function IA(e,t={},n={}){return new b(n).schemaAddField(e,t)}function EA(e,t={},n={}){return new b(n).schemaRemoveField(e,t)}function AA(e={}){return new b(e).schemaListFields()}function RA(e,t={}){return new b(t).schemaShowField(e)}function CA(e,t={},n={}){return new b(n).schemaApplyPreset(e,t)}function TA(e={},t={}){return new b(t).schemaInferTypes(e)}function xA(e,t,n,o={}){return new b(o).schemaRenameType(e,t,n)}function OA(e,t,n,o,r={}){return new b(r).schemaRenameField(e,t,n,o)}function $A(e,t,n,o={}){return new b(o).schemaRemapStatus(e,t,n)}function PA(e,t={}){return new b(t).schemaShowStatus(e)}function FA(e,t={},n={}){return new b(n).profile(e,t)}function LA(e={}){return new b(e).profileList()}function MA(e,t={}){return new b(t).profileShow(e)}function DA(e,t={},n={}){return new b(n).profileApply(e,t)}function NA(e,t={}){return new b(t).profileLint(e)}function jA(e={},t={}){return new b(t).validate(e)}function UA(e={},t={}){return new b(t).health(e)}function GA(e={},t={}){return new b(t).gc(e)}function qA(e,t,n={}){return new b(n).historyRedact(e,t)}function zA(e,t={},n={}){return new b(n).historyRepair(e,t)}function HA(e={},t={}){return new b(t).historyRepairAll(e)}function WA(e,t={},n={}){return new b(n).historyCompact(e,t)}function BA(e,t={}){return new b(t).historyCompactBulk(e)}function VA(e={},t={}){return new b(t).create(e)}function KA(e,t={},n={}){return new b(n).update(e,t)}function YA(e,t,n={},o={}){return new b(o).reopen(e,t,n)}function JA(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 ZA(e={},t={}){return new b(t).claimNext(e)}function QA(e,t={},n={}){return new b(n).release(e,t)}function eR(e,t={},n={}){return new b(n).copy(e,t)}function tR(e,t={},n={}){return new b(n).delete(e,t)}function nR(e,t,n={},o={}){return new b(o).restore(e,t,n)}function oR(e,t={},n={}){return new b(n).focus(e,t)}function rR(e,t={},n={}){return new b(n).startTask(e,t)}function iR(e,t={},n={}){return new b(n).pauseTask(e,t)}function sR(e,t,n={},o={}){return new b(o).closeTask(e,t,n)}function aR(e,t={},n={}){return new b(n).extension(e,t)}function cR(e={},t={}){return new b(t).extensionList(e)}function lR(e,t={},n={}){return new b(n).extensionActivate(e,t)}function dR(e,t={},n={}){return new b(n).extensionDeactivate(e,t)}function mR(e,t={},n={}){return new b(n).package(e,t)}function pR(e={},t={}){return new b(t).packageList(e)}function uR(e,t={},n={}){return new b(n).packageInstall(e,t)}function fR(e,t={},n={}){return new b(n).packageUninstall(e,t)}function _R(e={},t={}){return new b(t).packageDoctor(e)}function hR(e,t={},n={}){return new b(n).packageManage(e,t)}function gR(e,t={},n={}){return new b(n).packageDescribe(e,t)}function yR(e={},t={}){return new b(t).packageReload(e)}function bR(e={},t={}){return new b(t).packageCatalog(e)}function wR(e,t={},n={}){return new b(n).packageActivate(e,t)}function vR(e,t={},n={}){return new b(n).packageDeactivate(e,t)}function kR(e,t={},n={}){return new b(n).upgrade(e,t)}async function SR(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 ko(n,o)}function oe(e,t){let n=h(e,t);if(!n)throw new m(`Missing required argument: ${t}`,64);return n}var qd=oi(),Vd=new Ph;function Cn(){Nn(Yr()),jn(Jr()),Un(Xr()),Gn(Zr()),qn(Qr()),zn(ei()),Hn(ti())}async function Kd(e,t,n,o){return ri(()=>t===void 0?qd.read(()=>zd(e,n,o)):qd.write(()=>Lh(t,()=>zd(e,n,o))))}async function IR(e,t){let n=e.cwd,o=n??process.cwd();return Kd(Zt({path:e.path,noExtensions:e.noExtensions}),n,o,()=>Vd.run(!0,t))}async function zd(e,t,n){let o=I(t,e.path);if(e.noExtensions)return Cn(),Lo({pmRoot:o},()=>n(null));if(!await he(ct(o)))return Cn(),n(null);let r=null,i;try{let s=await A(o),a=await Ut({pmRoot:o,settings:s,cwd:t,noExtensions:!1}),c=await qt({...a,loaded:a.loaded});i={loadResult:a,activationResult:c},Nn(c.hooks),jn(c.commands),Un(c.parsers),Gn(c.preflight),qn(c.services),zn(c.renderers),Hn(c.registrations),r={registrations:c.registrations,commands:c.commands,pmRoot:o,packages:a.loaded}}catch(s){Cn(),console.error("[pm-sdk] extension activation failed; continuing without active extensions:",s)}try{return await Lo({pmRoot:o,packages:r?.packages},()=>n(r))}finally{Cn(),i&&await Gt(i.loadResult,i.activationResult).catch(()=>{})}}async function Fh(e,t,n,o,r){if(!r)throw new m(`Unsupported native pm action: ${e}`,u.USAGE);let i=Te(e),a=r.registrations.commands.find(l=>Te(l.action)===i)?.command??r.commands.handlers.find(l=>Te(l.command)===i)?.command;if(!a)throw new m(`Unsupported native pm action: ${e}`,u.USAGE);let c=await ci({command:ro(a),args:z(n.args??t.args),options:io(t,n),global:o,pm_root:r.pmRoot,sdk:Qc(r.pmRoot,b.forActiveExtensionHost({pmRoot:r.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 Lh(e,t){let n=process.cwd();process.chdir(e);try{return await t()}finally{process.chdir(n)}}function Mh(e){let t=oe(e,"action"),n=Te(t),o=it(Co,n),r=o?.action??n,i={...e,action:r};return o?.options!==void 0&&(i.options={...o.options,...On(e.options)}),r==="package"&&(i.options={...On(i.options),vocabulary:"package"}),{action:r,args:i}}async function Dh(e){let t=Mh(e),n=Zt(t.args),o=sa(t.action),r=h(t.args,"cwd"),i=r??process.cwd();t.action==="init"&&(n[_c]=i),(t.action!=="init"||n.path!==void 0||(process.env.PM_PATH?.trim().length??0)>0)&&(n.path=I(i,n.path));try{return e[Bd]===!0||Vd.getStore()===!0?await Wd(t.action,t.args,n,null):await Kd(n,r,i,s=>Wd(t.action,t.args,n,s))}finally{o&&Ro()}}function it(e,t){return Object.prototype.hasOwnProperty.call(e,t)?e[t]:void 0}function Tn(e){return h(e.args,"target")??h(e.options,"target")}function M(e,t=e.options){return e.id??oe(t,"id")}async function Nh(e){let t=We("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),Eo(await le(h(e.args,"status")??h(t,"status"),t,e.global),t)}async function jh(e){let t=oe(e.args,"query"),n=We("search",e.options,[t]);return n.compact===void 0&&n.full===void 0&&n.fields===void 0&&(n.compact=!0),Eo(await vo(t,n,e.global),n)}async function Uh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return J(await St(o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Gh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),r={...o,...o.title===void 0&&typeof e.args.title=="string"?{title:e.args.title}:{},...o.message===void 0&&typeof e.args.message=="string"?{message:e.args.message}:{}};return J(await Qo(M(e,r),r,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function qh(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return J(await Ye(M(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}function zh(e){let t=cn(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")),cl(M(e),t,e.global)}function Yd(e,t){return Xa(fd(e.options,t,X),e.global)}function Hh(e){let t=z(e.options.lookupPath);if(t&&t.length>0)return Yd(e,t);let n=M(e);return e.options.discover===!0?lo(n,oo(e.options),e.global):Ja(n,Qt(e.options),e.global)}function Wh(e){return Mc({subcommand:h(e.args,"subcommand")??h(e.options,"subcommand"),limit:ra(e.args,e.options)},e.global)}function Bh(e){let t={...e.options};return t.brief===void 0&&t.summary===void 0&&t.full===void 0&&(t.summary=!0),wt(e.global,t)}function Vh(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 fc(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 Kh(e){let t=e.options;return Qs(Zs(t),e.global)}function Yh(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 Jh(e){let t=h(e.args,"subcommand")??oe(e.options,"subcommand"),n=e.options;return Cl({subcommand:t,id:typeof e.id=="string"?e.id:typeof n.id=="string"?n.id:void 0,stepRef:Xh(e),reorderTo:Yh(n.reorderTo??e.args.reorderTo,"plan reorderTo"),options:e.options,global:e.global})}function Xh(e){return typeof e.options.stepRef=="string"?e.options.stepRef:typeof e.args.stepRef=="string"?e.args.stepRef:void 0}function Zh(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 Qh(e){let{ctx:t,subcommand:n,name:o,author:r,force:i}=e,a=it({list:()=>Ea(t.global),show:()=>Aa(o,t.global),"show-status":()=>Ra(o,t.global),"list-fields":()=>xa(t.global),"show-field":()=>Oa(o,t.global),"remove-type":()=>va(o,{author:r,force:i},t.global),"remove-field":()=>Ta(o,{author:r,force:i},t.global),"remove-status":()=>Ia(o,{author:r,force:i},t.global),"apply-preset":()=>$a(h(t.args,"typePreset")??h(t.options,"typePreset"),{author:r,force:i},t.global)},n);return a?a():null}function eg(e){let{ctx:t,name:n,author:o,force:r,aliases:i}=e,s=t.args.commands??t.options.commands,a=t.args.requiredTypes??t.options.requiredTypes;return Ca(n,{type:h(t.args,"fieldType")??h(t.options,"fieldType"),commands:s===void 0?void 0:z(s),description:h(t.args,"description")??h(t.options,"description"),cliFlag:h(t.args,"cliFlag")??h(t.options,"cliFlag"),alias:i,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:r},t.global)}function tg(e){let{ctx:t,name:n,author:o,force:r,aliases:i}=e,s=t.args.role??t.options.role;return Sa(n,{role:s===void 0?void 0:z(s),alias:i,description:h(t.args,"description")??h(t.options,"description"),order:X(t.args.order??t.options.order,"schema add-status order"),author:o,force:r},t.global)}function ng(e){let{ctx:t,name:n,author:o,force:r,aliases:i}=e;return wa(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:i,author:o,force:r},t.global)}function og(e){let{ctx:t,subcommand:n,name:o,author:r,force:i}=e,s=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:s}:n==="rename-field"?{kind:"rename-field",from:o??"",to:s,...c===void 0?{}:{type:c}}:{kind:"remap-status",from:o??"",to:s};return ya(l,{migrationId:a,dryRun:t.args.dryRun===!0||t.options.dryRun===!0,author:r,force:i},t.global)}function rg(e){let t=Zh(e),n=Bt.find(r=>r===t.subcommand);if(n)return ga(n,t.name,{definition:e.args.definition??e.options.definition,policy:h(e.args,"policy")??h(e.options,"policy"),message:h(e.args,"message")??h(e.options,"message"),author:t.author,dryRun:e.args.dryRun===!0||e.options.dryRun===!0},e.global);let o=Qh(t);if(o!==null)return o;if(["rename-type","rename-field","remap-status"].includes(t.subcommand))return og(t);if(t.subcommand==="add-field")return eg(t);if(t.subcommand==="add-status")return tg(t);if(t.subcommand==="add-type")return e.args.infer===!0||e.options.infer===!0?Pa({minCount:X(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):ng(t);throw ie({command_path:"schema",token:t.subcommand,allowed:ba,exit_code:64})}function ig(e){let t=h(e.args,"subcommand")??oe(e.options,"subcommand"),n=t.trim().toLowerCase(),o=h(e.args,"name")??h(e.options,"name"),i=it({list:()=>id(),show:()=>sd(o),lint:()=>ad(o),apply:()=>cd(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(!i)throw ie({command_path:"profile",token:t,allowed:rd,exit_code:64});return i()}async function sg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options);return J(await ol(M(e,o),o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function ag(e){let{changedFields:t,runnerOptions:n}=B(e.args,e.options);return J(await _l(ao(n),e.global),{changedFields:t})}async function cg(e){let{changedFields:t,runnerOptions:n}=B(e.args,e.options),o=h(e.args,"reason"),r=o!==void 0&&n.reason===void 0?{...n,reason:o}:{...n};return e.force&&r.force===void 0&&(r.force=!0),J(await al(so(r),e.global),{changedFields:t})}async function lg(e){let{changedFields:t,idOnly:n,runnerOptions:o}=B(e.args,e.options),r=h(o,"target")??oe(e.args,"target");return J(await Pe(M(e,o),r,o,e.global),{changedFields:t,compactEnvelope:t==="compact"&&!n,idOnly:n})}async function Hd(e){return bo(M(e),ce(e.options,{force:e.force}),e.global)}async function dg(e){let t=M(e),n=h(e.args,"reason")??h(e.args,"text")??h(e.options,"reason")??h(e.options,"text");return Et(t,n,ce(e.options,{force:e.force}),e.global)}function mg(e){let t={...e.args,...e.options};return ta(oe(t,"subcommand"),h(t,"id")??e.id,h(t,"target"),ca(t),e.global)}function pg(e){return da(I(process.cwd(),e.global.path),{...e.args,...e.options})}var Jd={init:e=>hc(h(e.args,"prefix"),e.global,e.options),context:e=>fo(We("context",e.options),e.global),next:e=>_o(We("next",e.options),e.global),eval:Ll,events:Ml,merge:Dl,workspace:Nl,meet:bn,event:bn,remind:bn,list:Nh,get:e=>{let t=M(e);return wo(t,e.global,We("get",e.options,[t]))},search:jh,duplicates:e=>{let t=typeof e.options.status=="string"?[e.options.status]:z(e.options.status);return Io(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:X(e.options.limit,"limit")})},create:Uh,copy:Gh,focus:e=>tr(e.id,{clear:e.options.clear===!0||e.args.clear===!0},e.global),update:qh,"item-reopen":ud,restore:lg,claim:md,release:e=>e.options.pause===!0?Hd(e):oc(M(e),e.force,e.global,e.options),"start-task":e=>It(M(e),ce(e.options,{force:e.force}),e.global),"pause-task":Hd,"close-task":dg,close:pd,comments:zh,notes:e=>dl(M(e),cn(e.options),e.global),learnings:e=>ll(M(e),cn(e.options),e.global),files:Hh,docs:e=>Ya(M(e),Qt(e.options),e.global),test:e=>Dc(M(e),e.options,e.global),"test-all":e=>Nc(e.options,e.global),telemetry:Wh,validate:e=>an(e.options,e.global,{runUpdate:(t,n,o)=>Ye(t,n,o)}),health:Bh,assurance:e=>Za(e.args,e.options,e.global),contracts:e=>ko(e.options,e.global),config:Vh,activity:Kh,aggregate:e=>mo(e.options,e.global),extension:e=>on(Tn(e),e.options,e.global),package:e=>on(Tn(e),e.options,e.global),install:e=>on(Tn(e),{...e.options,install:!0},e.global),upgrade:e=>dc(Tn(e),e.options,e.global),delete:e=>er(M(e),e.options,e.global),deps:e=>ea(M(e),e.options,e.global),graph:mg,"files-discover":e=>lo(M(e),e.options,e.global),"files-lookup":e=>Yd(e,z(e.options.paths)),history:e=>lc(M(e),e.options,e.global),"history-redact":e=>Tc(M(e),e.options,e.global),"history-repair":ld,"history-compact":dd,"history-author-acknowledge":pg,plan:Jh,schema:rg,profile:ig,stats:e=>So(e.global,_d(e.options)),append:sg,"update-many":ag,"close-many":cg,gc:e=>mc(e.global,e.options)};function ER(e=Fi){return e.map(t=>{let n=Te(t),o=it(Co,n),r=o?.action??n,i=it(Jd,r)!==void 0;return{action:t,resolved_action:r,covered:i,route:i?o?"alias":"native":"missing"}})}async function Wd(e,t,n,o){let r=no(t,e);Li(e,r),Mi(e,r);let i={action:e,args:t,options:r,id:h(t,"id"),force:t.force===!0||r.force===!0,global:n,activeExtensions:o},s=it(Jd,e),a=s?await s(i):await Fh(e,t,r,n,o);r.resolvedOutputFormat="json";let c=ji(e,r,a);return await el(I(process.cwd(),n.path),c),c}var ug={closeManyOptionsFromFlat:so,extensionOptionsFromArgs:io,globalOptions:Zt,mutationListOptions:aa,normalizeActionName:Te,normalizeCommandPath:ro,normalizeMcpUpdateOptions:la,normalizeMcpOptionsArrays:ia,optionsWithAuthor:no,readRequiredString:oe,readScalarString:na,readScalarStringAllowBlank:oa,readStringArray:z,updateManyOptionsFromFlat:ao,withAddNoteOption:Qt,withFilesDiscoveryOptions:oo,withMutationCompaction:B};(process.env.NODE_ENV==="test"||process.env.VITEST!==void 0||process.env.VITEST_WORKER_ID!==void 0)&&(globalThis.__pmCliActionRunnerTestHooks=ug);export{Yc as a,_m as b,To as c,Rt as d,_n as e,Qc as f,wg as g,vg as h,kg as i,Sg as j,Ig as k,Uc as l,Eg as m,Zd as n,em as o,mn as p,Ao as q,zc as r,pn as s,am as t,Ro as u,mm as v,Fo as w,tl as x,Am as y,Cm as z,Tm as A,Lo as B,ol as C,al as D,cl as E,ll as F,dl as G,_l as H,Dp as I,hl as J,Wo as K,Cl as L,Qo as M,er as N,tr as O,xl as P,Ol as Q,Fl as R,et as S,or as T,Vu as U,fw as V,_w as W,sr as X,Ul as Y,Ow as Z,$w as _,ql as $,Wl as aa,Xw as ba,mf as ca,ur as da,uf as ea,ff as fa,rd as ga,id as ha,sd as ia,ad as ja,cd as ka,kv as la,Sv as ma,Iv as na,Ev as oa,fr as pa,Af as qa,Rf as ra,Cf as sa,U as ta,Tf as ua,xf as va,Of as wa,$f as xa,gr as ya,hd as za,nt as Aa,hr as Ba,gd as Ca,Pf as Da,yd as Ea,Ff as Fa,Lf as Ga,Mf as Ha,Df as Ia,Nf as Ja,Wf as Ka,kd as La,Bf as Ma,Qf as Na,s_ as Oa,c_ as Pa,ah as Qa,$h as Ra,b as Sa,JE as Ta,XE as Ua,ZE as Va,QE as Wa,eA as Xa,tA as Ya,nA as Za,oA as _a,rA as $a,iA as ab,sA as bb,aA as cb,cA as db,lA as eb,dA as fb,mA as gb,pA as hb,uA as ib,fA as jb,_A as kb,hA as lb,gA as mb,yA as nb,bA as ob,wA as pb,vA as qb,kA as rb,SA as sb,IA as tb,EA as ub,AA as vb,RA as wb,CA as xb,TA as yb,xA as zb,OA as Ab,$A as Bb,PA as Cb,FA as Db,LA as Eb,MA as Fb,DA as Gb,NA as Hb,jA as Ib,UA as Jb,GA as Kb,qA as Lb,zA as Mb,HA as Nb,WA as Ob,BA as Pb,VA as Qb,KA as Rb,YA as Sb,JA as Tb,XA as Ub,ZA as Vb,QA as Wb,eR as Xb,tR as Yb,nR as Zb,oR as _b,rR as $b,iR as ac,sR as bc,aR as cc,cR as dc,lR as ec,dR as fc,mR as gc,pR as hc,uR as ic,fR as jc,_R as kc,hR as lc,gR as mc,yR as nc,bR as oc,wR as pc,vR as qc,kR as rc,SR as sc,oe as tc,IR as uc,Dh as vc,ER as wc};
+//# sourceMappingURL=chunk-4SFBH77G.js.map