superpowers-mcp 6.3.10 → 6.4.2

package/out/setup-runner.js

@@ -1,20 +1,21 @@
-"use strict";var q=Object.create;var A=Object.defineProperty;var J=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var H=Object.getPrototypeOf,K=Object.prototype.hasOwnProperty;var F=(e,t)=>{for(var r in t)A(e,r,{get:t[r],enumerable:!0})},R=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of M(t))!K.call(e,s)&&s!==r&&A(e,s,{get:()=>t[s],enumerable:!(o=J(t,s))||o.enumerable});return e};var _=(e,t,r)=>(r=e!=null?q(H(e)):{},R(t||!e||!e.__esModule?A(r,"default",{value:e,enumerable:!0}):r,e)),V=e=>R(A({},"__esModule",{value:!0}),e);var Q={};F(Q,{HARNESS_CONFIGS:()=>b,JSON_SERVER_ROOT_KEYS:()=>W,isPlainObject:()=>P,runSetup:()=>U,runSetupCli:()=>G,safeWriteConfig:()=>N,stripJsonComments:()=>I,updateJsonConfig:()=>T,updateYamlConfig:()=>O});module.exports=V(Q);var i=_(require("fs")),n=_(require("path")),x=_(require("os")),D=_(require("crypto")),b={lmstudio:{name:"LM Studio",aliases:["lmstudio","lm-studio"],getConfigPath:(e,t)=>n.join(t,".lmstudio","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},roo:{name:"Roo Code (VS Code Desktop)",aliases:["roo","roo-code","roocode"],getConfigPath:(e,t,r)=>{let o=e==="win32"?r||n.join(t,"AppData","Roaming"):e==="darwin"?n.join(t,"Library","Application Support"):n.join(t,".config");return n.join(o,"Code","User","globalStorage","rooveterinaryinc.roo-cline","settings","mcp_settings.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code","User","mcp.json"):n.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(t,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>n.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,o)=>{if(e==="win32"){let s=o||n.join(t,"AppData","Local");return n.join(s,"hermes","config.yaml")}return n.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>n.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?n.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t)=>{let r=n.join(t,".config","devin","mcp_config.json");return i.existsSync(r)?r:n.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>n.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let a=n.join(r||n.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(i.existsSync(a))return a;let c=n.join(t,".pi","agent","mcp.json");if(i.existsSync(c))return c;let g=n.join(t,".pi","mcp.json");return i.existsSync(g)?g:c}let o=n.join(t,".pi","agent","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,".pi","mcp.json");return i.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(e,t)=>{let r=n.join(t,".qwenpaw","config.json");if(i.existsSync(r))return r;let o=n.join(t,".copaw","config.json");return i.existsSync(o)?o:r},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(e,t,r)=>{let o="";if(e==="win32"?o=n.join(r||n.join(t,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):e==="darwin"?o=n.join(t,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):o=n.join(t,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),i.existsSync(o))return o;let s=n.join(t,".cline","data","settings","cline_mcp_settings.json");return i.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(e,t)=>{let r=n.join(t,".config","kilo","kilo.jsonc");if(i.existsSync(r))return r;let o=n.join(t,".config","kilo","kilo.json");return i.existsSync(o)?o:r},type:"json-mcp",defaultConfig:(e,t)=>({type:"local",command:[e,...t],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(e,t)=>n.join(t,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(e,t)=>n.join(t,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(e,t,r)=>{if(e==="win32"){let o=n.join(r||n.join(t,"AppData","Roaming"),"Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(r||n.join(t,"AppData","Roaming"),"Trae CN","User","mcp.json");return i.existsSync(s)?s:o}else if(e==="darwin"){let o=n.join(t,"Library","Application Support","Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,"Library","Application Support","Trae CN","User","mcp.json");return i.existsSync(s)?s:o}else{let o=n.join(t,".config","Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,".config","Trae CN","User","mcp.json");return i.existsSync(s)?s:o}},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}},W=["mcpServers","servers","mcp"];function P(e){return Object.prototype.toString.call(e)==="[object Object]"}function I(e,t=!1){if(!e)return"";if(!t)try{return JSON.parse(e),e}catch{}let r=e.length,o=[],s=!1,a=!1,c=!1,g=!1,h=-1;for(let f=0;f<r;f++){let p=e[f],d=f+1<r?e[f+1]:"";if(c){(p===`
-`||p==="\r")&&(c=!1,o.push(p));continue}if(g){p==="*"&&d==="/"&&(g=!1,f++);continue}if(s){o.push(p),a?a=!1:p==="\\"?a=!0:p==='"'&&(s=!1);continue}if(p==='"'){s=!0,a=!1,h=-1,o.push(p);continue}if(p==="/"&&d==="/"){c=!0,f++;continue}if(p==="/"&&d==="*"){g=!0,f++;continue}if(p===","){h=o.length,o.push(p);continue}if(p==="}"||p==="]"){h!==-1&&(o[h]=" ",h=-1),o.push(p);continue}p!==" "&&p!=="	"&&p!==`
-`&&p!=="\r"&&(h=-1),o.push(p)}return o.join("")}var $=/\s/;function z(e){for(let t=1;t<e.length;t++){if(e[t]!=="#"||!$.test(e[t-1]))continue;let r=t-1;for(;r>0&&$.test(e[r-1]);)r--;return e.slice(r)}return""}function O(e,t,r,o=!1){let s=e?e.split(/\r?\n/):[],a=s.map((u,w)=>{let C=u.match(/^(\s*)mcp_servers:/);return C?{index:w,indent:C[1],tail:u.slice(C[0].length).trim()}:null}).filter(u=>u!==null);if(a.length>1)throw new Error("Cannot safely update YAML with duplicate mcp_servers keys");if(a.length===1){let u=a[0];if(u.indent!==""||u.tail!==""&&!u.tail.startsWith("#"))throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping")}let c="  ";if(a.length===1)for(let u=a[0].index+1;u<s.length;u++){if(s[u].trim()===""||s[u].trimStart().startsWith("#"))continue;if(/^[^\s]/.test(s[u]))break;let w=s[u].match(/^(\s+)\S/);w&&(c=w[1]);break}if(o){let u=[],w=!1,C=0,y=!1,S=0;for(let j=0;j<s.length;j++){let l=s[j],m=l.match(/^(\s*)mcp_servers:\s*(?:#.*)?$/);if(m){w=!0,C=m[1].length,u.push(l);continue}if(w){let v=l.match(/^(\s*)/)?.[1].length||0;if(l.trimStart().startsWith("#")){u.push(l);continue}if(l.trim()!==""&&v<=C)w=!1,y=!1;else{let k=l.match(/^(\s*)superpowers:\s*(?:#.*)?$/);if(k&&k[1]===c){y=!0,S=k[1].length;continue}if(y){if(v>S||l.trim()==="")continue;y=!1}}}u.push(l)}return u.join(`
-`)}let g=JSON.stringify(t),h=JSON.stringify(r),f=[`${c}superpowers:`,`${c}${c}command: ${g}`,`${c}${c}args: ${h}`];if(!e||e.trim()==="")return`mcp_servers:
-${f.join(`
+"use strict";var M=Object.create;var E=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var K=Object.getPrototypeOf,V=Object.prototype.hasOwnProperty;var F=(e,t)=>{for(var r in t)E(e,r,{get:t[r],enumerable:!0})},$=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of H(t))!V.call(e,s)&&s!==r&&E(e,s,{get:()=>t[s],enumerable:!(o=q(t,s))||o.enumerable});return e};var _=(e,t,r)=>(r=e!=null?M(K(e)):{},$(t||!e||!e.__esModule?E(r,"default",{value:e,enumerable:!0}):r,e)),z=e=>$(E({},"__esModule",{value:!0}),e);var X={};F(X,{HARNESS_CONFIGS:()=>b,JSON_SERVER_ROOT_KEYS:()=>O,isPlainObject:()=>P,runSetup:()=>J,runSetupCli:()=>Q,safeWriteConfig:()=>U,stripJsonComments:()=>I,updateJsonConfig:()=>T,updateYamlConfig:()=>N});module.exports=z(X);var a=_(require("fs")),n=_(require("path")),k=_(require("os")),D=_(require("crypto")),b={lmstudio:{name:"LM Studio",aliases:["lmstudio","lm-studio"],getConfigPath:(e,t)=>n.join(t,".lmstudio","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},roo:{name:"Roo Code (VS Code Desktop)",aliases:["roo","roo-code","roocode"],getConfigPath:(e,t,r)=>{let o=e==="win32"?r||n.join(t,"AppData","Roaming"):e==="darwin"?n.join(t,"Library","Application Support"):n.join(t,".config");return n.join(o,"Code","User","globalStorage","rooveterinaryinc.roo-cline","settings","mcp_settings.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code","User","mcp.json"):n.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(t,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>n.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,o)=>{if(e==="win32"){let s=o||n.join(t,"AppData","Local");return n.join(s,"hermes","config.yaml")}return n.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>n.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?n.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t,r)=>{let o=e==="win32"&&r?r:n.join(t,".config"),s=n.join(o,"devin","mcp_config.json");return a.existsSync(s)?s:n.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>n.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let c=n.join(r||n.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(a.existsSync(c))return c;let i=n.join(t,".pi","agent","mcp.json");if(a.existsSync(i))return i;let p=n.join(t,".pi","mcp.json");return a.existsSync(p)?p:i}let o=n.join(t,".pi","agent","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,".pi","mcp.json");return a.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(e,t)=>{let r=n.join(t,".qwenpaw","config.json");if(a.existsSync(r))return r;let o=n.join(t,".copaw","config.json");return a.existsSync(o)?o:r},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(e,t,r)=>{let o="";if(e==="win32"?o=n.join(r||n.join(t,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):e==="darwin"?o=n.join(t,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):o=n.join(t,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),a.existsSync(o))return o;let s=n.join(t,".cline","data","settings","cline_mcp_settings.json");return a.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(e,t)=>{let r=n.join(t,".config","kilo","kilo.jsonc");if(a.existsSync(r))return r;let o=n.join(t,".config","kilo","kilo.json");return a.existsSync(o)?o:r},type:"json-mcp",defaultConfig:(e,t)=>({type:"local",command:[e,...t],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(e,t)=>n.join(t,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(e,t)=>n.join(t,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(e,t,r)=>{if(e==="win32"){let o=n.join(r||n.join(t,"AppData","Roaming"),"Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(r||n.join(t,"AppData","Roaming"),"Trae CN","User","mcp.json");return a.existsSync(s)?s:o}else if(e==="darwin"){let o=n.join(t,"Library","Application Support","Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,"Library","Application Support","Trae CN","User","mcp.json");return a.existsSync(s)?s:o}else{let o=n.join(t,".config","Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,".config","Trae CN","User","mcp.json");return a.existsSync(s)?s:o}},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}},O=["mcpServers","servers","mcp"];function P(e){return Object.prototype.toString.call(e)==="[object Object]"}function I(e,t=!1){if(!e)return"";if(!t)try{return JSON.parse(e),e}catch{}let r=e.length,o=[],s=!1,c=!1,i=!1,p=!1,S=-1;for(let m=0;m<r;m++){let g=e[m],C=m+1<r?e[m+1]:"";if(i){(g===`
+`||g==="\r")&&(i=!1,o.push(g));continue}if(p){g==="*"&&C==="/"&&(p=!1,m++);continue}if(s){o.push(g),c?c=!1:g==="\\"?c=!0:g==='"'&&(s=!1);continue}if(g==='"'){s=!0,c=!1,S=-1,o.push(g);continue}if(g==="/"&&C==="/"){i=!0,m++;continue}if(g==="/"&&C==="*"){p=!0,m++;continue}if(g===","){S=o.length,o.push(g);continue}if(g==="}"||g==="]"){S!==-1&&(o[S]=" ",S=-1),o.push(g);continue}g!==" "&&g!=="	"&&g!==`
+`&&g!=="\r"&&(S=-1),o.push(g)}return o.join("")}var W=/\s/;function G(e){for(let t=1;t<e.length;t++){if(e[t]!=="#"||!W.test(e[t-1]))continue;let r=t-1;for(;r>0&&W.test(e[r-1]);)r--;return e.slice(r)}return""}function N(e,t,r,o=!1){let s=e?e.split(/\r?\n/):[],c=s.map((l,d)=>{let y=l.match(/^(\s*)mcp_servers:/);return y?{index:d,indent:y[1],tail:l.slice(y[0].length).trim()}:null}).filter(l=>l!==null),i=c.filter(l=>l.indent==="");if(i.length>1)throw new Error("Cannot safely update YAML with duplicate mcp_servers keys");if(i.length===1){let l=i[0];if(l.tail!==""&&!l.tail.startsWith("#"))throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping")}else if(c.length>0)throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping");let p="  ";if(i.length===1)for(let l=i[0].index+1;l<s.length;l++){if(s[l].trim()===""||s[l].trimStart().startsWith("#"))continue;if(/^[^\s]/.test(s[l]))break;let d=s[l].match(/^(\s+)\S/);d&&(p=d[1]);break}if(o){let l=[],d=!1,y=0,j=!1,w=0;for(let f=0;f<s.length;f++){let u=s[f],v=u.match(/^(\s*)mcp_servers:\s*(?:#.*)?$/);if(v){d=!0,y=v[1].length,l.push(u);continue}if(d){let x=u.match(/^(\s*)/)?.[1].length||0;if(u.trimStart().startsWith("#")){l.push(u);continue}if(u.trim()!==""&&x<=y)d=!1,j=!1;else{let A=u.match(/^(\s*)superpowers:\s*(?:#.*)?$/);if(A&&A[1]===p){j=!0,w=A[1].length;continue}if(j){if(x>w||u.trim()==="")continue;j=!1}}}l.push(u)}return l.join(`
+`)}let S=JSON.stringify(t),m=JSON.stringify(r),g=[`${p}superpowers:`,`${p}${p}command: ${S}`,`${p}${p}args: ${m}`];if(!e||e.trim()==="")return`mcp_servers:
+${g.join(`
 `)}
-`;let p=a.length===1?a[0].index:-1;if(p===-1)return`${e.trimEnd()}
+`;let C=i.length===1?i[0].index:-1;if(C===-1)return`${e.trimEnd()}
 
 mcp_servers:
-${f.join(`
+${g.join(`
 `)}
-`;let d=-1;for(let u=p+1;u<s.length;u++){let w=s[u];if(/^[^\s#]/.test(w))break;if((w.match(/^(\s*)/)?.[1]||"")===c&&/^\s+["']?superpowers["']?\s*:\s*(?:#.*)?$/.test(w)){d=u;break}}if(d!==-1){let u=s[d].match(/^(\s*)/)?.[1].length||2,w=d+1;for(;w<s.length;){let S=s[w];if((S.match(/^(\s*)/)?.[1].length||0)>u||S.trim()==="")w++;else break}let C=[],y=-1;for(let S=d+1;S<w;S++){let j=s[S];if(j.trim()==="")continue;let l=j.match(/^(\s*)/)?.[1].length??0;if(!(y!==-1&&l>y)){if(y=-1,l>u&&/^\s*["']?(?:command|args)["']?\s*:/.test(j)){y=l;continue}C.push(j)}}return f[0]+=z(s[d]),s.splice(d,w-d,...f,...C),s.join(`
-`)}else return s.splice(p+1,0,...f),s.join(`
-`)}function T(e,t,r,o,s=!1,a){let c={};if(e&&e.trim()!=="")try{let p=JSON.parse(e);if(!P(p))throw new Error("Existing JSON root must be an object");c=p}catch{try{let d=I(e,!0),u=JSON.parse(d);if(!P(u))throw new Error("Existing JSON root must be an object");c=u}catch(d){let u=d instanceof Error?d.message:String(d);throw new Error(`Failed to parse existing JSON: ${u}`)}}let g=t==="json-servers"?"servers":t==="json-mcp"?"mcp":"mcpServers",h=W.find(p=>P(c[p])&&c[p].superpowers!==void 0)??g;if(c[h]!==void 0&&!P(c[h]))throw new Error(`Existing JSON field "${h}" must be an object`);c[h]===void 0&&(c[h]={});let f=c[h];if(s)delete f.superpowers;else{let p;a?p={...a}:t==="json-servers"?p={command:r,args:o,type:"stdio"}:t==="json-mcp"?p={type:"local",command:[r,...o],enabled:!0}:p={command:r,args:o};let d=f.superpowers;if(!P(d))f.superpowers=p;else{let u={...d,...p};(d.enabled!==void 0||d.disabled!==void 0)&&(d.enabled!==void 0?u.enabled=d.enabled:delete u.enabled),t==="json-mcp"&&Array.isArray(u.command)&&delete u.args,f.superpowers=u}}return JSON.stringify(c,null,2)+`
-`}function N(e,t,r=!1,o=[],s){if(o.length===0)throw new Error("safeWriteConfig requires at least one allowed destination root");let a=e;try{let l=i.lstatSync(e,{throwIfNoEntry:!1});if(l&&l.isSymbolicLink()){try{a=i.realpathSync(e)}catch{let L=i.readlinkSync(e);a=n.resolve(n.dirname(e),L)}let m=n.normalize(n.resolve(a)).toLowerCase(),v=n.normalize(n.resolve(x.tmpdir())).toLowerCase();if(!(m===v||m.startsWith(v+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(E=>m===E||m.startsWith(E+n.sep))||m==="/var"||m.startsWith("/var"+n.sep)&&!m.startsWith("/var/folders"+n.sep)||m==="/private/var"||m.startsWith("/private/var"+n.sep)&&!m.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${a}`)}}catch(l){if(l instanceof Error&&l.message.includes("Refusing to write to unsafe symlink target"))throw l}let c=n.dirname(a);i.existsSync(c)||i.mkdirSync(c,{recursive:!0,mode:448});let g=i.realpathSync(c),h=i.statSync(g);a=n.join(g,n.basename(a));let f=n.normalize(n.resolve(a)).toLowerCase(),p=n.normalize(n.resolve(x.tmpdir())).toLowerCase(),d=f===p||f.startsWith(p+n.sep),w=["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(l=>f===l||f.startsWith(l+n.sep))||f==="/var"||f.startsWith("/var"+n.sep)&&!f.startsWith("/var/folders"+n.sep)||f==="/private/var"||f.startsWith("/private/var"+n.sep)&&!f.startsWith("/private/var/folders"+n.sep);if(!d&&w)throw new Error(`Refusing to write to unsafe configuration target: ${a}`);if(!o.some(l=>{if(!l)return!1;let m=n.resolve(l);try{m=i.realpathSync(m)}catch{}let v=n.relative(m,a);return v!==".."&&!v.startsWith(`..${n.sep}`)&&!n.isAbsolute(v)}))throw new Error(`Refusing to write configuration outside allowed roots: ${a}`);let y=384;if(i.existsSync(a)){try{y=i.statSync(a).mode}catch{}if(r){let l=i.readFileSync(a,"utf8"),m=`${a}.${Date.now()}.bak`;try{i.writeFileSync(m,l,{encoding:"utf8",mode:y})}catch(v){let k=v instanceof Error?v.message:String(v);throw new Error(`Failed to create safe backup before write: ${k}`)}}}let S=D.randomBytes(8).toString("hex"),j=n.join(g,`.tmp.${n.basename(a)}.${process.pid}.${S}`);try{i.writeFileSync(j,t,{encoding:"utf8",mode:y,flag:"wx"});let l=i.existsSync(a);if(s===null&&l)throw new Error("Configuration changed concurrently before it could be created");if(s!=null&&(!l||i.readFileSync(a,"utf8")!==s))throw new Error("Configuration changed concurrently; refusing to overwrite newer content");let m=i.realpathSync(c),v=i.statSync(m);if(m!==g||v.dev!==h.dev||v.ino!==h.ino)throw new Error("Configuration directory changed while writing");i.renameSync(j,a)}catch(l){try{i.existsSync(j)&&i.unlinkSync(j)}catch{}throw l}}async function U(e={}){let t=e.platform||x.platform(),r=e.homeDir||x.homedir(),o=e.appData||process.env.APPDATA,s=e.localAppData||process.env.LOCALAPPDATA,a=!!e.dryRun,c=!!e.remove,g=!!e.bun,h=e.target?e.target.toLowerCase():null,f=g?"bunx":"npx",p=["-y","superpowers-mcp"],d=[];if(!h)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(b).join("|")}>.`);let u=Object.keys(b).find(C=>C===h||b[C].aliases.includes(h));if(!u)throw new Error(`Unknown harness target: "${h}". Supported targets: ${Object.keys(b).join(", ")}`);let w=[u];for(let C of w){let y=b[C],S=y.getConfigPath(t,r,o,s),j=i.existsSync(S);if(c&&!j){d.push({target:C,name:y.name,path:S,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let l="";j&&(l=i.readFileSync(S,"utf8"));let m="";if(y.type==="yaml")m=O(l,f,p,c);else{let v=typeof y.defaultConfig=="function"?y.defaultConfig(f,p):void 0;m=T(l,y.type,f,p,c,v)}if(l.trim()===m.trim()&&j){d.push({target:C,name:y.name,path:S,status:"up-to-date",message:c?"Already not configured":"Already configured and up-to-date"});continue}a||N(S,m,!!e.backup,[r,o||"",s||""],j?l:null),d.push({target:C,name:y.name,path:S,status:c?"removed":j?"updated":"created",message:a?`[Dry Run] Would ${c?"remove from":j?"update":"create"} ${S}`:`Successfully ${c?"removed from":j?"updated":"configured"}!`})}catch(l){let m=l instanceof Error?l.message:String(l);d.push({target:C,name:y.name,path:S,status:"error",message:m})}}return d}async function G(e=process.argv.slice(2)){let t=!1,r={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<e.length;o++){let s=e[o];if(!(s==="setup"||s==="install"||s==="--setup"))if(s==="--print-config")t=!0;else if(s==="--dry-run")r.dryRun=!0;else if(s==="--remove"||s==="--uninstall")r.remove=!0;else if(s==="--bun")r.bun=!0;else if(s==="--backup")r.backup=!0;else if(s==="--target"||s==="-t"){let a=e[o+1];if(!a||a.startsWith("-")){console.error(`\u274C Error: Missing value for --target flag.
-`),process.exitCode=1;return}r.target=e[++o]}else if(s.startsWith("--target=")){let a=s.split("=")[1];if(!a){console.error(`\u274C Error: Missing value for --target flag.
-`),process.exitCode=1;return}r.target=a}else if(s==="--help"||s==="-h"){Y();return}else if(s.startsWith("-")){console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
+`;let h=-1;for(let l=C+1;l<s.length;l++){let d=s[l];if(/^[^\s#]/.test(d))break;if((d.match(/^(\s*)/)?.[1]||"")===p&&/^\s+["']?superpowers["']?\s*:\s*(?:#.*)?$/.test(d)){h=l;break}}if(h!==-1){let l=s[h].match(/^(\s*)/)?.[1].length||2,d=h+1;for(;d<s.length;){let w=s[d];if((w.match(/^(\s*)/)?.[1].length||0)>l||w.trim()==="")d++;else break}let y=[],j=-1;for(let w=h+1;w<d;w++){let f=s[w];if(f.trim()==="")continue;let u=f.match(/^(\s*)/)?.[1].length??0;if(!(j!==-1&&u>j)){if(j=-1,u>l&&/^\s*["']?(?:command|args)["']?\s*:/.test(f)){j=u;continue}y.push(f)}}return g[0]+=G(s[h]),s.splice(h,d-h,...g,...y),s.join(`
+`)}else return s.splice(C+1,0,...g),s.join(`
+`)}function T(e,t,r,o,s=!1,c){let i={},p=!1;if(e&&e.trim()!=="")try{let h=JSON.parse(e);if(!P(h))throw new Error("Existing JSON root must be an object");i=h}catch(h){try{let l=I(e,!0),d=JSON.parse(l);if(!P(d))throw new Error("Existing JSON root must be an object");i=d,p=l!==e}catch(l){let d=l instanceof Error?l.message:String(l),y=h instanceof Error?h.message:String(h);throw new Error(`Failed to parse existing JSON: ${d} (raw JSON error: ${y})`)}}let S=t==="json-servers"?"servers":t==="json-mcp"?"mcp":"mcpServers",m=O.find(h=>P(i[h])&&i[h].superpowers!==void 0)??S;if(i[m]!==void 0&&!P(i[m]))throw new Error(`Existing JSON field "${m}" must be an object`);i[m]===void 0&&(i[m]={});let g=i[m];if(s)delete g.superpowers;else{let h;c?h={...c}:t==="json-servers"?h={command:r,args:o,type:"stdio"}:t==="json-mcp"?h={type:"local",command:[r,...o],enabled:!0}:h={command:r,args:o};let l=g.superpowers;if(!P(l))g.superpowers=h;else{let d={...l,...h};(l.enabled!==void 0||l.disabled!==void 0)&&(l.enabled!==void 0?d.enabled=l.enabled:delete d.enabled),t==="json-mcp"&&Array.isArray(d.command)&&delete d.args,g.superpowers=d}}let C=JSON.stringify(i,null,2)+`
+`;return p&&C!==e&&process.stderr.write(`[superpowers-mcp] Warning: JSONC comments/trailing commas in the existing config were removed while updating it (the file is rewritten as plain JSON).
+`),C}function Y(e,t=10){try{let r=n.dirname(e),o=`${n.basename(e)}.`,s=".bak",c=a.readdirSync(r).filter(i=>{if(!i.startsWith(o)||!i.endsWith(s))return!1;let p=i.slice(o.length,i.length-s.length);return/^\d+$/.test(p)}).map(i=>{let p=n.join(r,i);try{return{full:p,mtimeMs:a.statSync(p).mtimeMs}}catch{return{full:p,mtimeMs:0}}}).sort((i,p)=>p.mtimeMs-i.mtimeMs);for(let i of c.slice(t))try{a.unlinkSync(i.full)}catch{}}catch{}}function U(e,t,r=!1,o=[],s){if(o.length===0)throw new Error("safeWriteConfig requires at least one allowed destination root");let c=e;try{let f=a.lstatSync(e,{throwIfNoEntry:!1});if(f&&f.isSymbolicLink()){try{c=a.realpathSync(e)}catch{let L=a.readlinkSync(e);c=n.resolve(n.dirname(e),L)}let u=n.normalize(n.resolve(c)).toLowerCase(),v=n.normalize(n.resolve(k.tmpdir())).toLowerCase();if(!(u===v||u.startsWith(v+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(R=>u===R||u.startsWith(R+n.sep))||u==="/var"||u.startsWith("/var"+n.sep)&&!u.startsWith("/var/folders"+n.sep)||u==="/private/var"||u.startsWith("/private/var"+n.sep)&&!u.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${c}`)}}catch(f){if(f instanceof Error&&f.message.includes("Refusing to write to unsafe symlink target"))throw f}let i=n.dirname(c);a.existsSync(i)||a.mkdirSync(i,{recursive:!0,mode:448});let p=a.realpathSync(i),S=a.statSync(p);c=n.join(p,n.basename(c));let m=n.normalize(n.resolve(c)).toLowerCase(),g=n.normalize(n.resolve(k.tmpdir())).toLowerCase(),C=m===g||m.startsWith(g+n.sep),l=["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(f=>m===f||m.startsWith(f+n.sep))||m==="/var"||m.startsWith("/var"+n.sep)&&!m.startsWith("/var/folders"+n.sep)||m==="/private/var"||m.startsWith("/private/var"+n.sep)&&!m.startsWith("/private/var/folders"+n.sep);if(!C&&l)throw new Error(`Refusing to write to unsafe configuration target: ${c}`);if(!o.some(f=>{if(!f)return!1;let u=n.resolve(f);try{u=a.realpathSync(u)}catch{}let v=n.relative(u,c);return v!==".."&&!v.startsWith(`..${n.sep}`)&&!n.isAbsolute(v)}))throw new Error(`Refusing to write configuration outside allowed roots: ${c}`);let y=384;if(a.existsSync(c)){try{y=a.statSync(c).mode}catch{}if(r){let f=a.readFileSync(c,"utf8"),u=`${c}.${Date.now()}.bak`;try{a.writeFileSync(u,f,{encoding:"utf8",mode:y})}catch(v){let x=v instanceof Error?v.message:String(v);throw new Error(`Failed to create safe backup before write: ${x}`)}Y(c)}}let j=D.randomBytes(8).toString("hex"),w=n.join(p,`.tmp.${n.basename(c)}.${process.pid}.${j}`);try{a.writeFileSync(w,t,{encoding:"utf8",mode:y,flag:"wx"});let f=a.existsSync(c);if(s===null&&f)throw new Error("Configuration changed concurrently before it could be created");if(s!=null&&(!f||a.readFileSync(c,"utf8")!==s))throw new Error("Configuration changed concurrently; refusing to overwrite newer content");let u=a.realpathSync(i),v=a.statSync(u);if(u!==p||v.dev!==S.dev||v.ino!==S.ino)throw new Error("Configuration directory changed while writing");a.renameSync(w,c)}catch(f){try{a.existsSync(w)&&a.unlinkSync(w)}catch{}throw f}}async function J(e={}){let t=e.platform||k.platform(),r=e.homeDir||k.homedir(),o=e.appData||process.env.APPDATA,s=e.localAppData||process.env.LOCALAPPDATA,c=!!e.dryRun,i=!!e.remove,p=!!e.bun,S=e.target?e.target.toLowerCase():null,m=p?"bunx":"npx",g=["-y","superpowers-mcp"],C=[];if(!S)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(b).join("|")}>.`);let h=Object.keys(b).find(d=>d===S||b[d].aliases.includes(S));if(!h)throw new Error(`Unknown harness target: "${S}". Supported targets: ${Object.keys(b).join(", ")}`);let l=[h];for(let d of l){let y=b[d],j=y.getConfigPath(t,r,o,s),w=a.existsSync(j);if(i&&!w){C.push({target:d,name:y.name,path:j,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let f="";w&&(f=a.readFileSync(j,"utf8"));let u="";if(y.type==="yaml")u=N(f,m,g,i);else{let v=typeof y.defaultConfig=="function"?y.defaultConfig(m,g):void 0;u=T(f,y.type,m,g,i,v)}if(f.trim()===u.trim()&&w){C.push({target:d,name:y.name,path:j,status:"up-to-date",message:i?"Already not configured":"Already configured and up-to-date"});continue}c||U(j,u,!!e.backup,[r,o||"",s||""],w?f:null),C.push({target:d,name:y.name,path:j,status:i?"removed":w?"updated":"created",message:c?`[Dry Run] Would ${i?"remove from":w?"update":"create"} ${j}`:`Successfully ${i?"removed from":w?"updated":"configured"}!`})}catch(f){let u=f instanceof Error?f.message:String(f);C.push({target:d,name:y.name,path:j,status:"error",message:u})}}return C}async function Q(e=process.argv.slice(2)){let t=!1,r={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<e.length;o++){let s=e[o];if(!(s==="setup"||s==="install"||s==="--setup"))if(s==="--print-config")t=!0;else if(s==="--dry-run")r.dryRun=!0;else if(s==="--remove"||s==="--uninstall")r.remove=!0;else if(s==="--bun")r.bun=!0;else if(s==="--backup")r.backup=!0;else if(s==="--target"||s==="-t"){let c=e[o+1];if(!c||c.startsWith("-")){console.error(`\u274C Error: Missing value for --target flag.
+`),process.exitCode=1;return}r.target=e[++o]}else if(s.startsWith("--target=")){let c=s.split("=")[1];if(!c){console.error(`\u274C Error: Missing value for --target flag.
+`),process.exitCode=1;return}r.target=c}else if(s==="--help"||s==="-h"){B();return}else if(s.startsWith("-")){console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
 `),process.exitCode=1;return}else if(!r.target)r.target=s;else{console.error(`\u274C Error: Unexpected argument "${s}". Use --help for usage.
 `),process.exitCode=1;return}}if(t){if(r.target||r.remove||r.backup||r.dryRun){console.error("--print-config supports only --bun; omit target and file-operation flags."),process.exitCode=1;return}console.log(JSON.stringify({mcpServers:{superpowers:{command:r.bun?"bunx":"npx",args:["-y","superpowers-mcp"]}}},null,2));return}if(console.log(`
 ========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
@@ -22,9 +23,9 @@ ${f.join(`
 `),console.log("  npx -y superpowers-mcp setup --target lmstudio   # LM Studio (~/.lmstudio/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target roo        # Roo Code in VS Code Desktop"),console.log("  npx -y superpowers-mcp setup --print-config      # JSON for desktop app import"),console.log("  npx -y superpowers-mcp setup --target antigravity # Antigravity (~/.gemini/config/mcp_config.json)"),console.log("  npx -y superpowers-mcp setup --target pi-desktop  # Pi Desktop / Pi Agent (~/.pi/agent/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target cursor     # Cursor (~/.cursor/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot    # GitHub Copilot (VS Code mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot-insiders # GitHub Copilot (VS Code Insiders mcp.json)"),console.log("  npx -y superpowers-mcp setup --target hermes     # Hermes Desktop / Agent"),console.log("  npx -y superpowers-mcp setup --target kimi       # Kimi Work / Kimi Code"),console.log("  npx -y superpowers-mcp setup --target claude     # Claude Desktop"),console.log("  npx -y superpowers-mcp setup --target devin      # Devin Desktop (formerly Windsurf)"),console.log("  npx -y superpowers-mcp setup --target qwenpaw    # QwenPaw / CoPaw (~/.qwenpaw/config.json)"),console.log("  npx -y superpowers-mcp setup --target cline      # Cline (~/.../cline_mcp_settings.json)"),console.log("  npx -y superpowers-mcp setup --target kilo       # Kilo Code (~/.config/kilo/kilo.jsonc)"),console.log("  npx -y superpowers-mcp setup --target qoder      # Qoder (~/.qoder/settings.json)"),console.log("  npx -y superpowers-mcp setup --target kiro       # Kiro (~/.kiro/settings/mcp.json)"),console.log(`  npx -y superpowers-mcp setup --target trae       # Trae (~/.../Trae/User/mcp.json)
 `),console.log("\u{1F4A1} Tip:"),console.log("   You can run this setup command from ANY folder on your system."),console.log(`   It automatically targets your global config files (~/...) without needing to clone this repo.
 `),console.log("\u{1F4A1} Privacy & Safety:"),console.log("   Superpowers MCP only configures the specific client you explicitly choose."),console.log(`   It will NEVER silently scan or modify unselected environments.
-`),process.exitCode=1;return}try{let o=await U(r),s=0,a=0,c=0;for(let g of o){let h=g.status==="created"||g.status==="updated"||g.status==="removed"?"\u2705":g.status==="up-to-date"?"\u2728":g.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${h} [${g.name}] (${g.status})`),console.log(`   Path: ${g.path}`),console.log(`   Info: ${g.message}
-`),g.status==="created"||g.status==="updated"||g.status==="up-to-date"||g.status==="removed"?s++:g.status==="skipped"?a++:g.status==="error"&&c++}if(console.log("--------------------------------------------------------"),c>0){console.error(`\u26A0\uFE0F Setup finished with errors: ${c} failure(s), ${s} succeeded.`),process.exitCode=1;return}console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
-`),process.exitCode=1}}function Y(){console.log(`
+`),process.exitCode=1;return}try{let o=await J(r),s=0,c=0,i=0;for(let p of o){let S=p.status==="created"||p.status==="updated"||p.status==="removed"?"\u2705":p.status==="up-to-date"?"\u2728":p.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${S} [${p.name}] (${p.status})`),console.log(`   Path: ${p.path}`),console.log(`   Info: ${p.message}
+`),p.status==="created"||p.status==="updated"||p.status==="up-to-date"||p.status==="removed"?s++:p.status==="skipped"?c++:p.status==="error"&&i++}if(console.log("--------------------------------------------------------"),i>0){console.error(`\u26A0\uFE0F Setup finished with errors: ${i} failure(s), ${s} succeeded.`),process.exitCode=1;return}console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
+`),process.exitCode=1}}function B(){console.log(`
 Superpowers MCP - Targeted Global Setup
 
 Usage:

package/out/setup.js

@@ -1,21 +1,22 @@
 #!/usr/bin/env node
-"use strict";var J=Object.create;var A=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var K=Object.getPrototypeOf,F=Object.prototype.hasOwnProperty;var V=(e,t)=>{for(var r in t)A(e,r,{get:t[r],enumerable:!0})},$=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of H(t))!F.call(e,s)&&s!==r&&A(e,s,{get:()=>t[s],enumerable:!(o=M(t,s))||o.enumerable});return e};var E=(e,t,r)=>(r=e!=null?J(K(e)):{},$(t||!e||!e.__esModule?A(r,"default",{value:e,enumerable:!0}):r,e)),z=e=>$(A({},"__esModule",{value:!0}),e);var Q={};V(Q,{HARNESS_CONFIGS:()=>b,JSON_SERVER_ROOT_KEYS:()=>I,isPlainObject:()=>P,runSetup:()=>L,runSetupCli:()=>R,safeWriteConfig:()=>U,stripJsonComments:()=>O,updateJsonConfig:()=>N,updateYamlConfig:()=>T});module.exports=z(Q);var i=E(require("fs")),n=E(require("path")),x=E(require("os")),W=E(require("crypto")),b={lmstudio:{name:"LM Studio",aliases:["lmstudio","lm-studio"],getConfigPath:(e,t)=>n.join(t,".lmstudio","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},roo:{name:"Roo Code (VS Code Desktop)",aliases:["roo","roo-code","roocode"],getConfigPath:(e,t,r)=>{let o=e==="win32"?r||n.join(t,"AppData","Roaming"):e==="darwin"?n.join(t,"Library","Application Support"):n.join(t,".config");return n.join(o,"Code","User","globalStorage","rooveterinaryinc.roo-cline","settings","mcp_settings.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code","User","mcp.json"):n.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(t,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>n.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,o)=>{if(e==="win32"){let s=o||n.join(t,"AppData","Local");return n.join(s,"hermes","config.yaml")}return n.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>n.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?n.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t)=>{let r=n.join(t,".config","devin","mcp_config.json");return i.existsSync(r)?r:n.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>n.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let a=n.join(r||n.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(i.existsSync(a))return a;let c=n.join(t,".pi","agent","mcp.json");if(i.existsSync(c))return c;let g=n.join(t,".pi","mcp.json");return i.existsSync(g)?g:c}let o=n.join(t,".pi","agent","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,".pi","mcp.json");return i.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(e,t)=>{let r=n.join(t,".qwenpaw","config.json");if(i.existsSync(r))return r;let o=n.join(t,".copaw","config.json");return i.existsSync(o)?o:r},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(e,t,r)=>{let o="";if(e==="win32"?o=n.join(r||n.join(t,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):e==="darwin"?o=n.join(t,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):o=n.join(t,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),i.existsSync(o))return o;let s=n.join(t,".cline","data","settings","cline_mcp_settings.json");return i.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(e,t)=>{let r=n.join(t,".config","kilo","kilo.jsonc");if(i.existsSync(r))return r;let o=n.join(t,".config","kilo","kilo.json");return i.existsSync(o)?o:r},type:"json-mcp",defaultConfig:(e,t)=>({type:"local",command:[e,...t],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(e,t)=>n.join(t,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(e,t)=>n.join(t,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(e,t,r)=>{if(e==="win32"){let o=n.join(r||n.join(t,"AppData","Roaming"),"Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(r||n.join(t,"AppData","Roaming"),"Trae CN","User","mcp.json");return i.existsSync(s)?s:o}else if(e==="darwin"){let o=n.join(t,"Library","Application Support","Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,"Library","Application Support","Trae CN","User","mcp.json");return i.existsSync(s)?s:o}else{let o=n.join(t,".config","Trae","User","mcp.json");if(i.existsSync(o))return o;let s=n.join(t,".config","Trae CN","User","mcp.json");return i.existsSync(s)?s:o}},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}},I=["mcpServers","servers","mcp"];function P(e){return Object.prototype.toString.call(e)==="[object Object]"}function O(e,t=!1){if(!e)return"";if(!t)try{return JSON.parse(e),e}catch{}let r=e.length,o=[],s=!1,a=!1,c=!1,g=!1,h=-1;for(let f=0;f<r;f++){let p=e[f],d=f+1<r?e[f+1]:"";if(c){(p===`
-`||p==="\r")&&(c=!1,o.push(p));continue}if(g){p==="*"&&d==="/"&&(g=!1,f++);continue}if(s){o.push(p),a?a=!1:p==="\\"?a=!0:p==='"'&&(s=!1);continue}if(p==='"'){s=!0,a=!1,h=-1,o.push(p);continue}if(p==="/"&&d==="/"){c=!0,f++;continue}if(p==="/"&&d==="*"){g=!0,f++;continue}if(p===","){h=o.length,o.push(p);continue}if(p==="}"||p==="]"){h!==-1&&(o[h]=" ",h=-1),o.push(p);continue}p!==" "&&p!=="	"&&p!==`
-`&&p!=="\r"&&(h=-1),o.push(p)}return o.join("")}var D=/\s/;function G(e){for(let t=1;t<e.length;t++){if(e[t]!=="#"||!D.test(e[t-1]))continue;let r=t-1;for(;r>0&&D.test(e[r-1]);)r--;return e.slice(r)}return""}function T(e,t,r,o=!1){let s=e?e.split(/\r?\n/):[],a=s.map((u,w)=>{let C=u.match(/^(\s*)mcp_servers:/);return C?{index:w,indent:C[1],tail:u.slice(C[0].length).trim()}:null}).filter(u=>u!==null);if(a.length>1)throw new Error("Cannot safely update YAML with duplicate mcp_servers keys");if(a.length===1){let u=a[0];if(u.indent!==""||u.tail!==""&&!u.tail.startsWith("#"))throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping")}let c="  ";if(a.length===1)for(let u=a[0].index+1;u<s.length;u++){if(s[u].trim()===""||s[u].trimStart().startsWith("#"))continue;if(/^[^\s]/.test(s[u]))break;let w=s[u].match(/^(\s+)\S/);w&&(c=w[1]);break}if(o){let u=[],w=!1,C=0,y=!1,S=0;for(let j=0;j<s.length;j++){let l=s[j],m=l.match(/^(\s*)mcp_servers:\s*(?:#.*)?$/);if(m){w=!0,C=m[1].length,u.push(l);continue}if(w){let v=l.match(/^(\s*)/)?.[1].length||0;if(l.trimStart().startsWith("#")){u.push(l);continue}if(l.trim()!==""&&v<=C)w=!1,y=!1;else{let k=l.match(/^(\s*)superpowers:\s*(?:#.*)?$/);if(k&&k[1]===c){y=!0,S=k[1].length;continue}if(y){if(v>S||l.trim()==="")continue;y=!1}}}u.push(l)}return u.join(`
-`)}let g=JSON.stringify(t),h=JSON.stringify(r),f=[`${c}superpowers:`,`${c}${c}command: ${g}`,`${c}${c}args: ${h}`];if(!e||e.trim()==="")return`mcp_servers:
-${f.join(`
+"use strict";var q=Object.create;var E=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var F=Object.getPrototypeOf,V=Object.prototype.hasOwnProperty;var z=(e,t)=>{for(var r in t)E(e,r,{get:t[r],enumerable:!0})},W=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of K(t))!V.call(e,s)&&s!==r&&E(e,s,{get:()=>t[s],enumerable:!(o=H(t,s))||o.enumerable});return e};var _=(e,t,r)=>(r=e!=null?q(F(e)):{},W(t||!e||!e.__esModule?E(r,"default",{value:e,enumerable:!0}):r,e)),G=e=>W(E({},"__esModule",{value:!0}),e);var X={};z(X,{HARNESS_CONFIGS:()=>b,JSON_SERVER_ROOT_KEYS:()=>I,isPlainObject:()=>P,runSetup:()=>L,runSetupCli:()=>R,safeWriteConfig:()=>J,stripJsonComments:()=>N,updateJsonConfig:()=>U,updateYamlConfig:()=>T});module.exports=G(X);var a=_(require("fs")),n=_(require("path")),k=_(require("os")),O=_(require("crypto")),b={lmstudio:{name:"LM Studio",aliases:["lmstudio","lm-studio"],getConfigPath:(e,t)=>n.join(t,".lmstudio","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},roo:{name:"Roo Code (VS Code Desktop)",aliases:["roo","roo-code","roocode"],getConfigPath:(e,t,r)=>{let o=e==="win32"?r||n.join(t,"AppData","Roaming"):e==="darwin"?n.join(t,"Library","Application Support"):n.join(t,".config");return n.join(o,"Code","User","globalStorage","rooveterinaryinc.roo-cline","settings","mcp_settings.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code","User","mcp.json"):n.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(e,t,r,o)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):e==="darwin"?n.join(t,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(t,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>n.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,o)=>{if(e==="win32"){let s=o||n.join(t,"AppData","Local");return n.join(s,"hermes","config.yaml")}return n.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>n.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?n.join(r||n.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?n.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t,r)=>{let o=e==="win32"&&r?r:n.join(t,".config"),s=n.join(o,"devin","mcp_config.json");return a.existsSync(s)?s:n.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>n.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let c=n.join(r||n.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(a.existsSync(c))return c;let i=n.join(t,".pi","agent","mcp.json");if(a.existsSync(i))return i;let p=n.join(t,".pi","mcp.json");return a.existsSync(p)?p:i}let o=n.join(t,".pi","agent","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,".pi","mcp.json");return a.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(e,t)=>{let r=n.join(t,".qwenpaw","config.json");if(a.existsSync(r))return r;let o=n.join(t,".copaw","config.json");return a.existsSync(o)?o:r},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(e,t,r)=>{let o="";if(e==="win32"?o=n.join(r||n.join(t,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):e==="darwin"?o=n.join(t,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):o=n.join(t,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),a.existsSync(o))return o;let s=n.join(t,".cline","data","settings","cline_mcp_settings.json");return a.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(e,t)=>{let r=n.join(t,".config","kilo","kilo.jsonc");if(a.existsSync(r))return r;let o=n.join(t,".config","kilo","kilo.json");return a.existsSync(o)?o:r},type:"json-mcp",defaultConfig:(e,t)=>({type:"local",command:[e,...t],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(e,t)=>n.join(t,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(e,t)=>n.join(t,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(e,t,r)=>{if(e==="win32"){let o=n.join(r||n.join(t,"AppData","Roaming"),"Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(r||n.join(t,"AppData","Roaming"),"Trae CN","User","mcp.json");return a.existsSync(s)?s:o}else if(e==="darwin"){let o=n.join(t,"Library","Application Support","Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,"Library","Application Support","Trae CN","User","mcp.json");return a.existsSync(s)?s:o}else{let o=n.join(t,".config","Trae","User","mcp.json");if(a.existsSync(o))return o;let s=n.join(t,".config","Trae CN","User","mcp.json");return a.existsSync(s)?s:o}},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}},I=["mcpServers","servers","mcp"];function P(e){return Object.prototype.toString.call(e)==="[object Object]"}function N(e,t=!1){if(!e)return"";if(!t)try{return JSON.parse(e),e}catch{}let r=e.length,o=[],s=!1,c=!1,i=!1,p=!1,S=-1;for(let m=0;m<r;m++){let g=e[m],C=m+1<r?e[m+1]:"";if(i){(g===`
+`||g==="\r")&&(i=!1,o.push(g));continue}if(p){g==="*"&&C==="/"&&(p=!1,m++);continue}if(s){o.push(g),c?c=!1:g==="\\"?c=!0:g==='"'&&(s=!1);continue}if(g==='"'){s=!0,c=!1,S=-1,o.push(g);continue}if(g==="/"&&C==="/"){i=!0,m++;continue}if(g==="/"&&C==="*"){p=!0,m++;continue}if(g===","){S=o.length,o.push(g);continue}if(g==="}"||g==="]"){S!==-1&&(o[S]=" ",S=-1),o.push(g);continue}g!==" "&&g!=="	"&&g!==`
+`&&g!=="\r"&&(S=-1),o.push(g)}return o.join("")}var D=/\s/;function Y(e){for(let t=1;t<e.length;t++){if(e[t]!=="#"||!D.test(e[t-1]))continue;let r=t-1;for(;r>0&&D.test(e[r-1]);)r--;return e.slice(r)}return""}function T(e,t,r,o=!1){let s=e?e.split(/\r?\n/):[],c=s.map((l,d)=>{let y=l.match(/^(\s*)mcp_servers:/);return y?{index:d,indent:y[1],tail:l.slice(y[0].length).trim()}:null}).filter(l=>l!==null),i=c.filter(l=>l.indent==="");if(i.length>1)throw new Error("Cannot safely update YAML with duplicate mcp_servers keys");if(i.length===1){let l=i[0];if(l.tail!==""&&!l.tail.startsWith("#"))throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping")}else if(c.length>0)throw new Error("Cannot safely update YAML unless mcp_servers is a root-level block mapping");let p="  ";if(i.length===1)for(let l=i[0].index+1;l<s.length;l++){if(s[l].trim()===""||s[l].trimStart().startsWith("#"))continue;if(/^[^\s]/.test(s[l]))break;let d=s[l].match(/^(\s+)\S/);d&&(p=d[1]);break}if(o){let l=[],d=!1,y=0,j=!1,w=0;for(let f=0;f<s.length;f++){let u=s[f],v=u.match(/^(\s*)mcp_servers:\s*(?:#.*)?$/);if(v){d=!0,y=v[1].length,l.push(u);continue}if(d){let x=u.match(/^(\s*)/)?.[1].length||0;if(u.trimStart().startsWith("#")){l.push(u);continue}if(u.trim()!==""&&x<=y)d=!1,j=!1;else{let A=u.match(/^(\s*)superpowers:\s*(?:#.*)?$/);if(A&&A[1]===p){j=!0,w=A[1].length;continue}if(j){if(x>w||u.trim()==="")continue;j=!1}}}l.push(u)}return l.join(`
+`)}let S=JSON.stringify(t),m=JSON.stringify(r),g=[`${p}superpowers:`,`${p}${p}command: ${S}`,`${p}${p}args: ${m}`];if(!e||e.trim()==="")return`mcp_servers:
+${g.join(`
 `)}
-`;let p=a.length===1?a[0].index:-1;if(p===-1)return`${e.trimEnd()}
+`;let C=i.length===1?i[0].index:-1;if(C===-1)return`${e.trimEnd()}
 
 mcp_servers:
-${f.join(`
+${g.join(`
 `)}
-`;let d=-1;for(let u=p+1;u<s.length;u++){let w=s[u];if(/^[^\s#]/.test(w))break;if((w.match(/^(\s*)/)?.[1]||"")===c&&/^\s+["']?superpowers["']?\s*:\s*(?:#.*)?$/.test(w)){d=u;break}}if(d!==-1){let u=s[d].match(/^(\s*)/)?.[1].length||2,w=d+1;for(;w<s.length;){let S=s[w];if((S.match(/^(\s*)/)?.[1].length||0)>u||S.trim()==="")w++;else break}let C=[],y=-1;for(let S=d+1;S<w;S++){let j=s[S];if(j.trim()==="")continue;let l=j.match(/^(\s*)/)?.[1].length??0;if(!(y!==-1&&l>y)){if(y=-1,l>u&&/^\s*["']?(?:command|args)["']?\s*:/.test(j)){y=l;continue}C.push(j)}}return f[0]+=G(s[d]),s.splice(d,w-d,...f,...C),s.join(`
-`)}else return s.splice(p+1,0,...f),s.join(`
-`)}function N(e,t,r,o,s=!1,a){let c={};if(e&&e.trim()!=="")try{let p=JSON.parse(e);if(!P(p))throw new Error("Existing JSON root must be an object");c=p}catch{try{let d=O(e,!0),u=JSON.parse(d);if(!P(u))throw new Error("Existing JSON root must be an object");c=u}catch(d){let u=d instanceof Error?d.message:String(d);throw new Error(`Failed to parse existing JSON: ${u}`)}}let g=t==="json-servers"?"servers":t==="json-mcp"?"mcp":"mcpServers",h=I.find(p=>P(c[p])&&c[p].superpowers!==void 0)??g;if(c[h]!==void 0&&!P(c[h]))throw new Error(`Existing JSON field "${h}" must be an object`);c[h]===void 0&&(c[h]={});let f=c[h];if(s)delete f.superpowers;else{let p;a?p={...a}:t==="json-servers"?p={command:r,args:o,type:"stdio"}:t==="json-mcp"?p={type:"local",command:[r,...o],enabled:!0}:p={command:r,args:o};let d=f.superpowers;if(!P(d))f.superpowers=p;else{let u={...d,...p};(d.enabled!==void 0||d.disabled!==void 0)&&(d.enabled!==void 0?u.enabled=d.enabled:delete u.enabled),t==="json-mcp"&&Array.isArray(u.command)&&delete u.args,f.superpowers=u}}return JSON.stringify(c,null,2)+`
-`}function U(e,t,r=!1,o=[],s){if(o.length===0)throw new Error("safeWriteConfig requires at least one allowed destination root");let a=e;try{let l=i.lstatSync(e,{throwIfNoEntry:!1});if(l&&l.isSymbolicLink()){try{a=i.realpathSync(e)}catch{let q=i.readlinkSync(e);a=n.resolve(n.dirname(e),q)}let m=n.normalize(n.resolve(a)).toLowerCase(),v=n.normalize(n.resolve(x.tmpdir())).toLowerCase();if(!(m===v||m.startsWith(v+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(_=>m===_||m.startsWith(_+n.sep))||m==="/var"||m.startsWith("/var"+n.sep)&&!m.startsWith("/var/folders"+n.sep)||m==="/private/var"||m.startsWith("/private/var"+n.sep)&&!m.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${a}`)}}catch(l){if(l instanceof Error&&l.message.includes("Refusing to write to unsafe symlink target"))throw l}let c=n.dirname(a);i.existsSync(c)||i.mkdirSync(c,{recursive:!0,mode:448});let g=i.realpathSync(c),h=i.statSync(g);a=n.join(g,n.basename(a));let f=n.normalize(n.resolve(a)).toLowerCase(),p=n.normalize(n.resolve(x.tmpdir())).toLowerCase(),d=f===p||f.startsWith(p+n.sep),w=["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(l=>f===l||f.startsWith(l+n.sep))||f==="/var"||f.startsWith("/var"+n.sep)&&!f.startsWith("/var/folders"+n.sep)||f==="/private/var"||f.startsWith("/private/var"+n.sep)&&!f.startsWith("/private/var/folders"+n.sep);if(!d&&w)throw new Error(`Refusing to write to unsafe configuration target: ${a}`);if(!o.some(l=>{if(!l)return!1;let m=n.resolve(l);try{m=i.realpathSync(m)}catch{}let v=n.relative(m,a);return v!==".."&&!v.startsWith(`..${n.sep}`)&&!n.isAbsolute(v)}))throw new Error(`Refusing to write configuration outside allowed roots: ${a}`);let y=384;if(i.existsSync(a)){try{y=i.statSync(a).mode}catch{}if(r){let l=i.readFileSync(a,"utf8"),m=`${a}.${Date.now()}.bak`;try{i.writeFileSync(m,l,{encoding:"utf8",mode:y})}catch(v){let k=v instanceof Error?v.message:String(v);throw new Error(`Failed to create safe backup before write: ${k}`)}}}let S=W.randomBytes(8).toString("hex"),j=n.join(g,`.tmp.${n.basename(a)}.${process.pid}.${S}`);try{i.writeFileSync(j,t,{encoding:"utf8",mode:y,flag:"wx"});let l=i.existsSync(a);if(s===null&&l)throw new Error("Configuration changed concurrently before it could be created");if(s!=null&&(!l||i.readFileSync(a,"utf8")!==s))throw new Error("Configuration changed concurrently; refusing to overwrite newer content");let m=i.realpathSync(c),v=i.statSync(m);if(m!==g||v.dev!==h.dev||v.ino!==h.ino)throw new Error("Configuration directory changed while writing");i.renameSync(j,a)}catch(l){try{i.existsSync(j)&&i.unlinkSync(j)}catch{}throw l}}async function L(e={}){let t=e.platform||x.platform(),r=e.homeDir||x.homedir(),o=e.appData||process.env.APPDATA,s=e.localAppData||process.env.LOCALAPPDATA,a=!!e.dryRun,c=!!e.remove,g=!!e.bun,h=e.target?e.target.toLowerCase():null,f=g?"bunx":"npx",p=["-y","superpowers-mcp"],d=[];if(!h)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(b).join("|")}>.`);let u=Object.keys(b).find(C=>C===h||b[C].aliases.includes(h));if(!u)throw new Error(`Unknown harness target: "${h}". Supported targets: ${Object.keys(b).join(", ")}`);let w=[u];for(let C of w){let y=b[C],S=y.getConfigPath(t,r,o,s),j=i.existsSync(S);if(c&&!j){d.push({target:C,name:y.name,path:S,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let l="";j&&(l=i.readFileSync(S,"utf8"));let m="";if(y.type==="yaml")m=T(l,f,p,c);else{let v=typeof y.defaultConfig=="function"?y.defaultConfig(f,p):void 0;m=N(l,y.type,f,p,c,v)}if(l.trim()===m.trim()&&j){d.push({target:C,name:y.name,path:S,status:"up-to-date",message:c?"Already not configured":"Already configured and up-to-date"});continue}a||U(S,m,!!e.backup,[r,o||"",s||""],j?l:null),d.push({target:C,name:y.name,path:S,status:c?"removed":j?"updated":"created",message:a?`[Dry Run] Would ${c?"remove from":j?"update":"create"} ${S}`:`Successfully ${c?"removed from":j?"updated":"configured"}!`})}catch(l){let m=l instanceof Error?l.message:String(l);d.push({target:C,name:y.name,path:S,status:"error",message:m})}}return d}async function R(e=process.argv.slice(2)){let t=!1,r={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<e.length;o++){let s=e[o];if(!(s==="setup"||s==="install"||s==="--setup"))if(s==="--print-config")t=!0;else if(s==="--dry-run")r.dryRun=!0;else if(s==="--remove"||s==="--uninstall")r.remove=!0;else if(s==="--bun")r.bun=!0;else if(s==="--backup")r.backup=!0;else if(s==="--target"||s==="-t"){let a=e[o+1];if(!a||a.startsWith("-")){console.error(`\u274C Error: Missing value for --target flag.
-`),process.exitCode=1;return}r.target=e[++o]}else if(s.startsWith("--target=")){let a=s.split("=")[1];if(!a){console.error(`\u274C Error: Missing value for --target flag.
-`),process.exitCode=1;return}r.target=a}else if(s==="--help"||s==="-h"){Y();return}else if(s.startsWith("-")){console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
+`;let h=-1;for(let l=C+1;l<s.length;l++){let d=s[l];if(/^[^\s#]/.test(d))break;if((d.match(/^(\s*)/)?.[1]||"")===p&&/^\s+["']?superpowers["']?\s*:\s*(?:#.*)?$/.test(d)){h=l;break}}if(h!==-1){let l=s[h].match(/^(\s*)/)?.[1].length||2,d=h+1;for(;d<s.length;){let w=s[d];if((w.match(/^(\s*)/)?.[1].length||0)>l||w.trim()==="")d++;else break}let y=[],j=-1;for(let w=h+1;w<d;w++){let f=s[w];if(f.trim()==="")continue;let u=f.match(/^(\s*)/)?.[1].length??0;if(!(j!==-1&&u>j)){if(j=-1,u>l&&/^\s*["']?(?:command|args)["']?\s*:/.test(f)){j=u;continue}y.push(f)}}return g[0]+=Y(s[h]),s.splice(h,d-h,...g,...y),s.join(`
+`)}else return s.splice(C+1,0,...g),s.join(`
+`)}function U(e,t,r,o,s=!1,c){let i={},p=!1;if(e&&e.trim()!=="")try{let h=JSON.parse(e);if(!P(h))throw new Error("Existing JSON root must be an object");i=h}catch(h){try{let l=N(e,!0),d=JSON.parse(l);if(!P(d))throw new Error("Existing JSON root must be an object");i=d,p=l!==e}catch(l){let d=l instanceof Error?l.message:String(l),y=h instanceof Error?h.message:String(h);throw new Error(`Failed to parse existing JSON: ${d} (raw JSON error: ${y})`)}}let S=t==="json-servers"?"servers":t==="json-mcp"?"mcp":"mcpServers",m=I.find(h=>P(i[h])&&i[h].superpowers!==void 0)??S;if(i[m]!==void 0&&!P(i[m]))throw new Error(`Existing JSON field "${m}" must be an object`);i[m]===void 0&&(i[m]={});let g=i[m];if(s)delete g.superpowers;else{let h;c?h={...c}:t==="json-servers"?h={command:r,args:o,type:"stdio"}:t==="json-mcp"?h={type:"local",command:[r,...o],enabled:!0}:h={command:r,args:o};let l=g.superpowers;if(!P(l))g.superpowers=h;else{let d={...l,...h};(l.enabled!==void 0||l.disabled!==void 0)&&(l.enabled!==void 0?d.enabled=l.enabled:delete d.enabled),t==="json-mcp"&&Array.isArray(d.command)&&delete d.args,g.superpowers=d}}let C=JSON.stringify(i,null,2)+`
+`;return p&&C!==e&&process.stderr.write(`[superpowers-mcp] Warning: JSONC comments/trailing commas in the existing config were removed while updating it (the file is rewritten as plain JSON).
+`),C}function Q(e,t=10){try{let r=n.dirname(e),o=`${n.basename(e)}.`,s=".bak",c=a.readdirSync(r).filter(i=>{if(!i.startsWith(o)||!i.endsWith(s))return!1;let p=i.slice(o.length,i.length-s.length);return/^\d+$/.test(p)}).map(i=>{let p=n.join(r,i);try{return{full:p,mtimeMs:a.statSync(p).mtimeMs}}catch{return{full:p,mtimeMs:0}}}).sort((i,p)=>p.mtimeMs-i.mtimeMs);for(let i of c.slice(t))try{a.unlinkSync(i.full)}catch{}}catch{}}function J(e,t,r=!1,o=[],s){if(o.length===0)throw new Error("safeWriteConfig requires at least one allowed destination root");let c=e;try{let f=a.lstatSync(e,{throwIfNoEntry:!1});if(f&&f.isSymbolicLink()){try{c=a.realpathSync(e)}catch{let M=a.readlinkSync(e);c=n.resolve(n.dirname(e),M)}let u=n.normalize(n.resolve(c)).toLowerCase(),v=n.normalize(n.resolve(k.tmpdir())).toLowerCase();if(!(u===v||u.startsWith(v+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some($=>u===$||u.startsWith($+n.sep))||u==="/var"||u.startsWith("/var"+n.sep)&&!u.startsWith("/var/folders"+n.sep)||u==="/private/var"||u.startsWith("/private/var"+n.sep)&&!u.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${c}`)}}catch(f){if(f instanceof Error&&f.message.includes("Refusing to write to unsafe symlink target"))throw f}let i=n.dirname(c);a.existsSync(i)||a.mkdirSync(i,{recursive:!0,mode:448});let p=a.realpathSync(i),S=a.statSync(p);c=n.join(p,n.basename(c));let m=n.normalize(n.resolve(c)).toLowerCase(),g=n.normalize(n.resolve(k.tmpdir())).toLowerCase(),C=m===g||m.startsWith(g+n.sep),l=["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(f=>m===f||m.startsWith(f+n.sep))||m==="/var"||m.startsWith("/var"+n.sep)&&!m.startsWith("/var/folders"+n.sep)||m==="/private/var"||m.startsWith("/private/var"+n.sep)&&!m.startsWith("/private/var/folders"+n.sep);if(!C&&l)throw new Error(`Refusing to write to unsafe configuration target: ${c}`);if(!o.some(f=>{if(!f)return!1;let u=n.resolve(f);try{u=a.realpathSync(u)}catch{}let v=n.relative(u,c);return v!==".."&&!v.startsWith(`..${n.sep}`)&&!n.isAbsolute(v)}))throw new Error(`Refusing to write configuration outside allowed roots: ${c}`);let y=384;if(a.existsSync(c)){try{y=a.statSync(c).mode}catch{}if(r){let f=a.readFileSync(c,"utf8"),u=`${c}.${Date.now()}.bak`;try{a.writeFileSync(u,f,{encoding:"utf8",mode:y})}catch(v){let x=v instanceof Error?v.message:String(v);throw new Error(`Failed to create safe backup before write: ${x}`)}Q(c)}}let j=O.randomBytes(8).toString("hex"),w=n.join(p,`.tmp.${n.basename(c)}.${process.pid}.${j}`);try{a.writeFileSync(w,t,{encoding:"utf8",mode:y,flag:"wx"});let f=a.existsSync(c);if(s===null&&f)throw new Error("Configuration changed concurrently before it could be created");if(s!=null&&(!f||a.readFileSync(c,"utf8")!==s))throw new Error("Configuration changed concurrently; refusing to overwrite newer content");let u=a.realpathSync(i),v=a.statSync(u);if(u!==p||v.dev!==S.dev||v.ino!==S.ino)throw new Error("Configuration directory changed while writing");a.renameSync(w,c)}catch(f){try{a.existsSync(w)&&a.unlinkSync(w)}catch{}throw f}}async function L(e={}){let t=e.platform||k.platform(),r=e.homeDir||k.homedir(),o=e.appData||process.env.APPDATA,s=e.localAppData||process.env.LOCALAPPDATA,c=!!e.dryRun,i=!!e.remove,p=!!e.bun,S=e.target?e.target.toLowerCase():null,m=p?"bunx":"npx",g=["-y","superpowers-mcp"],C=[];if(!S)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(b).join("|")}>.`);let h=Object.keys(b).find(d=>d===S||b[d].aliases.includes(S));if(!h)throw new Error(`Unknown harness target: "${S}". Supported targets: ${Object.keys(b).join(", ")}`);let l=[h];for(let d of l){let y=b[d],j=y.getConfigPath(t,r,o,s),w=a.existsSync(j);if(i&&!w){C.push({target:d,name:y.name,path:j,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let f="";w&&(f=a.readFileSync(j,"utf8"));let u="";if(y.type==="yaml")u=T(f,m,g,i);else{let v=typeof y.defaultConfig=="function"?y.defaultConfig(m,g):void 0;u=U(f,y.type,m,g,i,v)}if(f.trim()===u.trim()&&w){C.push({target:d,name:y.name,path:j,status:"up-to-date",message:i?"Already not configured":"Already configured and up-to-date"});continue}c||J(j,u,!!e.backup,[r,o||"",s||""],w?f:null),C.push({target:d,name:y.name,path:j,status:i?"removed":w?"updated":"created",message:c?`[Dry Run] Would ${i?"remove from":w?"update":"create"} ${j}`:`Successfully ${i?"removed from":w?"updated":"configured"}!`})}catch(f){let u=f instanceof Error?f.message:String(f);C.push({target:d,name:y.name,path:j,status:"error",message:u})}}return C}async function R(e=process.argv.slice(2)){let t=!1,r={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<e.length;o++){let s=e[o];if(!(s==="setup"||s==="install"||s==="--setup"))if(s==="--print-config")t=!0;else if(s==="--dry-run")r.dryRun=!0;else if(s==="--remove"||s==="--uninstall")r.remove=!0;else if(s==="--bun")r.bun=!0;else if(s==="--backup")r.backup=!0;else if(s==="--target"||s==="-t"){let c=e[o+1];if(!c||c.startsWith("-")){console.error(`\u274C Error: Missing value for --target flag.
+`),process.exitCode=1;return}r.target=e[++o]}else if(s.startsWith("--target=")){let c=s.split("=")[1];if(!c){console.error(`\u274C Error: Missing value for --target flag.
+`),process.exitCode=1;return}r.target=c}else if(s==="--help"||s==="-h"){B();return}else if(s.startsWith("-")){console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
 `),process.exitCode=1;return}else if(!r.target)r.target=s;else{console.error(`\u274C Error: Unexpected argument "${s}". Use --help for usage.
 `),process.exitCode=1;return}}if(t){if(r.target||r.remove||r.backup||r.dryRun){console.error("--print-config supports only --bun; omit target and file-operation flags."),process.exitCode=1;return}console.log(JSON.stringify({mcpServers:{superpowers:{command:r.bun?"bunx":"npx",args:["-y","superpowers-mcp"]}}},null,2));return}if(console.log(`
 ========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
@@ -23,9 +24,9 @@ ${f.join(`
 `),console.log("  npx -y superpowers-mcp setup --target lmstudio   # LM Studio (~/.lmstudio/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target roo        # Roo Code in VS Code Desktop"),console.log("  npx -y superpowers-mcp setup --print-config      # JSON for desktop app import"),console.log("  npx -y superpowers-mcp setup --target antigravity # Antigravity (~/.gemini/config/mcp_config.json)"),console.log("  npx -y superpowers-mcp setup --target pi-desktop  # Pi Desktop / Pi Agent (~/.pi/agent/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target cursor     # Cursor (~/.cursor/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot    # GitHub Copilot (VS Code mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot-insiders # GitHub Copilot (VS Code Insiders mcp.json)"),console.log("  npx -y superpowers-mcp setup --target hermes     # Hermes Desktop / Agent"),console.log("  npx -y superpowers-mcp setup --target kimi       # Kimi Work / Kimi Code"),console.log("  npx -y superpowers-mcp setup --target claude     # Claude Desktop"),console.log("  npx -y superpowers-mcp setup --target devin      # Devin Desktop (formerly Windsurf)"),console.log("  npx -y superpowers-mcp setup --target qwenpaw    # QwenPaw / CoPaw (~/.qwenpaw/config.json)"),console.log("  npx -y superpowers-mcp setup --target cline      # Cline (~/.../cline_mcp_settings.json)"),console.log("  npx -y superpowers-mcp setup --target kilo       # Kilo Code (~/.config/kilo/kilo.jsonc)"),console.log("  npx -y superpowers-mcp setup --target qoder      # Qoder (~/.qoder/settings.json)"),console.log("  npx -y superpowers-mcp setup --target kiro       # Kiro (~/.kiro/settings/mcp.json)"),console.log(`  npx -y superpowers-mcp setup --target trae       # Trae (~/.../Trae/User/mcp.json)
 `),console.log("\u{1F4A1} Tip:"),console.log("   You can run this setup command from ANY folder on your system."),console.log(`   It automatically targets your global config files (~/...) without needing to clone this repo.
 `),console.log("\u{1F4A1} Privacy & Safety:"),console.log("   Superpowers MCP only configures the specific client you explicitly choose."),console.log(`   It will NEVER silently scan or modify unselected environments.
-`),process.exitCode=1;return}try{let o=await L(r),s=0,a=0,c=0;for(let g of o){let h=g.status==="created"||g.status==="updated"||g.status==="removed"?"\u2705":g.status==="up-to-date"?"\u2728":g.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${h} [${g.name}] (${g.status})`),console.log(`   Path: ${g.path}`),console.log(`   Info: ${g.message}
-`),g.status==="created"||g.status==="updated"||g.status==="up-to-date"||g.status==="removed"?s++:g.status==="skipped"?a++:g.status==="error"&&c++}if(console.log("--------------------------------------------------------"),c>0){console.error(`\u26A0\uFE0F Setup finished with errors: ${c} failure(s), ${s} succeeded.`),process.exitCode=1;return}console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
-`),process.exitCode=1}}function Y(){console.log(`
+`),process.exitCode=1;return}try{let o=await L(r),s=0,c=0,i=0;for(let p of o){let S=p.status==="created"||p.status==="updated"||p.status==="removed"?"\u2705":p.status==="up-to-date"?"\u2728":p.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${S} [${p.name}] (${p.status})`),console.log(`   Path: ${p.path}`),console.log(`   Info: ${p.message}
+`),p.status==="created"||p.status==="updated"||p.status==="up-to-date"||p.status==="removed"?s++:p.status==="skipped"?c++:p.status==="error"&&i++}if(console.log("--------------------------------------------------------"),i>0){console.error(`\u26A0\uFE0F Setup finished with errors: ${i} failure(s), ${s} succeeded.`),process.exitCode=1;return}console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
+`),process.exitCode=1}}function B(){console.log(`
 Superpowers MCP - Targeted Global Setup
 
 Usage:

package/package.json

@@ -2,7 +2,7 @@
   "name": "superpowers-mcp",
   "displayName": "Superpowers MCP",
   "description": "Superpowers skills library (TDD, debugging, collaboration workflows) as an MCP server for VSCode and Antigravity",
-  "version": "6.3.10",
+  "version": "6.4.2",
   "engines": {
     "node": ">=18"
   },
@@ -47,7 +47,7 @@
     "build": "node esbuild.js --production",
     "watch": "node esbuild.js --watch",
     "pretest": "npm run build",
-    "test": "node tests/edge_cases_test.js && node tests/run_test.js && node tests/brainstorm_server_test.js && node tests/prompts_compositions_test.js && node tests/upstream_sync_test.js && node tests/mcp_coverage_test.js && node tests/drift_test.js && node tests/setup_test.js",
+    "test": "node tests/edge_cases_test.js && node tests/run_test.js && node tests/brainstorm_server_test.js && node tests/prompts_compositions_test.js && node tests/upstream_sync_test.js && node tests/mcp_coverage_test.js && node tests/drift_test.js && node tests/setup_test.js && bash tests/executing-plans/test-task-start.sh && bash tests/executing-plans/test-task-done.sh",
     "drift": "node scripts/upstream-drift.js --fetch",
     "drift:record": "node scripts/upstream-drift.js --record",
     "prepublishOnly": "npm run build"

package/scripts/copy-skills.js

@@ -2,6 +2,10 @@
 /**
  * Copy skills from the parent superpowers repository into the extension's
  * own skills/ directory so they are included in the .vsix package.
+ *
+ * Copies are incremental (unchanged files are skipped) and a manifest records
+ * what this script copied so that skills removed/renamed upstream are cleaned up
+ * without ever deleting fork-specific skills the manifest does not know about.
  */
 
 const fs = require("fs");
@@ -9,40 +13,111 @@ const path = require("path");
 
 const src = path.join(__dirname, "..", "..", "target-learn", "skills");
 const dest = path.join(__dirname, "..", "skills");
+const manifestPath = path.join(__dirname, ".copy-skills-manifest.json");
 
-function copyRecursive(from, to) {
-    try {
-        if (!fs.existsSync(from)) {
-            console.error(`Source not found: ${from}`);
-            process.exit(1);
-        }
+if (!fs.existsSync(src)) {
+    console.log(`Source not found, skipping copy: ${src}`);
+    process.exit(0);
+}
 
-        if (!fs.existsSync(to)) {
-            fs.mkdirSync(to, { recursive: true });
+function listFiles(root) {
+    const out = [];
+    const walk = (dir, rel) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        } catch {
+            return;
         }
-
-        const entries = fs.readdirSync(from, { withFileTypes: true });
         for (const entry of entries) {
-            const srcPath = path.join(from, entry.name);
-            const destPath = path.join(to, entry.name);
-
-            // 防禦性設計：過濾符號連結防止無限迴圈或任意讀寫
-            if (entry.isSymbolicLink()) {
-                console.warn(`Warning: Skipping symbolic link: ${srcPath}`);
-                continue;
-            }
-
+            const abs = path.join(dir, entry.name);
+            const childRel = rel ? `${rel}/${entry.name}` : entry.name;
             if (entry.isDirectory()) {
-                copyRecursive(srcPath, destPath);
+                walk(abs, childRel);
             } else if (entry.isFile()) {
-                fs.copyFileSync(srcPath, destPath);
+                out.push(childRel);
             }
         }
-    } catch (err) {
-        console.error(`Fatal error copying files from "${from}" to "${to}":`, err);
-        process.exit(1);
+    };
+    walk(root, "");
+    return out.sort();
+}
+
+function sameFile(a, b) {
+    try {
+        const sa = fs.statSync(a);
+        const sb = fs.statSync(b);
+        return sa.size === sb.size && Math.floor(sa.mtimeMs) === Math.floor(sb.mtimeMs);
+    } catch {
+        return false;
+    }
+}
+
+function loadManifest() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+        return Array.isArray(parsed.files) ? parsed.files : [];
+    } catch {
+        return [];
     }
 }
 
-copyRecursive(src, dest);
-console.log(`Skills copied from ${src} to ${dest}`);
+const srcFiles = listFiles(src);
+const previousCopied = loadManifest();
+const currentlyCopied = new Set();
+
+fs.mkdirSync(dest, { recursive: true });
+
+let copied = 0;
+let skipped = 0;
+for (const rel of srcFiles) {
+    const from = path.join(src, rel);
+    const to = path.join(dest, rel);
+    currentlyCopied.add(rel);
+    if (fs.existsSync(to) && sameFile(from, to)) {
+        skipped++;
+        continue; // unchanged — avoid needless disk writes and mtime churn
+    }
+    fs.mkdirSync(path.dirname(to), { recursive: true });
+    fs.copyFileSync(from, to);
+    copied++;
+}
+
+// Remove only files THIS script copied previously that no longer exist upstream.
+// Fork-specific skills (never in the manifest) are left untouched.
+const currentSet = new Set(srcFiles);
+const stale = previousCopied.filter((rel) => !currentSet.has(rel));
+for (const rel of stale) {
+    const target = path.join(dest, rel);
+    try {
+        if (fs.existsSync(target)) {
+            fs.unlinkSync(target);
+        }
+    } catch {
+        // best-effort
+    }
+}
+
+// Prune directories that are now empty and were part of the previous copy set.
+const staleDirs = [...new Set(stale.map((rel) => path.posix.dirname(rel)))]
+    .filter((d) => d && d !== ".")
+    .sort((a, b) => b.split("/").length - a.split("/").length);
+for (const dir of staleDirs) {
+    const target = path.join(dest, dir);
+    try {
+        if (fs.existsSync(target) && fs.readdirSync(target).length === 0) {
+            fs.rmdirSync(target);
+        }
+    } catch {
+        // best-effort
+    }
+}
+
+try {
+    fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+    fs.writeFileSync(manifestPath, JSON.stringify({ files: [...currentlyCopied].sort() }, null, 2) + "\n", "utf-8");
+} catch {
+    // Manifest write is best-effort; a missing manifest just means no stale cleanup next run.
+}
+
+console.log(`✅ Copied ${copied} file(s), skipped ${skipped} unchanged, removed ${stale.length} stale file(s).`);

package/scripts/setup.js

@@ -7,16 +7,109 @@
 const path = require("path");
 const fs = require("fs");
 
-const compiledRunner = path.join(__dirname, "..", "out", "setup-runner.js");
+const repoRoot = path.join(__dirname, "..");
+const compiledRunner = path.join(repoRoot, "out", "setup-runner.js");
+const lockPath = path.join(repoRoot, "out", ".setup-build.lock");
 
-if (!fs.existsSync(compiledRunner)) {
-    const { execSync } = require("child_process");
+const inputFiles = [
+    path.join(repoRoot, "src", "setup-runner.ts"),
+    path.join(repoRoot, "src", "setup-cli.ts"),
+    path.join(repoRoot, "esbuild.js"),
+    path.join(repoRoot, "package.json"),
+];
+
+function sleepSync(ms) {
+    // Portable synchronous sleep; blocks this thread while waiting on the lock.
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+function newestInputMtime() {
+    let newest = 0;
+    for (const file of inputFiles) {
+        try {
+            newest = Math.max(newest, fs.statSync(file).mtimeMs);
+        } catch {
+            // Ignore missing inputs.
+        }
+    }
+    return newest;
+}
+
+// Rebuild when the output is missing OR any build input is newer, so edits to the
+// sources are never silently ignored (the old check only tested for existence).
+function needsBuild() {
+    if (!fs.existsSync(compiledRunner)) {
+        return true;
+    }
+    try {
+        return fs.statSync(compiledRunner).mtimeMs < newestInputMtime();
+    } catch {
+        return true;
+    }
+}
+
+function acquireLock() {
+    fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+    try {
+        fs.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
+        return true;
+    } catch (err) {
+        if (err && err.code === "EEXIST") {
+            return false; // another build holds the lock
+        }
+        // Unexpected lock error (e.g. permissions) — proceed without exclusion; the
+        // build itself will surface any real failure.
+        return true;
+    }
+}
+
+function releaseLock() {
     try {
-        execSync("node esbuild.js", { cwd: path.join(__dirname, ".."), stdio: "inherit" });
-    } catch (e) {
-        console.error("Failed to build out/setup-runner.js automatically:", e.message);
+        fs.unlinkSync(lockPath);
+    } catch {
+        // Ignore: we may not own it.
+    }
+}
+
+function lockIsStale() {
+    try {
+        return Date.now() - fs.statSync(lockPath).mtimeMs > 120000;
+    } catch {
+        return false; // already gone
+    }
+}
+
+if (needsBuild()) {
+    const { execSync } = require("child_process");
+
+    const deadline = Date.now() + 60000;
+    let owned = acquireLock();
+
+    // Wait for a concurrent build to finish (and release the lock) before building,
+    // so two invocations never run esbuild at once and interleave writes to out/*.
+    while (!owned && needsBuild() && Date.now() < deadline) {
+        if (lockIsStale()) {
+            releaseLock();
+            owned = acquireLock();
+            break;
+        }
+        sleepSync(250);
+    }
+
+    if (owned) {
+        try {
+            execSync("node esbuild.js", { cwd: repoRoot, stdio: "inherit" });
+        } catch (e) {
+            console.error("Failed to build out/setup-runner.js automatically:", e.message);
+            process.exit(1);
+        } finally {
+            releaseLock();
+        }
+    } else if (needsBuild()) {
+        console.error("Timed out waiting for a concurrent build of out/setup-runner.js.");
         process.exit(1);
     }
+    // If !owned but !needsBuild(), another process finished the build — reuse it.
 }
 
 const runner = require(compiledRunner);