@zibby/skills 0.1.95 → 0.2.0

package/dist/opendesign.js

@@ -1,4 +1,4 @@
-import{existsSync as m}from"fs";import{fileURLToPath as f}from"url";import{dirname as _,resolve as y}from"path";import{resolveIntegrationToken as I}from"@zibby/core/backend-client.js";var g=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",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),O=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"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});function j(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=_(f(import.meta.url)),t=y(r,"..","bin","mcp-skill.mjs");return m(t)?t:null}async function l(){let r=await I(g.OPEN_DESIGN),t=r?.token,e=r?.baseUrl;if(!t||typeof t!="string")throw new Error("OpenDesign is not connected: missing token. Connect it in Integrations.");if(!e||typeof e!="string")throw new Error("OpenDesign is not connected: missing baseUrl. Connect it in Integrations.");let n=e.replace(/\/+$/,"");return{token:t,baseUrl:n}}async function d(r,t={}){let{token:e,baseUrl:n}=await l(),i=`${n}/api${r}`;if(t.query&&typeof t.query=="object"){let a=new URLSearchParams;for(let[h,p]of Object.entries(t.query))p!=null&&p!==""&&a.set(h,String(p));let c=a.toString();c&&(i+=(i.includes("?")?"&":"?")+c)}let o={Authorization:`Bearer ${e}`,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{}},s=await fetch(i,{method:t.method||"GET",headers:o,body:t.body?JSON.stringify(t.body):void 0});return u(s,"OpenDesign")}async function u(r,t){if(!r.ok){let n=await r.text().catch(()=>""),i=n.slice(0,300);try{let o=JSON.parse(n),s=o?.code||o?.error?.code,a=o?.message||o?.error?.message||o?.error;(s||a)&&(i=[s?`[${s}]`:null,a].filter(Boolean).join(" ")||i)}catch{}throw new Error(`${t} API ${r.status}: ${i}`)}let e=await r.text().catch(()=>"");if(!e)return{};try{return JSON.parse(e)}catch{return{raw:e}}}var T={id:"open-design",serverName:"opendesign",allowedTools:["mcp__opendesign__*"],envKeys:[],description:"OpenDesign \u2014 list projects/designs, run the design agent, and export decks to PDF/HTML",promptFragment:`## OpenDesign (optional)
+import{existsSync as m}from"fs";import{fileURLToPath as f}from"url";import{dirname as _,resolve as y}from"path";import{resolveIntegrationToken as I}from"@zibby/core/backend-client.js";var g=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",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",FIGMA:"figma",HUBSPOT:"hubspot",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),O=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"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},hubspot:{id:"hubspot",name:"HubSpot",connectPath:"/integrations?provider=hubspot"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});function j(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=_(f(import.meta.url)),n=y(r,"..","bin","mcp-skill.mjs");return m(n)?n:null}async function l(){let r=await I(g.OPEN_DESIGN),n=r?.token,e=r?.baseUrl;if(!n||typeof n!="string")throw new Error("OpenDesign is not connected: missing token. Connect it in Integrations.");if(!e||typeof e!="string")throw new Error("OpenDesign is not connected: missing baseUrl. Connect it in Integrations.");let t=e.replace(/\/+$/,"");return{token:n,baseUrl:t}}async function d(r,n={}){let{token:e,baseUrl:t}=await l(),i=`${t}/api${r}`;if(n.query&&typeof n.query=="object"){let a=new URLSearchParams;for(let[h,p]of Object.entries(n.query))p!=null&&p!==""&&a.set(h,String(p));let c=a.toString();c&&(i+=(i.includes("?")?"&":"?")+c)}let o={Authorization:`Bearer ${e}`,Accept:"application/json",...n.body?{"Content-Type":"application/json"}:{}},s=await fetch(i,{method:n.method||"GET",headers:o,body:n.body?JSON.stringify(n.body):void 0});return u(s,"OpenDesign")}async function u(r,n){if(!r.ok){let t=await r.text().catch(()=>""),i=t.slice(0,300);try{let o=JSON.parse(t),s=o?.code||o?.error?.code,a=o?.message||o?.error?.message||o?.error;(s||a)&&(i=[s?`[${s}]`:null,a].filter(Boolean).join(" ")||i)}catch{}throw new Error(`${n} API ${r.status}: ${i}`)}let e=await r.text().catch(()=>"");if(!e)return{};try{return JSON.parse(e)}catch{return{raw:e}}}var T={id:"open-design",serverName:"opendesign",allowedTools:["mcp__opendesign__*"],envKeys:[],description:"OpenDesign \u2014 list projects/designs, run the design agent, and export decks to PDF/HTML",promptFragment:`## OpenDesign (optional)
 You may have access to the user's OpenDesign workspace (the Zibby-managed design/deck app) via its REST API. These tools are OPTIONAL \u2014 if OpenDesign is not connected they will return a "not connected" error; reach for them only when the task involves OpenDesign projects, designs, or exports. Tools (mcp__opendesign__*):
 
 ### Connectivity
@@ -20,4 +20,4 @@ You may have access to the user's OpenDesign workspace (the Zibby-managed design
 
 ### Notes
 - A design artifact lookup ALWAYS needs its projectId (it scopes the query).
-- After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=j();if(!r)return{command:null,args:[],env:{},description:this.description};let t={};for(let e of this.envKeys)process.env[e]&&(t[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(r,t){try{switch(r){case"opendesign_health":{let{baseUrl:e}=await l(),n=await fetch(`${e}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await u(n,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let e=await d("/projects");return JSON.stringify(e)}case"opendesign_get_project":{let e=t?.id||t?.projectId;if(!e)return JSON.stringify({error:"id is required"});let n=await d(`/projects/${encodeURIComponent(e)}`);return JSON.stringify(n)}case"opendesign_list_designs":{let e=t?.projectId;if(!e)return JSON.stringify({error:"projectId is required"});let n=await d("/live-artifacts",{query:{projectId:e}});return JSON.stringify(n)}case"opendesign_get_design":{let e=t?.id,n=t?.projectId;if(!e)return JSON.stringify({error:"id is required"});if(!n)return JSON.stringify({error:"projectId is required"});let i=await d(`/live-artifacts/${encodeURIComponent(e)}`,{query:{projectId:n}});return JSON.stringify(i)}case"opendesign_export_pdf":{let e=t?.projectId||t?.id,{fileName:n,title:i,deck:o}=t||{};if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"fileName is required"});let s={fileName:n};i!==void 0&&(s.title=i),o!==void 0&&(s.deck=o);let a=await d(`/projects/${encodeURIComponent(e)}/export/pdf`,{method:"POST",body:s});return JSON.stringify(a)}case"opendesign_export_html":{let e=t?.projectId||t?.id,n=t?.path;if(!e)return JSON.stringify({error:"projectId is required"});if(!n)return JSON.stringify({error:"path is required (the export sub-path)"});let o=String(n).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),s=await d(`/projects/${encodeURIComponent(e)}/export/${o}`,{query:{inline:1}});return JSON.stringify(s)}case"opendesign_cli_run":{let{agentId:e,message:n,projectId:i,conversationId:o,model:s}=t||{};if(!e)return JSON.stringify({error:"agentId is required"});if(!n)return JSON.stringify({error:"message is required"});let a={agentId:e,message:n};i!==void 0&&(a.projectId=i),o!==void 0&&(a.conversationId=o),s!==void 0&&(a.model=s);let c=await d("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let e=t?.id||t?.runId;if(!e)return JSON.stringify({error:"id (runId) is required"});let n=await d(`/runs/${encodeURIComponent(e)}`);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"opendesign_health",description:"Probe the OpenDesign instance (GET /api/health, no auth). Use to confirm connectivity before other calls.",input_schema:{type:"object",properties:{}}},{name:"opendesign_list_projects",description:"List the projects in the OpenDesign workspace.",input_schema:{type:"object",properties:{}}},{name:"opendesign_get_project",description:"Get a single OpenDesign project by id.",input_schema:{type:"object",properties:{id:{type:"string",description:"The project id."}},required:["id"]}},{name:"opendesign_list_designs",description:"List the live design artifacts in an OpenDesign project. Requires the projectId, which scopes the query.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id whose designs to list."}},required:["projectId"]}},{name:"opendesign_get_design",description:"Get a single live design artifact by id. Requires both the design id and its projectId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The live-artifact (design) id."},projectId:{type:"string",description:"The project id the design belongs to (scopes the lookup)."}},required:["id","projectId"]}},{name:"opendesign_export_pdf",description:"Export an OpenDesign project deck to PDF. Returns the export result (e.g. a download URL/path).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},fileName:{type:"string",description:"The output PDF file name."},title:{type:"string",description:"Optional deck title for the PDF."},deck:{description:"Optional deck payload/override to render instead of the project's current deck."}},required:["projectId","fileName"]}},{name:"opendesign_export_html",description:"Fetch an OpenDesign project's HTML export by sub-path (requested inline). Requires projectId and the export path.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},path:{type:"string",description:'The export sub-path under /projects/:id/export/ (e.g. "index.html" or a slide path).'}},required:["projectId","path"]}},{name:"opendesign_cli_run",description:"Start an OpenDesign agent run. Returns a runId; poll opendesign_cli_status with it until the run finishes.",input_schema:{type:"object",properties:{agentId:{type:"string",description:"The OpenDesign agent id to run."},message:{type:"string",description:"The instruction/message to send to the agent."},projectId:{type:"string",description:"Optional project id to scope the run to."},conversationId:{type:"string",description:"Optional conversation id to continue an existing thread."},model:{type:"string",description:"Optional model id override for the run."}},required:["agentId","message"]}},{name:"opendesign_cli_status",description:"Poll the status of an OpenDesign agent run by its runId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The runId returned by opendesign_cli_run."}},required:["id"]}}]};export{T as opendesignSkill};
+- After opendesign_cli_run, poll opendesign_cli_status with the returned runId until the run is no longer running.`,resolve(){let r=j();if(!r)return{command:null,args:[],env:{},description:this.description};let n={};for(let e of this.envKeys)process.env[e]&&(n[e]=process.env[e]);return{type:"stdio",command:"node",args:[r,"../dist/opendesign.js","opendesignSkill"],env:n,description:this.description,alwaysLoad:!0}},async handleToolCall(r,n){try{switch(r){case"opendesign_health":{let{baseUrl:e}=await l(),t=await fetch(`${e}/api/health`,{method:"GET",headers:{Accept:"application/json"}}),i=await u(t,"OpenDesign");return JSON.stringify({ok:!0,health:i})}case"opendesign_list_projects":{let e=await d("/projects");return JSON.stringify(e)}case"opendesign_get_project":{let e=n?.id||n?.projectId;if(!e)return JSON.stringify({error:"id is required"});let t=await d(`/projects/${encodeURIComponent(e)}`);return JSON.stringify(t)}case"opendesign_list_designs":{let e=n?.projectId;if(!e)return JSON.stringify({error:"projectId is required"});let t=await d("/live-artifacts",{query:{projectId:e}});return JSON.stringify(t)}case"opendesign_get_design":{let e=n?.id,t=n?.projectId;if(!e)return JSON.stringify({error:"id is required"});if(!t)return JSON.stringify({error:"projectId is required"});let i=await d(`/live-artifacts/${encodeURIComponent(e)}`,{query:{projectId:t}});return JSON.stringify(i)}case"opendesign_export_pdf":{let e=n?.projectId||n?.id,{fileName:t,title:i,deck:o}=n||{};if(!e)return JSON.stringify({error:"projectId is required"});if(!t)return JSON.stringify({error:"fileName is required"});let s={fileName:t};i!==void 0&&(s.title=i),o!==void 0&&(s.deck=o);let a=await d(`/projects/${encodeURIComponent(e)}/export/pdf`,{method:"POST",body:s});return JSON.stringify(a)}case"opendesign_export_html":{let e=n?.projectId||n?.id,t=n?.path;if(!e)return JSON.stringify({error:"projectId is required"});if(!t)return JSON.stringify({error:"path is required (the export sub-path)"});let o=String(t).replace(/^\/+/,"").split("/").map(a=>encodeURIComponent(a)).join("/"),s=await d(`/projects/${encodeURIComponent(e)}/export/${o}`,{query:{inline:1}});return JSON.stringify(s)}case"opendesign_cli_run":{let{agentId:e,message:t,projectId:i,conversationId:o,model:s}=n||{};if(!e)return JSON.stringify({error:"agentId is required"});if(!t)return JSON.stringify({error:"message is required"});let a={agentId:e,message:t};i!==void 0&&(a.projectId=i),o!==void 0&&(a.conversationId=o),s!==void 0&&(a.model=s);let c=await d("/runs",{method:"POST",body:a});return JSON.stringify(c)}case"opendesign_cli_status":{let e=n?.id||n?.runId;if(!e)return JSON.stringify({error:"id (runId) is required"});let t=await d(`/runs/${encodeURIComponent(e)}`);return JSON.stringify(t)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(e){return JSON.stringify({error:e.message})}},tools:[{name:"opendesign_health",description:"Probe the OpenDesign instance (GET /api/health, no auth). Use to confirm connectivity before other calls.",input_schema:{type:"object",properties:{}}},{name:"opendesign_list_projects",description:"List the projects in the OpenDesign workspace.",input_schema:{type:"object",properties:{}}},{name:"opendesign_get_project",description:"Get a single OpenDesign project by id.",input_schema:{type:"object",properties:{id:{type:"string",description:"The project id."}},required:["id"]}},{name:"opendesign_list_designs",description:"List the live design artifacts in an OpenDesign project. Requires the projectId, which scopes the query.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id whose designs to list."}},required:["projectId"]}},{name:"opendesign_get_design",description:"Get a single live design artifact by id. Requires both the design id and its projectId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The live-artifact (design) id."},projectId:{type:"string",description:"The project id the design belongs to (scopes the lookup)."}},required:["id","projectId"]}},{name:"opendesign_export_pdf",description:"Export an OpenDesign project deck to PDF. Returns the export result (e.g. a download URL/path).",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},fileName:{type:"string",description:"The output PDF file name."},title:{type:"string",description:"Optional deck title for the PDF."},deck:{description:"Optional deck payload/override to render instead of the project's current deck."}},required:["projectId","fileName"]}},{name:"opendesign_export_html",description:"Fetch an OpenDesign project's HTML export by sub-path (requested inline). Requires projectId and the export path.",input_schema:{type:"object",properties:{projectId:{type:"string",description:"The project id to export."},path:{type:"string",description:'The export sub-path under /projects/:id/export/ (e.g. "index.html" or a slide path).'}},required:["projectId","path"]}},{name:"opendesign_cli_run",description:"Start an OpenDesign agent run. Returns a runId; poll opendesign_cli_status with it until the run finishes.",input_schema:{type:"object",properties:{agentId:{type:"string",description:"The OpenDesign agent id to run."},message:{type:"string",description:"The instruction/message to send to the agent."},projectId:{type:"string",description:"Optional project id to scope the run to."},conversationId:{type:"string",description:"Optional conversation id to continue an existing thread."},model:{type:"string",description:"Optional model id override for the run."}},required:["agentId","message"]}},{name:"opendesign_cli_status",description:"Poll the status of an OpenDesign agent run by its runId.",input_schema:{type:"object",properties:{id:{type:"string",description:"The runId returned by opendesign_cli_run."}},required:["id"]}}]};export{T as opendesignSkill};

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.95",
+  "version": "0.2.0",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",
@@ -141,6 +141,7 @@
     "esbuild": "^0.28.0",
     "eslint": "^10.0.2",
     "globals": "^17.4.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@types/node": "^20.14.0"
   }
 }

package/dist/plane.d.ts

@@ -1,24 +1,40 @@
-export namespace planeSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let requiresIntegration: "plane";
-    let envKeys: string[];
-    let description: string;
-    let tools: any[];
-    let promptFragment: string;
-    /**
-     * Spawn the official Plane MCP server over stdio. Reads the api-key
-     * credentials from the env the backend injected (PLANE_API_KEY /
-     * PLANE_WORKSPACE_SLUG / PLANE_BASE_URL). PLANE_BASE_URL is optional —
-     * omitted means the MCP server defaults to https://api.plane.so
-     * (Plane Cloud); set it for self-hosted / Zibby-hosted instances.
-     */
-    function resolve(): {
-        type: string;
-        command: string;
-        args: string[];
-        env: {};
-        description: string;
-    };
-}
+/**
+ * Plane skill — plugs in the OFFICIAL Plane MCP server.
+ *
+ * Unlike jira.js / github.js (which hand-write every tool against the
+ * provider REST API), this skill is a pure MCP plug-in: it spawns the
+ * official `makeplane/plane-mcp-server` over stdio and exposes ALL of
+ * its ~100+ tools (projects, work items CRUD + search, cycles, modules,
+ * comments, epics, labels, states, pages, workspaces, …) to the agent
+ * via the `mcp__plane__*` wildcard allowlist. There is deliberately NO
+ * `tools: [...]` array and NO `handleToolCall` — the MCP server is the
+ * single source of truth for the tool surface, so it stays current with
+ * upstream without us re-implementing anything.
+ *
+ * Run path (documented stdio entrypoint): `uvx plane-mcp-server stdio`.
+ * (A Dockerfile + npx remote also exist upstream; uvx is the canonical
+ * stdio path.) `uvx` must be available in the agent runtime — see the
+ * "TO GO LIVE" note in the skill's README/handoff.
+ *
+ * Auth + endpoint (api-key style, mirrors github/sentry credential shape):
+ *   - PLANE_API_KEY        (required) static workspace/personal API key
+ *   - PLANE_WORKSPACE_SLUG (required for stdio) the workspace to operate on
+ *   - PLANE_BASE_URL       (optional) the Plane API base URL
+ *
+ * Base URL is CONFIGURABLE so a single skill covers all three hosting
+ * models with no code change:
+ *   - Plane Cloud:        https://api.plane.so   (the default)
+ *   - Self-hosted Plane:  https://plane.acme.com/api  (the instance's API base)
+ *   - Zibby-app-hosted:   the Zibby-managed instance's API base URL
+ * The value flows through the integration credential (baseUrl) or the
+ * PLANE_BASE_URL env var; when absent the MCP server falls back to
+ * api.plane.so. Never hardcode the host in a tool call.
+ *
+ * Credential plumbing matches jira/github: the backend resolves the
+ * connected-integration credentials and injects them into the Fargate
+ * task env (PLANE_API_KEY / PLANE_WORKSPACE_SLUG / PLANE_BASE_URL).
+ * resolve() reads them straight from process.env — exactly like
+ * jiraSkill.resolve() reads ATLASSIAN_ACCESS_TOKEN. Local dev can set
+ * the same env vars directly.
+ */
+export declare const planeSkill: any;

package/dist/report.d.ts

@@ -1,79 +1,33 @@
 /**
- * Convert a report-object → Slack Block-Kit `blocks` array.
+ * report — universal "rich digest" structured object + per-destination
+ * renderers.
  *
- * Pure function: input → output, no I/O. Throws on invalid input
- * (zod parse error). Callers should validate before calling if they
- * want softer error messages.
+ * Why this lives in @zibby/skills (not workflow-templates):
  *
- * @param {z.infer<typeof reportObjectSchema>} report
- * @returns {Object[]} Block Kit blocks suitable for chat.postMessage's
- *                    `blocks` field.
- */
-export function reportToBlockKit(report: z.infer<typeof reportObjectSchema>): any[];
-/**
- * Convert a report-object → Lark interactive-card JSON.
+ *   - The SCHEMA is the contract between any producer (analyze nodes
+ *     in digest workflows) and any consumer (notify-slack /
+ *     notify-lark / future notify-notion / etc.). Centralizing it here
+ *     keeps producer and consumer in lockstep without circular
+ *     dependencies between sibling templates.
  *
- * @param {z.infer<typeof reportObjectSchema>} report
- * @returns {Object} Lark message card payload — use as `card` field on
- *                   im/v1/messages with msg_type=interactive.
- */
-export function reportToLarkCard(report: z.infer<typeof reportObjectSchema>): any;
-/**
- * Convert a report-object → Notion blocks payload.
- *
- * Returns three things rather than just `blocks` because Notion's
- * page-create endpoint takes title + icon as page properties (separate
- * from the children blocks). Callers wire them as:
- *   POST /v1/pages
- *     { parent: { database_id }, properties: { Name: { title: [...] } },
- *       icon: { type: 'emoji', emoji }, children: blocks }
- * — or, for append-to-existing-page:
- *   PATCH /v1/blocks/{pageId}/children
- *     { children: blocks }
- * (the title + icon are dropped when appending).
+ *   - The RENDERERS (reportToBlockKit, reportToLarkCard) are
+ *     deterministic functions — pure mapping from report-object to the
+ *     destination's native rich-card spec. They can be unit-tested in
+ *     isolation; the notify-* templates wire them into their execute
+ *     paths.
  *
- * Pure function: input → output, no I/O. Throws on invalid input
- * (zod parse error). Notion's block schema documented at:
- *   https://developers.notion.com/reference/block
+ *   - Adding `notify-notion` later means writing a `reportToNotionBlocks`
+ *     here, then a thin template node that imports it. No changes to
+ *     existing templates or the schema.
  *
- * @param {z.infer<typeof reportObjectSchema>} report
- * @returns {{ blocks: Object[], title: string, icon?: string }}
- *   blocks: array of Notion block objects (no `id` / `parent` — those
- *           are server-assigned at create time)
- *   title:  string for the page's Name title property
- *   icon:   optional severity-mapped emoji for the page icon
+ * Format: 6 section kinds — headline, trend, table, callouts,
+ * breakdown, paragraph. Each section is rendered to native Slack
+ * Block-Kit / Lark-Card components. NO third-party chart-rendering,
+ * NO image generation — we rely on the IM platform's native UI.
  */
-export function reportToNotionBlocks(report: z.infer<typeof reportObjectSchema>): {
-    blocks: any[];
-    title: string;
-    icon?: string;
-};
-/**
- * Convert a report-object → a single markdown string.
- *
- * This is the SHARED path for the document channels (Google Docs / Lark
- * Docs / Notion via their create/append tools, which all accept markdown):
- * one renderer, three destinations, each destination's own
- * markdown-to-native converter does the final mapping. Layout mirrors the
- * chat-card renderers 1:1 so a report reads the same everywhere:
- *   - title as `#`, subtitle as a plain line under it
- *   - headline: bold primary + delta arrow + severity emoji + summary
- *   - trend: fenced code block with the same unicodeBar lines
- *   - table: a real markdown pipe table
- *   - callouts: severity-emoji bullets
- *   - breakdown: bold-label bullets
- *   - paragraph: text as-is
- *   - footer: markdown links
- *
- * Pure function: input → output, no I/O. Throws on invalid input
- * (zod parse error) — same contract as the other renderers.
- *
- * @param {z.infer<typeof reportObjectSchema>} report
- * @returns {string} full markdown document
- */
-export function reportToMarkdown(report: z.infer<typeof reportObjectSchema>): string;
-export const SEVERITIES: readonly ["ok", "info", "warn", "critical"];
-export const reportObjectSchema: z.ZodObject<{
+import { z } from 'zod';
+export declare const SEVERITIES: readonly ["ok", "info", "warn", "critical"];
+export declare const reportObjectSchema: z.ZodObject<{
     title: z.ZodString;
     subtitle: z.ZodOptional<z.ZodString>;
     headline: z.ZodObject<{
@@ -83,30 +37,30 @@ export const reportObjectSchema: z.ZodObject<{
             direction: z.ZodOptional<z.ZodEnum<["up", "down", "flat"]>>;
             severity: z.ZodOptional<z.ZodEnum<["ok", "info", "warn", "critical"]>>;
         }, "strip", z.ZodTypeAny, {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         }, {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         }>>;
         summary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         summary?: string;
         primary?: string;
         delta?: {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         };
     }, {
         summary?: string;
         primary?: string;
         delta?: {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         };
     }>;
     sections: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -117,18 +71,18 @@ export const reportObjectSchema: z.ZodObject<{
         highlight: z.ZodOptional<z.ZodDefault<z.ZodEnum<["last", "max", "min", "none"]>>>;
         severity: z.ZodOptional<z.ZodEnum<["ok", "info", "warn", "critical"]>>;
     }, "strip", z.ZodTypeAny, {
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     }, {
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"table">;
@@ -153,12 +107,12 @@ export const reportObjectSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     }, {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"breakdown">;
@@ -170,32 +124,32 @@ export const reportObjectSchema: z.ZodObject<{
             severity: z.ZodOptional<z.ZodEnum<["ok", "info", "warn", "critical"]>>;
         }, "strip", z.ZodTypeAny, {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }, {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     }, {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"paragraph">;
@@ -210,11 +164,11 @@ export const reportObjectSchema: z.ZodObject<{
         text?: string;
         kind?: "paragraph";
     }>]>, "many">>, ({
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     } | {
         title?: string;
@@ -224,27 +178,27 @@ export const reportObjectSchema: z.ZodObject<{
     } | {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     } | {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
         title?: string;
         text?: string;
         kind?: "paragraph";
     })[], ({
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     } | {
         title?: string;
@@ -254,16 +208,16 @@ export const reportObjectSchema: z.ZodObject<{
     } | {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     } | {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
         title?: string;
@@ -282,22 +236,22 @@ export const reportObjectSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     title?: string;
+    subtitle?: string;
     headline?: {
         summary?: string;
         primary?: string;
         delta?: {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         };
     };
-    subtitle?: string;
     sections?: ({
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     } | {
         title?: string;
@@ -307,16 +261,16 @@ export const reportObjectSchema: z.ZodObject<{
     } | {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     } | {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
         title?: string;
@@ -329,22 +283,22 @@ export const reportObjectSchema: z.ZodObject<{
     };
 }, {
     title?: string;
+    subtitle?: string;
     headline?: {
         summary?: string;
         primary?: string;
         delta?: {
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             direction?: "flat" | "up" | "down";
-            severity?: "ok" | "info" | "warn" | "critical";
         };
     };
-    subtitle?: string;
     sections?: ({
-        title?: string;
         values?: number[];
-        labels?: string[];
-        severity?: "ok" | "info" | "warn" | "critical";
+        title?: string;
+        severity?: "warn" | "info" | "ok" | "critical";
         kind?: "trend";
+        labels?: string[];
         highlight?: "none" | "last" | "max" | "min";
     } | {
         title?: string;
@@ -354,16 +308,16 @@ export const reportObjectSchema: z.ZodObject<{
     } | {
         title?: string;
         kind?: "callouts";
-        tone?: "ok" | "info" | "warn" | "critical";
+        tone?: "warn" | "info" | "ok" | "critical";
         items?: string[];
     } | {
         title?: string;
         kind?: "breakdown";
         rows?: {
             sub?: string;
+            severity?: "warn" | "info" | "ok" | "critical";
             value?: string;
             label?: string;
-            severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
         title?: string;
@@ -375,4 +329,93 @@ export const reportObjectSchema: z.ZodObject<{
         rerunUrl?: string;
     };
 }>;
-import { z } from 'zod';
+/**
+ * Convert a report-object → Slack Block-Kit `blocks` array.
+ *
+ * Pure function: input → output, no I/O. Throws on invalid input
+ * (zod parse error). Callers should validate before calling if they
+ * want softer error messages.
+ *
+ * @param {z.infer<typeof reportObjectSchema>} report
+ * @returns {Object[]} Block Kit blocks suitable for chat.postMessage's
+ *                    `blocks` field.
+ */
+export declare function reportToBlockKit(report: any): any[];
+/**
+ * Convert a report-object → Lark interactive-card JSON.
+ *
+ * @param {z.infer<typeof reportObjectSchema>} report
+ * @returns {Object} Lark message card payload — use as `card` field on
+ *                   im/v1/messages with msg_type=interactive.
+ */
+export declare function reportToLarkCard(report: any): {
+    config: {
+        wide_screen_mode: boolean;
+    };
+    header: {
+        title: {
+            tag: string;
+            content: string;
+        };
+        subtitle: {
+            tag: string;
+            content: string;
+        };
+        template: string;
+    };
+    elements: any[];
+};
+/**
+ * Convert a report-object → Notion blocks payload.
+ *
+ * Returns three things rather than just `blocks` because Notion's
+ * page-create endpoint takes title + icon as page properties (separate
+ * from the children blocks). Callers wire them as:
+ *   POST /v1/pages
+ *     { parent: { database_id }, properties: { Name: { title: [...] } },
+ *       icon: { type: 'emoji', emoji }, children: blocks }
+ * — or, for append-to-existing-page:
+ *   PATCH /v1/blocks/{pageId}/children
+ *     { children: blocks }
+ * (the title + icon are dropped when appending).
+ *
+ * Pure function: input → output, no I/O. Throws on invalid input
+ * (zod parse error). Notion's block schema documented at:
+ *   https://developers.notion.com/reference/block
+ *
+ * @param {z.infer<typeof reportObjectSchema>} report
+ * @returns {{ blocks: Object[], title: string, icon?: string }}
+ *   blocks: array of Notion block objects (no `id` / `parent` — those
+ *           are server-assigned at create time)
+ *   title:  string for the page's Name title property
+ *   icon:   optional severity-mapped emoji for the page icon
+ */
+export declare function reportToNotionBlocks(report: any): {
+    blocks: any[];
+    title: string;
+    icon: "🟢" | "ℹ️" | "⚠️" | "🚨";
+};
+/**
+ * Convert a report-object → a single markdown string.
+ *
+ * This is the SHARED path for the document channels (Google Docs / Lark
+ * Docs / Notion via their create/append tools, which all accept markdown):
+ * one renderer, three destinations, each destination's own
+ * markdown-to-native converter does the final mapping. Layout mirrors the
+ * chat-card renderers 1:1 so a report reads the same everywhere:
+ *   - title as `#`, subtitle as a plain line under it
+ *   - headline: bold primary + delta arrow + severity emoji + summary
+ *   - trend: fenced code block with the same unicodeBar lines
+ *   - table: a real markdown pipe table
+ *   - callouts: severity-emoji bullets
+ *   - breakdown: bold-label bullets
+ *   - paragraph: text as-is
+ *   - footer: markdown links
+ *
+ * Pure function: input → output, no I/O. Throws on invalid input
+ * (zod parse error) — same contract as the other renderers.
+ *
+ * @param {z.infer<typeof reportObjectSchema>} report
+ * @returns {string} full markdown document
+ */
+export declare function reportToMarkdown(report: any): string;

package/dist/review-dedup.d.ts

@@ -3,15 +3,17 @@
  * line-number references (they shift between commits), strip markdown emphasis,
  * collapse whitespace, lowercase, cap length. Line-INDEPENDENT on purpose.
  */
-export function normalizeBody(body: any): string;
+export declare function normalizeBody(body: any): string;
 /** Content fingerprint of an inline finding — path + normalized body (NO line). */
-export function fingerprint(path: any, body: any): any;
+export declare function fingerprint(path: any, body: any): string;
 /** Hidden marker appended to a posted inline comment. */
-export function fpMarker(fp: any): string;
+export declare function fpMarker(fp: any): string;
+/** Hidden marker on the review SUMMARY note (so it's updated, not re-posted). */
+export declare const SUMMARY_MARKER = "\n\n<!-- zbreview-summary -->";
 /** Pull the fingerprint out of an existing comment body, or null. */
-export function extractFp(body: any): string;
+export declare function extractFp(body: any): string;
 /** Does this body carry the review-summary marker? */
-export function hasSummaryMarker(body: any): boolean;
+export declare function hasSummaryMarker(body: any): boolean;
 /**
  * Split an incoming inline-comment list into { toPost, skipped } given the
  * fingerprints ALREADY present on the MR/PR. Each toPost body gets the marker
@@ -19,9 +21,7 @@ export function hasSummaryMarker(body: any): boolean;
  * @param {Array<{path,body,...}>} comments
  * @param {Iterable<string>} existingFps
  */
-export function dedupeInline(comments: any, existingFps: Iterable<string>): {
+export declare function dedupeInline(comments: any, existingFps: any): {
     toPost: any[];
     skipped: number;
 };
-/** Hidden marker on the review SUMMARY note (so it's updated, not re-posted). */
-export const SUMMARY_MARKER: "\n\n<!-- zbreview-summary -->";