@pushary/agent-hooks 0.3.0 → 0.4.1

package/dist/pushary-doctor-EHLTPBD3.js

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+
+// bin/pushary-doctor.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { confirm } from "@inquirer/prompts";
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+var green = (s) => `\x1B[32m${s}\x1B[0m`;
+var red = (s) => `\x1B[31m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+var pass = green("\u2713");
+var fail = red("\u2717");
+var warn = yellow("!");
+var CLAUDE_SETTINGS = join(homedir(), ".claude", "settings.json");
+var SKILL_PATH = join(homedir(), ".claude", "skills", "pushary", "SKILL.md");
+var MCP_URL = "https://pushary.com/api/mcp/mcp";
+var readJson = (path) => {
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+};
+var results = [];
+var check = (passed, label, detail) => {
+  results.push({ passed, label, detail });
+  const icon = passed ? pass : fail;
+  const suffix = detail ? ` ${dim(`(${detail})`)}` : "";
+  console.log(`  ${icon} ${label}${suffix}`);
+};
+var main = async () => {
+  console.log();
+  console.log(`  ${bold("Pushary Doctor")}`);
+  console.log();
+  console.log(`  ${dim("Configuration")}`);
+  const apiKey = process.env.PUSHARY_API_KEY;
+  check(!!apiKey, "API key in environment", apiKey ? `pk_${apiKey.split(".")[0]?.slice(3, 7)}...` : "PUSHARY_API_KEY not set");
+  const settings = readJson(CLAUDE_SETTINGS);
+  if (settings) {
+    const mcpServers = settings.mcpServers;
+    const pusharyServer = mcpServers?.pushary;
+    check(!!pusharyServer, "Claude Code: MCP server configured");
+    if (pusharyServer) {
+      check(pusharyServer.type === "http", "Claude Code: MCP server type", pusharyServer.type ? String(pusharyServer.type) : 'missing \u2014 add type: "http"');
+    }
+    const hooks = settings.hooks;
+    const hasPreHook = JSON.stringify(hooks?.PreToolUse ?? []).includes("pushary-hook");
+    const hasPostHook = JSON.stringify(hooks?.PostToolUse ?? []).includes("pushary-post-hook");
+    const hasStopHook = JSON.stringify(hooks?.Stop ?? []).includes("pushary-stop-hook");
+    check(hasPreHook, "Claude Code: PreToolUse hook");
+    check(hasPostHook, "Claude Code: PostToolUse hook");
+    check(hasStopHook, "Claude Code: Stop hook");
+    const permissions = settings.permissions;
+    const hasWildcard = permissions?.allow?.some((r) => r === "MCP(pushary:*)") ?? false;
+    check(hasWildcard, "Claude Code: Pushary tools auto-allowed", hasWildcard ? "MCP(pushary:*)" : "missing");
+    const hasLegacyPerms = permissions?.allow?.some((r) => r.startsWith("mcp__pushary__")) ?? false;
+    if (hasLegacyPerms) {
+      console.log(`  ${warn} Legacy individual permissions detected ${dim("(run pushary clean, then setup again)")}`);
+    }
+  } else {
+    check(false, "Claude Code: settings.json", "not found");
+  }
+  check(existsSync(SKILL_PATH), "Skill installed", existsSync(SKILL_PATH) ? SKILL_PATH : "not found");
+  let globalVersion = "";
+  try {
+    const { execSync } = await import("child_process");
+    globalVersion = execSync("npm list -g @pushary/agent-hooks --depth=0 2>/dev/null", { encoding: "utf-8" }).match(/@pushary\/agent-hooks@([\d.]+)/)?.[1] ?? "";
+  } catch {
+  }
+  check(!!globalVersion, "Global package installed", globalVersion || "not found");
+  console.log();
+  console.log(`  ${dim("Connectivity")}`);
+  if (!apiKey) {
+    check(false, "MCP server reachable", "skipped \u2014 no API key");
+    check(false, "API key valid", "skipped");
+    check(false, "MCP handshake", "skipped");
+  } else {
+    let sessionId = "";
+    let toolCount = 0;
+    try {
+      const initRes = await fetch(MCP_URL, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json, text/event-stream",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "initialize",
+          params: {
+            protocolVersion: "2025-03-26",
+            capabilities: {},
+            clientInfo: { name: "pushary-doctor", version: "1.0" }
+          }
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      check(initRes.ok, "MCP server reachable", `${initRes.status} ${initRes.statusText}`);
+      sessionId = initRes.headers.get("mcp-session-id") ?? "";
+      check(!!sessionId, "Session ID returned", sessionId ? `${sessionId.slice(0, 8)}...` : "missing \u2014 update MCP SDK");
+      const initBody = await initRes.text();
+      const initMatch = initBody.match(/data: (.+)/);
+      if (initMatch) {
+        const initData = JSON.parse(initMatch[1]);
+        check(!!initData.result?.serverInfo, "API key valid", initData.result?.serverInfo?.name ?? "unknown server");
+      }
+      const toolsRes = await fetch(MCP_URL, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json, text/event-stream",
+          "Authorization": `Bearer ${apiKey}`,
+          ...sessionId ? { "Mcp-Session-Id": sessionId } : {}
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 2,
+          method: "tools/list",
+          params: {}
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      const toolsBody = await toolsRes.text();
+      const toolsMatch = toolsBody.match(/data: (.+)/);
+      if (toolsMatch) {
+        const toolsData = JSON.parse(toolsMatch[1]);
+        toolCount = toolsData.result?.tools?.length ?? 0;
+      }
+      check(toolCount > 0, "MCP tools discovered", `${toolCount} tools`);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "unknown error";
+      check(false, "MCP server reachable", msg);
+    }
+    console.log();
+    console.log(`  ${dim("Notification Delivery")}`);
+    try {
+      const notifRes = await fetch("https://pushary.com/api/v1/server/send", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          title: "Pushary Doctor",
+          body: "If you see this, push notifications are working."
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      check(notifRes.ok, "Push notification sent", notifRes.ok ? "check your phone" : `${notifRes.status}`);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "network error";
+      check(false, "Push notification sent", msg);
+    }
+    const testQuestion = await confirm({ message: "Test question roundtrip? (sends a push notification)", default: false });
+    if (testQuestion) {
+      console.log();
+      console.log(`  ${dim("Question Roundtrip")}`);
+      try {
+        const mcpHeaders = {
+          "Content-Type": "application/json",
+          "Accept": "application/json, text/event-stream",
+          "Authorization": `Bearer ${apiKey}`,
+          ...sessionId ? { "Mcp-Session-Id": sessionId } : {}
+        };
+        const askRes = await fetch(MCP_URL, {
+          method: "POST",
+          headers: mcpHeaders,
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 3,
+            method: "tools/call",
+            params: {
+              name: "ask_user",
+              arguments: {
+                question: "Pushary Doctor: tap Yes to verify the roundtrip works.",
+                type: "confirm",
+                agentName: "Pushary Doctor"
+              }
+            }
+          }),
+          signal: AbortSignal.timeout(15e3)
+        });
+        const askBody = await askRes.text();
+        const askMatch = askBody.match(/data: (.+)/);
+        let correlationId = "";
+        if (askMatch) {
+          const askData = JSON.parse(askMatch[1]);
+          const content = askData.result?.content?.[0]?.text;
+          if (content) {
+            const parsed = JSON.parse(content);
+            correlationId = parsed.correlationId;
+          }
+        }
+        if (correlationId) {
+          console.log(`  ${dim("\u2192")} Question sent, waiting for your answer...`);
+          const start = Date.now();
+          const waitRes = await fetch(MCP_URL, {
+            method: "POST",
+            headers: mcpHeaders,
+            body: JSON.stringify({
+              jsonrpc: "2.0",
+              id: 4,
+              method: "tools/call",
+              params: {
+                name: "wait_for_answer",
+                arguments: { correlationId, timeoutMs: 55e3 }
+              }
+            }),
+            signal: AbortSignal.timeout(6e4)
+          });
+          const waitBody = await waitRes.text();
+          const waitMatch = waitBody.match(/data: (.+)/);
+          if (waitMatch) {
+            const waitData = JSON.parse(waitMatch[1]);
+            const content = waitData.result?.content?.[0]?.text;
+            if (content) {
+              const parsed = JSON.parse(content);
+              const elapsed = ((Date.now() - start) / 1e3).toFixed(1);
+              check(parsed.answered === true, "Answer received", `"${parsed.value}" (${elapsed}s roundtrip)`);
+            } else {
+              check(false, "Answer received", "no response within timeout");
+            }
+          }
+        } else {
+          check(false, "Question sent", "failed to get correlationId");
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "unknown error";
+        check(false, "Question roundtrip", msg);
+      }
+    }
+  }
+  console.log();
+  const failed = results.filter((r) => !r.passed);
+  if (failed.length === 0) {
+    console.log(`  ${green(bold("All checks passed."))}`);
+  } else {
+    console.log(`  ${red(bold(`${failed.length} check${failed.length === 1 ? "" : "s"} failed:`))}`);
+    for (const f of failed) {
+      console.log(`  ${fail} ${f.label}${f.detail ? ` \u2014 ${f.detail}` : ""}`);
+    }
+    console.log();
+    console.log(`  ${dim("Run")} ${cyan("npx @pushary/agent-hooks@latest clean")} ${dim("then")} ${cyan("setup")} ${dim("to fix.")}`);
+  }
+  console.log();
+};
+main();

package/dist/pushary-doctor-LYMEFIZN.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+// bin/pushary-doctor.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { confirm } from "@inquirer/prompts";
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+var green = (s) => `\x1B[32m${s}\x1B[0m`;
+var red = (s) => `\x1B[31m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+var pass = green("\u2713");
+var fail = red("\u2717");
+var warn = yellow("!");
+var CLAUDE_SETTINGS = join(homedir(), ".claude", "settings.json");
+var SKILL_PATH = join(homedir(), ".claude", "skills", "pushary", "SKILL.md");
+var MCP_URL = "https://pushary.com/api/mcp/mcp";
+var readJson = (path) => {
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+};
+var results = [];
+var check = (passed, label, detail) => {
+  results.push({ passed, label, detail });
+  const icon = passed ? pass : fail;
+  const suffix = detail ? ` ${dim(`(${detail})`)}` : "";
+  console.log(`  ${icon} ${label}${suffix}`);
+};
+var main = async () => {
+  console.log();
+  console.log(`  ${bold("Pushary Doctor")}`);
+  console.log();
+  console.log(`  ${dim("Configuration")}`);
+  const apiKey = process.env.PUSHARY_API_KEY;
+  check(!!apiKey, "API key in environment", apiKey ? `pk_${apiKey.split(".")[0]?.slice(3, 7)}...` : "PUSHARY_API_KEY not set");
+  const settings = readJson(CLAUDE_SETTINGS);
+  if (settings) {
+    const mcpServers = settings.mcpServers;
+    const pusharyServer = mcpServers?.pushary;
+    check(!!pusharyServer, "Claude Code: MCP server configured");
+    if (pusharyServer) {
+      check(pusharyServer.type === "http", "Claude Code: MCP server type", pusharyServer.type ? String(pusharyServer.type) : 'missing \u2014 add type: "http"');
+    }
+    const hooks = settings.hooks;
+    const hasPreHook = JSON.stringify(hooks?.PreToolUse ?? []).includes("pushary-hook");
+    const hasPostHook = JSON.stringify(hooks?.PostToolUse ?? []).includes("pushary-post-hook");
+    const hasStopHook = JSON.stringify(hooks?.Stop ?? []).includes("pushary-stop-hook");
+    check(hasPreHook, "Claude Code: PreToolUse hook");
+    check(hasPostHook, "Claude Code: PostToolUse hook");
+    check(hasStopHook, "Claude Code: Stop hook");
+    const permissions = settings.permissions;
+    const hasWildcard = permissions?.allow?.some((r) => r === "MCP(pushary:*)") ?? false;
+    check(hasWildcard, "Claude Code: Pushary tools auto-allowed", hasWildcard ? "MCP(pushary:*)" : "missing");
+    const hasLegacyPerms = permissions?.allow?.some((r) => r.startsWith("mcp__pushary__")) ?? false;
+    if (hasLegacyPerms) {
+      console.log(`  ${warn} Legacy individual permissions detected ${dim("(run pushary clean, then setup again)")}`);
+    }
+  } else {
+    check(false, "Claude Code: settings.json", "not found");
+  }
+  check(existsSync(SKILL_PATH), "Skill installed", existsSync(SKILL_PATH) ? SKILL_PATH : "not found");
+  let globalVersion = "";
+  try {
+    const { execSync } = await import("child_process");
+    globalVersion = execSync("npm list -g @pushary/agent-hooks --depth=0 2>/dev/null", { encoding: "utf-8" }).match(/@pushary\/agent-hooks@([\d.]+)/)?.[1] ?? "";
+  } catch {
+  }
+  check(!!globalVersion, "Global package installed", globalVersion || "not found");
+  console.log();
+  console.log(`  ${dim("Connectivity")}`);
+  if (!apiKey) {
+    check(false, "MCP server reachable", "skipped \u2014 no API key");
+    check(false, "API key valid", "skipped");
+    check(false, "MCP handshake", "skipped");
+  } else {
+    let sessionId = "";
+    let toolCount = 0;
+    try {
+      const initRes = await fetch(MCP_URL, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json, text/event-stream",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "initialize",
+          params: {
+            protocolVersion: "2025-03-26",
+            capabilities: {},
+            clientInfo: { name: "pushary-doctor", version: "1.0" }
+          }
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      check(initRes.ok, "MCP server reachable", `${initRes.status} ${initRes.statusText}`);
+      sessionId = initRes.headers.get("mcp-session-id") ?? "";
+      check(!!sessionId, "Session ID returned", sessionId ? `${sessionId.slice(0, 8)}...` : "missing \u2014 update MCP SDK");
+      const initBody = await initRes.text();
+      const initMatch = initBody.match(/data: (.+)/);
+      if (initMatch) {
+        const initData = JSON.parse(initMatch[1]);
+        check(!!initData.result?.serverInfo, "API key valid", initData.result?.serverInfo?.name ?? "unknown server");
+      }
+      const toolsRes = await fetch(MCP_URL, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json, text/event-stream",
+          "Authorization": `Bearer ${apiKey}`,
+          ...sessionId ? { "Mcp-Session-Id": sessionId } : {}
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 2,
+          method: "tools/list",
+          params: {}
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      const toolsBody = await toolsRes.text();
+      const toolsMatch = toolsBody.match(/data: (.+)/);
+      if (toolsMatch) {
+        const toolsData = JSON.parse(toolsMatch[1]);
+        toolCount = toolsData.result?.tools?.length ?? 0;
+      }
+      check(toolCount > 0, "MCP tools discovered", `${toolCount} tools`);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "unknown error";
+      check(false, "MCP server reachable", msg);
+    }
+    console.log();
+    console.log(`  ${dim("Notification Delivery")}`);
+    try {
+      const notifRes = await fetch("https://pushary.com/api/v1/server/send", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          title: "Pushary Doctor",
+          body: "If you see this, push notifications are working."
+        }),
+        signal: AbortSignal.timeout(1e4)
+      });
+      check(notifRes.ok, "Push notification sent", notifRes.ok ? "check your phone" : `${notifRes.status}`);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "network error";
+      check(false, "Push notification sent", msg);
+    }
+    const testQuestion = await confirm({ message: "Test question roundtrip? (sends a push notification)", default: false });
+    if (testQuestion) {
+      console.log();
+      console.log(`  ${dim("Question Roundtrip")}`);
+      try {
+        const askRes = await fetch(MCP_URL, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Accept": "application/json, text/event-stream",
+            "Authorization": `Bearer ${apiKey}`
+          },
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 3,
+            method: "tools/call",
+            params: {
+              name: "ask_user",
+              arguments: {
+                question: "Pushary Doctor: tap Yes to verify the roundtrip works.",
+                type: "confirm",
+                agentName: "Pushary Doctor"
+              }
+            }
+          }),
+          signal: AbortSignal.timeout(15e3)
+        });
+        const askBody = await askRes.text();
+        const askMatch = askBody.match(/data: (.+)/);
+        let correlationId = "";
+        if (askMatch) {
+          const askData = JSON.parse(askMatch[1]);
+          const content = askData.result?.content?.[0]?.text;
+          if (content) {
+            const parsed = JSON.parse(content);
+            correlationId = parsed.correlationId;
+          }
+        }
+        if (correlationId) {
+          console.log(`  ${dim("\u2192")} Question sent, waiting for your answer...`);
+          const start = Date.now();
+          const waitRes = await fetch(MCP_URL, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "Accept": "application/json, text/event-stream",
+              "Authorization": `Bearer ${apiKey}`
+            },
+            body: JSON.stringify({
+              jsonrpc: "2.0",
+              id: 4,
+              method: "tools/call",
+              params: {
+                name: "wait_for_answer",
+                arguments: { correlationId, timeoutMs: 55e3 }
+              }
+            }),
+            signal: AbortSignal.timeout(6e4)
+          });
+          const waitBody = await waitRes.text();
+          const waitMatch = waitBody.match(/data: (.+)/);
+          if (waitMatch) {
+            const waitData = JSON.parse(waitMatch[1]);
+            const content = waitData.result?.content?.[0]?.text;
+            if (content) {
+              const parsed = JSON.parse(content);
+              const elapsed = ((Date.now() - start) / 1e3).toFixed(1);
+              check(parsed.answered === true, "Answer received", `"${parsed.value}" (${elapsed}s roundtrip)`);
+            } else {
+              check(false, "Answer received", "no response within timeout");
+            }
+          }
+        } else {
+          check(false, "Question sent", "failed to get correlationId");
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "unknown error";
+        check(false, "Question roundtrip", msg);
+      }
+    }
+  }
+  console.log();
+  const failed = results.filter((r) => !r.passed);
+  if (failed.length === 0) {
+    console.log(`  ${green(bold("All checks passed."))}`);
+  } else {
+    console.log(`  ${red(bold(`${failed.length} check${failed.length === 1 ? "" : "s"} failed:`))}`);
+    for (const f of failed) {
+      console.log(`  ${fail} ${f.label}${f.detail ? ` \u2014 ${f.detail}` : ""}`);
+    }
+    console.log();
+    console.log(`  ${dim("Run")} ${cyan("npx @pushary/agent-hooks@latest clean")} ${dim("then")} ${cyan("setup")} ${dim("to fix.")}`);
+  }
+  console.log();
+};
+main();

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@pushary/agent-hooks",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Permission hooks for AI coding agents: route tool approvals through Pushary push notifications",
   "author": "Pushary <business@pushary.com>",
   "homepage": "https://pushary.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pushary/pushary.git",
+    "url": "git+https://github.com/pushary/pushary.git",
     "directory": "packages/agent-hooks"
   },
   "license": "MIT",
@@ -20,14 +20,19 @@
     "pushary-post-hook": "./dist/bin/pushary-post-hook.js",
     "pushary-stop-hook": "./dist/bin/pushary-stop-hook.js",
     "pushary-codex": "./dist/bin/pushary-codex.js",
-    "pushary-setup": "./dist/bin/pushary-setup.js"
+    "pushary-setup": "./dist/bin/pushary-setup.js",
+    "pushary-clean": "./dist/bin/pushary-clean.js",
+    "pushary-doctor": "./dist/bin/pushary-doctor.js"
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts bin/pushary.ts bin/pushary-hook.ts bin/pushary-post-hook.ts bin/pushary-stop-hook.ts bin/pushary-codex.ts bin/pushary-setup.ts --format esm --dts --outDir dist",
-    "dev": "tsup src/index.ts bin/pushary.ts bin/pushary-hook.ts bin/pushary-post-hook.ts bin/pushary-stop-hook.ts bin/pushary-codex.ts bin/pushary-setup.ts --format esm --watch"
+    "build": "tsup src/index.ts bin/pushary.ts bin/pushary-hook.ts bin/pushary-post-hook.ts bin/pushary-stop-hook.ts bin/pushary-codex.ts bin/pushary-setup.ts bin/pushary-clean.ts bin/pushary-doctor.ts --format esm --dts --outDir dist",
+    "dev": "tsup src/index.ts bin/pushary.ts bin/pushary-hook.ts bin/pushary-post-hook.ts bin/pushary-stop-hook.ts bin/pushary-codex.ts bin/pushary-setup.ts bin/pushary-clean.ts bin/pushary-doctor.ts --format esm --watch"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.2"
   },
   "devDependencies": {
     "tsup": "^8.0.0",