gitnexushub 0.4.3 → 0.4.5

package/dist/wiki/index.js

@@ -16,9 +16,8 @@ function reportError(err) {
     process.exit(1);
 }
 export function registerWikiCommand(program) {
-    const wiki = program.command('wiki').description('Client-side wiki generation and upload');
-    wiki
-        .command('upload')
+    const wiki = program
+        .command('wiki')
         .description('Generate the wiki locally with Claude Code and upload it to the Hub')
         .option('--mode <mode>', 'full | incremental', 'full')
         .option('--model <model>', 'Claude model to use', REAL_DEFAULT_MODEL)
@@ -28,14 +27,29 @@ export function registerWikiCommand(program) {
         if (opts.model)
             deps.model = opts.model;
         const ac = new AbortController();
+        let sigCount = 0;
+        let forceExitTimer = null;
         const onSig = () => {
-            warn('interrupt received, aborting session...');
-            ac.abort();
+            sigCount++;
+            if (sigCount === 1) {
+                warn('interrupt received — cleaning up (Ctrl+C again to force quit)...');
+                ac.abort();
+                forceExitTimer = setTimeout(() => {
+                    warn('cleanup timed out, forcing exit');
+                    process.exit(130);
+                }, 3000);
+                forceExitTimer.unref();
+            }
+            else {
+                if (forceExitTimer)
+                    clearTimeout(forceExitTimer);
+                process.exit(130);
+            }
         };
         process.on('SIGINT', onSig);
         process.on('SIGTERM', onSig);
         try {
-            info(`Resolving repo context...`);
+            info('Resolving repo context...');
             const result = await runWikiUpload({ cwd, mode: opts.mode, model: opts.model, abortSignal: ac.signal }, deps);
             ok(`Uploaded ${result.pagesPersisted} pages.`);
             if (result.failedSlugs.length > 0) {
@@ -43,9 +57,15 @@ export function registerWikiCommand(program) {
             }
         }
         catch (err) {
+            if (ac.signal.aborted) {
+                warn('aborted');
+                process.exit(130);
+            }
             reportError(err);
         }
         finally {
+            if (forceExitTimer)
+                clearTimeout(forceExitTimer);
             process.off('SIGINT', onSig);
             process.off('SIGTERM', onSig);
         }

package/dist/wiki/resolve-context.js

@@ -4,7 +4,7 @@ export async function resolveWikiContext(deps, opts = {}) {
     const repoRoot = deps.getGitRoot(deps.cwd);
     if (!repoRoot) {
         throw new GnxError(ErrorCode.NOT_GIT_REPO, 'not a git repository', {
-            hint: 'cd into your project, or run: gnx wiki upload <path>',
+            hint: 'cd into your project, or run: gnx wiki <path>',
         });
     }
     const headCommit = deps.getGitHead(repoRoot);

package/dist/wiki/session.d.ts

@@ -21,6 +21,7 @@ export interface RunSessionDeps {
     modules: ModuleNode[];
     moduleTree: unknown;
     generatePage: GeneratePageFn;
+    onSessionStart?: (sessionId: string) => void;
     onPageStart?: (slug: string) => void;
     onPageDone?: (slug: string, bytes: number) => void;
     onPageFail?: (slug: string, err: unknown) => void;

package/dist/wiki/session.js

@@ -8,6 +8,7 @@ export async function runWikiUploadSession(deps) {
         clientModel: deps.clientModel,
     });
     const sessionId = started.sessionId;
+    deps.onSessionStart?.(sessionId);
     const receivedSlugs = [];
     const failedSlugs = [];
     let aborted = false;

package/dist/wiki/upload-command.js

@@ -1,6 +1,22 @@
 import { resolveWikiContext } from './resolve-context.js';
 import { runWikiUploadSession } from './session.js';
 import { GnxError, ErrorCode } from './errors.js';
+import { info, warn } from '../cli-helpers.js';
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(2)} MB`;
+}
+function formatDuration(ms) {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    const rem = s % 60;
+    return `${m}m${rem.toString().padStart(2, '0')}s`;
+}
 function slugify(name) {
     return name
         .toLowerCase()
@@ -115,11 +131,13 @@ export async function runWikiUpload(opts, deps) {
     if (opts.abortSignal?.aborted)
         throw new GnxError(ErrorCode.USER_ABORTED, 'aborted before session start');
     const runner = deps.createClaudeRunner();
+    info(`Fetching graph context from Hub (${ctx.hubFullName})...`);
     const [prompts, groupingCtx] = await Promise.all([
         ctx.api.wikiPromptTemplates(ctx.hubRepoId),
         ctx.api.wikiGroupingContext(ctx.hubRepoId),
     ]);
     // Phase 1: Module tree
+    info('Phase 1/3: generating module tree with Claude Code...');
     const groupingPrompt = fillTemplate(prompts.grouping.user, {
         COMMUNITY_GROUPS: groupingCtx.communityGroups,
         INTER_COMMUNITY_EDGES: groupingCtx.interCommunityEdges,
@@ -138,6 +156,7 @@ export async function runWikiUpload(opts, deps) {
     const allPageNodes = [...leaves, ...parents];
     const moduleRegistry = allPageNodes.map((m) => `- [${m.title}](${m.slug}.md)`).join('\n');
     const generatedPages = new Map();
+    info(`Phase 2/3: generating ${leaves.length} leaf page(s) + ${parents.length} parent page(s)...`);
     if (opts.abortSignal?.aborted)
         throw new GnxError(ErrorCode.USER_ABORTED, 'aborted before page generation');
     // Phase 2a: Leaf pages
@@ -279,6 +298,25 @@ export async function runWikiUpload(opts, deps) {
         summary: m.summary,
         files: m.files,
     }));
+    info(`Phase 3/3: streaming ${orderedModules.length} page(s) to Hub...`);
+    let activeSessionId = null;
+    const onAbort = async () => {
+        if (!activeSessionId)
+            return;
+        try {
+            await ctx.api.wikiUploadAbort(ctx.hubRepoId, activeSessionId);
+        }
+        catch {
+            /* ignore secondary errors */
+        }
+    };
+    opts.abortSignal?.addEventListener('abort', onAbort, { once: true });
+    const total = orderedModules.length;
+    const titleBySlug = new Map(orderedModules.map((m) => [m.slug, m.title]));
+    const pageStartAt = new Map();
+    const runStartAt = Date.now();
+    let startedCount = 0;
+    let doneCount = 0;
     try {
         return await runWikiUploadSession({
             api: ctx.api,
@@ -290,6 +328,29 @@ export async function runWikiUpload(opts, deps) {
             modules: orderedModules,
             moduleTree,
             generatePage: generatePageByType,
+            onSessionStart: (id) => {
+                activeSessionId = id;
+            },
+            onPageStart: (slug) => {
+                startedCount += 1;
+                pageStartAt.set(slug, Date.now());
+                const title = titleBySlug.get(slug) ?? slug;
+                info(`[${startedCount}/${total}] ${title} — generating...`);
+            },
+            onPageDone: (slug, bytes) => {
+                doneCount += 1;
+                const startedAt = pageStartAt.get(slug) ?? Date.now();
+                const elapsed = formatDuration(Date.now() - startedAt);
+                const totalElapsed = formatDuration(Date.now() - runStartAt);
+                const pct = Math.round((doneCount / total) * 100);
+                const title = titleBySlug.get(slug) ?? slug;
+                info(`[${doneCount}/${total}] ${title} — uploaded (${formatBytes(bytes)}, ${elapsed}) · ${pct}% · total ${totalElapsed}`);
+            },
+            onPageFail: (slug, err) => {
+                const title = titleBySlug.get(slug) ?? slug;
+                const msg = err instanceof Error ? err.message : String(err);
+                warn(`[${startedCount}/${total}] ${title} — failed: ${msg}`);
+            },
         });
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexushub",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Connect your editor to GitNexus Hub — one command MCP setup + project context",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",