@zibby/skills 0.1.30 → 0.1.31

package/dist/trackers/jira-adapter.js

@@ -0,0 +1,71 @@
+import{createRequire as P}from"module";import{resolveIntegrationToken as x,clearTokenCache as L}from"@zibby/core/backend-client.js";var C=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",PLANE:"plane"}),Q=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark",connectPath:"/integrations?provider=lark"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"}});var E=P(import.meta.url);function D(){if(process.env.MCP_JIRA_PATH)return process.env.MCP_JIRA_PATH;try{return E.resolve("@zibby/mcp-jira/index.js")}catch{return null}}var B=new Set(["paragraph","heading","bulletList","orderedList","listItem","blockquote","codeBlock","rule","table","tableRow","tableCell","tableHeader","mediaSingle","panel"]);function U(s,r){if(!r||!r.length)return s;let e=s;for(let t of r)t.type==="strong"?e=`**${e}**`:t.type==="em"?e=`_${e}_`:t.type==="code"?e=`\`${e}\``:t.type==="strike"?e=`~~${e}~~`:t.type==="link"&&t.attrs?.href&&(e=`[${e}](${t.attrs.href})`);return e}function w(s,r=0){if(!Array.isArray(s))return"";let e=[];for(let t of s){if(t.type==="text"){e.push(U(t.text||"",t.marks));continue}if(t.type==="hardBreak"){e.push(`
+`);continue}if(t.type==="rule"){e.push(`
+---
+`);continue}let a=t.content?w(t.content,r+1):"";if(t.type==="listItem")e.push(a);else if(t.type==="bulletList"){let n=(t.content||[]).map(o=>`- ${w(o.content||[],r+1).trim()}`);e.push(`
+${n.join(`
+`)}
+`)}else if(t.type==="orderedList"){let n=(t.content||[]).map((o,i)=>`${i+1}. ${w(o.content||[],r+1).trim()}`);e.push(`
+${n.join(`
+`)}
+`)}else if(t.type==="heading"){let n=t.attrs?.level||2;e.push(`
+
+${"#".repeat(n)} ${a.trim()}
+
+`)}else B.has(t.type)?e.push(`
+
+${a}
+`):e.push(a)}return e.join("").replace(/\n{3,}/g,`
+
+`)}function S(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function A(s){return S(s).replace(/[a-z0-9]+/g,"")}function I(s,r){let e=S(s),t=S(r);if(!e||!t)return 0;if(e===t)return 1;if(e.length===1||t.length===1)return e===t?1:0;let a=u=>{let d=new Map;for(let m=0;m<u.length-1;m++){let g=u.slice(m,m+2);d.set(g,(d.get(g)||0)+1)}return d},n=a(e),o=a(t),i=0,c=0,p=0;for(let u of n.values())c+=u;for(let u of o.values())p+=u;for(let[u,d]of n.entries()){let m=o.get(u)||0;i+=Math.min(d,m)}return 2*i/Math.max(1,c+p)}function b(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function M(s,r=[]){let e=Array.isArray(r)?r:[];if(e.length===0)return{requested:s||null,resolved:null,strategy:"none"};let t=e.filter(i=>!i.subtask),a=t.length>0?t:e,n=b(s);if(n){let i=a.find(u=>b(u.name)===n);if(i)return{requested:s,resolved:i,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 u of Object.values(c)){if(!u.some(m=>b(m)===n))continue;let d=a.find(m=>u.some(g=>b(g)===b(m.name)));if(d)return{requested:s,resolved:d,strategy:"alias"}}let p=a.map(u=>({t:u,score:I(s,u.name)})).sort((u,d)=>d.score-u.score);if(p[0]&&p[0].score>=.5)return{requested:s,resolved:p[0].t,strategy:"fuzzy"}}let o=["task","story","bug","improvement","epic"];for(let i of o){let c=a.find(p=>b(p.name)===i);if(c)return{requested:s||null,resolved:c,strategy:"default-preferred"}}return{requested:s||null,resolved:a[0],strategy:"default-first"}}async function q(s){let r=`projectKeys=${encodeURIComponent(s)}&expand=projects.issuetypes`,e=await y(`/rest/api/3/issue/createmeta?${r}`),t=Array.isArray(e?.projects)?e.projects:[],n=t.find(i=>String(i?.key||"").toUpperCase()===String(s||"").toUpperCase())||t[0]||null;return(Array.isArray(n?.issuetypes)?n.issuetypes:[]).map(i=>({id:i.id,name:i.name,subtask:!!i.subtask,description:i.description||null}))}async function J(s,r){if(!s)throw new Error("projectKey is required");let e="sprint is not EMPTY";r==="active"?e="sprint in openSprints()":r==="closed"?e="sprint in closedSprints()":r==="future"&&(e="sprint in futureSprints()");let t=`project = ${s} AND ${e} ORDER BY updated DESC`,a=`jql=${encodeURIComponent(t)}&maxResults=100&fields=customfield_10020`,n=await y(`/rest/api/3/search/jql?${a}`),o=new Map;for(let i of n.issues||[])for(let c of i.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((i,c)=>{let p={active:0,future:1,closed:2},u=(p[i.state]??3)-(p[c.state]??3);return u!==0?u:String(c.startDate||"").localeCompare(String(i.startDate||""))})}function G(s,{sprintId:r,sprintName:e,target:t}={}){let a=Array.isArray(s)?s:[];if(!a.length)return{sprint:null,selectedBy:"none"};if(r!=null&&String(r).trim()!=="")return{sprint:a.find(i=>String(i.id)===String(r))||null,selectedBy:"id"};if(e&&String(e).trim()){let o=String(e).trim(),i=a.find(p=>String(p.name||"").toLowerCase()===o.toLowerCase());if(i)return{sprint:i,selectedBy:"name-exact"};let c=a.map(p=>({s:p,score:I(o,p.name||"")})).sort((p,u)=>u.score-p.score);return c[0]&&c[0].score>=.5?{sprint:c[0].s,selectedBy:"name-fuzzy"}:{sprint:null,selectedBy:"name-none"}}let n=String(t||"current").trim().toLowerCase();return n==="active"||n==="current"||n==="latest"?{sprint:a[0],selectedBy:n}:{sprint:a[0],selectedBy:"default"}}function Y(s,r){let e=s?.fields?.customfield_10020;return Array.isArray(e)?e.some(t=>String(t?.id)===String(r)):!1}async function z({issueKey:s,projectKey:r,sprintId:e,attempts:t=3,delayMs:a=450}){let n=[];for(let o=0;o<t;o++){try{let i=`project = ${r} AND key = ${s} AND sprint = ${e}`,c=`jql=${encodeURIComponent(i)}&maxResults=1&fields=key,status`,p=await y(`/rest/api/3/search/jql?${c}`);if(Number(p?.total||0)>0)return n.push({attempt:o+1,jql:!0,issueField:null}),{ok:!0,method:"jql",traces:n};let d=await y(`/rest/api/3/issue/${s}?fields=customfield_10020,status`),m=Y(d,e);if(n.push({attempt:o+1,jql:!1,issueField:m}),m)return{ok:!0,method:"issue_field",traces:n}}catch(i){n.push({attempt:o+1,error:String(i?.message||i)})}o<t-1&&await new Promise(i=>setTimeout(i,a))}return{ok:!1,method:"none",traces:n}}async function N({issueKey:s,projectKey:r,sprintId:e,sprintName:t,target:a}){if(!s)return{ok:!1,error:"issueKey is required"};let n=r;if(!n&&(n=(await y(`/rest/api/3/issue/${s}?fields=project`))?.fields?.project?.key||null,!n))return{ok:!1,error:`Could not resolve project for ${s}`};let o=await J(n,"active");if(!o.length)return{ok:!1,error:`No assignable active sprint found for project ${n}`};let{sprint:i,selectedBy:c}=G(o,{sprintId:e,sprintName:t,target:a});if(!i)return{ok:!1,error:`No matching sprint found in ${n}`,requested:{sprintId:e??null,sprintName:t??null,target:a??"current"},availableSprints:o.map(d=>({id:d.id,name:d.name,state:d.state}))};await y(`/rest/api/3/issue/${s}`,{method:"PUT",body:{fields:{customfield_10020:Number(i.id)}}});let p=await z({issueKey:s,projectKey:n,sprintId:i.id}),u=p.ok;return{ok:u,issueKey:s,projectKey:n,sprintId:i.id,sprintName:i.name,selectedBy:c,verifiedBy:p.method,verified:u,verificationTrace:p.traces,warning:u?null:`Sprint assignment attempted but verification did not find ${s} in sprint ${i.id}`}}async function y(s,r={}){let e=async()=>{let{token:t,cloudId:a}=await x("jira");if(typeof t!="string"||!t)throw new Error(`Invalid jira token type: ${typeof t}`);if(!a)throw new Error("Invalid jira cloudId: missing");let n=`https://api.atlassian.com/ex/jira/${a}${s}`,o=await fetch(n,{method:r.method||"GET",headers:{Authorization:`Bearer ${t}`,Accept:"application/json",...r.body?{"Content-Type":"application/json"}:{},...r.headers},body:r.body?JSON.stringify(r.body):void 0});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`Jira API ${o.status}: ${c.slice(0,300)}`)}let i=await o.text().catch(()=>"");if(!i||!i.trim())return{};try{return JSON.parse(i)}catch{return{raw:i}}};try{return await e()}catch(t){let a=String(t?.message||t||"").toLowerCase();if(!(a.includes("token")||a.includes("401")||a.includes("403")||a.includes("substring")))throw t;return L("jira"),e()}}var v={id:"jira",serverName:"jira",allowedTools:["mcp__jira__*"],requiresIntegration:C.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
+- jira_search: Search issues with JQL (e.g. "project = PROJ AND status != Done ORDER BY updated DESC")
+- jira_get_issue: Get full details of a ticket by key (e.g. PROJ-123)
+- jira_list_statuses: List available Jira statuses (global or project-specific)
+- jira_list_issue_types: List issue types allowed for issue creation in a project
+- jira_create_issue: Create a new ticket (requires projectKey + summary)
+- jira_get_comments: Get comments on a ticket (newest first) \u2014 use this to find testing steps, notes, etc.
+- jira_add_comment: Add a comment to a ticket
+- jira_edit_issue: Update fields (summary, labels, priority, story points)
+- jira_transition_issue: Move a ticket to a different status (pass transitionId or toStatus)
+
+### Project & sprint tools
+- jira_list_projects: List all projects
+- jira_list_sprints: List sprints for a project (filter by state: active/closed/future)
+- jira_get_sprint_issues: Get all issues in a sprint \u2014 filter by status name (e.g. "\u8FDB\u884C\u4E2D", "\u6D4B\u8BD5", "In Progress"). Returns status breakdown.
+- jira_move_issue_to_sprint: Move an issue to a sprint (current/active/latest/by-id/by-name) and verify membership.
+
+### Sprint membership updates
+- To move an issue into a sprint, use jira_edit_issue with fields.customfield_10020 set to sprint numeric id.
+- Example: jira_edit_issue({ issueKey: "PROJ-123", fields: { customfield_10020: 10 } })
+- Always verify by calling jira_get_sprint_issues(sprintId, projectKey) and checking the issue key is present.
+- For "create and place into current sprint" requests, use a generic atomic flow:
+  - Prefer jira_create_issue with moveToSprint=true (optionally sprintId/sprintName/target)
+  - Or create first, then use jira_move_issue_to_sprint
+  - Always report verified sprint membership result (not just status transition)
+
+### Search strategy (important!)
+1. **Board/sprint first**: When the user asks about "my board", "testing tickets", or "what's in progress", ALWAYS use the sprint path: jira_list_sprints (state: active) \u2192 jira_get_sprint_issues. This finds ALL tickets regardless of age.
+2. **Project-scoped search**: If you know the project key, use "project = KEY AND status != Done ORDER BY updated DESC" \u2014 no date filter needed when scoped to a project.
+3. **Global search (last resort)**: Only use broad JQL like "created >= -365d" when you genuinely don't know the project. Never use -90d \u2014 it misses older tickets still in testing.
+4. **Remember the board**: After finding the user's project/board, store it in memory (memory_store) so you go straight there next time.
+5. **Status discovery**: NEVER use jira_search with guessed status keywords to determine whether a status exists. Use jira_list_statuses (project-scoped when possible) and/or jira_transition_issue(issueKey) without transitionId.
+
+When the user asks about "my tickets" or "my board" and you know their project from memory, go directly to that project's active sprint.
+When the user asks about projects or boards, call jira_list_projects.
+When the user asks about sprints: jira_list_sprints \u2192 jira_get_sprint_issues.
+When user asks to move ticket into a sprint, do NOT use status transition. Use jira_move_issue_to_sprint(issueKey, projectKey?, sprintId|sprintName|target) and report verified result.
+When the user asks about testing steps, test cases, or wants to run tests for a ticket: call jira_get_comments \u2014 testing steps are typically written in the ticket's comments, not the description.
+JQL must be bounded (Jira rejects unbounded queries). Use "project = KEY AND status != Done" for project queries. Use "created >= -365d ORDER BY updated DESC" for global queries.
+
+### Transition workflow (MANDATORY)
+When user asks to move/transition ticket status:
+1. If user explicitly gives a target status (e.g. "move to \u8FDB\u884C\u4E2D", "move that in progress", "move to AI \u9A8C\u6536"), call jira_transition_issue with issueKey + toStatus directly. Do NOT call list-only mode first.
+2. If target is ambiguous or missing, call jira_transition_issue({ issueKey }) with no transitionId to list available transitions.
+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 s=D();if(!s)return null;let r={};for(let e of this.envKeys)process.env[e]&&(r[e]=process.env[e]);return process.env.ATLASSIAN_INSTANCE_URL&&(r.ATLASSIAN_INSTANCE_URL=process.env.ATLASSIAN_INSTANCE_URL),{command:"node",args:[s],env:r,description:this.description}},async handleToolCall(s,r){try{switch(s){case"jira_list_projects":{let e=await y("/rest/api/3/project"),t=(Array.isArray(e)?e:[]).map(a=>({id:a.id,key:a.key,name:a.name,style:a.style}));return JSON.stringify({count:t.length,projects:t})}case"jira_list_statuses":{let{projectKey:e}=r||{};if(e){let n=await y(`/rest/api/3/project/${encodeURIComponent(e)}/statuses`),o=Array.isArray(n)?n:[],i=new Map;for(let p of o)for(let u of p.statuses||[])u?.id&&(i.has(u.id)||i.set(u.id,{id:u.id,name:u.name,category:u.statusCategory?.name||null}));let c=[...i.values()].sort((p,u)=>String(p.name).localeCompare(String(u.name)));return JSON.stringify({scope:"project",projectKey:e,count:c.length,statuses:c})}let t=await y("/rest/api/3/status"),a=(Array.isArray(t)?t:[]).map(n=>({id:n.id,name:n.name,category:n.statusCategory?.name||null})).sort((n,o)=>String(n.name).localeCompare(String(o.name)));return JSON.stringify({scope:"global",count:a.length,statuses:a})}case"jira_list_issue_types":{let{projectKey:e}=r||{};if(!e)return JSON.stringify({error:"projectKey is required"});let t=await q(e);return JSON.stringify({projectKey:e,count:t.length,issueTypes:t})}case"jira_search":{let e=r.jql||"",t=r.maxResults||20;e.replace(/\s*ORDER\s+BY\s+.*/i,"").trim()||(e=`created >= -365d ${e}`.trim());let n=`jql=${encodeURIComponent(e)}&maxResults=${t}&fields=summary,status,assignee,priority,updated,issuetype,project`,i=((await y(`/rest/api/3/search/jql?${n}`)).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:i.length,issues:i})}case"jira_get_issue":{let e=r.issueKey;if(!e)return JSON.stringify({error:"issueKey is required"});let t=await y(`/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:a,description:n,priority:o,labels:i,assigneeId:c,moveToSprint:p,moveToActiveSprint:u,sprintId:d,sprintName:m,target:g}=r;if(!e||!t)return JSON.stringify({error:"projectKey and summary are required"});let l={requested:a||null,resolved:null,strategy:"none"},h=[];try{h=await q(e),l=M(a,h)}catch{}let f={project:{key:e},summary:t,issuetype:l?.resolved?.id?{id:l.resolved.id}:{name:a||"Task"}};n&&(f.description={type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}),o&&(f.priority={name:o}),i?.length&&(f.labels=i),c&&(f.assignee={id:c});let _=await y("/rest/api/3/issue",{method:"POST",body:{fields:f}}),j={ok:!0,key:_.key,id:_.id,self:_.self};return l?.resolved&&(j.issueType=l.resolved.name,j.issueTypeResolution=l.strategy,l.strategy!=="exact"&&l.requested&&b(l.requested)!==b(l.resolved.name)&&(j.issueTypeWarning=`Requested "${l.requested}" is not available in ${e}; used "${l.resolved.name}" instead.`)),h.length>0&&(j.availableIssueTypes=h.map(k=>k.name)),(p||u)&&(j.sprintMove=await N({issueKey:_.key,projectKey:e,sprintId:d,sprintName:m,target:g})),JSON.stringify(j)}case"jira_list_sprints":{let{projectKey:e,state:t}=r,a=await J(e,t);return JSON.stringify({count:a.length,sprints:a})}case"jira_move_to_active_sprint":{let{issueKey:e,projectKey:t,sprintId:a,sprintName:n,target:o}=r||{},i=await N({issueKey:e,projectKey:t,sprintId:a,sprintName:n,target:o||"current"});return JSON.stringify(i)}case"jira_move_issue_to_sprint":{let{issueKey:e,projectKey:t,sprintId:a,sprintName:n,target:o}=r||{},i=await N({issueKey:e,projectKey:t,sprintId:a,sprintName:n,target:o});return JSON.stringify(i)}case"jira_get_sprint_issues":{let{sprintName:e,sprintId:t,projectKey:a,status:n,maxResults:o}=r;if(!e&&!t)return JSON.stringify({error:"sprintName or sprintId is required"});let i=o||50,c=t?`sprint = ${t}`:`sprint = "${e}"`,p=a?`project = ${a} AND `:"",u=n?` AND status = "${n}"`:"",d=`${p}${c}${u} ORDER BY status ASC, priority DESC`,m=`jql=${encodeURIComponent(d)}&maxResults=${i}&fields=summary,status,assignee,priority,issuetype,project`,g=await y(`/rest/api/3/search/jql?${m}`),l=(g.issues||[]).map(f=>({key:f.key,project:f.fields?.project?.key,summary:f.fields?.summary,status:f.fields?.status?.name,assignee:f.fields?.assignee?.displayName||"Unassigned",priority:f.fields?.priority?.name,type:f.fields?.issuetype?.name})),h={};for(let f of l)h[f.status]=(h[f.status]||0)+1;return JSON.stringify({count:l.length,total:g.total||l.length,statusCounts:h,issues:l})}case"jira_get_comments":{let{issueKey:e,maxResults:t}=r;if(!e)return JSON.stringify({error:"issueKey is required"});let n=await y(`/rest/api/3/issue/${e}/comment?maxResults=${t||50}&orderBy=-created`),o=(n.comments||[]).map(i=>{let c="";return i.body?.content&&(c=w(i.body.content)),{id:i.id,author:i.author?.displayName||"Unknown",body:c,created:i.created,updated:i.updated}});return JSON.stringify({count:o.length,total:n.total||o.length,comments:o})}case"jira_add_comment":{let{issueKey:e,body:t}=r;return!e||!t?JSON.stringify({error:"issueKey and body are required"}):(await y(`/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}=r;return!e||!t?JSON.stringify({error:"issueKey and fields are required"}):(await y(`/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:a,statusName:n,status:o}=r;if(!e)return JSON.stringify({error:"issueKey is required"});let i=String(a||n||o||"").trim();if(!t&&!i){let d=((await y(`/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:d})}let c=t;if(!c){let d=(await y(`/rest/api/3/issue/${e}/transitions`)).transitions||[],m=S(i),g=d.find(l=>S(l?.name||"")===m||S(l?.to?.name||"")===m);if(!g){let l=A(i);l.length>=2&&(g=d.find(h=>{let f=A(h?.name||""),_=A(h?.to?.name||""),j=f.length>=2&&(f.includes(l)||l.includes(f)),k=_.length>=2&&(_.includes(l)||l.includes(_));return j||k}))}if(!g){let l=d.map(j=>{let k=I(i,j?.name||""),K=I(i,j?.to?.name||"");return{t:j,score:Math.max(k,K)}}).sort((j,k)=>k.score-j.score),h=l[0],f=l[1];h&&h.score>=.45&&(!f||h.score-f.score>=.12)&&(g=h.t)}if(!g?.id)return JSON.stringify({ok:!1,error:`No transition matches target status: "${i}"`,issueKey:e,availableTransitions:d.map(l=>({id:l.id,name:l.name,to:l.to?.name}))});c=g.id}await y(`/rest/api/3/issue/${e}/transitions`,{method:"POST",body:{transition:{id:c}}});let p=await y(`/rest/api/3/issue/${e}?fields=status`);return JSON.stringify({ok:!0,issueKey:e,transitionId:c,statusAfter:p?.fields?.status?.name||null})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}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 F={new:"todo",indeterminate:"in_progress",done:"done"},W=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function $(s){if(!s)return"unknown";if(s.name&&W.test(s.name))return"blocked";let r=s.statusCategory?.key;return F[r]||"unknown"}function T(s){if(!s)return"";if(Array.isArray(s))return s.map(T).join("");if(s.type==="text")return s.text||"";if(s.type==="hardBreak"||s.type==="rule")return`
+`;let r=s.content?T(s.content):"";return/^(paragraph|heading|listItem|blockquote|codeBlock|panel)$/.test(s.type)&&(r+=`
+`),r}function O(s,r){let e=s.fields||{},t=e.status||null,a=null;if(s.self&&s.key)try{a=`${new URL(s.self).origin}/browse/${s.key}`}catch{a=null}return!a&&r&&s.key&&(a=`${String(r).replace(/\/+$/,"")}/browse/${s.key}`),{id:String(s.id??s.key??""),key:s.key,title:e.summary||"",body:typeof e.description=="string"?e.description:T(e.description?.content).trim(),state:t?.name||null,stateCategory:$(t),assignee:e.assignee?.displayName||null,url:a,_raw:s}}function R(s){let r=JSON.parse(s);if(r&&r.error)throw new Error(r.error);return r}var H={id:"jira",toStateCategory:$,toNeutral:O,async listCandidates(s={}){let r=s.query||"";if(!r.trim()){let n=[];if(s.state&&n.push(`status = "${s.state}"`),s.labels){let o=Array.isArray(s.labels)?s.labels:[s.labels];for(let i of o)n.push(`labels = "${i}"`)}s.updatedAfter&&n.push(`updated >= "${s.updatedAfter}"`),r=n.length?`${n.join(" AND ")} ORDER BY updated DESC`:"ORDER BY updated DESC"}let e=Number(s.limit)||30,t=`jql=${encodeURIComponent(r)}&maxResults=${e}&fields=summary,description,status,assignee,labels,project,updated,created`;return((await y(`/rest/api/3/search/jql?${t}`)).issues||[]).map(n=>O(n))},async getTicket(s){if(!s)throw new Error("key is required");let r=await y(`/rest/api/3/issue/${encodeURIComponent(s)}`);return!r||!r.key?null:O(r)},async getComments(s){if(!s)throw new Error("key is required");return(R(await v.handleToolCall("jira_get_comments",{issueKey:s})).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(s,r){if(!s||!r)throw new Error("key and body are required");return{ok:!!R(await v.handleToolCall("jira_add_comment",{issueKey:s,body:r})).ok,id:null}},async transition(s,r){if(!s)throw new Error("key is required");let e=JSON.parse(await v.handleToolCall("jira_transition_issue",{issueKey:s,toStatus:r}));if(!e.ok)return{ok:!1,error:e.error||"transition failed",_raw:e};let t=e.statusAfter||null;return{ok:!0,stateAfter:t,stateCategoryAfter:$(t?{name:t}:null),_raw:e}},async linkPullRequest(s,r,e){if(!s||!r)throw new Error("key and prUrl are required");try{return await y(`/rest/api/3/issue/${encodeURIComponent(s)}/remotelink`,{method:"POST",body:{object:{url:r,title:e||r,icon:{url16x16:"https://github.com/favicon.ico",title:"GitHub"}}}}),{ok:!0,via:"remotelink"}}catch(t){let a=`${e?`${e}: `:"Linked PR: "}${r}`;return{ok:!!R(await v.handleToolCall("jira_add_comment",{issueKey:s,body:a})).ok,via:"comment",error:String(t?.message||t)}}}},re=H;export{re as default,H as jiraAdapter};

package/dist/trackers/linear-adapter.js

@@ -0,0 +1,114 @@
+var S=process.env.LINEAR_API_URL||"https://api.linear.app/graphql";function L(){if(process.env.LINEAR_OAUTH_TOKEN)return`Bearer ${process.env.LINEAR_OAUTH_TOKEN}`;let s=process.env.LINEAR_API_KEY;if(!s)throw new Error("Linear is not connected: set LINEAR_API_KEY (personal API key) or LINEAR_OAUTH_TOKEN.");return s}async function f(s,i={}){let t=await fetch(S,{method:"POST",headers:{Authorization:L(),"Content-Type":"application/json"},body:JSON.stringify({query:s,variables:i})});if(!t.ok){let a=await t.text().catch(()=>"");throw new Error(`Linear API ${t.status}: ${a.slice(0,300)}`)}let e=await t.json().catch(()=>null);if(!e)throw new Error("Linear API returned a non-JSON body");if(Array.isArray(e.errors)&&e.errors.length){let a=e.errors.map(n=>n?.message||String(n)).join("; ");throw new Error(`Linear GraphQL error: ${a.slice(0,300)}`)}return e.data}function h(s){return String(s||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function E(s,i){let t=h(s),e=h(i);if(!t||!e)return 0;if(t===e)return 1;if(t.length===1||e.length===1)return t===e?1:0;let a=d=>{let c=new Map;for(let y=0;y<d.length-1;y++){let g=d.slice(y,y+2);c.set(g,(c.get(g)||0)+1)}return c},n=a(t),r=a(e),o=0,l=0,m=0;for(let d of n.values())l+=d;for(let d of r.values())m+=d;for(let[d,c]of n.entries())o+=Math.min(c,r.get(d)||0);return 2*o/Math.max(1,l+m)}function v(s,i){let t=Array.isArray(s)?s:[];if(!t.length)return{state:null,strategy:"no-states"};let e=h(i);if(!e)return{state:null,strategy:"no-target"};let a=t.find(o=>h(o.name)===e);if(a)return{state:a,strategy:"exact"};let n={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[o,l]of Object.entries(n)){if(!l.some(d=>h(d)===e))continue;let m=t.find(d=>d.type===o);if(m)return{state:m,strategy:"type-alias"}}let r=t.map(o=>({s:o,score:E(i,o.name)})).sort((o,l)=>l.score-o.score);return r[0]&&r[0].score>=.5?{state:r[0].s,strategy:"fuzzy"}:{state:null,strategy:"no-match"}}var O=`
+  id
+  identifier
+  number
+  title
+  description
+  url
+  priority
+  createdAt
+  updatedAt
+  state { id name type color }
+  assignee { id name displayName email }
+  labels { nodes { id name color } }
+  team { id key name }
+`,_={id:"linear",serverName:"linear",allowedTools:["mcp__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
+- linear_list_teams: List teams (id, key, name) \u2014 needed to scope states/issues
+- linear_list_states: List a team's workflow states (id, name, type). Linear states are PER-TEAM; there is no global status list.
+- linear_list_labels: List labels (optionally scoped to a team)
+
+### Issues
+- linear_list_issues: List/poll issues filtered by team / state / label / assignee / updatedAfter cursor (for polling candidates)
+- linear_get_issue: Get one issue by identifier (e.g. ENG-123) or id \u2014 title, description, state, labels, assignee, url
+- linear_get_comments: Get an issue's comments (newest first)
+- linear_add_comment: Add a comment to an issue
+- linear_update_state: Move an issue to a different workflow state. Pass the issue + a target state NAME; the tool resolves it to the team's matching state id (exact -> type-alias -> fuzzy). There is no "transition" in Linear \u2014 you just set the state.
+- linear_link_attachment: Attach a URL (e.g. a GitHub PR) to an issue via Linear's native attachments. Use this for PR links; fall back to linear_add_comment if it fails.
+
+### Notes
+- Always resolve a team first when you need states or want to create/move issues by state name \u2014 states only make sense within their team.
+- Issue identifier (ENG-123) and internal id (uuid) are both accepted by get/update tools.`,resolve(){let s={};for(let i of this.envKeys)process.env[i]&&(s[i]=process.env[i]);return process.env.LINEAR_API_URL&&(s.LINEAR_API_URL=process.env.LINEAR_API_URL),{command:null,args:[],env:s,description:this.description}},async handleToolCall(s,i){try{switch(s){case"linear_list_teams":{let e=(await f(`
+            query Teams($first: Int) {
+              teams(first: $first) {
+                nodes { id key name description }
+              }
+            }
+          `,{first:i?.limit||50}))?.teams?.nodes||[];return JSON.stringify({count:e.length,teams:e})}case"linear_list_states":{let{teamId:t,teamKey:e}=i||{},a=t;if(!a&&e&&(a=await k(e)),a){let l=(await f(`
+              query States($teamId: String!) {
+                team(id: $teamId) {
+                  id key name
+                  states { nodes { id name type color position } }
+                }
+              }
+            `,{teamId:a}))?.team,m=(l?.states?.nodes||[]).slice().sort((d,c)=>(d.position||0)-(c.position||0));return JSON.stringify({team:l?{id:l.id,key:l.key,name:l.name}:null,count:m.length,states:m})}let r=(await f(`
+            query AllStates($first: Int) {
+              workflowStates(first: $first) {
+                nodes { id name type color team { id key name } }
+              }
+            }
+          `,{first:i?.limit||200}))?.workflowStates?.nodes||[];return JSON.stringify({scope:"workspace",count:r.length,states:r})}case"linear_list_labels":{let{teamId:t}=i||{},a=(await f(`
+            query Labels($first: Int, $filter: IssueLabelFilter) {
+              issueLabels(first: $first, filter: $filter) {
+                nodes { id name color team { id key } }
+              }
+            }
+          `,{first:i?.limit||100,filter:t?{team:{id:{eq:t}}}:void 0}))?.issueLabels?.nodes||[];return JSON.stringify({count:a.length,labels:a})}case"linear_list_issues":{let{teamId:t,teamKey:e,stateId:a,stateName:n,label:r,assigneeId:o,updatedAfter:l,limit:m}=i||{},d={},c=t;!c&&e&&(c=await k(e)),c&&(d.team={id:{eq:c}}),a?d.state={id:{eq:a}}:n&&(d.state={name:{eqIgnoreCase:n}}),r&&(d.labels={name:{eqIgnoreCase:r}}),o&&(d.assignee={id:{eq:o}}),l&&(d.updatedAt={gt:l});let g=((await f(`
+            query Issues($first: Int, $filter: IssueFilter, $orderBy: PaginationOrderBy) {
+              issues(first: $first, filter: $filter, orderBy: $orderBy) {
+                nodes {
+                  id identifier number title url priority createdAt updatedAt
+                  state { id name type }
+                  assignee { id displayName }
+                  labels { nodes { name } }
+                  team { id key }
+                }
+              }
+            }
+          `,{first:m||30,filter:Object.keys(d).length?d:void 0,orderBy:"updatedAt"}))?.issues?.nodes||[]).map(u=>({id:u.id,identifier:u.identifier,number:u.number,title:u.title,url:u.url,priority:u.priority,state:u.state?.name,stateType:u.state?.type,assignee:u.assignee?.displayName||null,labels:(u.labels?.nodes||[]).map(p=>p.name),team:u.team?.key,createdAt:u.createdAt,updatedAt:u.updatedAt}));return JSON.stringify({count:g.length,issues:g})}case"linear_get_issue":{let t=i?.issueId||i?.identifier||i?.issueKey;if(!t)return JSON.stringify({error:"issueId or identifier is required"});let e=await I(t);return JSON.stringify(e?{id:e.id,identifier:e.identifier,number:e.number,title:e.title,description:e.description||"",url:e.url,priority:e.priority,state:e.state?.name,stateId:e.state?.id,stateType:e.state?.type,assignee:e.assignee?.displayName||e.assignee?.name||null,assigneeId:e.assignee?.id||null,labels:(e.labels?.nodes||[]).map(a=>a.name),team:e.team?{id:e.team.id,key:e.team.key,name:e.team.name}:null,createdAt:e.createdAt,updatedAt:e.updatedAt}:{error:`Issue not found: ${t}`})}case"linear_get_comments":{let t=i?.issueId||i?.identifier||i?.issueKey;if(!t)return JSON.stringify({error:"issueId or identifier is required"});let e=await I(t,`
+            id identifier
+            comments(first: ${Number(i?.limit)||50}) {
+              nodes { id body createdAt updatedAt user { id name displayName } }
+            }
+          `);if(!e)return JSON.stringify({error:`Issue not found: ${t}`});let a=(e.comments?.nodes||[]).map(n=>({id:n.id,author:n.user?.displayName||n.user?.name||"Unknown",body:n.body||"",createdAt:n.createdAt,updatedAt:n.updatedAt})).sort((n,r)=>String(r.createdAt).localeCompare(String(n.createdAt)));return JSON.stringify({count:a.length,issue:e.identifier,comments:a})}case"linear_add_comment":{let t=i?.issueId||i?.identifier||i?.issueKey,e=i?.body;if(!t||!e)return JSON.stringify({error:"issueId/identifier and body are required"});let a=await I(t,"id identifier");if(!a)return JSON.stringify({error:`Issue not found: ${t}`});let r=(await f(`
+            mutation AddComment($input: CommentCreateInput!) {
+              commentCreate(input: $input) {
+                success
+                comment { id url createdAt }
+              }
+            }
+          `,{input:{issueId:a.id,body:e}}))?.commentCreate;return JSON.stringify({ok:!!r?.success,commentId:r?.comment?.id,url:r?.comment?.url})}case"linear_update_state":{let t=i?.issueId||i?.identifier||i?.issueKey,{stateId:e,stateName:a,toStatus:n,status:r}=i||{};if(!t)return JSON.stringify({error:"issueId or identifier is required"});let o=await I(t,`
+            id identifier
+            state { id name type }
+            team { id key states { nodes { id name type position } } }
+          `);if(!o)return JSON.stringify({error:`Issue not found: ${t}`});let l=e,m=e?{strategy:"explicit-id"}:null;if(!l){let y=String(a||n||r||"").trim(),g=(o.team?.states?.nodes||[]).slice().sort((p,N)=>(p.position||0)-(N.position||0));if(!y)return JSON.stringify({ok:!1,error:"stateId or stateName/toStatus is required",issue:o.identifier,availableStates:g.map(p=>({id:p.id,name:p.name,type:p.type}))});let u=v(g,y);if(!u.state)return JSON.stringify({ok:!1,error:`No workflow state matches "${y}" in team ${o.team?.key}`,issue:o.identifier,availableStates:g.map(p=>({id:p.id,name:p.name,type:p.type}))});l=u.state.id,m={strategy:u.strategy,matchedName:u.state.name}}let c=(await f(`
+            mutation MoveIssue($id: String!, $input: IssueUpdateInput!) {
+              issueUpdate(id: $id, input: $input) {
+                success
+                issue { id identifier state { id name type } }
+              }
+            }
+          `,{id:o.id,input:{stateId:l}}))?.issueUpdate;return JSON.stringify({ok:!!c?.success,issue:c?.issue?.identifier||o.identifier,stateAfter:c?.issue?.state?.name||null,stateTypeAfter:c?.issue?.state?.type||null,resolution:m})}case"linear_link_attachment":{let t=i?.issueId||i?.identifier||i?.issueKey,{url:e,title:a,subtitle:n}=i||{};if(!t||!e)return JSON.stringify({error:"issueId/identifier and url are required"});let r=await I(t,"id identifier");if(!r)return JSON.stringify({error:`Issue not found: ${t}`});let l=(await f(`
+            mutation LinkAttachment($input: AttachmentCreateInput!) {
+              attachmentCreate(input: $input) {
+                success
+                attachment { id url title }
+              }
+            }
+          `,{input:{issueId:r.id,url:e,title:a||e,subtitle:n||void 0}}))?.attachmentCreate;return JSON.stringify({ok:!!l?.success,attachmentId:l?.attachment?.id,url:l?.attachment?.url})}default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(t){return JSON.stringify({error:t.message})}},tools:[{name:"linear_list_teams",description:"List Linear teams (id, key, name). Needed to scope workflow states and issue queries.",input_schema:{type:"object",properties:{limit:{type:"number",description:"Max teams (default: 50)"}}}},{name:"linear_list_states",description:"List a team's workflow states (id, name, type: backlog|unstarted|started|completed|canceled|triage). Linear states are PER-TEAM. Omit team to list all states across the workspace.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Team uuid"},teamKey:{type:"string",description:"Team key (e.g. ENG); resolved to an id if teamId omitted"},limit:{type:"number",description:"Max states when listing workspace-wide (default: 200)"}}}},{name:"linear_list_labels",description:"List issue labels, optionally scoped to a team.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Optional team uuid to scope labels"},limit:{type:"number",description:"Max labels (default: 100)"}}}},{name:"linear_list_issues",description:"List/poll Linear issues filtered by team, state, label, assignee, and an updatedAfter cursor. Returns newest-updated first.",input_schema:{type:"object",properties:{teamId:{type:"string",description:"Team uuid"},teamKey:{type:"string",description:"Team key (e.g. ENG); resolved if teamId omitted"},stateId:{type:"string",description:"Filter by workflow state uuid"},stateName:{type:"string",description:"Filter by state name (case-insensitive)"},label:{type:"string",description:"Filter by label name (case-insensitive)"},assigneeId:{type:"string",description:"Filter by assignee uuid"},updatedAfter:{type:"string",description:"ISO-8601 timestamp; only issues updated after this (polling cursor)"},limit:{type:"number",description:"Max issues (default: 30)"}}}},{name:"linear_get_issue",description:"Get a single Linear issue by identifier (e.g. ENG-123) or internal uuid \u2014 title, description, state, labels, assignee, url.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"}}}},{name:"linear_get_comments",description:"Get comments on a Linear issue (newest first).",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},limit:{type:"number",description:"Max comments (default: 50)"}}}},{name:"linear_add_comment",description:"Add a comment to a Linear issue (markdown supported).",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},body:{type:"string",description:"Comment body (markdown)"}},required:["body"]}},{name:"linear_update_state",description:"Move a Linear issue to a different workflow state. Pass a state NAME (toStatus/stateName) and the tool resolves it to the issue's team's matching state id (exact -> type-alias -> fuzzy), or pass stateId directly. Linear has no transitions \u2014 this sets the state.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},stateId:{type:"string",description:"Target workflow state uuid (skips name resolution)"},stateName:{type:"string",description:'Target state name (e.g. "In Progress", "Done")'},toStatus:{type:"string",description:"Alias for stateName"}}}},{name:"linear_link_attachment",description:"Attach a URL (e.g. a GitHub PR) to a Linear issue via native attachments. Use this for PR links; fall back to linear_add_comment if it fails.",input_schema:{type:"object",properties:{identifier:{type:"string",description:"Issue identifier, e.g. ENG-123"},issueId:{type:"string",description:"Internal issue uuid (alternative to identifier)"},url:{type:"string",description:"The URL to attach (e.g. a PR link)"},title:{type:"string",description:"Attachment title (defaults to the URL)"},subtitle:{type:"string",description:"Optional attachment subtitle"}},required:["url"]}}]};async function k(s){return(await f(`
+    query TeamByKey($filter: TeamFilter) {
+      teams(first: 1, filter: $filter) { nodes { id key } }
+    }
+  `,{filter:{key:{eq:s}}}))?.teams?.nodes?.[0]?.id||null}async function I(s,i=O){let t=String(s).trim(),e=/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/.exec(t);if(e){let n=e[1].toUpperCase(),r=Number(e[2]);return(await f(`
+      query IssueByIdentifier($filter: IssueFilter) {
+        issues(first: 1, filter: $filter) {
+          nodes { ${i} }
+        }
+      }
+    `,{filter:{number:{eq:r},team:{key:{eq:n}}}}))?.issues?.nodes?.[0]||null}return(await f(`
+    query IssueById($id: String!) {
+      issue(id: $id) { ${i} }
+    }
+  `,{id:t}))?.issue||null}var T={triage:"todo",backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",canceled:"done"},$=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function A(s){return s?s.name&&$.test(s.name)?"blocked":T[s.type]||"unknown":"unknown"}function w(s){let i=JSON.parse(s);if(i&&i.error)throw new Error(i.error);return i}function b(s){let i=s.state||null,t=s.stateType||null;return{id:String(s.id||s.identifier||""),key:s.identifier||String(s.id||""),title:s.title||"",body:s.description||"",state:i,stateCategory:A(i?{name:i,type:t}:null),assignee:s.assignee||null,url:s.url||null,_raw:s}}var C={id:"linear",toStateCategory:A,toNeutral:b,async listCandidates(s={}){let i=s.ctx||{},t={teamId:i.teamId,teamKey:i.teamKey,stateName:s.state,label:Array.isArray(s.labels)?s.labels[0]:s.labels,assigneeId:i.assigneeId,updatedAfter:s.updatedAfter,limit:s.limit};return(w(await _.handleToolCall("linear_list_issues",t)).issues||[]).map(b)},async getTicket(s){if(!s)throw new Error("key is required");let i=JSON.parse(await _.handleToolCall("linear_get_issue",{identifier:s}));return i.error?null:b(i)},async getComments(s){if(!s)throw new Error("key is required");return(w(await _.handleToolCall("linear_get_comments",{identifier:s})).comments||[]).map(t=>({id:String(t.id),author:t.author||"Unknown",body:t.body||"",createdAt:t.createdAt||null,updatedAt:t.updatedAt||null,_raw:t}))},async addComment(s,i){if(!s||!i)throw new Error("key and body are required");let t=w(await _.handleToolCall("linear_add_comment",{identifier:s,body:i}));return{ok:!!t.ok,id:t.commentId||null}},async transition(s,i){if(!s)throw new Error("key is required");let t=JSON.parse(await _.handleToolCall("linear_update_state",{identifier:s,toStatus:i}));if(!t.ok)return{ok:!1,error:t.error||"state update failed",_raw:t};let e=t.stateAfter||null;return{ok:!0,stateAfter:e,stateCategoryAfter:A(e?{name:e,type:t.stateTypeAfter}:null),_raw:t}},async linkPullRequest(s,i,t){if(!s||!i)throw new Error("key and prUrl are required");try{if(w(await _.handleToolCall("linear_link_attachment",{identifier:s,url:i,title:t||i})).ok)return{ok:!0,via:"attachment"};throw new Error("attachmentCreate returned ok:false")}catch(e){let a=`${t?`${t}: `:"Linked PR: "}${i}`;return{ok:!!w(await _.handleToolCall("linear_add_comment",{identifier:s,body:a})).ok,via:"comment",error:String(e?.message||e)}}}},J=C;export{J as default,C as linearAdapter};

package/dist/trackers/plane-adapter.js

@@ -0,0 +1 @@
+var f=(process.env.PLANE_API_URL||"https://api.plane.so/api/v1").replace(/\/+$/,""),A=process.env.PLANE_WORKSPACE_SLUG||"",w=process.env.PLANE_PROJECT_ID||"";function k(){let e=process.env.PLANE_API_KEY||process.env.PLANE_OAUTH_TOKEN;if(!e)throw new Error("Plane is not connected: set PLANE_API_KEY (personal access token).");return e}function p(e={}){let t=e.workspaceSlug||A,o=e.projectId||w;if(!t||!o)throw new Error("Plane scope missing: provide workspaceSlug + projectId (env PLANE_WORKSPACE_SLUG / PLANE_PROJECT_ID or per-call ctx).");return{workspaceSlug:t,projectId:o}}async function d(e,t={}){let o=`${f}${e}`;if(t.query&&Object.keys(t.query).length){let a=new URLSearchParams;for(let[c,i]of Object.entries(t.query))i!=null&&i!==""&&a.set(c,String(i));let n=a.toString();n&&(o+=(o.includes("?")?"&":"?")+n)}let r=await fetch(o,{method:t.method||"GET",headers:{"X-API-Key":k(),Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!r.ok){let a=await r.text().catch(()=>"");throw new Error(`Plane API ${r.status}: ${a.slice(0,300)}`)}let s=await r.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}}var P={backlog:"todo",unstarted:"todo",started:"in_progress",completed:"done",cancelled:"done"},S=/\b(blocked|on[\s-]?hold|waiting|stuck)\b/i;function u(e){return e?e.name&&S.test(e.name)?"blocked":P[e.group]||"unknown":"unknown"}var m=new Map,I=300*1e3;async function g(e){let{workspaceSlug:t,projectId:o}=p(e),r=m.get(o);if(r&&Date.now()-r.fetchedAt<I)return r.states;let s=await d(`/workspaces/${encodeURIComponent(t)}/projects/${encodeURIComponent(o)}/states/`,{query:{per_page:100}}),a=(s.results||s||[]).map(n=>({id:n.id,name:n.name,group:n.group,color:n.color}));return m.set(o,{fetchedAt:Date.now(),states:a}),a}function l(e){return String(e||"").toLowerCase().replace(/\s+/g,"").replace(/[()\-_:："'`]/g,"")}function C(e,t){let o=l(t);if(!o)return null;let r=e.find(a=>l(a.name)===o);if(r)return r;let s={todo:["todo","backlog","open","unstarted"],inprogress:["inprogress","started","doing","wip"],done:["done","completed","closed","resolved","cancelled","canceled"],blocked:["blocked","onhold","waiting"]};for(let[,a]of Object.entries(s)){if(!a.some(i=>l(i)===o))continue;let n=o==="done"?"completed":o==="inprogress"?"started":"unstarted",c=e.find(i=>i.group===n);if(c)return c}return null}async function _(e,t){let r=(await g(t).catch(()=>[])).find(i=>i.id===e.state)||null,{workspaceSlug:s,projectId:a}=p(t),n=t.projectIdentifier&&e.sequence_id!=null?`${t.projectIdentifier}-${e.sequence_id}`:e.sequence_id!=null?String(e.sequence_id):e.id,c=e.assignees||[];return{id:e.id,key:n,title:e.name||"",body:e.description_html||e.description_stripped||e.description||"",state:r?r.name:null,stateCategory:u(r),assignee:c.length?String(c[0]):null,url:t.baseWebUrl?`${t.baseWebUrl}/${s}/projects/${a}/issues/${e.id}`:null,_raw:e}}var E={id:"plane",envKeys:["PLANE_API_KEY","PLANE_OAUTH_TOKEN","PLANE_API_URL","PLANE_WORKSPACE_SLUG","PLANE_PROJECT_ID"],planeFetch:d,toStateCategory:u,async listCandidates(e={}){let t=e.ctx||{},{workspaceSlug:o,projectId:r}=p(t),s={per_page:Math.min(Number(e.limit)||50,100),cursor:e.cursor};e.state&&(s.state=e.state),e.updatedAfter&&(s.updated_at__gte=e.updatedAfter);let n=(await d(`/workspaces/${encodeURIComponent(o)}/projects/${encodeURIComponent(r)}/work-items/`,{query:s})).results||[];return e.updatedAfter&&(n=n.filter(c=>String(c.updated_at)>String(e.updatedAfter))),Promise.all(n.map(c=>_(c,t)))},async getTicket(e,t={}){let{workspaceSlug:o,projectId:r}=p(t),s=await d(`/workspaces/${encodeURIComponent(o)}/projects/${encodeURIComponent(r)}/work-items/${encodeURIComponent(e)}/`);return!s||!s.id?null:_(s,t)},async getComments(e,t={}){let{workspaceSlug:o,projectId:r}=p(t);return((await d(`/workspaces/${encodeURIComponent(o)}/projects/${encodeURIComponent(r)}/work-items/${encodeURIComponent(e)}/comments/`,{query:{per_page:100}})).results||[]).map(n=>({id:n.id,author:n.actor||n.actor_detail?.display_name||"Unknown",body:n.comment_html||n.comment_stripped||"",createdAt:n.created_at||null,updatedAt:n.updated_at||null,_raw:n})).sort((n,c)=>String(c.createdAt).localeCompare(String(n.createdAt)))},async addComment(e,t,o={}){let{workspaceSlug:r,projectId:s}=p(o),n=/<[a-z][\s\S]*>/i.test(String(t||""))?String(t):`<p>${String(t||"")}</p>`,c=await d(`/workspaces/${encodeURIComponent(r)}/projects/${encodeURIComponent(s)}/work-items/${encodeURIComponent(e)}/comments/`,{method:"POST",body:{comment_html:n}});return{ok:!!c.id,id:c.id||null,_raw:c}},async transition(e,t,o={}){let{workspaceSlug:r,projectId:s}=p(o),a=await g(o),n=C(a,t);if(!n)return{ok:!1,error:`No Plane state matches "${t}" in this project`,availableStates:a.map(i=>({id:i.id,name:i.name,group:i.group}))};let c=await d(`/workspaces/${encodeURIComponent(r)}/projects/${encodeURIComponent(s)}/work-items/${encodeURIComponent(e)}/`,{method:"PATCH",body:{state:n.id}});return{ok:!!c.id,stateAfter:n.name,stateCategoryAfter:u(n),_raw:c}},async linkPullRequest(e,t,o,r={}){let s=o?`${o}: `:"Linked PR: ";return{ok:!!(await this.addComment(e,`<p>${s}<a href="${t}">${t}</a></p>`,r)).ok,via:"comment"}}},h=E;export{h as default,E as planeAdapter,d as planeFetch,u as toStateCategory};

package/dist/trackers/types.js

@@ -0,0 +1 @@
+var o=["todo","in_progress","done","blocked","unknown"];export{o as TRACKER_STATE_CATEGORIES};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Built-in skill definitions for Zibby test automation framework",
   "type": "module",
   "main": "dist/index.js",
@@ -12,6 +12,7 @@
     "./browser": "./dist/browser.js",
     "./jira": "./dist/jira.js",
     "./github": "./dist/github.js",
+    "./plane": "./dist/plane.js",
     "./slack": "./dist/slack.js",
     "./lark": "./dist/lark.js",
     "./memory": "./dist/memory.js",