@glie/mcp-polaris 0.3.0 → 0.4.0

package/dist/index.js

@@ -510,6 +510,162 @@ var TOOLS = [
       const qs = typeof args.limit === "number" ? `?limit=${args.limit}` : "";
       return (await apiCall("GET", `/api/chats/${chatId}/messages${qs}`)).body;
     }
+  },
+  {
+    name: "polaris.project.update",
+    description: "Update a project (human-only): repo_url, description_md, name, status (active|paused|archived), owner_human_id.",
+    inputSchema: objSchema({
+      key: strSchema("project key"),
+      name: strSchema(),
+      description_md: strSchema(),
+      repo_url: strSchema("github.com repo URL"),
+      status: strSchema("active|paused|archived"),
+      owner_human_id: intSchema()
+    }, ["key"]),
+    call: async (args) => {
+      const { key, ...patch } = args;
+      return (await apiCall("PATCH", `/api/projects/${key}`, patch)).body;
+    }
+  },
+  {
+    name: "polaris.project.claude_md_set",
+    description: "Set a project's CLAUDE.md \u2014 the conventions agents read. PUT the full markdown (human-only).",
+    inputSchema: objSchema({ key: strSchema("project key"), content: strSchema("full CLAUDE.md markdown") }, ["key", "content"]),
+    call: async (args) => (await apiCall("PUT", `/api/projects/${args.key}/claude-md`, { content: args.content })).body
+  },
+  {
+    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).",
+    inputSchema: objSchema({
+      agent_id_slug: strSchema("stable slug, e.g. developer-polaris-01"),
+      function: strSchema("developer|tester|planner|communicator"),
+      product: strSchema("project key"),
+      name: strSchema("friendly display name"),
+      team: strSchema("dev|mkt"),
+      domain: strSchema("roadmap|helpdesk|both")
+    }, ["agent_id_slug", "function", "product", "name", "team"]),
+    call: async (args) => (await apiCall("POST", "/api/agents", args)).body
+  },
+  {
+    name: "polaris.agent.update",
+    description: "Update an agent (human-only): name (rename), domain (roadmap|helpdesk|both), or mantra_md. The stable agent_id_slug never changes.",
+    inputSchema: objSchema({
+      id: intSchema(),
+      name: strSchema(),
+      domain: strSchema("roadmap|helpdesk|both"),
+      mantra_md: strSchema()
+    }, ["id"]),
+    call: async (args) => {
+      const { id, ...patch } = args;
+      return (await apiCall("PATCH", `/api/agents/${id}`, patch)).body;
+    }
+  },
+  {
+    name: "polaris.agent.token_issue",
+    description: "Issue a service token for an agent (human-only). Plaintext returned exactly once \u2014 store it.",
+    inputSchema: objSchema({ id: intSchema("agent id"), name: strSchema("token name") }, [
+      "id",
+      "name"
+    ]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/tokens`, { name: args.name })).body
+  },
+  {
+    name: "polaris.agent.token_revoke",
+    description: "Revoke an agent service token (human-only). Idempotent.",
+    inputSchema: objSchema({ id: intSchema("agent id"), token_id: intSchema() }, [
+      "id",
+      "token_id"
+    ]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/tokens/${args.token_id}/revoke`)).body
+  },
+  {
+    name: "polaris.agent.claude_login",
+    description: "Kick off an agent's Claude Code device-login (human-only). Poll agent.get for claude_login_url.",
+    inputSchema: objSchema({ id: intSchema("agent id") }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/claude-login`)).body
+  },
+  {
+    name: "polaris.agent.claude_login_code",
+    description: "Submit the OAuth callback code for an agent's Claude login (human-only).",
+    inputSchema: objSchema({ id: intSchema("agent id"), code: strSchema("callback code") }, [
+      "id",
+      "code"
+    ]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/claude-login/code`, { code: args.code })).body
+  },
+  {
+    name: "polaris.milestone.create",
+    description: "Create a milestone. team = dev|mkt; end_date = deadline (ISO date, required); framework_key optional.",
+    inputSchema: objSchema({
+      project_key: strSchema(),
+      name: strSchema(),
+      team: strSchema("dev|mkt"),
+      end_date: strSchema("ISO date, e.g. 2026-06-30"),
+      framework_key: strSchema(),
+      description_md: strSchema()
+    }, ["project_key", "name", "team", "end_date"]),
+    call: async (args) => (await apiCall("POST", "/api/milestones", args)).body
+  },
+  {
+    name: "polaris.stack.create",
+    description: "Create a stack (Release Candidate) from 2+ approval tasks of ONE milestone \u2014 shipped together. Pass task_ids.",
+    inputSchema: objSchema({
+      task_ids: {
+        type: "array",
+        items: { type: "integer" },
+        description: "task ids (>=2, same milestone, dependency-independent)"
+      }
+    }, ["task_ids"]),
+    call: async (args) => (await apiCall("POST", "/api/stacks", { task_ids: args.task_ids })).body
+  },
+  {
+    name: "polaris.stack.add_task",
+    description: "Add a task to a stack while it's assembling.",
+    inputSchema: objSchema({ id: intSchema("stack id"), task_id: intSchema() }, ["id", "task_id"]),
+    call: async (args) => (await apiCall("POST", `/api/stacks/${args.id}/tasks`, { task_id: args.task_id })).body
+  },
+  {
+    name: "polaris.stack.remove_task",
+    description: "Remove a task from a stack (its individual PR reopens). Removing the last member cancels the stack.",
+    inputSchema: objSchema({ id: intSchema("stack id"), task_id: intSchema() }, ["id", "task_id"]),
+    call: async (args) => (await apiCall("DELETE", `/api/stacks/${args.id}/tasks`, { task_id: args.task_id })).body
+  },
+  {
+    name: "polaris.task.return_to_backlog",
+    description: "Send an approval task back for rework (human-only) \u2014 to its sticky developer (dev) or backlog. Clears escalation.",
+    inputSchema: objSchema({ id: intSchema() }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/return-to-backlog`)).body
+  },
+  {
+    name: "polaris.chat.post",
+    description: "Post a message to a scope's feed/chat (task|milestone|project|agent_dm|human_dm|general). Author is YOU (from the token). @mentions render.",
+    inputSchema: objSchema({
+      scope_type: strSchema("task|milestone|project|agent_dm|human_dm|general"),
+      scope_id: intSchema(),
+      body_md: strSchema("markdown message")
+    }, ["scope_type", "scope_id", "body_md"]),
+    call: async (args) => {
+      const chat = (await apiCall("GET", `/api/chats/${args.scope_type}/${args.scope_id}`)).body;
+      const chatId = chat?.data?.id;
+      if (!chatId)
+        throw new Error(`no chat for ${args.scope_type}/${args.scope_id}`);
+      return (await apiCall("POST", `/api/chats/${chatId}/messages`, {
+        author_type: "human",
+        body_md: args.body_md
+      })).body;
+    }
+  },
+  {
+    name: "polaris.human.token_issue",
+    description: "Issue a Personal Access Token for YOU (the calling human). Plaintext returned once \u2014 used by mcp-polaris / automation you own.",
+    inputSchema: objSchema({ name: strSchema("token name") }, ["name"]),
+    call: async (args) => (await apiCall("POST", "/api/humans/me/tokens", { name: args.name })).body
+  },
+  {
+    name: "polaris.human.token_revoke",
+    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
   }
 ];
 var TOOLS_BY_NAME = new Map(TOOLS.map((t) => [t.name, t]));
@@ -566,7 +722,7 @@ async function handle(req) {
       return fail(id, -32601, `method not found: ${req.method}`);
   }
 }
-if (__require.main == __require.module) {
+if (true) {
   log(`starting against ${BASE} (token=${TOKEN ? "set" : "none"})`);
   const rl = createInterface({ input: process.stdin, crlfDelay: Number.POSITIVE_INFINITY });
   rl.on("line", async (line) => {

package/package.json

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