instagit 0.1.5 → 0.1.6

package/README.md

@@ -1,6 +1,8 @@
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=instagit&config=eyJjb21tYW5kIjoibnB4IC15IGluc3RhZ2l0QGxhdGVzdCJ9)
+
 # Instagit
 
-**Let Your Agents Instantly Understand the World's Code**
+**Let Your Agents Instantly Understand Any GitHub Repo**
 
 An MCP server that gives coding agents instant insight into any Git repository — no guessing, no hallucination.
 

package/dist/index.js

@@ -95,6 +95,34 @@ function formatMessage(tracker, status, tokens) {
   return parts.join(" \xB7 ");
 }
 
+// src/retry.ts
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([303, 429, 502, 503, 504]);
+var MAX_RETRIES = 3;
+var RETRY_BASE_DELAY = 5;
+var FETCH_TIMEOUT = 30 * 60 * 1e3;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var TRANSPORT_ERROR_PATTERNS = [
+  "incomplete chunked read",
+  "peer closed connection",
+  "connection reset",
+  "timed out",
+  "fetch failed",
+  "ECONNREFUSED"
+];
+function isTransportError(error) {
+  const message = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+  const lower = message.toLowerCase();
+  return TRANSPORT_ERROR_PATTERNS.some((p) => lower.includes(p.toLowerCase()));
+}
+function isSecurityRejection(text) {
+  return text.length < 100 && text.toLowerCase().includes("security validation");
+}
+function getRetryDelay(attempt) {
+  return RETRY_BASE_DELAY * 2 ** attempt * 1e3;
+}
+
 // src/api.ts
 var DEFAULT_API_URL = "https://instagit--instagit-api-api.modal.run";
 function getApiUrl() {
@@ -139,68 +167,115 @@ async function analyzeRepoStreaming(opts) {
     }, 250);
   }
   try {
-    const response = await fetch(`${apiUrl}/v1/responses`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(payload)
-    });
-    if (!response.ok) {
-      const errorBody = await response.text().catch(() => "");
-      const error = new Error(`API error: ${response.status}`);
-      error.status = response.status;
-      error.body = errorBody;
-      throw error;
-    }
-    if (!response.body) {
-      throw new Error("No response body");
-    }
-    await new Promise((resolve, reject) => {
-      const parser = (0, import_eventsource_parser.createParser)({
-        onEvent(event) {
-          if (event.data === "[DONE]") {
-            resolve();
-            return;
-          }
-          let data;
-          try {
-            data = JSON.parse(event.data);
-          } catch {
-            return;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+      collectedText = "";
+      usage = {};
+      try {
+        const response = await fetch(`${apiUrl}/v1/responses`, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(payload),
+          signal: AbortSignal.timeout(FETCH_TIMEOUT)
+        });
+        if (!response.ok) {
+          const errorBody = await response.text().catch(() => "");
+          const error = new Error(`API error: ${response.status}`);
+          error.status = response.status;
+          error.body = errorBody;
+          throw error;
+        }
+        if (!response.body) {
+          throw new Error("No response body");
+        }
+        await new Promise((resolve, reject) => {
+          const parser = (0, import_eventsource_parser.createParser)({
+            onEvent(event) {
+              if (event.data === "[DONE]") {
+                resolve();
+                return;
+              }
+              let data;
+              try {
+                data = JSON.parse(event.data);
+              } catch {
+                return;
+              }
+              const eventType = data.type ?? "";
+              if (eventType === "response.reasoning.delta") {
+                const status = data.delta ?? "";
+                if (status) tracker.lastStatus = status;
+                if (data.tokens) {
+                  if (data.tokens.input !== void 0) tracker.inputTokens = data.tokens.input;
+                  if (data.tokens.output !== void 0) tracker.outputTokens = data.tokens.output;
+                }
+              } else if (eventType === "response.output_text.delta") {
+                const delta = data.delta ?? "";
+                collectedText += delta;
+                if (tracker.outputTokens === 0) {
+                  tracker.outputTokens = Math.floor(collectedText.length / 4);
+                }
+                tracker.lastStatus = "Writing response...";
+              } else if (eventType === "response.completed") {
+                usage = data.response?.usage ?? {};
+              }
+            }
+          });
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          function read() {
+            reader.read().then(({ done, value }) => {
+              if (done) {
+                resolve();
+                return;
+              }
+              parser.feed(decoder.decode(value, { stream: true }));
+              read();
+            }).catch(reject);
           }
-          const eventType = data.type ?? "";
-          if (eventType === "response.reasoning.delta") {
-            const status = data.delta ?? "";
-            if (status) tracker.lastStatus = status;
-            if (data.tokens) {
-              if (data.tokens.input !== void 0) tracker.inputTokens = data.tokens.input;
-              if (data.tokens.output !== void 0) tracker.outputTokens = data.tokens.output;
+          read();
+        });
+        if (isSecurityRejection(collectedText)) {
+          throw new Error(`Request blocked: ${collectedText.slice(0, 200)}`);
+        }
+        if (!collectedText) {
+          if (attempt < MAX_RETRIES) {
+            if (progressCallback) {
+              tracker.lastStatus = `Retrying... (attempt ${attempt + 2}/${MAX_RETRIES + 1})`;
             }
-          } else if (eventType === "response.output_text.delta") {
-            const delta = data.delta ?? "";
-            collectedText += delta;
-            if (tracker.outputTokens === 0) {
-              tracker.outputTokens = Math.floor(collectedText.length / 4);
+            await sleep(getRetryDelay(attempt));
+            continue;
+          }
+          throw new Error("Empty response after retries");
+        }
+        break;
+      } catch (error) {
+        if (error instanceof Error && error.message.startsWith("Request blocked:")) {
+          throw error;
+        }
+        const statusError = error;
+        if (statusError.status && RETRYABLE_STATUS_CODES.has(statusError.status)) {
+          if (attempt < MAX_RETRIES) {
+            if (progressCallback) {
+              tracker.lastStatus = `Retrying... (attempt ${attempt + 2}/${MAX_RETRIES + 1})`;
             }
-            tracker.lastStatus = "Writing response...";
-          } else if (eventType === "response.completed") {
-            usage = data.response?.usage ?? {};
+            await sleep(getRetryDelay(attempt));
+            continue;
           }
+          throw error;
         }
-      });
-      const reader = response.body.getReader();
-      const decoder = new TextDecoder();
-      function read() {
-        reader.read().then(({ done, value }) => {
-          if (done) {
-            resolve();
-            return;
+        if (isTransportError(error)) {
+          if (attempt < MAX_RETRIES) {
+            if (progressCallback) {
+              tracker.lastStatus = `Retrying... (attempt ${attempt + 2}/${MAX_RETRIES + 1})`;
+            }
+            await sleep(getRetryDelay(attempt));
+            continue;
           }
-          parser.feed(decoder.decode(value, { stream: true }));
-          read();
-        }).catch(reject);
+          throw error;
+        }
+        throw error;
       }
-      read();
-    });
+    }
   } finally {
     tracker.done = true;
     if (heartbeatInterval) {
@@ -293,25 +368,40 @@ function getOrCreateToken() {
   return getStoredToken();
 }
 async function registerAnonymousToken(apiUrl) {
-  try {
-    const fingerprint = getMachineFingerprint();
-    const response = await fetch(`${apiUrl}/v1/auth/anonymous`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ fingerprint })
-    });
-    if (response.ok) {
-      const data = await response.json();
-      const token = data.token;
-      if (token) {
-        storeToken(token);
-        return token;
+  const fingerprint = getMachineFingerprint();
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    try {
+      const response = await fetch(`${apiUrl}/v1/auth/anonymous`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ fingerprint }),
+        signal: AbortSignal.timeout(FETCH_TIMEOUT)
+      });
+      if (response.ok) {
+        const data = await response.json();
+        const token = data.token;
+        if (token) {
+          storeToken(token);
+          return token;
+        }
+      }
+      if (RETRYABLE_STATUS_CODES.has(response.status)) {
+        await response.text().catch(() => "");
+        if (attempt < MAX_RETRIES) {
+          await sleep(getRetryDelay(attempt));
+          continue;
+        }
+      }
+      return null;
+    } catch (error) {
+      if (isTransportError(error) && attempt < MAX_RETRIES) {
+        await sleep(getRetryDelay(attempt));
+        continue;
       }
+      return null;
     }
-    return null;
-  } catch {
-    return null;
   }
+  return null;
 }
 
 // src/index.ts
@@ -319,14 +409,35 @@ var server = new import_mcp.McpServer({
   name: "instagit",
   version: "0.1.5"
 });
-var TOOL_DESCRIPTION = `Analyze any Git repository with AI. Point it at a repo and ask questions about the codebase. Use cases include:
-- Understanding unfamiliar codebases: 'Explain the architecture and main components'
-- Code review assistance: 'Review the authentication implementation for security issues'
-- Documentation generation: 'Document the public API of this library'
-- Dependency analysis: 'What external services does this app depend on?'
-- Onboarding help: 'How would I add a new API endpoint following existing patterns?'
-- Bug investigation: 'Where might null pointer exceptions occur in the data pipeline?'
-- Migration planning: 'What would it take to upgrade from React 17 to 18?'
+var TOOL_DESCRIPTION = `Analyze any Git repository with AI. Point it at a repo and ask questions about the codebase.
+
+Example prompts by use case:
+
+Understanding Architecture:
+- repo: "nginx/nginx", prompt: "How does nginx handle concurrent connections? Walk through the event loop, worker process model, and connection state transitions."
+
+Integration and API Usage:
+- repo: "hashicorp/terraform", prompt: "How do I implement a custom provider? What interfaces does the SDK expose, how are CRUD operations mapped to the resource lifecycle?"
+
+Debugging and Troubleshooting:
+- repo: "docker/compose", prompt: "How does Compose resolve service dependencies and startup order? What happens with depends_on and health check conditions?"
+
+Security Review:
+- repo: "redis/redis", prompt: "Review the ACL security model. How are per-user command permissions enforced, and how does AUTH prevent privilege escalation?"
+
+Code Quality and Evaluation:
+- repo: "vitejs/vite", prompt: "How does Vite's plugin system compare to Rollup's? What are the Vite-specific hooks and tradeoffs?"
+
+Deep Technical Analysis:
+- repo: "ggml-org/llama.cpp", prompt: "How does the KV cache work during autoregressive generation? How are past key-value pairs stored, reused, and evicted?"
+
+Migration Planning (with ref \u2014 Pro/Max plans only):
+- repo: "mui/material-ui", ref: "v4.12.0", prompt: "Document the Button component's full API surface \u2014 every prop, its type, default value, and behavior."
+- repo: "mui/material-ui", ref: "v5.0.0", prompt: "Document the Button component's full API surface \u2014 every prop, its type, default value, and behavior."
+  (Compare both results to build a migration guide between v4 and v5)
+- repo: "kubernetes/kubernetes", ref: "release-1.29", prompt: "How does the scheduler's scoring and filtering pipeline work for pod placement?"
+
+Ask detailed, specific questions \u2014 the tool returns real function signatures, parameter types, return values, and source citations with exact file paths and line numbers.
 
 If you hit a rate limit (429), the user's monthly token credits are exhausted \u2014 they can wait for the reset or upgrade their plan. Free-tier repos larger than 2 GB will be rejected with a 413 error; suggest upgrading to Pro or Max for unlimited repo size.`;
 server.tool(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instagit",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "mcpName": "io.github.instagitai/instagit",
   "description": "MCP server for Instagit — AI-powered Git repository analysis for coding agents",
   "author": "Instalabs, LLC",