@keepsnappy/mcp 0.1.0-alpha.11 → 0.1.0-alpha.13

package/README.md

@@ -4,7 +4,7 @@ KeepSnappy's MCP server for coding agents (Claude Code and others): it answers "
 what do I do" from the performance findings KeepSnappy measured on real phones. Read-only: it never starts a measurement,
 writes or recomputes anything (plan 48 §4).
 
-It gives the same answers as the `perflab` CLI (`perflab findings | finding | compare | history | commits | layers`):
+It gives the same answers as the `keepsnappy` CLI (`keepsnappy findings | finding | compare | history | commits | layers`):
 both use this package's API client and answer layout, so a person and an agent read the same words.
 
 ## Set it up in an app repo (TapIn)
@@ -12,26 +12,26 @@ both use this package's API client and answer layout, so a person and an agent r
 1. Ask the KeepSnappy owner for a project key with **read** scope (`bun run create-key -- <org> <app> read` in
    `apps/api`; it refuses an org or app that does not exist). Setup → Keys on the dashboard lists read keys and revokes
    them. A CI key (`run` scope) works too; an SDK key (`ingest`) does not.
-2. Put the key in your shell environment, not in the repo: `export PERFLAB_KEY=pl_rk_…` (for example in `~/.zshenv`).
+2. Put the key in your shell environment, not in the repo: `export KEEPSNAPPY_KEY=pl_rk_…` (for example in `~/.zshenv`).
 3. Add `.mcp.json` at the repo root:
 
 ```json
 {
   "mcpServers": {
-    "perflab": {
+    "keepsnappy": {
       "command": "npx",
       "args": ["-y", "@keepsnappy/mcp"],
       "env": {
-        "PERFLAB_KEY": "${PERFLAB_KEY}",
-        "PERFLAB_API": "https://perflab-api-864539138788.europe-west1.run.app"
+        "KEEPSNAPPY_KEY": "${KEEPSNAPPY_KEY}",
+        "KEEPSNAPPY_API": "https://keepsnappy-api-922918702810.europe-west1.run.app"
       }
     }
   }
 }
 ```
 
-Claude Code expands `${PERFLAB_KEY}` from your environment. `PERFLAB_API` is optional (the hosted API is the default).
-From a KeepSnappy checkout instead of npm: `"command": "bun", "args": ["<perflab>/packages/mcp/src/bin.ts"]`.
+Claude Code expands `${KEEPSNAPPY_KEY}` from your environment. `KEEPSNAPPY_API` is optional (the hosted API is the default).
+From a KeepSnappy checkout instead of npm: `"command": "bun", "args": ["<keepsnappy>/packages/mcp/src/bin.ts"]`.
 
 ## Tools
 
@@ -67,5 +67,5 @@ Can't compare / Not enough data yet**, and "not blocking" as a badge on a Worse
 bun install
 bunx vitest run        # the server against a fake API serving findings built by the API's own finding module
 bunx tsc --noEmit
-PERFLAB_KEY=… bun src/bin.ts   # stdio
+KEEPSNAPPY_KEY=… bun src/bin.ts   # stdio
 ```

package/dist/keepsnappy-mcp.js

@@ -14053,7 +14053,7 @@ class StdioServerTransport {
 }
 
 // packages/mcp/src/client.ts
-var DEFAULT_API_URL = "https://keepsnappy-api-864539138788.europe-west1.run.app";
+var DEFAULT_API_URL = "https://keepsnappy-api-922918702810.europe-west1.run.app";
 
 class ApiError extends Error {
   status;
@@ -14070,13 +14070,13 @@ async function get(t, path, query = {}) {
   for (const [k, v] of Object.entries(query))
     if (v !== undefined && v !== "")
       u.searchParams.set(k, String(v));
-  const r = await (t.fetch ?? fetch)(u, { headers: { "x-perflab-key": t.key, accept: "application/json" } });
+  const r = await (t.fetch ?? fetch)(u, { headers: { "x-keepsnappy-key": t.key, accept: "application/json" } });
   const text = await r.text();
   const body = text ? JSON.parse(text) : {};
   if (!r.ok) {
     const code = typeof body.error === "string" ? body.error : String(r.status);
     const message = typeof body.message === "string" ? body.message : code;
-    const hint = r.status === 401 ? " (check KEEPSNAPPY_KEY or PERFLAB_KEY)" : r.status === 403 ? " (the key needs the read or run scope)" : "";
+    const hint = r.status === 401 ? " (check KEEPSNAPPY_KEY)" : r.status === 403 ? " (the key needs the read or run scope)" : "";
     throw new ApiError(r.status, code, `${message}${hint}`);
   }
   return body;
@@ -22064,20 +22064,20 @@ var MEASURES = {
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "Time of the PerfLab SDK in the window",
-    short: "time of the PerfLab SDK",
+    label: "Time of the KeepSnappy SDK in the window",
+    short: "time of the KeepSnappy SDK",
     decimals: 1,
-    what: "Time the PerfLab SDK spent on the JavaScript thread after each screen update in the window (reading the update, its profile and, when on, the React export); evidence only, never decides a result. Clock time, so it also holds pauses for garbage collection or other threads while the SDK ran. Not known when the window had more updates than the SDK keeps times for"
+    what: "Time the KeepSnappy SDK spent on the JavaScript thread after each screen update in the window (reading the update, its profile and, when on, the React export); evidence only, never decides a result. Clock time, so it also holds pauses for garbage collection or other threads while the SDK ran. Not known when the window had more updates than the SDK keeps times for"
   },
   sdk_hook_commits: {
     unit: "count",
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "Screen updates the PerfLab SDK read",
+    label: "Screen updates the KeepSnappy SDK read",
     short: "screen updates the SDK read",
     decimals: 0,
-    what: "How many screen updates the PerfLab SDK read in the window, the ones its time is summed over"
+    what: "How many screen updates the KeepSnappy SDK read in the window, the ones its time is summed over"
   },
   sdk_hook_capped: {
     unit: "count",
@@ -22087,17 +22087,17 @@ var MEASURES = {
     label: "Windows with too many updates to time the SDK",
     short: "windows the SDK time is not known for",
     decimals: 0,
-    what: "Windows of this place with more screen updates than the PerfLab SDK keeps times for (5000), so its time there is not given"
+    what: "Windows of this place with more screen updates than the KeepSnappy SDK keeps times for (5000), so its time there is not given"
   },
   js_thread_app_ms: {
     unit: "ms",
     worse: "none",
     at: ["screen", "launch", "press", "drag", "other"],
     producer: "derive",
-    label: "JavaScript thread CPU time without the PerfLab SDK",
+    label: "JavaScript thread CPU time without the KeepSnappy SDK",
     short: "JavaScript thread time without the SDK",
     decimals: 0,
-    what: "JavaScript thread CPU time in the window minus the time the PerfLab SDK spent after screen updates (not below 0); evidence only, never decides a result. Approximate either way: the thread time is CPU time in 10 ms steps on Android, the SDK time is clock time and includes pauses inside it"
+    what: "JavaScript thread CPU time in the window minus the time the KeepSnappy SDK spent after screen updates (not below 0); evidence only, never decides a result. Approximate either way: the thread time is CPU time in 10 ms steps on Android, the SDK time is clock time and includes pauses inside it"
   },
   main_thread_ms: {
     unit: "ms",
@@ -23190,7 +23190,7 @@ function createServer(target) {
     title: "List performance findings",
     description: "What got worse (Worse / Warning) or better in the app, worst first, as KeepSnappy measured it on real phones. The answer starts with whether and when the branch was measured and how its newest run set read: an empty list on a branch that was never measured, or whose newest run set was not judged, is not a clean result. Filter by a PR branch or main, journey, phone, and state (present by default; not-judged = the newest run set did not judge it, so it may still be there). Each finding says what changed, where, how sure, and has an id for get_finding. Page with offset.",
     inputSchema: {
-      branch: string2().optional().describe("A PR branch, e.g. feat/perflab-integration"),
+      branch: string2().optional().describe("A PR branch, e.g. feat/keepsnappy-integration"),
       main: boolean2().optional().describe("Findings of main over time instead of a branch"),
       journey: string2().optional().describe("Journey key, e.g. live-ui"),
       phone: string2().optional().describe('Part of the phone model, e.g. "iPhone 15"'),
@@ -23239,11 +23239,11 @@ function createServer(target) {
 }
 
 // packages/mcp/src/bin.ts
-var key = process.env.KEEPSNAPPY_KEY ?? process.env.PERFLAB_KEY;
+var key = process.env.KEEPSNAPPY_KEY;
 if (!key) {
   process.stderr.write(`keepsnappy-mcp: set KEEPSNAPPY_KEY to a KeepSnappy project key with read scope
 `);
   process.exit(2);
 }
-var server = createServer({ url: process.env.KEEPSNAPPY_API ?? process.env.PERFLAB_API ?? DEFAULT_API_URL, key });
+var server = createServer({ url: process.env.KEEPSNAPPY_API ?? DEFAULT_API_URL, key });
 await server.connect(new StdioServerTransport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepsnappy/mcp",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "description": "KeepSnappy MCP server (stdio, read-only): performance findings, compare, window history and commits for coding agents.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,8 +16,7 @@
     "node": ">=22"
   },
   "bin": {
-    "keepsnappy-mcp": "dist/keepsnappy-mcp.js",
-    "perflab-mcp": "dist/keepsnappy-mcp.js"
+    "keepsnappy-mcp": "dist/keepsnappy-mcp.js"
   },
   "files": [
     "dist",