gitnexushub 0.2.10 → 0.2.12

package/dist/config.js

@@ -20,7 +20,23 @@ export async function saveConfig(updates) {
 export async function clearConfig() {
     try {
         const fs = await import('fs/promises');
-        await fs.rm(CONFIG_DIR, { recursive: true, force: true });
+        // Only remove connect-specific keys, not the entire ~/.gitnexus/ dir
+        // (other tools like `gitnexus wiki` store their own config here)
+        const existing = await loadConfig();
+        if (!existing.hubToken && !existing.hubUrl)
+            return; // nothing to clear
+        const config = await readJsonFile(CONFIG_PATH);
+        if (config) {
+            delete config.hubToken;
+            delete config.hubUrl;
+            // If nothing left, remove the file; otherwise rewrite
+            if (Object.keys(config).length === 0) {
+                await fs.rm(CONFIG_PATH, { force: true });
+            }
+            else {
+                await writeJsonFile(CONFIG_PATH, config);
+            }
+        }
     }
     catch {
         // Already gone

package/dist/content.js

@@ -16,6 +16,8 @@ export const HUB_SKILLS = [
     'gitnexus-exploring',
     'gitnexus-debugging',
     'gitnexus-impact-analysis',
+    'gitnexus-refactoring',
+    'gitnexus-guide',
     'gitnexus-pr-review',
 ];
 /**
@@ -23,68 +25,68 @@ export const HUB_SKILLS = [
  * No detect_changes or rename references (not available via Hub MCP).
  */
 function generateHubContent(projectName, stats) {
-    return `${GITNEXUS_START_MARKER}
-# GitNexus — Code Intelligence
-
-This project is indexed by GitNexus as **${projectName}** (${stats.nodes || 0} symbols, ${stats.edges || 0} relationships, ${stats.processes || 0} execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
-
-> Re-indexing is managed from the GitNexus Hub dashboard.
-
-## Always Do
-
-- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run \`gitnexus_impact({target: "symbolName", direction: "upstream"})\` and report the blast radius (direct callers, affected processes, risk level) to the user.
-- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
-- When exploring unfamiliar code, use \`gitnexus_query({query: "concept"})\` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
-- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use \`gitnexus_context({name: "symbolName"})\`.
-
-## When Debugging
-
-1. \`gitnexus_query({query: "<error or symptom>"})\` — find execution flows related to the issue
-2. \`gitnexus_context({name: "<suspect function>"})\` — see all callers, callees, and process participation
-3. \`READ gitnexus://repo/${projectName}/process/{processName}\` — trace the full execution flow step by step
-
-## When Refactoring
-
-- **Extracting/Splitting**: MUST run \`gitnexus_context({name: "target"})\` to see all incoming/outgoing refs, then \`gitnexus_impact({target: "target", direction: "upstream"})\` to find all external callers before moving code.
-
-## Never Do
-
-- NEVER edit a function, class, or method without first running \`gitnexus_impact\` on it.
-- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
-
-## Tools Quick Reference
-
-| Tool | When to use | Command |
-|------|-------------|---------|
-| \`query\` | Find code by concept | \`gitnexus_query({query: "auth validation"})\` |
-| \`context\` | 360-degree view of one symbol | \`gitnexus_context({name: "validateUser"})\` |
-| \`impact\` | Blast radius before editing | \`gitnexus_impact({target: "X", direction: "upstream"})\` |
-| \`cypher\` | Custom graph queries | \`gitnexus_cypher({query: "MATCH ..."})\` |
-
-## Impact Risk Levels
-
-| Depth | Meaning | Action |
-|-------|---------|--------|
-| d=1 | WILL BREAK — direct callers/importers | MUST update these |
-| d=2 | LIKELY AFFECTED — indirect deps | Should test |
-| d=3 | MAY NEED TESTING — transitive | Test if critical path |
-
-## Resources
-
-| Resource | Use for |
-|----------|---------|
-| \`gitnexus://repo/${projectName}/context\` | Codebase overview, check index freshness |
-| \`gitnexus://repo/${projectName}/clusters\` | All functional areas |
-| \`gitnexus://repo/${projectName}/processes\` | All execution flows |
-| \`gitnexus://repo/${projectName}/process/{name}\` | Step-by-step execution trace |
-
-## Self-Check Before Finishing
-
-Before completing any code modification task, verify:
-1. \`gitnexus_impact\` was run for all modified symbols
-2. No HIGH/CRITICAL risk warnings were ignored
-3. All d=1 (WILL BREAK) dependents were updated
-
+    return `${GITNEXUS_START_MARKER}
+# GitNexus — Code Intelligence
+
+This project is indexed by GitNexus as **${projectName}** (${stats.nodes || 0} symbols, ${stats.edges || 0} relationships, ${stats.processes || 0} execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
+
+> Re-indexing is managed from the GitNexus Hub dashboard.
+
+## Always Do
+
+- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run \`gitnexus_impact({target: "symbolName", direction: "upstream"})\` and report the blast radius (direct callers, affected processes, risk level) to the user.
+- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
+- When exploring unfamiliar code, use \`gitnexus_query({query: "concept"})\` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
+- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use \`gitnexus_context({name: "symbolName"})\`.
+
+## When Debugging
+
+1. \`gitnexus_query({query: "<error or symptom>"})\` — find execution flows related to the issue
+2. \`gitnexus_context({name: "<suspect function>"})\` — see all callers, callees, and process participation
+3. \`READ gitnexus://repo/${projectName}/process/{processName}\` — trace the full execution flow step by step
+
+## When Refactoring
+
+- **Extracting/Splitting**: MUST run \`gitnexus_context({name: "target"})\` to see all incoming/outgoing refs, then \`gitnexus_impact({target: "target", direction: "upstream"})\` to find all external callers before moving code.
+
+## Never Do
+
+- NEVER edit a function, class, or method without first running \`gitnexus_impact\` on it.
+- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
+
+## Tools Quick Reference
+
+| Tool | When to use | Command |
+|------|-------------|---------|
+| \`query\` | Find code by concept | \`gitnexus_query({query: "auth validation"})\` |
+| \`context\` | 360-degree view of one symbol | \`gitnexus_context({name: "validateUser"})\` |
+| \`impact\` | Blast radius before editing | \`gitnexus_impact({target: "X", direction: "upstream"})\` |
+| \`cypher\` | Custom graph queries | \`gitnexus_cypher({query: "MATCH ..."})\` |
+
+## Impact Risk Levels
+
+| Depth | Meaning | Action |
+|-------|---------|--------|
+| d=1 | WILL BREAK — direct callers/importers | MUST update these |
+| d=2 | LIKELY AFFECTED — indirect deps | Should test |
+| d=3 | MAY NEED TESTING — transitive | Test if critical path |
+
+## Resources
+
+| Resource | Use for |
+|----------|---------|
+| \`gitnexus://repo/${projectName}/context\` | Codebase overview, check index freshness |
+| \`gitnexus://repo/${projectName}/clusters\` | All functional areas |
+| \`gitnexus://repo/${projectName}/processes\` | All execution flows |
+| \`gitnexus://repo/${projectName}/process/{name}\` | Step-by-step execution trace |
+
+## Self-Check Before Finishing
+
+Before completing any code modification task, verify:
+1. \`gitnexus_impact\` was run for all modified symbols
+2. No HIGH/CRITICAL risk warnings were ignored
+3. All d=1 (WILL BREAK) dependents were updated
+
 ${GITNEXUS_END_MARKER}`;
 }
 /**

package/dist/editors/claude-code.js

@@ -17,13 +17,14 @@ async function configure(hubUrl, token) {
         if (!existing.mcpServers || typeof existing.mcpServers !== 'object') {
             existing.mcpServers = {};
         }
+        const overrodeCli = !!(existing.mcpServers.gitnexus && 'command' in existing.mcpServers.gitnexus);
         existing.mcpServers.gitnexus = {
             type: 'http',
             url: mcpUrl,
             headers: { Authorization: `Bearer ${token}` },
         };
         await writeJsonFile(claudeJsonPath, existing);
-        return { success: true, message: 'MCP configured in ~/.claude.json' };
+        return { success: true, message: 'MCP configured in ~/.claude.json', overrodeCli };
     }
     catch (err) {
         return { success: false, message: `Failed: ${err.message}` };

package/dist/editors/cursor.js

@@ -23,9 +23,10 @@ async function configure(hubUrl, token) {
         if (!existing.mcpServers || typeof existing.mcpServers !== 'object') {
             existing.mcpServers = {};
         }
+        const overrodeCli = !!(existing.mcpServers.gitnexus && 'command' in existing.mcpServers.gitnexus);
         existing.mcpServers.gitnexus = getMcpConfig(hubUrl, token);
         await writeJsonFile(mcpPath, existing);
-        return { success: true, message: 'MCP configured in ~/.cursor/mcp.json' };
+        return { success: true, message: 'MCP configured in ~/.cursor/mcp.json', overrodeCli };
     }
     catch (err) {
         return { success: false, message: `Failed: ${err.message}` };

package/dist/editors/opencode.js

@@ -23,9 +23,10 @@ async function configure(hubUrl, token) {
         if (!existing.mcp || typeof existing.mcp !== 'object') {
             existing.mcp = {};
         }
+        const overrodeCli = !!(existing.mcp.gitnexus && 'command' in existing.mcp.gitnexus);
         existing.mcp.gitnexus = getMcpConfig(hubUrl, token);
         await writeJsonFile(configPath, existing);
-        return { success: true, message: 'MCP configured in ~/.config/opencode/opencode.json' };
+        return { success: true, message: 'MCP configured in ~/.config/opencode/opencode.json', overrodeCli };
     }
     catch (err) {
         return { success: false, message: `Failed: ${err.message}` };

package/dist/editors/types.d.ts

@@ -16,4 +16,5 @@ export interface EditorConfig {
 export interface ConfigureResult {
     success: boolean;
     message: string;
+    overrodeCli?: boolean;
 }

package/dist/editors/windsurf.js

@@ -22,9 +22,10 @@ async function configure(hubUrl, token) {
         if (!existing.mcpServers || typeof existing.mcpServers !== 'object') {
             existing.mcpServers = {};
         }
+        const overrodeCli = !!(existing.mcpServers.gitnexus && 'command' in existing.mcpServers.gitnexus);
         existing.mcpServers.gitnexus = getMcpConfig(hubUrl, token);
         await writeJsonFile(mcpPath, existing);
-        return { success: true, message: 'MCP configured in ~/.codeium/windsurf/mcp_config.json' };
+        return { success: true, message: 'MCP configured in ~/.codeium/windsurf/mcp_config.json', overrodeCli };
     }
     catch (err) {
         return { success: false, message: `Failed: ${err.message}` };

package/dist/index.js

@@ -22,7 +22,7 @@ import { cursorEditor } from './editors/cursor.js';
 import { windsurfEditor } from './editors/windsurf.js';
 import { opencodeEditor } from './editors/opencode.js';
 import { claudeCodeEditor } from './editors/claude-code.js';
-const DEFAULT_HUB_URL = 'https://gitnexus-enterprise-production.up.railway.app';
+const DEFAULT_HUB_URL = process.env.GITNEXUS_HUB_URL || 'https://gitnexus-enterprise-production.up.railway.app';
 const EDITORS = {
     'claude-code': claudeCodeEditor,
     cursor: cursorEditor,
@@ -190,6 +190,12 @@ async function runConnect(tokenArg, opts) {
         const result = await editor.configure(hubUrl, token);
         if (result.success) {
             ok(result.message);
+            if (result.overrodeCli) {
+                console.log('');
+                console.log(`  ${pc.cyan('⬆')} ${pc.bold('GitNexus open-source detected — upgraded to Hub')}`);
+                console.log(`     ${pc.dim('Remote indexing. Deeper analysis. PR blast radius. Auto-reindex on push.')}`);
+                console.log(`     ${pc.dim('Your tools (query, context, impact) are unchanged — just faster and smarter.')}`);
+            }
         }
         else {
             fail(result.message);

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "gitnexushub",
-  "version": "0.2.10",
-  "description": "Connect your editor to GitNexus Hub — one command MCP setup + project context",
-  "author": "Abhigyan Patwari",
-  "license": "PolyForm-Noncommercial-1.0.0",
-  "homepage": "https://app.akonlabs.com",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Akon-Labs/gitnexus-enterprise.git",
-    "directory": "gitnexus-connect"
-  },
-  "bugs": {
-    "url": "https://github.com/Akon-Labs/gitnexus-enterprise/issues"
-  },
-  "keywords": [
-    "gitnexus",
-    "mcp",
-    "model-context-protocol",
-    "claude",
-    "cursor",
-    "windsurf",
-    "code-intelligence",
-    "ai-agent"
-  ],
-  "type": "module",
-  "bin": {
-    "gnx": "dist/index.js",
-    "gitnexus-connect": "dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "prepare": "npm run build"
-  },
-  "dependencies": {
-    "commander": "^12.0.0",
-    "picocolors": "^1.1.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.19.37",
-    "tsx": "^4.0.0",
-    "typescript": "^5.4.5"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist",
-    "skills"
-  ],
-  "publishConfig": {}
-}
+{
+  "name": "gitnexushub",
+  "version": "0.2.12",
+  "description": "Connect your editor to GitNexus Hub — one command MCP setup + project context",
+  "author": "Abhigyan Patwari",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "homepage": "https://app.akonlabs.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Akon-Labs/gitnexus-enterprise.git",
+    "directory": "gitnexus-connect"
+  },
+  "bugs": {
+    "url": "https://github.com/Akon-Labs/gitnexus-enterprise/issues"
+  },
+  "keywords": [
+    "gitnexus",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cursor",
+    "windsurf",
+    "code-intelligence",
+    "ai-agent"
+  ],
+  "type": "module",
+  "bin": {
+    "gnx": "dist/index.js",
+    "gitnexus-connect": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.37",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "publishConfig": {}
+}

package/skills/gitnexus-debugging.md

@@ -1,89 +1,89 @@
----
-name: gitnexus-debugging
-description: "Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\""
----
-
-# Debugging with GitNexus
-
-## When to Use
-
-- "Why is this function failing?"
-- "Trace where this error comes from"
-- "Who calls this method?"
-- "This endpoint returns 500"
-- Investigating bugs, errors, or unexpected behavior
-
-## Workflow
-
-```
-1. gitnexus_query({query: "<error or symptom>"})            → Find related execution flows
-2. gitnexus_context({name: "<suspect>"})                    → See callers/callees/processes
-3. READ gitnexus://repo/{name}/process/{name}                → Trace execution flow
-4. gitnexus_cypher({query: "MATCH path..."})                 → Custom traces if needed
-```
-
-> If "Index is stale" → trigger re-indexing from the Hub dashboard.
-
-## Checklist
-
-```
-- [ ] Understand the symptom (error message, unexpected behavior)
-- [ ] gitnexus_query for error text or related code
-- [ ] Identify the suspect function from returned processes
-- [ ] gitnexus_context to see callers and callees
-- [ ] Trace execution flow via process resource if applicable
-- [ ] gitnexus_cypher for custom call chain traces if needed
-- [ ] Read source files to confirm root cause
-```
-
-## Debugging Patterns
-
-| Symptom              | GitNexus Approach                                          |
-| -------------------- | ---------------------------------------------------------- |
-| Error message        | `gitnexus_query` for error text → `context` on throw sites |
-| Wrong return value   | `context` on the function → trace callees for data flow    |
-| Intermittent failure | `context` → look for external calls, async deps            |
-| Performance issue    | `context` → find symbols with many callers (hot paths)     |
-| Recent regression    | `impact` on changed functions → check what callers broke   |
-
-## Tools
-
-**gitnexus_query** — find code related to error:
-
-```
-gitnexus_query({query: "payment validation error"})
-→ Processes: CheckoutFlow, ErrorHandling
-→ Symbols: validatePayment, handlePaymentError, PaymentException
-```
-
-**gitnexus_context** — full context for a suspect:
-
-```
-gitnexus_context({name: "validatePayment"})
-→ Incoming calls: processCheckout, webhookHandler
-→ Outgoing calls: verifyCard, fetchRates (external API!)
-→ Processes: CheckoutFlow (step 3/7)
-```
-
-**gitnexus_cypher** — custom call chain traces:
-
-```cypher
-MATCH path = (a)-[:CodeRelation {type: 'CALLS'}*1..2]->(b:Function {name: "validatePayment"})
-RETURN [n IN nodes(path) | n.name] AS chain
-```
-
-## Example: "Payment endpoint returns 500 intermittently"
-
-```
-1. gitnexus_query({query: "payment error handling"})
-   → Processes: CheckoutFlow, ErrorHandling
-   → Symbols: validatePayment, handlePaymentError
-
-2. gitnexus_context({name: "validatePayment"})
-   → Outgoing calls: verifyCard, fetchRates (external API!)
-
-3. READ gitnexus://repo/my-app/process/CheckoutFlow
-   → Step 3: validatePayment → calls fetchRates (external)
-
-4. Root cause: fetchRates calls external API without proper timeout
-```
+---
+name: gitnexus-debugging
+description: "Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\""
+---
+
+# Debugging with GitNexus
+
+## When to Use
+
+- "Why is this function failing?"
+- "Trace where this error comes from"
+- "Who calls this method?"
+- "This endpoint returns 500"
+- Investigating bugs, errors, or unexpected behavior
+
+## Workflow
+
+```
+1. gitnexus_query({query: "<error or symptom>"})            → Find related execution flows
+2. gitnexus_context({name: "<suspect>"})                    → See callers/callees/processes
+3. READ gitnexus://repo/{name}/process/{name}                → Trace execution flow
+4. gitnexus_cypher({query: "MATCH path..."})                 → Custom traces if needed
+```
+
+> If "Index is stale" → trigger re-indexing from the Hub dashboard.
+
+## Checklist
+
+```
+- [ ] Understand the symptom (error message, unexpected behavior)
+- [ ] gitnexus_query for error text or related code
+- [ ] Identify the suspect function from returned processes
+- [ ] gitnexus_context to see callers and callees
+- [ ] Trace execution flow via process resource if applicable
+- [ ] gitnexus_cypher for custom call chain traces if needed
+- [ ] Read source files to confirm root cause
+```
+
+## Debugging Patterns
+
+| Symptom              | GitNexus Approach                                          |
+| -------------------- | ---------------------------------------------------------- |
+| Error message        | `gitnexus_query` for error text → `context` on throw sites |
+| Wrong return value   | `context` on the function → trace callees for data flow    |
+| Intermittent failure | `context` → look for external calls, async deps            |
+| Performance issue    | `context` → find symbols with many callers (hot paths)     |
+| Recent regression    | `impact` on changed functions → check what callers broke   |
+
+## Tools
+
+**gitnexus_query** — find code related to error:
+
+```
+gitnexus_query({query: "payment validation error"})
+→ Processes: CheckoutFlow, ErrorHandling
+→ Symbols: validatePayment, handlePaymentError, PaymentException
+```
+
+**gitnexus_context** — full context for a suspect:
+
+```
+gitnexus_context({name: "validatePayment"})
+→ Incoming calls: processCheckout, webhookHandler
+→ Outgoing calls: verifyCard, fetchRates (external API!)
+→ Processes: CheckoutFlow (step 3/7)
+```
+
+**gitnexus_cypher** — custom call chain traces:
+
+```cypher
+MATCH path = (a)-[:CodeRelation {type: 'CALLS'}*1..2]->(b:Function {name: "validatePayment"})
+RETURN [n IN nodes(path) | n.name] AS chain
+```
+
+## Example: "Payment endpoint returns 500 intermittently"
+
+```
+1. gitnexus_query({query: "payment error handling"})
+   → Processes: CheckoutFlow, ErrorHandling
+   → Symbols: validatePayment, handlePaymentError
+
+2. gitnexus_context({name: "validatePayment"})
+   → Outgoing calls: verifyCard, fetchRates (external API!)
+
+3. READ gitnexus://repo/my-app/process/CheckoutFlow
+   → Step 3: validatePayment → calls fetchRates (external)
+
+4. Root cause: fetchRates calls external API without proper timeout
+```