@okmira/mcp 0.0.1

package/README.md

@@ -0,0 +1,95 @@
+# @okmira/mcp
+
+MCP server and Claude Code hooks for [Mira](https://okmira.ai) — structured stakeholder feedback for AI-assisted development.
+
+## What is Mira?
+
+AI made developers 10x faster. Feedback is still 1x. Mira closes the gap.
+
+Mira structures stakeholder feedback so AI coding assistants can act on it directly. Stakeholders review deployed builds and leave role-contextualized feedback ("What works" / "What doesn't" / "Suggested direction"). Developers fetch that feedback into Claude Code and apply it conversationally.
+
+## Installation
+
+Register the MCP server with Claude Code (takes effect immediately, no restart):
+
+```bash
+claude mcp add mira \
+  -e CC_FEEDBACK_API_URL=https://okmira.ai \
+  -e CC_FEEDBACK_API_KEY=ccf_YOUR_KEY_HERE \
+  -- npx @okmira/mcp
+```
+
+Get your API key from the project dashboard at [okmira.ai](https://okmira.ai).
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `register_build` | Register a new build after deployment. Returns a review URL for stakeholders. |
+| `fetch_feedback` | Fetch structured feedback for a build. Returns role-contextualized feedback with suggested directions. |
+| `update_feedback_status` | Mark feedback as acknowledged, applied, or stale. Closes the feedback loop. |
+| `check_pending_feedback` | Check for unreviewed feedback across recent builds. Acts as an inbox. |
+
+## Claude Code Hooks
+
+Optional hooks for zero-friction automation. Add a `.mira.json` to your project root:
+
+```json
+{
+  "projectId": "your-project-uuid"
+}
+```
+
+Then add to `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [{ "type": "command", "command": "mira-auto-register" }]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [{ "type": "command", "command": "mira-check-feedback" }]
+      }
+    ]
+  }
+}
+```
+
+**`mira-auto-register`** (PostToolUse) — Detects Vercel deploy URLs in Bash output and automatically registers builds with Mira. Exits immediately for non-deploy commands.
+
+**`mira-check-feedback`** (SessionStart) — Surfaces pending feedback count at the start of each session so Claude can proactively inform you.
+
+Hook credentials are read from the MCP server config — no duplication needed.
+
+## Configuration
+
+| Variable | Description |
+|----------|-------------|
+| `CC_FEEDBACK_API_URL` | Base URL — `https://okmira.ai` (production) or `http://localhost:3000` (local) |
+| `CC_FEEDBACK_API_KEY` | Project-scoped API key (`ccf_` prefix), generated from the dashboard |
+
+## How It Works
+
+```
+Developer deploys build
+  → Build registered (via MCP tool or auto-register hook)
+  → Stakeholders notified, review build, leave structured feedback
+  → Developer fetches feedback into Claude Code
+  → Claude applies feedback conversationally
+  → New build deployed → cycle repeats
+```
+
+## Requirements
+
+- Node.js 18+ (for native `fetch()`)
+- `git` (for hooks — ref/branch detection)
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,10 @@
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKrC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAqB1E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAGlD"}

package/dist/api-client.js

@@ -0,0 +1,34 @@
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errBody = (await response.json().catch(() => ({ error: response.statusText })));
+            throw new Error(`API error ${response.status}: ${errBody.error || response.statusText}`);
+        }
+        return response.json();
+    }
+    get(path) {
+        return this.request("GET", path);
+    }
+    post(path, body) {
+        return this.request("POST", path, body);
+    }
+    patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAS;IACZ,OAAO,CAAS;IAChB,MAAM,CAAS;IAEvB,YAAY,OAAe,EAAE,MAAc;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc;QAC3D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAEnF,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAED,GAAG,CAAI,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAI,IAAY,EAAE,IAAa;QACjC,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAI,IAAY,EAAE,IAAa;QAClC,OAAO,IAAI,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ApiClient } from "./api-client.js";
+import { registerBuildTool } from "./tools/register-build.js";
+import { fetchFeedbackTool } from "./tools/fetch-feedback.js";
+import { updateFeedbackStatusTool } from "./tools/update-feedback-status.js";
+import { checkPendingTool } from "./tools/check-pending.js";
+const server = new McpServer({
+    name: "cc-feedback",
+    version: "0.0.1",
+});
+const apiUrl = process.env.CC_FEEDBACK_API_URL || "http://localhost:3000";
+const apiKey = process.env.CC_FEEDBACK_API_KEY || "";
+if (!apiKey) {
+    console.error("Warning: CC_FEEDBACK_API_KEY is not set. API calls will fail.");
+}
+const api = new ApiClient(apiUrl, apiKey);
+// Register all tools
+registerBuildTool(server, api);
+fetchFeedbackTool(server, api);
+updateFeedbackStatusTool(server, api);
+checkPendingTool(server, api);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("cc-feedback MCP server running on stdio");
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,uBAAuB,CAAC;AAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;AAErD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C,qBAAqB;AACrB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC/B,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC/B,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACtC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/tools/check-pending.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function checkPendingTool(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=check-pending.d.ts.map

package/dist/tools/check-pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-pending.d.ts","sourceRoot":"","sources":["../../src/tools/check-pending.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,QA6BjE"}

package/dist/tools/check-pending.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export function checkPendingTool(server, api) {
+    server.tool("check_pending_feedback", "Check for unreviewed feedback across recent builds. Acts as an inbox to surface feedback that needs attention.", {
+        project_id: z.string().uuid().describe("The project UUID to check"),
+    }, async ({ project_id }) => {
+        const response = await api.get(`/api/v1/projects/${project_id}/feedback/pending`);
+        let text;
+        if (response.pending_count === 0) {
+            text = `No pending feedback for ${response.project}.`;
+        }
+        else {
+            text = JSON.stringify(response, null, 2);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=check-pending.js.map

package/dist/tools/check-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-pending.js","sourceRoot":"","sources":["../../src/tools/check-pending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAc;IAChE,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,gHAAgH,EAChH;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KACpE,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,oBAAoB,UAAU,mBAAmB,CAClD,CAAC;QAEF,IAAI,IAAY,CAAC;QACjB,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YACjC,IAAI,GAAG,2BAA2B,QAAQ,CAAC,OAAO,GAAG,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI;iBACL;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-feedback.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function fetchFeedbackTool(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=fetch-feedback.d.ts.map

package/dist/tools/fetch-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-feedback.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-feedback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,QAmClE"}

package/dist/tools/fetch-feedback.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function fetchFeedbackTool(server, api) {
+    server.tool("fetch_feedback", "Fetch structured feedback for a build. Returns role-contextualized feedback with suggested directions for AI consumption.", {
+        build_id: z.string().uuid().describe("The build UUID to fetch feedback for"),
+        status: z
+            .enum(["pending", "acknowledged", "applied", "stale"])
+            .optional()
+            .describe("Filter by feedback status"),
+        type: z
+            .enum(["internal", "external"])
+            .optional()
+            .describe("Filter by member type (internal team vs external client)"),
+    }, async ({ build_id, status, type }) => {
+        const params = new URLSearchParams();
+        if (status)
+            params.set("status", status);
+        if (type)
+            params.set("type", type);
+        const qs = params.toString();
+        const path = `/api/v1/builds/${build_id}/feedback${qs ? `?${qs}` : ""}`;
+        const response = await api.get(path);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=fetch-feedback.js.map

package/dist/tools/fetch-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-feedback.js","sourceRoot":"","sources":["../../src/tools/fetch-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAc;IACjE,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,2HAA2H,EAC3H;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC5E,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;aACrD,QAAQ,EAAE;aACV,QAAQ,CAAC,2BAA2B,CAAC;QACxC,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;aAC9B,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;KACxE,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEnC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,kBAAkB,QAAQ,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAExE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAwB,IAAI,CAAC,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-build.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerBuildTool(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=register-build.d.ts.map

package/dist/tools/register-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-build.d.ts","sourceRoot":"","sources":["../../src/tools/register-build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,QAoClE"}

package/dist/tools/register-build.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export function registerBuildTool(server, api) {
+    server.tool("register_build", "Register a new build after deployment. Returns a review URL for stakeholders.", {
+        project_id: z.string().uuid().describe("The project UUID"),
+        url: z.string().url().describe("Deploy URL of the build"),
+        git_ref: z.string().describe("Git commit SHA or ref"),
+        track: z.string().describe("Branch or feature track name"),
+    }, async ({ project_id, url, git_ref, track }) => {
+        const build = await api.post(`/api/v1/projects/${project_id}/builds`, {
+            url,
+            git_ref,
+            track,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        build_id: build.id,
+                        url: build.url,
+                        deployed_at: build.deployed_at,
+                        review_url: build.review_url,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=register-build.js.map

package/dist/tools/register-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-build.js","sourceRoot":"","sources":["../../src/tools/register-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAc;IACjE,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,+EAA+E,EAC/E;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC1D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC3D,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAgB,oBAAoB,UAAU,SAAS,EAAE;YACnF,GAAG;YACH,OAAO;YACP,KAAK;SACN,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,QAAQ,EAAE,KAAK,CAAC,EAAE;wBAClB,GAAG,EAAE,KAAK,CAAC,GAAG;wBACd,WAAW,EAAE,KAAK,CAAC,WAAW;wBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/update-feedback-status.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function updateFeedbackStatusTool(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=update-feedback-status.d.ts.map

package/dist/tools/update-feedback-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-feedback-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-feedback-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,QAwBzE"}

package/dist/tools/update-feedback-status.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export function updateFeedbackStatusTool(server, api) {
+    server.tool("update_feedback_status", "Update the status of one or more feedback items. Use after reviewing or applying feedback.", {
+        feedback_ids: z.array(z.string().uuid()).min(1).describe("Array of feedback UUIDs to update"),
+        status: z.enum(["acknowledged", "applied", "stale"]).describe("New status to set"),
+    }, async ({ feedback_ids, status }) => {
+        const response = await api.patch("/api/v1/feedback", {
+            feedback_ids,
+            status,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=update-feedback-status.js.map

package/dist/tools/update-feedback-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-feedback-status.js","sourceRoot":"","sources":["../../src/tools/update-feedback-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,GAAc;IACxE,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,4FAA4F,EAC5F;QACE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC7F,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACnF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAA+B,kBAAkB,EAAE;YACjF,YAAY;YACZ,MAAM;SACP,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/hooks/auto-register.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+// PostToolUse hook: auto-register Vercel deploys with Mira.
+//
+// Fires after every tool use. Exits immediately for non-deploy
+// commands. When a Vercel deploy URL is detected, registers the build
+// and returns context so Claude can inform the developer.
+
+import {
+  readStdin,
+  readMiraConfig,
+  readMcpCredentials,
+  miraApi,
+  getGitInfo,
+} from "./lib.js";
+
+try {
+  const input = readStdin();
+  if (!input) process.exit(0);
+
+  // Only process Bash tool executions
+  if (input.tool_name !== "Bash") process.exit(0);
+
+  // Get tool output (handles both string and object formats)
+  let toolOutput = "";
+  const out = input.tool_output;
+  if (typeof out === "string") {
+    toolOutput = out;
+  } else if (out && typeof out === "object") {
+    toolOutput = out.stdout || out.content || JSON.stringify(out);
+  }
+  if (!toolOutput) process.exit(0);
+
+  // Detect Vercel deploy URL
+  let deployUrl = "";
+
+  // Priority 1: Vercel CLI "Preview:" or "Production:" line
+  const cliMatch = toolOutput.match(
+    /(?:Preview|Production): (https:\/\/[a-zA-Z0-9._-]+)/,
+  );
+  if (cliMatch) {
+    deployUrl = cliMatch[1];
+  }
+
+  // Priority 2: Any *.vercel.app URL
+  if (!deployUrl) {
+    const appMatch = toolOutput.match(
+      /https:\/\/[a-zA-Z0-9._-]+\.vercel\.app/,
+    );
+    if (appMatch) {
+      deployUrl = appMatch[0];
+    }
+  }
+
+  if (!deployUrl) process.exit(0);
+
+  // Deploy URL found — register the build
+  const cwd = input.cwd;
+  if (!cwd) process.exit(0);
+
+  const config = readMiraConfig(cwd);
+  if (!config) process.exit(0);
+
+  const credentials = readMcpCredentials(cwd);
+  if (!credentials) process.exit(0);
+
+  const git = getGitInfo(cwd);
+
+  const buildBody = { url: deployUrl, git_ref: git.ref, track: git.track };
+  if (git.commitMessage) {
+    buildBody.commit_message = git.commitMessage;
+  }
+
+  const result = await miraApi(
+    "POST",
+    `/api/v1/projects/${config.projectId}/builds`,
+    buildBody,
+    credentials,
+  );
+
+  if (result && result.httpCode >= 200 && result.httpCode < 300) {
+    const buildId = result.response?.id;
+    const reviewUrl = `${credentials.apiUrl}/review/${buildId}`;
+
+    console.log(
+      JSON.stringify({
+        reason: `Mira: Build auto-registered. Deploy: ${deployUrl} | Review: ${reviewUrl} | Git: ${git.ref} (${git.track}). Stakeholders can now leave feedback at the review URL.`,
+      }),
+    );
+  }
+} catch {
+  // Hooks must never block Claude Code
+  process.exit(0);
+}

package/hooks/check-feedback.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+// SessionStart hook: surface pending feedback when opening a project.
+//
+// Fires at session start. Checks if the project directory has a .mira.json,
+// and if so, queries the API for pending feedback and injects context so
+// Claude can proactively inform the developer.
+
+import { readStdin, readMiraConfig, readMcpCredentials, miraApi } from "./lib.js";
+
+try {
+  const input = readStdin();
+  if (!input) process.exit(0);
+
+  const cwd = input.cwd;
+  if (!cwd) process.exit(0);
+
+  const config = readMiraConfig(cwd);
+  if (!config) process.exit(0);
+
+  const credentials = readMcpCredentials(cwd);
+  if (!credentials) process.exit(0);
+
+  const result = await miraApi(
+    "GET",
+    `/api/v1/projects/${config.projectId}/feedback/pending`,
+    null,
+    credentials,
+  );
+
+  if (!result || result.httpCode < 200 || result.httpCode >= 300) process.exit(0);
+
+  const pendingCount = result.response?.pending_count || 0;
+  if (pendingCount <= 0) process.exit(0);
+
+  // Build summary lines
+  const builds = result.response?.builds_with_pending || [];
+  const summaryLines = builds.map((b) => {
+    const date = (b.deployed_at || "").split("T")[0];
+    const roles = (b.roles || []).join(", ");
+    return `  - ${b.track} (deployed ${date}): ${b.pending_count} pending from ${roles}`;
+  });
+
+  const context = [
+    `Mira: ${pendingCount} pending feedback item(s) on this project:`,
+    ...summaryLines,
+    'Use fetch_feedback to review, or say "mira, what feedback do we have?"',
+  ].join("\n");
+
+  console.log(
+    JSON.stringify({
+      hookSpecificOutput: {
+        additionalContext: context,
+      },
+    }),
+  );
+} catch {
+  // Hooks must never block Claude Code
+  process.exit(0);
+}

package/hooks/lib.js

@@ -0,0 +1,167 @@
+import { readFileSync, existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+/**
+ * Read and parse JSON from stdin (synchronous).
+ * Returns parsed object or null on failure.
+ */
+export function readStdin() {
+  try {
+    const raw = readFileSync(0, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read .mira.json from a directory.
+ * Returns { projectId } or null if not found/invalid.
+ */
+export function readMiraConfig(dir) {
+  try {
+    const configPath = join(dir, ".mira.json");
+    if (!existsSync(configPath)) return null;
+    const config = JSON.parse(readFileSync(configPath, "utf8"));
+    if (!config.projectId) return null;
+    return { projectId: config.projectId };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read MCP server credentials from Claude Code settings files.
+ * Checks project-level then user-level settings, and both "mira" and "cc-feedback" server names.
+ * Falls back to .mira.json for credentials.
+ * Returns { apiUrl, apiKey } or null.
+ */
+export function readMcpCredentials(dir) {
+  const settingsFiles = [
+    join(dir, ".claude", "settings.local.json"),
+    join(dir, ".claude", "settings.json"),
+    join(homedir(), ".claude", "settings.json"),
+  ];
+  const serverNames = ["mira", "cc-feedback"];
+
+  let apiUrl = "";
+  let apiKey = "";
+
+  for (const sf of settingsFiles) {
+    if (apiKey) break;
+    try {
+      if (!existsSync(sf)) continue;
+      const settings = JSON.parse(readFileSync(sf, "utf8"));
+      for (const sn of serverNames) {
+        const env = settings?.mcpServers?.[sn]?.env;
+        if (env?.CC_FEEDBACK_API_KEY) {
+          apiUrl = env.CC_FEEDBACK_API_URL || "";
+          apiKey = env.CC_FEEDBACK_API_KEY;
+          break;
+        }
+      }
+    } catch {
+      continue;
+    }
+  }
+
+  // Fall back to .mira.json for credentials
+  if (!apiKey) {
+    try {
+      const configPath = join(dir, ".mira.json");
+      if (!existsSync(configPath)) return null;
+      const config = JSON.parse(readFileSync(configPath, "utf8"));
+      apiUrl = config.apiUrl || "";
+      apiKey = config.apiKey || "";
+    } catch {
+      return null;
+    }
+  }
+
+  if (!apiKey) return null;
+
+  return {
+    apiUrl: apiUrl || "https://okmira.ai",
+    apiKey,
+  };
+}
+
+/**
+ * Make an authenticated API request.
+ * Returns { httpCode, response } or null on failure.
+ */
+export async function miraApi(method, path, body, credentials) {
+  try {
+    const url = `${credentials.apiUrl}${path}`;
+    const options = {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${credentials.apiKey}`,
+      },
+      signal: AbortSignal.timeout(10000),
+    };
+
+    if (body) {
+      options.body = JSON.stringify(body);
+    }
+
+    const res = await fetch(url, options);
+    const text = await res.text();
+    let response;
+    try {
+      response = JSON.parse(text);
+    } catch {
+      response = text;
+    }
+
+    return { httpCode: res.status, response };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Extract git metadata from a directory.
+ * Returns { ref, track }.
+ */
+export function getGitInfo(dir) {
+  let ref = "unknown";
+  let track = "unknown";
+
+  let commitMessage = "";
+
+  try {
+    ref = execSync("git rev-parse --short HEAD", {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+  } catch {
+    // ignore
+  }
+
+  try {
+    track = execSync("git branch --show-current", {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim() || "unknown";
+  } catch {
+    // ignore
+  }
+
+  try {
+    commitMessage = execSync("git log -1 --format=%s", {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+  } catch {
+    // ignore
+  }
+
+  return { ref, track, commitMessage };
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@okmira/mcp",
+  "version": "0.0.1",
+  "description": "MCP server for Mira — structured stakeholder feedback for AI-assisted development",
+  "type": "module",
+  "bin": {
+    "okmira-mcp": "./dist/index.js",
+    "mira-auto-register": "./hooks/auto-register.js",
+    "mira-check-feedback": "./hooks/check-feedback.js"
+  },
+  "files": [
+    "dist",
+    "hooks"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint . && tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "3"
+  },
+  "devDependencies": {
+    "@cc-feedback/shared": "workspace:*",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}