@zibby/skills 0.2.1 → 0.2.3

package/dist/trackers/index.js

@@ -16,7 +16,7 @@ ${"#".repeat(i)} ${n.trim()}
 ${n}
 `):e.push(n)}return e.join("").replace(/\n{3,}/g,`
 
-`)}function T(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function H(r){return T(r).replace(/[a-z0-9]+/g,"")}function D(r,s){let e=T(r),t=T(s);if(!e||!t)return 0;if(e===t)return 1;if(e.length===1||t.length===1)return e===t?1:0;let n=l=>{let p=new Map;for(let m=0;m<l.length-1;m++){let g=l.slice(m,m+2);p.set(g,(p.get(g)||0)+1)}return p},i=n(e),o=n(t),a=0,c=0,u=0;for(let l of i.values())c+=l;for(let l of o.values())u+=l;for(let[l,p]of i.entries()){let m=o.get(l)||0;a+=Math.min(p,m)}return 2*a/Math.max(1,c+u)}function $(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function qe(r,s=[]){let e=Array.isArray(s)?s:[];if(e.length===0)return{requested:r||null,resolved:null,strategy:"none"};let t=e.filter(a=>!a.subtask),n=t.length>0?t:e,i=$(r);if(i){let a=n.find(l=>$(l.name)===i);if(a)return{requested:r,resolved:a,strategy:"exact"};let c={task:["task","\u4EFB\u52A1","\u4E8B\u9879","to do","todo"],story:["story","\u7528\u6237\u6545\u4E8B","\u9700\u6C42"],bug:["bug","\u7F3A\u9677","\u95EE\u9898"],improvement:["improvement","\u4F18\u5316","\u6539\u8FDB"],epic:["epic","\u53F2\u8BD7"]};for(let l of Object.values(c)){if(!l.some(m=>$(m)===i))continue;let p=n.find(m=>l.some(g=>$(g)===$(m.name)));if(p)return{requested:r,resolved:p,strategy:"alias"}}let u=n.map(l=>({t:l,score:D(r,l.name)})).sort((l,p)=>p.score-l.score);if(u[0]&&u[0].score>=.5)return{requested:r,resolved:u[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=n.find(u=>$(u.name)===a);if(c)return{requested:r||null,resolved:c,strategy:"default-preferred"}}return{requested:r||null,resolved:n[0],strategy:"default-first"}}async function ae(r){let s=`projectKeys=${encodeURIComponent(r)}&expand=projects.issuetypes`,e=await w(`/rest/api/3/issue/createmeta?${s}`),t=Array.isArray(e?.projects)?e.projects:[],i=t.find(a=>String(a?.key||"").toUpperCase()===String(r||"").toUpperCase())||t[0]||null;return(Array.isArray(i?.issuetypes)?i.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function ce(r,s){if(!r)throw new Error("projectKey is required");let e="sprint is not EMPTY";s==="active"?e="sprint in openSprints()":s==="closed"?e="sprint in closedSprints()":s==="future"&&(e="sprint in futureSprints()");let t=`project = ${r} AND ${e} ORDER BY updated DESC`,n=`jql=${encodeURIComponent(t)}&maxResults=100&fields=customfield_10020`,i=await w(`/rest/api/3/search/jql?${n}`),o=new Map;for(let a of i.issues||[])for(let c of a.fields?.customfield_10020||[])c&&!o.has(c.id)&&o.set(c.id,{id:c.id,name:c.name,state:c.state,boardId:c.boardId||null,startDate:c.startDate||null,endDate:c.endDate||null,goal:c.goal||null});return[...o.values()].sort((a,c)=>{let u={active:0,future:1,closed:2},l=(u[a.state]??3)-(u[c.state]??3);return l!==0?l:String(c.startDate||"").localeCompare(String(a.startDate||""))})}function Je(r,{sprintId:s,sprintName:e,target:t}={}){let n=Array.isArray(r)?r:[];if(!n.length)return{sprint:null,selectedBy:"none"};if(s!=null&&String(s).trim()!=="")return{sprint:n.find(a=>String(a.id)===String(s))||null,selectedBy:"id"};if(e&&String(e).trim()){let o=String(e).trim(),a=n.find(u=>String(u.name||"").toLowerCase()===o.toLowerCase());if(a)return{sprint:a,selectedBy:"name-exact"};let c=n.map(u=>({s:u,score:D(o,u.name||"")})).sort((u,l)=>l.score-u.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let i=String(t||"current").trim().toLowerCase();return i==="active"||i==="current"||i==="latest"?{sprint:n[0],selectedBy:i}:{sprint:n[0],selectedBy:"default"}}function xe(r,s){let e=r?.fields?.customfield_10020;return Array.isArray(e)?e.some(t=>String(t?.id)===String(s)):!1}async function Ue({issueKey:r,projectKey:s,sprintId:e,attempts:t=3,delayMs:n=450}){let i=[];for(let o=0;o<t;o++){try{let a=`project = ${s} AND key = ${r} AND sprint = ${e}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,u=await w(`/rest/api/3/search/jql?${c}`);if(Number(u?.total||0)>0)return i.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:i};let p=await w(`/rest/api/3/issue/${r}?fields=customfield_10020,status`),m=xe(p,e);if(i.push({attempt:o+1,jql:!1,issueField:m}),m)return{ok:!0,method:"issue_field",traces:i}}catch(a){i.push({attempt:o+1,error:String(a?.message||a)})}o<t-1&&await new Promise(a=>setTimeout(a,n))}return{ok:!1,method:"none",traces:i}}async function B({issueKey:r,projectKey:s,sprintId:e,sprintName:t,target:n}){if(!r)return{ok:!1,error:"issueKey is required"};let i=s;if(!i&&(i=(await w(`/rest/api/3/issue/${r}?fields=project`))?.fields?.project?.key||null,!i))return{ok:!1,error:`Could not resolve project for ${r}`};let o=await ce(i,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${i}`};let{sprint:a,selectedBy:c}=Je(o,{sprintId:e,sprintName:t,target:n});if(!a)return{ok:!1,error:`No matching sprint found in ${i}`,requested:{sprintId:e??null,sprintName:t??null,target:n??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await w(`/rest/api/3/issue/${r}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let u=await Ue({issueKey:r,projectKey:i,sprintId:a.id}),l=u.ok;return{ok:l,issueKey:r,projectKey:i,sprintId:a.id,sprintName:a.name,selectedBy:c,verifiedBy:u.method,verified:l,verificationTrace:u.traces,warning:l?null:`Sprint assignment attempted but verification did not find ${r} in sprint ${a.id}`}}async function w(r,s={}){let e=async()=>{let{token:t,cloudId:n}=await je("jira");if(typeof t!="string"||!t)throw new Error(`Invalid jira token type: ${typeof t}`);if(!n)throw new Error("Invalid jira cloudId: missing");let i=`https://api.atlassian.com/ex/jira/${n}${r}`,o=await fetch(i,{method:s.method||"GET",headers:{Authorization:`Bearer ${t}`,Accept:"application/json",...s.body?{"Content-Type":"application/json"}:{},...s.headers},body:s.body?JSON.stringify(s.body):void 0});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`Jira API ${o.status}: ${c.slice(0,300)}`)}let a=await o.text().catch(()=>"");if(!a||!a.trim())return{};try{return JSON.parse(a)}catch{return{raw:a}}};try{return await e()}catch(t){let n=String(t?.message||t||"").toLowerCase();if(!(n.includes("token")||n.includes("401")||n.includes("403")||n.includes("substring")))throw t;return Ee("jira"),e()}}var q={id:"jira",serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:E.JIRA,envKeys:["ATLASSIAN_ACCESS_TOKEN","ATLASSIAN_CLOUD_ID"],description:"Zibby Jira MCP Server (OAuth Bearer)",promptFragment:`## Jira (connected)
+`)}function T(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function H(r){return T(r).replace(/[a-z0-9]+/g,"")}function D(r,s){let e=T(r),t=T(s);if(!e||!t)return 0;if(e===t)return 1;if(e.length===1||t.length===1)return e===t?1:0;let n=l=>{let p=new Map;for(let m=0;m<l.length-1;m++){let g=l.slice(m,m+2);p.set(g,(p.get(g)||0)+1)}return p},i=n(e),o=n(t),a=0,c=0,u=0;for(let l of i.values())c+=l;for(let l of o.values())u+=l;for(let[l,p]of i.entries()){let m=o.get(l)||0;a+=Math.min(p,m)}return 2*a/Math.max(1,c+u)}function I(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function qe(r,s=[]){let e=Array.isArray(s)?s:[];if(e.length===0)return{requested:r||null,resolved:null,strategy:"none"};let t=e.filter(a=>!a.subtask),n=t.length>0?t:e,i=I(r);if(i){let a=n.find(l=>I(l.name)===i);if(a)return{requested:r,resolved:a,strategy:"exact"};let c={task:["task","\u4EFB\u52A1","\u4E8B\u9879","to do","todo"],story:["story","\u7528\u6237\u6545\u4E8B","\u9700\u6C42"],bug:["bug","\u7F3A\u9677","\u95EE\u9898"],improvement:["improvement","\u4F18\u5316","\u6539\u8FDB"],epic:["epic","\u53F2\u8BD7"]};for(let l of Object.values(c)){if(!l.some(m=>I(m)===i))continue;let p=n.find(m=>l.some(g=>I(g)===I(m.name)));if(p)return{requested:r,resolved:p,strategy:"alias"}}let u=n.map(l=>({t:l,score:D(r,l.name)})).sort((l,p)=>p.score-l.score);if(u[0]&&u[0].score>=.5)return{requested:r,resolved:u[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let a of o){let c=n.find(u=>I(u.name)===a);if(c)return{requested:r||null,resolved:c,strategy:"default-preferred"}}return{requested:r||null,resolved:n[0],strategy:"default-first"}}async function ae(r){let s=`projectKeys=${encodeURIComponent(r)}&expand=projects.issuetypes`,e=await w(`/rest/api/3/issue/createmeta?${s}`),t=Array.isArray(e?.projects)?e.projects:[],i=t.find(a=>String(a?.key||"").toUpperCase()===String(r||"").toUpperCase())||t[0]||null;return(Array.isArray(i?.issuetypes)?i.issuetypes:[]).map(a=>({id:a.id,name:a.name,subtask:!!a.subtask,description:a.description||null}))}async function ce(r,s){if(!r)throw new Error("projectKey is required");let e="sprint is not EMPTY";s==="active"?e="sprint in openSprints()":s==="closed"?e="sprint in closedSprints()":s==="future"&&(e="sprint in futureSprints()");let t=`project = ${r} AND ${e} ORDER BY updated DESC`,n=`jql=${encodeURIComponent(t)}&maxResults=100&fields=customfield_10020`,i=await w(`/rest/api/3/search/jql?${n}`),o=new Map;for(let a of i.issues||[])for(let c of a.fields?.customfield_10020||[])c&&!o.has(c.id)&&o.set(c.id,{id:c.id,name:c.name,state:c.state,boardId:c.boardId||null,startDate:c.startDate||null,endDate:c.endDate||null,goal:c.goal||null});return[...o.values()].sort((a,c)=>{let u={active:0,future:1,closed:2},l=(u[a.state]??3)-(u[c.state]??3);return l!==0?l:String(c.startDate||"").localeCompare(String(a.startDate||""))})}function Je(r,{sprintId:s,sprintName:e,target:t}={}){let n=Array.isArray(r)?r:[];if(!n.length)return{sprint:null,selectedBy:"none"};if(s!=null&&String(s).trim()!=="")return{sprint:n.find(a=>String(a.id)===String(s))||null,selectedBy:"id"};if(e&&String(e).trim()){let o=String(e).trim(),a=n.find(u=>String(u.name||"").toLowerCase()===o.toLowerCase());if(a)return{sprint:a,selectedBy:"name-exact"};let c=n.map(u=>({s:u,score:D(o,u.name||"")})).sort((u,l)=>l.score-u.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let i=String(t||"current").trim().toLowerCase();return i==="active"||i==="current"||i==="latest"?{sprint:n[0],selectedBy:i}:{sprint:n[0],selectedBy:"default"}}function xe(r,s){let e=r?.fields?.customfield_10020;return Array.isArray(e)?e.some(t=>String(t?.id)===String(s)):!1}async function Ue({issueKey:r,projectKey:s,sprintId:e,attempts:t=3,delayMs:n=450}){let i=[];for(let o=0;o<t;o++){try{let a=`project = ${s} AND key = ${r} AND sprint = ${e}`,c=`jql=${encodeURIComponent(a)}&maxResults=1&fields=key,status`,u=await w(`/rest/api/3/search/jql?${c}`);if(Number(u?.total||0)>0)return i.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:i};let p=await w(`/rest/api/3/issue/${r}?fields=customfield_10020,status`),m=xe(p,e);if(i.push({attempt:o+1,jql:!1,issueField:m}),m)return{ok:!0,method:"issue_field",traces:i}}catch(a){i.push({attempt:o+1,error:String(a?.message||a)})}o<t-1&&await new Promise(a=>setTimeout(a,n))}return{ok:!1,method:"none",traces:i}}async function B({issueKey:r,projectKey:s,sprintId:e,sprintName:t,target:n}){if(!r)return{ok:!1,error:"issueKey is required"};let i=s;if(!i&&(i=(await w(`/rest/api/3/issue/${r}?fields=project`))?.fields?.project?.key||null,!i))return{ok:!1,error:`Could not resolve project for ${r}`};let o=await ce(i,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${i}`};let{sprint:a,selectedBy:c}=Je(o,{sprintId:e,sprintName:t,target:n});if(!a)return{ok:!1,error:`No matching sprint found in ${i}`,requested:{sprintId:e??null,sprintName:t??null,target:n??"current"},availableSprints:o.map(p=>({id:p.id,name:p.name,state:p.state}))};await w(`/rest/api/3/issue/${r}`,{method:"PUT",body:{fields:{customfield_10020:Number(a.id)}}});let u=await Ue({issueKey:r,projectKey:i,sprintId:a.id}),l=u.ok;return{ok:l,issueKey:r,projectKey:i,sprintId:a.id,sprintName:a.name,selectedBy:c,verifiedBy:u.method,verified:l,verificationTrace:u.traces,warning:l?null:`Sprint assignment attempted but verification did not find ${r} in sprint ${a.id}`}}async function w(r,s={}){let e=async()=>{let{token:t,cloudId:n}=await je("jira");if(typeof t!="string"||!t)throw new Error(`Invalid jira token type: ${typeof t}`);if(!n)throw new Error("Invalid jira cloudId: missing");let i=`https://api.atlassian.com/ex/jira/${n}${r}`,o=await fetch(i,{method:s.method||"GET",headers:{Authorization:`Bearer ${t}`,Accept:"application/json",...s.body?{"Content-Type":"application/json"}:{},...s.headers},body:s.body?JSON.stringify(s.body):void 0});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`Jira API ${o.status}: ${c.slice(0,300)}`)}let a=await o.text().catch(()=>"");if(!a||!a.trim())return{};try{return JSON.parse(a)}catch{return{raw:a}}};try{return await e()}catch(t){let n=String(t?.message||t||"").toLowerCase();if(!(n.includes("token")||n.includes("401")||n.includes("403")||n.includes("substring")))throw t;return Ee("jira"),e()}}var q={id:"jira",serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:E.JIRA,envKeys:["ATLASSIAN_ACCESS_TOKEN","ATLASSIAN_CLOUD_ID"],description:"Zibby Jira MCP Server (OAuth Bearer)",promptFragment:`## Jira (connected)
 You have direct access to the user's Jira. Use these tools proactively:
 
 ### Issue tools
@@ -66,7 +66,7 @@ When user asks to move/transition ticket status:
 3. Pick the correct transition from returned list (match by "to" status name, not guesswork), then call jira_transition_issue with transitionId.
 4. Call jira_get_issue(issueKey) to verify final status before claiming success.
 5. If target wording differs (e.g. \u5DF2\u7ECF\u9A8C\u6536 vs \u5DF2\u9A8C\u6536), try toStatus first; only ask user to confirm when no reasonable match exists.
-6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=Ce();if(!r)return null;let s={};for(let e of this.envKeys)process.env[e]&&(s[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(s.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(s[e]=process.env[e]);return{command:"node",args:[r],env:s,description:this.description}},async handleToolCall(r,s){try{switch(r){case"jira_list_projects":{let e=await w("/rest/api/3/project"),t=(Array.isArray(e)?e:[]).map(n=>({id:n.id,key:n.key,name:n.name,style:n.style}));return JSON.stringify({count:t.length,projects:t})}case"jira_list_statuses":{let{projectKey:e}=s||{};if(e){let i=await w(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(i)?i:[],a=new Map;for(let u of o)for(let l of u.statuses||[])l?.id&&(a.has(l.id)||a.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let c=[...a.values()].sort((u,l)=>String(u.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let t=await w("/rest/api/3/status"),n=(Array.isArray(t)?t:[]).map(i=>({id:i.id,name:i.name,category:i.statusCategory?.name||null})).sort((i,o)=>String(i.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:n.length,statuses:n})}case"jira_list_issue_types":{let{projectKey:e}=s||{};if(!e)return JSON.stringify({error:"projectKey is required"});let t=await ae(e);return JSON.stringify({projectKey:e,count:t.length,issueTypes:t})}case"jira_search":{let e=s.jql||"",t=s.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let i=`jql=${encodeURIComponent(e)}&maxResults=${t}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await w(`/rest/api/3/search/jql?${i}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=s.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let t=await w(`/rest/api/3/issue/${e}`);return JSON.stringify({key:t.key,project:t.fields?.project?.key,summary:t.fields?.summary,description:t.fields?.description,status:t.fields?.status?.name,assignee:t.fields?.assignee?.displayName||"Unassigned",priority:t.fields?.priority?.name,type:t.fields?.issuetype?.name,labels:t.fields?.labels,created:t.fields?.created,updated:t.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:t,issueType:n,description:i,priority:o,labels:a,assigneeId:c,moveToSprint:u,moveToActiveSprint:l,sprintId:p,sprintName:m,target:g}=s;if(!e||!t)return JSON.stringify({error:"projectKey and summary are required"});let d={requested:n||null,resolved:null,strategy:"none"},b=[];try{b=await ae(e),d=qe(n,b)}catch{}let h={project:{key:e},summary:t,issuetype:d?.resolved?.id?{id:d.resolved.id}:{name:n||"Task"}};i&&(h.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:i}]}]}),o&&(h.priority={name:o}),a?.length&&(h.labels=a),c&&(h.assignee={id:c});let S=await w("/rest/api/3/issue",{method:"POST",body:{fields:h}}),f={ok:!0,key:S.key,id:S.id,self:S.self};return d?.resolved&&(f.issueType=d.resolved.name,f.issueTypeResolution=d.strategy,d.strategy!=="exact"&&d.requested&&$(d.requested)!==$(d.resolved.name)&&(f.issueTypeWarning=`Requested "${d.requested}" is not available in ${e}; used "${d.resolved.name}" instead.`)),b.length>0&&(f.availableIssueTypes=b.map(y=>y.name)),(u||l)&&(f.sprintMove=await B({issueKey:S.key,projectKey:e,sprintId:p,sprintName:m,target:g})),JSON.stringify(f)}case"jira_list_sprints":{let{projectKey:e,state:t}=s,n=await ce(e,t);return JSON.stringify({count:n.length,sprints:n})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o}=s||{},a=await B({issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o}=s||{},a=await B({issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:t,projectKey:n,status:i,maxResults:o}=s;if(!e&&!t)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=t?`sprint = ${t}`:`sprint = "${e}"`,u=n?`project = ${n} AND `:"",l=i?` AND status = "${i}"`:"",p=`${u}${c}${l} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,g=await w(`/rest/api/3/search/jql?${m}`),d=(g.issues||[]).map(h=>({key:h.key,project:h.fields?.project?.key,summary:h.fields?.summary,status:h.fields?.status?.name,assignee:h.fields?.assignee?.displayName||"Unassigned",priority:h.fields?.priority?.name,type:h.fields?.issuetype?.name})),b={};for(let h of d)b[h.status]=(b[h.status]||0)+1;return JSON.stringify({count:d.length,total:g.total||d.length,statusCounts:b,issues:d})}case"jira_get_comments":{let{issueKey:e,maxResults:t}=s;if(!e)return JSON.stringify({error:"issueKey is required"});let i=await w(`/rest/api/3/issue/${e}/comment?maxResults=${t||50}&orderBy=-created`),o=(i.comments||[]).map(a=>{let c="";return a.body?.content&&(c=K(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:i.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:t}=s;return!e||!t?JSON.stringify({error:"issueKey and body are required"}):(await w(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:t}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:t}=s;return!e||!t?JSON.stringify({error:"issueKey and fields are required"}):(await w(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:t}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:t,toStatus:n,statusName:i,status:o}=s;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(n||i||o||"").trim();if(!t&&!a){let p=((await w(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(m=>({id:m.id,name:m.name,to:m.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=t;if(!c){let p=(await w(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=T(a),g=p.find(d=>T(d?.name||"")===m||T(d?.to?.name||"")===m);if(!g){let d=H(a);d.length>=2&&(g=p.find(b=>{let h=H(b?.name||""),S=H(b?.to?.name||""),f=h.length>=2&&(h.includes(d)||d.includes(h)),y=S.length>=2&&(S.includes(d)||d.includes(S));return f||y}))}if(!g){let d=p.map(f=>{let y=D(a,f?.name||""),k=D(a,f?.to?.name||"");return{t:f,score:Math.max(y,k)}}).sort((f,y)=>y.score-f.score),b=d[0],h=d[1];b&&b.score>=.45&&(!h||b.score-h.score>=.12)&&(g=b.t)}if(!g?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(d=>({id:d.id,name:d.name,to:d.to?.name}))});c=g.id}await w(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let u=await w(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:u?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description (plain text)"},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text (plain text)"}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, story points, labels, priority)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};var Ge={new:"todo",indeterminate:"in_progress",done:"done"},Ke=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function Y(r){if(!r)return"unknown";if(r.name&&Ke.test(r.name))return"blocked";let s=r.statusCategory?.key;return Ge[s]||"unknown"}function W(r){if(!r)return"";if(Array.isArray(r))return r.map(W).join("");if(r.type==="text")return r.text||"";if(r.type==="hardBreak"||r.type==="rule")return`
+6. IMPORTANT: When target is clear, complete transition + verification in SAME turn. Do NOT stop after listing options.`,resolve(){let r=Ce();if(!r)return null;let s={};for(let e of this.envKeys)process.env[e]&&(s[e]=process.env[e]);process.env.ATLASSIAN_INSTANCE_URL&&(s.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL);for(let e of["JIRA_API_TOKEN","JIRA_EMAIL","JIRA_BASE_URL"])process.env[e]&&(s[e]=process.env[e]);return{command:"node",args:[r],env:s,description:this.description}},async handleToolCall(r,s){try{switch(r){case"jira_list_projects":{let e=await w("/rest/api/3/project"),t=(Array.isArray(e)?e:[]).map(n=>({id:n.id,key:n.key,name:n.name,style:n.style}));return JSON.stringify({count:t.length,projects:t})}case"jira_list_statuses":{let{projectKey:e}=s||{};if(e){let i=await w(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(i)?i:[],a=new Map;for(let u of o)for(let l of u.statuses||[])l?.id&&(a.has(l.id)||a.set(l.id,{id:l.id,name:l.name,category:l.statusCategory?.name||null}));let c=[...a.values()].sort((u,l)=>String(u.name).localeCompare(String(l.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let t=await w("/rest/api/3/status"),n=(Array.isArray(t)?t:[]).map(i=>({id:i.id,name:i.name,category:i.statusCategory?.name||null})).sort((i,o)=>String(i.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:n.length,statuses:n})}case"jira_list_issue_types":{let{projectKey:e}=s||{};if(!e)return JSON.stringify({error:"projectKey is required"});let t=await ae(e);return JSON.stringify({projectKey:e,count:t.length,issueTypes:t})}case"jira_search":{let e=s.jql||"",t=s.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let i=`jql=${encodeURIComponent(e)}&maxResults=${t}&fields=summary,status,assignee,priority,updated,issuetype,project`,a=((await w(`/rest/api/3/search/jql?${i}`)).issues||[]).map(c=>({key:c.key,project:c.fields?.project?.key,summary:c.fields?.summary,status:c.fields?.status?.name,assignee:c.fields?.assignee?.displayName||"Unassigned",priority:c.fields?.priority?.name,type:c.fields?.issuetype?.name}));return JSON.stringify({count:a.length,issues:a})}case"jira_get_issue":{let e=s.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let t=await w(`/rest/api/3/issue/${e}`);return JSON.stringify({key:t.key,project:t.fields?.project?.key,summary:t.fields?.summary,description:t.fields?.description,status:t.fields?.status?.name,assignee:t.fields?.assignee?.displayName||"Unassigned",priority:t.fields?.priority?.name,type:t.fields?.issuetype?.name,labels:t.fields?.labels,created:t.fields?.created,updated:t.fields?.updated})}case"jira_create_issue":{let{projectKey:e,summary:t,issueType:n,description:i,priority:o,labels:a,assigneeId:c,moveToSprint:u,moveToActiveSprint:l,sprintId:p,sprintName:m,target:g}=s;if(!e||!t)return JSON.stringify({error:"projectKey and summary are required"});let d={requested:n||null,resolved:null,strategy:"none"},b=[];try{b=await ae(e),d=qe(n,b)}catch{}let h={project:{key:e},summary:t,issuetype:d?.resolved?.id?{id:d.resolved.id}:{name:n||"Task"}};i&&(h.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:i}]}]}),o&&(h.priority={name:o}),a?.length&&(h.labels=a),c&&(h.assignee={id:c});let S=await w("/rest/api/3/issue",{method:"POST",body:{fields:h}}),f={ok:!0,key:S.key,id:S.id,self:S.self};return d?.resolved&&(f.issueType=d.resolved.name,f.issueTypeResolution=d.strategy,d.strategy!=="exact"&&d.requested&&I(d.requested)!==I(d.resolved.name)&&(f.issueTypeWarning=`Requested "${d.requested}" is not available in ${e}; used "${d.resolved.name}" instead.`)),b.length>0&&(f.availableIssueTypes=b.map(y=>y.name)),(u||l)&&(f.sprintMove=await B({issueKey:S.key,projectKey:e,sprintId:p,sprintName:m,target:g})),JSON.stringify(f)}case"jira_list_sprints":{let{projectKey:e,state:t}=s,n=await ce(e,t);return JSON.stringify({count:n.length,sprints:n})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o}=s||{},a=await B({issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o||"current"});return JSON.stringify(a)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o}=s||{},a=await B({issueKey:e,projectKey:t,sprintId:n,sprintName:i,target:o});return JSON.stringify(a)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:t,projectKey:n,status:i,maxResults:o}=s;if(!e&&!t)return JSON.stringify({error:"sprintName or sprintId is required"});let a=o||50,c=t?`sprint = ${t}`:`sprint = "${e}"`,u=n?`project = ${n} AND `:"",l=i?` AND status = "${i}"`:"",p=`${u}${c}${l} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(p)}&maxResults=${a}&fields=summary,status,assignee,priority,issuetype,project`,g=await w(`/rest/api/3/search/jql?${m}`),d=(g.issues||[]).map(h=>({key:h.key,project:h.fields?.project?.key,summary:h.fields?.summary,status:h.fields?.status?.name,assignee:h.fields?.assignee?.displayName||"Unassigned",priority:h.fields?.priority?.name,type:h.fields?.issuetype?.name})),b={};for(let h of d)b[h.status]=(b[h.status]||0)+1;return JSON.stringify({count:d.length,total:g.total||d.length,statusCounts:b,issues:d})}case"jira_get_comments":{let{issueKey:e,maxResults:t}=s;if(!e)return JSON.stringify({error:"issueKey is required"});let i=await w(`/rest/api/3/issue/${e}/comment?maxResults=${t||50}&orderBy=-created`),o=(i.comments||[]).map(a=>{let c="";return a.body?.content&&(c=K(a.body.content)),{id:a.id,author:a.author?.displayName||"Unknown",body:c,created:a.created,updated:a.updated}});return JSON.stringify({count:o.length,total:i.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:t}=s;return!e||!t?JSON.stringify({error:"issueKey and body are required"}):(await w(`/rest/api/3/issue/${e}/comment`,{method:"POST",body:{body:{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:t}]}]}}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_edit_issue":{let{issueKey:e,fields:t}=s;return!e||!t?JSON.stringify({error:"issueKey and fields are required"}):(await w(`/rest/api/3/issue/${e}`,{method:"PUT",body:{fields:t}}),JSON.stringify({ok:!0,issueKey:e}))}case"jira_transition_issue":{let{issueKey:e,transitionId:t,toStatus:n,statusName:i,status:o}=s;if(!e)return JSON.stringify({error:"issueKey is required"});let a=String(n||i||o||"").trim();if(!t&&!a){let p=((await w(`/rest/api/3/issue/${e}/transitions`)).transitions||[]).map(m=>({id:m.id,name:m.name,to:m.to?.name}));return JSON.stringify({ok:!1,error:"transitionId or toStatus is required",issueKey:e,availableTransitions:p})}let c=t;if(!c){let p=(await w(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=T(a),g=p.find(d=>T(d?.name||"")===m||T(d?.to?.name||"")===m);if(!g){let d=H(a);d.length>=2&&(g=p.find(b=>{let h=H(b?.name||""),S=H(b?.to?.name||""),f=h.length>=2&&(h.includes(d)||d.includes(h)),y=S.length>=2&&(S.includes(d)||d.includes(S));return f||y}))}if(!g){let d=p.map(f=>{let y=D(a,f?.name||""),k=D(a,f?.to?.name||"");return{t:f,score:Math.max(y,k)}}).sort((f,y)=>y.score-f.score),b=d[0],h=d[1];b&&b.score>=.45&&(!h||b.score-h.score>=.12)&&(g=b.t)}if(!g?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${a}"`,issueKey:e,availableTransitions:p.map(d=>({id:d.id,name:d.name,to:d.to?.name}))});c=g.id}await w(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let u=await w(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:u?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"jira_list_projects",description:"List all Jira projects accessible to the user",input_schema:{type:"object",properties:{}}},{name:"jira_list_statuses",description:"List Jira statuses. Use projectKey to get statuses applicable in that project workflow.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Optional project key (e.g. PROJ). If omitted, returns global status catalog."}}}},{name:"jira_list_issue_types",description:"List issue types allowed for issue creation in the given project.",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"}},required:["projectKey"]}},{name:"jira_search",description:"Search Jira issues using JQL",input_schema:{type:"object",properties:{jql:{type:"string",description:'JQL query string, e.g. "project = PROJ AND status = Open"'},maxResults:{type:"number",description:"Max results to return (default 20)"}},required:["jql"]}},{name:"jira_get_issue",description:"Get details of a specific Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"}},required:["issueKey"]}},{name:"jira_create_issue",description:"Create a new Jira issue",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},summary:{type:"string",description:"Issue title/summary"},issueType:{type:"string",description:"Issue type (default: Task). Common: Task, Bug, Story, Epic"},description:{type:"string",description:"Issue description (plain text)"},priority:{type:"string",description:"Priority name, e.g. High, Medium, Low"},labels:{type:"array",items:{type:"string"},description:"Array of label strings"},assigneeId:{type:"string",description:"Atlassian account ID to assign to"},moveToSprint:{type:"boolean",description:"If true, move created issue to a sprint and verify."},moveToActiveSprint:{type:"boolean",description:"Backward-compatible alias for moveToSprint."},sprintId:{type:"number",description:"Optional sprint id for placement."},sprintName:{type:"string",description:"Optional sprint name for placement."},target:{type:"string",description:"Placement target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["projectKey","summary"]}},{name:"jira_list_sprints",description:"List sprints for a Jira project (returns sprint names, IDs, states, dates)",input_schema:{type:"object",properties:{projectKey:{type:"string",description:"Project key, e.g. PROJ"},state:{type:"string",description:"Filter: active, closed, future. Omit for all."}},required:["projectKey"]}},{name:"jira_get_sprint_issues",description:"Get all issues in a sprint, optionally filtered by status column name",input_schema:{type:"object",properties:{sprintName:{type:"string",description:"Sprint name (from jira_list_sprints). Use this OR sprintId."},sprintId:{type:"number",description:"Sprint ID (from jira_list_sprints). Use this OR sprintName."},projectKey:{type:"string",description:"Project key to scope the search (optional)"},status:{type:"string",description:'Filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "Done")'},maxResults:{type:"number",description:"Max issues to return (default 50)"}}}},{name:"jira_move_to_active_sprint",description:"Backward-compatible alias: move issue to sprint target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_move_issue_to_sprint",description:"Move an issue to a sprint by id/name/target and verify membership.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},projectKey:{type:"string",description:"Optional project key. If omitted, inferred from issue."},sprintId:{type:"number",description:"Optional sprint id."},sprintName:{type:"string",description:"Optional sprint name."},target:{type:"string",description:"Target when sprintId/sprintName omitted: current|active|latest (default: current)."}},required:["issueKey"]}},{name:"jira_get_comments",description:"Get comments on a Jira issue (newest first)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},maxResults:{type:"number",description:"Max comments to return (default 50)"}},required:["issueKey"]}},{name:"jira_add_comment",description:"Add a comment to a Jira issue",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},body:{type:"string",description:"Comment text (plain text)"}},required:["issueKey","body"]}},{name:"jira_edit_issue",description:"Update fields on a Jira issue (summary, story points, labels, priority)",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},fields:{type:"object",description:"Object of field names to values",additionalProperties:!0}},required:["issueKey","fields"]}},{name:"jira_transition_issue",description:"Move a Jira issue to a different status. Always pass toStatus when user gave a target; only pass issueKey alone when you explicitly need to list transitions.",input_schema:{type:"object",properties:{issueKey:{type:"string",description:"Issue key, e.g. PROJ-123"},transitionId:{type:"string",description:"Transition ID to perform (optional if toStatus is provided)"},toStatus:{type:"string",description:'Target status/column name (e.g. "\u5DF2\u7ECF\u9A8C\u6536", "Done", "In Progress"). If provided, tool resolves matching transition automatically.'}},required:["issueKey"]}}]};var Ge={new:"todo",indeterminate:"in_progress",done:"done"},Ke=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function Y(r){if(!r)return"unknown";if(r.name&&Ke.test(r.name))return"blocked";let s=r.statusCategory?.key;return Ge[s]||"unknown"}function W(r){if(!r)return"";if(Array.isArray(r))return r.map(W).join("");if(r.type==="text")return r.text||"";if(r.type==="hardBreak"||r.type==="rule")return`
 `;let s=r.content?W(r.content):"";return/^(paragraph|heading|listItem|blockquote|codeBlock|panel)$/.test(r.type)&&(s+=`
 `),s}function F(r,s){let e=r.fields||{},t=e.status||null,n=null;if(r.self&&r.key)try{n=`${new URL(r.self).origin}/browse/${r.key}`}catch{n=null}return!n&&s&&r.key&&(n=`${String(s).replace(/\/+$/,"")}/browse/${r.key}`),{id:String(r.id??r.key??""),key:r.key,title:e.summary||"",body:typeof e.description=="string"?e.description:W(e.description?.content).trim(),state:t?.name||null,stateCategory:Y(t),assignee:e.assignee?.displayName||null,url:n,_raw:r}}function z(r){let s=JSON.parse(r);if(s&&s.error)throw new Error(s.error);return s}var Q={id:"jira",toStateCategory:Y,toNeutral:F,async listCandidates(r={}){let s=r.query||"";if(!s.trim()){let i=[];if(r.state&&i.push(`status = "${r.state}"`),r.labels){let o=Array.isArray(r.labels)?r.labels:[r.labels];for(let a of o)i.push(`labels = "${a}"`)}r.updatedAfter&&i.push(`updated >= "${r.updatedAfter}"`),s=i.length?`${i.join(" AND ")} ORDER BY updated DESC`:"ORDER BY updated DESC"}let e=Number(r.limit)||30,t=`jql=${encodeURIComponent(s)}&maxResults=${e}&fields=summary,description,status,assignee,labels,project,updated,created`;return((await w(`/rest/api/3/search/jql?${t}`)).issues||[]).map(i=>F(i))},async getTicket(r){if(!r)throw new Error("key is required");let s=await w(`/rest/api/3/issue/${encodeURIComponent(r)}`);return!s||!s.key?null:F(s)},async getComments(r){if(!r)throw new Error("key is required");return(z(await q.handleToolCall("jira_get_comments",{issueKey:r})).comments||[]).map(e=>({id:String(e.id),author:e.author||"Unknown",body:e.body||"",createdAt:e.created||null,updatedAt:e.updated||null,_raw:e}))},async addComment(r,s){if(!r||!s)throw new Error("key and body are required");return{ok:!!z(await q.handleToolCall("jira_add_comment",{issueKey:r,body:s})).ok,id:null}},async transition(r,s){if(!r)throw new Error("key is required");let e=JSON.parse(await q.handleToolCall("jira_transition_issue",{issueKey:r,toStatus:s}));if(!e.ok)return{ok:!1,error:e.error||"transition failed",_raw:e};let t=e.statusAfter||null;return{ok:!0,stateAfter:t,stateCategoryAfter:Y(t?{name:t}:null),_raw:e}},async linkPullRequest(r,s,e){if(!r||!s)throw new Error("key and prUrl are required");try{return await w(`/rest/api/3/issue/${encodeURIComponent(r)}/remotelink`,{method:"POST",body:{object:{url:s,title:e||s,icon:{url16x16:"https://github.com/favicon.ico",title:"GitHub"}}}}),{ok:!0,via:"remotelink"}}catch(t){let n=`${e?`${e}: `:"Linked PR: "}${s}`;return{ok:!!z(await q.handleToolCall("jira_add_comment",{issueKey:r,body:n})).ok,via:"comment",error:String(t?.message||t)}}}};import{existsSync as De}from"fs";import{fileURLToPath as Me}from"url";import{dirname as He,resolve as Be}from"path";function Fe(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=He(Me(import.meta.url)),s=Be(r,"..","bin","mcp-skill.mjs");return De(s)?s:null}var ze=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function Ye(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let r=process.env.LINEAR_API_KEY;if(!r)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return r}async function A(r,s={}){let e=await fetch(ze,{method:"POST",headers:{Authorization:Ye(),"Content-Type":"application/json"},body:JSON.stringify({query:r,variables:s})});if(!e.ok){let n=await e.text().catch(()=>"");throw new Error(`Linear API ${e.status}: ${n.slice(0,300)}`)}let t=await e.json().catch(()=>null);if(!t)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(t.errors)&&t.errors.length){let n=t.errors.map(i=>i?.message||String(i)).join("; ");throw new Error(`Linear GraphQL error: ${n.slice(0,300)}`)}return t.data}function x(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function We(r,s){let e=x(r),t=x(s);if(!e||!t)return 0;if(e===t)return 1;if(e.length===1||t.length===1)return e===t?1:0;let n=l=>{let p=new Map;for(let m=0;m<l.length-1;m++){let g=l.slice(m,m+2);p.set(g,(p.get(g)||0)+1)}return p},i=n(e),o=n(t),a=0,c=0,u=0;for(let l of i.values())c+=l;for(let l of o.values())u+=l;for(let[l,p]of i.entries())a+=Math.min(p,o.get(l)||0);return 2*a/Math.max(1,c+u)}function Qe(r,s){let e=Array.isArray(r)?r:[];if(!e.length)return{state:null,strategy:"no-states"};let t=x(s);if(!t)return{state:null,strategy:"no-target"};let n=e.find(a=>x(a.name)===t);if(n)return{state:n,strategy:"exact"};let i={backlog:["backlog"],unstarted:["todo","unstarted","open"],started:["inprogress","started","doing","wip"],completed:["done","completed","closed","resolved","fixed"],canceled:["canceled","cancelled","wontfix","won'tfix"],triage:["triage"]};for(let[a,c]of Object.entries(i)){if(!c.some(l=>x(l)===t))continue;let u=e.find(l=>l.type===a);if(u)return{state:u,strategy:"type-alias"}}let o=e.map(a=>({s:a,score:We(s,a.name)})).sort((a,c)=>c.score-a.score);return o[0]&&o[0].score>=.5?{state:o[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var Ve=`
   id
@@ -82,7 +82,7 @@ When user asks to move/transition ticket status:
   assignee { id name displayName email }
   labels { nodes { id name color } }
   team { id key name }
-`,I={id:"linear",serverName:"linear",allowedTools:["mcp__linear__*"],requiresIntegration:E.LINEAR,envKeys:["LINEAR_API_KEY","LINEAR_OAUTH_TOKEN"],description:"Linear \u2014 issues, comments, workflow states (GraphQL API key)",promptFragment:`## Linear (connected)
+`,$={id:"linear",serverName:"linear",allowedTools:["mcp__linear__*"],requiresIntegration:E.LINEAR,envKeys:["LINEAR_API_KEY","LINEAR_OAUTH_TOKEN"],description:"Linear \u2014 issues, comments, workflow states (GraphQL API key)",promptFragment:`## Linear (connected)
 You have direct access to the user's Linear workspace (GraphQL API). Tools:
 
 ### Discovery
@@ -181,7 +181,7 @@ You have direct access to the user's Linear workspace (GraphQL API). Tools:
     query IssueById($id: String!) {
       issue(id: $id) { ${s} }
     }
-  `,{id:e}))?.issue||null}var Ze={triage:"todo",backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",canceled:"done"},Xe=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function Z(r){return r?r.name&&Xe.test(r.name)?"blocked":Ze[r.type]||"unknown":"unknown"}function U(r){let s=JSON.parse(r);if(s&&s.error)throw new Error(s.error);return s}function V(r){let s=r.state||null,e=r.stateType||null;return{id:String(r.id||r.identifier||""),key:r.identifier||String(r.id||""),title:r.title||"",body:r.description||"",state:s,stateCategory:Z(s?{name:s,type:e}:null),assignee:r.assignee||null,url:r.url||null,_raw:r}}var X={id:"linear",toStateCategory:Z,toNeutral:V,async listCandidates(r={}){let s=r.ctx||{},e={teamId:s.teamId,teamKey:s.teamKey,stateName:r.state,label:Array.isArray(r.labels)?r.labels[0]:r.labels,assigneeId:s.assigneeId,updatedAfter:r.updatedAfter,limit:r.limit};return(U(await I.handleToolCall("linear_list_issues",e)).issues||[]).map(V)},async getTicket(r){if(!r)throw new Error("key is required");let s=JSON.parse(await I.handleToolCall("linear_get_issue",{identifier:r}));return s.error?null:V(s)},async getComments(r){if(!r)throw new Error("key is required");return(U(await I.handleToolCall("linear_get_comments",{identifier:r})).comments||[]).map(e=>({id:String(e.id),author:e.author||"Unknown",body:e.body||"",createdAt:e.createdAt||null,updatedAt:e.updatedAt||null,_raw:e}))},async addComment(r,s){if(!r||!s)throw new Error("key and body are required");let e=U(await I.handleToolCall("linear_add_comment",{identifier:r,body:s}));return{ok:!!e.ok,id:e.commentId||null}},async transition(r,s){if(!r)throw new Error("key is required");let e=JSON.parse(await I.handleToolCall("linear_update_state",{identifier:r,toStatus:s}));if(!e.ok)return{ok:!1,error:e.error||"state update failed",_raw:e};let t=e.stateAfter||null;return{ok:!0,stateAfter:t,stateCategoryAfter:Z(t?{name:t,type:e.stateTypeAfter}:null),_raw:e}},async linkPullRequest(r,s,e){if(!r||!s)throw new Error("key and prUrl are required");try{if(U(await I.handleToolCall("linear_link_attachment",{identifier:r,url:s,title:e||s})).ok)return{ok:!0,via:"attachment"};throw new Error("attachmentCreate returned ok:false")}catch(t){let n=`${e?`${e}: `:"Linked PR: "}${s}`;return{ok:!!U(await I.handleToolCall("linear_add_comment",{identifier:r,body:n})).ok,via:"comment",error:String(t?.message||t)}}}};import{existsSync as it}from"fs";import{fileURLToPath as nt}from"url";import{dirname as ot,resolve as at}from"path";import{resolveIntegrationToken as he}from"@zibby/core/backend-client.js";import{spawn as xt,execSync as Ut}from"child_process";import{existsSync as Kt,mkdirSync as Dt,readdirSync as Mt,statSync as Ht,readFileSync as Bt}from"fs";import{resolve as zt,join as Yt,basename as Wt}from"path";function pe(r,s,e,t,n="clone"){try{r(`git -C "${s}" remote set-url origin "${e}"`,{stdio:"pipe"})}catch(i){let o=String(i?.message||i);t&&(o=o.split(t).join("***")),console.error(`[${n}] WARNING: failed to strip token from .git/config: ${o}`)}}import et from"crypto";var ue=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,de=/<!--\s*zbreview-summary\s*-->/i;function tt(r){return String(r||"").replace(ue,"").replace(de,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function rt(r,s){return et.createHash("sha256").update(`${String(r||"")}\0${tt(s)}`).digest("hex").slice(0,12)}function st(r){return`
+  `,{id:e}))?.issue||null}var Ze={triage:"todo",backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",canceled:"done"},Xe=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function Z(r){return r?r.name&&Xe.test(r.name)?"blocked":Ze[r.type]||"unknown":"unknown"}function U(r){let s=JSON.parse(r);if(s&&s.error)throw new Error(s.error);return s}function V(r){let s=r.state||null,e=r.stateType||null;return{id:String(r.id||r.identifier||""),key:r.identifier||String(r.id||""),title:r.title||"",body:r.description||"",state:s,stateCategory:Z(s?{name:s,type:e}:null),assignee:r.assignee||null,url:r.url||null,_raw:r}}var X={id:"linear",toStateCategory:Z,toNeutral:V,async listCandidates(r={}){let s=r.ctx||{},e={teamId:s.teamId,teamKey:s.teamKey,stateName:r.state,label:Array.isArray(r.labels)?r.labels[0]:r.labels,assigneeId:s.assigneeId,updatedAfter:r.updatedAfter,limit:r.limit};return(U(await $.handleToolCall("linear_list_issues",e)).issues||[]).map(V)},async getTicket(r){if(!r)throw new Error("key is required");let s=JSON.parse(await $.handleToolCall("linear_get_issue",{identifier:r}));return s.error?null:V(s)},async getComments(r){if(!r)throw new Error("key is required");return(U(await $.handleToolCall("linear_get_comments",{identifier:r})).comments||[]).map(e=>({id:String(e.id),author:e.author||"Unknown",body:e.body||"",createdAt:e.createdAt||null,updatedAt:e.updatedAt||null,_raw:e}))},async addComment(r,s){if(!r||!s)throw new Error("key and body are required");let e=U(await $.handleToolCall("linear_add_comment",{identifier:r,body:s}));return{ok:!!e.ok,id:e.commentId||null}},async transition(r,s){if(!r)throw new Error("key is required");let e=JSON.parse(await $.handleToolCall("linear_update_state",{identifier:r,toStatus:s}));if(!e.ok)return{ok:!1,error:e.error||"state update failed",_raw:e};let t=e.stateAfter||null;return{ok:!0,stateAfter:t,stateCategoryAfter:Z(t?{name:t,type:e.stateTypeAfter}:null),_raw:e}},async linkPullRequest(r,s,e){if(!r||!s)throw new Error("key and prUrl are required");try{if(U(await $.handleToolCall("linear_link_attachment",{identifier:r,url:s,title:e||s})).ok)return{ok:!0,via:"attachment"};throw new Error("attachmentCreate returned ok:false")}catch(t){let n=`${e?`${e}: `:"Linked PR: "}${s}`;return{ok:!!U(await $.handleToolCall("linear_add_comment",{identifier:r,body:n})).ok,via:"comment",error:String(t?.message||t)}}}};import{existsSync as it}from"fs";import{fileURLToPath as nt}from"url";import{dirname as ot,resolve as at}from"path";import{resolveIntegrationToken as he}from"@zibby/core/backend-client.js";import{spawn as xt,execSync as Ut}from"child_process";import{existsSync as Kt,mkdirSync as Dt,readdirSync as Mt,statSync as Ht,readFileSync as Bt}from"fs";import{resolve as zt,join as Yt,basename as Wt}from"path";function pe(r,s,e,t,n="clone"){try{r(`git -C "${s}" remote set-url origin "${e}"`,{stdio:"pipe"})}catch(i){let o=String(i?.message||i);t&&(o=o.split(t).join("***")),console.error(`[${n}] WARNING: failed to strip token from .git/config: ${o}`)}}import et from"crypto";var ue=/<!--\s*zbfp:([a-f0-9]{8,20})\s*-->/i,de=/<!--\s*zbreview-summary\s*-->/i;function tt(r){return String(r||"").replace(ue,"").replace(de,"").replace(/\b(?:lines?|L)\s*#?\d+(?:\s*[-–]\s*\d+)?/gi,"").replace(/[`*_>#~]/g,"").replace(/\s+/g," ").trim().toLowerCase().slice(0,400)}function rt(r,s){return et.createHash("sha256").update(`${String(r||"")}\0${tt(s)}`).digest("hex").slice(0,12)}function st(r){return`
 
 <!-- zbfp:${r} -->`}var me=`
 
@@ -230,4 +230,4 @@ When user says "check out repo-name" or "clone repo-name":
 When user just wants to "look at" or "read" files (not clone):
 - Use github_get_file to read individual files via API`,resolve(){let r=ct();if(!r)return{command:null,args:[],env:{},description:this.description};let s={};for(let e of this.envKeys)process.env[e]&&(s[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/github.js","githubSkill"],env:s,description:this.description,alwaysLoad:!0}},async handleToolCall(r,s){try{switch(r){case"github_search_issues":{let e=s.query;if(!e)return JSON.stringify({error:"query is required"});let t=await _(`/search/issues?q=${encodeURIComponent(e)}&per_page=${s.limit||20}`),n=(t.items||[]).map(i=>({number:i.number,title:i.title,state:i.state,repo:i.repository_url?.split("/").slice(-2).join("/"),url:i.html_url,user:i.user?.login,isPR:!!i.pull_request,labels:(i.labels||[]).map(o=>o.name),createdAt:i.created_at}));return JSON.stringify({total:t.total_count,items:n})}case"github_search_code":{let e=s.query;if(!e)return JSON.stringify({error:"query is required"});let t=s.repo?`+repo:${s.repo}`:"",n=s.language?`+language:${s.language}`:"",i=await _(`/search/code?q=${encodeURIComponent(e)}${t}${n}&per_page=${s.limit||15}`),o=(i.items||[]).map(a=>({name:a.name,path:a.path,repo:a.repository?.full_name,url:a.html_url,score:a.score}));return JSON.stringify({total:i.total_count,items:o})}case"github_get_pr":{let{owner:e,repo:t,number:n}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/pulls/${n}`);return JSON.stringify({number:i.number,title:i.title,state:i.state,merged:i.merged,body:i.body?.slice(0,5e3),user:i.user?.login,branch:i.head?.ref,headSha:i.head?.sha,base:i.base?.ref,changedFiles:i.changed_files,additions:i.additions,deletions:i.deletions,createdAt:i.created_at,mergedAt:i.merged_at,url:i.html_url,labels:(i.labels||[]).map(o=>o.name)})}case"github_get_pr_diff":{let{owner:e,repo:t,number:n}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/pulls/${n}`,{accept:"application/vnd.github.v3.diff",raw:!0}),o=i.length>15e3;return JSON.stringify({number:n,diff:o?i.slice(0,15e3):i,truncated:o,totalLength:i.length})}case"github_list_pr_files":{let{owner:e,repo:t,number:n}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/pulls/${n}/files?per_page=100`);return JSON.stringify({total:i.length,files:i.map(o=>({filename:o.filename,status:o.status,additions:o.additions,deletions:o.deletions,patch:o.patch?.slice(0,3e3)}))})}case"github_list_pr_comments":{let{owner:e,repo:t,number:n}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/pulls/${n}/comments?per_page=50`),o=await _(`/repos/${e}/${t}/issues/${n}/comments?per_page=50`),a=[...i.map(c=>({type:"review",user:c.user?.login,body:c.body?.slice(0,1e3),path:c.path,line:c.line,createdAt:c.created_at})),...o.map(c=>({type:"issue",user:c.user?.login,body:c.body?.slice(0,1e3),createdAt:c.created_at}))].sort((c,u)=>new Date(c.createdAt)-new Date(u.createdAt));return JSON.stringify({total:a.length,comments:a})}case"github_get_review_thread":{let{owner:e,repo:t,number:n,commentId:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, number, and commentId are required"});let o=await _(`/repos/${e}/${t}/pulls/comments/${i}`),a=o.in_reply_to_id||o.id,c=[];try{c=await _(`/repos/${e}/${t}/pulls/${n}/comments?per_page=100`)}catch{c=[o]}(!Array.isArray(c)||c.length===0)&&(c=[o]);let u=c.filter(m=>m.id===a||m.in_reply_to_id===a).sort((m,g)=>new Date(m.created_at)-new Date(g.created_at)),l=u.length?u:[o],p=l.find(m=>m.id===a)||l[0];return JSON.stringify({rootCommentId:a,path:p.path,line:p.line??p.original_line??null,side:p.side||"RIGHT",diffHunk:typeof p.diff_hunk=="string"?p.diff_hunk.slice(0,3e3):null,commitId:p.commit_id||p.original_commit_id||null,notes:l.map(m=>({id:m.id,user:m.user?.login,body:(m.body||"").slice(0,4e3),createdAt:m.created_at,isRoot:m.id===a,url:m.html_url}))})}case"github_reply_review_thread":{let{owner:e,repo:t,number:n,commentId:i,body:o}=s||{};if(!e||!t||!n||!i||!o)return JSON.stringify({error:"owner, repo, number, commentId, and body are required"});let a=await _(`/repos/${e}/${t}/pulls/${n}/comments/${i}/replies`,{method:"POST",body:{body:String(o)}});return JSON.stringify({ok:!0,id:a.id,url:a.html_url,inReplyTo:a.in_reply_to_id})}case"github_reply_issue_comment":{let{owner:e,repo:t,number:n,body:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await _(`/repos/${e}/${t}/issues/${n}/comments`,{method:"POST",body:{body:String(i)}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_create_review":{let{owner:e,repo:t,number:n,body:i,event:o,comments:a}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let c=(o||"COMMENT").toUpperCase();if(!["COMMENT","APPROVE","REQUEST_CHANGES"].includes(c))return JSON.stringify({error:`event must be COMMENT, APPROVE, or REQUEST_CHANGES (got ${o})`});let u=Array.isArray(a)?a.filter(f=>f&&f.path&&f.body&&(f.line!=null||f.position!=null)).map(f=>{let y={path:f.path,body:String(f.body)};return f.line!=null?(y.line=Number(f.line),y.side=f.side==="LEFT"?"LEFT":"RIGHT"):y.position=Number(f.position),y}):[];if(c!=="APPROVE"&&!i&&u.length===0)return JSON.stringify({error:"a COMMENT or REQUEST_CHANGES review needs a body and/or inline comments"});let l=new Set,p=null;try{for(let f=1;f<=20;f+=1){let y=await _(`/repos/${e}/${t}/pulls/${n}/comments?per_page=100&page=${f}`);if(!Array.isArray(y)||y.length===0)break;for(let k of y){let v=ye(k.body);v&&l.add(v)}if(y.length<100)break}for(let f=1;f<=20&&p==null;f+=1){let y=await _(`/repos/${e}/${t}/issues/${n}/comments?per_page=100&page=${f}`);if(!Array.isArray(y)||y.length===0)break;for(let k of y)if(fe(k.body)){p=k.id;break}if(y.length<100)break}}catch{}let m=!1,g=!1;if(i){let f=`${String(i)}${me}`;try{p!=null?(await _(`/repos/${e}/${t}/issues/comments/${p}`,{method:"PATCH",body:{body:f}}),m=!0):await _(`/repos/${e}/${t}/issues/${n}/comments`,{method:"POST",body:{body:f}}),g=!0}catch{}}let{toPost:d,skipped:b}=ge(u,l),h=d.map(({_fp:f,...y})=>y),S=null;if(h.length>0||c==="APPROVE"||c==="REQUEST_CHANGES"){let f={event:c};h.length>0&&(f.comments=h),h.length===0&&c==="REQUEST_CHANGES"&&(f.body="Changes requested \u2014 see the review summary comment."),S=await _(`/repos/${e}/${t}/pulls/${n}/reviews`,{method:"POST",body:f})}return JSON.stringify({ok:!0,id:S?S.id:void 0,state:S?S.state:void 0,event:c,notePosted:g,summaryUpdated:m,commentsPosted:h.length,inlineSkipped:b||void 0,url:S?S.html_url:void 0})}case"github_list_commits":{let{owner:e,repo:t,branch:n,path:i,limit:o,since:a,until:c,page:u}=s;if(!e||!t)return JSON.stringify({error:"owner and repo are required"});let l=Math.min(Number(o)||20,100),p=`/repos/${e}/${t}/commits?per_page=${l}&page=${Number(u)||1}`;n&&(p+=`&sha=${encodeURIComponent(n)}`),i&&(p+=`&path=${encodeURIComponent(i)}`),a&&(p+=`&since=${encodeURIComponent(a)}`),c&&(p+=`&until=${encodeURIComponent(c)}`);let m=await _(p);return JSON.stringify({total:m.length,page:Number(u)||1,hasMore:m.length>=l,commits:m.map(g=>({sha:g.sha?.slice(0,8),fullSha:g.sha,message:g.commit?.message?.slice(0,300),author:g.commit?.author?.name,authorEmail:g.commit?.author?.email,date:g.commit?.author?.date,url:g.html_url}))})}case"github_get_commit":{let{owner:e,repo:t,sha:n,includePrs:i}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and sha are required"});let o=await _(`/repos/${e}/${t}/commits/${n}`),a;if(i)try{let c=await _(`/repos/${e}/${t}/commits/${n}/pulls`);a=(Array.isArray(c)?c:[]).map(u=>({number:u.number,title:u.title,state:u.state,merged:!!u.merged_at,webUrl:u.html_url}))}catch{a=[]}return JSON.stringify({sha:o.sha?.slice(0,8),message:o.commit?.message,author:o.commit?.author?.name,date:o.commit?.author?.date,stats:o.stats,files:(o.files||[]).map(c=>({filename:c.filename,status:c.status,additions:c.additions,deletions:c.deletions,patch:c.patch?.slice(0,3e3)})),...a?{pullRequests:a}:{}})}case"github_get_file":{let{owner:e,repo:t,path:n,ref:i}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and path are required"});let o=`/repos/${e}/${t}/contents/${encodeURIComponent(n)}`;i&&(o+=`?ref=${encodeURIComponent(i)}`);let a=await _(o);if(a.type!=="file")return Array.isArray(a)?JSON.stringify({type:"directory",path:n,entries:a.map(l=>({name:l.name,type:l.type,size:l.size,path:l.path}))}):JSON.stringify({error:`Not a file: ${a.type}`});let c=Buffer.from(a.content||"","base64").toString("utf-8"),u=c.length>2e4;return JSON.stringify({path:a.path,size:a.size,sha:a.sha?.slice(0,8),content:u?c.slice(0,2e4):c,truncated:u})}case"github_get_user":try{let e=await _("/installation/repositories?per_page=1");if(e.repositories&&e.repositories.length>0){let t=e.repositories[0],n=t.owner.login,i=t.owner.type,o=i==="Organization"?`/orgs/${n}`:`/users/${n}`,a=await _(o);return JSON.stringify({login:a.login,name:a.name||a.login,avatar:a.avatar_url,bio:a.bio||a.description,type:i,isOrg:i==="Organization",publicRepos:a.public_repos,message:"Showing GitHub App installation owner (GitHub Apps cannot access /user endpoint)"})}return JSON.stringify({error:"No repositories accessible to this GitHub App installation"})}catch(e){return JSON.stringify({error:`GitHub App cannot access /user endpoint. Use github_list_repos instead. (${e.message})`})}case"github_list_orgs":try{let t=(await _("/installation/repositories?per_page=100")).repositories||[],n=new Map;for(let o of t)o.owner.type==="Organization"&&(n.has(o.owner.login)||n.set(o.owner.login,{login:o.owner.login,description:null,url:o.owner.url}));let i=Array.from(n.values());return JSON.stringify({count:i.length,orgs:i,message:"Extracted from accessible repositories (GitHub Apps cannot access /user/orgs directly)"})}catch(e){return JSON.stringify({error:`GitHub App cannot list orgs via /user/orgs. Error: ${e.message}`})}case"github_clone":{let d=function(f){let y=f.replace(/^~(?=$|\/|\\)/,g);return a(y)},{owner:e,repo:t,destination:n}=s;if(!e||!t)return JSON.stringify({error:"owner and repo are required"});let{execSync:i}=await import("child_process"),{join:o,resolve:a}=await import("path"),{existsSync:c,mkdirSync:u}=await import("fs"),{homedir:l,platform:p}=await import("os"),{token:m}=await he("github"),g=l(),b=n?d(n):o(g,"zibby-repos"),h=o(b,t);if(u(b,{recursive:!0}),c(h))return JSON.stringify({error:`Directory ${h} already exists. Remove it first or use a different destination.`,existingPath:h});let S=`https://x-access-token:${m}@github.com/${e}/${t}.git`;try{i(`git clone ${S} "${h}"`,{stdio:"pipe"});let f=`https://github.com/${e}/${t}.git`;pe(i,h,f,m,"github_clone");let y=p()==="win32",k;return y?k=i(`dir "${h}"`,{encoding:"utf-8",shell:"cmd.exe"}):k=i(`ls -la "${h}"`,{encoding:"utf-8"}),JSON.stringify({success:!0,path:h,message:`Cloned ${e}/${t} to ${h}`,contents:k.split(`
 `).slice(0,30).join(`
-`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(f){let k=String(f.message||f).split(m).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${k}`})}}case"github_search_repos":{let{query:e,limit:t}=s;if(!e)return JSON.stringify({error:"query is required"});let n=await this.handleToolCall("github_list_repos",{limit:200},{}),i=JSON.parse(n);if(i.error)return JSON.stringify(i);let o=e.toLowerCase(),a=i.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,t||20)})}case"github_list_repos":{let{owner:e,type:t,sort:n,direction:i,limit:o,query:a}=s,c=100,u=o||200,l=[],p=y=>({name:y.name,fullName:y.full_name,private:y.private,description:y.description,language:y.language,defaultBranch:y.default_branch,updatedAt:y.updated_at,stars:y.stargazers_count,url:y.html_url,fullPath:y.full_name,webUrl:y.html_url,visibility:y.visibility||(y.private?"private":"public")}),m=y=>{if(!a)return!0;let k=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(k)||y.fullName&&y.fullName.toLowerCase().includes(k)||y.description&&y.description.toLowerCase().includes(k)};if(!e){let y=1,k=!0;for(;k&&l.length<u;){let L=`/installation/repositories?per_page=${c}&page=${y}`,M=(await _(L)).repositories||[];if(M.length===0)break;l=l.concat(M),k=M.length===c,y++}let v=l.map(p).filter(m),P=v.slice(0,u),Ne=v.length>P.length,ne=P.filter(L=>L.private).length,oe=P.filter(L=>!L.private).length;return JSON.stringify({count:P.length,repos:P,truncated:Ne,privateCount:ne,publicCount:oe,message:`Found ${ne} private and ${oe} public repos`})}let g=await _(`/orgs/${e}`).then(()=>!0).catch(()=>!1),d=1,b=!0;for(;b&&l.length<u;){let y;g?y=`/orgs/${e}/repos?per_page=${c}&page=${d}&type=${t||"all"}&sort=${n||"updated"}&direction=${i||"desc"}`:y=`/users/${e}/repos?per_page=${c}&page=${d}&type=${t||"all"}&sort=${n||"updated"}&direction=${i||"desc"}`;let k=await _(y),v=Array.isArray(k)?k:[];if(v.length===0)break;l=l.concat(v),b=v.length===c,d++}let h=l.map(p).filter(m),S=h.slice(0,u),f=h.length>S.length;return JSON.stringify({count:S.length,repos:S,truncated:f})}case"github_create_pr":{let{owner:e,repo:t,head:n,title:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=s.base;if(!o)try{o=(await _(`/repos/${e}/${t}`)).default_branch||"main"}catch{o="main"}let a={title:String(i),head:String(n),base:String(o),body:s.body?String(s.body):"",draft:!!s.draft};try{let c=await _(`/repos/${e}/${t}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:n,base:o,repo:`${e}/${t}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let u=String(c.message||c);if(/GitHub API 422/.test(u))return JSON.stringify({success:!1,branch:n,base:o,repo:`${e}/${t}`,provider:"github",skippedReason:u});throw c}}case"github_merge_pr":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=s.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(i))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${i})`});let o={merge_method:i};s.commitTitle&&(o.commit_title=String(s.commitTitle)),s.commitMessage&&(o.commit_message=String(s.commitMessage));try{let a=await _(`/repos/${e}/${t}/pulls/${n}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:n,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:n,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:t,title:n,body:i}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and title are required"});let o=await _(`/repos/${e}/${t}/issues`,{method:"POST",body:{title:n,body:i||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:t,state:n,labels:i,since:o,assignee:a,sort:c,direction:u,limit:l}=s||{};if(!e||!t)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",n||"open"),p.set("per_page",String(l||30)),p.set("sort",c||"updated"),p.set("direction",u||"desc"),i&&p.set("labels",Array.isArray(i)?i.join(","):i),o&&p.set("since",o),a&&p.set("assignee",a);let m=await _(`/repos/${e}/${t}/issues?${p.toString()}`),g=(Array.isArray(m)?m:[]).filter(d=>!d.pull_request).map(d=>({number:d.number,title:d.title,state:d.state,labels:(d.labels||[]).map(b=>typeof b=="string"?b:b.name),assignee:d.assignee?.login||null,assignees:(d.assignees||[]).map(b=>b.login),user:d.user?.login,comments:d.comments,url:d.html_url,createdAt:d.created_at,updatedAt:d.updated_at}));return JSON.stringify({count:g.length,issues:g})}case"github_get_issue":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/issues/${n}`);return i.pull_request?JSON.stringify({error:`#${n} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:i.number,title:i.title,body:i.body||"",state:i.state,stateReason:i.state_reason||null,labels:(i.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:i.assignee?.login||null,assignees:(i.assignees||[]).map(o=>o.login),user:i.user?.login,milestone:i.milestone?.title||null,comments:i.comments,url:i.html_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:t,number:n,limit:i}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let o=await _(`/repos/${e}/${t}/issues/${n}/comments?per_page=${i||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:t,number:n,body:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await _(`/repos/${e}/${t}/issues/${n}/comments`,{method:"POST",body:{body:i}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:t,number:n,stateReason:i}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};i&&(o.state_reason=i);let a=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:i.number,state:i.state,url:i.html_url})}case"github_label_issue":{let{owner:e,repo:t,number:n,labels:i,mode:o}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(i)?i:i?[i]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let l=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await _(`/repos/${e}/${t}/issues/${n}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await _(`/repos/${e}/${t}/issues/${n}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let u=await _(`/repos/${e}/${t}/issues/${n}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:n,labels:(Array.isArray(u)?u:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). Optionally filtered by file path.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};var Se=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i,ke=/\b(in[\s-]?progress|wip|doing|started|in[\s-]?review|review)\b/i,lt=/\b(done|closed|complete|completed|resolved|fixed|merged|shipped)\b/i,pt=/\b(todo|to[\s-]?do|open|backlog|reopen|new)\b/i,be="in progress",_e="blocked";function Ae(r,s=[]){if(r==="closed")return"done";if(r!=="open")return"unknown";let e=(s||[]).map(String);return e.some(t=>Se.test(t))?"blocked":e.some(t=>ke.test(t))?"in_progress":"todo"}function C(r={}){let s=r.owner||process.env.GITHUB_OWNER,e=r.repo||process.env.GITHUB_REPO;if(!s||!e)throw new Error("GitHub scope missing: provide {owner, repo} via ctx or env GITHUB_OWNER / GITHUB_REPO.");return{owner:s,repo:e}}function N(r){let s=JSON.parse(r);if(s&&s.error)throw new Error(s.error);return s}function ee(r,s={}){let e=r.labels||[],t=r.number,n=s.owner&&s.repo?`${s.owner}/${s.repo}#${t}`:`#${t}`;return{id:String(t),key:n,title:r.title||"",body:r.body||"",state:r.state||null,stateCategory:Ae(r.state,e),assignee:r.assignee||r.assignees&&r.assignees[0]||null,url:r.url||null,_raw:r}}var te={id:"github",toStateCategory:Ae,toNeutral:ee,IN_PROGRESS_LABEL:be,BLOCKED_LABEL:_e,async listCandidates(r={}){let s=r.ctx||{},{owner:e,repo:t}=C(s);return(N(await R.handleToolCall("github_list_issues",{owner:e,repo:t,state:r.state||"open",labels:r.labels,since:r.updatedAfter,limit:r.limit})).issues||[]).map(i=>ee(i,{owner:e,repo:t}))},async getTicket(r,s={}){let{owner:e,repo:t}=C(s),n=G(r);if(n==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);let i=JSON.parse(await R.handleToolCall("github_get_issue",{owner:e,repo:t,number:n}));return i.error?null:ee(i,{owner:e,repo:t})},async getComments(r,s={}){let{owner:e,repo:t}=C(s),n=G(r);if(n==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);return(N(await R.handleToolCall("github_get_issue_comments",{owner:e,repo:t,number:n})).comments||[]).map(o=>({id:String(o.id),author:o.user||"Unknown",body:o.body||"",createdAt:o.createdAt||null,updatedAt:o.updatedAt||null,_raw:o})).sort((o,a)=>String(a.createdAt).localeCompare(String(o.createdAt)))},async addComment(r,s,e={}){let{owner:t,repo:n}=C(e),i=G(r);if(i==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);if(!s)throw new Error("body is required");let o=N(await R.handleToolCall("github_add_issue_comment",{owner:t,repo:n,number:i,body:s}));return{ok:!!o.ok,id:o.id?String(o.id):null}},async transition(r,s,e={}){let{owner:t,repo:n}=C(e),i=G(r);if(i==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);let o=String(s||"");if(lt.test(o)){let a=N(await R.handleToolCall("github_close_issue",{owner:t,repo:n,number:i,stateReason:"completed"}));return{ok:!!a.ok,stateAfter:a.state||"closed",stateCategoryAfter:"done",_raw:a}}if(Se.test(o)){await we(t,n,i);let a=N(await R.handleToolCall("github_label_issue",{owner:t,repo:n,number:i,labels:[_e],mode:"add"}));return{ok:!!a.ok,stateAfter:"open",stateCategoryAfter:"blocked",via:"label",_raw:a}}if(ke.test(o)){await we(t,n,i);let a=N(await R.handleToolCall("github_label_issue",{owner:t,repo:n,number:i,labels:[be],mode:"add"}));return{ok:!!a.ok,stateAfter:"open",stateCategoryAfter:"in_progress",via:"label",_raw:a}}if(pt.test(o)){let a=N(await R.handleToolCall("github_reopen_issue",{owner:t,repo:n,number:i}));return{ok:!!a.ok,stateAfter:a.state||"open",stateCategoryAfter:"todo",_raw:a}}return{ok:!1,error:`GitHub issues have no "${s}" state. Representable targets: open/todo, in progress, blocked, done/closed.`}},async linkPullRequest(r,s,e,t={}){let{owner:n,repo:i}=C(t),o=G(r);if(o==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);if(!s)throw new Error("prUrl is required");let a=`${e?`${e}: `:"Linked PR: "}${s}`;return{ok:!!N(await R.handleToolCall("github_add_issue_comment",{owner:n,repo:i,number:o,body:a})).ok,via:"comment"}}};async function we(r,s,e){await R.handleToolCall("github_reopen_issue",{owner:r,repo:s,number:e})}function G(r){if(r==null)return null;if(typeof r=="number")return r;let s=/(\d+)\s*$/.exec(String(r));return s?Number(s[1]):null}var ut=(process.env.PLANE_API_URL||"https://api.plane.so/api/v1").replace(/\/+$/,""),dt=process.env.PLANE_WORKSPACE_SLUG||"",mt=process.env.PLANE_PROJECT_ID||"";function yt(){let r=process.env.PLANE_API_KEY||process.env.PLANE_OAUTH_TOKEN;if(!r)throw new Error("Plane is not connected: set PLANE_API_KEY (personal access token).");return r}function j(r={}){let s=r.workspaceSlug||dt,e=r.projectId||mt;if(!s||!e)throw new Error("Plane scope missing: provide workspaceSlug + projectId (env PLANE_WORKSPACE_SLUG / PLANE_PROJECT_ID or per-call ctx).");return{workspaceSlug:s,projectId:e}}async function O(r,s={}){let e=`${ut}${r}`;if(s.query&&Object.keys(s.query).length){let i=new URLSearchParams;for(let[a,c]of Object.entries(s.query))c!=null&&c!==""&&i.set(a,String(c));let o=i.toString();o&&(e+=(e.includes("?")?"&":"?")+o)}let t=await fetch(e,{method:s.method||"GET",headers:{"X-API-Key":yt(),Accept:"application/json",...s.body?{"Content-Type":"application/json"}:{},...s.headers},body:s.body?JSON.stringify(s.body):void 0});if(!t.ok){let i=await t.text().catch(()=>"");throw new Error(`Plane API ${t.status}: ${i.slice(0,300)}`)}let n=await t.text().catch(()=>"");if(!n||!n.trim())return{};try{return JSON.parse(n)}catch{return{raw:n}}}var ft={backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",cancelled:"done"},gt=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function se(r){return r?r.name&&gt.test(r.name)?"blocked":ft[r.group]||"unknown":"unknown"}var Re=new Map,ht=300*1e3;async function $e(r){let{workspaceSlug:s,projectId:e}=j(r),t=Re.get(e);if(t&&Date.now()-t.fetchedAt<ht)return t.states;let n=await O(`/workspaces/${encodeURIComponent(s)}/projects/${encodeURIComponent(e)}/states/`,{query:{per_page:100}}),i=(n.results||n||[]).map(o=>({id:o.id,name:o.name,group:o.group,color:o.color}));return Re.set(e,{fetchedAt:Date.now(),states:i}),i}function re(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function bt(r,s){let e=re(s);if(!e)return null;let t=r.find(i=>re(i.name)===e);if(t)return t;let n={todo:["todo","backlog","open","unstarted"],inprogress:["inprogress","started","doing","wip"],done:["done","completed","closed","resolved","cancelled","canceled"],blocked:["blocked","onhold","waiting"]};for(let[,i]of Object.entries(n)){if(!i.some(c=>re(c)===e))continue;let o=e==="done"?"completed":e==="inprogress"?"started":"unstarted",a=r.find(c=>c.group===o);if(a)return a}return null}async function ve(r,s){let t=(await $e(s).catch(()=>[])).find(c=>c.id===r.state)||null,{workspaceSlug:n,projectId:i}=j(s),o=s.projectIdentifier&&r.sequence_id!=null?`${s.projectIdentifier}-${r.sequence_id}`:r.sequence_id!=null?String(r.sequence_id):r.id,a=r.assignees||[];return{id:r.id,key:o,title:r.name||"",body:r.description_html||r.description_stripped||r.description||"",state:t?t.name:null,stateCategory:se(t),assignee:a.length?String(a[0]):null,url:s.baseWebUrl?`${s.baseWebUrl}/${n}/projects/${i}/issues/${r.id}`:null,_raw:r}}var ie={id:"plane",envKeys:["PLANE_API_KEY","PLANE_OAUTH_TOKEN","PLANE_API_URL","PLANE_WORKSPACE_SLUG","PLANE_PROJECT_ID"],planeFetch:O,toStateCategory:se,async listCandidates(r={}){let s=r.ctx||{},{workspaceSlug:e,projectId:t}=j(s),n={per_page:Math.min(Number(r.limit)||50,100),cursor:r.cursor};r.state&&(n.state=r.state),r.updatedAfter&&(n.updated_at__gte=r.updatedAfter);let o=(await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/`,{query:n})).results||[];return r.updatedAfter&&(o=o.filter(a=>String(a.updated_at)>String(r.updatedAfter))),Promise.all(o.map(a=>ve(a,s)))},async getTicket(r,s={}){let{workspaceSlug:e,projectId:t}=j(s),n=await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/${encodeURIComponent(r)}/`);return!n||!n.id?null:ve(n,s)},async getComments(r,s={}){let{workspaceSlug:e,projectId:t}=j(s);return((await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/${encodeURIComponent(r)}/comments/`,{query:{per_page:100}})).results||[]).map(o=>({id:o.id,author:o.actor||o.actor_detail?.display_name||"Unknown",body:o.comment_html||o.comment_stripped||"",createdAt:o.created_at||null,updatedAt:o.updated_at||null,_raw:o})).sort((o,a)=>String(a.createdAt).localeCompare(String(o.createdAt)))},async addComment(r,s,e={}){let{workspaceSlug:t,projectId:n}=j(e),o=/<[a-z][\s\S]*>/i.test(String(s||""))?String(s):`<p>${String(s||"")}</p>`,a=await O(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(n)}/work-items/${encodeURIComponent(r)}/comments/`,{method:"POST",body:{comment_html:o}});return{ok:!!a.id,id:a.id||null,_raw:a}},async transition(r,s,e={}){let{workspaceSlug:t,projectId:n}=j(e),i=await $e(e),o=bt(i,s);if(!o)return{ok:!1,error:`No Plane state matches "${s}" in this project`,availableStates:i.map(c=>({id:c.id,name:c.name,group:c.group}))};let a=await O(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(n)}/work-items/${encodeURIComponent(r)}/`,{method:"PATCH",body:{state:o.id}});return{ok:!!a.id,stateAfter:o.name,stateCategoryAfter:se(o),_raw:a}},async linkPullRequest(r,s,e,t={}){let n=e?`${e}: `:"Linked PR: ";return{ok:!!(await this.addComment(r,`<p>${n}<a href="${s}">${s}</a></p>`,t)).ok,via:"comment"}}};var _t=["todo","in_progress","done","blocked","unknown"];var Ie={jira:Q,linear:X,github:te,plane:ie},wt="jira";function fr(r){let s=String(r||process.env.TRACKER_PROVIDER||wt).trim().toLowerCase(),e=Ie[s];if(!e){let t=Object.keys(Ie).join(", ");throw new Error(`Unknown tracker provider "${s}". Known providers: ${t}.`)}return e}export{wt as DEFAULT_TRACKER_PROVIDER,Ie as TRACKER_ADAPTERS,_t as TRACKER_STATE_CATEGORIES,fr as getAdapter,te as githubAdapter,Q as jiraAdapter,X as linearAdapter,ie as planeAdapter};
+`),instructions:"IMPORTANT: Show the contents field to the user - it contains the directory listing."})}catch(f){let k=String(f.message||f).split(m).join("***").replace(/x-access-token:[^@]*@/g,"x-access-token:***@");return JSON.stringify({error:`Clone failed: ${k}`})}}case"github_search_repos":{let{query:e,limit:t}=s;if(!e)return JSON.stringify({error:"query is required"});let n=await this.handleToolCall("github_list_repos",{limit:200},{}),i=JSON.parse(n);if(i.error)return JSON.stringify(i);let o=e.toLowerCase(),a=i.repos.filter(c=>c.name.toLowerCase().includes(o)||c.fullName.toLowerCase().includes(o)||c.description&&c.description.toLowerCase().includes(o));return JSON.stringify({query:e,count:a.length,repos:a.slice(0,t||20)})}case"github_list_repos":{let{owner:e,type:t,sort:n,direction:i,limit:o,query:a}=s,c=100,u=o||200,l=[],p=y=>({name:y.name,fullName:y.full_name,private:y.private,description:y.description,language:y.language,defaultBranch:y.default_branch,updatedAt:y.updated_at,stars:y.stargazers_count,url:y.html_url,fullPath:y.full_name,webUrl:y.html_url,visibility:y.visibility||(y.private?"private":"public")}),m=y=>{if(!a)return!0;let k=String(a).toLowerCase();return y.name&&y.name.toLowerCase().includes(k)||y.fullName&&y.fullName.toLowerCase().includes(k)||y.description&&y.description.toLowerCase().includes(k)};if(!e){let y=1,k=!0;for(;k&&l.length<u;){let L=`/installation/repositories?per_page=${c}&page=${y}`,M=(await _(L)).repositories||[];if(M.length===0)break;l=l.concat(M),k=M.length===c,y++}let v=l.map(p).filter(m),P=v.slice(0,u),Ne=v.length>P.length,ne=P.filter(L=>L.private).length,oe=P.filter(L=>!L.private).length;return JSON.stringify({count:P.length,repos:P,truncated:Ne,privateCount:ne,publicCount:oe,message:`Found ${ne} private and ${oe} public repos`})}let g=await _(`/orgs/${e}`).then(()=>!0).catch(()=>!1),d=1,b=!0;for(;b&&l.length<u;){let y;g?y=`/orgs/${e}/repos?per_page=${c}&page=${d}&type=${t||"all"}&sort=${n||"updated"}&direction=${i||"desc"}`:y=`/users/${e}/repos?per_page=${c}&page=${d}&type=${t||"all"}&sort=${n||"updated"}&direction=${i||"desc"}`;let k=await _(y),v=Array.isArray(k)?k:[];if(v.length===0)break;l=l.concat(v),b=v.length===c,d++}let h=l.map(p).filter(m),S=h.slice(0,u),f=h.length>S.length;return JSON.stringify({count:S.length,repos:S,truncated:f})}case"github_create_pr":{let{owner:e,repo:t,head:n,title:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, head (source branch), and title are required"});let o=s.base;if(!o)try{o=(await _(`/repos/${e}/${t}`)).default_branch||"main"}catch{o="main"}let a={title:String(i),head:String(n),base:String(o),body:s.body?String(s.body):"",draft:!!s.draft};try{let c=await _(`/repos/${e}/${t}/pulls`,{method:"POST",body:a});return JSON.stringify({success:!0,pr_url:c.html_url,number:c.number,branch:n,base:o,repo:`${e}/${t}`,provider:"github",draft:!!c.draft,state:c.state})}catch(c){let u=String(c.message||c);if(/GitHub API 422/.test(u))return JSON.stringify({success:!1,branch:n,base:o,repo:`${e}/${t}`,provider:"github",skippedReason:u});throw c}}case"github_merge_pr":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=s.mergeMethod||"squash";if(!["merge","squash","rebase"].includes(i))return JSON.stringify({error:`mergeMethod must be merge, squash, or rebase (got ${i})`});let o={merge_method:i};s.commitTitle&&(o.commit_title=String(s.commitTitle)),s.commitMessage&&(o.commit_message=String(s.commitMessage));try{let a=await _(`/repos/${e}/${t}/pulls/${n}/merge`,{method:"PUT",body:o});return JSON.stringify({success:!0,merged:!0,sha:a.sha,number:n,provider:"github"})}catch(a){let c=String(a.message||a);if(/GitHub API (405|409|404)/.test(c))return JSON.stringify({success:!1,number:n,provider:"github",skippedReason:c});throw a}}case"github_create_issue":{let{owner:e,repo:t,title:n,body:i}=s;if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and title are required"});let o=await _(`/repos/${e}/${t}/issues`,{method:"POST",body:{title:n,body:i||""}});return JSON.stringify({number:o.number,url:o.html_url,title:o.title})}case"github_list_issues":{let{owner:e,repo:t,state:n,labels:i,since:o,assignee:a,sort:c,direction:u,limit:l}=s||{};if(!e||!t)return JSON.stringify({error:"owner and repo are required"});let p=new URLSearchParams;p.set("state",n||"open"),p.set("per_page",String(l||30)),p.set("sort",c||"updated"),p.set("direction",u||"desc"),i&&p.set("labels",Array.isArray(i)?i.join(","):i),o&&p.set("since",o),a&&p.set("assignee",a);let m=await _(`/repos/${e}/${t}/issues?${p.toString()}`),g=(Array.isArray(m)?m:[]).filter(d=>!d.pull_request).map(d=>({number:d.number,title:d.title,state:d.state,labels:(d.labels||[]).map(b=>typeof b=="string"?b:b.name),assignee:d.assignee?.login||null,assignees:(d.assignees||[]).map(b=>b.login),user:d.user?.login,comments:d.comments,url:d.html_url,createdAt:d.created_at,updatedAt:d.updated_at}));return JSON.stringify({count:g.length,issues:g})}case"github_get_issue":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/issues/${n}`);return i.pull_request?JSON.stringify({error:`#${n} is a pull request, not an issue`,isPR:!0}):JSON.stringify({number:i.number,title:i.title,body:i.body||"",state:i.state,stateReason:i.state_reason||null,labels:(i.labels||[]).map(o=>typeof o=="string"?o:o.name),assignee:i.assignee?.login||null,assignees:(i.assignees||[]).map(o=>o.login),user:i.user?.login,milestone:i.milestone?.title||null,comments:i.comments,url:i.html_url,createdAt:i.created_at,updatedAt:i.updated_at,closedAt:i.closed_at})}case"github_get_issue_comments":{let{owner:e,repo:t,number:n,limit:i}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let o=await _(`/repos/${e}/${t}/issues/${n}/comments?per_page=${i||100}`),a=(Array.isArray(o)?o:[]).map(c=>({id:c.id,user:c.user?.login,body:c.body||"",createdAt:c.created_at,updatedAt:c.updated_at,url:c.html_url}));return JSON.stringify({count:a.length,comments:a})}case"github_add_issue_comment":{let{owner:e,repo:t,number:n,body:i}=s||{};if(!e||!t||!n||!i)return JSON.stringify({error:"owner, repo, number, and body are required"});let o=await _(`/repos/${e}/${t}/issues/${n}/comments`,{method:"POST",body:{body:i}});return JSON.stringify({ok:!0,id:o.id,url:o.html_url})}case"github_close_issue":{let{owner:e,repo:t,number:n,stateReason:i}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let o={state:"closed"};i&&(o.state_reason=i);let a=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:o});return JSON.stringify({ok:!0,number:a.number,state:a.state,stateReason:a.state_reason||null,url:a.html_url})}case"github_reopen_issue":{let{owner:e,repo:t,number:n}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let i=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:{state:"open"}});return JSON.stringify({ok:!0,number:i.number,state:i.state,url:i.html_url})}case"github_label_issue":{let{owner:e,repo:t,number:n,labels:i,mode:o}=s||{};if(!e||!t||!n)return JSON.stringify({error:"owner, repo, and number are required"});let a=Array.isArray(i)?i:i?[i]:[];if(!a.length)return JSON.stringify({error:"labels (string or array) is required"});let c=o||"add";if(c==="set"){let l=await _(`/repos/${e}/${t}/issues/${n}`,{method:"PATCH",body:{labels:a}});return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}if(c==="remove"){for(let p of a)await _(`/repos/${e}/${t}/issues/${n}/labels/${encodeURIComponent(p)}`,{method:"DELETE"});let l=await _(`/repos/${e}/${t}/issues/${n}`);return JSON.stringify({ok:!0,number:l.number,labels:(l.labels||[]).map(p=>typeof p=="string"?p:p.name)})}let u=await _(`/repos/${e}/${t}/issues/${n}/labels`,{method:"POST",body:{labels:a}});return JSON.stringify({ok:!0,number:n,labels:(Array.isArray(u)?u:[]).map(l=>typeof l=="string"?l:l.name)})}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"github_get_user",description:"Get the authenticated GitHub user profile and their organizations",input_schema:{type:"object",properties:{}}},{name:"github_list_orgs",description:"List GitHub organizations the authenticated user belongs to",input_schema:{type:"object",properties:{}}},{name:"github_list_repos",description:"List the repositories this token/installation can access (omit owner) \u2014 or a specific user/org's repos (pass owner). Use this to discover a RELATED repo worth cloning when a change's correctness depends on another accessible repo. Each repo carries a normalized { fullPath, name, webUrl, defaultBranch, visibility } shape (identical to gitlab_list_projects) alongside legacy fields, plus a truncated flag.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Org or user login. Omit to list every repo your token/installation can access."},query:{type:"string",description:"Optional term matched against repo name/full-name/description"},type:{type:"string",enum:["all","public","private","forks","sources","member"],description:"Filter by type (default: all)"},sort:{type:"string",enum:["created","updated","pushed","full_name"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max repos to return (default: 200, hard-capped at the fetch ceiling)"}}}},{name:"github_clone",description:'Clone a GitHub repository to the local filesystem. Use when user says "check out" or "clone" a repo.',input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner (user or org name)"},repo:{type:"string",description:"Repository name"},destination:{type:"string",description:"Destination directory. Accepts absolute paths, ~-prefixed paths, or relative names. Defaults to ~/zibby-repos/<repo>."}},required:["owner","repo"]}},{name:"github_search_repos",description:"Search accessible repositories by name or description. Use this when the user asks to find a specific repo.",input_schema:{type:"object",properties:{query:{type:"string",description:'Search term to match against repo name or description (e.g., "electron", "my-app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_issues",description:"Search GitHub issues and pull requests",input_schema:{type:"object",properties:{query:{type:"string",description:'GitHub search query (e.g. "SCRUM-123", "login bug repo:org/app")'},limit:{type:"number",description:"Max results (default: 20)"}},required:["query"]}},{name:"github_search_code",description:"Search code across GitHub repositories by keyword",input_schema:{type:"object",properties:{query:{type:"string",description:'Code search query (e.g. "handleLogin", "class AuthService")'},repo:{type:"string",description:'Scope to a specific repo (e.g. "org/app"). Optional.'},language:{type:"string",description:'Filter by language (e.g. "javascript", "python"). Optional.'},limit:{type:"number",description:"Max results (default: 15)"}},required:["query"]}},{name:"github_get_pr",description:"Get details of a pull request \u2014 title, description, branch, stats",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_pr_diff",description:"Get the unified diff of a pull request \u2014 the actual code changes",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_files",description:"List files changed in a PR with per-file patches",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_list_pr_comments",description:"Get all review and issue comments on a PR",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"}},required:["owner","repo","number"]}},{name:"github_get_review_thread",description:"Read a PR review-comment THREAD given any comment id in it: the root review comment + all its replies, plus the anchored diff context (file, line, the original diff hunk). Use this to understand a human's reply to a previous review comment before replying in-thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread (the root or any reply)"}},required:["owner","repo","number","commentId"]}},{name:"github_reply_review_thread",description:"Reply IN-THREAD to an existing PR review-comment thread (a conversational reply nested under the thread the human commented on \u2014 NOT a fresh full review). Pass any comment id in the thread.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},commentId:{type:"number",description:"Any review-comment id in the thread to reply to"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","commentId","body"]}},{name:"github_reply_issue_comment",description:"Post a reply on a PR's top-level conversation (a new issue comment on the PR). Use when the human replied to a non-inline/summary comment rather than an inline review thread. Quote or @-mention for context since issue comments are not threaded.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The reply text (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_create_review",description:"Post a review on a pull request: a summary body plus optional inline comments anchored to file/line, with an event (COMMENT, APPROVE, or REQUEST_CHANGES). Use this to deliver a code review back to the PR.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number"},body:{type:"string",description:"The review summary (markdown). Shown as the top-level review comment."},event:{type:"string",enum:["COMMENT","APPROVE","REQUEST_CHANGES"],description:"Review verdict. Default COMMENT (no approval state). Use REQUEST_CHANGES for blocking issues."},comments:{type:"array",description:"Optional inline comments, each anchored to a changed line.",items:{type:"object",properties:{path:{type:"string",description:"File path as it appears in the diff"},line:{type:"number",description:"Line number in the file's NEW version (the right side of the diff)"},side:{type:"string",enum:["LEFT","RIGHT"],description:"RIGHT (new) or LEFT (old). Default RIGHT."},body:{type:"string",description:"The inline comment text (markdown)"}},required:["path","line","body"]}}},required:["owner","repo","number"]}},{name:"github_list_commits",description:"List commits on a branch \u2014 optionally bounded by since/until ISO dates (date-window listing) and paginated (keep calling with page+1 while hasMore is true). Optionally filtered by file path.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},branch:{type:"string",description:"Branch name (default: repo default branch)"},path:{type:"string",description:"Filter commits touching this file path"},limit:{type:"number",description:"Commits per page, max 100 (default: 20)"},since:{type:"string",description:'Only commits after this ISO-8601 date/time, e.g. "2026-01-01T00:00:00Z"'},until:{type:"string",description:"Only commits before this ISO-8601 date/time"},page:{type:"number",description:"Page number, 1-based (default 1)"}},required:["owner","repo"]}},{name:"github_get_commit",description:"Get details of a specific commit \u2014 message, stats, file diffs",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},sha:{type:"string",description:"Commit SHA (full or short)"},includePrs:{type:"boolean",description:"Also return the pull request(s) containing this commit ({number,title,state,merged,webUrl}) \u2014 the evidence link for contribution records (default false)"}},required:["owner","repo","sha"]}},{name:"github_get_file",description:"Read a file (or list a directory) from a GitHub repo. Works on any branch/ref.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},path:{type:"string",description:'File or directory path (e.g. "src/auth/login.ts")'},ref:{type:"string",description:"Branch, tag, or commit SHA (default: repo default branch)"}},required:["owner","repo","path"]}},{name:"github_create_pr",description:"Open a pull request on GitHub (POST /repos/{owner}/{repo}/pulls). The head (source) branch must already be pushed. Returns the REAL pr_url from GitHub \u2014 never fabricate a PR url. Expected business outcomes (no commits between base and head, a PR already exists for this branch, base==head, missing head) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},head:{type:"string",description:'Source branch to merge FROM (must already be pushed). For a cross-fork PR use "fork-owner:branch".'},base:{type:"string",description:"Target branch to merge INTO (default: the repo's default branch)"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description (markdown)"},draft:{type:"boolean",description:"Open as a draft PR (default: false)"}},required:["owner","repo","head","title"]}},{name:"github_merge_pr",description:"Merge a pull request on GitHub (PUT /repos/{owner}/{repo}/pulls/{number}/merge). mergeMethod is merge | squash | rebase (default squash). Returns { success:true, merged:true, sha } with the REAL merge SHA from GitHub. Expected non-mergeable outcomes (405 = draft / failing checks / branch protection, 409 = head sha moved / conflict, 404 = not found) return { success:false, skippedReason } rather than erroring.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"PR number to merge"},mergeMethod:{type:"string",enum:["merge","squash","rebase"],description:"How to merge (default: squash)"},commitTitle:{type:"string",description:"Title for the merge/squash commit (optional)"},commitMessage:{type:"string",description:"Body for the merge/squash commit (optional)"}},required:["owner","repo","number"]}},{name:"github_create_issue",description:"Create a GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},title:{type:"string",description:"Issue title"},body:{type:"string",description:"Issue body (markdown)"}},required:["owner","repo","title"]}},{name:"github_list_issues",description:"List issues in a repo (excludes pull requests). Filter by state, labels, and an updated-since cursor for polling.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},state:{type:"string",enum:["open","closed","all"],description:"Filter by state (default: open)"},labels:{type:"array",items:{type:"string"},description:"Only issues carrying ALL of these labels"},since:{type:"string",description:"ISO-8601 timestamp; only issues updated at/after this (polling cursor)"},assignee:{type:"string",description:'Filter by assignee login, "none", or "*"'},sort:{type:"string",enum:["created","updated","comments"],description:"Sort field (default: updated)"},direction:{type:"string",enum:["asc","desc"],description:"Sort direction (default: desc)"},limit:{type:"number",description:"Max issues (default: 30, max 100 per page)"}},required:["owner","repo"]}},{name:"github_get_issue",description:"Get a single GitHub issue with full detail (title, body, state, labels, assignee, url)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_get_issue_comments",description:"Get the comment thread on a GitHub issue (chronological)",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},limit:{type:"number",description:"Max comments (default: 100)"}},required:["owner","repo","number"]}},{name:"github_add_issue_comment",description:"Add a comment to a GitHub issue. Also the way to record a PR link on an issue (post a markdown link).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},body:{type:"string",description:"Comment body (markdown)"}},required:["owner","repo","number","body"]}},{name:"github_close_issue",description:"Close a GitHub issue. Optionally set the close reason (completed or not_planned).",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},stateReason:{type:"string",enum:["completed","not_planned"],description:"Why the issue was closed (optional)"}},required:["owner","repo","number"]}},{name:"github_reopen_issue",description:"Reopen a closed GitHub issue",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"}},required:["owner","repo","number"]}},{name:"github_label_issue",description:"Add, set (replace all), or remove labels on a GitHub issue. Labels back state-like transitions on GitHub.",input_schema:{type:"object",properties:{owner:{type:"string",description:"Repository owner"},repo:{type:"string",description:"Repository name"},number:{type:"number",description:"Issue number"},labels:{type:"array",items:{type:"string"},description:"Label name(s)"},mode:{type:"string",enum:["add","set","remove"],description:"add appends, set replaces all, remove deletes (default: add)"}},required:["owner","repo","number","labels"]}}]};var Se=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i,ke=/\b(in[\s-]?progress|wip|doing|started|in[\s-]?review|review)\b/i,lt=/\b(done|closed|complete|completed|resolved|fixed|merged|shipped)\b/i,pt=/\b(todo|to[\s-]?do|open|backlog|reopen|new)\b/i,be="in progress",_e="blocked";function Ae(r,s=[]){if(r==="closed")return"done";if(r!=="open")return"unknown";let e=(s||[]).map(String);return e.some(t=>Se.test(t))?"blocked":e.some(t=>ke.test(t))?"in_progress":"todo"}function C(r={}){let s=r.owner||process.env.GITHUB_OWNER,e=r.repo||process.env.GITHUB_REPO;if(!s||!e)throw new Error("GitHub scope missing: provide {owner, repo} via ctx or env GITHUB_OWNER / GITHUB_REPO.");return{owner:s,repo:e}}function N(r){let s=JSON.parse(r);if(s&&s.error)throw new Error(s.error);return s}function ee(r,s={}){let e=r.labels||[],t=r.number,n=s.owner&&s.repo?`${s.owner}/${s.repo}#${t}`:`#${t}`;return{id:String(t),key:n,title:r.title||"",body:r.body||"",state:r.state||null,stateCategory:Ae(r.state,e),assignee:r.assignee||r.assignees&&r.assignees[0]||null,url:r.url||null,_raw:r}}var te={id:"github",toStateCategory:Ae,toNeutral:ee,IN_PROGRESS_LABEL:be,BLOCKED_LABEL:_e,async listCandidates(r={}){let s=r.ctx||{},{owner:e,repo:t}=C(s);return(N(await R.handleToolCall("github_list_issues",{owner:e,repo:t,state:r.state||"open",labels:r.labels,since:r.updatedAfter,limit:r.limit})).issues||[]).map(i=>ee(i,{owner:e,repo:t}))},async getTicket(r,s={}){let{owner:e,repo:t}=C(s),n=G(r);if(n==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);let i=JSON.parse(await R.handleToolCall("github_get_issue",{owner:e,repo:t,number:n}));return i.error?null:ee(i,{owner:e,repo:t})},async getComments(r,s={}){let{owner:e,repo:t}=C(s),n=G(r);if(n==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);return(N(await R.handleToolCall("github_get_issue_comments",{owner:e,repo:t,number:n})).comments||[]).map(o=>({id:String(o.id),author:o.user||"Unknown",body:o.body||"",createdAt:o.createdAt||null,updatedAt:o.updatedAt||null,_raw:o})).sort((o,a)=>String(a.createdAt).localeCompare(String(o.createdAt)))},async addComment(r,s,e={}){let{owner:t,repo:n}=C(e),i=G(r);if(i==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);if(!s)throw new Error("body is required");let o=N(await R.handleToolCall("github_add_issue_comment",{owner:t,repo:n,number:i,body:s}));return{ok:!!o.ok,id:o.id?String(o.id):null}},async transition(r,s,e={}){let{owner:t,repo:n}=C(e),i=G(r);if(i==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);let o=String(s||"");if(lt.test(o)){let a=N(await R.handleToolCall("github_close_issue",{owner:t,repo:n,number:i,stateReason:"completed"}));return{ok:!!a.ok,stateAfter:a.state||"closed",stateCategoryAfter:"done",_raw:a}}if(Se.test(o)){await we(t,n,i);let a=N(await R.handleToolCall("github_label_issue",{owner:t,repo:n,number:i,labels:[_e],mode:"add"}));return{ok:!!a.ok,stateAfter:"open",stateCategoryAfter:"blocked",via:"label",_raw:a}}if(ke.test(o)){await we(t,n,i);let a=N(await R.handleToolCall("github_label_issue",{owner:t,repo:n,number:i,labels:[be],mode:"add"}));return{ok:!!a.ok,stateAfter:"open",stateCategoryAfter:"in_progress",via:"label",_raw:a}}if(pt.test(o)){let a=N(await R.handleToolCall("github_reopen_issue",{owner:t,repo:n,number:i}));return{ok:!!a.ok,stateAfter:a.state||"open",stateCategoryAfter:"todo",_raw:a}}return{ok:!1,error:`GitHub issues have no "${s}" state. Representable targets: open/todo, in progress, blocked, done/closed.`}},async linkPullRequest(r,s,e,t={}){let{owner:n,repo:i}=C(t),o=G(r);if(o==null)throw new Error(`Cannot parse GitHub issue number from "${r}"`);if(!s)throw new Error("prUrl is required");let a=`${e?`${e}: `:"Linked PR: "}${s}`;return{ok:!!N(await R.handleToolCall("github_add_issue_comment",{owner:n,repo:i,number:o,body:a})).ok,via:"comment"}}};async function we(r,s,e){await R.handleToolCall("github_reopen_issue",{owner:r,repo:s,number:e})}function G(r){if(r==null)return null;if(typeof r=="number")return r;let s=/(\d+)\s*$/.exec(String(r));return s?Number(s[1]):null}var ut=(process.env.PLANE_API_URL||"https://api.plane.so/api/v1").replace(/\/+$/,""),dt=process.env.PLANE_WORKSPACE_SLUG||"",mt=process.env.PLANE_PROJECT_ID||"";function yt(){let r=process.env.PLANE_API_KEY||process.env.PLANE_OAUTH_TOKEN;if(!r)throw new Error("Plane is not connected: set PLANE_API_KEY (personal access token).");return r}function j(r={}){let s=r.workspaceSlug||dt,e=r.projectId||mt;if(!s||!e)throw new Error("Plane scope missing: provide workspaceSlug + projectId (env PLANE_WORKSPACE_SLUG / PLANE_PROJECT_ID or per-call ctx).");return{workspaceSlug:s,projectId:e}}async function O(r,s={}){let e=`${ut}${r}`;if(s.query&&Object.keys(s.query).length){let i=new URLSearchParams;for(let[a,c]of Object.entries(s.query))c!=null&&c!==""&&i.set(a,String(c));let o=i.toString();o&&(e+=(e.includes("?")?"&":"?")+o)}let t=await fetch(e,{method:s.method||"GET",headers:{"X-API-Key":yt(),Accept:"application/json",...s.body?{"Content-Type":"application/json"}:{},...s.headers},body:s.body?JSON.stringify(s.body):void 0});if(!t.ok){let i=await t.text().catch(()=>"");throw new Error(`Plane API ${t.status}: ${i.slice(0,300)}`)}let n=await t.text().catch(()=>"");if(!n||!n.trim())return{};try{return JSON.parse(n)}catch{return{raw:n}}}var ft={backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",cancelled:"done"},gt=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function se(r){return r?r.name&&gt.test(r.name)?"blocked":ft[r.group]||"unknown":"unknown"}var Re=new Map,ht=300*1e3;async function Ie(r){let{workspaceSlug:s,projectId:e}=j(r),t=Re.get(e);if(t&&Date.now()-t.fetchedAt<ht)return t.states;let n=await O(`/workspaces/${encodeURIComponent(s)}/projects/${encodeURIComponent(e)}/states/`,{query:{per_page:100}}),i=(n.results||n||[]).map(o=>({id:o.id,name:o.name,group:o.group,color:o.color}));return Re.set(e,{fetchedAt:Date.now(),states:i}),i}function re(r){return String(r||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function bt(r,s){let e=re(s);if(!e)return null;let t=r.find(i=>re(i.name)===e);if(t)return t;let n={todo:["todo","backlog","open","unstarted"],inprogress:["inprogress","started","doing","wip"],done:["done","completed","closed","resolved","cancelled","canceled"],blocked:["blocked","onhold","waiting"]};for(let[,i]of Object.entries(n)){if(!i.some(c=>re(c)===e))continue;let o=e==="done"?"completed":e==="inprogress"?"started":"unstarted",a=r.find(c=>c.group===o);if(a)return a}return null}async function ve(r,s){let t=(await Ie(s).catch(()=>[])).find(c=>c.id===r.state)||null,{workspaceSlug:n,projectId:i}=j(s),o=s.projectIdentifier&&r.sequence_id!=null?`${s.projectIdentifier}-${r.sequence_id}`:r.sequence_id!=null?String(r.sequence_id):r.id,a=r.assignees||[];return{id:r.id,key:o,title:r.name||"",body:r.description_html||r.description_stripped||r.description||"",state:t?t.name:null,stateCategory:se(t),assignee:a.length?String(a[0]):null,url:s.baseWebUrl?`${s.baseWebUrl}/${n}/projects/${i}/issues/${r.id}`:null,_raw:r}}var ie={id:"plane",envKeys:["PLANE_API_KEY","PLANE_OAUTH_TOKEN","PLANE_API_URL","PLANE_WORKSPACE_SLUG","PLANE_PROJECT_ID"],planeFetch:O,toStateCategory:se,async listCandidates(r={}){let s=r.ctx||{},{workspaceSlug:e,projectId:t}=j(s),n={per_page:Math.min(Number(r.limit)||50,100),cursor:r.cursor};r.state&&(n.state=r.state),r.updatedAfter&&(n.updated_at__gte=r.updatedAfter);let o=(await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/`,{query:n})).results||[];return r.updatedAfter&&(o=o.filter(a=>String(a.updated_at)>String(r.updatedAfter))),Promise.all(o.map(a=>ve(a,s)))},async getTicket(r,s={}){let{workspaceSlug:e,projectId:t}=j(s),n=await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/${encodeURIComponent(r)}/`);return!n||!n.id?null:ve(n,s)},async getComments(r,s={}){let{workspaceSlug:e,projectId:t}=j(s);return((await O(`/workspaces/${encodeURIComponent(e)}/projects/${encodeURIComponent(t)}/work-items/${encodeURIComponent(r)}/comments/`,{query:{per_page:100}})).results||[]).map(o=>({id:o.id,author:o.actor||o.actor_detail?.display_name||"Unknown",body:o.comment_html||o.comment_stripped||"",createdAt:o.created_at||null,updatedAt:o.updated_at||null,_raw:o})).sort((o,a)=>String(a.createdAt).localeCompare(String(o.createdAt)))},async addComment(r,s,e={}){let{workspaceSlug:t,projectId:n}=j(e),o=/<[a-z][\s\S]*>/i.test(String(s||""))?String(s):`<p>${String(s||"")}</p>`,a=await O(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(n)}/work-items/${encodeURIComponent(r)}/comments/`,{method:"POST",body:{comment_html:o}});return{ok:!!a.id,id:a.id||null,_raw:a}},async transition(r,s,e={}){let{workspaceSlug:t,projectId:n}=j(e),i=await Ie(e),o=bt(i,s);if(!o)return{ok:!1,error:`No Plane state matches "${s}" in this project`,availableStates:i.map(c=>({id:c.id,name:c.name,group:c.group}))};let a=await O(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(n)}/work-items/${encodeURIComponent(r)}/`,{method:"PATCH",body:{state:o.id}});return{ok:!!a.id,stateAfter:o.name,stateCategoryAfter:se(o),_raw:a}},async linkPullRequest(r,s,e,t={}){let n=e?`${e}: `:"Linked PR: ";return{ok:!!(await this.addComment(r,`<p>${n}<a href="${s}">${s}</a></p>`,t)).ok,via:"comment"}}};var _t=["todo","in_progress","done","blocked","unknown"];var $e={jira:Q,linear:X,github:te,plane:ie},wt="jira";function fr(r){let s=String(r||process.env.TRACKER_PROVIDER||wt).trim().toLowerCase(),e=$e[s];if(!e){let t=Object.keys($e).join(", ");throw new Error(`Unknown tracker provider "${s}". Known providers: ${t}.`)}return e}export{wt as DEFAULT_TRACKER_PROVIDER,$e as TRACKER_ADAPTERS,_t as TRACKER_STATE_CATEGORIES,fr as getAdapter,te as githubAdapter,Q as jiraAdapter,X as linearAdapter,ie as planeAdapter};

package/docs/self-host/backup-restore.md

@@ -9,11 +9,12 @@ title: Backup & restore
 
 ## What a backup contains
 
-One timestamped tarball holds the three things that together **are** your install:
+One timestamped tarball holds the four things that together **are** your install:
 
 1. **ScyllaDB volume** (`scylla-data`) — all metadata: integrations + their encrypted connect tokens, deployed agents (graph/env/schedule/prompts), repo→agent links, projects, members, access tokens, review-memory, execution history, stores.
 2. **Object-store volume** — `seaweed-data` (SeaweedFS, the default) or `minio-data` on a legacy box. Run artifacts + per-node logs, datasets, marketplace icons. The active store is detected from `.env` (`ZIBBY_OBJECT_STORE`) / volume presence; `restore.sh` handles either.
-3. **`.env`** — **critical**. It holds `ENCRYPTION_KEY`, without which every encrypted token/secret in ScyllaDB is unrecoverable, plus `JWT_SECRET`, the object-store root creds, and integration tokens. A ScyllaDB restore without the matching `ENCRYPTION_KEY` is useless, so `.env` travels **inside** the backup — which is also why the backup is highly sensitive.
+3. **Sidecar data volumes** (`zibby-sidecar-*-data`) — content that exists **nowhere else** and cannot be re-derived: a knowledge base's indexed documents, a sidecar's encrypted OAuth token store. They are discovered by convention, so a sidecar you add later — including one you brought yourself — is included with no configuration. Skip them with `--skip-sidecar-data` (or `ZIBBY_BACKUP_SIDECAR_DATA=false` for scheduled backups) if the size is a real problem; those sidecars then restore **empty**, and `restore.sh` says so out loud.
+4. **`.env`** — **critical**. It holds `ENCRYPTION_KEY`, without which every encrypted token/secret in ScyllaDB is unrecoverable, plus `JWT_SECRET`, the object-store root creds, and integration tokens. A ScyllaDB restore without the matching `ENCRYPTION_KEY` is useless, so `.env` travels **inside** the backup — which is also why the backup is highly sensitive.
 
 ## Take a backup
 
@@ -25,7 +26,7 @@ cd zibby-selfhosted
 ./backup.sh --s3 s3://mybucket/zibby   # also upload with YOUR aws creds (nothing goes to Zibby)
 ```
 
-Consistency + downtime: for a single-VM box the safe, simple approach wins — the script briefly **stops the writers** (control-plane + datastores), `nodetool flush`es Scylla so the commitlog is on disk, tars the volumes read-only from a throwaway helper container, then restarts everything. Downtime is typically seconds to a few minutes (plus Scylla's ~1–2 min cold-boot on restart). A trap guarantees the stack restarts even if the backup errors out. Volume names are compose-project-prefixed and **discovered at runtime**, so it works regardless of your install-dir name.
+Consistency + downtime: for a single-VM box the safe, simple approach wins — the script briefly **stops the writers** (control-plane + datastores + any running sidecars, whose single-writer file databases would otherwise be captured mid-write), `nodetool flush`es Scylla so the commitlog is on disk, tars the volumes read-only from a throwaway helper container, then restarts everything. Downtime is typically seconds to a few minutes (plus Scylla's ~1–2 min cold-boot on restart). A trap guarantees the stack restarts even if the backup errors out. Volume names are compose-project-prefixed and **discovered at runtime**, so it works regardless of your install-dir name.
 
 Copy the tarball **off the box** — it is your only recovery path, and it contains the encryption key.
 

package/docs/self-host/custom-sidecars.md

@@ -0,0 +1,136 @@
+---
+sidebar_position: 5
+title: Custom (BYO) sidecars
+---
+
+# Bring your own sidecar
+
+A **sidecar** is a long-lived service container the box runs next to your
+agents — the platform's own vector-KB engine and OAuth token broker ship this
+way. On a self-hosted box you can also register **your own** sidecar image.
+That is the standard way to add a custom resident service to the platform —
+most commonly a **thin MCP server that wraps an internal REST API**, so your
+agents and the chat Copilot can call systems that only exist inside your
+network.
+
+No marketplace entry, no platform code change, no third-party registry: you
+push a `docker save` tarball to your own box, the box pins its sha256, and the
+sidecar flows through the exact same launch/health/idle-reap machinery as the
+built-ins.
+
+:::tip Wrapping a REST API? Try the OpenAPI bridge agent first.
+
+If all you need is "my agents should be able to call this internal REST API",
+you probably do **not** need to build an image at all. Deploy the **OpenAPI MCP
+Bridge** agent from the marketplace, put your API's spec URL in its **Env** tab,
+and every operation in the spec becomes an MCP tool — no code, no upload.
+
+```json
+OPENAPI_APIS = {"billing":{"specUrl":"https://internal/v2/api-docs","root":"https://internal"}}
+```
+
+It is a marketplace agent that carries its own sidecar, so deploying it is the
+whole installation. Build your own image (below) when you need logic the bridge
+can't express — a non-HTTP protocol, a stateful session, custom auth.
+:::
+
+## Push one
+
+```bash
+# 1. Build your image however you like; it must serve HTTP on one port.
+docker build -t report-mcp:0.1.0 .
+docker save report-mcp:0.1.0 | gzip > report-mcp.tar.gz
+
+# 2. Push it to the box. Needs an OPERATOR access token
+#    (a restricted per-user token is refused).
+zibby sidecar push report-mcp.tar.gz \
+  --name report-mcp --port 8080 \
+  --health-path /health \
+  --warm \
+  --api-url https://your-box.example.com --token $OPERATOR_PAT
+```
+
+`push` streams the tarball up (`POST /selfhost/sidecars/artifacts`), then
+registers the declaration (`PUT /selfhost/sidecars/report-mcp`) pinned to the
+sha256 the server computed from the uploaded bytes. The image is verified and
+`docker load`ed **before** anything is persisted — a corrupt or tampered
+tarball can never become a registered sidecar.
+
+Manage what's registered:
+
+```bash
+zibby sidecar list             # custom sidecars + the reserved built-in names
+zibby sidecar remove <name>    # unregister + stop (image reclaimed; data volume kept) (data volumes are kept)
+```
+
+## Reach it
+
+- **From the control plane / the chat Copilot** — the container listens on the
+  box's infra network at `http://zibby-sidecar-<name>:<port>`. Agent run
+  containers deliberately **cannot** dial it directly (they are isolated on the
+  run network); access is brokered by the platform.
+- **From a browser / third-party client** — every `--public-path` prefix is
+  served at `https://<box-origin>/sidecars/<name>/<path>` through the
+  control-plane reverse proxy. Anything not declared public stays
+  infra-network-only.
+
+:::warning `--public-path` is opt-in, and most sidecars don't need it
+A declared public path is reachable **anonymously** — the platform adds no auth
+and no identity; your app owns that surface entirely. Agents and the chat
+Copilot reach a sidecar over the infra network, so an MCP server for them needs
+**no** public path. It exists for browser flows (an OAuth callback a provider
+redirects to). Registering one is therefore refused unless the box opts in with
+`SIDECAR_BYO_PUBLIC_PATHS=1` in its `.env` (then restart the control-plane).
+:::
+
+### Wire it into the Copilot
+
+For the "internal API → MCP → chat" use case, register the sidecar and then
+attach its MCP endpoint to the Copilot (in chat):
+
+> connect yourself to the MCP at `http://zibby-sidecar-report-mcp:8080/mcp`
+
+The Copilot can also drive the whole flow itself with the owner-only tools
+`zibby_add_sidecar` (takes a downloadable `url` + pinned `sha256` instead of a
+file upload), `zibby_list_sidecars`, and `zibby_remove_sidecar`.
+
+## Declaration reference
+
+| Flag | Meaning |
+|---|---|
+| `--name` | `[a-z][a-z0-9-]{1,30}`. Built-in names (`gbrain`, `pingcode`, …) are reserved. |
+| `--port` | The HTTP port your app listens on inside the container. Required. |
+| `--version` | Display/tag version (default: first 12 chars of the sha256). |
+| `--health-path` | GET path returning 2xx when ready (default `/health`). |
+| `--public-path` | Repeatable. Path prefix exposed through the public reverse proxy — **anonymously**. Disabled unless the box sets `SIDECAR_BYO_PUBLIC_PATHS=1`; see below. |
+| `--warm` | Keep it always-on (pre-warmed at boot, never idle-reaped). Default: on-demand launch + idle reap. |
+| `--env-key` | Repeatable. A box `.env` variable forwarded into the container when set. |
+| `--request-config-key` | Repeatable. Per-agent config: resolved from the **calling agent's encrypted Env bag** and sent per request — one shared container can serve N projects with different upstream credentials. |
+| `--data-path` | Container path persisted on a named volume (survives restarts; kept on remove). |
+| `--memory-bytes` | Container memory cap. |
+
+## What the box guarantees
+
+- **sha256-pinned, always.** The tarball's hash is computed server-side at
+  upload and re-verified on every subsequent load — including the re-fetch
+  path: the verified tarball is kept in the box's own object store, so if the
+  docker image is ever pruned it is restored automatically without a re-upload.
+- **Operator-only surface.** Upload/register/remove require the box
+  owner/admin token; restricted per-user tokens get `403`.
+- **Isolation unchanged.** Custom sidecars get the same placement as built-in
+  ones: infra network, brokered access, no host mounts — the declaration
+  cannot ask for privileged options.
+- **No shadowing, at BOTH layers.** A custom sidecar can never take over a
+  built-in sidecar's *name*, and its package can never take over a platform or
+  another sidecar's *image tag*: the archive's manifest is read **before**
+  `docker load` runs, and a package declaring `zibby-*` or another sidecar's
+  image is refused outright — even if that image isn't on the box yet.
+- **Uninstall reclaims storage.** Removing a sidecar deletes its image; a
+  superseded image is reclaimed when you push a new version. The declared data
+  volume is **kept** (it holds your content) — the response tells you its name,
+  and `zibby sidecar remove <name> --purge-data` deletes it deliberately.
+
+:::note Cloud
+BYO sidecars are **self-host only** today. On cloud, wrap an external API as a
+remote MCP server and attach it with `zibby_add_mcp` instead.
+:::

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",
@@ -115,7 +115,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@resvg/resvg-js": "^2.6.2",
-    "@zibby/agent-workflow": "^0.4.0",
+    "@zibby/agent-workflow": "^0.6.1",
     "@zibby/bin-oxlint": "^1.73.0",
     "@zibby/bin-semgrep": "^1.169.0",
     "@zibby/skill-ids": "^0.2.0",