gitnexus 1.2.0 → 1.2.2

package/dist/cli/index.js

@@ -15,7 +15,7 @@ const program = new Command();
 program
     .name('gitnexus')
     .description('GitNexus local CLI and MCP server')
-    .version('1.1.9');
+    .version('1.2.0');
 program
     .command('setup')
     .description('One-time setup: configure MCP for Cursor, Claude Code, OpenCode')
@@ -56,6 +56,7 @@ program
     .option('--model <model>', 'LLM model name (default: gpt-4o-mini)')
     .option('--base-url <url>', 'LLM API base URL (default: OpenAI)')
     .option('--api-key <key>', 'LLM API key (saved to ~/.gitnexus/config.json)')
+    .option('--gist', 'Publish wiki as a public GitHub Gist after generation')
     .action(wikiCommand);
 program
     .command('augment <pattern>')

package/dist/cli/wiki.d.ts

@@ -9,5 +9,6 @@ export interface WikiCommandOptions {
     model?: string;
     baseUrl?: string;
     apiKey?: string;
+    gist?: boolean;
 }
 export declare const wikiCommand: (inputPath?: string, options?: WikiCommandOptions) => Promise<void>;

package/dist/cli/wiki.js

@@ -6,6 +6,7 @@
  */
 import path from 'path';
 import readline from 'readline';
+import { execSync } from 'child_process';
 import cliProgress from 'cli-progress';
 import { getGitRoot, isGitRepo } from '../storage/git.js';
 import { getStoragePaths, loadMeta, loadCLIConfig, saveCLIConfig } from '../storage/repo-manager.js';
@@ -94,11 +95,18 @@ export const wikiCommand = async (inputPath, options) => {
         return;
     }
     // ── Resolve LLM config (with interactive fallback) ─────────────────
-    // If --api-key was passed via CLI, save it immediately
-    if (options?.apiKey) {
+    // Save any CLI overrides immediately
+    if (options?.apiKey || options?.model || options?.baseUrl) {
         const existing = await loadCLIConfig();
-        await saveCLIConfig({ ...existing, apiKey: options.apiKey });
-        console.log('  API key saved to ~/.gitnexus/config.json\n');
+        const updates = {};
+        if (options.apiKey)
+            updates.apiKey = options.apiKey;
+        if (options.model)
+            updates.model = options.model;
+        if (options.baseUrl)
+            updates.baseUrl = options.baseUrl;
+        await saveCLIConfig({ ...existing, ...updates });
+        console.log('  Config saved to ~/.gitnexus/config.json\n');
     }
     let llmConfig = await resolveLLMConfig({
         model: options?.model,
@@ -113,25 +121,52 @@ export const wikiCommand = async (inputPath, options) => {
             process.exitCode = 1;
             return;
         }
-        console.log('  No API key configured.\n');
-        console.log('  The wiki command requires an LLM API key (OpenAI-compatible).');
-        console.log('  You can also set OPENAI_API_KEY or GITNEXUS_API_KEY env var.\n');
-        const key = await prompt('  Enter your API key: ', true);
+        console.log('  No LLM configured. Let\'s set it up.\n');
+        console.log('  Supports OpenAI, OpenRouter, or any OpenAI-compatible API.\n');
+        // Provider selection
+        console.log('  [1] OpenAI (api.openai.com)');
+        console.log('  [2] OpenRouter (openrouter.ai)');
+        console.log('  [3] Custom endpoint\n');
+        const choice = await prompt('  Select provider (1/2/3): ');
+        let baseUrl;
+        let defaultModel;
+        if (choice === '2') {
+            baseUrl = 'https://openrouter.ai/api/v1';
+            defaultModel = 'openai/gpt-4o-mini';
+        }
+        else if (choice === '3') {
+            baseUrl = await prompt('  Base URL (e.g. http://localhost:11434/v1): ');
+            if (!baseUrl) {
+                console.log('\n  No URL provided. Aborting.\n');
+                process.exitCode = 1;
+                return;
+            }
+            defaultModel = 'gpt-4o-mini';
+        }
+        else {
+            baseUrl = 'https://api.openai.com/v1';
+            defaultModel = 'gpt-4o-mini';
+        }
+        // Model
+        const modelInput = await prompt(`  Model (default: ${defaultModel}): `);
+        const model = modelInput || defaultModel;
+        // API key
+        const key = await prompt('  API key: ', true);
         if (!key) {
             console.log('\n  No key provided. Aborting.\n');
             process.exitCode = 1;
             return;
         }
-        const save = await prompt('  Save key to ~/.gitnexus/config.json for future use? (Y/n): ');
+        // Save
+        const save = await prompt('\n  Save config to ~/.gitnexus/config.json? (Y/n): ');
         if (!save || save.toLowerCase() === 'y' || save.toLowerCase() === 'yes') {
-            const existing = await loadCLIConfig();
-            await saveCLIConfig({ ...existing, apiKey: key });
-            console.log('  Key saved.\n');
+            await saveCLIConfig({ apiKey: key, baseUrl, model });
+            console.log('  Config saved.\n');
         }
         else {
-            console.log('  Key will be used for this session only.\n');
+            console.log('  Config will be used for this session only.\n');
         }
-        llmConfig = { ...llmConfig, apiKey: key };
+        llmConfig = { ...llmConfig, apiKey: key, baseUrl, model };
     }
     // ── Setup progress bar ──────────────────────────────────────────────
     const bar = new cliProgress.SingleBar({
@@ -160,17 +195,19 @@ export const wikiCommand = async (inputPath, options) => {
         bar.update(100, { phase: 'Done' });
         bar.stop();
         const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+        const wikiDir = path.join(storagePath, 'wiki');
+        const viewerPath = path.join(wikiDir, 'index.html');
         if (result.mode === 'up-to-date' && !options?.force) {
             console.log('\n  Wiki is already up to date.');
-            console.log(`  ${path.join(storagePath, 'wiki')}\n`);
+            console.log(`  Viewer: ${viewerPath}\n`);
+            await maybePublishGist(viewerPath, options?.gist);
             return;
         }
-        const wikiDir = path.join(storagePath, 'wiki');
         console.log(`\n  Wiki generated successfully (${elapsed}s)\n`);
         console.log(`  Mode: ${result.mode}`);
         console.log(`  Pages: ${result.pagesGenerated}`);
         console.log(`  Output: ${wikiDir}`);
-        console.log(`  Viewer: ${path.join(wikiDir, 'index.html')}`);
+        console.log(`  Viewer: ${viewerPath}`);
         if (result.failedModules && result.failedModules.length > 0) {
             console.log(`\n  Failed modules (${result.failedModules.length}):`);
             for (const mod of result.failedModules) {
@@ -179,6 +216,7 @@ export const wikiCommand = async (inputPath, options) => {
             console.log('  Re-run to retry failed modules (pages will be regenerated).');
         }
         console.log('');
+        await maybePublishGist(viewerPath, options?.gist);
     }
     catch (err) {
         bar.stop();
@@ -197,3 +235,75 @@ export const wikiCommand = async (inputPath, options) => {
         process.exitCode = 1;
     }
 };
+// ─── Gist Publishing ───────────────────────────────────────────────────
+function hasGhCLI() {
+    try {
+        execSync('gh --version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function publishGist(htmlPath) {
+    try {
+        const output = execSync(`gh gist create "${htmlPath}" --desc "Repository Wiki — generated by GitNexus" --public`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        // gh gist create prints the gist URL as the last line
+        const lines = output.split('\n');
+        const gistUrl = lines.find(l => l.includes('gist.github.com')) || lines[lines.length - 1];
+        if (!gistUrl || !gistUrl.includes('gist.github.com'))
+            return null;
+        // Build a raw viewer URL via gist.githack.com
+        // gist URL format: https://gist.github.com/{user}/{id}
+        const match = gistUrl.match(/gist\.github\.com\/([^/]+)\/([a-f0-9]+)/);
+        let rawUrl = gistUrl;
+        if (match) {
+            rawUrl = `https://gistcdn.githack.com/${match[1]}/${match[2]}/raw/index.html`;
+        }
+        return { url: gistUrl.trim(), rawUrl };
+    }
+    catch {
+        return null;
+    }
+}
+async function maybePublishGist(htmlPath, gistFlag) {
+    if (gistFlag === false)
+        return;
+    // Check that the HTML file exists
+    try {
+        const fs = await import('fs/promises');
+        await fs.access(htmlPath);
+    }
+    catch {
+        return;
+    }
+    if (!hasGhCLI()) {
+        if (gistFlag) {
+            console.log('  GitHub CLI (gh) is not installed. Cannot publish gist.');
+            console.log('  Install it: https://cli.github.com\n');
+        }
+        return;
+    }
+    let shouldPublish = !!gistFlag;
+    if (!shouldPublish && process.stdin.isTTY) {
+        const answer = await new Promise((resolve) => {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            rl.question('  Publish wiki as a GitHub Gist for easy viewing? (Y/n): ', (ans) => {
+                rl.close();
+                resolve(ans.trim().toLowerCase());
+            });
+        });
+        shouldPublish = !answer || answer === 'y' || answer === 'yes';
+    }
+    if (!shouldPublish)
+        return;
+    console.log('\n  Publishing to GitHub Gist...');
+    const result = publishGist(htmlPath);
+    if (result) {
+        console.log(`  Gist:   ${result.url}`);
+        console.log(`  Viewer: ${result.rawUrl}\n`);
+    }
+    else {
+        console.log('  Failed to publish gist. Make sure `gh auth login` is configured.\n');
+    }
+}

package/dist/core/wiki/generator.d.ts

@@ -50,6 +50,7 @@ export declare class WikiGenerator {
         mode: 'full' | 'incremental' | 'up-to-date';
         failedModules: string[];
     }>;
+    private ensureHTMLViewer;
     private fullGeneration;
     private buildModuleTree;
     /**

package/dist/core/wiki/generator.js

@@ -51,6 +51,8 @@ export class WikiGenerator {
         const forceMode = this.options.force;
         // Up-to-date check (skip if --force)
         if (!forceMode && existingMeta && existingMeta.fromCommit === currentCommit) {
+            // Still regenerate the HTML viewer in case it's missing
+            await this.ensureHTMLViewer();
             return { pagesGenerated: 0, mode: 'up-to-date', failedModules: [] };
         }
         // Force mode: delete snapshot to force full re-grouping
@@ -85,14 +87,21 @@ export class WikiGenerator {
         finally {
             await closeWikiDb();
         }
-        // Generate self-contained HTML viewer
-        if (result.pagesGenerated > 0) {
-            this.onProgress('html', 98, 'Building HTML viewer...');
-            const repoName = path.basename(this.repoPath);
-            await generateHTMLViewer(this.wikiDir, repoName);
-        }
+        // Always generate the HTML viewer after wiki content changes
+        await this.ensureHTMLViewer();
         return result;
     }
+    // ─── HTML Viewer ─────────────────────────────────────────────────────
+    async ensureHTMLViewer() {
+        // Only generate if there are markdown pages to bundle
+        const dirEntries = await fs.readdir(this.wikiDir).catch(() => []);
+        const hasMd = dirEntries.some(f => f.endsWith('.md'));
+        if (!hasMd)
+            return;
+        this.onProgress('html', 98, 'Building HTML viewer...');
+        const repoName = path.basename(this.repoPath);
+        await generateHTMLViewer(this.wikiDir, repoName);
+    }
     // ─── Full Generation ────────────────────────────────────────────────
     async fullGeneration(currentCommit) {
         let pagesGenerated = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",