@glie/mcp-polaris 0.13.0 → 0.14.0

package/dist/index.js

@@ -95,6 +95,9 @@ var INSTRUCTIONS = [
   `\u2022 "It's reviewed, ship it"        \u2192 polaris.task.approve (human-only); ship several together via polaris.stack.* \u2192 stack.release`,
   `\u2022 "My task is stuck in a blocked stack" \u2192 fix the conflict on YOUR branch (rebase agent/task-N onto dev, push) \u2014 the rc PR flips to ready automatically. A stacked task can't advance individually; never merge the rc PR by hand.`,
   '\u2022 "Break a milestone into tasks"  \u2192 polaris.milestone.qa_list / qa_answer (while in discovery)',
+  '\u2022 "Jot something down for later" \u2192 polaris.idea.create (a title is enough). NO dates: an idea is not a milestone.',
+  '\u2022 "What have we already thought of?" \u2192 polaris.idea.list \u2014 read it before proposing work; it also holds what was turned down',
+  '\u2022 "This idea is now real"        \u2192 polaris.idea.promote (needs end_date + team) \u2014 the one door from the idea list to the timeline',
   `\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 "Turn a report into work"         \u2192 polaris.ticket.frame_issue \u2192 polaris.issue.add_task \xD7N (framing is HUMAN-only; the helpdesker proposes it)',
@@ -162,16 +165,97 @@ var TOOLS = [
   },
   {
     name: "polaris.project.arm",
-    description: "Arm a project for auto-approval (human-only): while armed, dev work that reaches `approval` CLEAN is approved on your behalf \u2014 no per-task click \u2014 and follows the normal path to release. Escalated tasks, mkt creatives, and support work still wait for a person; a merge that fails leaves the task in `approval`. Idempotent.",
+    description: "Arm a project for auto-approval (human-only): while armed, a task an agent writes in `draft` (discovery's batch, a campaign's pieces) is approved into `backlog` on your behalf, with no per-task click. Tasks a person creates by hand and support work still wait in `draft`. `approval \u2192 release` is never automatic. Not retroactive: drafts already there stay. Idempotent.",
     inputSchema: objSchema({ key: strSchema("project key (e.g. saasA)") }, ["key"]),
     call: async (args) => (await apiCall("POST", `/api/projects/${args.key}/arm`)).body
   },
   {
     name: "polaris.project.disarm",
-    description: "Disarm a project (human-only). Immediate effect: the next task to reach `approval` waits for a person again. Work already parked in `approval` is untouched. Idempotent.",
+    description: "Disarm a project (human-only). Immediate effect: the next task an agent writes in `draft` waits for a person again. Tasks already moved to `backlog` stay there. Idempotent.",
     inputSchema: objSchema({ key: strSchema("project key (e.g. saasA)") }, ["key"]),
     call: async (args) => (await apiCall("POST", `/api/projects/${args.key}/disarm`)).body
   },
+  {
+    name: "polaris.idea.list",
+    description: "List a project's IDEAS \u2014 what might matter later, before it has a date. An idea is not a milestone: no dates, no tasks, never on the timeline. Read this before proposing new work: it is where the things already thought of (and the things already turned down) live. Optional status filter: open|promoted|dropped.",
+    inputSchema: objSchema({
+      project_key: strSchema("project key (e.g. saasA)"),
+      status: strSchema("open|promoted|dropped")
+    }, ["project_key"]),
+    call: async (args) => {
+      const qs = typeof args.status === "string" ? `?status=${args.status}` : "";
+      return (await apiCall("GET", `/api/projects/${args.project_key}/ideas${qs}`)).body;
+    }
+  },
+  {
+    name: "polaris.idea.create",
+    description: "Capture an idea in a project. The title is the only required field \u2014 capturing has to cost less than losing the idea. No dates: if it has a deadline it is a milestone, so use polaris.milestone.create instead. Needs a token.",
+    inputSchema: objSchema({
+      project_key: strSchema("project key (e.g. saasA)"),
+      title: strSchema("one line \u2014 what the idea is"),
+      note_md: strSchema("optional: what it is and why now; becomes the milestone's description on promotion"),
+      team: strSchema("optional: dev|mkt \u2014 leave empty if you don't know yet")
+    }, ["project_key", "title"]),
+    call: async (args) => {
+      const { project_key, ...body } = args;
+      return (await apiCall("POST", `/api/projects/${project_key}/ideas`, body)).body;
+    }
+  },
+  {
+    name: "polaris.idea.update",
+    description: "Refine an open idea \u2014 its title, note or team. A promoted idea is refused: it became a milestone, and the milestone is the truth from then on (use polaris.milestone.update). Needs a token.",
+    inputSchema: objSchema({
+      project_key: strSchema(),
+      id: intSchema("idea id"),
+      title: strSchema(),
+      note_md: strSchema(),
+      team: strSchema("dev|mkt")
+    }, ["project_key", "id"]),
+    call: async (args) => {
+      const { project_key, id, ...body } = args;
+      return (await apiCall("PATCH", `/api/projects/${project_key}/ideas/${id}`, body)).body;
+    }
+  },
+  {
+    name: "polaris.idea.promote",
+    description: "Promote an idea into a milestone \u2014 the one door between the idea list and the timeline. Demands what a milestone demands: end_date, and a team (unless the idea already carries one). The milestone is created and the idea stamped in ONE transaction; promoting twice returns the first milestone and writes nothing. Needs a token.",
+    inputSchema: objSchema({
+      project_key: strSchema(),
+      id: intSchema("idea id"),
+      end_date: strSchema("YYYY-MM-DD \u2014 the deadline the milestone commits to"),
+      team: strSchema("dev|mkt \u2014 required unless the idea already has one"),
+      start_date: strSchema("YYYY-MM-DD, optional"),
+      name: strSchema("optional: overrides the idea's title"),
+      description_md: strSchema("optional: overrides the idea's note"),
+      framework_key: strSchema("optional: e.g. feature, marketing")
+    }, ["project_key", "id", "end_date"]),
+    call: async (args) => {
+      const { project_key, id, ...body } = args;
+      return (await apiCall("POST", `/api/projects/${project_key}/ideas/${id}/promote`, body)).body;
+    }
+  },
+  {
+    name: "polaris.idea.drop",
+    description: "Drop an idea, with the reason it was dropped. Reversible (polaris.idea.reopen) \u2014 dropping is not a one-way door, because almost every good idea looks bad at first. Idempotent: dropping twice keeps the first reason. Needs a token.",
+    inputSchema: objSchema({
+      project_key: strSchema(),
+      id: intSchema("idea id"),
+      reason: strSchema("why it was dropped")
+    }, ["project_key", "id"]),
+    call: async (args) => {
+      const { project_key, id, ...body } = args;
+      return (await apiCall("POST", `/api/projects/${project_key}/ideas/${id}/drop`, body)).body;
+    }
+  },
+  {
+    name: "polaris.idea.reopen",
+    description: "Put a dropped idea back on the open list, clearing its reason. Required before promoting a dropped idea \u2014 resurrecting is a decision, not a side effect. Needs a token.",
+    inputSchema: objSchema({ project_key: strSchema(), id: intSchema("idea id") }, [
+      "project_key",
+      "id"
+    ]),
+    call: async (args) => (await apiCall("POST", `/api/projects/${args.project_key}/ideas/${args.id}/reopen`, {})).body
+  },
   {
     name: "polaris.project.pause_publishing",
     description: "Pause publishing through Polaris for a product (human-only). While paused, no creative of this product goes out at its scheduled hour. It does NOT hold the clock: a piece whose hour passes meanwhile comes back to the person in `release`, like any other late piece \u2014 that is what pausing is for. Idempotent: a second call keeps the original pause, and the original reason. `reason` is optional and is what whoever finds it paused reads.",

package/package.json

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