@glie/mcp-polaris 0.19.0 → 0.21.0

package/README.md

@@ -63,7 +63,9 @@ approval Release Candidate flow), `polaris.agent.*`, `polaris.team.*`,
 `open`, `transition`, `add_task`). N tickets can dedup onto one issue, and one issue
 fans out into N tasks. A reply carries files through `attachment_ids`: upload each
 one to `POST /api/tickets/:id/attachments` first (this server does not carry bytes),
-then paste its `marker` into `body_md` to draw it inside the message.
+then paste its `marker` into `body_md` to draw it inside the message. `reply` with
+`internal: true` writes an internal NOTE instead: what you checked or suspect, in the
+thread for whoever works the ticket next and never sent to the customer.
 
 **Context, read-only.** `polaris.activity.list` (what happened),
 `polaris.chat.get` / `polaris.chat.messages` (comments agents left on a scope),

package/dist/index.js

@@ -30,7 +30,7 @@ var INLINE_MIMES = new Set([
 ]);
 
 // ../../src/mcp/index.ts
-var VERSION = "0.19.0";
+var VERSION = "0.21.0";
 var FRAMEWORK_KEY_DOC = "optional \u2014 a key from polaris.framework.list. Leave it out when none applies: a framework is for founding a large domain, and most milestones take none. An unknown key is refused (400) with the keys that exist.";
 var BASE = process.env.POLARIS_URL ?? "http://127.0.0.1:7843";
 var TOKEN = process.env.POLARIS_TOKEN ?? "";
@@ -118,6 +118,7 @@ var INSTRUCTIONS = [
   '\u2022 "This milestone was only a hunch" \u2192 polaris.milestone.demote \u2014 back to the idea list, only while it has no tasks (human-only)',
   `\u2022 "Triage support / what's waiting?" \u2192 polaris.ticket.list (status, project_key) \u2014 P1 first`,
   '\u2022 "Reply to a customer / hand off"  \u2192 polaris.ticket.reply then polaris.ticket.pass(to)',
+  '\u2022 "Leave the next person a note"    \u2192 polaris.ticket.reply with internal=true \u2014 what you checked or suspect, in the thread, never sent to the customer (it moves no counter, no ball, no status)',
   '\u2022 "Turn a report into work"         \u2192 polaris.ticket.frame_issue \u2192 polaris.issue.add_task \xD7N (framing is HUMAN-only; the helpdesker proposes it)',
   '\u2022 "Same bug reported again"         \u2192 polaris.ticket.link_issue (dedup onto the open issue; HUMAN-only) \u2192 say we already have it \u2192 close the duplicate ticket',
   "",
@@ -445,7 +446,7 @@ var TOOLS = [
   },
   {
     name: "polaris.task.list",
-    description: `Find tasks \u2014 the agent's entry point. Pass assignee_agent_id="self" (or assignee_human_id="self" for a human) to get what is YOURS; add status=dev (etc.) to see only active work. Other filters: milestone_id (or "none" for the standalone tasks, which have no milestone), product_key, team.`,
+    description: 'Find tasks \u2014 the agent\'s entry point. Pass assignee_agent_id="self" (or assignee_human_id="self" for a human) to get what is YOURS; add status=dev (etc.) to see only active work. Other filters: milestone_id (or "none" for the standalone tasks, which have no milestone), product_key, team, and q to find a task or creative by its name or by the title it publishes with. Each row carries `published_title`.',
     inputSchema: objSchema({
       status: strSchema("comma-separated subset of: draft,backlog,dev,test,approval,release,done,canceled"),
       milestone_id: strSchema('a milestone id, or "none" for the standalone tasks (no milestone)'),
@@ -453,6 +454,7 @@ var TOOLS = [
       team: strSchema("dev|mkt"),
       assignee_agent_id: strSchema('agent id, or "self" for the calling agent'),
       assignee_human_id: strSchema('human id, or "self" for the calling human'),
+      q: strSchema("words to find in the task's name or published title (article title, or the cover's title " + "of the newest ready version) \u2014 every word must appear, in any order; case and accents " + 'are ignored. "#2876" also matches the task with that id.'),
       limit: intSchema()
     }),
     call: async (args) => {
@@ -464,6 +466,7 @@ var TOOLS = [
         "team",
         "assignee_agent_id",
         "assignee_human_id",
+        "q",
         "limit"
       ]) {
         const v = args[k];
@@ -697,12 +700,17 @@ var TOOLS = [
         type: "array",
         items: { type: "integer" },
         description: "Ids from the attachment upload above (or from ticket.attachment_list, where sent=false). They ride on THIS message and become visible with it."
+      },
+      internal: {
+        type: "boolean",
+        description: "true writes an INTERNAL NOTE instead of a reply: it lands in the thread for whoever works the ticket next (what you checked, what you suspect, what you did elsewhere) and is never sent to the customer. A note is not part of the conversation, so it moves no counter, no ball and no status. Always on the team side."
       }
     }, ["id", "body_md"]),
     call: async (args) => (await apiCall("POST", `/api/tickets/${args.id}/messages`, {
       body_md: args.body_md,
       side: args.side,
-      attachment_ids: args.attachment_ids
+      attachment_ids: args.attachment_ids,
+      internal: args.internal
     })).body
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.19.0",
+  "version": "0.21.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>",