@pharaoh-so/mcp 0.3.12 → 0.3.14

package/inspect-tools.json

@@ -724,46 +724,46 @@
     },
     {
       "name": "pharaoh_account",
-      "description": "View your Pharaoh subscription status and manage billing. Toggle PR Guard and trigger graph refreshes.\n\nCALL THIS WHEN:\n• You want to check your subscription status\n• You need to update payment method, view invoices, or cancel\n• You want to know what plan you're on\n• You want to change which repo is active on the free tier\n• You want to enable or disable PR Guard on a repo\n• You want to refresh a repo's graph (re-map with latest code)\n• You want to open the Pharaoh dashboard to manage repos and settings visually",
+      "description": "View your Pharaoh subscription status and manage billing. Toggle PR Guard and trigger graph refreshes.\n\nPick one action and provide its fields. Each action has its own required and\noptional parameters; invalid combinations are rejected at parse time.\n\n• status — full account overview (plan, subscriptions, PR Guard, dashboard URL)\n• set_free_repo { repo } — change which repo is active on the free tier\n• refresh_repo { repo, full? } — re-map a single repo you own\n• refresh_all { force?, full? } — re-map every repo across your accessible orgs\n• enable_pr_guard { repos: [...] } — enable PR Guard on one or more repos, returns full status\n• disable_pr_guard { repos: [...] } — disable PR Guard on one or more repos, returns full status\n\nCALL THIS WHEN:\n• You want to check your subscription status\n• You need to update payment method, view invoices, or cancel\n• You want to know what plan you're on\n• You want to change which repo is active on the free tier\n• You want to enable or disable PR Guard on a repo\n• You want to refresh a repo's graph (re-map with latest code)\n• You want to open the Pharaoh dashboard to manage repos and settings visually\n\nFlag reference:\n  force = skip smart-skip (already-on-current-version check). Bulk refresh only.\n  full  = force full remap, bypassing incremental diff. Use after schema changes.",
       "inputSchema": {
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
         "properties": {
-          "enable_pr_guard": {
-            "description": "Repo slugs (owner/repo) to enable PR Guard on",
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
+          "action": {
+            "type": "string",
+            "enum": [
+              "status",
+              "set_free_repo",
+              "refresh_repo",
+              "refresh_all",
+              "enable_pr_guard",
+              "disable_pr_guard"
+            ],
+            "description": "Which account action to perform"
           },
-          "disable_pr_guard": {
-            "description": "Repo slugs (owner/repo) to disable PR Guard on",
+          "repo": {
+            "description": "Used by: set_free_repo (required), refresh_repo (required). Repo slug (owner/repo).",
+            "type": "string"
+          },
+          "repos": {
+            "description": "Used by: enable_pr_guard, disable_pr_guard (required). Repo slugs (owner/repo) to toggle.",
             "type": "array",
             "items": {
               "type": "string"
             }
           },
-          "set_free_repo": {
-            "description": "Repo slug (owner/repo) to set as your active free-tier repo",
-            "type": "string"
-          },
-          "refresh_repo": {
-            "description": "Repo slug (owner/repo) to re-map. Must belong to your org.",
-            "type": "string"
-          },
-          "refresh_all": {
-            "description": "Re-map all repos in your org (rate limited: once per hour)",
-            "type": "boolean"
-          },
           "force": {
-            "description": "Bulk refresh only (refresh_all): skip the 'already on current version' check. Does NOT force full remap — use `full: true` for that. Ignored with refresh_repo.",
+            "description": "Used by: refresh_all. Skip the 'already on current version' smart-skip check. Does NOT force full remap — use `full` for that.",
             "type": "boolean"
           },
           "full": {
-            "description": "Force full remap, bypassing incremental-diff detection. Use after schema changes or to rebuild the graph from scratch. Combine with refresh_repo or refresh_all.",
+            "description": "Used by: refresh_repo, refresh_all. Force full remap, bypassing incremental diff. Use after schema changes or to rebuild the graph from scratch.",
             "type": "boolean"
           }
-        }
+        },
+        "required": [
+          "action"
+        ]
       },
       "annotations": {
         "title": "Account Management",
@@ -846,7 +846,7 @@
     },
     {
       "name": "request_upload",
-      "description": "Map a local repo into Pharaoh without installing the GitHub App. Source code never leaves the machine — only structural metadata (function names, imports, exports, complexity) is uploaded.\n\nCALL THIS WHEN:\n- get_codebase_map returns no repos for this user\n- The user asks about a repo that isn't mapped in Pharaoh\n- The user wants to map a private repo without admin access\n- The user says \"analyze this repo\", \"map this codebase\", or similar\n\nWhen 'path' is provided, this tool returns a ready-to-run bash block that parses the repo locally and uploads the structural metadata. The agent should execute this bash block directly — no user action needed beyond approval. The upload URL is single-use and expires in 10 minutes.",
+      "description": "Evaluation mode: maps a repo locally, uploads only function names and dependency edges. Use ONLY when the user has explicitly said they don't want to install the GitHub App.\n\nThe GitHub App is how Pharaoh is meant to be used. 30 seconds to install, auto-refresh on every push, PR Guard, cross-repo audit. Evaluation mode gives up all of that. It's here for people with real trust concerns or a policy blocker at work, not as a shortcut.\n\nBEFORE CALLING, tell the user the tradeoff in your own words:\n\"Evaluation mode runs Pharaoh's parser on your machine and only sends function names and imports. Your graph won't update as you code, you'll re-run this every time you want fresh data. Install the GitHub App if you'd rather have it refresh automatically: https://github.com/apps/pharaoh-so/installations/new\"\n\nThen wait for confirmation. Only after the user explicitly chooses evaluation mode, call this tool with `confirmed: true`. Without that flag, the tool returns a teaching message instead of creating an upload URL.\n\nDO NOT USE when:\n- The user said \"analyze this repo\" or \"map my codebase\". They want the real thing. Point them at the install link.\n- get_codebase_map returned zero repos. The user needs to install the App. Don't route around the install step.\n- You're working around a \"repo not tracked\" error. Diagnose the missing install, don't bypass it.\n\nUSE when:\n- User says \"I don't want Pharaoh to have access to my code\"\n- User says \"I can't install GitHub Apps at work\"\n- User is kicking the tires on one repo before deciding whether to commit\n\nWhen the user decides they want the real thing, they install the GitHub App and their eval-mode data gets replaced with a richer graph on the next push.",
       "inputSchema": {
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
@@ -860,6 +860,10 @@
           "path": {
             "description": "Absolute path to the local repo directory. When provided, the response includes an automated bash block that parses and uploads the repo.",
             "type": "string"
+          },
+          "confirmed": {
+            "description": "Must be set to true after the user has explicitly chosen evaluation mode over installing the GitHub App. Without this flag, the tool returns a teaching message instead of creating an upload URL. This is the audit trail for explicit opt-in.",
+            "type": "boolean"
           }
         },
         "required": [

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pharaoh-so/mcp",
   "mcpName": "so.pharaoh/pharaoh",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "MCP proxy for Pharaoh — maps codebases into queryable knowledge graphs for AI agents. Enables Claude Code in headless environments (VPS, SSH, CI) via device flow auth.",
   "type": "module",
   "main": "dist/index.js",