@glie/mcp-polaris 0.4.0 → 0.6.0

package/dist/index.js

@@ -220,17 +220,28 @@ var TOOLS = [
   },
   {
     name: "polaris.task.create",
-    description: "Create a task within a milestone.",
-    inputSchema: objSchema({ milestone_id: intSchema(), name: strSchema(), description_md: strSchema() }, ["milestone_id", "name"]),
+    description: "Create a task within a milestone. For a marketing CREATIVE (a task in an mkt campaign): channel + format + scheduled_date (the publish day / calendar slot) + platform (if this creative is individually paid).",
+    inputSchema: objSchema({
+      milestone_id: intSchema(),
+      name: strSchema(),
+      description_md: strSchema(),
+      status: strSchema("draft|backlog|dev|test|approval|release (default draft)"),
+      channel: strSchema("mkt: Instagram, TikTok, LinkedIn, \u2026"),
+      format: strSchema("mkt: post, reel, story, artigo, \u2026"),
+      scheduled_date: strSchema("mkt: publish day (ISO date) \u2014 the calendar slot"),
+      platform: strSchema("mkt: ad platform if this creative is individually paid"),
+      asset_url: strSchema("mkt: URL of the produced creative asset (image/video) for the reviewer")
+    }, ["milestone_id", "name"]),
     call: async (args) => (await apiCall("POST", "/api/tasks", args)).body
   },
   {
     name: "polaris.task.update",
-    description: "Correct or refine a task's spec \u2014 PATCH its description_md (and optionally name). Use this to sharpen an underspecified brief so the implementing agent gets better results; it is NOT a log of what was done (leave that as a comment). Needs a token.",
+    description: "Correct or refine a task's spec \u2014 PATCH its description_md (and optionally name). For a marketing creative, set asset_url to the produced asset (image/video) so the reviewer can download and review it. It is NOT a log of what was done (leave that as a comment). Needs a token.",
     inputSchema: objSchema({
       id: intSchema(),
       name: strSchema(),
-      description_md: strSchema("full markdown brief; replaces the current description")
+      description_md: strSchema("full markdown brief; replaces the current description"),
+      asset_url: strSchema("mkt: URL of the produced creative asset (image/video) for the reviewer")
     }, ["id"]),
     call: async (args) => {
       const body = {};
@@ -238,6 +249,8 @@ var TOOLS = [
         body.name = args.name;
       if (typeof args.description_md === "string")
         body.description_md = args.description_md;
+      if (typeof args.asset_url === "string")
+        body.asset_url = args.asset_url;
       return (await apiCall("PATCH", `/api/tasks/${args.id}`, body)).body;
     }
   },
@@ -339,12 +352,12 @@ var TOOLS = [
   },
   {
     name: "polaris.ticket.update",
-    description: "Update a ticket's type, its human assignee, and/or its guidance (the communicator's orientation on what to do/say next).",
+    description: "Update a ticket's type, its human assignee, and/or its guidance (the helpdesker's orientation on what to do/say next).",
     inputSchema: objSchema({
       id: intSchema(),
       type: strSchema("bug|question|suggestion|feedback"),
       assignee_human_id: intSchema(),
-      guidance: strSchema("The communicator's guidance on what to do/say next \u2014 orientation (e.g. create an issue, inform, reassure), researched from the customer's history + related issues. Shown to the human as advice; NOT inserted into the reply box.")
+      guidance: strSchema("The helpdesker's guidance on what to do/say next \u2014 orientation (e.g. create an issue, inform, reassure), researched from the customer's history + related issues. Shown to the human as advice; NOT inserted into the reply box.")
     }, ["id"]),
     call: async (args) => (await apiCall("PATCH", `/api/tickets/${args.id}`, {
       type: args.type,
@@ -377,20 +390,23 @@ var TOOLS = [
   },
   {
     name: "polaris.issue.open",
-    description: "Open a STANDALONE issue (no ticket needed) \u2014 e.g. an internal dev files a bug. Scope with project_key.",
-    inputSchema: objSchema({ project_key: strSchema(), title: strSchema() }, [
-      "project_key",
-      "title"
-    ]),
+    description: "Open a STANDALONE issue (no ticket needed) \u2014 e.g. an internal dev files a bug. Scope with project_key. owner_human_id = the human accountable (defaults to you).",
+    inputSchema: objSchema({ project_key: strSchema(), title: strSchema(), owner_human_id: intSchema() }, ["project_key", "title"]),
     call: async (args) => (await apiCall("POST", "/api/issues", args)).body
   },
   {
     name: "polaris.issue.update",
-    description: "Update an issue \u2014 set its title and/or assign it to an agent (assignee_agent_id, e.g. hand it to a planner).",
-    inputSchema: objSchema({ id: intSchema(), title: strSchema(), assignee_agent_id: intSchema() }, ["id"]),
+    description: "Update an issue \u2014 set its title, assign it to an agent (assignee_agent_id, e.g. hand it to a planner), and/or set its owner (owner_human_id, the accountable human).",
+    inputSchema: objSchema({
+      id: intSchema(),
+      title: strSchema(),
+      assignee_agent_id: intSchema(),
+      owner_human_id: intSchema()
+    }, ["id"]),
     call: async (args) => (await apiCall("PATCH", `/api/issues/${args.id}`, {
       title: args.title,
-      assignee_agent_id: args.assignee_agent_id
+      assignee_agent_id: args.assignee_agent_id,
+      owner_human_id: args.owner_human_id
     })).body
   },
   {
@@ -535,10 +551,10 @@ var TOOLS = [
   },
   {
     name: "polaris.agent.create",
-    description: "Create an agent/employee (human-only). function: developer|tester|planner|communicator; product = project key; team = dev|mkt; domain optional (roadmap|helpdesk|both).",
+    description: "Create an agent/employee (human-only). function: developer|tester|planner|helpdesker; product = project key; team = dev|mkt; domain optional (roadmap|helpdesk|both).",
     inputSchema: objSchema({
       agent_id_slug: strSchema("stable slug, e.g. developer-polaris-01"),
-      function: strSchema("developer|tester|planner|communicator"),
+      function: strSchema("developer|tester|planner|helpdesker"),
       product: strSchema("project key"),
       name: strSchema("friendly display name"),
       team: strSchema("dev|mkt"),
@@ -595,14 +611,41 @@ var TOOLS = [
   },
   {
     name: "polaris.milestone.create",
-    description: "Create a milestone. team = dev|mkt; end_date = deadline (ISO date, required); framework_key optional.",
+    description: "Create a milestone. team=dev|mkt; end_date = deadline (ISO date, required). For a marketing CAMPAIGN (team=mkt) these extra fields carry the plan: market (BR/US/EU), cadence (per-channel rules Discovery expands into dated creatives), max_creatives (cap on that expansion), and paid + platforms + budget for a paid campaign.",
     inputSchema: objSchema({
       project_key: strSchema(),
       name: strSchema(),
       team: strSchema("dev|mkt"),
       end_date: strSchema("ISO date, e.g. 2026-06-30"),
+      start_date: strSchema("ISO date (optional)"),
       framework_key: strSchema(),
-      description_md: strSchema()
+      description_md: strSchema(),
+      market: {
+        type: "array",
+        items: { type: "string" },
+        description: "mkt: target markets \u2014 any of BR, US, EU"
+      },
+      cadence: {
+        type: "array",
+        description: "mkt: per-channel cadence rules Discovery expands into dated creatives",
+        items: {
+          type: "object",
+          properties: {
+            channel: { type: "string", description: "Instagram, TikTok, LinkedIn, \u2026" },
+            format: { type: "string", description: "post, reel, story, artigo, \u2026" },
+            n: { type: "integer", description: "count per period" },
+            per: { type: "string", description: "day | week" }
+          }
+        }
+      },
+      max_creatives: intSchema("mkt: cap on how many creatives Discovery/cadence may generate"),
+      paid: { type: "boolean", description: "mkt: is the whole campaign paid?" },
+      platforms: {
+        type: "array",
+        items: { type: "string" },
+        description: "mkt paid: any of Meta, Google, Reddit, LinkedIn, TikTok, YouTube"
+      },
+      budget: { type: "number", description: "mkt: campaign ad-spend budget (\u20AC)" }
     }, ["project_key", "name", "team", "end_date"]),
     call: async (args) => (await apiCall("POST", "/api/milestones", args)).body
   },
@@ -666,6 +709,49 @@ var TOOLS = [
     description: "Revoke one of YOUR Personal Access Tokens. Idempotent.",
     inputSchema: objSchema({ token_id: intSchema() }, ["token_id"]),
     call: async (args) => (await apiCall("POST", `/api/humans/me/tokens/${args.token_id}/revoke`)).body
+  },
+  {
+    name: "polaris.human.me_update",
+    description: "Update YOUR human profile \u2014 link or clear your GitHub username (PATCH /api/humans/me). Pass empty string to clear.",
+    inputSchema: objSchema({ github_username: strSchema("GitHub username, or empty string to clear") }, ["github_username"]),
+    call: async (args) => (await apiCall("PATCH", "/api/humans/me", {
+      github_username: args.github_username || null
+    })).body
+  },
+  {
+    name: "polaris.team.create",
+    description: 'Create a team (human-only). requires = capability keys (e.g. ["repo"]); functions = agent functions it runs (developer|tester|planner|helpdesker).',
+    inputSchema: objSchema({
+      key: strSchema("team key, e.g. dev"),
+      name: strSchema(),
+      requires: {
+        type: "array",
+        items: { type: "string" },
+        description: 'capability keys, e.g. ["repo"]'
+      },
+      functions: {
+        type: "array",
+        items: { type: "string" },
+        description: "developer|tester|planner|helpdesker"
+      },
+      framework_key: strSchema()
+    }, ["key", "name"]),
+    call: async (args) => (await apiCall("POST", "/api/teams", args)).body
+  },
+  {
+    name: "polaris.team.update",
+    description: "Update a team (human-only): name, requires, functions, framework_key.",
+    inputSchema: objSchema({
+      key: strSchema("team key"),
+      name: strSchema(),
+      requires: { type: "array", items: { type: "string" } },
+      functions: { type: "array", items: { type: "string" } },
+      framework_key: strSchema()
+    }, ["key"]),
+    call: async (args) => {
+      const { key, ...patch } = args;
+      return (await apiCall("PATCH", `/api/teams/${key}`, patch)).body;
+    }
   }
 ];
 var TOOLS_BY_NAME = new Map(TOOLS.map((t) => [t.name, t]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Model Context Protocol (stdio) server exposing Polaris — glie's ops platform — as native tools in Claude Code and any MCP client.",
   "license": "Apache-2.0",
   "author": "glie <carlos@glie.ai>",