gitnexus 1.2.0 → 1.2.1

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';
@@ -160,17 +161,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 +182,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 +201,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.1",
   "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",