@unbrained/pm-cli 2026.10.21 → 2026.10.23

package/dist/cli-bundle/chunks/{chunk-V3XONSVC.js → chunk-5V4HU6GK.js}

@@ -1,70 +1,70 @@
-import{$c as Ce,E as Ja,H as It,I as At,L as Oe,Q as qa,R as mn,_c as Ba,ad as tt,bd as Ha,cd as Ka,dd as ae,ed as ze,fd as Va,g as be,gd as re,hc as Wa,k as Fa,l as Ma,m as ke,n as Ua,nf as Tt,o as za,qe as Ya,y as Ga}from"./chunk-V5GJTXYW.js";import{i as Za,n as Qa,p as ei}from"./chunk-DJQVNDXO.js";import{$e as ne,Aa as ga,Ac as Oa,Bb as ka,Bd as Ra,Cb as xa,Cc as Et,Cd as Qe,Db as Sa,Dc as Ca,Ec as Pa,G as pa,Gb as Ea,Hb as $a,Oc as J,Of as Me,Pb as Ia,Q as kt,R as rn,Rb as Aa,Re as A,S as on,Sa as xt,Ta as ya,Ua as sn,Ub as Te,Va as cn,Wa as dn,Ya as _a,Za as wa,Zc as W,ab as va,bg as I,cg as V,dg as Na,eg as H,fg as ee,gh as ja,gi as pn,hb as ba,hg as Da,ii as La,j as sa,jg as et,ji as Ue,lg as $t,lh as K,na as ma,oa as ua,pa as q,rc as ln,ri as pe,sc as Ta,tc as St,v as B,vc as _e,wi as C,xa as F,xc as we,xi as ve,ya as fa,z as ye,za as ha}from"./chunk-KBSVPUFD.js";import{f as Xa}from"./chunk-4OYU5OXQ.js";import{A as h,C as f,E as k,F as bt,G as ge,H as G,K as le,a as ca,d as vt,m as da,t as nn,v as la,y as an}from"./chunk-GWIGZDRS.js";import{mkdir as gs,readFile as ys}from"node:fs/promises";import ii 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]="1fae5539-4eb8-5eba-bfd6-a191c89448ec")}catch{}})();var un=class extends Error{constructor(t="Workspace transaction interrupted"){super(t),this.name="WorkspaceTransactionInterruptedError"}},_s="sdk-workspace-transaction",ws=/^[a-zA-Z0-9._-]+$/,vs=30,bs=3e3;function ri(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n||!ws.test(n))throw new TypeError(`${t} must match [a-zA-Z0-9._-]+`);return n}function ti(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n)throw new TypeError(`${t} must be non-empty`);return n}function ks(e){return{pmRoot:ti(e.pmRoot,"Transaction pmRoot"),transactionId:ri(e.transactionId,"Transaction id"),author:ti(e.author,"Transaction author")}}function ni(e,t,n){let a=e??t;if(!Number.isInteger(a)||a<=0)throw new TypeError(`${n} must be a positive integer`);return a}function oi(e,t){return ii.join(e,"transactions","sdk",`${t}.json`)}async function xe(e,t){t.updatedAt=A();let n=oi(e,t.transactionId);await gs(ii.dirname(n),{recursive:!0}),await le(n,`${JSON.stringify(t,null,2)}
-`)}function xs(e){return Number.isInteger(e.attempt)&&typeof e.author=="string"&&typeof e.createdAt=="string"&&typeof e.updatedAt=="string"}function Pe(e){return Object.assign(Object.create(null),e)}function Ss(e,t){try{let n=JSON.stringify(e,(a,i)=>{if(typeof i=="number"&&!Number.isFinite(i))throw new TypeError(`${t} contains a non-finite number`);if(i===void 0||typeof i=="function"||typeof i=="symbol")throw new TypeError(`${t} contains a non-JSON value`);return i});return JSON.parse(n)}catch(n){throw new TypeError(`${t} must be JSON serializable`,{cause:n})}}function fn(e,t){return e===void 0?void 0:Ss(e,t)}function hn(e,t,n,a){let i=fn(n,a);i===void 0?delete e[t]:e[t]=i}function ai(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function gn(e,t){return Array.isArray(e)&&new Set(e).size===e.length&&e.every(n=>typeof n=="string"&&t.includes(n))}function Es(e,t){if(!gn(e.startedStepIds,t)||!gn(e.completedStepIds,t)||!ai(e.results)||!ai(e.compensationData))return!1;let n=e.startedStepIds,a=new Set(n),i=e.completedStepIds,r=new Set(i);return Object.keys(e.compensationData).some(o=>!a.has(o))||Object.keys(e.results).some(o=>!r.has(o))?!1:e.status==="committed"?t.every(o=>r.has(o)):e.status!=="compensated"||r.size===0&&a.size===0}function Ot(e,t){return new f(`Workspace transaction ${e} journal is invalid (${t})`,h.CONFLICT,{code:"transaction_journal_invalid",required:"A valid durable journal is required before transaction recovery can continue.",why:"Corrupt journal data cannot establish which steps applied or still require compensation.",nextSteps:["Preserve the journal and inspect its integrity or restore a verified backup before retrying.","Do not switch to a new transaction id to bypass an unreadable journal; previously applied work may remain."]})}function $s(e){return new f(`Workspace transaction ${e} journal does not match the supplied plan`,h.CONFLICT,{code:"transaction_plan_mismatch",required:"Replay the exact plan that started this transaction, or start a new transaction with a different id.",why:"A journal records the plan it is resuming; applying a different plan under the same id could skip or duplicate steps.",nextSteps:["Re-run with the original document to resume or replay it.","Pass --transaction-id <new-id> (or a new transactionId over MCP) to commit the changed plan as its own transaction.","Run pm ops gc --scope transactions --dry-run to inspect abandoned journals before pruning them."]})}function Is(e,t,n){let a;try{a=JSON.parse(e)}catch{throw Ot(t,"invalid JSON")}if(!a||typeof a!="object"||Array.isArray(a))throw Ot(t,"expected an object");let i=a;if(!(i.schemaVersion===1&&i.transactionId===t))throw Ot(t,"schema version or transaction id does not match the journal file");let r=i.stepIds;if(!Array.isArray(r)||!gn(r,r)||!Es(i,r)||!xs(i)||typeof i.status!="string"||!["applying","compensating","compensated","committed"].includes(i.status))throw Ot(t,"invalid lifecycle, metadata, status or step ids");if(!(i.status==="compensated"||r.length===n.length&&r.every((o,s)=>o===n[s])))throw $s(t);return{...i,results:Pe(i.results),compensationData:Pe(i.compensationData)}}async function As(e,t,n,a,i){let r=i,o=r!==void 0;if(r?.status==="compensating"&&await si(e,r),r===void 0||r.status==="compensated"){let s=A();r={schemaVersion:1,transactionId:t,author:n,status:"applying",attempt:(r?.attempt??0)+1,createdAt:r?.createdAt??s,updatedAt:s,stepIds:a,startedStepIds:[],completedStepIds:[],results:Pe(),compensationData:Pe()},await xe(e.pmRoot,r),await me(e,r,"prepared")}return{journal:r,recovered:o}}async function Ts(e,t,n){try{await Cs(t,e.steps),await xe(e.pmRoot,t);let a=new Set(t.completedStepIds),i=new Set(t.startedStepIds);for(let r of e.steps){if(a.has(r.id))continue;let o=await r.inspect(),s=fn(o.result,`Step ${r.id} result`);if(o.state!=="applied"){let d=await r.prepareCompensation?.();hn(t.compensationData,r.id,d,`Step ${r.id} compensation data`),i.add(r.id),t.startedStepIds=e.steps.map(l=>l.id).filter(l=>i.has(l)),await xe(e.pmRoot,t);let c=await r.apply();s=fn(c,`Step ${r.id} result`)}await me(e,t,"step_applied",r.id),a.add(r.id),t.completedStepIds=e.steps.map(d=>d.id).filter(d=>a.has(d)),hn(t.results,r.id,s,`Step ${r.id} result`),await xe(e.pmRoot,t),await me(e,t,"step_recorded",r.id)}return await me(e,t,"committing"),t.status="committed",await xe(e.pmRoot,t),await me(e,t,"committed"),{transactionId:t.transactionId,status:"committed",recovered:n,results:Pe(t.results)}}catch(a){if(a instanceof un||t.status==="committed")throw a;try{await si(e,t)}catch(i){throw new AggregateError([a,i],`Workspace transaction failed and compensation failed: ${String(i)}`,{cause:i})}throw a}}async function Os(e,t,n){try{return Is(await ys(oi(e,t),"utf8"),t,n)}catch(a){if(a!==null&&typeof a=="object"&&"code"in a&&ge(a))return;throw a}}async function me(e,t,n,a){await e.onTransition?.({transactionId:t.transactionId,attempt:t.attempt,transition:n,...a===void 0?{}:{stepId:a}})}async function Cs(e,t){let n=new Set,a=Pe();for(let i of t){let r=await i.inspect();r.state==="applied"&&(n.add(i.id),hn(a,i.id,r.result,`Step ${i.id} result`))}e.results=a,e.completedStepIds=t.map(i=>i.id).filter(i=>n.has(i))}async function si(e,t){t.status="compensating",await xe(e.pmRoot,t),await me(e,t,"compensating");let n=new Set(t.completedStepIds),a=new Set(t.startedStepIds);for(let i of[...e.steps].reverse()){if(!a.has(i.id)&&!n.has(i.id))continue;let r;try{r=a.has(i.id)&&(await i.inspect()).state==="applied"}catch{r=a.has(i.id)}r&&(await me(e,t,"step_compensating",i.id),await i.compensate(t.compensationData[i.id])),n.delete(i.id),a.delete(i.id),t.completedStepIds=e.steps.map(o=>o.id).filter(o=>n.has(o)),t.startedStepIds=e.steps.map(o=>o.id).filter(o=>a.has(o)),delete t.results[i.id],delete t.compensationData[i.id],await xe(e.pmRoot,t),await me(e,t,"step_compensated",i.id)}t.status="compensated",await xe(e.pmRoot,t),await me(e,t,"compensated")}async function ci(e){let{pmRoot:t,transactionId:n,author:a}=ks(e),i=ni(e.lockTtlSeconds,vs,"Transaction lock TTL"),r=ni(e.lockWaitMs,bs,"Transaction lock wait"),o=[...e.steps];if(o.length===0)throw new TypeError("Workspace transaction requires at least one step");let s=o.map(l=>{let p=ri(l.id,"Transaction step id");if(p!==l.id)throw new TypeError("Transaction step id must not contain surrounding whitespace");return p});if(new Set(s).size!==s.length)throw new TypeError("Workspace transaction step ids must be unique");let d={...e,pmRoot:t,transactionId:n,author:a,steps:o,lockTtlSeconds:i,lockWaitMs:r},c=await ne(t,_s,i,a,!1,!1,r);try{let l=await Os(t,n,s),p=l!==void 0;if(l?.status==="committed")return{transactionId:n,status:"committed",recovered:!0,results:Pe(l.results)};let m=await As(d,n,a,s,l);return await Ts(d,m.journal,p||m.recovered)}finally{await c()}}import Ps from"node:fs/promises";import Rs 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]="7be00b26-4a56-5399-94f6-f2f67cc5c1e6")}catch{}})();function yn(e){return Rs.join(e,"extension-migrations.json")}function di(e,t){let n=e.definition.id;return typeof n=="string"&&n.trim().length>0?n.trim():`migration-${String(t+1).padStart(3,"0")}`}function li(e,t){return`${e.layer}:${e.name}:${t}`}async function Ns(e){let t=yn(e);if(!await k(t))return{version:1,updated_at:"",entries:[]};let n=JSON.parse(await Ps.readFile(t,"utf8"));return{version:1,updated_at:typeof n.updated_at=="string"?n.updated_at:"",entries:Array.isArray(n.entries)?n.entries.filter(a=>typeof a?.key=="string"&&(a.status==="applied"||a.status==="failed")):[]}}async function Ds(e,t){let n=await Ns(e),a=new Map(n.entries.map(i=>[i.key,i]));return t.forEach((i,r)=>{let o=di(i,r),s=a.get(li(i,o));s&&(i.definition.status=s.status,s.status==="failed"?i.definition.reason=s.error:(delete i.definition.reason,delete i.definition.error,delete i.definition.message))}),n}async function js(e){let t=await Ds(e.pmRoot,e.migrations),n=new Map(t.entries.map(l=>[l.key,l])),a=[],i=!1,r=e.migrations.map((l,p)=>({migration:l,index:p})).filter(({migration:l})=>e.scope===void 0||l.layer===e.scope);for(let{migration:l,index:p}of r){let m=di(l,p),y=li(l,m),g=n.get(y),_=String(l.definition.status??"pending").toLowerCase(),u=g?.status??(_==="applied"||_==="failed"?_:"pending");if(u==="applied"){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"skipped"});continue}if(e.dryRun===!0){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"pending"});continue}let w=l.runtime_definition?.run??l.definition.run;if(typeof w!="function"){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"pending"});continue}let v=new Date().toISOString();try{await Promise.resolve(w({id:m,command:"migration",layer:l.layer,extension:l.name,pm_root:e.pmRoot,status:u}));let S={key:y,layer:l.layer,extension:l.name,id:m,status:"applied",attempted_at:v};n.set(y,S),l.definition.status="applied",delete l.definition.reason,delete l.definition.error,delete l.definition.message,a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"applied"}),i=!0}catch(S){let x=S instanceof Error?S.message:String(S),T={key:y,layer:l.layer,extension:l.name,id:m,status:"failed",attempted_at:v,error:x};n.set(y,T),l.definition.status="failed",l.definition.reason=x,a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"failed",error:x}),i=!0}}if(i){let l=await C(e.pmRoot),p={version:1,updated_at:new Date().toISOString(),entries:[...n.values()].sort((m,y)=>m.key.localeCompare(y.key))};await Ue({pmRoot:e.pmRoot,filePath:yn(e.pmRoot),raw:`${JSON.stringify(p,null,2)}
-`,op:"extension_migrations_apply",author:e.author,lockTtlSeconds:l.locks.ttl_seconds,lockWaitMs:l.locks.wait_ms})}let o=a.filter(l=>l.outcome==="pending").length,s=a.filter(l=>l.outcome==="applied").length,d=a.filter(l=>l.outcome==="skipped").length,c=a.filter(l=>l.outcome==="failed").length;return{ok:c===0,dry_run:e.dryRun===!0,state_path:yn(e.pmRoot),total:a.length,pending_count:o,applied_count:s,skipped_count:d,failed_count:c,migrations:a}}async function pi(e){let t=await C(e.resolvedRoots.settings_root),n=await _e({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),a=await we(n);e.warnings.push(...n.warnings,...a.warnings);let i=await js({pmRoot:e.resolvedRoots.pm_root,migrations:a.registrations.migrations,author:typeof e.global.author=="string"&&e.global.author.trim().length>0?e.global.author.trim():"pm-extension-migration",dryRun:e.options.dryRun===!0,...e.scope==="global"?{scope:"global"}:{}});return e.withResult({migration:i,load_failure_count:n.failed.length,activation_failure_count:a.failed.length},i.ok)}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="184c43e0-a543-5b0b-ac09-9139ba5ded6a")}catch{}})();var Ls=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function Ge(e,t={}){let n=new Set;t.extensionName!==void 0&&n.add(Et(t.extensionName));for(let u of t.extensionNames??[])n.add(Et(u));let a=u=>n.size===0||n.has(Et(u)),i=(u,w)=>mi(u.filter(v=>a(v.name)).map(w)),r=(u,w)=>mi(u.filter(v=>a(v.name)).flatMap(w)),{registrations:o,commands:s,parsers:d,preflight:c,services:l,renderers:p,hooks:m}=e,y=r(o.relationship_kinds??[],u=>u.definitions.map(w=>w.kind)),g=p.overrides.filter(u=>a(u.name)&&((u.commands?.length??0)>0||u.resultDiscriminator!==void 0)).map(u=>({format:u.format,commands:[...u.commands??[]],result_discriminator:u.resultDiscriminator!==void 0})).sort((u,w)=>u.format.localeCompare(w.format)),_=i(o.assurance_providers??[],u=>u.definition.id);return{capabilities:Ca(e,t),commands:i(o.commands,u=>u.command),command_overrides:i(s.overrides,u=>u.command),command_handlers:i(s.handlers,u=>u.command),hooks:Ls.filter(([u])=>m[u].some(w=>a(w.name))).map(([,u])=>u),flag_commands:i(o.flags,u=>u.target_command),item_types:r(o.item_types,u=>u.types.map(w=>w.name)),item_fields:r(o.item_fields,u=>u.fields.map(w=>w.name)),...y.length>0?{relationship_kinds:y}:{},migrations:r(o.migrations,u=>typeof u.definition.id=="string"?[u.definition.id]:[]),profiles:i(o.profiles,u=>u.profile.name),importers:i(o.importers,u=>u.importer),exporters:i(o.exporters,u=>u.exporter),search_providers:i(o.search_providers,u=>u.definition.name),vector_store_adapters:i(o.vector_store_adapters,u=>u.definition.name),..._.length>0?{assurance_providers:_}:{},parser_overrides:i(d.overrides,u=>u.command),service_overrides:i(l.overrides,u=>u.service),renderer_overrides:i(p.overrides,u=>u.format),...g.length>0?{renderer_ownership:g}:{},preflight_overrides:c.overrides.filter(u=>a(u.name)).length,preflight_ownership:c.overrides.filter(u=>a(u.name)).map(u=>({commands:[...u.commands??[]]}))}}function mi(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="caa9f916-c7ce-5e74-a00b-dd0fc6a41b5d")}catch{}})();var nt={type:"string",minLength:1,maxLength:128,pattern:"\\S"},Ct={type:"array",minItems:1,maxItems:sn,items:nt},ui={...Ct,items:{...nt,pattern:"^(?!(?:.*\\.)?(?:__proto__|constructor|prototype)(?:\\.|$))[a-zA-Z_][a-zA-Z0-9_]*(?:\\.[a-zA-Z_][a-zA-Z0-9_]*){0,7}$"}},Fs={type:"object",additionalProperties:!1,required:["id","rule"],properties:{id:{type:"string",minLength:1,maxLength:128,pattern:"^[a-zA-Z0-9][a-zA-Z0-9._-]*$"},description:{type:"string",minLength:1,maxLength:500,pattern:"\\S"},effect:{enum:["advise","warn","refuse"]},subject:{type:"object",additionalProperties:!1,properties:{...Object.fromEntries(["types","tags","statuses","operations","parents"].map(e=>[e,Ct])),dependency:{type:"object",additionalProperties:!1,required:["kind"],properties:{kind:nt,id:nt}}}},rule:{oneOf:[{type:"object",additionalProperties:!1,required:["kind","fields"],properties:{kind:{const:"require_fields"},fields:ui}},{type:"object",additionalProperties:!1,required:["kind","authors"],properties:{kind:{const:"authors"},authors:Ct}},...["field_writers","approval"].map(e=>({type:"object",additionalProperties:!1,required:["kind","fields","authors"],properties:{kind:{const:e},fields:ui,authors:Ct}})),{type:"object",additionalProperties:!1,required:["kind","allowed"],properties:{kind:{const:"transition"},allowed:{type:"array",maxItems:sn,items:{type:"array",minItems:2,maxItems:2,items:nt}}}}]}}},Tu={$schema:"https://json-schema.org/draft/2020-12/schema",title:"pm workflow policy registry",type:"object",additionalProperties:!1,required:["version","policies"],properties:{version:{const:1},enforcement:{enum:["advise","refuse"],default:"advise"},policies:{type:"array",maxItems:ya,items:Fs}}};(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="808f3bb5-cca5-5f9c-b557-7923c79ae6ce")}catch{}})();async function Ru(e,t,n,a){let i=await ke(e).catch(()=>null);return i===null?{check:{name:"completeness",status:"error",ok:!1,details:{policy_registry_readable:!1,policy_registry_path:"schema/policies.json",remediation_hint:"Repair schema/policies.json, then rerun pm validate."}},warnings:["validate_completeness_policy_registry_unreadable"]}:fi(i,t,n,a)}function Ms(e,t,n){return e===0?"undeclared":t===0?"empty":n===0?"inapplicable":n===t?"covered":"partial"}function fi(e,t,n=5,a=!1){let i=[],r=new Map,o=e.policies.filter(u=>u.rule.kind==="require_fields"),s=o.filter(u=>u.subject?.operations===void 0),d=new Set,c=0,l=0,p=0,m=0,y=0,g=va(e);for(let u of t){let w=g({operation:"",author:"",before:u,after:u,completeness_only:!0});c+=+(w.decisions.length>0),l+=w.decisions.length,w.decisions.forEach(x=>d.add(x.policy_id));let v=w.decisions.filter(x=>!x.satisfied);if(v.length===0)continue;m+=1;let S=r.get(u.type)??{items:0,violations:0,missing_fields:0};S.items+=1;for(let x of v)p+=1,S.violations+=1,S.missing_fields+=x.missing_fields.length,x.effect==="refuse"&&(y+=1),i.length<n&&i.push({id:u.id,type:u.type,status:u.status,decision:x});r.set(u.type,S)}let _=a||y>0?"error":p>0?"warn":"ok";return{check:{name:"completeness",status:_,ok:_==="ok",details:{scope:"operation_independent_require_fields",declared_requirement_count:o.length,state_requirement_count:s.length,applicable_requirement_count:d.size,requirement_application_count:l,governed_items:c,ungoverned_items:t.length-c,contract_status:Ms(o.length,t.length,c),applied_policy_ids:[...d].sort().slice(0,Math.max(0,n)),applied_policy_ids_truncated:d.size>Math.max(0,n),checked_items:t.length,incomplete_items:m,violation_count:p,refused_violations:y,missing_by_type:Object.fromEntries(r),violations:i,violations_truncated:i.length<p,enforcement:e.enforcement}},warnings:[...p>0?[`validate_completeness_missing_fields:${p}`]:[],...a?["validate_completeness_source_incomplete"]:[]]}}import Us 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]="0c3bed4d-4a17-5004-a1c5-65f6acec2a9b")}catch{}})();function zs(){return{version:1,enforcement:"advise",policies:[...[["Epic",["goal","objective","body"]],["Story",["description","value","acceptance_criteria"]],["Decision",["body","resolution"]],["Feature",["acceptance_criteria","expected_result"]],["Task",["description"]],["Issue",["repro_steps","expected_result"]],["Chore",["description"]]].map(([e,t])=>({id:`completeness-${e.toLowerCase()}`,effect:"advise",description:`Evidence expected when ${e} work reaches completion.`,subject:{types:[e],statuses:["closed"]},rule:{kind:"require_fields",fields:[...t]}})),{id:"completeness-resolution",effect:"advise",subject:{statuses:["closed"]},rule:{kind:"require_fields",fields:["resolution","expected_result","actual_result"]}}]}}function yi(e){let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{throw new f("Policy definition must be valid JSON.",h.USAGE)}if(typeof t!="object"||t===null||Array.isArray(t))throw new f("Policy definition must be an object.",h.USAGE);return t}async function Gs(e,t){let n=F(process.cwd(),e.path);await Me(n);let a=await C(n);return{pmRoot:n,settings:a,author:K(t,a.author_default)}}function hi(e,t,n,a){if(e==="policy-mode")return dn({...n,enforcement:t});let i=n.policies.filter(s=>s.id!==t);if(e==="policy-remove")return{...n,policies:i};let r=cn(a.definition),o=dn({...n,policies:[...i,r].sort((s,d)=>s.id.localeCompare(d.id))});if(Buffer.byteLength(`${JSON.stringify(o,null,2)}
-`)>Fa)throw new f("Policy registry exceeds its byte ceiling.",h.USAGE);return o}async function gi(e,t,n,a){if(n.dryRun)return{policy_result:!0,action:e,changed:!1,result:hi(e,t,await ke(a.pmRoot),n)};let i=await La({pmRoot:a.pmRoot,filePath:Us.join(a.pmRoot,"schema","policies.json"),op:`schema:${e}`,author:a.author,message:n.message,lockTtlSeconds:a.settings.locks.ttl_seconds,lockWaitMs:a.settings.locks.wait_ms,mutate(r){let o=hi(e,t,Ma(r),n);return{raw:`${JSON.stringify(o,null,2)}
-`,result:o}}});return{policy_result:!0,action:e,changed:i.changed,result:i.result}}async function Js(e,t,n){let a,i=await qa({...n,id:e,op:"policy_approve",message:t.message,resolveHistoryContext:()=>({workflow_approval:a}),async mutate(r){let o=(await ke(n.pmRoot)).policies.find(s=>s.id===t.policy);if(!o||o.rule.kind!=="approval")throw new f("--policy must name an approval rule.",h.USAGE);if(!o.rule.authors.includes(n.author))throw new f("This actor is not a declared approver.",h.CONFLICT);return await Ua(n.pmRoot,r.metadata.id),a={policy_id:o.id,policy_fingerprint:_a(o),content_fingerprint:wa(o,{...r.metadata,body:r.body})},{changedFields:[]}}});return{policy_result:!0,action:"policy-approve",changed:!0,result:{id:i.item.id,...a,warnings:i.warnings}}}function qs(e,t){let n=yi(t),a=cn({...n,id:n.id===void 0?e:n.id});if(e!==void 0&&e.trim()!==a.id)throw new f("Policy id operand does not match definition.id.",h.USAGE,{required:"Use the same policy id operand and definition.id, or supply only one of them.",nextSteps:["Omit the policy id operand to use definition.id, or omit definition.id to use the operand."]});return a}async function Yu(e,t,n={},a={}){if(!xt.includes(e))throw new f("Unknown workflow policy action.",h.USAGE);if(e==="policy-presets")return{policy_result:!0,action:e,changed:!1,result:zs()};let i=await Gs(a,n.author);if(e==="policies")return{policy_result:!0,action:e,changed:!1,result:await ke(i.pmRoot)};if(e==="policy-put"){let l=qs(t,n.definition);return gi(e,l.id,{...n,definition:l},i)}if(!t?.trim())throw new f(`schema ${e} requires an operand.`,h.USAGE);if(["policy-remove","policy-mode"].includes(e))return gi(e,t,n,i);if(e==="policy-approve"){if(n.dryRun)throw new f("Use policy-check to preview; policy-approve records an approval.",h.USAGE);return Js(t,n,i)}let r=q(i.settings,J()),o=await It(i.pmRoot,t,i.settings.id_prefix,i.settings.item_format,r.type_to_folder);if(!o)throw new f(`Item ${t} not found.`,h.NOT_FOUND);let{document:s}=await At(o,{schema:i.settings.schema}),d={...s.metadata,body:s.body},c=n.definition===void 0?d:{...d,...yi(n.definition)};if(c.id!==d.id)throw new f("Policy preview cannot change the item id.",h.USAGE);return{policy_result:!0,action:e,changed:!1,result:await za(i.pmRoot,await ke(i.pmRoot),{operation:"update",author:i.author,before:d,after:c,completeness_only:n.definition===void 0})}}import{createHash as Ci}from"node:crypto";import Ne from"node:fs/promises";import Ke 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]="68be16cc-4cb4-5df6-90f0-897d4fe82339")}catch{}})();var Ws=new Set(rn),Bs=new Set(on),_i=new Set([...da.filter(e=>e!=="severity"),"id","title","type","status","priority","tags","assignee","parent","description","body","created_at","updated_at","closed_at","completed_at","author","deadline","estimate","sprint","release","risk","confidence","reviewer","resolution","expected","actual"]),Hs=["create","update"];function ki(e){if(typeof e!="string")return"";let t=e.trim().toLowerCase().replaceAll(/[\s_]+/g,"-");return t.startsWith("--")?t.slice(2):t}function wi(e){return e.replaceAll("_","-")}function Ks(e,t){let n=new Set;for(let a of e){let i=ki(a);i.length>0&&i!==t&&n.add(i)}return[...n].sort((a,i)=>a.localeCompare(i))}function Vs(e){let t=new Set;for(let n of e??[]){let a=n.trim();a.length>0&&t.add(a)}return[...t].sort((n,a)=>n.localeCompare(a))}function Ys(e){let t=new Set,n=[];for(let a of e??[]){let i=a.trim().toLowerCase();if(i.length!==0){if(!Bs.has(i))throw new Error(`Invalid field command "${a}". Allowed: ${on.join(", ")}.`);t.has(i)||(t.add(i),n.push(i))}}return e===void 0||n.length===0?[...Hs]:n}function xi(e){let t=I(e.key);if(t.length===0)throw new Error("Field key must not be empty.");if(_i.has(t))throw new Error(`Cannot define custom field "${t}": custom schema field "${t}" collides with built-in item metadata "${t}". Rename the custom field with a project-specific prefix. Reserved fields: ${[..._i].sort((l,p)=>l.localeCompare(p)).join(", ")}.`);let n=typeof e.type=="string"&&e.type.trim().length>0?e.type.trim().toLowerCase():"string";if(!Ws.has(n))throw new Error(`Invalid field type "${e.type}". Allowed: ${rn.join(", ")}.`);let a=n,i=Ys(e.commands),r=ki(e.cliFlag),o=r.length>0&&r!==wi(t)?r:void 0,s=o??wi(t),d=Ks(e.aliases??[],s),c=e.description?.trim();return{key:t,type:a,commands:i,description:c&&c.length>0?c:void 0,cliFlag:o,cliAliases:d,required:e.required===!0,requiredOnCreate:e.requiredOnCreate===!0,allowUnset:e.allowUnset!==!1,requiredTypes:Vs(e.requiredTypes)}}function Xs(e){if(Array.isArray(e))return e;if(typeof e!="object"||e===null)return;let t=e;if(Array.isArray(t.fields))return t.fields;if(Array.isArray(t.definitions))return t.definitions}function Zs(e){let t=Xs(e);if(!t)return[];let n=[];for(let a of t){if(typeof a!="object"||a===null||Array.isArray(a))continue;let i=a;typeof i.key!="string"||i.key.trim().length===0||n.push(i)}return n}function Je(e){if(e==null||e.trim().length===0)return{fields:[]};let t;try{t=JSON.parse(e)}catch{throw new Error("schema/fields.json contains invalid JSON.")}return{fields:Zs(t)}}function qe(e){return`${JSON.stringify({fields:e.fields},null,2)}
-`}function Si(e,t){let n=e.fields.find(o=>I(o.key)===t.key),a=n!==void 0,i=e.fields.filter(o=>I(o.key)!==t.key),r={...n,key:t.key,type:t.type,commands:[...t.commands]};return vi(r,"description",t.description),vi(r,"cli_flag",t.cliFlag),t.cliAliases.length>0?r.cli_aliases=[...t.cliAliases]:delete r.cli_aliases,bi(r,"required",t.required),bi(r,"required_on_create",t.requiredOnCreate),t.allowUnset===!1?r.allow_unset=!1:delete r.allow_unset,t.requiredTypes.length>0?r.required_types=[...t.requiredTypes]:delete r.required_types,i.push(r),i.sort((o,s)=>I(o.key).localeCompare(I(s.key))),{file:{fields:i},definition:r,replaced:a}}function Ei(e,t){let n=I(t);if(n.length===0)throw new Error("Field key must not be empty.");let a=[],i=e.fields.filter(r=>I(r.key)===n?(a.push(r),!1):!0);return a.length===0?{file:{fields:i},removed:!1}:{file:{fields:i},removed:!0,definition:a[0]}}function vi(e,t,n){let a=e;n!==void 0&&n.length>0?a[t]=n:delete a[t]}function bi(e,t,n){let a=e;n?a[t]=!0:delete a[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]="b1e4c04e-0ade-5d24-95e3-b8dca3832c5a")}catch{}})();var Qs=new Set(kt),Re=new Set(Na.map(e=>I(e.id)).filter(e=>e.length>0));function ec(e){let t=new Set;for(let n of e){let a=I(n);a.length>0&&t.add(a)}return[...t].sort((n,a)=>n.localeCompare(a))}function $i(e){let t=I(e.id);if(t.length===0)throw new Error("Status id must not be empty.");if(Re.has(t))throw new Error(`Cannot add-status the built-in status "${t}". Built-in statuses are reserved: ${[...Re].join(", ")}.`);let n;if(e.roles!==void 0){n=[];let o=new Set;for(let s of e.roles){let d=typeof s=="string"?s.trim().toLowerCase():"";if(d.length!==0){if(!Qs.has(d))throw new Error(`Invalid status role "${s}". Allowed roles: ${kt.join(", ")}.`);o.has(d)||(o.add(d),n.push(d))}}if(n.length===0)throw new Error(`Status role must include at least one lifecycle role. Allowed roles: ${kt.join(", ")}.`)}let a=e.aliases===void 0?void 0:ec(e.aliases).filter(o=>o!==t),i=e.description?.trim(),r=typeof e.order=="number"&&Number.isFinite(e.order)?Math.trunc(e.order):void 0;return{id:t,roles:n,aliases:a,description:i&&i.length>0?i:void 0,order:r}}function tc(e){if(Array.isArray(e))return e;if(typeof e!="object"||e===null)return;let t=e;if(Array.isArray(t.statuses))return t.statuses;if(Array.isArray(t.definitions))return t.definitions}function nc(e){let t=tc(e);if(!t)return[];let n=[];for(let a of t){if(typeof a!="object"||a===null||Array.isArray(a))continue;let i=a;typeof i.id!="string"||i.id.trim().length===0||n.push(i)}return n}function We(e){if(e==null||e.trim().length===0)return{statuses:[]};let t;try{t=JSON.parse(e)}catch{throw new Error("schema/statuses.json contains invalid JSON.")}return{statuses:nc(t)}}function Be(e){return`${JSON.stringify({statuses:e.statuses},null,2)}
-`}function Ii(e,t,n){let a=e.statuses.slice(),i=a.findIndex(s=>I(s.id)===t.id),r=i>=0?a[i]:n,o={...r,id:t.id};return t.roles!==void 0&&(t.roles.length>0?o.roles=[...t.roles]:o.roles!==void 0&&delete o.roles),t.aliases!==void 0&&(t.aliases.length>0?o.aliases=[...t.aliases]:o.aliases!==void 0&&delete o.aliases),t.description!==void 0&&(o.description=t.description),t.order!==void 0&&(o.order=t.order),i>=0?a[i]=o:a.push(o),{file:{statuses:a},definition:o,replaced:r!==void 0}}function Ai(e,t){let n=I(t);if(n.length===0)throw new Error("Status id must not be empty.");if(Re.has(n))throw new Error(`Cannot remove built-in status "${n}". Built-in statuses are reserved: ${[...Re].join(", ")}.`);let a=e.statuses.slice(),i=a.findIndex(o=>I(o.id)===n);if(i<0)return{file:{statuses:a},removed:!1};let[r]=a.splice(i,1);return{file:{statuses:a},removed:!0,definition:r}}function _n(e,t){let n=[e.id,...e.aliases??[]];for(let a of n){let i=I(a);if(i.length===0)continue;let r=t.get(i);if(r!==void 0&&r!==e.id)throw new Error(`Status token "${i}" already belongs to status "${r}". Choose a different id/alias to avoid shadowing it.`)}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="8d04c087-62e4-51d3-8832-6cbcfd3ed993")}catch{}})();function ue(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Schema migration ${t} must be non-empty`);return e.trim()}function Pi(e){let t=ue(e,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(t))throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");return t}function Ri(e,t){let n=vn(e),a=ue(t,"migrationScope");return`auto-${Ci("sha256").update(JSON.stringify({scope:a,request:n})).digest("hex").slice(0,20)}`}function vn(e){let t=e.kind==="rename-type"?{kind:e.kind,from:ue(e.from,"source"),to:ue(e.to,"target")}:e.kind==="rename-field"?{kind:e.kind,from:I(ue(e.from,"source")),to:I(ue(e.to,"target")),...e.type===void 0?{}:{type:ue(e.type,"type")}}:{kind:e.kind,from:I(ue(e.from,"source")),to:I(ue(e.to,"target"))};if(t.from.toLowerCase()===t.to.toLowerCase())throw new TypeError("Schema migration source and target must differ");return t}function ac(e){return e.kind==="rename-type"?"types":e.kind==="rename-field"?"fields":"statuses"}function ic(e,t,n){let a=H(t.schema),i=ac(n);return ee(e,a.files[i],V[i])}function Ni(e,t){return Ke.join(e,"transactions","schema",`${t}-plan.json`)}function Pt(e){return e.length===0?null:JSON.parse(e)}async function He(e){let t=await G(e);return{exists:t!==null,raw:t??""}}async function Di(e,t){t.exists?await le(e,t.raw):await Ne.rm(e,{force:!0})}function rc(e,t,n){let a=ae(e),i=a.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.from.toLowerCase()),r=a.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.to.toLowerCase());if(n==="stage"){if(r>=0)return re(a);if(i<0)throw new TypeError(`Unknown custom type "${t.from}".`);a.definitions.push({...a.definitions[i],name:t.to})}else i>=0&&a.definitions.splice(i,1);return re(a)}function oc(e,t,n){let a=Je(e),i=a.fields.findIndex(o=>o.key===t.from),r=a.fields.findIndex(o=>o.key===t.to);if(n==="stage"){if(r>=0)return qe(a);if(i<0)throw new TypeError(`Unknown custom field "${t.from}".`);let o=a.fields[i];a.fields.push({...o,key:t.to,metadata_key:t.to,front_matter_key:t.to,cli_flag:t.to.replaceAll("_","-")})}else i>=0&&a.fields.splice(i,1);return qe(a)}function sc(e,t,n){let a=We(e),i=a.statuses.findIndex(o=>o.id===t.from),r=a.statuses.findIndex(o=>o.id===t.to);if(n==="stage"){if(r>=0)return Be(a);if(i<0)throw new TypeError(`Unknown custom status "${t.from}".`);a.statuses.push({...a.statuses[i],id:t.to})}else i>=0&&a.statuses.splice(i,1);return Be(a)}function cc(e,t,n){return t.kind==="rename-type"?rc(e,t,n):t.kind==="rename-field"?oc(e,t,n):sc(e,t,n)}function Se(e,t){return typeof e=="string"&&e.trim().toLowerCase()===t.from.toLowerCase()?t.to:e}function bn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function Ve(e){return Array.isArray(e)?e.map(t=>bn(t)).filter(t=>t!==void 0):[]}function dc(e,t){for(let n of Ve(e.fields))Array.isArray(n.required_types)&&(n.required_types=n.required_types.map(a=>Se(a,t)));for(let n of Ve(e.type_workflows))n.type=Se(n.type,t)}function lc(e,t){for(let a of Ve(e.definitions))a.default_status=Se(a.default_status,t);let n=bn(e.workflow);if(n)for(let[a,i]of Object.entries(n))n[a]=Se(i,t);for(let a of Ve(e.type_workflows))Array.isArray(a.allowed_transitions)&&(a.allowed_transitions=a.allowed_transitions.map(i=>Array.isArray(i)?i.map(r=>Se(r,t)):i))}function pc(e,t){for(let n of Ve(e.definitions)){for(let a of["required_create_fields","required_create_repeatables"])Array.isArray(n[a])&&(n[a]=n[a].map(i=>Se(i,t)));for(let a of["options","command_option_policies"])for(let i of Ve(n[a])){let r=a==="options"?"key":"option";i[r]=Se(i[r],t)}}}function mc(e,t){let n=bn(e.options);if(!n)return;if(t.kind==="rename-field"){if(!Object.prototype.hasOwnProperty.call(n,t.from))return;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision in saved template "${String(e.name??"unknown")}": target field "${t.to}" already exists.`);n[t.to]=n[t.from],delete n[t.from];return}let a=t.kind==="rename-type"?"type":"status";n[a]=Se(n[a],t)}function wn(e,t){let n=JSON.parse(e);if(typeof n!="object"||n===null||Array.isArray(n))return e;let a=n;return t.kind==="rename-type"?dc(a,t):t.kind==="rename-field"?pc(a,t):lc(a,t),mc(a,t),`${JSON.stringify(a,null,2)}
-`}function ji(e,t){if(t.kind==="rename-type"){let a=ae(e).definitions;return{source:a.some(i=>i.name.trim().toLowerCase()===t.from.toLowerCase()),target:a.some(i=>i.name.trim().toLowerCase()===t.to.toLowerCase())}}if(t.kind==="rename-field"){let a=Je(e).fields;return{source:a.some(i=>i.key===t.from),target:a.some(i=>i.key===t.to)}}let n=We(e).statuses;return{source:n.some(a=>a.id===t.from),target:n.some(a=>a.id===t.to)}}function uc(e,t){let n=e;return t.kind==="rename-type"?e.type.toLowerCase()===t.to.toLowerCase()?[]:["type"]:t.kind==="remap-status"?e.status.toLowerCase()===t.to.toLowerCase()?[]:["status"]:Object.prototype.hasOwnProperty.call(n,t.to)&&!Object.prototype.hasOwnProperty.call(n,t.from)?[]:[t.from,t.to]}function fc(e,t){if(t.kind==="rename-type")return e.type.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"type",before:e.type,after:t.to}]}:null;if(t.kind==="remap-status")return e.status.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"status",before:e.status,after:t.to}]}:null;if(t.type!==void 0&&e.type.toLowerCase()!==t.type.toLowerCase())return null;let n=e;if(!Object.prototype.hasOwnProperty.call(n,t.from))return null;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision on item "${e.id}": target field "${t.to}" already exists.`);return{id:e.id,changes:[{field:t.from,before:n[t.from],after:void 0},{field:t.to,before:void 0,after:n[t.from]}]}}function Li(e,t){let n=vn(t.request),a=t.migrationId===void 0?Ri(n,t.migrationScope??"plan"):Pi(t.migrationId),i=e.map(d=>fc(d,n)).filter(d=>d!==null).sort((d,c)=>d.id.localeCompare(c.id)),r=Ci("sha256").update(JSON.stringify({migrationId:a,request:n,items:i})).digest("hex"),o=new Set([...t.completedItemIds??[]].map(d=>d.trim()).filter(d=>d.length>0)),s=i.filter(d=>!o.has(d.id));return Object.freeze({migration_id:a,request:n,fingerprint:r,affected_item_count:i.length,pending_item_count:s.length,skipped_completed_count:i.length-s.length,items:Object.freeze(s)})}async function hc(e){let t=q(e.settings,J()),n=[...new Set(Object.values(t.type_to_folder))],a=await Ja(e.pmRoot,n),i=e.request.kind==="rename-type"?{types:[e.request.from]}:e.request.kind==="remap-status"?{statuses:[e.request.from]}:{metadataKeys:[e.request.from],...e.request.type===void 0?{}:{types:[e.request.type]}},r=a?await Ga({pmRoot:e.pmRoot,expectedSourceCursor:a.source_cursor,query:i}):null;return r?{items:r.items,selectionSource:"derived_index",typeToFolder:t.type_to_folder}:{items:await Oe(e.pmRoot,e.settings.item_format,t.type_to_folder,[],e.settings.schema),selectionSource:"scan",typeToFolder:t.type_to_folder}}async function gc(e,t){let n=await G(Ni(e,t));if(n===null)return null;try{let a=JSON.parse(n);if(a.schema_version!==1||a.plan.migration_id!==t||!Array.isArray(a.plan.items))throw new TypeError("invalid plan envelope");return a.plan}catch(a){throw new f(`Stored schema migration plan "${t}" is invalid: ${pa(a)}`,h.GENERIC_FAILURE)}}async function yc(e,t){let n=Ni(e,t.migration_id);await Ne.mkdir(Ke.dirname(n),{recursive:!0});let a={schema_version:1,plan:t,created_at:new Date().toISOString()};await le(n,`${JSON.stringify(a,null,2)}
-`)}function _c(e,t){return JSON.stringify(e)===JSON.stringify(t)}async function wc(e){let t=await It(e.pmRoot,e.id,e.settings.id_prefix,e.settings.item_format,e.typeToFolder);if(!t)throw new f(`Schema migration item "${e.id}" no longer exists.`,h.NOT_FOUND);return(await At(t,{schema:e.settings.schema})).document.metadata}function Ti(e,t,n){let a=n==="forward"?t.from:t.to,i=n==="forward"?t.to:t.from;if(t.kind==="rename-type"){if(e.metadata.type.toLowerCase()===i.toLowerCase())return[];if(e.metadata.type.toLowerCase()!==a.toLowerCase())throw new TypeError(`Schema migration expected type "${a}" on item "${e.metadata.id}".`);return e.metadata.type=i,["type"]}if(t.kind==="remap-status"){if(e.metadata.status.toLowerCase()===i.toLowerCase())return[];if(e.metadata.status.toLowerCase()!==a.toLowerCase())throw new TypeError(`Schema migration expected status "${a}" on item "${e.metadata.id}".`);return e.metadata.status=i,["status"]}let r=e.metadata;if(Object.prototype.hasOwnProperty.call(r,i)&&!Object.prototype.hasOwnProperty.call(r,a))return[];if(!Object.prototype.hasOwnProperty.call(r,a)||Object.prototype.hasOwnProperty.call(r,i))throw new TypeError(`Schema migration field state changed concurrently on item "${e.metadata.id}".`);return r[i]=r[a],delete r[a],[a,i]}function Oi(e){return{id:e.id,inspect:async()=>{let t=await He(e.filePath),n=ji(t.raw,e.request),a=e.phase==="stage"?n.source&&n.target:!n.source&&n.target;return{state:a?"applied":"pending",...a?{result:{phase:e.phase}}:{}}},prepareCompensation:async()=>{let t=await He(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await He(e.filePath);return await le(e.filePath,cc(t.raw,e.request,e.phase)),{phase:e.phase}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema snapshot for ${e.id} compensation.`);await Di(e.filePath,{exists:t.exists,raw:t.raw})}}}function vc(e){return{id:e.stepId,inspect:async()=>{let t=await He(e.filePath);return{state:wn(t.raw,e.request)===t.raw?"applied":"pending"}},prepareCompensation:async()=>{let t=await He(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await He(e.filePath);return await le(e.filePath,wn(t.raw,e.request)),{file:e.filePath}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema reference snapshot for ${e.stepId} compensation.`);await Di(e.filePath,{exists:t.exists,raw:t.raw})}}}function bc(e){return{id:`item-${e.id}`,inspect:async()=>{let t=await C(e.pmRoot),n=q(t,J()).type_to_folder,a=await wc({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id}),i=uc(a,e.request).length===0;return{state:i?"applied":"pending",...i?{result:{item_id:e.id}}:{}}},apply:async()=>{let t=await C(e.pmRoot),n=q(t,J()).type_to_folder,a=await mn({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}`,author:e.author,message:`Schema migration ${e.request.kind}: ${e.request.from} -> ${e.request.to}`,force:e.force,skipNoop:!0,mutate(i){return{changedFields:Ti(i,e.request,"forward")}}});return{item_id:e.id,changed_fields:a.changedFields}},compensate:async()=>{let t=await C(e.pmRoot),n=q(t,J()).type_to_folder;await mn({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}_compensate`,author:e.author,message:`Compensate schema migration ${e.request.kind}: ${e.request.to} -> ${e.request.from}`,force:!0,skipNoop:!0,mutate(a){return{changedFields:Ti(a,e.request,"reverse")}}})}}}async function kc(e){let t=await gc(e.pmRoot,e.migrationId);if(t){if(!_c(t.request,e.request))throw new f(`Schema migration id "${e.migrationId}" already belongs to a different request.`,h.CONFLICT);return{plan:t,stored:!0}}let n=await hc({pmRoot:e.pmRoot,settings:e.settings,request:e.request});return{plan:{...Li(n.items,{migrationId:e.migrationId,request:e.request}),selection_source:n.selectionSource},stored:!1}}async function xc(e){let t=ji(await G(e.schemaPath)??"",e.request);if(!t.source)throw new f(`Schema migration source "${e.request.from}" is not a custom definition.`,h.NOT_FOUND);if(t.target)throw new f(`Schema migration target "${e.request.to}" already exists.`,h.CONFLICT);await yc(e.pmRoot,e.plan)}async function Sc(e){let t=H(e.settings.schema),n=[...new Set([["types",V.types],["fields",V.fields],["workflows",V.workflows]].map(([i,r])=>ee(e.pmRoot,t.files[i],r)).filter(i=>i!==e.schemaPath))];try{let i=Ke.join(e.pmRoot,"templates"),r=await Ne.readdir(i,{withFileTypes:!0});n.push(...r.filter(o=>o.isFile()&&o.name.toLowerCase().endsWith(".json")).map(o=>Ke.join(i,o.name)))}catch(i){if(typeof i!="object"||i===null||!("code"in i)||!ge(i))throw i}n.sort((i,r)=>i.localeCompare(r));let a=[];for(let i of n){let r=await G(i);r!==null&&wn(r,e.request)!==r&&a.push({filePath:i,beforeRaw:r})}return{paths:n,snapshots:a}}async function Ec(e){for(let t of e.snapshots){let n=await Ne.readFile(t.filePath,"utf8"),a=Ke.relative(e.pmRoot,t.filePath).replaceAll("\\","/");await pn({pmRoot:e.pmRoot,author:e.author,documentPath:a,before:Pt(t.beforeRaw),after:Pt(n),op:"schema_migration_reference",idempotencyKey:`${e.plan.migration_id}:${e.plan.fingerprint}:${a}`,message:`${e.request.kind}: ${e.request.from} -> ${e.request.to}`,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}}async function $c(e,t,n){let a=vn(e),i=F(process.cwd(),n.path);await Me(i);let r=t.migrationId===void 0?Ri(a,await Ne.realpath(i)):Pi(t.migrationId),o=await C(i),s=K(t.author,o.author_default),d=await kc({pmRoot:i,settings:o,migrationId:r,request:a}),c=d.plan;if(t.dryRun===!0)return{...c,action:a.kind,applied:!1,recovered:!1,migrated_item_count:0};let l=ic(i,o,a),p=await Ne.readFile(l,"utf8");d.stored||await xc({pmRoot:i,schemaPath:l,request:a,plan:c});let m=await Sc({pmRoot:i,schemaPath:l,settings:o,request:a}),y=[Oi({id:"stage-schema",filePath:l,request:a,phase:"stage"}),...m.paths.map((w,v)=>vc({filePath:w,request:a,stepId:`reference-${String(v+1).padStart(4,"0")}`})),...c.items.map(w=>bc({pmRoot:i,id:w.id,request:a,author:s,force:t.force===!0})),Oi({id:"retire-source",filePath:l,request:a,phase:"retire"})],g=await ci({pmRoot:i,transactionId:`schema-${r}`,author:s,steps:y,lockTtlSeconds:Math.max(o.locks.ttl_seconds,300),lockWaitMs:o.locks.wait_ms}),_=await Ne.readFile(l,"utf8"),{historyPath:u}=await pn({pmRoot:i,author:s,documentPath:Ke.relative(i,l).replaceAll("\\","/"),before:Pt(p),after:Pt(_),op:"schema_migration",idempotencyKey:`${c.migration_id}:${c.fingerprint}`,message:`${a.kind}: ${a.from} -> ${a.to}; affected=${c.affected_item_count}`,lockTtlSeconds:o.locks.ttl_seconds,lockWaitMs:o.locks.wait_ms});return await Ec({pmRoot:i,author:s,settings:o,request:a,plan:c,snapshots:m.snapshots}),{...c,action:a.kind,applied:!0,recovered:g.recovered,migrated_item_count:c.affected_item_count,workspace_history_path:u}}function Ic(e){let t=e.applied?"applied":"dry-run",n=e.recovered?" (recovered)":"";return[`${e.action}: ${e.request.from} -> ${e.request.to} [${t}${n}]`,`migration_id: ${e.migration_id}`,`affected: ${e.affected_item_count}`,`pending: ${e.pending_item_count}`,`fingerprint: ${e.fingerprint}`].join(`
-`)}import Ui from"node:fs/promises";import De from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="74b72dd8-0877-55a4-9c80-d043f19e1f96")}catch{}})();var Rt=["extensions","docs","examples","assets","prompts"],Ac=Object.freeze({extensions:Object.freeze([".agents/pm/extensions","extensions",".custom/pm-extensions",".custom/pm-extension"]),docs:Object.freeze(["docs","documentation"]),examples:Object.freeze(["examples","docs/examples"]),assets:Object.freeze(["assets",".agents/pm/assets"]),prompts:Object.freeze(["prompts",".agents/pm/prompts"])});function Tc(e){return Rt.includes(e)}function Oc(e,t){if(t==null)return[];let n=Array.isArray(t)?t:[t],a=[];for(let i of n){if(typeof i!="string"||i.trim().length===0)throw new f(`Package manifest field pm.${e} must contain string paths.`,h.USAGE);a.push(i.trim())}return[...new Set(a)].sort((i,r)=>i.localeCompare(r))}function Cc(e){if(e==null)return{};if(typeof e!="object"||Array.isArray(e))throw new f("Package manifest field pm must be an object.",h.USAGE);let t={},n=e;for(let[a,i]of Object.entries(n)){if(!Tc(a))continue;let r=Oc(a,i);r.length>0&&(t[a]=r)}return t}function oe(e,t){let n=e[t];return typeof n=="string"&&n.trim().length>0?n.trim():void 0}function kn(e){if(!Array.isArray(e))return;let t=e.map(n=>typeof n=="string"?n.trim():"").filter(n=>n.length>0);return t.length>0?[...new Set(t)].sort((n,a)=>n.localeCompare(a)):void 0}function Fi(e){if(typeof e=="string"&&e.trim().length>0)return e.trim();if(typeof e=="object"&&e!==null&&!Array.isArray(e)){let t=e.url;return typeof t=="string"&&t.trim().length>0?t.trim():void 0}}function Pc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={docs:oe(t,"docs"),npm:oe(t,"npm"),repository:oe(t,"repository"),report:oe(t,"report")};return Object.values(n).some(a=>typeof a=="string")?n:void 0}function Rc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={image:oe(t,"image"),video:oe(t,"video")};return Object.values(n).some(a=>typeof a=="string")?n:void 0}function Nc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={display_name:oe(t,"display_name")??oe(t,"displayName"),category:oe(t,"category"),summary:oe(t,"summary"),links:Pc(t.links),media:Rc(t.media),tags:kn(t.tags)};return Object.values(n).some(a=>a!==void 0)?n:void 0}async function at(e){let t=De.join(e,"package.json");if(!await k(t))return{source:"convention",resources:{}};let n;try{n=JSON.parse(await Ui.readFile(t,"utf8"))}catch(s){throw new f(`Failed to parse package manifest at "${t}": ${String(s)}`,h.USAGE)}if(typeof n!="object"||n===null||Array.isArray(n))throw new f(`Package manifest at "${t}" must be a JSON object.`,h.USAGE);let a=n,i=a.pm,r=i!=null,o=typeof i=="object"&&i!==null&&!Array.isArray(i)?i:{};return{source:r?"pm":"convention",package_json_path:t,package_name:typeof a.name=="string"?a.name:void 0,package_version:typeof a.version=="string"?a.version:void 0,package_private:a.private===!0,package_description:typeof a.description=="string"?a.description:void 0,package_keywords:kn(a.keywords),package_homepage:typeof a.homepage=="string"?a.homepage:void 0,package_repository_url:Fi(a.repository),package_bugs_url:Fi(a.bugs),aliases:kn(o.aliases),resources:Cc(i),catalog:Nc(o.catalog)}}async function Mi(e){if(!await k(e))return[];let t=await Ui.readdir(e,{withFileTypes:!0}),n=[];for(let a of t){if(!a.isDirectory())continue;let i=De.join(e,a.name);await k(De.join(i,"manifest.json"))&&n.push(i)}return n.sort((a,i)=>a.localeCompare(i))}async function Nt(e){if(await k(De.join(e,"manifest.json")))return[e];let t=(await at(e)).resources.extensions??[],n=new Set;for(let a of t){if(a.includes("*")||a.startsWith("!"))throw new f(`Package extension entry "${a}" uses a glob/exclusion pattern. pm package installs currently require concrete extension paths or directories.`,h.USAGE);let i=De.resolve(e,a);if(!B(e,i))throw new f(`Package extension entry "${a}" resolves outside package root.`,h.USAGE);if(await k(De.join(i,"manifest.json"))){n.add(i);continue}for(let r of await Mi(i))n.add(r)}if(t.length===0)for(let a of Ac.extensions)for(let i of await Mi(De.join(e,a)))n.add(i);return[...n].sort((a,i)=>a.localeCompare(i))}import{execFile as td}from"node:child_process";import P from"node:fs/promises";import Cn from"node:os";import $ from"node:path";import{fileURLToPath as nd}from"node:url";import{promisify as ad}from"node:util";import id from"npm-package-arg";import{extract as rd,list as od}from"tar";import Wc from"node:fs/promises";import ie from"node:path";import zi from"node:fs/promises";import xn from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="9cf5a9e7-4a66-5e72-80a2-f8a9b5b6e412")}catch{}})();function Z(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function b(e){return e.trim().toLowerCase()}function Dt(e){let t=e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-"),n=0;for(;t[n]==="-";)n+=1;let a=t.length;for(;a>n&&t[a-1]==="-";)a-=1;let i=t.slice(n,a);if(i.length===0)throw new f("Extension manifest name must resolve to a non-empty directory name.",h.USAGE);if(i==="."||i==="..")throw new f('Extension manifest name must not resolve to "." or "..".',h.USAGE);return i}function Sn(e){return Ia(e)}async function Dc(e){try{let t=JSON.parse(await zi.readFile(xn.join(e,"package.json"),"utf8")),n=typeof t.name=="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(t.name)?t.name:void 0;return{...n?{package_name:n}:{},has_build_script:["build","prepare","prepack"].some(a=>typeof t.scripts?.[a]=="string")}}catch{return{has_build_script:!1}}}async function jc(e,t,n){if(n.source_kind!=="github"||typeof n.source_root!="string")return new f(`Extension entry file is missing at "${t}".`,h.USAGE);let a=await Dc(n.source_root),i=a.package_name?`pm package install npm:${a.package_name}`:void 0,r=n.source_input??n.source_root;return new f(`Extension entry "${e.entry}" is absent from GitHub source "${r}". pm package install copies GitHub repositories without running package scripts${a.has_build_script?", and this package declares a build or publish script":""}. ${i?`Try "${i}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,h.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:i?[i,`pm package install ${n.source_root}`]:[`pm package install ${n.source_root}`],nextSteps:i?[`Retry with ${i}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm package install npm:<package-name>."],recovery:{attempted_command:`pm install ${r}`,normalized_args:["install",r],...i?{next_best_command:i}:{}}})}async function Ye(e,t={}){let n=xn.join(e,"manifest.json");if(!await k(n))throw new f(`Extension manifest is missing at "${n}".`,h.USAGE);let a;try{a=JSON.parse(await zi.readFile(n,"utf8"))}catch(o){throw new f(`Failed to parse extension manifest at "${n}": ${Lc(o)}`,h.USAGE)}let i=Sn(a);if(!i)throw new f(`Extension manifest at "${n}" is invalid.`,h.USAGE);let r=xn.resolve(e,i.entry);if(!B(e,r))throw new f(`Extension entry "${i.entry}" resolves outside extension directory "${e}".`,h.USAGE);if(!await k(r))throw await jc(i,r,t);if(!await Ta(e,r))throw new f(`Extension entry "${i.entry}" resolves outside extension directory after symlink resolution.`,h.USAGE);return{directory:e,manifest_path:n,entry_path:r,manifest:i}}function Lc(e){return e instanceof Error?e.message:String(e)}import En from"node:fs/promises";import Fc 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]="5181479f-469f-525b-add2-914a9934afbd")}catch{}})();var Mc=".managed-extensions.json",jt=1;function it(e){return Fc.join(e,Mc)}function Uc(){return{version:jt,updated_at:A(),entries:[]}}function rt(e){return[...e].sort((t,n)=>{let a=t.scope.localeCompare(n.scope);if(a!==0)return a;let i=t.name.localeCompare(n.name);return i!==0?i:t.directory.localeCompare(n.directory)})}function Gi(e,t){return e.kind!==t.kind||e.input!==t.input||e.location!==t.location?!1:e.kind==="npm"&&t.kind==="npm"?e.package===t.package&&e.version===t.version:e.kind==="github"&&t.kind==="github"?e.repository===t.repository&&e.ref===t.ref&&e.subpath===t.subpath&&e.commit===t.commit:e.kind==="builtin"&&t.kind==="builtin"?e.name===t.name:!0}function Y(e){return typeof e=="string"?e:void 0}function zc(e){return typeof e.name=="string"&&e.name.trim().length>0&&typeof e.directory=="string"&&e.directory.trim().length>0&&(e.scope==="project"||e.scope==="global")&&typeof e.manifest_version=="string"&&typeof e.manifest_entry=="string"&&Array.isArray(e.capabilities)&&e.capabilities.every(t=>typeof t=="string")&&typeof e.installed_at=="string"&&typeof e.updated_at=="string"}function Gc(e){if(typeof e!="object"||e===null)return null;let t=e;return t.kind!=="local"&&t.kind!=="github"&&t.kind!=="npm"&&t.kind!=="builtin"||typeof t.input!="string"||typeof t.location!="string"?null:{kind:t.kind,input:t.input,location:t.location,name:Y(t.name),package:Y(t.package),version:Y(t.version),repository:Y(t.repository),owner:Y(t.owner),repo:Y(t.repo),ref:Y(t.ref),subpath:Y(t.subpath),commit:Y(t.commit)}}function Jc(e){if(typeof e!="object"||e===null)return null;let t=e;if(!zc(t))return null;let n=Gc(t.source);if(!n)return null;let a=ka(t.contributions);return a===null?null:{name:t.name.trim(),directory:t.directory.trim(),scope:t.scope,manifest_version:t.manifest_version,manifest_entry:t.manifest_entry,capabilities:Z(t.capabilities),contributions:a,installed_at:t.installed_at,updated_at:t.updated_at,source:n,last_update_check_at:Y(t.last_update_check_at),last_update_remote_commit:Y(t.last_update_remote_commit),last_update_remote_version:Y(t.last_update_remote_version),update_available:typeof t.update_available=="boolean"||t.update_available===null?t.update_available:void 0,update_error:Y(t.update_error)}}function qc(e){if(typeof e!="object"||e===null)return null;let t=e;if(t.version!==jt||!Array.isArray(t.entries))return null;let n=[];for(let a of t.entries){let i=Jc(a);i&&n.push(i)}return{version:jt,updated_at:Y(t.updated_at)??A(),entries:rt(n)}}async function se(e){let t=it(e),n=Uc();try{let a=await En.readFile(t,"utf8"),i=JSON.parse(a),r=qc(i);if(!r)throw new f(`Managed extension state file "${t}" has an invalid schema. Repair or remove it before mutating extension state.`,h.GENERIC_FAILURE);return{path:t,state:r,warnings:[]}}catch(a){if(a instanceof f)throw a;if(typeof a=="object"&&a!==null&&"code"in a&&ge(a))return{path:t,state:n,warnings:[]};throw new f(`Managed extension state file "${t}" could not be read. Repair or remove it before mutating extension state.`,h.GENERIC_FAILURE)}}async function Xe(e,t){let n=it(e),a={version:jt,updated_at:A(),entries:rt(t.entries)};await En.mkdir(e,{recursive:!0}),await En.writeFile(n,`${JSON.stringify(a,null,2)}
-`,"utf8")}function ot(e,t){let n=e.entries.filter(a=>b(a.name)!==b(t.name)&&b(a.directory)!==b(t.directory));return n.push(t),{...e,updated_at:A(),entries:rt(n)}}async function Ji(e,t,n,a){let i=t.entries.find(o=>b(o.name)===b(n));if(!i)return t;let r=ot(t,{...i,contributions:a});return await Xe(e,r),r}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="c9a362e5-6eb5-52dc-aa74-6c6c0df2c291")}catch{}})();var Bc="PM_CLI_PACKAGE_ROOT",qi={beads:{package_directory:"pm-beads",legacy_extension_directory:"beads"},todos:{package_directory:"pm-todos",legacy_extension_directory:"todos"}},Hc=new Set(["*","all"]);function $n(){let e=[],t=process.env[Bc];return typeof t=="string"&&t.trim().length>0&&e.push(ie.resolve(t.trim())),e.push(ye(import.meta.url,["../../.."])),[...new Set(e)]}async function st(e){let t=e.trim().toLowerCase(),n=await Bi(t);if(n)return n;let a=qi[t];if(!a)return null;for(let i of $n()){let r=ie.join(i,".agents","pm","extensions",a.legacy_extension_directory);if(await k(ie.join(r,"manifest.json")))return r}return null}function Wi(e){return Hc.has(e.trim().toLowerCase())}function Kc(e){return e.replace(/^pm-/i,"").trim().toLowerCase()}async function Vc(e,t){let n=await Wc.readdir(e,{withFileTypes:!0});for(let a of n){if(!a.isDirectory()||!a.name.startsWith("pm-"))continue;let i=ie.join(e,a.name);if(!await k(ie.join(i,"package.json")))continue;let r=await at(i),o=r.aliases&&r.aliases.length>0?r.aliases:[Kc(a.name)];for(let s of o){let d=s.trim().toLowerCase();d.length===0||t.has(d)||t.set(d,{alias:d,package_directory:a.name,package_root:i,package_name:r.package_name??null})}}}async function In(){let e=new Map;for(let t of $n()){let n=ie.join(t,"packages");await k(n)&&await Vc(n,e)}for(let[t,n]of Object.entries(qi))if(!e.has(t))for(let a of $n()){let i=ie.join(a,"packages",n.package_directory);if(await k(ie.join(i,"package.json"))){e.set(t,{alias:t,package_directory:n.package_directory,package_root:i,package_name:null});break}}return[...e.values()].sort((t,n)=>t.alias.localeCompare(n.alias))}async function Lt(){return(await In()).map(e=>e.alias)}async function Bi(e){let t=e.trim().toLowerCase();return(await In()).find(n=>n.alias===t||n.package_directory.toLowerCase()===t||n.package_name?.toLowerCase()===t)?.package_root??null}async function Hi(e){let t=await Bi(e);return t?(await at(t)).package_name??null:null}async function Ki(e){let t=await st(e);if(!t)return null;try{let n=await Nt(t);return n.length!==1?null:(await Ye(n[0])).manifest.name}catch{return null}}function Yc(e){return{docs:e.catalog?.links?.docs??e.package_homepage,npm:e.catalog?.links?.npm??(e.package_name&&e.package_private!==!0?`https://www.npmjs.com/package/${encodeURIComponent(e.package_name)}`:void 0),repository:e.catalog?.links?.repository??e.package_repository_url,report:e.catalog?.links?.report??e.package_bugs_url}}function Xc(e,t,n,a,i,r){let o=a==="global"?"--global":"--project",s=Object.fromEntries(Rt.filter(d=>d!=="extensions").map(d=>[d,e.resources[d]??[]]).filter(([,d])=>Array.isArray(d)&&d.length>0));return{alias:t.alias,aliases:n,bundled:!0,available:!0,installed:n.some(d=>i.has(d))||r.has(ie.resolve(t.package_root)),install_target:t.alias,install_command:`pm install ${t.alias} ${o}`,package_name:e.package_name,package_version:e.package_version,description:e.catalog?.summary??e.package_description,keywords:e.package_keywords??[],resources:e.resources,installable_resources:{extensions:e.resources.extensions??[]},metadata_only_resources:s,catalog:{display_name:e.catalog?.display_name,category:e.catalog?.category,tags:e.catalog?.tags??e.package_keywords??[],links:Yc(e),media:e.catalog?.media}}}async function Vi(e,t,n={}){let a=St(F(process.cwd(),t.path),process.cwd()),i=e==="global"?a.global:a.project,r=await se(i),o=new Set(r.state.entries.filter(m=>m.scope===e).filter(m=>m.source.kind!=="builtin").map(m=>ie.resolve(m.source.location))),s=new Set(r.state.entries.filter(m=>m.scope===e&&m.source.kind==="builtin").flatMap(m=>[m.source.name,m.source.input,m.source.location]).filter(m=>typeof m=="string"&&m.trim().length>0).map(m=>m.trim().toLowerCase())),d=[],c=new Map;for(let m of await In()){let y=ie.resolve(m.package_root),g=c.get(y)??[];g.push(m),c.set(y,g)}for(let m of c.values()){let y=m[0],g=m.map(u=>u.alias).sort((u,w)=>u.localeCompare(w)),_=await at(y.package_root);d.push(Xc(_,y,g,e,s,o))}let l=Qc(n.fields),p=l?d.map(m=>ed(m,l)):d;return{total:p.length,scope:e,installable_resource_kinds:["extensions"],metadata_only_resource_kinds:Rt.filter(m=>m!=="extensions"),packages:p}}var Zc=new Set(["alias","aliases","bundled","available","installed","install_target","install_command","package_name","package_version","description","keywords","resources","installable_resources","metadata_only_resources","catalog","category","display_name"]);function Qc(e){if(e===void 0)return;let t=Ya(e);if(t.length===0)throw new f("Package catalog --fields requires a comma-separated list of field names",h.USAGE);let n=t.filter(a=>!Zc.has(a));if(n.length>0)throw new f(`Unknown package catalog --fields value(s): ${n.join(", ")}`,h.USAGE,{examples:["pm package list --project --fields alias,installed,install_command","pm package catalog --project --fields alias,package_name,category"]});return t}function ed(e,t){let n={};for(let a of t)a==="category"?n[a]=e.catalog?.category??null:a==="display_name"?n[a]=e.catalog?.display_name??null:n[a]=e[a]??null;return n}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="fc993281-a2a0-59e8-9f4a-e520f1b94f3b")}catch{}})();var Xi=ad(td),Mt="@unbrained/pm-cli",sd={maxArchiveBytes:64*1024*1024,maxEntries:4096,maxExpandedBytes:256*1024*1024,maxEntryBytes:64*1024*1024},An;async function Zi(e,t=process.cwd()){let n=e.trim();if(!/^(@[^/\\\s]+\/[^/\\\s]+|[^@/\\\s][^/\\\s]*)$/u.test(n))return null;let a=$.resolve(t);for(;;){let i=$.join(a,"node_modules",...n.split("/")),r=$.join(i,"package.json");if(await k(r))try{let s=JSON.parse(await P.readFile(r,"utf8"));if(s.name===n)return{package:n,...typeof s.version=="string"?{version:s.version}:{},directory:i}}catch{return null}let o=$.dirname(a);if(o===a)return null;a=o}}function Tn(e,t,n){let a=e.split("/").map(c=>c.trim()).filter(c=>c.length>0);if(a.length<2)return null;let i=a[0],r=a[1].replace(/\.git$/i,"");if(i.length===0||r.length===0)return null;let o=a.slice(2),s,d;return o[0]==="tree"&&o.length>=2?(s=o[1],d=o.slice(2).join("/")):o.length>0&&(d=o.join("/")),typeof n=="string"&&n.trim().length>0&&(s=n.trim()),{kind:"github",input:t,owner:i,repo:r,repository:`https://github.com/${i}/${r}.git`,ref:s,subpath:d&&d.length>0?d:void 0}}function cd(e,t,n){let a=e.slice(4).trim();if(a.length===0)throw new f('npm package source must include a package spec after "npm:".',h.USAGE);if(t)throw new f('Options "--gh/--github" cannot be combined with npm: package sources.',h.USAGE);if(n)throw new f('Option "--ref" cannot be combined with npm: package sources.',h.USAGE);return{kind:"npm",input:e,spec:a}}function ct(e,t={}){let n=e.trim();if(n.length===0)throw new f("Extension source is required for --install.",h.USAGE);let a=typeof t.ref=="string"&&t.ref.trim().length>0?t.ref.trim():void 0;if(n.startsWith("npm:"))return cd(n,t.forceGithub===!0,a);let i=(()=>{try{let o=new URL(n);if(o.hostname!=="github.com")return null;let s=o.pathname.replace(/^\/+/,"");return Tn(s,n,a)}catch{return null}})();if(i)return i;let r=n.startsWith("github.com/")?n.slice(11):null;if(r){let o=Tn(r,n,a);if(!o)throw new f(`Invalid GitHub source "${n}".`,h.USAGE);return o}if(t.forceGithub){let o=Tn(n,n,a);if(!o)throw new f(`Invalid GitHub shorthand "${n}".`,h.USAGE);return o}if(/^https?:\/\//i.test(n))throw new f(`Unsupported extension source URL "${n}". Supported remote source host: github.com.`,h.USAGE);return{kind:"local",input:n,absolute_path:$.resolve(process.cwd(),n)}}async function Ft(e,t=Xi,n){try{return((await t("git",e,{encoding:"utf8",timeout:n})).stdout??"").trim()}catch(a){let i=typeof a=="object"&&a!==null&&"stderr"in a?String(a.stderr):"",r=i.trim().length>0?i.trim():a instanceof Error?a.message:String(a);throw new f(`Git command failed: git ${e.join(" ")}
-${r}`,h.GENERIC_FAILURE)}}function Pn(e=process.platform){return e==="win32"?"npm.cmd":"npm"}function Rn(e=process.platform){return e==="win32"}async function Qi(e,t,n=Xi,a=process.platform,i=process.env){let r=Pn(a),o=Object.fromEntries(Object.entries(i).filter(([s])=>s.toLowerCase()!=="npm_config_allow_scripts"));o.NPM_CONFIG_ALLOW_SCRIPTS="";try{return((await n(r,e,{cwd:t,encoding:"utf8",env:o,shell:Rn(a)})).stdout??"").trim()}catch(s){let d=typeof s=="object"&&s!==null&&"stderr"in s?String(s.stderr):"",c=d.trim().length>0?d.trim():s instanceof Error?s.message:String(s);throw new f(`npm command failed: ${r} ${e.join(" ")}
-${c}`,h.GENERIC_FAILURE)}}function er(e){let t=e.trim(),n=t.includes("@file:")?t.slice(0,t.lastIndexOf("@file:")):t;return n.startsWith("@")?n.match(/^(@[^/@\s]+\/[^/@\s]+)/)?.[1]??n:n.match(/^([^/@\s]+)/)?.[1]??n}function tr(e){let t="@file:",n=e.lastIndexOf(t);return n>0&&e.slice(0,n).trim().length>0&&e.slice(n+t.length).trim().length>0}function dd(e){let t=(e instanceof Error?e.message:String(e)).toLowerCase();return t.includes("npm err! code e404")||t.includes("404 not found")||t.includes("is not in this registry")}function ld(e){let t=(e instanceof Error?e.message:String(e)).toLowerCase();return dd(e)||t.includes("not found")}function pd(e){let t=e.trim().toLowerCase();return t.startsWith("@unbrained/pm-")||t.startsWith("pm-")}function md(e){let t=er(e),n=pd(t),a=t.replace(/^.*\//,""),i=n?`github.com/unbraind/${a}`:void 0,r=i?`pm package install --project ${i}`:void 0;return{message:n?`npm package "${e}" was not found in the registry. If this is an unpublished first-party pm package, install its GitHub repository instead.`:`npm package "${e}" was not found in the registry.`,context:{code:"npm_package_not_found",required:"Use an install source that exists, or publish the npm package before installing it with npm:<name>.",why:"Classifying npm 404s avoids repeated registry retries and gives agents a deterministic fallback path.",examples:r?[r,"pm package catalog --project --json"]:[`npm view ${t}`,"pm package catalog --project --json"],nextSteps:r?[`Try ${r} if the repository exists.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."]:[`Verify ${t} exists in the npm registry and that you have access to it.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."],recovery:{attempted_command:`pm install --project npm:${e}`,normalized_args:["install","--project",`npm:${e}`],...i&&r?{fallback_candidates:[{source:i,command:r,reason:"canonical first-party GitHub repository fallback for unpublished pm packages"}],next_best_command:r}:{}}}}}function ud(e,t){if(!ld(t))return null;let n=md(e);return new f(n.message,h.NOT_FOUND,n.context)}async function nr(e){if($.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")){let t=$.resolve(process.cwd(),e);return await k(t)?t:null}try{let t=new URL(e);if(t.protocol==="file:"){let n=nd(t);return await k(n)?n:null}}catch{}if(!/^[a-z][a-z0-9+.-]*:/i.test(e)){let t=$.resolve(process.cwd(),e);if(await k(t))return t}return null}async function fd(e){let t=await nr(e);if(t)return t;let n=hd(e);return n!==e?n:(/^[a-z][a-z0-9+.-]*:/i.test(e),e)}function hd(e,t=process.cwd()){let n="@file:",a=e.lastIndexOf(n);if(!tr(e))return e;let i=e.slice(0,a),r=e.slice(a+n.length);if(r.startsWith("//")&&!r.startsWith("///"))return e;if(!r.startsWith("/"))return`${i}@${$.resolve(t,r)}`;let o;try{o=decodeURIComponent(new URL(`file:${r}`).pathname)}catch{return e}let s=/^\/[A-Za-z]:/.test(o)?o.slice(1):o;return`${i}@${s}`}function Yi(e,t){let n=$.resolve(e,t),a=$.relative(e,n);if(a.length===0||a===".."||a.startsWith(`..${$.sep}`)||$.isAbsolute(a))throw new f("npm pack reported a package archive outside its isolated destination.",h.GENERIC_FAILURE,{code:"npm_package_archive_unsafe",required:"Retry with a trusted npm client that writes its archive inside the requested pack destination.",why:"pm will not read a package-manager artifact outside the isolated directory created for this install."});return n}function gd(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return;let n=e;if(!(typeof n.filename!="string"||n.filename.trim().length===0))return{...t===void 0?{}:{key:t},filename:n.filename,...typeof n.name=="string"?{name:n.name}:{},...typeof n.version=="string"?{version:n.version}:{}}}function yd(e){return(Array.isArray(e)?e.map(t=>({value:t})):typeof e=="object"&&e!==null?Object.entries(e).map(([t,n])=>({key:t,value:n})):[]).flatMap(({key:t,value:n})=>{let a=gd(n,t);return a?[a]:[]})}function _d(e,t){let n=t?.trim().toLowerCase(),a=n?e.filter(o=>{let s=o.name?.trim().toLowerCase();return s!==void 0?s===n:o.key?.trim().toLowerCase()===n}):[];if(a.length===1)return a[0];if(e.length!==1)return;let i=e[0],r=i.name??i.key;return n&&r!==void 0&&r.trim().toLowerCase()!==n?void 0:i}function wd(e,t,n){let a;try{a=JSON.parse(e)}catch{let o=e.split(/\r?\n/).map(s=>s.trim()).filter(s=>s.length>0).at(-1);if(!o)throw new f("npm pack did not report a tarball filename.",h.GENERIC_FAILURE);return{tarball:Yi(t,o)}}let i=yd(a),r=_d(i,n);if(!r)throw new f("npm pack --json returned an unsupported or ambiguous package receipt.",h.GENERIC_FAILURE,{code:"npm_pack_json_shape_unsupported",required:"Use an npm client that returns an array of package receipts or an object keyed by package name, with exactly one requested package entry containing filename.",why:`Well-formed JSON contained ${i.length} usable package receipt(s), but pm could not select ${n??"one package"} deterministically.`});return{tarball:Yi(t,r.filename),package:r.name??r.key,version:r.version}}async function vd(e){return bd(e,Qi)}async function bd(e,t){let n=await nr(e.spec);if(n){if((await P.stat(n)).isFile()&&ar(n))return On(n);let r=$.join(n,"package.json"),o=await k(r)?JSON.parse(await P.readFile(r,"utf8")):{};return{directory:await Ut(n,e.input),package:typeof o.name=="string"?o.name:void 0,version:typeof o.version=="string"?o.version:void 0,cleanup:async()=>{}}}let a=await P.mkdtemp($.join(Cn.tmpdir(),"pm-npm-package-source-")),i=$.join(a,"pack");await P.mkdir(i,{recursive:!0});try{let r=await fd(e.spec),o=await t(["pack",r,"--json","--pack-destination",i]),s=wd(o,i,tr(e.spec)?void 0:er(e.spec));if(!await k(s.tarball))throw new f("npm pack did not create its reported package archive.",h.GENERIC_FAILURE,{code:"npm_package_archive_missing",required:"Retry the npm package install with a healthy registry and writable temporary directory.",why:"The package manager reported a tarball filename that was absent before validation, so pm cannot safely extract or install it."});let d=await On(s.tarball);return{directory:d.directory,package:s.package??d.package,version:s.version??d.version,cleanup:async()=>{try{await d.cleanup()}finally{await P.rm(a,{recursive:!0,force:!0})}}}}catch(r){throw await P.rm(a,{recursive:!0,force:!0}),ud(e.spec,r)||r}}function ar(e){let t=e.toLowerCase();return t.endsWith(".tgz")||t.endsWith(".tar.gz")}function fe(e){throw new f(e,h.USAGE,{code:"local_package_archive_unsafe",required:"Use a bounded npm .tgz or .tar.gz archive with one package/ root and no links or escaping paths.",why:"Package archives are untrusted input and must be validated before any entry reaches the filesystem."})}function kd(e,t,n){if(e.meta)return;n.entries+=1,n.entries>t.maxEntries&&fe(`Local package archive exceeds the ${t.maxEntries} entry limit.`);let a=e.path,i=a.split("/");(a.includes("\\")||a.startsWith("/")||/^[A-Za-z]:/u.test(a)||i.some(r=>r===".."))&&fe(`Local package archive contains an escaping path: "${a}".`),i[0]!=="package"&&fe(`Local package archive entry "${a}" is outside the required package/ root.`),(e.type==="SymbolicLink"||e.type==="Link")&&fe(`Local package archive link "${a}" is not supported.`),e.type!=="File"&&e.type!=="OldFile"&&e.type!=="Directory"&&fe(`Local package archive entry "${a}" uses unsupported type "${e.type}".`),e.size>t.maxEntryBytes&&fe(`Local package archive entry "${a}" exceeds the ${t.maxEntryBytes} byte entry limit.`),n.expandedBytes+=e.size,n.expandedBytes>t.maxExpandedBytes&&fe(`Local package archive exceeds the ${t.maxExpandedBytes} expanded byte limit.`),a==="package/package.json"&&(n.packageJsonEntries+=1)}async function On(e,t=sd){(await P.stat(e)).size>t.maxArchiveBytes&&fe(`Local package archive exceeds the ${t.maxArchiveBytes} archive byte limit.`);let n=await P.mkdtemp($.join(Cn.tmpdir(),"pm-local-package-archive-")),a=$.join(n,"extract");await P.mkdir(a,{recursive:!0});let i={entries:0,expandedBytes:0,packageJsonEntries:0},r;try{if(await od({file:e,strict:!0,maxDecompressionRatio:100,onReadEntry:c=>{if(r===void 0)try{kd(c,t,i)}catch(l){r=l}}}),r!==void 0)throw r;i.packageJsonEntries!==1&&fe(`Local package archive must contain exactly one package/package.json entry; found ${i.packageJsonEntries}.`),await rd({file:e,cwd:a,strict:!0,preservePaths:!1,preserveOwner:!1,noMtime:!0,unlink:!0,maxDepth:64,maxDecompressionRatio:100});let o=$.join(a,"package"),s=$.join(o,"package.json"),d=JSON.parse(await P.readFile(s,"utf8"));return await xd(o),{directory:await Ut(o,e),package:typeof d.name=="string"?d.name:void 0,version:typeof d.version=="string"?d.version:void 0,cleanup:async()=>{await P.rm(n,{recursive:!0,force:!0})}}}catch(o){throw await P.rm(n,{recursive:!0,force:!0}),o}}async function xd(e,t=Qi){let n=$.join(e,"package.json");if(!await k(n))return;let a;try{a=JSON.parse(await P.readFile(n,"utf8"))}catch{return}if(typeof a!="object"||a===null)return;let i=a,r=Td(i),o=Sd(i);if(r.length===0&&!o)return;let s={...a};delete s.devDependencies;let d={...s};Ed(d),await P.writeFile(n,`${JSON.stringify(d,null,2)}
-`,"utf8");try{await Promise.all([P.rm($.join(e,"package-lock.json"),{force:!0}),P.rm($.join(e,"npm-shrinkwrap.json"),{force:!0})]),r.length>0&&await t(["install","--ignore-scripts","--no-audit","--fund=false","--package-lock=false","--no-save","--omit=peer","--"],e),o&&await $d(e)}finally{await P.writeFile(n,`${JSON.stringify(s,null,2)}
-`,"utf8")}}function Sd(e){for(let t of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(typeof t=="object"&&t!==null&&Mt in t)return!0;return!1}function Ed(e){for(let t of["dependencies","optionalDependencies","peerDependencies"]){let n=e[t];if(typeof n!="object"||n===null)continue;let a={...n};delete a[Mt],Object.keys(a).length===0?delete e[t]:e[t]=a}}async function $d(e){let t=ye(import.meta.url,["../../.."]),[n,a]=Mt.split("/"),i=$.join(e,"node_modules",n),r=$.join(i,a);await P.mkdir(i,{recursive:!0}),await P.rm(r,{recursive:!0,force:!0}),await P.symlink(t,r,Id(process.platform))}function Id(e){return e==="win32"?"junction":"dir"}function Ad(e,t){if(e.startsWith("-"))throw new f(`Extension runtime dependency name "${e}" is unsafe because npm could interpret it as a command-line option.`,h.USAGE,{code:"extension_dependency_name_unsafe",required:"Use a valid npm package name that does not begin with a dash.",why:"Extension manifests are untrusted input and dependency names must never become npm options."});if([...t].some(n=>{let a=n.charCodeAt(0);return a<=31||a===127||"&|;()`\"'".includes(n)}))throw new f(`Extension runtime dependency "${e}" has an unsafe version specifier.`,h.USAGE,{code:"extension_dependency_version_unsafe",required:"Use an npm version, range, dist-tag, URL, or file specifier without shell metacharacters.",why:"npm.cmd requires a command shell on Windows, so untrusted shell metacharacters cannot be forwarded."});try{id.resolve(e,t)}catch{throw new f(`Extension runtime dependency "${e}@${t}" is not a valid npm dependency specifier.`,h.USAGE,{code:"extension_dependency_spec_invalid",required:"Use a valid npm package name and npm-supported version, range, dist-tag, URL, or file specifier.",why:"Only grammar-validated dependency specs may be written to the isolated runtime install manifest."})}return`${e}@${t}`}function Td(e){let t=new Map;for(let n of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(!(typeof n!="object"||n===null))for(let[a,i]of Object.entries(n)){if(a===Mt||typeof i!="string"||i.trim().length===0||t.has(a))continue;let r=i.trim();t.set(a,Ad(a,r))}return[...t.values()]}async function Ut(e,t){let n=await Nt(e);if(n.length===1)return n[0];if(n.length>1){let a=n.map(i=>$.relative(e,i).replaceAll($.sep,"/")).sort((i,r)=>i.localeCompare(r));throw new f(`Package source "${t}" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${a.join(", ")}`,h.USAGE)}throw new f(`Unable to locate a pm extension manifest in package source "${t}". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,h.USAGE)}async function Od(e,t){let n=[];t.subpath&&(n.push(t.subpath),n.push($.posix.join(".agents/pm/extensions",t.subpath)),n.push($.posix.join(".custom/pm-extensions",t.subpath)),n.push($.posix.join(".custom/pm-extension",t.subpath)));for(let i of n){let r=$.resolve(e,i);if(B(e,r)&&await k($.join(r,"manifest.json")))return{directory:r,resolved_subpath:i}}if(await k($.join(e,"manifest.json")))return{directory:e,resolved_subpath:"."};let a=await Ut(e,t.input);return{directory:a,resolved_subpath:$.relative(e,a).replaceAll($.sep,"/")}}function Cd(e){let t=e.trim();return t.length===0||t.startsWith(".")||t.startsWith("~")?!1:t.startsWith("@")?t.split("/").length===2:!t.includes("/")&&!t.includes("\\")}async function Pd(e){let t=`Local extension source does not exist: "${e.absolute_path}".`,n=e.input.trim();if(!Cd(n))return new f(t,h.NOT_FOUND);let a=[];try{let r=process.env.PM_CLI_PACKAGE_ROOT,o=typeof r=="string"&&r.trim().length>0?$.resolve(r.trim()):"";An?.key!==o&&(An={key:o,aliases:await Lt()}),a=An.aliases}catch{}let i=[`Retry with pm package install npm:${n} if the package is published to npm.`,`Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${a.join(", ")}`];return new f(`${t} "${n}" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as "npm:${n}".`,h.NOT_FOUND,{code:"local_source_not_found_bare_name",required:`Use "npm:${n}" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,why:"Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.",examples:[`pm package install npm:${n}`,"pm package catalog --project --json"],nextSteps:i,recovery:{attempted_command:`pm install ${n}`,normalized_args:["install",n],next_best_command:`pm package install npm:${n}`}})}async function ir(e){if(e.kind==="local"){let a;try{a=await P.stat(e.absolute_path)}catch{throw await Pd(e)}if(a.isFile()&&ar(e.absolute_path)){let r=await On(e.absolute_path);return{source:e,directory:r.directory,source_root:$.dirname(r.directory),resolved_subpath:$.relative($.dirname(r.directory),r.directory).replaceAll($.sep,"/"),npm_package:r.package,npm_version:r.version,cleanup:r.cleanup}}if(!a.isDirectory())throw new f(`Local extension source must be a directory or npm .tgz/.tar.gz archive: "${e.absolute_path}".`,h.USAGE);let i=await Ut(e.absolute_path,e.input);return{source:e,directory:i,source_root:e.absolute_path}}if(e.kind==="npm"){let a=await vd(e);return{source:e,directory:a.directory,source_root:$.dirname(a.directory),cleanup:a.cleanup,resolved_subpath:$.relative($.dirname(a.directory),a.directory).replaceAll($.sep,"/"),npm_package:a.package,npm_version:a.version}}let t=await P.mkdtemp($.join(Cn.tmpdir(),"pm-extension-source-")),n=["clone","--depth","1"];e.ref&&n.push("--branch",e.ref),n.push(e.repository,t);try{await Ft(n);let a=await Ft(["-C",t,"rev-parse","HEAD"]),i=await Od(t,e);return{source:e,directory:i.directory,source_root:t,resolved_subpath:i.resolved_subpath,commit:a,cleanup:async()=>{await P.rm(t,{recursive:!0,force:!0})}}}catch(a){throw await P.rm(t,{recursive:!0,force:!0}),a}}async function zt(e,t){if(!await k(e)||!await k(t))return!1;let[n,a]=await Promise.all([P.realpath(e),P.realpath(t)]);return n===a}import dt from"node:fs/promises";import lt 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]="ceca3e62-35a7-51eb-b478-5309ba430cc8")}catch{}})();var Nn=1,je="2026.6.24",Rd=">=22.18.0",Nd={fs_read:!1,fs_write:!1,network:!1,env_read:!1,env_write:!1,process_spawn:!1},rr=new Set([...ba.map(e=>e.split("-")[0].toLowerCase()),...Object.keys(sa).map(e=>e.toLowerCase()),"scaffold"]),Dd="^6.0.0",jd="^22.0.0",cr=["type StarterHarness = Awaited<ReturnType<typeof createExtensionTestHarness>>;","","async function deactivateIfNeeded(ext: StarterHarness, deactivated: boolean): Promise<void> {","  if (!deactivated) {","    try {","      await ext.deactivate();","    } catch {","      // Preserve the original assertion error; cleanup is best effort.","    }","  }","}",""],ce=["  } finally {","    await deactivateIfNeeded(ext, deactivated);","  }"];function or(e,t){return e.map(n=>n===""?n:`${t}${n}`)}function dr(e){let t=e.includeMigrationReplacementHint===!0?["  // as your migration grows."]:[];return["  // assertItemType/Field/Migration throw unless the registration is present, so","  // reaching each next line already proves the wiring; assert on the returned","  // definitions to demonstrate inspecting registered metadata.",`  const itemType = ext.assertItemType({ name: ${JSON.stringify(e.itemTypeName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,`  assert.equal(itemType.itemType.folder, ${JSON.stringify(e.itemTypeFolder)});`,`  const itemField = ext.assertItemField({ name: ${JSON.stringify(e.fieldName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,'  assert.equal(itemField.field.type, "string");',`  ext.assertMigration({ name: ${JSON.stringify(e.migrationId)}, extensionName: ${JSON.stringify(e.extensionName)}, mandatory: false });`,"","  // runMigration invokes the migration through pm's real runner with a synthetic","  // context and returns its result.",...t,`  const migrated = await ext.runMigration({ migration: ${JSON.stringify(e.migrationId)} });`,`  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(e.migrationId)} });`]}function lr(e){return["  // assertProfile throws unless the profile is registered, so reaching the next","  // line already proves the wiring; assert on the returned definition to inspect","  // the bundled archetype dimensions.",`  const { profile } = ext.assertProfile({ name: ${JSON.stringify(e)}, extensionName: ${JSON.stringify(e)} });`,`  assert.equal(profile.title, ${JSON.stringify(`${e} archetype`)});`,"  assert.equal(profile.types.length, 1);","  assert.equal(profile.workflows.length, 1);"]}var Ld={compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",strict:!0,esModuleInterop:!0,skipLibCheck:!0,noEmit:!0,allowImportingTsExtensions:!0,resolveJsonModule:!0,types:["node"]},include:["**/*.ts"]},sr=["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"],pr={commands:["commands"],hooks:["commands","hooks"],search:["commands","search"],importers:["commands","schema","importers"],schema:["commands","schema"],profile:["commands","schema"],renderers:["commands","renderers"],parser:["commands","parser","schema"],preflight:["commands","preflight"],services:["commands","services"]},Fd={commands:'["commands"]',hooks:'["commands", "hooks"]',search:'["commands", "search"]',importers:'["commands", "schema", "importers"]',schema:'["commands", "schema"]',profile:'["commands", "schema"]',renderers:'["commands", "renderers"]',parser:'["commands", "parser", "schema"]',preflight:'["commands", "preflight"]',services:'["commands", "services"]'},Md={commands:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration plus a `deactivate` teardown stub.",hooks:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub.",search:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub.",importers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub.",schema:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a custom item type, a custom item field, a schema migration, and a `deactivate` teardown stub.",profile:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a project profile (item types, statuses, fields, a workflow, config, a template, and package recommendations) registered via `api.registerProfile`, and a `deactivate` teardown stub.",renderers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a `toon` output renderer override, and a `deactivate` teardown stub.",parser:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a parser override that rewrites the command's parsed options, and a `deactivate` teardown stub.",preflight:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a preflight override over pm's pre-run gate decision, and a `deactivate` teardown stub.",services:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `output_format` service override, and a `deactivate` teardown stub."},Ud={commands:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.",hooks:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.",search:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.",importers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers.",schema:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, item type/field/migration registration, migration invocation, and teardown via the SDK testing helpers.",profile:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, project-profile registration (asserting the bundled archetype dimensions), and teardown via the SDK testing helpers.",renderers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, renderer override registration and invocation (including format pass-through), and teardown via the SDK testing helpers.",parser:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, parser override registration and the option rewrite it produces, and teardown via the SDK testing helpers.",preflight:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, preflight override registration and the gate decision it returns, and teardown via the SDK testing helpers.",services:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, service override registration and invocation (including command pass-through), and teardown via the SDK testing helpers."},mr="- `tsconfig.json`: strict type-check-only TypeScript config (`noEmit`) for the `.ts` source the loader runs directly.",zd={commands:[],hooks:["","## Lifecycle Hook","`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.","pm fires it once a command finishes, passing the command outcome and the","items it mutated (`context.affected`). React there to keep external context","in sync - sync records, emit telemetry, or refresh derived state. The","`hooks` capability in `manifest.json` is what grants the hook registration;","remove it (and the hook) if your package only needs commands."],search:["","## Search Provider","`index.ts` registers a deterministic in-memory search provider and","vector-store adapter through `api.registerSearchProvider` and","`api.registerVectorStoreAdapter`. Replace the sample scoring,","embedding, and storage behavior with your project-specific retrieval","logic. The `search` capability in `manifest.json` grants both","registrations."],importers:["","## Importer and Exporter","`index.ts` registers paired project-context import/export commands through","`api.registerImporter` and `api.registerExporter`. Replace the starter","payloads with your domain adapter: GitHub issues, CSV rows, documents,","tickets, or another project-management source of truth. The `importers`","capability grants both registrations, and `schema` grants the example","command flag metadata."],schema:["","## Custom Schema","`index.ts` models a project domain by registering a custom item type, a","custom item field, and a schema migration through `api.registerItemTypes`,","`api.registerItemFields`, and `api.registerMigration`. This is how a package","turns pm into a domain-specific tracker \u2014 `project management = context","management`. Replace the sample type/field/migration with your own domain","model; the `schema` capability in `manifest.json` grants all three","registrations. Once installed, the custom type is usable everywhere, e.g.",'`pm create <type> "<title>"` and `pm list --type <type>`.'],profile:["","## Project Profile","`index.ts` registers a complete project-profile archetype through","`api.registerProfile`. A profile is the broadest customization primitive pm","has \u2014 one declarative bundle of item types, custom statuses, fields, a per-type","workflow, config knobs, create templates, and package recommendations. Once the","package is installed the profile resolves by name through `pm profile list`,","`pm profile show <name>`, and `pm profile apply <name>`, which stages every","dimension idempotently \u2014 exactly like a core archetype (agile/ops/research),","with no consumer code required. Replace the sample archetype with your own","domain; the `schema` capability in `manifest.json` grants the registration (a","profile is a schema+config bundle, so it needs no separate capability)."],renderers:["","## Output Renderer","`index.ts` registers a `toon` output renderer override through","`api.registerRenderer`. Renderer overrides run for every command's output in","that format, so this starter scopes itself to THIS package's own command and","returns `null` (pass-through to pm's default renderer) for everything else.","Return a string to take over rendering. Replace the sample serialization with","your own; the `renderers` capability in `manifest.json` grants the","registration."],parser:["","## Parser Override","`index.ts` registers a parser override for the starter command through","`api.registerParser`. pm runs it on the command's parsed options BEFORE the","handler, merging the delta you return. This starter rewrites a deprecated","`--shout` alias to the canonical `--upper` flag; replace it with your","command's real normalization. The `parser` capability in `manifest.json`","grants the registration."],preflight:["","## Preflight Override","`index.ts` registers a preflight override through `api.registerPreflight`. pm","calls it only for its declared command ownership to compute the migration/format","gate decision. Overlapping or legacy global ownership is diagnosed. Return only","the decision keys you want to","change; this starter echoes the current decision unchanged (a safe no-op) so","installing the package does not alter gate behavior. The `preflight`","capability in `manifest.json` grants the registration."],services:["","## Service Override","`index.ts` overrides the built-in `output_format` service through","`api.registerService`. The service renders a command's structured result;","returning the payload unchanged passes through to pm's default formatting.","This starter scopes itself to THIS package's own command and passes every","other command through, so it never disrupts unrelated output. The `services`","capability in `manifest.json` grants the registration."]},Gd={package:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","package's `activate` registers. pm imports and activates the package lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands (`pm list`, `pm search`, ...) never pay to load it. Keep this list in","sync with the registrations in `index.ts`: add an entry when you register a new","command, importer, or exporter, and remove one you drop. An omitted or stale","entry means the matching command will not dispatch from the CLI. Globally-scoped","surfaces (hooks, parser/preflight/renderer overrides, and search providers for","built-in search commands) still activate regardless of this list."],extension:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","extension's `activate` registers. pm imports and activates the extension lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands never pay to load it. Keep this list in sync with the registrations in","`index.ts`: an omitted or stale entry means the matching command will not dispatch","from the CLI. Globally-scoped surfaces (hooks, parser/preflight/renderer overrides,","and search providers for built-in search commands) still activate regardless."]},Jd={package:["","## Activation","This package contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the package","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`. If you","drop the schema registrations and keep only command/hook/search/importer surfaces,","add `activation.commands` back so pm can load the package lazily."],extension:["","## Activation","This extension contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the extension","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`."]},qd={package:["","## Activation","This package contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands \u2014 commands the package does not own \u2014 so `manifest.json` intentionally","declares no `activation.commands`. pm activates the package conservatively (for","every command, granted by the `schema` capability) so the profile is present","whenever `pm profile` runs. Declaring narrow `activation.commands` here would","gate activation to only the listed commands and silently leave the profile","unregistered for `pm profile`."],extension:["","## Activation","This extension contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands, so `manifest.json` intentionally declares no `activation.commands`. pm","activates the extension conservatively (for every command, granted by the","`schema` capability) so the profile is present whenever `pm profile` runs.","Declaring narrow `activation.commands` here would silently leave the profile","unregistered for `pm profile`."]};function ur(e,t){return e==="schema"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the custom item type activates for every command).`:e==="profile"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the contributed profile resolves through \`pm profile\` for every command).`:`- \`manifest.json\`: ${t} metadata, capabilities, and \`activation.commands\` (the command paths that lazily activate this ${t}).`}function fr(e,t){return e==="schema"?Jd[t]:e==="profile"?qd[t]:Gd[t]}function Wd(e){let t=e.replace(/-/g," ").trim().split(/\s+/).filter(o=>o.length>0);if(t.length===0)return"starter ping";let n=t[0].toLowerCase(),a=0;for(;t[a]?.toLowerCase()==="starter";)a+=1;let i=t[a]?.toLowerCase(),r=a>0&&(a===t.length||i!==void 0&&rr.has(i));return`${(rr.has(n)||r?["starter",...t]:t).join(" ")} ping`}function hr(e){let t=e,n=`${e}s`,a=e.replace(/-/g,""),i=a===t?[]:[a],r=`${e.replace(/-/g,"_")}_owner`,o="reviewing";return[`  name: ${JSON.stringify(e)},`,`  title: ${JSON.stringify(`${e} archetype`)},`,'  summary: "Starter project profile. Replace these dimensions with your own archetype.",',"  // Item types the profile upserts into the project schema when applied.","  types: [","    {",`      name: ${JSON.stringify(t)},`,`      folder: ${JSON.stringify(n)},`,`      aliases: ${JSON.stringify(i)},`,`      description: ${JSON.stringify(`A ${e} work item that flows to done.`)},`,"    },","  ],","  // Custom statuses upserted into the project status set.","  statuses: [","    {",`      id: ${JSON.stringify(o)},`,'      roles: ["active"],','      aliases: ["in-review"],','      description: "Work is implementation-complete and awaiting review.",',"    },","  ],","  // Custom item-metadata fields the archetype tracks.","  fields: [","    {",`      key: ${JSON.stringify(r)},`,'      type: "string",','      commands: ["create", "update", "list"],','      description: "Stakeholder accountable for the item.",',"    },","  ],","  // Per-type workflow transition allow-list staged into settings.","  workflows: [","    {",`      type: ${JSON.stringify(t)},`,"      allowed_transitions: [",'        ["open", "in_progress"],',`        ["in_progress", ${JSON.stringify(o)}],`,`        [${JSON.stringify(o)}, "in_progress"],`,`        [${JSON.stringify(o)}, "closed"],`,'        ["in_progress", "blocked"],','        ["blocked", "in_progress"],',"      ],","    },","  ],","  // Nested-settings knobs staged when the profile is applied.","  config: [",'    { key: "search_provider", value: "bm25", summary: "Offline BM25 lexical search needs no embedding service." },','    { key: "search_max_results", value: "20", summary: "Result cap tuned for quick triage." },',"  ],","  // Create templates staged into <pmRoot>/templates.","  templates: [","    {",`      name: ${JSON.stringify(e)},`,"      options: {",`        type: ${JSON.stringify(t)},`,'        priority: "2",',`        tags: ${JSON.stringify(e)},`,'        acceptanceCriteria: "Item delivers the stated outcome with tests and docs updated.",','        body: "## Context\\n\\n## Acceptance\\n- [ ] \\n",',"      },","    },","  ],","  // Advisory package recommendations (never auto-installed).","  packages: [",'    { spec: "templates", reason: "Reusable create templates for recurring item shapes." },',"  ],"]}function Bd(e,t,n){let a=`${e}-search`,i=`${e}-vector`,r=`${e.replace(/-/g," ")} items`,o=["  api.registerCommand({",`    name: ${JSON.stringify(t)},`,'    description: "Starter scaffold command. Replace with your own behavior.",',"    run: async (context) => ({","      ok: true,",`      source: ${JSON.stringify(e)},`,"      command: context.command,",'      message: "Starter extension scaffold is active.",',"    }),","  });"];if(n==="commands")return o;if(n==="search")return[...o,"","  // Search providers let packages customize how pm ranks and retrieves","  // project context. This starter is deterministic and dependency-free:","  // replace the scoring with your domain retrieval, embedding, or rerank","  // logic as the package grows.","  api.registerSearchProvider({",`    name: ${JSON.stringify(a)},`,"    query: async (context) => {","      const needle = context.query.toLowerCase();","      const hits = context.documents","        .filter((document) => {",'          const title = String(document.metadata.title ?? "").toLowerCase();',"          return title.includes(needle);","        })","        .map((document) => ({","          id: document.metadata.id,","          score: 1,",'          matched_fields: ["title"],',"        }));","      return { hits };","    },","    embed: async (context) => [context.input.length],","  });","","  // Vector-store adapters let packages own semantic index storage. This","  // starter returns a stable in-memory hit so generated tests can exercise","  // the adapter without external services.","  api.registerVectorStoreAdapter({",`    name: ${JSON.stringify(i)},`,'    query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"    upsert: async (context) => ({ upserted: context.points.length }),","    delete: async (context) => ({ deleted: context.ids.length }),","  });"];if(n==="schema"){let s=e,d=`${e}s`,c=e.replace(/-/g,""),l=c===s?[]:[c],p=`${e.replace(/-/g,"_")}_note`,m=`${e}-0001-init`;return[...o,"","  // Schema registrations let a package model its own project domain \u2014 the",'  // heart of "project management = context management". Item types and fields',"  // are GLOBAL contributions: built-in commands like `pm create <type>` and","  // `pm list --type <type>` must see them, so this package declares no","  // `activation.commands` and pm activates it conservatively for every command.","  // The `schema` capability in manifest.json grants all three registrations.","  api.registerItemFields([","    {",`      name: ${JSON.stringify(p)},`,'      type: "string",',"      optional: true,","    },","  ]);","","  api.registerItemTypes([","    {",`      name: ${JSON.stringify(s)},`,"      // Replace with your domain's canonical plural folder name.",`      folder: ${JSON.stringify(d)},`,`      aliases: ${JSON.stringify(l)},`,"      // Add field names here to force them at `pm create` time.","      required_create_fields: [],","    },","  ]);","","  // Migrations let a package evolve stored items as its schema changes. pm","  // runs each migration ONCE through the preflight gate (not once per item),","  // passing a context that identifies the migration itself: `context.id` is","  // the migration id (not an item id), alongside `context.pm_root` \u2014 iterate","  // the corpus yourself from there. This starter is a deterministic no-op so","  // package tests can invoke it without touching the corpus; replace the body","  // with your real rewrite.","  api.registerMigration({",`    id: ${JSON.stringify(m)},`,`    description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"    mandatory: false,","    run: async (context) => ({ migrated: true, id: context.id }),","  });"]}return n==="profile"?[...o,"","  // A project profile is the broadest customization primitive pm has: one","  // declarative bundle of item types, custom statuses, fields, a per-type","  // workflow, config knobs, create templates, and package recommendations. Once","  // this package is installed the profile resolves by name through `pm profile","  // list`, `pm profile show`, and `pm profile apply`, which stages every dimension","  // idempotently like a core archetype. A profile registration is a schema+config","  // bundle, so the `schema` capability in manifest.json grants it.","  api.registerProfile({",...hr(e).map(s=>`  ${s}`),"  });"]:n==="importers"?[...o,"","  // Importers/exporters are the bridge between pm's context graph and","  // another project-management system. Keep the starter deterministic so","  // package tests can run without touching the network or filesystem; replace","  // these payloads with your adapter's real mapping as the package grows.","  api.registerImporter(",`    ${JSON.stringify(r)},`,"    async (context) => ({","      imported: 1,",'      source: context.options.source ?? "starter",',"      args: context.args,","    }),","    {",`      action: ${JSON.stringify(`${r} import`)},`,'      description: "Import starter records into pm context.",',"      flags: [","        {",'          long: "--source",','          value_name: "name",','          value_type: "string",','          description: "Source name or path to import from.",',"        },","      ],","    },","  );","","  api.registerExporter(",`    ${JSON.stringify(r)},`,"    async (context) => ({","      exported: true,",'      destination: context.options.destination ?? "stdout",',"      args: context.args,","    }),","    {",`      action: ${JSON.stringify(`${r} export`)},`,'      description: "Export pm context into starter records.",',"      flags: [","        {",'          long: "--destination",','          value_name: "name",','          value_type: "string",','          description: "Destination name or path to export to.",',"        },","      ],","    },","  );"]:n==="renderers"?[...o,"","  // Renderer overrides customize how pm serializes a command's structured",'  // result for an output format ("toon" or "json"). Host-enforced ownership',"  // prevents unrelated commands from reaching this callback.","  // The `renderers` capability in manifest.json grants the registration.",'  api.registerRenderer("toon", (context) => {',`    return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,`  }, { commands: [${JSON.stringify(t)}] });`]:n==="parser"?["  api.registerCommand({",`    name: ${JSON.stringify(t)},`,'    description: "Starter scaffold command. Replace with your own behavior.",',"    flags: [","      {",'        long: "--shout",','        value_type: "boolean",','        description: "Deprecated alias for --upper; the parser override rewrites it.",',"      },","      {",'        long: "--upper",','        value_type: "boolean",','        description: "Echo the canonical flag the parser override produces.",',"      },","    ],","    run: async (context) => ({","      ok: true,",`      source: ${JSON.stringify(e)},`,"      command: context.command,","      // Surfaces the normalized option so `--shout`/`--upper` is observable.","      upper: context.options.upper === true,",'      message: "Starter extension scaffold is active.",',"    }),","  });","","  // Parser overrides preprocess a command's parsed options BEFORE its handler","  // runs, returning a delta \u2014 only the keys you set are merged over the parsed","  // input. This override is scoped to THIS package's own command. Here it","  // rewrites the deprecated `--shout` boolean alias to the canonical `--upper`","  // flag; replace it with your command's real normalization. The `parser`","  // capability in manifest.json grants the registration.",`  api.registerParser(${JSON.stringify(t)}, (context) => {`,"    const options = { ...context.options };","    if (options.shout === true) {","      options.upper = true;","    }","    delete options.shout;","    return { options };","  });"]:n==="preflight"?[...o,"","  // Preflight overrides adjust pm's pre-run gate decision (extension","  // migrations + item-format checks) for the commands it owns. Disjoint","  // packages compose; overlapping or legacy global ownership is diagnosed.","  // Return a delta of the keys you want to change","  // (enforce_item_format_gate, run_preflight_item_format_sync,","  // run_extension_migrations, enforce_mandatory_migration_gate); returning","  // context.decision unchanged is a safe no-op so installing the package does","  // not alter gate behavior \u2014 replace it with your policy, e.g.","  // `{ run_extension_migrations: false }`. The `preflight` capability in","  // manifest.json grants the registration.","  api.registerPreflight({",`    commands: [${JSON.stringify(t)}],`,"    run: (context) => context.decision,","  });"]:n==="services"?[...o,"","  // Service overrides replace a built-in pm service. The `output_format`","  // service renders a command's structured result; returning the payload","  // unchanged passes through to pm's default formatting. This override scopes","  // itself to THIS package's own command and passes every other command","  // through, so it never disrupts unrelated output. The `services` capability","  // in manifest.json grants the registration.",'  api.registerService("output_format", (context) => {',`    if (context.command !== ${JSON.stringify(t)}) {`,"      return { handled: false };","    }",`    return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"  });"]:[...o,"","  // after_command hooks fire once pm finishes a command, receiving the items","  // it mutated. This is the natural place to react to every change - sync to","  // an external system, emit telemetry, or refresh derived context",'  // ("project management = context management"). This starter is a documented',"  // no-op on the success path; replace the body with your own reaction.","  api.hooks.afterCommand((context) => {","    if (!context.ok) {","      return;","    }","    // `context.affected` lists the items pm mutated (id, status,","    // changed_fields). React here, e.g.:","    //   for (const item of context.affected ?? []) { /* ...item.id... */ }","  });"]}function Hd(e,t,n){let a=n==="hooks",i=n==="search",r=n==="importers",o=n==="schema",s=n==="profile",d=n==="renderers",c=n==="parser",l=n==="preflight",p=n==="services",m=Fd[n],y=e,g=`${e}s`,_=`${e.replace(/-/g,"_")}_note`,u=`${e}-0001-init`,w=["  assertExtensionDeactivated,","  createExtensionTestHarness,"],v=a?[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertHook throws unless an after_command hook is registered, so","    // reaching the next line already proves the hook is wired.","    ext.assertHook({",'      kind: "after_command",',`      extensionName: ${JSON.stringify(e)},`,"    });","    // runHook fires the hook through pm's real runner with a synthetic","    // context and returns the warnings it produced; a clean hook returns none.","    // Replace the context/assertions as your hook grows.","    const warnings = await ext.runHook({",'      kind: "after_command",',"      context: {",`        command: ${JSON.stringify(t)},`,"        args: [],",'        pm_root: "",',"        ok: true,","        affected: [],","      },","    });","    assert.deepEqual(warnings, []);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],S=i?Dn(e,t,"search",m):[],x=r?Dn(e,t,"importers",m):[],T=o?[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {",...or(dr({extensionName:e,itemTypeName:y,itemTypeFolder:g,fieldName:_,migrationId:u,includeMigrationReplacementHint:!0}),"  "),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],te=s?[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {",...or(lr(e),"  "),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],D=d?[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertRendererOverride throws unless a renderer is registered for the","    // format, so reaching the next line already proves the wiring.",`    const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,'    assert.equal(override.format, "toon");',"","    // runRendererOverride renders through pm's real runner. The override","    // customizes only THIS package's command output and returns a string the","    // host uses verbatim. Replace the assertions as it grows.","    const rendered = await ext.runRendererOverride({",'      format: "toon",',`      command: ${JSON.stringify(t)},`,"      result: { ok: true },","    });","    assert.equal(rendered.overridden, true);",`    assert.equal(rendered.rendered, ${JSON.stringify(`${e}: `)} + JSON.stringify({ ok: true }));`,"","    // Output for any other command passes through to pm's default renderer.","    const passthrough = await ext.runRendererOverride({",'      format: "toon",','      command: "list",',"      result: { ok: true },","    });","    assert.equal(passthrough.overridden, false);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],E=c?[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertParserOverride throws unless a parser is registered for the","    // command, so reaching the next line already proves the wiring.",`    ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,"","    // runParserOverride runs the override through pm's real parser runner and","    // returns the rewritten context. The starter rewrites the deprecated","    // `shout` alias to the canonical `upper` flag.","    const result = await ext.runParserOverride({",`      command: ${JSON.stringify(t)},`,"      args: [],","      options: { shout: true },","      global: {},",'      pm_root: "",',"    });","    assert.equal(result.overridden, true);","    assert.deepEqual(result.context.options, { upper: true });","","    // End to end: feed the rewritten options into the command handler to","    // prove `pm <command> --shout` surfaces the normalized `upper` flag in","    // the result.",`    const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`,"    assert.equal(invocation.handled, true);","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,"      upper: true,",'      message: "Starter extension scaffold is active.",',"    });","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],z=l?[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertPreflightOverride throws unless a preflight override is","    // registered, so reaching the next line already proves the wiring.",`    ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,"","    // runPreflightOverride runs the override through pm's real runner with a","    // synthetic gate decision. The starter echoes the decision unchanged;","    // replace the values/assertions with your real policy.","    const decision = {","      enforce_item_format_gate: true,","      run_preflight_item_format_sync: false,","      run_extension_migrations: true,","      enforce_mandatory_migration_gate: false,","    };","    const result = await ext.runPreflightOverride({",`      command: ${JSON.stringify(t)},`,"      args: [],","      options: {},","      global: {},",'      pm_root: "",',"      decision,","    });","    assert.equal(result.overridden, true);","    assert.deepEqual(result.decision, decision);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[],Ze=p?[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertServiceOverride throws unless a service override is registered","    // for the service, so reaching the next line proves the wiring.",`    ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,"","    // runServiceOverride runs the override through pm's real service runner.","    // The override customizes only THIS package's command output (handled),","    // passing every other command through (not handled).","    const handled = await ext.runServiceOverride({",'      service: "output_format",',`      command: ${JSON.stringify(t)},`,"      payload: { ok: true },","    });","    assert.equal(handled.handled, true);",`    assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,"","    // Output for any other command passes through to pm's default formatter.","    const passthrough = await ext.runServiceOverride({",'      service: "output_format",','      command: "list",',"      payload: { ok: true },","    });","    assert.equal(passthrough.handled, false);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});",""]:[];return['import assert from "node:assert/strict";','import { test } from "node:test";',"import {",...w,'} from "@unbrained/pm-cli/sdk/testing";',...i?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension from "./index.ts";',"",...cr,`test(${JSON.stringify(`${e} registers its starter command`)}, async () => {`,"  // `capabilities` mirrors manifest.json so the in-memory activation grants","  // the capabilities the entrypoint relies on.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertCommandContract is bound to the right activation registry and throws","    // if the command is not registered, so reaching here already proves the","    // wiring; assert on the returned definition to inspect metadata.","    const registered = ext.assertCommandContract({",`      name: ${JSON.stringify(t)},`,`      extensionName: ${JSON.stringify(e)},`,"    });",'    assert.equal(typeof registered.command.description, "string");',"","    // runCommand invokes the handler through pm's real dispatch engine, so this","    // asserts behavior - not just that the command is wired. Replace these","    // assertions as you flesh out your command.","    const invocation = await ext.runCommand({",`      command: ${JSON.stringify(t)},`,"    });","    assert.equal(invocation.handled, true);","    // The handler result is typed `unknown`, so deep-equality on the whole","    // structured payload keeps the assertion type-safe without a cast.","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,...c?["      upper: false,"]:[],'      message: "Starter extension scaffold is active.",',"    });","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});","",...v,...S,...x,...T,...te,...D,...E,...z,...Ze,`test(${JSON.stringify(`${e} tears down cleanly via deactivate`)}, async () => {`,"  // createExtensionTestHarness binds teardown to the same name/layer used for","  // activation, so this proves your `deactivate` hook runs without throwing.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  const teardown = await ext.deactivate();","  // assertExtensionDeactivated throws unless exactly one extension tore down","  // with no failures, so reaching the next line already proves teardown ran.","  assertExtensionDeactivated(teardown);","  assert.equal(teardown.deactivated, 1);","});",""].join(`
-`)}function Kd(e,t,n){if(n==="schema"||n==="profile")return[];if(n==="importers"){let a=`${e.replace(/-/g," ")} items`;return[t,`${a} import`,`${a} export`]}return[t]}var Vd={commands:"starter command",hooks:"starter command and after_command hook",search:"starter command, search provider, and vector-store adapter",importers:"starter command, importer, and exporter",schema:"starter command, custom item type, item field, and migration",profile:"starter command and project profile",renderers:"starter command and toon renderer override",parser:"starter command and parser override",preflight:"starter command and preflight override",services:"starter command and output_format service override"},Yd={commands:"`commands`",hooks:"`commands` and `hooks.afterCommand`",search:"`commands`, `searchProviders`, and `vectorStoreAdapters`",importers:"`commands`, `importers`, and `exporters`",schema:"`commands`, `itemTypes`, `itemFields`, and `migrations`",profile:"`commands` and `profiles`",renderers:"`commands` and `renderers`",parser:"`commands` and `parsers`",preflight:"`commands` and `preflights`",services:"`commands` and `services`"};function Xd(e,t,n){let a=n==="parser";return["// The starter command, authored with the `defineCommand` builder so its literal","// name is preserved and the handler `context` is inferred. Exporting it lets you","// unit-test the definition in isolation, apart from the blueprint.","export const pingCommand = defineCommand({",`  name: ${JSON.stringify(t)},`,'  description: "Starter scaffold command. Replace with your own behavior.",',...a?["  flags: [","    {",'      long: "--shout",','      value_type: "boolean",','      description: "Deprecated alias for --upper; the parser override rewrites it.",',"    },","    {",'      long: "--upper",','      value_type: "boolean",','      description: "Echo the canonical flag the parser override produces.",',"    },","  ],"]:[],"  run: async (context) => ({","    ok: true,",`    source: ${JSON.stringify(e)},`,"    command: context.command,",...a?["    upper: context.options.upper === true,"]:[],'    message: "Starter extension scaffold is active.",',"  }),","});"]}function Zd(e,t,n){let a=[],i=[...Xd(e,t,n)],r=["  commands: [pingCommand],"],o=`${e}-search`,s=`${e}-vector`,d=`${e.replace(/-/g," ")} items`,c=e,l=`${e}s`,p=e.replace(/-/g,""),m=p===c?[]:[p],y=`${e.replace(/-/g,"_")}_note`,g=`${e}-0001-init`;switch(n){case"commands":break;case"hooks":a.push("defineAfterCommandHook"),i.push("","// after_command hooks fire once pm finishes a command, receiving the items it","// mutated. React here - sync to an external system, emit telemetry, or refresh",'// derived context ("project management = context management"). This starter is a',"// documented no-op on the success path; replace the body with your own reaction.","export const afterCommandHook = defineAfterCommandHook((context) => {","  if (!context.ok) {","    return;","  }","  // `context.affected` lists the items pm mutated (id, status, changed_fields):","  //   for (const item of context.affected ?? []) { /* ...item.id... */ }","});"),r.push("  hooks: { afterCommand: [afterCommandHook] },");break;case"search":a.push("defineSearchProvider","defineVectorStoreAdapter"),i.push("","// Search providers let packages customize how pm ranks and retrieves project","// context. This starter is deterministic and dependency-free: replace the scoring","// with your domain retrieval, embedding, or rerank logic as the package grows.","export const searchProvider = defineSearchProvider({",`  name: ${JSON.stringify(o)},`,"  query: async (context) => {","    const needle = context.query.toLowerCase();","    const hits = context.documents","      .filter((document) => {",'        const title = String(document.metadata.title ?? "").toLowerCase();',"        return title.includes(needle);","      })","      .map((document) => ({","        id: document.metadata.id,","        score: 1,",'        matched_fields: ["title"],',"      }));","    return { hits };","  },","  embed: async (context) => [context.input.length],","});","","// Vector-store adapters let packages own semantic index storage. This starter","// returns a stable in-memory hit so generated tests can exercise the adapter","// without external services.","export const vectorStoreAdapter = defineVectorStoreAdapter({",`  name: ${JSON.stringify(s)},`,'  query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"  upsert: async (context) => ({ upserted: context.points.length }),","  delete: async (context) => ({ deleted: context.ids.length }),","});"),r.push("  searchProviders: [searchProvider],","  vectorStoreAdapters: [vectorStoreAdapter],");break;case"importers":a.push("defineExporter","defineImporter"),i.push("","// Importers/exporters are the bridge between pm's context graph and another","// project-management system. Keep the starter deterministic so package tests can","// run without touching the network or filesystem; replace these payloads with","// your adapter's real mapping as the package grows.","export const importer = defineImporter(async (context) => ({","  imported: 1,",'  source: context.options.source ?? "starter",',"  args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({","  exported: true,",'  destination: context.options.destination ?? "stdout",',"  args: context.args,","}));"),r.push("  importers: [","    {",`      name: ${JSON.stringify(d)},`,"      importer,","      options: {",`        action: ${JSON.stringify(`${d} import`)},`,'        description: "Import starter records into pm context.",',"        flags: [","          {",'            long: "--source",','            value_name: "name",','            value_type: "string",','            description: "Source name or path to import from.",',"          },","        ],","      },","    },","  ],","  exporters: [","    {",`      name: ${JSON.stringify(d)},`,"      exporter,","      options: {",`        action: ${JSON.stringify(`${d} export`)},`,'        description: "Export pm context into starter records.",',"        flags: [","          {",'            long: "--destination",','            value_name: "name",','            value_type: "string",','            description: "Destination name or path to export to.",',"          },","        ],","      },","    },","  ],");break;case"schema":a.push("defineItemField","defineItemType","defineMigration"),i.push("","// Schema registrations let a package model its own project domain - the heart of",'// "project management = context management". Item types and fields are GLOBAL',"// contributions, so this package declares no `activation.commands` and pm","// activates it conservatively for every command.","export const noteField = defineItemField({",`  name: ${JSON.stringify(y)},`,'  type: "string",',"  optional: true,","});","","export const itemType = defineItemType({",`  name: ${JSON.stringify(c)},`,"  // Replace with your domain's canonical plural folder name.",`  folder: ${JSON.stringify(l)},`,`  aliases: ${JSON.stringify(m)},`,"  // Add field names here to force them at `pm create` time.","  required_create_fields: [],","});","","// Migrations let a package evolve stored items as its schema changes. pm runs each","// migration ONCE through the preflight gate (not once per item), passing a context","// that identifies the migration itself: `context.id` is the migration id (not an","// item id), alongside `context.pm_root`. This starter is a deterministic no-op so","// package tests can invoke it without touching the corpus; replace the body with","// your real rewrite.","export const initMigration = defineMigration({",`  id: ${JSON.stringify(g)},`,`  description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"  mandatory: false,","  run: async (context) => ({ migrated: true, id: context.id }),","});"),r.push("  itemTypes: [itemType],","  itemFields: [noteField],","  migrations: [initMigration],");break;case"profile":a.push("defineProjectProfile"),i.push("","// A project profile is the broadest customization primitive pm has: one","// declarative bundle of item types, custom statuses, fields, a per-type workflow,","// config knobs, create templates, and package recommendations. Once installed it","// resolves by name through `pm profile list/show/apply`, which stages every","// dimension idempotently like a core archetype. A profile registration is a","// schema+config bundle, so the `schema` capability grants it.","export const starterProfile = defineProjectProfile({",...hr(e),"});"),r.push("  profiles: [starterProfile],");break;case"renderers":a.push("defineRendererOverride"),i.push("","// Host-enforced command ownership prevents unrelated output from reaching","// this renderer callback; return a string to take over serialization.","export const toonRenderer = defineRendererOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => {",`    return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,"  },","});"),r.push("  renderers: { toon: toonRenderer },");break;case"parser":a.push("defineParserOverride"),i.push("","// Parser overrides preprocess a command's parsed options BEFORE its handler runs,","// returning a delta - only the keys you set are merged over the parsed input. This","// override is scoped to THIS package's own command; here it rewrites the deprecated","// `--shout` boolean alias to the canonical `--upper` flag.","export const pingParser = defineParserOverride((context) => {","  const options = { ...context.options };","  if (options.shout === true) {","    options.upper = true;","  }","  delete options.shout;","  return { options };","});"),r.push(`  parsers: { ${JSON.stringify(t)}: pingParser },`);break;case"preflight":a.push("definePreflightOverride"),i.push("","// Preflight overrides adjust pm's pre-run gate decision (extension migrations +","// item-format checks) for the commands it owns. Scoped ownership composes with","// other packages; overlapping or legacy global ownership is diagnosed.","// Return a delta of the keys you want to change (enforce_item_format_gate,","// run_preflight_item_format_sync, run_extension_migrations,","// enforce_mandatory_migration_gate); returning context.decision unchanged is a","// safe no-op - replace it with your policy, e.g. { run_extension_migrations: false }.","export const preflightOverride = definePreflightOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => context.decision,","});"),r.push("  preflights: [preflightOverride],");break;case"services":a.push("defineServiceOverride"),i.push("","// Service overrides replace a built-in pm service. The `output_format` service","// renders a command's structured result; returning the payload unchanged passes","// through to pm's default formatting. This override scopes itself to THIS","// package's own command and passes every other command through.","export const outputService = defineServiceOverride((context) => {",`  if (context.command !== ${JSON.stringify(t)}) {`,"    return { handled: false };","  }",`  return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),r.push("  services: { output_format: outputService },");break}return{builderImports:a,definitions:i,blueprintFields:r}}function Qd(e,t,n){let a=Zd(e,t,n);return[`import { ${["composeExtension","defineCommand","defineExtensionBlueprint",...a.builderImports].sort((i,r)=>i.localeCompare(r)).join(", ")} } from "@unbrained/pm-cli/sdk";`,"",...a.definitions,"","// Declarative authoring: describe WHAT the package registers as a blueprint and","// let `composeExtension` generate the `activate` that wires every surface in order,","// instead of hand-writing each `api.register*` call. `defineExtensionBlueprint`","// contract-checks the blueprint where it is authored. Keep `manifest.json`'s","// `capabilities` equal to the set this blueprint derives.","export const blueprint = defineExtensionBlueprint({",...a.blueprintFields,"  // `deactivate` is the teardown counterpart to the generated `activate`: pm runs","  // it on host shutdown/reload to release anything the package opened (timers,","  // connections, caches). This starter holds none, so it stays a no-op.","  deactivate: () => {},","});","","// `composeExtension(blueprint)` is the package's default export \u2014 the runtime","// `ExtensionModule` pm loads. Guard the blueprint with `assertExtensionPreflight`","// in index.test.ts before publishing.","export default composeExtension(blueprint);",""].join(`
-`)}function Dn(e,t,n,a){if(n==="commands")return[];let i=`${e}-search`,r=`${e}-vector`,o=`${e.replace(/-/g," ")} items`,s=e,d=`${e}s`,c=`${e.replace(/-/g,"_")}_note`,l=`${e}-0001-init`,p=["  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${a},`,"  });"],m=y=>[...p,"  let deactivated = false;","  try {",...y.map(g=>g===""?g:`  ${g}`),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce];switch(n){case"hooks":return[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,...m(["  // assertHook throws unless an after_command hook is registered, so reaching the","  // next line already proves the hook is wired.",`  ext.assertHook({ kind: "after_command", extensionName: ${JSON.stringify(e)} });`,"  // runHook fires the hook through pm's real runner with a synthetic context and","  // returns the warnings it produced; a clean hook returns none.","  const warnings = await ext.runHook({",'    kind: "after_command",',"    context: {",`      command: ${JSON.stringify(t)},`,"      args: [],",'      pm_root: "",',"      ok: true,","      affected: [],","    },","  });","  assert.deepEqual(warnings, []);"]),"});",""];case"search":return[`test(${JSON.stringify(`${e} registers and invokes search primitives`)}, async () => {`,...m([`  ext.assertSearchProvider({ name: ${JSON.stringify(i)}, extensionName: ${JSON.stringify(e)} });`,`  ext.assertVectorStoreAdapter({ name: ${JSON.stringify(r)}, extensionName: ${JSON.stringify(e)} });`,"","  // The starter provider reads only document title/id, so `settings` is a minimal","  // typed stub and `documents` carry just the fields it inspects.","  const settings = {","    testing: {","      record_results_to_items: false,","      allow_untrusted_linked_tests: false,","    },","  } as PmSettings;","  const query = await ext.runSearchProvider({",`    provider: ${JSON.stringify(i)},`,'    operation: "query",',"    context: {",'      query: "sync",','      mode: "semantic",','      tokens: ["sync"],',"      options: {},","      settings,","      documents: [",'        { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },','        { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',"      ] as ItemDocument[],","    },","  });",'  assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',"","  const embedding = await ext.runSearchProvider({",`    provider: ${JSON.stringify(i)},`,'    operation: "embed",','    context: { input: "abc", settings, model: "starter-model" },',"  });","  assert.deepEqual(embedding, [3]);","","  const vectorHits = await ext.runVectorStoreAdapter({",`    adapter: ${JSON.stringify(r)},`,'    operation: "query",',"    context: { vector: [0.1, 0.2], limit: 2, settings },","  });",'  assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);']),"});",""];case"importers":return[`test(${JSON.stringify(`${e} registers and invokes import/export primitives`)}, async () => {`,...m([`  ext.assertImporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,`  ext.assertExporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,"","  const imported = await ext.runImporter({",`    importer: ${JSON.stringify(o)},`,'    options: { source: "tickets" },','    args: ["batch-1"],',"  });","  assert.equal(imported.handled, true);",'  assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',"","  const exported = await ext.runExporter({",`    exporter: ${JSON.stringify(o)},`,'    options: { destination: "archive" },','    args: ["done"],',"  });","  assert.equal(exported.handled, true);",'  assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });']),"});",""];case"schema":return[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,...m(dr({extensionName:e,itemTypeName:s,itemTypeFolder:d,fieldName:c,migrationId:l})),"});",""];case"profile":return[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,...m(lr(e)),"});",""];case"renderers":return[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,...m(["  // assertRendererOverride throws unless a renderer is registered for the format,","  // so reaching the next line already proves the wiring.",`  const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,'  assert.equal(override.format, "toon");',"","  // runRendererOverride renders through pm's real runner. The override customizes","  // only THIS package's command output and returns a string the host uses verbatim.","  const rendered = await ext.runRendererOverride({",'    format: "toon",',`    command: ${JSON.stringify(t)},`,"    result: { ok: true },","  });","  assert.equal(rendered.overridden, true);","  assert.equal(rendered.rendered, JSON.stringify({ ok: true }));","","  // Output for any other command passes through to pm's default renderer.","  const passthrough = await ext.runRendererOverride({",'    format: "toon",','    command: "list",',"    result: { ok: true },","  });","  assert.equal(passthrough.overridden, false);"]),"});",""];case"parser":return[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,...m(["  // assertParserOverride throws unless a parser is registered for the command, so","  // reaching the next line already proves the wiring.",`  ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,"","  // runParserOverride runs the override through pm's real parser runner and returns","  // the rewritten context. The starter rewrites the deprecated `shout` alias to the","  // canonical `upper` flag.","  const result = await ext.runParserOverride({",`    command: ${JSON.stringify(t)},`,"    args: [],","    options: { shout: true },","    global: {},",'    pm_root: "",',"  });","  assert.equal(result.overridden, true);","  assert.deepEqual(result.context.options, { upper: true });","","  // End to end: feed the rewritten options into the command handler to prove","  // `pm <command> --shout` surfaces the normalized `upper` flag in the result.",`  const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`,"  assert.equal(invocation.handled, true);","  assert.deepEqual(invocation.result, {","    ok: true,",`    source: ${JSON.stringify(e)},`,`    command: ${JSON.stringify(t)},`,"    upper: true,",'    message: "Starter extension scaffold is active.",',"  });"]),"});",""];case"preflight":return[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,...m(["  // assertPreflightOverride throws unless a preflight override is registered, so","  // reaching the next line already proves the wiring.",`  ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,"","  // runPreflightOverride runs the override through pm's real runner with a synthetic","  // gate decision. The starter echoes the decision unchanged; replace the","  // values/assertions with your real policy.","  const decision = {","    enforce_item_format_gate: true,","    run_preflight_item_format_sync: false,","    run_extension_migrations: true,","    enforce_mandatory_migration_gate: false,","  };","  const result = await ext.runPreflightOverride({",`    command: ${JSON.stringify(t)},`,"    args: [],","    options: {},","    global: {},",'    pm_root: "",',"    decision,","  });","  assert.equal(result.overridden, true);","  assert.deepEqual(result.decision, decision);"]),"});",""];case"services":return[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,...m(["  // assertServiceOverride throws unless a service override is registered for the","  // service, so reaching the next line proves the wiring.",`  ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,"","  // runServiceOverride runs the override through pm's real service runner. The","  // override customizes only THIS package's command output (handled), passing every","  // other command through (not handled).","  const handled = await ext.runServiceOverride({",'    service: "output_format",',`    command: ${JSON.stringify(t)},`,"    payload: { ok: true },","  });","  assert.equal(handled.handled, true);",`  assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,"","  // Output for any other command passes through to pm's default formatter.","  const passthrough = await ext.runServiceOverride({",'    service: "output_format",','    command: "list",',"    payload: { ok: true },","  });","  assert.equal(passthrough.handled, false);"]),"});",""]}}function el(e,t,n){let a=n==="parser",i=JSON.stringify([...pr[n]].sort());return['import assert from "node:assert/strict";','import { test } from "node:test";','import { assertExtensionDeactivated, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, createExtensionTestHarness } from "@unbrained/pm-cli/sdk/testing";',...n==="search"?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension, { blueprint } from "./index.ts";','import manifest from "./manifest.json" with { type: "json" };',"",...cr,`test(${JSON.stringify(`${e} passes author-time preflight`)}, () => {`,"  // assertExtensionPreflight is the author-time capstone: it lints the blueprint,","  // synthesizes the least-privilege manifest from `identity`, and checks the version","  // bounds against `target` in one call, throwing on any blocking finding. It returns","  // the full report so you can inspect the derived data.","  const report = assertExtensionPreflight(blueprint, {","    identity: {",`      name: ${JSON.stringify(e)},`,'      version: "0.1.0",','      entry: "./index.ts",',"      priority: 0,",`      pm_min_version: ${JSON.stringify(je)},`,"    },",`    target: { pmVersion: ${JSON.stringify(je)} },`,"  });","  // Fail the starter suite whenever the checked-in manifest drifts from the","  // capabilities derived from the blueprint.","  assertExtensionManifestMatchesBlueprint(manifest, blueprint);","  // The capability set is DERIVED from the blueprint, never hand-synced. Keep","  // manifest.json's `capabilities` equal to this list (set match, sorted).",`  assert.deepEqual(report.capabilities, ${i});`,`  assert.deepEqual(report.manifest?.capabilities, ${i});`,"});","",`test(${JSON.stringify(`${e} registers and runs its starter command`)}, async () => {`,"  // createExtensionTestHarness activates the composed module once and binds the","  // assert*/run*/deactivate helpers to the right activation sub-registry, so you","  // never thread activation.registrations vs activation.commands by hand.","  // `capabilities` mirrors manifest.json so the in-memory activation grants what the","  // blueprint needs.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${i},`,"  });","  let deactivated = false;","  try {","    // assertCommandContract throws unless the command is registered, so reaching","    // the next line already proves the wiring; assert on the returned definition","    // to demonstrate inspecting registered metadata.",`    const registered = ext.assertCommandContract({ name: ${JSON.stringify(t)} });`,'    assert.equal(typeof registered.command.description, "string");',"","    // runCommand invokes the handler through pm's real dispatch engine, so this","    // asserts behavior - not just that the command is wired. Replace these","    // assertions as you flesh out your command.",`    const invocation = await ext.runCommand({ command: ${JSON.stringify(t)} });`,"    assert.equal(invocation.handled, true);","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,...a?["      upper: false,"]:[],'      message: "Starter extension scaffold is active.",',"    });","    // deactivate runs pm's real teardown engine over the module; exactly one","    // extension tears down with no failures.","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...ce,"});","",...Dn(e,t,n,i)].join(`
-`)}function tl(e,t,n){let a=ur(n,"package"),i=fr(n,"package");return[`# ${e}`,"","Generated by `pm package init --declarative`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",a,`- \`index.ts\`: the TypeScript manifest entry \u2014 a \`defineExtensionBlueprint\` blueprint (${Vd[n]}) composed into the runtime module by \`composeExtension\`, plus a \`deactivate\` teardown stub.`,"- `index.test.ts`: sample `node:test` suite covering author-time preflight (`assertExtensionPreflight`) and runtime surface invocation/teardown via `createExtensionTestHarness`.",mr,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Declarative Authoring","`index.ts` uses the SDK's declarative authoring loop instead of an imperative","`activate` body. You describe WHAT the package registers as an","`ExtensionBlueprint` and `composeExtension` generates the `activate` that wires","every surface in order:","- The `define*` builders author each surface with literal-type preservation and","  contextual handler inference (`defineCommand`, `defineSearchProvider`,","  `defineItemType`, `defineParserOverride`, ...).","- `defineExtensionBlueprint({ ... })` collects the definitions into the blueprint;",`  this starter populates ${Yd[n]}. Add more`,"  fields as the package grows.","- `composeExtension(blueprint)` is the default export \u2014 the runtime module pm","  loads. Its generated `activate` requires exactly the capabilities the blueprint","  derives, so `manifest.json`'s `capabilities` never drift.","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`index.test.ts` exercises both authoring capstones: `assertExtensionPreflight`","(the author-time lint + manifest synthesis + version-compatibility check over the","exported `blueprint`) and `createExtensionTestHarness` (the runtime fixture whose","`assert*`/`run*`/`deactivate` methods bind to the right activation sub-registry).","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.",...i,"","## Compatibility Bounds","`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Nn}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${je}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
-`)}function nl(e){let t=e,n=e.replace(/-/g,"");return{searchProviderName:`${e}-search`,vectorAdapterName:`${e}-vector`,adapterName:`${e.replace(/-/g," ")} items`,itemTypeName:t,itemTypeFolder:`${e}s`,itemTypeAliases:n===t?[]:[n],fieldName:`${e.replace(/-/g,"_")}_note`,migrationId:`${e}-0001-init`}}function al(e){return["defineCommand",...e==="hooks"?["defineAfterCommandHook"]:[],...e==="search"?["defineSearchProvider","defineVectorStoreAdapter"]:[],...e==="importers"?["defineImporter","defineExporter"]:[],...e==="schema"?["defineItemType","defineItemField","defineMigration"]:[],...e==="profile"?["defineProjectProfile"]:[],...e==="renderers"?["defineRendererOverride"]:[],...e==="parser"?["defineParserOverride"]:[],...e==="preflight"?["definePreflightOverride"]:[],...e==="services"?["defineServiceOverride"]:[]].join(", ")}function il(e,t,n,a){let i=["export const pingCommand = defineCommand({",`  name: ${JSON.stringify(t)},`,'  description: "Starter scaffold command. Replace with your own behavior.",',...n==="parser"?["  flags: [",'    { long: "--shout", value_type: "boolean", description: "Deprecated alias for --upper." },','    { long: "--upper", value_type: "boolean", description: "Canonical flag the parser produces." },',"  ],","  run: (context) => ({ ok: true, command: context.command, upper: context.options.upper === true }),"]:["  run: (context) => ({ ok: true, command: context.command }),"],"});"];return n==="hooks"&&i.push("","export const afterCommandHook = defineAfterCommandHook((context) => {","  if (!context.ok) return;","  // React to context.affected here as your package grows.","});"),n==="search"&&i.push("","export const searchProvider = defineSearchProvider({",`  name: ${JSON.stringify(a.searchProviderName)},`,"  query: async (context) => ({","    hits: context.documents",'      .filter((document) => String(document.metadata.title ?? "").toLowerCase().includes(context.query.toLowerCase()))','      .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: ["title"] })),',"  }),","  embed: async (context) => [context.input.length],","});","","export const vectorStoreAdapter = defineVectorStoreAdapter({",`  name: ${JSON.stringify(a.vectorAdapterName)},`,'  query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"  upsert: async (context) => ({ upserted: context.points.length }),","  delete: async (context) => ({ deleted: context.ids.length }),","});"),n==="importers"&&i.push("","export const importer = defineImporter(async (context) => ({","  imported: 1,",'  source: context.options.source ?? "starter",',"  args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({","  exported: true,",'  destination: context.options.destination ?? "stdout",',"  args: context.args,","}));"),n==="schema"&&i.push("",`export const noteField = defineItemField({ name: ${JSON.stringify(a.fieldName)}, type: "string", optional: true });`,"","export const itemType = defineItemType({",`  name: ${JSON.stringify(a.itemTypeName)},`,`  folder: ${JSON.stringify(a.itemTypeFolder)},`,`  aliases: ${JSON.stringify(a.itemTypeAliases)},`,"  required_create_fields: [],","});","","export const initMigration = defineMigration({",`  id: ${JSON.stringify(a.migrationId)},`,`  description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"  mandatory: false,","  run: async (context) => ({ migrated: true, id: context.id }),","});"),n==="profile"&&i.push("","export const starterProfile = defineProjectProfile({",`  name: ${JSON.stringify(e)},`,`  title: ${JSON.stringify(`${e} archetype`)},`,'  summary: "Starter project profile. Replace these dimensions with your own archetype.",',"  types: [",`    { name: ${JSON.stringify(a.itemTypeName)}, folder: ${JSON.stringify(a.itemTypeFolder)} },`,"  ],","  // ...plus statuses, fields, workflows, config, templates, and packages.","});"),n==="renderers"&&i.push("","export const toonRenderer = defineRendererOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => JSON.stringify(context.result),","});"),n==="parser"&&i.push("","export const pingParser = defineParserOverride((context) => {","  const options = { ...context.options };","  if (options.shout === true) options.upper = true;","  delete options.shout;","  return { options };","});"),n==="preflight"&&i.push("","// Return a delta of the gate-decision keys you want to change; returning","// context.decision unchanged is a safe no-op (e.g. { run_extension_migrations: false }).","export const preflightOverride = definePreflightOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => context.decision,","});"),n==="services"&&i.push("","export const outputService = defineServiceOverride((context) => {",`  if (context.command !== ${JSON.stringify(t)}) return { handled: false };`,`  return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),i}function rl(e,t,n){let a=[];return t==="renderers"&&a.push('  api.registerRenderer("toon", toonRenderer.run, toonRenderer);'),t==="parser"&&a.push(`  api.registerParser(${JSON.stringify(e)}, pingParser);`),t==="preflight"&&a.push("  api.registerPreflight(preflightOverride);"),t==="services"&&a.push('  api.registerService("output_format", outputService);'),t==="hooks"&&a.push("  api.hooks.afterCommand(afterCommandHook);"),t==="search"&&a.push("  api.registerSearchProvider(searchProvider);","  api.registerVectorStoreAdapter(vectorStoreAdapter);"),t==="schema"&&a.push("  api.registerItemFields([noteField]);","  api.registerItemTypes([itemType]);","  api.registerMigration(initMigration);"),t==="profile"&&a.push("  api.registerProfile(starterProfile);"),t==="importers"&&a.push(`  api.registerImporter(${JSON.stringify(n.adapterName)}, importer, {`,`    action: ${JSON.stringify(`${n.adapterName} import`)},`,'    description: "Import starter records into pm context.",',"    flags: [","      {",'        long: "--source",','        value_name: "name",','        value_type: "string",','        description: "Source name or path to import from.",',"      },","    ],","  });",`  api.registerExporter(${JSON.stringify(n.adapterName)}, exporter, {`,`    action: ${JSON.stringify(`${n.adapterName} export`)},`,'    description: "Export pm context into starter records.",',"    flags: [","      {",'        long: "--destination",','        value_name: "name",','        value_type: "string",','        description: "Destination name or path to export to.",',"      },","    ],","  });"),a}function ol(e,t,n,a="commands",i=!1){let r=`pm-${e}`,o=pr[a],s=Kd(e,t,a),d=`${JSON.stringify({name:e,version:"0.1.0",entry:"./index.ts",manifest_version:Nn,pm_min_version:je,trusted:!0,sandbox_profile:"strict",permissions:{...Nd},capabilities:o,...s.length>0?{activation:{commands:s}}:{}},null,2)}
-`,c=['import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"","export function activate(api: ExtensionApi): void {",...Bd(e,t,a),"}","","// `deactivate` is the teardown counterpart to `activate`: pm runs it on host","// shutdown/reload (e.g. the MCP server between requests) to release anything","// `activate` opened - timers, connections, caches. This starter holds no such","// resources, so it stays a documented no-op; add cleanup here as you grow.","export function deactivate(): void {}","","export default {","  activate,","  deactivate,","};",""].join(`
-`),l=`${JSON.stringify(Ld,null,2)}
-`,p=Md[a],m=ur(a,"package"),y=`${JSON.stringify({name:r,version:"0.1.0",private:!0,type:"module",keywords:["pm-package"],engines:{node:Rd},scripts:{typecheck:"tsc --noEmit","test:runtime":"node --test",test:"npm run typecheck && npm run test:runtime"},peerDependencies:{"@unbrained/pm-cli":`>=${je}`},devDependencies:{"@types/node":jd,typescript:Dd},pm:{aliases:[e],extensions:["."],docs:["README.md"],examples:["README.md"],catalog:{display_name:e,category:"workflow",summary:"Starter pm package scaffold.",tags:["starter"]}}},null,2)}
-`,g=Hd(e,t,a),_=Ud[a],u=["node_modules/","*.log","*.tsbuildinfo",""].join(`
-`),w=nl(e),v=["```ts",`import { ${al(a)} } from "@unbrained/pm-cli/sdk";`,'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"",...il(e,t,a,w),"","export function activate(api: ExtensionApi): void {","  api.registerCommand(pingCommand);",...rl(t,a,w),"}","","export function deactivate(): void {}","","export default { activate, deactivate };","```"],S=[`# ${r}`,"","Generated by `pm package init` or `pm extension init`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",m,p,_,mr,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.","","## Authoring With define* Builders","`index.ts` is authored fully in TypeScript so every registration is checked","against the SDK contracts at author time. Use the public SDK authoring","builders for exported definitions you want literal-type preservation,","contextual handler inference, and direct unit tests for:",...v,"The builders return their argument unchanged; runtime validation still lives","in `api.register*`, and behavior validation lives in `sdk/testing`.",...zd[a],...fr(a,"package"),"","## Compatibility Bounds",`- \`peerDependencies["@unbrained/pm-cli"]\` uses the stable range \`>=${je}\`. Keep a normal stable range instead of pinning a date ordinal: SemVer excludes prerelease ordinals such as \`2026.7.24-3\`, while daily stable releases continue to satisfy the range.`,"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Nn}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${je}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
-`);return{"package.json":y,"manifest.json":d,"index.ts":i?Qd(e,t,a):c,"index.test.ts":i?el(e,t,a):g,"tsconfig.json":l,".gitignore":u,"README.md":i?tl(r,t,a):S}}async function gr(e,t="extension",n="commands",a=!1){let i=n.trim().toLowerCase();if(!sr.includes(i))throw new f(`Unknown scaffold capability "${n}". Supported capabilities: ${sr.join(", ")}.`,h.USAGE);let r=i;if(a&&t!=="package")throw new f("--declarative scaffolds a package-mode blueprint starter (composeExtension is a runtime SDK import). Use `pm package init`, not `pm extension init`.",h.USAGE);let o=a?"declarative":"imperative",s=e.trim(),d=lt.resolve(process.cwd(),s),c=Dt(lt.basename(d)).replace(/^(?:pm-)+/u,""),l=Wd(c),p=ol(c,l,t,r,a),m=!1;if(await k(d)){if(!(await dt.stat(d)).isDirectory())throw new f(`Scaffold target "${d}" exists and is not a directory.`,h.CONFLICT)}else await dt.mkdir(d,{recursive:!0}),m=!0;for(let[g,_]of Object.entries(p)){let u=lt.join(d,g);if(await k(u)&&await dt.readFile(u,"utf8")!==_)throw new f(`Scaffold file "${g}" already exists with different content in "${d}". Choose a new target path or remove conflicting files.`,h.CONFLICT)}let y=[];for(let[g,_]of Object.entries(p)){let u=lt.join(d,g);if(await k(u)){y.push({path:g,status:"unchanged"});continue}await dt.mkdir(lt.dirname(u),{recursive:!0}),await dt.writeFile(u,_,"utf8"),y.push({path:g,status:"created"})}return{extension_name:c,package_name:`pm-${c}`,command_name:l,invocation_command:`pm ${l}`,capability:r,style:o,target_path:d,created_directory:m,files:y}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="3984f1ef-1703-5a83-a4fa-ec1cdc738572")}catch{}})();var yr=[["commands","Commands"],["command_overrides","Command overrides"],["flag_commands","Flag commands"],["item_types","Item types"],["item_fields","Item fields"],["migrations","Migrations"],["profiles","Profiles"],["importers","Importers"],["exporters","Exporters"],["search_providers","Search providers"],["vector_store_adapters","Vector store adapters"],["assurance_providers","Assurance measurement providers"],["hooks","Lifecycle hooks"],["parser_overrides","Parser overrides"],["service_overrides","Service overrides"],["renderer_overrides","Renderer overrides"]];function jn(e){return"#".repeat(e)}function _r(e){if(!e.includes("`"))return`\`${e}\``;let t=0,n=0;for(let r of e)n=r==="`"?n+1:0,t=Math.max(t,n);let a="`".repeat(t+1),i=e.startsWith("`")||e.endsWith("`")?" ":"";return`${a}${i}${e}${i}${a}`}function sl(e){return e.length===0?"Capabilities: _none registered_":`Capabilities: ${e.map(_r).join(", ")}`}function cl(e,t,n){let a=[`${jn(t)} ${e}`,""];return n.length===0?(a.push("_None._",""),a):(a.push(...n.map(i=>`- ${_r(i)}`),""),a)}function dl(e,t,n){return e===0&&!n?[]:[`${jn(t)} Preflight overrides`,"",e>0?`- ${e} registered (this surface carries no per-entry identifier)`:"_None._",""]}function Ln(e,t={}){let n=t.headingLevel??2;if(!Number.isInteger(n)||n<1||n>6)throw new RangeError(`headingLevel must be an integer in [1, 6], received ${String(t.headingLevel)}`);let a=Math.min(n+1,6),i=t.includeEmpty===!0,r=t.title??"Extension surfaces",o=[`${jn(n)} ${r}`,""];(i||e.capabilities.length>0)&&o.push(sl(e.capabilities),"");for(let[s,d]of yr){let c=e[s]??[];c.length===0&&!i||o.push(...cl(d,a,c))}return o.push(...dl(e.preflight_overrides,a,i)),!(e.preflight_overrides>0||yr.some(([s])=>(e[s]?.length??0)>0))&&!i&&o.push("_This extension registers no surfaces._",""),`${o.join(`
+import{$c as Re,E as Wa,H as Tt,I as Ot,L as Pe,Q as Ba,R as un,_c as Ka,ad as at,bd as Va,cd as Ya,dd as ae,ed as ze,fd as Xa,g as Se,gd as se,hc as Ha,k as Ua,l as za,m as Ee,n as Ga,nf as Ct,o as Ja,qe as Za,y as qa}from"./chunk-5DKCD4KV.js";import{i as ei,n as ti,p as ni}from"./chunk-ZEI3DC5E.js";import{Aa as ya,Ac as Ca,Ai as xe,Bb as xa,Bd as Na,Cb as Sa,Cc as It,Cd as oe,Db as Ea,Dc as Pa,Ec as Ra,G as ma,Gb as $a,Hb as Ia,Oc as J,Pb as Aa,Q as St,R as on,Rb as Ta,Rf as Ue,S as sn,Sa as Et,Se as T,Ta as _a,Ua as cn,Ub as Ce,Va as dn,Wa as ln,Ya as wa,Za as va,Zc as B,ab as ba,bf as ne,eg as I,fg as V,gg as Da,hb as ka,hg as K,ig as Q,j as ca,jh as La,ji as mn,kg as ja,li as Fa,mg as nt,mi as ke,na as ua,oa as fa,og as At,oh as q,pa as W,rc as pn,ri as Ma,sc as Oa,tc as $t,ui as ue,v as H,vc as ve,xa as F,xc as be,ya as ha,z as we,za as ga,zi as A}from"./chunk-F76ZUP73.js";import{f as Qa}from"./chunk-ZDVTXLA6.js";import{A as h,C as f,E as k,F as xt,G as _e,H as G,K as me,a as da,d as kt,m as la,t as an,v as pa,y as rn}from"./chunk-R7KWBFM2.js";import{mkdir as ws,readFile as vs}from"node:fs/promises";import oi 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]="1fae5539-4eb8-5eba-bfd6-a191c89448ec")}catch{}})();var fn=class extends Error{constructor(t="Workspace transaction interrupted"){super(t),this.name="WorkspaceTransactionInterruptedError"}},bs="sdk-workspace-transaction",ks=/^[a-zA-Z0-9._-]+$/,xs=30,Ss=3e3;function si(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n||!ks.test(n))throw new TypeError(`${t} must match [a-zA-Z0-9._-]+`);return n}function ai(e,t){if(typeof e!="string")throw new TypeError(`${t} must be a string`);let n=e.trim();if(!n)throw new TypeError(`${t} must be non-empty`);return n}function Es(e){return{pmRoot:ai(e.pmRoot,"Transaction pmRoot"),transactionId:si(e.transactionId,"Transaction id"),author:ai(e.author,"Transaction author")}}function ii(e,t,n){let a=e??t;if(!Number.isInteger(a)||a<=0)throw new TypeError(`${n} must be a positive integer`);return a}function ci(e,t){return oi.join(e,"transactions","sdk",`${t}.json`)}async function $e(e,t){t.updatedAt=T();let n=ci(e,t.transactionId);await ws(oi.dirname(n),{recursive:!0}),await me(n,`${JSON.stringify(t,null,2)}
+`)}function $s(e){return Number.isInteger(e.attempt)&&typeof e.author=="string"&&typeof e.createdAt=="string"&&typeof e.updatedAt=="string"}function Ne(e){return Object.assign(Object.create(null),e)}function Is(e,t){try{let n=JSON.stringify(e,(a,i)=>{if(typeof i=="number"&&!Number.isFinite(i))throw new TypeError(`${t} contains a non-finite number`);if(i===void 0||typeof i=="function"||typeof i=="symbol")throw new TypeError(`${t} contains a non-JSON value`);return i});return JSON.parse(n)}catch(n){throw new TypeError(`${t} must be JSON serializable`,{cause:n})}}function hn(e,t){return e===void 0?void 0:Is(e,t)}function gn(e,t,n,a){let i=hn(n,a);i===void 0?delete e[t]:e[t]=i}function ri(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function yn(e,t){return Array.isArray(e)&&new Set(e).size===e.length&&e.every(n=>typeof n=="string"&&t.includes(n))}function As(e,t){if(!yn(e.startedStepIds,t)||!yn(e.completedStepIds,t)||!ri(e.results)||!ri(e.compensationData))return!1;let n=e.startedStepIds,a=new Set(n),i=e.completedStepIds,r=new Set(i);return Object.keys(e.compensationData).some(o=>!a.has(o))||Object.keys(e.results).some(o=>!r.has(o))?!1:e.status==="committed"?t.every(o=>r.has(o)):e.status!=="compensated"||r.size===0&&a.size===0}function Pt(e,t){return new f(`Workspace transaction ${e} journal is invalid (${t})`,h.CONFLICT,{code:"transaction_journal_invalid",required:"A valid durable journal is required before transaction recovery can continue.",why:"Corrupt journal data cannot establish which steps applied or still require compensation.",nextSteps:["Preserve the journal and inspect its integrity or restore a verified backup before retrying.","Do not switch to a new transaction id to bypass an unreadable journal; previously applied work may remain."]})}function Ts(e){return new f(`Workspace transaction ${e} journal does not match the supplied plan`,h.CONFLICT,{code:"transaction_plan_mismatch",required:"Replay the exact plan that started this transaction, or start a new transaction with a different id.",why:"A journal records the plan it is resuming; applying a different plan under the same id could skip or duplicate steps.",nextSteps:["Re-run with the original document to resume or replay it.","Pass --transaction-id <new-id> (or a new transactionId over MCP) to commit the changed plan as its own transaction.","Run pm ops gc --scope transactions --dry-run to inspect abandoned journals before pruning them."]})}function Os(e,t,n){let a;try{a=JSON.parse(e)}catch{throw Pt(t,"invalid JSON")}if(!a||typeof a!="object"||Array.isArray(a))throw Pt(t,"expected an object");let i=a;if(!(i.schemaVersion===1&&i.transactionId===t))throw Pt(t,"schema version or transaction id does not match the journal file");let r=i.stepIds;if(!Array.isArray(r)||!yn(r,r)||!As(i,r)||!$s(i)||typeof i.status!="string"||!["applying","compensating","compensated","committed"].includes(i.status))throw Pt(t,"invalid lifecycle, metadata, status or step ids");if(!(i.status==="compensated"||r.length===n.length&&r.every((o,s)=>o===n[s])))throw Ts(t);return{...i,results:Ne(i.results),compensationData:Ne(i.compensationData)}}async function Cs(e,t,n,a,i){let r=i,o=r!==void 0;if(r?.status==="compensating"&&await di(e,r),r===void 0||r.status==="compensated"){let s=T();r={schemaVersion:1,transactionId:t,author:n,status:"applying",attempt:(r?.attempt??0)+1,createdAt:r?.createdAt??s,updatedAt:s,stepIds:a,startedStepIds:[],completedStepIds:[],results:Ne(),compensationData:Ne()},await $e(e.pmRoot,r),await fe(e,r,"prepared")}return{journal:r,recovered:o}}async function Ps(e,t,n){try{await Ns(t,e.steps),await $e(e.pmRoot,t);let a=new Set(t.completedStepIds),i=new Set(t.startedStepIds);for(let r of e.steps){if(a.has(r.id))continue;let o=await r.inspect(),s=hn(o.result,`Step ${r.id} result`);if(o.state!=="applied"){let d=await r.prepareCompensation?.();gn(t.compensationData,r.id,d,`Step ${r.id} compensation data`),i.add(r.id),t.startedStepIds=e.steps.map(l=>l.id).filter(l=>i.has(l)),await $e(e.pmRoot,t);let c=await r.apply();s=hn(c,`Step ${r.id} result`)}await fe(e,t,"step_applied",r.id),a.add(r.id),t.completedStepIds=e.steps.map(d=>d.id).filter(d=>a.has(d)),gn(t.results,r.id,s,`Step ${r.id} result`),await $e(e.pmRoot,t),await fe(e,t,"step_recorded",r.id)}return await fe(e,t,"committing"),t.status="committed",await $e(e.pmRoot,t),await fe(e,t,"committed"),{transactionId:t.transactionId,status:"committed",recovered:n,results:Ne(t.results)}}catch(a){if(a instanceof fn||t.status==="committed")throw a;try{await di(e,t)}catch(i){throw new AggregateError([a,i],`Workspace transaction failed and compensation failed: ${String(i)}`,{cause:i})}throw a}}async function Rs(e,t,n){try{return Os(await vs(ci(e,t),"utf8"),t,n)}catch(a){if(a!==null&&typeof a=="object"&&"code"in a&&_e(a))return;throw a}}async function fe(e,t,n,a){await e.onTransition?.({transactionId:t.transactionId,attempt:t.attempt,transition:n,...a===void 0?{}:{stepId:a}})}async function Ns(e,t){let n=new Set,a=Ne();for(let i of t){let r=await i.inspect();r.state==="applied"&&(n.add(i.id),gn(a,i.id,r.result,`Step ${i.id} result`))}e.results=a,e.completedStepIds=t.map(i=>i.id).filter(i=>n.has(i))}async function di(e,t){t.status="compensating",await $e(e.pmRoot,t),await fe(e,t,"compensating");let n=new Set(t.completedStepIds),a=new Set(t.startedStepIds);for(let i of[...e.steps].reverse()){if(!a.has(i.id)&&!n.has(i.id))continue;let r;try{r=a.has(i.id)&&(await i.inspect()).state==="applied"}catch{r=a.has(i.id)}r&&(await fe(e,t,"step_compensating",i.id),await i.compensate(t.compensationData[i.id])),n.delete(i.id),a.delete(i.id),t.completedStepIds=e.steps.map(o=>o.id).filter(o=>n.has(o)),t.startedStepIds=e.steps.map(o=>o.id).filter(o=>a.has(o)),delete t.results[i.id],delete t.compensationData[i.id],await $e(e.pmRoot,t),await fe(e,t,"step_compensated",i.id)}t.status="compensated",await $e(e.pmRoot,t),await fe(e,t,"compensated")}async function li(e){let{pmRoot:t,transactionId:n,author:a}=Es(e),i=ii(e.lockTtlSeconds,xs,"Transaction lock TTL"),r=ii(e.lockWaitMs,Ss,"Transaction lock wait"),o=[...e.steps];if(o.length===0)throw new TypeError("Workspace transaction requires at least one step");let s=o.map(l=>{let p=si(l.id,"Transaction step id");if(p!==l.id)throw new TypeError("Transaction step id must not contain surrounding whitespace");return p});if(new Set(s).size!==s.length)throw new TypeError("Workspace transaction step ids must be unique");let d={...e,pmRoot:t,transactionId:n,author:a,steps:o,lockTtlSeconds:i,lockWaitMs:r},c=await ne(t,bs,i,a,!1,!1,r);try{let l=await Rs(t,n,s),p=l!==void 0;if(l?.status==="committed")return{transactionId:n,status:"committed",recovered:!0,results:Ne(l.results)};let m=await Cs(d,n,a,s,l);return await Ps(d,m.journal,p||m.recovered)}finally{await c()}}import Ds from"node:fs/promises";import js 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]="7be00b26-4a56-5399-94f6-f2f67cc5c1e6")}catch{}})();function _n(e){return js.join(e,"extension-migrations.json")}function pi(e,t){let n=e.definition.id;return typeof n=="string"&&n.trim().length>0?n.trim():`migration-${String(t+1).padStart(3,"0")}`}function mi(e,t){return`${e.layer}:${e.name}:${t}`}async function Ls(e){let t=_n(e);if(!await k(t))return{version:1,updated_at:"",entries:[]};let n=JSON.parse(await Ds.readFile(t,"utf8"));return{version:1,updated_at:typeof n.updated_at=="string"?n.updated_at:"",entries:Array.isArray(n.entries)?n.entries.filter(a=>typeof a?.key=="string"&&(a.status==="applied"||a.status==="failed")):[]}}async function Fs(e,t){let n=await Ls(e),a=new Map(n.entries.map(i=>[i.key,i]));return t.forEach((i,r)=>{let o=pi(i,r),s=a.get(mi(i,o));s&&(i.definition.status=s.status,s.status==="failed"?i.definition.reason=s.error:(delete i.definition.reason,delete i.definition.error,delete i.definition.message))}),n}async function Ms(e){let t=await Fs(e.pmRoot,e.migrations),n=new Map(t.entries.map(l=>[l.key,l])),a=[],i=!1,r=e.migrations.map((l,p)=>({migration:l,index:p})).filter(({migration:l})=>e.scope===void 0||l.layer===e.scope);for(let{migration:l,index:p}of r){let m=pi(l,p),y=mi(l,m),g=n.get(y),_=String(l.definition.status??"pending").toLowerCase(),u=g?.status??(_==="applied"||_==="failed"?_:"pending");if(u==="applied"){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"skipped"});continue}if(e.dryRun===!0){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"pending"});continue}let w=l.runtime_definition?.run??l.definition.run;if(typeof w!="function"){a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"pending"});continue}let v=new Date().toISOString();try{await Promise.resolve(w({id:m,command:"migration",layer:l.layer,extension:l.name,pm_root:e.pmRoot,status:u}));let E={key:y,layer:l.layer,extension:l.name,id:m,status:"applied",attempted_at:v};n.set(y,E),l.definition.status="applied",delete l.definition.reason,delete l.definition.error,delete l.definition.message,a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"applied"}),i=!0}catch(E){let S=E instanceof Error?E.message:String(E),C={key:y,layer:l.layer,extension:l.name,id:m,status:"failed",attempted_at:v,error:S};n.set(y,C),l.definition.status="failed",l.definition.reason=S,a.push({key:y,layer:l.layer,extension:l.name,id:m,before:u,outcome:"failed",error:S}),i=!0}}if(i){let l=await A(e.pmRoot),p={version:1,updated_at:new Date().toISOString(),entries:[...n.values()].sort((m,y)=>m.key.localeCompare(y.key))};await ke({pmRoot:e.pmRoot,filePath:_n(e.pmRoot),raw:`${JSON.stringify(p,null,2)}
+`,op:"extension_migrations_apply",author:e.author,lockTtlSeconds:l.locks.ttl_seconds,lockWaitMs:l.locks.wait_ms})}let o=a.filter(l=>l.outcome==="pending").length,s=a.filter(l=>l.outcome==="applied").length,d=a.filter(l=>l.outcome==="skipped").length,c=a.filter(l=>l.outcome==="failed").length;return{ok:c===0,dry_run:e.dryRun===!0,state_path:_n(e.pmRoot),total:a.length,pending_count:o,applied_count:s,skipped_count:d,failed_count:c,migrations:a}}async function ui(e){let t=await A(e.resolvedRoots.settings_root),n=await ve({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),a=await be(n);e.warnings.push(...n.warnings,...a.warnings);let i=await Ms({pmRoot:e.resolvedRoots.pm_root,migrations:a.registrations.migrations,author:typeof e.global.author=="string"&&e.global.author.trim().length>0?e.global.author.trim():"pm-extension-migration",dryRun:e.options.dryRun===!0,...e.scope==="global"?{scope:"global"}:{}});return e.withResult({migration:i,load_failure_count:n.failed.length,activation_failure_count:a.failed.length},i.ok)}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="184c43e0-a543-5b0b-ac09-9139ba5ded6a")}catch{}})();var Us=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function Ge(e,t={}){let n=new Set;t.extensionName!==void 0&&n.add(It(t.extensionName));for(let u of t.extensionNames??[])n.add(It(u));let a=u=>n.size===0||n.has(It(u)),i=(u,w)=>fi(u.filter(v=>a(v.name)).map(w)),r=(u,w)=>fi(u.filter(v=>a(v.name)).flatMap(w)),{registrations:o,commands:s,parsers:d,preflight:c,services:l,renderers:p,hooks:m}=e,y=r(o.relationship_kinds??[],u=>u.definitions.map(w=>w.kind)),g=p.overrides.filter(u=>a(u.name)&&((u.commands?.length??0)>0||u.resultDiscriminator!==void 0)).map(u=>({format:u.format,commands:[...u.commands??[]],result_discriminator:u.resultDiscriminator!==void 0})).sort((u,w)=>u.format.localeCompare(w.format)),_=i(o.assurance_providers??[],u=>u.definition.id);return{capabilities:Pa(e,t),commands:i(o.commands,u=>u.command),command_overrides:i(s.overrides,u=>u.command),command_handlers:i(s.handlers,u=>u.command),hooks:Us.filter(([u])=>m[u].some(w=>a(w.name))).map(([,u])=>u),flag_commands:i(o.flags,u=>u.target_command),item_types:r(o.item_types,u=>u.types.map(w=>w.name)),item_fields:r(o.item_fields,u=>u.fields.map(w=>w.name)),...y.length>0?{relationship_kinds:y}:{},migrations:r(o.migrations,u=>typeof u.definition.id=="string"?[u.definition.id]:[]),profiles:i(o.profiles,u=>u.profile.name),importers:i(o.importers,u=>u.importer),exporters:i(o.exporters,u=>u.exporter),search_providers:i(o.search_providers,u=>u.definition.name),vector_store_adapters:i(o.vector_store_adapters,u=>u.definition.name),..._.length>0?{assurance_providers:_}:{},parser_overrides:i(d.overrides,u=>u.command),service_overrides:i(l.overrides,u=>u.service),renderer_overrides:i(p.overrides,u=>u.format),...g.length>0?{renderer_ownership:g}:{},preflight_overrides:c.overrides.filter(u=>a(u.name)).length,preflight_ownership:c.overrides.filter(u=>a(u.name)).map(u=>({commands:[...u.commands??[]]}))}}function fi(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="caa9f916-c7ce-5e74-a00b-dd0fc6a41b5d")}catch{}})();var it={type:"string",minLength:1,maxLength:128,pattern:"\\S"},Rt={type:"array",minItems:1,maxItems:cn,items:it},hi={...Rt,items:{...it,pattern:"^(?!(?:.*\\.)?(?:__proto__|constructor|prototype)(?:\\.|$))[a-zA-Z_][a-zA-Z0-9_]*(?:\\.[a-zA-Z_][a-zA-Z0-9_]*){0,7}$"}},zs={type:"object",additionalProperties:!1,required:["id","rule"],properties:{id:{type:"string",minLength:1,maxLength:128,pattern:"^[a-zA-Z0-9][a-zA-Z0-9._-]*$"},description:{type:"string",minLength:1,maxLength:500,pattern:"\\S"},effect:{enum:["advise","warn","refuse"]},subject:{type:"object",additionalProperties:!1,properties:{...Object.fromEntries(["types","tags","statuses","operations","parents"].map(e=>[e,Rt])),dependency:{type:"object",additionalProperties:!1,required:["kind"],properties:{kind:it,id:it}}}},rule:{oneOf:[{type:"object",additionalProperties:!1,required:["kind","fields"],properties:{kind:{const:"require_fields"},fields:hi}},{type:"object",additionalProperties:!1,required:["kind","authors"],properties:{kind:{const:"authors"},authors:Rt}},...["field_writers","approval"].map(e=>({type:"object",additionalProperties:!1,required:["kind","fields","authors"],properties:{kind:{const:e},fields:hi,authors:Rt}})),{type:"object",additionalProperties:!1,required:["kind","allowed"],properties:{kind:{const:"transition"},allowed:{type:"array",maxItems:cn,items:{type:"array",minItems:2,maxItems:2,items:it}}}}]}}},Pu={$schema:"https://json-schema.org/draft/2020-12/schema",title:"pm workflow policy registry",type:"object",additionalProperties:!1,required:["version","policies"],properties:{version:{const:1},enforcement:{enum:["advise","refuse"],default:"advise"},policies:{type:"array",maxItems:_a,items:zs}}};(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="808f3bb5-cca5-5f9c-b557-7923c79ae6ce")}catch{}})();async function ju(e,t,n,a){let i=await Ee(e).catch(()=>null);return i===null?{check:{name:"completeness",status:"error",ok:!1,details:{policy_registry_readable:!1,policy_registry_path:"schema/policies.json",remediation_hint:"Repair schema/policies.json, then rerun pm validate."}},warnings:["validate_completeness_policy_registry_unreadable"]}:gi(i,t,n,a)}function Gs(e,t,n){return e===0?"undeclared":t===0?"empty":n===0?"inapplicable":n===t?"covered":"partial"}function gi(e,t,n=5,a=!1){let i=[],r=new Map,o=e.policies.filter(u=>u.rule.kind==="require_fields"),s=o.filter(u=>u.subject?.operations===void 0),d=new Set,c=0,l=0,p=0,m=0,y=0,g=ba(e);for(let u of t){let w=g({operation:"",author:"",before:u,after:u,completeness_only:!0});c+=+(w.decisions.length>0),l+=w.decisions.length,w.decisions.forEach(S=>d.add(S.policy_id));let v=w.decisions.filter(S=>!S.satisfied);if(v.length===0)continue;m+=1;let E=r.get(u.type)??{items:0,violations:0,missing_fields:0};E.items+=1;for(let S of v)p+=1,E.violations+=1,E.missing_fields+=S.missing_fields.length,S.effect==="refuse"&&(y+=1),i.length<n&&i.push({id:u.id,type:u.type,status:u.status,decision:S});r.set(u.type,E)}let _=a||y>0?"error":p>0?"warn":"ok";return{check:{name:"completeness",status:_,ok:_==="ok",details:{scope:"operation_independent_require_fields",declared_requirement_count:o.length,state_requirement_count:s.length,applicable_requirement_count:d.size,requirement_application_count:l,governed_items:c,ungoverned_items:t.length-c,contract_status:Gs(o.length,t.length,c),applied_policy_ids:[...d].sort().slice(0,Math.max(0,n)),applied_policy_ids_truncated:d.size>Math.max(0,n),checked_items:t.length,incomplete_items:m,violation_count:p,refused_violations:y,missing_by_type:Object.fromEntries(r),violations:i,violations_truncated:i.length<p,enforcement:e.enforcement}},warnings:[...p>0?[`validate_completeness_missing_fields:${p}`]:[],...a?["validate_completeness_source_incomplete"]:[]]}}import Js 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]="0c3bed4d-4a17-5004-a1c5-65f6acec2a9b")}catch{}})();function qs(){return{version:1,enforcement:"advise",policies:[...[["Epic",["goal","objective","body"]],["Story",["description","value","acceptance_criteria"]],["Decision",["body","resolution"]],["Feature",["acceptance_criteria","expected_result"]],["Task",["description"]],["Issue",["repro_steps","expected_result"]],["Chore",["description"]]].map(([e,t])=>({id:`completeness-${e.toLowerCase()}`,effect:"advise",description:`Evidence expected when ${e} work reaches completion.`,subject:{types:[e],statuses:["closed"]},rule:{kind:"require_fields",fields:[...t]}})),{id:"completeness-resolution",effect:"advise",subject:{statuses:["closed"]},rule:{kind:"require_fields",fields:["resolution","expected_result","actual_result"]}}]}}function wi(e){let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{throw new f("Policy definition must be valid JSON.",h.USAGE)}if(typeof t!="object"||t===null||Array.isArray(t))throw new f("Policy definition must be an object.",h.USAGE);return t}async function Ws(e,t){let n=F(process.cwd(),e.path);await Ue(n);let a=await A(n);return{pmRoot:n,settings:a,author:q(t,a.author_default)}}function yi(e,t,n,a){if(e==="policy-mode")return ln({...n,enforcement:t});let i=n.policies.filter(s=>s.id!==t);if(e==="policy-remove")return{...n,policies:i};let r=dn(a.definition),o=ln({...n,policies:[...i,r].sort((s,d)=>s.id.localeCompare(d.id))});if(Buffer.byteLength(`${JSON.stringify(o,null,2)}
+`)>Ua)throw new f("Policy registry exceeds its byte ceiling.",h.USAGE);return o}async function _i(e,t,n,a){if(n.dryRun)return{policy_result:!0,action:e,changed:!1,result:yi(e,t,await Ee(a.pmRoot),n)};let i=await Fa({pmRoot:a.pmRoot,filePath:Js.join(a.pmRoot,"schema","policies.json"),op:`schema:${e}`,author:a.author,message:n.message,lockTtlSeconds:a.settings.locks.ttl_seconds,lockWaitMs:a.settings.locks.wait_ms,mutate(r){let o=yi(e,t,za(r),n);return{raw:`${JSON.stringify(o,null,2)}
+`,result:o}}});return{policy_result:!0,action:e,changed:i.changed,result:i.result}}async function Bs(e,t,n){let a,i=await Ba({...n,id:e,op:"policy_approve",message:t.message,resolveHistoryContext:()=>({workflow_approval:a}),async mutate(r){let o=(await Ee(n.pmRoot)).policies.find(s=>s.id===t.policy);if(!o||o.rule.kind!=="approval")throw new f("--policy must name an approval rule.",h.USAGE);if(!o.rule.authors.includes(n.author))throw new f("This actor is not a declared approver.",h.CONFLICT);return await Ga(n.pmRoot,r.metadata.id),a={policy_id:o.id,policy_fingerprint:wa(o),content_fingerprint:va(o,{...r.metadata,body:r.body})},{changedFields:[]}}});return{policy_result:!0,action:"policy-approve",changed:!0,result:{id:i.item.id,...a,warnings:i.warnings}}}function Hs(e,t){let n=wi(t),a=dn({...n,id:n.id===void 0?e:n.id});if(e!==void 0&&e.trim()!==a.id)throw new f("Policy id operand does not match definition.id.",h.USAGE,{required:"Use the same policy id operand and definition.id, or supply only one of them.",nextSteps:["Omit the policy id operand to use definition.id, or omit definition.id to use the operand."]});return a}async function Qu(e,t,n={},a={}){if(!Et.includes(e))throw new f("Unknown workflow policy action.",h.USAGE);if(e==="policy-presets")return{policy_result:!0,action:e,changed:!1,result:qs()};let i=await Ws(a,n.author);if(e==="policies")return{policy_result:!0,action:e,changed:!1,result:await Ee(i.pmRoot)};if(e==="policy-put"){let l=Hs(t,n.definition);return _i(e,l.id,{...n,definition:l},i)}if(!t?.trim())throw new f(`schema ${e} requires an operand.`,h.USAGE);if(["policy-remove","policy-mode"].includes(e))return _i(e,t,n,i);if(e==="policy-approve"){if(n.dryRun)throw new f("Use policy-check to preview; policy-approve records an approval.",h.USAGE);return Bs(t,n,i)}let r=W(i.settings,J()),o=await Tt(i.pmRoot,t,i.settings.id_prefix,i.settings.item_format,r.type_to_folder);if(!o)throw new f(`Item ${t} not found.`,h.NOT_FOUND);let{document:s}=await Ot(o,{schema:i.settings.schema}),d={...s.metadata,body:s.body},c=n.definition===void 0?d:{...d,...wi(n.definition)};if(c.id!==d.id)throw new f("Policy preview cannot change the item id.",h.USAGE);return{policy_result:!0,action:e,changed:!1,result:await Ja(i.pmRoot,await Ee(i.pmRoot),{operation:"update",author:i.author,before:d,after:c,completeness_only:n.definition===void 0})}}import{createHash as Ri}from"node:crypto";import je from"node:fs/promises";import Ke 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]="68be16cc-4cb4-5df6-90f0-897d4fe82339")}catch{}})();var Ks=new Set(on),Vs=new Set(sn),vi=new Set([...la.filter(e=>e!=="severity"),"id","title","type","status","priority","tags","assignee","parent","description","body","created_at","updated_at","closed_at","completed_at","author","deadline","estimate","sprint","release","risk","confidence","reviewer","resolution","expected","actual"]),Ys=["create","update"];function Si(e){if(typeof e!="string")return"";let t=e.trim().toLowerCase().replaceAll(/[\s_]+/g,"-");return t.startsWith("--")?t.slice(2):t}function bi(e){return e.replaceAll("_","-")}function Xs(e,t){let n=new Set;for(let a of e){let i=Si(a);i.length>0&&i!==t&&n.add(i)}return[...n].sort((a,i)=>a.localeCompare(i))}function Zs(e){let t=new Set;for(let n of e??[]){let a=n.trim();a.length>0&&t.add(a)}return[...t].sort((n,a)=>n.localeCompare(a))}function Qs(e){let t=new Set,n=[];for(let a of e??[]){let i=a.trim().toLowerCase();if(i.length!==0){if(!Vs.has(i))throw new Error(`Invalid field command "${a}". Allowed: ${sn.join(", ")}.`);t.has(i)||(t.add(i),n.push(i))}}return e===void 0||n.length===0?[...Ys]:n}function Ei(e){let t=I(e.key);if(t.length===0)throw new Error("Field key must not be empty.");if(vi.has(t))throw new Error(`Cannot define custom field "${t}": custom schema field "${t}" collides with built-in item metadata "${t}". Rename the custom field with a project-specific prefix. Reserved fields: ${[...vi].sort((l,p)=>l.localeCompare(p)).join(", ")}.`);let n=typeof e.type=="string"&&e.type.trim().length>0?e.type.trim().toLowerCase():"string";if(!Ks.has(n))throw new Error(`Invalid field type "${e.type}". Allowed: ${on.join(", ")}.`);let a=n,i=Qs(e.commands),r=Si(e.cliFlag),o=r.length>0&&r!==bi(t)?r:void 0,s=o??bi(t),d=Xs(e.aliases??[],s),c=e.description?.trim();return{key:t,type:a,commands:i,description:c&&c.length>0?c:void 0,cliFlag:o,cliAliases:d,required:e.required===!0,requiredOnCreate:e.requiredOnCreate===!0,allowUnset:e.allowUnset!==!1,requiredTypes:Zs(e.requiredTypes)}}function ec(e){if(Array.isArray(e))return e;if(typeof e!="object"||e===null)return;let t=e;if(Array.isArray(t.fields))return t.fields;if(Array.isArray(t.definitions))return t.definitions}function tc(e){let t=ec(e);if(!t)return[];let n=[];for(let a of t){if(typeof a!="object"||a===null||Array.isArray(a))continue;let i=a;typeof i.key!="string"||i.key.trim().length===0||n.push(i)}return n}function Je(e){if(e==null||e.trim().length===0)return{fields:[]};let t;try{t=JSON.parse(e)}catch{throw new Error("schema/fields.json contains invalid JSON.")}return{fields:tc(t)}}function qe(e){return`${JSON.stringify({fields:e.fields},null,2)}
+`}function $i(e,t){let n=e.fields.find(o=>I(o.key)===t.key),a=n!==void 0,i=e.fields.filter(o=>I(o.key)!==t.key),r={...n,key:t.key,type:t.type,commands:[...t.commands]};return ki(r,"description",t.description),ki(r,"cli_flag",t.cliFlag),t.cliAliases.length>0?r.cli_aliases=[...t.cliAliases]:delete r.cli_aliases,xi(r,"required",t.required),xi(r,"required_on_create",t.requiredOnCreate),t.allowUnset===!1?r.allow_unset=!1:delete r.allow_unset,t.requiredTypes.length>0?r.required_types=[...t.requiredTypes]:delete r.required_types,i.push(r),i.sort((o,s)=>I(o.key).localeCompare(I(s.key))),{file:{fields:i},definition:r,replaced:a}}function Ii(e,t){let n=I(t);if(n.length===0)throw new Error("Field key must not be empty.");let a=[],i=e.fields.filter(r=>I(r.key)===n?(a.push(r),!1):!0);return a.length===0?{file:{fields:i},removed:!1}:{file:{fields:i},removed:!0,definition:a[0]}}function ki(e,t,n){let a=e;n!==void 0&&n.length>0?a[t]=n:delete a[t]}function xi(e,t,n){let a=e;n?a[t]=!0:delete a[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]="b1e4c04e-0ade-5d24-95e3-b8dca3832c5a")}catch{}})();var nc=new Set(St),De=new Set(Da.map(e=>I(e.id)).filter(e=>e.length>0));function ac(e){let t=new Set;for(let n of e){let a=I(n);a.length>0&&t.add(a)}return[...t].sort((n,a)=>n.localeCompare(a))}function Ai(e){let t=I(e.id);if(t.length===0)throw new Error("Status id must not be empty.");if(De.has(t))throw new Error(`Cannot add-status the built-in status "${t}". Built-in statuses are reserved: ${[...De].join(", ")}.`);let n;if(e.roles!==void 0){n=[];let o=new Set;for(let s of e.roles){let d=typeof s=="string"?s.trim().toLowerCase():"";if(d.length!==0){if(!nc.has(d))throw new Error(`Invalid status role "${s}". Allowed roles: ${St.join(", ")}.`);o.has(d)||(o.add(d),n.push(d))}}if(n.length===0)throw new Error(`Status role must include at least one lifecycle role. Allowed roles: ${St.join(", ")}.`)}let a=e.aliases===void 0?void 0:ac(e.aliases).filter(o=>o!==t),i=e.description?.trim(),r=typeof e.order=="number"&&Number.isFinite(e.order)?Math.trunc(e.order):void 0;return{id:t,roles:n,aliases:a,description:i&&i.length>0?i:void 0,order:r}}function ic(e){if(Array.isArray(e))return e;if(typeof e!="object"||e===null)return;let t=e;if(Array.isArray(t.statuses))return t.statuses;if(Array.isArray(t.definitions))return t.definitions}function rc(e){let t=ic(e);if(!t)return[];let n=[];for(let a of t){if(typeof a!="object"||a===null||Array.isArray(a))continue;let i=a;typeof i.id!="string"||i.id.trim().length===0||n.push(i)}return n}function We(e){if(e==null||e.trim().length===0)return{statuses:[]};let t;try{t=JSON.parse(e)}catch{throw new Error("schema/statuses.json contains invalid JSON.")}return{statuses:rc(t)}}function Be(e){return`${JSON.stringify({statuses:e.statuses},null,2)}
+`}function Ti(e,t,n){let a=e.statuses.slice(),i=a.findIndex(s=>I(s.id)===t.id),r=i>=0?a[i]:n,o={...r,id:t.id};return t.roles!==void 0&&(t.roles.length>0?o.roles=[...t.roles]:o.roles!==void 0&&delete o.roles),t.aliases!==void 0&&(t.aliases.length>0?o.aliases=[...t.aliases]:o.aliases!==void 0&&delete o.aliases),t.description!==void 0&&(o.description=t.description),t.order!==void 0&&(o.order=t.order),i>=0?a[i]=o:a.push(o),{file:{statuses:a},definition:o,replaced:r!==void 0}}function Oi(e,t){let n=I(t);if(n.length===0)throw new Error("Status id must not be empty.");if(De.has(n))throw new Error(`Cannot remove built-in status "${n}". Built-in statuses are reserved: ${[...De].join(", ")}.`);let a=e.statuses.slice(),i=a.findIndex(o=>I(o.id)===n);if(i<0)return{file:{statuses:a},removed:!1};let[r]=a.splice(i,1);return{file:{statuses:a},removed:!0,definition:r}}function wn(e,t){let n=[e.id,...e.aliases??[]];for(let a of n){let i=I(a);if(i.length===0)continue;let r=t.get(i);if(r!==void 0&&r!==e.id)throw new Error(`Status token "${i}" already belongs to status "${r}". Choose a different id/alias to avoid shadowing it.`)}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="8d04c087-62e4-51d3-8832-6cbcfd3ed993")}catch{}})();function he(e,t){if(typeof e!="string"||e.trim().length===0)throw new TypeError(`Schema migration ${t} must be non-empty`);return e.trim()}function Ni(e){let t=he(e,"migrationId");if(!/^[a-zA-Z0-9._-]+$/.test(t))throw new TypeError("Schema migration migrationId must match [a-zA-Z0-9._-]+");return t}function Di(e,t){let n=bn(e),a=he(t,"migrationScope");return`auto-${Ri("sha256").update(JSON.stringify({scope:a,request:n})).digest("hex").slice(0,20)}`}function bn(e){let t=e.kind==="rename-type"?{kind:e.kind,from:he(e.from,"source"),to:he(e.to,"target")}:e.kind==="rename-field"?{kind:e.kind,from:I(he(e.from,"source")),to:I(he(e.to,"target")),...e.type===void 0?{}:{type:he(e.type,"type")}}:{kind:e.kind,from:I(he(e.from,"source")),to:I(he(e.to,"target"))};if(t.from.toLowerCase()===t.to.toLowerCase())throw new TypeError("Schema migration source and target must differ");return t}function oc(e){return e.kind==="rename-type"?"types":e.kind==="rename-field"?"fields":"statuses"}function sc(e,t,n){let a=K(t.schema),i=oc(n);return Q(e,a.files[i],V[i])}function ji(e,t){return Ke.join(e,"transactions","schema",`${t}-plan.json`)}function Nt(e){return e.length===0?null:JSON.parse(e)}async function He(e){let t=await G(e);return{exists:t!==null,raw:t??""}}async function Li(e,t){t.exists?await me(e,t.raw):await je.rm(e,{force:!0})}function cc(e,t,n){let a=ae(e),i=a.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.from.toLowerCase()),r=a.definitions.findIndex(o=>o.name.trim().toLowerCase()===t.to.toLowerCase());if(n==="stage"){if(r>=0)return se(a);if(i<0)throw new TypeError(`Unknown custom type "${t.from}".`);a.definitions.push({...a.definitions[i],name:t.to})}else i>=0&&a.definitions.splice(i,1);return se(a)}function dc(e,t,n){let a=Je(e),i=a.fields.findIndex(o=>o.key===t.from),r=a.fields.findIndex(o=>o.key===t.to);if(n==="stage"){if(r>=0)return qe(a);if(i<0)throw new TypeError(`Unknown custom field "${t.from}".`);let o=a.fields[i];a.fields.push({...o,key:t.to,metadata_key:t.to,front_matter_key:t.to,cli_flag:t.to.replaceAll("_","-")})}else i>=0&&a.fields.splice(i,1);return qe(a)}function lc(e,t,n){let a=We(e),i=a.statuses.findIndex(o=>o.id===t.from),r=a.statuses.findIndex(o=>o.id===t.to);if(n==="stage"){if(r>=0)return Be(a);if(i<0)throw new TypeError(`Unknown custom status "${t.from}".`);a.statuses.push({...a.statuses[i],id:t.to})}else i>=0&&a.statuses.splice(i,1);return Be(a)}function pc(e,t,n){return t.kind==="rename-type"?cc(e,t,n):t.kind==="rename-field"?dc(e,t,n):lc(e,t,n)}function Ie(e,t){return typeof e=="string"&&e.trim().toLowerCase()===t.from.toLowerCase()?t.to:e}function kn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function Ve(e){return Array.isArray(e)?e.map(t=>kn(t)).filter(t=>t!==void 0):[]}function mc(e,t){for(let n of Ve(e.fields))Array.isArray(n.required_types)&&(n.required_types=n.required_types.map(a=>Ie(a,t)));for(let n of Ve(e.type_workflows))n.type=Ie(n.type,t)}function uc(e,t){for(let a of Ve(e.definitions))a.default_status=Ie(a.default_status,t);let n=kn(e.workflow);if(n)for(let[a,i]of Object.entries(n))n[a]=Ie(i,t);for(let a of Ve(e.type_workflows))Array.isArray(a.allowed_transitions)&&(a.allowed_transitions=a.allowed_transitions.map(i=>Array.isArray(i)?i.map(r=>Ie(r,t)):i))}function fc(e,t){for(let n of Ve(e.definitions)){for(let a of["required_create_fields","required_create_repeatables"])Array.isArray(n[a])&&(n[a]=n[a].map(i=>Ie(i,t)));for(let a of["options","command_option_policies"])for(let i of Ve(n[a])){let r=a==="options"?"key":"option";i[r]=Ie(i[r],t)}}}function hc(e,t){let n=kn(e.options);if(!n)return;if(t.kind==="rename-field"){if(!Object.prototype.hasOwnProperty.call(n,t.from))return;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision in saved template "${String(e.name??"unknown")}": target field "${t.to}" already exists.`);n[t.to]=n[t.from],delete n[t.from];return}let a=t.kind==="rename-type"?"type":"status";n[a]=Ie(n[a],t)}function vn(e,t){let n=JSON.parse(e);if(typeof n!="object"||n===null||Array.isArray(n))return e;let a=n;return t.kind==="rename-type"?mc(a,t):t.kind==="rename-field"?fc(a,t):uc(a,t),hc(a,t),`${JSON.stringify(a,null,2)}
+`}function Fi(e,t){if(t.kind==="rename-type"){let a=ae(e).definitions;return{source:a.some(i=>i.name.trim().toLowerCase()===t.from.toLowerCase()),target:a.some(i=>i.name.trim().toLowerCase()===t.to.toLowerCase())}}if(t.kind==="rename-field"){let a=Je(e).fields;return{source:a.some(i=>i.key===t.from),target:a.some(i=>i.key===t.to)}}let n=We(e).statuses;return{source:n.some(a=>a.id===t.from),target:n.some(a=>a.id===t.to)}}function gc(e,t){let n=e;return t.kind==="rename-type"?e.type.toLowerCase()===t.to.toLowerCase()?[]:["type"]:t.kind==="remap-status"?e.status.toLowerCase()===t.to.toLowerCase()?[]:["status"]:Object.prototype.hasOwnProperty.call(n,t.to)&&!Object.prototype.hasOwnProperty.call(n,t.from)?[]:[t.from,t.to]}function yc(e,t){if(t.kind==="rename-type")return e.type.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"type",before:e.type,after:t.to}]}:null;if(t.kind==="remap-status")return e.status.toLowerCase()===t.from.toLowerCase()?{id:e.id,changes:[{field:"status",before:e.status,after:t.to}]}:null;if(t.type!==void 0&&e.type.toLowerCase()!==t.type.toLowerCase())return null;let n=e;if(!Object.prototype.hasOwnProperty.call(n,t.from))return null;if(Object.prototype.hasOwnProperty.call(n,t.to))throw new TypeError(`Schema migration collision on item "${e.id}": target field "${t.to}" already exists.`);return{id:e.id,changes:[{field:t.from,before:n[t.from],after:void 0},{field:t.to,before:void 0,after:n[t.from]}]}}function Mi(e,t){let n=bn(t.request),a=t.migrationId===void 0?Di(n,t.migrationScope??"plan"):Ni(t.migrationId),i=e.map(d=>yc(d,n)).filter(d=>d!==null).sort((d,c)=>d.id.localeCompare(c.id)),r=Ri("sha256").update(JSON.stringify({migrationId:a,request:n,items:i})).digest("hex"),o=new Set([...t.completedItemIds??[]].map(d=>d.trim()).filter(d=>d.length>0)),s=i.filter(d=>!o.has(d.id));return Object.freeze({migration_id:a,request:n,fingerprint:r,affected_item_count:i.length,pending_item_count:s.length,skipped_completed_count:i.length-s.length,items:Object.freeze(s)})}async function _c(e){let t=W(e.settings,J()),n=[...new Set(Object.values(t.type_to_folder))],a=await Wa(e.pmRoot,n),i=e.request.kind==="rename-type"?{types:[e.request.from]}:e.request.kind==="remap-status"?{statuses:[e.request.from]}:{metadataKeys:[e.request.from],...e.request.type===void 0?{}:{types:[e.request.type]}},r=a?await qa({pmRoot:e.pmRoot,expectedSourceCursor:a.source_cursor,query:i}):null;return r?{items:r.items,selectionSource:"derived_index",typeToFolder:t.type_to_folder}:{items:await Pe(e.pmRoot,e.settings.item_format,t.type_to_folder,[],e.settings.schema),selectionSource:"scan",typeToFolder:t.type_to_folder}}async function wc(e,t){let n=await G(ji(e,t));if(n===null)return null;try{let a=JSON.parse(n);if(a.schema_version!==1||a.plan.migration_id!==t||!Array.isArray(a.plan.items))throw new TypeError("invalid plan envelope");return a.plan}catch(a){throw new f(`Stored schema migration plan "${t}" is invalid: ${ma(a)}`,h.GENERIC_FAILURE)}}async function vc(e,t){let n=ji(e,t.migration_id);await je.mkdir(Ke.dirname(n),{recursive:!0});let a={schema_version:1,plan:t,created_at:new Date().toISOString()};await me(n,`${JSON.stringify(a,null,2)}
+`)}function bc(e,t){return JSON.stringify(e)===JSON.stringify(t)}async function kc(e){let t=await Tt(e.pmRoot,e.id,e.settings.id_prefix,e.settings.item_format,e.typeToFolder);if(!t)throw new f(`Schema migration item "${e.id}" no longer exists.`,h.NOT_FOUND);return(await Ot(t,{schema:e.settings.schema})).document.metadata}function Ci(e,t,n){let a=n==="forward"?t.from:t.to,i=n==="forward"?t.to:t.from;if(t.kind==="rename-type"){if(e.metadata.type.toLowerCase()===i.toLowerCase())return[];if(e.metadata.type.toLowerCase()!==a.toLowerCase())throw new TypeError(`Schema migration expected type "${a}" on item "${e.metadata.id}".`);return e.metadata.type=i,["type"]}if(t.kind==="remap-status"){if(e.metadata.status.toLowerCase()===i.toLowerCase())return[];if(e.metadata.status.toLowerCase()!==a.toLowerCase())throw new TypeError(`Schema migration expected status "${a}" on item "${e.metadata.id}".`);return e.metadata.status=i,["status"]}let r=e.metadata;if(Object.prototype.hasOwnProperty.call(r,i)&&!Object.prototype.hasOwnProperty.call(r,a))return[];if(!Object.prototype.hasOwnProperty.call(r,a)||Object.prototype.hasOwnProperty.call(r,i))throw new TypeError(`Schema migration field state changed concurrently on item "${e.metadata.id}".`);return r[i]=r[a],delete r[a],[a,i]}function Pi(e){return{id:e.id,inspect:async()=>{let t=await He(e.filePath),n=Fi(t.raw,e.request),a=e.phase==="stage"?n.source&&n.target:!n.source&&n.target;return{state:a?"applied":"pending",...a?{result:{phase:e.phase}}:{}}},prepareCompensation:async()=>{let t=await He(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await He(e.filePath);return await me(e.filePath,pc(t.raw,e.request,e.phase)),{phase:e.phase}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema snapshot for ${e.id} compensation.`);await Li(e.filePath,{exists:t.exists,raw:t.raw})}}}function xc(e){return{id:e.stepId,inspect:async()=>{let t=await He(e.filePath);return{state:vn(t.raw,e.request)===t.raw?"applied":"pending"}},prepareCompensation:async()=>{let t=await He(e.filePath);return{exists:t.exists,raw:t.raw}},apply:async()=>{let t=await He(e.filePath);return await me(e.filePath,vn(t.raw,e.request)),{file:e.filePath}},compensate:async t=>{if(typeof t!="object"||t===null||Array.isArray(t)||typeof t.exists!="boolean"||typeof t.raw!="string")throw new TypeError(`Missing schema reference snapshot for ${e.stepId} compensation.`);await Li(e.filePath,{exists:t.exists,raw:t.raw})}}}function Sc(e){return{id:`item-${e.id}`,inspect:async()=>{let t=await A(e.pmRoot),n=W(t,J()).type_to_folder,a=await kc({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id}),i=gc(a,e.request).length===0;return{state:i?"applied":"pending",...i?{result:{item_id:e.id}}:{}}},apply:async()=>{let t=await A(e.pmRoot),n=W(t,J()).type_to_folder,a=await un({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}`,author:e.author,message:`Schema migration ${e.request.kind}: ${e.request.from} -> ${e.request.to}`,force:e.force,skipNoop:!0,mutate(i){return{changedFields:Ci(i,e.request,"forward")}}});return{item_id:e.id,changed_fields:a.changedFields}},compensate:async()=>{let t=await A(e.pmRoot),n=W(t,J()).type_to_folder;await un({pmRoot:e.pmRoot,settings:t,typeToFolder:n,id:e.id,op:`schema_${e.request.kind.replaceAll("-","_")}_compensate`,author:e.author,message:`Compensate schema migration ${e.request.kind}: ${e.request.to} -> ${e.request.from}`,force:!0,skipNoop:!0,mutate(a){return{changedFields:Ci(a,e.request,"reverse")}}})}}}async function Ec(e){let t=await wc(e.pmRoot,e.migrationId);if(t){if(!bc(t.request,e.request))throw new f(`Schema migration id "${e.migrationId}" already belongs to a different request.`,h.CONFLICT);return{plan:t,stored:!0}}let n=await _c({pmRoot:e.pmRoot,settings:e.settings,request:e.request});return{plan:{...Mi(n.items,{migrationId:e.migrationId,request:e.request}),selection_source:n.selectionSource},stored:!1}}async function $c(e){let t=Fi(await G(e.schemaPath)??"",e.request);if(!t.source)throw new f(`Schema migration source "${e.request.from}" is not a custom definition.`,h.NOT_FOUND);if(t.target)throw new f(`Schema migration target "${e.request.to}" already exists.`,h.CONFLICT);await vc(e.pmRoot,e.plan)}async function Ic(e){let t=K(e.settings.schema),n=[...new Set([["types",V.types],["fields",V.fields],["workflows",V.workflows]].map(([i,r])=>Q(e.pmRoot,t.files[i],r)).filter(i=>i!==e.schemaPath))];try{let i=Ke.join(e.pmRoot,"templates"),r=await je.readdir(i,{withFileTypes:!0});n.push(...r.filter(o=>o.isFile()&&o.name.toLowerCase().endsWith(".json")).map(o=>Ke.join(i,o.name)))}catch(i){if(typeof i!="object"||i===null||!("code"in i)||!_e(i))throw i}n.sort((i,r)=>i.localeCompare(r));let a=[];for(let i of n){let r=await G(i);r!==null&&vn(r,e.request)!==r&&a.push({filePath:i,beforeRaw:r})}return{paths:n,snapshots:a}}async function Ac(e){for(let t of e.snapshots){let n=await je.readFile(t.filePath,"utf8"),a=Ke.relative(e.pmRoot,t.filePath).replaceAll("\\","/");await mn({pmRoot:e.pmRoot,author:e.author,documentPath:a,before:Nt(t.beforeRaw),after:Nt(n),op:"schema_migration_reference",idempotencyKey:`${e.plan.migration_id}:${e.plan.fingerprint}:${a}`,message:`${e.request.kind}: ${e.request.from} -> ${e.request.to}`,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}}async function Tc(e,t,n){let a=bn(e),i=F(process.cwd(),n.path);await Ue(i);let r=t.migrationId===void 0?Di(a,await je.realpath(i)):Ni(t.migrationId),o=await A(i),s=q(t.author,o.author_default),d=await Ec({pmRoot:i,settings:o,migrationId:r,request:a}),c=d.plan;if(t.dryRun===!0)return{...c,action:a.kind,applied:!1,recovered:!1,migrated_item_count:0};let l=sc(i,o,a),p=await je.readFile(l,"utf8");d.stored||await $c({pmRoot:i,schemaPath:l,request:a,plan:c});let m=await Ic({pmRoot:i,schemaPath:l,settings:o,request:a}),y=[Pi({id:"stage-schema",filePath:l,request:a,phase:"stage"}),...m.paths.map((w,v)=>xc({filePath:w,request:a,stepId:`reference-${String(v+1).padStart(4,"0")}`})),...c.items.map(w=>Sc({pmRoot:i,id:w.id,request:a,author:s,force:t.force===!0})),Pi({id:"retire-source",filePath:l,request:a,phase:"retire"})],g=await li({pmRoot:i,transactionId:`schema-${r}`,author:s,steps:y,lockTtlSeconds:Math.max(o.locks.ttl_seconds,300),lockWaitMs:o.locks.wait_ms}),_=await je.readFile(l,"utf8"),{historyPath:u}=await mn({pmRoot:i,author:s,documentPath:Ke.relative(i,l).replaceAll("\\","/"),before:Nt(p),after:Nt(_),op:"schema_migration",idempotencyKey:`${c.migration_id}:${c.fingerprint}`,message:`${a.kind}: ${a.from} -> ${a.to}; affected=${c.affected_item_count}`,lockTtlSeconds:o.locks.ttl_seconds,lockWaitMs:o.locks.wait_ms});return await Ac({pmRoot:i,author:s,settings:o,request:a,plan:c,snapshots:m.snapshots}),{...c,action:a.kind,applied:!0,recovered:g.recovered,migrated_item_count:c.affected_item_count,workspace_history_path:u}}function Oc(e){let t=e.applied?"applied":"dry-run",n=e.recovered?" (recovered)":"";return[`${e.action}: ${e.request.from} -> ${e.request.to} [${t}${n}]`,`migration_id: ${e.migration_id}`,`affected: ${e.affected_item_count}`,`pending: ${e.pending_item_count}`,`fingerprint: ${e.fingerprint}`].join(`
+`)}import Gi from"node:fs/promises";import Le 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]="74b72dd8-0877-55a4-9c80-d043f19e1f96")}catch{}})();var Dt=["extensions","docs","examples","assets","prompts"],Cc=Object.freeze({extensions:Object.freeze([".agents/pm/extensions","extensions",".custom/pm-extensions",".custom/pm-extension"]),docs:Object.freeze(["docs","documentation"]),examples:Object.freeze(["examples","docs/examples"]),assets:Object.freeze(["assets",".agents/pm/assets"]),prompts:Object.freeze(["prompts",".agents/pm/prompts"])});function Pc(e){return Dt.includes(e)}function Rc(e,t){if(t==null)return[];let n=Array.isArray(t)?t:[t],a=[];for(let i of n){if(typeof i!="string"||i.trim().length===0)throw new f(`Package manifest field pm.${e} must contain string paths.`,h.USAGE);a.push(i.trim())}return[...new Set(a)].sort((i,r)=>i.localeCompare(r))}function Nc(e){if(e==null)return{};if(typeof e!="object"||Array.isArray(e))throw new f("Package manifest field pm must be an object.",h.USAGE);let t={},n=e;for(let[a,i]of Object.entries(n)){if(!Pc(a))continue;let r=Rc(a,i);r.length>0&&(t[a]=r)}return t}function ce(e,t){let n=e[t];return typeof n=="string"&&n.trim().length>0?n.trim():void 0}function xn(e){if(!Array.isArray(e))return;let t=e.map(n=>typeof n=="string"?n.trim():"").filter(n=>n.length>0);return t.length>0?[...new Set(t)].sort((n,a)=>n.localeCompare(a)):void 0}function Ui(e){if(typeof e=="string"&&e.trim().length>0)return e.trim();if(typeof e=="object"&&e!==null&&!Array.isArray(e)){let t=e.url;return typeof t=="string"&&t.trim().length>0?t.trim():void 0}}function Dc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={docs:ce(t,"docs"),npm:ce(t,"npm"),repository:ce(t,"repository"),report:ce(t,"report")};return Object.values(n).some(a=>typeof a=="string")?n:void 0}function jc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={image:ce(t,"image"),video:ce(t,"video")};return Object.values(n).some(a=>typeof a=="string")?n:void 0}function Lc(e){if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,n={display_name:ce(t,"display_name")??ce(t,"displayName"),category:ce(t,"category"),summary:ce(t,"summary"),links:Dc(t.links),media:jc(t.media),tags:xn(t.tags)};return Object.values(n).some(a=>a!==void 0)?n:void 0}async function rt(e){let t=Le.join(e,"package.json");if(!await k(t))return{source:"convention",resources:{}};let n;try{n=JSON.parse(await Gi.readFile(t,"utf8"))}catch(s){throw new f(`Failed to parse package manifest at "${t}": ${String(s)}`,h.USAGE)}if(typeof n!="object"||n===null||Array.isArray(n))throw new f(`Package manifest at "${t}" must be a JSON object.`,h.USAGE);let a=n,i=a.pm,r=i!=null,o=typeof i=="object"&&i!==null&&!Array.isArray(i)?i:{};return{source:r?"pm":"convention",package_json_path:t,package_name:typeof a.name=="string"?a.name:void 0,package_version:typeof a.version=="string"?a.version:void 0,package_private:a.private===!0,package_description:typeof a.description=="string"?a.description:void 0,package_keywords:xn(a.keywords),package_homepage:typeof a.homepage=="string"?a.homepage:void 0,package_repository_url:Ui(a.repository),package_bugs_url:Ui(a.bugs),aliases:xn(o.aliases),resources:Nc(i),catalog:Lc(o.catalog)}}async function zi(e){if(!await k(e))return[];let t=await Gi.readdir(e,{withFileTypes:!0}),n=[];for(let a of t){if(!a.isDirectory())continue;let i=Le.join(e,a.name);await k(Le.join(i,"manifest.json"))&&n.push(i)}return n.sort((a,i)=>a.localeCompare(i))}async function jt(e){if(await k(Le.join(e,"manifest.json")))return[e];let t=(await rt(e)).resources.extensions??[],n=new Set;for(let a of t){if(a.includes("*")||a.startsWith("!"))throw new f(`Package extension entry "${a}" uses a glob/exclusion pattern. pm package installs currently require concrete extension paths or directories.`,h.USAGE);let i=Le.resolve(e,a);if(!H(e,i))throw new f(`Package extension entry "${a}" resolves outside package root.`,h.USAGE);if(await k(Le.join(i,"manifest.json"))){n.add(i);continue}for(let r of await zi(i))n.add(r)}if(t.length===0)for(let a of Cc.extensions)for(let i of await zi(Le.join(e,a)))n.add(i);return[...n].sort((a,i)=>a.localeCompare(i))}import{execFile as id}from"node:child_process";import P from"node:fs/promises";import Pn from"node:os";import $ from"node:path";import{fileURLToPath as rd}from"node:url";import{promisify as od}from"node:util";import sd from"npm-package-arg";import{extract as cd,list as dd}from"tar";import Kc from"node:fs/promises";import ie from"node:path";import Ji from"node:fs/promises";import Sn 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]="9cf5a9e7-4a66-5e72-80a2-f8a9b5b6e412")}catch{}})();function Z(e){return[...new Set(e.map(t=>t.trim()).filter(t=>t.length>0))].sort((t,n)=>t.localeCompare(n))}function b(e){return e.trim().toLowerCase()}function Lt(e){let t=e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-"),n=0;for(;t[n]==="-";)n+=1;let a=t.length;for(;a>n&&t[a-1]==="-";)a-=1;let i=t.slice(n,a);if(i.length===0)throw new f("Extension manifest name must resolve to a non-empty directory name.",h.USAGE);if(i==="."||i==="..")throw new f('Extension manifest name must not resolve to "." or "..".',h.USAGE);return i}function En(e){return Aa(e)}async function Fc(e){try{let t=JSON.parse(await Ji.readFile(Sn.join(e,"package.json"),"utf8")),n=typeof t.name=="string"&&/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(t.name)?t.name:void 0;return{...n?{package_name:n}:{},has_build_script:["build","prepare","prepack"].some(a=>typeof t.scripts?.[a]=="string")}}catch{return{has_build_script:!1}}}async function Mc(e,t,n){if(n.source_kind!=="github"||typeof n.source_root!="string")return new f(`Extension entry file is missing at "${t}".`,h.USAGE);let a=await Fc(n.source_root),i=a.package_name?`pm package install npm:${a.package_name}`:void 0,r=n.source_input??n.source_root;return new f(`Extension entry "${e.entry}" is absent from GitHub source "${r}". pm package install copies GitHub repositories without running package scripts${a.has_build_script?", and this package declares a build or publish script":""}. ${i?`Try "${i}" if the package is published, or install a locally built directory.`:"Build the source locally and install that directory, or use its published npm: package."}`,h.USAGE,{code:"github_source_entry_unbuilt",required:"Use a GitHub tree with committed runtime output, a published npm artifact, or a locally built source directory.",why:"GitHub installation is a source copy and never executes untrusted package build scripts.",examples:i?[i,`pm package install ${n.source_root}`]:[`pm package install ${n.source_root}`],nextSteps:i?[`Retry with ${i}.`,"Or build the repository locally, then install its directory."]:["Build the repository locally, then install its directory.","If it is published, retry with pm package install npm:<package-name>."],recovery:{attempted_command:`pm install ${r}`,normalized_args:["install",r],...i?{next_best_command:i}:{}}})}async function Ye(e,t={}){let n=Sn.join(e,"manifest.json");if(!await k(n))throw new f(`Extension manifest is missing at "${n}".`,h.USAGE);let a;try{a=JSON.parse(await Ji.readFile(n,"utf8"))}catch(o){throw new f(`Failed to parse extension manifest at "${n}": ${Uc(o)}`,h.USAGE)}let i=En(a);if(!i)throw new f(`Extension manifest at "${n}" is invalid.`,h.USAGE);let r=Sn.resolve(e,i.entry);if(!H(e,r))throw new f(`Extension entry "${i.entry}" resolves outside extension directory "${e}".`,h.USAGE);if(!await k(r))throw await Mc(i,r,t);if(!await Oa(e,r))throw new f(`Extension entry "${i.entry}" resolves outside extension directory after symlink resolution.`,h.USAGE);return{directory:e,manifest_path:n,entry_path:r,manifest:i}}function Uc(e){return e instanceof Error?e.message:String(e)}import $n from"node:fs/promises";import zc 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]="5181479f-469f-525b-add2-914a9934afbd")}catch{}})();var Gc=".managed-extensions.json",Ft=1;function ot(e){return zc.join(e,Gc)}function Jc(){return{version:Ft,updated_at:T(),entries:[]}}function st(e){return[...e].sort((t,n)=>{let a=t.scope.localeCompare(n.scope);if(a!==0)return a;let i=t.name.localeCompare(n.name);return i!==0?i:t.directory.localeCompare(n.directory)})}function qi(e,t){return e.kind!==t.kind||e.input!==t.input||e.location!==t.location?!1:e.kind==="npm"&&t.kind==="npm"?e.package===t.package&&e.version===t.version:e.kind==="github"&&t.kind==="github"?e.repository===t.repository&&e.ref===t.ref&&e.subpath===t.subpath&&e.commit===t.commit:e.kind==="builtin"&&t.kind==="builtin"?e.name===t.name:!0}function Y(e){return typeof e=="string"?e:void 0}function qc(e){return typeof e.name=="string"&&e.name.trim().length>0&&typeof e.directory=="string"&&e.directory.trim().length>0&&(e.scope==="project"||e.scope==="global")&&typeof e.manifest_version=="string"&&typeof e.manifest_entry=="string"&&Array.isArray(e.capabilities)&&e.capabilities.every(t=>typeof t=="string")&&typeof e.installed_at=="string"&&typeof e.updated_at=="string"}function Wc(e){if(typeof e!="object"||e===null)return null;let t=e;return t.kind!=="local"&&t.kind!=="github"&&t.kind!=="npm"&&t.kind!=="builtin"||typeof t.input!="string"||typeof t.location!="string"?null:{kind:t.kind,input:t.input,location:t.location,name:Y(t.name),package:Y(t.package),version:Y(t.version),repository:Y(t.repository),owner:Y(t.owner),repo:Y(t.repo),ref:Y(t.ref),subpath:Y(t.subpath),commit:Y(t.commit)}}function Bc(e){if(typeof e!="object"||e===null)return null;let t=e;if(!qc(t))return null;let n=Wc(t.source);if(!n)return null;let a=xa(t.contributions);return a===null?null:{name:t.name.trim(),directory:t.directory.trim(),scope:t.scope,manifest_version:t.manifest_version,manifest_entry:t.manifest_entry,capabilities:Z(t.capabilities),contributions:a,installed_at:t.installed_at,updated_at:t.updated_at,source:n,last_update_check_at:Y(t.last_update_check_at),last_update_remote_commit:Y(t.last_update_remote_commit),last_update_remote_version:Y(t.last_update_remote_version),update_available:typeof t.update_available=="boolean"||t.update_available===null?t.update_available:void 0,update_error:Y(t.update_error)}}function Hc(e){if(typeof e!="object"||e===null)return null;let t=e;if(t.version!==Ft||!Array.isArray(t.entries))return null;let n=[];for(let a of t.entries){let i=Bc(a);i&&n.push(i)}return{version:Ft,updated_at:Y(t.updated_at)??T(),entries:st(n)}}async function de(e){let t=ot(e),n=Jc();try{let a=await $n.readFile(t,"utf8"),i=JSON.parse(a),r=Hc(i);if(!r)throw new f(`Managed extension state file "${t}" has an invalid schema. Repair or remove it before mutating extension state.`,h.GENERIC_FAILURE);return{path:t,state:r,warnings:[]}}catch(a){if(a instanceof f)throw a;if(typeof a=="object"&&a!==null&&"code"in a&&_e(a))return{path:t,state:n,warnings:[]};throw new f(`Managed extension state file "${t}" could not be read. Repair or remove it before mutating extension state.`,h.GENERIC_FAILURE)}}async function Xe(e,t){let n=ot(e),a={version:Ft,updated_at:T(),entries:st(t.entries)};await $n.mkdir(e,{recursive:!0}),await $n.writeFile(n,`${JSON.stringify(a,null,2)}
+`,"utf8")}function ct(e,t){let n=e.entries.filter(a=>b(a.name)!==b(t.name)&&b(a.directory)!==b(t.directory));return n.push(t),{...e,updated_at:T(),entries:st(n)}}async function Wi(e,t,n,a){let i=t.entries.find(o=>b(o.name)===b(n));if(!i)return t;let r=ct(t,{...i,contributions:a});return await Xe(e,r),r}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="c9a362e5-6eb5-52dc-aa74-6c6c0df2c291")}catch{}})();var Vc="PM_CLI_PACKAGE_ROOT",Bi={beads:{package_directory:"pm-beads",legacy_extension_directory:"beads"},todos:{package_directory:"pm-todos",legacy_extension_directory:"todos"}},Yc=new Set(["*","all"]);function In(){let e=[],t=process.env[Vc];return typeof t=="string"&&t.trim().length>0&&e.push(ie.resolve(t.trim())),e.push(we(import.meta.url,["../../.."])),[...new Set(e)]}async function dt(e){let t=e.trim().toLowerCase(),n=await Ki(t);if(n)return n;let a=Bi[t];if(!a)return null;for(let i of In()){let r=ie.join(i,".agents","pm","extensions",a.legacy_extension_directory);if(await k(ie.join(r,"manifest.json")))return r}return null}function Hi(e){return Yc.has(e.trim().toLowerCase())}function Xc(e){return e.replace(/^pm-/i,"").trim().toLowerCase()}async function Zc(e,t){let n=await Kc.readdir(e,{withFileTypes:!0});for(let a of n){if(!a.isDirectory()||!a.name.startsWith("pm-"))continue;let i=ie.join(e,a.name);if(!await k(ie.join(i,"package.json")))continue;let r=await rt(i),o=r.aliases&&r.aliases.length>0?r.aliases:[Xc(a.name)];for(let s of o){let d=s.trim().toLowerCase();d.length===0||t.has(d)||t.set(d,{alias:d,package_directory:a.name,package_root:i,package_name:r.package_name??null})}}}async function An(){let e=new Map;for(let t of In()){let n=ie.join(t,"packages");await k(n)&&await Zc(n,e)}for(let[t,n]of Object.entries(Bi))if(!e.has(t))for(let a of In()){let i=ie.join(a,"packages",n.package_directory);if(await k(ie.join(i,"package.json"))){e.set(t,{alias:t,package_directory:n.package_directory,package_root:i,package_name:null});break}}return[...e.values()].sort((t,n)=>t.alias.localeCompare(n.alias))}async function Mt(){return(await An()).map(e=>e.alias)}async function Ki(e){let t=e.trim().toLowerCase();return(await An()).find(n=>n.alias===t||n.package_directory.toLowerCase()===t||n.package_name?.toLowerCase()===t)?.package_root??null}async function Vi(e){let t=await Ki(e);return t?(await rt(t)).package_name??null:null}async function Yi(e){let t=await dt(e);if(!t)return null;try{let n=await jt(t);return n.length!==1?null:(await Ye(n[0])).manifest.name}catch{return null}}function Qc(e){return{docs:e.catalog?.links?.docs??e.package_homepage,npm:e.catalog?.links?.npm??(e.package_name&&e.package_private!==!0?`https://www.npmjs.com/package/${encodeURIComponent(e.package_name)}`:void 0),repository:e.catalog?.links?.repository??e.package_repository_url,report:e.catalog?.links?.report??e.package_bugs_url}}function ed(e,t,n,a,i,r){let o=a==="global"?"--global":"--project",s=Object.fromEntries(Dt.filter(d=>d!=="extensions").map(d=>[d,e.resources[d]??[]]).filter(([,d])=>Array.isArray(d)&&d.length>0));return{alias:t.alias,aliases:n,bundled:!0,available:!0,installed:n.some(d=>i.has(d))||r.has(ie.resolve(t.package_root)),install_target:t.alias,install_command:`pm install ${t.alias} ${o}`,package_name:e.package_name,package_version:e.package_version,description:e.catalog?.summary??e.package_description,keywords:e.package_keywords??[],resources:e.resources,installable_resources:{extensions:e.resources.extensions??[]},metadata_only_resources:s,catalog:{display_name:e.catalog?.display_name,category:e.catalog?.category,tags:e.catalog?.tags??e.package_keywords??[],links:Qc(e),media:e.catalog?.media}}}async function Xi(e,t,n={}){let a=$t(F(process.cwd(),t.path),process.cwd()),i=e==="global"?a.global:a.project,r=await de(i),o=new Set(r.state.entries.filter(m=>m.scope===e).filter(m=>m.source.kind!=="builtin").map(m=>ie.resolve(m.source.location))),s=new Set(r.state.entries.filter(m=>m.scope===e&&m.source.kind==="builtin").flatMap(m=>[m.source.name,m.source.input,m.source.location]).filter(m=>typeof m=="string"&&m.trim().length>0).map(m=>m.trim().toLowerCase())),d=[],c=new Map;for(let m of await An()){let y=ie.resolve(m.package_root),g=c.get(y)??[];g.push(m),c.set(y,g)}for(let m of c.values()){let y=m[0],g=m.map(u=>u.alias).sort((u,w)=>u.localeCompare(w)),_=await rt(y.package_root);d.push(ed(_,y,g,e,s,o))}let l=nd(n.fields),p=l?d.map(m=>ad(m,l)):d;return{total:p.length,scope:e,installable_resource_kinds:["extensions"],metadata_only_resource_kinds:Dt.filter(m=>m!=="extensions"),packages:p}}var td=new Set(["alias","aliases","bundled","available","installed","install_target","install_command","package_name","package_version","description","keywords","resources","installable_resources","metadata_only_resources","catalog","category","display_name"]);function nd(e){if(e===void 0)return;let t=Za(e);if(t.length===0)throw new f("Package catalog --fields requires a comma-separated list of field names",h.USAGE);let n=t.filter(a=>!td.has(a));if(n.length>0)throw new f(`Unknown package catalog --fields value(s): ${n.join(", ")}`,h.USAGE,{examples:["pm package list --project --fields alias,installed,install_command","pm package catalog --project --fields alias,package_name,category"]});return t}function ad(e,t){let n={};for(let a of t)a==="category"?n[a]=e.catalog?.category??null:a==="display_name"?n[a]=e.catalog?.display_name??null:n[a]=e[a]??null;return n}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="fc993281-a2a0-59e8-9f4a-e520f1b94f3b")}catch{}})();var Qi=od(id),zt="@unbrained/pm-cli",ld={maxArchiveBytes:64*1024*1024,maxEntries:4096,maxExpandedBytes:256*1024*1024,maxEntryBytes:64*1024*1024},Tn;async function er(e,t=process.cwd()){let n=e.trim();if(!/^(@[^/\\\s]+\/[^/\\\s]+|[^@/\\\s][^/\\\s]*)$/u.test(n))return null;let a=$.resolve(t);for(;;){let i=$.join(a,"node_modules",...n.split("/")),r=$.join(i,"package.json");if(await k(r))try{let s=JSON.parse(await P.readFile(r,"utf8"));if(s.name===n)return{package:n,...typeof s.version=="string"?{version:s.version}:{},directory:i}}catch{return null}let o=$.dirname(a);if(o===a)return null;a=o}}function On(e,t,n){let a=e.split("/").map(c=>c.trim()).filter(c=>c.length>0);if(a.length<2)return null;let i=a[0],r=a[1].replace(/\.git$/i,"");if(i.length===0||r.length===0)return null;let o=a.slice(2),s,d;return o[0]==="tree"&&o.length>=2?(s=o[1],d=o.slice(2).join("/")):o.length>0&&(d=o.join("/")),typeof n=="string"&&n.trim().length>0&&(s=n.trim()),{kind:"github",input:t,owner:i,repo:r,repository:`https://github.com/${i}/${r}.git`,ref:s,subpath:d&&d.length>0?d:void 0}}function pd(e,t,n){let a=e.slice(4).trim();if(a.length===0)throw new f('npm package source must include a package spec after "npm:".',h.USAGE);if(t)throw new f('Options "--gh/--github" cannot be combined with npm: package sources.',h.USAGE);if(n)throw new f('Option "--ref" cannot be combined with npm: package sources.',h.USAGE);return{kind:"npm",input:e,spec:a}}function lt(e,t={}){let n=e.trim();if(n.length===0)throw new f("Extension source is required for --install.",h.USAGE);let a=typeof t.ref=="string"&&t.ref.trim().length>0?t.ref.trim():void 0;if(n.startsWith("npm:"))return pd(n,t.forceGithub===!0,a);let i=(()=>{try{let o=new URL(n);if(o.hostname!=="github.com")return null;let s=o.pathname.replace(/^\/+/,"");return On(s,n,a)}catch{return null}})();if(i)return i;let r=n.startsWith("github.com/")?n.slice(11):null;if(r){let o=On(r,n,a);if(!o)throw new f(`Invalid GitHub source "${n}".`,h.USAGE);return o}if(t.forceGithub){let o=On(n,n,a);if(!o)throw new f(`Invalid GitHub shorthand "${n}".`,h.USAGE);return o}if(/^https?:\/\//i.test(n))throw new f(`Unsupported extension source URL "${n}". Supported remote source host: github.com.`,h.USAGE);return{kind:"local",input:n,absolute_path:$.resolve(process.cwd(),n)}}async function Ut(e,t=Qi,n){try{return((await t("git",e,{encoding:"utf8",timeout:n})).stdout??"").trim()}catch(a){let i=typeof a=="object"&&a!==null&&"stderr"in a?String(a.stderr):"",r=i.trim().length>0?i.trim():a instanceof Error?a.message:String(a);throw new f(`Git command failed: git ${e.join(" ")}
+${r}`,h.GENERIC_FAILURE)}}function Rn(e=process.platform){return e==="win32"?"npm.cmd":"npm"}function Nn(e=process.platform){return e==="win32"}async function tr(e,t,n=Qi,a=process.platform,i=process.env){let r=Rn(a),o=Object.fromEntries(Object.entries(i).filter(([s])=>s.toLowerCase()!=="npm_config_allow_scripts"));o.NPM_CONFIG_ALLOW_SCRIPTS="";try{return((await n(r,e,{cwd:t,encoding:"utf8",env:o,shell:Nn(a)})).stdout??"").trim()}catch(s){let d=typeof s=="object"&&s!==null&&"stderr"in s?String(s.stderr):"",c=d.trim().length>0?d.trim():s instanceof Error?s.message:String(s);throw new f(`npm command failed: ${r} ${e.join(" ")}
+${c}`,h.GENERIC_FAILURE)}}function nr(e){let t=e.trim(),n=t.includes("@file:")?t.slice(0,t.lastIndexOf("@file:")):t;return n.startsWith("@")?n.match(/^(@[^/@\s]+\/[^/@\s]+)/)?.[1]??n:n.match(/^([^/@\s]+)/)?.[1]??n}function ar(e){let t="@file:",n=e.lastIndexOf(t);return n>0&&e.slice(0,n).trim().length>0&&e.slice(n+t.length).trim().length>0}function md(e){let t=(e instanceof Error?e.message:String(e)).toLowerCase();return t.includes("npm err! code e404")||t.includes("404 not found")||t.includes("is not in this registry")}function ud(e){let t=(e instanceof Error?e.message:String(e)).toLowerCase();return md(e)||t.includes("not found")}function fd(e){let t=e.trim().toLowerCase();return t.startsWith("@unbrained/pm-")||t.startsWith("pm-")}function hd(e){let t=nr(e),n=fd(t),a=t.replace(/^.*\//,""),i=n?`github.com/unbraind/${a}`:void 0,r=i?`pm package install --project ${i}`:void 0;return{message:n?`npm package "${e}" was not found in the registry. If this is an unpublished first-party pm package, install its GitHub repository instead.`:`npm package "${e}" was not found in the registry.`,context:{code:"npm_package_not_found",required:"Use an install source that exists, or publish the npm package before installing it with npm:<name>.",why:"Classifying npm 404s avoids repeated registry retries and gives agents a deterministic fallback path.",examples:r?[r,"pm package catalog --project --json"]:[`npm view ${t}`,"pm package catalog --project --json"],nextSteps:r?[`Try ${r} if the repository exists.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."]:[`Verify ${t} exists in the npm registry and that you have access to it.`,"Use pm package catalog --project --json to inspect bundled package aliases before installing."],recovery:{attempted_command:`pm install --project npm:${e}`,normalized_args:["install","--project",`npm:${e}`],...i&&r?{fallback_candidates:[{source:i,command:r,reason:"canonical first-party GitHub repository fallback for unpublished pm packages"}],next_best_command:r}:{}}}}}function gd(e,t){if(!ud(t))return null;let n=hd(e);return new f(n.message,h.NOT_FOUND,n.context)}async function ir(e){if($.isAbsolute(e)||e.startsWith(".")||e.startsWith("..")){let t=$.resolve(process.cwd(),e);return await k(t)?t:null}try{let t=new URL(e);if(t.protocol==="file:"){let n=rd(t);return await k(n)?n:null}}catch{}if(!/^[a-z][a-z0-9+.-]*:/i.test(e)){let t=$.resolve(process.cwd(),e);if(await k(t))return t}return null}async function yd(e){let t=await ir(e);if(t)return t;let n=_d(e);return n!==e?n:(/^[a-z][a-z0-9+.-]*:/i.test(e),e)}function _d(e,t=process.cwd()){let n="@file:",a=e.lastIndexOf(n);if(!ar(e))return e;let i=e.slice(0,a),r=e.slice(a+n.length);if(r.startsWith("//")&&!r.startsWith("///"))return e;if(!r.startsWith("/"))return`${i}@${$.resolve(t,r)}`;let o;try{o=decodeURIComponent(new URL(`file:${r}`).pathname)}catch{return e}let s=/^\/[A-Za-z]:/.test(o)?o.slice(1):o;return`${i}@${s}`}function Zi(e,t){let n=$.resolve(e,t),a=$.relative(e,n);if(a.length===0||a===".."||a.startsWith(`..${$.sep}`)||$.isAbsolute(a))throw new f("npm pack reported a package archive outside its isolated destination.",h.GENERIC_FAILURE,{code:"npm_package_archive_unsafe",required:"Retry with a trusted npm client that writes its archive inside the requested pack destination.",why:"pm will not read a package-manager artifact outside the isolated directory created for this install."});return n}function wd(e,t){if(typeof e!="object"||e===null||Array.isArray(e))return;let n=e;if(!(typeof n.filename!="string"||n.filename.trim().length===0))return{...t===void 0?{}:{key:t},filename:n.filename,...typeof n.name=="string"?{name:n.name}:{},...typeof n.version=="string"?{version:n.version}:{}}}function vd(e){return(Array.isArray(e)?e.map(t=>({value:t})):typeof e=="object"&&e!==null?Object.entries(e).map(([t,n])=>({key:t,value:n})):[]).flatMap(({key:t,value:n})=>{let a=wd(n,t);return a?[a]:[]})}function bd(e,t){let n=t?.trim().toLowerCase(),a=n?e.filter(o=>{let s=o.name?.trim().toLowerCase();return s!==void 0?s===n:o.key?.trim().toLowerCase()===n}):[];if(a.length===1)return a[0];if(e.length!==1)return;let i=e[0],r=i.name??i.key;return n&&r!==void 0&&r.trim().toLowerCase()!==n?void 0:i}function kd(e,t,n){let a;try{a=JSON.parse(e)}catch{let o=e.split(/\r?\n/).map(s=>s.trim()).filter(s=>s.length>0).at(-1);if(!o)throw new f("npm pack did not report a tarball filename.",h.GENERIC_FAILURE);return{tarball:Zi(t,o)}}let i=vd(a),r=bd(i,n);if(!r)throw new f("npm pack --json returned an unsupported or ambiguous package receipt.",h.GENERIC_FAILURE,{code:"npm_pack_json_shape_unsupported",required:"Use an npm client that returns an array of package receipts or an object keyed by package name, with exactly one requested package entry containing filename.",why:`Well-formed JSON contained ${i.length} usable package receipt(s), but pm could not select ${n??"one package"} deterministically.`});return{tarball:Zi(t,r.filename),package:r.name??r.key,version:r.version}}async function xd(e){return Sd(e,tr)}async function Sd(e,t){let n=await ir(e.spec);if(n){if((await P.stat(n)).isFile()&&rr(n))return Cn(n);let r=$.join(n,"package.json"),o=await k(r)?JSON.parse(await P.readFile(r,"utf8")):{};return{directory:await Gt(n,e.input),package:typeof o.name=="string"?o.name:void 0,version:typeof o.version=="string"?o.version:void 0,cleanup:async()=>{}}}let a=await P.mkdtemp($.join(Pn.tmpdir(),"pm-npm-package-source-")),i=$.join(a,"pack");await P.mkdir(i,{recursive:!0});try{let r=await yd(e.spec),o=await t(["pack",r,"--json","--pack-destination",i]),s=kd(o,i,ar(e.spec)?void 0:nr(e.spec));if(!await k(s.tarball))throw new f("npm pack did not create its reported package archive.",h.GENERIC_FAILURE,{code:"npm_package_archive_missing",required:"Retry the npm package install with a healthy registry and writable temporary directory.",why:"The package manager reported a tarball filename that was absent before validation, so pm cannot safely extract or install it."});let d=await Cn(s.tarball);return{directory:d.directory,package:s.package??d.package,version:s.version??d.version,cleanup:async()=>{try{await d.cleanup()}finally{await P.rm(a,{recursive:!0,force:!0})}}}}catch(r){throw await P.rm(a,{recursive:!0,force:!0}),gd(e.spec,r)||r}}function rr(e){let t=e.toLowerCase();return t.endsWith(".tgz")||t.endsWith(".tar.gz")}function ge(e){throw new f(e,h.USAGE,{code:"local_package_archive_unsafe",required:"Use a bounded npm .tgz or .tar.gz archive with one package/ root and no links or escaping paths.",why:"Package archives are untrusted input and must be validated before any entry reaches the filesystem."})}function Ed(e,t,n){if(e.meta)return;n.entries+=1,n.entries>t.maxEntries&&ge(`Local package archive exceeds the ${t.maxEntries} entry limit.`);let a=e.path,i=a.split("/");(a.includes("\\")||a.startsWith("/")||/^[A-Za-z]:/u.test(a)||i.some(r=>r===".."))&&ge(`Local package archive contains an escaping path: "${a}".`),i[0]!=="package"&&ge(`Local package archive entry "${a}" is outside the required package/ root.`),(e.type==="SymbolicLink"||e.type==="Link")&&ge(`Local package archive link "${a}" is not supported.`),e.type!=="File"&&e.type!=="OldFile"&&e.type!=="Directory"&&ge(`Local package archive entry "${a}" uses unsupported type "${e.type}".`),e.size>t.maxEntryBytes&&ge(`Local package archive entry "${a}" exceeds the ${t.maxEntryBytes} byte entry limit.`),n.expandedBytes+=e.size,n.expandedBytes>t.maxExpandedBytes&&ge(`Local package archive exceeds the ${t.maxExpandedBytes} expanded byte limit.`),a==="package/package.json"&&(n.packageJsonEntries+=1)}async function Cn(e,t=ld){(await P.stat(e)).size>t.maxArchiveBytes&&ge(`Local package archive exceeds the ${t.maxArchiveBytes} archive byte limit.`);let n=await P.mkdtemp($.join(Pn.tmpdir(),"pm-local-package-archive-")),a=$.join(n,"extract");await P.mkdir(a,{recursive:!0});let i={entries:0,expandedBytes:0,packageJsonEntries:0},r;try{if(await dd({file:e,strict:!0,maxDecompressionRatio:100,onReadEntry:c=>{if(r===void 0)try{Ed(c,t,i)}catch(l){r=l}}}),r!==void 0)throw r;i.packageJsonEntries!==1&&ge(`Local package archive must contain exactly one package/package.json entry; found ${i.packageJsonEntries}.`),await cd({file:e,cwd:a,strict:!0,preservePaths:!1,preserveOwner:!1,noMtime:!0,unlink:!0,maxDepth:64,maxDecompressionRatio:100});let o=$.join(a,"package"),s=$.join(o,"package.json"),d=JSON.parse(await P.readFile(s,"utf8"));return await $d(o),{directory:await Gt(o,e),package:typeof d.name=="string"?d.name:void 0,version:typeof d.version=="string"?d.version:void 0,cleanup:async()=>{await P.rm(n,{recursive:!0,force:!0})}}}catch(o){throw await P.rm(n,{recursive:!0,force:!0}),o}}async function $d(e,t=tr){let n=$.join(e,"package.json");if(!await k(n))return;let a;try{a=JSON.parse(await P.readFile(n,"utf8"))}catch{return}if(typeof a!="object"||a===null)return;let i=a,r=Pd(i),o=Id(i);if(r.length===0&&!o)return;let s={...a};delete s.devDependencies;let d={...s};Ad(d),await P.writeFile(n,`${JSON.stringify(d,null,2)}
+`,"utf8");try{await Promise.all([P.rm($.join(e,"package-lock.json"),{force:!0}),P.rm($.join(e,"npm-shrinkwrap.json"),{force:!0})]),r.length>0&&await t(["install","--ignore-scripts","--no-audit","--fund=false","--package-lock=false","--no-save","--omit=peer","--"],e),o&&await Td(e)}finally{await P.writeFile(n,`${JSON.stringify(s,null,2)}
+`,"utf8")}}function Id(e){for(let t of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(typeof t=="object"&&t!==null&&zt in t)return!0;return!1}function Ad(e){for(let t of["dependencies","optionalDependencies","peerDependencies"]){let n=e[t];if(typeof n!="object"||n===null)continue;let a={...n};delete a[zt],Object.keys(a).length===0?delete e[t]:e[t]=a}}async function Td(e){let t=we(import.meta.url,["../../.."]),[n,a]=zt.split("/"),i=$.join(e,"node_modules",n),r=$.join(i,a);await P.mkdir(i,{recursive:!0}),await P.rm(r,{recursive:!0,force:!0}),await P.symlink(t,r,Od(process.platform))}function Od(e){return e==="win32"?"junction":"dir"}function Cd(e,t){if(e.startsWith("-"))throw new f(`Extension runtime dependency name "${e}" is unsafe because npm could interpret it as a command-line option.`,h.USAGE,{code:"extension_dependency_name_unsafe",required:"Use a valid npm package name that does not begin with a dash.",why:"Extension manifests are untrusted input and dependency names must never become npm options."});if([...t].some(n=>{let a=n.charCodeAt(0);return a<=31||a===127||"&|;()`\"'".includes(n)}))throw new f(`Extension runtime dependency "${e}" has an unsafe version specifier.`,h.USAGE,{code:"extension_dependency_version_unsafe",required:"Use an npm version, range, dist-tag, URL, or file specifier without shell metacharacters.",why:"npm.cmd requires a command shell on Windows, so untrusted shell metacharacters cannot be forwarded."});try{sd.resolve(e,t)}catch{throw new f(`Extension runtime dependency "${e}@${t}" is not a valid npm dependency specifier.`,h.USAGE,{code:"extension_dependency_spec_invalid",required:"Use a valid npm package name and npm-supported version, range, dist-tag, URL, or file specifier.",why:"Only grammar-validated dependency specs may be written to the isolated runtime install manifest."})}return`${e}@${t}`}function Pd(e){let t=new Map;for(let n of[e.dependencies,e.optionalDependencies,e.peerDependencies])if(!(typeof n!="object"||n===null))for(let[a,i]of Object.entries(n)){if(a===zt||typeof i!="string"||i.trim().length===0||t.has(a))continue;let r=i.trim();t.set(a,Cd(a,r))}return[...t.values()]}async function Gt(e,t){let n=await jt(e);if(n.length===1)return n[0];if(n.length>1){let a=n.map(i=>$.relative(e,i).replaceAll($.sep,"/")).sort((i,r)=>i.localeCompare(r));throw new f(`Package source "${t}" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${a.join(", ")}`,h.USAGE)}throw new f(`Unable to locate a pm extension manifest in package source "${t}". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,h.USAGE)}async function Rd(e,t){let n=[];t.subpath&&(n.push(t.subpath),n.push($.posix.join(".agents/pm/extensions",t.subpath)),n.push($.posix.join(".custom/pm-extensions",t.subpath)),n.push($.posix.join(".custom/pm-extension",t.subpath)));for(let i of n){let r=$.resolve(e,i);if(H(e,r)&&await k($.join(r,"manifest.json")))return{directory:r,resolved_subpath:i}}if(await k($.join(e,"manifest.json")))return{directory:e,resolved_subpath:"."};let a=await Gt(e,t.input);return{directory:a,resolved_subpath:$.relative(e,a).replaceAll($.sep,"/")}}function Nd(e){let t=e.trim();return t.length===0||t.startsWith(".")||t.startsWith("~")?!1:t.startsWith("@")?t.split("/").length===2:!t.includes("/")&&!t.includes("\\")}async function Dd(e){let t=`Local extension source does not exist: "${e.absolute_path}".`,n=e.input.trim();if(!Nd(n))return new f(t,h.NOT_FOUND);let a=[];try{let r=process.env.PM_CLI_PACKAGE_ROOT,o=typeof r=="string"&&r.trim().length>0?$.resolve(r.trim()):"";Tn?.key!==o&&(Tn={key:o,aliases:await Mt()}),a=Tn.aliases}catch{}let i=[`Retry with pm package install npm:${n} if the package is published to npm.`,`Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${a.join(", ")}`];return new f(`${t} "${n}" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as "npm:${n}".`,h.NOT_FOUND,{code:"local_source_not_found_bare_name",required:`Use "npm:${n}" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,why:"Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.",examples:[`pm package install npm:${n}`,"pm package catalog --project --json"],nextSteps:i,recovery:{attempted_command:`pm install ${n}`,normalized_args:["install",n],next_best_command:`pm package install npm:${n}`}})}async function or(e){if(e.kind==="local"){let a;try{a=await P.stat(e.absolute_path)}catch{throw await Dd(e)}if(a.isFile()&&rr(e.absolute_path)){let r=await Cn(e.absolute_path);return{source:e,directory:r.directory,source_root:$.dirname(r.directory),resolved_subpath:$.relative($.dirname(r.directory),r.directory).replaceAll($.sep,"/"),npm_package:r.package,npm_version:r.version,cleanup:r.cleanup}}if(!a.isDirectory())throw new f(`Local extension source must be a directory or npm .tgz/.tar.gz archive: "${e.absolute_path}".`,h.USAGE);let i=await Gt(e.absolute_path,e.input);return{source:e,directory:i,source_root:e.absolute_path}}if(e.kind==="npm"){let a=await xd(e);return{source:e,directory:a.directory,source_root:$.dirname(a.directory),cleanup:a.cleanup,resolved_subpath:$.relative($.dirname(a.directory),a.directory).replaceAll($.sep,"/"),npm_package:a.package,npm_version:a.version}}let t=await P.mkdtemp($.join(Pn.tmpdir(),"pm-extension-source-")),n=["clone","--depth","1"];e.ref&&n.push("--branch",e.ref),n.push(e.repository,t);try{await Ut(n);let a=await Ut(["-C",t,"rev-parse","HEAD"]),i=await Rd(t,e);return{source:e,directory:i.directory,source_root:t,resolved_subpath:i.resolved_subpath,commit:a,cleanup:async()=>{await P.rm(t,{recursive:!0,force:!0})}}}catch(a){throw await P.rm(t,{recursive:!0,force:!0}),a}}async function Ze(e,t){if(!await k(e)||!await k(t))return!1;let[n,a]=await Promise.all([P.realpath(e),P.realpath(t)]);return n===a}import pt from"node:fs/promises";import mt 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]="ceca3e62-35a7-51eb-b478-5309ba430cc8")}catch{}})();var Dn=1,Fe="2026.6.24",jd=">=22.18.0",Ld={fs_read:!1,fs_write:!1,network:!1,env_read:!1,env_write:!1,process_spawn:!1},sr=new Set([...ka.map(e=>e.split("-")[0].toLowerCase()),...Object.keys(ca).map(e=>e.toLowerCase()),"scaffold"]),Fd="^6.0.0",Md="^22.0.0",lr=["type StarterHarness = Awaited<ReturnType<typeof createExtensionTestHarness>>;","","async function deactivateIfNeeded(ext: StarterHarness, deactivated: boolean): Promise<void> {","  if (!deactivated) {","    try {","      await ext.deactivate();","    } catch {","      // Preserve the original assertion error; cleanup is best effort.","    }","  }","}",""],le=["  } finally {","    await deactivateIfNeeded(ext, deactivated);","  }"];function cr(e,t){return e.map(n=>n===""?n:`${t}${n}`)}function pr(e){let t=e.includeMigrationReplacementHint===!0?["  // as your migration grows."]:[];return["  // assertItemType/Field/Migration throw unless the registration is present, so","  // reaching each next line already proves the wiring; assert on the returned","  // definitions to demonstrate inspecting registered metadata.",`  const itemType = ext.assertItemType({ name: ${JSON.stringify(e.itemTypeName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,`  assert.equal(itemType.itemType.folder, ${JSON.stringify(e.itemTypeFolder)});`,`  const itemField = ext.assertItemField({ name: ${JSON.stringify(e.fieldName)}, extensionName: ${JSON.stringify(e.extensionName)} });`,'  assert.equal(itemField.field.type, "string");',`  ext.assertMigration({ name: ${JSON.stringify(e.migrationId)}, extensionName: ${JSON.stringify(e.extensionName)}, mandatory: false });`,"","  // runMigration invokes the migration through pm's real runner with a synthetic","  // context and returns its result.",...t,`  const migrated = await ext.runMigration({ migration: ${JSON.stringify(e.migrationId)} });`,`  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(e.migrationId)} });`]}function mr(e){return["  // assertProfile throws unless the profile is registered, so reaching the next","  // line already proves the wiring; assert on the returned definition to inspect","  // the bundled archetype dimensions.",`  const { profile } = ext.assertProfile({ name: ${JSON.stringify(e)}, extensionName: ${JSON.stringify(e)} });`,`  assert.equal(profile.title, ${JSON.stringify(`${e} archetype`)});`,"  assert.equal(profile.types.length, 1);","  assert.equal(profile.workflows.length, 1);"]}var Ud={compilerOptions:{target:"ES2022",module:"NodeNext",moduleResolution:"NodeNext",strict:!0,esModuleInterop:!0,skipLibCheck:!0,noEmit:!0,allowImportingTsExtensions:!0,resolveJsonModule:!0,types:["node"]},include:["**/*.ts"]},dr=["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"],ur={commands:["commands"],hooks:["commands","hooks"],search:["commands","search"],importers:["commands","schema","importers"],schema:["commands","schema"],profile:["commands","schema"],renderers:["commands","renderers"],parser:["commands","parser","schema"],preflight:["commands","preflight"],services:["commands","services"]},zd={commands:'["commands"]',hooks:'["commands", "hooks"]',search:'["commands", "search"]',importers:'["commands", "schema", "importers"]',schema:'["commands", "schema"]',profile:'["commands", "schema"]',renderers:'["commands", "renderers"]',parser:'["commands", "parser", "schema"]',preflight:'["commands", "preflight"]',services:'["commands", "services"]'},Gd={commands:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration plus a `deactivate` teardown stub.",hooks:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub.",search:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub.",importers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub.",schema:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a custom item type, a custom item field, a schema migration, and a `deactivate` teardown stub.",profile:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a project profile (item types, statuses, fields, a workflow, config, a template, and package recommendations) registered via `api.registerProfile`, and a `deactivate` teardown stub.",renderers:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a `toon` output renderer override, and a `deactivate` teardown stub.",parser:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a parser override that rewrites the command's parsed options, and a `deactivate` teardown stub.",preflight:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, a preflight override over pm's pre-run gate decision, and a `deactivate` teardown stub.",services:"- `index.ts`: the TypeScript manifest entry \u2014 starter command registration, an `output_format` service override, and a `deactivate` teardown stub."},Jd={commands:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.",hooks:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.",search:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.",importers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers.",schema:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, item type/field/migration registration, migration invocation, and teardown via the SDK testing helpers.",profile:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, project-profile registration (asserting the bundled archetype dimensions), and teardown via the SDK testing helpers.",renderers:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, renderer override registration and invocation (including format pass-through), and teardown via the SDK testing helpers.",parser:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, parser override registration and the option rewrite it produces, and teardown via the SDK testing helpers.",preflight:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, preflight override registration and the gate decision it returns, and teardown via the SDK testing helpers.",services:"- `index.test.ts`: sample `node:test` suite covering activation, command invocation, service override registration and invocation (including command pass-through), and teardown via the SDK testing helpers."},fr="- `tsconfig.json`: strict type-check-only TypeScript config (`noEmit`) for the `.ts` source the loader runs directly.",qd={commands:[],hooks:["","## Lifecycle Hook","`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.","pm fires it once a command finishes, passing the command outcome and the","items it mutated (`context.affected`). React there to keep external context","in sync - sync records, emit telemetry, or refresh derived state. The","`hooks` capability in `manifest.json` is what grants the hook registration;","remove it (and the hook) if your package only needs commands."],search:["","## Search Provider","`index.ts` registers a deterministic in-memory search provider and","vector-store adapter through `api.registerSearchProvider` and","`api.registerVectorStoreAdapter`. Replace the sample scoring,","embedding, and storage behavior with your project-specific retrieval","logic. The `search` capability in `manifest.json` grants both","registrations."],importers:["","## Importer and Exporter","`index.ts` registers paired project-context import/export commands through","`api.registerImporter` and `api.registerExporter`. Replace the starter","payloads with your domain adapter: GitHub issues, CSV rows, documents,","tickets, or another project-management source of truth. The `importers`","capability grants both registrations, and `schema` grants the example","command flag metadata."],schema:["","## Custom Schema","`index.ts` models a project domain by registering a custom item type, a","custom item field, and a schema migration through `api.registerItemTypes`,","`api.registerItemFields`, and `api.registerMigration`. This is how a package","turns pm into a domain-specific tracker \u2014 `project management = context","management`. Replace the sample type/field/migration with your own domain","model; the `schema` capability in `manifest.json` grants all three","registrations. Once installed, the custom type is usable everywhere, e.g.",'`pm create <type> "<title>"` and `pm list --type <type>`.'],profile:["","## Project Profile","`index.ts` registers a complete project-profile archetype through","`api.registerProfile`. A profile is the broadest customization primitive pm","has \u2014 one declarative bundle of item types, custom statuses, fields, a per-type","workflow, config knobs, create templates, and package recommendations. Once the","package is installed the profile resolves by name through `pm profile list`,","`pm profile show <name>`, and `pm profile apply <name>`, which stages every","dimension idempotently \u2014 exactly like a core archetype (agile/ops/research),","with no consumer code required. Replace the sample archetype with your own","domain; the `schema` capability in `manifest.json` grants the registration (a","profile is a schema+config bundle, so it needs no separate capability)."],renderers:["","## Output Renderer","`index.ts` registers a `toon` output renderer override through","`api.registerRenderer`. Renderer overrides run for every command's output in","that format, so this starter scopes itself to THIS package's own command and","returns `null` (pass-through to pm's default renderer) for everything else.","Return a string to take over rendering. Replace the sample serialization with","your own; the `renderers` capability in `manifest.json` grants the","registration."],parser:["","## Parser Override","`index.ts` registers a parser override for the starter command through","`api.registerParser`. pm runs it on the command's parsed options BEFORE the","handler, merging the delta you return. This starter rewrites a deprecated","`--shout` alias to the canonical `--upper` flag; replace it with your","command's real normalization. The `parser` capability in `manifest.json`","grants the registration."],preflight:["","## Preflight Override","`index.ts` registers a preflight override through `api.registerPreflight`. pm","calls it only for its declared command ownership to compute the migration/format","gate decision. Overlapping or legacy global ownership is diagnosed. Return only","the decision keys you want to","change; this starter echoes the current decision unchanged (a safe no-op) so","installing the package does not alter gate behavior. The `preflight`","capability in `manifest.json` grants the registration."],services:["","## Service Override","`index.ts` overrides the built-in `output_format` service through","`api.registerService`. The service renders a command's structured result;","returning the payload unchanged passes through to pm's default formatting.","This starter scopes itself to THIS package's own command and passes every","other command through, so it never disrupts unrelated output. The `services`","capability in `manifest.json` grants the registration."]},Wd={package:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","package's `activate` registers. pm imports and activates the package lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands (`pm list`, `pm search`, ...) never pay to load it. Keep this list in","sync with the registrations in `index.ts`: add an entry when you register a new","command, importer, or exporter, and remove one you drop. An omitted or stale","entry means the matching command will not dispatch from the CLI. Globally-scoped","surfaces (hooks, parser/preflight/renderer overrides, and search providers for","built-in search commands) still activate regardless of this list."],extension:["","## Lazy Activation","`manifest.json` declares `activation.commands`: the exact command paths this","extension's `activate` registers. pm imports and activates the extension lazily \u2014","only when an invoked command path matches one of these entries \u2014 so unrelated","commands never pay to load it. Keep this list in sync with the registrations in","`index.ts`: an omitted or stale entry means the matching command will not dispatch","from the CLI. Globally-scoped surfaces (hooks, parser/preflight/renderer overrides,","and search providers for built-in search commands) still activate regardless."]},Bd={package:["","## Activation","This package contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the package","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`. If you","drop the schema registrations and keep only command/hook/search/importer surfaces,","add `activation.commands` back so pm can load the package lazily."],extension:["","## Activation","This extension contributes a GLOBAL custom item type and field, so `manifest.json`","intentionally declares no `activation.commands`. pm activates the extension","conservatively \u2014 for every command \u2014 so the custom type is present wherever it is","used: `pm create <type>`, `pm list --type <type>`, `pm validate`, and so on.","Declaring narrow `activation.commands` here would gate activation to only those","commands and silently leave the custom type unregistered for `pm create`."]},Hd={package:["","## Activation","This package contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands \u2014 commands the package does not own \u2014 so `manifest.json` intentionally","declares no `activation.commands`. pm activates the package conservatively (for","every command, granted by the `schema` capability) so the profile is present","whenever `pm profile` runs. Declaring narrow `activation.commands` here would","gate activation to only the listed commands and silently leave the profile","unregistered for `pm profile`."],extension:["","## Activation","This extension contributes a project profile resolved by the built-in","`pm profile list`, `pm profile show <name>`, and `pm profile apply <name>`","commands, so `manifest.json` intentionally declares no `activation.commands`. pm","activates the extension conservatively (for every command, granted by the","`schema` capability) so the profile is present whenever `pm profile` runs.","Declaring narrow `activation.commands` here would silently leave the profile","unregistered for `pm profile`."]};function hr(e,t){return e==="schema"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the custom item type activates for every command).`:e==="profile"?`- \`manifest.json\`: ${t} metadata and capabilities (no \`activation.commands\` \u2014 the contributed profile resolves through \`pm profile\` for every command).`:`- \`manifest.json\`: ${t} metadata, capabilities, and \`activation.commands\` (the command paths that lazily activate this ${t}).`}function gr(e,t){return e==="schema"?Bd[t]:e==="profile"?Hd[t]:Wd[t]}function Kd(e){let t=e.replace(/-/g," ").trim().split(/\s+/).filter(o=>o.length>0);if(t.length===0)return"starter ping";let n=t[0].toLowerCase(),a=0;for(;t[a]?.toLowerCase()==="starter";)a+=1;let i=t[a]?.toLowerCase(),r=a>0&&(a===t.length||i!==void 0&&sr.has(i));return`${(sr.has(n)||r?["starter",...t]:t).join(" ")} ping`}function yr(e){let t=e,n=`${e}s`,a=e.replace(/-/g,""),i=a===t?[]:[a],r=`${e.replace(/-/g,"_")}_owner`,o="reviewing";return[`  name: ${JSON.stringify(e)},`,`  title: ${JSON.stringify(`${e} archetype`)},`,'  summary: "Starter project profile. Replace these dimensions with your own archetype.",',"  // Item types the profile upserts into the project schema when applied.","  types: [","    {",`      name: ${JSON.stringify(t)},`,`      folder: ${JSON.stringify(n)},`,`      aliases: ${JSON.stringify(i)},`,`      description: ${JSON.stringify(`A ${e} work item that flows to done.`)},`,"    },","  ],","  // Custom statuses upserted into the project status set.","  statuses: [","    {",`      id: ${JSON.stringify(o)},`,'      roles: ["active"],','      aliases: ["in-review"],','      description: "Work is implementation-complete and awaiting review.",',"    },","  ],","  // Custom item-metadata fields the archetype tracks.","  fields: [","    {",`      key: ${JSON.stringify(r)},`,'      type: "string",','      commands: ["create", "update", "list"],','      description: "Stakeholder accountable for the item.",',"    },","  ],","  // Per-type workflow transition allow-list staged into settings.","  workflows: [","    {",`      type: ${JSON.stringify(t)},`,"      allowed_transitions: [",'        ["open", "in_progress"],',`        ["in_progress", ${JSON.stringify(o)}],`,`        [${JSON.stringify(o)}, "in_progress"],`,`        [${JSON.stringify(o)}, "closed"],`,'        ["in_progress", "blocked"],','        ["blocked", "in_progress"],',"      ],","    },","  ],","  // Nested-settings knobs staged when the profile is applied.","  config: [",'    { key: "search_provider", value: "bm25", summary: "Offline BM25 lexical search needs no embedding service." },','    { key: "search_max_results", value: "20", summary: "Result cap tuned for quick triage." },',"  ],","  // Create templates staged into <pmRoot>/templates.","  templates: [","    {",`      name: ${JSON.stringify(e)},`,"      options: {",`        type: ${JSON.stringify(t)},`,'        priority: "2",',`        tags: ${JSON.stringify(e)},`,'        acceptanceCriteria: "Item delivers the stated outcome with tests and docs updated.",','        body: "## Context\\n\\n## Acceptance\\n- [ ] \\n",',"      },","    },","  ],","  // Advisory package recommendations (never auto-installed).","  packages: [",'    { spec: "templates", reason: "Reusable create templates for recurring item shapes." },',"  ],"]}function Vd(e,t,n){let a=`${e}-search`,i=`${e}-vector`,r=`${e.replace(/-/g," ")} items`,o=["  api.registerCommand({",`    name: ${JSON.stringify(t)},`,'    description: "Starter scaffold command. Replace with your own behavior.",',"    run: async (context) => ({","      ok: true,",`      source: ${JSON.stringify(e)},`,"      command: context.command,",'      message: "Starter extension scaffold is active.",',"    }),","  });"];if(n==="commands")return o;if(n==="search")return[...o,"","  // Search providers let packages customize how pm ranks and retrieves","  // project context. This starter is deterministic and dependency-free:","  // replace the scoring with your domain retrieval, embedding, or rerank","  // logic as the package grows.","  api.registerSearchProvider({",`    name: ${JSON.stringify(a)},`,"    query: async (context) => {","      const needle = context.query.toLowerCase();","      const hits = context.documents","        .filter((document) => {",'          const title = String(document.metadata.title ?? "").toLowerCase();',"          return title.includes(needle);","        })","        .map((document) => ({","          id: document.metadata.id,","          score: 1,",'          matched_fields: ["title"],',"        }));","      return { hits };","    },","    embed: async (context) => [context.input.length],","  });","","  // Vector-store adapters let packages own semantic index storage. This","  // starter returns a stable in-memory hit so generated tests can exercise","  // the adapter without external services.","  api.registerVectorStoreAdapter({",`    name: ${JSON.stringify(i)},`,'    query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"    upsert: async (context) => ({ upserted: context.points.length }),","    delete: async (context) => ({ deleted: context.ids.length }),","  });"];if(n==="schema"){let s=e,d=`${e}s`,c=e.replace(/-/g,""),l=c===s?[]:[c],p=`${e.replace(/-/g,"_")}_note`,m=`${e}-0001-init`;return[...o,"","  // Schema registrations let a package model its own project domain \u2014 the",'  // heart of "project management = context management". Item types and fields',"  // are GLOBAL contributions: built-in commands like `pm create <type>` and","  // `pm list --type <type>` must see them, so this package declares no","  // `activation.commands` and pm activates it conservatively for every command.","  // The `schema` capability in manifest.json grants all three registrations.","  api.registerItemFields([","    {",`      name: ${JSON.stringify(p)},`,'      type: "string",',"      optional: true,","    },","  ]);","","  api.registerItemTypes([","    {",`      name: ${JSON.stringify(s)},`,"      // Replace with your domain's canonical plural folder name.",`      folder: ${JSON.stringify(d)},`,`      aliases: ${JSON.stringify(l)},`,"      // Add field names here to force them at `pm create` time.","      required_create_fields: [],","    },","  ]);","","  // Migrations let a package evolve stored items as its schema changes. pm","  // runs each migration ONCE through the preflight gate (not once per item),","  // passing a context that identifies the migration itself: `context.id` is","  // the migration id (not an item id), alongside `context.pm_root` \u2014 iterate","  // the corpus yourself from there. This starter is a deterministic no-op so","  // package tests can invoke it without touching the corpus; replace the body","  // with your real rewrite.","  api.registerMigration({",`    id: ${JSON.stringify(m)},`,`    description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"    mandatory: false,","    run: async (context) => ({ migrated: true, id: context.id }),","  });"]}return n==="profile"?[...o,"","  // A project profile is the broadest customization primitive pm has: one","  // declarative bundle of item types, custom statuses, fields, a per-type","  // workflow, config knobs, create templates, and package recommendations. Once","  // this package is installed the profile resolves by name through `pm profile","  // list`, `pm profile show`, and `pm profile apply`, which stages every dimension","  // idempotently like a core archetype. A profile registration is a schema+config","  // bundle, so the `schema` capability in manifest.json grants it.","  api.registerProfile({",...yr(e).map(s=>`  ${s}`),"  });"]:n==="importers"?[...o,"","  // Importers/exporters are the bridge between pm's context graph and","  // another project-management system. Keep the starter deterministic so","  // package tests can run without touching the network or filesystem; replace","  // these payloads with your adapter's real mapping as the package grows.","  api.registerImporter(",`    ${JSON.stringify(r)},`,"    async (context) => ({","      imported: 1,",'      source: context.options.source ?? "starter",',"      args: context.args,","    }),","    {",`      action: ${JSON.stringify(`${r} import`)},`,'      description: "Import starter records into pm context.",',"      flags: [","        {",'          long: "--source",','          value_name: "name",','          value_type: "string",','          description: "Source name or path to import from.",',"        },","      ],","    },","  );","","  api.registerExporter(",`    ${JSON.stringify(r)},`,"    async (context) => ({","      exported: true,",'      destination: context.options.destination ?? "stdout",',"      args: context.args,","    }),","    {",`      action: ${JSON.stringify(`${r} export`)},`,'      description: "Export pm context into starter records.",',"      flags: [","        {",'          long: "--destination",','          value_name: "name",','          value_type: "string",','          description: "Destination name or path to export to.",',"        },","      ],","    },","  );"]:n==="renderers"?[...o,"","  // Renderer overrides customize how pm serializes a command's structured",'  // result for an output format ("toon" or "json"). Host-enforced ownership',"  // prevents unrelated commands from reaching this callback.","  // The `renderers` capability in manifest.json grants the registration.",'  api.registerRenderer("toon", (context) => {',`    return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,`  }, { commands: [${JSON.stringify(t)}] });`]:n==="parser"?["  api.registerCommand({",`    name: ${JSON.stringify(t)},`,'    description: "Starter scaffold command. Replace with your own behavior.",',"    flags: [","      {",'        long: "--shout",','        value_type: "boolean",','        description: "Deprecated alias for --upper; the parser override rewrites it.",',"      },","      {",'        long: "--upper",','        value_type: "boolean",','        description: "Echo the canonical flag the parser override produces.",',"      },","    ],","    run: async (context) => ({","      ok: true,",`      source: ${JSON.stringify(e)},`,"      command: context.command,","      // Surfaces the normalized option so `--shout`/`--upper` is observable.","      upper: context.options.upper === true,",'      message: "Starter extension scaffold is active.",',"    }),","  });","","  // Parser overrides preprocess a command's parsed options BEFORE its handler","  // runs, returning a delta \u2014 only the keys you set are merged over the parsed","  // input. This override is scoped to THIS package's own command. Here it","  // rewrites the deprecated `--shout` boolean alias to the canonical `--upper`","  // flag; replace it with your command's real normalization. The `parser`","  // capability in manifest.json grants the registration.",`  api.registerParser(${JSON.stringify(t)}, (context) => {`,"    const options = { ...context.options };","    if (options.shout === true) {","      options.upper = true;","    }","    delete options.shout;","    return { options };","  });"]:n==="preflight"?[...o,"","  // Preflight overrides adjust pm's pre-run gate decision (extension","  // migrations + item-format checks) for the commands it owns. Disjoint","  // packages compose; overlapping or legacy global ownership is diagnosed.","  // Return a delta of the keys you want to change","  // (enforce_item_format_gate, run_preflight_item_format_sync,","  // run_extension_migrations, enforce_mandatory_migration_gate); returning","  // context.decision unchanged is a safe no-op so installing the package does","  // not alter gate behavior \u2014 replace it with your policy, e.g.","  // `{ run_extension_migrations: false }`. The `preflight` capability in","  // manifest.json grants the registration.","  api.registerPreflight({",`    commands: [${JSON.stringify(t)}],`,"    run: (context) => context.decision,","  });"]:n==="services"?[...o,"","  // Service overrides replace a built-in pm service. The `output_format`","  // service renders a command's structured result; returning the payload","  // unchanged passes through to pm's default formatting. This override scopes","  // itself to THIS package's own command and passes every other command","  // through, so it never disrupts unrelated output. The `services` capability","  // in manifest.json grants the registration.",'  api.registerService("output_format", (context) => {',`    if (context.command !== ${JSON.stringify(t)}) {`,"      return { handled: false };","    }",`    return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"  });"]:[...o,"","  // after_command hooks fire once pm finishes a command, receiving the items","  // it mutated. This is the natural place to react to every change - sync to","  // an external system, emit telemetry, or refresh derived context",'  // ("project management = context management"). This starter is a documented',"  // no-op on the success path; replace the body with your own reaction.","  api.hooks.afterCommand((context) => {","    if (!context.ok) {","      return;","    }","    // `context.affected` lists the items pm mutated (id, status,","    // changed_fields). React here, e.g.:","    //   for (const item of context.affected ?? []) { /* ...item.id... */ }","  });"]}function Yd(e,t,n){let a=n==="hooks",i=n==="search",r=n==="importers",o=n==="schema",s=n==="profile",d=n==="renderers",c=n==="parser",l=n==="preflight",p=n==="services",m=zd[n],y=e,g=`${e}s`,_=`${e.replace(/-/g,"_")}_note`,u=`${e}-0001-init`,w=["  assertExtensionDeactivated,","  createExtensionTestHarness,"],v=a?[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertHook throws unless an after_command hook is registered, so","    // reaching the next line already proves the hook is wired.","    ext.assertHook({",'      kind: "after_command",',`      extensionName: ${JSON.stringify(e)},`,"    });","    // runHook fires the hook through pm's real runner with a synthetic","    // context and returns the warnings it produced; a clean hook returns none.","    // Replace the context/assertions as your hook grows.","    const warnings = await ext.runHook({",'      kind: "after_command",',"      context: {",`        command: ${JSON.stringify(t)},`,"        args: [],",'        pm_root: "",',"        ok: true,","        affected: [],","      },","    });","    assert.deepEqual(warnings, []);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],E=i?jn(e,t,"search",m):[],S=r?jn(e,t,"importers",m):[],C=o?[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {",...cr(pr({extensionName:e,itemTypeName:y,itemTypeFolder:g,fieldName:_,migrationId:u,includeMigrationReplacementHint:!0}),"  "),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],te=s?[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {",...cr(mr(e),"  "),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],D=d?[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertRendererOverride throws unless a renderer is registered for the","    // format, so reaching the next line already proves the wiring.",`    const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,'    assert.equal(override.format, "toon");',"","    // runRendererOverride renders through pm's real runner. The override","    // customizes only THIS package's command output and returns a string the","    // host uses verbatim. Replace the assertions as it grows.","    const rendered = await ext.runRendererOverride({",'      format: "toon",',`      command: ${JSON.stringify(t)},`,"      result: { ok: true },","    });","    assert.equal(rendered.overridden, true);",`    assert.equal(rendered.rendered, ${JSON.stringify(`${e}: `)} + JSON.stringify({ ok: true }));`,"","    // Output for any other command passes through to pm's default renderer.","    const passthrough = await ext.runRendererOverride({",'      format: "toon",','      command: "list",',"      result: { ok: true },","    });","    assert.equal(passthrough.overridden, false);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],x=c?[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertParserOverride throws unless a parser is registered for the","    // command, so reaching the next line already proves the wiring.",`    ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,"","    // runParserOverride runs the override through pm's real parser runner and","    // returns the rewritten context. The starter rewrites the deprecated","    // `shout` alias to the canonical `upper` flag.","    const result = await ext.runParserOverride({",`      command: ${JSON.stringify(t)},`,"      args: [],","      options: { shout: true },","      global: {},",'      pm_root: "",',"    });","    assert.equal(result.overridden, true);","    assert.deepEqual(result.context.options, { upper: true });","","    // End to end: feed the rewritten options into the command handler to","    // prove `pm <command> --shout` surfaces the normalized `upper` flag in","    // the result.",`    const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`,"    assert.equal(invocation.handled, true);","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,"      upper: true,",'      message: "Starter extension scaffold is active.",',"    });","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],z=l?[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertPreflightOverride throws unless a preflight override is","    // registered, so reaching the next line already proves the wiring.",`    ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,"","    // runPreflightOverride runs the override through pm's real runner with a","    // synthetic gate decision. The starter echoes the decision unchanged;","    // replace the values/assertions with your real policy.","    const decision = {","      enforce_item_format_gate: true,","      run_preflight_item_format_sync: false,","      run_extension_migrations: true,","      enforce_mandatory_migration_gate: false,","    };","    const result = await ext.runPreflightOverride({",`      command: ${JSON.stringify(t)},`,"      args: [],","      options: {},","      global: {},",'      pm_root: "",',"      decision,","    });","    assert.equal(result.overridden, true);","    assert.deepEqual(result.decision, decision);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[],tt=p?[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,"  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertServiceOverride throws unless a service override is registered","    // for the service, so reaching the next line proves the wiring.",`    ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,"","    // runServiceOverride runs the override through pm's real service runner.","    // The override customizes only THIS package's command output (handled),","    // passing every other command through (not handled).","    const handled = await ext.runServiceOverride({",'      service: "output_format",',`      command: ${JSON.stringify(t)},`,"      payload: { ok: true },","    });","    assert.equal(handled.handled, true);",`    assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,"","    // Output for any other command passes through to pm's default formatter.","    const passthrough = await ext.runServiceOverride({",'      service: "output_format",','      command: "list",',"      payload: { ok: true },","    });","    assert.equal(passthrough.handled, false);","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});",""]:[];return['import assert from "node:assert/strict";','import { test } from "node:test";',"import {",...w,'} from "@unbrained/pm-cli/sdk/testing";',...i?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension from "./index.ts";',"",...lr,`test(${JSON.stringify(`${e} registers its starter command`)}, async () => {`,"  // `capabilities` mirrors manifest.json so the in-memory activation grants","  // the capabilities the entrypoint relies on.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  let deactivated = false;","  try {","    // assertCommandContract is bound to the right activation registry and throws","    // if the command is not registered, so reaching here already proves the","    // wiring; assert on the returned definition to inspect metadata.","    const registered = ext.assertCommandContract({",`      name: ${JSON.stringify(t)},`,`      extensionName: ${JSON.stringify(e)},`,"    });",'    assert.equal(typeof registered.command.description, "string");',"","    // runCommand invokes the handler through pm's real dispatch engine, so this","    // asserts behavior - not just that the command is wired. Replace these","    // assertions as you flesh out your command.","    const invocation = await ext.runCommand({",`      command: ${JSON.stringify(t)},`,"    });","    assert.equal(invocation.handled, true);","    // The handler result is typed `unknown`, so deep-equality on the whole","    // structured payload keeps the assertion type-safe without a cast.","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,...c?["      upper: false,"]:[],'      message: "Starter extension scaffold is active.",',"    });","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});","",...v,...E,...S,...C,...te,...D,...x,...z,...tt,`test(${JSON.stringify(`${e} tears down cleanly via deactivate`)}, async () => {`,"  // createExtensionTestHarness binds teardown to the same name/layer used for","  // activation, so this proves your `deactivate` hook runs without throwing.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${m},`,"  });","  const teardown = await ext.deactivate();","  // assertExtensionDeactivated throws unless exactly one extension tore down","  // with no failures, so reaching the next line already proves teardown ran.","  assertExtensionDeactivated(teardown);","  assert.equal(teardown.deactivated, 1);","});",""].join(`
+`)}function Xd(e,t,n){if(n==="schema"||n==="profile")return[];if(n==="importers"){let a=`${e.replace(/-/g," ")} items`;return[t,`${a} import`,`${a} export`]}return[t]}var Zd={commands:"starter command",hooks:"starter command and after_command hook",search:"starter command, search provider, and vector-store adapter",importers:"starter command, importer, and exporter",schema:"starter command, custom item type, item field, and migration",profile:"starter command and project profile",renderers:"starter command and toon renderer override",parser:"starter command and parser override",preflight:"starter command and preflight override",services:"starter command and output_format service override"},Qd={commands:"`commands`",hooks:"`commands` and `hooks.afterCommand`",search:"`commands`, `searchProviders`, and `vectorStoreAdapters`",importers:"`commands`, `importers`, and `exporters`",schema:"`commands`, `itemTypes`, `itemFields`, and `migrations`",profile:"`commands` and `profiles`",renderers:"`commands` and `renderers`",parser:"`commands` and `parsers`",preflight:"`commands` and `preflights`",services:"`commands` and `services`"};function el(e,t,n){let a=n==="parser";return["// The starter command, authored with the `defineCommand` builder so its literal","// name is preserved and the handler `context` is inferred. Exporting it lets you","// unit-test the definition in isolation, apart from the blueprint.","export const pingCommand = defineCommand({",`  name: ${JSON.stringify(t)},`,'  description: "Starter scaffold command. Replace with your own behavior.",',...a?["  flags: [","    {",'      long: "--shout",','      value_type: "boolean",','      description: "Deprecated alias for --upper; the parser override rewrites it.",',"    },","    {",'      long: "--upper",','      value_type: "boolean",','      description: "Echo the canonical flag the parser override produces.",',"    },","  ],"]:[],"  run: async (context) => ({","    ok: true,",`    source: ${JSON.stringify(e)},`,"    command: context.command,",...a?["    upper: context.options.upper === true,"]:[],'    message: "Starter extension scaffold is active.",',"  }),","});"]}function tl(e,t,n){let a=[],i=[...el(e,t,n)],r=["  commands: [pingCommand],"],o=`${e}-search`,s=`${e}-vector`,d=`${e.replace(/-/g," ")} items`,c=e,l=`${e}s`,p=e.replace(/-/g,""),m=p===c?[]:[p],y=`${e.replace(/-/g,"_")}_note`,g=`${e}-0001-init`;switch(n){case"commands":break;case"hooks":a.push("defineAfterCommandHook"),i.push("","// after_command hooks fire once pm finishes a command, receiving the items it","// mutated. React here - sync to an external system, emit telemetry, or refresh",'// derived context ("project management = context management"). This starter is a',"// documented no-op on the success path; replace the body with your own reaction.","export const afterCommandHook = defineAfterCommandHook((context) => {","  if (!context.ok) {","    return;","  }","  // `context.affected` lists the items pm mutated (id, status, changed_fields):","  //   for (const item of context.affected ?? []) { /* ...item.id... */ }","});"),r.push("  hooks: { afterCommand: [afterCommandHook] },");break;case"search":a.push("defineSearchProvider","defineVectorStoreAdapter"),i.push("","// Search providers let packages customize how pm ranks and retrieves project","// context. This starter is deterministic and dependency-free: replace the scoring","// with your domain retrieval, embedding, or rerank logic as the package grows.","export const searchProvider = defineSearchProvider({",`  name: ${JSON.stringify(o)},`,"  query: async (context) => {","    const needle = context.query.toLowerCase();","    const hits = context.documents","      .filter((document) => {",'        const title = String(document.metadata.title ?? "").toLowerCase();',"        return title.includes(needle);","      })","      .map((document) => ({","        id: document.metadata.id,","        score: 1,",'        matched_fields: ["title"],',"      }));","    return { hits };","  },","  embed: async (context) => [context.input.length],","});","","// Vector-store adapters let packages own semantic index storage. This starter","// returns a stable in-memory hit so generated tests can exercise the adapter","// without external services.","export const vectorStoreAdapter = defineVectorStoreAdapter({",`  name: ${JSON.stringify(s)},`,'  query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"  upsert: async (context) => ({ upserted: context.points.length }),","  delete: async (context) => ({ deleted: context.ids.length }),","});"),r.push("  searchProviders: [searchProvider],","  vectorStoreAdapters: [vectorStoreAdapter],");break;case"importers":a.push("defineExporter","defineImporter"),i.push("","// Importers/exporters are the bridge between pm's context graph and another","// project-management system. Keep the starter deterministic so package tests can","// run without touching the network or filesystem; replace these payloads with","// your adapter's real mapping as the package grows.","export const importer = defineImporter(async (context) => ({","  imported: 1,",'  source: context.options.source ?? "starter",',"  args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({","  exported: true,",'  destination: context.options.destination ?? "stdout",',"  args: context.args,","}));"),r.push("  importers: [","    {",`      name: ${JSON.stringify(d)},`,"      importer,","      options: {",`        action: ${JSON.stringify(`${d} import`)},`,'        description: "Import starter records into pm context.",',"        flags: [","          {",'            long: "--source",','            value_name: "name",','            value_type: "string",','            description: "Source name or path to import from.",',"          },","        ],","      },","    },","  ],","  exporters: [","    {",`      name: ${JSON.stringify(d)},`,"      exporter,","      options: {",`        action: ${JSON.stringify(`${d} export`)},`,'        description: "Export pm context into starter records.",',"        flags: [","          {",'            long: "--destination",','            value_name: "name",','            value_type: "string",','            description: "Destination name or path to export to.",',"          },","        ],","      },","    },","  ],");break;case"schema":a.push("defineItemField","defineItemType","defineMigration"),i.push("","// Schema registrations let a package model its own project domain - the heart of",'// "project management = context management". Item types and fields are GLOBAL',"// contributions, so this package declares no `activation.commands` and pm","// activates it conservatively for every command.","export const noteField = defineItemField({",`  name: ${JSON.stringify(y)},`,'  type: "string",',"  optional: true,","});","","export const itemType = defineItemType({",`  name: ${JSON.stringify(c)},`,"  // Replace with your domain's canonical plural folder name.",`  folder: ${JSON.stringify(l)},`,`  aliases: ${JSON.stringify(m)},`,"  // Add field names here to force them at `pm create` time.","  required_create_fields: [],","});","","// Migrations let a package evolve stored items as its schema changes. pm runs each","// migration ONCE through the preflight gate (not once per item), passing a context","// that identifies the migration itself: `context.id` is the migration id (not an","// item id), alongside `context.pm_root`. This starter is a deterministic no-op so","// package tests can invoke it without touching the corpus; replace the body with","// your real rewrite.","export const initMigration = defineMigration({",`  id: ${JSON.stringify(g)},`,`  description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"  mandatory: false,","  run: async (context) => ({ migrated: true, id: context.id }),","});"),r.push("  itemTypes: [itemType],","  itemFields: [noteField],","  migrations: [initMigration],");break;case"profile":a.push("defineProjectProfile"),i.push("","// A project profile is the broadest customization primitive pm has: one","// declarative bundle of item types, custom statuses, fields, a per-type workflow,","// config knobs, create templates, and package recommendations. Once installed it","// resolves by name through `pm profile list/show/apply`, which stages every","// dimension idempotently like a core archetype. A profile registration is a","// schema+config bundle, so the `schema` capability grants it.","export const starterProfile = defineProjectProfile({",...yr(e),"});"),r.push("  profiles: [starterProfile],");break;case"renderers":a.push("defineRendererOverride"),i.push("","// Host-enforced command ownership prevents unrelated output from reaching","// this renderer callback; return a string to take over serialization.","export const toonRenderer = defineRendererOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => {",`    return ${JSON.stringify(`${e}: `)} + JSON.stringify(context.result);`,"  },","});"),r.push("  renderers: { toon: toonRenderer },");break;case"parser":a.push("defineParserOverride"),i.push("","// Parser overrides preprocess a command's parsed options BEFORE its handler runs,","// returning a delta - only the keys you set are merged over the parsed input. This","// override is scoped to THIS package's own command; here it rewrites the deprecated","// `--shout` boolean alias to the canonical `--upper` flag.","export const pingParser = defineParserOverride((context) => {","  const options = { ...context.options };","  if (options.shout === true) {","    options.upper = true;","  }","  delete options.shout;","  return { options };","});"),r.push(`  parsers: { ${JSON.stringify(t)}: pingParser },`);break;case"preflight":a.push("definePreflightOverride"),i.push("","// Preflight overrides adjust pm's pre-run gate decision (extension migrations +","// item-format checks) for the commands it owns. Scoped ownership composes with","// other packages; overlapping or legacy global ownership is diagnosed.","// Return a delta of the keys you want to change (enforce_item_format_gate,","// run_preflight_item_format_sync, run_extension_migrations,","// enforce_mandatory_migration_gate); returning context.decision unchanged is a","// safe no-op - replace it with your policy, e.g. { run_extension_migrations: false }.","export const preflightOverride = definePreflightOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => context.decision,","});"),r.push("  preflights: [preflightOverride],");break;case"services":a.push("defineServiceOverride"),i.push("","// Service overrides replace a built-in pm service. The `output_format` service","// renders a command's structured result; returning the payload unchanged passes","// through to pm's default formatting. This override scopes itself to THIS","// package's own command and passes every other command through.","export const outputService = defineServiceOverride((context) => {",`  if (context.command !== ${JSON.stringify(t)}) {`,"    return { handled: false };","  }",`  return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),r.push("  services: { output_format: outputService },");break}return{builderImports:a,definitions:i,blueprintFields:r}}function nl(e,t,n){let a=tl(e,t,n);return[`import { ${["composeExtension","defineCommand","defineExtensionBlueprint",...a.builderImports].sort((i,r)=>i.localeCompare(r)).join(", ")} } from "@unbrained/pm-cli/sdk";`,"",...a.definitions,"","// Declarative authoring: describe WHAT the package registers as a blueprint and","// let `composeExtension` generate the `activate` that wires every surface in order,","// instead of hand-writing each `api.register*` call. `defineExtensionBlueprint`","// contract-checks the blueprint where it is authored. Keep `manifest.json`'s","// `capabilities` equal to the set this blueprint derives.","export const blueprint = defineExtensionBlueprint({",...a.blueprintFields,"  // `deactivate` is the teardown counterpart to the generated `activate`: pm runs","  // it on host shutdown/reload to release anything the package opened (timers,","  // connections, caches). This starter holds none, so it stays a no-op.","  deactivate: () => {},","});","","// `composeExtension(blueprint)` is the package's default export \u2014 the runtime","// `ExtensionModule` pm loads. Guard the blueprint with `assertExtensionPreflight`","// in index.test.ts before publishing.","export default composeExtension(blueprint);",""].join(`
+`)}function jn(e,t,n,a){if(n==="commands")return[];let i=`${e}-search`,r=`${e}-vector`,o=`${e.replace(/-/g," ")} items`,s=e,d=`${e}s`,c=`${e.replace(/-/g,"_")}_note`,l=`${e}-0001-init`,p=["  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${a},`,"  });"],m=y=>[...p,"  let deactivated = false;","  try {",...y.map(g=>g===""?g:`  ${g}`),"    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le];switch(n){case"hooks":return[`test(${JSON.stringify(`${e} reacts to commands via its after_command hook`)}, async () => {`,...m(["  // assertHook throws unless an after_command hook is registered, so reaching the","  // next line already proves the hook is wired.",`  ext.assertHook({ kind: "after_command", extensionName: ${JSON.stringify(e)} });`,"  // runHook fires the hook through pm's real runner with a synthetic context and","  // returns the warnings it produced; a clean hook returns none.","  const warnings = await ext.runHook({",'    kind: "after_command",',"    context: {",`      command: ${JSON.stringify(t)},`,"      args: [],",'      pm_root: "",',"      ok: true,","      affected: [],","    },","  });","  assert.deepEqual(warnings, []);"]),"});",""];case"search":return[`test(${JSON.stringify(`${e} registers and invokes search primitives`)}, async () => {`,...m([`  ext.assertSearchProvider({ name: ${JSON.stringify(i)}, extensionName: ${JSON.stringify(e)} });`,`  ext.assertVectorStoreAdapter({ name: ${JSON.stringify(r)}, extensionName: ${JSON.stringify(e)} });`,"","  // The starter provider reads only document title/id, so `settings` is a minimal","  // typed stub and `documents` carry just the fields it inspects.","  const settings = {","    testing: {","      record_results_to_items: false,","      allow_untrusted_linked_tests: false,","    },","  } as PmSettings;","  const query = await ext.runSearchProvider({",`    provider: ${JSON.stringify(i)},`,'    operation: "query",',"    context: {",'      query: "sync",','      mode: "semantic",','      tokens: ["sync"],',"      options: {},","      settings,","      documents: [",'        { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },','        { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',"      ] as ItemDocument[],","    },","  });",'  assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',"","  const embedding = await ext.runSearchProvider({",`    provider: ${JSON.stringify(i)},`,'    operation: "embed",','    context: { input: "abc", settings, model: "starter-model" },',"  });","  assert.deepEqual(embedding, [3]);","","  const vectorHits = await ext.runVectorStoreAdapter({",`    adapter: ${JSON.stringify(r)},`,'    operation: "query",',"    context: { vector: [0.1, 0.2], limit: 2, settings },","  });",'  assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);']),"});",""];case"importers":return[`test(${JSON.stringify(`${e} registers and invokes import/export primitives`)}, async () => {`,...m([`  ext.assertImporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,`  ext.assertExporter({ name: ${JSON.stringify(o)}, extensionName: ${JSON.stringify(e)} });`,"","  const imported = await ext.runImporter({",`    importer: ${JSON.stringify(o)},`,'    options: { source: "tickets" },','    args: ["batch-1"],',"  });","  assert.equal(imported.handled, true);",'  assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',"","  const exported = await ext.runExporter({",`    exporter: ${JSON.stringify(o)},`,'    options: { destination: "archive" },','    args: ["done"],',"  });","  assert.equal(exported.handled, true);",'  assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });']),"});",""];case"schema":return[`test(${JSON.stringify(`${e} registers and runs its custom schema`)}, async () => {`,...m(pr({extensionName:e,itemTypeName:s,itemTypeFolder:d,fieldName:c,migrationId:l})),"});",""];case"profile":return[`test(${JSON.stringify(`${e} registers its project profile`)}, async () => {`,...m(mr(e)),"});",""];case"renderers":return[`test(${JSON.stringify(`${e} registers and invokes its renderer override`)}, async () => {`,...m(["  // assertRendererOverride throws unless a renderer is registered for the format,","  // so reaching the next line already proves the wiring.",`  const override = ext.assertRendererOverride({ name: "toon", extensionName: ${JSON.stringify(e)} });`,'  assert.equal(override.format, "toon");',"","  // runRendererOverride renders through pm's real runner. The override customizes","  // only THIS package's command output and returns a string the host uses verbatim.","  const rendered = await ext.runRendererOverride({",'    format: "toon",',`    command: ${JSON.stringify(t)},`,"    result: { ok: true },","  });","  assert.equal(rendered.overridden, true);","  assert.equal(rendered.rendered, JSON.stringify({ ok: true }));","","  // Output for any other command passes through to pm's default renderer.","  const passthrough = await ext.runRendererOverride({",'    format: "toon",','    command: "list",',"    result: { ok: true },","  });","  assert.equal(passthrough.overridden, false);"]),"});",""];case"parser":return[`test(${JSON.stringify(`${e} rewrites command options via its parser override`)}, async () => {`,...m(["  // assertParserOverride throws unless a parser is registered for the command, so","  // reaching the next line already proves the wiring.",`  ext.assertParserOverride({ name: ${JSON.stringify(t)}, extensionName: ${JSON.stringify(e)} });`,"","  // runParserOverride runs the override through pm's real parser runner and returns","  // the rewritten context. The starter rewrites the deprecated `shout` alias to the","  // canonical `upper` flag.","  const result = await ext.runParserOverride({",`    command: ${JSON.stringify(t)},`,"    args: [],","    options: { shout: true },","    global: {},",'    pm_root: "",',"  });","  assert.equal(result.overridden, true);","  assert.deepEqual(result.context.options, { upper: true });","","  // End to end: feed the rewritten options into the command handler to prove","  // `pm <command> --shout` surfaces the normalized `upper` flag in the result.",`  const invocation = await ext.runCommand({ command: ${JSON.stringify(t)}, options: result.context.options });`,"  assert.equal(invocation.handled, true);","  assert.deepEqual(invocation.result, {","    ok: true,",`    source: ${JSON.stringify(e)},`,`    command: ${JSON.stringify(t)},`,"    upper: true,",'    message: "Starter extension scaffold is active.",',"  });"]),"});",""];case"preflight":return[`test(${JSON.stringify(`${e} returns a preflight gate decision via its override`)}, async () => {`,...m(["  // assertPreflightOverride throws unless a preflight override is registered, so","  // reaching the next line already proves the wiring.",`  ext.assertPreflightOverride({ extensionName: ${JSON.stringify(e)} });`,"","  // runPreflightOverride runs the override through pm's real runner with a synthetic","  // gate decision. The starter echoes the decision unchanged; replace the","  // values/assertions with your real policy.","  const decision = {","    enforce_item_format_gate: true,","    run_preflight_item_format_sync: false,","    run_extension_migrations: true,","    enforce_mandatory_migration_gate: false,","  };","  const result = await ext.runPreflightOverride({",`    command: ${JSON.stringify(t)},`,"    args: [],","    options: {},","    global: {},",'    pm_root: "",',"    decision,","  });","  assert.equal(result.overridden, true);","  assert.deepEqual(result.decision, decision);"]),"});",""];case"services":return[`test(${JSON.stringify(`${e} customizes command output via its service override`)}, async () => {`,...m(["  // assertServiceOverride throws unless a service override is registered for the","  // service, so reaching the next line proves the wiring.",`  ext.assertServiceOverride({ name: "output_format", extensionName: ${JSON.stringify(e)} });`,"","  // runServiceOverride runs the override through pm's real service runner. The","  // override customizes only THIS package's command output (handled), passing every","  // other command through (not handled).","  const handled = await ext.runServiceOverride({",'    service: "output_format",',`    command: ${JSON.stringify(t)},`,"    payload: { ok: true },","  });","  assert.equal(handled.handled, true);",`  assert.deepEqual(handled.result, { rendered_by: ${JSON.stringify(e)}, payload: { ok: true } });`,"","  // Output for any other command passes through to pm's default formatter.","  const passthrough = await ext.runServiceOverride({",'    service: "output_format",','    command: "list",',"    payload: { ok: true },","  });","  assert.equal(passthrough.handled, false);"]),"});",""]}}function al(e,t,n){let a=n==="parser",i=JSON.stringify([...ur[n]].sort());return['import assert from "node:assert/strict";','import { test } from "node:test";','import { assertExtensionDeactivated, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, createExtensionTestHarness } from "@unbrained/pm-cli/sdk/testing";',...n==="search"?['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";']:[],'import extension, { blueprint } from "./index.ts";','import manifest from "./manifest.json" with { type: "json" };',"",...lr,`test(${JSON.stringify(`${e} passes author-time preflight`)}, () => {`,"  // assertExtensionPreflight is the author-time capstone: it lints the blueprint,","  // synthesizes the least-privilege manifest from `identity`, and checks the version","  // bounds against `target` in one call, throwing on any blocking finding. It returns","  // the full report so you can inspect the derived data.","  const report = assertExtensionPreflight(blueprint, {","    identity: {",`      name: ${JSON.stringify(e)},`,'      version: "0.1.0",','      entry: "./index.ts",',"      priority: 0,",`      pm_min_version: ${JSON.stringify(Fe)},`,"    },",`    target: { pmVersion: ${JSON.stringify(Fe)} },`,"  });","  // Fail the starter suite whenever the checked-in manifest drifts from the","  // capabilities derived from the blueprint.","  assertExtensionManifestMatchesBlueprint(manifest, blueprint);","  // The capability set is DERIVED from the blueprint, never hand-synced. Keep","  // manifest.json's `capabilities` equal to this list (set match, sorted).",`  assert.deepEqual(report.capabilities, ${i});`,`  assert.deepEqual(report.manifest?.capabilities, ${i});`,"});","",`test(${JSON.stringify(`${e} registers and runs its starter command`)}, async () => {`,"  // createExtensionTestHarness activates the composed module once and binds the","  // assert*/run*/deactivate helpers to the right activation sub-registry, so you","  // never thread activation.registrations vs activation.commands by hand.","  // `capabilities` mirrors manifest.json so the in-memory activation grants what the","  // blueprint needs.","  const ext = await createExtensionTestHarness(extension, {",`    name: ${JSON.stringify(e)},`,`    capabilities: ${i},`,"  });","  let deactivated = false;","  try {","    // assertCommandContract throws unless the command is registered, so reaching","    // the next line already proves the wiring; assert on the returned definition","    // to demonstrate inspecting registered metadata.",`    const registered = ext.assertCommandContract({ name: ${JSON.stringify(t)} });`,'    assert.equal(typeof registered.command.description, "string");',"","    // runCommand invokes the handler through pm's real dispatch engine, so this","    // asserts behavior - not just that the command is wired. Replace these","    // assertions as you flesh out your command.",`    const invocation = await ext.runCommand({ command: ${JSON.stringify(t)} });`,"    assert.equal(invocation.handled, true);","    assert.deepEqual(invocation.result, {","      ok: true,",`      source: ${JSON.stringify(e)},`,`      command: ${JSON.stringify(t)},`,...a?["      upper: false,"]:[],'      message: "Starter extension scaffold is active.",',"    });","    // deactivate runs pm's real teardown engine over the module; exactly one","    // extension tears down with no failures.","    const teardown = await ext.deactivate();","    assertExtensionDeactivated(teardown);","    deactivated = true;",...le,"});","",...jn(e,t,n,i)].join(`
+`)}function il(e,t,n){let a=hr(n,"package"),i=gr(n,"package");return[`# ${e}`,"","Generated by `pm package init --declarative`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",a,`- \`index.ts\`: the TypeScript manifest entry \u2014 a \`defineExtensionBlueprint\` blueprint (${Zd[n]}) composed into the runtime module by \`composeExtension\`, plus a \`deactivate\` teardown stub.`,"- `index.test.ts`: sample `node:test` suite covering author-time preflight (`assertExtensionPreflight`) and runtime surface invocation/teardown via `createExtensionTestHarness`.",fr,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Declarative Authoring","`index.ts` uses the SDK's declarative authoring loop instead of an imperative","`activate` body. You describe WHAT the package registers as an","`ExtensionBlueprint` and `composeExtension` generates the `activate` that wires","every surface in order:","- The `define*` builders author each surface with literal-type preservation and","  contextual handler inference (`defineCommand`, `defineSearchProvider`,","  `defineItemType`, `defineParserOverride`, ...).","- `defineExtensionBlueprint({ ... })` collects the definitions into the blueprint;",`  this starter populates ${Qd[n]}. Add more`,"  fields as the package grows.","- `composeExtension(blueprint)` is the default export \u2014 the runtime module pm","  loads. Its generated `activate` requires exactly the capabilities the blueprint","  derives, so `manifest.json`'s `capabilities` never drift.","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`index.test.ts` exercises both authoring capstones: `assertExtensionPreflight`","(the author-time lint + manifest synthesis + version-compatibility check over the","exported `blueprint`) and `createExtensionTestHarness` (the runtime fixture whose","`assert*`/`run*`/`deactivate` methods bind to the right activation sub-registry).","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.",...i,"","## Compatibility Bounds","`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Dn}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${Fe}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
+`)}function rl(e){let t=e,n=e.replace(/-/g,"");return{searchProviderName:`${e}-search`,vectorAdapterName:`${e}-vector`,adapterName:`${e.replace(/-/g," ")} items`,itemTypeName:t,itemTypeFolder:`${e}s`,itemTypeAliases:n===t?[]:[n],fieldName:`${e.replace(/-/g,"_")}_note`,migrationId:`${e}-0001-init`}}function ol(e){return["defineCommand",...e==="hooks"?["defineAfterCommandHook"]:[],...e==="search"?["defineSearchProvider","defineVectorStoreAdapter"]:[],...e==="importers"?["defineImporter","defineExporter"]:[],...e==="schema"?["defineItemType","defineItemField","defineMigration"]:[],...e==="profile"?["defineProjectProfile"]:[],...e==="renderers"?["defineRendererOverride"]:[],...e==="parser"?["defineParserOverride"]:[],...e==="preflight"?["definePreflightOverride"]:[],...e==="services"?["defineServiceOverride"]:[]].join(", ")}function sl(e,t,n,a){let i=["export const pingCommand = defineCommand({",`  name: ${JSON.stringify(t)},`,'  description: "Starter scaffold command. Replace with your own behavior.",',...n==="parser"?["  flags: [",'    { long: "--shout", value_type: "boolean", description: "Deprecated alias for --upper." },','    { long: "--upper", value_type: "boolean", description: "Canonical flag the parser produces." },',"  ],","  run: (context) => ({ ok: true, command: context.command, upper: context.options.upper === true }),"]:["  run: (context) => ({ ok: true, command: context.command }),"],"});"];return n==="hooks"&&i.push("","export const afterCommandHook = defineAfterCommandHook((context) => {","  if (!context.ok) return;","  // React to context.affected here as your package grows.","});"),n==="search"&&i.push("","export const searchProvider = defineSearchProvider({",`  name: ${JSON.stringify(a.searchProviderName)},`,"  query: async (context) => ({","    hits: context.documents",'      .filter((document) => String(document.metadata.title ?? "").toLowerCase().includes(context.query.toLowerCase()))','      .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: ["title"] })),',"  }),","  embed: async (context) => [context.input.length],","});","","export const vectorStoreAdapter = defineVectorStoreAdapter({",`  name: ${JSON.stringify(a.vectorAdapterName)},`,'  query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],',"  upsert: async (context) => ({ upserted: context.points.length }),","  delete: async (context) => ({ deleted: context.ids.length }),","});"),n==="importers"&&i.push("","export const importer = defineImporter(async (context) => ({","  imported: 1,",'  source: context.options.source ?? "starter",',"  args: context.args,","}));","","export const exporter = defineExporter(async (context) => ({","  exported: true,",'  destination: context.options.destination ?? "stdout",',"  args: context.args,","}));"),n==="schema"&&i.push("",`export const noteField = defineItemField({ name: ${JSON.stringify(a.fieldName)}, type: "string", optional: true });`,"","export const itemType = defineItemType({",`  name: ${JSON.stringify(a.itemTypeName)},`,`  folder: ${JSON.stringify(a.itemTypeFolder)},`,`  aliases: ${JSON.stringify(a.itemTypeAliases)},`,"  required_create_fields: [],","});","","export const initMigration = defineMigration({",`  id: ${JSON.stringify(a.migrationId)},`,`  description: ${JSON.stringify(`Initialize ${e} schema state.`)},`,"  mandatory: false,","  run: async (context) => ({ migrated: true, id: context.id }),","});"),n==="profile"&&i.push("","export const starterProfile = defineProjectProfile({",`  name: ${JSON.stringify(e)},`,`  title: ${JSON.stringify(`${e} archetype`)},`,'  summary: "Starter project profile. Replace these dimensions with your own archetype.",',"  types: [",`    { name: ${JSON.stringify(a.itemTypeName)}, folder: ${JSON.stringify(a.itemTypeFolder)} },`,"  ],","  // ...plus statuses, fields, workflows, config, templates, and packages.","});"),n==="renderers"&&i.push("","export const toonRenderer = defineRendererOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => JSON.stringify(context.result),","});"),n==="parser"&&i.push("","export const pingParser = defineParserOverride((context) => {","  const options = { ...context.options };","  if (options.shout === true) options.upper = true;","  delete options.shout;","  return { options };","});"),n==="preflight"&&i.push("","// Return a delta of the gate-decision keys you want to change; returning","// context.decision unchanged is a safe no-op (e.g. { run_extension_migrations: false }).","export const preflightOverride = definePreflightOverride({",`  commands: [${JSON.stringify(t)}],`,"  run: (context) => context.decision,","});"),n==="services"&&i.push("","export const outputService = defineServiceOverride((context) => {",`  if (context.command !== ${JSON.stringify(t)}) return { handled: false };`,`  return { rendered_by: ${JSON.stringify(e)}, payload: context.payload };`,"});"),i}function cl(e,t,n){let a=[];return t==="renderers"&&a.push('  api.registerRenderer("toon", toonRenderer.run, toonRenderer);'),t==="parser"&&a.push(`  api.registerParser(${JSON.stringify(e)}, pingParser);`),t==="preflight"&&a.push("  api.registerPreflight(preflightOverride);"),t==="services"&&a.push('  api.registerService("output_format", outputService);'),t==="hooks"&&a.push("  api.hooks.afterCommand(afterCommandHook);"),t==="search"&&a.push("  api.registerSearchProvider(searchProvider);","  api.registerVectorStoreAdapter(vectorStoreAdapter);"),t==="schema"&&a.push("  api.registerItemFields([noteField]);","  api.registerItemTypes([itemType]);","  api.registerMigration(initMigration);"),t==="profile"&&a.push("  api.registerProfile(starterProfile);"),t==="importers"&&a.push(`  api.registerImporter(${JSON.stringify(n.adapterName)}, importer, {`,`    action: ${JSON.stringify(`${n.adapterName} import`)},`,'    description: "Import starter records into pm context.",',"    flags: [","      {",'        long: "--source",','        value_name: "name",','        value_type: "string",','        description: "Source name or path to import from.",',"      },","    ],","  });",`  api.registerExporter(${JSON.stringify(n.adapterName)}, exporter, {`,`    action: ${JSON.stringify(`${n.adapterName} export`)},`,'    description: "Export pm context into starter records.",',"    flags: [","      {",'        long: "--destination",','        value_name: "name",','        value_type: "string",','        description: "Destination name or path to export to.",',"      },","    ],","  });"),a}function dl(e,t,n,a="commands",i=!1){let r=`pm-${e}`,o=ur[a],s=Xd(e,t,a),d=`${JSON.stringify({name:e,version:"0.1.0",entry:"./index.ts",manifest_version:Dn,pm_min_version:Fe,trusted:!0,sandbox_profile:"strict",permissions:{...Ld},capabilities:o,...s.length>0?{activation:{commands:s}}:{}},null,2)}
+`,c=['import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"","export function activate(api: ExtensionApi): void {",...Vd(e,t,a),"}","","// `deactivate` is the teardown counterpart to `activate`: pm runs it on host","// shutdown/reload (e.g. the MCP server between requests) to release anything","// `activate` opened - timers, connections, caches. This starter holds no such","// resources, so it stays a documented no-op; add cleanup here as you grow.","export function deactivate(): void {}","","export default {","  activate,","  deactivate,","};",""].join(`
+`),l=`${JSON.stringify(Ud,null,2)}
+`,p=Gd[a],m=hr(a,"package"),y=`${JSON.stringify({name:r,version:"0.1.0",private:!0,type:"module",keywords:["pm-package"],engines:{node:jd},scripts:{typecheck:"tsc --noEmit","test:runtime":"node --test",test:"npm run typecheck && npm run test:runtime"},peerDependencies:{"@unbrained/pm-cli":`>=${Fe}`},devDependencies:{"@types/node":Md,typescript:Fd},pm:{aliases:[e],extensions:["."],docs:["README.md"],examples:["README.md"],catalog:{display_name:e,category:"workflow",summary:"Starter pm package scaffold.",tags:["starter"]}}},null,2)}
+`,g=Yd(e,t,a),_=Jd[a],u=["node_modules/","*.log","*.tsbuildinfo",""].join(`
+`),w=rl(e),v=["```ts",`import { ${ol(a)} } from "@unbrained/pm-cli/sdk";`,'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',"",...sl(e,t,a,w),"","export function activate(api: ExtensionApi): void {","  api.registerCommand(pingCommand);",...cl(t,a,w),"}","","export function deactivate(): void {}","","export default { activate, deactivate };","```"],E=[`# ${r}`,"","Generated by `pm package init` or `pm extension init`.","","## Included Files","- `package.json`: package metadata, `typecheck`/`test` scripts, and `pm` resource manifest.",m,p,_,fr,"- `.gitignore`: ignores `node_modules/`, logs, and the TypeScript build cache.","","## Quick Start","This package is authored AND loaded as TypeScript: the manifest `entry` is","`./index.ts` and pm imports it directly via Node's native type stripping","(Node >=22.18), so there is no build step \u2014 install and run:","```bash","npm install","pm install --project <package-path>",`pm ${t}`,"pm package doctor --project --detail summary","```","","## Validate the Package","`npm install` pulls the peer SDK and TypeScript. `npm test` is the default","validation gate: it type-checks the package, then runs the colocated sample:","```bash","npm install","npm test","```","`npm run typecheck` is available when you only want the SDK contract check.","`npm run test:runtime` runs just `node --test`, which strips types on load and","executes `index.test.ts` directly against the `@unbrained/pm-cli/sdk/testing`","helpers - no compile step and no extra test runner required.","","## Authoring With define* Builders","`index.ts` is authored fully in TypeScript so every registration is checked","against the SDK contracts at author time. Use the public SDK authoring","builders for exported definitions you want literal-type preservation,","contextual handler inference, and direct unit tests for:",...v,"The builders return their argument unchanged; runtime validation still lives","in `api.register*`, and behavior validation lives in `sdk/testing`.",...qd[a],...gr(a,"package"),"","## Compatibility Bounds",`- \`peerDependencies["@unbrained/pm-cli"]\` uses the stable range \`>=${Fe}\`. Keep a normal stable range instead of pinning a date ordinal: SemVer excludes prerelease ordinals such as \`2026.7.24-3\`, while daily stable releases continue to satisfy the range.`,"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",`- \`manifest_version\` (integer): manifest schema generation. Leave at \`${Dn}\` unless you adopt a newer manifest schema.`,`- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${Fe}\`. The loader blocks the package on older CLIs.`,"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.","","## Policy Metadata",'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',"","## Notes","- Author in `index.ts`; pm loads it directly (no build), so edits take effect on the next install/reload \u2014 there is no `.js` to regenerate.","- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them with their real `.ts` extension; `tsconfig.json` type-checks every `*.ts` in the package (recursively).","- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.","- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",""].join(`
+`);return{"package.json":y,"manifest.json":d,"index.ts":i?nl(e,t,a):c,"index.test.ts":i?al(e,t,a):g,"tsconfig.json":l,".gitignore":u,"README.md":i?il(r,t,a):E}}async function _r(e,t="extension",n="commands",a=!1){let i=n.trim().toLowerCase();if(!dr.includes(i))throw new f(`Unknown scaffold capability "${n}". Supported capabilities: ${dr.join(", ")}.`,h.USAGE);let r=i;if(a&&t!=="package")throw new f("--declarative scaffolds a package-mode blueprint starter (composeExtension is a runtime SDK import). Use `pm package init`, not `pm extension init`.",h.USAGE);let o=a?"declarative":"imperative",s=e.trim(),d=mt.resolve(process.cwd(),s),c=Lt(mt.basename(d)).replace(/^(?:pm-)+/u,""),l=Kd(c),p=dl(c,l,t,r,a),m=!1;if(await k(d)){if(!(await pt.stat(d)).isDirectory())throw new f(`Scaffold target "${d}" exists and is not a directory.`,h.CONFLICT)}else await pt.mkdir(d,{recursive:!0}),m=!0;for(let[g,_]of Object.entries(p)){let u=mt.join(d,g);if(await k(u)&&await pt.readFile(u,"utf8")!==_)throw new f(`Scaffold file "${g}" already exists with different content in "${d}". Choose a new target path or remove conflicting files.`,h.CONFLICT)}let y=[];for(let[g,_]of Object.entries(p)){let u=mt.join(d,g);if(await k(u)){y.push({path:g,status:"unchanged"});continue}await pt.mkdir(mt.dirname(u),{recursive:!0}),await pt.writeFile(u,_,"utf8"),y.push({path:g,status:"created"})}return{extension_name:c,package_name:`pm-${c}`,command_name:l,invocation_command:`pm ${l}`,capability:r,style:o,target_path:d,created_directory:m,files:y}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="3984f1ef-1703-5a83-a4fa-ec1cdc738572")}catch{}})();var wr=[["commands","Commands"],["command_overrides","Command overrides"],["flag_commands","Flag commands"],["item_types","Item types"],["item_fields","Item fields"],["migrations","Migrations"],["profiles","Profiles"],["importers","Importers"],["exporters","Exporters"],["search_providers","Search providers"],["vector_store_adapters","Vector store adapters"],["assurance_providers","Assurance measurement providers"],["hooks","Lifecycle hooks"],["parser_overrides","Parser overrides"],["service_overrides","Service overrides"],["renderer_overrides","Renderer overrides"]];function Ln(e){return"#".repeat(e)}function vr(e){if(!e.includes("`"))return`\`${e}\``;let t=0,n=0;for(let r of e)n=r==="`"?n+1:0,t=Math.max(t,n);let a="`".repeat(t+1),i=e.startsWith("`")||e.endsWith("`")?" ":"";return`${a}${i}${e}${i}${a}`}function ll(e){return e.length===0?"Capabilities: _none registered_":`Capabilities: ${e.map(vr).join(", ")}`}function pl(e,t,n){let a=[`${Ln(t)} ${e}`,""];return n.length===0?(a.push("_None._",""),a):(a.push(...n.map(i=>`- ${vr(i)}`),""),a)}function ml(e,t,n){return e===0&&!n?[]:[`${Ln(t)} Preflight overrides`,"",e>0?`- ${e} registered (this surface carries no per-entry identifier)`:"_None._",""]}function Fn(e,t={}){let n=t.headingLevel??2;if(!Number.isInteger(n)||n<1||n>6)throw new RangeError(`headingLevel must be an integer in [1, 6], received ${String(t.headingLevel)}`);let a=Math.min(n+1,6),i=t.includeEmpty===!0,r=t.title??"Extension surfaces",o=[`${Ln(n)} ${r}`,""];(i||e.capabilities.length>0)&&o.push(ll(e.capabilities),"");for(let[s,d]of wr){let c=e[s]??[];c.length===0&&!i||o.push(...pl(d,a,c))}return o.push(...ml(e.preflight_overrides,a,i)),!(e.preflight_overrides>0||wr.some(([s])=>(e[s]?.length??0)>0))&&!i&&o.push("_This extension registers no surfaces._",""),`${o.join(`
 `).trimEnd()}
-`}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="6d50733c-ced5-5ec8-b82e-2391a974ad0f")}catch{}})();function wr(e,t){return`${e}:${b(t)}`}function ll(e,t){let n=[];for(let[a,i]of[["handler",e.commands.handlers],["override",e.commands.overrides]]){let r=new Map;for(let o of i){let s=r.get(o.command)??[];r.set(o.command,[...s,o])}for(let[o,s]of r){if(t!==null&&!s.some(c=>t.has(b(c.name))))continue;let d=s.at(-1);n.push({command:o,surface:a,policy:"last_activated_wins",collision:s.length>1,claimants:s.map(c=>({name:c.name,layer:c.layer,winner:c===d}))})}}return n.sort((a,i)=>a.command.localeCompare(i.command)||a.surface.localeCompare(i.surface))}function vr(e,t,n){let a=new Set(n.failed.map(c=>wr(c.layer,c.name))),i=[...t.loaded.map(c=>({name:c.name,layer:c.layer,version:c.version,activation_status:a.has(wr(c.layer,c.name))?"failed":"ok",surfaces:Ge(n,{extensionName:c.name})})),...t.failed.map(c=>({name:c.name,layer:c.layer,version:"unknown",activation_status:"not_loaded",surfaces:Ge(n,{extensionName:c.name})}))].sort((c,l)=>c.name.localeCompare(l.name)||c.layer.localeCompare(l.layer)),r=typeof e=="string"?b(e):null,o=r===null?null:new Set(t.loaded.filter(c=>b(c.name)===r||typeof c.source_package=="string"&&b(c.source_package)===r||(c.source_aliases??[]).some(l=>b(l)===r)).map(c=>b(c.name)).concat(r)),s=o===null?i:i.filter(c=>o.has(b(c.name))),d=o===null?{}:{extensionNames:[...o]};return{target:typeof e=="string"?e.trim():null,total:s.length,extensions:s,union:Ge(n,d),command_ownership:ll(n,o)}}var pl={ok:"loaded",failed:"activation failed",not_loaded:"not loaded"};function Wh(e,t){let n=[`# ${`${t[0].toUpperCase()}${t.slice(1)}`} surface reference`,""];if(n.push(e.target===null?`Scope: all loaded ${t}s`:`Scope: \`${e.target}\``),n.push(`Described: ${e.total} ${t}${e.total===1?"":"s"}`,""),(e.command_ownership?.length??0)>0){n.push("## Command ownership","");for(let a of e.command_ownership){let i=a.claimants.find(o=>o.winner),r=a.claimants.map(o=>`${o.layer}:${o.name}`).join(", ");n.push(`- \`${a.command}\` (${a.surface}): ${i.layer}:${i.name}; policy=${a.policy}; collision=${String(a.collision)}; claimants=${r}`)}n.push("")}if(e.extensions.length===0)return n.push(`_No ${t}s are loaded._`,""),`${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]="6d50733c-ced5-5ec8-b82e-2391a974ad0f")}catch{}})();function br(e,t){return`${e}:${b(t)}`}function ul(e,t){let n=[];for(let[a,i]of[["handler",e.commands.handlers],["override",e.commands.overrides]]){let r=new Map;for(let o of i){let s=r.get(o.command)??[];r.set(o.command,[...s,o])}for(let[o,s]of r){if(t!==null&&!s.some(c=>t.has(b(c.name))))continue;let d=s.at(-1);n.push({command:o,surface:a,policy:"last_activated_wins",collision:s.length>1,claimants:s.map(c=>({name:c.name,layer:c.layer,winner:c===d}))})}}return n.sort((a,i)=>a.command.localeCompare(i.command)||a.surface.localeCompare(i.surface))}function kr(e,t,n){let a=new Set(n.failed.map(c=>br(c.layer,c.name))),i=[...t.loaded.map(c=>({name:c.name,layer:c.layer,version:c.version,activation_status:a.has(br(c.layer,c.name))?"failed":"ok",surfaces:Ge(n,{extensionName:c.name})})),...t.failed.map(c=>({name:c.name,layer:c.layer,version:"unknown",activation_status:"not_loaded",surfaces:Ge(n,{extensionName:c.name})}))].sort((c,l)=>c.name.localeCompare(l.name)||c.layer.localeCompare(l.layer)),r=typeof e=="string"?b(e):null,o=r===null?null:new Set(t.loaded.filter(c=>b(c.name)===r||typeof c.source_package=="string"&&b(c.source_package)===r||(c.source_aliases??[]).some(l=>b(l)===r)).map(c=>b(c.name)).concat(r)),s=o===null?i:i.filter(c=>o.has(b(c.name))),d=o===null?{}:{extensionNames:[...o]};return{target:typeof e=="string"?e.trim():null,total:s.length,extensions:s,union:Ge(n,d),command_ownership:ul(n,o)}}var fl={ok:"loaded",failed:"activation failed",not_loaded:"not loaded"};function Kh(e,t){let n=[`# ${`${t[0].toUpperCase()}${t.slice(1)}`} surface reference`,""];if(n.push(e.target===null?`Scope: all loaded ${t}s`:`Scope: \`${e.target}\``),n.push(`Described: ${e.total} ${t}${e.total===1?"":"s"}`,""),(e.command_ownership?.length??0)>0){n.push("## Command ownership","");for(let a of e.command_ownership){let i=a.claimants.find(o=>o.winner),r=a.claimants.map(o=>`${o.layer}:${o.name}`).join(", ");n.push(`- \`${a.command}\` (${a.surface}): ${i.layer}:${i.name}; policy=${a.policy}; collision=${String(a.collision)}; claimants=${r}`)}n.push("")}if(e.extensions.length===0)return n.push(`_No ${t}s are loaded._`,""),`${n.join(`
 `).trimEnd()}
-`;for(let a of e.extensions){let i=`${a.name} (${a.layer} v${a.version}, ${pl[a.activation_status]})`;n.push(Ln(a.surfaces,{title:i,headingLevel:2}))}return e.extensions.length>1&&n.push(Ln(e.union,{title:`Union across all described ${t}s`,headingLevel:2})),`${n.join(`
+`;for(let a of e.extensions){let i=`${a.name} (${a.layer} v${a.version}, ${fl[a.activation_status]})`;n.push(Fn(a.surfaces,{title:i,headingLevel:2}))}return e.extensions.length>1&&n.push(Fn(e.union,{title:`Union across all described ${t}s`,headingLevel:2})),`${n.join(`
 `).trimEnd()}
-`}import qt from"node:fs/promises";import Jt from"node:path";import br 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]="147fb29e-ad06-5850-b0b1-f643e32e9b1f")}catch{}})();function pt(e,t,n,a){let i=br.relative(e,n);if(i!==""&&!B(e,n)||n===t||B(t,n))return!1;let r=i.split(br.sep);return r.includes(".git")?!1:a?!r.some(o=>o===".agents"||o==="node_modules"||o.startsWith(".pm-extension-install-backup-")):!0}import{randomUUID as ml}from"node:crypto";import L from"node:fs/promises";import ul from"node:os";import N from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="cefb224d-a18f-599a-9cf9-3d3a22616440")}catch{}})();var kr=3,fl=120,xr=250,hl=12e4,gl=new Set(["EEXIST","ENOTEMPTY","ENOENT"]),Sr=e=>typeof e=="object"&&e!==null&&"code"in e?e.code:void 0,Er=e=>gl.has(String(Sr(e))),Gt=(e,t)=>Sr(e)===t,$r=e=>new Promise(t=>{setTimeout(t,e)}),Ir=async e=>{let t=N.join(e,"package.json");await k(t)||await L.writeFile(t,`${JSON.stringify({type:"module"},null,2)}
-`,"utf8")},Ar=async e=>{let t=ye(import.meta.url,["../../.."]),n=N.join(e,"node_modules","@unbrained"),a=N.join(n,"pm-cli");await L.mkdir(n,{recursive:!0}),await L.rm(a,{recursive:!0,force:!0}),await L.symlink(t,a,process.platform==="win32"?"junction":"dir")},mt=async e=>{let t=N.resolve(e),n=N.dirname(t),a=N.parse(n).root,i=await L.realpath(a).catch(()=>a),r=N.relative(a,n),o=r===""?[]:r.split(N.sep);for(let[s,d]of o.entries()){let c=N.join(i,d);try{i=await L.realpath(c)}catch{i=N.join(i,...o.slice(s));break}}return N.join(i,N.basename(t))},Tr=async(e,t,n,a=ul.tmpdir())=>Te("extension_install_copy",async()=>{let i=N.resolve(e),r=await L.realpath(i).catch(()=>i),o=await mt(t);if(r===o)return;if(!B(r,o)){await n(r,t,{recursive:!0,force:!0,filter:p=>pt(r,o,N.resolve(p),!1)});return}let s=await L.realpath(N.resolve(a)).catch(()=>mt(a)),d=B(r,s)?N.dirname(r):s;if(B(r,d))throw new f(`Extension source "${e}" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,h.USAGE,{code:"extension_install_source_contains_destination"});let c=await L.mkdtemp(N.join(d,"pm-extension-copy-")),l=N.join(c,"extension");try{await n(r,l,{recursive:!0,force:!0,filter:p=>pt(r,o,N.resolve(p),!0)}),await n(l,t,{recursive:!0,force:!0})}finally{await L.rm(c,{recursive:!0,force:!0})}}),Or=async(e,t,n=L.cp)=>{for(let a=1;a<=kr;a+=1)try{await Te("extension_install_copy",async()=>{await L.rm(t,{recursive:!0,force:!0}),await Tr(e,t,n)});return}catch(i){if(!Er(i)||a===kr)throw i;await $r(xr)}},Fn=async e=>{let t;try{t=await L.readFile(N.join(e,"owner.json"),"utf8")}catch(i){if(!bt(i))throw i;return null}let n;try{n=JSON.parse(t)}catch{return null}if(typeof n!="object"||n===null||!("token"in n))return null;let a=n.token;return typeof a=="string"&&a.length>0?a:null},Cr=async(e,t)=>await Fn(e)!==t?!1:(await L.rm(e,{recursive:!0,force:!0}),!0),yl=async(e,t)=>{let n;try{n=await L.stat(e)}catch{return!1}if(Date.now()-n.mtimeMs<=t)return!1;let a=await Fn(e);return a===null?(await L.rm(e,{recursive:!0,force:!0}),!0):Cr(e,a)},_l=(e,t,n)=>{let a=Promise.resolve(),i=setInterval(()=>{a=a.then(async()=>{if(await Fn(e)!==t)return;let r=new Date;await L.utimes(e,r,r)}).catch(()=>{})},n);return i.unref(),async()=>{clearInterval(i),await a}},wl=async(e,t)=>{await L.mkdir(e);try{await L.writeFile(N.join(e,"owner.json"),`${JSON.stringify(t,null,2)}
-`,"utf8")}catch(n){throw await L.rm(e,{recursive:!0,force:!0}).catch(()=>{}),n}},vl=async(e,t,n,a,i)=>{for(let r=1;r<=n;r+=1)try{return await wl(e,t),!0}catch(o){if(!Gt(o,"EEXIST"))throw o;await yl(e,i)?r-=1:await $r(a)}return!1},Mn=async(e,t,n,a)=>Te("extension_install",async()=>{let i=N.join(e,"runtime","extension-install-locks"),r=N.join(i,"scope.lock");await L.mkdir(i,{recursive:!0});let{attempts:o=fl,delay_ms:s=xr,stale_ms:d=hl,heartbeat_ms:c}=a??{};if(![o,s,d,c].filter(w=>w!==void 0).every(Number.isFinite))throw new f("Extension install lock timings must be finite numbers.",h.USAGE);let l=Math.max(1,Math.floor(o)),p=Math.max(0,Math.floor(s)),m=Math.floor(d),y=Math.floor(c??m/3);if(m<=0||y<=0||y>=m)throw new f("Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.",h.USAGE);let g={pid:process.pid,token:ml(),created_at:A(),destination:t};if(!await vl(r,g,l,p,m))throw new f(`Timed out waiting for extension install lock for "${t}".`,h.CONFLICT);let _=_l(r,g.token,y),u=!1;try{let w=await n();return u=!0,w}finally{await _(),await Cr(r,g.token).catch(w=>{if(u)throw w})}});(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="18bf1015-c2c8-5530-a3ce-1531a8a1d0e2")}catch{}})();var bl=new Set(["node_modules",".git","dist","build","coverage"]);async function Pr(e,t,n,a){let i=e.source.kind==="local"?await qt.stat(e.source.absolute_path):void 0,r=e.source.kind==="local"?i.isDirectory()?"directory":"archive":e.source.kind,o=await kl(e.directory,t,a),s={source_mode:r,...r==="archive"?{archive_bytes:i.size}:{},copy:o},d=e.source_root??e.directory;if(r==="directory"&&(!o.complete||o.development_entries>0||o.bytes>=16*1024*1024)&&await k(Jt.join(d,"package.json"))&&(s.packed_alternative={cwd:d,pack:{command:"npm",args:["pack","--ignore-scripts","--json"]},install:{command:"pm",args:["package","install","<archive-filename>",`--${n}`]},archive_argument:"pack_result[0].filename"}),r==="directory"&&!o.complete){let c=o.stop_reason==="entry_limit"?`${o.max_entries} entries`:`${o.max_depth} directory levels`;throw new f(`Local extension source scan stopped at ${c}; the directory snapshot is incomplete and installation was refused. ${s.packed_alternative?"Pack the package with npm pack --ignore-scripts --json, then install its archive.":"Install a smaller source directory or a packed archive."}`,h.USAGE,{code:"extension_install_incomplete_source_scan",reason:o.stop_reason,nextSteps:s.packed_alternative?[`Run npm pack --ignore-scripts --json from the package root, then pm package install <archive-filename> --${n}.`]:["Choose a smaller source directory or install a packed archive."]})}return s}async function kl(e,t,n={}){let{maxEntries:a=1e4,maxDepth:i=64,signal:r}=n;if(![a,i].every(p=>Number.isSafeInteger(p)&&p>0))throw new f("maxEntries and maxDepth must be positive safe integers.",h.USAGE);r?.throwIfAborted();let o=await qt.realpath(e),s=await mt(t),d=await zt(o,s);r?.throwIfAborted();let c=d?"in_place":B(o,s)?"nested_filtered_snapshot":"directory_snapshot",l={copy_scope:c,source_directory:o,destination_directory:s,files:0,bytes:0,directories:0,symlinks:0,other_entries:0,scanned_entries:0,excluded_entries:0,development_entries:0,complete:!0,stop_reason:"complete",max_entries:a,max_depth:i};return c==="in_place"||await Rr(o,0,l,r),l}async function Rr(e,t,n,a){a?.throwIfAborted();let i=await qt.opendir(e);for await(let r of i){if(a?.throwIfAborted(),n.scanned_entries>=n.max_entries){n.complete=!1,n.stop_reason="entry_limit";return}n.scanned_entries+=1;let o=Jt.join(e,r.name);if(!pt(n.source_directory,n.destination_directory,o,n.copy_scope==="nested_filtered_snapshot")){n.excluded_entries+=1;continue}if(Jt.relative(n.source_directory,o).split(Jt.sep).some(s=>bl.has(s))&&(n.development_entries+=1),await xl(o,t,n,a),!n.complete)return}}async function xl(e,t,n,a){let i=await qt.lstat(e);if(a?.throwIfAborted(),i.isDirectory()){if(n.directories+=1,t+1>=n.max_depth){n.complete=!1,n.stop_reason="depth_limit";return}await Rr(e,t+1,n,a)}else i.isFile()?(n.files+=1,n.bytes+=i.size):i.isSymbolicLink()?n.symlinks+=1:n.other_entries+=1}import Sl from"node:fs/promises";import El from"npm-package-arg";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2bef4424-f5b8-511b-91f7-0b39cf11f515")}catch{}})();async function $l(e,t){if(e.kind!=="local"||e.input.startsWith(".")||e.input.includes("\\")||e.input.includes("/")&&!/^@[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/u.test(e.input))return e;try{return await Sl.lstat(e.absolute_path),e}catch(r){if(!ge(r))throw r}let n=e.input.trim(),a=t.filter(r=>r.source.kind==="npm"),i=(a.find(r=>r.name===n)??a.find(r=>r.directory===n)??a.find(r=>r.source.package===n))?.source.package;if(i===void 0)return e;try{let r=El(i);if(!r.registry||r.name!==i)return e}catch{return e}return ct(`npm:${i}`,{})}async function Nr(e,t,n,a=[]){let i=typeof t=="string"?null:await st(e),r=i===null?null:e.trim().toLowerCase(),o=r===null?null:await Hi(r),s=await $l(ct(i??e,{forceGithub:typeof t=="string",ref:n}),a),d=r===null?null:await Zi(e);return{bundledAliasName:r,bundledPackageName:o,installSource:s,sourceResolution:{requested:e,selected:{kind:r===null?s.kind:"builtin",input:r??s.input,...o===null?{}:{package:o}},ambiguous:d!==null,precedence:"bundled_alias_before_installed_npm",candidates:[...r===null?[]:[{kind:"builtin",input:r,...o===null?{}:{package:o},command:`pm install ${r}`}],...d===null?[]:[{kind:"npm",input:`npm:${d.package}`,package:d.package,...d.version===void 0?{}:{version:d.version},directory:d.directory,command:`pm install npm:${d.package}`}]]}}}import Ie from"node:fs/promises";import Q from"node:path";import Cl from"node:path";import{mkdir as Pl}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]="abb182c9-6d6c-5be4-a2ad-c91b00a098d0")}catch{}})();var ut=["agile","ops","research"],Il={agile:[{name:"Story",description:"User-facing outcome or capability slice expressed from a stakeholder perspective.",defaultStatus:"open",folder:"stories",aliases:["user-story"]},{name:"Spike",description:"Time-boxed investigation used to reduce uncertainty before implementation.",defaultStatus:"open",folder:"spikes",aliases:["research-spike"]}],ops:[{name:"Incident",description:"Operational disruption, degradation, or support escalation with recovery tracking.",defaultStatus:"open",folder:"incidents",aliases:["outage"]},{name:"Runbook",description:"Repeatable operational procedure, diagnostic path, or response playbook.",defaultStatus:"open",folder:"runbooks",aliases:["playbook"]}],research:[{name:"Experiment",description:"Validated-learning activity with hypothesis, method, and outcome tracking.",defaultStatus:"open",folder:"experiments",aliases:["study"]},{name:"Hypothesis",description:"Testable claim or assumption that should be supported, rejected, or refined.",defaultStatus:"open",folder:"hypotheses",aliases:["assumption"]}]};function Wt(e){if(e===void 0)return;let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new Error("Type preset name must not be empty.");if(t==="agile"||t==="ops"||t==="research")return t;throw new Error(`Invalid type preset "${e}". Allowed: ${ut.join(", ")}.`)}function ft(e){return Il[e].map(t=>tt(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]="4d01ffa0-2cdb-5d22-834e-d23d31403ad6")}catch{}})();var Al=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function Tl(e){let t=Al.exec(e.trim());if(!t)return;let n=t[1];if(!(n.length<2)&&!/^[A-Za-z]\d+$/.test(n))return n.toLowerCase()}function Ol(e){return e.split(/[-_]+/).filter(t=>t.length>0).map(t=>`${t.slice(0,1).toUpperCase()}${t.slice(1).toLowerCase()}`).join("")}function Dr(e,t={}){let n=typeof t.minCount=="number"&&t.minCount>0?Math.trunc(t.minCount):10,a=typeof t.maxExamples=="number"&&t.maxExamples>0?Math.trunc(t.maxExamples):3,i=new Map;for(let o of e){let s=typeof o=="string"?o.trim():"";if(s.length===0)continue;let d=Tl(s);if(d===void 0)continue;let c=i.get(d)??{count:0,examples:[]};c.count+=1,c.examples.length<a&&c.examples.push(s),i.set(d,c)}let r=[];for(let[o,s]of i.entries()){if(s.count<n)continue;let d=Ol(o);r.push({name:d,prefix:o,count:s.count,examples:s.examples,shadows_builtin:Ba(d)!==void 0})}return r.sort((o,s)=>s.count-o.count||o.name.localeCompare(s.name)),r}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="7a59f90b-0497-530c-93e1-c93cfc8a0016")}catch{}})();var Qg=[...xt,"add-type","remove-type","add-status","remove-status","add-field","remove-field","list-fields","show-field","apply-preset","list","show","show-status","rename-type","rename-field","remap-status"],Bt="schema-types",jr="schema-statuses",Lr="schema-fields";function Ee(e){return Ue({pmRoot:e.pmRoot,filePath:e.filePath,raw:e.raw,op:e.op,author:e.author,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}async function ny(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i;try{i=tt({name:e,description:t.description,defaultStatus:t.defaultStatus,folder:t.folder,aliases:t.alias})}catch(y){throw new f(y instanceof Error?y.message:String(y),h.USAGE)}let r=await C(a),o=H(r.schema),s=ee(a,o.files.types,V.types),d=[],c=K(t.author,r.author_default),l=pe(r),p=await ne(a,Bt,r.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,r.locks.wait_ms),m;try{let y=await G(s),g;try{g=ae(y)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.GENERIC_FAILURE)}try{Ha(i,g);let _=new Map,u=q(r,J());for(let[w,v]of Object.entries(u.type_to_folder)){let S=v.trim().toLowerCase();S.length>0&&!_.has(S)&&_.set(S,w)}Ka(i,g,_)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}m=ze(g,i),m.replaced&&m.previousName!==void 0&&m.previousName!==m.definition.name&&d.push(`type_recased:${m.previousName}->${m.definition.name}`),await Ee({pmRoot:a,filePath:s,raw:re(m.file),op:"schema:add-type",author:c,settings:r}),await ht(a,[m.definition],d,"schema:add-type-folder"),d.push(...await W({path:s,scope:"project",op:"schema:add-type"}))}finally{await p()}return await Fr(a,d),{action:"add-type",registered:!0,replaced:m.replaced,type:m.definition,file:{path:s,definitions:m.file.definitions.length},warnings:$e(d),generated_at:A()}}async function he(e){await Me(e)}async function Fr(e,t){try{let n=await Qa(e);n.status==="refreshed"?t.push("merge_fence_refreshed"):n.status==="not_installed"&&t.push('merge_fence_not_installed:type folders lack git merge drivers; run "pm merge install"')}catch{t.push('merge_fence_refresh_failed:run "pm merge install" to reconcile')}}function $e(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}async function Rl(e,t,n,a){let i=q(t,J()),r=a.trim().toLowerCase();return(await Oe(e,t.item_format,i.type_to_folder,[],n)).filter(o=>typeof o.type=="string"&&o.type.toLowerCase()===r).length}async function Nl(e,t,n,a){let i=q(t,J()),r=et(n),o=I(a);return(await Oe(e,t.item_format,i.type_to_folder,[],n)).filter(s=>{let d=typeof s.status=="string"?s.status:"";return(r.alias_to_id.get(I(d))??I(d))===o}).length}async function Dl(e,t,n,a,i){if(i.length===0||Re.has(i))return;let r=await Nl(t,n,a,i);r>0&&e.push(`items_using_status:${r}`);let o=Mr(a.workflow,i);o.length>0&&e.push(`status_referenced_by_workflow:${o.join(",")}`)}function Mr(e,t){return[["draft_status",e.draft_status],["open_status",e.open_status],["in_progress_status",e.in_progress_status],["blocked_status",e.blocked_status],["close_status",e.close_status],["canceled_status",e.canceled_status]].filter(([,n])=>n!==void 0&&I(n)===t).map(([n])=>n)}async function ay(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i=await C(a),r=H(i.schema),o=ee(a,r.files.types,V.types),s=[],d=K(t.author,i.author_default),c=pe(i),l=await ne(a,Bt,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=ae(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Va(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=(p.definition?.name??e??"").trim();if(g.length>0){let _=await Rl(a,i,r,g);_>0&&s.push(`items_using_type:${_}`)}await Ee({pmRoot:a,filePath:o,raw:re(p.file),op:"schema:remove-type",author:d,settings:i}),s.push(...await W({path:o,scope:"project",op:"schema:remove-type"}))}}finally{await l()}return p.removed&&await Fr(a,s),{action:"remove-type",removed:p.removed,...p.definition?{type:p.definition}:{},file:{path:o,definitions:p.file.definitions.length},warnings:$e(s),generated_at:A()}}function Un(e,t){return ee(e,t.files.statuses,V.statuses)}function Ht(e,t){return ee(e,t.files.fields,V.fields)}function Ur(e,t){return ee(e,t.files.types,V.types)}async function ht(e,t,n,a){for(let i of t){let r=ua(i.folder??ma(i.name)),o=Cl.join(e,r);await k(o)||(await Pl(o,{recursive:!0}),n.push(...await W({path:o,scope:"project",op:a})))}}function zn(e){return{key:e.key,type:e.type,commands:[...e.commands],cli_flag:`--${e.cli_flag}`,cli_aliases:e.cli_aliases.map(t=>`--${t}`),...e.description?{description:e.description}:{},required:e.required,required_on_create:e.required_on_create,allow_unset:e.allow_unset,required_types:[...e.required_types]}}function jl(e){if(e)return{id:e.id,...e.roles.length>0?{roles:[...e.roles]}:{},...e.aliases.length>0?{aliases:[...e.aliases]}:{},...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function Ll(e){let t=new Map;for(let n of e){let a=I(n.id);if(a.length!==0){t.set(a,a);for(let i of Array.isArray(n.aliases)?n.aliases:[]){let r=I(i);r.length>0&&!t.has(r)&&t.set(r,a)}}}return t}async function iy(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i;try{i=$i({id:e,roles:t.role,aliases:t.alias,description:t.description,order:t.order})}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let r=await C(a),o=H(r.schema),s=Un(a,o),d=et(o);try{_n(i,d.alias_to_id)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let c=jl(d.by_id.get(i.id));if((i.roles??c?.roles??[]).length===0)throw new f(`Status "${i.id}" requires at least one lifecycle role. Re-run with --role active, --role blocked, --role draft, or an appropriate terminal/default role.`,h.USAGE,{code:"status_lifecycle_role_required",examples:[`pm schema add-status "${Ce(i.id)}" --role active`,`pm schema add-status "${Ce(i.id)}" --role blocked`]});let l=[],p=K(t.author,r.author_default),m=pe(r),y=await ne(a,jr,r.locks.ttl_seconds,p,!!t.force,m.force_required_for_stale_lock,r.locks.wait_ms),g;try{let _=await G(s),u;try{u=We(_)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.GENERIC_FAILURE)}let w=Ll(u.statuses);try{_n(i,w)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.USAGE)}g=Ii(u,i,c),await Ee({pmRoot:a,filePath:s,raw:Be(g.file),op:"schema:add-status",author:p,settings:r}),l.push(...await W({path:s,scope:"project",op:"schema:add-status"}))}finally{await y()}return{action:"add-status",registered:!0,replaced:g.replaced,status:g.definition,file:{path:s,statuses:g.file.statuses.length},warnings:$e(l),generated_at:A()}}async function ry(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i=await C(a),r=H(i.schema),o=Un(a,r),s=[],d=K(t.author,i.author_default),c=pe(i),l=await ne(a,jr,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=We(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Ai(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=I(p.definition?.id??e);await Dl(s,a,i,r,g),await Ee({pmRoot:a,filePath:o,raw:Be(p.file),op:"schema:remove-status",author:d,settings:i}),s.push(...await W({path:o,scope:"project",op:"schema:remove-status"}))}}finally{await l()}return{action:"remove-status",removed:p.removed,...p.definition?{status:p.definition}:{},file:{path:o,statuses:p.file.statuses.length},warnings:$e(s),generated_at:A()}}function zr(e){return{name:e.name,folder:e.folder,aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.default_status?{default_status:e.default_status}:{},...e.description?{description:e.description}:{}}}function Fl(e,t,n){return{...zr(e),source:t,...n?{extension:n}:{},required_create_fields:[...e.required_create_fields],required_create_repeatables:[...e.required_create_repeatables],options:structuredClone(e.options),command_option_policies:structuredClone(e.command_option_policies)}}function Gr(e){return{id:e.id,source:Re.has(e.id)?"builtin":"custom",roles:Array.isArray(e.roles)?[...e.roles]:[],aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function Jr(e,t,n){let a=e.toLowerCase();return n.has(a)?"extension":t.has(a)?"custom":"builtin"}function Ml(){let e=new Map,t=J();for(let n of t?.item_types??[]){let a=n.types;if(Array.isArray(a))for(let i of a){if(typeof i!="object"||i===null||Array.isArray(i))continue;let r=i.name;typeof r=="string"&&r.trim().length>0&&e.set(r.trim().toLowerCase(),{layer:n.layer,name:n.name})}}return e}function Ul(e){let t=et(e),n=[],a=[];for(let i of t.definitions){let r=Gr(i);r.source==="builtin"?n.push(r):a.push(r)}return{builtin:n,custom:a}}async function gt(e){let t=F(process.cwd(),e.path);await he(t);let n=await C(t),a=H(n.schema),i=ee(t,a.files.types,V.types),r=Un(t,a),o=q(n,J()),s=Ml(),d=new Set((n.item_types?.definitions??[]).map(c=>c.name.trim().toLowerCase()).filter(c=>c.length>0&&!s.has(c)));return{pmRoot:t,typesPath:i,statusesPath:r,byType:o.by_type,customNames:d,extensionProvenance:s,schema:a}}async function oy(e){let t=await gt(e),n=[],a=[],i=[];for(let s of Object.values(t.byType).sort((d,c)=>d.name.localeCompare(c.name))){let d=Jr(s.name,t.customNames,new Set(t.extensionProvenance.keys())),c=zr(s);d==="extension"?i.push(c):d==="custom"?a.push(c):n.push(c)}let r=Ul(t.schema),o=$t(t.schema).definitions.map(zn);return{action:"list",builtin:n,custom:a,extension:i,counts:{builtin:n.length,custom:a.length,extension:i.length,total:n.length+a.length+i.length},statuses:{builtin:r.builtin,custom:r.custom,counts:{builtin:r.builtin.length,custom:r.custom.length,total:r.builtin.length+r.custom.length}},fields:{custom:o,counts:{total:o.length}},file:{path:t.typesPath},generated_at:A()}}async function sy(e,t){let n=(e??"").trim();if(n.length===0)throw new f("Type name must not be empty.",h.USAGE);let a=await gt(t),i=Object.values(a.byType).find(r=>r.name.toLowerCase()===n.toLowerCase()||r.aliases.some(o=>o.toLowerCase()===n.toLowerCase()));if(!i)throw new f(`Unknown item type "${n}". Run pm schema list to inspect registered types, or pm schema add-type "${Ce(n)}" to register it.`,h.NOT_FOUND,{code:"unknown_item_type"});return{action:"show",type:Fl(i,Jr(i.name,a.customNames,new Set(a.extensionProvenance.keys())),a.extensionProvenance.get(i.name.toLowerCase())),file:{path:a.typesPath},generated_at:A()}}async function cy(e,t){let n=I(e);if(n.length===0)throw new f("Status id must not be empty.",h.USAGE);let a=await gt(t),i=et(a.schema),r=i.alias_to_id.get(n)??n,o=i.by_id.get(r);if(!o)throw new f(`Unknown status "${e}". Run pm schema list to inspect registered statuses, or pm schema add-status "${Ce(e??"")}" to register it.`,h.NOT_FOUND,{code:"unknown_status"});return{action:"show-status",status:Gr(o),file:{path:a.statusesPath},generated_at:A()}}async function dy(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i;try{i=xi({key:e,type:t.type,commands:t.commands,description:t.description,cliFlag:t.cliFlag,aliases:t.alias,required:t.required,requiredOnCreate:t.requiredOnCreate,allowUnset:t.allowUnset,requiredTypes:t.requiredTypes})}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}let r=await C(a),o=H(r.schema),s=Ht(a,o),d=[],c=Tt(i.key);c&&d.push(`custom_field_mcp_input_collision:${c.field}:${c.property}:${c.owner}:use=${c.nested_path}`);let l=K(t.author,r.author_default),p=pe(r),m=await ne(a,Lr,r.locks.ttl_seconds,l,!!t.force,p.force_required_for_stale_lock,r.locks.wait_ms),y;try{let g=await G(s),_;try{_=Je(g)}catch(u){throw new f(u instanceof Error?u.message:String(u),h.GENERIC_FAILURE)}y=Si(_,i),await Ee({pmRoot:a,filePath:s,raw:qe(y.file),op:"schema:add-field",author:l,settings:r}),d.push(...await W({path:s,scope:"project",op:"schema:add-field"}))}finally{await m()}return{action:"add-field",registered:!0,replaced:y.replaced,field:y.definition,file:{path:s,fields:y.file.fields.length},warnings:$e(d),generated_at:A()}}async function zl(e,t,n,a){let i=q(t,J());return(await Oe(e,t.item_format,i.type_to_folder,[],n)).filter(r=>{let o=r[a];return o==null?!1:Array.isArray(o)?o.length>0:typeof o=="string"?o.trim().length>0:!0}).length}async function ly(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i=await C(a),r=H(i.schema),o=Ht(a,r),s=[],d=K(t.author,i.author_default),c=pe(i),l=await ne(a,Lr,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=Je(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Ei(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=I(p.definition?.key??e),_=I(p.definition?.metadata_key??p.definition?.front_matter_key??g);if(_.length>0){let u=await zl(a,i,r,_);u>0&&s.push(`items_using_field:${u}`)}await Ee({pmRoot:a,filePath:o,raw:qe(p.file),op:"schema:remove-field",author:d,settings:i}),s.push(...await W({path:o,scope:"project",op:"schema:remove-field"}))}}finally{await l()}return{action:"remove-field",removed:p.removed,...p.definition?{field:p.definition}:{},file:{path:o,fields:p.file.fields.length},warnings:$e(s),generated_at:A()}}async function py(e){let t=await gt(e),n=$t(t.schema).definitions.map(zn);return{action:"list-fields",fields:n,counts:{total:n.length},file:{path:Ht(t.pmRoot,t.schema)},generated_at:A()}}async function my(e,t){let n=I(e);if(n.length===0)throw new f("Field key must not be empty.",h.USAGE);let a=await gt(t),i=$t(a.schema).by_key.get(n);if(!i)throw new f(`Unknown custom field "${e}". Run pm schema list-fields to inspect registered fields, or pm schema add-field "${Ce(e??"")}" to register it.`,h.NOT_FOUND,{code:"unknown_field"});return{action:"show-field",field:zn(i),file:{path:Ht(a.pmRoot,a.schema)},generated_at:A()}}async function uy(e,t,n){let a=F(process.cwd(),n.path);await he(a);let i;try{let _=Wt(e);if(_===void 0)throw new Error(`Type preset name is required. Allowed: ${ut.join(", ")}.`);i=_}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let r=await C(a),o=H(r.schema),s=Ur(a,o),d=[],c=K(t.author,r.author_default),l=pe(r),p=[],m=[],y,g=await ne(a,Bt,r.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,r.locks.wait_ms);try{let _=await G(s),u;try{u=ae(_)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.GENERIC_FAILURE)}let w=u;for(let v of ft(i)){let S=ze(w,v);w=S.file,(S.replaced?m:p).push(S.definition.name)}y=w.definitions.length,await Ee({pmRoot:a,filePath:s,raw:re(w),op:"schema:apply-preset",author:c,settings:r}),await ht(a,ft(i),d,"schema:apply-preset-folder"),d.push(...await W({path:s,scope:"project",op:"schema:apply-preset"}))}finally{await g()}return{action:"apply-preset",preset:i,registered:p,replaced:m,file:{path:s,definitions:y},warnings:$e(d),generated_at:A()}}function Gl(e){if(e===void 0)return 10;if(!Number.isInteger(e)||e<1)throw new f("--min-count must be a positive integer (>= 1).",h.USAGE);return e}async function fy(e,t){let n=F(process.cwd(),t.path);await he(n);let a=await C(n),i=H(a.schema),r=Ur(n,i),o=Gl(e.minCount),s=q(a,J()),d=(await Oe(n,a.item_format,s.type_to_folder,[],i)).map(v=>typeof v.title=="string"?v.title:""),c=Dr(d,{minCount:o}),l=[],p=[],m=[],y=[],g;if(!e.apply){let v;try{v=ae(await G(r))}catch(S){throw new f(S instanceof Error?S.message:String(S),h.GENERIC_FAILURE)}return g=v.definitions.length,{action:"infer-types",applied:!1,min_count:o,candidates:c,registered:p,replaced:m,skipped:y,file:{path:r,definitions:g},warnings:l,generated_at:A()}}let _=K(e.author,a.author_default),u=pe(a),w=await ne(n,Bt,a.locks.ttl_seconds,_,!!e.force,u.force_required_for_stale_lock,a.locks.wait_ms);try{let v=await G(r),S;try{S=ae(v)}catch(T){throw new f(T instanceof Error?T.message:String(T),h.GENERIC_FAILURE)}let x=S;for(let T of c){if(T.shadows_builtin){y.push({name:T.name,reason:"shadows_builtin"});continue}let te;try{te=tt({name:T.name})}catch{y.push({name:T.name,reason:"invalid_type_token"});continue}let D=ze(x,te);x=D.file,(D.replaced?m:p).push(D.definition.name)}g=x.definitions.length,await Ee({pmRoot:n,filePath:r,raw:re(x),op:"schema:infer-types",author:_,settings:a}),await ht(n,x.definitions.filter(T=>p.includes(T.name)||m.includes(T.name)),l,"schema:infer-types-folder"),l.push(...await W({path:r,scope:"project",op:"schema:infer-types"}))}finally{await w()}return{action:"infer-types",applied:!0,min_count:o,candidates:c,registered:p,replaced:m,skipped:y,file:{path:r,definitions:g},warnings:$e(l),generated_at:A()}}function hy(e){let t=e.replaced?"Updated":"Registered",n=e.type.aliases&&e.type.aliases.length>0?` (aliases: ${e.type.aliases.join(", ")})`:"";return`${t} custom item type "${e.type.name}"${n} in ${e.file.path}. Run: pm create "${Ce(e.type.name)}" "<title>"`}function gy(e){return e.removed?`Removed custom item type "${e.type?.name??"(unknown)"}" from ${e.file.path}.`:`No custom item type matched; nothing removed from ${e.file.path}.`}function yy(e){let t=e.replaced?"Updated":"Registered",n=e.status.roles&&e.status.roles.length>0?` (roles: ${e.status.roles.join(", ")})`:"",a=e.status.aliases&&e.status.aliases.length>0?` (aliases: ${e.status.aliases.join(", ")})`:"";return`${t} status "${e.status.id}"${n}${a} in ${e.file.path}.`}function _y(e){return e.removed?`Removed custom status "${e.status?.id??"(unknown)"}" from ${e.file.path}.`:`No custom status matched; nothing removed from ${e.file.path}.`}function wy(e){let t=[`Schema types: ${e.counts.total} total (${e.counts.builtin} builtin, ${e.counts.custom} custom, ${e.counts.extension} extension)`];for(let[n,a]of[["builtin",e.builtin],["custom",e.custom],["extension",e.extension]])a.length!==0&&t.push(`${n}: ${a.map(i=>i.name).join(", ")}`);t.push(`statuses: ${e.statuses.counts.total} total (${e.statuses.counts.builtin} builtin, ${e.statuses.counts.custom} custom)`);for(let[n,a]of[["builtin statuses",e.statuses.builtin],["custom statuses",e.statuses.custom]])a.length!==0&&t.push(`${n}: ${a.map(i=>i.id).join(", ")}`);return t.push(`custom fields: ${e.fields.counts.total} total`),e.fields.custom.length>0&&t.push(`fields: ${e.fields.custom.map(n=>`${n.key} (${n.type}, ${n.cli_flag})`).join(", ")}`),t.push("Inspect one: pm schema show <Type>"),t.push("Inspect one status: pm schema show-status <status>"),t.push("Inspect one field: pm schema show-field <key>"),t.join(`
-`)}function vy(e){let t=[`type: ${e.type.name}`,`source: ${e.type.source}`,`folder: ${e.type.folder}`];return e.type.default_status&&t.push(`default_status: ${e.type.default_status}`),e.type.aliases.length>0&&t.push(`aliases: ${e.type.aliases.join(", ")}`),e.type.description&&t.push(`description: ${e.type.description}`),e.type.options.length>0&&t.push(`options: ${e.type.options.map(n=>n.key).join(", ")}`),t.join(`
-`)}function by(e){let t=[`status: ${e.status.id}`,`source: ${e.status.source}`];return e.status.roles.length>0&&t.push(`roles: ${e.status.roles.join(", ")}`),e.status.aliases.length>0&&t.push(`aliases: ${e.status.aliases.join(", ")}`),e.status.description&&t.push(`description: ${e.status.description}`),typeof e.status.order=="number"&&t.push(`order: ${e.status.order}`),t.join(`
-`)}function Jl(e){let t=[];e.required&&t.push("required"),e.required_on_create&&t.push("required_on_create"),e.allow_unset||t.push("no_unset");let n=t.length>0?` [${t.join(", ")}]`:"";return`${e.key} (${e.type}) ${e.cli_flag} commands=${e.commands.join("/")}${n}`}function ky(e){return`${e.replaced?"Updated":"Registered"} custom field "${e.field.key}" in ${e.file.path}. Use it: pm create "<title>" --${(e.field.cli_flag??e.field.key).replaceAll("_","-")} <value>`}function xy(e){return e.removed?`Removed custom field "${e.field?.key??"(unknown)"}" from ${e.file.path}.`:`No custom field matched; nothing removed from ${e.file.path}.`}function Sy(e){let t=[`Custom fields: ${e.counts.total} total`];for(let n of e.fields)t.push(`  ${Jl(n)}`);return t.push("Inspect one: pm schema show-field <key>"),t.join(`
-`)}function Ey(e){let t=e.field,n=[`field: ${t.key}`,`type: ${t.type}`,`cli_flag: ${t.cli_flag}`,`commands: ${t.commands.join(", ")}`];return t.cli_aliases.length>0&&n.push(`cli_aliases: ${t.cli_aliases.join(", ")}`),t.description&&n.push(`description: ${t.description}`),t.required&&n.push("required: true"),t.required_on_create&&n.push("required_on_create: true"),t.allow_unset||n.push("allow_unset: false"),t.required_types.length>0&&n.push(`required_types: ${t.required_types.join(", ")}`),n.join(`
-`)}function $y(e){let t=e.registered.length>0?`registered: ${e.registered.join(", ")}`:"",n=e.replaced.length>0?`updated: ${e.replaced.join(", ")}`:"",a=[t,n].filter(i=>i.length>0).join("; ");return`Applied "${e.preset}" type preset to ${e.file.path}${a.length>0?` (${a})`:""}.`}function Iy(e){if(e.candidates.length===0)return`No title-prefix conventions found with at least ${e.min_count} items. Lower the threshold with --min-count <n>.`;let t=e.applied?[`Inferred and registered custom types from title prefixes (min-count ${e.min_count}):`]:[`Inferred custom type candidates from title prefixes (min-count ${e.min_count}, dry-run):`];for(let n of e.candidates){let a=n.shadows_builtin?" [shadows built-in, skipped]":"";t.push(`  ${n.name} <- "${n.prefix}" (${n.count} items)${a}`)}return e.applied?(e.registered.length>0&&t.push(`registered: ${e.registered.join(", ")}`),e.replaced.length>0&&t.push(`updated: ${e.replaced.join(", ")}`)):t.push("Re-run with --apply to register the non-shadowing candidates."),t.join(`
-`)}var Ay={workflowSlotsReferencing:Mr};(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="1e6087f2-01b5-59c3-a471-433c722316b0")}catch{}})();function Gn(e){return e.map(({layer:t,name:n,error:a})=>({layer:t,name:n,error:a}))}function Kt(e,t,n){let a=b(t),i=n.trim();if(a.length===0||i.length===0)return;let r=e.get(a)??new Set;r.add(i),e.set(a,r)}function ql(e){let t=new Map,n=new Map;for(let a of e.registrations.commands)Kt(t,a.name,a.command),Kt(n,a.name,a.action);for(let a of e.commands.handlers)Kt(t,a.name,a.command);for(let a of e.commands.overrides)Kt(t,a.name,a.command);return{commandPathsByExtension:t,actionPathsByExtension:n}}function qr(e){if(!(!e||e.size===0))return[...e].sort((t,n)=>t.localeCompare(n))}function Wl(e){let{enabled:t,normalizedName:n,loadedNames:a,loadFailedNames:i,activationFailedNames:r}=e;return t?i.has(n)||r.has(n)?{runtime_active:!1,activation_status:"failed"}:a.has(n)?{runtime_active:!0,activation_status:"ok"}:{runtime_active:!1,activation_status:"not_loaded"}:{runtime_active:!1,activation_status:"not_loaded"}}function Vt(e,t,n){let a=new Set(t.loaded.map(d=>b(d.name))),i=new Set(t.failed.map(d=>b(d.name))),r=new Set(n.failed.map(d=>b(d.name))),{commandPathsByExtension:o,actionPathsByExtension:s}=ql(n);return e.map(d=>{let c=b(d.name),l=qr(o.get(c)),p=qr(s.get(c)),m={...l?{command_paths:l}:{},...p?{action_paths:p}:{}},y=Wl({enabled:d.enabled,normalizedName:c,loadedNames:a,loadFailedNames:i,activationFailedNames:r});return{...d,...y,...m}})}function Bl(e){let t=0,n=0,a=0;for(let i of e)if(i.startsWith("extension_policy_")){if(t+=1,i.startsWith("extension_policy_violation_")){n+=1;continue}i.startsWith("extension_policy_blocked_")&&(a+=1)}return{warning_count:t,violation_count:n,blocked_count:a}}function M(e,t){return e.vocabulary==="package"?`pm package --${t}`:`pm extension --${t}`}var Hr=new Set(["extension_command_handler_collision","extension_command_override_collision","extension_command_override_handler_overlap","extension_parser_override_collision","extension_preflight_override_collision","extension_renderer_collision","extension_service_override_collision"]);function Hl(e){return Hr.has(Qr(e))}function Wr(e){return e==="project"||e==="global"}function Kr(e){let t=e.split(":"),n=t[0];if(!n||!Hr.has(n))return null;let a=t.at(-4),i=t.at(-3)?.trim(),r=t.at(-2),o=t.at(-1)?.trim();return!Wr(a)||!Wr(r)||!i||!o?null:{code:n,surface:t.slice(1,-4).join(":")||"global",winner:{layer:a,name:i},displaced:{layer:r,name:o}}}function Kl(e){let t=new Set;for(let n of e){let a=Kr(n);a&&(t.add(a.winner.name),t.add(a.displaced.name))}return[...t].sort((n,a)=>n.localeCompare(a))}function Vl(e,t){let n=e.filter(Hl);if(n.length===0)return null;let a=Kl(n);return`Extension registration collisions or handler/override overlaps detected.${a.length>0?` Conflicting extensions: ${a.join(", ")}.`:""} Single-winner surfaces can hide earlier package behavior. Deactivate one conflicting package with ${t.deactivate}, or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${t.doctor}.`}function Yl(e,t,n,a){let i=t.map(p=>Kr(p)).filter(p=>p!==null).sort((p,m)=>`${p.code}:${p.surface}:${p.winner.name}:${p.displaced.name}`.localeCompare(`${m.code}:${m.surface}:${m.winner.name}:${m.displaced.name}`));if(i.length===0)return;let r=e==="global"?"--global":"--project",o=M(a,"deactivate"),s=`${M(a,"doctor")} ${r} --detail deep --trace`,d=new Map(n.map(p=>[b(p.name),p])),c=new Map;for(let p of i)for(let m of[p.winner.name,p.displaced.name]){let y=b(m);c.set(y,(c.get(y)??0)+1)}let l=[...c.entries()].map(([p,m])=>{let y=d.get(p),g=y?.name??p,_=y?.command_paths??[],u=y?.action_paths??[];return{action:"deactivate",extension:g,command:`${o} ${g} ${r}`,affected_collisions:m,feature_loss:{command_paths:[..._].sort((w,v)=>w.localeCompare(v)),action_paths:[...u].sort((w,v)=>w.localeCompare(v))}}}).sort((p,m)=>{let y=m.affected_collisions-p.affected_collisions;if(y!==0)return y;let g=p.feature_loss.command_paths.length+p.feature_loss.action_paths.length,_=m.feature_loss.command_paths.length+m.feature_loss.action_paths.length;return g!==_?g-_:p.extension.localeCompare(m.extension)});return{status:"conflicts_detected",collision_count:i.length,extension_count:c.size,next_best_command:s,collisions:i,remediation_candidates:l}}function Vr(e){let t=[];for(let n of e){let a=n.error.toLowerCase();(a.includes("cannot find package '@unbrained/pm-cli'")||a.includes('cannot find module "@unbrained/pm-cli"')||a.includes("cannot find module '@unbrained/pm-cli'"))&&t.push(`extension_load_failed_sdk_dependency_missing:${n.name}`),(a.includes("cannot use import statement outside a module")||a.includes("to load an es module")||a.includes("must use import to load es module"))&&t.push(`extension_load_failed_module_mode_mismatch:${n.name}`)}return[...new Set(t)].sort((n,a)=>n.localeCompare(a))}function Yr(e=[]){let t=Array.isArray(e)?e:[],n=[];for(let a of t){if(!a||typeof a.name!="string")continue;let i=a.trace?.missing_capability??a.trace?.capability;typeof i=="string"&&i.trim().length>0&&n.push(`extension_capability_missing:${a.name}:${i.trim().toLowerCase()}`)}return[...new Set(n)].sort((a,i)=>a.localeCompare(i))}function Xr(e,t){let n=[];for(let a of Pa(e.loaded,t))for(let i of a.unused)n.push(`extension_capability_unused:${a.layer}:${a.name}:${i}`);return[...new Set(n)].sort((a,i)=>a.localeCompare(i))}var Xl=[{matches:e=>e.some(t=>t.startsWith("extension_manifest_")),build:e=>`Run ${M(e.options,"explore")} ${e.scopeFlag} to inspect discovered manifests and directories.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unknown:")),build:()=>`Unknown extension capabilities detected. Allowed capabilities: ${ca.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_legacy_alias:")),build:()=>"Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."},{matches:e=>e.some(t=>t.startsWith("extension_capability_missing:")),build:e=>`Extension activation failed because code registered a surface missing from manifest capabilities. Run ${M(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unused:")),build:e=>`Extension manifests declare capabilities that are never registered against. Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${M(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace for per-extension registration counts.`},{matches:e=>e.some(t=>t.startsWith("extension_command_definition_legacy_handler_alias:")),build:()=>"Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."},{matches:e=>e.some(t=>t.startsWith("extension_output_service_override_global:")||t.startsWith("extension_output_renderer_override_global:")),build:()=>"Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering."},{matches:e=>e.some(t=>t.startsWith("extension_schema_narrow_activation:")),build:()=>"A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or \u2014 if the schema is intentionally command-scoped \u2014 knowingly ignore this advisory."},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_sdk_dependency_missing:")),build:e=>`Detected extension load failures caused by missing SDK dependency resolution. Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_module_mode_mismatch:")),build:e=>`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" or use an explicit .mjs entry and rerun ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_pm_min_version_")||t.startsWith("extension_pm_max_version_")),build:e=>`Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:(e,t)=>t.updateCheckFailedTotal>0,build:e=>`Run ${M(e.options,"manage")} ${e.scopeFlag} after validating network and repository access.`},{matches:e=>e.some(t=>t.startsWith("extension_manager_state_")),build:e=>`Review and repair ${e.scope} managed extension state file if schema/read warnings persist.`},{matches:(e,t)=>t.policyWarningCount>0,build:()=>"Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces."}];function Zl(e){let{normalizedWarnings:t,options:n,scope:a,scopeFlag:i,updateCheckFailedTotal:r,policyWarningCount:o,unmanagedActionRequiredTotal:s,notCheckedTotal:d,skippedNonGithubTotal:c,updateAvailableTotal:l}=e,p=[],m={options:n,scope:a,scopeFlag:i,updateCheckFailedTotal:r,policyWarningCount:o};if(t.length>0){let y=Vl(t,{deactivate:`${M(n,"deactivate")} <name> ${i}`,doctor:`${M(n,"doctor")} ${i} --detail deep --trace`});y&&p.push(y);for(let g of Xl)g.matches(t,m)&&p.push(g.build(m))}return s>0&&p.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${M(n,"manage")} ${i} --fix-managed-state (or ${M(n,"adopt-all")} ${i}, ${M(n,"adopt")} <name> ${i}, or reinstall via ${M(n,"install")} ${i} <source>).`),c>0&&p.push("Update-check coverage is partial: non-GitHub managed sources were not checked. Inspect their registry or source directly; zero detected updates does not mean these packages are current. Runtime activation health is independent."),d>0&&p.push(`Update-check coverage is partial: some sources have no completed check. Run ${M(n,"manage")} ${i} to request update checks.`),l>0&&p.push(`Update available managed extensions via ${M(n,"install")} ${i} <source>.`),p.length===0&&p.push(`No immediate action required. Re-run ${M(n,"manage")} ${i} after extension changes.`),p}function Yt(e,t,n,a={}){let i=[...new Set(t)].sort((E,z)=>E.localeCompare(z)),r=n.filter(E=>E.managed).length,o=n.filter(E=>E.enabled).length,s=n.filter(E=>E.active).length,d=n.filter(E=>E.update_check_status==="checked"&&E.update_available===!0).length,c=n.filter(E=>E.managed===!1),l=c.filter(E=>Br(E)).map(E=>E.name).sort((E,z)=>E.localeCompare(z)),p=c.filter(E=>!Br(E)).map(E=>E.name).sort((E,z)=>E.localeCompare(z)),m={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(let E of n)m[E.update_check_status]+=1;let y=m.failed,g=n.filter(E=>E.update_check_status==="skipped_non_github"&&E.source?.kind!=="builtin").length,_=Object.entries({skipped_unmanaged:p.length,skipped_non_github:g,failed:y,not_checked:m.not_checked}).filter(([,E])=>E>0).map(([E,z])=>`extension_update_health_partial_coverage:${E}:${z}`),u=_.length>0,w=u?"partial":"full",v=[...new Set([...i,..._])].sort((E,z)=>E.localeCompare(z)),S=[...new Set(v.map(E=>Qr(E)))].sort((E,z)=>E.localeCompare(z)),x=Bl(v),T=e==="global"?"--global":"--project",te=Yl(e,i,n,a),D=Zl({normalizedWarnings:v,options:a,scope:e,scopeFlag:T,updateCheckFailedTotal:y,policyWarningCount:x.warning_count,unmanagedActionRequiredTotal:p.length,notCheckedTotal:m.not_checked,skippedNonGithubTotal:g,updateAvailableTotal:d});return{status:v.length===0?"ok":"warn",warning_count:v.length,warning_codes:S,warnings:v,policy_warning_count:x.warning_count,policy_violation_count:x.violation_count,policy_blocked_count:x.blocked_count,total_extensions:n.length,managed_total:r,enabled_total:o,active_total:s,update_available_total:d,update_health_coverage:w,update_health_partial:u,unmanaged_loaded_extension_count:c.length,unmanaged_loaded_extensions:c.map(E=>E.name).sort((E,z)=>E.localeCompare(z)),unmanaged_expected_extension_count:l.length,unmanaged_expected_extensions:l,unmanaged_action_required_extension_count:p.length,unmanaged_action_required_extensions:p,update_check_status_totals:m,update_check_failed_total:y,top_warnings:v.slice(0,8),remediation:D,...te?{collision_plan:te}:{}}}function Zr(e){if(!e||e.trim().length===0)return"summary";let t=e.trim().toLowerCase();if(t==="summary"||t==="deep")return t;throw new f(`Invalid --detail value "${e}". Expected summary or deep.`,h.USAGE)}function Qr(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function eo(e){let t=new Set,n=[];for(let a of e){let i=(()=>{let r=Ea(a);return r?[r]:$a(a)})();for(let r of i){let o=`${r.layer}:${r.name}:${r.capability}`;t.has(o)||(t.add(o),n.push(r))}}return n}function to(){return{version:vt.version,capabilities:[...vt.capabilities],legacy_aliases:{...vt.legacy_aliases}}}function Br(e){let t=b(e.name),n=b(e.directory);return t.startsWith("builtin-")?!0:n==="beads"||n==="todos"}function no(e,t,n,a,i){if(e!=="project"||i)return{warnings:[],summary:{active_project_count:0,loaded_project_count:0,active_project_names:[],loaded_project_names:[],missing_active_project_names:[]}};let r=[...new Set(t.filter(c=>c.active).map(c=>b(c.name)))].sort((c,l)=>c.localeCompare(l)),o=[...new Set(n.filter(c=>c.layer==="project").map(c=>b(c.name)))].sort((c,l)=>c.localeCompare(l)),s=new Set(a.map(c=>b(c.name))),d=r.filter(c=>!o.includes(c)&&!s.has(c)).sort((c,l)=>c.localeCompare(l));return{warnings:d.length>0?[`extension_doctor_consistency_active_not_loaded:${d.join(",")}`]:[],summary:{active_project_count:r.length,loaded_project_count:o.length,active_project_names:r,loaded_project_names:o,missing_active_project_names:d}}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="eb830963-f036-5f98-ab26-786240b3e0fd")}catch{}})();var Jn=async(e,t,n)=>{if(!Number.isInteger(t)||t<1)throw new RangeError("concurrency must be a positive integer");let a=new Array(e.length),i=0,r=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,a[o]=await n(e[o])}});return await Promise.all(r),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]="accde468-de04-51b6-81ad-5c5ea218a87b")}catch{}})();function ao(e,t){let n=b(e),a=t.find(i=>b(i.name)===n);return{command_paths:[...a?.command_paths??[]].sort((i,r)=>i.localeCompare(r)),action_paths:[...a?.action_paths??[]].sort((i,r)=>i.localeCompare(r))}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="f2cac210-bba0-5c7f-867b-8b59f8d36e11")}catch{}})();function io(e,t){let n=new Set((t?.loaded??[]).flatMap(r=>(r.activation?.commands?.length??0)>0?[`${r.layer}:${b(r.name)}`]:[])),a=e.services.overrides.filter(r=>r.service==="output_format").filter(r=>r.passThrough!==!0).filter(r=>!n.has(`${r.layer}:${b(r.name)}`)).map(r=>`extension_output_service_override_global:${r.service}:${r.layer}:${r.name}`),i=e.renderers.overrides.filter(r=>(r.commands?.length??0)===0&&r.resultDiscriminator===void 0).map(r=>`extension_output_renderer_override_global:${r.format}:${r.layer}:${r.name}`);return[...new Set([...a,...i])].sort((r,o)=>r.localeCompare(o))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="a1803149-25ca-5bb0-a178-afa2d85d2ec9")}catch{}})();var ro=e=>[...e.registrations.item_fields.flatMap(t=>t.fields.map(n=>({layer:t.layer,extension:t.name,field:n.name}))),...e.registrations.profiles.flatMap(t=>t.profile.fields.map(n=>({layer:t.layer,extension:t.name,field:n.key??""})))].flatMap(t=>{let n=Tt(t.field);return n?[`extension_custom_field_mcp_input_collision:${t.layer}:${t.extension}:${n.field}:${n.property}:${n.owner}:use=${n.nested_path}`]:[]}).filter((t,n,a)=>a.indexOf(t)===n).sort((t,n)=>t.localeCompare(n));import{execFile as Ql}from"node:child_process";import{promisify as ep}from"node:util";import tp from"npm-package-arg";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="b67e46f9-51ff-501b-98da-74353b4c66d9")}catch{}})();var np=ep(Ql),so=1e4;function oo(e,t,n){if(typeof t=="string")try{let a=tp.resolve(e,t);if(a.type==="version")return a.fetchSpec}catch{}throw new Error(n)}async function ap(e,t){try{return(await np(Pn(),e,{encoding:"utf8",timeout:t,maxBuffer:65536,shell:Rn(),env:{...process.env,npm_config_ignore_scripts:"true"}})).stdout.trim()}catch{throw new Error("npm_registry_lookup_failed")}}async function co(e,t=ap){let n=A();try{if(e.kind!=="npm"||!e.package||!/^(?:@[a-zA-Z0-9._-]+\/)?[a-zA-Z0-9._-]+$/u.test(e.package))throw new Error("missing_or_invalid_npm_package_identity");let a=oo(e.package,e.version,"missing_or_invalid_installed_npm_version"),i=await t(["view",e.package,"dist-tags.latest","--json","--ignore-scripts"],so),r;try{r=JSON.parse(i)}catch{throw new Error("invalid_npm_registry_metadata")}let o=Array.isArray(r)&&r.length===1?r[0]:r,s=oo(e.package,o,"invalid_npm_registry_version");return{checked_at:n,available:s!==a,remote_version:s}}catch(a){return{checked_at:n,available:null,error:a instanceof Error?a.message:String(a)}}}var ip=(e,t,n)=>{let a=e.split(/\r?\n/).map(o=>o.trim()).filter(Boolean).map(o=>{let[s,d=""]=o.split(/\s+/);return{commit:s,ref:d}}),i=a.find(o=>o.ref.endsWith("^{}"))??a[0];if(!i)return{checked_at:n,available:null,error:"no_remote_reference_found"};let r=t?.trim();return r?{checked_at:n,remote_commit:i.commit,available:i.commit!==r}:{checked_at:n,remote_commit:i.commit,available:null,error:"missing_installed_commit"}},qn=async(e,t=Ft)=>{let n=A();if(e.kind!=="github"||!e.repository)return{checked_at:n,available:null,error:"not_a_github_managed_source"};try{let a=[e.ref?.trim(),"HEAD"].find(Boolean),i=await t(["ls-remote",e.repository,a,`${a}^{}`],void 0,so);return ip(i,e.commit,n)}catch(a){return{checked_at:n,available:null,error:a instanceof Error?a.message:String(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]="d34e2cc0-5e58-5534-8480-a9ab47ec4a88")}catch{}})();var rp=4;async function lo(e,t=!1){let n=await Jn(e.entries,rp,async a=>{if(!["github","npm"].includes(a.source.kind))return a;if(t)return{...a,last_update_check_at:void 0,last_update_remote_commit:void 0,last_update_remote_version:void 0,update_available:null,update_error:void 0};let i=a.source.kind==="github"?await qn(a.source):await co(a.source);return{...a,last_update_check_at:i.checked_at,last_update_remote_commit:"remote_commit"in i?i.remote_commit:void 0,last_update_remote_version:"remote_version"in i?i.remote_version:void 0,update_available:i.available,update_error:i.error}});return{...e,entries:rt(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]="fcf7df06-e3b8-5476-a76a-cd391839c13d")}catch{}})();function po(e,t){let n=e.filter(a=>a.result.ok).length;return{installed_all:!t&&n===e.length,installed_count:t?0:n,...t?{dry_run:!0,planned_count:n}:{},failed_count:e.length-n,packages:e.map(({alias:a,result:i})=>{let r=i.details;return{alias:a,ok:i.ok,extension:r.extension,source:r.source,source_resolution:r.source_resolution,install_plan:r.install_plan,dry_run:r.dry_run,destination_path:r.destination_path,activated:r.activated,settings_changed:r.settings_changed,command_paths:r.command_paths,action_paths:r.action_paths,command_discovery:r.command_discovery,verification:r.verification,runtime_activation_status:r.runtime_activation_status,activation_diagnostics:r.activation_diagnostics,warnings:i.warnings}})}}import op from"node:fs/promises";import sp 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]="955d33c5-8c96-5ed6-bbd1-fc8a26801df4")}catch{}})();function cp(e){return typeof e.name=="string"&&e.name.trim().length>0?e.name.trim():"workspace-manifest"}function dp(e,t){return t.code==="manifest_unknown_key"?`extension_manifest_unknown_key:author:${e}:key=${t.path}${t.suggested_key?`:suggested=${t.suggested_key}`:""}`:`extension_manifest_no_version_bounds:author:${e}:suggested=pm_min_version`}async function lp(e){let t=sp.join(e,"manifest.json"),n;try{n=await op.readFile(t,"utf8")}catch(s){if(bt(s))return{path:t,present:!1,parse_status:"absent",package_metadata_location:"package.json#pm",schema_findings:[],warnings:[],remediation:[]};throw s}let a;try{a=JSON.parse(n)}catch{return{path:t,present:!0,parse_status:"invalid_json",package_metadata_location:"package.json#pm",schema_findings:[],warnings:["extension_author_manifest_invalid_json:manifest.json"],remediation:["Repair manifest.json so it contains one valid JSON object, then rerun pm package doctor --project."]}}if(typeof a!="object"||a===null||Array.isArray(a))return{path:t,present:!0,parse_status:"invalid_shape",package_metadata_location:"package.json#pm",schema_findings:[],warnings:["extension_author_manifest_invalid_shape:manifest.json"],remediation:["Replace manifest.json with one JSON object, then rerun pm package doctor --project."]};let i=a,r=Aa(i),o=cp(i);return{path:t,present:!0,parse_status:"valid",package_metadata_location:"package.json#pm",schema_findings:r.findings,warnings:r.findings.map(s=>dp(o,s)),remediation:r.findings.map(s=>s.message)}}function mo(e){return lp(fa(e))}import Le from"node:fs/promises";import pp 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]="776854e4-6df4-507e-b21b-a4d320946642")}catch{}})();var Wn=async e=>Le.readFile(e).catch(t=>{if(Gt(t,"ENOENT"))return null;throw t}),uo=async(e,t,n,a,i)=>Te("extension_install_backup",async()=>{let r=it(e),o=ga(t),[s,d]=await Promise.all([Wn(r),Wn(o)]);return a&&await Le.cp(n,i,{recursive:!0,force:!0}),{backupDirectory:i,destinationDirectory:n,destinationExists:a,managedStatePath:r,managedStateContents:s,settingsPath:o,settingsContents:d}}),fo=async e=>Te("extension_install_rollback",async()=>{await Le.rm(e.destinationDirectory,{recursive:!0,force:!0}),e.destinationExists&&await Le.cp(e.backupDirectory,e.destinationDirectory,{recursive:!0,force:!0});for(let[t,n]of[[e.managedStatePath,e.managedStateContents],[e.settingsPath,e.settingsContents]])n===null?await Le.rm(t,{force:!0}):(await Le.mkdir(pp.dirname(t),{recursive:!0}),await Le.writeFile(t,n))});(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="549164da-d760-52bc-9950-25dacf286775")}catch{}})();var _o=[["install","install","--install"],["uninstall","uninstall","--uninstall"],["explore","explore","--explore"],["list","explore","--explore"],["manage","manage","--manage"],["describe","describe","--describe"],["reload","reload","--reload"],["doctor","doctor","--doctor"],["catalog","catalog","--catalog"],["init","init","--init"],["scaffold","init","--scaffold"],["adopt","adopt","--adopt"],["adopt-all","adopt-all","--adopt-all"],["activate","activate","--activate"],["deactivate","deactivate","--deactivate"],["migrate","migrate","--migrate"]],mp=_o.map(([,,e])=>e).filter((e,t,n)=>n.indexOf(e)===t).join(", "),up={install:"--install",uninstall:"--uninstall",explore:"--explore",manage:"--manage",describe:"--describe",reload:"--reload",doctor:"--doctor",catalog:"--catalog",adopt:"--adopt","adopt-all":"--adopt-all",activate:"--activate",deactivate:"--deactivate",migrate:"--migrate",init:"--init"},fp="__pm_native_output",hp=["trusted_extensions","allowed_extensions","blocked_extensions","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],wo=["allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],gp=["disabled","require_trusted","require_provenance"],vo={mode:"off",trust_mode:"off",require_provenance:!1,trusted_extensions:[],default_sandbox_profile:"none",allowed_extensions:[],blocked_extensions:[],allowed_capabilities:[],blocked_capabilities:[],allowed_surfaces:[],blocked_surfaces:[],allowed_commands:[],blocked_commands:[],allowed_actions:[],blocked_actions:[],allowed_services:[],blocked_services:[],extension_overrides:[]},yp=e=>{let t=e??vo,n={};for(let a of hp)n[a]=Z(t[a]??[]);return n},_p=(e,t)=>{for(let n of wo)t[n].length>0&&(e[n]=t[n]);return e},wp=(e,t)=>{for(let n of gp)t[n]===!0&&(e[n]=!0);return t.sandbox_profile&&(e.sandbox_profile=t.sandbox_profile),e},vp=e=>{let t={};for(let n of wo)t[n]=Z(e[n]??[]);return t},bp=e=>{let t=typeof e.name=="string"?e.name.trim():"";return t.length===0?null:_p(wp({name:t},e),vp(e))},kp=e=>(e??[]).map(t=>bp(t)).filter(t=>t!==null).sort((t,n)=>t.name.localeCompare(n.name)),xp=e=>{let t=Object.assign({},vo,e??{}),n=yp(e),a=kp(t.extension_overrides);return{mode:t.mode,trust_mode:t.trust_mode,require_provenance:t.require_provenance===!0,trusted_extensions:n.trusted_extensions,default_sandbox_profile:t.default_sandbox_profile,allowed_extensions:n.allowed_extensions,blocked_extensions:n.blocked_extensions,allowed_capabilities:n.allowed_capabilities,blocked_capabilities:n.blocked_capabilities,allowed_surfaces:n.allowed_surfaces,blocked_surfaces:n.blocked_surfaces,allowed_commands:n.allowed_commands,blocked_commands:n.blocked_commands,allowed_actions:n.allowed_actions,blocked_actions:n.blocked_actions,allowed_services:n.allowed_services,blocked_services:n.blocked_services,extension_overrides:a}},bo=async(e,t)=>{let n=[t],a=await Ki(t);a&&n.push(a);let i=[...new Set(n.map(r=>b(r)).filter(r=>r.length>0))];for(let r of i){let o=e.find(d=>b(d.name)===r);if(o)return o;let s=e.find(d=>b(d.directory)===r);if(s)return s}},ko=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled));return new Set(Z(e.extensions.disabled)).has(n)?!1:a.size===0?!0:a.has(n)},xo=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return i.delete(n),a.size>0&&a.add(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},Sp=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return a.delete(n),i.add(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},Ep=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return a.delete(n),i.delete(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},$p=e=>{let t=e.trim().toLowerCase(),n=Math.min(2,Math.max(1,Math.ceil(t.length/4))),a=_o.map(([i,r,o])=>({action:r,flag:o,distance:Sa(t,i,n)})).filter(i=>i.distance!==null).sort((i,r)=>i.distance-r.distance)[0];return a?{action:a.action,flag:a.flag}:null},Ip=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",a=$p(e);if(!a)return new f(`One action flag is required. Use one of: ${mp}. Bare \`pm package\` and \`pm extension\` default to --explore.`,h.USAGE);let i=`pm ${n} ${a.flag}`;return Wa({command_path:n,display_name:`${n} lifecycle`,token_kind:"action",token:e,allowed:Object.keys(So),retry_command:i,message_suffix:`. Did you mean "${a.flag}"?`,fallback_candidates:[{source:"lifecycle_action",command:i,reason:`nearest lifecycle action for "${e}"`}]})},Ap=[["install","install"],["uninstall","uninstall"],["explore","explore"],["manage","manage"],["describe","describe"],["reload","reload"],["doctor","doctor"],["catalog","catalog"],["init","init"],["scaffold","init"],["adopt","adopt"],["adoptAll","adopt-all"],["activate","activate"],["deactivate","deactivate"],["migrate","migrate"]],So={doctor:"doctor",reload:"reload",catalog:"catalog",init:"init",scaffold:"init",explore:"explore",manage:"manage",migrate:"migrate",list:"explore","":"explore"},Tp=e=>So[e]??null,Op=(e,t)=>{let n=[...new Set(Ap.filter(([a])=>t[a]===!0).map(([,a])=>a))];if(n.length===0){if(e===void 0)return"explore";let a=Tp(e.trim().toLowerCase());if(a)return a;throw Ip(e,t)}if(n.length>1)throw new f("Extension action flags are mutually exclusive.",h.USAGE);return n[0]},Cp=e=>{let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new f('Options "--project/--local" and "--global" are mutually exclusive.',h.USAGE);return n?"global":"project"},Pp=[e=>e?null:{status:"skipped_unmanaged",reason:"extension_not_managed"},e=>e&&!["github","npm"].includes(e.source.kind)?{status:"skipped_non_github",reason:`managed_source_kind_${e.source.kind}`}:null,e=>{let t=typeof e?.update_error=="string"?e.update_error.trim():"";return t.length>0?{status:"failed",reason:t}:null},e=>{let t=e;return(typeof t.last_update_check_at=="string"?t.last_update_check_at.trim():"").length===0?null:{status:"checked",reason:{true:"update_available",false:"up_to_date"}[String(t.update_available)]??"checked_without_commit_baseline"}}],Eo=e=>{for(let t of Pp){let n=t(e);if(n)return n}return{status:"not_checked",reason:"no_update_check_recorded"}},$o=(e,t,n,a)=>{let i=n??{};return{name:e.name,directory:e.directory,version:e.version,entry:e.entry,scope:t,active:e.enabled,enabled:e.enabled,runtime_active:null,activation_status:"unknown",contributions:i.contributions,managed:!!n,source:i.source,update_available:i.update_available,last_update_check_at:i.last_update_check_at,last_update_remote_commit:i.last_update_remote_commit,last_update_remote_version:i.last_update_remote_version,update_error:i.update_error,update_check_status:a.status,update_check_reason:a.reason}},Rp=(e,t,n,a)=>{let i=Object.assign({name:e,manifest_version:"unknown",manifest_entry:"unknown"},a),r=a?ko(n,a.name):!1;return{warning:`extension_manifest_missing:${t}:${e}`,summary:$o({name:i.name,directory:e,version:i.manifest_version,entry:i.manifest_entry,enabled:r},t,a,Eo(a))}},Np=async(e,t,n,a,i,r)=>{let o=Q.join(e,t),s=Q.join(o,"manifest.json"),d=r.get(b(t));if(!await k(s))return Rp(t,n,a,d);let c=Symbol("invalid-extension-manifest-json"),l=await Ie.readFile(s,"utf8").then(y=>JSON.parse(y)).catch(()=>c);if(l===c)return{warning:`extension_manifest_invalid_json:${n}:${t}`};let p=Sn(l);if(!p)return{warning:`extension_manifest_invalid:${n}:${t}`};let m=i.get(b(p.name))??r.get(b(t));return{summary:$o({name:p.name,directory:t,version:p.version,entry:p.entry,enabled:ko(a,p.name)},n,m,Eo(m))}},de=async(e,t,n,a)=>{if(!await k(e))return{extensions:[],warnings:[]};let i=(await Ie.readdir(e,{withFileTypes:!0})).filter(c=>c.isDirectory()).map(c=>c.name).sort((c,l)=>c.localeCompare(l)),r=new Map(a.entries.map(c=>[b(c.name),c])),o=new Map(a.entries.map(c=>[b(c.directory),c])),s=[],d=[];for(let c of i){let l=await Np(e,c,t,n,r,o);l.warning&&s.push(l.warning),l.summary&&d.push(l.summary)}return{extensions:d.sort((c,l)=>c.name.localeCompare(l.name)),warnings:s.sort((c,l)=>c.localeCompare(l))}},Dp=Oa(),jp=(e,t)=>[t.package,t.kind==="builtin"?t.name:void 0].find(n=>n?.trim())?.trim()??e,Lp=(e,t,n,a)=>{let i=n.command_paths.map(s=>`pm ${s} --help`),r=a?.error.toLowerCase().includes("@unbrained/pm-cli")===!0,o=n.command_paths.length>0?[...i]:["Run pm package doctor --project --detail deep if expected package commands are missing."];return r&&o.unshift("Install @unbrained/pm-cli in the target workspace so declarative package runtime imports resolve, then reinstall the package."),{package_name:jp(e,t),extension_name:e,command_paths:n.command_paths,action_paths:n.action_paths,help_commands:i,next_steps:o,...r?{sdk_dependency_status:"missing"}:{}}},Fp=e=>{let t=e.trace,n={layer:e.layer,name:e.name,entry_path:e.entry_path,error:e.error};return t&&(n.trace=Object.fromEntries(Object.entries(t).filter(([,a])=>a!==void 0)),t.missing_capability&&(n.missing_capability=t.missing_capability),t.hint&&(n.hint=t.hint)),n},Io=e=>e.map(t=>Fp(t)).sort((t,n)=>`${t.layer}:${t.name}`.localeCompare(`${n.layer}:${n.name}`)),Ao=(e,t,n)=>{let a=b(e);return t.find(i=>(n===void 0||i.layer===n)&&b(i.name)===a)},Mp=(e,t,n,a)=>n.find(i=>i.scope===t&&b(i.name)===b(e))?.activation_status??(a?"failed":"unknown"),To=(e,t,n,a,i)=>Dp.enqueue(async()=>{let r=process.env.PM_CLI_PACKAGE_ROOT,o=await Ie.mkdtemp(Q.join(t,".pm-module-graph-"));process.env.PM_CLI_PACKAGE_ROOT=ye(import.meta.url,["../.."]);try{let s=await _e({pmRoot:e,settings:n,cwd:process.cwd(),noExtensions:i.noExtensions===!0,reload_token:ln(),cache_bust:!0,module_graph_snapshot_root:o}),d=await we({...s}),c=[...s.failed.map(p=>({layer:p.layer,name:p.name,entry_path:p.entry_path,error:p.error})),...Io(d.failed)],l=Object.fromEntries(s.loaded.map(p=>[b(p.name),xa(Ge(d,{extensionName:p.name}))]));return{installed:Vt(a,s,d),warnings:[...s.warnings,...d.warnings],activation_failures:c,extensions_disabled:s.disabled_by_flag,item_type_registrations:d.registrations.item_types,contribution_inventories:l}}finally{await Ie.rm(o,{recursive:!0,force:!0}),r===void 0?delete process.env.PM_CLI_PACKAGE_ROOT:process.env.PM_CLI_PACKAGE_ROOT=r}}),Hn=async(e,t,n,a)=>{let i=n.filter(d=>!d.managed),r=[...i].sort((d,c)=>{let l=d.name.localeCompare(c.name);return l!==0?l:d.directory.localeCompare(c.directory)}),o=a,s=[];for(let d of r){let c=Q.join(e,d.directory),l=await Ye(c),p=A(),m={kind:"local",input:d.name,location:c};o=ot(o,{name:l.manifest.name,directory:d.directory,scope:t,manifest_version:l.manifest.version,manifest_entry:l.manifest.entry,capabilities:[...l.manifest.capabilities],contributions:l.manifest.contributions,installed_at:p,updated_at:p,source:m}),s.push({name:l.manifest.name,directory:d.directory,version:l.manifest.version,entry:l.manifest.entry,source:m})}return s.length>0&&await Xe(e,o),{state:o,adopted_entries:s,unmanaged_candidates:r,already_managed_count:n.length-i.length}},Up=(e,t)=>{let n=F(process.cwd(),t.path),a=St(n,process.cwd()),i=e==="global"?ha(process.cwd()):n,r=e==="global"?a.global:a.project;return{pm_root:n,scope:e,settings_root:i,selected_root:r,roots:a}},Xt=e=>{let t=[e.gh,e.github].filter(a=>typeof a=="string").map(a=>a.trim()).filter(Boolean),n=[...new Set(t)];if(n.length>1)throw new f('Options "--gh" and "--github" must match when both are provided.',h.USAGE);return n[0]},zp=e=>up[e],Gp=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",a=e==="install"?"source":"name",i=`${n} ${a}`,r=zp(e),o=`<${a}>`,s=`pm ${n} ${r} ${o}`;throw new f(`Action "${e}" requires ${i} input.`,h.USAGE,{code:"missing_lifecycle_target",required:`Provide a ${a} target for ${e}.`,examples:[`pm ${n} ${e} ${o}`,s,`pm ${n} --help`],recovery:{attempted_command:`pm ${n} ${e}`,suggested_retry:s,fallback_candidates:[{source:"lifecycle_action",command:s,reason:`flag-form ${e} command with required ${a} target`}]}})},Zt=(e,t,n={})=>{let a=e?.trim();if(a)return a;if(t==="init")throw new f('Action "init" requires a scaffold target path (for example: pm package init ./my-package or pm extension init ./my-extension).',h.USAGE);return Gp(t,n)},Jp=(e,t)=>{let n=new Set([...t.registrations.item_types.map(a=>({entry:a,count:a.types.length})),...t.registrations.item_fields.map(a=>({entry:a,count:a.fields.length}))].filter(({count:a})=>a>0).map(({entry:a})=>`${a.layer}:${b(a.name)}`));return e.loaded.filter(a=>(a.activation?.commands??[]).length>0).filter(a=>n.has(`${a.layer}:${b(a.name)}`)).map(a=>`extension_schema_narrow_activation:${a.layer}:${a.name}`).filter((a,i,r)=>r.indexOf(a)===i).sort((a,i)=>a.localeCompare(i))},qp=(e,t)=>{let n=[{triggered:t.strictExit===!0||t.failOnWarn===!0,allowed:e==="doctor",message:"--strict-exit and --fail-on-warn are only valid with --doctor."},{triggered:t.trace===!0,allowed:e==="doctor",message:"--trace is only valid with --doctor."},{triggered:t.watch===!0,allowed:e==="reload",message:"--watch is only valid with --reload."},{triggered:t.runtimeProbe===!0,allowed:e==="manage",message:"--runtime-probe is only valid with --manage."},{triggered:t.fixManagedState===!0,allowed:e==="manage"||e==="doctor",message:"--fix-managed-state is only valid with --manage or --doctor."},{triggered:t.isolated===!0||t.ignoreGlobal===!0,allowed:e==="doctor",message:"--isolated and --ignore-global are only valid with --doctor."},{triggered:t.capability!==void 0,allowed:e==="init",message:"--capability is only valid with --init/--scaffold."},{triggered:t.declarative===!0,allowed:e==="init",message:"--declarative is only valid with --init/--scaffold."},{triggered:t.dryRun===!0,allowed:e==="migrate"||e==="install",message:"--dry-run is only valid with --migrate or --install."}].find(a=>a.triggered&&!a.allowed);if(n)throw new f(n.message,h.USAGE)},Wp=(e,t,n)=>{let a=String(e??"").trim().toLowerCase(),i=[n.init,n.scaffold].includes(!0);return({doctor:["doctor"],reload:["reload"],catalog:["catalog"],init:i?[]:["init","scaffold"]}[t]??[]).includes(a)?void 0:e},Bp=e=>[e.action==="catalog",typeof e.options.fields=="string",String(e.options.fields).trim().length>0].every(Boolean)?{project:"project",global:"global",selected:e.scope,settings_root:"project"}:{project:e.resolvedRoots.roots.project,global:e.resolvedRoots.roots.global,selected:e.resolvedRoots.selected_root,settings_root:e.resolvedRoots.settings_root},Hp=(e,t,n)=>{let a={ok:n,action:e.action,scope:e.scope,roots:Bp(e),warnings:[...new Set(e.warnings)].sort((i,r)=>i.localeCompare(r)),details:t};return e.action==="doctor"&&Object.defineProperty(a,fp,{value:!0,enumerable:!1,configurable:!1}),a},Kn=async(e,t,n)=>{let a=Op(e,t);qp(a,t);let i=Wp(e,a,t),r=Cp(t),o=Up(r,n),s={action:a,normalizedTarget:i,scope:r,resolvedRoots:o,warnings:[],options:t,global:n},d={...s,withResult:(c,l=!0)=>Hp(s,c,l)};return await $m(d)},Kp=(e,t)=>{let n=t.vocabulary??"extension",a=e.target_path.replace(/\\/g,"/"),i=Ra(a),r={package:`Install dependencies: cd ${i}, then run "npm install"`,extension:`Install type-check dependencies: cd ${i}, then run "npm install -D typescript @types/node @unbrained/pm-cli"`},o={package:`Validate the package: cd ${i}, then run "npm run typecheck" and "npm test"`,extension:`Type-check the source (optional): cd ${i}, then run "npx tsc --noEmit"`},s=[];return[n==="package",t.declarative===!0].every(Boolean)&&s.push("Ensure the target workspace can resolve @unbrained/pm-cli before installing this declarative package."),[r[n],...s,`Install the scaffold: ${Qe(n==="package"?["install","--project",a]:["extension","--install","--project",a])}`,`Smoke-test command path: pm ${e.command_name}`,o[n],`Run diagnostics: ${n==="package"?"pm package doctor":"pm extension --doctor"} --project --detail summary`]},Vp=async e=>{let{action:t,normalizedTarget:n,options:a,withResult:i}=e;if([Xt(a),a.ref].filter(s=>typeof s=="string").map(s=>s.trim()).filter(Boolean).length>0)throw new f('Action "init" does not accept --gh/--github/--ref options.',h.USAGE);let r=Zt(n,t,a),o=await gr(r,a.vocabulary??"extension",a.capability,a.declarative===!0);return i({scaffolded:o.created_directory||o.files.some(s=>s.status==="created"),extension:{name:o.extension_name,command:o.command_name},capability:o.capability,style:o.style,target_path:o.target_path,created_directory:o.created_directory,files:o.files,next_steps:Kp(o,a)})},Yp=async e=>{let{normalizedTarget:t,resolvedRoots:n,warnings:a,options:i,global:r,withResult:o}=e;if(t!==void 0)throw new f('Action "reload" does not accept a target argument.',h.USAGE);let s=await C(n.settings_root),d=ln(),c=await _e({pmRoot:n.settings_root,settings:s,cwd:process.cwd(),noExtensions:r.noExtensions,reload_token:d,cache_bust:!0});a.push(...c.warnings);let l=await we(c);a.push(...l.warnings);let p={reload:{token:d,cache_bust:!0,watch:i.watch===!0},loaded_count:c.loaded.length,failed_count:c.failed.length,activated_count:Math.max(0,c.loaded.length-l.failed.length),activation_failed_count:l.failed.length,loaded_extensions:c.loaded.map(m=>({name:m.name,layer:m.layer,version:m.version})),failed_extensions:c.failed.map(m=>({name:m.name,layer:m.layer,error:m.error})),activation_failures:l.failed.map(m=>({name:m.name,layer:m.layer,error:m.error}))};return i.watch===!0&&a.push("extension_reload_watch_hint:watch_mode_requested_non_interactive_single_pass_only"),o(p)},Xp=async e=>{let{normalizedTarget:t,scope:n,options:a,global:i,withResult:r}=e;if(typeof t=="string"&&t.length>0&&t!=="catalog")throw new f('Action "catalog" does not accept a package target.',h.USAGE);return r(await Vi(n,i,a))},Zp=(e,t)=>({kind:"builtin",input:e,location:e,name:e,...t===null?{}:{package:t}}),Qp=e=>({kind:"local",input:e.input,location:e.absolute_path}),em=(e,t)=>({kind:"npm",input:e.input,location:t.resolved_subpath??".",package:t.npm_package,version:t.npm_version}),tm=(e,t)=>({kind:"github",input:e.input,location:t.resolved_subpath??e.subpath??".",repository:e.repository,owner:e.owner,repo:e.repo,ref:e.ref,subpath:t.resolved_subpath??e.subpath,commit:t.commit}),nm=(e,t,n,a)=>e?Zp(e,t):n.kind==="local"?Qp(n):n.kind==="npm"?em(n,a):tm(n,a),am=(e,t,n,a)=>e?e.manifest_version!==t?{installed_at:e.installed_at,updated_at:a}:Gi(e.source,n)?{installed_at:e.installed_at,updated_at:e.updated_at}:{installed_at:e.installed_at,updated_at:a}:{installed_at:a,updated_at:a},im=async(e,t)=>{let{scope:n,resolvedRoots:a,warnings:i}=e,{validated:r,destinationDirectoryName:o}=t,s=await C(a.settings_root),d=await se(a.selected_root);i.push(...d.warnings);let c=Q.join(a.selected_root,o),l=await k(c),p=await zt(r.directory,c);await Ie.mkdir(a.selected_root,{recursive:!0});let m=await Ie.mkdtemp(Q.join(a.selected_root,".pm-extension-install-backup-")),y=Q.join(m,"destination");try{let g=await uo(a.selected_root,a.settings_root,c,l,y),_=nm(t.bundledAliasName,t.bundledPackageName,t.installSource,t.resolvedSource),u=d.state.entries.find(x=>b(x.name)===b(r.manifest.name)),w=am(u,r.manifest.version,_,A()),v=ot(d.state,{name:r.manifest.name,directory:o,scope:n,manifest_version:r.manifest.version,manifest_entry:r.manifest.entry,capabilities:[...r.manifest.capabilities],contributions:r.manifest.contributions,...w,source:_}),S=xo(s,r.manifest.name);try{p||await Or(r.directory,c),await Ir(c),await Ar(c),await Xe(a.selected_root,v),S&&await ve(a.settings_root,s,"settings:write")}catch(x){try{await fo(g)}catch(T){throw new AggregateError([x,T],`Extension install failed: ${String(x)}; rollback failed: ${String(T)}`,{cause:T})}throw x}return{settings:s,managedState:v,sourceRecord:_,destinationDirectory:c,destinationExists:l,installInPlace:p,activationChanged:S}}finally{await Ie.rm(m,{recursive:!0,force:!0}).catch(()=>{})}},rm=async(e,t,n)=>{let a=n.filter(i=>b(i.name)===b(t)).flatMap(i=>i.types.map(r=>({name:r.name,folder:r.folder})));return e.scope==="project"&&a.length>0&&await ht(e.resolvedRoots.pm_root,a,e.warnings,"install:type-folder"),a},om=(e,t,n,a,i)=>{let r=Ao(t,n.activation_failures,e.scope),o=Mp(t,e.scope,n.installed,r),s=[!n.extensions_disabled,o==="ok"].every(Boolean);s||e.warnings.push(`extension_install_activation_failed:${e.scope}:${t}:${o}`);let d={true:{status:"ok",blocking_failure_count:0},false:{status:"degraded",blocking_failure_count:1}};return{activated:s,status:o,failure:r,verification:{status:d[String(s)].status,target_pm_root:e.resolvedRoots.pm_root,activation_status:o,activated:s,registered_commands:a.command_paths,registered_actions:a.action_paths,registered_item_types:i,module_graph_verification:"fresh_in_topology_snapshot",health:d[String(s)]}}},sm=async(e,t)=>{let{scope:n,resolvedRoots:a,warnings:i,global:r,withResult:o}=e,{validated:s,destinationDirectoryName:d}=t,c=await im(e,t),l=await de(a.selected_root,n,c.settings,c.managedState);i.push(...l.warnings);let p=await To(a.pm_root,Q.dirname(a.selected_root),c.settings,l.extensions,r);i.push(...p.warnings);let m=await rm(e,s.manifest.name,p.item_type_registrations),y=ao(s.manifest.name,p.installed),g=om(e,s.manifest.name,p,y,m),_=p.contribution_inventories[b(s.manifest.name)];return _&&(c.managedState=await Ji(a.selected_root,c.managedState,s.manifest.name,_)),o({extension:{name:s.manifest.name,version:s.manifest.version,entry:s.manifest.entry,capabilities:s.manifest.capabilities,directory:d},source:c.sourceRecord,source_resolution:t.sourceResolution,...t.installPlan?{install_plan:t.installPlan}:{},destination_path:c.destinationDirectory,overwritten:[c.destinationExists,!c.installInPlace].every(Boolean),installed_in_place:c.installInPlace,activated:g.activated,settings_changed:c.activationChanged,runtime_activation_status:g.status,command_paths:y.command_paths,action_paths:y.action_paths,contributions:_,command_discovery:Lp(s.manifest.name,c.sourceRecord,y,g.failure),verification:g.verification,activation_diagnostics:{failed_count:p.activation_failures.length,failed:p.activation_failures,installed_extension_failed:g.failure??null}},g.activated)},cm=async e=>{let{options:t,global:n,warnings:a,withResult:i}=e;if(typeof t.ref=="string"&&t.ref.trim().length>0)throw new f('Action "install all" does not accept --ref.',h.USAGE);let r=[],o=new Map;for(let s of await Lt()){let d=await st(s),c=Q.resolve(d),l=o.get(c);l===void 0&&(l=await Kn(s,{...t,install:!0},n),o.set(c,l)),r.push({alias:s,result:l})}return a.push(...r.flatMap(s=>s.result.warnings)),i(po(r,t.dryRun===!0),r.every(s=>s.result.ok))},dm=async(e,t,n)=>{let{resolvedRoots:a}=e,{bundledAliasName:i,bundledPackageName:r,installSource:o,sourceResolution:s}=await Nr(t,n,e.options.ref,(await se(a.selected_root)).state.entries);if(s.ambiguous){let c=s.candidates.find(l=>l.kind==="npm");e.warnings.push(`extension_install_source_ambiguous:${t}:builtin:${i}:npm:${c.package}`)}let d=await ir(o);try{let c=await Ye(d.directory,{source_kind:o.kind,source_input:o.input,source_root:d.source_root}),l=Dt(c.manifest.name),p=e.options.dryRun===!0||o.kind==="local"&&i===null?await Pr(d,Q.join(a.selected_root,l),e.scope,e.options.copyPlan):void 0;return e.options.dryRun===!0?e.withResult({dry_run:!0,installed:!1,activated:!1,extension:{name:c.manifest.name,version:c.manifest.version},source_resolution:s,install_plan:p}):await Mn(a.settings_root,l,()=>sm(e,{validated:c,destinationDirectoryName:l,bundledAliasName:i,bundledPackageName:r,sourceResolution:s,installSource:o,resolvedSource:d,installPlan:p}))}finally{d.cleanup&&await d.cleanup()}},lm=async e=>{let t=Xt(e.options),n=t??Zt(e.normalizedTarget,e.action,e.options);return[t===void 0,Wi(n)].every(Boolean)?cm(e):dm(e,n,t)},pm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,withResult:o}=e;if(t!==void 0)throw new f('Action "adopt-all" does not accept a target argument.',h.USAGE);if(Xt(r)!==void 0||typeof r.ref=="string"&&r.ref.trim().length>0)throw new f('Action "adopt-all" does not accept --gh/--github/--ref options.',h.USAGE);let s=await C(a.settings_root),d=await se(a.selected_root);i.push(...d.warnings);let c=await de(a.selected_root,n,s,d.state);i.push(...c.warnings);let l=await Hn(a.selected_root,n,c.extensions,d.state),p=await de(a.selected_root,n,s,l.state);i.push(...p.warnings);let m=Yt(n,i,p.extensions,r);i.push(...m.warnings);let y=new Map(p.extensions.map(u=>[`${b(u.name)}:${b(u.directory)}`,u])),g=new Map(p.extensions.map(u=>[b(u.directory),u])),_=l.adopted_entries.map(u=>{let w=b(u.directory),v=y.get(`${b(u.name)}:${w}`)??g.get(w);return{...u,...Oo(v)}});return o({adopted_all:_.length>0,adopted_count:_.length,already_managed_count:l.already_managed_count,extensions:_,triage:m,warning_codes:m.warning_codes,update_health_partial:m.update_health_partial,update_health_coverage:m.update_health_coverage})},Oo=e=>({update_check_status:e?.update_check_status??null,update_check_reason:e?.update_check_reason??null}),mm=(e,t,n,a)=>{if(e===void 0)return{kind:"local",input:t,location:n};let i=ct(e,{forceGithub:!0,ref:a});if(i.kind!=="github")throw new f(`Invalid GitHub shorthand "${e}".`,h.USAGE);return{kind:"github",input:i.input,location:i.subpath??".",repository:i.repository,owner:i.owner,repo:i.repo,ref:i.ref,subpath:i.subpath}},um=async e=>{let{action:t,normalizedTarget:n,scope:a,resolvedRoots:i,warnings:r,options:o,withResult:s}=e,d=Zt(n,t,o),c=Xt(o),l=await C(i.settings_root),p=await se(i.selected_root);r.push(...p.warnings);let m=await de(i.selected_root,a,l,p.state);r.push(...m.warnings);let y=await bo(m.extensions,d);if(!y)throw new f(`Installed extension "${d}" was not found in ${a} scope.`,h.NOT_FOUND);if(y.managed)return s({adopted:!1,already_managed:!0,extension:{name:y.name,directory:y.directory}});let g=Q.join(i.selected_root,y.directory),_=await Ye(g),u=A(),w=mm(c,d,g,o.ref),v=ot(p.state,{name:_.manifest.name,directory:y.directory,scope:a,manifest_version:_.manifest.version,manifest_entry:_.manifest.entry,capabilities:[..._.manifest.capabilities],contributions:_.manifest.contributions,installed_at:u,updated_at:u,source:w});await Xe(i.selected_root,v);let S=await de(i.selected_root,a,l,v);r.push(...S.warnings);let x=S.extensions.find(T=>b(T.name)===b(_.manifest.name))??S.extensions.find(T=>b(T.directory)===b(y.directory));return s({adopted:!0,extension:{name:_.manifest.name,directory:y.directory,version:_.manifest.version,entry:_.manifest.entry},source:w,...Oo(x)})},Co=async e=>{let{action:t,normalizedTarget:n,scope:a,resolvedRoots:i,warnings:r,options:o}=e,s=Zt(n,t,o),d=await C(i.settings_root),c=await se(i.selected_root);r.push(...c.warnings);let l=await de(i.selected_root,a,d,c.state);r.push(...l.warnings);let p=await bo(l.extensions,s);if(!p)throw new f(`Installed extension "${s}" was not found in ${a} scope.`,h.NOT_FOUND);return{settings:d,managedStateRead:c,candidate:p}},fm=async e=>{let{resolvedRoots:t,withResult:n}=e,{settings:a,managedStateRead:i,candidate:r}=await Co(e),o=Q.join(t.selected_root,r.directory);await Ie.rm(o,{recursive:!0,force:!0});let s={...i.state,updated_at:A(),entries:i.state.entries.filter(c=>b(c.name)!==b(r.name)&&b(c.directory)!==b(r.directory))};await Xe(t.selected_root,s);let d=Ep(a,r.name);return d&&await ve(t.settings_root,a,"settings:write"),n({removed:!0,extension:{name:r.name,directory:r.directory},destination_path:o,settings_changed:d})},ho=async e=>{let{action:t,resolvedRoots:n,warnings:a,global:i,withResult:r}=e,{settings:o,candidate:s}=await Co(e),d=t==="activate"?xo(o,s.name):Sp(o,s.name);d&&await ve(n.settings_root,o,"settings:write");let c=t==="activate"?await To(n.pm_root,Q.dirname(n.selected_root),o,[s],i).then(l=>(a.push(...l.warnings),Ao(s.name,l.activation_failures,e.scope))):void 0;return c&&a.push(`extension_activate_failed:${e.scope}:${s.name}`),r({extension:{name:s.name,directory:s.directory},active:t==="activate"&&c===void 0,runtime_active:t==="activate"&&c===void 0,activation_failure:c??null,settings_changed:d,settings:{enabled:[...o.extensions.enabled],disabled:[...o.extensions.disabled]}},c===void 0)},hm=(e,t,n,a,i,r)=>{let o=a==="package"?"package":"extension",s={package:"doctor",extension:"--doctor"}[o],d=i?.adopted_entries.length??0,c=[[r!==null,r??""],[t>0,`Run pm ${o} explore --project and pm ${o} explore --global to inspect load failures.`],[n>0,`Review activation failures in pm ${o} ${s} --detail deep output.`],[d>0,`Managed-state fix adopted ${d} extension(s).`]];return[...new Set([...e,...c.filter(([l])=>l).map(([,l])=>l)].map(l=>l.trim()).filter(l=>l.length>0))]},Bn=e=>e.loaded.some(t=>t.layer==="global")||e.failed.some(t=>t.layer==="global")||e.warnings.some(t=>t.includes(":global:")),gm=(e,t,n,a)=>{if(e!=="project"||t||!Bn(a))return null;let i=n==="package"?"package":"extension";return`Global ${i} registrations are included in project diagnostics. For hermetic ${i} smoke tests, rerun pm ${i} doctor --project --isolated --detail deep --trace, or set PM_GLOBAL_PATH to a temporary directory for the whole test process.`},ym=(e,t,n)=>{if(String(e??"").trim().length>0)throw new f('Action "doctor" does not accept a target argument.',h.USAGE);let a=[n.isolated,n.ignoreGlobal].includes(!0);if([a,t==="global"].every(Boolean))throw new f("--isolated and --ignore-global are only valid with project-scope doctor diagnostics.",h.USAGE);let i=Zr(n.detail),r=n.trace===!0;if([r,i!=="deep"].every(Boolean))throw new f("--trace requires --detail deep with --doctor.",h.USAGE);return{isolated:a,detailMode:i,includeTrace:r}},_m=async(e,t,n)=>{if(e.options.fixManagedState!==!0)return{state:n,fix:null};let a=await Hn(e.resolvedRoots.selected_root,e.scope,t,n);return{state:a.state,fix:a}},wm=(e,t,n,a)=>{let i=n==="package"?"package":"extension";if(e!=="project")return{isolated:t,global_extensions_included:!1,global_diagnostics_present:Bn(a),rerun_command:null,pm_global_path_recipe:null};let r=`pm ${i} doctor --project --isolated --detail deep --trace`;return{isolated:t,global_extensions_included:!t,global_diagnostics_present:Bn(a),rerun_command:t?null:r,pm_global_path_recipe:`PM_GLOBAL_PATH=$(mktemp -d) pm ${i} doctor --project --detail deep --trace`}},vm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,global:o,withResult:s}=e,{isolated:d,detailMode:c,includeTrace:l}=ym(t,n,r),p=await C(a.settings_root),m=await se(a.selected_root);i.push(...m.warnings);let y=await de(a.selected_root,n,p,m.state);i.push(...y.warnings);let{state:g,fix:_}=await _m(e,y.extensions,m.state),u=await de(a.selected_root,n,p,g);i.push(...u.warnings);let w=await _e({pmRoot:a.pm_root,settings:p,cwd:process.cwd(),noExtensions:o.noExtensions===!0,ignoreGlobalExtensions:d}),v=await we({...w,loaded:w.loaded}),S=await mo(a.pm_root);i.push(...S.warnings,...w.warnings),i.push(...Vr(w.failed)),i.push(...v.warnings),i.push(...Yr(v.failed)),i.push(...Xr(w,v)),i.push(...io(v,w)),i.push(...Jp(w,v)),i.push(...ro(v));let x=Vt(u.extensions,w,v),T=no(n,x,w.loaded.map(O=>({layer:O.layer,name:O.name})),w.failed.map(O=>({name:O.name})),w.disabled_by_flag);i.push(...T.warnings);let te=x.filter(O=>O.update_check_status==="failed").map(O=>`extension_update_check_failed:${O.name}`);i.push(...te);let D=Yt(n,i,x,r);i.push(...D.warnings);let E=[...D.warnings],z={mode:w.policy.mode,trust_mode:w.policy.trust_mode,require_provenance:w.policy.require_provenance,default_sandbox_profile:w.policy.default_sandbox_profile,sandbox_enforcement:"advisory: sandbox_profile/permissions are declaration-based load gates, not runtime isolation (ADR pm-6ef3)",trusted_extensions_count:w.policy.trusted_extensions.length,allowed_extensions_count:w.policy.allowed_extensions.length,blocked_extensions_count:w.policy.blocked_extensions.length,allowed_capabilities_count:w.policy.allowed_capabilities.length,blocked_capabilities_count:w.policy.blocked_capabilities.length,allowed_surfaces_count:w.policy.allowed_surfaces.length,blocked_surfaces_count:w.policy.blocked_surfaces.length,allowed_commands_count:w.policy.allowed_commands.length,blocked_commands_count:w.policy.blocked_commands.length,allowed_actions_count:w.policy.allowed_actions.length,blocked_actions_count:w.policy.blocked_actions.length,allowed_services_count:w.policy.allowed_services.length,blocked_services_count:w.policy.blocked_services.length,extension_override_count:w.policy.extension_overrides.length},Ze=eo(E),en=to(),ra=D.warning_codes,ps=gm(n,d,r.vocabulary,w),ms=hm(D.remediation,w.failed.length,v.failed.length,r.vocabulary,_,ps),oa=wm(n,d,r.vocabulary,w),us={status:D.status,scope:n,warning_count:D.warning_count,warning_codes:ra,total_extensions:x.length,managed_total:x.filter(O=>O.managed).length,enabled_total:x.filter(O=>O.enabled).length,active_total:x.filter(O=>O.active).length,unmanaged_loaded_extension_count:D.unmanaged_loaded_extension_count,unmanaged_action_required_extension_count:D.unmanaged_action_required_extension_count,unmanaged_expected_extension_count:D.unmanaged_expected_extension_count,runtime_active_total:x.filter(O=>O.runtime_active===!0).length,activation_status_totals:{ok:x.filter(O=>O.activation_status==="ok").length,failed:x.filter(O=>O.activation_status==="failed").length,not_loaded:x.filter(O=>O.activation_status==="not_loaded").length,unknown:x.filter(O=>O.activation_status==="unknown").length},unknown_capability_count:Ze.length,capability_contract_version:en.version,update_available_total:D.update_available_total,update_check_status_totals:D.update_check_status_totals,update_health_coverage:D.update_health_coverage,update_health_partial:D.update_health_partial,update_check_failed_total:x.filter(O=>O.update_check_status==="failed").length,load_failure_count:w.failed.length,activation_failure_count:v.failed.length,load_failures:Gn(w.failed),activation_failures:Gn(v.failed),blocking_failure_count:w.failed.length+v.failed.length,has_blocking_failures:w.failed.length+v.failed.length>0,consistency_warning_count:T.warnings.length,trace_enabled:l,isolation:oa,policy:z,remediation:ms},fs=_?{requested:!0,applied:_.adopted_entries.length>0,adopted_count:_.adopted_entries.length,already_managed_count:_.already_managed_count,adopted_extensions:_.adopted_entries.map(O=>O.name)}:{requested:!1,applied:!1,adopted_count:0,already_managed_count:u.extensions.filter(O=>O.managed).length,adopted_extensions:[]},tn={mode:c,summary:us,triage:D,trace_enabled:l,capability_contract:en,capability_guidance:Ze,managed_state_fix:fs,author_manifest:S,isolation:oa,policy:w.policy};if(c==="deep"){let O=l?v.failed:v.failed.map(R=>{let{trace:lu,...hs}=R;return hs});tn.deep={warnings:E,warning_codes:ra,capability_contract:en,capability_guidance:Ze,trace_enabled:l,managed_state:{path:m.path,count:g.entries.length,entries:g.entries},installed_extensions:x,load:{roots:w.roots,policy:w.policy,warnings:w.warnings,failed:w.failed,loaded:w.loaded.map(R=>({layer:R.layer,directory:R.directory,name:R.name,version:R.version,entry:R.entry,priority:R.priority}))},activation:{failed:O,warnings:v.warnings,hook_counts:v.hook_counts,registration_counts:v.registration_counts,parser_override_count:v.parser_override_count,preflight_override_count:v.preflight_override_count,service_override_count:v.service_override_count,renderer_override_count:v.renderer_override_count},consistency:T.summary},l&&(tn.deep.trace={activation_failures:v.failed.filter(R=>R.trace!==void 0).map(R=>({layer:R.layer,name:R.name,entry_path:R.entry_path,error:R.error,method:R.trace.method,command:R.trace.command,capability:R.trace.capability,missing_capability:R.trace.missing_capability,registration_index:R.trace.registration_index,expected_schema:R.trace.expected_schema,hint:R.trace.hint,received:R.trace.received}))})}return s(tn)},bm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,global:o,withResult:s}=e,d=await C(a.settings_root),c=await _e({pmRoot:a.pm_root,settings:d,cwd:process.cwd(),noExtensions:o.noExtensions===!0}),l=await we(c);i.push(...c.warnings),i.push(...l.warnings);let p=vr(t,c,l);if(t!==void 0&&p.extensions.length===0){let m=r.vocabulary==="package"?"package":"extension",y=[...new Set(c.loaded.map(_=>r.vocabulary==="package"&&typeof _.source_package=="string"&&_.source_package.trim().length>0?_.source_package.trim():_.name))].sort((_,u)=>_.localeCompare(u)),g=y.length>0?` Loaded ${m} names: ${y.join(", ")}.`:"";throw new f(`No loaded ${m} named "${t}" was found in ${n} scope.${g} Run pm ${m} explore to list discovered ${m}s.`,h.NOT_FOUND)}return s({target:p.target,total:p.total,extensions:p.extensions,union:p.union,command_ownership:p.command_ownership})},km=async(e,t,n)=>{let a=n,i=null;return[e.action==="manage",e.options.fixManagedState===!0].every(Boolean)&&(i=await Hn(e.resolvedRoots.selected_root,e.scope,t,n),a=i.state),e.action==="manage"&&(a=await lo(a,e.options.offline)),{state:a,fix:i}},xm=async(e,t,n)=>{let a=await _e({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),i=await we({...a,loaded:a.loaded});return e.warnings.push(...a.warnings,...i.warnings),{installed:Vt(n,a,i),failures:Io(i.failed),summary:{requested:!0,executed:!0,reason:e.action==="explore"?"explore_defaults_to_runtime_probe":e.options.runtimeProbe===!0?"runtime_probe_requested":"manage_defaults_to_runtime_probe",load_failure_count:a.failed.length,activation_failure_count:i.failed.length,warning_count:[...new Set([...a.warnings,...i.warnings])].length,policy:a.policy}}},Sm=(e,t)=>e?{requested:!0,applied:e.adopted_entries.length>0,adopted_count:e.adopted_entries.length,adopted_extensions:e.adopted_entries.map(n=>n.name),already_managed_count:e.already_managed_count}:{requested:!1,applied:!1,adopted_count:0,adopted_extensions:[],already_managed_count:t.filter(n=>n.managed).length},go=async e=>{let{action:t,scope:n,resolvedRoots:a,warnings:i,options:r,withResult:o}=e,s=await C(a.settings_root),d=xp(s.extensions.policy),c=await se(a.selected_root);i.push(...c.warnings);let l=await de(a.selected_root,n,s,c.state);i.push(...l.warnings);let{state:p,fix:m}=await km(e,l.extensions,c.state),y=await de(a.selected_root,n,s,p);if(i.push(...y.warnings),t==="manage"&&r.offline===!0)for(let v of y.extensions)v.managed&&["npm","github"].includes(v.source.kind)&&(v.update_check_reason="offline_requested");if(t==="manage"){let v=y.extensions.filter(S=>S.update_check_status==="failed").map(S=>`extension_update_check_failed:${S.name}`);i.push(...v)}let g=await xm(e,s,y.extensions),_=g.installed,u=Yt(n,i,_,r);i.push(...u.warnings);let w={total:_.length,managed_total:_.filter(v=>v.managed).length,enabled_total:_.filter(v=>v.enabled).length,active_total:_.filter(v=>v.active).length,extensions:_,triage:u,policy:d};return g.failures!==void 0&&(w.activation_diagnostics={failed_count:g.failures.length,failed:g.failures}),t==="explore"&&(w.runtime_probe=g.summary),t==="manage"&&(w.runtime_probe=g.summary,w.managed_state_fix=Sm(m,_)),o(w)},yo={init:Vp,install:lm,uninstall:fm,explore:go,manage:go,describe:bm,reload:Yp,doctor:vm,catalog:Xp,adopt:um,"adopt-all":pm,activate:ho,deactivate:ho,migrate:pi},Em=e=>[e.action==="uninstall",e.action==="adopt",e.action==="adopt-all",e.action==="activate",e.action==="deactivate",e.action==="migrate",[["doctor","manage"].includes(e.action),e.options.fixManagedState===!0].every(Boolean)].some(Boolean),$m=e=>Em(e)?Mn(e.resolvedRoots.settings_root,`${e.action}-state`,()=>yo[e.action](e)):yo[e.action](e);import Xn from"node:fs/promises";import U from"node:path";import Po from"node:readline/promises";import{stdin as Ro,stdout as yt}from"node:process";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="f3a0706e-7162-5cde-9f48-c5de9b2fbd8e")}catch{}})();var No=["ask","add","skip","status"],Im=["AGENTS.md","CLAUDE.md"],Am=["pm init","pm context","pm search","pm create","pm claim","pm files","pm docs","pm test --run","pm close","pm release","pm_author"],Tm=8,Zn=1,Om="<!-- pm-cli:agent-guidance:start:",Cm=`<!-- pm-cli:agent-guidance:start:v${Zn} -->`,Vn="<!-- pm-cli:agent-guidance:end -->",wt="Add workflow guidance later: pm init --agent-guidance add",iw={toPortableRelativePath:Fe,ensureTrailingNewline:Yn,detectLineEnding:jo,findGuidanceBlockRange:Qn,buildAgentGuidanceBlock:Lo,upsertAgentGuidanceBlock:ea,resolveProjectRoot:Mo,resolveTargetGuidancePath:Uo,parsePromptChoice:zo,pushUnique:Ae,promptForGuidanceWrite:Go,normalizeAgentGuidanceState:ta,applyAgentGuidanceState:qo,writeGuidanceFile:na,setAgentGuidanceReadlineFactoryForTests:Pm},Do=()=>Po.createInterface({input:Ro,output:yt});function Pm(e){Do=e??(()=>Po.createInterface({input:Ro,output:yt}))}function Fe(e,t){let n=U.relative(e,t);return n.length===0?U.basename(t):n.split(U.sep).join("/")}function Yn(e){return e.endsWith(`
+`}import Wt from"node:fs/promises";import qt from"node:path";import xr 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]="147fb29e-ad06-5850-b0b1-f643e32e9b1f")}catch{}})();function ut(e,t,n,a){let i=xr.relative(e,n);if(i!==""&&!H(e,n)||n===t||H(t,n))return!1;let r=i.split(xr.sep);return r.includes(".git")?!1:a?!r.some(o=>o===".agents"||o==="node_modules"||o.startsWith(".pm-extension-install-backup-")):!0}import{randomUUID as hl}from"node:crypto";import L from"node:fs/promises";import gl from"node:os";import N from"node:path";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="cefb224d-a18f-599a-9cf9-3d3a22616440")}catch{}})();var Sr=3,yl=120,Er=250,_l=12e4,wl=new Set(["EEXIST","ENOTEMPTY","ENOENT"]),$r=e=>typeof e=="object"&&e!==null&&"code"in e?e.code:void 0,Ir=e=>wl.has(String($r(e))),Jt=(e,t)=>$r(e)===t,Ar=e=>new Promise(t=>{setTimeout(t,e)}),Tr=async e=>{let t=N.join(e,"package.json");await k(t)||await L.writeFile(t,`${JSON.stringify({type:"module"},null,2)}
+`,"utf8")},Or=async e=>{let t=we(import.meta.url,["../../.."]),n=N.join(e,"node_modules","@unbrained"),a=N.join(n,"pm-cli");await L.mkdir(n,{recursive:!0}),await L.rm(a,{recursive:!0,force:!0}),await L.symlink(t,a,process.platform==="win32"?"junction":"dir")},ft=async e=>{let t=N.resolve(e),n=N.dirname(t),a=N.parse(n).root,i=await L.realpath(a).catch(()=>a),r=N.relative(a,n),o=r===""?[]:r.split(N.sep);for(let[s,d]of o.entries()){let c=N.join(i,d);try{i=await L.realpath(c)}catch{i=N.join(i,...o.slice(s));break}}return N.join(i,N.basename(t))},Cr=async(e,t,n,a=gl.tmpdir())=>Ce("extension_install_copy",async()=>{let i=N.resolve(e),r=await L.realpath(i).catch(()=>i),o=await ft(t);if(r===o)return;if(!H(r,o)){await n(r,t,{recursive:!0,force:!0,filter:p=>ut(r,o,N.resolve(p),!1)});return}let s=await L.realpath(N.resolve(a)).catch(()=>ft(a)),d=H(r,s)?N.dirname(r):s;if(H(r,d))throw new f(`Extension source "${e}" contains its install destination and no external staging directory is available. Install a narrower package directory instead.`,h.USAGE,{code:"extension_install_source_contains_destination"});let c=await L.mkdtemp(N.join(d,"pm-extension-copy-")),l=N.join(c,"extension");try{await n(r,l,{recursive:!0,force:!0,filter:p=>ut(r,o,N.resolve(p),!0)}),await n(l,t,{recursive:!0,force:!0})}finally{await L.rm(c,{recursive:!0,force:!0})}}),Pr=async(e,t,n=L.cp)=>{for(let a=1;a<=Sr;a+=1)try{await Ce("extension_install_copy",async()=>{await L.rm(t,{recursive:!0,force:!0}),await Cr(e,t,n)});return}catch(i){if(!Ir(i)||a===Sr)throw i;await Ar(Er)}},Mn=async e=>{let t;try{t=await L.readFile(N.join(e,"owner.json"),"utf8")}catch(i){if(!xt(i))throw i;return null}let n;try{n=JSON.parse(t)}catch{return null}if(typeof n!="object"||n===null||!("token"in n))return null;let a=n.token;return typeof a=="string"&&a.length>0?a:null},Rr=async(e,t)=>await Mn(e)!==t?!1:(await L.rm(e,{recursive:!0,force:!0}),!0),vl=async(e,t)=>{let n;try{n=await L.stat(e)}catch{return!1}if(Date.now()-n.mtimeMs<=t)return!1;let a=await Mn(e);return a===null?(await L.rm(e,{recursive:!0,force:!0}),!0):Rr(e,a)},bl=(e,t,n)=>{let a=Promise.resolve(),i=setInterval(()=>{a=a.then(async()=>{if(await Mn(e)!==t)return;let r=new Date;await L.utimes(e,r,r)}).catch(()=>{})},n);return i.unref(),async()=>{clearInterval(i),await a}},kl=async(e,t)=>{await L.mkdir(e);try{await L.writeFile(N.join(e,"owner.json"),`${JSON.stringify(t,null,2)}
+`,"utf8")}catch(n){throw await L.rm(e,{recursive:!0,force:!0}).catch(()=>{}),n}},xl=async(e,t,n,a,i)=>{for(let r=1;r<=n;r+=1)try{return await kl(e,t),!0}catch(o){if(!Jt(o,"EEXIST"))throw o;await vl(e,i)?r-=1:await Ar(a)}return!1},Un=async(e,t,n,a)=>Ce("extension_install",async()=>{let i=N.join(e,"runtime","extension-install-locks"),r=N.join(i,"scope.lock");await L.mkdir(i,{recursive:!0});let{attempts:o=yl,delay_ms:s=Er,stale_ms:d=_l,heartbeat_ms:c}=a??{};if(![o,s,d,c].filter(w=>w!==void 0).every(Number.isFinite))throw new f("Extension install lock timings must be finite numbers.",h.USAGE);let l=Math.max(1,Math.floor(o)),p=Math.max(0,Math.floor(s)),m=Math.floor(d),y=Math.floor(c??m/3);if(m<=0||y<=0||y>=m)throw new f("Extension install lock timings require stale_ms > 0 and 0 < heartbeat_ms < stale_ms.",h.USAGE);let g={pid:process.pid,token:hl(),created_at:T(),destination:t};if(!await xl(r,g,l,p,m))throw new f(`Timed out waiting for extension install lock for "${t}".`,h.CONFLICT);let _=bl(r,g.token,y),u=!1;try{let w=await n();return u=!0,w}finally{await _(),await Rr(r,g.token).catch(w=>{if(u)throw w})}});(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="18bf1015-c2c8-5530-a3ce-1531a8a1d0e2")}catch{}})();var Sl=new Set(["node_modules",".git","dist","build","coverage"]);async function Nr(e,t,n,a){let i=e.source.kind==="local"?await Wt.stat(e.source.absolute_path):void 0,r=e.source.kind==="local"?i.isDirectory()?"directory":"archive":e.source.kind,o=await El(e.directory,t,a),s={source_mode:r,...r==="archive"?{archive_bytes:i.size}:{},copy:o},d=e.source_root??e.directory;if(r==="directory"&&(!o.complete||o.development_entries>0||o.bytes>=16*1024*1024)&&await k(qt.join(d,"package.json"))&&(s.packed_alternative={cwd:d,pack:{command:"npm",args:["pack","--ignore-scripts","--json"]},install:{command:"pm",args:["package","install","<archive-filename>",`--${n}`]},archive_argument:"pack_result[0].filename"}),r==="directory"&&!o.complete){let c=o.stop_reason==="entry_limit"?`${o.max_entries} entries`:`${o.max_depth} directory levels`;throw new f(`Local extension source scan stopped at ${c}; the directory snapshot is incomplete and installation was refused. ${s.packed_alternative?"Pack the package with npm pack --ignore-scripts --json, then install its archive.":"Install a smaller source directory or a packed archive."}`,h.USAGE,{code:"extension_install_incomplete_source_scan",reason:o.stop_reason,nextSteps:s.packed_alternative?[`Run npm pack --ignore-scripts --json from the package root, then pm package install <archive-filename> --${n}.`]:["Choose a smaller source directory or install a packed archive."]})}return s}async function El(e,t,n={}){let{maxEntries:a=1e4,maxDepth:i=64,signal:r}=n;if(![a,i].every(p=>Number.isSafeInteger(p)&&p>0))throw new f("maxEntries and maxDepth must be positive safe integers.",h.USAGE);r?.throwIfAborted();let o=await Wt.realpath(e),s=await ft(t),d=await Ze(o,s);r?.throwIfAborted();let c=d?"in_place":H(o,s)?"nested_filtered_snapshot":"directory_snapshot",l={copy_scope:c,source_directory:o,destination_directory:s,files:0,bytes:0,directories:0,symlinks:0,other_entries:0,scanned_entries:0,excluded_entries:0,development_entries:0,complete:!0,stop_reason:"complete",max_entries:a,max_depth:i};return c==="in_place"||await Dr(o,0,l,r),l}async function Dr(e,t,n,a){a?.throwIfAborted();let i=await Wt.opendir(e);for await(let r of i){if(a?.throwIfAborted(),n.scanned_entries>=n.max_entries){n.complete=!1,n.stop_reason="entry_limit";return}n.scanned_entries+=1;let o=qt.join(e,r.name);if(!ut(n.source_directory,n.destination_directory,o,n.copy_scope==="nested_filtered_snapshot")){n.excluded_entries+=1;continue}if(qt.relative(n.source_directory,o).split(qt.sep).some(s=>Sl.has(s))&&(n.development_entries+=1),await $l(o,t,n,a),!n.complete)return}}async function $l(e,t,n,a){let i=await Wt.lstat(e);if(a?.throwIfAborted(),i.isDirectory()){if(n.directories+=1,t+1>=n.max_depth){n.complete=!1,n.stop_reason="depth_limit";return}await Dr(e,t+1,n,a)}else i.isFile()?(n.files+=1,n.bytes+=i.size):i.isSymbolicLink()?n.symlinks+=1:n.other_entries+=1}import Il from"node:fs/promises";import Al from"npm-package-arg";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="2bef4424-f5b8-511b-91f7-0b39cf11f515")}catch{}})();async function Tl(e,t){if(e.kind!=="local"||e.input.startsWith(".")||e.input.includes("\\")||e.input.includes("/")&&!/^@[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/u.test(e.input))return e;try{return await Il.lstat(e.absolute_path),e}catch(r){if(!_e(r))throw r}let n=e.input.trim(),a=t.filter(r=>r.source.kind==="npm"),i=(a.find(r=>r.name===n)??a.find(r=>r.directory===n)??a.find(r=>r.source.package===n))?.source.package;if(i===void 0)return e;try{let r=Al(i);if(!r.registry||r.name!==i)return e}catch{return e}return lt(`npm:${i}`,{})}async function jr(e,t,n,a=[]){let i=typeof t=="string"?null:await dt(e),r=i===null?null:e.trim().toLowerCase(),o=r===null?null:await Vi(r),s=await Tl(lt(i??e,{forceGithub:typeof t=="string",ref:n}),a),d=r===null?null:await er(e);return{bundledAliasName:r,bundledPackageName:o,installSource:s,sourceResolution:{requested:e,selected:{kind:r===null?s.kind:"builtin",input:r??s.input,...o===null?{}:{package:o}},ambiguous:d!==null,precedence:"bundled_alias_before_installed_npm",candidates:[...r===null?[]:[{kind:"builtin",input:r,...o===null?{}:{package:o},command:`pm install ${r}`}],...d===null?[]:[{kind:"npm",input:`npm:${d.package}`,package:d.package,...d.version===void 0?{}:{version:d.version},directory:d.directory,command:`pm install npm:${d.package}`}]]}}}import et from"node:fs/promises";import ee from"node:path";import Nl from"node:path";import{mkdir as Dl}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]="abb182c9-6d6c-5be4-a2ad-c91b00a098d0")}catch{}})();var ht=["agile","ops","research"],Ol={agile:[{name:"Story",description:"User-facing outcome or capability slice expressed from a stakeholder perspective.",defaultStatus:"open",folder:"stories",aliases:["user-story"]},{name:"Spike",description:"Time-boxed investigation used to reduce uncertainty before implementation.",defaultStatus:"open",folder:"spikes",aliases:["research-spike"]}],ops:[{name:"Incident",description:"Operational disruption, degradation, or support escalation with recovery tracking.",defaultStatus:"open",folder:"incidents",aliases:["outage"]},{name:"Runbook",description:"Repeatable operational procedure, diagnostic path, or response playbook.",defaultStatus:"open",folder:"runbooks",aliases:["playbook"]}],research:[{name:"Experiment",description:"Validated-learning activity with hypothesis, method, and outcome tracking.",defaultStatus:"open",folder:"experiments",aliases:["study"]},{name:"Hypothesis",description:"Testable claim or assumption that should be supported, rejected, or refined.",defaultStatus:"open",folder:"hypotheses",aliases:["assumption"]}]};function Bt(e){if(e===void 0)return;let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new Error("Type preset name must not be empty.");if(t==="agile"||t==="ops"||t==="research")return t;throw new Error(`Invalid type preset "${e}". Allowed: ${ht.join(", ")}.`)}function gt(e){return Ol[e].map(t=>at(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]="4d01ffa0-2cdb-5d22-834e-d23d31403ad6")}catch{}})();var Cl=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function Pl(e){let t=Cl.exec(e.trim());if(!t)return;let n=t[1];if(!(n.length<2)&&!/^[A-Za-z]\d+$/.test(n))return n.toLowerCase()}function Rl(e){return e.split(/[-_]+/).filter(t=>t.length>0).map(t=>`${t.slice(0,1).toUpperCase()}${t.slice(1).toLowerCase()}`).join("")}function Lr(e,t={}){let n=typeof t.minCount=="number"&&t.minCount>0?Math.trunc(t.minCount):10,a=typeof t.maxExamples=="number"&&t.maxExamples>0?Math.trunc(t.maxExamples):3,i=new Map;for(let o of e){let s=typeof o=="string"?o.trim():"";if(s.length===0)continue;let d=Pl(s);if(d===void 0)continue;let c=i.get(d)??{count:0,examples:[]};c.count+=1,c.examples.length<a&&c.examples.push(s),i.set(d,c)}let r=[];for(let[o,s]of i.entries()){if(s.count<n)continue;let d=Rl(o);r.push({name:d,prefix:o,count:s.count,examples:s.examples,shadows_builtin:Ka(d)!==void 0})}return r.sort((o,s)=>s.count-o.count||o.name.localeCompare(s.name)),r}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="7a59f90b-0497-530c-93e1-c93cfc8a0016")}catch{}})();var ny=[...Et,"add-type","remove-type","add-status","remove-status","add-field","remove-field","list-fields","show-field","apply-preset","list","show","show-status","rename-type","rename-field","remap-status"],Ht="schema-types",Fr="schema-statuses",Mr="schema-fields";function Ae(e){return ke({pmRoot:e.pmRoot,filePath:e.filePath,raw:e.raw,op:e.op,author:e.author,lockTtlSeconds:e.settings.locks.ttl_seconds,lockWaitMs:e.settings.locks.wait_ms})}async function ry(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i;try{i=at({name:e,description:t.description,defaultStatus:t.defaultStatus,folder:t.folder,aliases:t.alias})}catch(y){throw new f(y instanceof Error?y.message:String(y),h.USAGE)}let r=await A(a),o=K(r.schema),s=Q(a,o.files.types,V.types),d=[],c=q(t.author,r.author_default),l=ue(r),p=await ne(a,Ht,r.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,r.locks.wait_ms),m;try{let y=await G(s),g;try{g=ae(y)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.GENERIC_FAILURE)}try{Va(i,g);let _=new Map,u=W(r,J());for(let[w,v]of Object.entries(u.type_to_folder)){let E=v.trim().toLowerCase();E.length>0&&!_.has(E)&&_.set(E,w)}Ya(i,g,_)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}m=ze(g,i),m.replaced&&m.previousName!==void 0&&m.previousName!==m.definition.name&&d.push(`type_recased:${m.previousName}->${m.definition.name}`),await Ae({pmRoot:a,filePath:s,raw:se(m.file),op:"schema:add-type",author:c,settings:r}),await yt(a,[m.definition],d,"schema:add-type-folder"),d.push(...await B({path:s,scope:"project",op:"schema:add-type"}))}finally{await p()}return await Ur(a,d),{action:"add-type",registered:!0,replaced:m.replaced,type:m.definition,file:{path:s,definitions:m.file.definitions.length},warnings:Te(d),generated_at:T()}}async function ye(e){await Ue(e)}async function Ur(e,t){try{let n=await ti(e);n.status==="refreshed"?t.push("merge_fence_refreshed"):n.status==="not_installed"&&t.push('merge_fence_not_installed:type folders lack git merge drivers; run "pm merge install"')}catch{t.push('merge_fence_refresh_failed:run "pm merge install" to reconcile')}}function Te(e){return[...new Set(e)].sort((t,n)=>t.localeCompare(n))}async function jl(e,t,n,a){let i=W(t,J()),r=a.trim().toLowerCase();return(await Pe(e,t.item_format,i.type_to_folder,[],n)).filter(o=>typeof o.type=="string"&&o.type.toLowerCase()===r).length}async function Ll(e,t,n,a){let i=W(t,J()),r=nt(n),o=I(a);return(await Pe(e,t.item_format,i.type_to_folder,[],n)).filter(s=>{let d=typeof s.status=="string"?s.status:"";return(r.alias_to_id.get(I(d))??I(d))===o}).length}async function Fl(e,t,n,a,i){if(i.length===0||De.has(i))return;let r=await Ll(t,n,a,i);r>0&&e.push(`items_using_status:${r}`);let o=zr(a.workflow,i);o.length>0&&e.push(`status_referenced_by_workflow:${o.join(",")}`)}function zr(e,t){return[["draft_status",e.draft_status],["open_status",e.open_status],["in_progress_status",e.in_progress_status],["blocked_status",e.blocked_status],["close_status",e.close_status],["canceled_status",e.canceled_status]].filter(([,n])=>n!==void 0&&I(n)===t).map(([n])=>n)}async function oy(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i=await A(a),r=K(i.schema),o=Q(a,r.files.types,V.types),s=[],d=q(t.author,i.author_default),c=ue(i),l=await ne(a,Ht,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=ae(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Xa(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=(p.definition?.name??e??"").trim();if(g.length>0){let _=await jl(a,i,r,g);_>0&&s.push(`items_using_type:${_}`)}await Ae({pmRoot:a,filePath:o,raw:se(p.file),op:"schema:remove-type",author:d,settings:i}),s.push(...await B({path:o,scope:"project",op:"schema:remove-type"}))}}finally{await l()}return p.removed&&await Ur(a,s),{action:"remove-type",removed:p.removed,...p.definition?{type:p.definition}:{},file:{path:o,definitions:p.file.definitions.length},warnings:Te(s),generated_at:T()}}function zn(e,t){return Q(e,t.files.statuses,V.statuses)}function Kt(e,t){return Q(e,t.files.fields,V.fields)}function Gr(e,t){return Q(e,t.files.types,V.types)}async function yt(e,t,n,a){for(let i of t){let r=fa(i.folder??ua(i.name)),o=Nl.join(e,r);await k(o)||(await Dl(o,{recursive:!0}),n.push(...await B({path:o,scope:"project",op:a})))}}function Gn(e){return{key:e.key,type:e.type,commands:[...e.commands],cli_flag:`--${e.cli_flag}`,cli_aliases:e.cli_aliases.map(t=>`--${t}`),...e.description?{description:e.description}:{},required:e.required,required_on_create:e.required_on_create,allow_unset:e.allow_unset,required_types:[...e.required_types]}}function Ml(e){if(e)return{id:e.id,...e.roles.length>0?{roles:[...e.roles]}:{},...e.aliases.length>0?{aliases:[...e.aliases]}:{},...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function Ul(e){let t=new Map;for(let n of e){let a=I(n.id);if(a.length!==0){t.set(a,a);for(let i of Array.isArray(n.aliases)?n.aliases:[]){let r=I(i);r.length>0&&!t.has(r)&&t.set(r,a)}}}return t}async function sy(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i;try{i=Ai({id:e,roles:t.role,aliases:t.alias,description:t.description,order:t.order})}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let r=await A(a),o=K(r.schema),s=zn(a,o),d=nt(o);try{wn(i,d.alias_to_id)}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let c=Ml(d.by_id.get(i.id));if((i.roles??c?.roles??[]).length===0)throw new f(`Status "${i.id}" requires at least one lifecycle role. Re-run with --role active, --role blocked, --role draft, or an appropriate terminal/default role.`,h.USAGE,{code:"status_lifecycle_role_required",examples:[`pm schema add-status "${Re(i.id)}" --role active`,`pm schema add-status "${Re(i.id)}" --role blocked`]});let l=[],p=q(t.author,r.author_default),m=ue(r),y=await ne(a,Fr,r.locks.ttl_seconds,p,!!t.force,m.force_required_for_stale_lock,r.locks.wait_ms),g;try{let _=await G(s),u;try{u=We(_)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.GENERIC_FAILURE)}let w=Ul(u.statuses);try{wn(i,w)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.USAGE)}g=Ti(u,i,c),await Ae({pmRoot:a,filePath:s,raw:Be(g.file),op:"schema:add-status",author:p,settings:r}),l.push(...await B({path:s,scope:"project",op:"schema:add-status"}))}finally{await y()}return{action:"add-status",registered:!0,replaced:g.replaced,status:g.definition,file:{path:s,statuses:g.file.statuses.length},warnings:Te(l),generated_at:T()}}async function cy(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i=await A(a),r=K(i.schema),o=zn(a,r),s=[],d=q(t.author,i.author_default),c=ue(i),l=await ne(a,Fr,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=We(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Oi(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=I(p.definition?.id??e);await Fl(s,a,i,r,g),await Ae({pmRoot:a,filePath:o,raw:Be(p.file),op:"schema:remove-status",author:d,settings:i}),s.push(...await B({path:o,scope:"project",op:"schema:remove-status"}))}}finally{await l()}return{action:"remove-status",removed:p.removed,...p.definition?{status:p.definition}:{},file:{path:o,statuses:p.file.statuses.length},warnings:Te(s),generated_at:T()}}function Jr(e){return{name:e.name,folder:e.folder,aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.default_status?{default_status:e.default_status}:{},...e.description?{description:e.description}:{}}}function zl(e,t,n){return{...Jr(e),source:t,...n?{extension:n}:{},required_create_fields:[...e.required_create_fields],required_create_repeatables:[...e.required_create_repeatables],options:structuredClone(e.options),command_option_policies:structuredClone(e.command_option_policies)}}function qr(e){return{id:e.id,source:De.has(e.id)?"builtin":"custom",roles:Array.isArray(e.roles)?[...e.roles]:[],aliases:Array.isArray(e.aliases)?[...e.aliases]:[],...e.description?{description:e.description}:{},...typeof e.order=="number"?{order:e.order}:{}}}function Wr(e,t,n){let a=e.toLowerCase();return n.has(a)?"extension":t.has(a)?"custom":"builtin"}function Gl(){let e=new Map,t=J();for(let n of t?.item_types??[]){let a=n.types;if(Array.isArray(a))for(let i of a){if(typeof i!="object"||i===null||Array.isArray(i))continue;let r=i.name;typeof r=="string"&&r.trim().length>0&&e.set(r.trim().toLowerCase(),{layer:n.layer,name:n.name})}}return e}function Jl(e){let t=nt(e),n=[],a=[];for(let i of t.definitions){let r=qr(i);r.source==="builtin"?n.push(r):a.push(r)}return{builtin:n,custom:a}}async function _t(e){let t=F(process.cwd(),e.path);await ye(t);let n=await A(t),a=K(n.schema),i=Q(t,a.files.types,V.types),r=zn(t,a),o=W(n,J()),s=Gl(),d=new Set((n.item_types?.definitions??[]).map(c=>c.name.trim().toLowerCase()).filter(c=>c.length>0&&!s.has(c)));return{pmRoot:t,typesPath:i,statusesPath:r,byType:o.by_type,customNames:d,extensionProvenance:s,schema:a}}async function dy(e){let t=await _t(e),n=[],a=[],i=[];for(let s of Object.values(t.byType).sort((d,c)=>d.name.localeCompare(c.name))){let d=Wr(s.name,t.customNames,new Set(t.extensionProvenance.keys())),c=Jr(s);d==="extension"?i.push(c):d==="custom"?a.push(c):n.push(c)}let r=Jl(t.schema),o=At(t.schema).definitions.map(Gn);return{action:"list",builtin:n,custom:a,extension:i,counts:{builtin:n.length,custom:a.length,extension:i.length,total:n.length+a.length+i.length},statuses:{builtin:r.builtin,custom:r.custom,counts:{builtin:r.builtin.length,custom:r.custom.length,total:r.builtin.length+r.custom.length}},fields:{custom:o,counts:{total:o.length}},file:{path:t.typesPath},generated_at:T()}}async function ly(e,t){let n=(e??"").trim();if(n.length===0)throw new f("Type name must not be empty.",h.USAGE);let a=await _t(t),i=Object.values(a.byType).find(r=>r.name.toLowerCase()===n.toLowerCase()||r.aliases.some(o=>o.toLowerCase()===n.toLowerCase()));if(!i)throw new f(`Unknown item type "${n}". Run pm schema list to inspect registered types, or pm schema add-type "${Re(n)}" to register it.`,h.NOT_FOUND,{code:"unknown_item_type"});return{action:"show",type:zl(i,Wr(i.name,a.customNames,new Set(a.extensionProvenance.keys())),a.extensionProvenance.get(i.name.toLowerCase())),file:{path:a.typesPath},generated_at:T()}}async function py(e,t){let n=I(e);if(n.length===0)throw new f("Status id must not be empty.",h.USAGE);let a=await _t(t),i=nt(a.schema),r=i.alias_to_id.get(n)??n,o=i.by_id.get(r);if(!o)throw new f(`Unknown status "${e}". Run pm schema list to inspect registered statuses, or pm schema add-status "${Re(e??"")}" to register it.`,h.NOT_FOUND,{code:"unknown_status"});return{action:"show-status",status:qr(o),file:{path:a.statusesPath},generated_at:T()}}async function my(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i;try{i=Ei({key:e,type:t.type,commands:t.commands,description:t.description,cliFlag:t.cliFlag,aliases:t.alias,required:t.required,requiredOnCreate:t.requiredOnCreate,allowUnset:t.allowUnset,requiredTypes:t.requiredTypes})}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}let r=await A(a),o=K(r.schema),s=Kt(a,o),d=[],c=Ct(i.key);c&&d.push(`custom_field_mcp_input_collision:${c.field}:${c.property}:${c.owner}:use=${c.nested_path}`);let l=q(t.author,r.author_default),p=ue(r),m=await ne(a,Mr,r.locks.ttl_seconds,l,!!t.force,p.force_required_for_stale_lock,r.locks.wait_ms),y;try{let g=await G(s),_;try{_=Je(g)}catch(u){throw new f(u instanceof Error?u.message:String(u),h.GENERIC_FAILURE)}y=$i(_,i),await Ae({pmRoot:a,filePath:s,raw:qe(y.file),op:"schema:add-field",author:l,settings:r}),d.push(...await B({path:s,scope:"project",op:"schema:add-field"}))}finally{await m()}return{action:"add-field",registered:!0,replaced:y.replaced,field:y.definition,file:{path:s,fields:y.file.fields.length},warnings:Te(d),generated_at:T()}}async function ql(e,t,n,a){let i=W(t,J());return(await Pe(e,t.item_format,i.type_to_folder,[],n)).filter(r=>{let o=r[a];return o==null?!1:Array.isArray(o)?o.length>0:typeof o=="string"?o.trim().length>0:!0}).length}async function uy(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i=await A(a),r=K(i.schema),o=Kt(a,r),s=[],d=q(t.author,i.author_default),c=ue(i),l=await ne(a,Mr,i.locks.ttl_seconds,d,!!t.force,c.force_required_for_stale_lock,i.locks.wait_ms),p;try{let m=await G(o),y;try{y=Je(m)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.GENERIC_FAILURE)}try{p=Ii(y,e)}catch(g){throw new f(g instanceof Error?g.message:String(g),h.USAGE)}if(p.removed){let g=I(p.definition?.key??e),_=I(p.definition?.metadata_key??p.definition?.front_matter_key??g);if(_.length>0){let u=await ql(a,i,r,_);u>0&&s.push(`items_using_field:${u}`)}await Ae({pmRoot:a,filePath:o,raw:qe(p.file),op:"schema:remove-field",author:d,settings:i}),s.push(...await B({path:o,scope:"project",op:"schema:remove-field"}))}}finally{await l()}return{action:"remove-field",removed:p.removed,...p.definition?{field:p.definition}:{},file:{path:o,fields:p.file.fields.length},warnings:Te(s),generated_at:T()}}async function fy(e){let t=await _t(e),n=At(t.schema).definitions.map(Gn);return{action:"list-fields",fields:n,counts:{total:n.length},file:{path:Kt(t.pmRoot,t.schema)},generated_at:T()}}async function hy(e,t){let n=I(e);if(n.length===0)throw new f("Field key must not be empty.",h.USAGE);let a=await _t(t),i=At(a.schema).by_key.get(n);if(!i)throw new f(`Unknown custom field "${e}". Run pm schema list-fields to inspect registered fields, or pm schema add-field "${Re(e??"")}" to register it.`,h.NOT_FOUND,{code:"unknown_field"});return{action:"show-field",field:Gn(i),file:{path:Kt(a.pmRoot,a.schema)},generated_at:T()}}async function gy(e,t,n){let a=F(process.cwd(),n.path);await ye(a);let i;try{let _=Bt(e);if(_===void 0)throw new Error(`Type preset name is required. Allowed: ${ht.join(", ")}.`);i=_}catch(_){throw new f(_ instanceof Error?_.message:String(_),h.USAGE)}let r=await A(a),o=K(r.schema),s=Gr(a,o),d=[],c=q(t.author,r.author_default),l=ue(r),p=[],m=[],y,g=await ne(a,Ht,r.locks.ttl_seconds,c,!!t.force,l.force_required_for_stale_lock,r.locks.wait_ms);try{let _=await G(s),u;try{u=ae(_)}catch(v){throw new f(v instanceof Error?v.message:String(v),h.GENERIC_FAILURE)}let w=u;for(let v of gt(i)){let E=ze(w,v);w=E.file,(E.replaced?m:p).push(E.definition.name)}y=w.definitions.length,await Ae({pmRoot:a,filePath:s,raw:se(w),op:"schema:apply-preset",author:c,settings:r}),await yt(a,gt(i),d,"schema:apply-preset-folder"),d.push(...await B({path:s,scope:"project",op:"schema:apply-preset"}))}finally{await g()}return{action:"apply-preset",preset:i,registered:p,replaced:m,file:{path:s,definitions:y},warnings:Te(d),generated_at:T()}}function Wl(e){if(e===void 0)return 10;if(!Number.isInteger(e)||e<1)throw new f("--min-count must be a positive integer (>= 1).",h.USAGE);return e}async function yy(e,t){let n=F(process.cwd(),t.path);await ye(n);let a=await A(n),i=K(a.schema),r=Gr(n,i),o=Wl(e.minCount),s=W(a,J()),d=(await Pe(n,a.item_format,s.type_to_folder,[],i)).map(v=>typeof v.title=="string"?v.title:""),c=Lr(d,{minCount:o}),l=[],p=[],m=[],y=[],g;if(!e.apply){let v;try{v=ae(await G(r))}catch(E){throw new f(E instanceof Error?E.message:String(E),h.GENERIC_FAILURE)}return g=v.definitions.length,{action:"infer-types",applied:!1,min_count:o,candidates:c,registered:p,replaced:m,skipped:y,file:{path:r,definitions:g},warnings:l,generated_at:T()}}let _=q(e.author,a.author_default),u=ue(a),w=await ne(n,Ht,a.locks.ttl_seconds,_,!!e.force,u.force_required_for_stale_lock,a.locks.wait_ms);try{let v=await G(r),E;try{E=ae(v)}catch(C){throw new f(C instanceof Error?C.message:String(C),h.GENERIC_FAILURE)}let S=E;for(let C of c){if(C.shadows_builtin){y.push({name:C.name,reason:"shadows_builtin"});continue}let te;try{te=at({name:C.name})}catch{y.push({name:C.name,reason:"invalid_type_token"});continue}let D=ze(S,te);S=D.file,(D.replaced?m:p).push(D.definition.name)}g=S.definitions.length,await Ae({pmRoot:n,filePath:r,raw:se(S),op:"schema:infer-types",author:_,settings:a}),await yt(n,S.definitions.filter(C=>p.includes(C.name)||m.includes(C.name)),l,"schema:infer-types-folder"),l.push(...await B({path:r,scope:"project",op:"schema:infer-types"}))}finally{await w()}return{action:"infer-types",applied:!0,min_count:o,candidates:c,registered:p,replaced:m,skipped:y,file:{path:r,definitions:g},warnings:Te(l),generated_at:T()}}function _y(e){let t=e.replaced?"Updated":"Registered",n=e.type.aliases&&e.type.aliases.length>0?` (aliases: ${e.type.aliases.join(", ")})`:"";return`${t} custom item type "${e.type.name}"${n} in ${e.file.path}. Run: pm create "${Re(e.type.name)}" "<title>"`}function wy(e){return e.removed?`Removed custom item type "${e.type?.name??"(unknown)"}" from ${e.file.path}.`:`No custom item type matched; nothing removed from ${e.file.path}.`}function vy(e){let t=e.replaced?"Updated":"Registered",n=e.status.roles&&e.status.roles.length>0?` (roles: ${e.status.roles.join(", ")})`:"",a=e.status.aliases&&e.status.aliases.length>0?` (aliases: ${e.status.aliases.join(", ")})`:"";return`${t} status "${e.status.id}"${n}${a} in ${e.file.path}.`}function by(e){return e.removed?`Removed custom status "${e.status?.id??"(unknown)"}" from ${e.file.path}.`:`No custom status matched; nothing removed from ${e.file.path}.`}function ky(e){let t=[`Schema types: ${e.counts.total} total (${e.counts.builtin} builtin, ${e.counts.custom} custom, ${e.counts.extension} extension)`];for(let[n,a]of[["builtin",e.builtin],["custom",e.custom],["extension",e.extension]])a.length!==0&&t.push(`${n}: ${a.map(i=>i.name).join(", ")}`);t.push(`statuses: ${e.statuses.counts.total} total (${e.statuses.counts.builtin} builtin, ${e.statuses.counts.custom} custom)`);for(let[n,a]of[["builtin statuses",e.statuses.builtin],["custom statuses",e.statuses.custom]])a.length!==0&&t.push(`${n}: ${a.map(i=>i.id).join(", ")}`);return t.push(`custom fields: ${e.fields.counts.total} total`),e.fields.custom.length>0&&t.push(`fields: ${e.fields.custom.map(n=>`${n.key} (${n.type}, ${n.cli_flag})`).join(", ")}`),t.push("Inspect one: pm schema show <Type>"),t.push("Inspect one status: pm schema show-status <status>"),t.push("Inspect one field: pm schema show-field <key>"),t.join(`
+`)}function xy(e){let t=[`type: ${e.type.name}`,`source: ${e.type.source}`,`folder: ${e.type.folder}`];return e.type.default_status&&t.push(`default_status: ${e.type.default_status}`),e.type.aliases.length>0&&t.push(`aliases: ${e.type.aliases.join(", ")}`),e.type.description&&t.push(`description: ${e.type.description}`),e.type.options.length>0&&t.push(`options: ${e.type.options.map(n=>n.key).join(", ")}`),t.join(`
+`)}function Sy(e){let t=[`status: ${e.status.id}`,`source: ${e.status.source}`];return e.status.roles.length>0&&t.push(`roles: ${e.status.roles.join(", ")}`),e.status.aliases.length>0&&t.push(`aliases: ${e.status.aliases.join(", ")}`),e.status.description&&t.push(`description: ${e.status.description}`),typeof e.status.order=="number"&&t.push(`order: ${e.status.order}`),t.join(`
+`)}function Bl(e){let t=[];e.required&&t.push("required"),e.required_on_create&&t.push("required_on_create"),e.allow_unset||t.push("no_unset");let n=t.length>0?` [${t.join(", ")}]`:"";return`${e.key} (${e.type}) ${e.cli_flag} commands=${e.commands.join("/")}${n}`}function Ey(e){return`${e.replaced?"Updated":"Registered"} custom field "${e.field.key}" in ${e.file.path}. Use it: pm create "<title>" --${(e.field.cli_flag??e.field.key).replaceAll("_","-")} <value>`}function $y(e){return e.removed?`Removed custom field "${e.field?.key??"(unknown)"}" from ${e.file.path}.`:`No custom field matched; nothing removed from ${e.file.path}.`}function Iy(e){let t=[`Custom fields: ${e.counts.total} total`];for(let n of e.fields)t.push(`  ${Bl(n)}`);return t.push("Inspect one: pm schema show-field <key>"),t.join(`
+`)}function Ay(e){let t=e.field,n=[`field: ${t.key}`,`type: ${t.type}`,`cli_flag: ${t.cli_flag}`,`commands: ${t.commands.join(", ")}`];return t.cli_aliases.length>0&&n.push(`cli_aliases: ${t.cli_aliases.join(", ")}`),t.description&&n.push(`description: ${t.description}`),t.required&&n.push("required: true"),t.required_on_create&&n.push("required_on_create: true"),t.allow_unset||n.push("allow_unset: false"),t.required_types.length>0&&n.push(`required_types: ${t.required_types.join(", ")}`),n.join(`
+`)}function Ty(e){let t=e.registered.length>0?`registered: ${e.registered.join(", ")}`:"",n=e.replaced.length>0?`updated: ${e.replaced.join(", ")}`:"",a=[t,n].filter(i=>i.length>0).join("; ");return`Applied "${e.preset}" type preset to ${e.file.path}${a.length>0?` (${a})`:""}.`}function Oy(e){if(e.candidates.length===0)return`No title-prefix conventions found with at least ${e.min_count} items. Lower the threshold with --min-count <n>.`;let t=e.applied?[`Inferred and registered custom types from title prefixes (min-count ${e.min_count}):`]:[`Inferred custom type candidates from title prefixes (min-count ${e.min_count}, dry-run):`];for(let n of e.candidates){let a=n.shadows_builtin?" [shadows built-in, skipped]":"";t.push(`  ${n.name} <- "${n.prefix}" (${n.count} items)${a}`)}return e.applied?(e.registered.length>0&&t.push(`registered: ${e.registered.join(", ")}`),e.replaced.length>0&&t.push(`updated: ${e.replaced.join(", ")}`)):t.push("Re-run with --apply to register the non-shadowing candidates."),t.join(`
+`)}var Cy={workflowSlotsReferencing:zr};(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="a8289336-e833-5617-9a32-0a21f28f294e")}catch{}})();function Br(e){let t=/^extension_(disabled_)?pm_(min|max)_version_([a-z_]+):(project|global):([^:]+):(.+)$/u.exec(e);if(!t)return;let[,n,a,i,r,o,s]=t,d=s.split(":")[0].replace(a==="min"?"required=":"allowed=",""),c=i==="invalid"?`a valid pm_${a}_version instead of ${d}`:`pm ${a==="min"?">=":"<="} ${d}`;return n?`Package ${o} is disabled and requires ${c} before activation. After satisfying the bound, run ${oe(["package","activate",o,`--${r}`])}.`:`Package ${o} requires ${c}. Use a compatible host or package version, or keep it disabled with ${oe(["package","deactivate",o,`--${r}`])}.`}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="573b0fd6-f003-55d8-8f49-c2a5e81cbc31")}catch{}})();function Jn(e){return e.map(({layer:t,name:n,error:a})=>({layer:t,name:n,error:a}))}function Vt(e,t,n){let a=b(t),i=n.trim();if(a.length===0||i.length===0)return;let r=e.get(a)??new Set;r.add(i),e.set(a,r)}function Hl(e){let t=new Map,n=new Map;for(let a of e.registrations.commands)Vt(t,a.name,a.command),Vt(n,a.name,a.action);for(let a of e.commands.handlers)Vt(t,a.name,a.command);for(let a of e.commands.overrides)Vt(t,a.name,a.command);return{commandPathsByExtension:t,actionPathsByExtension:n}}function Hr(e){if(!(!e||e.size===0))return[...e].sort((t,n)=>t.localeCompare(n))}function Kl(e){let{enabled:t,normalizedName:n,loadedNames:a,loadFailedNames:i,activationFailedNames:r}=e;return t?i.has(n)||r.has(n)?{runtime_active:!1,activation_status:"failed"}:a.has(n)?{runtime_active:!0,activation_status:"ok"}:{runtime_active:!1,activation_status:"not_loaded"}:{runtime_active:!1,activation_status:"not_loaded"}}function Yt(e,t,n){let a=new Set(t.loaded.map(d=>b(d.name))),i=new Set(t.failed.map(d=>b(d.name))),r=new Set(n.failed.map(d=>b(d.name))),{commandPathsByExtension:o,actionPathsByExtension:s}=Hl(n);return e.map(d=>{let c=b(d.name),l=Hr(o.get(c)),p=Hr(s.get(c)),m={...l?{command_paths:l}:{},...p?{action_paths:p}:{}},y=Kl({enabled:d.enabled,normalizedName:c,loadedNames:a,loadFailedNames:i,activationFailedNames:r});return{...d,...y,...m}})}function Vl(e){let t=0,n=0,a=0;for(let i of e)if(i.startsWith("extension_policy_")){if(t+=1,i.startsWith("extension_policy_violation_")){n+=1;continue}i.startsWith("extension_policy_blocked_")&&(a+=1)}return{warning_count:t,violation_count:n,blocked_count:a}}function M(e,t){return e.vocabulary==="package"?`pm package --${t}`:`pm extension --${t}`}var Yr=new Set(["extension_command_handler_collision","extension_command_override_collision","extension_command_override_handler_overlap","extension_parser_override_collision","extension_preflight_override_collision","extension_renderer_collision","extension_service_override_collision"]);function Yl(e){return Yr.has(no(e))}function Kr(e){return e==="project"||e==="global"}function Xr(e){let t=e.split(":"),n=t[0];if(!n||!Yr.has(n))return null;let a=t.at(-4),i=t.at(-3)?.trim(),r=t.at(-2),o=t.at(-1)?.trim();return!Kr(a)||!Kr(r)||!i||!o?null:{code:n,surface:t.slice(1,-4).join(":")||"global",winner:{layer:a,name:i},displaced:{layer:r,name:o}}}function Xl(e){let t=new Set;for(let n of e){let a=Xr(n);a&&(t.add(a.winner.name),t.add(a.displaced.name))}return[...t].sort((n,a)=>n.localeCompare(a))}function Zl(e,t){let n=e.filter(Yl);if(n.length===0)return null;let a=Xl(n);return`Extension registration collisions or handler/override overlaps detected.${a.length>0?` Conflicting extensions: ${a.join(", ")}.`:""} Single-winner surfaces can hide earlier package behavior. Deactivate one conflicting package with ${t.deactivate}, or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${t.doctor}.`}function Ql(e,t,n,a){let i=t.map(p=>Xr(p)).filter(p=>p!==null).sort((p,m)=>`${p.code}:${p.surface}:${p.winner.name}:${p.displaced.name}`.localeCompare(`${m.code}:${m.surface}:${m.winner.name}:${m.displaced.name}`));if(i.length===0)return;let r=e==="global"?"--global":"--project",o=M(a,"deactivate"),s=`${M(a,"doctor")} ${r} --detail deep --trace`,d=new Map(n.map(p=>[b(p.name),p])),c=new Map;for(let p of i)for(let m of[p.winner.name,p.displaced.name]){let y=b(m);c.set(y,(c.get(y)??0)+1)}let l=[...c.entries()].map(([p,m])=>{let y=d.get(p),g=y?.name??p,_=y?.command_paths??[],u=y?.action_paths??[];return{action:"deactivate",extension:g,command:`${o} ${g} ${r}`,affected_collisions:m,feature_loss:{command_paths:[..._].sort((w,v)=>w.localeCompare(v)),action_paths:[...u].sort((w,v)=>w.localeCompare(v))}}}).sort((p,m)=>{let y=m.affected_collisions-p.affected_collisions;if(y!==0)return y;let g=p.feature_loss.command_paths.length+p.feature_loss.action_paths.length,_=m.feature_loss.command_paths.length+m.feature_loss.action_paths.length;return g!==_?g-_:p.extension.localeCompare(m.extension)});return{status:"conflicts_detected",collision_count:i.length,extension_count:c.size,next_best_command:s,collisions:i,remediation_candidates:l}}function Zr(e){let t=[];for(let n of e){let a=n.error.toLowerCase();(a.includes("cannot find package '@unbrained/pm-cli'")||a.includes('cannot find module "@unbrained/pm-cli"')||a.includes("cannot find module '@unbrained/pm-cli'"))&&t.push(`extension_load_failed_sdk_dependency_missing:${n.name}`),(a.includes("cannot use import statement outside a module")||a.includes("to load an es module")||a.includes("must use import to load es module"))&&t.push(`extension_load_failed_module_mode_mismatch:${n.name}`)}return[...new Set(t)].sort((n,a)=>n.localeCompare(a))}function Qr(e=[]){let t=Array.isArray(e)?e:[],n=[];for(let a of t){if(!a||typeof a.name!="string")continue;let i=a.trace?.missing_capability??a.trace?.capability;typeof i=="string"&&i.trim().length>0&&n.push(`extension_capability_missing:${a.name}:${i.trim().toLowerCase()}`)}return[...new Set(n)].sort((a,i)=>a.localeCompare(i))}function eo(e,t){let n=[];for(let a of Ra(e.loaded,t))for(let i of a.unused)n.push(`extension_capability_unused:${a.layer}:${a.name}:${i}`);return[...new Set(n)].sort((a,i)=>a.localeCompare(i))}var ep=[{matches:e=>e.some(t=>t.startsWith("extension_manifest_")),build:e=>`Run ${M(e.options,"explore")} ${e.scopeFlag} to inspect discovered manifests and directories.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unknown:")),build:()=>`Unknown extension capabilities detected. Allowed capabilities: ${da.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_legacy_alias:")),build:()=>"Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."},{matches:e=>e.some(t=>t.startsWith("extension_capability_missing:")),build:e=>`Extension activation failed because code registered a surface missing from manifest capabilities. Run ${M(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`},{matches:e=>e.some(t=>t.startsWith("extension_capability_unused:")),build:e=>`Extension manifests declare capabilities that are never registered against. Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${M(e.options,"doctor")} ${e.scopeFlag} --detail deep --trace for per-extension registration counts.`},{matches:e=>e.some(t=>t.startsWith("extension_command_definition_legacy_handler_alias:")),build:()=>"Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."},{matches:e=>e.some(t=>t.startsWith("extension_output_service_override_global:")||t.startsWith("extension_output_renderer_override_global:")),build:()=>"Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering."},{matches:e=>e.some(t=>t.startsWith("extension_schema_narrow_activation:")),build:()=>"A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or \u2014 if the schema is intentionally command-scoped \u2014 knowingly ignore this advisory."},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_sdk_dependency_missing:")),build:e=>`Detected extension load failures caused by missing SDK dependency resolution. Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_load_failed_module_mode_mismatch:")),build:e=>`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" or use an explicit .mjs entry and rerun ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:e=>e.some(t=>t.startsWith("extension_pm_min_version_")||t.startsWith("extension_pm_max_version_")),build:e=>`Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${M(e.options,"doctor")} ${e.scopeFlag}.`},{matches:(e,t)=>t.updateCheckFailedTotal>0,build:e=>`Run ${M(e.options,"manage")} ${e.scopeFlag} after validating network and repository access.`},{matches:e=>e.some(t=>t.startsWith("extension_manager_state_")),build:e=>`Review and repair ${e.scope} managed extension state file if schema/read warnings persist.`},{matches:(e,t)=>t.policyWarningCount>0,build:()=>"Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces."}];function tp(e){let{normalizedWarnings:t,options:n,scope:a,scopeFlag:i,updateCheckFailedTotal:r,policyWarningCount:o,unmanagedActionRequiredTotal:s,notCheckedTotal:d,skippedNonGithubTotal:c,updateAvailableTotal:l}=e,p=t.map(Br).filter(y=>y!==void 0),m={options:n,scope:a,scopeFlag:i,updateCheckFailedTotal:r,policyWarningCount:o};if(t.length>0){let y=Zl(t,{deactivate:`${M(n,"deactivate")} <name> ${i}`,doctor:`${M(n,"doctor")} ${i} --detail deep --trace`});y&&p.push(y);for(let g of ep)g.matches(t,m)&&p.push(g.build(m))}return s>0&&p.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${M(n,"manage")} ${i} --fix-managed-state (or ${M(n,"adopt-all")} ${i}, ${M(n,"adopt")} <name> ${i}, or reinstall via ${M(n,"install")} ${i} <source>).`),c>0&&p.push("Update-check coverage is partial: non-GitHub managed sources were not checked. Inspect their registry or source directly; zero detected updates does not mean these packages are current. Runtime activation health is independent."),d>0&&p.push(`Update-check coverage is partial: some sources have no completed check. Run ${M(n,"manage")} ${i} to request update checks.`),l>0&&p.push(`Update available managed extensions via ${M(n,"install")} ${i} <source>.`),p.length===0&&p.push(`No immediate action required. Re-run ${M(n,"manage")} ${i} after extension changes.`),p}function Xt(e,t,n,a={}){let i=[...new Set(t)].sort((x,z)=>x.localeCompare(z)),r=n.filter(x=>x.managed).length,o=n.filter(x=>x.enabled).length,s=n.filter(x=>x.active).length,d=n.filter(x=>x.update_check_status==="checked"&&x.update_available===!0).length,c=n.filter(x=>x.managed===!1),l=c.filter(x=>Vr(x)).map(x=>x.name).sort((x,z)=>x.localeCompare(z)),p=c.filter(x=>!Vr(x)).map(x=>x.name).sort((x,z)=>x.localeCompare(z)),m={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(let x of n)m[x.update_check_status]+=1;let y=m.failed,g=n.filter(x=>x.update_check_status==="skipped_non_github"&&x.source?.kind!=="builtin").length,_=Object.entries({skipped_unmanaged:p.length,skipped_non_github:g,failed:y,not_checked:m.not_checked}).filter(([,x])=>x>0).map(([x,z])=>`extension_update_health_partial_coverage:${x}:${z}`),u=_.length>0,w=u?"partial":"full",v=[...new Set([...i,..._])].sort((x,z)=>x.localeCompare(z)),E=[...new Set(v.map(x=>no(x)))].sort((x,z)=>x.localeCompare(z)),S=Vl(v),C=e==="global"?"--global":"--project",te=Ql(e,i,n,a),D=tp({normalizedWarnings:v,options:a,scope:e,scopeFlag:C,updateCheckFailedTotal:y,policyWarningCount:S.warning_count,unmanagedActionRequiredTotal:p.length,notCheckedTotal:m.not_checked,skippedNonGithubTotal:g,updateAvailableTotal:d});return{status:v.length===0?"ok":"warn",warning_count:v.length,warning_codes:E,warnings:v,policy_warning_count:S.warning_count,policy_violation_count:S.violation_count,policy_blocked_count:S.blocked_count,total_extensions:n.length,managed_total:r,enabled_total:o,active_total:s,update_available_total:d,update_health_coverage:w,update_health_partial:u,unmanaged_loaded_extension_count:c.length,unmanaged_loaded_extensions:c.map(x=>x.name).sort((x,z)=>x.localeCompare(z)),unmanaged_expected_extension_count:l.length,unmanaged_expected_extensions:l,unmanaged_action_required_extension_count:p.length,unmanaged_action_required_extensions:p,update_check_status_totals:m,update_check_failed_total:y,top_warnings:v.slice(0,8),remediation:D,...te?{collision_plan:te}:{}}}function to(e){if(!e||e.trim().length===0)return"summary";let t=e.trim().toLowerCase();if(t==="summary"||t==="deep")return t;throw new f(`Invalid --detail value "${e}". Expected summary or deep.`,h.USAGE)}function no(e){let t=e.trim(),n=t.indexOf(":");return n===-1?t:t.slice(0,n)}function ao(e){let t=new Set,n=[];for(let a of e){let i=(()=>{let r=$a(a);return r?[r]:Ia(a)})();for(let r of i){let o=`${r.layer}:${r.name}:${r.capability}`;t.has(o)||(t.add(o),n.push(r))}}return n}function io(){return{version:kt.version,capabilities:[...kt.capabilities],legacy_aliases:{...kt.legacy_aliases}}}function Vr(e){let t=b(e.name),n=b(e.directory);return t.startsWith("builtin-")?!0:n==="beads"||n==="todos"}function ro(e,t,n,a,i){if(e!=="project"||i)return{warnings:[],summary:{active_project_count:0,loaded_project_count:0,active_project_names:[],loaded_project_names:[],missing_active_project_names:[]}};let r=[...new Set(t.filter(c=>c.active).map(c=>b(c.name)))].sort((c,l)=>c.localeCompare(l)),o=[...new Set(n.filter(c=>c.layer==="project").map(c=>b(c.name)))].sort((c,l)=>c.localeCompare(l)),s=new Set(a.map(c=>b(c.name))),d=r.filter(c=>!o.includes(c)&&!s.has(c)).sort((c,l)=>c.localeCompare(l));return{warnings:d.length>0?[`extension_doctor_consistency_active_not_loaded:${d.join(",")}`]:[],summary:{active_project_count:r.length,loaded_project_count:o.length,active_project_names:r,loaded_project_names:o,missing_active_project_names:d}}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="eb830963-f036-5f98-ab26-786240b3e0fd")}catch{}})();var qn=async(e,t,n)=>{if(!Number.isInteger(t)||t<1)throw new RangeError("concurrency must be a positive integer");let a=new Array(e.length),i=0,r=Array.from({length:Math.min(t,e.length)},async()=>{for(;i<e.length;){let o=i;i+=1,a[o]=await n(e[o])}});return await Promise.all(r),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]="accde468-de04-51b6-81ad-5c5ea218a87b")}catch{}})();function oo(e,t){let n=b(e),a=t.find(i=>b(i.name)===n);return{command_paths:[...a?.command_paths??[]].sort((i,r)=>i.localeCompare(r)),action_paths:[...a?.action_paths??[]].sort((i,r)=>i.localeCompare(r))}}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="f2cac210-bba0-5c7f-867b-8b59f8d36e11")}catch{}})();function so(e,t){let n=new Set((t?.loaded??[]).flatMap(r=>(r.activation?.commands?.length??0)>0?[`${r.layer}:${b(r.name)}`]:[])),a=e.services.overrides.filter(r=>r.service==="output_format").filter(r=>r.passThrough!==!0).filter(r=>!n.has(`${r.layer}:${b(r.name)}`)).map(r=>`extension_output_service_override_global:${r.service}:${r.layer}:${r.name}`),i=e.renderers.overrides.filter(r=>(r.commands?.length??0)===0&&r.resultDiscriminator===void 0).map(r=>`extension_output_renderer_override_global:${r.format}:${r.layer}:${r.name}`);return[...new Set([...a,...i])].sort((r,o)=>r.localeCompare(o))}(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="a1803149-25ca-5bb0-a178-afa2d85d2ec9")}catch{}})();var co=e=>[...e.registrations.item_fields.flatMap(t=>t.fields.map(n=>({layer:t.layer,extension:t.name,field:n.name}))),...e.registrations.profiles.flatMap(t=>t.profile.fields.map(n=>({layer:t.layer,extension:t.name,field:n.key??""})))].flatMap(t=>{let n=Ct(t.field);return n?[`extension_custom_field_mcp_input_collision:${t.layer}:${t.extension}:${n.field}:${n.property}:${n.owner}:use=${n.nested_path}`]:[]}).filter((t,n,a)=>a.indexOf(t)===n).sort((t,n)=>t.localeCompare(n));import{execFile as np}from"node:child_process";import{promisify as ap}from"node:util";import ip from"npm-package-arg";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="b67e46f9-51ff-501b-98da-74353b4c66d9")}catch{}})();var rp=ap(np),po=1e4;function lo(e,t,n){if(typeof t=="string")try{let a=ip.resolve(e,t);if(a.type==="version")return a.fetchSpec}catch{}throw new Error(n)}async function op(e,t){try{return(await rp(Rn(),e,{encoding:"utf8",timeout:t,maxBuffer:65536,shell:Nn(),env:{...process.env,npm_config_ignore_scripts:"true"}})).stdout.trim()}catch{throw new Error("npm_registry_lookup_failed")}}async function mo(e,t=op){let n=T();try{if(e.kind!=="npm"||!e.package||!/^(?:@[a-zA-Z0-9._-]+\/)?[a-zA-Z0-9._-]+$/u.test(e.package))throw new Error("missing_or_invalid_npm_package_identity");let a=lo(e.package,e.version,"missing_or_invalid_installed_npm_version"),i=await t(["view",e.package,"dist-tags.latest","--json","--ignore-scripts"],po),r;try{r=JSON.parse(i)}catch{throw new Error("invalid_npm_registry_metadata")}let o=Array.isArray(r)&&r.length===1?r[0]:r,s=lo(e.package,o,"invalid_npm_registry_version");return{checked_at:n,available:s!==a,remote_version:s}}catch(a){return{checked_at:n,available:null,error:a instanceof Error?a.message:String(a)}}}var sp=(e,t,n)=>{let a=e.split(/\r?\n/).map(o=>o.trim()).filter(Boolean).map(o=>{let[s,d=""]=o.split(/\s+/);return{commit:s,ref:d}}),i=a.find(o=>o.ref.endsWith("^{}"))??a[0];if(!i)return{checked_at:n,available:null,error:"no_remote_reference_found"};let r=t?.trim();return r?{checked_at:n,remote_commit:i.commit,available:i.commit!==r}:{checked_at:n,remote_commit:i.commit,available:null,error:"missing_installed_commit"}},Wn=async(e,t=Ut)=>{let n=T();if(e.kind!=="github"||!e.repository)return{checked_at:n,available:null,error:"not_a_github_managed_source"};try{let a=[e.ref?.trim(),"HEAD"].find(Boolean),i=await t(["ls-remote",e.repository,a,`${a}^{}`],void 0,po);return sp(i,e.commit,n)}catch(a){return{checked_at:n,available:null,error:a instanceof Error?a.message:String(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]="d34e2cc0-5e58-5534-8480-a9ab47ec4a88")}catch{}})();var cp=4;async function uo(e,t=!1){let n=await qn(e.entries,cp,async a=>{if(!["github","npm"].includes(a.source.kind))return a;if(t)return{...a,last_update_check_at:void 0,last_update_remote_commit:void 0,last_update_remote_version:void 0,update_available:null,update_error:void 0};let i=a.source.kind==="github"?await Wn(a.source):await mo(a.source);return{...a,last_update_check_at:i.checked_at,last_update_remote_commit:"remote_commit"in i?i.remote_commit:void 0,last_update_remote_version:"remote_version"in i?i.remote_version:void 0,update_available:i.available,update_error:i.error}});return{...e,entries:st(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]="17cca82e-e9f9-5633-8d91-bc6c2b560d5f")}catch{}})();function fo(e,t){let n=e.filter(a=>a.result.ok).length;return{installed_all:!t&&n===e.length,installed_count:t?0:n,...t?{dry_run:!0,planned_count:n}:{},failed_count:e.length-n,packages:e.map(({alias:a,result:i})=>{let r=i.details;return{alias:a,ok:i.ok,extension:r.extension,source:r.source,source_resolution:r.source_resolution,install_plan:r.install_plan,dry_run:r.dry_run,destination_path:r.destination_path,activated:r.activated,settings_changed:r.settings_changed,previous_state_preserved:r.previous_state_preserved,rollback:r.rollback,command_paths:r.command_paths,action_paths:r.action_paths,command_discovery:r.command_discovery,verification:r.verification,runtime_activation_status:r.runtime_activation_status,activation_diagnostics:r.activation_diagnostics,warnings:i.warnings}})}}import dp from"node:fs/promises";import lp 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]="955d33c5-8c96-5ed6-bbd1-fc8a26801df4")}catch{}})();function pp(e){return typeof e.name=="string"&&e.name.trim().length>0?e.name.trim():"workspace-manifest"}function mp(e,t){return t.code==="manifest_unknown_key"?`extension_manifest_unknown_key:author:${e}:key=${t.path}${t.suggested_key?`:suggested=${t.suggested_key}`:""}`:`extension_manifest_no_version_bounds:author:${e}:suggested=pm_min_version`}async function up(e){let t=lp.join(e,"manifest.json"),n;try{n=await dp.readFile(t,"utf8")}catch(s){if(xt(s))return{path:t,present:!1,parse_status:"absent",package_metadata_location:"package.json#pm",schema_findings:[],warnings:[],remediation:[]};throw s}let a;try{a=JSON.parse(n)}catch{return{path:t,present:!0,parse_status:"invalid_json",package_metadata_location:"package.json#pm",schema_findings:[],warnings:["extension_author_manifest_invalid_json:manifest.json"],remediation:["Repair manifest.json so it contains one valid JSON object, then rerun pm package doctor --project."]}}if(typeof a!="object"||a===null||Array.isArray(a))return{path:t,present:!0,parse_status:"invalid_shape",package_metadata_location:"package.json#pm",schema_findings:[],warnings:["extension_author_manifest_invalid_shape:manifest.json"],remediation:["Replace manifest.json with one JSON object, then rerun pm package doctor --project."]};let i=a,r=Ta(i),o=pp(i);return{path:t,present:!0,parse_status:"valid",package_metadata_location:"package.json#pm",schema_findings:r.findings,warnings:r.findings.map(s=>mp(o,s)),remediation:r.findings.map(s=>s.message)}}function ho(e){return up(ha(e))}import re from"node:fs/promises";import Qe 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]="7c06c702-29ea-5552-aadc-52dfc9c238ef")}catch{}})();var Bn=async e=>re.readFile(e).catch(t=>{if(Jt(t,"ENOENT"))return null;throw t}),fp=async(e,t,n,a,i)=>Ce("extension_install_backup",async()=>{let r=ot(e),o=ya(t),[s,d]=await Promise.all([Bn(r),Bn(o)]);return a&&await re.cp(n,i,{recursive:!0,force:!0}),{backupDirectory:i,destinationDirectory:n,destinationExists:a,managedStatePath:r,managedStateContents:s,settingsPath:o,settingsContents:d}}),go=async e=>Ce("extension_install_rollback",async()=>{await re.rm(e.destinationDirectory,{recursive:!0,force:!0}),e.destinationExists&&await re.cp(e.backupDirectory,e.destinationDirectory,{recursive:!0,force:!0});for(let[t,n]of[[e.managedStatePath,e.managedStateContents],[e.settingsPath,e.settingsContents]])if(n===null)await re.rm(t,{force:!0});else if(t===e.settingsPath){let a=Qe.dirname(e.settingsPath),i=await A(a);try{await ke({pmRoot:a,filePath:t,raw:n.toString("utf8"),op:"extension:install:rollback",author:q(void 0,i.author_default),lockTtlSeconds:i.locks.ttl_seconds,lockWaitMs:i.locks.wait_ms})}finally{Ma(a)}}else await re.mkdir(Qe.dirname(t),{recursive:!0}),await re.writeFile(t,n)});async function yo(e,t){let n=await k(e.destinationDirectory),a=await Ze(e.sourceDirectory,e.destinationDirectory);await re.mkdir(e.selectedRoot,{recursive:!0});let i=Qe.join(Qe.dirname(e.selectedRoot),"runtime","extension-installs");await re.mkdir(i,{recursive:!0});let r=await re.mkdtemp(Qe.join(i,".pm-extension-install-backup-")),o=Qe.join(r,"destination"),s=["package","install",o,`--${e.scope}`],d=oe(s),c=!1;try{let l=await fp(e.selectedRoot,e.settingsRoot,e.destinationDirectory,n,o),p;try{p=await t()}catch(m){try{await go(l)}catch(y){c=!0;let g=new f(`Extension install failed: ${String(m)}; rollback failed: ${String(y)}`,h.GENERIC_FAILURE,{code:"extension_install_rollback_failed",original_code:m instanceof f?m.code:void 0,required:"Restore the previous package before retrying the replacement. Previous state was not preserved.",nextSteps:[n?d:"Repair the reported metadata write failure, then retry the original install."],...n?{recovery:{suggested_retry:d,suggested_retry_args:s}}:{}});throw Object.defineProperty(g,"cause",{value:m,configurable:!0,writable:!0}),g}throw m}if(p.ok)return p;if(!n||a)return{...p,details:{...p.details,previous_state_preserved:!1}};try{await go(l)}catch(m){return c=!0,{...p,details:{...p.details,previous_state_preserved:!1,rollback:{status:"failed",error:String(m),backup_directory:o,recovery_command:d,recovery_args:s}}}}return{...p,details:{...p.details,overwritten:!1,settings_changed:!1,previous_state_preserved:!0,rollback:{status:"restored"}}}}finally{c||await re.rm(r,{recursive:!0,force:!0}).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]="6ae11424-9de8-5bce-91b4-e8901459fb5f")}catch{}})();var bo=[["install","install","--install"],["uninstall","uninstall","--uninstall"],["explore","explore","--explore"],["list","explore","--explore"],["manage","manage","--manage"],["describe","describe","--describe"],["reload","reload","--reload"],["doctor","doctor","--doctor"],["catalog","catalog","--catalog"],["init","init","--init"],["scaffold","init","--scaffold"],["adopt","adopt","--adopt"],["adopt-all","adopt-all","--adopt-all"],["activate","activate","--activate"],["deactivate","deactivate","--deactivate"],["migrate","migrate","--migrate"]],hp=bo.map(([,,e])=>e).filter((e,t,n)=>n.indexOf(e)===t).join(", "),gp={install:"--install",uninstall:"--uninstall",explore:"--explore",manage:"--manage",describe:"--describe",reload:"--reload",doctor:"--doctor",catalog:"--catalog",adopt:"--adopt","adopt-all":"--adopt-all",activate:"--activate",deactivate:"--deactivate",migrate:"--migrate",init:"--init"},yp="__pm_native_output",_p=["trusted_extensions","allowed_extensions","blocked_extensions","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],ko=["allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"],wp=["disabled","require_trusted","require_provenance"],xo={mode:"off",trust_mode:"off",require_provenance:!1,trusted_extensions:[],default_sandbox_profile:"none",allowed_extensions:[],blocked_extensions:[],allowed_capabilities:[],blocked_capabilities:[],allowed_surfaces:[],blocked_surfaces:[],allowed_commands:[],blocked_commands:[],allowed_actions:[],blocked_actions:[],allowed_services:[],blocked_services:[],extension_overrides:[]},vp=e=>{let t=e??xo,n={};for(let a of _p)n[a]=Z(t[a]??[]);return n},bp=(e,t)=>{for(let n of ko)t[n].length>0&&(e[n]=t[n]);return e},kp=(e,t)=>{for(let n of wp)t[n]===!0&&(e[n]=!0);return t.sandbox_profile&&(e.sandbox_profile=t.sandbox_profile),e},xp=e=>{let t={};for(let n of ko)t[n]=Z(e[n]??[]);return t},Sp=e=>{let t=typeof e.name=="string"?e.name.trim():"";return t.length===0?null:bp(kp({name:t},e),xp(e))},Ep=e=>(e??[]).map(t=>Sp(t)).filter(t=>t!==null).sort((t,n)=>t.name.localeCompare(n.name)),$p=e=>{let t=Object.assign({},xo,e??{}),n=vp(e),a=Ep(t.extension_overrides);return{mode:t.mode,trust_mode:t.trust_mode,require_provenance:t.require_provenance===!0,trusted_extensions:n.trusted_extensions,default_sandbox_profile:t.default_sandbox_profile,allowed_extensions:n.allowed_extensions,blocked_extensions:n.blocked_extensions,allowed_capabilities:n.allowed_capabilities,blocked_capabilities:n.blocked_capabilities,allowed_surfaces:n.allowed_surfaces,blocked_surfaces:n.blocked_surfaces,allowed_commands:n.allowed_commands,blocked_commands:n.blocked_commands,allowed_actions:n.allowed_actions,blocked_actions:n.blocked_actions,allowed_services:n.allowed_services,blocked_services:n.blocked_services,extension_overrides:a}},So=async(e,t)=>{let n=[t],a=await Yi(t);a&&n.push(a);let i=[...new Set(n.map(r=>b(r)).filter(r=>r.length>0))];for(let r of i){let o=e.find(d=>b(d.name)===r);if(o)return o;let s=e.find(d=>b(d.directory)===r);if(s)return s}},Eo=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled));return new Set(Z(e.extensions.disabled)).has(n)?!1:a.size===0?!0:a.has(n)},$o=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return i.delete(n),a.size>0&&a.add(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},Ip=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return a.delete(n),i.add(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},Ap=(e,t)=>{let n=t.trim(),a=new Set(Z(e.extensions.enabled)),i=new Set(Z(e.extensions.disabled)),r=[...a],o=[...i];return a.delete(n),i.delete(n),e.extensions.enabled=[...a].sort((s,d)=>s.localeCompare(d)),e.extensions.disabled=[...i].sort((s,d)=>s.localeCompare(d)),e.extensions.enabled.join("\0")!==r.join("\0")||e.extensions.disabled.join("\0")!==o.join("\0")},Tp=e=>{let t=e.trim().toLowerCase(),n=Math.min(2,Math.max(1,Math.ceil(t.length/4))),a=bo.map(([i,r,o])=>({action:r,flag:o,distance:Ea(t,i,n)})).filter(i=>i.distance!==null).sort((i,r)=>i.distance-r.distance)[0];return a?{action:a.action,flag:a.flag}:null},Op=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",a=Tp(e);if(!a)return new f(`One action flag is required. Use one of: ${hp}. Bare \`pm package\` and \`pm extension\` default to --explore.`,h.USAGE);let i=`pm ${n} ${a.flag}`;return Ha({command_path:n,display_name:`${n} lifecycle`,token_kind:"action",token:e,allowed:Object.keys(Io),retry_command:i,message_suffix:`. Did you mean "${a.flag}"?`,fallback_candidates:[{source:"lifecycle_action",command:i,reason:`nearest lifecycle action for "${e}"`}]})},Cp=[["install","install"],["uninstall","uninstall"],["explore","explore"],["manage","manage"],["describe","describe"],["reload","reload"],["doctor","doctor"],["catalog","catalog"],["init","init"],["scaffold","init"],["adopt","adopt"],["adoptAll","adopt-all"],["activate","activate"],["deactivate","deactivate"],["migrate","migrate"]],Io={doctor:"doctor",reload:"reload",catalog:"catalog",init:"init",scaffold:"init",explore:"explore",manage:"manage",migrate:"migrate",list:"explore","":"explore"},Pp=e=>Io[e]??null,Rp=(e,t)=>{let n=[...new Set(Cp.filter(([a])=>t[a]===!0).map(([,a])=>a))];if(n.length===0){if(e===void 0)return"explore";let a=Pp(e.trim().toLowerCase());if(a)return a;throw Op(e,t)}if(n.length>1)throw new f("Extension action flags are mutually exclusive.",h.USAGE);return n[0]},Np=e=>{let t=e.project===!0||e.local===!0,n=e.global===!0;if(t&&n)throw new f('Options "--project/--local" and "--global" are mutually exclusive.',h.USAGE);return n?"global":"project"},Dp=[e=>e?null:{status:"skipped_unmanaged",reason:"extension_not_managed"},e=>e&&!["github","npm"].includes(e.source.kind)?{status:"skipped_non_github",reason:`managed_source_kind_${e.source.kind}`}:null,e=>{let t=typeof e?.update_error=="string"?e.update_error.trim():"";return t.length>0?{status:"failed",reason:t}:null},e=>{let t=e;return(typeof t.last_update_check_at=="string"?t.last_update_check_at.trim():"").length===0?null:{status:"checked",reason:{true:"update_available",false:"up_to_date"}[String(t.update_available)]??"checked_without_commit_baseline"}}],Ao=e=>{for(let t of Dp){let n=t(e);if(n)return n}return{status:"not_checked",reason:"no_update_check_recorded"}},To=(e,t,n,a)=>{let i=n??{};return{name:e.name,directory:e.directory,version:e.version,entry:e.entry,scope:t,active:e.enabled,enabled:e.enabled,runtime_active:null,activation_status:"unknown",contributions:i.contributions,managed:!!n,source:i.source,update_available:i.update_available,last_update_check_at:i.last_update_check_at,last_update_remote_commit:i.last_update_remote_commit,last_update_remote_version:i.last_update_remote_version,update_error:i.update_error,update_check_status:a.status,update_check_reason:a.reason}},jp=(e,t,n,a)=>{let i=Object.assign({name:e,manifest_version:"unknown",manifest_entry:"unknown"},a),r=a?Eo(n,a.name):!1;return{warning:`extension_manifest_missing:${t}:${e}`,summary:To({name:i.name,directory:e,version:i.manifest_version,entry:i.manifest_entry,enabled:r},t,a,Ao(a))}},Lp=async(e,t,n,a,i,r)=>{let o=ee.join(e,t),s=ee.join(o,"manifest.json"),d=r.get(b(t));if(!await k(s))return jp(t,n,a,d);let c=Symbol("invalid-extension-manifest-json"),l=await et.readFile(s,"utf8").then(y=>JSON.parse(y)).catch(()=>c);if(l===c)return{warning:`extension_manifest_invalid_json:${n}:${t}`};let p=En(l);if(!p)return{warning:`extension_manifest_invalid:${n}:${t}`};let m=i.get(b(p.name))??r.get(b(t));return{summary:To({name:p.name,directory:t,version:p.version,entry:p.entry,enabled:Eo(a,p.name)},n,m,Ao(m))}},pe=async(e,t,n,a)=>{if(!await k(e))return{extensions:[],warnings:[]};let i=(await et.readdir(e,{withFileTypes:!0})).filter(c=>c.isDirectory()).map(c=>c.name).sort((c,l)=>c.localeCompare(l)),r=new Map(a.entries.map(c=>[b(c.name),c])),o=new Map(a.entries.map(c=>[b(c.directory),c])),s=[],d=[];for(let c of i){let l=await Lp(e,c,t,n,r,o);l.warning&&s.push(l.warning),l.summary&&d.push(l.summary)}return{extensions:d.sort((c,l)=>c.name.localeCompare(l.name)),warnings:s.sort((c,l)=>c.localeCompare(l))}},Fp=Ca(),Mp=(e,t)=>[t.package,t.kind==="builtin"?t.name:void 0].find(n=>n?.trim())?.trim()??e,Up=(e,t,n,a)=>{let i=n.command_paths.map(s=>`pm ${s} --help`),r=a?.error.toLowerCase().includes("@unbrained/pm-cli")===!0,o=n.command_paths.length>0?[...i]:["Run pm package doctor --project --detail deep if expected package commands are missing."];return r&&o.unshift("Install @unbrained/pm-cli in the target workspace so declarative package runtime imports resolve, then reinstall the package."),{package_name:Mp(e,t),extension_name:e,command_paths:n.command_paths,action_paths:n.action_paths,help_commands:i,next_steps:o,...r?{sdk_dependency_status:"missing"}:{}}},zp=e=>{let t=e.trace,n={layer:e.layer,name:e.name,entry_path:e.entry_path,error:e.error};return t&&(n.trace=Object.fromEntries(Object.entries(t).filter(([,a])=>a!==void 0)),t.missing_capability&&(n.missing_capability=t.missing_capability),t.hint&&(n.hint=t.hint)),n},Oo=e=>e.map(t=>zp(t)).sort((t,n)=>`${t.layer}:${t.name}`.localeCompare(`${n.layer}:${n.name}`)),Co=(e,t,n)=>{let a=b(e);return t.find(i=>(n===void 0||i.layer===n)&&b(i.name)===a)},Gp=(e,t,n,a)=>n.find(i=>i.scope===t&&b(i.name)===b(e))?.activation_status??(a?"failed":"unknown"),Po=(e,t,n,a,i)=>Fp.enqueue(async()=>{let r=process.env.PM_CLI_PACKAGE_ROOT,o=await et.mkdtemp(ee.join(t,".pm-module-graph-"));process.env.PM_CLI_PACKAGE_ROOT=we(import.meta.url,["../.."]);try{let s=await ve({pmRoot:e,settings:n,cwd:process.cwd(),noExtensions:i.noExtensions===!0,reload_token:pn(),cache_bust:!0,module_graph_snapshot_root:o}),d=await be({...s}),c=[...s.failed.map(p=>({layer:p.layer,name:p.name,entry_path:p.entry_path,error:p.error})),...Oo(d.failed)],l=Object.fromEntries(s.loaded.map(p=>[b(p.name),Sa(Ge(d,{extensionName:p.name}))]));return{installed:Yt(a,s,d),warnings:[...s.warnings,...d.warnings],activation_failures:c,extensions_disabled:s.disabled_by_flag,item_type_registrations:d.registrations.item_types,contribution_inventories:l}}finally{await et.rm(o,{recursive:!0,force:!0}),r===void 0?delete process.env.PM_CLI_PACKAGE_ROOT:process.env.PM_CLI_PACKAGE_ROOT=r}}),Kn=async(e,t,n,a)=>{let i=n.filter(d=>!d.managed),r=[...i].sort((d,c)=>{let l=d.name.localeCompare(c.name);return l!==0?l:d.directory.localeCompare(c.directory)}),o=a,s=[];for(let d of r){let c=ee.join(e,d.directory),l=await Ye(c),p=T(),m={kind:"local",input:d.name,location:c};o=ct(o,{name:l.manifest.name,directory:d.directory,scope:t,manifest_version:l.manifest.version,manifest_entry:l.manifest.entry,capabilities:[...l.manifest.capabilities],contributions:l.manifest.contributions,installed_at:p,updated_at:p,source:m}),s.push({name:l.manifest.name,directory:d.directory,version:l.manifest.version,entry:l.manifest.entry,source:m})}return s.length>0&&await Xe(e,o),{state:o,adopted_entries:s,unmanaged_candidates:r,already_managed_count:n.length-i.length}},Jp=(e,t)=>{let n=F(process.cwd(),t.path),a=$t(n,process.cwd()),i=e==="global"?ga(process.cwd()):n,r=e==="global"?a.global:a.project;return{pm_root:n,scope:e,settings_root:i,selected_root:r,roots:a}},Zt=e=>{let t=[e.gh,e.github].filter(a=>typeof a=="string").map(a=>a.trim()).filter(Boolean),n=[...new Set(t)];if(n.length>1)throw new f('Options "--gh" and "--github" must match when both are provided.',h.USAGE);return n[0]},qp=e=>gp[e],Wp=(e,t)=>{let n=t.vocabulary==="package"?"package":"extension",a=e==="install"?"source":"name",i=`${n} ${a}`,r=qp(e),o=`<${a}>`,s=`pm ${n} ${r} ${o}`;throw new f(`Action "${e}" requires ${i} input.`,h.USAGE,{code:"missing_lifecycle_target",required:`Provide a ${a} target for ${e}.`,examples:[`pm ${n} ${e} ${o}`,s,`pm ${n} --help`],recovery:{attempted_command:`pm ${n} ${e}`,suggested_retry:s,fallback_candidates:[{source:"lifecycle_action",command:s,reason:`flag-form ${e} command with required ${a} target`}]}})},Qt=(e,t,n={})=>{let a=e?.trim();if(a)return a;if(t==="init")throw new f('Action "init" requires a scaffold target path (for example: pm package init ./my-package or pm extension init ./my-extension).',h.USAGE);return Wp(t,n)},Bp=(e,t)=>{let n=new Set([...t.registrations.item_types.map(a=>({entry:a,count:a.types.length})),...t.registrations.item_fields.map(a=>({entry:a,count:a.fields.length}))].filter(({count:a})=>a>0).map(({entry:a})=>`${a.layer}:${b(a.name)}`));return e.loaded.filter(a=>(a.activation?.commands??[]).length>0).filter(a=>n.has(`${a.layer}:${b(a.name)}`)).map(a=>`extension_schema_narrow_activation:${a.layer}:${a.name}`).filter((a,i,r)=>r.indexOf(a)===i).sort((a,i)=>a.localeCompare(i))},Hp=(e,t)=>{let n=[{triggered:t.strictExit===!0||t.failOnWarn===!0,allowed:e==="doctor",message:"--strict-exit and --fail-on-warn are only valid with --doctor."},{triggered:t.trace===!0,allowed:e==="doctor",message:"--trace is only valid with --doctor."},{triggered:t.watch===!0,allowed:e==="reload",message:"--watch is only valid with --reload."},{triggered:t.runtimeProbe===!0,allowed:e==="manage",message:"--runtime-probe is only valid with --manage."},{triggered:t.fixManagedState===!0,allowed:e==="manage"||e==="doctor",message:"--fix-managed-state is only valid with --manage or --doctor."},{triggered:t.isolated===!0||t.ignoreGlobal===!0,allowed:e==="doctor",message:"--isolated and --ignore-global are only valid with --doctor."},{triggered:t.capability!==void 0,allowed:e==="init",message:"--capability is only valid with --init/--scaffold."},{triggered:t.declarative===!0,allowed:e==="init",message:"--declarative is only valid with --init/--scaffold."},{triggered:t.dryRun===!0,allowed:e==="migrate"||e==="install",message:"--dry-run is only valid with --migrate or --install."}].find(a=>a.triggered&&!a.allowed);if(n)throw new f(n.message,h.USAGE)},Kp=(e,t,n)=>{let a=String(e??"").trim().toLowerCase(),i=[n.init,n.scaffold].includes(!0);return({doctor:["doctor"],reload:["reload"],catalog:["catalog"],init:i?[]:["init","scaffold"]}[t]??[]).includes(a)?void 0:e},Vp=e=>[e.action==="catalog",typeof e.options.fields=="string",String(e.options.fields).trim().length>0].every(Boolean)?{project:"project",global:"global",selected:e.scope,settings_root:"project"}:{project:e.resolvedRoots.roots.project,global:e.resolvedRoots.roots.global,selected:e.resolvedRoots.selected_root,settings_root:e.resolvedRoots.settings_root},Yp=(e,t,n)=>{let a={ok:n,action:e.action,scope:e.scope,roots:Vp(e),warnings:[...new Set(e.warnings)].sort((i,r)=>i.localeCompare(r)),details:t};return e.action==="doctor"&&Object.defineProperty(a,yp,{value:!0,enumerable:!1,configurable:!1}),a},Vn=async(e,t,n)=>{let a=Rp(e,t);Hp(a,t);let i=Kp(e,a,t),r=Np(t),o=Jp(r,n),s={action:a,normalizedTarget:i,scope:r,resolvedRoots:o,warnings:[],options:t,global:n},d={...s,withResult:(c,l=!0)=>Yp(s,c,l)};return await Tm(d)},Xp=(e,t)=>{let n=t.vocabulary??"extension",a=e.target_path.replace(/\\/g,"/"),i=Na(a),r={package:`Install dependencies: cd ${i}, then run "npm install"`,extension:`Install type-check dependencies: cd ${i}, then run "npm install -D typescript @types/node @unbrained/pm-cli"`},o={package:`Validate the package: cd ${i}, then run "npm run typecheck" and "npm test"`,extension:`Type-check the source (optional): cd ${i}, then run "npx tsc --noEmit"`},s=[];return[n==="package",t.declarative===!0].every(Boolean)&&s.push("Ensure the target workspace can resolve @unbrained/pm-cli before installing this declarative package."),[r[n],...s,`Install the scaffold: ${oe(n==="package"?["install","--project",a]:["extension","--install","--project",a])}`,`Smoke-test command path: pm ${e.command_name}`,o[n],`Run diagnostics: ${n==="package"?"pm package doctor":"pm extension --doctor"} --project --detail summary`]},Zp=async e=>{let{action:t,normalizedTarget:n,options:a,withResult:i}=e;if([Zt(a),a.ref].filter(s=>typeof s=="string").map(s=>s.trim()).filter(Boolean).length>0)throw new f('Action "init" does not accept --gh/--github/--ref options.',h.USAGE);let r=Qt(n,t,a),o=await _r(r,a.vocabulary??"extension",a.capability,a.declarative===!0);return i({scaffolded:o.created_directory||o.files.some(s=>s.status==="created"),extension:{name:o.extension_name,command:o.command_name},capability:o.capability,style:o.style,target_path:o.target_path,created_directory:o.created_directory,files:o.files,next_steps:Xp(o,a)})},Qp=async e=>{let{normalizedTarget:t,resolvedRoots:n,warnings:a,options:i,global:r,withResult:o}=e;if(t!==void 0)throw new f('Action "reload" does not accept a target argument.',h.USAGE);let s=await A(n.settings_root),d=pn(),c=await ve({pmRoot:n.settings_root,settings:s,cwd:process.cwd(),noExtensions:r.noExtensions,reload_token:d,cache_bust:!0});a.push(...c.warnings);let l=await be(c);a.push(...l.warnings);let p={reload:{token:d,cache_bust:!0,watch:i.watch===!0},loaded_count:c.loaded.length,failed_count:c.failed.length,activated_count:Math.max(0,c.loaded.length-l.failed.length),activation_failed_count:l.failed.length,loaded_extensions:c.loaded.map(m=>({name:m.name,layer:m.layer,version:m.version})),failed_extensions:c.failed.map(m=>({name:m.name,layer:m.layer,error:m.error})),activation_failures:l.failed.map(m=>({name:m.name,layer:m.layer,error:m.error}))};return i.watch===!0&&a.push("extension_reload_watch_hint:watch_mode_requested_non_interactive_single_pass_only"),o(p)},em=async e=>{let{normalizedTarget:t,scope:n,options:a,global:i,withResult:r}=e;if(typeof t=="string"&&t.length>0&&t!=="catalog")throw new f('Action "catalog" does not accept a package target.',h.USAGE);return r(await Xi(n,i,a))},tm=(e,t)=>({kind:"builtin",input:e,location:e,name:e,...t===null?{}:{package:t}}),nm=e=>({kind:"local",input:e.input,location:e.absolute_path}),am=(e,t)=>({kind:"npm",input:e.input,location:t.resolved_subpath??".",package:t.npm_package,version:t.npm_version}),im=(e,t)=>({kind:"github",input:e.input,location:t.resolved_subpath??e.subpath??".",repository:e.repository,owner:e.owner,repo:e.repo,ref:e.ref,subpath:t.resolved_subpath??e.subpath,commit:t.commit}),rm=(e,t,n,a)=>e?tm(e,t):n.kind==="local"?nm(n):n.kind==="npm"?am(n,a):im(n,a),om=(e,t,n,a)=>e?e.manifest_version!==t?{installed_at:e.installed_at,updated_at:a}:qi(e.source,n)?{installed_at:e.installed_at,updated_at:e.updated_at}:{installed_at:e.installed_at,updated_at:a}:{installed_at:a,updated_at:a},sm=async(e,t)=>{let{scope:n,resolvedRoots:a,warnings:i}=e,{validated:r,destinationDirectoryName:o}=t,s=await A(a.settings_root),d=await de(a.selected_root);i.push(...d.warnings);let c=ee.join(a.selected_root,o),l=await k(c),p=await Ze(r.directory,c);await et.mkdir(a.selected_root,{recursive:!0});let m=rm(t.bundledAliasName,t.bundledPackageName,t.installSource,t.resolvedSource),y=d.state.entries.find(w=>b(w.name)===b(r.manifest.name)),g=om(y,r.manifest.version,m,T()),_=ct(d.state,{name:r.manifest.name,directory:o,scope:n,manifest_version:r.manifest.version,manifest_entry:r.manifest.entry,capabilities:[...r.manifest.capabilities],contributions:r.manifest.contributions,...g,source:m}),u=$o(s,r.manifest.name);return p||await Pr(r.directory,c),await Tr(c),await Or(c),await Xe(a.selected_root,_),u&&await xe(a.settings_root,s,"settings:write"),{settings:s,managedState:_,sourceRecord:m,destinationDirectory:c,destinationExists:l,installInPlace:p,activationChanged:u}},cm=async(e,t,n)=>{let a=n.filter(i=>b(i.name)===b(t)).flatMap(i=>i.types.map(r=>({name:r.name,folder:r.folder})));return e.scope==="project"&&a.length>0&&await yt(e.resolvedRoots.pm_root,a,e.warnings,"install:type-folder"),a},dm=(e,t,n,a,i)=>{let r=Co(t,n.activation_failures,e.scope),o=Gp(t,e.scope,n.installed,r),s=[!n.extensions_disabled,o==="ok"].every(Boolean);s||e.warnings.push(`extension_install_activation_failed:${e.scope}:${t}:${o}`);let d={true:{status:"ok",blocking_failure_count:0},false:{status:"degraded",blocking_failure_count:1}};return{activated:s,status:o,failure:r,verification:{status:d[String(s)].status,target_pm_root:e.resolvedRoots.pm_root,activation_status:o,activated:s,registered_commands:a.command_paths,registered_actions:a.action_paths,registered_item_types:i,module_graph_verification:"fresh_in_topology_snapshot",health:d[String(s)]}}},lm=async(e,t)=>{let{scope:n,resolvedRoots:a,warnings:i,global:r,withResult:o}=e,{validated:s,destinationDirectoryName:d}=t;return yo({selectedRoot:a.selected_root,settingsRoot:a.settings_root,destinationDirectory:ee.join(a.selected_root,d),sourceDirectory:s.directory,scope:n},async()=>{let c=await sm(e,t),l=await pe(a.selected_root,n,c.settings,c.managedState);i.push(...l.warnings);let p=await Po(a.pm_root,ee.dirname(a.selected_root),c.settings,l.extensions,r);i.push(...p.warnings);let m=await cm(e,s.manifest.name,p.item_type_registrations),y=oo(s.manifest.name,p.installed),g=dm(e,s.manifest.name,p,y,m),_=p.contribution_inventories[b(s.manifest.name)];return _&&(c.managedState=await Wi(a.selected_root,c.managedState,s.manifest.name,_)),o({extension:{name:s.manifest.name,version:s.manifest.version,entry:s.manifest.entry,capabilities:s.manifest.capabilities,directory:d},source:c.sourceRecord,source_resolution:t.sourceResolution,...t.installPlan?{install_plan:t.installPlan}:{},destination_path:c.destinationDirectory,overwritten:[c.destinationExists,!c.installInPlace].every(Boolean),installed_in_place:c.installInPlace,activated:g.activated,settings_changed:c.activationChanged,runtime_activation_status:g.status,command_paths:y.command_paths,action_paths:y.action_paths,contributions:_,command_discovery:Up(s.manifest.name,c.sourceRecord,y,g.failure),verification:g.verification,activation_diagnostics:{failed_count:p.activation_failures.length,failed:p.activation_failures,installed_extension_failed:g.failure??null}},g.activated)})},pm=async e=>{let{options:t,global:n,warnings:a,withResult:i}=e;if(typeof t.ref=="string"&&t.ref.trim().length>0)throw new f('Action "install all" does not accept --ref.',h.USAGE);let r=[],o=new Map;for(let s of await Mt()){let d=await dt(s),c=ee.resolve(d),l=o.get(c);l===void 0&&(l=await Vn(s,{...t,install:!0},n),o.set(c,l)),r.push({alias:s,result:l})}return a.push(...r.flatMap(s=>s.result.warnings)),i(fo(r,t.dryRun===!0),r.every(s=>s.result.ok))},mm=async(e,t,n)=>{let{resolvedRoots:a}=e,{bundledAliasName:i,bundledPackageName:r,installSource:o,sourceResolution:s}=await jr(t,n,e.options.ref,(await de(a.selected_root)).state.entries);if(s.ambiguous){let c=s.candidates.find(l=>l.kind==="npm");e.warnings.push(`extension_install_source_ambiguous:${t}:builtin:${i}:npm:${c.package}`)}let d=await or(o);try{let c=await Ye(d.directory,{source_kind:o.kind,source_input:o.input,source_root:d.source_root}),l=Lt(c.manifest.name),p=e.options.dryRun===!0||o.kind==="local"&&i===null?await Nr(d,ee.join(a.selected_root,l),e.scope,e.options.copyPlan):void 0;return e.options.dryRun===!0?e.withResult({dry_run:!0,installed:!1,activated:!1,extension:{name:c.manifest.name,version:c.manifest.version},source_resolution:s,install_plan:p}):await Un(a.settings_root,l,()=>lm(e,{validated:c,destinationDirectoryName:l,bundledAliasName:i,bundledPackageName:r,sourceResolution:s,installSource:o,resolvedSource:d,installPlan:p}))}finally{d.cleanup&&await d.cleanup()}},um=async e=>{let t=Zt(e.options),n=t??Qt(e.normalizedTarget,e.action,e.options);return[t===void 0,Hi(n)].every(Boolean)?pm(e):mm(e,n,t)},fm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,withResult:o}=e;if(t!==void 0)throw new f('Action "adopt-all" does not accept a target argument.',h.USAGE);if(Zt(r)!==void 0||typeof r.ref=="string"&&r.ref.trim().length>0)throw new f('Action "adopt-all" does not accept --gh/--github/--ref options.',h.USAGE);let s=await A(a.settings_root),d=await de(a.selected_root);i.push(...d.warnings);let c=await pe(a.selected_root,n,s,d.state);i.push(...c.warnings);let l=await Kn(a.selected_root,n,c.extensions,d.state),p=await pe(a.selected_root,n,s,l.state);i.push(...p.warnings);let m=Xt(n,i,p.extensions,r);i.push(...m.warnings);let y=new Map(p.extensions.map(u=>[`${b(u.name)}:${b(u.directory)}`,u])),g=new Map(p.extensions.map(u=>[b(u.directory),u])),_=l.adopted_entries.map(u=>{let w=b(u.directory),v=y.get(`${b(u.name)}:${w}`)??g.get(w);return{...u,...Ro(v)}});return o({adopted_all:_.length>0,adopted_count:_.length,already_managed_count:l.already_managed_count,extensions:_,triage:m,warning_codes:m.warning_codes,update_health_partial:m.update_health_partial,update_health_coverage:m.update_health_coverage})},Ro=e=>({update_check_status:e?.update_check_status??null,update_check_reason:e?.update_check_reason??null}),hm=(e,t,n,a)=>{if(e===void 0)return{kind:"local",input:t,location:n};let i=lt(e,{forceGithub:!0,ref:a});if(i.kind!=="github")throw new f(`Invalid GitHub shorthand "${e}".`,h.USAGE);return{kind:"github",input:i.input,location:i.subpath??".",repository:i.repository,owner:i.owner,repo:i.repo,ref:i.ref,subpath:i.subpath}},gm=async e=>{let{action:t,normalizedTarget:n,scope:a,resolvedRoots:i,warnings:r,options:o,withResult:s}=e,d=Qt(n,t,o),c=Zt(o),l=await A(i.settings_root),p=await de(i.selected_root);r.push(...p.warnings);let m=await pe(i.selected_root,a,l,p.state);r.push(...m.warnings);let y=await So(m.extensions,d);if(!y)throw new f(`Installed extension "${d}" was not found in ${a} scope.`,h.NOT_FOUND);if(y.managed)return s({adopted:!1,already_managed:!0,extension:{name:y.name,directory:y.directory}});let g=ee.join(i.selected_root,y.directory),_=await Ye(g),u=T(),w=hm(c,d,g,o.ref),v=ct(p.state,{name:_.manifest.name,directory:y.directory,scope:a,manifest_version:_.manifest.version,manifest_entry:_.manifest.entry,capabilities:[..._.manifest.capabilities],contributions:_.manifest.contributions,installed_at:u,updated_at:u,source:w});await Xe(i.selected_root,v);let E=await pe(i.selected_root,a,l,v);r.push(...E.warnings);let S=E.extensions.find(C=>b(C.name)===b(_.manifest.name))??E.extensions.find(C=>b(C.directory)===b(y.directory));return s({adopted:!0,extension:{name:_.manifest.name,directory:y.directory,version:_.manifest.version,entry:_.manifest.entry},source:w,...Ro(S)})},No=async e=>{let{action:t,normalizedTarget:n,scope:a,resolvedRoots:i,warnings:r,options:o}=e,s=Qt(n,t,o),d=await A(i.settings_root),c=await de(i.selected_root);r.push(...c.warnings);let l=await pe(i.selected_root,a,d,c.state);r.push(...l.warnings);let p=await So(l.extensions,s);if(!p)throw new f(`Installed extension "${s}" was not found in ${a} scope.`,h.NOT_FOUND);return{settings:d,managedStateRead:c,candidate:p}},ym=async e=>{let{resolvedRoots:t,withResult:n}=e,{settings:a,managedStateRead:i,candidate:r}=await No(e),o=ee.join(t.selected_root,r.directory);await et.rm(o,{recursive:!0,force:!0});let s={...i.state,updated_at:T(),entries:i.state.entries.filter(c=>b(c.name)!==b(r.name)&&b(c.directory)!==b(r.directory))};await Xe(t.selected_root,s);let d=Ap(a,r.name);return d&&await xe(t.settings_root,a,"settings:write"),n({removed:!0,extension:{name:r.name,directory:r.directory},destination_path:o,settings_changed:d})},_o=async e=>{let{action:t,resolvedRoots:n,warnings:a,global:i,withResult:r}=e,{settings:o,candidate:s}=await No(e),d=t==="activate"?$o(o,s.name):Ip(o,s.name);d&&await xe(n.settings_root,o,"settings:write");let c=t==="activate"?await Po(n.pm_root,ee.dirname(n.selected_root),o,[s],i).then(l=>(a.push(...l.warnings),Co(s.name,l.activation_failures,e.scope))):void 0;return c&&a.push(`extension_activate_failed:${e.scope}:${s.name}`),r({extension:{name:s.name,directory:s.directory},active:t==="activate"&&c===void 0,runtime_active:t==="activate"&&c===void 0,activation_failure:c??null,settings_changed:d,settings:{enabled:[...o.extensions.enabled],disabled:[...o.extensions.disabled]}},c===void 0)},_m=(e,t,n,a,i,r)=>{let o=a==="package"?"package":"extension",s={package:"doctor",extension:"--doctor"}[o],d=i?.adopted_entries.length??0,c=[[r!==null,r??""],[t>0,`Run pm ${o} explore --project and pm ${o} explore --global to inspect load failures.`],[n>0,`Review activation failures in pm ${o} ${s} --detail deep output.`],[d>0,`Managed-state fix adopted ${d} extension(s).`]];return[...new Set([...e,...c.filter(([l])=>l).map(([,l])=>l)].map(l=>l.trim()).filter(l=>l.length>0))]},Hn=e=>e.loaded.some(t=>t.layer==="global")||e.failed.some(t=>t.layer==="global")||e.warnings.some(t=>t.includes(":global:")),wm=(e,t,n,a)=>{if(e!=="project"||t||!Hn(a))return null;let i=n==="package"?"package":"extension";return`Global ${i} registrations are included in project diagnostics. For hermetic ${i} smoke tests, rerun pm ${i} doctor --project --isolated --detail deep --trace, or set PM_GLOBAL_PATH to a temporary directory for the whole test process.`},vm=(e,t,n)=>{if(String(e??"").trim().length>0)throw new f('Action "doctor" does not accept a target argument.',h.USAGE);let a=[n.isolated,n.ignoreGlobal].includes(!0);if([a,t==="global"].every(Boolean))throw new f("--isolated and --ignore-global are only valid with project-scope doctor diagnostics.",h.USAGE);let i=to(n.detail),r=n.trace===!0;if([r,i!=="deep"].every(Boolean))throw new f("--trace requires --detail deep with --doctor.",h.USAGE);return{isolated:a,detailMode:i,includeTrace:r}},bm=async(e,t,n)=>{if(e.options.fixManagedState!==!0)return{state:n,fix:null};let a=await Kn(e.resolvedRoots.selected_root,e.scope,t,n);return{state:a.state,fix:a}},km=(e,t,n,a)=>{let i=n==="package"?"package":"extension";if(e!=="project")return{isolated:t,global_extensions_included:!1,global_diagnostics_present:Hn(a),rerun_command:null,pm_global_path_recipe:null};let r=`pm ${i} doctor --project --isolated --detail deep --trace`;return{isolated:t,global_extensions_included:!t,global_diagnostics_present:Hn(a),rerun_command:t?null:r,pm_global_path_recipe:`PM_GLOBAL_PATH=$(mktemp -d) pm ${i} doctor --project --detail deep --trace`}},xm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,global:o,withResult:s}=e,{isolated:d,detailMode:c,includeTrace:l}=vm(t,n,r),p=await A(a.settings_root),m=await de(a.selected_root);i.push(...m.warnings);let y=await pe(a.selected_root,n,p,m.state);i.push(...y.warnings);let{state:g,fix:_}=await bm(e,y.extensions,m.state),u=await pe(a.selected_root,n,p,g);i.push(...u.warnings);let w=await ve({pmRoot:a.pm_root,settings:p,cwd:process.cwd(),noExtensions:o.noExtensions===!0,ignoreGlobalExtensions:d}),v=await be({...w,loaded:w.loaded}),E=await ho(a.pm_root);i.push(...E.warnings,...w.warnings),i.push(...Zr(w.failed)),i.push(...v.warnings),i.push(...Qr(v.failed)),i.push(...eo(w,v)),i.push(...so(v,w)),i.push(...Bp(w,v)),i.push(...co(v));let S=Yt(u.extensions,w,v),C=ro(n,S,w.loaded.map(O=>({layer:O.layer,name:O.name})),w.failed.map(O=>({name:O.name})),w.disabled_by_flag);i.push(...C.warnings);let te=S.filter(O=>O.update_check_status==="failed").map(O=>`extension_update_check_failed:${O.name}`);i.push(...te);let D=Xt(n,i,S,r);i.push(...D.warnings);let x=[...D.warnings],z={mode:w.policy.mode,trust_mode:w.policy.trust_mode,require_provenance:w.policy.require_provenance,default_sandbox_profile:w.policy.default_sandbox_profile,sandbox_enforcement:"advisory: sandbox_profile/permissions are declaration-based load gates, not runtime isolation (ADR pm-6ef3)",trusted_extensions_count:w.policy.trusted_extensions.length,allowed_extensions_count:w.policy.allowed_extensions.length,blocked_extensions_count:w.policy.blocked_extensions.length,allowed_capabilities_count:w.policy.allowed_capabilities.length,blocked_capabilities_count:w.policy.blocked_capabilities.length,allowed_surfaces_count:w.policy.allowed_surfaces.length,blocked_surfaces_count:w.policy.blocked_surfaces.length,allowed_commands_count:w.policy.allowed_commands.length,blocked_commands_count:w.policy.blocked_commands.length,allowed_actions_count:w.policy.allowed_actions.length,blocked_actions_count:w.policy.blocked_actions.length,allowed_services_count:w.policy.allowed_services.length,blocked_services_count:w.policy.blocked_services.length,extension_override_count:w.policy.extension_overrides.length},tt=ao(x),tn=io(),oa=D.warning_codes,fs=wm(n,d,r.vocabulary,w),hs=_m(D.remediation,w.failed.length,v.failed.length,r.vocabulary,_,fs),sa=km(n,d,r.vocabulary,w),gs={status:D.status,scope:n,warning_count:D.warning_count,warning_codes:oa,total_extensions:S.length,managed_total:S.filter(O=>O.managed).length,enabled_total:S.filter(O=>O.enabled).length,active_total:S.filter(O=>O.active).length,unmanaged_loaded_extension_count:D.unmanaged_loaded_extension_count,unmanaged_action_required_extension_count:D.unmanaged_action_required_extension_count,unmanaged_expected_extension_count:D.unmanaged_expected_extension_count,runtime_active_total:S.filter(O=>O.runtime_active===!0).length,activation_status_totals:{ok:S.filter(O=>O.activation_status==="ok").length,failed:S.filter(O=>O.activation_status==="failed").length,not_loaded:S.filter(O=>O.activation_status==="not_loaded").length,unknown:S.filter(O=>O.activation_status==="unknown").length},unknown_capability_count:tt.length,capability_contract_version:tn.version,update_available_total:D.update_available_total,update_check_status_totals:D.update_check_status_totals,update_health_coverage:D.update_health_coverage,update_health_partial:D.update_health_partial,update_check_failed_total:S.filter(O=>O.update_check_status==="failed").length,load_failure_count:w.failed.length,activation_failure_count:v.failed.length,load_failures:Jn(w.failed),activation_failures:Jn(v.failed),blocking_failure_count:w.failed.length+v.failed.length,has_blocking_failures:w.failed.length+v.failed.length>0,consistency_warning_count:C.warnings.length,trace_enabled:l,isolation:sa,policy:z,remediation:hs},ys=_?{requested:!0,applied:_.adopted_entries.length>0,adopted_count:_.adopted_entries.length,already_managed_count:_.already_managed_count,adopted_extensions:_.adopted_entries.map(O=>O.name)}:{requested:!1,applied:!1,adopted_count:0,already_managed_count:u.extensions.filter(O=>O.managed).length,adopted_extensions:[]},nn={mode:c,summary:gs,triage:D,trace_enabled:l,capability_contract:tn,capability_guidance:tt,managed_state_fix:ys,author_manifest:E,isolation:sa,policy:w.policy};if(c==="deep"){let O=l?v.failed:v.failed.map(R=>{let{trace:uu,..._s}=R;return _s});nn.deep={warnings:x,warning_codes:oa,capability_contract:tn,capability_guidance:tt,trace_enabled:l,managed_state:{path:m.path,count:g.entries.length,entries:g.entries},installed_extensions:S,load:{roots:w.roots,policy:w.policy,warnings:w.warnings,failed:w.failed,loaded:w.loaded.map(R=>({layer:R.layer,directory:R.directory,name:R.name,version:R.version,entry:R.entry,priority:R.priority}))},activation:{failed:O,warnings:v.warnings,hook_counts:v.hook_counts,registration_counts:v.registration_counts,parser_override_count:v.parser_override_count,preflight_override_count:v.preflight_override_count,service_override_count:v.service_override_count,renderer_override_count:v.renderer_override_count},consistency:C.summary},l&&(nn.deep.trace={activation_failures:v.failed.filter(R=>R.trace!==void 0).map(R=>({layer:R.layer,name:R.name,entry_path:R.entry_path,error:R.error,method:R.trace.method,command:R.trace.command,capability:R.trace.capability,missing_capability:R.trace.missing_capability,registration_index:R.trace.registration_index,expected_schema:R.trace.expected_schema,hint:R.trace.hint,received:R.trace.received}))})}return s(nn)},Sm=async e=>{let{normalizedTarget:t,scope:n,resolvedRoots:a,warnings:i,options:r,global:o,withResult:s}=e,d=await A(a.settings_root),c=await ve({pmRoot:a.pm_root,settings:d,cwd:process.cwd(),noExtensions:o.noExtensions===!0}),l=await be(c);i.push(...c.warnings),i.push(...l.warnings);let p=kr(t,c,l);if(t!==void 0&&p.extensions.length===0){let m=r.vocabulary==="package"?"package":"extension",y=[...new Set(c.loaded.map(_=>r.vocabulary==="package"&&typeof _.source_package=="string"&&_.source_package.trim().length>0?_.source_package.trim():_.name))].sort((_,u)=>_.localeCompare(u)),g=y.length>0?` Loaded ${m} names: ${y.join(", ")}.`:"";throw new f(`No loaded ${m} named "${t}" was found in ${n} scope.${g} Run pm ${m} explore to list discovered ${m}s.`,h.NOT_FOUND)}return s({target:p.target,total:p.total,extensions:p.extensions,union:p.union,command_ownership:p.command_ownership})},Em=async(e,t,n)=>{let a=n,i=null;return[e.action==="manage",e.options.fixManagedState===!0].every(Boolean)&&(i=await Kn(e.resolvedRoots.selected_root,e.scope,t,n),a=i.state),e.action==="manage"&&(a=await uo(a,e.options.offline)),{state:a,fix:i}},$m=async(e,t,n)=>{let a=await ve({pmRoot:e.resolvedRoots.pm_root,settings:t,cwd:process.cwd(),noExtensions:e.global.noExtensions===!0}),i=await be({...a,loaded:a.loaded});return e.warnings.push(...a.warnings,...i.warnings),{installed:Yt(n,a,i),failures:Oo(i.failed),summary:{requested:!0,executed:!0,reason:e.action==="explore"?"explore_defaults_to_runtime_probe":e.options.runtimeProbe===!0?"runtime_probe_requested":"manage_defaults_to_runtime_probe",load_failure_count:a.failed.length,activation_failure_count:i.failed.length,warning_count:[...new Set([...a.warnings,...i.warnings])].length,policy:a.policy}}},Im=(e,t)=>e?{requested:!0,applied:e.adopted_entries.length>0,adopted_count:e.adopted_entries.length,adopted_extensions:e.adopted_entries.map(n=>n.name),already_managed_count:e.already_managed_count}:{requested:!1,applied:!1,adopted_count:0,adopted_extensions:[],already_managed_count:t.filter(n=>n.managed).length},wo=async e=>{let{action:t,scope:n,resolvedRoots:a,warnings:i,options:r,withResult:o}=e,s=await A(a.settings_root),d=$p(s.extensions.policy),c=await de(a.selected_root);i.push(...c.warnings);let l=await pe(a.selected_root,n,s,c.state);i.push(...l.warnings);let{state:p,fix:m}=await Em(e,l.extensions,c.state),y=await pe(a.selected_root,n,s,p);if(i.push(...y.warnings),t==="manage"&&r.offline===!0)for(let v of y.extensions)v.managed&&["npm","github"].includes(v.source.kind)&&(v.update_check_reason="offline_requested");if(t==="manage"){let v=y.extensions.filter(E=>E.update_check_status==="failed").map(E=>`extension_update_check_failed:${E.name}`);i.push(...v)}let g=await $m(e,s,y.extensions),_=g.installed,u=Xt(n,i,_,r);i.push(...u.warnings);let w={total:_.length,managed_total:_.filter(v=>v.managed).length,enabled_total:_.filter(v=>v.enabled).length,active_total:_.filter(v=>v.active).length,extensions:_,triage:u,policy:d};return g.failures!==void 0&&(w.activation_diagnostics={failed_count:g.failures.length,failed:g.failures}),t==="explore"&&(w.runtime_probe=g.summary),t==="manage"&&(w.runtime_probe=g.summary,w.managed_state_fix=Im(m,_)),o(w)},vo={init:Zp,install:um,uninstall:ym,explore:wo,manage:wo,describe:Sm,reload:Qp,doctor:xm,catalog:em,adopt:gm,"adopt-all":fm,activate:_o,deactivate:_o,migrate:ui},Am=e=>[e.action==="uninstall",e.action==="adopt",e.action==="adopt-all",e.action==="activate",e.action==="deactivate",e.action==="migrate",[["doctor","manage"].includes(e.action),e.options.fixManagedState===!0].every(Boolean)].some(Boolean),Tm=e=>Am(e)?Un(e.resolvedRoots.settings_root,`${e.action}-state`,()=>vo[e.action](e)):vo[e.action](e);import Zn from"node:fs/promises";import U from"node:path";import Do from"node:readline/promises";import{stdin as jo,stdout as wt}from"node:process";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="f3a0706e-7162-5cde-9f48-c5de9b2fbd8e")}catch{}})();var Lo=["ask","add","skip","status"],Om=["AGENTS.md","CLAUDE.md"],Cm=["pm init","pm context","pm search","pm create","pm claim","pm files","pm docs","pm test --run","pm close","pm release","pm_author"],Pm=8,Qn=1,Rm="<!-- pm-cli:agent-guidance:start:",Nm=`<!-- pm-cli:agent-guidance:start:v${Qn} -->`,Yn="<!-- pm-cli:agent-guidance:end -->",bt="Add workflow guidance later: pm init --agent-guidance add",ww={toPortableRelativePath:Me,ensureTrailingNewline:Xn,detectLineEnding:Mo,findGuidanceBlockRange:ea,buildAgentGuidanceBlock:Uo,upsertAgentGuidanceBlock:ta,resolveProjectRoot:Go,resolveTargetGuidancePath:Jo,parsePromptChoice:qo,pushUnique:Oe,promptForGuidanceWrite:Wo,normalizeAgentGuidanceState:na,applyAgentGuidanceState:Ho,writeGuidanceFile:aa,setAgentGuidanceReadlineFactoryForTests:Dm},Fo=()=>Do.createInterface({input:jo,output:wt});function Dm(e){Fo=e??(()=>Do.createInterface({input:jo,output:wt}))}function Me(e,t){let n=U.relative(e,t);return n.length===0?U.basename(t):n.split(U.sep).join("/")}function Xn(e){return e.endsWith(`
 `)?e:`${e}
-`}function jo(e){return e.includes(`\r
+`}function Mo(e){return e.includes(`\r
 `)?`\r
 `:`
-`}function Qn(e){let t=e.indexOf(Om);if(t===-1)return null;let n=e.indexOf(Vn,t);return n===-1?null:{start_index:t,end_index:n+Vn.length}}function Rm(e){return Qn(e)!==null}function Lo(e,t="<your project test command>"){return[Cm,"## pm Workflow (Agent Quickstart)","",'- Cold start with the measured canonical orientation: `pm context --limit 10 --for orient`; before item mutation, also run `pm search "<keywords>" --limit 10`, `pm list --status open --limit 20`, and `pm list --status in_progress --limit 20`.',"- Claim and start atomically: `pm claim <id> --start`.",`- Link evidence while coding: \`pm files <id> --add ...\`, \`pm docs <id> --add ...\`, \`pm test <id> --add command="${t}"\`.`,'- Verify and close: `pm test <id> --run --progress`, then atomically record closure evidence with `pm close <id> "<reason>" --resolution "<what changed>" --expected "<expected outcome>" --actual "<observed outcome>" --validate-close warn`, then `pm release <id>`.',"- Author identity is automatic for supported agent harnesses; use `--author` only for an explicit override.","",Vn,""].join(e)}function ea(e,t="<your project test command>"){let n=jo(e),a=Lo(n,t),i=Qn(e);if(i){let s=e.slice(i.end_index),d=s.startsWith(`\r
+`}function ea(e){let t=e.indexOf(Rm);if(t===-1)return null;let n=e.indexOf(Yn,t);return n===-1?null:{start_index:t,end_index:n+Yn.length}}function jm(e){return ea(e)!==null}function Uo(e,t="<your project test command>"){return[Nm,"## pm Workflow (Agent Quickstart)","",'- Cold start with the measured canonical orientation: `pm context --limit 10 --for orient`; before item mutation, also run `pm search "<keywords>" --limit 10`, `pm list --status open --limit 20`, and `pm list --status in_progress --limit 20`.',"- Claim and start atomically: `pm claim <id> --start`.",`- Link evidence while coding: \`pm files <id> --add ...\`, \`pm docs <id> --add ...\`, \`pm test <id> --add command="${t}"\`.`,'- Verify and close: `pm test <id> --run --progress`, then atomically record closure evidence with `pm close <id> "<reason>" --resolution "<what changed>" --expected "<expected outcome>" --actual "<observed outcome>" --validate-close warn`, then `pm release <id>`.',"- Author identity is automatic for supported agent harnesses; use `--author` only for an explicit override.","",Yn,""].join(e)}function ta(e,t="<your project test command>"){let n=Mo(e),a=Uo(n,t),i=ea(e);if(i){let s=e.slice(i.end_index),d=s.startsWith(`\r
 `)?s.slice(2):s.startsWith(`
-`)?s.slice(1):s,c=Yn(`${e.slice(0,i.start_index)}${a}${d}`);return{next_content:c,changed:c!==e}}let r=e.length===0?"":e.endsWith(`
+`)?s.slice(1):s,c=Xn(`${e.slice(0,i.start_index)}${a}${d}`);return{next_content:c,changed:c!==e}}let r=e.length===0?"":e.endsWith(`
 `)?`
 `:`
 
-`,o=Yn(`${e}${r}${a}`);return{next_content:o,changed:o!==e}}async function Fo(e){if(await k(U.join(e,"scripts","run-tests.mjs")))return"node scripts/run-tests.mjs test";let t;try{t=JSON.parse(await Xn.readFile(U.join(e,"package.json"),"utf8"))}catch{return"<your project test command>"}let n=Nm(t);if(n===void 0)return"<your project test command>";let a=n.packageManager?.split("@")[0];return a==="pnpm"?"pnpm test":a==="bun"?"bun run test":a==="yarn"?"yarn test":a==="npm"?"npm test":await k(U.join(e,"pnpm-lock.yaml"))?"pnpm test":await k(U.join(e,"bun.lock"))||await k(U.join(e,"bun.lockb"))?"bun run test":await k(U.join(e,"yarn.lock"))?"yarn test":"npm test"}function Nm(e){if(typeof e!="object"||e===null||!("scripts"in e))return;let t=e.scripts;if(!(typeof t!="object"||t===null||!("test"in t)||typeof t.test!="string"||t.test.trim().length===0))return{scripts:{test:t.test},..."packageManager"in e&&typeof e.packageManager=="string"?{packageManager:e.packageManager}:{}}}function Mo(e,t){let n=U.dirname(e);return U.basename(e)==="pm"&&U.basename(n)===".agents"?U.dirname(n):U.resolve(t,e)}function Uo(e,t){let n=e.find(i=>U.basename(i.file_path)==="AGENTS.md"&&i.exists);if(n)return n.file_path;let a=e.find(i=>i.exists);return a?a.file_path:U.join(t,"AGENTS.md")}function zo(e,t){let n=e.trim().toLowerCase();return n.length===0?t:n==="y"||n==="yes"?!0:n==="n"||n==="no"?!1:t}async function Go(e){let t=Do();try{yt.write(`
+`,o=Xn(`${e}${r}${a}`);return{next_content:o,changed:o!==e}}async function zo(e){if(await k(U.join(e,"scripts","run-tests.mjs")))return"node scripts/run-tests.mjs test";let t;try{t=JSON.parse(await Zn.readFile(U.join(e,"package.json"),"utf8"))}catch{return"<your project test command>"}let n=Lm(t);if(n===void 0)return"<your project test command>";let a=n.packageManager?.split("@")[0];return a==="pnpm"?"pnpm test":a==="bun"?"bun run test":a==="yarn"?"yarn test":a==="npm"?"npm test":await k(U.join(e,"pnpm-lock.yaml"))?"pnpm test":await k(U.join(e,"bun.lock"))||await k(U.join(e,"bun.lockb"))?"bun run test":await k(U.join(e,"yarn.lock"))?"yarn test":"npm test"}function Lm(e){if(typeof e!="object"||e===null||!("scripts"in e))return;let t=e.scripts;if(!(typeof t!="object"||t===null||!("test"in t)||typeof t.test!="string"||t.test.trim().length===0))return{scripts:{test:t.test},..."packageManager"in e&&typeof e.packageManager=="string"?{packageManager:e.packageManager}:{}}}function Go(e,t){let n=U.dirname(e);return U.basename(e)==="pm"&&U.basename(n)===".agents"?U.dirname(n):U.resolve(t,e)}function Jo(e,t){let n=e.find(i=>U.basename(i.file_path)==="AGENTS.md"&&i.exists);if(n)return n.file_path;let a=e.find(i=>i.exists);return a?a.file_path:U.join(t,"AGENTS.md")}function qo(e,t){let n=e.trim().toLowerCase();return n.length===0?t:n==="y"||n==="yes"?!0:n==="n"||n==="no"?!1:t}async function Wo(e){let t=Fo();try{wt.write(`
 Agent guidance check
-`),yt.write(`No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.
-`);let n=await t.question(`Add a compact pm workflow section to ${e}? [Y/n] `);return yt.write(`
-`),zo(n,!0)}finally{t.close()}}function ta(e){let t=e.agent_guidance;return{prompt_completed:t?.prompt_completed===!0,declined:t?.declined===!0,declined_at:typeof t?.declined_at=="string"?t.declined_at:"",template_version:typeof t?.template_version=="number"&&Number.isInteger(t.template_version)&&t.template_version>0?t.template_version:Zn,last_checked_files:Array.isArray(t?.last_checked_files)?[...new Set(t.last_checked_files.map(n=>n.trim()).filter(n=>n.length>0))].sort((n,a)=>n.localeCompare(a)):[]}}async function Jo(e){let t=[],n=await Fo(e);for(let a of Im){let i=U.join(e,a),r=await k(i);if(!r){t.push({file_path:i,exists:r,has_guidance:!1,has_marker:!1});continue}let o=await Xn.readFile(i,"utf8"),s=o.toLowerCase(),d=Am.filter(l=>s.includes(l)),c=Rm(o);t.push({file_path:i,exists:r,has_guidance:c||d.length>=Tm,has_marker:c,outdated:c&&ea(o,n).changed})}return t}function Ae(e,t){e.includes(t)||e.push(t)}function qo(e,t){let n=ta(e),a=JSON.stringify(n)!==JSON.stringify(t);return a&&(e.agent_guidance=t),{changed:a,state:t}}async function na(e,t=U.dirname(e)){let n=await k(e)?await Xn.readFile(e,"utf8"):"",a=ea(n,await Fo(t));return a.changed?(await le(e,a.next_content),{changed:!0,warnings:await W({path:e,scope:"project",op:"init:agent_guidance_file"})}):{changed:!1,warnings:[]}}function Dm(e){return{mode:e.mode,present:e.scans.some(t=>t.has_guidance),prompted:e.prompted,applied:e.applied,skipped:e.skipped,declined:e.state.declined,prompt_completed:e.state.prompt_completed,template_version:e.state.template_version,target_file:e.targetRelativePath,checked_files:e.scans.map(t=>Fe(e.projectRoot,t.file_path)),files_with_guidance:e.scans.filter(t=>t.has_guidance).map(t=>Fe(e.projectRoot,t.file_path)),missing_files:e.scans.filter(t=>!t.exists).map(t=>Fe(e.projectRoot,t.file_path))}}async function jm(e,t,n){return e?await Jo(n):t}function _t(e,t,n){e.state={...e.state,...n,template_version:Zn,last_checked_files:t}}async function Wo(e,t){if(t.presentBefore)return;let n=await na(t.targetPath,t.projectRoot);e.warnings.push(...n.warnings),n.changed&&(e.applied=!0,e.warnings.push(`agent_guidance:added:${t.targetRelativePath}`))}function Lm(e,t){t||(e.warnings.push("agent_guidance:missing"),Ae(e.nextSteps,wt))}function Fm(e,t){e.skipped=!0,_t(e,t,{prompt_completed:!0,declined:!0,declined_at:e.state.declined_at||new Date().toISOString()}),e.warnings.push("agent_guidance:explicit_skip"),Ae(e.nextSteps,wt)}async function Mm(e,t){await Wo(e,t),_t(e,t.checkedFiles,{prompt_completed:!0,declined:!1,declined_at:""})}function Um(e,t){e.state.declined&&_t(e,t,{prompt_completed:!0,declined:!1,declined_at:""})}function zm(e){e.skipped=!0,e.warnings.push("agent_guidance:skipped_declined"),Ae(e.nextSteps,wt)}async function Gm(e,t){if(e.prompted=!0,await Go(t.targetRelativePath)){await Wo(e,t),_t(e,t.checkedFiles,{prompt_completed:!0,declined:!1,declined_at:""});return}e.skipped=!0,_t(e,t.checkedFiles,{prompt_completed:!0,declined:!0,declined_at:new Date().toISOString()}),e.warnings.push("agent_guidance:declined"),Ae(e.nextSteps,wt)}function Jm(e){e.warnings.push("agent_guidance:missing_non_interactive"),Ae(e.nextSteps,"Inspect workflow guidance: pm init --agent-guidance status"),Ae(e.nextSteps,wt)}async function qm(e,t){let n={warnings:[],nextSteps:[],prompted:!1,applied:!1,skipped:!1,state:e};return t.mode==="status"?(Lm(n,t.presentBefore),n):t.mode==="skip"?(Fm(n,t.checkedFiles),n):t.mode==="add"?(await Mm(n,t),n):t.presentBefore?(Um(n,t.checkedFiles),n):n.state.prompt_completed&&n.state.declined?(zm(n),n):t.interactive?(await Gm(n,t),n):(Jm(n),n)}async function Bo(e){let t=Mo(e.pm_root,e.cwd),n=await Jo(t),a=Uo(n,t),i=Fe(t,a),r=n.map(l=>Fe(t,l.file_path)),o=n.some(l=>l.has_guidance),s=await qm(ta(e.settings),{mode:e.mode,interactive:e.interactive,targetPath:a,targetRelativePath:i,checkedFiles:r,presentBefore:o,projectRoot:t});if(e.mode==="add")for(let l of n.filter(p=>p.outdated)){let p=await na(l.file_path,t);s.applied||=p.changed,s.warnings.push(...p.warnings)}let d=qo(e.settings,s.state);n=await jm(s.applied,n,t);let c=n.filter(l=>l.outdated).map(l=>Fe(t,l.file_path));return c.length>0&&(s.warnings.push(`agent_guidance_outdated:${c.join(",")}`),Ae(s.nextSteps,"pm init --agent-guidance add")),{summary:Dm({mode:e.mode,scans:n,projectRoot:t,targetRelativePath:i,prompted:s.prompted,applied:s.applied,skipped:s.skipped,state:s.state}),warnings:s.warnings,next_steps:s.nextSteps,settings_changed:d.changed}}import Wm from"node:fs/promises";import j from"node:path";import Ko from"node:readline/promises";import{stdin as Vo,stdout as X}from"node:process";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="ffab1407-659d-5bc4-95ff-5efe52baf522")}catch{}})();var Bm=Symbol.for("pm.sdk.init-invocation-cwd");function Aw(e,t=!1){if(t){let n=e.warnings.filter(i=>!/^(?:already_exists:|updated:|registered_type_preset:)/u.test(i)),a=n.includes("agent_guidance:missing_non_interactive")?e.next_steps.filter(i=>i.includes("--agent-guidance")):[];return{ok:e.ok,path:e.path,governance_preset:e.governance_preset,telemetry:`${e.settings.telemetry.enabled?"enabled":"disabled"} (${e.settings.telemetry.capture_level})`,created_count:e.created_dirs.length,next_steps:[...a,...e.next_steps.filter(i=>!a.includes(i))].slice(0,3),...n.length>0?{warnings:n.join("; ")}:{},details:`${Qe(["--pm-path",e.path,"init","--verbose"])} for full setup details and notices (or --json)`}}return{ok:e.ok,path:e.path,target:e.target,id_prefix:e.settings.id_prefix,governance_preset:e.governance_preset,telemetry:{enabled:e.settings.telemetry.enabled,capture_level:e.settings.telemetry.capture_level},output_format:e.settings.output.default_format,created_dirs_count:e.created_dirs.length,created_dirs:e.created_dirs,warnings:e.warnings,wizard_used:e.wizard_used,...e.registered_type_preset?{registered_type_preset:e.registered_type_preset}:{},...e.installed_packages?{installed_packages:e.installed_packages}:{},next_steps:e.next_steps,agent_guidance:e.agent_guidance,hint:"Re-run with --verbose for the full settings tree."}}var Tw={normalizeInitGovernancePreset:aa,normalizeInitTypePreset:Xo,normalizeOptionalInitAuthor:Zo,normalizeInitAgentGuidanceMode:ts,isPathLikeInitTarget:Qt,resolveInitInvocation:Qo,resolveInitPrefixInput:es,parseYesNoChoice:ns,applyGovernancePreset:ia,runInitWizard:cs,setInitReadlineFactoryForTests:Hm,summarizeInstalledPackages:as,buildInitNextSteps:ds,registerInitTypePreset:is,assertExplicitTrackerPathIsNotWorkspaceRoot:os,isLikelyWorkspaceRoot:rs,installInitMergeFence:ls},Yo=()=>Ko.createInterface({input:Vo,output:X});function Hm(e){Yo=e??(()=>Ko.createInterface({input:Vo,output:X}))}function Km(){return structuredClone(an)}var Vm=["minimal","default","strict"];function aa(e){if(e===void 0)return;let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new f("--preset must not be empty",h.USAGE);if(t==="minimal"||t==="default"||t==="strict")return t;if(t==="lite"||t==="minimum")return"minimal";throw new f(`Invalid --preset value "${e}". Allowed: ${Vm.join(", ")}`,h.USAGE)}function Xo(e){if(e!==void 0){if(e.trim().length===0)throw new f("--type-preset must not be empty",h.USAGE);try{return Wt(e)}catch{throw new f(`Invalid --type-preset value "${e}". Allowed: ${ut.join(", ")}`,h.USAGE)}}}function Zo(e){if(e===void 0)return;let t=e.trim();if(t.length===0)throw new f("--author must not be empty",h.USAGE);return t}function Qt(e){if(e===void 0)return!1;let t=e.trim();return t.length===0?!1:j.isAbsolute(t)||/^[a-z]:/iu.test(t)||t.startsWith(".")||t.includes("/")||t.includes("\\")}function Qo(e,t,n,a){let i=a?.trim();if(a!==void 0&&i?.length===0)throw new f("--workspace must not be empty",h.USAGE);if(i!==void 0){if(t.path!==void 0||Qt(n))throw new f("--workspace cannot be combined with --pm-path/--path or a path-like positional target.",h.USAGE);let c=j.resolve(e,i),l=j.join(c,".agents","pm");return{pmRoot:l,prefixArg:n,target:{mode:"workspace-path",tracker_root:l,workspace_root:c}}}if(t.path===void 0&&Qt(n)){let c=j.resolve(e,n.trim());return{pmRoot:c,prefixArg:void 0,target:{mode:"tracker-path",tracker_root:c}}}let r=F(e,t.path),o=j.join(j.resolve(e),".agents","pm"),s=j.dirname(j.dirname(r)),d=j.resolve(r)===o?"current":"ancestor";return{pmRoot:r,prefixArg:n,target:t.path===void 0?{mode:"workspace-discovery",tracker_root:r,workspace_root:s,discovery:d,requested_cwd:j.resolve(e),...d==="ancestor"?{suggested_current_tracker_root:o}:{}}:{mode:"tracker-path",tracker_root:r}}}function es(e,t){if(t===void 0)return e;if(t.trim().length===0)throw new f("--id-prefix must not be empty",h.USAGE);if(Qt(t))throw new f(`--id-prefix accepts an item ID prefix, not a tracker path: "${t}".`,h.USAGE,{code:"init_id_prefix_path_like",required:"Pass the tracker path positionally or with the global --path option.",examples:[`pm init ${t}`,`pm --path ${t} init`]});if(e!==void 0&&be(e)!==be(t))throw new f(`Conflicting id prefixes: positional "${e}" and --id-prefix "${t}".`,h.USAGE,{code:"init_id_prefix_conflict",required:"Use either the positional id prefix or --id-prefix with one value.",examples:[`pm init ${be(e)}`,`pm init --id-prefix ${be(t)}`]});return t}function ts(e){if(e===void 0)return"ask";let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new f("--agent-guidance must not be empty",h.USAGE);if(t==="ask"||t==="add"||t==="skip"||t==="status")return t;throw new f(`Invalid --agent-guidance value "${e}". Allowed: ${No.join(", ")}`,h.USAGE)}function ns(e,t){let n=e.trim().toLowerCase();return n.length===0?t:n==="y"||n==="yes"?!0:n==="n"||n==="no"?!1:t}function ia(e,t){let n=la[t];e.governance={preset:t,...n},e.validation.parent_reference=n.parent_reference,e.validation.metadata_profile=n.metadata_profile}function Ym(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function as(e){let t=e.details;return{installed_all:t.installed_all===!0,installed_count:typeof t.installed_count=="number"?t.installed_count:0,packages:Array.isArray(t.packages)?t.packages.filter(Ym).map(n=>({alias:typeof n.alias=="string"?n.alias:"",ok:n.ok===!0})):[]}}async function is(e,t,n){let a=H(t.schema),i=ee(e,a.files.types,V.types),r=ae(await G(i)),o=[],s=[];for(let d of ft(n)){let c=ze(r,d);r=c.file,(c.replaced?s:o).push(c.definition.name)}return await Ue({pmRoot:e,filePath:i,raw:re(r),op:"init:type-preset",author:K(void 0,t.author_default),lockTtlSeconds:t.locks.ttl_seconds,lockWaitMs:t.locks.wait_ms}),{name:n,registered:o,updated:s,file:i}}async function rs(e){let t=[".git","package.json","pnpm-workspace.yaml","AGENTS.md",j.join(".agents","pm")];for(let n of t)if(await k(j.join(e,n)))return!0;return!1}async function os(e,t,n){if(!t||n||await k(j.join(e,"settings.json"))||!await rs(e))return;let a=j.join(e,".agents","pm");throw new f(`Refusing to initialize tracker files directly in workspace root "${e}".`,h.USAGE,{code:"workspace_root_pm_path",type:"urn:pm-cli:error:workspace_root_pm_path",why:"Path-like init targets and --pm-path/--path point at the tracker storage directory itself, not the repository workspace. Point at .agents/pm, use --workspace, or pass --force if you intentionally want root-level tracker files.",examples:[`pm --pm-path ${a} init --yes`,"pm init --yes",`pm --pm-path ${e} init --yes --force`],nextSteps:["Use --pm-path <repo>/.agents/pm for repository-local tracker storage.","Use PM_PATH only for sandboxed tests or explicit tracker roots.","Pass --force only when root-level tracker files are intentional."],recovery:{next_best_command:`pm --pm-path ${a} init --yes`}})}async function ss(e,t){let n=[],a=[];for(let i of t){let r=i?j.join(e,i):e,o=await k(r);await Wm.mkdir(r,{recursive:!0}),o?a.push(`already_exists:${r}`):n.push(r),a.push(...await W({path:r,scope:"project",op:"init:ensure_dir"}))}return{createdDirs:n,warnings:a}}async function cs(e,t){let n=Yo();try{X.write(`pm init setup wizard (agent-optimized)
+`),wt.write(`No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.
+`);let n=await t.question(`Add a compact pm workflow section to ${e}? [Y/n] `);return wt.write(`
+`),qo(n,!0)}finally{t.close()}}function na(e){let t=e.agent_guidance;return{prompt_completed:t?.prompt_completed===!0,declined:t?.declined===!0,declined_at:typeof t?.declined_at=="string"?t.declined_at:"",template_version:typeof t?.template_version=="number"&&Number.isInteger(t.template_version)&&t.template_version>0?t.template_version:Qn,last_checked_files:Array.isArray(t?.last_checked_files)?[...new Set(t.last_checked_files.map(n=>n.trim()).filter(n=>n.length>0))].sort((n,a)=>n.localeCompare(a)):[]}}async function Bo(e){let t=[],n=await zo(e);for(let a of Om){let i=U.join(e,a),r=await k(i);if(!r){t.push({file_path:i,exists:r,has_guidance:!1,has_marker:!1});continue}let o=await Zn.readFile(i,"utf8"),s=o.toLowerCase(),d=Cm.filter(l=>s.includes(l)),c=jm(o);t.push({file_path:i,exists:r,has_guidance:c||d.length>=Pm,has_marker:c,outdated:c&&ta(o,n).changed})}return t}function Oe(e,t){e.includes(t)||e.push(t)}function Ho(e,t){let n=na(e),a=JSON.stringify(n)!==JSON.stringify(t);return a&&(e.agent_guidance=t),{changed:a,state:t}}async function aa(e,t=U.dirname(e)){let n=await k(e)?await Zn.readFile(e,"utf8"):"",a=ta(n,await zo(t));return a.changed?(await me(e,a.next_content),{changed:!0,warnings:await B({path:e,scope:"project",op:"init:agent_guidance_file"})}):{changed:!1,warnings:[]}}function Fm(e){return{mode:e.mode,present:e.scans.some(t=>t.has_guidance),prompted:e.prompted,applied:e.applied,skipped:e.skipped,declined:e.state.declined,prompt_completed:e.state.prompt_completed,template_version:e.state.template_version,target_file:e.targetRelativePath,checked_files:e.scans.map(t=>Me(e.projectRoot,t.file_path)),files_with_guidance:e.scans.filter(t=>t.has_guidance).map(t=>Me(e.projectRoot,t.file_path)),missing_files:e.scans.filter(t=>!t.exists).map(t=>Me(e.projectRoot,t.file_path))}}async function Mm(e,t,n){return e?await Bo(n):t}function vt(e,t,n){e.state={...e.state,...n,template_version:Qn,last_checked_files:t}}async function Ko(e,t){if(t.presentBefore)return;let n=await aa(t.targetPath,t.projectRoot);e.warnings.push(...n.warnings),n.changed&&(e.applied=!0,e.warnings.push(`agent_guidance:added:${t.targetRelativePath}`))}function Um(e,t){t||(e.warnings.push("agent_guidance:missing"),Oe(e.nextSteps,bt))}function zm(e,t){e.skipped=!0,vt(e,t,{prompt_completed:!0,declined:!0,declined_at:e.state.declined_at||new Date().toISOString()}),e.warnings.push("agent_guidance:explicit_skip"),Oe(e.nextSteps,bt)}async function Gm(e,t){await Ko(e,t),vt(e,t.checkedFiles,{prompt_completed:!0,declined:!1,declined_at:""})}function Jm(e,t){e.state.declined&&vt(e,t,{prompt_completed:!0,declined:!1,declined_at:""})}function qm(e){e.skipped=!0,e.warnings.push("agent_guidance:skipped_declined"),Oe(e.nextSteps,bt)}async function Wm(e,t){if(e.prompted=!0,await Wo(t.targetRelativePath)){await Ko(e,t),vt(e,t.checkedFiles,{prompt_completed:!0,declined:!1,declined_at:""});return}e.skipped=!0,vt(e,t.checkedFiles,{prompt_completed:!0,declined:!0,declined_at:new Date().toISOString()}),e.warnings.push("agent_guidance:declined"),Oe(e.nextSteps,bt)}function Bm(e){e.warnings.push("agent_guidance:missing_non_interactive"),Oe(e.nextSteps,"Inspect workflow guidance: pm init --agent-guidance status"),Oe(e.nextSteps,bt)}async function Hm(e,t){let n={warnings:[],nextSteps:[],prompted:!1,applied:!1,skipped:!1,state:e};return t.mode==="status"?(Um(n,t.presentBefore),n):t.mode==="skip"?(zm(n,t.checkedFiles),n):t.mode==="add"?(await Gm(n,t),n):t.presentBefore?(Jm(n,t.checkedFiles),n):n.state.prompt_completed&&n.state.declined?(qm(n),n):t.interactive?(await Wm(n,t),n):(Bm(n),n)}async function Vo(e){let t=Go(e.pm_root,e.cwd),n=await Bo(t),a=Jo(n,t),i=Me(t,a),r=n.map(l=>Me(t,l.file_path)),o=n.some(l=>l.has_guidance),s=await Hm(na(e.settings),{mode:e.mode,interactive:e.interactive,targetPath:a,targetRelativePath:i,checkedFiles:r,presentBefore:o,projectRoot:t});if(e.mode==="add")for(let l of n.filter(p=>p.outdated)){let p=await aa(l.file_path,t);s.applied||=p.changed,s.warnings.push(...p.warnings)}let d=Ho(e.settings,s.state);n=await Mm(s.applied,n,t);let c=n.filter(l=>l.outdated).map(l=>Me(t,l.file_path));return c.length>0&&(s.warnings.push(`agent_guidance_outdated:${c.join(",")}`),Oe(s.nextSteps,"pm init --agent-guidance add")),{summary:Fm({mode:e.mode,scans:n,projectRoot:t,targetRelativePath:i,prompted:s.prompted,applied:s.applied,skipped:s.skipped,state:s.state}),warnings:s.warnings,next_steps:s.nextSteps,settings_changed:d.changed}}import Km from"node:fs/promises";import j from"node:path";import Xo from"node:readline/promises";import{stdin as Zo,stdout as X}from"node:process";(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},t=new e.Error().stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="ffab1407-659d-5bc4-95ff-5efe52baf522")}catch{}})();var Vm=Symbol.for("pm.sdk.init-invocation-cwd");function Jw(e,t=!1){if(t){let n=e.warnings.filter(i=>!/^(?:already_exists:|updated:|registered_type_preset:)/u.test(i)),a=n.includes("agent_guidance:missing_non_interactive")?e.next_steps.filter(i=>i.includes("--agent-guidance")):[];return{ok:e.ok,path:e.path,governance_preset:e.governance_preset,telemetry:`${e.settings.telemetry.enabled?"enabled":"disabled"} (${e.settings.telemetry.capture_level})`,created_count:e.created_dirs.length,next_steps:[...a,...e.next_steps.filter(i=>!a.includes(i))].slice(0,3),...n.length>0?{warnings:n.join("; ")}:{},details:`${oe(["--pm-path",e.path,"init","--verbose"])} for full setup details and notices (or --json)`}}return{ok:e.ok,path:e.path,target:e.target,id_prefix:e.settings.id_prefix,governance_preset:e.governance_preset,telemetry:{enabled:e.settings.telemetry.enabled,capture_level:e.settings.telemetry.capture_level},output_format:e.settings.output.default_format,created_dirs_count:e.created_dirs.length,created_dirs:e.created_dirs,warnings:e.warnings,wizard_used:e.wizard_used,...e.registered_type_preset?{registered_type_preset:e.registered_type_preset}:{},...e.installed_packages?{installed_packages:e.installed_packages}:{},next_steps:e.next_steps,agent_guidance:e.agent_guidance,hint:"Re-run with --verbose for the full settings tree."}}var qw={normalizeInitGovernancePreset:ia,normalizeInitTypePreset:es,normalizeOptionalInitAuthor:ts,normalizeInitAgentGuidanceMode:is,isPathLikeInitTarget:en,resolveInitInvocation:ns,resolveInitPrefixInput:as,parseYesNoChoice:rs,applyGovernancePreset:ra,runInitWizard:ps,setInitReadlineFactoryForTests:Ym,summarizeInstalledPackages:os,buildInitNextSteps:ms,registerInitTypePreset:ss,assertExplicitTrackerPathIsNotWorkspaceRoot:ds,isLikelyWorkspaceRoot:cs,installInitMergeFence:us},Qo=()=>Xo.createInterface({input:Zo,output:X});function Ym(e){Qo=e??(()=>Xo.createInterface({input:Zo,output:X}))}function Xm(){return structuredClone(rn)}var Zm=["minimal","default","strict"];function ia(e){if(e===void 0)return;let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new f("--preset must not be empty",h.USAGE);if(t==="minimal"||t==="default"||t==="strict")return t;if(t==="lite"||t==="minimum")return"minimal";throw new f(`Invalid --preset value "${e}". Allowed: ${Zm.join(", ")}`,h.USAGE)}function es(e){if(e!==void 0){if(e.trim().length===0)throw new f("--type-preset must not be empty",h.USAGE);try{return Bt(e)}catch{throw new f(`Invalid --type-preset value "${e}". Allowed: ${ht.join(", ")}`,h.USAGE)}}}function ts(e){if(e===void 0)return;let t=e.trim();if(t.length===0)throw new f("--author must not be empty",h.USAGE);return t}function en(e){if(e===void 0)return!1;let t=e.trim();return t.length===0?!1:j.isAbsolute(t)||/^[a-z]:/iu.test(t)||t.startsWith(".")||t.includes("/")||t.includes("\\")}function ns(e,t,n,a){let i=a?.trim();if(a!==void 0&&i?.length===0)throw new f("--workspace must not be empty",h.USAGE);if(i!==void 0){if(t.path!==void 0||en(n))throw new f("--workspace cannot be combined with --pm-path/--path or a path-like positional target.",h.USAGE);let c=j.resolve(e,i),l=j.join(c,".agents","pm");return{pmRoot:l,prefixArg:n,target:{mode:"workspace-path",tracker_root:l,workspace_root:c}}}if(t.path===void 0&&en(n)){let c=j.resolve(e,n.trim());return{pmRoot:c,prefixArg:void 0,target:{mode:"tracker-path",tracker_root:c}}}let r=F(e,t.path),o=j.join(j.resolve(e),".agents","pm"),s=j.dirname(j.dirname(r)),d=j.resolve(r)===o?"current":"ancestor";return{pmRoot:r,prefixArg:n,target:t.path===void 0?{mode:"workspace-discovery",tracker_root:r,workspace_root:s,discovery:d,requested_cwd:j.resolve(e),...d==="ancestor"?{suggested_current_tracker_root:o}:{}}:{mode:"tracker-path",tracker_root:r}}}function as(e,t){if(t===void 0)return e;if(t.trim().length===0)throw new f("--id-prefix must not be empty",h.USAGE);if(en(t))throw new f(`--id-prefix accepts an item ID prefix, not a tracker path: "${t}".`,h.USAGE,{code:"init_id_prefix_path_like",required:"Pass the tracker path positionally or with the global --path option.",examples:[`pm init ${t}`,`pm --path ${t} init`]});if(e!==void 0&&Se(e)!==Se(t))throw new f(`Conflicting id prefixes: positional "${e}" and --id-prefix "${t}".`,h.USAGE,{code:"init_id_prefix_conflict",required:"Use either the positional id prefix or --id-prefix with one value.",examples:[`pm init ${Se(e)}`,`pm init --id-prefix ${Se(t)}`]});return t}function is(e){if(e===void 0)return"ask";let t=e.trim().toLowerCase().replaceAll("-","_");if(t.length===0)throw new f("--agent-guidance must not be empty",h.USAGE);if(t==="ask"||t==="add"||t==="skip"||t==="status")return t;throw new f(`Invalid --agent-guidance value "${e}". Allowed: ${Lo.join(", ")}`,h.USAGE)}function rs(e,t){let n=e.trim().toLowerCase();return n.length===0?t:n==="y"||n==="yes"?!0:n==="n"||n==="no"?!1:t}function ra(e,t){let n=pa[t];e.governance={preset:t,...n},e.validation.parent_reference=n.parent_reference,e.validation.metadata_profile=n.metadata_profile}function Qm(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function os(e){let t=e.details;return{installed_all:t.installed_all===!0,installed_count:typeof t.installed_count=="number"?t.installed_count:0,packages:Array.isArray(t.packages)?t.packages.filter(Qm).map(n=>({alias:typeof n.alias=="string"?n.alias:"",ok:n.ok===!0})):[]}}async function ss(e,t,n){let a=K(t.schema),i=Q(e,a.files.types,V.types),r=ae(await G(i)),o=[],s=[];for(let d of gt(n)){let c=ze(r,d);r=c.file,(c.replaced?s:o).push(c.definition.name)}return await ke({pmRoot:e,filePath:i,raw:se(r),op:"init:type-preset",author:q(void 0,t.author_default),lockTtlSeconds:t.locks.ttl_seconds,lockWaitMs:t.locks.wait_ms}),{name:n,registered:o,updated:s,file:i}}async function cs(e){let t=[".git","package.json","pnpm-workspace.yaml","AGENTS.md",j.join(".agents","pm")];for(let n of t)if(await k(j.join(e,n)))return!0;return!1}async function ds(e,t,n){if(!t||n||await k(j.join(e,"settings.json"))||!await cs(e))return;let a=j.join(e,".agents","pm");throw new f(`Refusing to initialize tracker files directly in workspace root "${e}".`,h.USAGE,{code:"workspace_root_pm_path",type:"urn:pm-cli:error:workspace_root_pm_path",why:"Path-like init targets and --pm-path/--path point at the tracker storage directory itself, not the repository workspace. Point at .agents/pm, use --workspace, or pass --force if you intentionally want root-level tracker files.",examples:[`pm --pm-path ${a} init --yes`,"pm init --yes",`pm --pm-path ${e} init --yes --force`],nextSteps:["Use --pm-path <repo>/.agents/pm for repository-local tracker storage.","Use PM_PATH only for sandboxed tests or explicit tracker roots.","Pass --force only when root-level tracker files are intentional."],recovery:{next_best_command:`pm --pm-path ${a} init --yes`}})}async function ls(e,t){let n=[],a=[];for(let i of t){let r=i?j.join(e,i):e,o=await k(r);await Km.mkdir(r,{recursive:!0}),o?a.push(`already_exists:${r}`):n.push(r),a.push(...await B({path:r,scope:"project",op:"init:ensure_dir"}))}return{createdDirs:n,warnings:a}}async function ps(e,t){let n=Qo();try{X.write(`pm init setup wizard (agent-optimized)
 `),X.write(`This walkthrough is non-destructive and each choice can be changed later with pm config.
 
 `),X.write(`1/3 Item ID prefix
 `),X.write(`Prefix is prepended to generated IDs (for example pm-a1b2).
-`);let a=await n.question(`Item ID prefix [${e}]: `),i=a.trim().length>0?be(a):e;X.write(`
+`);let a=await n.question(`Item ID prefix [${e}]: `),i=a.trim().length>0?Se(a):e;X.write(`
 2/3 Governance preset
 `),X.write(`minimal: no ownership blocking, progressive create defaults, close validation off.
 `),X.write(`default: ownership conflict warnings, progressive create defaults, close validation warn.
 `),X.write(`strict: ownership blocking, strict create defaults, close validation strict.
-`);let r=await n.question("Governance preset [minimal/default/strict] (default: minimal): "),o=r.trim().length>0?r.trim():"minimal",s="minimal";try{s=aa(o)}catch{X.write(`Unrecognized governance preset "${o}"; using minimal.
+`);let r=await n.question("Governance preset [minimal/default/strict] (default: minimal): "),o=r.trim().length>0?r.trim():"minimal",s="minimal";try{s=ia(o)}catch{X.write(`Unrecognized governance preset "${o}"; using minimal.
 `)}X.write(`
 3/3 Project telemetry
 `),X.write(`Telemetry helps improve reliability and can be disabled anytime via pm config.
-`);let d=t?"Y/n":"y/N",c=await n.question(`Enable telemetry for this project? [${d}] `),l=ns(c,t);return X.write(`
-`),{prefix:i,preset:s,telemetry_enabled:l}}finally{n.close()}}function Xm(e){return{presetFromOption:aa(e.preset),useDefaults:e.defaults===!0,authorFromOption:Zo(e.author),installBundledPackages:e.withPackages===!0,agentGuidanceMode:ts(e.agentGuidance),typePreset:Xo(e.typePreset)}}function Zm(e){let t=[];return e.prefixArg!==void 0&&e.settings.id_prefix!==e.normalizedPrefix&&t.push("id_prefix"),e.presetFromOption!==void 0&&e.settings.governance.preset!==e.presetFromOption&&t.push("governance_preset"),e.authorFromOption!==void 0&&e.settings.author_default!==e.authorFromOption&&t.push("author_default"),t}function Qm(e,t,n,a){if(t.length===0||n)return;let i=a.discovery==="ancestor";throw new f(`${i?`No tracker exists in ${a.requested_cwd}; pm init found an ancestor tracker at ${a.tracker_root}. `:""}Refusing to update existing tracker settings at ${e} without --force.`,h.USAGE,{code:"init_existing_settings_requires_force",type:"urn:pm-cli:error:init_existing_settings_requires_force",required:`--force for ${t.join(", ")}`,why:i?"Ancestor discovery is useful for normal commands, but init must make the selected existing workspace explicit before changing its identity or policy settings.":"pm init is safe to rerun, but changing id prefix, governance preset, or default author on an existing tracker can corrupt long-lived project context when an agent meant to initialize a sandbox path.",resolved_path:a.tracker_root,requested_path:a.requested_cwd,suggested_path:a.suggested_current_tracker_root,examples:["pm init --yes","pm init ./sandbox-pm --yes",...i?['pm init <name> --yes --pm-path "$PWD/.agents/pm"']:[],"pm init acme --yes --force"],nextSteps:[...i?['To create a new tracker in the current directory, rerun with --pm-path "$PWD/.agents/pm".']:[],"If you meant to initialize a sandbox tracker, pass a path-like positional such as ./sandbox-pm or /tmp/pm-test.","If you intentionally want to rewrite this existing tracker's init-managed settings, rerun with --force."]})}function eu(e){let t=!1;return e.prefixArg!==void 0&&e.settings.id_prefix!==e.normalizedPrefix&&(e.settings.id_prefix=e.normalizedPrefix,e.warnings.push(`updated:id_prefix:${e.normalizedPrefix}`),t=!0),e.presetFromOption!==void 0&&e.settings.governance.preset!==e.presetFromOption&&(ia(e.settings,e.presetFromOption),e.warnings.push(`updated:governance_preset:${e.presetFromOption}`),t=!0),e.authorFromOption!==void 0&&e.settings.author_default!==e.authorFromOption&&(e.settings.author_default=e.authorFromOption,e.warnings.push(`updated:author_default:${e.authorFromOption}`),t=!0),t}async function tu(e){let t=await C(e.pmRoot);e.warnings.push(`already_exists:${e.settingsPath}`);let n=Zm({settings:t,normalizedPrefix:e.normalizedPrefix,prefixArg:e.prefixArg,presetFromOption:e.normalizedOptions.presetFromOption,authorFromOption:e.normalizedOptions.authorFromOption});return Qm(e.settingsPath,n,e.options.force===!0,e.target),eu({settings:t,normalizedPrefix:e.normalizedPrefix,prefixArg:e.prefixArg,presetFromOption:e.normalizedOptions.presetFromOption,authorFromOption:e.normalizedOptions.authorFromOption,warnings:e.warnings})&&await ve(e.pmRoot,t),{settings:t,normalizedPrefix:e.normalizedPrefix,chosenPreset:e.normalizedOptions.presetFromOption,wizardUsed:!1}}async function nu(e){let t=e.normalizedPrefix,n=e.normalizedOptions.presetFromOption,a,i=!1;if(e.normalizedOptions.presetFromOption===void 0&&!e.normalizedOptions.useDefaults&&process.stdin.isTTY===!0&&process.stdout.isTTY===!0){let d=await cs(t,an.telemetry.enabled);t=d.prefix,n=d.preset,a=d.telemetry_enabled,i=!0}let r=n??"minimal",o=Km();o.id_prefix=t,ia(o,r);let s=ja()?.trim()||void 0;return o.author_default=e.normalizedOptions.authorFromOption??s??"",a!==void 0&&(o.telemetry.enabled=a,o.telemetry.first_run_prompt_completed=!0),await ve(e.pmRoot,o),{settings:o,normalizedPrefix:t,chosenPreset:n,wizardUsed:i}}async function Ho(e){return e.settingsExists?await tu(e):await nu({pmRoot:e.pmRoot,normalizedPrefix:e.normalizedPrefix,normalizedOptions:e.normalizedOptions})}async function au(e){let t=await Bo({pm_root:e.pmRoot,cwd:e.cwd,mode:e.agentGuidanceMode,interactive:process.stdin.isTTY===!0&&process.stdout.isTTY===!0,settings:e.settings});return e.warnings.push(...t.warnings),t.settings_changed&&await ve(e.pmRoot,e.settings),{...t.summary,next_steps:t.next_steps}}async function iu(e,t){let n=[],a=[],i=await Da(e,t.schema);for(let r of i.created_paths)n.push(r),a.push(...await W({path:r,scope:"project",op:"init:runtime_schema_file"}));return{createdDirs:n,warnings:a}}async function ru(e){if(e.typePreset===void 0)return;let t=await is(e.pmRoot,e.settings,e.typePreset);return e.warnings.push(`registered_type_preset:${e.typePreset}`),e.warnings.push(...await W({path:t.file,scope:"project",op:"init:type_preset"})),t}async function ou(e){let t=q(e.settings,J()).folders.filter(a=>!nn.includes(a)),n=await ss(e.pmRoot,t);e.createdDirs.push(...n.createdDirs),e.warnings.push(...n.warnings)}function su(e){let t=j.resolve(e.tracker_root),n=j.dirname(t);return j.basename(t)==="pm"&&j.basename(n)===".agents"?j.dirname(n):e.workspace_root}async function cu(e,t,n,a){if(!e)return;let i=await Kn("all",{install:!0,project:!0},{...t,path:n});a.push(...i.warnings);let r=as(i),o=r.packages.filter(s=>!s.ok).map(s=>s.alias);if(!r.installed_all||o.length>0)throw new f(`pm init --with-packages did not install all bundled packages successfully${o.length>0?`: ${o.join(", ")}`:"."}`,h.GENERIC_FAILURE);return r}function ds(e){let t=a=>Qe([...e.target.mode==="workspace-discovery"?[]:["--pm-path",e.target.tracker_root],...a]),n=[`Create your first item: ${t(["create","--type","Task","--title","<title>"])}`,`List active items: ${t(["list"])}`,`Get agent-friendly project context: ${t(["context"])}`];e.installBundledPackages?n.push(`Explore newly-available commands: ${t(["cal"])}, ${t(["templates"])}, ${t(["guide"])}`):(n.push(`Add optional packages for richer workflows: ${t(["install","calendar","--project"])}, ${t(["install","templates","--project"])}, ${t(["install","guide-shell","--project"])}`),n.push(`Or install everything bundled: ${t(["init","--with-packages"])} (idempotent on re-run)`)),e.registeredTypePreset&&n.push(`Inspect registered preset types: ${t(["schema","list"])}, ${t(["schema","show",e.registeredTypePreset.registered[0]??e.registeredTypePreset.updated[0]])}`),n.push("Supported agent harnesses are attributed automatically; use --author or PM_AUTHOR only when an explicit identity override is required.");for(let a of e.agentGuidanceNextSteps){let i=e.target.mode==="workspace-discovery"?a:a.replace(/\bpm (?=[a-z])/g,()=>`${t([])} `);n.includes(i)||n.push(i)}return n}async function ls(e,t,n,a=ei){if(t===null){n.push("merge_fence_skipped:not_git_repository:run pm merge install after moving the tracker into a Git repository");return}try{let i=await a({pmRoot:e,workspaceRoot:t});i.gitattributes.changed&&n.push(`updated:merge_fence:${i.gitattributes.path}`)}catch(i){if(!(i instanceof f))throw i;n.push(`merge_fence_skipped:install_failed:${i.context.code??"pm_error"}:${i.message}:run pm merge install after resolving the Git repository error`)}}async function du(e,t,n,a){if(e==null||n==="status")return;let i=await Xa(e,{pmRoot:t});i.changed&&a.push(`updated:gitignore:${i.path}`)}async function Ow(e,t,n={}){let a=t[Bm],i=typeof a=="string"?a:process.cwd(),r=Qo(i,t,e,n.workspace),o=r.pmRoot;e=es(r.prefixArg,n.idPrefix);let s=Xm(n);await os(o,r.target.mode==="tracker-path",n.force===!0);let d=[],c=[],l=j.join(o,"settings.json"),p=await k(l),m;p&&(m=await Ho({pmRoot:o,settingsPath:l,settingsExists:p,normalizedPrefix:be(e),prefixArg:e,options:n,normalizedOptions:s,warnings:c,target:r.target}));let y=await ss(o,nn);d.push(...y.createdDirs),c.push(...y.warnings),m??=await Ho({pmRoot:o,settingsPath:l,settingsExists:p,normalizedPrefix:be(e),prefixArg:e,options:n,normalizedOptions:s,warnings:c,target:r.target});let{settings:g}=m,_=su(r.target),u=await Za(_??j.dirname(o)),w=_??u,v=await au({pmRoot:o,cwd:w??i,agentGuidanceMode:s.agentGuidanceMode,settings:g,warnings:c}),S=await iu(o,g);d.push(...S.createdDirs),c.push(...S.warnings);let x=await ru({pmRoot:o,settings:g,typePreset:s.typePreset,warnings:c});x&&(g=await C(o)),await ou({pmRoot:o,settings:g,createdDirs:d,warnings:c}),await du(w,o,s.agentGuidanceMode,c),!p&&n.mergeFence!==!1&&s.agentGuidanceMode!=="status"&&await ls(o,u,c);let T=await cu(s.installBundledPackages,t,o,c),te=ds({installBundledPackages:s.installBundledPackages,registeredTypePreset:x,agentGuidanceNextSteps:v.next_steps,target:r.target});return{ok:!0,path:o,target:r.target,settings:g,created_dirs:d,warnings:c,governance_preset:g.governance.preset,wizard_used:m.wizardUsed,...x?{registered_type_preset:x}:{},...T?{installed_packages:T}:{},next_steps:te,agent_guidance:v}}export{un as a,ks as b,ci as c,yn as d,Ns as e,Ds as f,js as g,pi as h,Il as i,Ge as j,$i as k,We as l,Be as m,Ii as n,xi as o,Je as p,qe as q,Si as r,Fs as s,Tu as t,Ru as u,fi as v,zs as w,Yu as x,Ri as y,Li as z,$c as A,Ic as B,Qg as C,ny as D,ay as E,ht as F,iy as G,ry as H,oy as I,sy as J,cy as K,dy as L,ly as M,py as N,my as O,uy as P,fy as Q,hy as R,gy as S,yy as T,_y as U,wy as V,vy as W,by as X,ky as Y,xy as Z,Sy as _,Ey as $,$y as aa,Iy as ba,Ay as ca,Z as da,b as ea,Sn as fa,qc as ga,se as ha,Rt as ia,Ac as ja,at as ka,Nt as la,Zi as ma,sr as na,Ln as oa,vr as pa,Wh as qa,Vl as ra,eo as sa,to as ta,Jn as ua,Pr as va,kl as wa,lp as xa,Nr as ya,Kn as za,No as Aa,iw as Ba,Bo as Ca,Bm as Da,Aw as Ea,Tw as Fa,Ow as Ga};
-//# sourceMappingURL=chunk-V3XONSVC.js.map
+`);let d=t?"Y/n":"y/N",c=await n.question(`Enable telemetry for this project? [${d}] `),l=rs(c,t);return X.write(`
+`),{prefix:i,preset:s,telemetry_enabled:l}}finally{n.close()}}function eu(e){return{presetFromOption:ia(e.preset),useDefaults:e.defaults===!0,authorFromOption:ts(e.author),installBundledPackages:e.withPackages===!0,agentGuidanceMode:is(e.agentGuidance),typePreset:es(e.typePreset)}}function tu(e){let t=[];return e.prefixArg!==void 0&&e.settings.id_prefix!==e.normalizedPrefix&&t.push("id_prefix"),e.presetFromOption!==void 0&&e.settings.governance.preset!==e.presetFromOption&&t.push("governance_preset"),e.authorFromOption!==void 0&&e.settings.author_default!==e.authorFromOption&&t.push("author_default"),t}function nu(e,t,n,a){if(t.length===0||n)return;let i=a.discovery==="ancestor";throw new f(`${i?`No tracker exists in ${a.requested_cwd}; pm init found an ancestor tracker at ${a.tracker_root}. `:""}Refusing to update existing tracker settings at ${e} without --force.`,h.USAGE,{code:"init_existing_settings_requires_force",type:"urn:pm-cli:error:init_existing_settings_requires_force",required:`--force for ${t.join(", ")}`,why:i?"Ancestor discovery is useful for normal commands, but init must make the selected existing workspace explicit before changing its identity or policy settings.":"pm init is safe to rerun, but changing id prefix, governance preset, or default author on an existing tracker can corrupt long-lived project context when an agent meant to initialize a sandbox path.",resolved_path:a.tracker_root,requested_path:a.requested_cwd,suggested_path:a.suggested_current_tracker_root,examples:["pm init --yes","pm init ./sandbox-pm --yes",...i?['pm init <name> --yes --pm-path "$PWD/.agents/pm"']:[],"pm init acme --yes --force"],nextSteps:[...i?['To create a new tracker in the current directory, rerun with --pm-path "$PWD/.agents/pm".']:[],"If you meant to initialize a sandbox tracker, pass a path-like positional such as ./sandbox-pm or /tmp/pm-test.","If you intentionally want to rewrite this existing tracker's init-managed settings, rerun with --force."]})}function au(e){let t=!1;return e.prefixArg!==void 0&&e.settings.id_prefix!==e.normalizedPrefix&&(e.settings.id_prefix=e.normalizedPrefix,e.warnings.push(`updated:id_prefix:${e.normalizedPrefix}`),t=!0),e.presetFromOption!==void 0&&e.settings.governance.preset!==e.presetFromOption&&(ra(e.settings,e.presetFromOption),e.warnings.push(`updated:governance_preset:${e.presetFromOption}`),t=!0),e.authorFromOption!==void 0&&e.settings.author_default!==e.authorFromOption&&(e.settings.author_default=e.authorFromOption,e.warnings.push(`updated:author_default:${e.authorFromOption}`),t=!0),t}async function iu(e){let t=await A(e.pmRoot);e.warnings.push(`already_exists:${e.settingsPath}`);let n=tu({settings:t,normalizedPrefix:e.normalizedPrefix,prefixArg:e.prefixArg,presetFromOption:e.normalizedOptions.presetFromOption,authorFromOption:e.normalizedOptions.authorFromOption});return nu(e.settingsPath,n,e.options.force===!0,e.target),au({settings:t,normalizedPrefix:e.normalizedPrefix,prefixArg:e.prefixArg,presetFromOption:e.normalizedOptions.presetFromOption,authorFromOption:e.normalizedOptions.authorFromOption,warnings:e.warnings})&&await xe(e.pmRoot,t),{settings:t,normalizedPrefix:e.normalizedPrefix,chosenPreset:e.normalizedOptions.presetFromOption,wizardUsed:!1}}async function ru(e){let t=e.normalizedPrefix,n=e.normalizedOptions.presetFromOption,a,i=!1;if(e.normalizedOptions.presetFromOption===void 0&&!e.normalizedOptions.useDefaults&&process.stdin.isTTY===!0&&process.stdout.isTTY===!0){let d=await ps(t,rn.telemetry.enabled);t=d.prefix,n=d.preset,a=d.telemetry_enabled,i=!0}let r=n??"minimal",o=Xm();o.id_prefix=t,ra(o,r);let s=La()?.trim()||void 0;return o.author_default=e.normalizedOptions.authorFromOption??s??"",a!==void 0&&(o.telemetry.enabled=a,o.telemetry.first_run_prompt_completed=!0),await xe(e.pmRoot,o),{settings:o,normalizedPrefix:t,chosenPreset:n,wizardUsed:i}}async function Yo(e){return e.settingsExists?await iu(e):await ru({pmRoot:e.pmRoot,normalizedPrefix:e.normalizedPrefix,normalizedOptions:e.normalizedOptions})}async function ou(e){let t=await Vo({pm_root:e.pmRoot,cwd:e.cwd,mode:e.agentGuidanceMode,interactive:process.stdin.isTTY===!0&&process.stdout.isTTY===!0,settings:e.settings});return e.warnings.push(...t.warnings),t.settings_changed&&await xe(e.pmRoot,e.settings),{...t.summary,next_steps:t.next_steps}}async function su(e,t){let n=[],a=[],i=await ja(e,t.schema);for(let r of i.created_paths)n.push(r),a.push(...await B({path:r,scope:"project",op:"init:runtime_schema_file"}));return{createdDirs:n,warnings:a}}async function cu(e){if(e.typePreset===void 0)return;let t=await ss(e.pmRoot,e.settings,e.typePreset);return e.warnings.push(`registered_type_preset:${e.typePreset}`),e.warnings.push(...await B({path:t.file,scope:"project",op:"init:type_preset"})),t}async function du(e){let t=W(e.settings,J()).folders.filter(a=>!an.includes(a)),n=await ls(e.pmRoot,t);e.createdDirs.push(...n.createdDirs),e.warnings.push(...n.warnings)}function lu(e){let t=j.resolve(e.tracker_root),n=j.dirname(t);return j.basename(t)==="pm"&&j.basename(n)===".agents"?j.dirname(n):e.workspace_root}async function pu(e,t,n,a){if(!e)return;let i=await Vn("all",{install:!0,project:!0},{...t,path:n});a.push(...i.warnings);let r=os(i),o=r.packages.filter(s=>!s.ok).map(s=>s.alias);if(!r.installed_all||o.length>0)throw new f(`pm init --with-packages did not install all bundled packages successfully${o.length>0?`: ${o.join(", ")}`:"."}`,h.GENERIC_FAILURE);return r}function ms(e){let t=a=>oe([...e.target.mode==="workspace-discovery"?[]:["--pm-path",e.target.tracker_root],...a]),n=[`Create your first item: ${t(["create","--type","Task","--title","<title>"])}`,`List active items: ${t(["list"])}`,`Get agent-friendly project context: ${t(["context"])}`];e.installBundledPackages?n.push(`Explore newly-available commands: ${t(["cal"])}, ${t(["templates"])}, ${t(["guide"])}`):(n.push(`Add optional packages for richer workflows: ${t(["install","calendar","--project"])}, ${t(["install","templates","--project"])}, ${t(["install","guide-shell","--project"])}`),n.push(`Or install everything bundled: ${t(["init","--with-packages"])} (idempotent on re-run)`)),e.registeredTypePreset&&n.push(`Inspect registered preset types: ${t(["schema","list"])}, ${t(["schema","show",e.registeredTypePreset.registered[0]??e.registeredTypePreset.updated[0]])}`),n.push("Supported agent harnesses are attributed automatically; use --author or PM_AUTHOR only when an explicit identity override is required.");for(let a of e.agentGuidanceNextSteps){let i=e.target.mode==="workspace-discovery"?a:a.replace(/\bpm (?=[a-z])/g,()=>`${t([])} `);n.includes(i)||n.push(i)}return n}async function us(e,t,n,a=ni){if(t===null){n.push("merge_fence_skipped:not_git_repository:run pm merge install after moving the tracker into a Git repository");return}try{let i=await a({pmRoot:e,workspaceRoot:t});i.gitattributes.changed&&n.push(`updated:merge_fence:${i.gitattributes.path}`)}catch(i){if(!(i instanceof f))throw i;n.push(`merge_fence_skipped:install_failed:${i.context.code??"pm_error"}:${i.message}:run pm merge install after resolving the Git repository error`)}}async function mu(e,t,n,a){if(e==null||n==="status")return;let i=await Qa(e,{pmRoot:t});i.changed&&a.push(`updated:gitignore:${i.path}`)}async function Ww(e,t,n={}){let a=t[Vm],i=typeof a=="string"?a:process.cwd(),r=ns(i,t,e,n.workspace),o=r.pmRoot;e=as(r.prefixArg,n.idPrefix);let s=eu(n);await ds(o,r.target.mode==="tracker-path",n.force===!0);let d=[],c=[],l=j.join(o,"settings.json"),p=await k(l),m;p&&(m=await Yo({pmRoot:o,settingsPath:l,settingsExists:p,normalizedPrefix:Se(e),prefixArg:e,options:n,normalizedOptions:s,warnings:c,target:r.target}));let y=await ls(o,an);d.push(...y.createdDirs),c.push(...y.warnings),m??=await Yo({pmRoot:o,settingsPath:l,settingsExists:p,normalizedPrefix:Se(e),prefixArg:e,options:n,normalizedOptions:s,warnings:c,target:r.target});let{settings:g}=m,_=lu(r.target),u=await ei(_??j.dirname(o)),w=_??u,v=await ou({pmRoot:o,cwd:w??i,agentGuidanceMode:s.agentGuidanceMode,settings:g,warnings:c}),E=await su(o,g);d.push(...E.createdDirs),c.push(...E.warnings);let S=await cu({pmRoot:o,settings:g,typePreset:s.typePreset,warnings:c});S&&(g=await A(o)),await du({pmRoot:o,settings:g,createdDirs:d,warnings:c}),await mu(w,o,s.agentGuidanceMode,c),!p&&n.mergeFence!==!1&&s.agentGuidanceMode!=="status"&&await us(o,u,c);let C=await pu(s.installBundledPackages,t,o,c),te=ms({installBundledPackages:s.installBundledPackages,registeredTypePreset:S,agentGuidanceNextSteps:v.next_steps,target:r.target});return{ok:!0,path:o,target:r.target,settings:g,created_dirs:d,warnings:c,governance_preset:g.governance.preset,wizard_used:m.wizardUsed,...S?{registered_type_preset:S}:{},...C?{installed_packages:C}:{},next_steps:te,agent_guidance:v}}export{fn as a,Es as b,li as c,_n as d,Ls as e,Fs as f,Ms as g,ui as h,Ol as i,Ge as j,Ai as k,We as l,Be as m,Ti as n,Ei as o,Je as p,qe as q,$i as r,zs as s,Pu as t,ju as u,gi as v,qs as w,Qu as x,Di as y,Mi as z,Tc as A,Oc as B,ny as C,ry as D,oy as E,yt as F,sy as G,cy as H,dy as I,ly as J,py as K,my as L,uy as M,fy as N,hy as O,gy as P,yy as Q,_y as R,wy as S,vy as T,by as U,ky as V,xy as W,Sy as X,Ey as Y,$y as Z,Iy as _,Ay as $,Ty as aa,Oy as ba,Cy as ca,Z as da,b as ea,En as fa,Hc as ga,de as ha,Dt as ia,Cc as ja,rt as ka,jt as la,er as ma,dr as na,Fn as oa,kr as pa,Kh as qa,Br as ra,Zl as sa,ao as ta,io as ua,qn as va,Nr as wa,El as xa,up as ya,jr as za,Vn as Aa,Lo as Ba,ww as Ca,Vo as Da,Vm as Ea,Jw as Fa,qw as Ga,Ww as Ha};
+//# sourceMappingURL=chunk-5V4HU6GK.js.map